Metadata-Version: 2.1
Name: noos-inv
Version: 0.2.10
Summary: Shared workflows across CI/CD pipelines
Home-page: https://github.com/noosenergy/noos-invoke
License: MIT
Author: Noos Energy
Author-email: contact@noos.energy
Requires-Python: >=3.12,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Typing :: Typed
Requires-Dist: invoke
Description-Content-Type: text/markdown

[![CircleCI](https://circleci.com/gh/noosenergy/noos-invoke.svg?style=svg&circle-token=5b4d9fc54d8987081b7c4a9a79fa8b436e70930c)](https://circleci.com/gh/noosenergy/noos-invoke)

# Noos Invoke

Software development kit for sharing workflows across CI/CD pipelines.

Such a project aims to enforce parity and reproducability between local development and CI/CD workflows in remote containers (e.g. executable versions, command line calls, environment variables...) - developped with [`inv[oke]`](https://github.com/pyinvoke/invoke).

## Installation

Install the package from the [PyPi repository](https://pypi.org/project/noos-inv/):

    ```bash
    $ pip install noos-inv
    ```

To enable shell completion, execute the following command (e.g. `zsh`),

    ```bash
    $ noosinv --print-completion-script=zsh
    ```

And copy/paste its `stdout` into your shell config.

    ```bash
    # NOOSINV completion script

    _complete_noosinv() {
        collection_arg=''
        if [[ "${words}" =~ "(-c|--collection) [^ ]+" ]]; then
            collection_arg=$MATCH
        fi
        reply=( $(noosinv ${=collection_arg} --complete -- ${words}) )
    }

    compctl -K _complete_noosinv + -f noosinv
    ```

Finally, still in your shell config, enable automatic sub shell loading:

    ```bash
    # ENV variable sub shell loading with command "source .env"

    set -a
    ```

## Usage as a command line tool

The `noos-inv` package installs a CLI binary, for managing common CI/CD tasks.

From the terminal,

    ```bash
    $ noosinv

    Usage: noosinv [--core-opts] <subcommand> [--subcommand-opts] ...

    Subcommands:

    docker.build       Build Docker image locally.
    docker.buildx      Build and push x-platform Docker image to a remote registry.
    docker.configure   Create and configure buildx builder for multi-platform.
    docker.login       Login to Docker remote registry (AWS ECR or Dockerhub).
    docker.pull        Pull Docker image from a remote registry.
    docker.push        Push Docker image to a remote registry.
    git.config         Setup git credentials with a Github token.
    helm.install       Provision local Helm client (Chart Museum Plugin).
    helm.lint          Check compliance of Helm charts / values.
    helm.login         Login to Helm remote registry (AWS ECR or Chart Museum).
    helm.push          Push Helm chart to a remote registry (AWS ECR or Chart Museum).
    helm.test          Test local deployment in Minikube.
    local.dotenv       Create local dotenv file.
    local.ports        Forward ports for defined Kubernetes pods.
    python.clean       Clean project from temp files / dirs.
    python.coverage    Run coverage test report.
    python.format      Auto-format source code.
    python.lint        Run python linters.
    python.package     Build project wheel distribution.
    python.release     Publish wheel distribution to PyPi.
    python.test        Run pytest with optional grouped tests.
    terraform.run      Run a plan in Terraform cloud.
    terraform.update   Update variable in Terraform cloud.
    ```

Source your environnement variables first for a seamless experience.
(use command `local.dotenv` to create it from the provided template)

    ```bash
    $ source .env
    ```

## Special note on K8S port-forwards

Add the `NOOSINV_LOCAL_CONFIG` OS variable to your shell config, as the path to a local configuration file:

    ```json
    {
        "podForwards": {
            "pod_1": {
                "podNamespace": "default",
                "podPrefix": "service-1-",
                "podPort": 80,
                "localPort": 8000
            },
            "pod_2": {
                "podNamespace": "test",
                "podPrefix": "service-2-",
                "podPort": 8080,
                "localPort": 8000,
                "localAddress": "0.0.0.0"
            }
        }
    }
    ```

To start port forwarding a specific K8S cluster pod:

    ```bash
    $ noosinv local.ports -p pod_1
    ```

To kill all previous port forward processes:

    ```bash
    $ noosinv local.ports -u
    ```

Or previously opened port forward:

    ```bash
    $ noosinv local.ports -p pod_1 -u
    ```

## Development

Make sure [poetry](https://python-poetry.org/) has been installed and pre-configured,

This project is shipped with a Makefile, which is ready to do basic common tasks.

    ```bash
    $ make

    help                           Display this auto-generated help message
    update                         Lock and install build dependencies
    clean                          Clean project from temp files / dirs
    format                         Run auto-formatting linters
    install                        Install build dependencies from lock file
    lint                           Run python linters
    test                           Run pytest with all tests
    package                        Build project wheel distribution
    release                        Publish wheel distribution to PyPi
    ```

