npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

taginator

v1.0.2

Published

Creates 'tags' files for vim automatically in the background.

Downloads

13

Readme

This is Taginator, the last tags generator you need.

Start Taginator at your system startup or user login and it generates fresh tags files for each of your projects. After that it watches your project for file changes and updates the tags file if you change a file. If you change more files, e.g. with a git rebase/checkout, Taginator waits till there are no change notifications any more and generates the complete tags file again.

Install

  • run npm install -g coffee-script to make sure coffee-script is globally installed
  • install this by hand
    • git clone http://github.com/hoschi/taginator
    • cd taginator
    • npm install
    • bin/taginator
  • or with npm
    • npm install -g taginator

Tags generation for JavaScript

Install jsctags first, if you want to generate tags for JavaScript. After that put my ctags script into your ~/bin/ directory so it calls ctags or jsctags automatically.

Configuration

Create the file /.taginator.json and put your project configurations in an array. Here is an example configuration:

[
    {
        "name":"test",
        "cwd":"~/vimtest/",
        "output":"~/vimtest/tags",
        "extensions":[
            "js"
        ],
        "ctagArgs":[
            "--language-force=javascript"
        ],
        "inputDirs":[
            "a/",
            "b/"
        ],
        "globs":[
            "~/vimtest/.git/**/*",
            "~/vimtest/a/**/*.js",
            "~/vimtest/b/**/*.js"
        ]
    }
]

Run taginator with your config or the example config and browse to http://localhost:3000/ to see an explanation of your configuration.

Properties:

  • name the name of the project
  • cwd the current working directory of your project and base path for inputDirs
  • output file path for the tags file
  • extensions valid file extensions to generate tags for
  • ctagArgs static arguments for the ctags command passed on every call for this project
  • inputDirs for the ctags command
  • globs which select the files should be watched

Important notes

This project uses the library node-glob, so Windows users also must use forward slashes instead of back slashes. Please read the note at the end of this site.

Using ~/ as a shortcut for your home dir is ok at all OSs.

The cwd property must have a trailing slash so it can be removed safely from found files to make them relative paths. This config property is not optional!

Usage

Start Taginator and let it update your tags files automatically :)

Development

Use nodemon to automatically restart the app:

nodemon -e .coffee,.js,.json -w /home/YOURHOMEDIR/.taginator.json -w .  --exec coffee taginator.coffee