Npm (software): Difference between revisions
Appearance
| Line 2: | Line 2: | ||
==Usage== | ==Usage== | ||
==package.json== | |||
<pre> | |||
{ | |||
"name": "@david18284/ddns-cloudflare", | |||
"version": "1.0.0", | |||
"description": "A DDNS Updater for Cloudflare.<br>\r This will scan for all \"A\" records and update their IPs.", | |||
"main": "./build/index.js", | |||
"bin": { | |||
"ddns-cloudflare": "./bin/cli.js" | |||
}, | |||
"scripts": { | |||
"start": "npm run compile && node build/index.js", | |||
"compile": "babel src -d build", | |||
"test": "echo \"Error: no test specified\" && exit 1" | |||
}, | |||
"repository": { | |||
"type": "git", | |||
"url": "git+https://github.com/dli7319/ddns-cloudflare-javascript.git" | |||
}, | |||
"author": "David Li", | |||
"license": "MIT", | |||
"bugs": { | |||
"url": "https://github.com/dli7319/ddns-cloudflare-javascript/issues" | |||
}, | |||
"homepage": "https://github.com/dli7319/ddns-cloudflare-javascript#readme", | |||
"dependencies": { | |||
"node-fetch": "^2.3.0" | |||
}, | |||
"devDependencies": { | |||
"@babel/cli": "^7.10.5", | |||
"@babel/core": "^7.11.4", | |||
"@babel/preset-env": "^7.11.0" | |||
} | |||
} | |||
</pre> | |||
* <code>scripts</code> contains JS commands you can run with <code>npm run</code> | |||
* <code>bin</code> contains binaries or scripts which get installed globally. | |||
==Publishing== | ==Publishing== | ||
Revision as of 14:45, 24 August 2020
NPM is a package manager for JavaScript and TypeScript projects.
Usage
package.json
{
"name": "@david18284/ddns-cloudflare",
"version": "1.0.0",
"description": "A DDNS Updater for Cloudflare.<br>\r This will scan for all \"A\" records and update their IPs.",
"main": "./build/index.js",
"bin": {
"ddns-cloudflare": "./bin/cli.js"
},
"scripts": {
"start": "npm run compile && node build/index.js",
"compile": "babel src -d build",
"test": "echo \"Error: no test specified\" && exit 1"
},
"repository": {
"type": "git",
"url": "git+https://github.com/dli7319/ddns-cloudflare-javascript.git"
},
"author": "David Li",
"license": "MIT",
"bugs": {
"url": "https://github.com/dli7319/ddns-cloudflare-javascript/issues"
},
"homepage": "https://github.com/dli7319/ddns-cloudflare-javascript#readme",
"dependencies": {
"node-fetch": "^2.3.0"
},
"devDependencies": {
"@babel/cli": "^7.10.5",
"@babel/core": "^7.11.4",
"@babel/preset-env": "^7.11.0"
}
}
scriptscontains JS commands you can run withnpm runbincontains binaries or scripts which get installed globally.
Publishing
- Create an account at https://npmjs.org.
- Login to npm using
npm login. - Initialize a
package.jsonusingnpm init.- I recommend using a scoped name
@username/package-name.
- I recommend using a scoped name
- Make a UMD build e.g. using webpack.
- Fill in all the details in
package.json. - For publishing the most important are: name, version, description, main, module, author, repository, license, files, homepage.
- Fill in all the details in
- Test your package.
- Run your own tests using `npm run test`.
- Install to another package using `npm install [dir]`.
- Upload to npm
npm publish --access public