devlogs 1.0.0__tar.gz

devlogs-1.0.0/LICENSE

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

devlogs-1.0.0/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include src/devlogs/web/static *.html *.css *.js

devlogs-1.0.0/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: devlogs
+Version: 1.0.0
+Summary: Developer-focused logging library for Python with OpenSearch integration.
+Author-email: Dan Driscoll <dan@thedandriscoll.org>
+License: MIT License
+        
+        Copyright (c) 2025 dandriscoll
+        
+        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.
+        
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: opensearch-py>=2.4.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: fastapi>=0.110.0
+Requires-Dist: uvicorn>=0.24.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: mcp>=1.0.0
+Provides-Extra: dev
+Requires-Dist: httpx>=0.26.0; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Dynamic: license-file
+
+# devlogs
+
+A developer-focused logging library for Python with OpenSearch integration.
+
+## Quickstart
+
+1. **Install devlogs:**
+	```sh
+	pip install devlogs
+	```
+
+2. **Start OpenSearch:**
+	```sh
+	docker-compose up -d opensearch
+	```
+	Or point `DEVLOGS_OPENSEARCH_*` at an existing cluster.
+
+3. **Initialize indices/templates:**
+	```sh
+	devlogs init
+	```
+
+4. **Use in Python code:**
+	```python
+	import logging
+	from devlogs.handler import OpenSearchHandler
+	from devlogs.context import operation
+
+	handler = OpenSearchHandler(level=logging.DEBUG)
+	logging.getLogger().addHandler(handler)
+	logging.getLogger().setLevel(logging.DEBUG)
+
+	with operation(area="web"):
+		 logging.info("Hello from devlogs!", extra={"features": {"user": "alice", "plan": "pro"}})
+	```
+
+5. **Tail logs from CLI:**
+	```sh
+	devlogs tail --area web --follow
+	```
+
+6. **Search logs from CLI:**
+	```sh
+	devlogs search --q "error" --area web
+	```
+
+7. **Run the web UI:**
+	```sh
+	uvicorn devlogs.web.server:app --port 8088
+	# Then open http://localhost:8088/ui/
+	```
+
+## Using devlogs in another project
+
+1. **Install devlogs:**
+	```sh
+	pip install devlogs
+	```
+
+2. **Add the diagnostics handler:**
+	```python
+	import logging
+	from devlogs.handler import DiagnosticsHandler
+	from devlogs.opensearch.client import get_opensearch_client
+	from devlogs.context import operation
+
+	client = get_opensearch_client()
+	handler = DiagnosticsHandler(opensearch_client=client, index_name="devlogs-0001")
+	logging.getLogger().addHandler(handler)
+	logging.getLogger().setLevel(logging.DEBUG)
+
+	with operation(area="web"):
+		 logging.info("request started")
+	```
+
+## Features
+
+- Standard `logging.Handler` for OpenSearch
+- Context manager for operation_id/area
+- Structured feature pairs on log entries (`extra={"features": {...}}`)
+- CLI and Linux shell wrapper
+- Minimal embeddable web UI
+- Robust tests (pytest)
+
+## Configuration
+
+Environment variables:
+- OpenSearch connection: `DEVLOGS_OPENSEARCH_HOST`, `DEVLOGS_OPENSEARCH_PORT`, `DEVLOGS_OPENSEARCH_USER`, `DEVLOGS_OPENSEARCH_PASS`
+- Index: `DEVLOGS_INDEX`
+- Retention (supports duration strings like `24h`, `7d`): `DEVLOGS_RETENTION_DEBUG`, `DEVLOGS_RETENTION_INFO`, `DEVLOGS_RETENTION_WARNING`
+
+See [.env.example](.env.example) for a complete configuration template.
+
+## Project Structure
+
+- `src/devlogs/` - Python library, CLI, MCP server, and web UI
+- `devlogs` - Shell wrapper for local development
+- `tests/` - Pytest-based tests
+
+## See Also
+
+- `PROMPT.md` for full requirements

devlogs-1.0.0/README.md

@@ -0,0 +1,102 @@
+# devlogs
+
+A developer-focused logging library for Python with OpenSearch integration.
+
+## Quickstart
+
+1. **Install devlogs:**
+	```sh
+	pip install devlogs
+	```
+
+2. **Start OpenSearch:**
+	```sh
+	docker-compose up -d opensearch
+	```
+	Or point `DEVLOGS_OPENSEARCH_*` at an existing cluster.
+
+3. **Initialize indices/templates:**
+	```sh
+	devlogs init
+	```
+
+4. **Use in Python code:**
+	```python
+	import logging
+	from devlogs.handler import OpenSearchHandler
+	from devlogs.context import operation
+
+	handler = OpenSearchHandler(level=logging.DEBUG)
+	logging.getLogger().addHandler(handler)
+	logging.getLogger().setLevel(logging.DEBUG)
+
+	with operation(area="web"):
+		 logging.info("Hello from devlogs!", extra={"features": {"user": "alice", "plan": "pro"}})
+	```
+
+5. **Tail logs from CLI:**
+	```sh
+	devlogs tail --area web --follow
+	```
+
+6. **Search logs from CLI:**
+	```sh
+	devlogs search --q "error" --area web
+	```
+
+7. **Run the web UI:**
+	```sh
+	uvicorn devlogs.web.server:app --port 8088
+	# Then open http://localhost:8088/ui/
+	```
+
+## Using devlogs in another project
+
+1. **Install devlogs:**
+	```sh
+	pip install devlogs
+	```
+
+2. **Add the diagnostics handler:**
+	```python
+	import logging
+	from devlogs.handler import DiagnosticsHandler
+	from devlogs.opensearch.client import get_opensearch_client
+	from devlogs.context import operation
+
+	client = get_opensearch_client()
+	handler = DiagnosticsHandler(opensearch_client=client, index_name="devlogs-0001")
+	logging.getLogger().addHandler(handler)
+	logging.getLogger().setLevel(logging.DEBUG)
+
+	with operation(area="web"):
+		 logging.info("request started")
+	```
+
+## Features
+
+- Standard `logging.Handler` for OpenSearch
+- Context manager for operation_id/area
+- Structured feature pairs on log entries (`extra={"features": {...}}`)
+- CLI and Linux shell wrapper
+- Minimal embeddable web UI
+- Robust tests (pytest)
+
+## Configuration
+
+Environment variables:
+- OpenSearch connection: `DEVLOGS_OPENSEARCH_HOST`, `DEVLOGS_OPENSEARCH_PORT`, `DEVLOGS_OPENSEARCH_USER`, `DEVLOGS_OPENSEARCH_PASS`
+- Index: `DEVLOGS_INDEX`
+- Retention (supports duration strings like `24h`, `7d`): `DEVLOGS_RETENTION_DEBUG`, `DEVLOGS_RETENTION_INFO`, `DEVLOGS_RETENTION_WARNING`
+
+See [.env.example](.env.example) for a complete configuration template.
+
+## Project Structure
+
+- `src/devlogs/` - Python library, CLI, MCP server, and web UI
+- `devlogs` - Shell wrapper for local development
+- `tests/` - Pytest-based tests
+
+## See Also
+
+- `PROMPT.md` for full requirements

devlogs-1.0.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "devlogs"
+version = "1.0.0"
+description = "Developer-focused logging library for Python with OpenSearch integration."
+requires-python = ">=3.11"
+readme = "README.md"
+license = {file = "LICENSE"}
+authors = [{name = "Dan Driscoll", email = "dan@thedandriscoll.org"}]
+dependencies = [
+  "opensearch-py>=2.4.0",
+  "click>=8.1.0",
+  "typer>=0.9.0",
+  "fastapi>=0.110.0",
+  "uvicorn>=0.24.0",
+  "python-dotenv>=1.0.0",
+  "mcp>=1.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "httpx>=0.26.0",
+  "pytest>=8.0.0",
+  "pytest-asyncio>=0.23.0",
+]
+
+[project.scripts]
+devlogs = "devlogs.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"devlogs.web" = ["static/*.html", "static/*.css", "static/*.js"]
+
+[tool.pytest.ini_options]
+markers = [
+  "integration: marks tests as integration (deselect with '-m \"not integration\"')",
+]

devlogs-1.0.0/setup.cfg

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

devlogs-1.0.0/src/devlogs/__init__.py

@@ -0,0 +1 @@
+# devlogs package