dev-shell 0.10.2__tar.gz → 0.11.1__tar.gz

{dev_shell-0.10.2 → dev_shell-0.11.1}/.gitignore

@@ -1,11 +1,4 @@
 .*
-*.egg-info
-__pycache__
-/dist/
-/build/
-/coverage.*
-*.orig
-
 !.github
 !.run
 !.editorconfig
@@ -13,3 +6,13 @@ __pycache__
 !.pre-commit-config.yaml
 !.pre-commit-hooks.yaml
 !.gitkeep
+
+*.egg-info
+__pycache__
+/dist/
+/build/
+/coverage.*
+*.orig
+
+# This is a library, not an application — consumers manage their own lock file
+uv.lock

{dev_shell-0.10.2 → dev_shell-0.11.1}/.pre-commit-config.yaml

@@ -2,6 +2,6 @@
 # See https://pre-commit.com for more information
 repos:
   - repo: https://github.com/jedie/cli-base-utilities
-    rev: v0.28.0
+    rev: v0.30.0
     hooks:
       - id: update-readme-history

{dev_shell-0.10.2 → dev_shell-0.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dev-shell
-Version: 0.10.2
+Version: 0.11.1
 Summary: Developer shell for easy startup...
 Project-URL: Documentation, https://github.com/jedie/dev-shell
 Project-URL: Source, https://github.com/jedie/dev-shell
@@ -57,14 +57,14 @@ The output looks like:
 
 [comment]: <> (✂✂✂ auto generated main help start ✂✂✂)
 ```
+Cmd2 Commands
+─────────────
+alias  help  history  macro  quit  set  shortcuts
+
 dev-shell commands
 ──────────────────
 coverage        install             publish    test    version
 fix_code_style  list_venv_packages  pyupgrade  update
-
-Uncategorized Commands
-──────────────────────
-alias  help  history  macro  quit  set  shortcuts
 ```
 [comment]: <> (✂✂✂ auto generated main help end ✂✂✂)
 
@@ -88,19 +88,32 @@ See also:
 
 [comment]: <> (✂✂✂ auto generated history start ✂✂✂)
 
+* [v0.11.1](https://github.com/jedie/dev-shell/compare/v0.11.0...v0.11.1)
+  * 2026-06-11 - fix _print_info() if Path instance pass as arguments
+* [v0.11.0](https://github.com/jedie/dev-shell/compare/v0.10.2...v0.11.0)
+  * 2026-06-11 - Remove uv.lock from this repo: It's a library not a project
+  * 2026-06-11 - nox: reuse venv
+  * 2026-06-11 - NEW: CategorizedCommandSet replacement for @cmd2.with_default_category()
+  * 2026-06-11 - fix linting
+  * 2026-06-11 - Update requirements
+  * 2026-05-29 - Bump uv from 0.11.6 to 0.11.15
+  * 2026-04-10 - Bump uv from 0.10.4 to 0.11.6
+  * 2026-04-08 - Bump cryptography from 46.0.6 to 46.0.7
+  * 2026-03-30 - Bump pygments from 2.19.2 to 2.20.0
+  * 2026-03-29 - Bump cryptography from 46.0.5 to 46.0.6
 * [v0.10.2](https://github.com/jedie/dev-shell/compare/v0.10.1...v0.10.2)
   * 2026-02-19 - apply manageprojects updates
   * 2026-02-19 - Bugfix colorful helpers if a Path instance should be printed.
 * [v0.10.1](https://github.com/jedie/dev-shell/compare/v0.10.0...v0.10.1)
   * 2026-02-10 - Bugfix text color styles
+
+<details><summary>Expand older history entries ...</summary>
+
 * [v0.10.0](https://github.com/jedie/dev-shell/compare/v0.9.1...v0.10.0)
   * 2026-02-10 - Cleanup
   * 2026-02-09 - Update project
 * [v0.9.1](https://github.com/jedie/dev-shell/compare/v0.9.0...v0.9.1)
   * 2025-03-11 - Fix usage as package in external projects
-
-<details><summary>Expand older history entries ...</summary>
-
 * [v0.9.0](https://github.com/jedie/dev-shell/compare/v0.8.0...v0.9.0)
   * 2025-03-11 - fix publish
   * 2025-03-11 - Replace `poetry` with `uv`

{dev_shell-0.10.2 → dev_shell-0.11.1}/README.md

@@ -40,14 +40,14 @@ The output looks like:
 
 [comment]: <> (✂✂✂ auto generated main help start ✂✂✂)
 ```
+Cmd2 Commands
+─────────────
+alias  help  history  macro  quit  set  shortcuts
+
 dev-shell commands
 ──────────────────
 coverage        install             publish    test    version
 fix_code_style  list_venv_packages  pyupgrade  update
-
-Uncategorized Commands
-──────────────────────
-alias  help  history  macro  quit  set  shortcuts
 ```
 [comment]: <> (✂✂✂ auto generated main help end ✂✂✂)
 
@@ -71,19 +71,32 @@ See also:
 
 [comment]: <> (✂✂✂ auto generated history start ✂✂✂)
 
+* [v0.11.1](https://github.com/jedie/dev-shell/compare/v0.11.0...v0.11.1)
+  * 2026-06-11 - fix _print_info() if Path instance pass as arguments
+* [v0.11.0](https://github.com/jedie/dev-shell/compare/v0.10.2...v0.11.0)
+  * 2026-06-11 - Remove uv.lock from this repo: It's a library not a project
+  * 2026-06-11 - nox: reuse venv
+  * 2026-06-11 - NEW: CategorizedCommandSet replacement for @cmd2.with_default_category()
+  * 2026-06-11 - fix linting
+  * 2026-06-11 - Update requirements
+  * 2026-05-29 - Bump uv from 0.11.6 to 0.11.15
+  * 2026-04-10 - Bump uv from 0.10.4 to 0.11.6
+  * 2026-04-08 - Bump cryptography from 46.0.6 to 46.0.7
+  * 2026-03-30 - Bump pygments from 2.19.2 to 2.20.0
+  * 2026-03-29 - Bump cryptography from 46.0.5 to 46.0.6
 * [v0.10.2](https://github.com/jedie/dev-shell/compare/v0.10.1...v0.10.2)
   * 2026-02-19 - apply manageprojects updates
   * 2026-02-19 - Bugfix colorful helpers if a Path instance should be printed.
 * [v0.10.1](https://github.com/jedie/dev-shell/compare/v0.10.0...v0.10.1)
   * 2026-02-10 - Bugfix text color styles
+
+<details><summary>Expand older history entries ...</summary>
+
 * [v0.10.0](https://github.com/jedie/dev-shell/compare/v0.9.1...v0.10.0)
   * 2026-02-10 - Cleanup
   * 2026-02-09 - Update project
 * [v0.9.1](https://github.com/jedie/dev-shell/compare/v0.9.0...v0.9.1)
   * 2025-03-11 - Fix usage as package in external projects
-
-<details><summary>Expand older history entries ...</summary>
-
 * [v0.9.0](https://github.com/jedie/dev-shell/compare/v0.8.0...v0.9.0)
   * 2025-03-11 - fix publish
   * 2025-03-11 - Replace `poetry` with `uv`

{dev_shell-0.10.2 → dev_shell-0.11.1}/dev_shell/__init__.py

@@ -4,5 +4,5 @@ Developer shell for easy startup...
 """
 
 # See https://packaging.python.org/en/latest/specifications/version-specifiers/
-__version__ = '0.10.2'
+__version__ = '0.11.1'
 __author__ = 'Jens Diemer <dev-shell@jensdiemer.de>'

{dev_shell-0.10.2 → dev_shell-0.11.1}/dev_shell/base_cmd2_app.py

@@ -21,7 +21,7 @@ class DevShellBaseApp(cmd2.Cmd):
     delattr(cmd2.Cmd, 'do_run_pyscript')
 
     def __init__(self, *args, config: DevShellConfig, **kwargs):
-        kwargs.update(dict(persistent_history_file='.history', allow_cli_args=False))
+        kwargs.update({'persistent_history_file': '.history', 'allow_cli_args': False})
         super().__init__(*args, **kwargs)
 
         self.config = config

{dev_shell-0.10.2 → dev_shell-0.11.1}/dev_shell/bootstrap-source.py

@@ -70,9 +70,12 @@ def main(argv):
     if not uv_bin:
         print_uv_error_and_exit()
 
-    if not Path(VIRTUAL_ENV).is_dir():
-        verbose_check_call(uv_bin, 'venv', VIRTUAL_ENV)
+    first_run = not Path(VIRTUAL_ENV).is_dir()
 
+    # Always sync: creates venv if missing, regenerates uv.lock, installs deps:
+    verbose_check_call(uv_bin, 'sync')
+
+    if first_run:
         # Activate git pre-commit hooks:
         verbose_check_call(uv_bin, 'run', '--active', '-m', 'pre_commit', 'install')
 

dev_shell-0.11.1/dev_shell/command_sets/__init__.py

@@ -0,0 +1,43 @@
+import inspect
+
+import cmd2
+from cmd2 import CommandSet
+
+from dev_shell.config import DevShellConfig
+
+
+class CategorizedCommandSet(CommandSet):
+    """
+    A cmd2 CommandSet that automatically groups all do_* methods under a help category.
+
+    Set the class attribute `category` in a subclass to assign all its commands to that
+    category in the help output. The categorization happens once at class definition time
+    via __init_subclass__, so there is no runtime overhead per instance.
+
+    Example::
+
+        class MyCommands(CategorizedCommandSet):
+            category = 'My Commands'
+
+            def do_hello(self, statement):
+                ...
+    """
+
+    category = None
+
+    def __init_subclass__(cls, **kwargs):
+        super().__init_subclass__(**kwargs)
+        if category := getattr(cls, 'category', None):
+            cmd2.utils.categorize(
+                [v for k, v in inspect.getmembers(cls, predicate=inspect.isfunction) if k.startswith('do_')],
+                category,
+            )
+
+
+class DevShellBaseCommandSet(CategorizedCommandSet):
+    category = 'dev-shell commands'
+
+    def __init__(self, config: DevShellConfig):
+        super().__init__()
+
+        self.config = config

{dev_shell-0.10.2 → dev_shell-0.11.1}/dev_shell/command_sets/dev_shell_commands.py

@@ -23,7 +23,6 @@ except ModuleNotFoundError:
     publish_package = None
 
 
-@cmd2.with_default_category('dev-shell commands')
 class DevShellCommandSet(DevShellBaseCommandSet):
     """
     This command set may be used in external project, too.

{dev_shell-0.10.2 → dev_shell-0.11.1}/dev_shell/dev_shell_app.py

@@ -27,16 +27,16 @@ def get_devshell_app_kwargs():
     config = DevShellConfig(package_module=dev_shell)
 
     # initialize all CommandSet() with context:
-    kwargs = dict(
-        config=config
-    )
+    kwargs = {
+        'config': config,
+    }
 
-    app_kwargs = dict(
-        config=config,
-        command_sets=[
+    app_kwargs = {
+        'config': config,
+        'command_sets': [
             DevShellCommandSet(**kwargs),
-        ]
-    )
+        ],
+    }
     return app_kwargs
 
 

{dev_shell-0.10.2 → dev_shell-0.11.1}/dev_shell/tests/__init__.py

@@ -4,7 +4,7 @@ from pathlib import Path
 
 from bx_py_utils.test_utils.deny_requests import deny_any_real_request
 from cli_base.cli_tools.verbosity import MAX_LOG_LEVEL, setup_logging
-from rich import print  # noqa
+from rich import print
 from typeguard import install_import_hook
 
 
@@ -17,7 +17,7 @@ def pre_configure_tests() -> None:
 
     # Hacky way to display more "assert"-Context in failing tests:
     _MIN_MAX_DIFF = unittest.util._MAX_LENGTH - unittest.util._MIN_DIFF_LEN
-    unittest.util._MAX_LENGTH = int(os.environ.get('UNITTEST_MAX_LENGTH', 2000))
+    unittest.util._MAX_LENGTH = int(os.environ.get('UNITTEST_MAX_LENGTH', '2000'))
     unittest.util._MIN_DIFF_LEN = unittest.util._MAX_LENGTH - _MIN_MAX_DIFF
 
     # Deny any request via docket/urllib3 because tests they should mock all requests:

{dev_shell-0.10.2 → dev_shell-0.11.1}/dev_shell/tests/test_readme.py

@@ -7,13 +7,21 @@ from manageprojects.tests.base import BaseTestCase
 from dev_shell.constants import DEV_SHELL_PKG_PATH
 
 
+def remove_until_usage(text: str) -> str:
+    lines = text.splitlines()
+    for idx, line in enumerate(lines):
+        if '-m dev_shell help' in line:
+            return '\n'.join(lines[idx + 1 :])
+    raise ValueError('No usage line found')
+
+
 def assert_cli_help_in_readme(text_block: str, marker: str):
     README_PATH = DEV_SHELL_PKG_PATH.parent / 'README.md'
     assert_is_file(README_PATH)
 
-    text_block = '\n'.join(text_block.splitlines()[2:])
-
+    text_block = remove_until_usage(text_block)
     text_block = f'```\n{text_block.strip()}\n```'
+
     assert_readme_block(
         readme_path=README_PATH,
         text_block=text_block,

{dev_shell-0.10.2 → dev_shell-0.11.1}/dev_shell/utils/subprocess_utils.py

@@ -3,6 +3,7 @@ import shlex
 import shutil
 import subprocess
 import sys
+from collections.abc import Iterable
 from pathlib import Path
 
 from bx_py_utils.path import assert_is_dir
@@ -60,13 +61,31 @@ def make_relative_path(path, relative_to):
     return path
 
 
+def shlex_join_plus(args: Iterable) -> str:
+    """
+    Like shlex.join(), but also accepts Path objects.
+
+    >>> shlex_join_plus(['echo', Path('/tmp/my dir')])
+    "echo '/tmp/my dir'"
+    """
+
+    def path_to_str(parts):
+        for part in parts:
+            if isinstance(part, Path):
+                yield str(part)
+            else:
+                yield part
+
+    return shlex.join(path_to_str(args))
+
+
 def _print_info(popenargs, *, cwd, kwargs):
     print()
     print('_' * 100)
 
     if len(popenargs) > 1:
         command, *args = popenargs
-        args = shlex.join(args)
+        args = shlex_join_plus(args)
     else:
         command = popenargs[0]
         args = ''

{dev_shell-0.10.2 → dev_shell-0.11.1}/devshell.py

@@ -70,9 +70,12 @@ def main(argv):
     if not uv_bin:
         print_uv_error_and_exit()
 
-    if not Path(VIRTUAL_ENV).is_dir():
-        verbose_check_call(uv_bin, 'venv', VIRTUAL_ENV)
+    first_run = not Path(VIRTUAL_ENV).is_dir()
 
+    # Always sync: creates venv if missing, regenerates uv.lock, installs deps:
+    verbose_check_call(uv_bin, 'sync')
+
+    if first_run:
         # Activate git pre-commit hooks:
         verbose_check_call(uv_bin, 'run', '--active', '-m', 'pre_commit', 'install')
 

{dev_shell-0.10.2 → dev_shell-0.11.1}/noxfile.py

@@ -12,6 +12,7 @@ PYTHON_VERSIONS = ('3.14', '3.13', '3.12')
 @nox.session(
     python=PYTHON_VERSIONS,
     venv_backend='uv',
+    reuse_venv=True,
     download_python='auto',
 )
 def tests(session: Session):

{dev_shell-0.10.2 → dev_shell-0.11.1}/pyproject.toml

@@ -67,6 +67,7 @@ version_module_name = "dev_shell"  # Used by "update-readme-history" git hook
 line-length = 120
 exclude = [
   ".*/",
+  "dev_shell/bootstrap-source.py",
 ]
 
 [tool.ruff.lint]

dev_shell-0.10.2/dev_shell/command_sets/__init__.py

@@ -1,10 +0,0 @@
-from cmd2 import CommandSet
-
-from dev_shell.config import DevShellConfig
-
-
-class DevShellBaseCommandSet(CommandSet):
-    def __init__(self, config: DevShellConfig):
-        super().__init__()
-
-        self.config = config