logtrace-py 1.0.0__tar.gz

logtrace_py-1.0.0/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2026 Logtrace Ltd (https://logtracehq.com) 
+
+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.

logtrace_py-1.0.0/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: logtrace-py
+Version: 1.0.0
+Summary: Python client for the Logtrace API
+Requires-Python: >=3.11
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Dynamic: license-file

logtrace_py-1.0.0/README.md

@@ -0,0 +1,100 @@
+# logtrace-py
+
+Python client for the Logtrace API. Requires Python ≥ 3.11, no dependencies.
+
+## Install
+
+```bash
+pip install logtrace-py
+```
+
+## Usage
+
+```python
+from logtrace_py import Client, CreateEventRequest
+
+client = Client(api_key=os.environ["LOGTRACE_API_KEY"])
+
+client.create_event(CreateEventRequest(
+    action_name="user.signup",
+    http_method="POST",
+    http_status=201,
+    client_ip="203.0.113.42",
+    client_user_agent=request.headers.get("User-Agent", ""),
+))
+
+client.create_session(CreateSessionRequest(...))
+client.create_audit_log(CreateAuditLogRequest(...))
+```
+
+### Async
+
+```python
+from logtrace_py import AsyncClient
+
+async with AsyncClient(api_key=os.environ["LOGTRACE_API_KEY"]) as client:
+    await client.create_event(CreateEventRequest(...))
+```
+
+## Middleware
+
+Automatically attaches request context (IP, method, endpoint, headers, status code) to every call made inside a handler.
+
+**WSGI (Flask)**
+
+```python
+from logtrace_py import WsgiMiddleware
+
+app.wsgi_app = WsgiMiddleware(app.wsgi_app, client)
+```
+
+**ASGI (FastAPI / Starlette)**
+
+```python
+from logtrace_py import AsgiMiddleware
+
+app.add_middleware(AsgiMiddleware, client=client)
+```
+
+**Django** — add to `settings.py`:
+
+```python
+import logtrace_py
+LOGTRACE_CLIENT = logtrace_py.Client(api_key=os.environ["LOGTRACE_API_KEY"])
+
+MIDDLEWARE = [
+    "logtrace_py.middleware.DjangoMiddleware",
+    ...
+]
+```
+
+Inside any handler:
+
+```python
+from logtrace_py import from_context
+
+rc = from_context(client)
+rc.create_event(CreateEventRequest(...))              # sync
+await rc.async_create_event(CreateEventRequest(...))  # async
+```
+
+## Error handling
+
+```python
+from logtrace_py import LogtraceError
+
+try:
+    client.create_event(req)
+except LogtraceError as e:
+    print(e.status_code, e)
+```
+
+## Options
+
+```python
+Client(
+    api_key="...",
+    base_url="https://api.logtrace.dev/v1/developers",  # default: http://localhost:8080/v1/developers
+    timeout=5.0,                                         # default: 10.0
+)
+```

logtrace_py-1.0.0/logtrace_py.egg-info/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: logtrace-py
+Version: 1.0.0
+Summary: Python client for the Logtrace API
+Requires-Python: >=3.11
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Dynamic: license-file

logtrace_py-1.0.0/logtrace_py.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+logtrace_py.egg-info/PKG-INFO
+logtrace_py.egg-info/SOURCES.txt
+logtrace_py.egg-info/dependency_links.txt
+logtrace_py.egg-info/requires.txt
+logtrace_py.egg-info/top_level.txt

logtrace_py-1.0.0/logtrace_py.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

logtrace_py-1.0.0/logtrace_py.egg-info/requires.txt

@@ -0,0 +1,4 @@
+
+[dev]
+pytest>=8.0
+pytest-asyncio>=0.23

logtrace_py-1.0.0/logtrace_py.egg-info/top_level.txt

@@ -0,0 +1 @@
+

logtrace_py-1.0.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+ 
+[project]
+name = "logtrace-py"
+version = "1.0.0"
+description = "Python client for the Logtrace API"
+requires-python = ">=3.11"
+dependencies = []
+ 
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "pytest-asyncio>=0.23"]
+ 
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["logtrace_py*"]
+ 
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

logtrace_py-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+