Skip to main content

SCons builders.

Project description

Miniscons

SCons builders.

Review Version Downloads Quality Coverage

Motivation

When writing an SConstruct.py configuration it is difficult to:

  • Specify libraries and warnings for each build since the default environment is global
  • Declare executable targets that depend on builds and don't need to be built themselves
  • Parse outputs from conan to get include paths for build dependencies since they don't appear in the exported conandeps
  • Declare and chain together aliases for external scripts

We can use miniscons to keep the SConstruct.py file short and get an interface like this:

builds:
  build
  tests

targets:
  start -> build
  test -> tests

scripts:
  clang-tidy
  cppclean

routines:
  lint -> [clang-tidy, cppclean]

flags:
  --dump

Installation

pip install miniscons

Documentation

Documentation and more detailed examples are hosted on Github Pages.

 Usage

Parse the SConscript_conandeps if you are using conan:

from miniscons import conan

env = conan()

Add the builds with their specific warning flags and libs to include:

from miniscons import Build, flags, packages
from walkmate import tree

build = Build(
    "build",
    tree("src", r"(?<!\.spec)\.cpp$"),
    flags("c++11", ["shadow"]),
)

tests = Build(
    "tests",
    tree("src", r"\.cpp$", ["main.cpp"]),
    flags("c++11"),
    packages(["gtest"]),
)

Add the executable targets that depend on the builds with their runtime arguments:

from miniscons import Target

start = Target("start", build)

test = Target("test", tests, ["--gtest_brief"])

Add the scripts to invoke your tooling:

from miniscons import Script
from walkmate import tree

cppclean = Script("cppclean", ["."])

includes = tests.packages["CPPPATH"]

tidy = Script(
    "clang-tidy",
    [tree("src", r"\.(cpp)$"), "--", [f"-I{i}" for i in includes]],
)

Add the routines and flags for your interface:

from miniscons import Flag, Routine

lint = Routine("lint", [cppclean, tidy])

dump = Flag("--dump")

Register all the declarations with the environment and add handlers for each flag:

from miniscons import Tasks
from SCons.Script.Main import GetOption

cli = Tasks(
    [build, tests],
    [start, test],
    [tidy, cppclean],
    [lint],
    [dump],
)

cli.register(env)

if GetOption("dump"):
    cli.dump()

Now if we run

scons --dump

We get our interface:

scons: Reading SConscript files ...

builds:
  build
  tests

targets:
  start -> build
  test -> tests

scripts:
  clang-tidy
  cppclean

routines:
  lint -> [clang-tidy, cppclean]

flags:
  --dump

Discussion

Why not use a simple task runner for scripts and routines?

Some scripts need access to the include paths that appear in the SConstruct.py file so they need to be integrated into the scons workflow.

Tooling

Dependencies

To install dependencies:

yarn install
pip install .[all]

Tests

To run tests:

thx test

Documentation

To generate the documentation locally:

thx docs

Linters

To run linters:

thx lint

Formatters

To run formatters:

thx format

Contributing

Please read this repository's Code of Conduct which outlines our collaboration standards and the Changelog for details on breaking changes that have been made.

This repository adheres to semantic versioning standards. For more information on semantic versioning visit SemVer.

Bump2version is used to version and tag changes. For example:

bump2version patch

Contributors

Remarks

Lots of love to the open source community!

Be kind to your mind Love each other It's ok to have a bad day

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

miniscons-0.11.2.tar.gz (6.3 kB view details)

Uploaded Source

Built Distribution

miniscons-0.11.2-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

File details

Details for the file miniscons-0.11.2.tar.gz.

File metadata

  • Download URL: miniscons-0.11.2.tar.gz
  • Upload date:
  • Size: 6.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for miniscons-0.11.2.tar.gz
Algorithm Hash digest
SHA256 f97e48e71d07ea55754374f1f7cb04298e4e1dfe601acf2362cce131d02b3f9d
MD5 d7930d19b6951fe0d04a1252bd27009c
BLAKE2b-256 52c475fc3e4c3edd1bdc9b14fb9392828223ea8c260d42e8f775488227f8f0d1

See more details on using hashes here.

File details

Details for the file miniscons-0.11.2-py3-none-any.whl.

File metadata

  • Download URL: miniscons-0.11.2-py3-none-any.whl
  • Upload date:
  • Size: 9.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for miniscons-0.11.2-py3-none-any.whl
Algorithm Hash digest
SHA256 530c95bace358ee8e7a2c29ca74c99bbd2a2dd7cfd28842af0f418a189a3a60e
MD5 6580999a54c4aacdb0738e125127be22
BLAKE2b-256 a54aa435d831f8234329a7b3b0b9db673ad472c1267ebdc02d2ca87a3cc8d6b5

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