Skip to main content

No project description provided

Project description

oak-build

A make-like build system written on python

How to use

Create oak_build.py file in your project directory. Every method marked with @task decorator can be called from CLI.

from pathlib import Path

from oak_build import task


@task
def create_file():
    with open(Path("result.txt"), "w") as txt:
        txt.write("test content\n")

To execute create_file task call oak create_file from console.

Task dependencies

You can link dependent tasks with depends_on parameter.

from oak_build import task, run


@task
def unit_tests():
    run("poetry run pytest tests")


@task
def integration_tests():
    run("poetry run pytest integration_tests")


@task(
    depends_on=[
        unit_tests,
        integration_tests,
    ]
)
def tests():
    pass

When oak tests is called oak build will execute unit_tests and integration_tests tasks as well.

CLI params

You can pass parameters to tasks with --param key=value parameter of command line. Oak will try to parse all task function params regarding its annotation type.

Example:

from enum import Enum, auto
from oak_build import task


class TaskEnum(Enum):
    VALUE = auto()


@task
def enum_param(param: TaskEnum):
    pass

Task results

Exit code

All int return value from task will be treated as return code. If return is integer and not zero task will be marked as failed and further execution will be stopped.

from oak_build import task

@task
def exit_code_task():
    return 0

Result dict

All dict return value will be treated as result. Those results can be used in another tasks with tas name prefix (see example below).

from oak_build import task

@task
def source():
    return {
        "result": 123,
    }

@task(depends_on=[source])
def result_consumer(source_result):
    pass

Please note that CLI params have greater priority than arguments deducted from task results.

Code and result

You can return Tuple[int, Dict[str, Any]] from task, and it will be treated as return code and result dict. If code is not zero task is considered failed. The result dict processing is the same as in dict result

Exceptions

If task throws exception it is considered faled and further execution will be stopped.

Examples

For examples see integration tests files and self build oak_file.py.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

oak_build-0.1.2.post2.tar.gz (8.7 kB view details)

Uploaded Source

Built Distribution

oak_build-0.1.2.post2-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file oak_build-0.1.2.post2.tar.gz.

File metadata

  • Download URL: oak_build-0.1.2.post2.tar.gz
  • Upload date:
  • Size: 8.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for oak_build-0.1.2.post2.tar.gz
Algorithm Hash digest
SHA256 c1f216005fc55a17af975106b1ad6422167bab881d3a8265976c3f580de5ae10
MD5 dffbd50f769220399d4c1ba9feb41eb6
BLAKE2b-256 d493c36d8d71702018f571772d14178742044271145e55b8ac4b7ebbeaf92b73

See more details on using hashes here.

File details

Details for the file oak_build-0.1.2.post2-py3-none-any.whl.

File metadata

File hashes

Hashes for oak_build-0.1.2.post2-py3-none-any.whl
Algorithm Hash digest
SHA256 ae5ef2dbb3b505061988e9bf8bcfc3da7d6eb281752b3a28dbbdbbcf8bd1202f
MD5 c7d9f67eed3fa6e5262942dc24d3de77
BLAKE2b-256 279430c61274b23659bb810bc24d6723f7c6461400cbca16d9922fe1b6e36e8d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page