# GAMA CLI
![GAMA CLI](./docs/gama_cli.png)
Publicly available on [PyPi](https://pypi.org/project/gama-cli/) for convenience but if you don't work at Greenroom Robotics, you probably don't want to use this.
## Install
* For development:
* `pip install -e ./libs/gama_config`
* `pip install -e ./tools/gama_cli`
* For production: `pip install gama-cli`
* You may also need to `export PATH=$PATH:~/.local/bin` if you don't have `~/.local/bin` in your path
* Install autocomplete:
* bash: `echo 'eval "$(_GAMA_CLI_COMPLETE=bash_source gama)"' >> ~/.bashrc`
* zsh: `echo 'eval "$(_GAMA_CLI_COMPLETE=zsh_source gama)"' >> ~/.zshrc` (this is much nicer)
## Usage
* `gama --help` to get help with the CLI
### Groundstation
Installing a GAMA on a groundstation is as simple as this:
* `mkdir ~/gama && cd ~/gama`
* `gama authenticate` to authenticate with the GAMA package registry
* `gama gs configure` to configure GAMA on a groundstation
* `gama gs install` to install GAMA on a groundstation
* `gama gs up` to start GAMA on a groundstation
* `gama gs down` to stop GAMA on a groundstation
### Vessel
Installing a GAMA on a vessel is as simple as this:
* `mkdir ~/gama && cd ~/gama`
* `gama authenticate` to authenticate with the GAMA package registry
* `gama vessel configure` to configure GAMA on a vessel
* `gama vessel install` to install GAMA on a vessel
* `gama vessel up` to start GAMA on a vessel
* `gama vessel down` to stop GAMA on a vessel
## Dev mode
GAMA CLI can be ran in dev mode. This will happen if it is installed with `pip install -e ./tools/gama_cli` or if the environment variable `GAMA_CLI_DEV_MODE` is set to `true`.
Raw data
{
"_id": null,
"home_page": "https://github.com/Greenroom-Robotics/gama",
"name": "gama-cli",
"maintainer": "David Revay",
"docs_url": null,
"requires_python": null,
"maintainer_email": "david.revay@greenroomrobotics.com",
"keywords": "colcon",
"author": "Greenroom Robotics",
"author_email": "team@greenroomrobotics.com",
"download_url": "https://files.pythonhosted.org/packages/51/5f/af0d110aa69641e9bad9402edaba645d078c4950ffbee59962f3484e51b5/gama_cli-2.3.0.tar.gz",
"platform": null,
"description": "# GAMA CLI\n\n![GAMA CLI](./docs/gama_cli.png)\n\nPublicly available on [PyPi](https://pypi.org/project/gama-cli/) for convenience but if you don't work at Greenroom Robotics, you probably don't want to use this.\n\n## Install\n\n* For development:\n * `pip install -e ./libs/gama_config`\n * `pip install -e ./tools/gama_cli`\n* For production: `pip install gama-cli`\n* You may also need to `export PATH=$PATH:~/.local/bin` if you don't have `~/.local/bin` in your path\n* Install autocomplete:\n * bash: `echo 'eval \"$(_GAMA_CLI_COMPLETE=bash_source gama)\"' >> ~/.bashrc`\n * zsh: `echo 'eval \"$(_GAMA_CLI_COMPLETE=zsh_source gama)\"' >> ~/.zshrc` (this is much nicer)\n\n## Usage\n\n* `gama --help` to get help with the CLI\n\n### Groundstation\n\nInstalling a GAMA on a groundstation is as simple as this:\n\n* `mkdir ~/gama && cd ~/gama`\n* `gama authenticate` to authenticate with the GAMA package registry\n* `gama gs configure` to configure GAMA on a groundstation\n* `gama gs install` to install GAMA on a groundstation\n* `gama gs up` to start GAMA on a groundstation\n* `gama gs down` to stop GAMA on a groundstation\n\n### Vessel\n\nInstalling a GAMA on a vessel is as simple as this:\n\n* `mkdir ~/gama && cd ~/gama`\n* `gama authenticate` to authenticate with the GAMA package registry\n* `gama vessel configure` to configure GAMA on a vessel\n* `gama vessel install` to install GAMA on a vessel\n* `gama vessel up` to start GAMA on a vessel\n* `gama vessel down` to stop GAMA on a vessel\n\n## Dev mode\n\nGAMA CLI can be ran in dev mode. This will happen if it is installed with `pip install -e ./tools/gama_cli` or if the environment variable `GAMA_CLI_DEV_MODE` is set to `true`.\n",
"bugtrack_url": null,
"license": "Copyright (C) 2023, Greenroom Robotics",
"summary": "A CLI for interacting with the GAMA platform",
"version": "2.3.0",
"project_urls": {
"Homepage": "https://github.com/Greenroom-Robotics/gama"
},
"split_keywords": [
"colcon"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "43606e11dbc9744982fb4598e3404a4e6431cfb45a7cc68051c8ea8427d348ad",
"md5": "9b164f97c0561f32be5e94d3349c5053",
"sha256": "9088b38ff76da086c1194647b89648fce534c99a636659b36ee25737ae150103"
},
"downloads": -1,
"filename": "gama_cli-2.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9b164f97c0561f32be5e94d3349c5053",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 21327,
"upload_time": "2024-04-16T22:15:07",
"upload_time_iso_8601": "2024-04-16T22:15:07.411283Z",
"url": "https://files.pythonhosted.org/packages/43/60/6e11dbc9744982fb4598e3404a4e6431cfb45a7cc68051c8ea8427d348ad/gama_cli-2.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "515faf0d110aa69641e9bad9402edaba645d078c4950ffbee59962f3484e51b5",
"md5": "5823aa1e2309bd5342a5055b5ad7adab",
"sha256": "8c459c6ceeaed2962ffb598ecfe5cf4b812339d38fdc290f4d5c9129e2205f34"
},
"downloads": -1,
"filename": "gama_cli-2.3.0.tar.gz",
"has_sig": false,
"md5_digest": "5823aa1e2309bd5342a5055b5ad7adab",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 13605,
"upload_time": "2024-04-16T22:15:09",
"upload_time_iso_8601": "2024-04-16T22:15:09.539587Z",
"url": "https://files.pythonhosted.org/packages/51/5f/af0d110aa69641e9bad9402edaba645d078c4950ffbee59962f3484e51b5/gama_cli-2.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-16 22:15:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Greenroom-Robotics",
"github_project": "gama",
"github_not_found": true,
"lcname": "gama-cli"
}