uttl.buildout 1.1.0

Utilities for Buildout developed for Up There They Love.

uttl.buildout

Utilities for zc.buildout as developed for Up There They Love.

Usage

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

[buildout]
parts =
    devenv
    game

# find devenv executable from visual studio path

[devenv]
recipe = uttl.buildout:versioncheck
required-major = 2017
required-minor = 15
body = ... path = None
    ... args = [ 
    ...   r'%ProgramFiles(x86)%\Microsoft Visual Studio\Installer\vswhere.exe',
    ...   '-version',
    ...   '%s.0' % (self.options['required-minor']),
    ...   '-property',
    ...   'installationPath'
    ... ]
    ...
    ... try:
    ...   with subprocess.Popen(args, shell=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT) as proc:
    ...     for line in iter(proc.stdout.readline, b''):
    ...       path = os.path.abspath(str(line.rstrip(), encoding='ascii'))
    ...       break
    ... except FileNotFoundError:
    ...   self.log.error('Visual Studio is not installed.')
    ...   return (False, 0, 0, 0, '')
    ...
    ... if not path:
    ...   self.log.error('Cannot find Visual Studio executable.')
    ...   return (False, 0, 0, 0, '')
    ...
    ... path = os.path.abspath(path + r'\Common7\IDE\devenv.com')
    ... if not os.path.exists(path):
    ...   self.log.error('Failed to find path to devenv.')
    ...   return (False, 0, 0, 0, '')
    ...
    ... return (True, self.options['required-major'], self.options['required-minor'], 64, path)

# build game executable

[game]
recipe = uttl.buildout:devenv
executable = ${devenv: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.copyfile - Copy files between directories
• uttl.buildout.devenv - Build projects with Visual Studio
• uttl.buildout.dotnet.restore - Restore .NET packages
• 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

Check the source folders for detailed documentation about each recipe.

Building from source

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

Create egg in dist/ folder:

python setup.py bdist_egg

Install manually:

python -m easy_install -a dist\uttl_buildout-1.0.0-py3.9.egg

Upload to package manager:

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

1.1.0

• Changed options in all recipes from snake_case to kebab-case
• Added recipe for dotnet restore
• CMake: Fixed source path option
• CMake: Made target option a synonym for targets
• CopyFile: Copies files if they do not exist or if they were modified
• CopyFile: Added documentation
• Devenv: Cleaned up script
• Devenv: Added documentation
• QMake: Fixed files option throwing an error
• QMake: Expanded documentation
• QMake: Fixed typos in documentation