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

prettier-plugin-package-perfection

v1.1.0

Published

A Prettier plugin that formats the package.json file by leveraging the prettier-package-json CLI library

Downloads

659

Readme

A Prettier plugin that formats the package.json file by leveraging the prettier-package-json CLI library

Table of Contents

Overview

The prettier-package-json CLI tool is easily the best package.json formatter available. However, despite its name, it is not a Prettier plugin. This project brings all of the great prettier-package-json features to Prettier as a plugin. It sorts in an opinionated style and also has some nifty features that other formatters do not have like:

  • Sorting in an opinionated manner (common elements at the top of the file and everything else sorted alphabetically afterwards)
  • Sorting scripts while keeping pre and post commands together
  • Removing redundant or unnecessary fields in favor of more compact syntax
  • More information available on the prettier-package-json npmjs.org page

Requirements

If you are simply including this library in your project, all you need is a recent version of Node.js. Node.js >14.18.0 is sometimes required and is the only version range we actively support. Albeit, it is highly probable that lower versions will work as well depending on the requirements that this project imports.

Developer Requirements

The following versions of Node.js and Python are required for development:

Other versions may work, but only the above versions are supported. Most development dependencies are installed automatically by our Taskfile.yml set-up (even Node.js and Python). Run bash start.sh to install Bodega (an improved fork of go-task) and run the initialization sequence. The taskfiles will automatically install dependencies as they are needed, based on what development tasks you are running. For more information, check out the CONTRIBUTING.md or simply run:

npm run help

npm run help will ensure Bodega is installed and then open an interactive dialog where you can explore and learn about various developer commands.

Usage / Installation

Prettier plugins are automatically registered if their package name begins with @prettier/plugin-, prettier-plugin-, or @<scope>/prettier-plugin-. Since this package begins with prettier-plugin-, all you have to do is install it via:

npm install --save-dev prettier-plugin-package-perfection

That is it! You are good to go. Prettier should automatically pick up on the plugin.

Shared Configuration

With Prettier, you can create a shared configuration that you can share across all your projects. To do this, you first have to find or create an NPM package that will house your configuration. Then, you have to set the .prettier key in package.json equal to the name of your shared configuration NPM package.

You can find an example shared configuration NPM package here (check out the src/main.ts file to see the magic). All the configuration does is export a typical configuration with module.exports. This opens the door for dynamically configuring your project's configuration and keeping things DRY.

Example Configuration

Specifically including this Prettier plugin in your configuration might look something like this:

{
  "bracketSpacing": true,
  "printWidth": 120,
  "quoteProps": "as-needed",
  "requirePragma": false,
  "semi": false,
  "singleQuote": true,
  "tabWidth": 2,
  "trailingComma": "none",
  "useTabs": false,
  "goTemplateBracketSpacing": true,
  "overrides": [
    {
      "files": ["*.go.html"],
      "options": {
        "parser": "go-template"
      }
    },
    {
      "files": ["*.yml"],
      "options": {
        "printWidth": 160
      }
    }
  ],
  "plugins": [
    "@prettier/plugin-xml",
    "prettier-plugin-go-template",
    "prettier-plugin-ini",
    "prettier-plugin-organize-imports",
    "prettier-plugin-package-perfection",
    "prettier-plugin-properties",
    "prettier-plugin-sh"
  ]
}

Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page. If you would like to contribute, please take a look at the contributing guide.

Brian Zalewski

Affiliates

Below you will find a list of services we leverage that offer special incentives for signing up for their services through our special links:

License

Copyright © 2020-2021 Megabyte LLC. This project is MIT licensed.