packer-cli
Advanced tools
Full-fledged CLI tool to generate and package library Node modules compliant with Browser and NodeJS. Packer CLI support all modern style, unit test and script transpiler tools.
Full-fledged CLI tool to generate and package library Node modules compliant with Browser and NodeJS. Packer CLI support all modern style, unit test and script transpiler tools.
This project is inspired by Angular CLI
You can simply run the following command in a preferred directory to generate a new project using Packer CLI,
npx packer-cli generate my-library
or
npm install packer-cli -g && packer generate my-library
Then CLI will query questions associated to custom project generation,
# Description about the library
Give us a small description about the library (optional)? Client compliant node module
# Comma separated package keywords to be included in package config
Give us a set of comma separated package keywords (optional)? lib,awesome library,my library
# Name of the library author
Author's name (optional)? Yohan Gomez
# Name of the library author.
Author's email address (optional)? yohan.gz@gmail.com
# Github username of the library author.
Author's github username (optional)? yohangz
# Web home page of the library. This must be a valid URL.
Library homepage link (optional)? http://www.my-project.com
# Script transpiler to be used. Select none to use vanilla javascript.
What's the script pre processor you want to use?
- typescript
- none
# Support CSS bundling if yes.
Do you want style sheet support? (Y/n) Yes
# Style preprocessor to be used. Select none if not required.
What's the style pre processor you want to use?
- scss
- sass
- less
- stylus
- none
# Inline bundle style sheets within bundled script files. Select none to disable support.
Do you want to inline bundle styles within script? (y/N) No
# Target build process to support browser compliant bundling if yes
Are you building a browser compliant library? (Y/n) Yes
## If yes, react framework support will be enabled. Select none to disable support.
Are you building a react library? (y/N) No
# You can chose from the browser compliant flat bundle formats options list.
What's the build bundle format you want to use? umd
- umd
- amd
- iife
- system
# Custom AMD id can be provided if flat bundle format is UMD or AMD. Applicable for "amd" module format only.
What's the AMD id you want to use? (optional) my-lib
# Library namespace will be used when exposing the library via global scope. Applicable for "umd" | "iife" | "systemjs" module formats.
What's the library namespace you want to use? my.lib
# You can chose either Jasmine or Mocha unit test framework.
Which unit test framework do you want to use?
- Jasmine
- Mocha
# Library copyright year to be included in license file.
What is the library copyright year (optional)? 2018
# Generate license file for the project.
What's the library copyright year (optional)?
- MIT License
- Apache License 2.0
- Mozilla Public License 2.0
- BBSD 2-Clause FreeBSD License
- BSD 3-Clause Revised License
- Internet Systems Consortium (ISC) License
- GNU Lesser General Public License v3.0 only
- GNU General Public License v3.0 only
- The Unlicense
# Use yarn package manager instead of NPM CLI if true.
Do you want to use yarn as package manager? (Y/n) Yes
Once project is generated and dependencies are installed, you can use the following CLI commands:
# Run project on watch mode
npm run watch
# Production build
npm run build
# Run Style and script lint tasks
npm run lint
# Run style lint task
npm run lint:style
# Run script lint task
npm run lint:script
# Run unit test suite on development envrionemnt watch mode
npm run test
# Run unit test suite with coverage on development envrionemnt watch mode
npm run test:coverage
# Run unit test suite on continues integration environment mode
npm run test:ci
# Run unit test suite with coverage mode on continues integration environment mode
npm run test:coverage:ci
# Bump package version and push updated package config
npm version major|minor|patch
# Build project and publish to NPM
npm run release
.
├── /.rpt2_cache/ # TypeScript build cache directory
├── /.packer/ # Build helpers files directory
│ ├── .banne.hbs # Build artifact top banner comment template.
│ └── .bin.hbs # Build artifact bin file template used in CLI projects
├── /.tmp/ # Watch build temporary artifact directory
├── /demo/ # Demo source content (applicable if serve mode is enabled in config)
│ ├── /build/ # Build demo page and assets
│ ├── /helper/ # Watch and build demo helper scripts
│ │ ├── require.min.js # RequireJS static artifact
│ │ └── system.min.js # SystemJS static artifact
│ └── /watch/ # Watch demo page and assets
├── /dist/ # Compiled distribution artifacts directory (Generated by build task)
│ ├── /bundles # Directory containing main bundled artifacts (umd, amd, iife, system, ejs, esm)
│ ├── /fesm5 # Directory containing FESM5 artifact.
│ ├── /fesmnext # Directory containing FESMNEXT artifact.
│ ├── /styles # Directory containing compiled style sheets.
│ ├── /LICENSE # Project license agreement file.
│ ├── /package.json # Package.json file with publish artifact specific configuration.
│ └── /README.md # Package documentation markup file.
├── /node_modules/ # Node modules directory
├── /src/ # Library source of the project
│ ├── /sub_srcs # Contain any sub sources(files or folders)
│ └── /index.ts # Expose the accesible properties to the global
├── .babelrc.bundle.js # Bundle build babel config.
├── .babelrc.es5.js # ES5 build babel config.
├── .babelrc.esnext.js # ESNext build babel config.
├── .editorconfig # Define and maintain consistent coding styles between different editors and IDEs.
├── .gitignore # Contains files to be ignored when pushing to git.
├── .packerrc.js # This file contains library build configuration options.
├── .stylelintrc.json # Style lint configuration.
├── .eslintrc.yml # ES Lint configuration.
├── .travis.yml # Travis CI configuration file.
├── karma.conf.js # This file contains karma unit test runner configuration.
├── LICENSE # License agreement file
├── package.json # NPM configuration and medata.
├── README.md # Project documentation markup file.
├── tsconfig.json # This file contains base typescript compiler options and configuration.
└── tslint.json # TS Lint rules for the project.
Build configuration can be updated after project generation via .packerrc.js.
/**
* Packer base configuration object.
*/
module.exports = {
/**
* Entry source file.
* @type {string}
* @default 'index.js'
*/
entry: 'index.js',
/**
* Source directory
* @type {string}
* @default 'src'
*/
source: 'src',
/**
* Build artifact output directory
* @type {string}
* @default 'dist'
*/
dist: 'dist',
/**
* Watch and build temporary file directory
* @type {string}
* @default '.tmp'
*/
tmp: '.tmp',
/**
* Packer compiler options
*/
compiler: {
/**
* Dependency map mode option
* - 'cross-map-peer-dependency' : Map project dependencies to target peerDependencies
* - 'cross-map-dependency' : Map project peerDependencies to target dependencies
* - 'map-dependency' : Map project dependencies to target dependencies
* - 'map-peer-dependency' : Map project peer dependencies to target peerDependencies
* - 'all' - Map both peerDependencies and dependencies to target peerDependencies and dependencies
* @type {string}
* @default 'cross-map-peer-dependency'
*/
dependencyMapMode: 'cross-map-peer-dependency',
/**
* If true, a separate sourcemap file will be created. If inline, the sourcemap will be appended to
* the resulting output file as a data URI.
* @type {boolean|string}
* @default true
*/
sourceMap: true,
/**
* Compile build target config.
* @type {{}}
* @default {}
*/
build: {
/**
* Generate flat bundle minified build artifact.
* @type {boolean}
* @default true
*/
bundleMin: true,
/**
* Generate flat es5 build artifact.
* @type {boolean}
* @default false
*/
es5: false,
/**
* Generate flat es5 minified build artifact based on .babelrc.es5.js.
* @type {boolean}
* @default false
*/
es5Min: false,
/**
* Generate flat esnext build artifact based on .babelrc.esnext.js.
* @type {boolean}
* @default true
*/
esnext: true,
/**
* Generate flat esnext minified build artifact.
* @type {boolean}
* @default true
*/
esnextMin: true
},
/**
* Library compile mode.
* - 'browser' : Browser/NodeJS compliant module.
* - 'node' : NodeJS only module.
* - 'node-cli' : Node CLI module.
* @type {string}
* @default 'browser'
*/
buildMode: 'browser',
/**
* Script compile configuration.
* @type {{}}
* @default {}
*/
script: {
/**
* Script preprocessor.
* - 'typescript' : use typescript preprocessor to transpile source.
* - 'none': do not use any script preprocessor to transpile source.
* @type {string}
* @default 'none'
*/
preprocessor: 'none',
/**
* Script required image compile configuration.
* set false if not required to inline images
* @type {({}|false)}
* @default {}
*/
image: {
/**
* Inline image if image size is less than or equal to specified limit.
* @type {number}
* @default 1000000
*/
inlineLimit: 1000000,
/**
* Large image output directory within distribution directory.
* @type {string}
* @default 'images'
*/
outDir: 'images'
},
},
/**
* Style compile configuration.
* Set false if styles are not supported.
* @type {({}|false)}
* @default {}
*/
style: {
/**
* Bundle styles inline within target build and inject to head at runtime.
* @type {boolean}
* @default false
*/
inline: false,
/**
* Bundled style output directory path within distribution directory.
* @type {string}
* @default 'styles'
*/
outDir: 'styles',
/**
* Style preprocessor
* - 'scss' : SCSS style preprocessor.
* - 'sass' : SASS style preprocessor.
* - 'stylus' : Stylus style preprocessor.
* - 'less' : LESS style preprocessor.
* - 'none' : Do not use any style preprocessor.
* @type {string}
* @default 'none'
*/
preprocessor: 'none',
/**
* Stylesheet required image compile configuration.
* set false if not required to inline images
* @type {({}|false)}
* @default {}
*/
image: {
/**
* Inline image if image size is less than or equal to specified limit.
* @type {number}
* @default 1000000
*/
inlineLimit: 1000000,
/**
* Large image output directory within distribution directory.
* @type {string}
* @default 'images'
*/
outDir: 'images'
}
},
/**
* Run bundle build tasks concurrently to improve performance if true
* @type {boolean}
* @default true
*/
concurrentBuild: true
},
/**
* List of paths which contains static assets referenced in style sheets.
* Paths should be relative to project root.
* @type {Array<string>}
* @default []
*/
assetPaths: [
'src/assets'
],
/**
* List of files paths to copy on build.
* Paths should be relative to project root.
* @type {Array<string>}
* @default []
*/
copy: [
'README.md',
'LICENSE',
'assets/**/{.*,*}'
],
/**
* Import paths to ignore with noop implementation.
* Paths should be relative to project root.
* @type {Array<string>}
* @default []
*/
ignore: [],
/**
* Import path replace pattern collection.
* @type {Array<{ test: (string|RegExp), replace: string }>}
* @default []
*/
replacePatterns: [
{
/**
* Test path identifier string or regular expression.
* @type {(string|RegExp)}
* @default ''
*/
test: './config/base-config',
/**
* Replace path string.
* @type {string}
* @default ''
*/
replace: './config/replace-config'
}
],
/**
* Bundle artifact build configuration.
* @type {{}}
*/
bundle: {
/**
* Bundle output external dependencies (dependency modules to treat as externals).
* Refer rollup options for more info.
* @type {Array<string>}
* @default []
*/
externals: [
'regenerator-runtime/**',
'@babel/runtime/**',
'@babel/runtime-corejs2/**'
],
/**
* Bundle output global dependencies (dependency modules to tread as globals).
* Refer rollup options for more info.
* @type {{}}
* @default {}
*/
globals: {
'react': 'React',
'react-dom': 'ReactDOM'
},
/**
* Treat globals as externals if true
* @type {boolean}
* @default true
*/
mapExternals: true,
/**
* Browser compliant bundle modules formats (based on .babelrc.bundle.js)
* - 'umd' – Universal Module Definition, works as amd, cjs and iife all in one
* - 'amd' – Asynchronous Module Definition, used with module loaders like RequireJS
* - 'iife' – A self-executing function, suitable for inclusion as a DOM script tag. (If you want to create a bundle
* for your application, you probably want to use this, because it leads to smaller file sizes.)
* - 'system' - Native format of SystemJS loader
*
* NodeJS only bundle module formats
* 'cjs' – CommonJS, suitable for Node and Browserify/Webpack
* 'esm' – Keep the bundle as an ES module file
* @type {string}
* @default 'umd'
*/
format: 'umd',
/**
* Library global scope namespace (only applicable for browser compliant).
* @type {string}
* @default 'com.lib'
*/
namespace: 'com.lib',
/**
* AMD flat bundle configuration
* @type {{}}
* @default {}
*/
amd: {
/**
* AMD flat bundle define function name
* @type {string}
* @default ''
*/
define: '',
/**
* AMD flat bundle module identifier name
* @type {string}
* @default 'my-lib'
*/
id: 'my-lib'
}
},
/**
* Unit test framework
* - 'jasmine'
* - 'mocha'
* - 'jest'
* @type {string}
* @default 'jasmine'
*/
testFramework: '{{testFramework}}',
/**
* Watch mode configuration
* Set false if not required to serve on watch build.
* @type {{}|false}
* @default {}
*/
watch: {
/**
* Demo watch source directory which contains index.html to serve.
* This path should be relative to root.
* @type {string}
* @default 'demo/watch'
*/
demoDir: 'demo/watch',
/**
* Demo watch helper directory which contains helper scripts to serve.
* This path should be relative to root.
* @type {string}
* @default 'demo/watch'
*/
helperDir: 'demo/helper',
/**
* Additional serve directories.
* These paths should be relative to root.
* @type {Array<string>}
* @default []
*/
serveDir: [
'node_modules/react/umd',
'node_modules/react-dom/umd'
],
/**
* Open browser tab on watch mode build if true
* @type {boolean}
* @default true
*/
open: true,
/**
* Watch source serve port.
* @type {number}
* @default 4000
*/
port: 4000
},
/**
* Bundle license configuration
* @type {{}}
* @default {}
*/
license: {
/**
* Include inline header banner parsed via .packer/.banner.hbs template to build artifacts.
* @type {boolean}
* @default true
*/
banner: true
}
};
Feel free to open an issue or create a PR
FAQs
Full-fledged CLI tool to generate and package library Node modules compliant with Browser and NodeJS. Packer CLI support all modern style, unit test and script transpiler tools.
The npm package packer-cli receives a total of 18 weekly downloads. As such, packer-cli popularity was classified as not popular.
We found that packer-cli demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket researchers uncovered a malicious PyPI package exploiting Deezer’s API to enable coordinated music piracy through API abuse and C2 server control.
Research
The Socket Research Team discovered a malicious npm package, '@ton-wallet/create', stealing cryptocurrency wallet keys from developers and users in the TON ecosystem.
Security News
Newly introduced telemetry in devenv 1.4 sparked a backlash over privacy concerns, leading to the removal of its AI-powered feature after strong community pushback.