<!-- <img id="logo" src="resources/logo.png" style="max-width: 717px"> -->
[](https://github.com/the-new-flesh/cv-depot/blob/master/LICENSE)
[](https://github.com/the-new-flesh/cv-depot/blob/master/docker/config/pyproject.toml)
[](https://pypi.org/project/cv-depot/)
[](https://pepy.tech/project/cv-depot)
# Introduction
Computer Vision Tools
See [documentation](https://the-new-flesh.github.io/cv-depot/) for details.
# Installation for Developers
### Docker
1. Install [docker-desktop](https://docs.docker.com/desktop/)
2. Ensure docker-desktop has at least 4 GB of memory allocated to it.
3. `git clone git@github.com:theNewFlesh/cv-depot.git`
4. `cd cv-depot`
5. `chmod +x bin/cv-depot`
6. `bin/cv-depot docker-start`
- If building on a M1 Mac run `export DOCKER_DEFAULT_PLATFORM=linux/amd64` first.
The service should take a few minutes to start up.
Run `bin/cv-depot --help` for more help on the command line tool.
### ZSH Setup
1. `bin/cv-depot` must be run from this repository's top level directory.
2. Therefore, if using zsh, it is recommended that you paste the following line
in your ~/.zshrc file:
- `alias cv-depot="cd [parent dir]/cv-depot; bin/cv-depot"`
- Replace `[parent dir]` with the parent directory of this repository
3. Consider adding the following line to your ~/.zshrc if you are using a M1 Mac:
- `export DOCKER_DEFAULT_PLATFORM=linux/amd64`
4. Running the `zsh-complete` command will enable tab completions of the cli
commands, in the next shell session.
For example:
- `cv-depot [tab]` will show you all the cli options, which you can press
tab to cycle through
- `cv-depot docker-[tab]` will show you only the cli options that begin with
"docker-"
# Installation for Production
### Python
`pip install cv-depot`
### Docker
1. Install [docker-desktop](https://docs.docker.com/desktop/)
2. `docker pull theNewFlesh/cv-depot:[version]`
---
# Quickstart Guide
This repository contains a suite commands for the whole development process.
This includes everything from testing, to documentation generation and
publishing pip packages.
These commands can be accessed through:
- The VSCode task runner
- The VSCode task runner side bar
- A terminal running on the host OS
- A terminal within this repositories docker container
Running the `zsh-complete` command will enable tab completions of the CLI.
See the zsh setup section for more information.
### Command Groups
Development commands are grouped by one of 10 prefixes:
| Command | Description |
| ---------- | ---------------------------------------------------------------------------------- |
| build | Commands for building packages for testing and pip publishing |
| docker | Common docker commands such as build, start and stop |
| docs | Commands for generating documentation and code metrics |
| library | Commands for managing python package dependencies |
| session | Commands for starting interactive sessions such as jupyter lab and python |
| state | Command to display the current state of the repo and container |
| test | Commands for running tests, linter and type annotations |
| version | Commands for bumping project versions |
| quickstart | Display this quickstart guide |
| zsh | Commands for running a zsh session in the container and generating zsh completions |
### Common Commands
Here are some frequently used commands to get you started:
| Command | Description |
| ----------------- | --------------------------------------------------------- |
| docker-restart | Restart container |
| docker-start | Start container |
| docker-stop | Stop container |
| docs-full | Generate documentation, coverage report, diagram and code |
| library-add | Add a given package to a given dependency group |
| library-graph-dev | Graph dependencies in dev environment |
| library-remove | Remove a given package from a given dependency group |
| library-search | Search for pip packages |
| library-update | Update dev dependencies |
| session-lab | Run jupyter lab server |
| state | State of |
| test-dev | Run all tests |
| test-lint | Run linting and type checking |
| zsh | Run ZSH session inside container |
| zsh-complete | Generate ZSH completion script |
---
# Development CLI
bin/cv-depot is a command line interface (defined in cli.py) that
works with any version of python 2.7 and above, as it has no dependencies.
Commands generally do not expect any arguments or flags.
Its usage pattern is: `bin/cv-depot COMMAND [-a --args]=ARGS [-h --help] [--dryrun]`
### Commands
The following is a complete list of all available development commands:
| Command | Description |
| ----------------------- | ------------------------------------------------------------------- |
| build-package | Build production version of repo for publishing |
| build-prod | Publish pip package of repo to PyPi |
| build-publish | Run production tests first then publish pip package of repo to PyPi |
| build-test | Build test version of repo for prod testing |
| docker-build | Build Docker image |
| docker-build-from-cache | Build Docker image from registry cache |
| docker-build-no-cache | Build Docker image without cache |
| docker-build-prod | Build production image |
| docker-container | Display the Docker container id |
| docker-destroy | Shutdown container and destroy its image |
| docker-destroy-prod | Shutdown production container and destroy its image |
| docker-image | Display the Docker image id |
| docker-prod | Start production container |
| docker-pull-dev | Pull development image from Docker registry |
| docker-pull-prod | Pull production image from Docker registry |
| docker-push-dev | Push development image to Docker registry |
| docker-push-dev-latest | Push development image to Docker registry with dev-latest tag |
| docker-push-prod | Push production image to Docker registry |
| docker-push-prod-latest | Push production image to Docker registry with prod-latest tag |
| docker-remove | Remove Docker image |
| docker-restart | Restart Docker container |
| docker-start | Start Docker container |
| docker-stop | Stop Docker container |
| docs | Generate sphinx documentation |
| docs-architecture | Generate architecture.svg diagram from all import statements |
| docs-full | Generate documentation, coverage report, diagram and code |
| docs-metrics | Generate code metrics report, plots and tables |
| library-add | Add a given package to a given dependency group |
| library-graph-dev | Graph dependencies in dev environment |
| library-graph-prod | Graph dependencies in prod environment |
| library-install-dev | Install all dependencies into dev environment |
| library-install-prod | Install all dependencies into prod environment |
| library-list-dev | List packages in dev environment |
| library-list-prod | List packages in prod environment |
| library-lock-dev | Resolve dev.lock file |
| library-lock-prod | Resolve prod.lock file |
| library-remove | Remove a given package from a given dependency group |
| library-search | Search for pip packages |
| library-sync-dev | Sync dev environment with packages listed in dev.lock |
| library-sync-prod | Sync prod environment with packages listed in prod.lock |
| library-update | Update dev dependencies |
| library-update-pdm | Update PDM |
| quickstart | Display quickstart guide |
| session-lab | Run jupyter lab server |
| session-python | Run python session with dev dependencies |
| state | State of repository and Docker container |
| test-coverage | Generate test coverage report |
| test-dev | Run all tests |
| test-fast | Test all code excepts tests marked with SKIP_SLOWS_TESTS decorator |
| test-lint | Run linting and type checking |
| test-prod | Run tests across all support python versions |
| version | Full resolution of repo: dependencies, linting, tests, docs, etc |
| version-bump-major | Bump pyproject major version |
| version-bump-minor | Bump pyproject minor version |
| version-bump-patch | Bump pyproject patch version |
| version-commit | Tag with version and commit changes to master |
| zsh | Run ZSH session inside Docker container |
| zsh-complete | Generate oh-my-zsh completions |
| zsh-root | Run ZSH session as root inside Docker container |
### Flags
| Short | Long | Description |
| ----- | --------- | ---------------------------------------------------- |
| -a | --args | Additional arguments, this can generally be ignored |
| -h | --help | Prints command help message to stdout |
| | --dryrun | Prints command that would otherwise be run to stdout |
---
# Production CLI
cv-depot comes with a command line interface defined in command.py.
Its usage pattern is: `cv-depot COMMAND [ARGS] [FLAGS] [-h --help]`
## Commands
---
### bash-completion
Prints BASH completion code to be written to a _cv-depot completion file
Usage: `cv-depot bash-completion`
---
### zsh-completion
Prints ZSH completion code to be written to a _cv-depot completion file
Usage: `cv-depot zsh-completion`
Raw data
{
"_id": null,
"home_page": null,
"name": "cv-depot",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "OpenEXR, EXR, openexr, exr, computer-vision, cv, image, compositing",
"author": null,
"author_email": "Alex Braun <alexander.g.braun@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/17/09/8c3c27e589f6e90098ad6b9ac456bee57db0202cc2177f58f9f203280018/cv-depot-0.1.3.tar.gz",
"platform": null,
"description": "<!-- <img id=\"logo\" src=\"resources/logo.png\" style=\"max-width: 717px\"> -->\n\n[](https://github.com/the-new-flesh/cv-depot/blob/master/LICENSE)\n[](https://github.com/the-new-flesh/cv-depot/blob/master/docker/config/pyproject.toml)\n[](https://pypi.org/project/cv-depot/)\n[](https://pepy.tech/project/cv-depot)\n\n# Introduction\n\nComputer Vision Tools\n\nSee [documentation](https://the-new-flesh.github.io/cv-depot/) for details.\n\n# Installation for Developers\n\n### Docker\n1. Install [docker-desktop](https://docs.docker.com/desktop/)\n2. Ensure docker-desktop has at least 4 GB of memory allocated to it.\n3. `git clone git@github.com:theNewFlesh/cv-depot.git`\n4. `cd cv-depot`\n5. `chmod +x bin/cv-depot`\n6. `bin/cv-depot docker-start`\n - If building on a M1 Mac run `export DOCKER_DEFAULT_PLATFORM=linux/amd64` first.\n\nThe service should take a few minutes to start up.\n\nRun `bin/cv-depot --help` for more help on the command line tool.\n\n### ZSH Setup\n1. `bin/cv-depot` must be run from this repository's top level directory.\n2. Therefore, if using zsh, it is recommended that you paste the following line\n in your ~/.zshrc file:\n - `alias cv-depot=\"cd [parent dir]/cv-depot; bin/cv-depot\"`\n - Replace `[parent dir]` with the parent directory of this repository\n3. Consider adding the following line to your ~/.zshrc if you are using a M1 Mac:\n - `export DOCKER_DEFAULT_PLATFORM=linux/amd64`\n4. Running the `zsh-complete` command will enable tab completions of the cli\n commands, in the next shell session.\n\n For example:\n - `cv-depot [tab]` will show you all the cli options, which you can press\n tab to cycle through\n - `cv-depot docker-[tab]` will show you only the cli options that begin with\n \"docker-\"\n\n# Installation for Production\n\n### Python\n`pip install cv-depot`\n\n### Docker\n1. Install [docker-desktop](https://docs.docker.com/desktop/)\n2. `docker pull theNewFlesh/cv-depot:[version]`\n\n\n---\n\n# Quickstart Guide\nThis repository contains a suite commands for the whole development process.\nThis includes everything from testing, to documentation generation and\npublishing pip packages.\n\nThese commands can be accessed through:\n\n - The VSCode task runner\n - The VSCode task runner side bar\n - A terminal running on the host OS\n - A terminal within this repositories docker container\n\nRunning the `zsh-complete` command will enable tab completions of the CLI.\nSee the zsh setup section for more information.\n\n### Command Groups\n\nDevelopment commands are grouped by one of 10 prefixes:\n\n| Command | Description |\n| ---------- | ---------------------------------------------------------------------------------- |\n| build | Commands for building packages for testing and pip publishing |\n| docker | Common docker commands such as build, start and stop |\n| docs | Commands for generating documentation and code metrics |\n| library | Commands for managing python package dependencies |\n| session | Commands for starting interactive sessions such as jupyter lab and python |\n| state | Command to display the current state of the repo and container |\n| test | Commands for running tests, linter and type annotations |\n| version | Commands for bumping project versions |\n| quickstart | Display this quickstart guide |\n| zsh | Commands for running a zsh session in the container and generating zsh completions |\n\n### Common Commands\n\nHere are some frequently used commands to get you started:\n\n| Command | Description |\n| ----------------- | --------------------------------------------------------- |\n| docker-restart | Restart container |\n| docker-start | Start container |\n| docker-stop | Stop container |\n| docs-full | Generate documentation, coverage report, diagram and code |\n| library-add | Add a given package to a given dependency group |\n| library-graph-dev | Graph dependencies in dev environment |\n| library-remove | Remove a given package from a given dependency group |\n| library-search | Search for pip packages |\n| library-update | Update dev dependencies |\n| session-lab | Run jupyter lab server |\n| state | State of |\n| test-dev | Run all tests |\n| test-lint | Run linting and type checking |\n| zsh | Run ZSH session inside container |\n| zsh-complete | Generate ZSH completion script |\n\n---\n\n# Development CLI\nbin/cv-depot is a command line interface (defined in cli.py) that\nworks with any version of python 2.7 and above, as it has no dependencies.\nCommands generally do not expect any arguments or flags.\n\nIts usage pattern is: `bin/cv-depot COMMAND [-a --args]=ARGS [-h --help] [--dryrun]`\n\n### Commands\nThe following is a complete list of all available development commands:\n\n| Command | Description |\n| ----------------------- | ------------------------------------------------------------------- |\n| build-package | Build production version of repo for publishing |\n| build-prod | Publish pip package of repo to PyPi |\n| build-publish | Run production tests first then publish pip package of repo to PyPi |\n| build-test | Build test version of repo for prod testing |\n| docker-build | Build Docker image |\n| docker-build-from-cache | Build Docker image from registry cache |\n| docker-build-no-cache | Build Docker image without cache |\n| docker-build-prod | Build production image |\n| docker-container | Display the Docker container id |\n| docker-destroy | Shutdown container and destroy its image |\n| docker-destroy-prod | Shutdown production container and destroy its image |\n| docker-image | Display the Docker image id |\n| docker-prod | Start production container |\n| docker-pull-dev | Pull development image from Docker registry |\n| docker-pull-prod | Pull production image from Docker registry |\n| docker-push-dev | Push development image to Docker registry |\n| docker-push-dev-latest | Push development image to Docker registry with dev-latest tag |\n| docker-push-prod | Push production image to Docker registry |\n| docker-push-prod-latest | Push production image to Docker registry with prod-latest tag |\n| docker-remove | Remove Docker image |\n| docker-restart | Restart Docker container |\n| docker-start | Start Docker container |\n| docker-stop | Stop Docker container |\n| docs | Generate sphinx documentation |\n| docs-architecture | Generate architecture.svg diagram from all import statements |\n| docs-full | Generate documentation, coverage report, diagram and code |\n| docs-metrics | Generate code metrics report, plots and tables |\n| library-add | Add a given package to a given dependency group |\n| library-graph-dev | Graph dependencies in dev environment |\n| library-graph-prod | Graph dependencies in prod environment |\n| library-install-dev | Install all dependencies into dev environment |\n| library-install-prod | Install all dependencies into prod environment |\n| library-list-dev | List packages in dev environment |\n| library-list-prod | List packages in prod environment |\n| library-lock-dev | Resolve dev.lock file |\n| library-lock-prod | Resolve prod.lock file |\n| library-remove | Remove a given package from a given dependency group |\n| library-search | Search for pip packages |\n| library-sync-dev | Sync dev environment with packages listed in dev.lock |\n| library-sync-prod | Sync prod environment with packages listed in prod.lock |\n| library-update | Update dev dependencies |\n| library-update-pdm | Update PDM |\n| quickstart | Display quickstart guide |\n| session-lab | Run jupyter lab server |\n| session-python | Run python session with dev dependencies |\n| state | State of repository and Docker container |\n| test-coverage | Generate test coverage report |\n| test-dev | Run all tests |\n| test-fast | Test all code excepts tests marked with SKIP_SLOWS_TESTS decorator |\n| test-lint | Run linting and type checking |\n| test-prod | Run tests across all support python versions |\n| version | Full resolution of repo: dependencies, linting, tests, docs, etc |\n| version-bump-major | Bump pyproject major version |\n| version-bump-minor | Bump pyproject minor version |\n| version-bump-patch | Bump pyproject patch version |\n| version-commit | Tag with version and commit changes to master |\n| zsh | Run ZSH session inside Docker container |\n| zsh-complete | Generate oh-my-zsh completions |\n| zsh-root | Run ZSH session as root inside Docker container |\n\n### Flags\n\n| Short | Long | Description |\n| ----- | --------- | ---------------------------------------------------- |\n| -a | --args | Additional arguments, this can generally be ignored |\n| -h | --help | Prints command help message to stdout |\n| | --dryrun | Prints command that would otherwise be run to stdout |\n\n---\n\n# Production CLI\n\ncv-depot comes with a command line interface defined in command.py.\n\nIts usage pattern is: `cv-depot COMMAND [ARGS] [FLAGS] [-h --help]`\n\n## Commands\n\n---\n\n### bash-completion\nPrints BASH completion code to be written to a _cv-depot completion file\n\nUsage: `cv-depot bash-completion`\n\n---\n\n### zsh-completion\nPrints ZSH completion code to be written to a _cv-depot completion file\n\nUsage: `cv-depot zsh-completion`\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Computer Vision Tools",
"version": "0.1.3",
"project_urls": {
"documentation": "https://theNewFlesh.github.io/cv-depot",
"repository": "https://github.com/the-new-flesh/cv-depot"
},
"split_keywords": [
"openexr",
" exr",
" openexr",
" exr",
" computer-vision",
" cv",
" image",
" compositing"
],
"urls": [
{
"comment_text": "0.1.3",
"digests": {
"blake2b_256": "66bb59f39b277637fab20cae3fcc02c33ca9cf32cfd2251ff09b1147ab9f70ac",
"md5": "9306dea919af0c305397a80365084050",
"sha256": "607505841624c64f09ec0ae052e62f3428bc0c345601cd2c53613c07a37c5351"
},
"downloads": -1,
"filename": "cv_depot-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9306dea919af0c305397a80365084050",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 9055,
"upload_time": "2025-02-01T21:18:01",
"upload_time_iso_8601": "2025-02-01T21:18:01.797658Z",
"url": "https://files.pythonhosted.org/packages/66/bb/59f39b277637fab20cae3fcc02c33ca9cf32cfd2251ff09b1147ab9f70ac/cv_depot-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "0.1.3",
"digests": {
"blake2b_256": "17098c3c27e589f6e90098ad6b9ac456bee57db0202cc2177f58f9f203280018",
"md5": "f0294e8eed43aec545e7c9cf7a1e6f37",
"sha256": "a903eb63e8a19de9a5fcb4220520a31b282b4aea132ff07da9e77d5246852132"
},
"downloads": -1,
"filename": "cv-depot-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "f0294e8eed43aec545e7c9cf7a1e6f37",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 10805,
"upload_time": "2025-02-01T21:18:03",
"upload_time_iso_8601": "2025-02-01T21:18:03.719266Z",
"url": "https://files.pythonhosted.org/packages/17/09/8c3c27e589f6e90098ad6b9ac456bee57db0202cc2177f58f9f203280018/cv-depot-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-01 21:18:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "the-new-flesh",
"github_project": "cv-depot",
"github_not_found": true,
"lcname": "cv-depot"
}
JSON
