Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@ptkdev/all-shields-cli

Package Overview
Dependencies
Maintainers
1
Versions
8
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@ptkdev/all-shields-cli

Tool to help automate your badges of shields.io, badgen.net, fury.io, github action and snyk.io from .all-shieldsrc dotfile for your markdown files. You can use Liquid variables like {{name}} or {{version}} which refer to your package.json. Inspired by al

  • 2.0.2
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
133
increased by107.81%
Maintainers
1
Weekly downloads
 
Created
Source

all-shields-cli

🦌 all-shields-cli - badges generator

v2.0.2 License: MIT Language: TypeScript ECMAScript: 2019 Discord Server

Tool to help automate your badges of shields.io, badgen.net, fury.io, github action and snyk.io from .all-shieldsrc dotfile for your markdown files. You can use Liquid variables like {{name}} or {{version}} which refer to your package.json. Inspired by all-contributors-cli

🎁 Support: Donate

This project is free, open source and I try to provide excellent free support. Why donate? I work on this project several hours in my spare time and try to keep it up to date and working. THANK YOU!

Donate Paypal Donate Ko-Fi Donate Github Sponsors Donate Patreon Donate Bitcoin Donate Ethereum

📎 Menu

💡 Features

  • [✔️] Easy to use
  • [✔️] MIT License
  • [✔️] Support: shields.io
  • [✔️] Support: fury.io
  • [✔️] Support: snyk.io
  • [✔️] Support: badgen.net
  • [✔️] Support: github action
  • [✔️] Full customizations!
  • [✔️] Liquid Variables
  • [✔️] Tool to help automate your badges on markdown.
  • [✔️] Badges generator from dotfiles for any markdown

👔 Screenshot

all-shields-cli

🚀 How to use

🔧 Installation
  1. In your node project run: npm install @ptkdev/all-shields-cli --save-dev
  2. In your package.json add script:
	...
	"scripts": {
		"all-shields-generate": "all-shields-cli"
	}
	...
  1. Create .all-shieldsrc and paste sample:
{
	"files": ["README.md"],
	"shields": [
		{
			"id": "my-badges",
			"badges": [
				{
					"url": "https://www.npmjs.com/package/@ptkdev/all-shields-cli",
					"color": "#D3D3D3",
					"label": "package name",
					"title": "package name",
					"message": "{{name}}",
					"style": "flat",
					"logo": "",
					"platform": "shields"
				}
			]
		}
	]
}
  1. Add in your README.md the html comment (my-badges is id from the previous step):
<!-- all-shields/my-badges:START -->
<!-- all-shields/my-badges:END -->
  1. Run npm run all-shields-generate

See folder examples, run with npm run example. Below is available a description of options values.

⚙️ CLI
  1. Install cli package globally: npm install @ptkdev/all-shields-cli -g
  2. Run anywhere: all-shields-cli

You can use npx, example: npx @ptkdev/all-shields-cli

🔑 Liquid variables

In your .all-shieldsrc dotfile you can use liquid variables like {{name}} or {{version}} which refer to your package.json. Key of package.json is name of liquid variable {{key_from_package.json}}

🐶 Work with Husky

  1. In your node project run: npm install husky --save-dev (docs)
  2. Setup husky with: npx husky install
  3. Add hook: npx husky add .husky/pre-commit "npm run all-shields-generate"

🧰 Options: Badges Array

ParameterDescriptionValuesDefault valueAvailable on platformsAvailable since
platformDefine platformdiscord / shields / fury / snyk / badgen / githubshieldsv1.0.0
customSet custom string of image url (appended after domain url of badge service)stringemptydiscord, shields, fury, snyk, badgen, githubv1.1.0
urlIf you click on badge open this urlURIemptydiscord, shields, fury, snyk, badgen, githubv1.0.0
colorBadge hexcode color (right side). NOTE: Overwrited if custom is set.string / hexcodelightgrayshields, badgenv1.0.0
labelBadge text (left side). NOTE: Overwrited if custom is set.stringemptyshields, badgenv1.0.0
titleMouse hover alt textstringemptydiscord, shields, fury, snyk, badgen, githubv1.0.0
messageBadge text (right side). NOTE: Overwrited if custom is set.stringemptydiscord, shields, fury, snyk, badgen, githubv1.0.0
styleLook of badge. NOTE: Overwrited if custom is set.plastic / flat / flat-square / for-the-badge / socialflatshieldsv1.0.0
logoShow logo (left side). NOTE: Overwrited if custom is set.shields: bitcoin , dependabot , discord , gitlab , npm , paypal , serverfault , stackexchange , superuser , telegram , travis and more on docs.

badgen: airbnb, apple, appveyor, atom, awesome, azure, azurepipelines, bitcoin, buymeacoffee, chrome, circleci, cocoapods, codacy, codebeat, codeclimate, codecov, codeship, commonwl, deepscan, dependabot, discord, dockbit, docker, eclipse, firefox, flow, git, github, gitlab, gitter, googleplay, graphql, haskell, jsdelivr and more on docs
emptyshields, badgenv1.0.0
server_idif platform is discord, set your discord server_idDISCORD_SERVER_IDemptydiscordv1.0.0

🔨 Developer Mode

🏁 Run Project
  1. Clone this repository or download nightly, beta or stable.
  2. Run npm run init
  3. Run npm run build && npm run link (unix require sudo)
  4. Run all-shields-cli anywhere for execute command line tool

or run npm run dev for watch mode.

📚 Documentation

Run npm run docs

👑 Backers and Sponsors

Thanks to all our backers! 🙏 Donate 3$ or more on paypal, ko-fi, github or patreon and send me email with your avatar and url.

👨‍💻 Contributing

I ❤️ contributions! I will happily accept your pull request! Translations, grammatical corrections (GrammarNazi you are welcome! Yes my English is bad, sorry), etc... Do not be afraid, if the code is not perfect we will work together 👯 and remember to insert your name in .all-contributorsrc and package.json file.

Thanks goes to these wonderful people (emoji key):


Patryk Rzucidło

💻 🌍 📖 🐛

di4urp

💻 🐛

💰 In the future, if the donations allow it, I would like to share some of the success with those who helped me the most. For me open source is share of code, share development knowledges and share donations!

🦄 Other Projects

💫 License

  • Code and Contributions have MIT License
  • Images and logos have CC BY-NC 4.0 License (Freepik Premium License)
  • Documentations and Translations have CC BY 4.0 License
Copyleft (c) 2021 Patryk Rzucidło (@PTKDev) <support@ptkdev.io>

Keywords

FAQs

Package last updated on 24 Apr 2021

Did you know?

Socket

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.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc