# CloudBlue Connect Command Line Interface
 [](https://pypi.org/project/connect-cli/)    [](https://sonarcloud.io/summary/new_code?id=connect-cli) [](https://sonarcloud.io/summary/new_code?id=connect-cli)
## Introduction
The CloudBlue Connect Command Line Interface (CLI) is an extensible unified tool to perform various automation scenarios. With just one tool, you can control multiple Connect modules from the command line and automate them through scripts.
Since it is extensible, users can write their own plugins to extend its functionalities.
## Install
### Prerequisites
`connect-cli` depends on [Git](https://git-scm.com/), [Cairo](https://www.cairographics.org/),
[Pango](https://pango.gnome.org/) and [GDK-PixBuf](https://developer.gnome.org/gdk-pixbuf/stable/).
Please refers to the platform-specific instructions on how to install these dependecies:
* [Linux](docs/linux_deps_install.md)
* [Mac OS](docs/osx_deps_install.md)
* [Windows](docs/win_deps_install.md)
### Using PIP
To use `connect-cli` you need a system with python 3.8 or later installed.
```sh
$ pip install --upgrade connect-cli
```
### Using Docker
To use the Docker image of `connect-cli`:
```sh
$ docker run -it -v $HOME/.ccli:/home/connect/.ccli cloudblueconnect/connect-cli ccli
```
Please refer to the [`connect-cli` docker image documentation](https://hub.docker.com/r/cloudblueconnect/connect-cli) for more information.
### Using Homebrew on Mac OS
To install `connect-cli` with homebrew run:
```sh
$ brew update
$ brew tap cloudblue/connect
$ brew install cloudblue/connect/connect-cli
```
### Using the installer on Windows
An installer package is available for Windows 10 or newer.
You can download its zip file from the [Github Releases](https://github.com/cloudblue/connect-cli/releases) page.
## Usage
* [General](docs/core_usage.md)
* [Locales](docs/locales_usage.md)
* [Products](docs/products_usage.md)
* [Customers](docs/customers_usage.md)
* [Reports](docs/reports_usage.md)
* [Translations](docs/translations_usage.md)
* [Projects](docs/project_usage.md)
* [Streams](docs/stream_usage.md)
## Development
We use `isort` library to order and format our imports, and we check it using `flake8-isort` library (automatically on `flake8` run).
For convenience you may run `poetry run isort .` to order imports.
## Run tests
`connect-cli` uses [poetry](https://python-poetry.org/) for dependencies management and packaging.
To run the `connect-cli` tests suite run:
```
$ pip install poetry
$ poetry install
$ poetry run pytest
```
## License
`connect-cli` is released under the [Apache License Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).
Raw data
{
"_id": null,
"home_page": "https://connect.cloudblue.com",
"name": "connect-cli",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4",
"maintainer_email": "",
"keywords": "fulfillment,command,line,interface,utility,cli,vendor,connect,cloudblue",
"author": "CloudBlue LLC",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/a9/3d/cca39778c6159709cd4268c517275074e5adc515724c8affa4231689148c/connect_cli-31.0.tar.gz",
"platform": null,
"description": "# CloudBlue Connect Command Line Interface\n\n [](https://pypi.org/project/connect-cli/)    [](https://sonarcloud.io/summary/new_code?id=connect-cli) [](https://sonarcloud.io/summary/new_code?id=connect-cli)\n\n## Introduction\n\nThe CloudBlue Connect Command Line Interface (CLI) is an extensible unified tool to perform various automation scenarios. With just one tool, you can control multiple Connect modules from the command line and automate them through scripts.\n\nSince it is extensible, users can write their own plugins to extend its functionalities.\n\n\n## Install\n\n### Prerequisites\n\n`connect-cli` depends on [Git](https://git-scm.com/), [Cairo](https://www.cairographics.org/),\n[Pango](https://pango.gnome.org/) and [GDK-PixBuf](https://developer.gnome.org/gdk-pixbuf/stable/).\n\nPlease refers to the platform-specific instructions on how to install these dependecies:\n\n* [Linux](docs/linux_deps_install.md)\n* [Mac OS](docs/osx_deps_install.md)\n* [Windows](docs/win_deps_install.md)\n\n\n### Using PIP\n\nTo use `connect-cli` you need a system with python 3.8 or later installed.\n\n```sh\n $ pip install --upgrade connect-cli\n```\n\n### Using Docker\n\nTo use the Docker image of `connect-cli`:\n\n```sh\n $ docker run -it -v $HOME/.ccli:/home/connect/.ccli cloudblueconnect/connect-cli ccli\n```\n\nPlease refer to the [`connect-cli` docker image documentation](https://hub.docker.com/r/cloudblueconnect/connect-cli) for more information.\n\n\n### Using Homebrew on Mac OS\n\nTo install `connect-cli` with homebrew run:\n\n```sh\n $ brew update\n $ brew tap cloudblue/connect\n $ brew install cloudblue/connect/connect-cli\n```\n\n### Using the installer on Windows\n\nAn installer package is available for Windows 10 or newer.\nYou can download its zip file from the [Github Releases](https://github.com/cloudblue/connect-cli/releases) page.\n\n\n\n## Usage\n\n* [General](docs/core_usage.md)\n* [Locales](docs/locales_usage.md)\n* [Products](docs/products_usage.md)\n* [Customers](docs/customers_usage.md)\n* [Reports](docs/reports_usage.md)\n* [Translations](docs/translations_usage.md)\n* [Projects](docs/project_usage.md)\n* [Streams](docs/stream_usage.md)\n\n\n## Development\nWe use `isort` library to order and format our imports, and we check it using `flake8-isort` library (automatically on `flake8` run). \nFor convenience you may run `poetry run isort .` to order imports.\n\n\n## Run tests\n\n`connect-cli` uses [poetry](https://python-poetry.org/) for dependencies management and packaging.\n\nTo run the `connect-cli` tests suite run:\n\n```\n$ pip install poetry\n$ poetry install\n$ poetry run pytest\n```\n\n\n## License\n\n`connect-cli` is released under the [Apache License Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "CloudBlue Connect Command Line Interface",
"version": "31.0",
"project_urls": {
"Documentation": "https://connect.cloudblue.com/community/sdk/cli/",
"Homepage": "https://connect.cloudblue.com",
"Repository": "https://github.com/cloudblue/connect-cli"
},
"split_keywords": [
"fulfillment",
"command",
"line",
"interface",
"utility",
"cli",
"vendor",
"connect",
"cloudblue"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e273d10abd7b4dde3323059486c4b868abbd41664a64f6b850f43f3c7341fe21",
"md5": "0d7f0e89495e58d12acb0e805031f2e0",
"sha256": "71c06a769e6544560b2501210fa5f654fd367a5536a44f13b7db2f797fd46fe0"
},
"downloads": -1,
"filename": "connect_cli-31.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0d7f0e89495e58d12acb0e805031f2e0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4",
"size": 1292984,
"upload_time": "2024-03-01T09:39:11",
"upload_time_iso_8601": "2024-03-01T09:39:11.205674Z",
"url": "https://files.pythonhosted.org/packages/e2/73/d10abd7b4dde3323059486c4b868abbd41664a64f6b850f43f3c7341fe21/connect_cli-31.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a93dcca39778c6159709cd4268c517275074e5adc515724c8affa4231689148c",
"md5": "3b9a41826aa10ccdadfd025ebe253a4b",
"sha256": "1cc0f0352fda93a05faee0e2fe151281db9fe2e0d76f9d2587b9dd8b03b172c6"
},
"downloads": -1,
"filename": "connect_cli-31.0.tar.gz",
"has_sig": false,
"md5_digest": "3b9a41826aa10ccdadfd025ebe253a4b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4",
"size": 1146918,
"upload_time": "2024-03-01T09:39:14",
"upload_time_iso_8601": "2024-03-01T09:39:14.244199Z",
"url": "https://files.pythonhosted.org/packages/a9/3d/cca39778c6159709cd4268c517275074e5adc515724c8affa4231689148c/connect_cli-31.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-01 09:39:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cloudblue",
"github_project": "connect-cli",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "connect-cli"
}
JSON
