Metadata-Version: 2.1
Name: pipen-cli-require
Version: 0.1.1
Summary: A pipen cli plugin to check requirements for processes of a pipeline
License: MIT
Author: pwwang
Author-email: pwwang@pwwang.com
Requires-Python: >=3.7.1,<4.0.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: pipen (>=0.3,<0.4)
Requires-Dist: pipen-annotate (>=0.0,<0.1)
Description-Content-Type: text/markdown

# pipen-cli-require

Checking the requirements for processes of a pipeline

## Install

```shell
pip install -U pipen-cli-require
```

## Usage

### Defining requirements of a process

```python
# example_pipeline.py
from pipen import Pipen, Proc

class P1(Proc):
    """Process 1

    Requires:
        - name: pipen
          message: Run `pip install -U pipen` to install
          check: |
            {{proc.lang}} -c "import pipen"
        - name: liquidpy
          message: Run `pip install -U liquidpy` to install
          check: |
            {{proc.lang}} -c "import liquid"
        - name: nonexist
          message: Run `pip install -U nonexist` to install
          check: |
            {{proc.lang}} -c "import nonexist"
        - name: optional
          if: {{proc.envs.require_optional}}
          check:
            {{proc.lang}} -c "import optional"

    """
    input = "a"
    output = "outfile:file:out.txt"
    envs = {"require_optional": False}
    lang = "python"

# Setup the pipeline
# Must be outside __main__
# Or define a function to return the pipeline
pipeline = Pipen(...)

if __name__ == '__main__':
    # Pipeline must be executed with __main__
    pipeline.run()
```

## Checking the requirements via the CLI

```shell
> pipen require -v -n 2 tests/example_pipeline.py:example_pipeline

Checking requirements for pipeline: EXAMPLE_PIPELINE
│
├── P1: Process 1
│   ├── ✅ pipen
│   ├── ✅ liquidpy
│   ├── ❎ nonexist: Run `pip install -U nonexist` to install
│   │   └── Traceback (most recent call last):
│   │         File "<string>", line 1, in <module>
│   │       ModuleNotFoundError: No module named 'nonexist'
│   │
│   ├── ❎ nonexist2_nomsg
│   │   └── Traceback (most recent call last):
│   │         File "<string>", line 1, in <module>
│   │       ModuleNotFoundError: No module named 'nonexist'
│   │
│   └── ⏩ optional (skipped by if-statement)
...
```

## Checking requirements with runtime arguments

For example, when I use a different python to run the pipeline:

Add this to the head of `example_pipeline.py`:

```python
from pipen_args import args as _
```

See also `tests/pipen_args_pipeline.py`

Then specify the path of the python to use:

```shell
pipen require tests/example_pipeline.py:example_pipeline --P1.lang /path/to/another/python
```

