Metadata-Version: 2.1
Name: hexagon
Version: 0.60.0
Summary: Build your Team's CLI
Home-page: https://github.com/lt-mayonesa/hexagon
Author: Joaco Campero
Author-email: juacocampero@gmail.com
Project-URL: Bug Tracker, https://github.com/lt-mayonesa/hexagon/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: clipboard ==0.0.4
Requires-Dist: pyperclip ==1.9.0
Requires-Dist: wcwidth ==0.2.13
Requires-Dist: prompt-toolkit ==3.0.47 ; python_full_version >= "3.7.0"
Requires-Dist: rich ==13.7.1 ; python_full_version >= "3.7.0"
Requires-Dist: ruamel.yaml.clib ==0.2.8 ; python_version < "3.13" and platform_python_implementation == "CPython"
Requires-Dist: mdurl ==0.1.2 ; python_version >= "3.7"
Requires-Dist: ruamel.yaml ==0.18.6 ; python_version >= "3.7"
Requires-Dist: inquirerpy ==0.3.4 ; python_version >= "3.7" and python_version < "4.0"
Requires-Dist: pfzy ==0.3.4 ; python_version >= "3.7" and python_version < "4.0"
Requires-Dist: annotated-types ==0.7.0 ; python_version >= "3.8"
Requires-Dist: markdown ==3.6 ; python_version >= "3.8"
Requires-Dist: markdown-it-py ==3.0.0 ; python_version >= "3.8"
Requires-Dist: packaging ==24.1 ; python_version >= "3.8"
Requires-Dist: pydantic ==2.8.2 ; python_version >= "3.8"
Requires-Dist: pydantic-core ==2.20.1 ; python_version >= "3.8"
Requires-Dist: pydantic-settings ==2.4.0 ; python_version >= "3.8"
Requires-Dist: pygments ==2.18.0 ; python_version >= "3.8"
Requires-Dist: python-dotenv ==1.0.1 ; python_version >= "3.8"
Requires-Dist: typing-extensions ==4.12.2 ; python_version >= "3.8"

# hexagon
Make your team's knowledge truly accessible, truly shared, and truly empowering by creating your own CLI.

[![01_ci-cd](https://github.com/lt-mayonesa/hexagon/actions/workflows/01-python-package.yml/badge.svg)](https://github.com/lt-mayonesa/hexagon/actions/workflows/01-python-package.yml)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

[![hexagon setup example](https://user-images.githubusercontent.com/11464844/141402773-2fa1e859-cbe7-43a2-87e8-81620307167f.gif)](https://asciinema.org/a/Mk8of7EC0grfsSgWYrEdGCjdF)

---

## Getting Started

### Install hexagon
```bash
pip install hexagon
```

### Create your teams CLI

Either use our [template repo](https://github.com/lt-mayonesa/hexagon-tools) or create a YAML like the following
```yaml
cli:
  custom_tools_dir: .  # relative to this file
  name: Test CLI
  command: tc

envs:
  - name: dev
    alias: d
  - name: qa
    alias: q

tools:

  - name: google
    alias: g
    long_name: Google
    description: Open google
    type: web
    envs:
      dev: google.dev
      qa: google.qa
    action: open_link

  - name: hello-world
    alias: hw
    long_name: Greet the world
    type: shell
    action: echo "Hello World!"
```

### Install the CLI

Run `hexagon` and select the CLI installation tool

## Options

### Theming

Hexagon supports 3 themes for now:

 - default (some nice colors and decorations)
 - disabled (no colors and no decorations)
 - result_only (with colors but only shows the result logs)

This can be specified by the envvar `HEXAGON_THEME`, i.e.,

```bash
# assuming you installed a CLI with command tc
HEXAGON_THEME=result_only tc
```


## Development

### Pre-requisites

```bash
pip install pipenv
```

### Run:

```bash
# start a shell
pipenv shell
# install hexagon dependencies
pipenv install --dev
# run it
python -m hexagon
```

### Unit Tests:

```bash
pytest -svv tests/
```

### E2E Tests:

```bash
# first generate the transalation files
.github/scripts/i18n/build.sh
# run tests
pytest -svv tests_e2e/
```
