diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-vgs-cli.spec | 375 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 377 insertions, 0 deletions
@@ -0,0 +1 @@ +/vgs-cli-1.19.0.tar.gz diff --git a/python-vgs-cli.spec b/python-vgs-cli.spec new file mode 100644 index 0000000..b369026 --- /dev/null +++ b/python-vgs-cli.spec @@ -0,0 +1,375 @@ +%global _empty_manifest_terminate_build 0 +Name: python-vgs-cli +Version: 1.19.0 +Release: 1 +Summary: VGS Client +License: BSD +URL: https://github.com/verygoodsecurity/vgs-cli +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/d1/ce/bff537cfc956bf587ae39d572dc05de7706a90130bab414a0b6e76e7ed85/vgs-cli-1.19.0.tar.gz +BuildArch: noarch + + +%description +# VGS CLI +[](https://circleci.com/gh/verygoodsecurity/vgs-cli/tree/master) + +Command Line Tool for programmatic configurations on VGS. + +[Official Documentation](https://www.verygoodsecurity.com/docs/vgs-cli/getting-started) + +## Table of Contents + +- [Requirements](#requirements) +- [Installation](#installation) + - [PyPI](#pypi) +- [Run](#run) +- [Running in Docker](#running-in-docker) +- [Commands](#commands) +- [Automation with VGS CLI](#automation-with-vgs-cli) +- [Sphinx Documentation](#sphinx-documentation) +- [Plugins Development](#plugins-development) + +## Requirements +[Python 3](https://www.python.org/downloads/) or [Docker](https://docs.docker.com/get-docker/). + +## Installation + +### PyPI +Install the latest version from [PyPI](https://pypi.org/project/vgs-cli/): +``` +pip install vgs-cli +``` + +## Run + +Verify your installation by running: +``` +vgs --version +``` + +## Running in Docker + +Check our [official documentation](https://www.verygoodsecurity.com/docs/vgs-cli/docker). + +## Commands + +- [`help`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#exploring-the-cli) +- [`login`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#login) +- [`logout`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#logout) +- [`routes get`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#get) +- [`routes apply`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#apply) +- [`logs access`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#access) +- [`access-credentials get`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#get) +- [`access-credentials generate`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#generate) +- [`organizations get`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#get) +- [`vaults get`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#get) + +## Automation with VGS CLI + +If you want to use the VGS CLI for automation you might be interested in creating a [service account](https://www.verygoodsecurity.com/docs/vgs-cli/service-account). + +## Sphinx Documentation + +In order to generate [Sphinx](https://www.sphinx-doc.org/en/master/index.html) documentation: +``` +pip install -r dev-requirements.txt +cd docs +make html +``` +Check the generated docs: +``` +open build/html/index.html +``` + +## Plugins Development + +See [Click - Developing Plugins](https://github.com/click-contrib/click-plugins#developing-plugins). + +In order to develop a plugin you need to register your commands to an entrypoint in `setup.py`. + +Supported entrypoints: + +- `vgs.plugins` - for extending `vgs` with sub-commands +- `vgs.get.plugins` - for extending `vgs get` with sub-commands +- `vgs.apply.plugins` - for extending `vgs apply` with sub-commands +- `vgs.logs.plugins` - for extending `vgs logs` with sub-commands + +Example: +```python +entry_points=''' + [vgs.plugins] + activate=vgscliplugin.myplugin:new_command + + [vgs.get.plugins] + preferences=vgscliplugin.myplugin:new_get_command +''' +``` + +### Plugin catalog +- [vgs-cli-admin-plugin](https://github.com/verygoodsecurity/vgs-cli-admin-plugin) +- [vgs-cli-marketplace-plugin](https://github.com/verygoodsecurity/vgs-cli-marketplace-plugin) +- [vgs-cli-marketplace-dev-plugin](https://github.com/verygoodsecurity/vgs-cli-marketplace-dev-plugin) +- [vgs-cli-compute-plugin](https://github.com/verygoodsecurity/vgs-cli-compute-plugin) +- [vgs-cli-athena-plugin](https://github.com/verygoodsecurity/vgs-cli-athena-plugin) + + +%package -n python3-vgs-cli +Summary: VGS Client +Provides: python-vgs-cli +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-vgs-cli +# VGS CLI +[](https://circleci.com/gh/verygoodsecurity/vgs-cli/tree/master) + +Command Line Tool for programmatic configurations on VGS. + +[Official Documentation](https://www.verygoodsecurity.com/docs/vgs-cli/getting-started) + +## Table of Contents + +- [Requirements](#requirements) +- [Installation](#installation) + - [PyPI](#pypi) +- [Run](#run) +- [Running in Docker](#running-in-docker) +- [Commands](#commands) +- [Automation with VGS CLI](#automation-with-vgs-cli) +- [Sphinx Documentation](#sphinx-documentation) +- [Plugins Development](#plugins-development) + +## Requirements +[Python 3](https://www.python.org/downloads/) or [Docker](https://docs.docker.com/get-docker/). + +## Installation + +### PyPI +Install the latest version from [PyPI](https://pypi.org/project/vgs-cli/): +``` +pip install vgs-cli +``` + +## Run + +Verify your installation by running: +``` +vgs --version +``` + +## Running in Docker + +Check our [official documentation](https://www.verygoodsecurity.com/docs/vgs-cli/docker). + +## Commands + +- [`help`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#exploring-the-cli) +- [`login`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#login) +- [`logout`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#logout) +- [`routes get`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#get) +- [`routes apply`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#apply) +- [`logs access`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#access) +- [`access-credentials get`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#get) +- [`access-credentials generate`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#generate) +- [`organizations get`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#get) +- [`vaults get`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#get) + +## Automation with VGS CLI + +If you want to use the VGS CLI for automation you might be interested in creating a [service account](https://www.verygoodsecurity.com/docs/vgs-cli/service-account). + +## Sphinx Documentation + +In order to generate [Sphinx](https://www.sphinx-doc.org/en/master/index.html) documentation: +``` +pip install -r dev-requirements.txt +cd docs +make html +``` +Check the generated docs: +``` +open build/html/index.html +``` + +## Plugins Development + +See [Click - Developing Plugins](https://github.com/click-contrib/click-plugins#developing-plugins). + +In order to develop a plugin you need to register your commands to an entrypoint in `setup.py`. + +Supported entrypoints: + +- `vgs.plugins` - for extending `vgs` with sub-commands +- `vgs.get.plugins` - for extending `vgs get` with sub-commands +- `vgs.apply.plugins` - for extending `vgs apply` with sub-commands +- `vgs.logs.plugins` - for extending `vgs logs` with sub-commands + +Example: +```python +entry_points=''' + [vgs.plugins] + activate=vgscliplugin.myplugin:new_command + + [vgs.get.plugins] + preferences=vgscliplugin.myplugin:new_get_command +''' +``` + +### Plugin catalog +- [vgs-cli-admin-plugin](https://github.com/verygoodsecurity/vgs-cli-admin-plugin) +- [vgs-cli-marketplace-plugin](https://github.com/verygoodsecurity/vgs-cli-marketplace-plugin) +- [vgs-cli-marketplace-dev-plugin](https://github.com/verygoodsecurity/vgs-cli-marketplace-dev-plugin) +- [vgs-cli-compute-plugin](https://github.com/verygoodsecurity/vgs-cli-compute-plugin) +- [vgs-cli-athena-plugin](https://github.com/verygoodsecurity/vgs-cli-athena-plugin) + + +%package help +Summary: Development documents and examples for vgs-cli +Provides: python3-vgs-cli-doc +%description help +# VGS CLI +[](https://circleci.com/gh/verygoodsecurity/vgs-cli/tree/master) + +Command Line Tool for programmatic configurations on VGS. + +[Official Documentation](https://www.verygoodsecurity.com/docs/vgs-cli/getting-started) + +## Table of Contents + +- [Requirements](#requirements) +- [Installation](#installation) + - [PyPI](#pypi) +- [Run](#run) +- [Running in Docker](#running-in-docker) +- [Commands](#commands) +- [Automation with VGS CLI](#automation-with-vgs-cli) +- [Sphinx Documentation](#sphinx-documentation) +- [Plugins Development](#plugins-development) + +## Requirements +[Python 3](https://www.python.org/downloads/) or [Docker](https://docs.docker.com/get-docker/). + +## Installation + +### PyPI +Install the latest version from [PyPI](https://pypi.org/project/vgs-cli/): +``` +pip install vgs-cli +``` + +## Run + +Verify your installation by running: +``` +vgs --version +``` + +## Running in Docker + +Check our [official documentation](https://www.verygoodsecurity.com/docs/vgs-cli/docker). + +## Commands + +- [`help`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#exploring-the-cli) +- [`login`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#login) +- [`logout`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#logout) +- [`routes get`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#get) +- [`routes apply`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#apply) +- [`logs access`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#access) +- [`access-credentials get`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#get) +- [`access-credentials generate`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#generate) +- [`organizations get`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#get) +- [`vaults get`](https://www.verygoodsecurity.com/docs/vgs-cli/commands#get) + +## Automation with VGS CLI + +If you want to use the VGS CLI for automation you might be interested in creating a [service account](https://www.verygoodsecurity.com/docs/vgs-cli/service-account). + +## Sphinx Documentation + +In order to generate [Sphinx](https://www.sphinx-doc.org/en/master/index.html) documentation: +``` +pip install -r dev-requirements.txt +cd docs +make html +``` +Check the generated docs: +``` +open build/html/index.html +``` + +## Plugins Development + +See [Click - Developing Plugins](https://github.com/click-contrib/click-plugins#developing-plugins). + +In order to develop a plugin you need to register your commands to an entrypoint in `setup.py`. + +Supported entrypoints: + +- `vgs.plugins` - for extending `vgs` with sub-commands +- `vgs.get.plugins` - for extending `vgs get` with sub-commands +- `vgs.apply.plugins` - for extending `vgs apply` with sub-commands +- `vgs.logs.plugins` - for extending `vgs logs` with sub-commands + +Example: +```python +entry_points=''' + [vgs.plugins] + activate=vgscliplugin.myplugin:new_command + + [vgs.get.plugins] + preferences=vgscliplugin.myplugin:new_get_command +''' +``` + +### Plugin catalog +- [vgs-cli-admin-plugin](https://github.com/verygoodsecurity/vgs-cli-admin-plugin) +- [vgs-cli-marketplace-plugin](https://github.com/verygoodsecurity/vgs-cli-marketplace-plugin) +- [vgs-cli-marketplace-dev-plugin](https://github.com/verygoodsecurity/vgs-cli-marketplace-dev-plugin) +- [vgs-cli-compute-plugin](https://github.com/verygoodsecurity/vgs-cli-compute-plugin) +- [vgs-cli-athena-plugin](https://github.com/verygoodsecurity/vgs-cli-athena-plugin) + + +%prep +%autosetup -n vgs-cli-1.19.0 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-vgs-cli -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Thu May 18 2023 Python_Bot <Python_Bot@openeuler.org> - 1.19.0-1 +- Package Spec generated @@ -0,0 +1 @@ +3ac068c31f53afb08768cf91aff4ffe9 vgs-cli-1.19.0.tar.gz |