Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mikbry/packito
Packito cleans your npm package before publishing it !
https://github.com/mikbry/packito
cli cli-app es6 lerna nodejs np npm npm-package npm-publish yarn
Last synced: about 2 hours ago
JSON representation
Packito cleans your npm package before publishing it !
- Host: GitHub
- URL: https://github.com/mikbry/packito
- Owner: mikbry
- License: mit
- Created: 2019-12-17T11:35:57.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-01-06T13:40:12.000Z (almost 2 years ago)
- Last Synced: 2024-09-23T15:48:15.252Z (about 2 months ago)
- Topics: cli, cli-app, es6, lerna, nodejs, np, npm, npm-package, npm-publish, yarn
- Language: JavaScript
- Homepage:
- Size: 901 KB
- Stars: 14
- Watchers: 4
- Forks: 1
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 📦 Packito
[![Build Status][travis-image]][travis-url]
[![codecov][codecov-image]][codecov-url]
[![NPM version][npm-image]][npm-url]
[![License][license-image]][license-url]
[travis-image]: https://travis-ci.com/mikbry/packito.svg?branch=master
[travis-url]: https://travis-ci.com/mikbry/packito
[codecov-image]: https://codecov.io/gh/mikbry/packito/branch/master/graph/badge.svg?token=K4P0vnM5fh
[codecov-url]: https://codecov.io/gh/mikbry/packito
[npm-image]: https://img.shields.io/npm/v/packito.svg
[npm-url]: https://npmjs.org/package/packito
[license-image]: https://img.shields.io/npm/l/packito.svg
[License-url]:./LICENSE
> Packito is a cli tool to clean package before publishing it.
### Purpose
Before publishing to npm, did you take care of your package.json ?
* devDependencies, some scripts and other entries("husky", ...) could be removed.
* add some new or change entries, like "main" source file name
* use a dist file and copy some extra files/directories in it (README.md, LICENSE, ...).
* and finally publish your package using npm, np or lerna.
***Simple using one command:***
```bash
$ packito
```
By default it will remove "scripts" and "devDependencies", copy README.md and LICENSE if they exist to './dist' folder.
### Install
```bash
$ yarn add --dev packito
```
Or using npm
```bash
$ npm add --dev packito
```
### Usage
```bash
$ packito [options] [bin-to-publisher]
```
***Options***
| name | alias | description |
| ----------- | --- | ----------- |
| --dist | -d | Path to publish from |
| --nopublish | -n | Skips publishing step |
| --help | -h | Displays help informations |
***Bin to publisher***
| name | description |
| ----------- | ----------- |
| npm | Publish using npm |
| lerna | Publish using npm |
| np | Publish using np |
***.packito.json***
It is the configuration file.
This json should be at root of the project, a sample:
```json
{
"remove": {
"devDependencies": "*",
"scripts": "*",
"type": true,
"esm": true,
"husky": true,
"commitlint": true
},
"replace": {
"main": "index.js",
"module": "index.mjs"
},
"publisher": "np"
}
```
| name | type | description |
| ----------- | --- | ----------- |
| remove | object | all keys to remove from packages.json (if =true or ='*' replace all) |
| replace | object | all keys+values to replace in packages.json |
| copy | object | all files to copy in dist |
| output | string | folder to publish to |
| publisher | string\|object | The publisher to use (npm, np, lerna) |
***Other command examples***
> Publish to path 'publish'
```bash
$ packito -d ./publish
```
> Publish to path 'publish' and use `np patch`to publish
```bash
$ packito -d ./publish np patch
```
### Coded using state of the art and simplicity in mind
- Simple to use
- Modern ES6+ syntax (import instead of require, await/async, ...)
- Follows [Node best practices](https://github.com/goldbergyoni/nodebestpractices)
### Requirements
- Node >= 12
## Contribution
Read [Contributing Guide](CONTRIBUTING.md) for development setup instructions.