findfmt 0.1.0__tar.gz

findfmt-0.1.0/.gitignore

@@ -0,0 +1,73 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# 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
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# Testing and Coverage
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+
+# Type Checking and Tool Caches
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+.ruff_cache/
+.ty_cache/
+
+# Sphinx documentation builds
+docs/_build/
+docs/build/
+docs/source/api/generated/
+
+# Environments and Secrets
+.env
+.env.*
+!.env.example
+*.local
+
+# IDEs and Editors
+.vscode/
+.idea/
+*.sublime-project
+*.sublime-workspace
+*.swp
+*.swo
+*~
+
+# Operating System files
+.DS_Store
+Thumbs.db

findfmt-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brandon Perkins
+
+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.

findfmt-0.1.0/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.5
+Name: findfmt
+Version: 0.1.0
+Summary: A.gitignore-aware file discovery and classification suite that locates files by content format, shebang, and MIME tag for automated linting, formatting, and CI pipelines.
+Project-URL: Changelog, https://github.com/bdperkin/findfmt/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://bdperkin.github.io/findfmt
+Project-URL: Homepage, https://github.com/bdperkin/findfmt
+Project-URL: Issues, https://github.com/bdperkin/findfmt/issues
+Project-URL: Repository, https://github.com/bdperkin/findfmt
+Author-email: Brandon Perkins <bdperkin@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: classification,discovery,find,format,gitignore,identify,linting,mime,shebang
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: identify>=2.6
+Requires-Dist: pathspec>=0.12
+Requires-Dist: tomli>=2.0.1; python_version < '3.11'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="assets/logo.svg" alt="findfmt Logo" width="600" />
+</p>
+
+<p align="center">
+  <a href="https://github.com/bdperkin/findfmt/actions/workflows/ci.yml"><img src="https://github.com/bdperkin/findfmt/actions/workflows/ci.yml/badge.svg" alt="CI Status" /></a>
+  <a href="https://github.com/bdperkin/findfmt/actions/workflows/codeql.yml"><img src="https://github.com/bdperkin/findfmt/actions/workflows/codeql.yml/badge.svg" alt="CodeQL Analysis" /></a>
+  <a href="https://github.com/bdperkin/findfmt/actions/workflows/docs.yml"><img src="https://github.com/bdperkin/findfmt/actions/workflows/docs.yml/badge.svg" alt="Documentation Status" /></a>
+  <a href="https://results.pre-commit.ci/latest/github/bdperkin/findfmt/main"><img src="https://results.pre-commit.ci/badge/github/bdperkin/findfmt/main.svg" alt="pre-commit.ci status" /></a>
+  <a href="https://codecov.io/gh/bdperkin/findfmt"><img src="https://codecov.io/gh/bdperkin/findfmt/branch/main/graph/badge.svg" alt="Coverage" /></a>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/findfmt/"><img src="https://img.shields.io/pypi/v/findfmt.svg?logo=pypi&logoColor=white" alt="PyPI Version" /></a>
+  <a href="https://pypi.org/project/findfmt/"><img src="https://img.shields.io/pypi/pyversions/findfmt.svg?logo=python&logoColor=white" alt="Python Versions" /></a>
+  <a href="https://pypi.org/project/findfmt/"><img src="https://img.shields.io/pypi/wheel/findfmt.svg" alt="PyPI Wheel" /></a>
+  <a href="https://github.com/bdperkin/findfmt/pkgs/container/findfmt"><img src="https://img.shields.io/badge/GHCR-container-blue?logo=docker&logoColor=white" alt="GHCR Container" /></a>
+  <a href="https://github.com/bdperkin/findfmt/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT" /></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/astral-sh/uv"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv" /></a>
+  <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff" /></a>
+  <a href="https://github.com/astral-sh/ty"><img src="https://img.shields.io/badge/type--checked-ty-blueviolet" alt="Type-checked: ty" /></a>
+  <a href="https://interrogate.readthedocs.io/"><img src="https://img.shields.io/badge/interrogate-100%25-brightgreen" alt="Docstring Coverage: 100%" /></a>
+  <a href="https://conventionalcommits.org"><img src="https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg" alt="Conventional Commits" /></a>
+  <a href="ACCESSIBILITY.md"><img src="https://img.shields.io/badge/accessibility-WCAG%202.1%20AA-blue" alt="Accessibility WCAG 2.1 AA" /></a>
+</p>
+
+______________________________________________________________________
+
+> **A `.gitignore`-aware file discovery and classification suite that locates files by content
+> format, shebang, and MIME tag for automated linting, formatting, and CI pipelines.**
+
+## 1. Why findfmt?
+
+Unlike traditional `find` or globbing tools that rely strictly on file extensions, `findfmt`:
+
+- **Understands file content**: Identifies format by content, shebang (`#!/usr/bin/env python3`),
+  and MIME types using the `identify` engine.
+- **Respects Git**: Traverses trees hierarchically while pruning `.gitignore` and
+  `.git/info/exclude` paths early before descending into large directories (e.g. `node_modules/`,
+  `.venv/`).
+- **Deterministic**: Always returns clean, relative, deterministically sorted paths optimized for
+  subshells, xargs, and automation.
+
+______________________________________________________________________
+
+## 2. Installation
+
+### 2.1. With `uv` (Recommended)
+
+Run directly with `uvx`:
+
+```bash
+uvx findfmt --help
+```
+
+Install globally:
+
+```bash
+uv tool install findfmt
+```
+
+Or add to your project:
+
+```bash
+uv add findfmt
+```
+
+### 2.2. With `pip`
+
+```bash
+pip install findfmt
+```
+
+### 2.3. With Docker / Container
+
+```bash
+docker pull ghcr.io/bdperkin/findfmt:latest
+docker run --rm -v "$(pwd)":/workspace -w /workspace ghcr.io/bdperkin/findfmt:latest -t python
+```
+
+______________________________________________________________________
+
+## 3. Usage
+
+### 3.1. Locate Files by Tag / Format
+
+```bash
+# Locate all Python files
+findfmt -t python
+
+# Locate all YAML and JSON files
+findfmt -t yaml,json
+
+# Locate shell scripts
+findfmt -t shell
+```
+
+### 3.2. Shebang Filtering
+
+```bash
+# Locate files with bash shebang
+findfmt --shebang bash
+
+# Locate scripts executing with python
+findfmt --shebang python
+```
+
+### 3.3. Pipe Safely to Linters and Tools
+
+Use `-0` for NUL-delimited output with `xargs -0`:
+
+```bash
+# Format discovered Python files
+findfmt -t python -0 | xargs -0 ruff format
+
+# Lint shell scripts with shellcheck
+findfmt -t shell -0 | xargs -r -0 shellcheck
+```
+
+### 3.4. Inspect Tags & Summaries
+
+```bash
+# Print matched files and their classification tags
+findfmt -l -t python
+
+# Print summary statistics to stderr
+findfmt -s
+```
+
+______________________________________________________________________
+
+## 4. CLI Options
+
+| Flag                           | Description                                        |
+| ------------------------------ | -------------------------------------------------- |
+| `-t, --tag, --type`            | Match files containing specified tag(s)            |
+| `-e, --exclude, --exclude-tag` | Exclude files containing specified tag(s)          |
+| `--all-tags`                   | Require match against all include tags (AND logic) |
+| `--shebang`                    | Match shebang interpreter name or pattern          |
+| `--no-ignore`                  | Do not prune paths matching `.gitignore`           |
+| `--hidden`                     | Inspect hidden files and directories               |
+| `-0, --print0`                 | NUL-delimited output for `xargs -0`                |
+| `-l, --list-tags`              | Print tags alongside file paths                    |
+| `-s, --summary`                | Print match frequencies to stderr                  |
+| `--absolute`                   | Output absolute rather than relative paths         |
+| `--known-tags`                 | List all supported classification tags             |
+| `-v, --version`                | Display version and exit                           |
+
+______________________________________________________________________
+
+## 5. Development & Testing
+
+This project enforces 100% test coverage and strict type checking:
+
+```bash
+# Clone the repository
+git clone https://github.com/bdperkin/findfmt.git
+cd findfmt
+
+# Install dependencies with uv
+uv sync --all-groups
+
+# Run tests and verify 100% coverage
+uv run pytest
+
+# Run linting and typing
+uv run ruff check
+uv run ty check
+
+# Run full verification suite
+uv run python tools/verify_quality.py
+```
+
+______________________________________________________________________
+
+## 6. Governance & Community
+
+- [Contributing Guidelines](CONTRIBUTING.md)
+- [Code of Conduct](CODE_OF_CONDUCT.md)
+- [Security Policy](SECURITY.md)
+- [Support Information](SUPPORT.md)
+- [Accessibility Statement](ACCESSIBILITY.md)
+
+## 7. License
+
+[MIT License](LICENSE) © 2026 Brandon Perkins.

findfmt-0.1.0/README.md

@@ -0,0 +1,189 @@
+<p align="center">
+  <img src="assets/logo.svg" alt="findfmt Logo" width="600" />
+</p>
+
+<p align="center">
+  <a href="https://github.com/bdperkin/findfmt/actions/workflows/ci.yml"><img src="https://github.com/bdperkin/findfmt/actions/workflows/ci.yml/badge.svg" alt="CI Status" /></a>
+  <a href="https://github.com/bdperkin/findfmt/actions/workflows/codeql.yml"><img src="https://github.com/bdperkin/findfmt/actions/workflows/codeql.yml/badge.svg" alt="CodeQL Analysis" /></a>
+  <a href="https://github.com/bdperkin/findfmt/actions/workflows/docs.yml"><img src="https://github.com/bdperkin/findfmt/actions/workflows/docs.yml/badge.svg" alt="Documentation Status" /></a>
+  <a href="https://results.pre-commit.ci/latest/github/bdperkin/findfmt/main"><img src="https://results.pre-commit.ci/badge/github/bdperkin/findfmt/main.svg" alt="pre-commit.ci status" /></a>
+  <a href="https://codecov.io/gh/bdperkin/findfmt"><img src="https://codecov.io/gh/bdperkin/findfmt/branch/main/graph/badge.svg" alt="Coverage" /></a>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/findfmt/"><img src="https://img.shields.io/pypi/v/findfmt.svg?logo=pypi&logoColor=white" alt="PyPI Version" /></a>
+  <a href="https://pypi.org/project/findfmt/"><img src="https://img.shields.io/pypi/pyversions/findfmt.svg?logo=python&logoColor=white" alt="Python Versions" /></a>
+  <a href="https://pypi.org/project/findfmt/"><img src="https://img.shields.io/pypi/wheel/findfmt.svg" alt="PyPI Wheel" /></a>
+  <a href="https://github.com/bdperkin/findfmt/pkgs/container/findfmt"><img src="https://img.shields.io/badge/GHCR-container-blue?logo=docker&logoColor=white" alt="GHCR Container" /></a>
+  <a href="https://github.com/bdperkin/findfmt/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT" /></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/astral-sh/uv"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv" /></a>
+  <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff" /></a>
+  <a href="https://github.com/astral-sh/ty"><img src="https://img.shields.io/badge/type--checked-ty-blueviolet" alt="Type-checked: ty" /></a>
+  <a href="https://interrogate.readthedocs.io/"><img src="https://img.shields.io/badge/interrogate-100%25-brightgreen" alt="Docstring Coverage: 100%" /></a>
+  <a href="https://conventionalcommits.org"><img src="https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg" alt="Conventional Commits" /></a>
+  <a href="ACCESSIBILITY.md"><img src="https://img.shields.io/badge/accessibility-WCAG%202.1%20AA-blue" alt="Accessibility WCAG 2.1 AA" /></a>
+</p>
+
+______________________________________________________________________
+
+> **A `.gitignore`-aware file discovery and classification suite that locates files by content
+> format, shebang, and MIME tag for automated linting, formatting, and CI pipelines.**
+
+## 1. Why findfmt?
+
+Unlike traditional `find` or globbing tools that rely strictly on file extensions, `findfmt`:
+
+- **Understands file content**: Identifies format by content, shebang (`#!/usr/bin/env python3`),
+  and MIME types using the `identify` engine.
+- **Respects Git**: Traverses trees hierarchically while pruning `.gitignore` and
+  `.git/info/exclude` paths early before descending into large directories (e.g. `node_modules/`,
+  `.venv/`).
+- **Deterministic**: Always returns clean, relative, deterministically sorted paths optimized for
+  subshells, xargs, and automation.
+
+______________________________________________________________________
+
+## 2. Installation
+
+### 2.1. With `uv` (Recommended)
+
+Run directly with `uvx`:
+
+```bash
+uvx findfmt --help
+```
+
+Install globally:
+
+```bash
+uv tool install findfmt
+```
+
+Or add to your project:
+
+```bash
+uv add findfmt
+```
+
+### 2.2. With `pip`
+
+```bash
+pip install findfmt
+```
+
+### 2.3. With Docker / Container
+
+```bash
+docker pull ghcr.io/bdperkin/findfmt:latest
+docker run --rm -v "$(pwd)":/workspace -w /workspace ghcr.io/bdperkin/findfmt:latest -t python
+```
+
+______________________________________________________________________
+
+## 3. Usage
+
+### 3.1. Locate Files by Tag / Format
+
+```bash
+# Locate all Python files
+findfmt -t python
+
+# Locate all YAML and JSON files
+findfmt -t yaml,json
+
+# Locate shell scripts
+findfmt -t shell
+```
+
+### 3.2. Shebang Filtering
+
+```bash
+# Locate files with bash shebang
+findfmt --shebang bash
+
+# Locate scripts executing with python
+findfmt --shebang python
+```
+
+### 3.3. Pipe Safely to Linters and Tools
+
+Use `-0` for NUL-delimited output with `xargs -0`:
+
+```bash
+# Format discovered Python files
+findfmt -t python -0 | xargs -0 ruff format
+
+# Lint shell scripts with shellcheck
+findfmt -t shell -0 | xargs -r -0 shellcheck
+```
+
+### 3.4. Inspect Tags & Summaries
+
+```bash
+# Print matched files and their classification tags
+findfmt -l -t python
+
+# Print summary statistics to stderr
+findfmt -s
+```
+
+______________________________________________________________________
+
+## 4. CLI Options
+
+| Flag                           | Description                                        |
+| ------------------------------ | -------------------------------------------------- |
+| `-t, --tag, --type`            | Match files containing specified tag(s)            |
+| `-e, --exclude, --exclude-tag` | Exclude files containing specified tag(s)          |
+| `--all-tags`                   | Require match against all include tags (AND logic) |
+| `--shebang`                    | Match shebang interpreter name or pattern          |
+| `--no-ignore`                  | Do not prune paths matching `.gitignore`           |
+| `--hidden`                     | Inspect hidden files and directories               |
+| `-0, --print0`                 | NUL-delimited output for `xargs -0`                |
+| `-l, --list-tags`              | Print tags alongside file paths                    |
+| `-s, --summary`                | Print match frequencies to stderr                  |
+| `--absolute`                   | Output absolute rather than relative paths         |
+| `--known-tags`                 | List all supported classification tags             |
+| `-v, --version`                | Display version and exit                           |
+
+______________________________________________________________________
+
+## 5. Development & Testing
+
+This project enforces 100% test coverage and strict type checking:
+
+```bash
+# Clone the repository
+git clone https://github.com/bdperkin/findfmt.git
+cd findfmt
+
+# Install dependencies with uv
+uv sync --all-groups
+
+# Run tests and verify 100% coverage
+uv run pytest
+
+# Run linting and typing
+uv run ruff check
+uv run ty check
+
+# Run full verification suite
+uv run python tools/verify_quality.py
+```
+
+______________________________________________________________________
+
+## 6. Governance & Community
+
+- [Contributing Guidelines](CONTRIBUTING.md)
+- [Code of Conduct](CODE_OF_CONDUCT.md)
+- [Security Policy](SECURITY.md)
+- [Support Information](SUPPORT.md)
+- [Accessibility Statement](ACCESSIBILITY.md)
+
+## 7. License
+
+[MIT License](LICENSE) © 2026 Brandon Perkins.

findfmt-0.1.0/docs/Makefile

@@ -0,0 +1,33 @@
+# Minimal Makefile for Sphinx documentation
+
+SPHINXOPTS    ?= -W --keep-going
+SPHINXBUILD   ?= uv run sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = _build
+DOCTREEDIR    = $(BUILDDIR)/doctrees
+
+.PHONY: help Makefile html epub man latex linkcheck clean
+
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+html:
+	@$(SPHINXBUILD) -b html -d "$(DOCTREEDIR)" "$(SOURCEDIR)" "$(BUILDDIR)/html" $(SPHINXOPTS)
+
+epub:
+	@$(SPHINXBUILD) -b epub -d "$(DOCTREEDIR)" "$(SOURCEDIR)" "$(BUILDDIR)/epub" $(SPHINXOPTS)
+
+man:
+	@$(SPHINXBUILD) -b man -d "$(DOCTREEDIR)" "$(SOURCEDIR)" "$(BUILDDIR)/man" $(SPHINXOPTS)
+
+latex:
+	@$(SPHINXBUILD) -b latex -d "$(DOCTREEDIR)" "$(SOURCEDIR)" "$(BUILDDIR)/latex" $(SPHINXOPTS)
+
+linkcheck:
+	@$(SPHINXBUILD) -b linkcheck -d "$(DOCTREEDIR)" "$(SOURCEDIR)" "$(BUILDDIR)/linkcheck" $(SPHINXOPTS)
+
+clean:
+	rm -rf "$(BUILDDIR)"
+
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

findfmt-0.1.0/docs/source/_static/custom.css

@@ -0,0 +1,9 @@
+/* Custom styling enhancements for findfmt Sphinx documentation */
+:root {
+  --color-brand-primary: #38bdf8;
+  --color-brand-content: #818cf8;
+}
+
+.sidebar-brand img {
+  max-height: 48px;
+}

findfmt-0.1.0/docs/source/_static/icon.svg

@@ -0,0 +1,50 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" width="100%" height="100%">
+  <defs>
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#0f172a" />
+      <stop offset="100%" stop-color="#1e293b" />
+    </linearGradient>
+    <linearGradient id="accentGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#38bdf8" />
+      <stop offset="50%" stop-color="#818cf8" />
+      <stop offset="100%" stop-color="#c084fc" />
+    </linearGradient>
+    <linearGradient id="lensGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#38bdf8" stop-opacity="0.2" />
+      <stop offset="100%" stop-color="#818cf8" stop-opacity="0.05" />
+    </linearGradient>
+    <filter id="glow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="5" result="blur" />
+      <feComposite in="SourceGraphic" in2="blur" operator="over" />
+    </filter>
+  </defs>
+
+  <!-- Background Rounded Square -->
+  <rect width="200" height="200" rx="44" fill="url(#bgGrad)" stroke="#334155" stroke-width="2" />
+
+  <!-- Mark Component Centered -->
+  <g transform="translate(14, 18)">
+    <!-- File Stacks -->
+    <rect x="20" y="25" width="60" height="80" rx="6" fill="#1e293b" stroke="#475569" stroke-width="2" />
+    <line x1="32" y1="45" x2="68" y2="45" stroke="#64748b" stroke-width="2" stroke-linecap="round" />
+    <line x1="32" y1="58" x2="60" y2="58" stroke="#64748b" stroke-width="2" stroke-linecap="round" />
+    <line x1="32" y1="71" x2="52" y2="71" stroke="#64748b" stroke-width="2" stroke-linecap="round" />
+
+    <!-- Magnifying Scanner Lens -->
+    <circle cx="85" cy="75" r="48" fill="url(#lensGrad)" stroke="url(#accentGrad)" stroke-width="4" filter="url(#glow)" />
+    <line x1="120" y1="110" x2="148" y2="138" stroke="url(#accentGrad)" stroke-width="6" stroke-linecap="round" />
+
+    <!-- Floating Format Badges Inside Lens -->
+    <!-- Python Badge -->
+    <rect x="58" y="48" width="28" height="16" rx="4" fill="#0284c7" fill-opacity="0.85" />
+    <text x="72" y="60" fill="#ffffff" font-family="system-ui, -apple-system, sans-serif" font-size="10" font-weight="700" text-anchor="middle">.py</text>
+
+    <!-- Shebang Badge -->
+    <rect x="72" y="70" width="30" height="16" rx="4" fill="#7c3aed" fill-opacity="0.85" />
+    <text x="87" y="82" fill="#ffffff" font-family="system-ui, -apple-system, sans-serif" font-size="10" font-weight="700" text-anchor="middle">#!/</text>
+
+    <!-- MIME Tag Badge -->
+    <rect x="52" y="90" width="34" height="16" rx="4" fill="#059669" fill-opacity="0.85" />
+    <text x="69" y="102" fill="#ffffff" font-family="system-ui, -apple-system, sans-serif" font-size="9" font-weight="700" text-anchor="middle">MIME</text>
+  </g>
+</svg>