acqua


Nameacqua JSON
Version 0.1.4 PyPI version JSON
download
home_pageNone
SummaryNone
upload_time2024-11-08 18:23:31
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseNone
keywords anonymous bitcoin cli lightning terminal tui ui user-interface
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Acqua 

[![Docker](https://img.shields.io/badge/docker-2496ED?&logo=docker&logoColor=white)](https://hub.docker.com)
[![Top](https://img.shields.io/github/languages/top/aekasitt/acqua)](https://github.com/aekasitt/acqua)
[![Languages](https://img.shields.io/github/languages/count/aekasitt/acqua)](https://github.com/aekasitt/acqua)
[![Size](https://img.shields.io/github/repo-size/aekasitt/acqua)](https://github.com/aekasitt/acqua)
[![Last commit](https://img.shields.io/github/last-commit/aekasitt/acqua/master)](https://github.com/aekasitt/acqua)

[![Acqua Banner](static/acqua-banner.svg)](https://github.com/aekasitt/acqua/blob/master/static/acqua-banner.svg)

## Getting started

You can use `acqua` simply by installing via `pip` on your Terminal.

```sh
pip install acqua
```
<details>
  <summary> Sample output when running install command </summary>

![Sample Pip Install](https://github.com/aekasitt/acqua/blob/master/static/pip-install.gif)

</details>

And build required images with `build` command. The following shows you how to build a `Testnet`
Sui Validator node with one-command.

```sh
acqua pull --mainnet
```

<details>
  <summary> Sample output when running pull command </summary>

![Sample Acqua Build](https://github.com/aekasitt/acqua/blob/master/static/acqua-pull.gif)

</details>

The initial pull may take some time as it is downloading source codes from different repositories
and interfacing with `Docker Daemon` to build according to flagged requirements. Once the pull
process completes, you can begin deploying local network with middlewares as such:

```sh
acqua deploy --mainnet
```

Note: If you do not have `postgres:latest` image in your local Docker image registry, this may
take some time to deploy on your first run.

<details>
<summary>Sample output when running deploy command</summary>

![Sample Acqua Deploy](https://github.com/aekasitt/acqua/blob/master/static/acqua-deploy.gif)


</details>

You will have docker containers running in the backend, ready to be interfaced by your local
environment applications you are developing.

## Dashboard

Acqua not only facilitates the deployment of [Bitcoin](https://twentyone.world) services
such as the [Sui](https://sui.io) Validator node with a PoW relay, but allows you to view
Node's Blockchain Information, Mempool Information, Peripheral Details and etc.

In order to view relevant metrics, launch the dashboard using the following command.

```sh
acqua dashboard
```

<details>
  <summary> Sample output when running dashboard command </summary>

![Sample Acqua Dashboard](https://github.com/aekasitt/acqua/blob/master/static/acqua-dashboard.gif)
</details>

## Contributions

### Prerequisites

* [python](https://www.python.org) version 3.9 and above
* [uv](https://docs.astral.sh/uv)
* [docker](https://www.docker.com)

### Set up local environment

The following guide walks through setting up your local working environment using `pyenv`
as Python version manager and `uv` as Python package manager. If you do not have `pyenv`
installed, run the following command.

<details>
  <summary> Install using Homebrew (Darwin) </summary>
  
  ```sh
  brew install pyenv --head
  ```
</details>

<details>
  <summary> Install using standalone installer (Darwin and Linux) </summary>
  
  ```sh
  curl https://pyenv.run | bash
  ```
</details>

If you do not have `uv` installed, run the following command.

<details>
  <summary> Install using Homebrew (Darwin) </summary>

  ```sh
  brew install uv
  ```
</details>

<details>
  <summary> Install using standalone installer (Darwin and Linux) </summary>

  ```sh
  curl -LsSf https://astral.sh/uv/install.sh | sh
  ```
</details>


Once you have `pyenv` Python version manager installed, you can
install any version of Python above version 3.8 for this project.
The following commands help you set up and activate a Python virtual
environment where `uv` can download project dependencies from the `PyPI`
open-sourced registry defined under `pyproject.toml` file.

<details>
  <summary> Set up environment and synchronize project dependencies </summary>

  ```sh
  pyenv shell 3.11.9
  uv venv  --python-preference system
  source .venv/bin/activate
  uv sync --dev
  ```
</details>

Now you have the entire project set-up and ready to be tinkered with. Try out the
standard `acqua` command which brings up a help menu.

<details>
  <summary> Launch Acqua Help </summary>

  ```sh
  $ acqua
  >  Usage: acqua [OPTIONS] COMMAND [ARGS]...
  > 
  >  acqua 
  > 
  > Options:
  >   --help  Show this message and exit.
  > 
  > Commands:
  >   auth       Persist authentications in desired run-control file.
  >   build      Build peripheral images for the desired cluster.
  >   clean      Remove all active "acqua-*" containers, drop network.
  >   dashboard  Dashboard for checking current state of images deployed.
  >   deploy     Deploy cluster.
  >   pull       Pull core and peripheral images from GitHub container registry
  ```
</details>

### Known issues

You may run into this setback when first running this project. This is a
[docker-py](https://github.com/docker/docker-py/issues/3059) issue widely known as of October 2022.

```python
docker.errors.DockerException:
  Error while fetching server API version: (
    'Connection aborted.', FileNotFoundError(
      2, 'No such file or directory'
    )
  )
```

See the following issue for Mac OSX troubleshooting.
[docker from_env and pull is broken on mac](https://github.com/docker/docker-py/issues/3059#issuecomment-1294369344)
Recommended fix is to run the following command:

```sh
sudo ln -s "$HOME/.docker/run/docker.sock" /var/run/docker.sock
```

## License

This project is licensed under the terms of the MIT license.


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "acqua",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "anonymous, bitcoin, cli, lightning, terminal, tui, ui, user-interface",
    "author": null,
    "author_email": "Sitt Guruvanich <aekasitt.g+github@siamintech.co.th>",
    "download_url": "https://files.pythonhosted.org/packages/0a/2d/9d5ee35399c6271d33e921fdad70aaf14b973910eada62c6877732991ee2/acqua-0.1.4.tar.gz",
    "platform": null,
    "description": "# Acqua \n\n[![Docker](https://img.shields.io/badge/docker-2496ED?&logo=docker&logoColor=white)](https://hub.docker.com)\n[![Top](https://img.shields.io/github/languages/top/aekasitt/acqua)](https://github.com/aekasitt/acqua)\n[![Languages](https://img.shields.io/github/languages/count/aekasitt/acqua)](https://github.com/aekasitt/acqua)\n[![Size](https://img.shields.io/github/repo-size/aekasitt/acqua)](https://github.com/aekasitt/acqua)\n[![Last commit](https://img.shields.io/github/last-commit/aekasitt/acqua/master)](https://github.com/aekasitt/acqua)\n\n[![Acqua Banner](static/acqua-banner.svg)](https://github.com/aekasitt/acqua/blob/master/static/acqua-banner.svg)\n\n## Getting started\n\nYou can use `acqua` simply by installing via `pip` on your Terminal.\n\n```sh\npip install acqua\n```\n<details>\n  <summary> Sample output when running install command </summary>\n\n![Sample Pip Install](https://github.com/aekasitt/acqua/blob/master/static/pip-install.gif)\n\n</details>\n\nAnd build required images with `build` command. The following shows you how to build a `Testnet`\nSui Validator node with one-command.\n\n```sh\nacqua pull --mainnet\n```\n\n<details>\n  <summary> Sample output when running pull command </summary>\n\n![Sample Acqua Build](https://github.com/aekasitt/acqua/blob/master/static/acqua-pull.gif)\n\n</details>\n\nThe initial pull may take some time as it is downloading source codes from different repositories\nand interfacing with `Docker Daemon` to build according to flagged requirements. Once the pull\nprocess completes, you can begin deploying local network with middlewares as such:\n\n```sh\nacqua deploy --mainnet\n```\n\nNote: If you do not have `postgres:latest` image in your local Docker image registry, this may\ntake some time to deploy on your first run.\n\n<details>\n<summary>Sample output when running deploy command</summary>\n\n![Sample Acqua Deploy](https://github.com/aekasitt/acqua/blob/master/static/acqua-deploy.gif)\n\n\n</details>\n\nYou will have docker containers running in the backend, ready to be interfaced by your local\nenvironment applications you are developing.\n\n## Dashboard\n\nAcqua not only facilitates the deployment of [Bitcoin](https://twentyone.world) services\nsuch as the [Sui](https://sui.io) Validator node with a PoW relay, but allows you to view\nNode's Blockchain Information, Mempool Information, Peripheral Details and etc.\n\nIn order to view relevant metrics, launch the dashboard using the following command.\n\n```sh\nacqua dashboard\n```\n\n<details>\n  <summary> Sample output when running dashboard command </summary>\n\n![Sample Acqua Dashboard](https://github.com/aekasitt/acqua/blob/master/static/acqua-dashboard.gif)\n</details>\n\n## Contributions\n\n### Prerequisites\n\n* [python](https://www.python.org) version 3.9 and above\n* [uv](https://docs.astral.sh/uv)\n* [docker](https://www.docker.com)\n\n### Set up local environment\n\nThe following guide walks through setting up your local working environment using `pyenv`\nas Python version manager and `uv` as Python package manager. If you do not have `pyenv`\ninstalled, run the following command.\n\n<details>\n  <summary> Install using Homebrew (Darwin) </summary>\n  \n  ```sh\n  brew install pyenv --head\n  ```\n</details>\n\n<details>\n  <summary> Install using standalone installer (Darwin and Linux) </summary>\n  \n  ```sh\n  curl https://pyenv.run | bash\n  ```\n</details>\n\nIf you do not have `uv` installed, run the following command.\n\n<details>\n  <summary> Install using Homebrew (Darwin) </summary>\n\n  ```sh\n  brew install uv\n  ```\n</details>\n\n<details>\n  <summary> Install using standalone installer (Darwin and Linux) </summary>\n\n  ```sh\n  curl -LsSf https://astral.sh/uv/install.sh | sh\n  ```\n</details>\n\n\nOnce you have `pyenv` Python version manager installed, you can\ninstall any version of Python above version 3.8 for this project.\nThe following commands help you set up and activate a Python virtual\nenvironment where `uv` can download project dependencies from the `PyPI`\nopen-sourced registry defined under `pyproject.toml` file.\n\n<details>\n  <summary> Set up environment and synchronize project dependencies </summary>\n\n  ```sh\n  pyenv shell 3.11.9\n  uv venv  --python-preference system\n  source .venv/bin/activate\n  uv sync --dev\n  ```\n</details>\n\nNow you have the entire project set-up and ready to be tinkered with. Try out the\nstandard `acqua` command which brings up a help menu.\n\n<details>\n  <summary> Launch Acqua Help </summary>\n\n  ```sh\n  $ acqua\n  >  Usage: acqua [OPTIONS] COMMAND [ARGS]...\n  > \n  >  acqua \n  > \n  > Options:\n  >   --help  Show this message and exit.\n  > \n  > Commands:\n  >   auth       Persist authentications in desired run-control file.\n  >   build      Build peripheral images for the desired cluster.\n  >   clean      Remove all active \"acqua-*\" containers, drop network.\n  >   dashboard  Dashboard for checking current state of images deployed.\n  >   deploy     Deploy cluster.\n  >   pull       Pull core and peripheral images from GitHub container registry\n  ```\n</details>\n\n### Known issues\n\nYou may run into this setback when first running this project. This is a\n[docker-py](https://github.com/docker/docker-py/issues/3059) issue widely known as of October 2022.\n\n```python\ndocker.errors.DockerException:\n  Error while fetching server API version: (\n    'Connection aborted.', FileNotFoundError(\n      2, 'No such file or directory'\n    )\n  )\n```\n\nSee the following issue for Mac OSX troubleshooting.\n[docker from_env and pull is broken on mac](https://github.com/docker/docker-py/issues/3059#issuecomment-1294369344)\nRecommended fix is to run the following command:\n\n```sh\nsudo ln -s \"$HOME/.docker/run/docker.sock\" /var/run/docker.sock\n```\n\n## License\n\nThis project is licensed under the terms of the MIT license.\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": null,
    "version": "0.1.4",
    "project_urls": null,
    "split_keywords": [
        "anonymous",
        " bitcoin",
        " cli",
        " lightning",
        " terminal",
        " tui",
        " ui",
        " user-interface"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "e2a424cc69e08db718e16a2e813861295d36320b1c6423f7390dc2f7b347746b",
                "md5": "4ddc4a5c6b8436f87dd2b8a751b0e7dd",
                "sha256": "0ddbcf96bdf998a1513cc2ed050a1862f200024ddb2c6225f1addd1f5c03435f"
            },
            "downloads": -1,
            "filename": "acqua-0.1.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4ddc4a5c6b8436f87dd2b8a751b0e7dd",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 29091,
            "upload_time": "2024-11-08T18:23:15",
            "upload_time_iso_8601": "2024-11-08T18:23:15.829999Z",
            "url": "https://files.pythonhosted.org/packages/e2/a4/24cc69e08db718e16a2e813861295d36320b1c6423f7390dc2f7b347746b/acqua-0.1.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "0a2d9d5ee35399c6271d33e921fdad70aaf14b973910eada62c6877732991ee2",
                "md5": "b8a54b9053744ec8b00fe198b8851776",
                "sha256": "ef881ec732f696ccd7a5835848c646375439c22871d0731d0ca12709d2000cd4"
            },
            "downloads": -1,
            "filename": "acqua-0.1.4.tar.gz",
            "has_sig": false,
            "md5_digest": "b8a54b9053744ec8b00fe198b8851776",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 7418277,
            "upload_time": "2024-11-08T18:23:31",
            "upload_time_iso_8601": "2024-11-08T18:23:31.615646Z",
            "url": "https://files.pythonhosted.org/packages/0a/2d/9d5ee35399c6271d33e921fdad70aaf14b973910eada62c6877732991ee2/acqua-0.1.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-08 18:23:31",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "acqua"
}
        
Elapsed time: 0.43589s