README
police
A module dependency version policing tool. It goes through all your repositories on github which has package.json. Then it analyzes the dependencies and reports back to you about all the outdated packages.
It also can suggest corrections to your package.json file in certain cases.
Installation
Install police globally from npm registry by typing the following command
npm install police -g
Usage
For the first time after you installed police, you need to authenticate yourself to github. This is a one-time step
police auth
Note: We will not save your github password anywhere. A token which we acquire during
the authentication will be used thereafter. And it will be saved in a file with permissions 0600
Does not work when 2 factor authorization is enabled. Please create a personal use token here and edit the ./policeconf
file.
# To police your module dependencies
police
# To police a particular module (You should give the repository name)
police octonode
# To police another user/org module dependencies
police -u flatiron
# To police a particular module of another user/org (You should give the repository name)
police flatiron/plates
# To police a local module or package.json file
police -l ~/octonode
police -l ~/octonode/package.json
# To continue checking even though errors are encountered (Doesnt work with -l)
police -f
police -u flatiron -f
# To edit all the fields in package.json (Doesnt work with -l)
police -e
# To add the missing fields to package.json (Doesnt work with -l)
police -a
# To update dependencies in package.json
police -t
Given below are some ideal commands to help you.
# An ideal police command for github user for the first time on a module
police -f -e -t
# An ideal police command for github user
police -f -a -t
# An ideal police command locally
police -l ~/octonode -t
The token which we acquied during auth will be stored in $HOME/.policeconf
. If you want to use another config file
police octonode --conf /etc/policeconf
police octonode --conf ~/.conf
If you want to destory your token, you can use
police -d
police --destroy
Calling police with help option will display all the above
police -h
police --help
If you like this project, please watch this and follow me.
Testing
npm test
Contributors
Here is a list of Contributors
TODO
- Option to isolate dependency checking and suggestions
- Support multiple npm registries (custom)
- Display progress bar instead of listing the dependencies (use charm)
- Caching package.json blobs per commit
- Start using octonode module
- Command for setting and deleting configurations
I accept pull requests and guarantee a reply back within a day
License
MIT/X11
Bug Reports
Report here. Guaranteed reply within a day.
Contact
Pavan Kumar Sunkara (pavan.sss1991@gmail.com)
Concept by: Martin Wawrusch (martin@wawrusch.com)