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

octo-tag

v1.0.4

Published

Octo-tag is library to help you versioning, and automatically add tag to git

Downloads

138

Readme

Octo-Tag library help tagging in git

octo-tag

Octo-tag is a library that help you with versioning when adding a tag to remote/locally.

It will automatically generate a version, calculated based on the previous version, if the tag on git doesn't have history, it will make new ones.

Installation

You can install globally by running this command

npm install -g octo-tag

or you just want to install in specific project, you can do with

npm install octo-tag --dev

Usage

running this command

octo-tag

when you running this command, it will give you some question and confirmation to make sure the tag is correct.

The questions consist of :

  1. Environment (Staging, Production or Beta), if you choose staging, octo-tag will add alpha.1 in you tag, so the final tag will be v0.0.1-alpha.1 and if you choose production will add tag like commonly v0.0.1.( and the last one is beta on progress)

  2. Semantic Version Type (major, minor, patch), if you choose major, it will make the first number in your version increase, say you has previous version i.e : v1.0.0 when you choose major it will increase to v2.0.0, if you choose minor, it will increase secondary number to v1.1.0, and if you choose patch it will increase last number to v1.0.1.

  3. Commit Id is used if you want add tag to specific commit/history id in your git.

  4. Confirmation to add tag

  5. Confirmation to push tag, in this step you can choose, you want to push the tag to remote/origin or not.

Prefix

if you want to add prefix i.e from v1.0.0 to octo-tag-1.0.0, you can add argument --prefix=customtag-

octo-tag --prefix=customtag-

How Octo-Tag Works :

Calculate Versioning :

  1. octo-tag will get latest version in remote, if the latest version is v1.0.0, and you choose environment staging and semantic version major. the versioning will generate v2.0.0-alpha.1. or if beta selected it will have v2.0.0-beta.1.

  2. If the v2.0.0-alpha.1 is exist, it will increase latest number, so the output will v2.0.0-alpha.2

Publish

change your version in package.json

i.e: 1.0.0 to 2.0.0

npm login
npm publish

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT