hmd-cli-repo 0.2.81

Implementation for repo cli command

hmd-cli-repo

A CLI application for creating NeuronSphere compliant project repositories.

Additional Requirements

• Git

Basic Usage

hmd repo create will provide prompts to choose which Project Type Category and then Project Type you want to create. After having selected a Project Type, you will be prompted for any additional information need to create the project, i.e. a name for the project.

After all prompts have been answered, it will render a series of templates into a folder with the Project Name. This will be a standard Git repository and all generated files will be committed for you.

Configuration

All configuration is done via environment variables set in an hmd.env file. These variables can be set via the hmd configure tool.

Required Variables

• HMD_HOME: a folder used to contain Local NeuronSphere specific configuration and data. The hmd.env file gets create in here at $HMD_HOME/.config/hmd.env.

Optional Variables

• HMD_REPO_ORG_NAME: a common org code prefix to prepend to all create repo names.
• HMD_REPO_REMOTE_GITHUB_ENABLED: if set to "true", a remote repository will be created in GitHub upon running hmd repo create
• HMD_GH_USERNAME: the GitHub username to use
• HMD_GH_PASSWORD: the GitHub PAT to use
• HMD_GH_ORG_NAME: the GitHub Organization to create the repository in

Commands

• hmd repo create: create a NeuronSphere compliant repository based on chosen Project Type
• hmd repo add: overlay a new Project Type onto an existing repository in a new branch
• hmd repo configure: configure hmd-cli-repo specific environment variables in $HMD_HOME/.config/hmd.env
• hmd repo pull-all: pull all changes and new repositories from a GitHub organization locally into $HMD_REPO_HOME
• hmd repo create-remote: create a remote repository for an existing local repo, will set origin remote in Git to new remote.