justmytype 0.1.0__tar.gz

justmytype-0.1.0/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2026 Kaj Wik Siebert
+
+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.

justmytype-0.1.0/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.3
+Name: justmytype
+Version: 0.1.0
+Summary: Cross-platform font discovery and resolution library for Python
+License: MIT
+Author: Kaj Siebert
+Author-email: kaj@k-si.com
+Requires-Python: >=3.10
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Provides-Extra: dev
+Provides-Extra: pillow
+Requires-Dist: Pillow (>=9.0.0) ; extra == "pillow"
+Requires-Dist: coverage (>=7.0.0) ; extra == "dev"
+Requires-Dist: mypy (>=1.0.0) ; extra == "dev"
+Requires-Dist: pytest (>=7.0.0) ; extra == "dev"
+Requires-Dist: pytest-cov (>=4.0.0) ; extra == "dev"
+Requires-Dist: ruff (>=0.1.0) ; extra == "dev"
+Project-URL: Homepage, https://github.com/kws/justmytype
+Project-URL: Issues, https://github.com/kws/justmytype/issues
+Project-URL: Repository, https://github.com/kws/justmytype
+Description-Content-Type: text/markdown
+
+# JustMyType
+
+A precise, lightweight, and extensible font discovery library for Python. JustMyType provides a robust "Font Atlas" for the Python ecosystem—a definitive map of every font available to an application, whether installed on the system or bundled in a Python package.
+
+## Features
+
+- **Cross-platform**: Unified API across macOS, Linux, and Windows
+- **Extensible**: Font packs can be added via standard Python EntryPoints mechanism
+- **Efficient**: Lazy discovery with in-memory caching
+- **Flexible**: Supports font matching by family, weight, style, and width with intelligent fallback
+- **W3C Compliant**: Implements CSS Fonts Level 4 matching algorithm for browser-like behavior
+- **Precise**: Uses `fonttools` to parse binary font tables—never guesses from filenames
+
+## Installation
+
+```bash
+pip install justmytype
+```
+
+For Pillow support (optional, for loading fonts):
+
+```bash
+pip install justmytype[pillow]
+```
+
+## Quick Start
+
+```python
+from justmytype import FontRegistry, get_default_registry
+
+# Get default registry
+registry = get_default_registry()
+
+# Find a font (lazy discovery happens automatically)
+font_info = registry.find_font("Arial", weight=700, style="normal")
+if font_info:
+    # Load as PIL ImageFont (requires Pillow)
+    font = font_info.load(size=16)
+
+    # Or use the path directly
+    print(f"Found font at: {font_info.path}")
+```
+
+## Basic Usage
+
+### Finding Fonts
+
+```python
+from justmytype import FontRegistry
+
+registry = FontRegistry()
+
+# Find by family name
+font_info = registry.find_font("Roboto", weight=400)
+
+# Find with style
+font_info = registry.find_font("Open Sans", weight=700, style="italic")
+
+# Find with width
+font_info = registry.find_font("Arial", width="condensed")
+
+# List all available families
+for family in registry.list_families():
+    print(family)
+```
+
+### Loading Fonts with Pillow
+
+```python
+from justmytype import get_default_registry
+from PIL import Image, ImageDraw, ImageFont
+
+registry = get_default_registry()
+font_info = registry.find_font("Arial", weight=700)
+
+if font_info:
+    # Load as PIL ImageFont
+    font = font_info.load(size=24)
+
+    # Use with PIL
+    img = Image.new("RGB", (200, 100), "white")
+    draw = ImageDraw.Draw(img)
+    draw.text((10, 10), "Hello", font=font, fill="black")
+    img.save("output.png")
+```
+
+### Blocking Font Packs
+
+```python
+# Block system fonts
+registry = FontRegistry(blocklist={"system-fonts"})
+
+# Block via environment variable
+# FONT_DISCOVERY_BLOCKLIST="system-fonts,broken-pack" python app.py
+```
+
+## Creating Font Packs
+
+Font packs can be registered via Python EntryPoints. This allows applications to bundle fonts or third-party packages to provide fonts.
+
+### First-Party Font Pack (Application's Own Fonts)
+
+```python
+# myapp/fonts.py
+from pathlib import Path
+from importlib.resources import files
+
+def get_font_directories():
+    """Entry point factory for application's bundled fonts."""
+    package = files("myapp.fonts")
+    return [Path(str(package))]
+```
+
+```toml
+# pyproject.toml
+[project.entry-points."fontpacks"]
+"myapp-fonts" = "myapp.fonts:get_font_directories"
+```
+
+### Third-Party Font Pack
+
+```python
+# my_font_pack/__init__.py
+from pathlib import Path
+from importlib.resources import files
+
+def get_font_directories():
+    """Entry point factory for font pack."""
+    package = files("my_font_pack.fonts")
+    return [Path(str(package))]
+```
+
+## Architecture
+
+JustMyType follows a unified "Font Pack" architecture where all font sources (system fonts, bundled fonts, third-party fonts) implement the same `FontPack` protocol. This ensures:
+
+- **Consistency**: All fonts are discovered and resolved the same way
+- **Extensibility**: New font sources can be added via EntryPoints
+- **Priority**: Font packs (priority 100) override system fonts (priority 0)
+
+See `docs/architecture.md` for detailed architecture documentation.
+
+## Development
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/justmytype.git
+cd justmytype
+
+# Install with development dependencies
+pip install -e ".[pillow]"
+pip install -e ".[dev]"  # If dev dependencies are configured
+```
+
+### Running Tests
+
+```bash
+# Run tests with coverage
+pytest
+
+# Run with coverage report
+pytest --cov=justmytype --cov-report=html
+```
+
+### Code Quality
+
+```bash
+# Format code
+ruff format .
+
+# Lint code
+ruff check .
+
+# Type checking
+mypy src/
+```
+
+## Requirements
+
+- Python 3.10+
+- `fonttools` (required)
+- `Pillow` (optional, for `FontInfo.load()`)
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Contributing
+
+Contributions are welcome! Please read the architecture documentation in `docs/architecture.md` and follow the project philosophy outlined in `AGENTS.md`.
+

justmytype-0.1.0/README.md

@@ -0,0 +1,192 @@
+# JustMyType
+
+A precise, lightweight, and extensible font discovery library for Python. JustMyType provides a robust "Font Atlas" for the Python ecosystem—a definitive map of every font available to an application, whether installed on the system or bundled in a Python package.
+
+## Features
+
+- **Cross-platform**: Unified API across macOS, Linux, and Windows
+- **Extensible**: Font packs can be added via standard Python EntryPoints mechanism
+- **Efficient**: Lazy discovery with in-memory caching
+- **Flexible**: Supports font matching by family, weight, style, and width with intelligent fallback
+- **W3C Compliant**: Implements CSS Fonts Level 4 matching algorithm for browser-like behavior
+- **Precise**: Uses `fonttools` to parse binary font tables—never guesses from filenames
+
+## Installation
+
+```bash
+pip install justmytype
+```
+
+For Pillow support (optional, for loading fonts):
+
+```bash
+pip install justmytype[pillow]
+```
+
+## Quick Start
+
+```python
+from justmytype import FontRegistry, get_default_registry
+
+# Get default registry
+registry = get_default_registry()
+
+# Find a font (lazy discovery happens automatically)
+font_info = registry.find_font("Arial", weight=700, style="normal")
+if font_info:
+    # Load as PIL ImageFont (requires Pillow)
+    font = font_info.load(size=16)
+
+    # Or use the path directly
+    print(f"Found font at: {font_info.path}")
+```
+
+## Basic Usage
+
+### Finding Fonts
+
+```python
+from justmytype import FontRegistry
+
+registry = FontRegistry()
+
+# Find by family name
+font_info = registry.find_font("Roboto", weight=400)
+
+# Find with style
+font_info = registry.find_font("Open Sans", weight=700, style="italic")
+
+# Find with width
+font_info = registry.find_font("Arial", width="condensed")
+
+# List all available families
+for family in registry.list_families():
+    print(family)
+```
+
+### Loading Fonts with Pillow
+
+```python
+from justmytype import get_default_registry
+from PIL import Image, ImageDraw, ImageFont
+
+registry = get_default_registry()
+font_info = registry.find_font("Arial", weight=700)
+
+if font_info:
+    # Load as PIL ImageFont
+    font = font_info.load(size=24)
+
+    # Use with PIL
+    img = Image.new("RGB", (200, 100), "white")
+    draw = ImageDraw.Draw(img)
+    draw.text((10, 10), "Hello", font=font, fill="black")
+    img.save("output.png")
+```
+
+### Blocking Font Packs
+
+```python
+# Block system fonts
+registry = FontRegistry(blocklist={"system-fonts"})
+
+# Block via environment variable
+# FONT_DISCOVERY_BLOCKLIST="system-fonts,broken-pack" python app.py
+```
+
+## Creating Font Packs
+
+Font packs can be registered via Python EntryPoints. This allows applications to bundle fonts or third-party packages to provide fonts.
+
+### First-Party Font Pack (Application's Own Fonts)
+
+```python
+# myapp/fonts.py
+from pathlib import Path
+from importlib.resources import files
+
+def get_font_directories():
+    """Entry point factory for application's bundled fonts."""
+    package = files("myapp.fonts")
+    return [Path(str(package))]
+```
+
+```toml
+# pyproject.toml
+[project.entry-points."fontpacks"]
+"myapp-fonts" = "myapp.fonts:get_font_directories"
+```
+
+### Third-Party Font Pack
+
+```python
+# my_font_pack/__init__.py
+from pathlib import Path
+from importlib.resources import files
+
+def get_font_directories():
+    """Entry point factory for font pack."""
+    package = files("my_font_pack.fonts")
+    return [Path(str(package))]
+```
+
+## Architecture
+
+JustMyType follows a unified "Font Pack" architecture where all font sources (system fonts, bundled fonts, third-party fonts) implement the same `FontPack` protocol. This ensures:
+
+- **Consistency**: All fonts are discovered and resolved the same way
+- **Extensibility**: New font sources can be added via EntryPoints
+- **Priority**: Font packs (priority 100) override system fonts (priority 0)
+
+See `docs/architecture.md` for detailed architecture documentation.
+
+## Development
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/justmytype.git
+cd justmytype
+
+# Install with development dependencies
+pip install -e ".[pillow]"
+pip install -e ".[dev]"  # If dev dependencies are configured
+```
+
+### Running Tests
+
+```bash
+# Run tests with coverage
+pytest
+
+# Run with coverage report
+pytest --cov=justmytype --cov-report=html
+```
+
+### Code Quality
+
+```bash
+# Format code
+ruff format .
+
+# Lint code
+ruff check .
+
+# Type checking
+mypy src/
+```
+
+## Requirements
+
+- Python 3.10+
+- `fonttools` (required)
+- `Pillow` (optional, for `FontInfo.load()`)
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Contributing
+
+Contributions are welcome! Please read the architecture documentation in `docs/architecture.md` and follow the project philosophy outlined in `AGENTS.md`.

justmytype-0.1.0/pyproject.toml

@@ -0,0 +1,141 @@
+[project]
+name = "justmytype"
+version = "0.1.0"
+description = "Cross-platform font discovery and resolution library for Python"
+authors = [
+    {name = "Kaj Siebert", email = "kaj@k-si.com"}
+]
+license = {text = "MIT"}
+readme = "README.md"
+requires-python = ">=3.10"
+
+[project.optional-dependencies]
+pillow = ["Pillow>=9.0.0"]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "coverage>=7.0.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/kws/justmytype"
+Repository = "https://github.com/kws/justmytype"
+Issues = "https://github.com/kws/justmytype/issues"
+
+[project.entry-points."fontpacks"]
+# Entry point group for font pack discovery
+# Example: "my-font-pack" = "my_font_pack:get_font_directories"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry]
+# Poetry configuration for PEP 621 compatibility
+# All project metadata is defined in [project] above
+
+[tool.poetry.dependencies]
+python = ">=3.10"
+fonttools = ">=4.0.0"
+
+[tool.poetry.group.dev.dependencies]
+pytest = ">=7.0.0"
+pytest-cov = ">=4.0.0"
+coverage = ">=7.0.0"
+ruff = ">=0.1.0"
+mypy = ">=1.0.0"
+pre-commit = ">=3.0.0"
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "N",   # pep8-naming
+    "UP",  # pyupgrade
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+]
+ignore = [
+    "E501",  # line too long (handled by formatter)
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["justmytype"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "--cov=justmytype",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+    "--cov-report=xml",
+    "--cov-fail-under=90",
+]
+markers = [
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+    "integration: marks tests as integration tests",
+]
+
+[tool.coverage.run]
+source = ["src"]
+omit = [
+    "*/tests/*",
+    "*/test_*",
+    "*/__pycache__/*",
+]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+    "class .*\\bProtocol\\):",
+    "if False:",
+]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+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
+strict_equality = true
+show_error_codes = true
+
+[[tool.mypy.overrides]]
+module = [
+    "fonttools.*",
+    "PIL.*",
+]
+ignore_missing_imports = true

justmytype-0.1.0/src/justmytype/__init__.py

@@ -0,0 +1,15 @@
+"""JustMyType - Cross-platform font discovery and resolution library."""
+
+from justmytype.core import FontRegistry, get_default_registry
+from justmytype.packs.factory import create_system_font_pack
+from justmytype.types import FontInfo, FontPack
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "FontInfo",
+    "FontPack",
+    "FontRegistry",
+    "create_system_font_pack",
+    "get_default_registry",
+]