From d98060e873bf57b9bf3987023a54a9eb528be571 Mon Sep 17 00:00:00 2001 From: kzndotsh Date: Tue, 26 Mar 2024 17:37:25 -0400 Subject: [PATCH] [Docs] Added CLI documentation for developer commands --- docs/CLI.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 docs/CLI.md diff --git a/docs/CLI.md b/docs/CLI.md new file mode 100644 index 0000000..0aace39 --- /dev/null +++ b/docs/CLI.md @@ -0,0 +1,37 @@ +## Installation +`poetry install` # Install dependencies with Poetry. +`poetry run pre-commit install` # Install pre-commit hooks. + +## Development +`poetry run python tux/main.py` # Run the application with Poetry. +`poetry run pytest` # Run all tests. + +## Docker +`docker-compose up` # Run the application with Docker. + +## Linting +`poetry run pre-commit run --all-files` # Run all pre-commit hooks. +`poetry run pre-commit run ` # Run a specific pre-commit hook. + +## Linting and Formatting +`poetry run ruff check` # Lint all files in the current directory. +`poetry run ruff check --fix` # Lint all files in the current directory, and fix any fixable errors. +`poetry run ruff check --watch` # Lint all files in the current directory, and re-lint on change. +`poetry run ruff check path/to/code/` # Lint all files in `path/to/code` (and any subdirectories). +`poetry run ruff format` # Format all files in the current directory. +`poetry run ruff format path/to/code/` # Lint all files in `path/to/code` (and any subdirectories). +`poetry run ruff format path/to/file.py` # Format a single file. + +## Git +`git checkout -b ` # Create a new branch. +`git checkout ` # Switch to an existing branch. +`git pull` # Pull changes from the remote repository. +`git branch -d ` # Delete a branch. +`git status` # Check the status of the repository. +`git diff` # Show changes between commits, commit and working tree, etc. +`git log` # Show commit logs. +`git remote -v` # Show remote repositories. +`git remote add origin ` # Add a remote repository. +`git add .` # Add all files to the staging area. +`git commit -m "Your commit message"` # Commit changes with a message. +`git push` # Push changes to the remote repository. \ No newline at end of file