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

create-clone

v0.3.0

Published

A template repository cloning tool with support for private GitHub repos.

Downloads

52

Readme

create-clone is a template repository scaffolding tool that creates copies of git repositories with support for private repos. It taps into the compressed tarball of a repository to quickly pull down a copy without all that extra git cruft.

Key features

  • 🎏 Supports GitHub repos, GitHub gists, GitLab and Bitbucket
  • 💡 Understands GitHub shorthand (rdmurphy/my-cool-template) for referring to repositories
  • 🔐 With proper credentials in place can clone private repositories on GitHub, GitLab and Bitbucket

Table of contents

Setup

create-clone requires at least Node 10 to run.

This library expects to be used in a global context and makes the most sense when installed globally.

npm install --global create-clone
# or
yarn global add create-clone

This also means it works great when paired with npx.

npx create-clone <repository> <dest>

However! create-clone's unique name gives it another super power — you can use a special feature of npm init and yarn create.

npm init clone <repository> <dest>
# or
yarn create clone <repository> <dest>

This is most of the reason this library exists. 😶

Usage

create-clone works any git host URLs that hosted-git-info supports. By default the copy of the repository is output into your current working directory. A path to a different directory can be provided as the second parameter and will be created if necessary.

# The contents of the repository will be copied into the current directory
create-clone user/repository

# The contents of the repository will be copied into provided directory (and created if necessary)
create-clone user/repository my-new-project

By default create-clone will stop and not touch a target directory that already contains files, but this can be overriden with --force.

# I already have something in the "my-old-project" directory, but I don't care
create-clone user/repository my-old-project --force

GitHub

# shortcuts only available to GitHub
create-clone user/repository
create-clone user/repository#branch

create-clone github:user/repository
create-clone github:user/repository.git
create-clone github:user/repository#branch
create-clone github:user/repository.git#branch

# github.com and www.github.com are both supported
create-clone https://github.com/user/repository
create-clone https://github.com/user/repository.git
create-clone https://github.com/user/repository#branch
create-clone https://github.com/user/repository.git#branch
create-clone [email protected]:user/repository
create-clone [email protected]:user/repository.git
create-clone [email protected]:user/repository#branch
create-clone [email protected]:user/repository.git#branch

GitLab

create-clone gitlab:user/repository
create-clone gitlab:user/repository.git
create-clone gitlab:user/repository#branch
create-clone gitlab:user/repository.git#branch

# gitlab.com and www.gitlab.com are both supported
create-clone https://gitlab.com/user/repository
create-clone https://gitlab.com/user/repository.git
create-clone https://gitlab.com/user/repository#branch
create-clone https://gitlab.com/user/repository.git#branch
create-clone [email protected]:user/repository
create-clone [email protected]:user/repository.git
create-clone [email protected]:user/repository#branch
create-clone [email protected]:user/repository.git#branch

Bitbucket

create-clone bitbucket:user/repository
create-clone bitbucket:user/repository.git
create-clone bitbucket:user/repository#branch
create-clone bitbucket:user/repository.git#branch

# bitbucket.org and www.bitbucket.org are both supported
create-clone https://bitbucket.org/user/repository
create-clone https://bitbucket.org/user/repository.git
create-clone https://bitbucket.org/user/repository#branch
create-clone https://bitbucket.org/user/repository.git#branch
create-clone [email protected]:user/repository
create-clone [email protected]:user/repository.git
create-clone [email protected]:user/repository#branch
create-clone [email protected]:user/repository.git#branch

Gist

create-clone gist:user/hash
create-clone gist:user/hash.git
create-clone gist:user/hash#branch
create-clone gist:user/hash.git#branch

create-clone [email protected]:hash.git
create-clone git+https://gist.github.com:hash.git
create-clone git+https://gist.github.com:hash.git
create-clone https://gist.github.com/user/hash
create-clone https://gist.github.com/user/hash.git
create-clone https://gist.github.com/user/hash#branch
create-clone https://gist.github.com/user/hash.git#branch
create-clone [email protected]:user/hash
create-clone [email protected]:user/hash.git
create-clone [email protected]:user/hash#branch
create-clone [email protected]:user/hash.git#branch

Private repos

GitHub, GitLab and Bitbucket all have varying methods for authenticating against their services, so each one needs slightly different permissions and keys.

Fun fact — Private GitHub gists are already supported without any additional authentication because they're only "private" as long as no one else has the URL. This is a documented feature!

GitHub

create-clone requires a GitHub personal access token with read access for repositories and/or gists. Once you have this token, it needs to be available in your environment at GITHUB_TOKEN.

In your .bashrc/.zshrc/preferred shell config:

export GITHUB_TOKEN=<personal-access-token>

create-clone will check for this environment variable when attempting to clone a GitHub repository or gist and include it as an authorization header in the request. create-clone will be able to clone any private GitHub repo your account can access.

GitLab

GitLab also has personal access tokens, but because access to the archive of a private repository is only available via the GitLab API, your token needs to be given the scope of api access, not read_repository. Once you have this token, it needs to be available in your environment at GITLAB_TOKEN.

In your .bashrc/.zshrc/preferred shell config:

export GITLAB_TOKEN=<personal-access-token>

create-clone will check for this environment variable when attempting to clone a GitLab repository and include it as an authorization header in the request. create-clone will be able to clone any private GitLab repo your account can access.

Bitbucket

This is the funky one. Bitbucket does not have the equivalent of a personal access token, so we need to use what it calls an app password. The only permission your app password needs is Repositories -> Read. However, because we are using what's essentially a single-purpose password, we also need to include your Bitbucket username as part of the request. To accomplish this, we need to set up two environmental variables: BITBUCKET_USER for your username, and BITBUCKET_TOKEN for your app password.

In your .bashrc/.zshrc/preferred shell config:

export BITBUCKET_USER=<your-bitbucket-username>
export BITBUCKET_TOKEN=<app-password>

create-clone will check for this environment variable when attempting to clone a Bitbucket repository and include it as the user and password of the request. create-clone will be able to clone any private Bitbucket repo your account can access.

What makes this different from degit?

Honestly? Not a whole lot. This was mostly me wanting to be able to do something cool like npm init clone <repo>/yarn create clone <repo>.

The most notable difference is create-clone does not have a caching layer like degit does. In practice I've not found that to be a major issue, but it may be a big deal for some folks! degit also has a cool actions framework layered on top.

License

MIT