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

cascade-cli

v0.2.0

Published

CLI for Git automation

Downloads

8

Readme

Overview

Cascade adds Git automation via the command line, and seeks to streamline your workflow.

With Cascade you can:

  • Create a local and remote repo with multiple branches with one command cascade create <repoName> [branches...]
  • Merge and push multiple branches with one command cascade merge <head> <toBranches...>

Cascade runs commands on the underlying Git API and requires Git to be installed to work. Also, your login credentials are not read or stored - they are completely hidden to Cascade

Installation

To use Cascade in any directory be sure to install globally.

npm i -g casade-cli 

Create

Creating a repo is done using the create command in a new folder. Cascade will initialize a local repository, generate and commit a README file, then [optionally] create a remote repository.

Usage
cascade create <repoName> [branches...]

<repoName> refers to the remote repository name. [branches...] refers to at least one or more optional branches you wish to create. You can chain on more branches by separating them by a space.

By default, when creating a repository, a master branch will be implicitly created. When adding optional branches, each branch will be created off of the mainline branch,

Example
cascade create my_project develop feature
Shorthand Example
cas c my_project develop feature
options

| Flag | Shorthand | Description | | ------------- | ------------ | ----------------------------------- | | --no-remote | | Does not create a remote repository |

CREATE NOTES: 1. When creating a repository, you MUST select a unique repo name for your account. Cascade will fail if a repository exists with the same name of the one you're trying to create.

Merge

Merging branches with the merge command. Cascade will handle pulling, merging, and pushing of branches on the repo.

Common Git workflow pattern
git add -A
git commit -m "message"
git checkout develop
git pull
git merge --no-ff feature -m "Merged 'feature' into develop"
git push
git checkout master
git pull
git merge --no-ff develop -m "Merged 'develop' into master"
git push

More or less, this is a familiar pattern when working on a project with multiple branches.

Cascade equivalent
git add -A
git commit -m "message"
cascade merge feature develop master
Usage
cascade merge <head> <toBranches...>

<head> refers to the HEAD pointer. <toBranches...> refers to at least one or more required branches to merge. You can chain more branches to merge separated by a space.

Example
cascade merge feature develop master
Shorthand Example
cas m feature develop master 
options

| Flag | Shorthand | Description | | ------------- |:------------:| ------------------------------------------:| | --no-push | | Does not push commits to remote repository |

MERGE NOTES:

1. Currently Cascade only supports merging not rebasing, and by default sets the Fast-Forward flag to false `--no-ff`. `--no-ff` creates a more readable Git tree, but will add a commit for the merge.
2. Cascade does not currently support diffing of files or any conflict resolution beyond the Git 3-way auto-merge.
3. If a remote repository does not exist, Cascade will continue merge your local branches.

Commands

| Command | Shorthand | Description | | ------------- |:------------:| -----------------------------------:| | create | c | Creates a repository | | merge | m | Merges branches |

Upcoming Features

  • Ability to set default options
  • Create an optional package.json file when making a new repository