semvec/pypi-packages huggingface dataset:
hmd-cli-repo 0.3.154
Implementation for repo cli command
License: Apache 2.0

.. README

hmd-cli-repo README
=====================
A CLI application for creating NeuronSphere-compliant project repositories from templates.  This tool is also
the base for multi-repository operations.

* 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.  Depending on configuration,
this may create a remote repository and push the initial code as well.


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**: configures 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.

TODO: more descriptions and examples of these commands

Environment Variables
-----------------------
This command must be run with a valid HMD_HOME set and configured.

**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