redline-core 0.2.0a1__tar.gz

redline_core-0.2.0a1/.gitignore

@@ -0,0 +1,21 @@
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+dist/
+build/
+site/
+.redline/
+*.db
+*.sqlite3
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+node_modules/
+frontend/dist/
+.DS_Store
+frontend/screenshots/
+
+# agent worktrees
+.claude/

redline_core-0.2.0a1/LICENSE

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

redline_core-0.2.0a1/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.5
+Name: redline-core
+Version: 0.2.0a1
+Summary: Framework-agnostic request profiler engine: span tracing, SQL fingerprinting, N+1 detection, EXPLAIN analysis, storage and the Redline web UI.
+Project-URL: Homepage, https://github.com/Pythondeveloper6/redline
+Project-URL: Documentation, https://pythondeveloper6.github.io/redline/
+Project-URL: Source, https://github.com/Pythondeveloper6/redline
+Project-URL: Issues, https://github.com/Pythondeveloper6/redline/issues
+Project-URL: Changelog, https://github.com/Pythondeveloper6/redline/blob/main/CHANGELOG.md
+Author-email: Mahmoud Ahmed <pythondeveloper6@gmail.com>
+Maintainer-email: Mahmoud Ahmed <pythondeveloper6@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: apm,explain,flamegraph,load-testing,n+1,performance,profiler,profiling,sql
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: System :: Monitoring
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Provides-Extra: asyncpg
+Requires-Dist: asyncpg>=0.29; extra == 'asyncpg'
+Provides-Extra: graphene
+Requires-Dist: graphene>=3.3; extra == 'graphene'
+Provides-Extra: httpx
+Requires-Dist: httpx>=0.27; extra == 'httpx'
+Provides-Extra: load
+Requires-Dist: httpx>=0.27; extra == 'load'
+Provides-Extra: profile
+Requires-Dist: pyinstrument<6.0,>=5.0; extra == 'profile'
+Provides-Extra: psycopg
+Requires-Dist: psycopg>=3.1; extra == 'psycopg'
+Provides-Extra: redis
+Requires-Dist: redis>=5.0; extra == 'redis'
+Provides-Extra: requests
+Requires-Dist: requests>=2.31; extra == 'requests'
+Provides-Extra: sqlalchemy
+Requires-Dist: sqlalchemy<3.0,>=2.0; extra == 'sqlalchemy'
+Provides-Extra: strawberry
+Requires-Dist: strawberry-graphql>=0.240; extra == 'strawberry'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="https://pythondeveloper6.github.io/redline/">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Pythondeveloper6/redline/main/docs/assets/logo-dark.svg">
+      <img alt="Redline" src="https://raw.githubusercontent.com/Pythondeveloper6/redline/main/docs/assets/logo-light.svg" height="56">
+    </picture>
+  </a>
+</p>
+
+# redline-core
+
+The framework-agnostic engine behind **Redline**, a self-hosted request profiler and
+backend analyzer and load tester for Django, FastAPI, Flask and Litestar.
+
+`redline-core` holds everything that does not depend on a web framework:
+
+- the trace/span data model and a `contextvars` recorder that is correct across threads
+  and `asyncio` tasks and costs next to nothing when no request is being recorded;
+- SQL fingerprinting, project-only callsite capture and secret redaction;
+- detectors for N+1 queries, duplicate queries, slow queries and query budgets, plus
+  event-loop blocking, long transactions, huge and unbounded results, `len(qs)` vs `.exists()`,
+  slow serializers and slow, duplicated or retried external calls;
+- an on-demand `EXPLAIN` runner with plan analysis for PostgreSQL, MySQL and SQLite;
+- an optional `pyinstrument` flamegraph profiler (`redline-core[profile]`);
+- a separate SQLite store with a background writer, retention, hourly rollups and release
+  history;
+- a load tester (`redline load`, extra `load`) with an open-model scheduler, knee detection
+  and per-step bottlenecks;
+- optional integrations in `redline_core.contrib` (SQLAlchemy, httpx, requests, redis,
+  asyncpg, psycopg, Marshmallow, Strawberry, Graphene);
+- the access policy and layered configuration shared by every adapter;
+- the framework-neutral JSON API and the prebuilt web UI.
+
+It has **no runtime dependencies**.
+
+## You probably want an adapter
+
+Install the package for your framework; it pulls in `redline-core` for you:
+
+Redline is not on PyPI yet: install from GitHub, naming the adapter **and** `redline-core` in
+one command (the adapter pins the core exactly). Adapters: `django-redline`,
+`fastapi-redline`, `flask-redline`, `litestar-redline`.
+
+```console
+pip install \
+  "django-redline @ git+https://github.com/Pythondeveloper6/redline#subdirectory=packages/django-redline" \
+  "redline-core @ git+https://github.com/Pythondeveloper6/redline#subdirectory=packages/redline-core"
+```
+
+Extras on the core requirement: `profile` (flamegraphs), `load` (the load tester), and
+`httpx`, `requests`, `redis`, `asyncpg`, `psycopg`, `strawberry`, `graphene`. Documentation:
+<https://pythondeveloper6.github.io/redline/>.
+
+## Timing your own code
+
+```python
+import redline_core
+
+@redline_core.span("pricing.compute")
+def compute_price(order): ...
+
+async def handler():
+    async with redline_core.span("fetch-rates", kind="custom", provider="ecb"):
+        ...
+```
+
+`span()` does nothing (and costs almost nothing) outside a recorded request.
+
+## License
+
+MIT

redline_core-0.2.0a1/README.md

@@ -0,0 +1,71 @@
+<p align="center">
+  <a href="https://pythondeveloper6.github.io/redline/">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Pythondeveloper6/redline/main/docs/assets/logo-dark.svg">
+      <img alt="Redline" src="https://raw.githubusercontent.com/Pythondeveloper6/redline/main/docs/assets/logo-light.svg" height="56">
+    </picture>
+  </a>
+</p>
+
+# redline-core
+
+The framework-agnostic engine behind **Redline**, a self-hosted request profiler and
+backend analyzer and load tester for Django, FastAPI, Flask and Litestar.
+
+`redline-core` holds everything that does not depend on a web framework:
+
+- the trace/span data model and a `contextvars` recorder that is correct across threads
+  and `asyncio` tasks and costs next to nothing when no request is being recorded;
+- SQL fingerprinting, project-only callsite capture and secret redaction;
+- detectors for N+1 queries, duplicate queries, slow queries and query budgets, plus
+  event-loop blocking, long transactions, huge and unbounded results, `len(qs)` vs `.exists()`,
+  slow serializers and slow, duplicated or retried external calls;
+- an on-demand `EXPLAIN` runner with plan analysis for PostgreSQL, MySQL and SQLite;
+- an optional `pyinstrument` flamegraph profiler (`redline-core[profile]`);
+- a separate SQLite store with a background writer, retention, hourly rollups and release
+  history;
+- a load tester (`redline load`, extra `load`) with an open-model scheduler, knee detection
+  and per-step bottlenecks;
+- optional integrations in `redline_core.contrib` (SQLAlchemy, httpx, requests, redis,
+  asyncpg, psycopg, Marshmallow, Strawberry, Graphene);
+- the access policy and layered configuration shared by every adapter;
+- the framework-neutral JSON API and the prebuilt web UI.
+
+It has **no runtime dependencies**.
+
+## You probably want an adapter
+
+Install the package for your framework; it pulls in `redline-core` for you:
+
+Redline is not on PyPI yet: install from GitHub, naming the adapter **and** `redline-core` in
+one command (the adapter pins the core exactly). Adapters: `django-redline`,
+`fastapi-redline`, `flask-redline`, `litestar-redline`.
+
+```console
+pip install \
+  "django-redline @ git+https://github.com/Pythondeveloper6/redline#subdirectory=packages/django-redline" \
+  "redline-core @ git+https://github.com/Pythondeveloper6/redline#subdirectory=packages/redline-core"
+```
+
+Extras on the core requirement: `profile` (flamegraphs), `load` (the load tester), and
+`httpx`, `requests`, `redis`, `asyncpg`, `psycopg`, `strawberry`, `graphene`. Documentation:
+<https://pythondeveloper6.github.io/redline/>.
+
+## Timing your own code
+
+```python
+import redline_core
+
+@redline_core.span("pricing.compute")
+def compute_price(order): ...
+
+async def handler():
+    async with redline_core.span("fetch-rates", kind="custom", provider="ecb"):
+        ...
+```
+
+`span()` does nothing (and costs almost nothing) outside a recorded request.
+
+## License
+
+MIT

redline_core-0.2.0a1/pyproject.toml

@@ -0,0 +1,106 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "redline-core"
+version = "0.2.0a1"
+description = "Framework-agnostic request profiler engine: span tracing, SQL fingerprinting, N+1 detection, EXPLAIN analysis, storage and the Redline web UI."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Mahmoud Ahmed", email = "pythondeveloper6@gmail.com" }]
+maintainers = [{ name = "Mahmoud Ahmed", email = "pythondeveloper6@gmail.com" }]
+keywords = [
+    "profiler",
+    "profiling",
+    "performance",
+    "apm",
+    "n+1",
+    "sql",
+    "explain",
+    "flamegraph",
+    "load-testing",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Debuggers",
+    "Topic :: System :: Monitoring",
+    "Typing :: Typed",
+]
+# Deliberately empty. The core is imported into the request path of an application and
+# must never pull a framework (or anything else) into it uninvited. Storage is stdlib
+# sqlite3; the flamegraph profiler is an opt-in extra.
+dependencies = []
+
+[project.optional-dependencies]
+profile = ["pyinstrument>=5.0,<6.0"]
+sqlalchemy = ["sqlalchemy>=2.0,<3.0"]
+httpx = ["httpx>=0.27"]
+requests = ["requests>=2.31"]
+redis = ["redis>=5.0"]
+asyncpg = ["asyncpg>=0.29"]
+psycopg = ["psycopg>=3.1"]
+strawberry = ["strawberry-graphql>=0.240"]
+graphene = ["graphene>=3.3"]
+load = ["httpx>=0.27"]
+
+[project.scripts]
+redline = "redline_core.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/Pythondeveloper6/redline"
+Documentation = "https://pythondeveloper6.github.io/redline/"
+Source = "https://github.com/Pythondeveloper6/redline"
+Issues = "https://github.com/Pythondeveloper6/redline/issues"
+Changelog = "https://github.com/Pythondeveloper6/redline/blob/main/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.3",
+    "pytest-asyncio>=0.24",
+    "ruff>=0.8",
+    "pyinstrument>=5.0",
+    "sqlalchemy[asyncio]>=2.0,<3.0",
+    "aiosqlite>=0.20",
+    "greenlet>=3.0",
+    "httpx>=0.27",
+    "requests>=2.31",
+    "marshmallow>=3.20",
+    "redis>=5.0",
+    "fakeredis>=2.20",
+    "asyncpg>=0.29",
+    "psycopg>=3.1",
+    "strawberry-graphql>=0.240",
+    "graphene>=3.3",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/redline_core"]
+exclude = ["**/__pycache__", "**/*.py[cod]", "**/.DS_Store"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src/redline_core", "/tests", "/README.md", "/LICENSE"]
+exclude = ["**/__pycache__", "**/*.py[cod]", "**/.DS_Store"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--strict-markers -q"
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+markers = [
+    "slow: spawns load-test worker processes (a few seconds each)",
+]
+
+[tool.ruff]
+extend = "../../pyproject.toml"

redline_core-0.2.0a1/src/redline_core/__init__.py

@@ -0,0 +1,66 @@
+"""redline-core: the framework-agnostic engine of Redline.
+
+Redline is a self-hosted request profiler and backend analyzer for Django and FastAPI.
+This package holds everything that does not depend on a web framework – the data model,
+the ``contextvars`` recorder, SQL fingerprinting, callsite capture, redaction, the N+1 /
+duplicate / slow-query detectors, EXPLAIN plan analysis, the optional pyinstrument
+profiler, the SQLite store and the JSON API. It has no runtime dependencies.
+
+Applications install ``django-redline`` or ``fastapi-redline``; the only thing most user
+code touches directly is :func:`span`::
+
+    import redline_core
+
+    @redline_core.span("pricing.compute")
+    def compute_price(order): ...
+
+    async with redline_core.span("fetch-rates", provider="ecb"):
+        ...
+"""
+
+from __future__ import annotations
+
+__version__ = "0.2.0a1"
+
+from .conf import Settings, SettingsError
+from .detect import Detector, FixSuggester, GenericSuggester
+from .model import Callsite, Frame, Issue, Span, Suggestion, Trace
+from .recorder import (
+    Recorder,
+    SpanContext,
+    TraceBuilder,
+    configure,
+    current,
+    finish_trace,
+    get_recorder,
+    record_query,
+    record_span,
+    span,
+    start_trace,
+)
+
+__all__ = [
+    "Callsite",
+    "Detector",
+    "FixSuggester",
+    "Frame",
+    "GenericSuggester",
+    "Issue",
+    "Recorder",
+    "Settings",
+    "SettingsError",
+    "Span",
+    "SpanContext",
+    "Suggestion",
+    "Trace",
+    "TraceBuilder",
+    "__version__",
+    "configure",
+    "current",
+    "finish_trace",
+    "get_recorder",
+    "record_query",
+    "record_span",
+    "span",
+    "start_trace",
+]