checktrace 0.0.1__tar.gz

checktrace-0.0.1/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: checktrace
+Version: 0.0.1
+Summary: Placeholder for checktrace SDK. Install from pip.muid.io for full version.
+Project-URL: Homepage, https://muid.io
+Project-URL: Repository, https://github.com/muid-io/checktrace
+Project-URL: Documentation, https://pip.muid.io
+Author-email: "MUID.io" <dev@muid.io>
+License-Expression: MIT
+Keywords: distributed,observability,placeholder,tracing
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# checktrace
+
+**This is a placeholder package on PyPI.**
+
+The full checktrace SDK (Python SDK for distributed tracing via TraceHub) is available from our private package index.
+
+## Installation
+
+```bash
+pip install checktrace --extra-index-url https://pip.muid.io/simple/
+```
+
+With FastAPI middleware support:
+
+```bash
+pip install "checktrace[middleware]" --extra-index-url https://pip.muid.io/simple/
+```
+
+## Features (in full version)
+
+- Config-driven tracing initialization
+- ContextVar-based correlation ID propagation (async-safe)
+- Auto-redaction of sensitive data
+- Non-blocking trace sending (background thread)
+- FastAPI middleware for automatic request tracing
+- `@checkpoint` decorator for function tracing
+- CLI for querying traces (`checktrace list/get/stream`)
+
+## Quick Start (after installing from pip.muid.io)
+
+```python
+from checktrace import CheckTraceConfig, init_tracing, checkpoint
+
+config = CheckTraceConfig(
+    tracehub_url="http://tracehub:8099",
+    project_name="myapp",
+    default_source_id="MA",
+)
+init_tracing(config)
+
+@checkpoint("MA", "process_request")
+async def process_request(data: dict):
+    return {"status": "ok"}
+```
+
+## Links
+
+- **Full package:** https://pip.muid.io/simple/checktrace/
+- **Documentation:** https://github.com/muid-io/checktrace
+- **MUID.io:** https://muid.io
+
+## License
+
+MIT

checktrace-0.0.1/README.md

@@ -0,0 +1,54 @@
+# checktrace
+
+**This is a placeholder package on PyPI.**
+
+The full checktrace SDK (Python SDK for distributed tracing via TraceHub) is available from our private package index.
+
+## Installation
+
+```bash
+pip install checktrace --extra-index-url https://pip.muid.io/simple/
+```
+
+With FastAPI middleware support:
+
+```bash
+pip install "checktrace[middleware]" --extra-index-url https://pip.muid.io/simple/
+```
+
+## Features (in full version)
+
+- Config-driven tracing initialization
+- ContextVar-based correlation ID propagation (async-safe)
+- Auto-redaction of sensitive data
+- Non-blocking trace sending (background thread)
+- FastAPI middleware for automatic request tracing
+- `@checkpoint` decorator for function tracing
+- CLI for querying traces (`checktrace list/get/stream`)
+
+## Quick Start (after installing from pip.muid.io)
+
+```python
+from checktrace import CheckTraceConfig, init_tracing, checkpoint
+
+config = CheckTraceConfig(
+    tracehub_url="http://tracehub:8099",
+    project_name="myapp",
+    default_source_id="MA",
+)
+init_tracing(config)
+
+@checkpoint("MA", "process_request")
+async def process_request(data: dict):
+    return {"status": "ok"}
+```
+
+## Links
+
+- **Full package:** https://pip.muid.io/simple/checktrace/
+- **Documentation:** https://github.com/muid-io/checktrace
+- **MUID.io:** https://muid.io
+
+## License
+
+MIT

checktrace-0.0.1/README.md.toc

@@ -0,0 +1,54 @@
+---
+source_file: "README.md"
+generated_date: "2026-02-10"
+generated_time: "18:33:44"
+generated_timestamp: "2026-02-10T18:33:44.416353"
+file_hash_sha256: "0f8ee74ed1e2d13121de8d9cb8694ca990c4a412cb9eeea2c20ed14ff55ff34b"
+file_size_bytes: 1336
+total_lines: 54
+word_count: 140
+char_count: 1336
+sections_count: 0
+headers_count: 6
+encoding: "utf-8"
+format_type: "markdown"
+format_detection: "auto"
+format_confidence: 1.0
+toc_generator_version: "3.7.0"
+---
+
+## 📑 CURRENT DOCUMENT TABLE OF CONTENTS
+
+*Generated by [smart-toc v3.7.0](https://www.npmjs.com/package/@muid-io/smart-toc) • [LifeAiTools](https://muid.io) • `npx @muid-io/smart-toc`*
+
+### 🤖 MANDATORY AI NAVIGATION INSTRUCTIONS
+
+**⚠️ CRITICAL: When working with this document, you MUST:**
+1. **USE THE LINE NUMBERS** from the Navigation Table below to jump directly to sections
+2. **USE THE SECTION SEARCH COMMANDS** provided in the table for precise navigation
+3. **DO NOT GUESS** or search manually - the TOC provides exact locations
+4. **ALWAYS CHECK THE TOC FIRST** before searching for any content in this document
+
+**Example Usage:**
+- To find "MinIO Buckets": Check table → Line 400 → Jump directly there
+- To search section: Use the exact command from "Section Search Command" column
+- Box-drawing characters (├──, │) represent hierarchical nested content
+
+**This TOC is auto-generated with exact line numbers. Trust it completely.**
+
+### File Structure Overview
+- Total lines: 54
+- Total sections: 0
+- Total headers (depth ≤ 3): 6
+
+### Navigation Table
+
+| Section/Header                                  | Line(s) | Description                  | Section Search Command                         |          |
+| ----------------------------------------------- | ------- | ---------------------------- | ---------------------------------------------- | -------- |
+| checktrace                                      | 1 (54)  | [Check section for contents] | `grep -n "^#\{1,6\}.*checktrace"               | head -1` |
+| Installation                                    | 7 (12)  | [Check section for contents] | `grep -n "^#\{1,6\}.*Installation"             | head -1` |
+| Features (in full version)                      | 19 (10) | [Check section for contents] | `grep -n "^#\{1,6\}.*Features\ \(in\ full\ ve" | head -1` |
+| Quick Start (after installing from pip.muid.io) | 29 (17) | [Check section for contents] | `grep -n "^#\{1,6\}.*Quick\ Start\ \(after\ i" | head -1` |
+| Links                                           | 46 (6)  | [Check section for contents] | `grep -n "^#\{1,6\}.*Links"                    | head -1` |
+| License                                         | 52 (3)  | [Check section for contents] | `grep -n "^#\{1,6\}.*License"                  | head -1` |
+

checktrace-0.0.1/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "checktrace"
+version = "0.0.1"
+description = "Placeholder for checktrace SDK. Install from pip.muid.io for full version."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+authors = [
+    { name = "MUID.io", email = "dev@muid.io" }
+]
+keywords = ["tracing", "distributed", "observability", "placeholder"]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+]
+
+[project.urls]
+Homepage = "https://muid.io"
+Repository = "https://github.com/muid-io/checktrace"
+Documentation = "https://pip.muid.io"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/checktrace"]

checktrace-0.0.1/src/checktrace/__init__.py

@@ -0,0 +1,44 @@
+"""
+checktrace - Python SDK for distributed tracing via TraceHub.
+
+NOTE: This is a placeholder package. The full implementation is available at:
+
+    pip install checktrace --extra-index-url https://pip.muid.io/simple/
+
+For documentation, see: https://github.com/muid-io/checktrace
+"""
+
+__version__ = "0.0.1"
+
+_INSTALL_MESSAGE = """
+================================================================================
+checktrace: This is a placeholder package on PyPI.
+
+The full checktrace SDK is available from pip.muid.io:
+
+    pip install checktrace --extra-index-url https://pip.muid.io/simple/
+
+Or with FastAPI middleware support:
+
+    pip install "checktrace[middleware]" --extra-index-url https://pip.muid.io/simple/
+
+Documentation: https://github.com/muid-io/checktrace
+================================================================================
+"""
+
+def _show_install_message():
+    print(_INSTALL_MESSAGE)
+
+# Show message on import
+_show_install_message()
+
+# Raise error if someone tries to use it
+class CheckTraceConfig:
+    def __init__(self, *args, **kwargs):
+        raise NotImplementedError(_INSTALL_MESSAGE)
+
+def init_tracing(*args, **kwargs):
+    raise NotImplementedError(_INSTALL_MESSAGE)
+
+def checkpoint(*args, **kwargs):
+    raise NotImplementedError(_INSTALL_MESSAGE)