From 70da99e4f70845da37ae368c4788ecc18546792d Mon Sep 17 00:00:00 2001 From: Egor Tensin Date: Sat, 28 Mar 2020 17:19:43 +0000 Subject: WIP: restructure A stupid attempt to reduce code duplication led me to believe that all the scripts could use _a bit_ of refactoring. This is going to be a major pain (factoring out all the things), which I'll take gladly. All the links and usage examples are broken right now, but nobody cares, so whatevs. --- .ci/Makefile | 34 +- boost/build/README.md | 13 - boost/build/build.py | 566 --------------------------------- boost/build/ci/appveyor.py | 124 -------- boost/build/ci/travis.py | 122 ------- boost/toolchains/README.md | 2 - boost/toolchains/mingw-w64-x64-exe.jam | 1 - boost/toolchains/mingw-w64-x64.jam | 1 - boost/toolchains/mingw-w64-x86-exe.jam | 1 - boost/toolchains/mingw-w64-x86.jam | 1 - cmake/build/README.md | 13 - cmake/build/build.py | 190 ----------- cmake/build/ci/appveyor.py | 167 ---------- cmake/build/ci/travis.py | 102 ------ cmake/common.cmake | 225 ------------- cmake/examples/boost/CMakeLists.txt | 14 - cmake/examples/boost/foo.cpp | 11 - cmake/examples/dynamic/CMakeLists.txt | 16 - cmake/examples/dynamic/baz.cpp | 7 - cmake/examples/dynamic/baz.hpp | 9 - cmake/examples/dynamic/foo.cpp | 6 - cmake/examples/simple/CMakeLists.txt | 12 - cmake/examples/simple/foo.cpp | 6 - cmake/examples/static/CMakeLists.txt | 16 - cmake/examples/static/bar.cpp | 7 - cmake/examples/static/bar.hpp | 3 - cmake/examples/static/foo.cpp | 6 - cmake/toolchains/README.md | 3 - cmake/toolchains/gcc-x64.cmake | 4 - cmake/toolchains/gcc-x86.cmake | 4 - cmake/toolchains/mingw-w64-x64.cmake | 4 - cmake/toolchains/mingw-w64-x86.cmake | 4 - common.cmake | 225 +++++++++++++ examples/boost/CMakeLists.txt | 14 + examples/boost/foo.cpp | 11 + examples/dynamic/CMakeLists.txt | 16 + examples/dynamic/baz.cpp | 7 + examples/dynamic/baz.hpp | 9 + examples/dynamic/foo.cpp | 6 + examples/simple/CMakeLists.txt | 12 + examples/simple/foo.cpp | 6 + examples/static/CMakeLists.txt | 16 + examples/static/bar.cpp | 7 + examples/static/bar.hpp | 3 + examples/static/foo.cpp | 6 + project/__init__.py | 0 project/boost/README.md | 13 + project/boost/__init__.py | 0 project/boost/build.py | 566 +++++++++++++++++++++++++++++++++ project/ci/__init__.py | 0 project/ci/appveyor/__init__.py | 0 project/ci/appveyor/boost.py | 121 +++++++ project/ci/appveyor/cmake.py | 164 ++++++++++ project/ci/travis/__init__.py | 0 project/ci/travis/boost.py | 119 +++++++ project/ci/travis/cmake.py | 99 ++++++ project/cmake/README.md | 13 + project/cmake/__init__.py | 0 project/cmake/build.py | 190 +++++++++++ toolchains/boost/README.md | 2 + toolchains/boost/mingw-w64-x64-exe.jam | 1 + toolchains/boost/mingw-w64-x64.jam | 1 + toolchains/boost/mingw-w64-x86-exe.jam | 1 + toolchains/boost/mingw-w64-x86.jam | 1 + toolchains/cmake/README.md | 3 + toolchains/cmake/gcc-x64.cmake | 4 + toolchains/cmake/gcc-x86.cmake | 4 + toolchains/cmake/mingw-w64-x64.cmake | 4 + toolchains/cmake/mingw-w64-x86.cmake | 4 + 69 files changed, 1665 insertions(+), 1677 deletions(-) delete mode 100644 boost/build/README.md delete mode 100755 boost/build/build.py delete mode 100644 boost/build/ci/appveyor.py delete mode 100755 boost/build/ci/travis.py delete mode 100644 boost/toolchains/README.md delete mode 100644 boost/toolchains/mingw-w64-x64-exe.jam delete mode 100644 boost/toolchains/mingw-w64-x64.jam delete mode 100644 boost/toolchains/mingw-w64-x86-exe.jam delete mode 100644 boost/toolchains/mingw-w64-x86.jam delete mode 100644 cmake/build/README.md delete mode 100755 cmake/build/build.py delete mode 100755 cmake/build/ci/appveyor.py delete mode 100755 cmake/build/ci/travis.py delete mode 100644 cmake/common.cmake delete mode 100644 cmake/examples/boost/CMakeLists.txt delete mode 100644 cmake/examples/boost/foo.cpp delete mode 100644 cmake/examples/dynamic/CMakeLists.txt delete mode 100644 cmake/examples/dynamic/baz.cpp delete mode 100644 cmake/examples/dynamic/baz.hpp delete mode 100644 cmake/examples/dynamic/foo.cpp delete mode 100644 cmake/examples/simple/CMakeLists.txt delete mode 100644 cmake/examples/simple/foo.cpp delete mode 100644 cmake/examples/static/CMakeLists.txt delete mode 100644 cmake/examples/static/bar.cpp delete mode 100644 cmake/examples/static/bar.hpp delete mode 100644 cmake/examples/static/foo.cpp delete mode 100644 cmake/toolchains/README.md delete mode 100644 cmake/toolchains/gcc-x64.cmake delete mode 100644 cmake/toolchains/gcc-x86.cmake delete mode 100644 cmake/toolchains/mingw-w64-x64.cmake delete mode 100644 cmake/toolchains/mingw-w64-x86.cmake create mode 100644 common.cmake create mode 100644 examples/boost/CMakeLists.txt create mode 100644 examples/boost/foo.cpp create mode 100644 examples/dynamic/CMakeLists.txt create mode 100644 examples/dynamic/baz.cpp create mode 100644 examples/dynamic/baz.hpp create mode 100644 examples/dynamic/foo.cpp create mode 100644 examples/simple/CMakeLists.txt create mode 100644 examples/simple/foo.cpp create mode 100644 examples/static/CMakeLists.txt create mode 100644 examples/static/bar.cpp create mode 100644 examples/static/bar.hpp create mode 100644 examples/static/foo.cpp create mode 100644 project/__init__.py create mode 100644 project/boost/README.md create mode 100644 project/boost/__init__.py create mode 100644 project/boost/build.py create mode 100644 project/ci/__init__.py create mode 100644 project/ci/appveyor/__init__.py create mode 100644 project/ci/appveyor/boost.py create mode 100644 project/ci/appveyor/cmake.py create mode 100644 project/ci/travis/__init__.py create mode 100644 project/ci/travis/boost.py create mode 100644 project/ci/travis/cmake.py create mode 100644 project/cmake/README.md create mode 100644 project/cmake/__init__.py create mode 100644 project/cmake/build.py create mode 100644 toolchains/boost/README.md create mode 100644 toolchains/boost/mingw-w64-x64-exe.jam create mode 100644 toolchains/boost/mingw-w64-x64.jam create mode 100644 toolchains/boost/mingw-w64-x86-exe.jam create mode 100644 toolchains/boost/mingw-w64-x86.jam create mode 100644 toolchains/cmake/README.md create mode 100644 toolchains/cmake/gcc-x64.cmake create mode 100644 toolchains/cmake/gcc-x86.cmake create mode 100644 toolchains/cmake/mingw-w64-x64.cmake create mode 100644 toolchains/cmake/mingw-w64-x86.cmake diff --git a/.ci/Makefile b/.ci/Makefile index 9553238..13fa74f 100644 --- a/.ci/Makefile +++ b/.ci/Makefile @@ -53,8 +53,8 @@ x86_args = -A Win32 install_prefix = C:/install else makefile_dir := $(dir $(realpath $(firstword $(MAKEFILE_LIST)))) -x64_args := -D "CMAKE_TOOLCHAIN_FILE=$(makefile_dir)/../cmake/toolchains/gcc-x64.cmake" -x86_args := -D "CMAKE_TOOLCHAIN_FILE=$(makefile_dir)/../cmake/toolchains/gcc-x86.cmake" +x64_args := -D "CMAKE_TOOLCHAIN_FILE=$(makefile_dir)/../toolchains/cmake/gcc-x64.cmake" +x86_args := -D "CMAKE_TOOLCHAIN_FILE=$(makefile_dir)/../toolchains/cmake/gcc-x86.cmake" install_prefix := $$HOME/install endif @@ -74,7 +74,7 @@ FORCE: echo/%/build: FORCE $(newline) @echo ===================================================================== - @echo Building cmake/examples/$* + @echo Building examples/$* @echo ===================================================================== echo/%/run: FORCE @@ -95,7 +95,7 @@ echo/%/finished: FORCE .PHONY: simple/build simple/build: echo/simple/build - "$(python)" cmake/build/build.py --install "$(install_prefix)/simple" --configuration Release -- cmake/examples/simple $(x64_args) + "$(python)" -m project.cmake.build --install "$(install_prefix)/simple" --configuration Release -- examples/simple $(x64_args) .PHONY: simple/run simple/run: echo/simple/run @@ -112,7 +112,7 @@ simple: simple/build simple/run simple/verify echo/simple/finished .PHONY: static/build static/build: echo/static/build - "$(python)" cmake/build/build.py --install "$(install_prefix)/static" --configuration Debug -- cmake/examples/static $(x86_args) + "$(python)" -m project.cmake.build --install "$(install_prefix)/static" --configuration Debug -- examples/static $(x86_args) .PHONY: static/run static/run: echo/static/run @@ -129,7 +129,7 @@ static: static/build static/run static/verify echo/static/finished .PHONY: dynamic/build dynamic/build: echo/dynamic/build - "$(python)" cmake/build/build.py --install "$(install_prefix)/dynamic" --configuration RelWithDebInfo -- cmake/examples/dynamic $(x64_args) + "$(python)" -m project.cmake.build --install "$(install_prefix)/dynamic" --configuration RelWithDebInfo -- examples/dynamic $(x64_args) .PHONY: dynamic/run # Windows can pick up DLLs in the same directory, otherwise we need to add them @@ -161,7 +161,7 @@ echo/boost/%/ls: FORCE echo/boost/%/exe/build: FORCE @echo --------------------------------------------------------------------- - @echo Boost 1.$*.0: building cmake/examples/boost + @echo Boost 1.$*.0: building examples/boost @echo --------------------------------------------------------------------- echo/boost/%/exe/run: FORCE @@ -186,11 +186,11 @@ echo/boost/%/finished: FORCE .PHONY: boost/58/download boost/58/download: echo/boost/58/build - "$(python)" boost/build/build.py download 1.58.0 + "$(python)" -m project.boost.build download 1.58.0 .PHONY: boost/58/build boost/58/build: - "$(python)" boost/build/build.py build --configuration Debug --platform x86 --link static -- ./boost_1_58_0 --with-filesystem --with-program_options $(b2_flags) + "$(python)" -m project.boost.build build --configuration Debug --platform x86 --link static -- ./boost_1_58_0 --with-filesystem --with-program_options $(b2_flags) .PHONY: boost/58/ls boost/58/ls: echo/boost/58/ls @@ -198,7 +198,7 @@ boost/58/ls: echo/boost/58/ls .PHONY: boost/58/exe/build boost/58/exe/build: echo/boost/58/exe/build - "$(python)" cmake/build/build.py --install "$(install_prefix)/boost_1_58_0" --configuration Debug -- cmake/examples/boost $(x86_args) -D "BOOST_ROOT=$(cwd)/boost_1_58_0" -D "BOOST_LIBRARYDIR=$(cwd)/boost_1_58_0/stage/x86/Debug/lib" + "$(python)" -m project.cmake.build --install "$(install_prefix)/boost_1_58_0" --configuration Debug -- examples/boost $(x86_args) -D "BOOST_ROOT=$(cwd)/boost_1_58_0" -D "BOOST_LIBRARYDIR=$(cwd)/boost_1_58_0/stage/x86/Debug/lib" .PHONY: boost/58/exe/run # Boost should be linked statically, no need to adjust PATH: @@ -223,11 +223,11 @@ boost/58: boost/58/download boost/58/build boost/58/ls boost/58/exe echo/boost/5 .PHONY: boost/72/download boost/72/download: echo/boost/72/build - "$(python)" boost/build/build.py download --cache . 1.72.0 + "$(python)" -m project.boost.build download --cache . 1.72.0 .PHONY: boost/72/build boost/72/build: - "$(python)" boost/build/build.py build --platform x86 x64 --link shared -- ./boost_1_72_0 --with-filesystem --with-program_options $(b2_flags) + "$(python)" -m project.boost.build build --platform x86 x64 --link shared -- ./boost_1_72_0 --with-filesystem --with-program_options $(b2_flags) .PHONY: boost/72/ls boost/72/ls: echo/boost/72/ls @@ -235,7 +235,7 @@ boost/72/ls: echo/boost/72/ls .PHONY: boost/72/exe/build boost/72/exe/build: echo/boost/72/exe/build - "$(python)" cmake/build/build.py --install "$(install_prefix)/boost_1_72_0" --configuration Release -- cmake/examples/boost $(x64_args) -D "BOOST_ROOT=$(cwd)/boost_1_72_0" -D "BOOST_LIBRARYDIR=$(cwd)/boost_1_72_0/stage/x64/Release/lib" -D Boost_USE_STATIC_LIBS=OFF + "$(python)" -m project.cmake.build --install "$(install_prefix)/boost_1_72_0" --configuration Release -- examples/boost $(x64_args) -D "BOOST_ROOT=$(cwd)/boost_1_72_0" -D "BOOST_LIBRARYDIR=$(cwd)/boost_1_72_0/stage/x64/Release/lib" -D Boost_USE_STATIC_LIBS=OFF .PHONY: boost/72/exe/run # Boost is linked dynamically, we need to adjust PATH: @@ -265,7 +265,7 @@ boost/72: boost/72/download boost/72/build boost/72/ls boost/72/exe echo/boost/7 ifdef TRAVIS .PHONY: boost/65/build boost/65/build: echo/boost/65/build - "$(python)" boost/build/ci/travis.py --link static -- --with-filesystem --with-program_options $(b2_flags) + "$(python)" -m project.ci.travis.boost --link static -- --with-filesystem --with-program_options $(b2_flags) .PHONY: boost/65/ls boost/65/ls: echo/boost/65/ls @@ -273,12 +273,12 @@ boost/65/ls: echo/boost/65/ls .PHONY: boost/65/exe/build boost/65/exe/build: echo/boost/65/exe/build - TRAVIS_BUILD_DIR="$$TRAVIS_BUILD_DIR/cmake/examples/boost" "$(python)" cmake/build/ci/travis.py --install "$(install_prefix)/boost_1_65_0" -- -D "BOOST_ROOT=$$HOME/boost" -D "BOOST_LIBRARYDIR=$$HOME/boost/stage/$$platform/$$configuration/lib" + TRAVIS_BUILD_DIR="$$TRAVIS_BUILD_DIR/examples/boost" "$(python)" -m project.ci.travis.cmake --install "$(install_prefix)/boost_1_65_0" -- -D "BOOST_ROOT=$$HOME/boost" -D "BOOST_LIBRARYDIR=$$HOME/boost/stage/$$platform/$$configuration/lib" endif ifdef APPVEYOR .PHONY: boost/65/build boost/65/build: echo/boost/65/build - "$(python)" boost/build/ci/appveyor.py --link static -- --with-filesystem --with-program_options $(b2_flags) + "$(python)" -m project.ci.appveyor.boost --link static -- --with-filesystem --with-program_options $(b2_flags) .PHONY: boost/65/ls boost/65/ls: echo/boost/65/ls @@ -286,7 +286,7 @@ boost/65/ls: echo/boost/65/ls .PHONY: boost/65/exe/build boost/65/exe/build: echo/boost/65/exe/build - set "APPVEYOR_BUILD_FOLDER=%APPVEYOR_BUILD_FOLDER%\cmake\examples\boost" && "$(python)" cmake/build/ci/appveyor.py --install "$(install_prefix)/boost_1_65_0" -- -D "BOOST_ROOT=C:\projects\boost" -D "BOOST_LIBRARYDIR=C:\projects\boost\stage\%PLATFORM%\%CONFIGURATION%\lib" + set "APPVEYOR_BUILD_FOLDER=%APPVEYOR_BUILD_FOLDER%\examples\boost" && "$(python)" -m project.ci.appveyor.cmake --install "$(install_prefix)/boost_1_65_0" -- -D "BOOST_ROOT=C:\projects\boost" -D "BOOST_LIBRARYDIR=C:\projects\boost\stage\%PLATFORM%\%CONFIGURATION%\lib" endif .PHONY: boost/65/exe/run diff --git a/boost/build/README.md b/boost/build/README.md deleted file mode 100644 index c1f903e..0000000 --- a/boost/build/README.md +++ /dev/null @@ -1,13 +0,0 @@ -Boost -===== - -Download & build the Boost libraries in a cross-platform way. -Consult the output of `build.py --help` for details. - -A simple usage example to download and build Boost 1.71.0: - - $ python3 build.py download 1.71.0 - ... - - $ python3 build.py build -- boost_1_71_0/ --with-filesystem --with-program_options - ... diff --git a/boost/build/build.py b/boost/build/build.py deleted file mode 100755 index 8da8c9e..0000000 --- a/boost/build/build.py +++ /dev/null @@ -1,566 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2019 Egor Tensin -# This file is part of the "cmake-common" project. -# For details, see https://github.com/egor-tensin/cmake-common. -# Distributed under the MIT License. - -'''Download & build Boost. - -This script downloads and builds the Boost libraries. It's main purpose is to: -1) provide a cross-platform way to download & unpack the Boost distribution -archive, -2) set the correct --stagedir parameter value to avoid name clashes. - -Please pick a command below. You can execute `%(prog)s COMMAND --help` to view -its usage message. - -A simple usage example: - - $ %(prog)s download 1.71.0 - ... - - $ %(prog)s build -- boost_1_71_0/ --with-filesystem --with-program_options - ... -''' - -import abc -import argparse -from collections import namedtuple -from contextlib import contextmanager -from enum import Enum -from functools import total_ordering -import logging -import os.path -import platform -import re -import shutil -import subprocess -import sys -import tempfile -import urllib.request - - -@contextmanager -def _chdir(path): - cwd = os.getcwd() - os.chdir(path) - try: - yield - finally: - os.chdir(cwd) - - -def _setup_logging(): - logging.basicConfig( - format='%(asctime)s | %(levelname)s | %(message)s', - level=logging.INFO) - - -def _on_windows(): - return platform.system() == 'Windows' - - -def _on_linux(): - return not _on_windows() - - -def _run_executable(cmd_line): - logging.info('Running executable: %s', cmd_line) - return subprocess.run(cmd_line, check=True) - - -class Platform(Enum): - X86 = 'x86' - X64 = 'x64' - WIN32 = 'Win32' - - def __str__(self): - return self.value - - @staticmethod - def all(): - return (Platform.X86, Platform.X64) - - def get_address_model(self): - if self is Platform.X86: - return 32 - if self is Platform.X64: - return 64 - if self is Platform.WIN32: - return 32 - raise NotImplementedError(f'unsupported platform: {self}') - - -def _parse_platform(s): - try: - return Platform(s) - except ValueError: - raise argparse.ArgumentTypeError(f'invalid platform: {s}') - - -class Configuration(Enum): - # AFAIK, Boost only supports debug/release, MinSizeRel and RelWithDebInfo - # are for compatibility with CMake, they map to "release". - # The libraries will still reside in stage/PLATFORM/CONFIGURATION/lib, even - # if CONFIGURATION is MinSizeRel/RelWithDebInfo. - DEBUG = 'Debug' - MINSIZEREL = 'MinSizeRel' - RELWITHDEBINFO = 'RelWithDebInfo' - RELEASE = 'Release' - - def normalize(self): - '''Roughly maps CMake's CMAKE_BUILD_TYPE to Boost's variant.''' - if self is Configuration.MINSIZEREL: - return Configuration.RELEASE - if self is Configuration.RELWITHDEBINFO: - return Configuration.RELEASE - return self - - @staticmethod - def all(): - return (Configuration.DEBUG, Configuration.RELEASE) - - def __str__(self): - return self.value - - -def _parse_configuration(s): - try: - return Configuration(s) - except ValueError: - raise argparse.ArgumentTypeError(f'invalid configuration: {s}') - - -class Linkage(Enum): - STATIC = 'static' - SHARED = 'shared' - - @staticmethod - def all(): - return tuple(Linkage) - - def __str__(self): - return self.value - - -def _parse_linkage(s): - try: - return Linkage(s) - except ValueError: - raise argparse.ArgumentTypeError(f'invalid linkage: {s}') - - -_Version = namedtuple('_Version', ['major', 'minor', 'patch']) - - -@total_ordering -class BoostVersion: - def __init__(self, major, minor, patch): - self._impl = _Version(major, minor, patch) - - @property - def major(self): - return self._impl.major - - @property - def minor(self): - return self._impl.minor - - @property - def patch(self): - return self._impl.patch - - def __lt__(self, other): - return self._impl < other._impl - - def __eq__(self, other): - return self._impl == other._impl - - @staticmethod - def from_string(s): - result = re.match(r'^(\d+)\.(\d+)\.(\d+)$', s) - if result is None: - raise ValueError(f'invalid Boost version: {s}') - major = int(result.group(1)) - minor = int(result.group(2)) - patch = int(result.group(3)) - return BoostVersion(major, minor, patch) - - def __str__(self): - return f'{self.major}.{self.minor}.{self.patch}' - - @property - def archive_ext(self): - return '.tar.gz' - - def dir_path(self, parent_dir): - return os.path.join(parent_dir, self.dir_name) - - @property - def dir_name(self): - return f'boost_{self.major}_{self.minor}_{self.patch}' - - @property - def archive_name(self): - return f'{self.dir_name}{self.archive_ext}' - - def _get_bintray_url(self): - return f'https://dl.bintray.com/boostorg/release/{self}/source/{self.archive_name}' - - def _get_sourceforge_url(self): - return f'https://sourceforge.net/projects/boost/files/boost/{self}/{self.archive_name}/download' - - def get_download_urls(self): - if self._impl < _Version(1, 63, 0): - # For versions older than 1.63.0, SourceForge is the only option: - return [self._get_sourceforge_url()] - # Otherwise, Bintray is preferred (the official website links to it). - return [self._get_bintray_url(), self._get_sourceforge_url()] - - -class BoostArchive: - def __init__(self, version, path): - self.version = version - self.path = path - - @property - def dir_name(self): - return self.version.dir_name - - def unpack(self, dest_dir): - path = os.path.join(dest_dir, self.dir_name) - if os.path.exists(path): - raise RuntimeError(f'Boost directory already exists: {path}') - logging.info('Unpacking Boost to: %s', path) - shutil.unpack_archive(self.path, dest_dir) - return BoostDir(path) - - -class ArchiveStorage(abc.ABC): - @contextmanager - def download(self, version): - path = self.get_archive(version) - if path is not None: - logging.info('Using existing Boost archive: %s', path) - yield BoostArchive(version, path) - return - - urls = version.get_download_urls() - - for url in urls: - logging.info('Trying URL: %s', url) - try: - with urllib.request.urlopen(url, timeout=20) as request: - with self.write_archive(version, request.read()) as path: - yield BoostArchive(version, path) - return - except urllib.request.URLError as e: - logging.error("Couldn't download from this mirror, an error occured:") - logging.exception(e) - - raise RuntimeError("Couldn't download Boost from any of the mirrors") - - @abc.abstractmethod - def get_archive(self, version): - pass - - @contextmanager - @abc.abstractmethod - def write_archive(self, version, contents): - pass - - -class CacheStorage(ArchiveStorage): - def __init__(self, cache_dir): - self._dir = cache_dir - - def _archive_path(self, version): - return os.path.join(self._dir, version.archive_name) - - def get_archive(self, version): - path = self._archive_path(version) - if os.path.exists(path): - return path - return None - - @contextmanager - def write_archive(self, version, contents): - path = self._archive_path(version) - logging.info('Writing Boost archive: %s', path) - if os.path.exists(path): - raise RuntimeError(f'cannot download Boost, file already exists: {path}') - with open(path, mode='w+b') as dest: - dest.write(contents) - yield path - - -class TempStorage(ArchiveStorage): - def __init__(self, temp_dir): - self._dir = temp_dir - - def get_archive(self, version): - return None - - @contextmanager - def write_archive(self, version, contents): - with tempfile.NamedTemporaryFile(prefix=f'boost_{version}_', suffix=version.archive_ext, dir=self._dir, delete=False) as dest: - path = dest.name - logging.info('Writing Boost archive: %s', path) - dest.write(contents) - try: - yield path - finally: - logging.info('Removing temporary Boost archive: %s', path) - os.remove(path) - - -class BoostDir: - def __init__(self, path): - if not os.path.isdir(path): - raise RuntimeError(f"Boost directory doesn't exist: {path}") - self.path = path - - def _go(self): - return _chdir(self.path) - - def build(self, params): - with self._go(): - self._bootstrap_if_required() - self._b2(params) - - def _bootstrap_if_required(self): - if os.path.isfile(self._b2_path()): - logging.info('Not going to bootstrap, b2 is already there') - return - self.bootstrap() - - def bootstrap(self): - with self._go(): - _run_executable(self._bootstrap_path()) - - def _b2(self, params): - for b2_params in params.enum_b2_args(): - _run_executable([self._b2_path()] + b2_params) - - @staticmethod - def _bootstrap_path(): - return os.path.join('.', BoostDir._bootstrap_name()) - - @staticmethod - def _bootstrap_name(): - ext = '.sh' - if _on_windows(): - ext = '.bat' - return f'bootstrap{ext}' - - @staticmethod - def _b2_path(): - return os.path.join('.', BoostDir._b2_name()) - - @staticmethod - def _b2_name(): - ext = '' - if _on_windows(): - ext = '.exe' - return f'b2{ext}' - - -class BuildParameters: - def __init__(self, args): - self.platforms = args.platforms or Platform.all() - self.configurations = args.configurations or Configuration.all() - self.link = args.link or Linkage.all() - self.runtime_link = args.runtime_link - - self.stage_dir = 'stage' - - self.build_dir = args.build_dir - self.boost_dir = args.boost_dir - - self.b2_args = args.b2_args - - def enum_b2_args(self): - with self._create_build_dir() as build_dir: - for platform in self.platforms: - for configuration in self.configurations: - for link, runtime_link in self._linkage_options(): - yield self._build_params(build_dir, platform, configuration, link, runtime_link) - - def _linkage_options(self): - for link in self.link: - runtime_link = self.runtime_link - if runtime_link is Linkage.STATIC: - if link is Linkage.SHARED: - logging.warning("Cannot link the runtime statically to a dynamic library, going to link dynamically") - runtime_link = Linkage.SHARED - elif _on_linux(): - logging.warning("Cannot link to the GNU C Library (which is assumed) statically, going to link dynamically") - runtime_link = Linkage.SHARED - yield link, runtime_link - - @contextmanager - def _create_build_dir(self): - if self.build_dir is not None: - logging.info('Build directory: %s', self.build_dir) - yield self.build_dir - return - - with tempfile.TemporaryDirectory(dir=os.path.dirname(self.boost_dir)) as build_dir: - logging.info('Build directory: %s', build_dir) - try: - yield build_dir - finally: - logging.info('Removing build directory: %s', build_dir) - return - - def _build_params(self, build_dir, platform, configuration, link, runtime_link): - params = [] - params.append(self._build_dir(build_dir)) - params.append(self._stagedir(platform, configuration)) - params.append(self._link(link)) - params.append(self._runtime_link(runtime_link)) - params.append(self._address_model(platform)) - params.append(self._variant(configuration)) - params += self.b2_args - return params - - @staticmethod - def _build_dir(build_dir): - return f'--build-dir={build_dir}' - - def _stagedir(self, platform, configuration): - # Having different --stagedir values for every configuration/platform - # combination is unnecessary on Windows. - # Even for older Boost versions (when the binaries weren't tagged with - # their target platform) only a single --stagedir for every platform - # would suffice. - # For newer versions, just a single --stagedir would do, as the - # binaries are tagged with the target platform, as well as their - # configuration (a.k.a. "variant" in Boost's terminology). - # Still, uniformity helps. - platform = str(platform) - configuration = str(configuration) - return f'--stagedir={os.path.join(self.stage_dir, platform, configuration)}' - - @staticmethod - def _link(link): - return f'link={link}' - - @staticmethod - def _runtime_link(runtime_link): - return f'runtime-link={runtime_link}' - - @staticmethod - def _address_model(platform): - return f'address-model={platform.get_address_model()}' - - @staticmethod - def _variant(configuration): - return f'variant={str(configuration.normalize()).lower()}' - - -def _parse_dir(s): - return os.path.abspath(os.path.normpath(s)) - - -def _parse_args(argv=None): - if argv is None: - argv = sys.argv[1:] - logging.info('Command line arguments: %s', argv) - - parser = argparse.ArgumentParser( - description=__doc__, - formatter_class=argparse.RawDescriptionHelpFormatter) - - subparsers = parser.add_subparsers(dest='command') - - download = subparsers.add_parser('download', help='download & bootstrap Boost') - - download.add_argument('--cache', metavar='DIR', dest='cache_dir', - type=_parse_dir, - help='download directory (temporary file unless specified)') - download.add_argument('--unpack', metavar='DIR', dest='unpack_dir', - type=_parse_dir, default='.', - help='directory to unpack the archive to') - download.add_argument('boost_version', metavar='VERSION', - type=BoostVersion.from_string, - help='Boost version (in the MAJOR.MINOR.PATCH format)') - - build = subparsers.add_parser('build', help='build the libraries') - - # These are used to put the built libraries into proper stage/ - # subdirectories (to avoid name clashes). - build.add_argument('--platform', metavar='PLATFORM', - nargs='*', dest='platforms', default=[], - type=_parse_platform, - help=f'target platform ({"/".join(map(str, Platform))})') - build.add_argument('--configuration', metavar='CONFIGURATION', - nargs='*', dest='configurations', default=[], - type=_parse_configuration, - help=f'target configuration ({"/".join(map(str, Configuration))})') - # This is needed because the default behaviour on Linux and Windows is - # different: static & dynamic libs are built on Linux, but only static libs - # are built on Windows by default. - build.add_argument('--link', metavar='LINKAGE', - nargs='*', default=[], - type=_parse_linkage, - help=f'how the libraries are linked ({"/".join(map(str, Linkage))})') - # This is used to omit runtime-link=static I'd have to otherwise use a lot, - # plus the script validates the link= and runtime-link= combinations. - build.add_argument('--runtime-link', metavar='LINKAGE', - type=_parse_linkage, default=Linkage.STATIC, - help=f'how the libraries link to the runtime ({"/".join(map(str, Linkage))})') - - build.add_argument('--build', metavar='DIR', dest='build_dir', - type=_parse_dir, - help='Boost build directory (temporary directory unless specified)') - build.add_argument('boost_dir', metavar='DIR', - type=_parse_dir, - help='root Boost directory') - - build.add_argument('b2_args', nargs='*', metavar='B2_ARG', default=[], - help='additional b2 arguments, to be passed verbatim') - - args = parser.parse_args(argv) - if args.command is None: - parser.error("please specify a command") - return args - - -def build(args): - build_params = BuildParameters(args) - boost_dir = BoostDir(args.boost_dir) - boost_dir.build(build_params) - - -def download(args): - storage = TempStorage(args.unpack_dir) - if args.cache_dir is not None: - storage = CacheStorage(args.cache_dir) - with storage.download(args.boost_version) as archive: - boost_dir = archive.unpack(args.unpack_dir) - boost_dir.bootstrap() - - -def main(argv=None): - args = _parse_args(argv) - if args.command == 'download': - download(args) - elif args.command == 'build': - build(args) - else: - raise NotImplementedError(f'unsupported command: {args.command}') - - -def _main(argv=None): - _setup_logging() - try: - main(argv) - except Exception as e: - logging.exception(e) - raise - - -if __name__ == '__main__': - _main() diff --git a/boost/build/ci/appveyor.py b/boost/build/ci/appveyor.py deleted file mode 100644 index 4a55e20..0000000 --- a/boost/build/ci/appveyor.py +++ /dev/null @@ -1,124 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2020 Egor Tensin -# This file is part of the "cmake-common" project. -# For details, see https://github.com/egor-tensin/cmake-common. -# Distributed under the MIT License. - -'''Download & build Boost on AppVeyor. - -This is similar to build.py, but auto-fills some parameters for build.py from -the AppVeyor-defined environment variables. This script is rarely usefull, -since AppVeyor images come with lots of pre-built Boost distributions, but -still. - -Boost is built in C:\projects\boost. -''' - -import argparse -import logging -import os -import os.path -import sys - - -def _env(name): - if name not in os.environ: - raise RuntimeError(f'undefined environment variable: {name}') - return os.environ[name] - - -def _check_appveyor(): - if 'APPVEYOR' not in os.environ: - raise RuntimeError('not running on AppVeyor') - - -def _get_build_dir(): - return 'C:\\projects' - - -def _get_boost_dir(): - return os.path.join(_get_build_dir(), 'boost') - - -def _get_boost_version(): - return _env('appveyor_boost_version') - - -def _get_configuration(): - return _env('CONFIGURATION') - - -def _get_platform(): - return _env('PLATFORM') - - -def _setup_logging(): - logging.basicConfig( - format='%(asctime)s | %(levelname)s | %(message)s', - level=logging.INFO) - - -def _parse_args(argv=None): - if argv is None: - argv = sys.argv[1:] - logging.info('Command line arguments: %s', argv) - - parser = argparse.ArgumentParser( - description=__doc__, - formatter_class=argparse.RawDescriptionHelpFormatter) - parser.add_argument('--link', metavar='LINKAGE', nargs='*', - help='how the libraries are linked (i.e. static/shared)') - parser.add_argument('--runtime-link', metavar='LINKAGE', - help='how the libraries link to the runtime') - parser.add_argument('b2_args', nargs='*', metavar='B2_ARG', default=[], - help='additional b2 arguments, to be passed verbatim') - return parser.parse_args(argv) - - -def build_appveyor(argv=None): - args = _parse_args(argv) - _check_appveyor() - - this_module_dir = os.path.dirname(os.path.abspath(__file__)) - parent_module_dir = os.path.dirname(this_module_dir) - sys.path.insert(1, parent_module_dir) - from build import BoostVersion, main as build_main - - version = BoostVersion.from_string(_get_boost_version()) - appveyor_argv = [ - 'download', - '--unpack', _get_build_dir(), - '--', str(version) - ] - build_main(appveyor_argv) - - unpacked_boost_dir = version.dir_path(_get_build_dir()) - boost_dir = _get_boost_dir() - os.rename(unpacked_boost_dir, boost_dir) - - appveyor_argv = [ - 'build', - '--configuration', _get_configuration(), - '--platform', _get_platform(), - ] - if args.link is not None: - appveyor_argv.append('--link') - appveyor_argv += args.link - if args.runtime_link is not None: - appveyor_argv += ['--runtime-link', args.runtime_link] - appveyor_argv += ['--', boost_dir] - build_main(appveyor_argv + args.b2_args) - - -def main(argv=None): - _setup_logging() - try: - build_appveyor(argv) - except Exception as e: - logging.exception(e) - raise - - -if __name__ == '__main__': - main() diff --git a/boost/build/ci/travis.py b/boost/build/ci/travis.py deleted file mode 100755 index 7bbb18d..0000000 --- a/boost/build/ci/travis.py +++ /dev/null @@ -1,122 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2019 Egor Tensin -# This file is part of the "cmake-common" project. -# For details, see https://github.com/egor-tensin/cmake-common. -# Distributed under the MIT License. - -'''Download & build Boost on Travis. - -This is similar to build.py, but auto-fills some parameters for build.py from -the Travis-defined environment variables. - -Boost is built in $HOME/boost. -''' - -import argparse -import logging -import os -import os.path -import sys - - -def _env(name): - if name not in os.environ: - raise RuntimeError(f'undefined environment variable: {name}') - return os.environ[name] - - -def _check_travis(): - if 'TRAVIS' not in os.environ: - raise RuntimeError('not running on Travis') - - -def _get_build_dir(): - return _env('HOME') - - -def _get_boost_dir(): - return os.path.join(_get_build_dir(), 'boost') - - -def _get_boost_version(): - return _env('travis_boost_version') - - -def _get_configuration(): - return _env('configuration') - - -def _get_platform(): - return _env('platform') - - -def _setup_logging(): - logging.basicConfig( - format='%(asctime)s | %(levelname)s | %(message)s', - level=logging.INFO) - - -def _parse_args(argv=None): - if argv is None: - argv = sys.argv[1:] - logging.info('Command line arguments: %s', argv) - - parser = argparse.ArgumentParser( - description=__doc__, - formatter_class=argparse.RawDescriptionHelpFormatter) - parser.add_argument('--link', metavar='LINKAGE', nargs='*', - help='how the libraries are linked') - parser.add_argument('--runtime-link', metavar='LINKAGE', - help='how the libraries link to the runtime') - parser.add_argument('b2_args', nargs='*', metavar='B2_ARG', default=[], - help='additional b2 arguments, to be passed verbatim') - return parser.parse_args(argv) - - -def build_travis(argv=None): - args = _parse_args(argv) - _check_travis() - - this_module_dir = os.path.dirname(os.path.abspath(__file__)) - parent_module_dir = os.path.dirname(this_module_dir) - sys.path.insert(1, parent_module_dir) - from build import BoostVersion, main as build_main - - version = BoostVersion.from_string(_get_boost_version()) - travis_argv = [ - 'download', - '--unpack', _get_build_dir(), - '--', str(version) - ] - build_main(travis_argv) - - unpacked_boost_dir = version.dir_path(_get_build_dir()) - boost_dir = _get_boost_dir() - os.rename(unpacked_boost_dir, boost_dir) - - travis_argv = [ - 'build', - '--configuration', _get_configuration(), - '--platform', _get_platform(), - ] - if args.link is not None: - travis_argv.append('--link') - travis_argv += args.link - if args.runtime_link is not None: - travis_argv += ['--runtime-link', args.runtime_link] - travis_argv += ['--', boost_dir] - build_main(travis_argv + args.b2_args) - - -def main(argv=None): - _setup_logging() - try: - build_travis(argv) - except Exception as e: - logging.exception(e) - raise - - -if __name__ == '__main__': - main() diff --git a/boost/toolchains/README.md b/boost/toolchains/README.md deleted file mode 100644 index 8c6870a..0000000 --- a/boost/toolchains/README.md +++ /dev/null @@ -1,2 +0,0 @@ -Use the toolchain files by passing something like -`--user-config=PATH/TO/cmake-common/boost/toolchains/TOOLCHAIN.jam` to `b2`. diff --git a/boost/toolchains/mingw-w64-x64-exe.jam b/boost/toolchains/mingw-w64-x64-exe.jam deleted file mode 100644 index 46ab535..0000000 --- a/boost/toolchains/mingw-w64-x64-exe.jam +++ /dev/null @@ -1 +0,0 @@ -using gcc : : x86_64-w64-mingw32-g++.exe : windows ; diff --git a/boost/toolchains/mingw-w64-x64.jam b/boost/toolchains/mingw-w64-x64.jam deleted file mode 100644 index f52acfa..0000000 --- a/boost/toolchains/mingw-w64-x64.jam +++ /dev/null @@ -1 +0,0 @@ -using gcc : : x86_64-w64-mingw32-g++ : windows ; diff --git a/boost/toolchains/mingw-w64-x86-exe.jam b/boost/toolchains/mingw-w64-x86-exe.jam deleted file mode 100644 index 87beca0..0000000 --- a/boost/toolchains/mingw-w64-x86-exe.jam +++ /dev/null @@ -1 +0,0 @@ -using gcc : : i686-w64-mingw32-g++.exe : windows ; diff --git a/boost/toolchains/mingw-w64-x86.jam b/boost/toolchains/mingw-w64-x86.jam deleted file mode 100644 index e73f190..0000000 --- a/boost/toolchains/mingw-w64-x86.jam +++ /dev/null @@ -1 +0,0 @@ -using gcc : : i686-w64-mingw32-g++ : windows ; diff --git a/cmake/build/README.md b/cmake/build/README.md deleted file mode 100644 index b63564d..0000000 --- a/cmake/build/README.md +++ /dev/null @@ -1,13 +0,0 @@ -CMake -===== - -Build a CMake project. -Consult the output of `build.py --help` for details. - -A simple usage example: - - > python3 build.py --configuration Release --install path/to/somewhere -- ../examples/simple - ... - - > ./path/to/somewhere/bin/foo - foo diff --git a/cmake/build/build.py b/cmake/build/build.py deleted file mode 100755 index 695489b..0000000 --- a/cmake/build/build.py +++ /dev/null @@ -1,190 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2019 Egor Tensin -# This file is part of the "cmake-common" project. -# For details, see https://github.com/egor-tensin/cmake-common. -# Distributed under the MIT License. - -R'''Build a CMake project. - -This script is used basically to invoke the CMake executable in a -cross-platform way (provided the platform has Python 3, of course). The -motivation was to merge my Travis and AppVeyor build scripts (largely similar, -but written in bash and PowerShell, respectively). - -A simple usage example: - - $ %(prog)s --configuration Release --install path/to/somewhere -- ../examples/simple - ... - - $ ./path/to/somewhere/bin/foo - foo - -Picking the target platform is build system-specific. On Visual Studio, pass -the target platform using the `-A` flag like this: - - > %(prog)s --install path\to\somewhere -- ..\examples\simple -A Win32 - ... - -Using GCC-like compilers, the best way is to use CMake toolchain files (see -cmake/toolchains in this repository for examples). - - $ %(prog)s --install path/to/somewhere -- ../examples/simple -D CMAKE_TOOLCHAIN_FILE="$( pwd )/../toolchains/mingw-x86.cmake" - ... -''' - -import argparse -from contextlib import contextmanager -import logging -from enum import Enum -import os -import os.path -import subprocess -import sys -import tempfile - - -def _run_executable(cmd_line): - logging.info('Running executable: %s', cmd_line) - return subprocess.run(cmd_line, check=True) - - -def _run_cmake(cmake_args): - _run_executable(['cmake'] + cmake_args) - - -class Configuration(Enum): - DEBUG = 'Debug' - MINSIZEREL = 'MinSizeRel' - RELWITHDEBINFO = 'RelWithDebInfo' - RELEASE = 'Release' - - def __str__(self): - return self.value - - -def _parse_configuration(s): - try: - return Configuration(s) - except ValueError: - raise argparse.ArgumentTypeError(f'invalid configuration: {s}') - - -@contextmanager -def _create_build_dir(args): - if args.build_dir is not None: - logging.info('Build directory: %s', args.build_dir) - yield args.build_dir - return - - with tempfile.TemporaryDirectory(dir=os.path.dirname(args.src_dir)) as build_dir: - logging.info('Build directory: %s', build_dir) - try: - yield build_dir - finally: - logging.info('Removing build directory: %s', build_dir) - return - - -class GenerationPhase: - def __init__(self, build_dir, args): - self.build_dir = build_dir - self.args = args - - def _cmake_args(self): - return self._to_cmake_args(self.build_dir, self.args) - - @staticmethod - def _to_cmake_args(build_dir, args): - result = [] - if args.install_dir is not None: - result += ['-D', f'CMAKE_INSTALL_PREFIX={args.install_dir}'] - if args.configuration is not None: - result += ['-D', f'CMAKE_BUILD_TYPE={args.configuration}'] - if args.cmake_args is not None: - result += args.cmake_args - result += [f'-B{build_dir}', f'-H{args.src_dir}'] - return result - - def run(self): - _run_cmake(self._cmake_args()) - - -class BuildPhase: - def __init__(self, build_dir, args): - self.build_dir = build_dir - self.args = args - - def _cmake_args(self): - return self._to_cmake_args(self.build_dir, self.args) - - @staticmethod - def _to_cmake_args(build_dir, args): - result = ['--build', build_dir] - if args.configuration is not None: - result += ['--config', str(args.configuration)] - if args.install_dir is not None: - result += ['--target', 'install'] - return result - - def run(self): - _run_cmake(self._cmake_args()) - - -def _parse_dir(s): - return os.path.abspath(os.path.normpath(s)) - - -def _parse_args(argv=None): - if argv is None: - argv = sys.argv[1:] - logging.info('Command line arguments: %s', argv) - - parser = argparse.ArgumentParser( - description=__doc__, - formatter_class=argparse.RawDescriptionHelpFormatter) - - parser.add_argument('--build', metavar='DIR', dest='build_dir', - type=_parse_dir, - help='build directory (temporary directory unless specified)') - parser.add_argument('--install', metavar='DIR', dest='install_dir', - type=_parse_dir, - help='install directory') - parser.add_argument('--configuration', metavar='CONFIG', - type=_parse_configuration, default=Configuration.DEBUG, - help=f'build configuration ({"/".join(map(str, Configuration))})') - parser.add_argument('src_dir', metavar='DIR', - type=_parse_dir, - help='source directory') - parser.add_argument('cmake_args', nargs='*', metavar='CMAKE_ARG', - help='additional CMake arguments, to be passed verbatim') - args = parser.parse_args(argv) - return args - - -def _setup_logging(): - logging.basicConfig( - format='%(asctime)s | %(levelname)s | %(message)s', - level=logging.INFO) - - -def build(argv=None): - args = _parse_args(argv) - with _create_build_dir(args) as build_dir: - gen_phase = GenerationPhase(build_dir, args) - gen_phase.run() - build_phase = BuildPhase(build_dir, args) - build_phase.run() - - -def main(argv=None): - _setup_logging() - try: - build(argv) - except Exception as e: - logging.exception(e) - raise - - -if __name__ == '__main__': - main() diff --git a/cmake/build/ci/appveyor.py b/cmake/build/ci/appveyor.py deleted file mode 100755 index b9141ec..0000000 --- a/cmake/build/ci/appveyor.py +++ /dev/null @@ -1,167 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2019 Egor Tensin -# This file is part of the "cmake-common" project. -# For details, see https://github.com/egor-tensin/cmake-common. -# Distributed under the MIT License. - -'''Build a CMake project on AppVeyor. - -This is similar to build.py, but auto-fills some parameters for build.py from -the AppVeyor-defined environment variables. - -The project is built in C:\Projects\build. -''' - -import argparse -from enum import Enum -import logging -import os -import sys - - -class Image(Enum): - VS_2013 = 'Visual Studio 2013' - VS_2015 = 'Visual Studio 2015' - VS_2017 = 'Visual Studio 2017' - VS_2019 = 'Visual Studio 2019' - - def __str__(self): - return self.value - - -def _parse_image(s): - try: - return Image(s) - except ValueError as e: - raise ValueError(f'unsupported AppVeyor image: {s}') from e - - -class Generator(Enum): - VS_2013 = 'Visual Studio 12 2013' - VS_2015 = 'Visual Studio 14 2015' - VS_2017 = 'Visual Studio 15 2017' - VS_2019 = 'Visual Studio 16 2019' - - def __str__(self): - return self.value - - @staticmethod - def from_image(image): - if image is Image.VS_2013: - return Generator.VS_2013 - if image is Image.VS_2015: - return Generator.VS_2015 - if image is Image.VS_2017: - return Generator.VS_2017 - if image is Image.VS_2019: - return Generator.VS_2019 - raise RuntimeError(f"don't know which generator to use for image: {image}") - - -class Platform(Enum): - x86 = 'Win32' - X64 = 'x64' - - def __str__(self): - return self.value - - -def _parse_platform(s): - try: - return Platform(s) - except ValueError as e: - raise ValueError(f'unsupported AppVeyor platform: {s}') from e - - -def _env(name): - if name not in os.environ: - raise RuntimeError(f'undefined environment variable: {name}') - return os.environ[name] - - -def _check_appveyor(): - if 'APPVEYOR' not in os.environ: - raise RuntimeError('not running on AppVeyor') - - -def _get_src_dir(): - return _env('APPVEYOR_BUILD_FOLDER') - - -def _get_build_dir(): - return R'C:\Projects\build' - - -def _get_generator(): - image = _parse_image(_env('APPVEYOR_BUILD_WORKER_IMAGE')) - return str(Generator.from_image(image)) - - -def _get_platform(): - return str(_parse_platform(_env('PLATFORM'))) - - -def _get_configuration(): - return _env('CONFIGURATION') - - -def _setup_logging(): - logging.basicConfig( - format='%(asctime)s | %(levelname)s | %(message)s', - level=logging.INFO) - - -def _parse_args(argv=None): - if argv is None: - argv = sys.argv[1:] - logging.info('Command line arguments: %s', argv) - - parser = argparse.ArgumentParser( - description=__doc__, - formatter_class=argparse.RawDescriptionHelpFormatter) - - parser.add_argument('--install', metavar='DIR', dest='install_dir', - help='install directory') - parser.add_argument('cmake_args', nargs='*', metavar='CMAKE_ARG', default=[], - help='additional CMake arguments, to be passed verbatim') - return parser.parse_args(argv) - - -def build_appveyor(argv=None): - args = _parse_args(argv) - _check_appveyor() - - this_module_dir = os.path.dirname(os.path.abspath(__file__)) - parent_module_dir = os.path.dirname(this_module_dir) - sys.path.insert(1, parent_module_dir) - from build import build - - appveyor_argv = [ - '--build', _get_build_dir(), - '--configuration', _get_configuration(), - ] - if args.install_dir is not None: - appveyor_argv += [ - '--install', args.install_dir, - ] - appveyor_argv += [ - '--', - _get_src_dir(), - '-G', _get_generator(), - '-A', _get_platform(), - ] - build(appveyor_argv + args.cmake_args) - - -def main(argv=None): - _setup_logging() - try: - build_appveyor(argv) - except Exception as e: - logging.exception(e) - raise - - -if __name__ == '__main__': - main() diff --git a/cmake/build/ci/travis.py b/cmake/build/ci/travis.py deleted file mode 100755 index ab93711..0000000 --- a/cmake/build/ci/travis.py +++ /dev/null @@ -1,102 +0,0 @@ -#!/usr/bin/env python3 - -# Copyright (c) 2019 Egor Tensin -# This file is part of the "cmake-common" project. -# For details, see https://github.com/egor-tensin/cmake-common. -# Distributed under the MIT License. - -'''Build a CMake project on Travis. - -This is similar to build.py, but auto-fills some parameters for build.py from -the Travis-defined environment variables. - -The project is built in $HOME/build. -''' - -import argparse -import logging -import os -import os.path -import sys - - -def _env(name): - if name not in os.environ: - raise RuntimeError(f'undefined environment variable: {name}') - return os.environ[name] - - -def _check_travis(): - if 'TRAVIS' not in os.environ: - raise RuntimeError('not running on Travis') - - -def _get_src_dir(): - return _env('TRAVIS_BUILD_DIR') - - -def _get_build_dir(): - return os.path.join(_env('HOME'), 'build') - - -def _get_configuration(): - return _env('configuration') - - -def _setup_logging(): - logging.basicConfig( - format='%(asctime)s | %(levelname)s | %(message)s', - level=logging.INFO) - - -def _parse_args(argv=None): - if argv is None: - argv = sys.argv[1:] - logging.info('Command line arguments: %s', argv) - - parser = argparse.ArgumentParser( - description=__doc__, - formatter_class=argparse.RawDescriptionHelpFormatter) - - parser.add_argument('--install', metavar='DIR', dest='install_dir', - help='install directory') - parser.add_argument('cmake_args', nargs='*', metavar='CMAKE_ARG', default=[], - help='additional CMake arguments, to be passed verbatim') - return parser.parse_args(argv) - - -def build_travis(argv=None): - args = _parse_args(argv) - _check_travis() - - this_module_dir = os.path.dirname(os.path.abspath(__file__)) - parent_module_dir = os.path.dirname(this_module_dir) - sys.path.insert(1, parent_module_dir) - from build import build - - travis_argv = [ - '--build', _get_build_dir(), - '--configuration', _get_configuration(), - ] - if args.install_dir is not None: - travis_argv += [ - '--install', args.install_dir, - ] - travis_argv += [ - '--', - _get_src_dir(), - ] - build(travis_argv + args.cmake_args) - - -def main(argv=None): - _setup_logging() - try: - build_travis(argv) - except Exception as e: - logging.exception(e) - raise - - -if __name__ == '__main__': - main() diff --git a/cmake/common.cmake b/cmake/common.cmake deleted file mode 100644 index 0d813fe..0000000 --- a/cmake/common.cmake +++ /dev/null @@ -1,225 +0,0 @@ -# Copyright (c) 2017 Egor Tensin -# This file is part of the "cmake-common" project. -# For details, see https://github.com/egor-tensin/cmake-common. -# Distributed under the MIT License. - -# It's a CMake code snippet I use in all of my CMake projects. -# It makes targets link the runtime statically by default, strips debug symbols -# in release builds and sets a couple of useful compilation options. - -# Add this to the top-level CMakeLists.txt (unless a higher version has already -# been specified): -# -# cmake_minimum_required(VERSION 3.1) - -# Without this policy set, this line: -# -# if(toolset STREQUAL "MSVC") -# -# evaluates to false even when using Visual Studio (since MSVC is a predefined -# variable; it's completely bonkers). -if(NOT POLICY CMP0054) - message(FATAL_ERROR "common.cmake uses CMP0054, which is unsupported by this CMake version") -endif() -cmake_policy(SET CMP0054 NEW) - -# Toolset identification: - -if(CMAKE_C_COMPILER_ID) - set(toolset "${CMAKE_C_COMPILER_ID}") -elseif(CMAKE_CXX_COMPILER_ID) - set(toolset "${CMAKE_CXX_COMPILER_ID}") -else() - set(toolset "unknown") -endif() - -if(toolset STREQUAL "GNU") - set(is_gcc ON) -elseif(toolset STREQUAL "MSVC") - set(is_msvc ON) -else() - message(WARNING "Unrecognized toolset: ${toolset}") -endif() - -# User-defined switches: - -set(default_value ON) -get_directory_property(parent_dir PARENT_DIRECTORY) -if(parent_dir) - set(default_value OFF) -endif() - -if(NOT DEFINED CC_CXX_STANDARD) - set(CC_CXX_STANDARD "14" CACHE STRING "C++ standard version") -endif() -if(NOT DEFINED CC_BEST_PRACTICES) - option(CC_BEST_PRACTICES "Set common compiler options" "${default_value}") -endif() -if(NOT DEFINED CC_WINDOWS_DEF) - option(CC_WINDOWS_DEF "Define useful Windows macros" "${default_value}") -endif() -if(NOT DEFINED CC_STATIC_RUNTIME) - set(static_runtime_default_value "${default_value}") - if(DEFINED Boost_USE_STATIC_LIBS AND NOT Boost_USE_STATIC_LIBS) - # Linking to dynamic Boost libs and the static runtime is a no-no: - set(static_runtime_default_value OFF) - elseif(CMAKE_SYSTEM_NAME STREQUAL "Windows" OR MINGW) - else() - # At this point, Linux-like environment & the GNU C Library are assumed. - set(static_runtime_default_value OFF) - endif() - option(CC_STATIC_RUNTIME "Link the runtime statically" "${static_runtime_default_value}") -endif() -if(NOT DEFINED CC_STRIP_SYMBOLS) - option(CC_STRIP_SYMBOLS "Strip debug symbols" "${default_value}") -endif() - -option(Boost_USE_STATIC_LIBS "Use the static Boost libraries" "${default_value}") -option(Boost_USE_STATIC_RUNTIME "Use Boost libraries linked to the runtime statically" "${CC_STATIC_RUNTIME}") - -message(STATUS "Toolset: ${toolset}") -message(STATUS "C++ standard: ${CC_CXX_STANDARD}") -message(STATUS "Set common compiler options: ${CC_BEST_PRACTICES}") -message(STATUS "Define useful Windows macros: ${CC_WINDOWS_DEF}") -message(STATUS "Use the static Boost libraries: ${Boost_USE_STATIC_LIBS}") -message(STATUS "Link the runtime statically: ${CC_STATIC_RUNTIME}") -message(STATUS "Strip symbols: ${CC_STRIP_SYMBOLS}") - -# C++ standard version: - -set(CMAKE_CXX_STANDARD "${CC_CXX_STANDARD}") -set(CMAKE_CXX_STANDARD_REQUIRED ON) -set(CMAKE_CXX_EXTENSIONS OFF) - -# Common compiler options routines: - -function(_cc_best_practices_msvc target) - set(compile_options /MP /W4) - get_target_property(target_type "${target}" TYPE) - get_target_property(aliased "${target}" ALIASED_TARGET) - if(NOT target_type STREQUAL "INTERFACE_LIBRARY" AND NOT aliased) - target_compile_options("${target}" PRIVATE ${compile_options}) - endif() -endfunction() - -function(_cc_best_practices_gcc target) - set(compile_options -Wall -Wextra) - get_target_property(target_type "${target}" TYPE) - get_target_property(aliased "${target}" ALIASED_TARGET) - if(NOT target_type STREQUAL "INTERFACE_LIBRARY" AND NOT aliased) - target_compile_options("${target}" PRIVATE ${compile_options}) - endif() -endfunction() - -function(_cc_best_practices target) - if(is_msvc) - _cc_best_practices_msvc("${target}") - elseif(is_gcc) - _cc_best_practices_gcc("${target}") - endif() -endfunction() - -# Useful Windows macros routines: - -function(_cc_common_windows_definitions target) - set(compile_definitions WIN32_LEAN_AND_MEAN NOMINMAX) - get_target_property(target_type "${target}" TYPE) - if(target_type STREQUAL "INTERFACE_LIBRARY") - target_compile_definitions("${target}" INTERFACE ${compile_definitions}) - else() - get_target_property(aliased "${target}" ALIASED_TARGET) - if(NOT aliased) - target_compile_definitions("${target}" PRIVATE ${compile_definitions}) - endif() - endif() -endfunction() - -# Static runtime routines: - -function(_cc_static_runtime_msvc target) - get_target_property(target_type "${target}" TYPE) - get_target_property(aliased "${target}" ALIASED_TARGET) - if(NOT target_type STREQUAL "INTERFACE_LIBRARY" AND NOT aliased) - target_compile_options("${target}" PRIVATE - $<$:/MTd> - $<$>:/MT>) - endif() -endfunction() - -function(_cc_static_runtime_gcc target) - get_target_property(target_type "${target}" TYPE) - get_target_property(aliased "${target}" ALIASED_TARGET) - if(NOT target_type STREQUAL "INTERFACE_LIBRARY" AND NOT aliased) - # This causes issues with mixing keyword- and plain- versions of - # target_link_libraries: - #target_link_libraries("${target}" PRIVATE -static) - - set_property(TARGET "${target}" APPEND_STRING PROPERTY LINK_FLAGS " -static") - - # Or (haven't tested this), if CMake 3.13+ is used: - #target_link_options("${target}" PRIVATE -static) - endif() -endfunction() - -function(_cc_static_runtime target) - if(is_msvc) - _cc_static_runtime_msvc("${target}") - elseif(is_gcc) - _cc_static_runtime_gcc("${target}") - endif() -endfunction() - -# Symbol stripping routines: - -function(_cc_strip_symbols_gcc target) - get_target_property(target_type "${target}" TYPE) - get_target_property(aliased "${target}" ALIASED_TARGET) - if(NOT target_type STREQUAL "INTERFACE_LIBRARY" AND NOT aliased) - set(release_build $,$>) - if(release_build) - # This causes issues with mixing keyword- and plain- versions of - # target_link_libraries: - #target_link_libraries("${target}" PRIVATE -s) - - set_property(TARGET "${target}" APPEND_STRING PROPERTY LINK_FLAGS " -s") - endif() - endif() -endfunction() - -function(_cc_strip_symbols target) - if(is_gcc) - _cc_strip_symbols_gcc("${target}") - endif() -endfunction() - -# Main macros: - -function(_cc_apply_settings target) - if(TARGET "${target}") - get_target_property(target_imported "${target}" IMPORTED) - if(NOT target_imported) - if(CC_BEST_PRACTICES) - _cc_best_practices("${target}") - endif() - if(CC_WINDOWS_DEF) - _cc_common_windows_definitions("${target}") - endif() - if(CC_STRIP_SYMBOLS) - _cc_strip_symbols("${target}") - endif() - if(CC_STATIC_RUNTIME) - _cc_static_runtime("${target}") - endif() - endif() - endif() -endfunction() - -macro(add_executable target) - _add_executable(${ARGV}) - _cc_apply_settings("${target}") -endmacro() - -macro(add_library target) - _add_library(${ARGV}) - _cc_apply_settings("${target}") -endmacro() diff --git a/cmake/examples/boost/CMakeLists.txt b/cmake/examples/boost/CMakeLists.txt deleted file mode 100644 index 8c076c9..0000000 --- a/cmake/examples/boost/CMakeLists.txt +++ /dev/null @@ -1,14 +0,0 @@ -cmake_minimum_required(VERSION 3.5) # for Boost::* imported targets - -project(example_boost) - -include(../../common.cmake) - -find_package(Boost REQUIRED COMPONENTS filesystem) -add_executable(foo foo.cpp) -target_link_libraries(foo PRIVATE Boost::disable_autolinking Boost::filesystem) - -install(TARGETS foo RUNTIME DESTINATION bin) -if(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC") - install(FILES "$" DESTINATION bin OPTIONAL) -endif() diff --git a/cmake/examples/boost/foo.cpp b/cmake/examples/boost/foo.cpp deleted file mode 100644 index 3bd0326..0000000 --- a/cmake/examples/boost/foo.cpp +++ /dev/null @@ -1,11 +0,0 @@ -#include - -#include - -int main(int argc, char* argv[]) { - std::cout << "Hello from " - << boost::filesystem::absolute(boost::filesystem::path{argv[0]}) - .string() - << "!\n"; - return 0; -} diff --git a/cmake/examples/dynamic/CMakeLists.txt b/cmake/examples/dynamic/CMakeLists.txt deleted file mode 100644 index 4602adb..0000000 --- a/cmake/examples/dynamic/CMakeLists.txt +++ /dev/null @@ -1,16 +0,0 @@ -cmake_minimum_required(VERSION 3.1) - -project(example_dynamic) - -include(../../common.cmake) - -add_library(baz SHARED baz.cpp) -target_include_directories(baz PUBLIC .) - -add_executable(foo foo.cpp) -target_link_libraries(foo PRIVATE baz) - -install(TARGETS foo baz RUNTIME DESTINATION bin LIBRARY DESTINATION lib) -if(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC") - install(FILES "$" "$" DESTINATION bin OPTIONAL) -endif() diff --git a/cmake/examples/dynamic/baz.cpp b/cmake/examples/dynamic/baz.cpp deleted file mode 100644 index d108ae3..0000000 --- a/cmake/examples/dynamic/baz.cpp +++ /dev/null @@ -1,7 +0,0 @@ -#include "baz.hpp" - -#include - -void baz() { - std::cout << "baz\n"; -} diff --git a/cmake/examples/dynamic/baz.hpp b/cmake/examples/dynamic/baz.hpp deleted file mode 100644 index 2fc9b2a..0000000 --- a/cmake/examples/dynamic/baz.hpp +++ /dev/null @@ -1,9 +0,0 @@ -#pragma once - -#ifdef _MSC_VER -#define DLLEXPORT __declspec(dllexport) -#else -#define DLLEXPORT -#endif - -DLLEXPORT void baz(); diff --git a/cmake/examples/dynamic/foo.cpp b/cmake/examples/dynamic/foo.cpp deleted file mode 100644 index b7d9986..0000000 --- a/cmake/examples/dynamic/foo.cpp +++ /dev/null @@ -1,6 +0,0 @@ -#include - -int main() { - baz(); - return 0; -} diff --git a/cmake/examples/simple/CMakeLists.txt b/cmake/examples/simple/CMakeLists.txt deleted file mode 100644 index 4f8859e..0000000 --- a/cmake/examples/simple/CMakeLists.txt +++ /dev/null @@ -1,12 +0,0 @@ -cmake_minimum_required(VERSION 3.1) - -project(example_simple) - -include(../../common.cmake) - -add_executable(foo foo.cpp) - -install(TARGETS foo RUNTIME DESTINATION bin) -if(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC") - install(FILES "$" DESTINATION bin OPTIONAL) -endif() diff --git a/cmake/examples/simple/foo.cpp b/cmake/examples/simple/foo.cpp deleted file mode 100644 index b9d3132..0000000 --- a/cmake/examples/simple/foo.cpp +++ /dev/null @@ -1,6 +0,0 @@ -#include - -int main() { - std::cout << "foo\n"; - return 0; -} diff --git a/cmake/examples/static/CMakeLists.txt b/cmake/examples/static/CMakeLists.txt deleted file mode 100644 index 8a6acb8..0000000 --- a/cmake/examples/static/CMakeLists.txt +++ /dev/null @@ -1,16 +0,0 @@ -cmake_minimum_required(VERSION 3.1) - -project(example_static) - -include(../../common.cmake) - -add_library(bar bar.cpp) -target_include_directories(bar PUBLIC .) - -add_executable(foo foo.cpp) -target_link_libraries(foo PRIVATE bar) - -install(TARGETS foo bar RUNTIME DESTINATION bin ARCHIVE DESTINATION lib) -if(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC") - install(FILES "$" DESTINATION bin OPTIONAL) -endif() diff --git a/cmake/examples/static/bar.cpp b/cmake/examples/static/bar.cpp deleted file mode 100644 index 37aa9b5..0000000 --- a/cmake/examples/static/bar.cpp +++ /dev/null @@ -1,7 +0,0 @@ -#include "bar.hpp" - -#include - -void bar() { - std::cout << "bar\n"; -} diff --git a/cmake/examples/static/bar.hpp b/cmake/examples/static/bar.hpp deleted file mode 100644 index a3ea4c1..0000000 --- a/cmake/examples/static/bar.hpp +++ /dev/null @@ -1,3 +0,0 @@ -#pragma once - -void bar(); diff --git a/cmake/examples/static/foo.cpp b/cmake/examples/static/foo.cpp deleted file mode 100644 index c6355a2..0000000 --- a/cmake/examples/static/foo.cpp +++ /dev/null @@ -1,6 +0,0 @@ -#include - -int main() { - bar(); - return 0; -} diff --git a/cmake/toolchains/README.md b/cmake/toolchains/README.md deleted file mode 100644 index 9c58eb6..0000000 --- a/cmake/toolchains/README.md +++ /dev/null @@ -1,3 +0,0 @@ -Use the toolchain files by passing something like -`-D CMAKE_TOOLCHAIN_FILE=PATH/TO/cmake-common/cmake/toolchains/TOOLCHAIN.cmake` -to `cmake`. diff --git a/cmake/toolchains/gcc-x64.cmake b/cmake/toolchains/gcc-x64.cmake deleted file mode 100644 index 2f7019e..0000000 --- a/cmake/toolchains/gcc-x64.cmake +++ /dev/null @@ -1,4 +0,0 @@ -set(CMAKE_C_COMPILER gcc) -set(CMAKE_C_FLAGS -m64) -set(CMAKE_CXX_COMIPLER g++) -set(CMAKE_CXX_FLAGS -m64) diff --git a/cmake/toolchains/gcc-x86.cmake b/cmake/toolchains/gcc-x86.cmake deleted file mode 100644 index e2e84be..0000000 --- a/cmake/toolchains/gcc-x86.cmake +++ /dev/null @@ -1,4 +0,0 @@ -set(CMAKE_C_COMPILER gcc) -set(CMAKE_C_FLAGS -m32) -set(CMAKE_CXX_COMIPLER g++) -set(CMAKE_CXX_FLAGS -m32) diff --git a/cmake/toolchains/mingw-w64-x64.cmake b/cmake/toolchains/mingw-w64-x64.cmake deleted file mode 100644 index c689d39..0000000 --- a/cmake/toolchains/mingw-w64-x64.cmake +++ /dev/null @@ -1,4 +0,0 @@ -set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc) -set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++) -set(CMAKE_RC_COMILER x86_64-w64-mingw32-windres) -set(CMAKE_SYSTEM_NAME Windows) diff --git a/cmake/toolchains/mingw-w64-x86.cmake b/cmake/toolchains/mingw-w64-x86.cmake deleted file mode 100644 index e5dedd4..0000000 --- a/cmake/toolchains/mingw-w64-x86.cmake +++ /dev/null @@ -1,4 +0,0 @@ -set(CMAKE_C_COMPILER i686-w64-mingw32-gcc) -set(CMAKE_CXX_COMPILER i686-w64-mingw32-g++) -set(CMAKE_RC_COMILER i686-w64-mingw32-windres) -set(CMAKE_SYSTEM_NAME Windows) diff --git a/common.cmake b/common.cmake new file mode 100644 index 0000000..0d813fe --- /dev/null +++ b/common.cmake @@ -0,0 +1,225 @@ +# Copyright (c) 2017 Egor Tensin +# This file is part of the "cmake-common" project. +# For details, see https://github.com/egor-tensin/cmake-common. +# Distributed under the MIT License. + +# It's a CMake code snippet I use in all of my CMake projects. +# It makes targets link the runtime statically by default, strips debug symbols +# in release builds and sets a couple of useful compilation options. + +# Add this to the top-level CMakeLists.txt (unless a higher version has already +# been specified): +# +# cmake_minimum_required(VERSION 3.1) + +# Without this policy set, this line: +# +# if(toolset STREQUAL "MSVC") +# +# evaluates to false even when using Visual Studio (since MSVC is a predefined +# variable; it's completely bonkers). +if(NOT POLICY CMP0054) + message(FATAL_ERROR "common.cmake uses CMP0054, which is unsupported by this CMake version") +endif() +cmake_policy(SET CMP0054 NEW) + +# Toolset identification: + +if(CMAKE_C_COMPILER_ID) + set(toolset "${CMAKE_C_COMPILER_ID}") +elseif(CMAKE_CXX_COMPILER_ID) + set(toolset "${CMAKE_CXX_COMPILER_ID}") +else() + set(toolset "unknown") +endif() + +if(toolset STREQUAL "GNU") + set(is_gcc ON) +elseif(toolset STREQUAL "MSVC") + set(is_msvc ON) +else() + message(WARNING "Unrecognized toolset: ${toolset}") +endif() + +# User-defined switches: + +set(default_value ON) +get_directory_property(parent_dir PARENT_DIRECTORY) +if(parent_dir) + set(default_value OFF) +endif() + +if(NOT DEFINED CC_CXX_STANDARD) + set(CC_CXX_STANDARD "14" CACHE STRING "C++ standard version") +endif() +if(NOT DEFINED CC_BEST_PRACTICES) + option(CC_BEST_PRACTICES "Set common compiler options" "${default_value}") +endif() +if(NOT DEFINED CC_WINDOWS_DEF) + option(CC_WINDOWS_DEF "Define useful Windows macros" "${default_value}") +endif() +if(NOT DEFINED CC_STATIC_RUNTIME) + set(static_runtime_default_value "${default_value}") + if(DEFINED Boost_USE_STATIC_LIBS AND NOT Boost_USE_STATIC_LIBS) + # Linking to dynamic Boost libs and the static runtime is a no-no: + set(static_runtime_default_value OFF) + elseif(CMAKE_SYSTEM_NAME STREQUAL "Windows" OR MINGW) + else() + # At this point, Linux-like environment & the GNU C Library are assumed. + set(static_runtime_default_value OFF) + endif() + option(CC_STATIC_RUNTIME "Link the runtime statically" "${static_runtime_default_value}") +endif() +if(NOT DEFINED CC_STRIP_SYMBOLS) + option(CC_STRIP_SYMBOLS "Strip debug symbols" "${default_value}") +endif() + +option(Boost_USE_STATIC_LIBS "Use the static Boost libraries" "${default_value}") +option(Boost_USE_STATIC_RUNTIME "Use Boost libraries linked to the runtime statically" "${CC_STATIC_RUNTIME}") + +message(STATUS "Toolset: ${toolset}") +message(STATUS "C++ standard: ${CC_CXX_STANDARD}") +message(STATUS "Set common compiler options: ${CC_BEST_PRACTICES}") +message(STATUS "Define useful Windows macros: ${CC_WINDOWS_DEF}") +message(STATUS "Use the static Boost libraries: ${Boost_USE_STATIC_LIBS}") +message(STATUS "Link the runtime statically: ${CC_STATIC_RUNTIME}") +message(STATUS "Strip symbols: ${CC_STRIP_SYMBOLS}") + +# C++ standard version: + +set(CMAKE_CXX_STANDARD "${CC_CXX_STANDARD}") +set(CMAKE_CXX_STANDARD_REQUIRED ON) +set(CMAKE_CXX_EXTENSIONS OFF) + +# Common compiler options routines: + +function(_cc_best_practices_msvc target) + set(compile_options /MP /W4) + get_target_property(target_type "${target}" TYPE) + get_target_property(aliased "${target}" ALIASED_TARGET) + if(NOT target_type STREQUAL "INTERFACE_LIBRARY" AND NOT aliased) + target_compile_options("${target}" PRIVATE ${compile_options}) + endif() +endfunction() + +function(_cc_best_practices_gcc target) + set(compile_options -Wall -Wextra) + get_target_property(target_type "${target}" TYPE) + get_target_property(aliased "${target}" ALIASED_TARGET) + if(NOT target_type STREQUAL "INTERFACE_LIBRARY" AND NOT aliased) + target_compile_options("${target}" PRIVATE ${compile_options}) + endif() +endfunction() + +function(_cc_best_practices target) + if(is_msvc) + _cc_best_practices_msvc("${target}") + elseif(is_gcc) + _cc_best_practices_gcc("${target}") + endif() +endfunction() + +# Useful Windows macros routines: + +function(_cc_common_windows_definitions target) + set(compile_definitions WIN32_LEAN_AND_MEAN NOMINMAX) + get_target_property(target_type "${target}" TYPE) + if(target_type STREQUAL "INTERFACE_LIBRARY") + target_compile_definitions("${target}" INTERFACE ${compile_definitions}) + else() + get_target_property(aliased "${target}" ALIASED_TARGET) + if(NOT aliased) + target_compile_definitions("${target}" PRIVATE ${compile_definitions}) + endif() + endif() +endfunction() + +# Static runtime routines: + +function(_cc_static_runtime_msvc target) + get_target_property(target_type "${target}" TYPE) + get_target_property(aliased "${target}" ALIASED_TARGET) + if(NOT target_type STREQUAL "INTERFACE_LIBRARY" AND NOT aliased) + target_compile_options("${target}" PRIVATE + $<$:/MTd> + $<$>:/MT>) + endif() +endfunction() + +function(_cc_static_runtime_gcc target) + get_target_property(target_type "${target}" TYPE) + get_target_property(aliased "${target}" ALIASED_TARGET) + if(NOT target_type STREQUAL "INTERFACE_LIBRARY" AND NOT aliased) + # This causes issues with mixing keyword- and plain- versions of + # target_link_libraries: + #target_link_libraries("${target}" PRIVATE -static) + + set_property(TARGET "${target}" APPEND_STRING PROPERTY LINK_FLAGS " -static") + + # Or (haven't tested this), if CMake 3.13+ is used: + #target_link_options("${target}" PRIVATE -static) + endif() +endfunction() + +function(_cc_static_runtime target) + if(is_msvc) + _cc_static_runtime_msvc("${target}") + elseif(is_gcc) + _cc_static_runtime_gcc("${target}") + endif() +endfunction() + +# Symbol stripping routines: + +function(_cc_strip_symbols_gcc target) + get_target_property(target_type "${target}" TYPE) + get_target_property(aliased "${target}" ALIASED_TARGET) + if(NOT target_type STREQUAL "INTERFACE_LIBRARY" AND NOT aliased) + set(release_build $,$>) + if(release_build) + # This causes issues with mixing keyword- and plain- versions of + # target_link_libraries: + #target_link_libraries("${target}" PRIVATE -s) + + set_property(TARGET "${target}" APPEND_STRING PROPERTY LINK_FLAGS " -s") + endif() + endif() +endfunction() + +function(_cc_strip_symbols target) + if(is_gcc) + _cc_strip_symbols_gcc("${target}") + endif() +endfunction() + +# Main macros: + +function(_cc_apply_settings target) + if(TARGET "${target}") + get_target_property(target_imported "${target}" IMPORTED) + if(NOT target_imported) + if(CC_BEST_PRACTICES) + _cc_best_practices("${target}") + endif() + if(CC_WINDOWS_DEF) + _cc_common_windows_definitions("${target}") + endif() + if(CC_STRIP_SYMBOLS) + _cc_strip_symbols("${target}") + endif() + if(CC_STATIC_RUNTIME) + _cc_static_runtime("${target}") + endif() + endif() + endif() +endfunction() + +macro(add_executable target) + _add_executable(${ARGV}) + _cc_apply_settings("${target}") +endmacro() + +macro(add_library target) + _add_library(${ARGV}) + _cc_apply_settings("${target}") +endmacro() diff --git a/examples/boost/CMakeLists.txt b/examples/boost/CMakeLists.txt new file mode 100644 index 0000000..8c076c9 --- /dev/null +++ b/examples/boost/CMakeLists.txt @@ -0,0 +1,14 @@ +cmake_minimum_required(VERSION 3.5) # for Boost::* imported targets + +project(example_boost) + +include(../../common.cmake) + +find_package(Boost REQUIRED COMPONENTS filesystem) +add_executable(foo foo.cpp) +target_link_libraries(foo PRIVATE Boost::disable_autolinking Boost::filesystem) + +install(TARGETS foo RUNTIME DESTINATION bin) +if(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC") + install(FILES "$" DESTINATION bin OPTIONAL) +endif() diff --git a/examples/boost/foo.cpp b/examples/boost/foo.cpp new file mode 100644 index 0000000..3bd0326 --- /dev/null +++ b/examples/boost/foo.cpp @@ -0,0 +1,11 @@ +#include + +#include + +int main(int argc, char* argv[]) { + std::cout << "Hello from " + << boost::filesystem::absolute(boost::filesystem::path{argv[0]}) + .string() + << "!\n"; + return 0; +} diff --git a/examples/dynamic/CMakeLists.txt b/examples/dynamic/CMakeLists.txt new file mode 100644 index 0000000..4602adb --- /dev/null +++ b/examples/dynamic/CMakeLists.txt @@ -0,0 +1,16 @@ +cmake_minimum_required(VERSION 3.1) + +project(example_dynamic) + +include(../../common.cmake) + +add_library(baz SHARED baz.cpp) +target_include_directories(baz PUBLIC .) + +add_executable(foo foo.cpp) +target_link_libraries(foo PRIVATE baz) + +install(TARGETS foo baz RUNTIME DESTINATION bin LIBRARY DESTINATION lib) +if(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC") + install(FILES "$" "$" DESTINATION bin OPTIONAL) +endif() diff --git a/examples/dynamic/baz.cpp b/examples/dynamic/baz.cpp new file mode 100644 index 0000000..d108ae3 --- /dev/null +++ b/examples/dynamic/baz.cpp @@ -0,0 +1,7 @@ +#include "baz.hpp" + +#include + +void baz() { + std::cout << "baz\n"; +} diff --git a/examples/dynamic/baz.hpp b/examples/dynamic/baz.hpp new file mode 100644 index 0000000..2fc9b2a --- /dev/null +++ b/examples/dynamic/baz.hpp @@ -0,0 +1,9 @@ +#pragma once + +#ifdef _MSC_VER +#define DLLEXPORT __declspec(dllexport) +#else +#define DLLEXPORT +#endif + +DLLEXPORT void baz(); diff --git a/examples/dynamic/foo.cpp b/examples/dynamic/foo.cpp new file mode 100644 index 0000000..b7d9986 --- /dev/null +++ b/examples/dynamic/foo.cpp @@ -0,0 +1,6 @@ +#include + +int main() { + baz(); + return 0; +} diff --git a/examples/simple/CMakeLists.txt b/examples/simple/CMakeLists.txt new file mode 100644 index 0000000..4f8859e --- /dev/null +++ b/examples/simple/CMakeLists.txt @@ -0,0 +1,12 @@ +cmake_minimum_required(VERSION 3.1) + +project(example_simple) + +include(../../common.cmake) + +add_executable(foo foo.cpp) + +install(TARGETS foo RUNTIME DESTINATION bin) +if(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC") + install(FILES "$" DESTINATION bin OPTIONAL) +endif() diff --git a/examples/simple/foo.cpp b/examples/simple/foo.cpp new file mode 100644 index 0000000..b9d3132 --- /dev/null +++ b/examples/simple/foo.cpp @@ -0,0 +1,6 @@ +#include + +int main() { + std::cout << "foo\n"; + return 0; +} diff --git a/examples/static/CMakeLists.txt b/examples/static/CMakeLists.txt new file mode 100644 index 0000000..8a6acb8 --- /dev/null +++ b/examples/static/CMakeLists.txt @@ -0,0 +1,16 @@ +cmake_minimum_required(VERSION 3.1) + +project(example_static) + +include(../../common.cmake) + +add_library(bar bar.cpp) +target_include_directories(bar PUBLIC .) + +add_executable(foo foo.cpp) +target_link_libraries(foo PRIVATE bar) + +install(TARGETS foo bar RUNTIME DESTINATION bin ARCHIVE DESTINATION lib) +if(CMAKE_CXX_COMPILER_ID STREQUAL "MSVC") + install(FILES "$" DESTINATION bin OPTIONAL) +endif() diff --git a/examples/static/bar.cpp b/examples/static/bar.cpp new file mode 100644 index 0000000..37aa9b5 --- /dev/null +++ b/examples/static/bar.cpp @@ -0,0 +1,7 @@ +#include "bar.hpp" + +#include + +void bar() { + std::cout << "bar\n"; +} diff --git a/examples/static/bar.hpp b/examples/static/bar.hpp new file mode 100644 index 0000000..a3ea4c1 --- /dev/null +++ b/examples/static/bar.hpp @@ -0,0 +1,3 @@ +#pragma once + +void bar(); diff --git a/examples/static/foo.cpp b/examples/static/foo.cpp new file mode 100644 index 0000000..c6355a2 --- /dev/null +++ b/examples/static/foo.cpp @@ -0,0 +1,6 @@ +#include + +int main() { + bar(); + return 0; +} diff --git a/project/__init__.py b/project/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/project/boost/README.md b/project/boost/README.md new file mode 100644 index 0000000..c1f903e --- /dev/null +++ b/project/boost/README.md @@ -0,0 +1,13 @@ +Boost +===== + +Download & build the Boost libraries in a cross-platform way. +Consult the output of `build.py --help` for details. + +A simple usage example to download and build Boost 1.71.0: + + $ python3 build.py download 1.71.0 + ... + + $ python3 build.py build -- boost_1_71_0/ --with-filesystem --with-program_options + ... diff --git a/project/boost/__init__.py b/project/boost/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/project/boost/build.py b/project/boost/build.py new file mode 100644 index 0000000..8da8c9e --- /dev/null +++ b/project/boost/build.py @@ -0,0 +1,566 @@ +#!/usr/bin/env python3 + +# Copyright (c) 2019 Egor Tensin +# This file is part of the "cmake-common" project. +# For details, see https://github.com/egor-tensin/cmake-common. +# Distributed under the MIT License. + +'''Download & build Boost. + +This script downloads and builds the Boost libraries. It's main purpose is to: +1) provide a cross-platform way to download & unpack the Boost distribution +archive, +2) set the correct --stagedir parameter value to avoid name clashes. + +Please pick a command below. You can execute `%(prog)s COMMAND --help` to view +its usage message. + +A simple usage example: + + $ %(prog)s download 1.71.0 + ... + + $ %(prog)s build -- boost_1_71_0/ --with-filesystem --with-program_options + ... +''' + +import abc +import argparse +from collections import namedtuple +from contextlib import contextmanager +from enum import Enum +from functools import total_ordering +import logging +import os.path +import platform +import re +import shutil +import subprocess +import sys +import tempfile +import urllib.request + + +@contextmanager +def _chdir(path): + cwd = os.getcwd() + os.chdir(path) + try: + yield + finally: + os.chdir(cwd) + + +def _setup_logging(): + logging.basicConfig( + format='%(asctime)s | %(levelname)s | %(message)s', + level=logging.INFO) + + +def _on_windows(): + return platform.system() == 'Windows' + + +def _on_linux(): + return not _on_windows() + + +def _run_executable(cmd_line): + logging.info('Running executable: %s', cmd_line) + return subprocess.run(cmd_line, check=True) + + +class Platform(Enum): + X86 = 'x86' + X64 = 'x64' + WIN32 = 'Win32' + + def __str__(self): + return self.value + + @staticmethod + def all(): + return (Platform.X86, Platform.X64) + + def get_address_model(self): + if self is Platform.X86: + return 32 + if self is Platform.X64: + return 64 + if self is Platform.WIN32: + return 32 + raise NotImplementedError(f'unsupported platform: {self}') + + +def _parse_platform(s): + try: + return Platform(s) + except ValueError: + raise argparse.ArgumentTypeError(f'invalid platform: {s}') + + +class Configuration(Enum): + # AFAIK, Boost only supports debug/release, MinSizeRel and RelWithDebInfo + # are for compatibility with CMake, they map to "release". + # The libraries will still reside in stage/PLATFORM/CONFIGURATION/lib, even + # if CONFIGURATION is MinSizeRel/RelWithDebInfo. + DEBUG = 'Debug' + MINSIZEREL = 'MinSizeRel' + RELWITHDEBINFO = 'RelWithDebInfo' + RELEASE = 'Release' + + def normalize(self): + '''Roughly maps CMake's CMAKE_BUILD_TYPE to Boost's variant.''' + if self is Configuration.MINSIZEREL: + return Configuration.RELEASE + if self is Configuration.RELWITHDEBINFO: + return Configuration.RELEASE + return self + + @staticmethod + def all(): + return (Configuration.DEBUG, Configuration.RELEASE) + + def __str__(self): + return self.value + + +def _parse_configuration(s): + try: + return Configuration(s) + except ValueError: + raise argparse.ArgumentTypeError(f'invalid configuration: {s}') + + +class Linkage(Enum): + STATIC = 'static' + SHARED = 'shared' + + @staticmethod + def all(): + return tuple(Linkage) + + def __str__(self): + return self.value + + +def _parse_linkage(s): + try: + return Linkage(s) + except ValueError: + raise argparse.ArgumentTypeError(f'invalid linkage: {s}') + + +_Version = namedtuple('_Version', ['major', 'minor', 'patch']) + + +@total_ordering +class BoostVersion: + def __init__(self, major, minor, patch): + self._impl = _Version(major, minor, patch) + + @property + def major(self): + return self._impl.major + + @property + def minor(self): + return self._impl.minor + + @property + def patch(self): + return self._impl.patch + + def __lt__(self, other): + return self._impl < other._impl + + def __eq__(self, other): + return self._impl == other._impl + + @staticmethod + def from_string(s): + result = re.match(r'^(\d+)\.(\d+)\.(\d+)$', s) + if result is None: + raise ValueError(f'invalid Boost version: {s}') + major = int(result.group(1)) + minor = int(result.group(2)) + patch = int(result.group(3)) + return BoostVersion(major, minor, patch) + + def __str__(self): + return f'{self.major}.{self.minor}.{self.patch}' + + @property + def archive_ext(self): + return '.tar.gz' + + def dir_path(self, parent_dir): + return os.path.join(parent_dir, self.dir_name) + + @property + def dir_name(self): + return f'boost_{self.major}_{self.minor}_{self.patch}' + + @property + def archive_name(self): + return f'{self.dir_name}{self.archive_ext}' + + def _get_bintray_url(self): + return f'https://dl.bintray.com/boostorg/release/{self}/source/{self.archive_name}' + + def _get_sourceforge_url(self): + return f'https://sourceforge.net/projects/boost/files/boost/{self}/{self.archive_name}/download' + + def get_download_urls(self): + if self._impl < _Version(1, 63, 0): + # For versions older than 1.63.0, SourceForge is the only option: + return [self._get_sourceforge_url()] + # Otherwise, Bintray is preferred (the official website links to it). + return [self._get_bintray_url(), self._get_sourceforge_url()] + + +class BoostArchive: + def __init__(self, version, path): + self.version = version + self.path = path + + @property + def dir_name(self): + return self.version.dir_name + + def unpack(self, dest_dir): + path = os.path.join(dest_dir, self.dir_name) + if os.path.exists(path): + raise RuntimeError(f'Boost directory already exists: {path}') + logging.info('Unpacking Boost to: %s', path) + shutil.unpack_archive(self.path, dest_dir) + return BoostDir(path) + + +class ArchiveStorage(abc.ABC): + @contextmanager + def download(self, version): + path = self.get_archive(version) + if path is not None: + logging.info('Using existing Boost archive: %s', path) + yield BoostArchive(version, path) + return + + urls = version.get_download_urls() + + for url in urls: + logging.info('Trying URL: %s', url) + try: + with urllib.request.urlopen(url, timeout=20) as request: + with self.write_archive(version, request.read()) as path: + yield BoostArchive(version, path) + return + except urllib.request.URLError as e: + logging.error("Couldn't download from this mirror, an error occured:") + logging.exception(e) + + raise RuntimeError("Couldn't download Boost from any of the mirrors") + + @abc.abstractmethod + def get_archive(self, version): + pass + + @contextmanager + @abc.abstractmethod + def write_archive(self, version, contents): + pass + + +class CacheStorage(ArchiveStorage): + def __init__(self, cache_dir): + self._dir = cache_dir + + def _archive_path(self, version): + return os.path.join(self._dir, version.archive_name) + + def get_archive(self, version): + path = self._archive_path(version) + if os.path.exists(path): + return path + return None + + @contextmanager + def write_archive(self, version, contents): + path = self._archive_path(version) + logging.info('Writing Boost archive: %s', path) + if os.path.exists(path): + raise RuntimeError(f'cannot download Boost, file already exists: {path}') + with open(path, mode='w+b') as dest: + dest.write(contents) + yield path + + +class TempStorage(ArchiveStorage): + def __init__(self, temp_dir): + self._dir = temp_dir + + def get_archive(self, version): + return None + + @contextmanager + def write_archive(self, version, contents): + with tempfile.NamedTemporaryFile(prefix=f'boost_{version}_', suffix=version.archive_ext, dir=self._dir, delete=False) as dest: + path = dest.name + logging.info('Writing Boost archive: %s', path) + dest.write(contents) + try: + yield path + finally: + logging.info('Removing temporary Boost archive: %s', path) + os.remove(path) + + +class BoostDir: + def __init__(self, path): + if not os.path.isdir(path): + raise RuntimeError(f"Boost directory doesn't exist: {path}") + self.path = path + + def _go(self): + return _chdir(self.path) + + def build(self, params): + with self._go(): + self._bootstrap_if_required() + self._b2(params) + + def _bootstrap_if_required(self): + if os.path.isfile(self._b2_path()): + logging.info('Not going to bootstrap, b2 is already there') + return + self.bootstrap() + + def bootstrap(self): + with self._go(): + _run_executable(self._bootstrap_path()) + + def _b2(self, params): + for b2_params in params.enum_b2_args(): + _run_executable([self._b2_path()] + b2_params) + + @staticmethod + def _bootstrap_path(): + return os.path.join('.', BoostDir._bootstrap_name()) + + @staticmethod + def _bootstrap_name(): + ext = '.sh' + if _on_windows(): + ext = '.bat' + return f'bootstrap{ext}' + + @staticmethod + def _b2_path(): + return os.path.join('.', BoostDir._b2_name()) + + @staticmethod + def _b2_name(): + ext = '' + if _on_windows(): + ext = '.exe' + return f'b2{ext}' + + +class BuildParameters: + def __init__(self, args): + self.platforms = args.platforms or Platform.all() + self.configurations = args.configurations or Configuration.all() + self.link = args.link or Linkage.all() + self.runtime_link = args.runtime_link + + self.stage_dir = 'stage' + + self.build_dir = args.build_dir + self.boost_dir = args.boost_dir + + self.b2_args = args.b2_args + + def enum_b2_args(self): + with self._create_build_dir() as build_dir: + for platform in self.platforms: + for configuration in self.configurations: + for link, runtime_link in self._linkage_options(): + yield self._build_params(build_dir, platform, configuration, link, runtime_link) + + def _linkage_options(self): + for link in self.link: + runtime_link = self.runtime_link + if runtime_link is Linkage.STATIC: + if link is Linkage.SHARED: + logging.warning("Cannot link the runtime statically to a dynamic library, going to link dynamically") + runtime_link = Linkage.SHARED + elif _on_linux(): + logging.warning("Cannot link to the GNU C Library (which is assumed) statically, going to link dynamically") + runtime_link = Linkage.SHARED + yield link, runtime_link + + @contextmanager + def _create_build_dir(self): + if self.build_dir is not None: + logging.info('Build directory: %s', self.build_dir) + yield self.build_dir + return + + with tempfile.TemporaryDirectory(dir=os.path.dirname(self.boost_dir)) as build_dir: + logging.info('Build directory: %s', build_dir) + try: + yield build_dir + finally: + logging.info('Removing build directory: %s', build_dir) + return + + def _build_params(self, build_dir, platform, configuration, link, runtime_link): + params = [] + params.append(self._build_dir(build_dir)) + params.append(self._stagedir(platform, configuration)) + params.append(self._link(link)) + params.append(self._runtime_link(runtime_link)) + params.append(self._address_model(platform)) + params.append(self._variant(configuration)) + params += self.b2_args + return params + + @staticmethod + def _build_dir(build_dir): + return f'--build-dir={build_dir}' + + def _stagedir(self, platform, configuration): + # Having different --stagedir values for every configuration/platform + # combination is unnecessary on Windows. + # Even for older Boost versions (when the binaries weren't tagged with + # their target platform) only a single --stagedir for every platform + # would suffice. + # For newer versions, just a single --stagedir would do, as the + # binaries are tagged with the target platform, as well as their + # configuration (a.k.a. "variant" in Boost's terminology). + # Still, uniformity helps. + platform = str(platform) + configuration = str(configuration) + return f'--stagedir={os.path.join(self.stage_dir, platform, configuration)}' + + @staticmethod + def _link(link): + return f'link={link}' + + @staticmethod + def _runtime_link(runtime_link): + return f'runtime-link={runtime_link}' + + @staticmethod + def _address_model(platform): + return f'address-model={platform.get_address_model()}' + + @staticmethod + def _variant(configuration): + return f'variant={str(configuration.normalize()).lower()}' + + +def _parse_dir(s): + return os.path.abspath(os.path.normpath(s)) + + +def _parse_args(argv=None): + if argv is None: + argv = sys.argv[1:] + logging.info('Command line arguments: %s', argv) + + parser = argparse.ArgumentParser( + description=__doc__, + formatter_class=argparse.RawDescriptionHelpFormatter) + + subparsers = parser.add_subparsers(dest='command') + + download = subparsers.add_parser('download', help='download & bootstrap Boost') + + download.add_argument('--cache', metavar='DIR', dest='cache_dir', + type=_parse_dir, + help='download directory (temporary file unless specified)') + download.add_argument('--unpack', metavar='DIR', dest='unpack_dir', + type=_parse_dir, default='.', + help='directory to unpack the archive to') + download.add_argument('boost_version', metavar='VERSION', + type=BoostVersion.from_string, + help='Boost version (in the MAJOR.MINOR.PATCH format)') + + build = subparsers.add_parser('build', help='build the libraries') + + # These are used to put the built libraries into proper stage/ + # subdirectories (to avoid name clashes). + build.add_argument('--platform', metavar='PLATFORM', + nargs='*', dest='platforms', default=[], + type=_parse_platform, + help=f'target platform ({"/".join(map(str, Platform))})') + build.add_argument('--configuration', metavar='CONFIGURATION', + nargs='*', dest='configurations', default=[], + type=_parse_configuration, + help=f'target configuration ({"/".join(map(str, Configuration))})') + # This is needed because the default behaviour on Linux and Windows is + # different: static & dynamic libs are built on Linux, but only static libs + # are built on Windows by default. + build.add_argument('--link', metavar='LINKAGE', + nargs='*', default=[], + type=_parse_linkage, + help=f'how the libraries are linked ({"/".join(map(str, Linkage))})') + # This is used to omit runtime-link=static I'd have to otherwise use a lot, + # plus the script validates the link= and runtime-link= combinations. + build.add_argument('--runtime-link', metavar='LINKAGE', + type=_parse_linkage, default=Linkage.STATIC, + help=f'how the libraries link to the runtime ({"/".join(map(str, Linkage))})') + + build.add_argument('--build', metavar='DIR', dest='build_dir', + type=_parse_dir, + help='Boost build directory (temporary directory unless specified)') + build.add_argument('boost_dir', metavar='DIR', + type=_parse_dir, + help='root Boost directory') + + build.add_argument('b2_args', nargs='*', metavar='B2_ARG', default=[], + help='additional b2 arguments, to be passed verbatim') + + args = parser.parse_args(argv) + if args.command is None: + parser.error("please specify a command") + return args + + +def build(args): + build_params = BuildParameters(args) + boost_dir = BoostDir(args.boost_dir) + boost_dir.build(build_params) + + +def download(args): + storage = TempStorage(args.unpack_dir) + if args.cache_dir is not None: + storage = CacheStorage(args.cache_dir) + with storage.download(args.boost_version) as archive: + boost_dir = archive.unpack(args.unpack_dir) + boost_dir.bootstrap() + + +def main(argv=None): + args = _parse_args(argv) + if args.command == 'download': + download(args) + elif args.command == 'build': + build(args) + else: + raise NotImplementedError(f'unsupported command: {args.command}') + + +def _main(argv=None): + _setup_logging() + try: + main(argv) + except Exception as e: + logging.exception(e) + raise + + +if __name__ == '__main__': + _main() diff --git a/project/ci/__init__.py b/project/ci/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/project/ci/appveyor/__init__.py b/project/ci/appveyor/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/project/ci/appveyor/boost.py b/project/ci/appveyor/boost.py new file mode 100644 index 0000000..4218dd6 --- /dev/null +++ b/project/ci/appveyor/boost.py @@ -0,0 +1,121 @@ +#!/usr/bin/env python3 + +# Copyright (c) 2020 Egor Tensin +# This file is part of the "cmake-common" project. +# For details, see https://github.com/egor-tensin/cmake-common. +# Distributed under the MIT License. + +'''Download & build Boost on AppVeyor. + +This is similar to build.py, but auto-fills some parameters for build.py from +the AppVeyor-defined environment variables. This script is rarely usefull, +since AppVeyor images come with lots of pre-built Boost distributions, but +still. + +Boost is built in C:\projects\boost. +''' + +import argparse +import logging +import os +import os.path +import sys + +from project.boost.build import BoostVersion, main as build_main + + +def _env(name): + if name not in os.environ: + raise RuntimeError(f'undefined environment variable: {name}') + return os.environ[name] + + +def _check_appveyor(): + if 'APPVEYOR' not in os.environ: + raise RuntimeError('not running on AppVeyor') + + +def _get_build_dir(): + return 'C:\\projects' + + +def _get_boost_dir(): + return os.path.join(_get_build_dir(), 'boost') + + +def _get_boost_version(): + return _env('appveyor_boost_version') + + +def _get_configuration(): + return _env('CONFIGURATION') + + +def _get_platform(): + return _env('PLATFORM') + + +def _setup_logging(): + logging.basicConfig( + format='%(asctime)s | %(levelname)s | %(message)s', + level=logging.INFO) + + +def _parse_args(argv=None): + if argv is None: + argv = sys.argv[1:] + logging.info('Command line arguments: %s', argv) + + parser = argparse.ArgumentParser( + description=__doc__, + formatter_class=argparse.RawDescriptionHelpFormatter) + parser.add_argument('--link', metavar='LINKAGE', nargs='*', + help='how the libraries are linked (i.e. static/shared)') + parser.add_argument('--runtime-link', metavar='LINKAGE', + help='how the libraries link to the runtime') + parser.add_argument('b2_args', nargs='*', metavar='B2_ARG', default=[], + help='additional b2 arguments, to be passed verbatim') + return parser.parse_args(argv) + + +def build_appveyor(argv=None): + args = _parse_args(argv) + _check_appveyor() + + version = BoostVersion.from_string(_get_boost_version()) + appveyor_argv = [ + 'download', + '--unpack', _get_build_dir(), + '--', str(version) + ] + build_main(appveyor_argv) + + unpacked_boost_dir = version.dir_path(_get_build_dir()) + boost_dir = _get_boost_dir() + os.rename(unpacked_boost_dir, boost_dir) + + appveyor_argv = [ + 'build', + '--configuration', _get_configuration(), + '--platform', _get_platform(), + ] + if args.link is not None: + appveyor_argv.append('--link') + appveyor_argv += args.link + if args.runtime_link is not None: + appveyor_argv += ['--runtime-link', args.runtime_link] + appveyor_argv += ['--', boost_dir] + build_main(appveyor_argv + args.b2_args) + + +def main(argv=None): + _setup_logging() + try: + build_appveyor(argv) + except Exception as e: + logging.exception(e) + raise + + +if __name__ == '__main__': + main() diff --git a/project/ci/appveyor/cmake.py b/project/ci/appveyor/cmake.py new file mode 100644 index 0000000..e1ebce0 --- /dev/null +++ b/project/ci/appveyor/cmake.py @@ -0,0 +1,164 @@ +#!/usr/bin/env python3 + +# Copyright (c) 2019 Egor Tensin +# This file is part of the "cmake-common" project. +# For details, see https://github.com/egor-tensin/cmake-common. +# Distributed under the MIT License. + +'''Build a CMake project on AppVeyor. + +This is similar to build.py, but auto-fills some parameters for build.py from +the AppVeyor-defined environment variables. + +The project is built in C:\Projects\build. +''' + +import argparse +from enum import Enum +import logging +import os +import sys + +from project.cmake.build import build + + +class Image(Enum): + VS_2013 = 'Visual Studio 2013' + VS_2015 = 'Visual Studio 2015' + VS_2017 = 'Visual Studio 2017' + VS_2019 = 'Visual Studio 2019' + + def __str__(self): + return self.value + + +def _parse_image(s): + try: + return Image(s) + except ValueError as e: + raise ValueError(f'unsupported AppVeyor image: {s}') from e + + +class Generator(Enum): + VS_2013 = 'Visual Studio 12 2013' + VS_2015 = 'Visual Studio 14 2015' + VS_2017 = 'Visual Studio 15 2017' + VS_2019 = 'Visual Studio 16 2019' + + def __str__(self): + return self.value + + @staticmethod + def from_image(image): + if image is Image.VS_2013: + return Generator.VS_2013 + if image is Image.VS_2015: + return Generator.VS_2015 + if image is Image.VS_2017: + return Generator.VS_2017 + if image is Image.VS_2019: + return Generator.VS_2019 + raise RuntimeError(f"don't know which generator to use for image: {image}") + + +class Platform(Enum): + x86 = 'Win32' + X64 = 'x64' + + def __str__(self): + return self.value + + +def _parse_platform(s): + try: + return Platform(s) + except ValueError as e: + raise ValueError(f'unsupported AppVeyor platform: {s}') from e + + +def _env(name): + if name not in os.environ: + raise RuntimeError(f'undefined environment variable: {name}') + return os.environ[name] + + +def _check_appveyor(): + if 'APPVEYOR' not in os.environ: + raise RuntimeError('not running on AppVeyor') + + +def _get_src_dir(): + return _env('APPVEYOR_BUILD_FOLDER') + + +def _get_build_dir(): + return R'C:\Projects\build' + + +def _get_generator(): + image = _parse_image(_env('APPVEYOR_BUILD_WORKER_IMAGE')) + return str(Generator.from_image(image)) + + +def _get_platform(): + return str(_parse_platform(_env('PLATFORM'))) + + +def _get_configuration(): + return _env('CONFIGURATION') + + +def _setup_logging(): + logging.basicConfig( + format='%(asctime)s | %(levelname)s | %(message)s', + level=logging.INFO) + + +def _parse_args(argv=None): + if argv is None: + argv = sys.argv[1:] + logging.info('Command line arguments: %s', argv) + + parser = argparse.ArgumentParser( + description=__doc__, + formatter_class=argparse.RawDescriptionHelpFormatter) + + parser.add_argument('--install', metavar='DIR', dest='install_dir', + help='install directory') + parser.add_argument('cmake_args', nargs='*', metavar='CMAKE_ARG', default=[], + help='additional CMake arguments, to be passed verbatim') + return parser.parse_args(argv) + + +def build_appveyor(argv=None): + args = _parse_args(argv) + _check_appveyor() + + appveyor_argv = [ + '--build', _get_build_dir(), + '--configuration', _get_configuration(), + ] + if args.install_dir is not None: + appveyor_argv += [ + '--install', args.install_dir, + ] + appveyor_argv += [ + '--', + _get_src_dir(), + '-G', _get_generator(), + '-A', _get_platform(), + ] + build(appveyor_argv + args.cmake_args) + + +def main(argv=None): + _setup_logging() + try: + build_appveyor(argv) + except Exception as e: + logging.exception(e) + raise + + +if __name__ == '__main__': + main() diff --git a/project/ci/travis/__init__.py b/project/ci/travis/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/project/ci/travis/boost.py b/project/ci/travis/boost.py new file mode 100644 index 0000000..46ae96b --- /dev/null +++ b/project/ci/travis/boost.py @@ -0,0 +1,119 @@ +#!/usr/bin/env python3 + +# Copyright (c) 2019 Egor Tensin +# This file is part of the "cmake-common" project. +# For details, see https://github.com/egor-tensin/cmake-common. +# Distributed under the MIT License. + +'''Download & build Boost on Travis. + +This is similar to build.py, but auto-fills some parameters for build.py from +the Travis-defined environment variables. + +Boost is built in $HOME/boost. +''' + +import argparse +import logging +import os +import os.path +import sys + +from project.boost.build import BoostVersion, main as build_main + + +def _env(name): + if name not in os.environ: + raise RuntimeError(f'undefined environment variable: {name}') + return os.environ[name] + + +def _check_travis(): + if 'TRAVIS' not in os.environ: + raise RuntimeError('not running on Travis') + + +def _get_build_dir(): + return _env('HOME') + + +def _get_boost_dir(): + return os.path.join(_get_build_dir(), 'boost') + + +def _get_boost_version(): + return _env('travis_boost_version') + + +def _get_configuration(): + return _env('configuration') + + +def _get_platform(): + return _env('platform') + + +def _setup_logging(): + logging.basicConfig( + format='%(asctime)s | %(levelname)s | %(message)s', + level=logging.INFO) + + +def _parse_args(argv=None): + if argv is None: + argv = sys.argv[1:] + logging.info('Command line arguments: %s', argv) + + parser = argparse.ArgumentParser( + description=__doc__, + formatter_class=argparse.RawDescriptionHelpFormatter) + parser.add_argument('--link', metavar='LINKAGE', nargs='*', + help='how the libraries are linked') + parser.add_argument('--runtime-link', metavar='LINKAGE', + help='how the libraries link to the runtime') + parser.add_argument('b2_args', nargs='*', metavar='B2_ARG', default=[], + help='additional b2 arguments, to be passed verbatim') + return parser.parse_args(argv) + + +def build_travis(argv=None): + args = _parse_args(argv) + _check_travis() + + version = BoostVersion.from_string(_get_boost_version()) + travis_argv = [ + 'download', + '--unpack', _get_build_dir(), + '--', str(version) + ] + build_main(travis_argv) + + unpacked_boost_dir = version.dir_path(_get_build_dir()) + boost_dir = _get_boost_dir() + os.rename(unpacked_boost_dir, boost_dir) + + travis_argv = [ + 'build', + '--configuration', _get_configuration(), + '--platform', _get_platform(), + ] + if args.link is not None: + travis_argv.append('--link') + travis_argv += args.link + if args.runtime_link is not None: + travis_argv += ['--runtime-link', args.runtime_link] + travis_argv += ['--', boost_dir] + build_main(travis_argv + args.b2_args) + + +def main(argv=None): + _setup_logging() + try: + build_travis(argv) + except Exception as e: + logging.exception(e) + raise + + +if __name__ == '__main__': + main() diff --git a/project/ci/travis/cmake.py b/project/ci/travis/cmake.py new file mode 100644 index 0000000..7a1f707 --- /dev/null +++ b/project/ci/travis/cmake.py @@ -0,0 +1,99 @@ +#!/usr/bin/env python3 + +# Copyright (c) 2019 Egor Tensin +# This file is part of the "cmake-common" project. +# For details, see https://github.com/egor-tensin/cmake-common. +# Distributed under the MIT License. + +'''Build a CMake project on Travis. + +This is similar to build.py, but auto-fills some parameters for build.py from +the Travis-defined environment variables. + +The project is built in $HOME/build. +''' + +import argparse +import logging +import os +import os.path +import sys + +from project.cmake.build import build + + +def _env(name): + if name not in os.environ: + raise RuntimeError(f'undefined environment variable: {name}') + return os.environ[name] + + +def _check_travis(): + if 'TRAVIS' not in os.environ: + raise RuntimeError('not running on Travis') + + +def _get_src_dir(): + return _env('TRAVIS_BUILD_DIR') + + +def _get_build_dir(): + return os.path.join(_env('HOME'), 'build') + + +def _get_configuration(): + return _env('configuration') + + +def _setup_logging(): + logging.basicConfig( + format='%(asctime)s | %(levelname)s | %(message)s', + level=logging.INFO) + + +def _parse_args(argv=None): + if argv is None: + argv = sys.argv[1:] + logging.info('Command line arguments: %s', argv) + + parser = argparse.ArgumentParser( + description=__doc__, + formatter_class=argparse.RawDescriptionHelpFormatter) + + parser.add_argument('--install', metavar='DIR', dest='install_dir', + help='install directory') + parser.add_argument('cmake_args', nargs='*', metavar='CMAKE_ARG', default=[], + help='additional CMake arguments, to be passed verbatim') + return parser.parse_args(argv) + + +def build_travis(argv=None): + args = _parse_args(argv) + _check_travis() + + travis_argv = [ + '--build', _get_build_dir(), + '--configuration', _get_configuration(), + ] + if args.install_dir is not None: + travis_argv += [ + '--install', args.install_dir, + ] + travis_argv += [ + '--', + _get_src_dir(), + ] + build(travis_argv + args.cmake_args) + + +def main(argv=None): + _setup_logging() + try: + build_travis(argv) + except Exception as e: + logging.exception(e) + raise + + +if __name__ == '__main__': + main() diff --git a/project/cmake/README.md b/project/cmake/README.md new file mode 100644 index 0000000..b63564d --- /dev/null +++ b/project/cmake/README.md @@ -0,0 +1,13 @@ +CMake +===== + +Build a CMake project. +Consult the output of `build.py --help` for details. + +A simple usage example: + + > python3 build.py --configuration Release --install path/to/somewhere -- ../examples/simple + ... + + > ./path/to/somewhere/bin/foo + foo diff --git a/project/cmake/__init__.py b/project/cmake/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/project/cmake/build.py b/project/cmake/build.py new file mode 100644 index 0000000..695489b --- /dev/null +++ b/project/cmake/build.py @@ -0,0 +1,190 @@ +#!/usr/bin/env python3 + +# Copyright (c) 2019 Egor Tensin +# This file is part of the "cmake-common" project. +# For details, see https://github.com/egor-tensin/cmake-common. +# Distributed under the MIT License. + +R'''Build a CMake project. + +This script is used basically to invoke the CMake executable in a +cross-platform way (provided the platform has Python 3, of course). The +motivation was to merge my Travis and AppVeyor build scripts (largely similar, +but written in bash and PowerShell, respectively). + +A simple usage example: + + $ %(prog)s --configuration Release --install path/to/somewhere -- ../examples/simple + ... + + $ ./path/to/somewhere/bin/foo + foo + +Picking the target platform is build system-specific. On Visual Studio, pass +the target platform using the `-A` flag like this: + + > %(prog)s --install path\to\somewhere -- ..\examples\simple -A Win32 + ... + +Using GCC-like compilers, the best way is to use CMake toolchain files (see +cmake/toolchains in this repository for examples). + + $ %(prog)s --install path/to/somewhere -- ../examples/simple -D CMAKE_TOOLCHAIN_FILE="$( pwd )/../toolchains/mingw-x86.cmake" + ... +''' + +import argparse +from contextlib import contextmanager +import logging +from enum import Enum +import os +import os.path +import subprocess +import sys +import tempfile + + +def _run_executable(cmd_line): + logging.info('Running executable: %s', cmd_line) + return subprocess.run(cmd_line, check=True) + + +def _run_cmake(cmake_args): + _run_executable(['cmake'] + cmake_args) + + +class Configuration(Enum): + DEBUG = 'Debug' + MINSIZEREL = 'MinSizeRel' + RELWITHDEBINFO = 'RelWithDebInfo' + RELEASE = 'Release' + + def __str__(self): + return self.value + + +def _parse_configuration(s): + try: + return Configuration(s) + except ValueError: + raise argparse.ArgumentTypeError(f'invalid configuration: {s}') + + +@contextmanager +def _create_build_dir(args): + if args.build_dir is not None: + logging.info('Build directory: %s', args.build_dir) + yield args.build_dir + return + + with tempfile.TemporaryDirectory(dir=os.path.dirname(args.src_dir)) as build_dir: + logging.info('Build directory: %s', build_dir) + try: + yield build_dir + finally: + logging.info('Removing build directory: %s', build_dir) + return + + +class GenerationPhase: + def __init__(self, build_dir, args): + self.build_dir = build_dir + self.args = args + + def _cmake_args(self): + return self._to_cmake_args(self.build_dir, self.args) + + @staticmethod + def _to_cmake_args(build_dir, args): + result = [] + if args.install_dir is not None: + result += ['-D', f'CMAKE_INSTALL_PREFIX={args.install_dir}'] + if args.configuration is not None: + result += ['-D', f'CMAKE_BUILD_TYPE={args.configuration}'] + if args.cmake_args is not None: + result += args.cmake_args + result += [f'-B{build_dir}', f'-H{args.src_dir}'] + return result + + def run(self): + _run_cmake(self._cmake_args()) + + +class BuildPhase: + def __init__(self, build_dir, args): + self.build_dir = build_dir + self.args = args + + def _cmake_args(self): + return self._to_cmake_args(self.build_dir, self.args) + + @staticmethod + def _to_cmake_args(build_dir, args): + result = ['--build', build_dir] + if args.configuration is not None: + result += ['--config', str(args.configuration)] + if args.install_dir is not None: + result += ['--target', 'install'] + return result + + def run(self): + _run_cmake(self._cmake_args()) + + +def _parse_dir(s): + return os.path.abspath(os.path.normpath(s)) + + +def _parse_args(argv=None): + if argv is None: + argv = sys.argv[1:] + logging.info('Command line arguments: %s', argv) + + parser = argparse.ArgumentParser( + description=__doc__, + formatter_class=argparse.RawDescriptionHelpFormatter) + + parser.add_argument('--build', metavar='DIR', dest='build_dir', + type=_parse_dir, + help='build directory (temporary directory unless specified)') + parser.add_argument('--install', metavar='DIR', dest='install_dir', + type=_parse_dir, + help='install directory') + parser.add_argument('--configuration', metavar='CONFIG', + type=_parse_configuration, default=Configuration.DEBUG, + help=f'build configuration ({"/".join(map(str, Configuration))})') + parser.add_argument('src_dir', metavar='DIR', + type=_parse_dir, + help='source directory') + parser.add_argument('cmake_args', nargs='*', metavar='CMAKE_ARG', + help='additional CMake arguments, to be passed verbatim') + args = parser.parse_args(argv) + return args + + +def _setup_logging(): + logging.basicConfig( + format='%(asctime)s | %(levelname)s | %(message)s', + level=logging.INFO) + + +def build(argv=None): + args = _parse_args(argv) + with _create_build_dir(args) as build_dir: + gen_phase = GenerationPhase(build_dir, args) + gen_phase.run() + build_phase = BuildPhase(build_dir, args) + build_phase.run() + + +def main(argv=None): + _setup_logging() + try: + build(argv) + except Exception as e: + logging.exception(e) + raise + + +if __name__ == '__main__': + main() diff --git a/toolchains/boost/README.md b/toolchains/boost/README.md new file mode 100644 index 0000000..8c6870a --- /dev/null +++ b/toolchains/boost/README.md @@ -0,0 +1,2 @@ +Use the toolchain files by passing something like +`--user-config=PATH/TO/cmake-common/boost/toolchains/TOOLCHAIN.jam` to `b2`. diff --git a/toolchains/boost/mingw-w64-x64-exe.jam b/toolchains/boost/mingw-w64-x64-exe.jam new file mode 100644 index 0000000..46ab535 --- /dev/null +++ b/toolchains/boost/mingw-w64-x64-exe.jam @@ -0,0 +1 @@ +using gcc : : x86_64-w64-mingw32-g++.exe : windows ; diff --git a/toolchains/boost/mingw-w64-x64.jam b/toolchains/boost/mingw-w64-x64.jam new file mode 100644 index 0000000..f52acfa --- /dev/null +++ b/toolchains/boost/mingw-w64-x64.jam @@ -0,0 +1 @@ +using gcc : : x86_64-w64-mingw32-g++ : windows ; diff --git a/toolchains/boost/mingw-w64-x86-exe.jam b/toolchains/boost/mingw-w64-x86-exe.jam new file mode 100644 index 0000000..87beca0 --- /dev/null +++ b/toolchains/boost/mingw-w64-x86-exe.jam @@ -0,0 +1 @@ +using gcc : : i686-w64-mingw32-g++.exe : windows ; diff --git a/toolchains/boost/mingw-w64-x86.jam b/toolchains/boost/mingw-w64-x86.jam new file mode 100644 index 0000000..e73f190 --- /dev/null +++ b/toolchains/boost/mingw-w64-x86.jam @@ -0,0 +1 @@ +using gcc : : i686-w64-mingw32-g++ : windows ; diff --git a/toolchains/cmake/README.md b/toolchains/cmake/README.md new file mode 100644 index 0000000..9c58eb6 --- /dev/null +++ b/toolchains/cmake/README.md @@ -0,0 +1,3 @@ +Use the toolchain files by passing something like +`-D CMAKE_TOOLCHAIN_FILE=PATH/TO/cmake-common/cmake/toolchains/TOOLCHAIN.cmake` +to `cmake`. diff --git a/toolchains/cmake/gcc-x64.cmake b/toolchains/cmake/gcc-x64.cmake new file mode 100644 index 0000000..2f7019e --- /dev/null +++ b/toolchains/cmake/gcc-x64.cmake @@ -0,0 +1,4 @@ +set(CMAKE_C_COMPILER gcc) +set(CMAKE_C_FLAGS -m64) +set(CMAKE_CXX_COMIPLER g++) +set(CMAKE_CXX_FLAGS -m64) diff --git a/toolchains/cmake/gcc-x86.cmake b/toolchains/cmake/gcc-x86.cmake new file mode 100644 index 0000000..e2e84be --- /dev/null +++ b/toolchains/cmake/gcc-x86.cmake @@ -0,0 +1,4 @@ +set(CMAKE_C_COMPILER gcc) +set(CMAKE_C_FLAGS -m32) +set(CMAKE_CXX_COMIPLER g++) +set(CMAKE_CXX_FLAGS -m32) diff --git a/toolchains/cmake/mingw-w64-x64.cmake b/toolchains/cmake/mingw-w64-x64.cmake new file mode 100644 index 0000000..c689d39 --- /dev/null +++ b/toolchains/cmake/mingw-w64-x64.cmake @@ -0,0 +1,4 @@ +set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc) +set(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++) +set(CMAKE_RC_COMILER x86_64-w64-mingw32-windres) +set(CMAKE_SYSTEM_NAME Windows) diff --git a/toolchains/cmake/mingw-w64-x86.cmake b/toolchains/cmake/mingw-w64-x86.cmake new file mode 100644 index 0000000..e5dedd4 --- /dev/null +++ b/toolchains/cmake/mingw-w64-x86.cmake @@ -0,0 +1,4 @@ +set(CMAKE_C_COMPILER i686-w64-mingw32-gcc) +set(CMAKE_CXX_COMPILER i686-w64-mingw32-g++) +set(CMAKE_RC_COMILER i686-w64-mingw32-windres) +set(CMAKE_SYSTEM_NAME Windows) -- cgit v1.2.3