pytola-dev 0.1.18__tar.gz

pytola_dev-0.1.18/.gitignore

@@ -0,0 +1,155 @@
+# 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/
+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
+*.py,cover
+.pytest_cache/
+cover/
+
+# 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
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# idea
+.idea
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .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
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# 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
+
+# poetry
+poetry.lock
+
+# uv
+uv.lock
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+
+# Added by cargo
+
+/target
+Cargo.lock
+projects.json
+.cbuild
+*.backup

pytola_dev-0.1.18/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: pytola-dev
+Version: 0.1.18
+Summary: Add your description here
+Requires-Python: >=3.8
+Requires-Dist: jinja2>=3.0
+Requires-Dist: pefile>=2024.8.26
+Requires-Dist: pillow>=10.4.0
+Requires-Dist: tomli-w>=1.0.0

pytola_dev-0.1.18/pyproject.toml

@@ -0,0 +1,180 @@
+[tool.hatch.build.targets.wheel]
+exclude = [
+  "pytola_dev/**/README.md",
+  "pytola_dev/**/dist",
+  "pytola_dev/**/pyproject.toml",
+  "pytola_dev/**/tests",
+]
+packages = ["pytola_dev"]
+[tool.hatch.build]
+include = ["pytola_dev/**/*.py", "pytola_dev/**/templates/**"]
+
+[project]
+dependencies = [
+  "jinja2>=3.0",
+  "pefile>=2024.8.26",
+  "pillow>=10.4.0",
+  "tomli-w>=1.0.0",
+]
+description = "Add your description here"
+name = "pytola-dev"
+readme = "README.md"
+requires-python = ">=3.8"
+version = "0.1.18"
+
+[project.scripts]
+autofmt = "pytola_dev.autofmt.cli:main"
+bumpversion = "pytola_dev.bumpversion.cli:main"
+checksum = "pytola_dev.checksum.gui:main"
+checksumc = "pytola_dev.checksum.cli:main"
+cleanbuild = "pytola_dev.cleanbuild:main"
+condasetup = "pytola_dev.condasetup:main"
+envt = "pytola_dev.envtool.cli:main"
+gitt = "pytola_dev.gittool.cli:main"
+mkp = "pytola_dev.makepython.cli:main"
+pipt = "pytola_dev.piptool:main"
+pylibpack = "pytola_dev.pypack.tools.pylibpack:main"
+pyloadergen = "pytola_dev.pypack.tools.pyloadergen:main"
+pymake = "pytola_dev.pymake.cli:main"
+pyp = "pytola_dev.pypack:main"
+pypack = "pytola_dev.pypack:gui_main"
+pyparse = "pytola_dev.pypack.components.parser:main"
+pyprof = "pytola_dev.pyprofiler.cli:main"
+regval = "pytola_dev.regexvalidate:main"
+reshack = "pytola_dev.reshack:gui_main"
+reshackc = "pytola_dev.reshack:main"
+
+[build-system]
+build-backend = "hatchling.build"
+requires = ["hatchling"]
+# ------------------------ ruff ------------------------- #
+[tool.ruff]
+exclude = ["**/*_rc.py", "**/ui_*.py", "docs/**/*.py"]
+line-length = 120
+preview = true
+target-version = "py38"
+unsafe-fixes = true
+
+[tool.ruff.lint]
+# See list of rules at: https://docs.astral.sh/ruff/rules/
+select = [
+  "A",
+  "AIR",
+  "ANN",
+  "ARG",
+  "ASYNC",
+  "B",
+  "BLE",
+  "C",
+  "C4",
+  "C90",
+  "COM",
+  "D",
+  "DJ",
+  "DOC",
+  "DTZ",
+  "E",
+  "EM",
+  "ERA",
+  "EXE",
+  "F",
+  "FA",
+  "FAST",
+  "FBT",
+  "FIX",
+  "FLY",
+  "FURB",
+  "I",
+  "ICN",
+  "INP",
+  "INT",
+  "ISC",
+  "LOG",
+  "N",
+  "NPY",
+  "PD",
+  "PERF",
+  "PGH",
+  "PIE",
+  "PL",
+  "PT",
+  "PTH",
+  "PYI",
+  "Q",
+  "RET",
+  "RSE",
+  "RUF",
+  "SIM",
+  "SLF",
+  "SLOT",
+  "T10",
+  "T20",
+  "TD",
+  "TID",
+  "TRY",
+  "UP",
+  "W",
+  "YTT",
+]
+
+ignore = [
+  "ARG001",
+  "D100",
+  "D103",
+  "D104",
+  "D107",
+  "D203",
+  "DOC201",
+  "DOC501",
+  "FBT003",
+  "N802",
+  "PGH003",
+  "PIE",
+  "PLC0415",
+  "PLR0904",
+  "PLR0913",
+  "PLR0915",
+  "PLR6301",
+  "RUF002",
+  "RUF003",
+  "UP006",
+  "UP045",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"**/*gui*.py" = ["N802", "N803", "N806"] # Allow Qt naming conventions
+"**/gui/**" = ["N802", "N803", "N806"] # Allow Qt naming conventions
+"**/tests/**" = [
+  "ANN",
+  "ARG",
+  "D1",
+  "DOC",
+  "FBT",
+  "PLC0415",
+  "PLR2004",
+  "PLR6301",
+  "SLF",
+] # Do not require documentation for tests.
+"**/ui/**" = ["N802", "N803", "N806"] # Allow Qt naming conventions
+"**/views/**" = ["N802", "N803", "N806"] # Allow Qt naming conventions
+
+[tool.ruff.lint.pycodestyle]
+max-doc-length = 100
+
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
+# ------------------------ pytest ------------------------- #
+[tool.pytest.ini_options]
+addopts = ["--tb=short", "-m not benchmark", "-v"]
+asyncio_default_fixture_loop_scope = "function"
+asyncio_mode = "auto"
+filterwarnings = ["ignore::DeprecationWarning"]
+markers = [
+  "benchmark: marks tests as performance benchmarks",
+  "slow: marks tests as slow-running (for stress testing and large-scale operations)",
+]
+python_classes = ["Test*"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+testpaths = ["."]

pytola_dev-0.1.18/pytola_dev/__init__.py

@@ -0,0 +1 @@
+"""Development tools and utilities."""

pytola_dev-0.1.18/pytola_dev/autofmt/__init__.py

@@ -0,0 +1,11 @@
+"""Autofmt pytola-dev tools."""
+
+from .formatters.base import BaseFormatter
+from .formatters.docstring import DocstringFormatter
+from .formatters.pyproject import PyProjectFormatter
+
+__all__ = [
+    "BaseFormatter",
+    "DocstringFormatter",
+    "PyProjectFormatter",
+]

pytola_dev-0.1.18/pytola_dev/autofmt/cli.py

@@ -0,0 +1,53 @@
+"""Command-line interface for autofmt."""
+
+import argparse
+import logging
+from pathlib import Path
+
+from pytola_core.registry import DefaultRegistry
+
+from .logger import logger
+
+
+def parse_args() -> argparse.Namespace:
+    """Parse command-line arguments.
+
+    Returns
+    -------
+        argparse.Namespace: Parsed command-line arguments namespace
+    """
+    parser = argparse.ArgumentParser(description="Pytola autofmt tool")
+    parser.add_argument("root_dir", type=Path, default=Path.cwd(), nargs="?", help="Root directory to run autofmt on")
+    parser.add_argument("--list", "-l", action="store_true", help="List all available actions")
+    parser.add_argument("--verbose", "-v", action="store_true", help="Enable verbose output")
+    parser.add_argument("--dry-run", "-D", action="store_true", help="Enable dry run mode")
+    parser.add_argument("--check", "-C", action="store_true", help="Enable check mode")
+
+    return parser.parse_args()
+
+
+def main() -> None:
+    """Run the autofmt tool."""
+    args = parse_args()
+
+    if args.verbose:
+        logger.setLevel(logging.DEBUG)
+
+    if not args.root_dir.exists():
+        logger.error(f"Root directory {args.root_dir} does not exist")
+        return
+
+    action_registry = DefaultRegistry.get_instance()
+
+    if args.list:
+        logger.info("Available actions:")
+        actions = action_registry.list_all()
+        for action in actions:
+            logger.info(f"  - {action}")
+    else:
+        logger.info("Executing default action...")
+        classes = action_registry.get_classes()
+        for klass in classes:
+            logger.info(f"Executing {klass.__name__}...")
+            class_instance = klass(root_dir=args.root_dir, check_only=args.check, dry_run=args.dry_run)
+            class_instance.run()

pytola_dev-0.1.18/pytola_dev/autofmt/formatters/__init__.py

@@ -0,0 +1 @@
+"""Tools pytola-dev tools."""

pytola_dev-0.1.18/pytola_dev/autofmt/formatters/base.py

@@ -0,0 +1,78 @@
+"""Base module for formatters."""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from functools import cached_property
+from pathlib import Path
+
+# 需要跳过的文件夹
+SKIP_FOLDERS: set[str] = {"__pycache__", "dist", "build", ".venv", "venv", "env", ".env", "tests"}
+
+
+def check_exclude_folder(file_path: Path, excludes: set[str] | None = None) -> bool:
+    """Check if a file is excluded based on its name or parent directories.
+
+    Args:
+        file_path: Path of the file to check
+        exclude_dirs: Directories to exclude from search
+
+    Returns
+    -------
+        True if the file is excluded, False otherwise
+
+    Examples
+    --------
+    >>> check_exclude_folder(Path("path/to/file.py"))
+    False
+    >>> check_exclude_folder(Path("path/to/__file.py"))
+    False
+    >>> check_exclude_folder(Path("path/to/__init__.py"))
+    False
+    >>> check_exclude_folder(Path("path/to/file.py"), excludes={"path/to"})
+    False
+    >>> check_exclude_folder(Path("path/build/file.py"), excludes={"build"})
+    True
+    """
+    # 快速检查：文件名是否以 . 开头（隐藏文件），但不是 __init__.py
+    if excludes is None:
+        excludes = SKIP_FOLDERS
+
+    if file_path.name.startswith(".") and file_path.name != "__init__.py":
+        return True
+
+    # 检查路径中是否包含排除的目录
+    return any(part in excludes for part in file_path.parts)
+
+
+class BaseFormatter(ABC):
+    """Base class for auto-formatting tools."""
+
+    def __init__(self, root_dir: Path | None = None, *, check_only: bool = False, dry_run: bool = True) -> None:
+        self.root_dir = root_dir or Path.cwd()
+        self.check_only = check_only
+        self.dry_run = dry_run
+
+    @abstractmethod
+    def run(self, *, dry_run: bool = True, check_only: bool = False) -> bool:
+        """Run the formatter on all Python files.
+
+        Args:
+            dry_run: If True, only report changes without writing
+            check_only: If True, only check if conversion is needed
+
+        Returns
+        -------
+            True if successful, False otherwise
+        """
+
+    @cached_property
+    def python_files(self) -> set[Path]:
+        """Get a set of Python files in the root directory, excluding certain folders."""
+        py_files = self.root_dir.rglob("*.py")
+        return {py_file for py_file in py_files if not check_exclude_folder(py_file)}
+
+    @cached_property
+    def init_files(self) -> set[Path]:
+        """Get a set of __init__.py files in the root directory, excluding certain folders."""
+        return {f for f in self.python_files if f.name == "__init__.py"}