proj-flow 0.9.3__tar.gz → 0.10.0__tar.gz

{proj_flow-0.9.3 → proj_flow-0.10.0}/.flow/config.yaml

@@ -1,7 +1,7 @@
 extensions:
   - proj_flow.ext.python
   - proj_flow.ext.github
-  - proj_flow.ext.re_structured_changelist
+  - proj_flow.ext.re_structured_changelog
 
 entry:
   build: [ Build ]

{proj_flow-0.9.3 → proj_flow-0.10.0}/CHANGELOG.rst

@@ -4,6 +4,28 @@ Changelog
 
 All notable changes to this project will be documented in this file.
 
+`0.10.0 <https://github.com/mzdun/proj-flow/compare/v0.9.4...v0.10.0>`_ (2025-02-09)
+====================================================================================
+
+New Features
+------------
+
+- add ``project`` parameter to ``proj-flow init`` (`7d8c942 <https://github.com/mzdun/proj-flow/commit/7d8c942d608eea091589cebb21ca4e2c91654e4a>`_)
+- add project key to init settings (`c03662a <https://github.com/mzdun/proj-flow/commit/c03662a4878d47f19d0d3f200baa335c3e7eba44>`_)
+- introduce init-specific project module (`61e8710 <https://github.com/mzdun/proj-flow/commit/61e871067c79dcbbfffd121f095ac9c7ce3b69df>`_)
+- evaluate command argument' properties lazily (`18ecb83 <https://github.com/mzdun/proj-flow/commit/18ecb837a584d7e4670fce689661319cf832388e>`_)
+
+`0.9.4 <https://github.com/mzdun/proj-flow/compare/v0.9.3...v0.9.4>`_ (2025-02-09)
+==================================================================================
+
+Bug Fixes
+---------
+
+- remove vestiges of old plugin finder + styles (`484fec4 <https://github.com/mzdun/proj-flow/commit/484fec44107474fe765091b7754b94094395c838>`_)
+- move C++ things to ext.cplusplus (`fce7318 <https://github.com/mzdun/proj-flow/commit/fce7318b614a645dd9b72854a4ab78c0c5cf7b00>`_)
+- move last command to minimal (`c3f1dba <https://github.com/mzdun/proj-flow/commit/c3f1dba7c4f55fc8f62eb4d44162833991cd516f>`_)
+- **docs**: cleanup the docstrings after moving (`a952ebe <https://github.com/mzdun/proj-flow/commit/a952ebe19c65cb51585dc2c69ead74bfe7fff5cc>`_)
+
 `0.9.3 <https://github.com/mzdun/proj-flow/compare/v0.9.2...v0.9.3>`_ (2025-02-08)
 ==================================================================================
 

{proj_flow-0.9.3 → proj_flow-0.10.0}/PKG-INFO

@@ -1,7 +1,8 @@
 Metadata-Version: 2.4
 Name: proj-flow
-Version: 0.9.3
+Version: 0.10.0
 Summary: C++ project maintenance, automated
+Project-URL: Changelog, https://github.com/mzdun/proj-flow/blob/main/CHANGELOG.rst
 Project-URL: Documentation, https://proj-flow.readthedocs.io/en/latest/
 Project-URL: Homepage, https://pypi.org/project/proj-flow/
 Project-URL: Source Code, https://github.com/mzdun/proj-flow
@@ -75,7 +76,7 @@ From PowerShell with:
 A fresh C++ project can be created with a
 
 ```sh
-proj-flow init
+proj-flow init cxx
 ```
 
 This command will ask multiple questions to build Mustache context for the

{proj_flow-0.9.3 → proj_flow-0.10.0}/README.md

@@ -50,7 +50,7 @@ From PowerShell with:
 A fresh C++ project can be created with a
 
 ```sh
-proj-flow init
+proj-flow init cxx
 ```
 
 This command will ask multiple questions to build Mustache context for the

{proj_flow-0.9.3 → proj_flow-0.10.0}/pyproject.toml

@@ -37,6 +37,7 @@ readme = "README.md"
 requires-python = ">=3.10"
 
 [project.urls]
+Changelog = "https://github.com/mzdun/proj-flow/blob/main/CHANGELOG.rst"
 Documentation = "https://proj-flow.readthedocs.io/en/latest/"
 Homepage = "https://pypi.org/project/proj-flow/"
 "Source Code" = "https://github.com/mzdun/proj-flow"

proj_flow-0.10.0/src/proj_flow/__init__.py

@@ -0,0 +1,9 @@
+# Copyright (c) 2025 Marcin Zdun
+# This code is licensed under MIT license (see LICENSE for details)
+
+"""
+The **proj_flow** contains only ``__version__`` to be updated, nothing more.
+This is in an attempt to make this module easy to load initially.
+"""
+
+__version__ = "0.10.0"

{proj_flow-0.9.3 → proj_flow-0.10.0}/src/proj_flow/api/arg.py

@@ -12,48 +12,71 @@ from dataclasses import dataclass, field
 
 from proj_flow.base import inspect as _inspect
 
+T = typing.TypeVar("T")
+LazyArgument = typing.Union[T, typing.Callable[[], T]]
+
+
+def _eval(arg: LazyArgument[T]) -> T:
+    if callable(arg):
+        return typing.cast(T, arg())
+    return arg
+
+
+class _Completable(typing.Protocol):
+    completer: _inspect.Function
+
 
 @dataclass
 class Argument:
-    help: str = ""
+    help: LazyArgument[str] = ""
     pos: bool = False
-    names: typing.List[str] = field(default_factory=list)
-    nargs: typing.Union[str, int, None] = None
-    opt: typing.Optional[bool] = None
-    meta: typing.Optional[str] = None
-    action: typing.Union[str, argparse.Action, None] = None
-    default: typing.Optional[typing.Any] = None
-    choices: typing.Optional[typing.List[str]] = None
+    names: LazyArgument[typing.List[str]] = field(default_factory=list)
+    nargs: LazyArgument[typing.Union[str, int, None]] = None
+    opt: LazyArgument[typing.Optional[bool]] = None
+    meta: LazyArgument[typing.Optional[str]] = None
+    action: LazyArgument[typing.Union[str, argparse.Action, None]] = None
+    default: LazyArgument[typing.Optional[typing.Any]] = None
+    choices: LazyArgument[typing.Optional[typing.List[str]]] = None
     completer: typing.Optional[_inspect.Function] = None
 
     def visit(self, parser: argparse.ArgumentParser, name: str):
         kwargs = {}
-        if self.help is not None:
-            kwargs["help"] = self.help
-        if self.nargs is not None:
-            kwargs["nargs"] = self.nargs
-        if self.meta is not None:
-            kwargs["metavar"] = self.meta
-        if self.default is not None:
-            kwargs["default"] = self.default
-        if self.action is not None:
-            kwargs["action"] = self.action
-        if self.choices is not None:
-            kwargs["choices"] = self.choices
+
+        self_help = _eval(self.help)
+        self_names = _eval(self.names)
+        self_nargs = _eval(self.nargs)
+        self_opt = _eval(self.opt)
+        self_meta = _eval(self.meta)
+        self_action = _eval(self.action)
+        self_default = _eval(self.default)
+        self_choices = _eval(self.choices)
+
+        if self_help is not None:
+            kwargs["help"] = self_help
+        if self_nargs is not None:
+            kwargs["nargs"] = self_nargs
+        if self_meta is not None:
+            kwargs["metavar"] = self_meta
+        if self_default is not None:
+            kwargs["default"] = self_default
+        if self_action is not None:
+            kwargs["action"] = self_action
+        if self_choices is not None:
+            kwargs["choices"] = self_choices
 
         names = (
-            [name] if self.pos else self.names if len(self.names) > 0 else [f"--{name}"]
+            [name] if self.pos else self_names if len(self_names) > 0 else [f"--{name}"]
         )
 
         if self.pos:
-            kwargs["nargs"] = "?" if self.opt else 1
+            kwargs["nargs"] = "?" if self_opt else 1
         else:
             kwargs["dest"] = name
-            kwargs["required"] = not self.opt
+            kwargs["required"] = not self_opt
 
         action = parser.add_argument(*names, **kwargs)
         if self.completer:
-            action.completer = self.completer  # type: ignore
+            typing.cast(_Completable, action).completer = self.completer
 
         return action
 

{proj_flow-0.9.3 → proj_flow-0.10.0}/src/proj_flow/api/ctx.py

@@ -9,9 +9,10 @@ import datetime
 import inspect
 import os
 from dataclasses import dataclass
-from typing import Callable, Dict, Iterable, List, Optional, Union
+from typing import Any, Callable, Dict, Iterable, List, Optional, Union, cast
 
 from proj_flow.base import cmd
+from proj_flow.base import inspect as _inspect
 
 package_root = os.path.dirname(os.path.dirname(__file__))
 template_dir = "template"
@@ -26,32 +27,44 @@ SettingsType = Dict[str, StrOrBool]
 class Setting:
     json_key: str
     prompt: str = ""
-    value: Union[Values, Callable[[], Values]] = ""
+    value: Union[Values, Callable[[], Values], Callable[[SettingsType], Values]] = ""
     fix: Optional[str] = None
     force_fix: bool = False
+    project: Optional[str] = None
 
     def calc_value(self, previous: SettingsType):
-        if isinstance(self.value, Callable):
+        if callable(self.value):
             kwargs = {}
 
             params = inspect.signature(self.value).parameters
             if "settings" in params:
                 kwargs["settings"] = previous
 
-            return self.value(**kwargs)
+            return cast(_inspect.Function, self.value)(**kwargs)
 
         return self.value
 
 
-def register_init_setting(*setting: Setting, is_hidden=False):
+def register_init_setting(*settings: Setting, is_hidden=False, project: Optional[str]):
+    if project is not None:
+        for setting in settings:
+            setting.project = project
+    (hidden if is_hidden else defaults).extend(settings)
+
+
+def register_common_init_setting(*setting: Setting, is_hidden=False):
     (hidden if is_hidden else defaults).extend(setting)
 
 
-def register_switch(key: str, prompt: str, enabled: bool):
+def register_switch(key: str, prompt: str, enabled: bool, project: Optional[str]):
+    switches.append(Setting(key, prompt, value=enabled, project=project))
+
+
+def register_common_switch(key: str, prompt: str, enabled: bool):
     switches.append(Setting(key, prompt, value=enabled))
 
 
-def register_internal(key: str, value: any):
+def register_internal(key: str, value: Any):
     internals[key] = value
 
 
@@ -59,17 +72,20 @@ def _git_config(name: str):
     def wrap():
         proc = cmd.run("git", "config", name, capture_output=True)
         if proc is None or proc.returncode != 0:
-            return None
+            return ""
         return proc.stdout.strip()
 
     return wrap
 
 
-def move_to_front(preferred: str, values: Iterable[str]):
+def move_to_front(preferred: str, values: Iterable[Optional[str]]):
     result: List[str] = []
 
     has_preferred = False
     for value in values:
+        if value is None:
+            continue
+
         if value == preferred:
             has_preferred = True
         else:
@@ -94,7 +110,7 @@ def _enum_licenses():
     root = os.path.abspath(os.path.join(package_root, template_dir, "licenses"))
     for _, dirnames, filenames in os.walk(root):
         dirnames[:] = []
-        iter = filter(lambda x: x is not None, map(_as_mustache, filenames))
+        iter = map(_as_mustache, filenames)
         return move_to_front("MIT", iter)
     return []
 
@@ -114,11 +130,11 @@ def _get_nothing(_: SettingsType) -> StrOrBool:
 
 
 def _map(internal_key: str):
-    def impl(key: str):
+    def impl(key: StrOrBool) -> StrOrBool:
         mapped = internals.get(internal_key)
         if not isinstance(mapped, dict):
-            return None
-        return mapped.get(key)
+            return ""
+        return mapped.get(key, "")
 
     return impl
 
@@ -152,12 +168,12 @@ def _build_fixup(settings: SettingsType, fixup: str):
         value = code(settings)
 
         if result:
-            result += value
+            result = f"{result}{value}"
         else:
             result = value
 
         if verbose:
-            result += verbose
+            result = f"{result}{verbose}"
 
     return result
 
@@ -169,7 +185,7 @@ def _fixed(fixup: str):
     return wrap
 
 
-internals = {}
+internals: Dict[str, Any] = {}
 
 switches: List[Setting] = []
 
@@ -200,18 +216,21 @@ defaults: List[Setting] = [
         "INCLUDE_PREFIX",
         'Prefix for includes (as in #include "{PREFIX}/version.hpp")',
         _fixed("{PROJECT.NAME}"),
+        project="cxx",
     ),
     Setting(
         "NAME_PREFIX",
         "CMake variable name prefix",
         _fixed("{PROJECT.NAME$safe$upper}"),
+        project="cxx",
     ),
     Setting(
         "NAMESPACE",
         "C++ namespace for the project",
         _fixed("{PROJECT.NAME$safe}"),
+        project="cxx",
     ),
-    Setting("EXT", "Extension for code files", _list_ext),
+    Setting("EXT", "Extension for code files", _list_ext, project="cxx"),
     Setting("SRCDIR", "Directory for code files", "src"),
     Setting(
         "INCLUDEDIR",
@@ -219,20 +238,21 @@ defaults: List[Setting] = [
         "include",
         "{INCLUDEDIR}/{INCLUDE_PREFIX}",
         force_fix=True,
+        project="cxx",
     ),
 ]
 
 hidden: List[Setting] = [
-    Setting("EXT.cxx", fix="{EXT}"),
-    Setting("EXT.hxx", fix="{EXT.cxx$header}"),
+    Setting("EXT.cxx", fix="{EXT}", project="cxx"),
+    Setting("EXT.hxx", fix="{EXT.cxx$header}", project="cxx"),
 ]
 
 _fileext = {".cc": ".hh", ".cxx": ".hxx", ".cpp": ".hpp"}
 
 
 _filters: Dict[str, Callable[[StrOrBool], StrOrBool]] = {
-    "safe": lambda value: value.replace("-", "_"),
-    "upper": lambda value: value.upper(),
-    "lower": lambda value: value.lower(),
-    "header": lambda cxx_ext: _fileext.get(cxx_ext, ".hpp"),
+    "safe": lambda value: str(value).replace("-", "_"),
+    "upper": lambda value: str(value).upper(),
+    "lower": lambda value: str(value).lower(),
+    "header": lambda cxx_ext: _fileext.get(str(cxx_ext), ".hpp"),
 }

{proj_flow-0.9.3 → proj_flow-0.10.0}/src/proj_flow/api/env.py

@@ -24,7 +24,6 @@ from enum import Enum
 from typing import Any, Callable, Dict, List, Optional, Union, cast
 
 from proj_flow.base import plugins, uname
-from proj_flow.base.plugins import load_module_plugins
 
 platform = uname.uname()[0]
 
@@ -152,7 +151,13 @@ class FlowConfig:
             sys.path.insert(0, local_extensions)
 
         for extension in extensions:
-            importlib.import_module(extension)
+            try:
+                importlib.import_module(extension)
+            except ModuleNotFoundError:
+                print(
+                    f"-- error: module `{extension}` was no found, ignoring",
+                    file=sys.stderr,
+                )
 
     @property
     def entry(self) -> Dict[str, dict]:

{proj_flow-0.9.3 → proj_flow-0.10.0}/src/proj_flow/api/makefile.py

@@ -2,7 +2,7 @@
 # This code is licensed under MIT license (see LICENSE for details)
 
 """
-The **proj_flow.api.makefiles** exposes simple makefiles APIs, so extensions can
+The **proj_flow.api.makefile** exposes simple makefile APIs, so extensions can
 easily provide run steps with multiple scripts being called.
 """
 

{proj_flow-0.9.3 → proj_flow-0.10.0}/src/proj_flow/api/step.py

@@ -12,6 +12,7 @@ from typing import List, cast
 from proj_flow.api.env import Config, Runtime
 from proj_flow.base import inspect as _inspect
 from proj_flow.base import matrix
+from proj_flow.base.name_list import name_list
 
 
 class Step(ABC):
@@ -111,11 +112,8 @@ def _name_list(label: str, names: List[str], template="`{}`") -> str:
     if len(names) == 0:
         return ""
 
-    em = [template.format(name) for name in names]
-    prefix = ", ".join(em[:-1])
-    if prefix:
-        prefix += " and "
-    return f"\n:{label}: {prefix}{em[-1]}"
+    joined = name_list([template.format(name) for name in names])
+    return f"\n:{label}: {joined}"
 
 
 def _make_private(f: _inspect.Function):

proj_flow-0.10.0/src/proj_flow/base/name_list.py

@@ -0,0 +1,19 @@
+# Copyright (c) 2025 Marcin Zdun
+# This code is licensed under MIT license (see LICENSE for details)
+
+"""
+The **proj_flow.base.name_list** provides name list helper for arguments with
+choices
+"""
+
+from typing import List
+
+
+def name_list(names: List[str]) -> str:
+    if len(names) == 0:
+        return ""
+
+    prefix = ", ".join(names[:-1])
+    if prefix:
+        prefix += " and "
+    return f"{prefix}{names[-1]}"

proj_flow-0.10.0/src/proj_flow/base/plugins.py

@@ -0,0 +1,48 @@
+# Copyright (c) 2025 Marcin Zdun
+# This code is licensed under MIT license (see LICENSE for details)
+
+"""
+The **proj_flow.base.plugins** provide the plugin enumeration helpers.
+"""
+
+import json
+import os
+from typing import cast
+
+import yaml
+
+
+def load_yaml(filename: str):
+    with open(filename) as src:
+        return cast(dict, yaml.load(src, Loader=yaml.Loader))
+
+
+def load_json(filename: str):
+    with open(filename) as src:
+        return cast(dict, json.load(src))
+
+
+LOADERS = {
+    ".json": load_json,
+    ".yml": load_yaml,
+    ".yaml": load_yaml,
+}
+
+
+def load_data(filename: str):
+    prefix, ext = os.path.splitext(filename)
+    loader = LOADERS.get(ext.lower())
+    if loader:
+        try:
+            return loader(filename)
+        except Exception:
+            pass
+
+    for new_ext, loader in LOADERS.items():
+        new_filename = prefix + new_ext
+        try:
+            return loader(new_filename)
+        except Exception:
+            pass
+
+    return {}

{proj_flow-0.9.3 → proj_flow-0.10.0}/src/proj_flow/base/registry.py

@@ -2,10 +2,12 @@
 # This code is licensed under MIT license (see LICENSE for details)
 
 """
-The **proj_flow.base.registry**
+The **proj_flow.base.registry** allows building extension points, with ability
+to register the plugins with a decorator.
 """
 
 import typing
+from collections import OrderedDict
 
 T = typing.TypeVar("T")
 K = typing.TypeVar("K")
@@ -100,6 +102,19 @@ _debug_copies: typing.List[Registry] = []
 def verbose_info():
     for registry in _debug_copies:
         for item in registry.container:
-            print(
-                f"-- {registry.name}: adding `{item.__module__}.{item.__class__.__name__}`"
-            )
+            full_name = f"{item.__module__}.{item.__class__.__name__}"
+
+            kw = OrderedDict()
+
+            if hasattr(item, "name"):
+                kw["name"] = getattr(item, "name")
+            elif hasattr(item, "__name__"):
+                kw["name"] = getattr(item, "__name__")
+
+            if hasattr(item, "id"):
+                kw["id"] = getattr(item, "id")
+
+            items = ", ".join([f"{key}={value}" for key, value in kw.items()])
+            if len(items) > 0:
+                items = f" ({items})"
+            print(f"-- {registry.name}: adding `{full_name}`{items}")

{proj_flow-0.9.3 → proj_flow-0.10.0}/src/proj_flow/cli/__init__.py

@@ -10,10 +10,8 @@ The **proj_flow.cli** provides command-line entry for the *Project Flow*.
 import argparse
 import os
 import sys
-from pprint import pprint
-from typing import Dict, Optional, Tuple
 
-from proj_flow.api import arg, env
+from proj_flow.api import env
 from proj_flow.cli import argument, finder
 from proj_flow.flow import steps
 
@@ -31,7 +29,7 @@ def main():
 def _change_dir():
     root = argparse.ArgumentParser(
         prog="proj-flow",
-        usage="proj-flow [-h] [--version] [-C [dir]] {command} ...",
+        usage="proj-flow [-h] [--version] [-C [dir]] command ...",
         add_help=False,
     )
     root.add_argument("-C", dest="cd", nargs="?")

{proj_flow-0.9.3 → proj_flow-0.10.0}/src/proj_flow/cli/argument.py

@@ -2,7 +2,7 @@
 # This code is licensed under MIT license (see LICENSE for details)
 
 """
-The **proj_flow.cli.arguments** provides command-line builders and runners,
+The **proj_flow.cli.argument** provides command-line builders and runners,
 supporting the functions decorated with :func:`@arg.command()
 <proj_flow.api.arg.command>`.
 """
@@ -192,7 +192,7 @@ class Command:
         if len(self.children):
             subparsers = parser.add_subparsers(
                 dest=f"command_{level}",
-                metavar="{command}",
+                metavar="command",
                 help="Known command name, see below",
             )
             subparsers.parent = parser  # type: ignore
@@ -254,7 +254,7 @@ def _argparse_visit_all(
     parser.shortcuts = shortcut_configs
 
     subparsers = parser.add_subparsers(
-        dest="command", metavar="{command}", help="Known command name, see below"
+        dest="command", metavar="command", help="Known command name, see below"
     )
 
     subparsers.parent = parser  # type: ignore

{proj_flow-0.9.3/src/proj_flow/flow → proj_flow-0.10.0/src/proj_flow}/dependency.py

@@ -2,7 +2,7 @@
 # This code is licensed under MIT license (see LICENSE for details)
 
 """
-The **proj_flow.flow.dependency** verifies availabilty of Step's external tools.
+The **proj_flow.dependency** verifies availabilty of Step's external tools.
 """
 
 import re

proj_flow-0.10.0/src/proj_flow/ext/cplusplus/__init__.py

@@ -0,0 +1,10 @@
+# Copyright (c) 2025 Marcin Zdun
+# This code is licensed under MIT license (see LICENSE for details)
+
+"""
+The **proj_flow.ext.cplusplus** defines steps and commands for C++ projects.
+"""
+
+from . import cmake, conan
+
+__all__ = ["cmake", "conan"]

proj_flow-0.10.0/src/proj_flow/ext/cplusplus/cmake/__init__.py

@@ -0,0 +1,12 @@
+# Copyright (c) 2025 Marcin Zdun
+# This code is licensed under MIT license (see LICENSE for details)
+
+"""
+The **proj_flow.ext.cplusplus.cmake** provides ``"CMake"``, ``"Build"``,
+``"Pack"`` and ``"Test"`` steps, as well as CMake-specific initialization
+context.
+"""
+
+from . import context, parser, steps, version
+
+__all__ = ["context", "parser", "steps", "version"]

{proj_flow-0.9.3/src/proj_flow/plugins → proj_flow-0.10.0/src/proj_flow/ext/cplusplus}/cmake/__version__.py

@@ -1,5 +1,10 @@
 # Copyright (c) 2025 Marcin Zdun
 # This code is licensed under MIT license (see LICENSE for details)
 
+"""
+The **proj_flow.ext.cplusplus.cmake.__version__** contains only the value of
+expected version of CMake.
+"""
+
 
 CMAKE_VERSION = "3.28"