justin-utils 0.1.0__tar.gz

justin_utils-0.1.0/.github/workflows/integration.yml

@@ -0,0 +1,40 @@
+name: Integration
+
+on:
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  integration:
+    uses: djachenko/repokit/.github/workflows/python-integration.yml@0.5
+    secrets: inherit
+
+  publish:
+    needs: integration
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true
+
+      - name: Smoke test
+        run: |
+          PACKAGE=$(ls dist/*.whl | head -1 | xargs basename | sed 's/-[0-9].*//')
+          VERSION=$(ls dist/*.tar.gz | sed 's/.*-\(.*\)\.tar\.gz/\1/')
+          for i in {1..5}; do
+            pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ $PACKAGE==$VERSION && break
+            echo "Attempt $i failed, retrying in 10s..."
+            sleep 10
+          done
+          python -c "import $PACKAGE"

justin_utils-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,40 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  release:
+    uses: djachenko/repokit/.github/workflows/python-release.yml@0.5
+    secrets: inherit
+    permissions:
+      contents: write
+
+  publish:
+    needs: release
+    if: needs.release.outputs.released == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Smoke test
+        run: |
+          PACKAGE=$(ls dist/*.whl | head -1 | xargs basename | sed 's/-[0-9].*//')
+          VERSION=$(ls dist/*.tar.gz | sed 's/.*-\(.*\)\.tar\.gz/\1/')
+          for i in {1..5}; do
+            pip install $PACKAGE==$VERSION && break
+            echo "Attempt $i failed, retrying in 10s..."
+            sleep 10
+          done
+          python -c "import $PACKAGE"

justin_utils-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,13 @@
+name: Tests
+
+on:
+  push:
+    branches:
+      - '**'
+    tags-ignore:
+      - '**'
+
+jobs:
+  tests:
+    uses: djachenko/repokit/.github/workflows/python-tests.yml@0.5
+    secrets: inherit

justin_utils-0.1.0/.gitignore

@@ -0,0 +1,137 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# Session memory
+memory/
+
+# IDE
+.idea/
+
+# Claude Code
+.claude/
+
+# Repo dump
+justin_utils.txt
+.repokit

justin_utils-0.1.0/CHANGELOG.md

@@ -0,0 +1,7 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## v0.1.0 (2026-06-25)
+
+- Initial Release

justin_utils-0.1.0/CLAUDE.md

@@ -0,0 +1,55 @@
+# justin_utils — Project Guide
+
+## Что это
+
+Общие утилиты Python-экосистемы. Библиотека без зависимостей, которую можно установить отдельно и использовать в любом проекте экосистемы.
+
+---
+
+## Место в экосистеме
+
+```
+justin ──→ justin_utils
+pyvko  ──→ justin_utils (планируется)
+```
+
+Цель: вобрать весь переиспользуемый код из `justin` и `pyvko`, чтобы шарить между проектами без лишних зависимостей.
+
+---
+
+## Текущие модули
+
+| Модуль | Содержимое |
+|--------|------------|
+| `filesystem.py` | `Folder`, `File` — обёртки над `Path` с удобным доступом к подпапкам |
+| `parts.py` | CLI-утилита `parts` |
+| `subfolder.py` | CLI-утилита `sf` |
+| `transfer.py` | `TransferSpeedMeter`, `TransferTimeEstimator` |
+| `time_formatter.py` | Форматирование времени |
+| `data.py` | `DataSize` |
+| `exif.py` | EXIF-утилиты |
+| `singleton.py` | Singleton паттерн |
+| `joins.py`, `pylinq.py` | LINQ-подобные операции над коллекциями |
+| `json_migration.py` | Утилиты для JSON-миграций |
+
+---
+
+## Текущее состояние
+
+- Версия `0.0.1` — никогда не апдейтилась с релиза
+- 26 незакоммиченных файлов — давно не синхронизировалось с реальным состоянием
+- Установка в других проектах: `pip install -e ../justin_utils`
+
+---
+
+## Что нужно сделать
+
+- Разобрать 26 dirty-файлов
+- При следующей работе с justin или pyvko — выявить код который стоит сюда перенести
+- Рассмотреть разбивку на отдельные install-extras чтобы не тянуть всё целиком
+
+---
+
+## Git
+
+Semantic commits: `feat:`, `fix:`, `refactor:`, `chore:`

justin_utils-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: justin_utils
+Version: 0.1.0
+Summary: Utilities for the Justin project
+Project-URL: Homepage, https://github.com/djachenko/justin_utils
+Project-URL: Repository, https://github.com/djachenko/justin_utils
+Project-URL: Issues, https://github.com/djachenko/justin_utils/issues
+Author: Igor Djachenko
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: justin-utils[cli]
+Requires-Dist: justin-utils[exif]
+Requires-Dist: justin-utils[filesystem]
+Requires-Dist: justin-utils[joins]
+Requires-Dist: justin-utils[other]
+Requires-Dist: justin-utils[parts]
+Requires-Dist: justin-utils[pylinq]
+Requires-Dist: justin-utils[singleton]
+Requires-Dist: justin-utils[sources]
+Requires-Dist: justin-utils[util]
+Requires-Dist: typing-extensions
+Provides-Extra: cli
+Provides-Extra: exif
+Requires-Dist: exif; extra == 'exif'
+Requires-Dist: pillow; extra == 'exif'
+Provides-Extra: filesystem
+Provides-Extra: joins
+Provides-Extra: other
+Provides-Extra: parts
+Provides-Extra: pylinq
+Provides-Extra: release
+Requires-Dist: build; extra == 'release'
+Requires-Dist: python-semantic-release; extra == 'release'
+Provides-Extra: singleton
+Provides-Extra: sources
+Requires-Dist: exif; extra == 'sources'
+Requires-Dist: pillow; extra == 'sources'
+Provides-Extra: test
+Requires-Dist: mypy; extra == 'test'
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: ruff; extra == 'test'
+Provides-Extra: util
+Description-Content-Type: text/markdown
+
+justin_utils

justin_utils-0.1.0/README.md

@@ -0,0 +1 @@
+justin_utils

justin_utils-0.1.0/pyproject.toml

@@ -0,0 +1,92 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/justin_utils"]
+
+[project]
+name = "justin_utils"
+version = "0.1.0"
+description = "Utilities for the Justin project"
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "Igor Djachenko" }]
+requires-python = ">=3.10"
+dependencies = [
+    "typing_extensions",
+    "justin_utils[util]",
+    "justin_utils[joins]",
+    "justin_utils[singleton]",
+    "justin_utils[pylinq]",
+    "justin_utils[other]",
+    "justin_utils[filesystem]",
+    "justin_utils[cli]",
+    "justin_utils[parts]",
+    "justin_utils[exif]",
+    "justin_utils[sources]",
+]
+
+[project.scripts]
+parts = "justin_utils.parts:__run"
+sf = "justin_utils.subfolder:__run"
+
+[project.optional-dependencies]
+util       = []
+joins      = []
+singleton  = []
+pylinq     = []
+other      = [
+    "justin_utils[singleton]",
+]
+filesystem = [
+    "justin_utils[other]",
+]
+cli        = [
+    "justin_utils[util]",
+]
+parts      = [
+    "justin_utils[cli]",
+]
+exif       = [
+    "Pillow",
+    "exif",
+]
+sources    = [
+    "justin_utils[util]",
+    "justin_utils[joins]",
+    "justin_utils[exif]",
+    "justin_utils[filesystem]",
+]
+test       = [
+    "pytest",
+    "ruff",
+    "mypy",
+]
+release    = [
+    "build",
+    "python-semantic-release",
+]
+
+[project.urls]
+Homepage   = "https://github.com/djachenko/justin_utils"
+Repository = "https://github.com/djachenko/justin_utils"
+Issues     = "https://github.com/djachenko/justin_utils/issues"
+
+[tool.mypy]
+python_version = "3.10"
+
+[[tool.mypy.overrides]]
+module = [
+    "justin_utils.pylinq",
+    "justin_utils.cli",
+    "justin_utils.json_migration",
+]
+ignore_errors = true
+
+[tool.semantic_release]
+version_toml    = ["pyproject.toml:project.version"]
+branch          = "master"
+commit_message  = "chore(release): v{version} [no ci]"
+major_on_zero   = false
+allow_zero_version = true

justin_utils-0.1.0/src/justin_utils/cd.py

@@ -0,0 +1,18 @@
+import os
+from contextlib import contextmanager
+from pathlib import Path
+
+
+@contextmanager
+def cd(new_path: Path):
+    assert new_path.exists()
+    assert new_path.is_dir()
+
+    previous_path = Path.cwd()
+
+    os.chdir(str(new_path.expanduser()))
+
+    try:
+        yield
+    finally:
+        os.chdir(str(previous_path))

justin_utils-0.1.0/src/justin_utils/cli.py

@@ -0,0 +1,143 @@
+from abc import abstractmethod
+from argparse import ArgumentParser, Namespace
+from dataclasses import dataclass, asdict
+from enum import Enum
+from typing import Any, Iterable, Dict, ClassVar, Type, Callable, List, TypeVar
+
+from justin_utils.util import is_distinct
+
+Context = Any
+
+T = TypeVar("T")
+
+
+@dataclass
+class Parameter:
+    class Action(str, Enum):
+        STORE_TRUE = "store_true"
+
+    name: str = None
+    flags: Iterable[str] = None
+    nargs: str = None
+    default: Any = None
+    action: Action = None
+    type: Type | Callable[[str], T] = None
+    choices: Iterable[T] = None
+
+    not_kw_fields: ClassVar[Iterable[str]] = [
+        "name",
+        "flags",
+    ]
+
+    def __post_init__(self) -> None:
+        if self.flags is None:
+            self.flags = ()
+        else:
+            self.flags = tuple(self.flags)
+
+        if self.action is not None:
+            self.action = self.action.value
+
+    @property
+    def name_or_flags(self) -> Iterable[str]:
+        # noinspection PyTypeChecker
+        return tuple(i for i in (self.name,) + self.flags if i)
+
+    @property
+    def params(self) -> Dict[str, Any]:
+        return {k: v for k, v in asdict(self).items() if k not in Parameter.not_kw_fields and v}
+
+
+class Action:
+    def configure_subparser(self, subparser: ArgumentParser) -> None:
+        pass
+
+    @property
+    def parameters(self) -> List[Parameter]:
+        return []
+
+    @abstractmethod
+    def perform(self, args: Namespace, context: Context) -> None:
+        pass
+
+
+class Command:
+    def __init__(self, name: str, actions: Iterable[Action], allowed_same_parameters: Iterable[str] = ()) -> None:
+        super().__init__()
+
+        name = name.strip()
+
+        assert " " not in name
+
+        params_set = set()
+
+        for action in actions:
+            for param in action.parameters:
+                param_name = param.name_or_flags
+
+                assert param_name not in params_set or any(i in allowed_same_parameters for i in param_name)
+
+                params_set.add(param_name)
+
+        self.__name = name
+        self.__actions = actions
+
+    @property
+    def name(self) -> str:
+        return self.__name
+
+    def configure_parser(self, parser_adder) -> None:
+        subparser: ArgumentParser = parser_adder.add_parser(self.__name)
+
+        self.configure_subparser(subparser)
+
+        self.__setup_callback(subparser)
+
+    def configure_subparser(self, subparser: ArgumentParser) -> None:
+        params_set = set()
+
+        for action in self.__actions:
+            for parameter in action.parameters:
+                if parameter.name_or_flags in params_set:
+                    continue
+
+                subparser.add_argument(*parameter.name_or_flags, **parameter.params)
+                params_set.add(parameter.name_or_flags)
+
+            action.configure_subparser(subparser)
+
+    def __setup_callback(self, parser: ArgumentParser) -> None:
+        parser.set_defaults(command=self)
+
+    def __call__(self, args: Namespace, context: Context) -> None:
+        for action in self.__actions:
+            action.perform(args, context)
+
+
+class App:
+    def __init__(self, commands: Iterable[Command], context: Context = None) -> None:
+        super().__init__()
+
+        assert is_distinct([command.name for command in commands])
+
+        self.__commands = commands
+        self.__context = context
+
+    def run(self, args: Iterable[str] = None) -> None:
+        parser = ArgumentParser()
+
+        parser_adder = parser.add_subparsers()
+
+        for command in self.__commands:
+            command.configure_parser(parser_adder)
+
+        namespace = parser.parse_args(args)
+
+        if not hasattr(namespace, "command"):
+            print("No parameters is bad")
+        elif not namespace.command:
+            print("No command found.")
+        elif not isinstance(namespace.command, Command):
+            print("Wrong command class")
+        else:
+            namespace.command(namespace, self.__context)