netra-sdk 0.1.0__tar.gz → 0.1.1__tar.gz

{netra_sdk-0.1.0 → netra_sdk-0.1.1}/LICENCE

@@ -198,4 +198,4 @@
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
-   limitations under the License.
+   limitations under the License.

netra_sdk-0.1.0/README.md → netra_sdk-0.1.1/PKG-INFO

@@ -1,3 +1,82 @@
+Metadata-Version: 2.3
+Name: netra-sdk
+Version: 0.1.1
+Summary: A Python SDK for AI application observability that provides OpenTelemetry-based monitoring, tracing, and PII protection for LLM and vector database applications. Enables easy instrumentation, session tracking, and privacy-focused data collection for AI systems in production environments.
+License: Apache-2.0
+Keywords: netra,tracing,observability,sdk,ai,llm,vector,database
+Author: Sooraj Thomas
+Author-email: sooraj@keyvalue.systems
+Requires-Python: >=3.10,<3.13
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: OpenTelemetry
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+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: Typing :: Typed
+Provides-Extra: llm-guard
+Requires-Dist: llm-guard (>=0.3.16,<0.4.0) ; extra == "llm-guard"
+Requires-Dist: opentelemetry-api (>=1.34.0,<2.0.0)
+Requires-Dist: opentelemetry-instrumentation-aio-pika (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-aiohttp-client (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-aiohttp-server (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-aiokafka (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-aiopg (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-asyncclick (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-asyncio (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-asyncpg (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-aws-lambda (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-boto (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-boto3sqs (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-botocore (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-cassandra (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-celery (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-click (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-confluent-kafka (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-django (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-elasticsearch (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-falcon (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-fastapi (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-flask (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-grpc (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-httpx (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-jinja2 (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-kafka-python (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-logging (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-mysql (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-mysqlclient (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-pika (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-psycopg (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-psycopg2 (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-pymemcache (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-pymongo (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-pymssql (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-pymysql (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-pyramid (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-redis (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-remoulade (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-requests (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-sqlalchemy (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-sqlite3 (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-starlette (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-system-metrics (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-threading (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-tornado (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-tortoiseorm (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-urllib (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-instrumentation-urllib3 (>=0.55b1,<1.0.0)
+Requires-Dist: opentelemetry-sdk (>=1.34.0,<2.0.0)
+Requires-Dist: presidio-analyzer (>=2.2.358,<3.0.0)
+Requires-Dist: traceloop-sdk (>=0.40.7,<0.41.0)
+Project-URL: Bug Tracker, https://github.com/KeyValueSoftwareSystems/netra-sdk-py/issues
+Project-URL: Documentation, https://github.com/KeyValueSoftwareSystems/netra-sdk-py/blob/main/README.md
+Project-URL: Homepage, https://github.com/KeyValueSoftwareSystems/netra-sdk-py
+Project-URL: Repository, https://github.com/KeyValueSoftwareSystems/netra-sdk-py
+Description-Content-Type: text/markdown
+
 # Netra SDK
 
 🚀 **Netra SDK** is a comprehensive Python library for AI application observability that provides OpenTelemetry-based monitoring, and tracing for LLM applications. It enables easy instrumentation, session tracking, and privacy-focused data analysis for AI systems.
@@ -146,16 +225,47 @@ class CustomerSupportAgent:
 - **AIOHTTP** - Asynchronous HTTP client/server
 - **FastAPI** - Modern web framework for APIs
 - **Requests** - Popular HTTP library for Python
-- **urllib3** - Low-level HTTP client library
+- **Django** - High-level Python web framework
+- **Flask** - Lightweight WSGI web application framework
+- **Falcon** - High-performance Python web framework
+- **Pyramid** - Small, fast, down-to-earth Python web framework
+- **Starlette** - Lightweight ASGI framework/toolkit
+- **Tornado** - Asynchronous networking library and web framework
+- **gRPC** - High-performance, open-source universal RPC framework
+- **Urllib** - Standard Python HTTP client library
+- **Urllib3** - Powerful, user-friendly HTTP client for Python
 
 ### 🗄️ Database Clients
 
 - **PyMySQL** - Pure Python MySQL client
 - **Redis** - In-memory data structure store
+- **SQLAlchemy** - SQL toolkit and Object-Relational Mapper
+- **Psycopg** - Modern PostgreSQL database adapter for Python
+- **Pymongo** - Python driver for MongoDB
+- **Elasticsearch** - Distributed, RESTful search and analytics engine
+- **Cassandra** - Distributed NoSQL database
+- **PyMSSQL** - Simple Microsoft SQL Server client
+- **MySQL Connector** - Official MySQL driver
+- **Sqlite3** - Built-in SQL database engine
+- **Aiopg** - Asynchronous PostgreSQL client
+- **Asyncpg** - Fast asynchronous PostgreSQL client
+- **Pymemcache** - Comprehensive Memcached client
+- **Tortoise ORM** - Easy-to-use asyncio ORM
+
+### 📨 Messaging & Task Queues
+
+- **Celery** - Distributed task queue
+- **Pika** - Pure-Python implementation of the AMQP 0-9-1 protocol
+- **AIO Pika** - Asynchronous AMQP client
+- **Kafka-Python** - Python client for Apache Kafka
+- **AIOKafka** - Asynchronous Python client for Kafka
+- **Confluent-Kafka** - Confluent's Python client for Apache Kafka
+- **Boto3 SQS** - Amazon SQS client via Boto3
 
 ### 🔧 AI Frameworks & Orchestration
 
 - **LangChain** - Framework for developing LLM applications
+- **LangGraph** - Modern framework for LLM applications
 - **LlamaIndex** - Data framework for LLM applications
 - **Haystack** - End-to-end NLP framework
 - **CrewAI** - Multi-agent AI systems
@@ -330,6 +440,72 @@ with Netra.start_session("video_generation_task") as session:
 
 ## 🔧 Advanced Configuration
 
+### Environment Variables
+
+Netra SDK can be configured using the following environment variables:
+
+#### Netra-specific Variables
+
+| Variable Name | Description | Default |
+|---------------|-------------|---------|
+| `NETRA_APP_NAME` | Logical name for your service | Falls back to `OTEL_SERVICE_NAME` or `llm_tracing_service` |
+| `NETRA_OTLP_ENDPOINT` | URL for OTLP collector | Falls back to `OTEL_EXPORTER_OTLP_ENDPOINT` |
+| `NETRA_API_KEY` | API key for authentication | `None` |
+| `NETRA_HEADERS` | Additional headers in W3C Correlation-Context format | `None` |
+| `NETRA_DISABLE_BATCH` | Disable batch span processor (`true`/`false`) | `false` |
+| `NETRA_TRACE_CONTENT` | Whether to capture prompt/completion content (`true`/`false`) | `true` |
+| `NETRA_ENV` | Deployment environment (e.g., `prod`, `staging`, `dev`) | `local` |
+| `NETRA_RESOURCE_ATTRS` | JSON string of custom resource attributes | `{}` |
+
+#### Standard OpenTelemetry Variables
+
+| Variable Name | Description | Used When |
+|---------------|-------------|-----------|
+| `OTEL_SERVICE_NAME` | Logical name for your service | When `NETRA_APP_NAME` is not set |
+| `OTEL_EXPORTER_OTLP_ENDPOINT` | URL for OTLP collector | When `NETRA_OTLP_ENDPOINT` is not set |
+| `OTEL_EXPORTER_OTLP_HEADERS` | Additional headers for OTLP exporter | When `NETRA_HEADERS` is not set |
+| `OTEL_RESOURCE_ATTRIBUTES` | Additional resource attributes | When `NETRA_RESOURCE_ATTRS` is not set |
+
+### Configuration Precedence
+
+Configuration values are resolved in the following order (highest to lowest precedence):
+
+1. **Code Parameters**: Values passed directly to `Netra.init()`
+2. **Netra Environment Variables**: `NETRA_*` variables
+3. **OpenTelemetry Environment Variables**: Standard `OTEL_*` variables
+4. **Default Values**: Fallback values defined in the SDK
+
+This allows you to:
+- Override any setting directly in code for maximum control
+- Use Netra-specific environment variables for Netra-specific settings
+- Fall back to standard OpenTelemetry variables for compatibility
+- Rely on sensible defaults when no other configuration is provided
+
+**Example**:
+```bash
+export NETRA_APP_NAME="my-ai-service"
+export NETRA_OTLP_ENDPOINT="https://collector.example.com:4318"
+export NETRA_API_KEY="your-api-key-here"
+export NETRA_ENV="production"
+export NETRA_RESOURCE_ATTRS='{"team":"ai", "version":"1.0.0"}'
+```
+
+### Programmatic Configuration
+
+You can also configure the SDK programmatically when initializing:
+
+```python
+from netra import Netra
+
+Netra.init(
+    app_name="my-ai-service",
+    environment="production",
+    resource_attributes={"team": "ai", "version": "1.0.0"},
+    trace_content=True,
+    disable_batch=False
+)
+```
+
 ### Custom Instrumentation Selection
 
 Control which instrumentations are enabled:
@@ -400,6 +576,7 @@ Netra.init(app_name="Your App")
 - **📈 Rich Ecosystem**: Leverage the entire OpenTelemetry ecosystem
 
 
+
 ## 📚 Examples
 
 The SDK includes comprehensive examples in the `examples/` directory:
@@ -412,61 +589,52 @@ The SDK includes comprehensive examples in the `examples/` directory:
 
 ## 🧪 Tests
 
-The Netra SDK includes a comprehensive testing suite in the `tests/` directory. The tests are built using pytest and cover all major components of the SDK.
-
-### Test Structure
-
-- **conftest.py**: Contains shared fixtures, test utilities, and configuration for all tests
-- **test_netra_init.py**: Tests for the main Netra SDK initialization and configuration
-- **test_decorators.py**: Tests for workflow, agent, and task decorators
-- **test_input_scanner.py**: Tests for prompt injection scanning and security features
+Our test suite is built on `pytest` and is designed to ensure the reliability and stability of the Netra SDK. We follow comprehensive testing standards, including unit, integration, and thread-safety tests.
 
 ### Running Tests
 
-To run the full test suite:
+To run the complete test suite, use the following command from the root of the project:
 
 ```bash
 poetry run pytest
 ```
 
-To run specific test modules:
 
+### Run Specific Test File
+To run a specific test file, use the following command from the root of the project:
 ```bash
 poetry run pytest tests/test_netra_init.py
-poetry run pytest tests/test_decorators.py
 ```
 
-To run tests with coverage reporting:
+### Test Coverage
+
+To generate a test coverage report, you can run:
 
 ```bash
 poetry run pytest --cov=netra --cov-report=html
 ```
 
-### Test Fixtures
-
-The testing framework provides several useful fixtures:
+This will create an `htmlcov` directory with a detailed report.
 
-- **reset_netra_state**: Automatically resets Netra state before and after each test
-- **clean_environment**: Provides a clean environment by temporarily clearing relevant environment variables
-- **mock_config**, **mock_tracer**, **mock_init_instrumentations**: Mock objects for testing components in isolation
-- **sample_config_params**, **sample_session_data**: Sample data for testing configuration and sessions
+### Running Specific Test Categories
 
-### Test Categories
-
-Tests are organized using pytest markers:
-
-- **unit**: Unit tests for individual components
-- **integration**: Integration tests for component interactions
-- **thread_safety**: Tests for thread safety and concurrency
-
-To run tests by category:
+Tests are organized using `pytest` markers. You can run specific categories of tests as follows:
 
 ```bash
+# Run only unit tests (default)
 poetry run pytest -m unit
+
+# Run only integration tests
 poetry run pytest -m integration
+
+# Run only thread-safety tests
 poetry run pytest -m thread_safety
 ```
 
+For more detailed information on our testing strategy, fixtures, and best practices, please refer to the `README.md` file in the `tests` directory.
+
+
+
 ## 🛠️ Development Setup
 
 To set up your development environment for the Netra SDK, run the provided setup script:
@@ -536,3 +704,4 @@ docs: update installation instructions
 **Footer** can be used for "BREAKING CHANGE:" or issue references.
 
 ---
+

netra_sdk-0.1.0/PKG-INFO → netra_sdk-0.1.1/README.md

@@ -1,37 +1,3 @@
-Metadata-Version: 2.3
-Name: netra-sdk
-Version: 0.1.0
-Summary: A Python SDK for AI application observability that provides OpenTelemetry-based monitoring, tracing, and PII protection for LLM and vector database applications. Enables easy instrumentation, session tracking, and privacy-focused data collection for AI systems in production environments.
-License: Apache-2.0
-Keywords: netra,tracing,observability,sdk,ai,llm,vector,database
-Author: Sooraj Thomas
-Author-email: sooraj@keyvalue.systems
-Requires-Python: >=3.10,<3.13
-Classifier: Development Status :: 4 - Beta
-Classifier: Framework :: OpenTelemetry
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-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: Typing :: Typed
-Provides-Extra: llm-guard
-Requires-Dist: llm-guard (>=0.3.16,<0.4.0) ; extra == "llm-guard"
-Requires-Dist: opentelemetry-api (>=1.34.0,<2.0.0)
-Requires-Dist: opentelemetry-instrumentation-aiohttp-client (>=0.55b1,<1.0.0)
-Requires-Dist: opentelemetry-instrumentation-fastapi (>=0.55b1,<1.0.0)
-Requires-Dist: opentelemetry-instrumentation-httpx (>=0.55b1,<1.0.0)
-Requires-Dist: opentelemetry-sdk (>=1.34.0,<2.0.0)
-Requires-Dist: presidio-analyzer (>=2.2.358,<3.0.0)
-Requires-Dist: traceloop-sdk (>=0.40.7,<0.41.0)
-Project-URL: Bug Tracker, https://github.com/KeyValueSoftwareSystems/netra-sdk-py/issues
-Project-URL: Documentation, https://github.com/KeyValueSoftwareSystems/netra-sdk-py/blob/main/README.md
-Project-URL: Homepage, https://github.com/KeyValueSoftwareSystems/netra-sdk-py
-Project-URL: Repository, https://github.com/KeyValueSoftwareSystems/netra-sdk-py
-Description-Content-Type: text/markdown
-
 # Netra SDK
 
 🚀 **Netra SDK** is a comprehensive Python library for AI application observability that provides OpenTelemetry-based monitoring, and tracing for LLM applications. It enables easy instrumentation, session tracking, and privacy-focused data analysis for AI systems.
@@ -180,16 +146,47 @@ class CustomerSupportAgent:
 - **AIOHTTP** - Asynchronous HTTP client/server
 - **FastAPI** - Modern web framework for APIs
 - **Requests** - Popular HTTP library for Python
-- **urllib3** - Low-level HTTP client library
+- **Django** - High-level Python web framework
+- **Flask** - Lightweight WSGI web application framework
+- **Falcon** - High-performance Python web framework
+- **Pyramid** - Small, fast, down-to-earth Python web framework
+- **Starlette** - Lightweight ASGI framework/toolkit
+- **Tornado** - Asynchronous networking library and web framework
+- **gRPC** - High-performance, open-source universal RPC framework
+- **Urllib** - Standard Python HTTP client library
+- **Urllib3** - Powerful, user-friendly HTTP client for Python
 
 ### 🗄️ Database Clients
 
 - **PyMySQL** - Pure Python MySQL client
 - **Redis** - In-memory data structure store
+- **SQLAlchemy** - SQL toolkit and Object-Relational Mapper
+- **Psycopg** - Modern PostgreSQL database adapter for Python
+- **Pymongo** - Python driver for MongoDB
+- **Elasticsearch** - Distributed, RESTful search and analytics engine
+- **Cassandra** - Distributed NoSQL database
+- **PyMSSQL** - Simple Microsoft SQL Server client
+- **MySQL Connector** - Official MySQL driver
+- **Sqlite3** - Built-in SQL database engine
+- **Aiopg** - Asynchronous PostgreSQL client
+- **Asyncpg** - Fast asynchronous PostgreSQL client
+- **Pymemcache** - Comprehensive Memcached client
+- **Tortoise ORM** - Easy-to-use asyncio ORM
+
+### 📨 Messaging & Task Queues
+
+- **Celery** - Distributed task queue
+- **Pika** - Pure-Python implementation of the AMQP 0-9-1 protocol
+- **AIO Pika** - Asynchronous AMQP client
+- **Kafka-Python** - Python client for Apache Kafka
+- **AIOKafka** - Asynchronous Python client for Kafka
+- **Confluent-Kafka** - Confluent's Python client for Apache Kafka
+- **Boto3 SQS** - Amazon SQS client via Boto3
 
 ### 🔧 AI Frameworks & Orchestration
 
 - **LangChain** - Framework for developing LLM applications
+- **LangGraph** - Modern framework for LLM applications
 - **LlamaIndex** - Data framework for LLM applications
 - **Haystack** - End-to-end NLP framework
 - **CrewAI** - Multi-agent AI systems
@@ -364,6 +361,72 @@ with Netra.start_session("video_generation_task") as session:
 
 ## 🔧 Advanced Configuration
 
+### Environment Variables
+
+Netra SDK can be configured using the following environment variables:
+
+#### Netra-specific Variables
+
+| Variable Name | Description | Default |
+|---------------|-------------|---------|
+| `NETRA_APP_NAME` | Logical name for your service | Falls back to `OTEL_SERVICE_NAME` or `llm_tracing_service` |
+| `NETRA_OTLP_ENDPOINT` | URL for OTLP collector | Falls back to `OTEL_EXPORTER_OTLP_ENDPOINT` |
+| `NETRA_API_KEY` | API key for authentication | `None` |
+| `NETRA_HEADERS` | Additional headers in W3C Correlation-Context format | `None` |
+| `NETRA_DISABLE_BATCH` | Disable batch span processor (`true`/`false`) | `false` |
+| `NETRA_TRACE_CONTENT` | Whether to capture prompt/completion content (`true`/`false`) | `true` |
+| `NETRA_ENV` | Deployment environment (e.g., `prod`, `staging`, `dev`) | `local` |
+| `NETRA_RESOURCE_ATTRS` | JSON string of custom resource attributes | `{}` |
+
+#### Standard OpenTelemetry Variables
+
+| Variable Name | Description | Used When |
+|---------------|-------------|-----------|
+| `OTEL_SERVICE_NAME` | Logical name for your service | When `NETRA_APP_NAME` is not set |
+| `OTEL_EXPORTER_OTLP_ENDPOINT` | URL for OTLP collector | When `NETRA_OTLP_ENDPOINT` is not set |
+| `OTEL_EXPORTER_OTLP_HEADERS` | Additional headers for OTLP exporter | When `NETRA_HEADERS` is not set |
+| `OTEL_RESOURCE_ATTRIBUTES` | Additional resource attributes | When `NETRA_RESOURCE_ATTRS` is not set |
+
+### Configuration Precedence
+
+Configuration values are resolved in the following order (highest to lowest precedence):
+
+1. **Code Parameters**: Values passed directly to `Netra.init()`
+2. **Netra Environment Variables**: `NETRA_*` variables
+3. **OpenTelemetry Environment Variables**: Standard `OTEL_*` variables
+4. **Default Values**: Fallback values defined in the SDK
+
+This allows you to:
+- Override any setting directly in code for maximum control
+- Use Netra-specific environment variables for Netra-specific settings
+- Fall back to standard OpenTelemetry variables for compatibility
+- Rely on sensible defaults when no other configuration is provided
+
+**Example**:
+```bash
+export NETRA_APP_NAME="my-ai-service"
+export NETRA_OTLP_ENDPOINT="https://collector.example.com:4318"
+export NETRA_API_KEY="your-api-key-here"
+export NETRA_ENV="production"
+export NETRA_RESOURCE_ATTRS='{"team":"ai", "version":"1.0.0"}'
+```
+
+### Programmatic Configuration
+
+You can also configure the SDK programmatically when initializing:
+
+```python
+from netra import Netra
+
+Netra.init(
+    app_name="my-ai-service",
+    environment="production",
+    resource_attributes={"team": "ai", "version": "1.0.0"},
+    trace_content=True,
+    disable_batch=False
+)
+```
+
 ### Custom Instrumentation Selection
 
 Control which instrumentations are enabled:
@@ -434,6 +497,7 @@ Netra.init(app_name="Your App")
 - **📈 Rich Ecosystem**: Leverage the entire OpenTelemetry ecosystem
 
 
+
 ## 📚 Examples
 
 The SDK includes comprehensive examples in the `examples/` directory:
@@ -446,61 +510,52 @@ The SDK includes comprehensive examples in the `examples/` directory:
 
 ## 🧪 Tests
 
-The Netra SDK includes a comprehensive testing suite in the `tests/` directory. The tests are built using pytest and cover all major components of the SDK.
-
-### Test Structure
-
-- **conftest.py**: Contains shared fixtures, test utilities, and configuration for all tests
-- **test_netra_init.py**: Tests for the main Netra SDK initialization and configuration
-- **test_decorators.py**: Tests for workflow, agent, and task decorators
-- **test_input_scanner.py**: Tests for prompt injection scanning and security features
+Our test suite is built on `pytest` and is designed to ensure the reliability and stability of the Netra SDK. We follow comprehensive testing standards, including unit, integration, and thread-safety tests.
 
 ### Running Tests
 
-To run the full test suite:
+To run the complete test suite, use the following command from the root of the project:
 
 ```bash
 poetry run pytest
 ```
 
-To run specific test modules:
 
+### Run Specific Test File
+To run a specific test file, use the following command from the root of the project:
 ```bash
 poetry run pytest tests/test_netra_init.py
-poetry run pytest tests/test_decorators.py
 ```
 
-To run tests with coverage reporting:
+### Test Coverage
+
+To generate a test coverage report, you can run:
 
 ```bash
 poetry run pytest --cov=netra --cov-report=html
 ```
 
-### Test Fixtures
-
-The testing framework provides several useful fixtures:
+This will create an `htmlcov` directory with a detailed report.
 
-- **reset_netra_state**: Automatically resets Netra state before and after each test
-- **clean_environment**: Provides a clean environment by temporarily clearing relevant environment variables
-- **mock_config**, **mock_tracer**, **mock_init_instrumentations**: Mock objects for testing components in isolation
-- **sample_config_params**, **sample_session_data**: Sample data for testing configuration and sessions
+### Running Specific Test Categories
 
-### Test Categories
-
-Tests are organized using pytest markers:
-
-- **unit**: Unit tests for individual components
-- **integration**: Integration tests for component interactions
-- **thread_safety**: Tests for thread safety and concurrency
-
-To run tests by category:
+Tests are organized using `pytest` markers. You can run specific categories of tests as follows:
 
 ```bash
+# Run only unit tests (default)
 poetry run pytest -m unit
+
+# Run only integration tests
 poetry run pytest -m integration
+
+# Run only thread-safety tests
 poetry run pytest -m thread_safety
 ```
 
+For more detailed information on our testing strategy, fixtures, and best practices, please refer to the `README.md` file in the `tests` directory.
+
+
+
 ## 🛠️ Development Setup
 
 To set up your development environment for the Netra SDK, run the provided setup script:
@@ -570,4 +625,3 @@ docs: update installation instructions
 **Footer** can be used for "BREAKING CHANGE:" or issue references.
 
 ---
-

{netra_sdk-0.1.0 → netra_sdk-0.1.1}/netra/config.py

@@ -35,7 +35,7 @@ class Config:
     ):
         # Application name: from param, else env
         self.app_name = (
-            app_name or os.getenv("OTEL_SERVICE_NAME") or os.getenv("NETRA_APP_NAME") or "llm_tracing_service"
+            app_name or os.getenv("NETRA_APP_NAME") or os.getenv("OTEL_SERVICE_NAME") or "llm_tracing_service"
         )
 
         # OTLP endpoint: if explicit param, else OTEL_EXPORTER_OTLP_ENDPOINT