logquill 0.1.0__tar.gz

logquill-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - run: pip install -e ".[dev,http]"
+
+      - run: ruff check .
+
+      - run: mypy logquill
+
+      - run: pytest --cov

logquill-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,29 @@
+name: Publish to PyPI
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
+        with: { python-version: "3.12" }
+      - run: pip install build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with: { name: dist, path: dist/ }
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/logquill
+    permissions:
+      id-token: write # mandatory for trusted publishing — no secrets needed
+    steps:
+      - uses: actions/download-artifact@v4
+        with: { name: dist, path: dist/ }
+      - uses: pypa/gh-action-pypi-publish@release/v1

logquill-0.1.0/.gitignore

@@ -0,0 +1,32 @@
+# ── Secrets & local env — never commit ──────────────────────────────
+.env
+.env.*
+!.env.example
+*.pem
+*.key
+**/secrets/
+
+# ── Python ───────────────────────────────────────────────────────────
+.venv/
+**/__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# ── Editors / OS cruft ───────────────────────────────────────────────
+.DS_Store
+Thumbs.db
+.vscode/*
+!.vscode/extensions.json
+.idea/
+
+# ── Logs produced during local runs/tests ────────────────────────────
+*.log
+*.log.[0-9]
+CLAUDE.md

logquill-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.11.2
+    hooks:
+      - id: mypy
+        additional_dependencies: []
+        args: [--strict, logquill]
+        pass_filenames: false
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer

logquill-0.1.0/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+## Unreleased
+
+- Repo scaffold: `pyproject.toml`, package skeleton, dev tooling (ruff, mypy --strict, pytest), pre-commit hooks, and CI workflow.

logquill-0.1.0/LICENSE

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

logquill-0.1.0/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.5
+Name: logquill
+Version: 0.1.0
+Summary: A structured, leveled logging framework with pluggable transports and a plugin pipeline.
+Project-URL: Homepage, https://github.com/nikhilarora/logquill-python
+Project-URL: Repository, https://github.com/nikhilarora/logquill-python
+Project-URL: Changelog, https://github.com/nikhilarora/logquill-python/blob/main/CHANGELOG.md
+Author: Nikhil Arora
+License-Expression: MIT
+License-File: LICENSE
+Keywords: logger,logging,observability,structured-logging
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: twine>=5.1; extra == 'dev'
+Provides-Extra: hooks
+Requires-Dist: pre-commit>=3.7; extra == 'hooks'
+Provides-Extra: http
+Requires-Dist: aiohttp>=3.9; extra == 'http'
+Description-Content-Type: text/markdown
+
+# logquill
+
+A structured, leveled logging framework for Python with pluggable transports
+and a plugin pipeline. Sibling to [`logquill` on npm](https://www.npmjs.com/package/logquill)
+(`logquill-js`) — same log record shape, same level names, one mental model
+across a Python + Node stack.
+
+Status: pre-release, under active development.
+
+## Development
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,http,hooks]"
+pre-commit install
+
+ruff check .
+mypy logquill
+pytest
+```

logquill-0.1.0/README.md

@@ -0,0 +1,21 @@
+# logquill
+
+A structured, leveled logging framework for Python with pluggable transports
+and a plugin pipeline. Sibling to [`logquill` on npm](https://www.npmjs.com/package/logquill)
+(`logquill-js`) — same log record shape, same level names, one mental model
+across a Python + Node stack.
+
+Status: pre-release, under active development.
+
+## Development
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev,http,hooks]"
+pre-commit install
+
+ruff check .
+mypy logquill
+pytest
+```

logquill-0.1.0/logquill/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

logquill-0.1.0/pyproject.toml

@@ -0,0 +1,70 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "logquill"
+version = "0.1.0"
+description = "A structured, leveled logging framework with pluggable transports and a plugin pipeline."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [{ name = "Nikhil Arora" }]
+keywords = ["logging", "structured-logging", "logger", "observability"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.optional-dependencies]
+http = ["aiohttp>=3.9"]
+dev = [
+    "ruff>=0.6",
+    "mypy>=1.11",
+    "pytest>=8.0",
+    "pytest-asyncio>=0.24",
+    "pytest-cov>=5.0",
+    "build>=1.2",
+    "twine>=5.1",
+]
+hooks = [
+    # Separate from "dev": pre-commit dropped Python 3.8 support, but our
+    # CI matrix still tests 3.8, and pre-commit is only needed locally.
+    "pre-commit>=3.7",
+]
+
+[project.urls]
+Homepage = "https://github.com/nikhilarora/logquill-python"
+Repository = "https://github.com/nikhilarora/logquill-python"
+Changelog = "https://github.com/nikhilarora/logquill-python/blob/main/CHANGELOG.md"
+
+[tool.hatch.build.targets.wheel]
+packages = ["logquill"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py38"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "C4", "SIM"]
+
+[tool.mypy]
+strict = true
+python_version = "3.10"
+files = ["logquill"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.coverage.run]
+source = ["logquill"]

logquill-0.1.0/tests/test_version.py

@@ -0,0 +1,5 @@
+import logquill
+
+
+def test_version_is_a_string() -> None:
+    assert isinstance(logquill.__version__, str)