repo¶

Description¶

Repository management commands.

Available Commands:

scaffold: Create and initialize a new repository with template files
update_deps: Update and lock repository dependencies

Subcommands¶

create-remote¶

Create a new repository on Github.

Required Parameters:

user (--user): Github user. to create the repository under.

Optional Parameters:

repo_name: Name of the repository to create

token (--token): Github token. (Default: None)

private (--private): Make the repository private. (Default: False)

Usage: Create a new repository: adev repo create-github-repo my_repo

Create a new private repository:
    adev repo create-github-repo my_repo --private

Notes¶

- Creates a new repository on Github
- Requires a Github token to authenticate
- Optionally makes the repository private
- Returns the response from the Github API

scaffold¶

Create a new repository and scaffold necessary files.

Required Parameters:

name: Name of the repository to create

Optional Parameters:

type_of_repo (-t): Type of repository to scaffold (autonomy, python). (Default: autonomy)
force (-f): Overwrite existing repository if it exists. (Default: False)
auto_approve (-aa): Skip confirmation prompts. (Default: False)
install (--install/--no-install): Install dependencies after scaffolding. (Default: True)
initial_commit (--initial-commit/--no-commit): Create initial git commit. (Default: True)

Usage: Create basic autonomy repo: adev repo scaffold my_repo

Create Python repo:
    adev repo scaffold my_repo -t python

Force overwrite existing repo:
    adev repo scaffold my_repo -f

Skip dependency installation:
    adev repo scaffold my_repo --no-install

Notes¶

- Creates a new git repository in the specified directory
- For autonomy repos:
    - Installs host dependencies via install.sh
    - Initializes autonomy packages
- For Python repos:
    - Creates src directory with __init__.py
    - Adds sample main.py and cli.py files

update-deps¶

Update and lock repository dependencies.

Optional Parameters:

lock (--lock): Lock dependencies after updating. Default: False

Usage:

Update dependencies:
    adev repo update-deps

Update and lock dependencies:
    adev repo update-deps --lock

Notes¶

- Updates dependencies in packages.json
- Optionally locks dependency versions
- Checks for changes in dependency files
- Prompts to commit changes if detected
- Exits with error if uncommitted changes exist