vexy-formi 1.0.4__tar.gz

vexy_formi-1.0.4/.gitignore

@@ -0,0 +1,354 @@
+!**/[Pp]ackages/build/
+!.axoCover/settings.json
+!.vscode/extensions.json
+!.vscode/launch.json
+!.vscode/settings.json
+!.vscode/tasks.json
+!?*.[Cc]ache/
+!Directory.Build.rsp
+!dist/.gitkeep
+$tf/
+*$py.class
+**/*.DesktopClient/GeneratedArtifacts
+**/*.DesktopClient/ModelManifest.xml
+**/*.HTMLClient/GeneratedArtifacts
+**/*.Server/GeneratedArtifacts
+**/*.Server/ModelManifest.xml
+**/[Pp]ackages/*
+*- [Bb]ackup ([0-9]).rdl
+*- [Bb]ackup ([0-9][0-9]).rdl
+*- [Bb]ackup.rdl
+*.[Cc]ache
+*.[Pp]ublish.xml
+*.[Rr]e[Ss]harper
+*.a
+*.aof
+*.app
+*.appx
+*.appxbundle
+*.appxupload
+*.aps
+*.azurePubxml
+*.bim.layout
+*.bim_*.settings
+*.binlog
+*.btm.cs
+*.btp.cs
+*.build.csdef
+*.cab
+*.cachefile
+*.code-workspace
+*.cover
+*.coverage
+*.coveragexml
+*.d
+*.dbmdl
+*.dbproj.schemaview
+*.dll
+*.dotCover
+*.DotSettings.user
+*.dsp
+*.dsw
+*.dylib
+*.e2e
+*.egg
+*.egg-info/
+*.exe
+*.gch
+*.GhostDoc.xml
+*.gpState
+*.ilk
+*.iobj
+*.ipdb
+*.jfm
+*.jmconfig
+*.la
+*.lai
+*.ldf
+*.lib
+*.lo
+*.log
+*.manifest
+*.mdf
+*.meta
+*.mm.*
+*.mo
+*.mod
+*.msi
+*.msix
+*.msm
+*.msp
+*.ncb
+*.ndf
+*.nuget.props
+*.nuget.targets
+*.nupkg
+*.nvuser
+*.o
+*.obj
+*.odx.cs
+*.opendb
+*.opensdf
+*.opt
+*.out
+*.pch
+*.pdb
+*.pfx
+*.pgc
+*.pgd
+*.pid
+*.pidb
+*.plg
+*.pot
+*.psess
+*.publishproj
+*.publishsettings
+*.pubxml
+*.py,cover
+*.py.cover
+*.py[cod]
+*.py[codz]
+*.pyc
+*.rdb
+*.rdl.data
+*.rptproj.bak
+*.rptproj.rsuser
+*.rsp
+*.rsuser
+*.sage.py
+*.sap
+*.sbr
+*.scc
+*.sdf
+*.sln.docstates
+*.sln.iml
+*.slo
+*.smod
+*.snupkg
+*.so
+*.spec
+*.suo
+*.svclog
+*.swo
+*.swp
+*.tlb
+*.tlh
+*.tli
+*.tlog
+*.tmp
+*.tmp_proj
+*.tss
+*.user
+*.userosscache
+*.userprefs
+*.vbp
+*.vbw
+*.VC.db
+*.VC.VC.opendb
+*.VisualState.xml
+*.vsp
+*.vspscc
+*.vspx
+*.vssscc
+*.xsd.cs
+*_autogen/
+*_h.h
+*_i.c
+*_p.c
+*_wpftmp.csproj
+*~
+.*crunch*.local.xml
+._*
+.abstra/
+.axoCover/*
+.builds
+.cache
+.coverage
+.coverage.*
+.cr/personal
+.dmypy.json
+.DS_Store
+.DS_Store?
+.eggs/
+.env
+.envrc
+.fake/
+.history/
+.hypothesis/
+.idea/
+.installed.cfg
+.ionide/
+.ipynb_checkpoints
+.localhistory/
+.mfractor/
+.mypy_cache/
+.nox/
+.ntvs_analysis.dat
+.paket/paket.exe
+.pdm-build/
+.pdm-python
+.pixi
+.pybuilder/
+.pypirc
+.pyre/
+.pytest_cache/
+.Python
+.pytype/
+.ropeproject
+.ruff_cache/
+.sass-cache/
+.scrapy
+.Spotlight-V100
+.spyderproject
+.spyproject
+.streamlit/secrets.toml
+.tox/
+.Trashes
+.venv
+.vs/
+.vscode
+.vscode/
+.vscode/*
+.vshistory/
+.webassets-cache
+/site
+[Aa][Rr][Mm]/
+[Aa][Rr][Mm]64/
+[Bb]in/
+[Bb]uild[Ll]og.*
+[Dd]ebug/
+[Dd]ebugPS/
+[Dd]ebugPublic/
+[Ee]xpress/
+[Ll]og/
+[Ll]ogs/
+[Oo]bj/
+[Rr]elease/
+[Rr]eleasePS/
+[Rr]eleases/
+[Tt]est[Rr]esult*/
+[Ww][Ii][Nn]32/
+__marimo__/
+__pycache__/
+__pypackages__/
+__version__.py
+_Chutzpah*
+_deps
+_NCrunch_*
+_pkginfo.txt
+_private
+_Pvt_Extensions
+_ReSharper*/
+_TeamCity*
+_UpgradeReport_Files/
+_version.py
+activemq-data/
+AppPackages/
+artifacts/
+ASALocalRun/
+AutoTest.Net/
+Backup*/
+BenchmarkDotNet.Artifacts/
+bld/
+build/
+BundleArtifacts/
+celerybeat-schedule
+celerybeat.pid
+ClientBin/
+cmake_install.cmake
+CMakeCache.txt
+CMakeFiles
+CMakeLists.txt.user
+CMakeScripts
+CMakeUserPresets.json
+compile_commands.json
+cover/
+coverage*.info
+coverage*.json
+coverage*.xml
+coverage.xml
+csx/
+CTestTestfile.cmake
+cython_debug/
+db.sqlite3
+db.sqlite3-journal
+develop-eggs/
+dist/
+dlldata.c
+dmypy.json
+DocProject/buildhelp/
+DocProject/Help/*.hhc
+DocProject/Help/*.hhk
+DocProject/Help/*.hhp
+DocProject/Help/*.HxC
+DocProject/Help/*.HxT
+DocProject/Help/html
+DocProject/Help/Html2
+docs/_build/
+downloads/
+ecf/
+eggs/
+ehthumbs.db
+env.bak/
+env/
+ENV/
+FakesAssemblies/
+FodyWeavers.xsd
+Generated\ Files/
+Generated_Code/
+healthchecksdb
+htmlcov/
+install_manifest.txt
+instance/
+ipch/
+ipython_config.py
+lib/
+lib64/
+local_settings.py
+Makefile
+MANIFEST
+marimo/_lsp/
+marimo/_static/
+MigrationBackup/
+mnesia/
+mono_crash.*
+nCrunchTemp_*
+node_modules/
+nosetests.xml
+nunit-*.xml
+OpenCover/
+orleans.codegen.cs
+Package.StoreAssociation.xml
+paket-files/
+parts/
+pip-delete-this-directory.txt
+pip-log.txt
+profile_default/
+project.fragment.lock.json
+project.lock.json
+publish/
+PublishScripts/
+rabbitmq-data/
+rabbitmq/
+rcf/
+ScaffoldingReadMe.txt
+sdist/
+ServiceFabricBackup/
+share/python-wheels/
+StyleCopReport.xml
+target/
+Testing
+TestResult.xml
+Thumbs.db
+UpgradeLog*.htm
+UpgradeLog*.XML
+var/
+venv.bak/
+venv/
+VERSION.txt
+wheels/
+x64/
+x86/
+~$*
+
+external

vexy_formi-1.0.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Fontlab Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

vexy_formi-1.0.4/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: vexy-formi
+Version: 1.0.4
+Summary: Fast code formatting and minification tool using the best available tools
+Project-URL: Documentation, https://github.com/vexyart/vexy-formi#readme
+Project-URL: Issues, https://github.com/vexyart/vexy-formi/issues
+Project-URL: Source, https://github.com/vexyart/vexy-formi
+Author-email: Fontlab Ltd <opensource@vexy.art>
+License: MIT
+License-File: LICENSE
+Keywords: biome,code-formatter,esbuild,formatter,minifier,ruff,swc
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: chardet>=5.0.0
+Requires-Dist: fire>=0.7.0
+Requires-Dist: pathspec>=0.12.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: all
+Provides-Extra: dev
+Requires-Dist: absolufy-imports>=0.3.1; extra == 'dev'
+Requires-Dist: isort>=6.0.1; extra == 'dev'
+Requires-Dist: mypy>=1.15.0; extra == 'dev'
+Requires-Dist: pre-commit>=4.1.0; extra == 'dev'
+Requires-Dist: pyupgrade>=3.19.1; extra == 'dev'
+Requires-Dist: ruff>=0.9.7; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: myst-parser>=3.0.0; extra == 'docs'
+Requires-Dist: sphinx-autodoc-typehints>=2.0.0; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == 'docs'
+Requires-Dist: sphinx>=7.2.6; extra == 'docs'
+Provides-Extra: test
+Requires-Dist: coverage[toml]>=7.6.12; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.25.3; extra == 'test'
+Requires-Dist: pytest-benchmark[histogram]>=5.1.0; extra == 'test'
+Requires-Dist: pytest-cov>=6.0.0; extra == 'test'
+Requires-Dist: pytest-xdist>=3.6.1; extra == 'test'
+Requires-Dist: pytest>=8.3.4; extra == 'test'
+Description-Content-Type: text/markdown
+
+# VexyFormi
+
+Fast code formatting and minification using the best available tools.
+
+## Features
+
+- 🔥 **Blazing Fast**: Uses fastest available tools (esbuild, swc, biome, ruff)
+- 🛡️ **Safe**: Atomic operations with automatic backups
+- 🎯 **Smart**: Automatic tool detection and fallbacks
+- 📦 **Simple**: Zero-config operation with sensible defaults
+- 🌐 **Universal**: Supports JS, TS, CSS, HTML, Python, JSON, YAML, TOML, Markdown
+
+## Quick Start
+
+```bash
+# Install
+pip install vexy-formi
+
+# Install all required tools automatically
+vfor install
+
+# Minify current directory
+vfor mini
+
+# Format Python files
+vfor fmt --verbose src/
+
+# Show available tools
+vfor tools
+
+# Update all tools to latest versions
+vfor update
+
+# Use as Python package
+python -c "import vexy_formi; vexy_formi.minify('src/')"
+```
+
+## Supported Tools
+
+- **JavaScript/TypeScript**: esbuild, swc, terser, biome, prettier
+- **CSS/SCSS**: biome, lightningcss, prettier
+- **Python**: ruff, black  
+- **HTML**: html-minifier-terser, prettier
+- **JSON**: biome, jq, prettier
+- **TOML**: taplo, dprint
+- **YAML**: prettier, yq
+- **Markdown**: dprint, prettier
+
+## Configuration
+
+Set preferences via environment variables:
+- `VFOR_PREFERRED_JS_TOOL=esbuild`
+- `VFOR_PREFERRED_CSS_TOOL=biome`
+- `VFOR_PREFERRED_PYTHON_TOOL=ruff`
+- `VFOR_MAX_WORKERS=8`
+
+Or create `.vfor.json` in your project:
+```json
+{
+    "preferred_js_tool": "esbuild",
+    "preferred_css_tool": "biome", 
+    "max_workers": 4
+}
+```
+
+## CLI Usage
+
+```bash
+# Minify files
+vfor mini                    # Current directory  
+vfor mini src/              # Specific directory
+vfor mini --verbose src/    # Show detailed output
+vfor mini --no-backup src/  # Skip backups
+
+# Format files
+vfor fmt                     # Current directory
+vfor fmt --recursive src/    # Process recursively  
+vfor fmt --exclude "*.min.*" # Exclude patterns
+
+# Tool management
+vfor install                 # Install all required tools
+vfor update                  # Update tools to latest versions
+vfor tools                   # Show available tools
+vfor cleanup                 # Clean backup files
+```
+
+## Python API
+
+```python
+import vexy_formi
+
+# Simple API
+result = vexy_formi.minify('src/')
+result = vexy_formi.format('src/', recursive=True, exclude=['*.test.*'])
+
+# Advanced usage
+from vexy_formi import FileProcessor
+
+processor = FileProcessor()
+result = processor.minify_files(
+    Path('src/'), 
+    recursive=True,
+    max_workers=8,
+    create_backup=True
+)
+
+print(f"Processed {result.total_files} files")
+print(f"Size reduction: {result.total_size_reduction_percent:.1f}%")
+```
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/vexyart/vexy-formi.git
+cd vexy-formi
+
+# Install dependencies  
+pip install -e .[dev,test]
+
+# Run CLI directly
+./vfor mini examples/
+
+# Run tests
+pytest
+
+# Format code
+ruff format src/
+```
+
+## License
+
+MIT License

vexy_formi-1.0.4/README.md

@@ -0,0 +1,133 @@
+# VexyFormi
+
+Fast code formatting and minification using the best available tools.
+
+## Features
+
+- 🔥 **Blazing Fast**: Uses fastest available tools (esbuild, swc, biome, ruff)
+- 🛡️ **Safe**: Atomic operations with automatic backups
+- 🎯 **Smart**: Automatic tool detection and fallbacks
+- 📦 **Simple**: Zero-config operation with sensible defaults
+- 🌐 **Universal**: Supports JS, TS, CSS, HTML, Python, JSON, YAML, TOML, Markdown
+
+## Quick Start
+
+```bash
+# Install
+pip install vexy-formi
+
+# Install all required tools automatically
+vfor install
+
+# Minify current directory
+vfor mini
+
+# Format Python files
+vfor fmt --verbose src/
+
+# Show available tools
+vfor tools
+
+# Update all tools to latest versions
+vfor update
+
+# Use as Python package
+python -c "import vexy_formi; vexy_formi.minify('src/')"
+```
+
+## Supported Tools
+
+- **JavaScript/TypeScript**: esbuild, swc, terser, biome, prettier
+- **CSS/SCSS**: biome, lightningcss, prettier
+- **Python**: ruff, black  
+- **HTML**: html-minifier-terser, prettier
+- **JSON**: biome, jq, prettier
+- **TOML**: taplo, dprint
+- **YAML**: prettier, yq
+- **Markdown**: dprint, prettier
+
+## Configuration
+
+Set preferences via environment variables:
+- `VFOR_PREFERRED_JS_TOOL=esbuild`
+- `VFOR_PREFERRED_CSS_TOOL=biome`
+- `VFOR_PREFERRED_PYTHON_TOOL=ruff`
+- `VFOR_MAX_WORKERS=8`
+
+Or create `.vfor.json` in your project:
+```json
+{
+    "preferred_js_tool": "esbuild",
+    "preferred_css_tool": "biome", 
+    "max_workers": 4
+}
+```
+
+## CLI Usage
+
+```bash
+# Minify files
+vfor mini                    # Current directory  
+vfor mini src/              # Specific directory
+vfor mini --verbose src/    # Show detailed output
+vfor mini --no-backup src/  # Skip backups
+
+# Format files
+vfor fmt                     # Current directory
+vfor fmt --recursive src/    # Process recursively  
+vfor fmt --exclude "*.min.*" # Exclude patterns
+
+# Tool management
+vfor install                 # Install all required tools
+vfor update                  # Update tools to latest versions
+vfor tools                   # Show available tools
+vfor cleanup                 # Clean backup files
+```
+
+## Python API
+
+```python
+import vexy_formi
+
+# Simple API
+result = vexy_formi.minify('src/')
+result = vexy_formi.format('src/', recursive=True, exclude=['*.test.*'])
+
+# Advanced usage
+from vexy_formi import FileProcessor
+
+processor = FileProcessor()
+result = processor.minify_files(
+    Path('src/'), 
+    recursive=True,
+    max_workers=8,
+    create_backup=True
+)
+
+print(f"Processed {result.total_files} files")
+print(f"Size reduction: {result.total_size_reduction_percent:.1f}%")
+```
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/vexyart/vexy-formi.git
+cd vexy-formi
+
+# Install dependencies  
+pip install -e .[dev,test]
+
+# Run CLI directly
+./vfor mini examples/
+
+# Run tests
+pytest
+
+# Format code
+ruff format src/
+```
+
+## License
+
+MIT License

vexy_formi-1.0.4/pyproject.toml

@@ -0,0 +1,480 @@
+# this_file: pyproject.toml
+#==============================================================================
+# VEXY-FORMI PACKAGE CONFIGURATION
+# This pyproject.toml defines the package metadata, dependencies, build system,
+# and development environment for the vexy-formi package.
+#==============================================================================
+
+#------------------------------------------------------------------------------
+# PROJECT METADATA
+# Core package information used by PyPI and package managers.
+#------------------------------------------------------------------------------
+[project]
+name = 'vexy-formi' # Package name on PyPI
+description = 'Fast code formatting and minification tool using the best available tools' # Short description
+readme = 'README.md' # Path to README file
+requires-python = '>=3.10' # Minimum Python version
+keywords = [
+    'formatter', 'minifier', 'code-formatter', 'esbuild', 'swc', 'biome', 'ruff'
+] # Keywords for PyPI search
+dynamic = ["version"] # Fields set dynamically at build time
+
+# PyPI classifiers for package categorization
+classifiers = [
+    'Development Status :: 4 - Beta', # Package maturity level
+    'Programming Language :: Python',
+    'Programming Language :: Python :: 3.10',
+    'Programming Language :: Python :: 3.11',
+    'Programming Language :: Python :: 3.12',
+    'Programming Language :: Python :: Implementation :: CPython',
+    'Programming Language :: Python :: Implementation :: PyPy',
+    'Operating System :: OS Independent',
+    'License :: OSI Approved :: MIT License',
+    'Intended Audience :: Developers',
+    'Topic :: Software Development :: Quality Assurance',
+    'Topic :: Software Development :: Code Generators',
+    'Topic :: Utilities',
+]
+
+dependencies = [
+    'fire>=0.7.0',
+    'rich>=13.0.0',
+    'pathspec>=0.12.0', 
+    'chardet>=5.0.0'
+]
+
+# Author information
+[[project.authors]]
+name = 'Fontlab Ltd'
+email = 'opensource@vexy.art'
+
+# License information
+[project.license]
+text = 'MIT'
+
+# Project URLs
+[project.urls]
+Documentation = 'https://github.com/vexyart/vexy-formi#readme'
+Issues = 'https://github.com/vexyart/vexy-formi/issues'
+Source = 'https://github.com/vexyart/vexy-formi'
+
+#------------------------------------------------------------------------------
+# OPTIONAL DEPENDENCIES
+# Additional dependencies for optional features, development, and testing.
+#------------------------------------------------------------------------------
+[project.optional-dependencies]
+
+# Development tools
+dev = [
+    'pre-commit>=4.1.0', # Pre-commit hook manager - Keep pre-commit as is, update if newer pre-commit version is required
+    'ruff>=0.9.7', # Linting and formatting - Keep ruff as is, update if newer ruff version is required
+    'mypy>=1.15.0', # Type checking - Keep mypy as is, update if newer mypy version is required
+    'absolufy-imports>=0.3.1', # Convert relative imports to absolute - Keep absolufy-imports as is, update if newer absolufy-imports version is required
+    'pyupgrade>=3.19.1', # Upgrade Python syntax - Keep pyupgrade as is, update if newer pyupgrade version is required
+    'isort>=6.0.1', # Sort imports - Keep isort as is, update if newer isort version is required
+]
+
+# Testing tools and frameworks
+test = [
+    'pytest>=8.3.4', # Testing framework - Keep pytest as is, update if newer pytest version is required
+    'pytest-cov>=6.0.0', # Coverage plugin for pytest - Keep pytest-cov as is, update if newer pytest-cov version is required
+    'pytest-xdist>=3.6.1', # Parallel test execution - Keep pytest-xdist as is, update if newer pytest-xdist version is required
+    'pytest-benchmark[histogram]>=5.1.0', # Benchmarking plugin - Keep pytest-benchmark as is, update if newer pytest-benchmark version is required
+    'pytest-asyncio>=0.25.3', # Async test support - Keep pytest-asyncio as is, update if newer pytest-asyncio version is required
+    'coverage[toml]>=7.6.12',
+]
+
+docs = [
+    "sphinx>=7.2.6",
+    "sphinx-rtd-theme>=2.0.0",
+    "sphinx-autodoc-typehints>=2.0.0",
+    "myst-parser>=3.0.0", # Markdown support in Sphinx
+]
+
+# All optional dependencies combined
+all = [
+]
+
+#------------------------------------------------------------------------------
+# COMMAND-LINE SCRIPTS
+# Entry points for command-line executables installed with the package.
+#------------------------------------------------------------------------------
+[project.scripts]
+vfor = "vexy_formi.cli:main"
+
+#------------------------------------------------------------------------------
+# BUILD SYSTEM CONFIGURATION
+# Defines the tools required to build the package and the build backend.
+#------------------------------------------------------------------------------
+[build-system]
+# Hatchling is a modern build backend for Python packaging
+# hatch-vcs integrates with version control systems for versioning
+requires = [
+    'hatchling>=1.27.0',
+    'hatch-vcs>=0.4.0',
+]
+build-backend = 'hatchling.build'
+
+#------------------------------------------------------------------------------
+# UV TOOL CONFIGURATION
+# Modern Python package installer and resolver configuration
+#------------------------------------------------------------------------------
+[tool.uv]
+dev-dependencies = [
+    "pre-commit>=4.1.0",
+    "ruff>=0.9.7", 
+    "mypy>=1.15.0",
+    "pytest>=8.3.4",
+    "pytest-cov>=6.0.0",
+    "pytest-xdist>=3.6.1",
+    "pytest-benchmark[histogram]>=5.1.0",
+    "coverage[toml]>=7.6.12",
+]
+# Use hatch for project management, uv for fast installs
+managed = false  # Let hatch manage environments
+
+
+#------------------------------------------------------------------------------
+# HATCH BUILD CONFIGURATION
+# Configures the build process, specifying which packages to include and
+# how to handle versioning.
+#------------------------------------------------------------------------------
+[tool.hatch.build]
+# Include package data files
+include = [
+    "src/vexy_formi/py.typed", # For better type checking support
+    "src/vexy_formi/data/**/*", # Include data files if any
+
+]
+exclude = ["**/__pycache__", "**/.pytest_cache", "**/.mypy_cache"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/vexy_formi"]
+reproducible = true
+
+
+# Version source configuration - hatch-vcs for git-tag-based semver
+[tool.hatch.version]
+source = "vcs"
+
+# VCS version configuration
+[tool.hatch.version.raw-options]
+# Match tags like v1.0.0, v1.2.3  
+tag_regex = "^v(?P<version>[^+]+)(?:\\+.*)?$"
+
+# Metadata handling configuration
+[tool.hatch.metadata]
+allow-direct-references = true # Allow direct references in metadata (useful for local dependencies)
+
+
+#------------------------------------------------------------------------------
+# DEVELOPMENT ENVIRONMENTS
+
+[tool.hatch.envs.default]
+features = ['dev', 'test', 'all']
+dependencies = []
+# Note: uv integration with hatch is experimental, using pip for now
+
+# Commands available in the default environment
+[tool.hatch.envs.default.scripts]
+# Run tests with optional arguments
+test = 'pytest {args:tests}'
+# Run tests with coverage reporting
+test-cov = "pytest --cov-report=term-missing --cov-config=pyproject.toml --cov=src/vexy_formi --cov=tests {args:tests}"
+# Run type checking
+type-check = "mypy src/vexy_formi tests"
+# Run linting and formatting
+lint = ["ruff check src/vexy_formi tests", "ruff format --respect-gitignore src/vexy_formi tests"]
+# Format and fix style issues
+fmt = ["ruff format --respect-gitignore src/vexy_formi tests", "ruff check --fix src/vexy_formi tests"]
+fix = ["ruff check --fix --unsafe-fixes src/vexy_formi tests", "ruff format --respect-gitignore src/vexy_formi tests"]
+
+# Matrix configuration to test across multiple Python versions
+
+[[tool.hatch.envs.all.matrix]]
+python = ["3.10", "3.11", "3.12"]
+
+#------------------------------------------------------------------------------
+# SPECIALIZED ENVIRONMENTS
+# Additional environments for specific development tasks.
+#------------------------------------------------------------------------------
+
+# Dedicated environment for linting and code quality checks
+[tool.hatch.envs.lint]
+detached = true # Create a separate, isolated environment
+features = ['dev'] # Use dev extras dependencies
+# installer = "uv"  # Use uv for faster package installation (experimental) 
+
+# Linting environment commands
+[tool.hatch.envs.lint.scripts]
+# Type checking with automatic type installation
+typing = "mypy --install-types --non-interactive {args:src/vexy_formi tests}"
+# Check style and format code
+style = ["ruff check {args:.}", "ruff format --respect-gitignore {args:.}"]
+# Format and fix style issues
+fmt = ["ruff format --respect-gitignore {args:.}", "ruff check --fix {args:.}"]
+fix = ["ruff check --fix --unsafe-fixes {args:.}", "ruff format --respect-gitignore {args:.}"]
+# Run all ops
+all = ["style", "typing", "fix"]
+
+# Dedicated environment for testing
+[tool.hatch.envs.test]
+features = ['test'] # Use test extras as dependencies
+# installer = "uv"  # Use uv for faster package installation (experimental)
+
+# Testing environment commands
+[tool.hatch.envs.test.scripts]
+# Run tests in parallel
+test = "python -m pytest -n auto {args:tests}"
+# Run tests with coverage in parallel
+test-cov = "python -m pytest -n auto --cov-report=term-missing --cov-config=pyproject.toml --cov=src/vexy_formi --cov=tests {args:tests}"
+# Run benchmarks
+bench = "python -m pytest -v -p no:briefcase tests/test_benchmark.py --benchmark-only"
+# Run benchmarks and save results
+bench-save = "python -m pytest -v -p no:briefcase tests/test_benchmark.py --benchmark-only --benchmark-json=benchmark/results.json"
+
+# Documentation environment
+[tool.hatch.envs.docs]
+features = ['docs']
+# installer = "uv"  # Use uv for faster package installation (experimental)
+
+# Documentation environment commands
+[tool.hatch.envs.docs.scripts]
+build = "sphinx-build -b html docs/source docs/build"
+
+# GitHub Actions workflow configuration
+[tool.hatch.envs.ci]
+features = ['test']
+# installer = "uv"  # Use uv for faster package installation (experimental)
+
+
+[tool.hatch.envs.ci.scripts]
+test = "pytest --cov=src/vexy_formi --cov-report=xml"
+
+
+#------------------------------------------------------------------------------
+# CODE QUALITY TOOLS
+# Configuration for linting, formatting, and code quality enforcement.
+#------------------------------------------------------------------------------
+
+#------------------------------------------------------------------------------
+# COVERAGE CONFIGURATION
+# Settings for test coverage measurement and reporting.
+#------------------------------------------------------------------------------
+
+# Path mapping for coverage in different environments
+[tool.coverage.paths]
+vexy_formi = ["src/vexy_formi", "*/vexy-formi/src/vexy_formi"]
+tests = ["tests", "*/vexy-formi/tests"]
+
+# Coverage report configuration
+[tool.coverage.report]
+# Lines to exclude from coverage reporting
+exclude_lines = [
+    'no cov', # Custom marker to skip coverage
+    'if __name__ == .__main__.:', # Script execution guard
+    'if TYPE_CHECKING:', # Type checking imports and code
+    'pass', # Empty pass statements
+    'raise NotImplementedError', # Unimplemented method placeholders
+    'raise ImportError', # Import error handling
+    'except ImportError', # Import error handling
+    'except KeyError', # Common error handling
+    'except AttributeError', # Common error handling
+    'except NotImplementedError', # Common error handling
+]
+
+[tool.coverage.run]
+source_pkgs = ["vexy_formi", "tests"]
+branch = true # Measure branch coverage (if/else statements)
+parallel = true # Support parallel test execution
+omit = [
+    "src/vexy_formi/__about__.py",
+]
+
+#------------------------------------------------------------------------------
+# MYPY CONFIGURATION
+# Configuration for type checking with mypy.
+#------------------------------------------------------------------------------
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_unreachable = true
+
+[[tool.mypy.overrides]]
+module = ["tests.*"]
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+
+#------------------------------------------------------------------------------
+# PYTEST CONFIGURATION
+# Configuration for pytest, including markers, options, and benchmark settings.
+#------------------------------------------------------------------------------
+
+[tool.pytest.ini_options]
+addopts = "-v --durations=10 -p no:briefcase"
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+console_output_style = "progress"
+filterwarnings = ["ignore::DeprecationWarning", "ignore::UserWarning"]
+log_cli = true
+log_cli_level = "INFO"
+markers = [
+    "benchmark: marks tests as benchmarks (select with '-m benchmark')",
+    "unit: mark a test as a unit test",
+    "integration: mark a test as an integration test",
+    "permutation: tests for permutation functionality", 
+    "parameter: tests for parameter parsing",
+    "prompt: tests for prompt parsing",
+]
+norecursedirs = [
+    ".*",
+    "build",
+    "dist", 
+    "venv",
+    "__pycache__",
+    "*.egg-info",
+    "_private",
+]
+python_classes = ["Test*"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+testpaths = ["tests"]
+
+[tool.pytest-benchmark]
+min_rounds = 100
+min_time = 0.1
+histogram = true
+storage = "file"
+save-data = true
+compare = [
+    "min",    # Minimum time
+    "max",    # Maximum time
+    "mean",   # Mean time
+    "stddev", # Standard deviation
+    "median", # Median time
+    "iqr",    # Inter-quartile range
+    "ops",    # Operations per second
+    "rounds", # Number of rounds
+]
+
+#------------------------------------------------------------------------------
+# RUFF CONFIGURATION
+# Configuration for Ruff, including linter and formatter settings.
+#------------------------------------------------------------------------------ 
+
+# Ruff linter and formatter configuration
+[tool.ruff]
+target-version = "py310"
+line-length = 100  # Modern standard, better for code readability
+fix = true  # Auto-fix issues where possible
+show-fixes = true  # Show what was fixed
+cache-dir = ".ruff_cache"  # Custom cache directory
+# Configure exclude to ignore specific directories
+exclude = [".git", ".venv", "venv", "dist", "build", ".ruff_cache"]
+
+# Linting rules configuration
+[tool.ruff.lint]
+# Rule sets to enable, organized by category
+select = [
+    # flake8 plugins and extensions
+    'A', # flake8-builtins: checks for shadowed builtins
+    'ARG', # flake8-unused-arguments: checks for unused function arguments
+    'ASYNC', # flake8-async: checks for async/await issues
+    'B', # flake8-bugbear: finds likely bugs and design problems
+    'C', # flake8-comprehensions: helps write better list/dict comprehensions
+    'DTZ', # flake8-datetimez: checks for datetime timezone issues
+    'E', # pycodestyle errors: PEP 8 style guide errors
+    'EM', # flake8-errmsg: checks for better error messages
+    'F', # pyflakes: detects various errors
+    'FBT', # flake8-boolean-trap: checks for boolean traps in function signatures
+    'I', # isort: sorts imports
+    'ICN', # flake8-import-conventions: checks for import conventions
+    'ISC', # flake8-implicit-str-concat: checks for implicit string concatenation
+    'LOG', # flake8-logging: checks for logging issues
+    'N', # pep8-naming: checks naming conventions
+    'PLC', # pylint convention: checks for convention issues
+    'PLE', # pylint error: checks for errors
+    'PLR', # pylint refactor: suggests refactors
+    'PLW', # pylint warning: checks for suspicious code
+    'PT', # flake8-pytest-style: checks pytest-specific style
+    'PTH', # flake8-use-pathlib: checks for stdlib path usage vs pathlib
+    'PYI', # flake8-pyi: checks stub files
+    'RET', # flake8-return: checks return statement consistency
+    'RSE', # flake8-raise: checks raise statements
+    'RUF', # Ruff-specific rules
+    'S', # flake8-bandit: checks for security issues
+    'SIM', # flake8-simplify: checks for code simplification opportunities
+    'T', # flake8-print: checks for print statements
+    'TCH', # flake8-type-checking: helps with type-checking
+    'TID', # flake8-tidy-imports: checks for tidy import statements
+    'UP', # pyupgrade: checks for opportunities to use newer Python features
+    'W', # pycodestyle warnings: PEP 8 style guide warnings
+    'YTT', # flake8-2020: checks for misuse of sys.version or sys.version_info
+
+]
+# Rules to ignore (with reasons)
+ignore = [
+    'B027', # Empty method in abstract base class - sometimes needed for interfaces
+    'C901', # Function is too complex - sometimes complexity is necessary
+    'FBT003', # Boolean positional argument in function definition - sometimes unavoidable
+    'PLR0911', # Too many return statements - sometimes needed for readability
+    'PLR0912', # Too many branches - sometimes needed for complex logic
+    'PLR0913', # Too many arguments - sometimes needed in APIs
+    'PLR0915', # Too many statements - sometimes needed for comprehensive functions
+    'PLR1714', # Consider merging multiple comparisons - sometimes less readable
+    'PLW0603', # Using the global statement - sometimes necessary
+    'PT013', # Pytest explicit test parameter - sometimes clearer
+    'PTH123', # Path traversal - sometimes needed
+    'PYI056', # Calling open() in pyi file - sometimes needed in type stubs
+    'S105', # Possible hardcoded password - often false positives
+    'S106', # Possible hardcoded password - often false positives
+    'S107', # Possible hardcoded password - often false positives
+    'S110', # try-except-pass - sometimes valid for suppressing exceptions
+    'SIM102',
+    # Nested if statements - sometimes more readable than combined conditions
+    'D', # pydocstyle - too verbose for utility code
+    'ANN', # flake8-annotations - type hints handled by mypy
+]
+# Rules that should not be automatically fixed
+unfixable = [
+    'F401', # Don't automatically remove unused imports - may be needed later
+
+]
+# extend-exclude moved to main [tool.ruff] section above
+
+# Ruff formatter configuration
+[tool.ruff.format]
+quote-style = "double"  # Use double quotes
+indent-style = "space"   # Use spaces for indentation
+skip-magic-trailing-comma = false  # Respect trailing commas
+line-ending = "lf"       # Use LF line endings (unix-style)
+docstring-code-format = true  # Format code in docstrings
+docstring-code-line-length = 80  # Shorter line length for docstring code
+
+# isort configuration within Ruff
+[tool.ruff.lint.isort]
+known-first-party = ['vexy_formi'] # Treat as first-party imports for sorting
+
+# flake8-tidy-imports configuration within Ruff
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = 'all' # Ban all relative imports for consistency
+
+# Per-file rule exceptions
+[tool.ruff.lint.per-file-ignores]
+# Tests can use magic values, assertions, and relative imports
+'tests/**/*' = [
+    'PLR2004', # Allow magic values in tests for readability
+    'S101', # Allow assertions in tests
+    'TID252'
+    # Allow relative imports in tests for convenience
+]