cppmake 127.0.13__py3-none-any.whl → 127.0.16__py3-none-any.whl

cppmake-127.0.16.dist-info/METADATA

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: cppmake
+Version: 127.0.16
+Summary: A modern C++ builder based on C++20 Modules.
+Author-email: shyeyian <shyeyian@icloud.com>
+License-Expression: MIT
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# Cppmake: A C++20 Modules Build System
+
+Cppmake is a modern, fast, and accurate C++ build system focusing on C++20 Modules.
+
+Cppmake aims to
+- Make everything modular.
+- Easily modularize third-party libraries.
+- Be fast, parallel, and fully cached.
+
+Cppmake is written in pure Python with no additional pip dependencies.
+
+# Show
+
+![vedio](share/make.gif)
+
+# Install
+
+Use pip to install cppmake:
+```sh
+pip install cppmake
+```
+Or install from source:
+```sh
+git clone https://github.com/anonymouspc/cppmake
+cd cppmake
+python install.py
+```
+
+# Getting Started
+
+In a cppmake project: 
+- module `aaa.bbb` should be placed at `module/aaa/bbb.cpp`
+- module `aaa:ccc` should be placed at `module/aaa/ccc.cpp`
+- source `main` should be placed at `source/main.cpp`
+- `std` module will be auto-installed.
+
+For example:
+```
+├── module
+│   ├── aaa.cpp
+│   ├── aaa
+│   │   ├── bbb.cpp // aaa.bbb
+│   │   └── ccc.cpp // aaa:ccc
+│   └── ddd.cpp
+├── source
+│   └── main.cpp
+└── cppmake.py
+```
+Then, run
+```sh
+cppmake
+```
+The output will be generated in the `binary/` directory.
+
+# Advanced
+
+Cppmake provides various configurable options, such as:
+```sh
+cppmake --compiler=clang++ --std=c++23
+```
+```sh
+cppmake --compiler=/opt/gcc/bin/g++ --linker=lld --std=c++26 --type=release --target=make --parallel=$(nproc)
+```
+
+System/compiler support:
+|         | clang | emcc | gcc | msvc |
+|:-------:|:-----:|:----:|:---:|:----:| 
+| Linux   | ✓     | ✓    | ✓   | N/A  |  
+| Macos   | ✓     | ✓    | ✓   | N/A  |  
+| Windows | ✗     | ✗    | ✗   | ✗    | 
+- ✓: Supported and tested.
+- ✗: Not implemented yet; planned for future releases.
+- *(The author does not own a Windows PC. Contributions for Windows support are welcome!)*
+
+# Configure
+
+Cppmake uses a `cppmake.py` file (pure Python) to describe the C++ project. The configuration is entirely standard Python syntax.
+
+For example:
+```py
+from cppmakelib import *
+def make():
+    Source("main").compile()
+```
+This `cppmake.py` defines a single source `source/main.cpp`, which will be
+built into a binary.
+- *(Imported modules and packages will be built automatically before compiling the source. For example, if `source/main.cpp` imports module my_module and module `boost.asio`, then Cppmake will precompile module `my_module`, cmake build `boost`, and precompile module `boost.asio` before finally compiling `source/main.cpp`.)*
+- *(By default, the imported modules and packages form a [directed acyclic graph](https://en.wikipedia.org/wiki/Directed_acyclic_graph) and will be executed with maximum possible parallelism, depending on your cpu thread count. You can control the level of parallelism using `cppmake --parallel=N`, or force serial compilation through `cppmake --parallel=1`.)*
+
+Another example:
+```py
+from cppmakelib import *
+
+if type(compiler) == Gcc:
+    compiler.compile_flags += ["-fno-inline"] # global
+    compiler.define_macros |= {"NDEBUG": '1'} # global
+
+package.define_macros = {"MY_MACRO": "42"} # package-local
+
+def build(): # select a source file to compile
+    if type(system) == Linux:
+        Source("linux").compile()
+
+def test(): # compile and test all units
+    for file in iterate_dir("source/test", recursive=True):
+        Source(file=file).compile()
+        Executable(file=file).run()
+```
+This `cppmake.py` defines 2 targets (switchable via
+`cppmake --target=build|test`) and several configuration rules. You can
+easily extend it with any other Python code.
+
+# Integrating third-party packages
+
+Third-party packages should be located in `package/`, for example
+```
+├── module
+│   ├── aaa.cpp
+│   ├── aaa
+│   │   ├── bbb.cpp // aaa.bbb
+│   │   └── ccc.cpp // aaa:ccc
+│   └── ddd.cpp
+├── source
+│   └── main.cpp
+├── package
+│   ├── boost
+│   │   ├── git
+│   │   │   └── [git clone]
+│   │   ├── module
+│   │   │   ├── boost.cpp // boost
+│   │   │   └── boost
+│   │   │       ├── asio.cpp // boost.asio
+│   │   │       ├── beast.cpp // boost.beast
+│   │   │       └── numeric.cpp // boost.numeric
+│   │   │           ├── interval.cpp // boost.numeric.interval
+│   │   │           └── ublas.cpp // boost.numeric.ublas
+│   │   └── cppmake.py
+│   └── eigen
+│       ├── git
+│       │   └── [git clone]
+│       ├── module
+│       │   └── eigen.cpp // eigen
+│       └── cppmake.py
+└── cppmake.py
+```
+
+In `package/boost/cppmake.py` we can define a `build()` function to describe how this package should be built. For example:
+```py
+# package/boost/cppmake.py
+from cppmakelib import *
+
+def build():
+    cmake.build(
+        package=package,
+        args=[
+            "-DBUILD_SHARED_LIBS=OFF"
+        ]
+    )
+```
+Then:
+```cpp
+// package/boost/module/boost/asio.cpp
+module;
+#include <boost/asio.hpp>
+export module boost.asio;
+export namespace boost::asio
+{
+    using boost::asio::io_context;
+    //...
+}
+```
+will modularize boost.asio into a module.
+
+Builder support: 
+| cmake | include* | makefile | meson | msbuild |
+|:-----:|:--------:|:--------:|:-----:|:-------:| 
+| ✓     | ✓        | ✓        |(soon) | ✗       |
+- ✓: Supported and tested.
+- ✗: Not implemented yet; planned for future releases.
+- *(include: means header-only libraries.)*
+
+# Thank you!

cppmake-127.0.16.dist-info/RECORD

@@ -0,0 +1,55 @@
+cppmake.py,sha256=xbfuYDNg1BJ2MQKqP-nBZ0FGSoEB651FAxeWoR-Dyrk,1316
+cppmaked.py,sha256=53d6Byv2xUv31UAoMHH5Lym6Q5SSIdYm5Oj8-2b-T0E,19
+cppmakelib/__init__.py,sha256=meHRNq2JVOGvxkShKnmCuNeMsJ4t0Bp1yHQ8j7xisHQ,1123
+cppmakelib/basic/config.py,sha256=f-Pb7xGzy7z7Y6symG3wgLzqgxsOps6Rd3cnZL8qog8,2594
+cppmakelib/basic/context.py,sha256=BUL5i1Ii8TB_iyTDYS1PWQz1AjfiSGnk5ha7EJFTwxE,1297
+cppmakelib/builder/cmake.py,sha256=DDI1bQxgubc4d8_-6710Ztz_Q0kCO1jHusVaR_fvKa4,2398
+cppmakelib/builder/include.py,sha256=G4WVZLOxxLPwpJDKCW1OBMc-d8n1vGEHQJpOr1DMhHI,586
+cppmakelib/builder/makefile.py,sha256=k1uSDpFSXBqEyFMnarrNM1luQD8Ah_jN2sSvGQYT7WM,2258
+cppmakelib/compiler/all.py,sha256=0zYy3qF0WwF2JGztUs_JK7WgbXOZmXMxgM2EHErVYmc,948
+cppmakelib/compiler/clang.py,sha256=GhOmnYlNcpQ0kKB3rWjmZnMR0R5uUcBkN1k6Zo5m4ns,8863
+cppmakelib/compiler/emcc.py,sha256=N33g7nYFphltbvW8VA3crt178fdX2ZZjnYofBcnUCEA,3151
+cppmakelib/compiler/gcc.py,sha256=vqE9iJMGEY82cWzGScDjLHuWijPCgf7faqEA3hoof6g,12035
+cppmakelib/compiler/msvc.py,sha256=8AeKDFWGh4efg0xs8N52lVMA1qdVS_ggzeWgFaPyq08,707
+cppmakelib/error/config.py,sha256=lUUIJJJHM20UDVzFq9Ar4eOqlJHPfCTSjtkHoOARFkw,167
+cppmakelib/error/logic.py,sha256=ovqfqfM41Ar_LDB5NqisEPYK8ppAo4cFIimZFRGNmnQ,167
+cppmakelib/error/subprocess.py,sha256=NyrH4g0CTM2OP0esJtwwbmNczqdfBepHLGC3M8IRdps,312
+cppmakelib/executor/operation.py,sha256=A7P7v2JxvA-FjtOwep20Hl2OzbE1-j8lrZg8IfkpD8Q,652
+cppmakelib/executor/run.py,sha256=Gq5O5CPjPEzoTkJPpNOWwj0WV8rwOfsTEj6qoI8x0Ok,5599
+cppmakelib/executor/scheduler.py,sha256=UKEWy3U9mwQIiwxOloQDNKsuI6Iw0JJ7yklvtqxXeIE,3081
+cppmakelib/logger/compile_commands.py,sha256=vw4cgBofHK5tLqIJJn1AxPIDiVoK271m9zO4-0krs9I,922
+cppmakelib/logger/make_progress.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cppmakelib/logger/module_mapper.py,sha256=htD2bT2pz564zxokttSqLuSOv2UU4X1rdpEhuGWfh4w,176
+cppmakelib/logger/unit_status.py,sha256=w1gng94cSxPsCyeb2NJ4izcN_cSFJCRj3Ezcru4jSKc,12405
+cppmakelib/system/all.py,sha256=SCGq5GSNrWlTWuE2hx8DEJsS-utrAZQiOrHyv5zbStQ,850
+cppmakelib/system/linux.py,sha256=3Qt8M_b7R_mnPRGZ_CPgEY9YHwRauWZDcRJHBEmWfP4,659
+cppmakelib/system/macos.py,sha256=u52SQfJ38cYdzBJlxWW-n1mHyjPS4qOC9CEsrWZ6FeE,667
+cppmakelib/system/windows.py,sha256=wcn70tEKRAiQs3abGhTqMmU0qxuQVMjuGnStuBeFAbY,711
+cppmakelib/unit/binary.py,sha256=gvv0ZHFQRlyMVrDJ8SmTioORpxWevoxzCP4GoHIh_u8,1058
+cppmakelib/unit/code.py,sha256=HrGyHaqsJ56LN9mRp-Odlxj81GqRMbBk9p2HaxTW5tE,2865
+cppmakelib/unit/dynamic.py,sha256=qxa--uJzU-SnNiBn0UJ1lh7iWGhBX9aJbr3nVJjFNq4,395
+cppmakelib/unit/executable.py,sha256=Rn_BfxEiUv6x-nNzNaNiba620hy-0iTsoEesczKh5F8,1129
+cppmakelib/unit/header.py,sha256=__9hwYSW6pp0LMVqvDjiN2P3THb2t6tUh8DbHIjgxQs,3179
+cppmakelib/unit/module.py,sha256=tH3VBvr93nmmlbCqxoW_EMxqSOd5oTLK-oMCkHxojiM,3744
+cppmakelib/unit/object.py,sha256=leH5FrxSR5tqGFCTtcK1pyjMgmaWoitGfoSHe2Ugcz0,3565
+cppmakelib/unit/package.py,sha256=PQbgVo1VOW5jsvABF-nqQhkaI0oOan5x12WwIHmmvOA,3748
+cppmakelib/unit/precompiled.py,sha256=5VRzdb8-GOByzZH9UmHZSW2-11-wNIWuLW6n2dJ8f9k,233
+cppmakelib/unit/preparsed.py,sha256=N3PuBlSkWcrR9sUay23-gP8SU3eV9oH8rRKBDQKTBpU,227
+cppmakelib/unit/preprocessed.py,sha256=DiCouO_9jqPjMp5fOa_ofkoIPqT6PGmlnfJD2htX7ow,68
+cppmakelib/unit/source.py,sha256=bijgUDu9q07WjY65y_tqOA1JVOIB1D-0DR24gLnRVTc,3316
+cppmakelib/utility/algorithm.py,sha256=lssr2pwtZg4ozWiN994YNM_8hpkuO5ypwAgePHj2-3E,1883
+cppmakelib/utility/color.py,sha256=KOEt_116tXpl-houoRRaAgDtICUt1JxwsBC3RznbvO8,259
+cppmakelib/utility/decorator.py,sha256=7JQ7weTQvuUeUgS-LodIi4YdgCe-7k2rV3mjw-Zu7Vw,6936
+cppmakelib/utility/filesystem.py,sha256=stvMjUY7rHwgPu5F4u4tHwcIVQF_DQ-MmD5AB6qE7OQ,2580
+cppmakelib/utility/import_.py,sha256=3S01IgezSNxWwKpGK2si1w1TGkk_CxR4aDSJ88U0t6w,788
+cppmakelib/utility/time.py,sha256=n6YjgHOpXg7-1LFMzOw2UOr5XDXaWi4ub3CuotfwhPU,10
+cppmakelib/utility/version.py,sha256=_IvzOQNnrOAxUWLGMyZ4OeGZoTKFJ_LKqNelkTgusP8,3088
+cppmakelib/utility/remote/client.py,sha256=5FEQ86-f-j0Vm_uLJ3SSIKYStBwM2VqbogkTPEMKt0s,22
+cppmakelib/utility/remote/protocol.py,sha256=W5l08clEfMDdMK1pwSh8viKeI0bEanyDuse5gTC7ecc,1094
+cppmakelib/utility/remote/remote.py,sha256=_Js4McneDRc4QsV0aiYmkIFfxPyMP1N7TqLu2i702nk,1398
+cppmakelib/utility/remote/server.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cppmake-127.0.16.dist-info/METADATA,sha256=ASQW5jswoXJHsKiyoDzXfzyc3oSbZpTH3mzAkbjyEZA,5727
+cppmake-127.0.16.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+cppmake-127.0.16.dist-info/entry_points.txt,sha256=j0a6PH2Oo88b4nX0-m6CWSUQ0Lb3SYH5GDBtdECK_8k,66
+cppmake-127.0.16.dist-info/top_level.txt,sha256=DQF_BjuSUuvQMC6xFPikLsxY9Fp72ygEJiEgh5xTjC0,28
+cppmake-127.0.16.dist-info/RECORD,,

{cppmake-127.0.13.dist-info → cppmake-127.0.16.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

cppmake-127.0.16.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+cppmake = cppmake:main
+cppmaked = cppmaked:main

cppmake-127.0.16.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+cppmake
+cppmaked
+cppmakelib

cppmaked.py

@@ -0,0 +1,2 @@
+def main():
+    ...

cppmakelib/__init__.py

@@ -0,0 +1,32 @@
+from .basic.config        import config
+
+from .builder.cmake       import cmake
+from .builder.include     import include
+from .builder.makefile    import makefile
+
+from .compiler.all        import compiler
+from .compiler.clang      import Clang
+from .compiler.emcc       import Emcc
+from .compiler.gcc        import Gcc
+from .compiler.msvc       import Msvc
+
+from .error.config        import ConfigError
+from .error.logic         import LogicError
+from .error.subprocess    import SubprocessError
+
+from .utility.filesystem    import path, exist_file, exist_dir, create_file, create_dir, copy_file, copy_dir, remove_file, remove_dir, modified_time_file, iterate_dir
+
+from .execution.operation import sync_wait, start_detached, when_all, when_any
+from .execution.run       import run
+
+from .system.all          import system
+from .system.linux        import Linux
+from .system.macos        import Macos
+from .system.windows      import Windows
+
+from .unit.executable     import Executable
+from .unit.module         import Module
+from .unit.package        import Package
+from .unit.source         import Source
+
+self: Package

cppmakelib/basic/config.py

@@ -0,0 +1,50 @@
+from cppmakelib.utility.filesystem import path
+from cppmakelib.system.all         import system
+from cppmakelib.utility.decorator  import member
+import argparse
+import functools
+import os
+import sys
+import typing
+
+class Config(argparse.Namespace):
+    def __init__    (self)                            -> None: ...
+    @functools.wraps(argparse.ArgumentParser.add_argument)
+    def add_argument(self, *args: ..., **kwargs: ...) -> None: ...
+    project : path
+    target  : str
+    compiler: path
+    std     : typing.Literal['c++20'] | typing.Literal['c++23']   | typing.Literal['c++26']
+    type    : typing.Literal['debug'] | typing.Literal['release'] | typing.Literal['size']
+    jobs    : int
+    verbose : bool
+
+    _parser: argparse.ArgumentParser
+
+config: Config
+
+
+
+@member(Config)
+def __init__(self: Config) -> None:
+    self._parser = argparse.ArgumentParser()
+    self._parser.usage = 'cppmake [project] [options...]'
+    self._parser.add_argument('project',    nargs='?',                            default='.',                  help=f'path to C++ project dir   (example: ., .., /home/my/project; requires: containing cppmake.py; default: .)')
+    self._parser.add_argument('--target',                                         default='make',               help=f'select cppmake target     (example: make, build, test; requires: defined in cppmake.py; default: make)')
+    self._parser.add_argument('--compiler',                                       default=system.compiler,      help=f'use specific C++ compiler (example: g++, /usr/bin/g++, /opt/homebrew/clang++; requires: executable; default: {system.compiler})')
+    self._parser.add_argument('--std',      choices=['c++20', 'c++23', 'c++26'],  default='c++26',              help=f'use specific C++ standard (default: c++26)')
+    self._parser.add_argument('--type',     choices=['debug', 'release', 'size'], default='debug',              help=f'choose config type        (default: debug)')
+    self._parser.add_argument('--jobs',     type   =lambda n: int(n),             default=os.cpu_count(),       help=f'allow maximun concurrency (default: {os.cpu_count()})')
+    self._parser.add_argument('--verbose',  action ='store_true',                 default=False,                help=f'print verbose outputs')
+    self._parser.parse_args(namespace=self)
+
+@member(Config)
+def add_argument(self: Config, *args: ..., **kwargs: ...) -> None:
+    self._parser.add_argument(*args, **kwargs)
+    self._parser.parse_args(namespace=self)
+
+config = Config()
+
+sys.dont_write_bytecode = True
+os.chdir(config.project)
+os.environ['LANG'] = 'C'

cppmakelib/basic/context.py

@@ -0,0 +1,39 @@
+from cppmakelib.unit.package      import Package
+from cppmakelib.utility.decorator import member
+import typing
+
+class Context:
+    def switch(self, package: Package) -> typing.ContextManager[None]: ...
+    package: Package 
+
+    class _ContextManager:
+        def __init__ (self, context: Context, package: Package)      -> None: ...
+        def __enter__(self)                                          -> None: ...
+        def __exit__ (self, *args: typing.Any, **kwargs: typing.Any) -> None: ...
+        context    : Context
+        old_package: Package
+        new_package: Package
+
+context: Context
+
+
+
+@member(Context)
+def switch(self: Context, package: Package) -> typing.ContextManager[None]:
+    return Context._ContextManager(self, package)
+
+@member(Context._ContextManager)
+def __init__(self: Context._ContextManager, context: Context, package: Package) -> None:
+    self.context     = context
+    self.old_package = context.package
+    self.new_package = package
+
+@member(Context._ContextManager)
+def __enter__(self: Context._ContextManager) -> None:
+    self.context.package = self.new_package
+
+@member(Context._ContextManager)
+def __exit__(self: Context._ContextManager, *args: typing.Any, **kwargs: typing.Any) -> None:
+    self.context.package = self.old_package
+
+context = Context()

cppmakelib/builder/cmake.py

@@ -0,0 +1,71 @@
+from cppmakelib.basic.config      import config
+from cppmakelib.compiler.all      import compiler
+from cppmakelib.executor.run      import async_run
+from cppmakelib.utility.filesystemimport path, create_dir, remove_dir
+from cppmakelib.utility.algorithm import recursive_collect
+from cppmakelib.utility.decorator import syncable, unique
+from cppmakelib.utility.version   import Version
+
+class Cmake:
+    name: str = 'cmake'
+    def       __init__ (self, path: path = path('cmake')) -> None: ...
+    async def __ainit__(self, path: path = path('cmake')) -> None: ...
+    def       async_build(self, package: Package, args: list[str]) -> None: ...
+
+
+
+async def __ainit__(self, path: path = path('cmake')):
+    self.path    = path
+    self.version = await self._async_get_version()
+
+@syncable
+async def async_build(self, package, args):
+    try:
+        create_dir(package.build_dir)
+        await async_run(
+            command=[
+                self.path,
+                '-S', package.git_dir,
+                '-B', package.build_dir,
+                f'-DCMAKE_BUILD_TYPE={config.type}',
+                f'-DCMAKE_CXX_COMPILER={compiler.path}',
+                f'-DCMAKE_CXX_FLAGS={' '.join(compiler.compile_flags + package.compile_flags)}',
+                f'-DCMAKE_PREFIX_PATH={';'.join(recursive_collect(package, next=lambda package: package.require_packages, collect=lambda package: package.install_dir))}',
+                f'-DCMAKE_INSTALL_PREFIX={package.install_dir}',
+                '-DCMAKE_INSTALL_LIBDIR=lib',
+                *args
+            ]
+        )
+    except:
+        remove_dir(package.build_dir)
+        raise
+    try:
+        await async_run(
+            command=[
+                self.path,
+                '--build', package.build_dir,
+                '-j',      str(config.parallel)
+            ]
+        )
+    except:
+        raise
+    try:
+        create_dir(package.install_dir)
+        await async_run(
+            command=[
+                self.path,
+                '--install', package.build_dir,
+                '-j',        str(config.parallel)
+            ]
+        )
+    except:
+        remove_dir(package.install_dir)
+        raise
+
+async def _async_get_version(self):
+    return await Version.async_parse(
+        name   =self.name,
+        command=[self.path, '--version'],
+        check  =lambda stdout: stdout.startswith('cmake'),
+        lowest =4
+    )

cppmakelib/builder/include.py

@@ -0,0 +1,15 @@
+from cppmakelib.utility.filesystemimport create_dir, remove_dir, copy_file, copy_dir
+
+def include(package, file=None, dir=None, relpath='.'):
+    try:
+        create_dir(f'{package.include_dir}/{relpath}')
+        if file is not None and dir is None:
+            copy_file(f'{package.git_dir}/{file}', f'{package.include_dir}/{relpath}/{file}')
+        elif file is None and dir is not None:
+            copy_dir (f'{package.git_dir}/{dir}',  f'{package.include_dir}/{relpath}/')
+        else:
+            assert False
+    except:
+        remove_dir(package.install_dir)
+        raise
+

cppmakelib/builder/makefile.py

@@ -0,0 +1,68 @@
+from cppmakelib.basic.config      import config
+from cppmakelib.compiler.all      import compiler
+from cppmakelib.executor.run      import async_run
+from cppmakelib.utility.filesystemimport absolute_path, create_dir, remove_dir
+from cppmakelib.utility.decorator import syncable, unique
+from cppmakelib.utility.version   import Version
+
+class Makefile:
+    name = 'makefile'
+
+    @syncable
+    @unique
+    async def __ainit__(self, path='make'):
+        self.path    = path
+        self.version = await self._async_get_version()
+
+    @syncable
+    async def async_build(self, package, file='configure', args=[]):
+        try:
+            create_dir(package.build_dir)
+            await async_run(
+                command=[
+                   f'{package.git_dir}/{file}',
+                   f'CXX={compiler.path}',
+                   f'CXXFLAGS={' '.join(compiler.compile_flags + package.compile_flags)}'
+                   f'--prefix={absolute_path(package.install_dir)}',
+                   f'--libdir={absolute_path(package.install_dir)/'lib'}',
+                    *args
+                ],
+                cwd=package.build_dir
+            )
+        except:
+            remove_dir(package.build_dir)
+            raise
+        try:
+            await async_run(
+                command=[
+                    self.path,
+                   f'CXX={compiler.path}',
+                   f'CXXFLAGS={' '.join(compiler.compile_flags + package.compile_flags)}'
+                    '-C', package.build_dir,
+                    '-j', str(config.parallel)
+                ]
+            )
+        except:
+            raise
+        try:
+            create_dir(package.install_dir)
+            await async_run(
+                command=[
+                    self.path, 'install'
+                    '-C', package.build_dir,
+                    '-j', str(config.parallel)
+                ]
+            )
+        except:
+            remove_dir(package.install_dir)
+            raise
+
+    async def _async_get_version(self):
+        return await Version.async_parse(
+            name   ='makefile',
+            command=[self.path, '--version'],
+            check  =lambda stdout: stdout.startswith('GNU Make'),
+            lowest =4
+        )
+            
+makefile = Makefile()

cppmakelib/compiler/all.py

@@ -0,0 +1,26 @@
+from cppmakelib.basic.config   import config
+from cppmakelib.compiler.clang import Clang
+from cppmakelib.compiler.emcc  import Emcc
+from cppmakelib.compiler.gcc   import Gcc
+from cppmakelib.error.config   import ConfigError
+
+compiler: Clang | Emcc | Gcc
+
+
+
+def _choose_compiler() -> Clang | Emcc | Gcc:
+    matches: list[Clang | Emcc | Gcc] = []
+    errors : list[Exception]          = []
+    for Compiler in (Clang, Emcc, Gcc):
+        try:
+            matches += [Compiler(config.compiler)]
+        except ConfigError as error:
+            errors += [error]
+    if len(matches) == 0:
+        raise ConfigError(f'compiler is not supported (with path = {config.compiler}, matches = {matches})') from ExceptionGroup('no compiler is matched', errors)
+    elif len(matches) == 1:
+        return matches[0]
+    else:
+        raise ConfigError(f'compiler is ambiguous (with path = {config.compiler}, matches = {matches})')
+
+compiler = _choose_compiler()