pysfi 0.1.0__tar.gz

pysfi-0.1.0/.codebuddy/rules/language-standards.mdc

@@ -0,0 +1,79 @@
+---
+description: 
+alwaysApply: true
+enabled: true
+updatedAt: 2026-01-12T09:56:47.884Z
+provider: 
+---
+
+# Language Standards for sfi Project
+
+This rule enforces consistent use of English language throughout the sfi project to ensure international accessibility and professional code standards.
+
+## Requirements
+
+### 1. Code Comments
+- ALL code comments MUST be written in English
+- This includes:
+  - Inline comments (single-line)
+  - Block comments (multi-line)
+  - Docstrings
+  - Type hints descriptions
+  - Function and class documentation
+
+### 2. Documentation
+- ALL documentation files MUST be written in English
+- This includes:
+  - README.md
+  - Any additional markdown files (*.md)
+  - Documentation text in code files
+  - Inline documentation strings
+
+### 3. User-Facing Messages
+- Command-line interface messages SHOULD be written in English for international users
+- This includes:
+  - Help text in argparse
+  - Logger messages (info, warning, error)
+  - Print statements for user output
+  - Error messages
+
+### 4. Variable and Function Names
+- All identifiers MUST use English names
+- Examples:
+  - ✅ `process_file()`, `user_name`, `total_count`
+  - ❌ `处理文件()`, `用户名`, `总数`
+
+## Examples
+
+### Correct (English)
+```python
+"""Remove file date prefix and replace with creation/modification date."""
+def process_files(files: list[Path]) -> None:
+    """Process multiple files concurrently."""
+    logger.info("Processing files...")
+```
+
+### Incorrect (Non-English)
+```python
+"""移除文件日期前缀并替换为创建/修改日期。"""
+def 处理文件(文件列表: list[Path]) -> None:
+    """并发处理多个文件。"""
+    logger.info("处理文件中...")
+```
+
+## Enforcement
+
+When writing or reviewing code for the sfi project:
+1. Check all comments are in English
+2. Check all docstrings are in English
+3. Check README and documentation are in English
+4. Check variable/function names are in English
+5. Check user-facing messages are in English
+
+## Rationale
+
+- English is the de facto standard for open-source projects
+- Ensures code is accessible to international contributors
+- Follows Python community best practices
+- Maintains consistency across the codebase
+- Facilitates collaboration and code review

pysfi-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+uv.lock
+.vscode
+projects.json
+runtime
+.cache
+.coverage
+pyloader.exe
+*.c

pysfi-0.1.0/.python-version

@@ -0,0 +1 @@
+3.8

pysfi-0.1.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: pysfi
+Version: 0.1.0
+Summary: Single File commands for Interactive python.
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# sfi
+
+Single File commands for Interactive python.
+
+## Overview
+
+sfi is a Python project that provides single-file command-line utilities, designed to be lightweight and easy-to-use.
+
+## Available Commands
+
+### [filedate](sfi/filedate/README.md)
+
+A file date management tool that normalizes date prefixes in filenames.
+
+## Installation
+
+```bash
+# Install using uv (recommended)
+uv add sfi
+
+# Or using pip
+pip install sfi
+```
+
+## Development
+
+### Requirements
+
+- Python >= 3.8
+- [uv](https://github.com/astral-sh/uv) (recommended) or pip
+
+### Development Dependencies
+
+```bash
+uv pip install -e ".[dev]"
+```
+
+### Code Standards
+
+The project uses Ruff for code linting and formatting:
+
+```bash
+# Check code
+ruff check .
+
+# Format code
+ruff format .
+```
+
+## Project Structure
+
+```bash
+sfi/
+├── pyproject.toml          # Main project configuration
+├── README.md
+└── sfi/
+    ├── __init__.py
+    └── filedate/           # filedate command module
+        ├── __init__.py
+        ├── filedate.py     # Main implementation
+        ├── pyproject.toml
+        └── README.md       # Detailed documentation
+```
+
+## License
+
+MIT License
+
+## Contributing
+
+Issues and Pull Requests are welcome!

pysfi-0.1.0/README.md

@@ -0,0 +1,71 @@
+# sfi
+
+Single File commands for Interactive python.
+
+## Overview
+
+sfi is a Python project that provides single-file command-line utilities, designed to be lightweight and easy-to-use.
+
+## Available Commands
+
+### [filedate](sfi/filedate/README.md)
+
+A file date management tool that normalizes date prefixes in filenames.
+
+## Installation
+
+```bash
+# Install using uv (recommended)
+uv add sfi
+
+# Or using pip
+pip install sfi
+```
+
+## Development
+
+### Requirements
+
+- Python >= 3.8
+- [uv](https://github.com/astral-sh/uv) (recommended) or pip
+
+### Development Dependencies
+
+```bash
+uv pip install -e ".[dev]"
+```
+
+### Code Standards
+
+The project uses Ruff for code linting and formatting:
+
+```bash
+# Check code
+ruff check .
+
+# Format code
+ruff format .
+```
+
+## Project Structure
+
+```bash
+sfi/
+├── pyproject.toml          # Main project configuration
+├── README.md
+└── sfi/
+    ├── __init__.py
+    └── filedate/           # filedate command module
+        ├── __init__.py
+        ├── filedate.py     # Main implementation
+        ├── pyproject.toml
+        └── README.md       # Detailed documentation
+```
+
+## License
+
+MIT License
+
+## Contributing
+
+Issues and Pull Requests are welcome!

pysfi-0.1.0/pyproject.toml

@@ -0,0 +1,102 @@
+[build-system]
+build-backend = "hatchling.build"
+requires = ["hatchling"]
+
+[project]
+dependencies = []
+description = "Single File commands for Interactive python."
+name = "pysfi"
+readme = "README.md"
+requires-python = ">=3.8"
+version = "0.1.0"
+
+[project.scripts]
+alarmclk = "sfi.alarmclock.alarmclock:main"
+embedinstall = "sfi.embedinstall.embedinstall:main"
+filedate = "sfi.filedate.filedate:main"
+mkp = "sfi.makepython.makepython:main"
+projectparse = "sfi.projectparse.projectparse:main"
+pyloadergen = "sfi.pyloadergen.pyloadergen:main"
+pypacker = "sfi.pypacker.pypacker:main"
+
+[tool.hatch.build.targets.wheel]
+exclude = ["sfi/*/README.md", "sfi/*/dist", "sfi/*/pyproject.toml"]
+packages = ["sfi"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py38"
+
+# Exclude files and directories
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".git-rewrite",
+    ".hg",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".pytype",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "venv",
+]
+
+[tool.ruff.lint]
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+fixable = ["ALL"]
+ignore = [
+    "B008", # Do not perform function calls in function arguments
+    "E501", # Line too long (handled by formatter)
+]
+select = [
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "E",   # pycodestyle errors
+    "F",   # Pyflakes
+    "I",   # isort
+    "N",   # pep8-naming
+    "RUF", # Ruff-specific rules
+    "SIM", # flake8-simplify
+    "UP",  # pyupgrade
+    "W",   # pycodestyle warnings
+]
+unfixable = []
+
+[tool.ruff.lint.isort]
+known-first-party = ["sfi"]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = ["F401"] # Allow unused imports
+
+[tool.uv.workspace]
+members = [
+    "sfi/alarmclock",
+    "sfi/embedinstall",
+    "sfi/filedate",
+    "sfi/makepython",
+    "sfi/projectparse",
+    "sfi/pyloadergen",
+    "sfi/pypacker",
+]
+
+[dependency-groups]
+dev = [
+    "hatch>=1.14.2",
+    "pyside2>=5.15.2.1",
+    "pytest-cov>=5.0.0",
+    "pytest>=8.3.5",
+    "qdarkstyle>=3.2.3",
+    "ruff>=0.14.11",
+    "tomli>=2.4.0",
+]