Make mode¶

Make mode is a simple usage of dogebuild used to create python analog to Makefile.

Simple example¶

from dogebuild import make_mode, task

make_mode()

@task
def task1():
    print('task1')

@task()
def task2():
    print('task2')

@task(
    name='Task 3 verbose name',
    depends=['task1', 'task2'],
)
def task3():
    print('task3')

@task(depends=['Task 3 verbose name'])
def task4():
    print('task4')

make_mode() marks that dogefile should be run in make mode. All tasks must be marked with @task decorator to be added to build graph. All dependencies must be enumerated as list in depends variable of @task decorator.

More complex example¶

As far as dogefile is just a python script you can use all python power to run tasks:

from dogebuild import make_mode, task
from pathlib import Path
from shutil import rmtree
from subprocess import run

make_mode()

src_dir = Path('./src')
sources = src_dir.glob('**/*.cpp')
headers = src_dir

build_dir = Path('./build')
target = build_dir / 'hello-world'


@task()
def make_build_dir():
    build_dir.mkdir(parents=True, exist_ok=True)


@task()
def clean():
    rmtree(build_dir)


@task(depends=['make_build_dir'])
def build():
    run(
        [
            'g++',
            '-o', str(target),
            *map(str, sources),
            f'-I{headers}',
        ],
        check=True,
    )

This is possible but not the recommended way to build any c++ project.

You see that you can use variables and standard python functions inside dogefile.py.