Numerous Packages Multiply
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    fixpackpublic

    fixpack

    A package.json file scrubber for the truly insane.

    It will re-write your package.json file as follows:

    • name first
    • description second
    • version third
    • author fourth
    • all other keys in alphabetical order
    • dependencies and devDependencies sorted alphabetically
    • newline at the end of the file

    It will warn you if any of these are missing:

    • description
    • author
    • repository
    • keywords
    • main
    • bugs
    • homepage
    • license'

    Fix all indenting to 2 spaces.

    Oh, and it will tolerate improperly quoted and comma'd JSON thanks to ALCE.

    Oh, and can do same if you pass it a bower.json file or whatnot.

    Usage

    1. install it globally
    npm i -g fixpack
    
    1. run it in the same directory as your package.json, that's it.
    fixpack
    

    What you might do if you're clever

    npm i cool_package --save && fixpack
    

    Configuration

    It's configurable. You can create a .fixpackrc file in your project or anywhere up the tree to your $HOME directory. Or overwrite options via CLI arguments.

    Uses the rc module to do this. So you can pass all these as CLI args too.

    The available options and their defaults shown below:

     
    {
        // will put these first in this order if present
        sortToTop: [
            'name',
            'description',
            'version',
            'author'
        ],
        // will error if these not present
        required: [
            'name',
            'version'
        ],
        // will warn if these not present
        warn: [
            'description',
            'author',
            'repository',
            'keywords',
            'main',
            'bugs',
            'homepage',
            'license'
        ],
        // if `private: true` in package.json will use the next two lists instead
        requiredOnPrivate: [],
        warnOnPrivate: ['name', 'version', 'description', 'main'],
        // sub items to sort by default
        sortedSubItems: [
            'dependencies',
            'devDependencies',
            'jshintConfig',
            'scripts',
            'keywords'
        ],
        // if you set quiet to true it won't do output anything to the console
        quiet: false,
        // files to scrub
        files: ['package.json'],
        // Will set all deps to '*'
        // this may be useful because then you can
        // run npm update --save && npm update --save-dev
        // to install latest stable releases of everything.
        wipe: false
    }
     

    Changelog

    • 2.3.0 - add wipe option that sets all dep versions to * for easier bulk updating.
    • 2.2.0 - add optionalDependencies to auto sorted
    • 2.1.0 - switched to standard style. Add peerDependencies to default sorted keys.
    • 2.0.1 - don't error on missing bower file by default.
    • 2.0.0 - configurable via .fixpackrc file using rc module.
    • x.x.x - unknown miscellaneous madness and poor version tracking
    • 0.0.2 diff - EOF newline
    • 0.0.1 - initial release

    Credits

    This embarrassing display of insanity, type-A-ness, and OCD brought to you by @HenrikJoreteg.

    License

    MIT

    install

    npm i fixpack

    Downloadsweekly downloads

    3,450

    version

    2.3.1

    license

    MIT

    repository

    githubgithub

    last publish

    collaborators

    • avatar
    • avatar