FlowTask
FlowTask is a plugin-based, component-driven task execution framework for create complex Tasks.
FlowTask runs Tasks defined in JSON, YAML or TOML files, any Task is a combination of Components, and every component in the Task run sequentially or depend of others, like a DAG.
Can create a Task combining Commands, Shell scripts and other specific Components (as TableInput: Open a Table using a datasource, DownloadFromIMAP: Download a File from a IMAP Folder, and so on), any Python Callable can be a Component inside a Task, or can extends UserComponent to build your own componets.
Every designed Task can run from CLI, programmatically, via RESTful API (using our aioHTTP-based Handler), called by WebHooks or even dispatched to a external Worker using our built-in Scheduler.
Quickstart
pip install flowtask
Tasks can organizated into directory structure like this:
tasks / ├── programs / ├── test / ├── tasks /
The main reason of this structure, is maintain organized several tasks by tenant/program, avoiding filling a directory with several task files.
FlowTask support "TaskStorage", a Task Storage is the main repository for tasks, main Task Storage is a directory in any filesystem path (optionally you can syncronize that path using git), but Tasks can be saved onto a Database or a S3 bucket.
Dependencies
- aiohttp (Asyncio Web Framework and Server) (required by navigator)
- AsyncDB
- QuerySource
- Navigator-api
- (Optional) Qworker (for distributing asyncio Tasks on distributed workers).
Features
- Component-based Task execution framework with several components covering several actions (download files, create pandas dataframes from files, mapping dataframe columns to a json-dictionary, etc)
- Built-in API for execution of Tasks.
How I run a Task?
Can run a Task from CLI:
task --program=test --task=example
on CLI, you can pass an ENV (enviroment) to change the environment file on task execution.
ENV=dev task --program=test --task=example
or Programmatically:
from flowtask import Task
import asyncio
task = Task(program='test', task='example')
results = asyncio.run(task.run())
# we can alternatively, using the execution mode of task object:
results = asyncio.run(task())
Requirements
- Python >= 3.9
- asyncio (https://pypi.python.org/pypi/asyncio/)
- aiohttp >= 3.6.2
Contribution guidelines
Please have a look at the Contribution Guide
- Writing tests
- Code review
- Other guidelines
Who do I talk to?
- Repo owner or admin
- Other community or team contact
License
Navigator is licensed under Apache 2.0 License. See the LICENSE file for more details.
2 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file flowtask-5.12.14.tar.gz.
File metadata
- Download URL: flowtask-5.12.14.tar.gz
- Upload date:
- Size: 1.5 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cac7cfd4e45e02da57fcb0678c4a33dba91fa2cf7167deadc1f2c210627c8d6b
|
|
| MD5 |
fc1e6c5acfbc753a5c8413d77c05af9c
|
|
| BLAKE2b-256 |
05e6fe1adc64a3a009481d05195656557394fe052c36e85af67e19703836aa23
|
Provenance
The following attestation bundles were made for flowtask-5.12.14.tar.gz:
Publisher:
release.yml on phenobarbital/flowtask
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
flowtask-5.12.14.tar.gz -
Subject digest:
cac7cfd4e45e02da57fcb0678c4a33dba91fa2cf7167deadc1f2c210627c8d6b - Sigstore transparency entry: 2586900621
- Sigstore integration time:
-
Permalink:
phenobarbital/flowtask@9a3d794a745aad56a293868f05c5cfe8495afc09 -
Branch / Tag:
refs/tags/5.12.14 - Owner: https://github.com/phenobarbital
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@9a3d794a745aad56a293868f05c5cfe8495afc09 -
Trigger Event:
release
-
Statement type:
File details
Details for the file flowtask-5.12.14-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.
File metadata
- Download URL: flowtask-5.12.14-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
- Upload date:
- Size: 3.6 MB
- Tags: CPython 3.13, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
34983e0990b98c1e96862c325147aa0ab4ae0a813e016ef26960241e2a7c8bee
|
|
| MD5 |
732bcc7466790b850fe32788a8c94e64
|
|
| BLAKE2b-256 |
28c40a63975d32ee3c86a355fcb2ec54ac6a735da4c0632347ec2c61f181d348
|
Provenance
The following attestation bundles were made for flowtask-5.12.14-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl:
Publisher:
release.yml on phenobarbital/flowtask
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
flowtask-5.12.14-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl -
Subject digest:
34983e0990b98c1e96862c325147aa0ab4ae0a813e016ef26960241e2a7c8bee - Sigstore transparency entry: 2586902409
- Sigstore integration time:
-
Permalink:
phenobarbital/flowtask@9a3d794a745aad56a293868f05c5cfe8495afc09 -
Branch / Tag:
refs/tags/5.12.14 - Owner: https://github.com/phenobarbital
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@9a3d794a745aad56a293868f05c5cfe8495afc09 -
Trigger Event:
release
-
Statement type:
File details
Details for the file flowtask-5.12.14-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.
File metadata
- Download URL: flowtask-5.12.14-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
- Upload date:
- Size: 3.7 MB
- Tags: CPython 3.12, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
92062f4eb2687dfbb6a4baddc2ff38ede6e19d1bc542f5254d04adf93c9c331e
|
|
| MD5 |
af70bcf7a9dc88a0676586c43788e951
|
|
| BLAKE2b-256 |
6af3ec3a4072803de340d846bb1b260310b6801d72d75734170454252b78e7b8
|
Provenance
The following attestation bundles were made for flowtask-5.12.14-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl:
Publisher:
release.yml on phenobarbital/flowtask
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
flowtask-5.12.14-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl -
Subject digest:
92062f4eb2687dfbb6a4baddc2ff38ede6e19d1bc542f5254d04adf93c9c331e - Sigstore transparency entry: 2586903969
- Sigstore integration time:
-
Permalink:
phenobarbital/flowtask@9a3d794a745aad56a293868f05c5cfe8495afc09 -
Branch / Tag:
refs/tags/5.12.14 - Owner: https://github.com/phenobarbital
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@9a3d794a745aad56a293868f05c5cfe8495afc09 -
Trigger Event:
release
-
Statement type:
File details
Details for the file flowtask-5.12.14-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.
File metadata
- Download URL: flowtask-5.12.14-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
- Upload date:
- Size: 3.6 MB
- Tags: CPython 3.11, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e1b9fed17f8728c89e191ba9882fa36209776478cf713049a45c4e0e7ecd33cc
|
|
| MD5 |
f330a3926a4b6576e55874a8b042bf7a
|
|
| BLAKE2b-256 |
a1d146fef1f788fd9bd1e980f3db4fb1a0a6fd2dded7c6ab7996b1c52e1bd545
|
Provenance
The following attestation bundles were made for flowtask-5.12.14-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl:
Publisher:
release.yml on phenobarbital/flowtask
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
flowtask-5.12.14-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl -
Subject digest:
e1b9fed17f8728c89e191ba9882fa36209776478cf713049a45c4e0e7ecd33cc - Sigstore transparency entry: 2586902162
- Sigstore integration time:
-
Permalink:
phenobarbital/flowtask@9a3d794a745aad56a293868f05c5cfe8495afc09 -
Branch / Tag:
refs/tags/5.12.14 - Owner: https://github.com/phenobarbital
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@9a3d794a745aad56a293868f05c5cfe8495afc09 -
Trigger Event:
release
-
Statement type:
