proj-flow 0.9.4__py3-none-any.whl → 0.10.0__py3-none-any.whl

proj_flow/__init__.py

@@ -1,4 +1,9 @@
 # Copyright (c) 2025 Marcin Zdun
 # This code is licensed under MIT license (see LICENSE for details)
 
-__version__ = "0.9.4"
+"""
+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/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/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/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/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/base/registry.py

@@ -7,6 +7,7 @@ to register the plugins with a decorator.
 """
 
 import typing
+from collections import OrderedDict
 
 T = typing.TypeVar("T")
 K = typing.TypeVar("K")
@@ -101,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/cli/__init__.py

@@ -29,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/cli/argument.py

@@ -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/{flow/dependency.py → 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/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"

proj_flow/ext/cplusplus/cmake/context.py

@@ -11,7 +11,8 @@ import uuid
 
 import chevron
 
-from proj_flow import api, flow
+from proj_flow import api, project
+from proj_flow.project import cplusplus
 
 from .__version__ import CMAKE_VERSION
 
@@ -49,22 +50,23 @@ class CMakeInit(api.init.InitStep):
 def _list_cmake_types():
     return api.ctx.move_to_front(
         "console-application",
-        sorted(key for key in flow.init.get_internal("cmake").keys() if key),
+        sorted(key for key in project.data.get_internal("cmake").keys() if key),
     )
 
 
 api.init.register_init_step(CMakeInit())
-api.ctx.register_init_setting(
+
+cplusplus.project.register_init_setting(
     api.ctx.Setting("PROJECT.TYPE", "CMake project type", _list_cmake_types)
 )
-api.ctx.register_init_setting(
+cplusplus.project.register_init_setting(
     api.ctx.Setting("cmake", fix="{PROJECT.TYPE$map:cmake}"),
     api.ctx.Setting("CMAKE_VERSION", value=CMAKE_VERSION),
     api.ctx.Setting("PROJECT.WIX.UPGRADE_GUID", value=lambda: str(uuid.uuid4())),
     is_hidden=True,
 )
-api.ctx.register_switch("with_cmake", "Use CMake", True)
-api.ctx.register_internal(
+cplusplus.project.register_switch("with_cmake", "Use CMake", True)
+cplusplus.project.register_internal(
     "cmake",
     {
         "": {"cmd": "add_executable", "type": ""},

proj_flow/ext/cplusplus/conan/__init__.py

@@ -9,7 +9,8 @@ import os
 import textwrap
 from typing import List
 
-from proj_flow.api import ctx, env, step
+from proj_flow.api import env, step
+from proj_flow.project import cplusplus
 
 from ._conan import conan_api
 
@@ -64,4 +65,6 @@ class ConanConfig:
         return 0
 
 
-ctx.register_switch("with_conan", "Use Conan for dependency manager", True)
+cplusplus.project.register_switch(
+    "with_conan", "Use Conan for dependency manager", True
+)

proj_flow/ext/cplusplus/conan/_conan.py

@@ -13,7 +13,7 @@ from typing import Callable, List, cast
 
 from proj_flow.api.env import Config, Runtime
 from proj_flow.base import cmd
-from proj_flow.flow.dependency import VER_REGEX
+from proj_flow.dependency import VER_REGEX
 
 
 class conan(ABC):

proj_flow/ext/github/cli.py

@@ -16,22 +16,13 @@ import typing
 
 from proj_flow import log
 from proj_flow.api import arg, env
+from proj_flow.base.name_list import name_list
 from proj_flow.flow.configs import Configs
 from proj_flow.log import commit, hosting, rich_text
 
 FORCED_LEVEL_CHOICES = list(commit.FORCED_LEVEL.keys())
 
 
-def _name_list(names: typing.List[str]) -> str:
-    if len(names) == 0:
-        return ""
-
-    prefix = ", ".join(names[:-1])
-    if prefix:
-        prefix += " and "
-    return f"{prefix}{names[-1]}"
-
-
 @arg.command("github")
 def github():
     """Interact with GitHub workflows and releases"""
@@ -81,7 +72,7 @@ def release(
         typing.Optional[str],
         arg.Argument(
             help="Ignore the version change from changelog and instead use this value. "
-            f"Allowed values are: {_name_list(FORCED_LEVEL_CHOICES)}",
+            f"Allowed values are: {name_list(FORCED_LEVEL_CHOICES)}",
             meta="level",
             choices=FORCED_LEVEL_CHOICES,
         ),

proj_flow/ext/github/switches.py

@@ -7,7 +7,7 @@ projects.
 
 from proj_flow.api import ctx
 
-ctx.register_switch("with_github_actions", "Use Github Actions", True)
-ctx.register_switch(
+ctx.register_common_switch("with_github_actions", "Use Github Actions", True)
+ctx.register_common_switch(
     "with_github_social", "Use Github ISSUE_TEMPLATE, CONTRIBUTING.md, etc.", True
 )

proj_flow/flow/__init__.py

@@ -6,6 +6,6 @@ The **proj_flow.flow** contains the inner workings of various *Project Flow*
 components.
 """
 
-from . import configs, dependency, init, interact, layer, steps
+from . import configs, layer, steps
 
-__all__ = ["configs", "dependency", "init", "interact", "layer", "steps"]
+__all__ = ["configs", "layer", "steps"]

proj_flow/minimal/base.py

@@ -26,5 +26,6 @@ api.init.register_init_step(GitInit())
 api.ctx.register_init_setting(
     api.ctx.Setting("__flow_version__", value=__version__),
     api.ctx.Setting("${", value="${"),
+    project=None,
     is_hidden=True,
 )

proj_flow/minimal/init.py

@@ -10,12 +10,36 @@ import os
 import sys
 from typing import Annotated, Optional
 
-from proj_flow import flow
+import yaml
+
+from proj_flow import dependency, flow
 from proj_flow.api import arg, ctx, env, init
+from proj_flow.base.name_list import name_list
+from proj_flow.project import api, interact
+
+
+def _project_types():
+    return list(map(lambda proj: proj.id, api.project_type.get()))
+
+
+def _project_help():
+    return (
+        "Type of project to create. "
+        f"Allowed values are: {name_list(_project_types())}"
+    )
 
 
 @arg.command("init")
 def main(
+    project: Annotated[
+        str,
+        arg.Argument(
+            help=_project_help,
+            meta="project",
+            pos=True,
+            choices=_project_types,
+        ),
+    ],
     path: Annotated[
         Optional[str],
         arg.Argument(
@@ -38,26 +62,35 @@ def main(
 ):
     """Initialize new project"""
 
+    try:
+        current_project = api.get_project_type(project)
+    except api.ProjectNotFound:
+        print(f"proj-flow init: error: project type `{project}` is not known")
+        return 1
+
     if path is not None:
         os.makedirs(path, exist_ok=True)
         os.chdir(path)
 
-    errors = flow.dependency.verify(flow.dependency.gather(init.__steps))
+    errors = dependency.verify(dependency.gather(init.__steps))
     if len(errors) > 0:
         if not rt.silent:
             for error in errors:
                 print(f"proj-flow: {error}", file=sys.stderr)
         return 1
 
-    context = flow.init.fixup(
-        flow.init.all_default() if non_interactive else flow.interact.prompt()
-    )
+    context = current_project.get_context(not non_interactive)
     if not non_interactive and not rt.silent:
         print()
 
-    if save_context:
-        with open(".context.json", "w", encoding="UTF-8") as jsonf:
-            json.dump(context, jsonf, ensure_ascii=False, indent=4)
+    if save_context and rt.verbose:
+        lines = yaml.dump(context, indent=4).rstrip().split("\n")
+        for line in lines:
+            rt.message("[CONTEXT]", line)
+
+    if save_context and not rt.dry_run:
+        with open(".context.yaml", "w", encoding="UTF-8") as jsonf:
+            yaml.dump(context, jsonf, indent=4)
 
     flow.layer.copy_license(rt, context)
     if not rt.silent:
@@ -67,9 +100,9 @@ def main(
     for fs_layer in layers:
         fs_layer.run(rt, context)
 
-    if save_context:
+    if save_context and not rt.dry_run:
         with open(".gitignore", "ab") as ignoref:
-            ignoref.write("\n/.context.json\n".encode("UTF-8"))
+            ignoref.write("\n/.context.yaml\n".encode("UTF-8"))
 
     for step in init.__steps:
         step.postprocess(rt, context)

proj_flow/minimal/run.py

@@ -11,9 +11,8 @@ import sys
 from contextlib import contextmanager
 from typing import Annotated, List, Optional, Set, cast
 
-from proj_flow import api
+from proj_flow import api, dependency
 from proj_flow.base import matrix
-from proj_flow.flow import dependency
 from proj_flow.flow.configs import Configs
 
 

proj_flow/project/__init__.py

@@ -0,0 +1,11 @@
+# Copyright (c) 2025 Marcin Zdun
+# This code is licensed under MIT license (see LICENSE for details)
+
+"""
+The **proj_flow.project** contains the inner workings of ``proj-flow init``
+command.
+"""
+
+from . import api, cplusplus, data, interact
+
+__all__ = ["api", "cplusplus", "data", "interact"]

proj_flow/project/api.py

@@ -0,0 +1,51 @@
+# Copyright (c) 2025 Marcin Zdun
+# This code is licensed under MIT license (see LICENSE for details)
+
+"""
+The **proj_flow.project.api** defines an extension point for project suites.
+"""
+
+from abc import ABC, abstractmethod
+from typing import Any, List, NamedTuple, Optional
+
+from proj_flow import base
+from proj_flow.api import ctx
+from proj_flow.project import interact
+
+
+class ProjectType(ABC):
+    name: str
+    id: str
+
+    def __init__(self, name: str, id: str):
+        self.name = name
+        self.id = id
+
+    def register_switch(self, key: str, prompt: str, enabled: bool):
+        ctx.register_switch(key, prompt, enabled, self.id)
+
+    def register_internal(self, key: str, value: Any):
+        ctx.register_internal(key, value)
+
+    def register_init_setting(self, *settings: ctx.Setting, is_hidden=False):
+        ctx.register_init_setting(*settings, is_hidden=is_hidden, project=self.id)
+
+    def get_context(self, interactive: bool):
+        return interact.get_context(interactive, self.id)
+
+
+project_type = base.registry.Registry[ProjectType]("ProjectType")
+
+
+class ProjectNotFound(Exception):
+    name: str
+
+    def __init__(self, name: str):
+        self.name = name
+
+
+def get_project_type(id: str):
+    result, _ = project_type.find(lambda proj: proj.id == id)
+    if result is None:
+        raise ProjectNotFound(id)
+    return result

proj_flow/project/cplusplus.py

@@ -0,0 +1,17 @@
+# Copyright (c) 2025 Marcin Zdun
+# This code is licensed under MIT license (see LICENSE for details)
+
+"""
+The **proj_flow.project.cplusplus** registers a ``"C++"`` projects support.
+"""
+
+from proj_flow.project import api
+
+
+@api.project_type.add
+class CPlusPlus(api.ProjectType):
+    def __init__(self):
+        super().__init__("C++ + CMake + Conan", "cxx")
+
+
+project = api.get_project_type("cxx")

proj_flow/project/data.py

@@ -0,0 +1,14 @@
+# Copyright (c) 2025 Marcin Zdun
+# This code is licensed under MIT license (see LICENSE for details)
+
+"""
+The **proj_flow.project.data** supports the ``init`` command.
+"""
+
+from typing import Any
+
+from proj_flow.api import ctx
+
+
+def get_internal(key: str, value: Any = None):
+    return ctx.internals.get(key, value)

proj_flow/{flow → project}/interact.py

@@ -2,15 +2,16 @@
 # This code is licensed under MIT license (see LICENSE for details)
 
 """
-The **proj_flow.flow.interact** provides initialization context through user
-prompts.
+The **proj_flow.project.interact** provides initialization context through
+user prompts.
 """
 
 from dataclasses import dataclass
-from typing import List, Union
+from typing import Callable, List, Optional, Union
 
 from prompt_toolkit import prompt as tk_prompt
 from prompt_toolkit.completion import WordCompleter
+from prompt_toolkit.formatted_text.base import AnyFormattedText
 from prompt_toolkit.shortcuts import CompleteStyle
 from prompt_toolkit.validation import Validator
 
@@ -39,7 +40,7 @@ class _Question:
     def ps(self):
         return self.prompt or f'"{self.key}"'
 
-    def _ps(self, default: ctx.Values, counter: int, size: int):
+    def _ps(self, default: ctx.Values, counter: int, size: int) -> AnyFormattedText:
         if default:
             if isinstance(default, str):
                 return [
@@ -89,7 +90,7 @@ class _Question:
 
     def _tk_prompt(
         self,
-        defaults: Union[bool | List[str]],
+        defaults: Union[bool, List[str]],
         words: List[str],
         counter: int,
         size: int,
@@ -108,27 +109,127 @@ class _Question:
         )
 
 
-def prompt() -> ctx.SettingsType:
-    """
-    Prompts user to provide details of newly-crated project.
+def _project_filter(project: Optional[str]):
+    if project is None:
 
-    :returns: Dictionary with answers to all interactive settings and switches.
-    """
+        def impl(setting: ctx.Setting):
+            return setting.project is None
+
+        return impl
+
+    def impl(setting: ctx.Setting):
+        return setting.project is None or setting.project == project
+
+    return impl
+
+
+def _prompt(wanted: Callable[[ctx.Setting], bool]) -> ctx.SettingsType:
     settings: ctx.SettingsType = {}
 
-    size = len(ctx.defaults) + len(ctx.switches)
+    defaults = [setting for setting in ctx.defaults if wanted(setting)]
+    switches = [setting for setting in ctx.switches if wanted(setting)]
+
+    size = len(defaults) + len(switches)
     counter = 1
 
-    for setting in ctx.defaults:
+    for setting in defaults:
         loaded = _Question.load_default(setting, settings)
         value = loaded.interact(counter, size)
         settings[loaded.key] = value
         counter += 1
 
-    for setting in ctx.switches:
+    for setting in switches:
         loaded = _Question.load_default(setting, settings)
         value = loaded.interact(counter, size)
         settings[loaded.key] = value
         counter += 1
 
     return settings
+
+
+def _all_default(wanted: Callable[[ctx.Setting], bool]):
+    """
+    Chooses default answers for all details of newly-crated project.
+
+    :returns: Dictionary with default values of all interactive settings
+        and switches.
+    """
+
+    settings: ctx.SettingsType = {}
+
+    defaults = [setting for setting in ctx.defaults if wanted(setting)]
+    switches = [setting for setting in ctx.switches if wanted(setting)]
+
+    for setting in defaults:
+        value = _get_default(setting, settings)
+        settings[setting.json_key] = value
+
+    for setting in switches:
+        value = _get_default(setting, settings)
+        settings[setting.json_key] = value
+
+    return settings
+
+
+def _fixup(settings: ctx.SettingsType, key: str, fixup: str, force=False):
+    value = settings.get(key, "")
+    if value != "" and not force:
+        return
+
+    value = ctx._build_fixup(settings, fixup)
+    settings[key] = value
+
+
+def _get_default(setting: ctx.Setting, settings: ctx.SettingsType):
+    value = setting.calc_value(settings)
+    if isinstance(value, list):
+        return value[0]
+    return value
+
+
+def _fixup_context(settings: ctx.SettingsType, wanted: Callable[[ctx.Setting], bool]):
+    defaults = [setting for setting in ctx.defaults if wanted(setting)]
+    hidden = [setting for setting in ctx.hidden if wanted(setting)]
+
+    for setting in hidden:
+        value = _get_default(setting, settings)
+        if isinstance(value, bool) or value != "":
+            settings[setting.json_key] = value
+
+    for coll in [defaults, hidden]:
+        for setting in coll:
+            _fixup(settings, setting.json_key, setting.fix or "", setting.force_fix)
+
+    try:
+        del settings["EXT"]
+    except KeyError:
+        pass
+
+    result = {}
+    for key in settings:
+        path = key.split(".")
+        path_ctx = result
+        for step in path[:-1]:
+            if step not in path_ctx or not isinstance(path_ctx[step], dict):
+                path_ctx[step] = {}
+            path_ctx = path_ctx[step]
+        path_ctx[path[-1]] = settings[key]
+    return result
+
+
+def get_context(interactive: bool, project: Optional[str]):
+    """
+    Prompts user to provide details of newly-crated project. If `interactive`
+    is true, however, this functions skips the prompts and chooses all the
+    default answers.
+
+    :param interactive: Selects, if the initialization process is done through
+        prompts, or not
+
+    :returns: Dictionary with answers to all interactive settings and switches.
+    """
+
+    wanted = _project_filter(project)
+    return _fixup_context(
+        _all_default(wanted) if not interactive else _prompt(wanted), wanted
+    )

{proj_flow-0.9.4.dist-info → proj_flow-0.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proj-flow
-Version: 0.9.4
+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/
@@ -76,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.4.dist-info → proj_flow-0.10.0.dist-info}/RECORD

@@ -1,23 +1,25 @@
-proj_flow/__init__.py,sha256=mb_RaqBK8YLjzInbWdxN7mBDJZ3gqbzxfnHEXvzXbTw,124
+proj_flow/__init__.py,sha256=cd3hxTcDnlv9Qd6qQYRRa3g7bs5iuMrPJtfF_ENzMTY,277
 proj_flow/__main__.py,sha256=HUar_qQ9Ndmchmryegtzu__5wukwCLrFN_SGRl5Ol_M,233
+proj_flow/dependency.py,sha256=CpcnR6El8AO9hlLc9lQtYQADYlkx3GMHlkLYbEAtdMI,4639
 proj_flow/api/__init__.py,sha256=gV2f6kll_5JXtvkGASvnx7CbOWr34PHOdck-4ce-qEk,378
-proj_flow/api/arg.py,sha256=J7_53noW7t8VJ9sfJiX4qaPs7KqWfMHNcrWYe1jIq-g,4097
+proj_flow/api/arg.py,sha256=id08mLFVDWIvsrhEaPuJfng27f92Vf8pIA5VajyjGVo,4802
 proj_flow/api/completers.py,sha256=NapNVu6QAQ_iF6dqcAzOV5kDHKD9MAMVX209Bklq-Mw,2464
-proj_flow/api/ctx.py,sha256=AXZSnfLO9w7Uiqa8VtrTzLnNegVZru2sn1-WON3RIyg,5847
+proj_flow/api/ctx.py,sha256=IJu0q0Chivo6b2M4MKkAlV09oi7Cn9VxtDFeAeL_tnc,6646
 proj_flow/api/env.py,sha256=4VvSkfA2k6OPrtvkPtEPhb24dDyaqbUoqSznIgvAXNg,11082
 proj_flow/api/init.py,sha256=an0czDiPCDqW4Bp0I8sGQgaAlDAozLO0ZYnP149lWqk,521
 proj_flow/api/makefile.py,sha256=AxtGOvmypBtSvoyMEDJq1bGoaVD5yW9YYRZSdunUEeg,3856
 proj_flow/api/release.py,sha256=A-t4qcjeaptEgfBCZs2Q9cOjsGACrNM0CzmCorms0U4,2401
-proj_flow/api/step.py,sha256=PAqLBkQkUVQETrBvHjI6_-PAkh4Q7KLPMBUOWqW_jbk,4580
+proj_flow/api/step.py,sha256=AOqe1wXYnU_O3pD5KlzfyyOm_D9fcF_4vyhhr1w-NrI,4561
 proj_flow/base/__init__.py,sha256=RRmqiYjdVlC4i8QijXHNiRh9yzNH8305WXezrSaPjKk,311
 proj_flow/base/cmd.py,sha256=Vo3e8kd4CHRzbsUkO-MnbhQxjLXTczv7YQRUkFlcBQE,1560
 proj_flow/base/inspect.py,sha256=lt5P19rvSZ-wMCTrCYAaQFCt2S9fUjEQXlrKK-Tmvwc,2786
 proj_flow/base/matrix.py,sha256=8XBFGYOwW6Myt_4h3WNk36V2bJ5xeqUv6DvzF4B3q_g,7767
+proj_flow/base/name_list.py,sha256=KiHSnbDgYplJc25O3EehYhFAhD7Z3mHVAK6UYOdg5PQ,416
 proj_flow/base/plugins.py,sha256=evn2Dym_NeoBaIZAu2YUtRd--15PCFpHD0h5zSsWkQE,978
-proj_flow/base/registry.py,sha256=oRLGY1QLY306KLEXJU-p5kmTKQPM7xgRpaajdCFg0OQ,3022
+proj_flow/base/registry.py,sha256=C04Imxux_BO7DffZZth28iFLPnM4Yw9K7IGt06VokE0,3528
 proj_flow/base/uname.py,sha256=7Awb3Es0jTAKMpyRawdrC16xc5X9M97BlPqEfQibqIk,2295
-proj_flow/cli/__init__.py,sha256=__5sdeicDv3HBEREPwY2FAbLNcI5x8bUDJqmkhH6HJ0,1198
-proj_flow/cli/argument.py,sha256=KnBRmnHfBQHF_rDxtE8HEa01QMIagBxxImq-jGClynE,13690
+proj_flow/cli/__init__.py,sha256=cMsZpECkXeSzY4Hv_ela3Ou-FhwE5w1A3ypMSnZZikM,1196
+proj_flow/cli/argument.py,sha256=OCx_Z0NVm4bmHI30WFdtPdqVMdDnvkqqluhAgP7Ya0w,13686
 proj_flow/cli/finder.py,sha256=5x7H1nH0k63DetDauhB_wABel_f0RQpsZ5YnhPfbkRc,1402
 proj_flow/ext/__init__.py,sha256=XD52rUFTPz3GnyRq6KZUNeWdMce7e0bB19iTx-zU6DE,169
 proj_flow/ext/markdown_changelog.py,sha256=fRGL09jojnv2B-8vAX2prvgNp8e7uyq5NxboSZjFCJ8,436
@@ -25,17 +27,17 @@ proj_flow/ext/re_structured_changelog.py,sha256=UF23W9eu_YgPO42MiaoDbEKu8In_48mQ
 proj_flow/ext/store.py,sha256=yfyIb2G7UhoIkPmVDnp1RPx2fwFZK8FyLZzrMvPlEUM,3681
 proj_flow/ext/cplusplus/__init__.py,sha256=dAmLMyGVQq586jJM_jiAuo5Ecw9U8agpvSRbzzPgh3g,245
 proj_flow/ext/cplusplus/cmake/__init__.py,sha256=f-_gTY_XpIfcKrAj0jhT57DBGeifkW2s7NlSxjpHTMg,366
-proj_flow/ext/cplusplus/cmake/__version__.py,sha256=tmRnT4aUpx4_h-vyWsGyVEeahW49VlLqlsd-o7irmKY,126
-proj_flow/ext/cplusplus/cmake/context.py,sha256=5RPpc0tquh7xDO1_ifgnIdxCbabuZeW-Yw7QjpeazUo,3085
+proj_flow/ext/cplusplus/cmake/__version__.py,sha256=imja0GnhpBvS8Crz-64eOUKhc4i6FeRrjBGRB68x_p0,239
+proj_flow/ext/cplusplus/cmake/context.py,sha256=BJDMRuIvCEXR577yWuYSw-wzQ9PQudpXjnIxo1gKHBU,3172
 proj_flow/ext/cplusplus/cmake/parser.py,sha256=ZqQRZqS_VU5VtC8uwax-dknh7sfuLEvtazG8ChSqHDQ,3814
 proj_flow/ext/cplusplus/cmake/steps.py,sha256=Q7HcVlMbKOwrRj-Sms0W7FS027M_shM7s2FJx6rX4KQ,4100
 proj_flow/ext/cplusplus/cmake/version.py,sha256=E0PAUdO9Wg02pxtU4LWYTNoTB-9Oer3Y9zr1lR2zvgw,962
-proj_flow/ext/cplusplus/conan/__init__.py,sha256=Ohcx5DpvI9X3uEhkzcb85otqZPRGqeWw8Mc5HeVvjgs,1967
-proj_flow/ext/cplusplus/conan/_conan.py,sha256=c3rVi4WdmhsO8eqxG2xG4vzgagnOx1HDUOPl3bWxkD0,3357
+proj_flow/ext/cplusplus/conan/__init__.py,sha256=1WmGMY1hhvJdHsXfHg5MjA8g6qL3H2FABsK0TLBigCI,2022
+proj_flow/ext/cplusplus/conan/_conan.py,sha256=9xnji-f8uN7huXLqavVBUDC33CgnjBIyZX6wVcGm2RA,3352
 proj_flow/ext/github/__init__.py,sha256=Mgx19YS6SYBXYB66_pOgIgwuB2WKRxqp5UGutq0B9Xk,282
-proj_flow/ext/github/cli.py,sha256=tOo65gZR1JRuitQdbs4i9lG0pxlWRXy2bmsaIbfOyUo,4091
+proj_flow/ext/github/cli.py,sha256=zQS2TB7fDeY0VwR1bOw065Trz2NPe07JKcFQaJbwKGg,3934
 proj_flow/ext/github/hosting.py,sha256=3iW8QjeJk7MyqKNbv92nB-5a_Yn_B5_eEIlw_cdgUT0,519
-proj_flow/ext/github/switches.py,sha256=Sv5NxTOzwatrhCanKM3siKI-NcH9Cwloe-ohWLnIuWg,407
+proj_flow/ext/github/switches.py,sha256=g7O2hvrg4mHm3WSHYsRBhEDU0bIkEJgp4Qclhqxk0uI,421
 proj_flow/ext/python/__init__.py,sha256=GbEKEJJZ3PJ4sRHEykAWjGIR6yyyrYdlUFulldvsAGI,252
 proj_flow/ext/python/rtdocs.py,sha256=idm6DTUnbA18L-EpxQiFVXCz9x8AIRSb52ZPqIXzrf8,6354
 proj_flow/ext/python/steps.py,sha256=pDHGAe_CDzzdRFAzM1AIBvkbc14KB3SNUunusKZAaaY,1815
@@ -43,11 +45,8 @@ proj_flow/ext/python/version.py,sha256=pnyuKATyZwBh1p0gf9KmqbRSZx8hJ5285CiFK_tHE
 proj_flow/ext/sign/__init__.py,sha256=yvXpqLdvBwkB0GDBl4yWw--iZ2tFxhx-97EP9OAzx2g,4345
 proj_flow/ext/sign/api.py,sha256=dlnXYYoBDYXx_WWGBQ8ThKmEMYmw2kt6NNZA8j-MXuM,2288
 proj_flow/ext/sign/win32.py,sha256=fV8_Z42KaeDBEf3_5qCzlALb0dy1zN0Pqy8Hr-ZMAQ4,4874
-proj_flow/flow/__init__.py,sha256=Y1MfQsrbk_dIT6pn7c9YIlqsEUZj4Q9n_oIGtbnhIP4,339
+proj_flow/flow/__init__.py,sha256=5Zo97zJsR7HMbl64jeMB9PbUuxCxpOlNuLmo3apWSVU,277
 proj_flow/flow/configs.py,sha256=l-pIotrXFm4oMqqpuvKP-RdtlTmDDnK_izhTJfsWbhk,5260
-proj_flow/flow/dependency.py,sha256=5o_-5Soc2e1tOu5mwvkXa6jqDFplZi_chN8edkR6vVY,4644
-proj_flow/flow/init.py,sha256=9k3cgVmmeOKtH6mJ0nc4IOmI48oXvtYXFYWx2rj60-M,1777
-proj_flow/flow/interact.py,sha256=AJknpCxk3C39GhsR6BjH5QDk33KouWCZbHEUFLjvfGc,4166
 proj_flow/flow/layer.py,sha256=6mvbhiOy9KcMP69Q9zew_7jGhf5Wqr7v-veS3YPGnmc,5720
 proj_flow/flow/steps.py,sha256=PN_C_B6vNvqOsjpDpa5ESvH30Sc6RM1fSSqWqXgqg-4,2804
 proj_flow/log/__init__.py,sha256=02EIgasE-K7mmbbNiIdX0IebWQMp2Co_D6H4ZBhJgcs,365
@@ -64,12 +63,17 @@ proj_flow/log/rich_text/api.py,sha256=PCSAGwkmDUMoVlpN7BDsgIA1AiMZEC0H6TUZXpr_Mg
 proj_flow/log/rich_text/markdown.py,sha256=jBnNxxhBHzyIZ3Y4HXDfqpl7zlRbbKbKdwdnZwkmNAI,1623
 proj_flow/log/rich_text/re_structured_text.py,sha256=DEl9KjBUF6cxfNWpQ7GVnHi7wKeuFnPGJwxQxjbCsnM,1823
 proj_flow/minimal/__init__.py,sha256=NglaSdKiMebrOqfsqF9ctqi0ZwiiBHOQcUnp3DS8lP0,340
-proj_flow/minimal/base.py,sha256=-J9aEU1R7tJY7hgcODB2o37CYi7v3iWUztuZ2IZF5cQ,740
+proj_flow/minimal/base.py,sha256=yJR3FAigR_x8krTQ1UeifBb4AnLUZAk6LfVVqB_RFO4,758
 proj_flow/minimal/bootstrap.py,sha256=PcZfBsUmj8uDPGBC55iUgD5O7W4VSkpCQb6r9GEyAaQ,556
-proj_flow/minimal/init.py,sha256=3AhICGKG8ZScMG1aVlNOXXM1pGOXayqW9AOmgsYbNAs,2081
+proj_flow/minimal/init.py,sha256=YFAsD_wGypGxweEFrbAbCdGptV1jQ2OdxUseUPi-3C8,2945
 proj_flow/minimal/list.py,sha256=RlOqammE8olNKXsnbv1enF5uriu0MZ2wFbht37Z2ETw,4810
-proj_flow/minimal/run.py,sha256=fkirdYeWb36SFXqIq5NQEflIv0HdjNhaTpmsutzWwXA,4691
+proj_flow/minimal/run.py,sha256=4qvGLqz2ayCZDvVBrq4tG094fjfcmDPon-xcGPQkM_U,4665
 proj_flow/minimal/system.py,sha256=9FliH5TD103JYSAe2O5EU7hkOHDgVzTqu0Exxk-WrXE,1579
+proj_flow/project/__init__.py,sha256=AROrwhbuMR5rJE-HC769eL4IXrMLQYpQb3HgpkOAYqg,293
+proj_flow/project/api.py,sha256=xQ3eFcxgLfi6ZAGs2q_1V0uHTpM7v9gsb7Ie2o2z-v8,1358
+proj_flow/project/cplusplus.py,sha256=GXHXI4cdrSm0jWTr2g9dCBgeFS1G4g2fC9WCv6ILn0c,398
+proj_flow/project/data.py,sha256=TluhBDoJEYL4dnyTpInmhQ49Uvf8mkWmpU-YMLQPNhE,317
+proj_flow/project/interact.py,sha256=DgclUNeY6K146QQe510tdHcYnZmWmQZ0xH9w4HifLTU,7235
 proj_flow/template/layers/base.json,sha256=jrlby8FUUwkx4V_EGMix_pkQlWcUCVUgmeoapZaZnt4,3
 proj_flow/template/layers/cmake.json,sha256=KJe9uqTDoGm0ppdNOtniKEv30iNV2K4Yk8hZQetEZ7Y,385
 proj_flow/template/layers/conan.json,sha256=mAhDrxCtDjI_7Rbtr2hlNW5_jZkLdWLiwgfuhRsRuuw,29
@@ -124,8 +128,8 @@ proj_flow/template/licenses/MIT.mustache,sha256=NncPoQaNsuy-WmRmboik3fyhJJ8m5pc2
 proj_flow/template/licenses/Unlicense.mustache,sha256=awOCsWJ58m_2kBQwBUGWejVqZm6wuRtCL2hi9rfa0X4,1211
 proj_flow/template/licenses/WTFPL.mustache,sha256=lvF4V_PrKKfZPa2TC8CZo8tlqaKvs3Bpv9G6XsWWQ4k,483
 proj_flow/template/licenses/Zlib.mustache,sha256=uIj-mhSjes2HJ3rRapyy2ALflKRz4xQgS4mVM9827C0,868
-proj_flow-0.9.4.dist-info/METADATA,sha256=xubfKNSwQpIkuu3Mugzwed5kdO3XhraoEIctZs0ppOI,2863
-proj_flow-0.9.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-proj_flow-0.9.4.dist-info/entry_points.txt,sha256=d_OmGKZzpY7FCWz0sZ4wnBAPZC75oMEzTgJZWtpDELo,49
-proj_flow-0.9.4.dist-info/licenses/LICENSE,sha256=vpOQJ5QlrTedF3coEWvA4wJzVJH304f66ZitR7Od4iU,1068
-proj_flow-0.9.4.dist-info/RECORD,,
+proj_flow-0.10.0.dist-info/METADATA,sha256=bQUtOSHQevlBQB43X1xui_BfX4KBey_TwIYx_tUNx1Q,2868
+proj_flow-0.10.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+proj_flow-0.10.0.dist-info/entry_points.txt,sha256=d_OmGKZzpY7FCWz0sZ4wnBAPZC75oMEzTgJZWtpDELo,49
+proj_flow-0.10.0.dist-info/licenses/LICENSE,sha256=vpOQJ5QlrTedF3coEWvA4wJzVJH304f66ZitR7Od4iU,1068
+proj_flow-0.10.0.dist-info/RECORD,,

proj_flow/flow/init.py

@@ -1,65 +0,0 @@
-# Copyright (c) 2025 Marcin Zdun
-# This code is licensed under MIT license (see LICENSE for details)
-
-"""
-The **proj_flow.flow.init** supports the ``init`` command.
-"""
-
-from proj_flow.api import ctx
-
-
-def _fixup(settings: ctx.SettingsType, key: str, fixup: str, force=False):
-    value = settings.get(key, "")
-    if value != "" and not force:
-        return
-
-    value = ctx._build_fixup(settings, fixup)
-    settings[key] = value
-
-
-def _get_default(setting: ctx.Setting, settings: ctx.SettingsType):
-    value = setting.calc_value(settings)
-    if isinstance(value, list):
-        return value[0]
-    return value
-
-
-def all_default():
-    settings: ctx.SettingsType = {}
-
-    for setting in ctx.defaults:
-        value = _get_default(setting, settings)
-        settings[setting.json_key] = value
-
-    for setting in ctx.switches:
-        value = _get_default(setting, settings)
-        settings[setting.json_key] = value
-
-    return settings
-
-
-def fixup(settings: ctx.SettingsType):
-    for setting in ctx.hidden:
-        value = _get_default(setting, settings)
-        if isinstance(value, bool) or value != "":
-            settings[setting.json_key] = value
-
-    for coll in [ctx.defaults, ctx.hidden]:
-        for setting in coll:
-            _fixup(settings, setting.json_key, setting.fix or "", setting.force_fix)
-    del settings["EXT"]
-
-    result = {}
-    for key in settings:
-        path = key.split(".")
-        path_ctx = result
-        for step in path[:-1]:
-            if step not in path_ctx or not isinstance(path_ctx[step], dict):
-                path_ctx[step] = {}
-            path_ctx = path_ctx[step]
-        path_ctx[path[-1]] = settings[key]
-    return result
-
-
-def get_internal(key: str, value: any = None):
-    return ctx.internals.get(key, value)