uttl.buildout

Utilities for zc.buildout for different build systems on Windows, as used by Up There They Love for developing their titles.

Usage

The uttl.buildout package will be automatically installed from PyPi when you use it in your Buildout configuration.

You can also clone the repository to disk and use the recipes directly without installing a package:

[buildout]
develop = C:\Downloads\uttl-buildout

The downside of this approach is that your configuration will be invalidated (and thus your dependencies rebuilt) when the recipes change.

Example

[buildout]
parts =
    visual-studio
    game

# find installation for visual studio 2017

[visual-studio]
recipe = uttl.buildout:vswhere
version = 2017

# build game executable

[game]
recipe = uttl.buildout:devenv
executable = ${visual-studio:product-path}
solution = SSSG.sln
project = SSSG
build = Release

Recipes

The following recipes (scripts) for zc.buildout are available in this package:

• uttl.buildout.cmake - Run CMake commands
• uttl.buildout.command - Run an executable with arguments
• uttl.buildout.copyfile - Copy files between directories
• uttl.buildout.devenv - Build projects with Visual Studio
• uttl.buildout.dotnet-restore - Restore .NET packages using NuGet
• uttl.buildout.inklecate - Compile .ink files to JSON
• uttl.buildout.qmake - Run QMake commands
• uttl.buildout.qtdeploy - Deploy Qt libraries
• uttl.buildout.versioncheck - Get versioned executables
• uttl.buildout.vswhere - Get Visual Studio installation paths

Check the source folders for detailed documentation about each recipe.

Testing the package locally

Check that you're running at least Python 3.9:

D:\Projects\uttl-buildout>python --version
Python 3.9.5

Build and install egg on system:

python setup.py install

Uploading new package

Create egg in dist/ folder:

python setup.py bdist_egg

Upload packaged egg to repository:

python -m twine upload --repository pypi dist/*