nua

Name	nua JSON
Version	0.5.43 JSON
	download
home_page	https://github.com/abilian/nua
Summary	Command line interface for the Nua self-hosted PaaS (Platform as a Service)
upload_time	2023-10-09 21:19:18
maintainer
docs_url	None
author	Stefane Fermigier
requires_python	>=3.10,<3.12
license	Apache-2.0
keywords
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # nua-cli: CLI for NUA (for users)

Command-line interface for Nua.

[Nua](https://nua.rocks/) is an open source, self-hosted cloud platform project (a PaaS - platform as a service).

Used by developers and devops people to deploy and manage applications.

## Installation

### From PyPI

On PyPI the package is called just `nua` (not `nua-cli`) as it is the main interface for Nua users.

```bash
pipx install nua
nua
```

### From source

When developing nua-cli, you can install it from the source repository:
```bash
pipx install --force "git+https://github.com/abilian/nua.git#subdirectory=nua-cli"
```

Or, in editable mode, from your local clone:
```bash
pipx install --force -e path/to/nua/nua-cli
```

## Usage

```bash
nua --help
# or
nua [command] [options]
```

### Main commands and subcommands

Here's the list of commands and subcommands provided by nua-cli (some of them are not yet implemented):

```
nua (0.5.17)

Usage:
  nua <command> [options] [arguments]

Options:
  -V  Show version and exit
  -d  Enable debug mode
  -v  Increase verbosity

Available commands:
  apps     List applications.
  backup   Backup a deployed application.
  build    Build app but don't deploy it.
  deploy   Deploy app.
  destroy  Destroy an application.
  help     Show help.
  logs     Show application logs.
  restart  Restart an application.
  restore  Restore backup data of a deployed application.
  start    Start an application.
  stop     Stop an application.
  update   Update an application.

 config
  config show      Show application config.

 env
  env set          Show application env variables.
  env show         Show application env variables.

 server
  server cleanup   Cleanup server (remove inactive docker images and containers).
  server logs      Show server logs.
  server ps        List all server processes.
  server settings  Show server settings.
  server status    Show Nua status.
  server uptime    Show server uptime.
```


<!-- TODO: add more specific examples -->


## Development

### Dependency graph

![Dependency graph](./doc/dependency-graph.png)


            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/abilian/nua",
    "name": "nua",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.10,<3.12",
    "maintainer_email": "",
    "keywords": "",
    "author": "Stefane Fermigier",
    "author_email": "sf@abilian.com",
    "download_url": "https://files.pythonhosted.org/packages/cb/a7/21867dc675e757721346935785893a3c33bb9aa8e471c7487fe4603f27d2/nua-0.5.43.tar.gz",
    "platform": null,
    "description": "# nua-cli: CLI for NUA (for users)\n\nCommand-line interface for Nua.\n\n[Nua](https://nua.rocks/) is an open source, self-hosted cloud platform project (a PaaS - platform as a service).\n\nUsed by developers and devops people to deploy and manage applications.\n\n## Installation\n\n### From PyPI\n\nOn PyPI the package is called just `nua` (not `nua-cli`) as it is the main interface for Nua users.\n\n```bash\npipx install nua\nnua\n```\n\n### From source\n\nWhen developing nua-cli, you can install it from the source repository:\n```bash\npipx install --force \"git+https://github.com/abilian/nua.git#subdirectory=nua-cli\"\n```\n\nOr, in editable mode, from your local clone:\n```bash\npipx install --force -e path/to/nua/nua-cli\n```\n\n## Usage\n\n```bash\nnua --help\n# or\nnua [command] [options]\n```\n\n### Main commands and subcommands\n\nHere's the list of commands and subcommands provided by nua-cli (some of them are not yet implemented):\n\n```\nnua (0.5.17)\n\nUsage:\n  nua <command> [options] [arguments]\n\nOptions:\n  -V  Show version and exit\n  -d  Enable debug mode\n  -v  Increase verbosity\n\nAvailable commands:\n  apps     List applications.\n  backup   Backup a deployed application.\n  build    Build app but don't deploy it.\n  deploy   Deploy app.\n  destroy  Destroy an application.\n  help     Show help.\n  logs     Show application logs.\n  restart  Restart an application.\n  restore  Restore backup data of a deployed application.\n  start    Start an application.\n  stop     Stop an application.\n  update   Update an application.\n\n config\n  config show      Show application config.\n\n env\n  env set          Show application env variables.\n  env show         Show application env variables.\n\n server\n  server cleanup   Cleanup server (remove inactive docker images and containers).\n  server logs      Show server logs.\n  server ps        List all server processes.\n  server settings  Show server settings.\n  server status    Show Nua status.\n  server uptime    Show server uptime.\n```\n\n\n<!-- TODO: add more specific examples -->\n\n\n## Development\n\n### Dependency graph\n\n![Dependency graph](./doc/dependency-graph.png)\n\n",
    "bugtrack_url": null,
    "license": "Apache-2.0",
    "summary": "Command line interface for the Nua self-hosted PaaS (Platform as a Service)",
    "version": "0.5.43",
    "project_urls": {
        "Documentation": "https://nua.rocks/",
        "Homepage": "https://github.com/abilian/nua",
        "Repository": "https://github.com/abilian/nua"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "fe2200f76ca8185801d32db80c061e634cf336d2b5db12897aa2af5a8c8ebc72",
                "md5": "4ab9a25dfdec00630647ddfcfb8a2bd4",
                "sha256": "e8059cc9b45c23d987999bbf82f90f16e8c6b85dfc302bdc88c396b3600838f4"
            },
            "downloads": -1,
            "filename": "nua-0.5.43-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4ab9a25dfdec00630647ddfcfb8a2bd4",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10,<3.12",
            "size": 12538,
            "upload_time": "2023-10-09T21:19:16",
            "upload_time_iso_8601": "2023-10-09T21:19:16.504028Z",
            "url": "https://files.pythonhosted.org/packages/fe/22/00f76ca8185801d32db80c061e634cf336d2b5db12897aa2af5a8c8ebc72/nua-0.5.43-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "cba721867dc675e757721346935785893a3c33bb9aa8e471c7487fe4603f27d2",
                "md5": "c61860034c1b72d650880fd9647afd7f",
                "sha256": "624bd64ea311a639154ab926905f481e3593676e86a0713bc1f1b4d317391ff8"
            },
            "downloads": -1,
            "filename": "nua-0.5.43.tar.gz",
            "has_sig": false,
            "md5_digest": "c61860034c1b72d650880fd9647afd7f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10,<3.12",
            "size": 8632,
            "upload_time": "2023-10-09T21:19:18",
            "upload_time_iso_8601": "2023-10-09T21:19:18.093121Z",
            "url": "https://files.pythonhosted.org/packages/cb/a7/21867dc675e757721346935785893a3c33bb9aa8e471c7487fe4603f27d2/nua-0.5.43.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-10-09 21:19:18",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "abilian",
    "github_project": "nua",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "nua"
}