Add integration test skeleton for live API testing

- Add integration_config.py template for API key configuration
- Create test_live_api.py with basic connectivity tests and fixtures
- Add conftest.py for integration test pytest configuration
- Update .gitignore to exclude integration_config.py

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: msch-nutrient

.gitignore

@@ -153,3 +153,6 @@ openapi_spec.yml
 
 .pixi
 .claude/settings.local.json
+
+# Integration test configuration
+tests/integration/integration_config.py

tests/integration/conftest.py

@@ -0,0 +1,18 @@
+"""Pytest configuration for integration tests."""
+
+import pytest
+
+
+def pytest_configure(config):
+    """Configure pytest for integration tests."""
+    # Add custom markers
+    config.addinivalue_line(
+        "markers", "integration: marks tests as integration tests (may require API key)"
+    )
+
+
+def pytest_collection_modifyitems(config, items):
+    """Automatically mark integration tests."""
+    for item in items:
+        if "integration" in str(item.fspath):
+            item.add_marker(pytest.mark.integration)

tests/integration/integration_config.py.example

@@ -0,0 +1,13 @@
+"""Integration test configuration template.
+
+Copy this file to integration_config.py and fill in your API key.
+"""
+
+# Your Nutrient DWS API key
+API_KEY = "your-api-key-here"
+
+# Optional: Override base URL if testing against different environment
+# BASE_URL = "https://api.nutrient.io/build"
+
+# Optional: Request timeout for integration tests
+# TIMEOUT = 60

tests/integration/test_live_api.py

@@ -0,0 +1,82 @@
+"""Integration tests against the live Nutrient DWS API.
+
+These tests require a valid API key configured in integration_config.py.
+"""
+
+import os
+import pytest
+from pathlib import Path
+
+from nutrient_dws import NutrientClient
+from nutrient_dws.exceptions import AuthenticationError
+
+try:
+    from . import integration_config
+    API_KEY = integration_config.API_KEY
+    BASE_URL = getattr(integration_config, 'BASE_URL', None)
+    TIMEOUT = getattr(integration_config, 'TIMEOUT', 60)
+except ImportError:
+    API_KEY = None
+    BASE_URL = None
+    TIMEOUT = 60
+
+
+@pytest.mark.skipif(not API_KEY, reason="No API key configured in integration_config.py")
+class TestLiveAPI:
+    """Integration tests against live API."""
+
+    @pytest.fixture
+    def client(self):
+        """Create a client with the configured API key."""
+        client = NutrientClient(api_key=API_KEY, timeout=TIMEOUT)
+        yield client
+        client.close()
+
+    @pytest.fixture
+    def sample_pdf_path(self, tmp_path):
+        """Create a simple PDF file for testing."""
+        pdf_content = b"%PDF-1.4\n1 0 obj<</Type/Catalog/Pages 2 0 R>>endobj 2 0 obj<</Type/Pages/Kids[3 0 R]/Count 1>>endobj 3 0 obj<</Type/Page/Parent 2 0 R/MediaBox[0 0 612 792]>>endobj xref 0 4 0000000000 65535 f 0000000010 00000 n 0000000053 00000 n 0000000125 00000 n trailer<</Size 4/Root 1 0 R>>startxref 177 %%EOF"
+        pdf_path = tmp_path / "test.pdf"
+        pdf_path.write_bytes(pdf_content)
+        return str(pdf_path)
+
+    def test_client_initialization(self):
+        """Test that client initializes correctly with API key."""
+        client = NutrientClient(api_key=API_KEY)
+        assert client._api_key == API_KEY
+        client.close()
+
+    def test_client_missing_api_key(self):
+        """Test that client works without API key but fails on API calls."""
+        client = NutrientClient()
+        # Should not raise during initialization
+        assert client is not None
+        client.close()
+
+    def test_basic_api_connectivity(self, client, sample_pdf_path):
+        """Test basic API connectivity with a simple operation."""
+        # This test will depend on what operations are available
+        # For now, we'll test that we can create a builder without errors
+        builder = client.build(input_file=sample_pdf_path)
+        assert builder is not None
+
+    @pytest.mark.skip(reason="Requires specific tool implementation")
+    def test_convert_operation(self, client, sample_pdf_path, tmp_path):
+        """Test a basic convert operation (example - adjust based on available tools)."""
+        output_path = tmp_path / "output.pdf"
+        
+        # This is an example - adjust based on actual available tools
+        # result = client.convert_to_pdf(input_file=sample_pdf_path, output_path=str(output_path))
+        
+        # assert output_path.exists()
+        # assert output_path.stat().st_size > 0
+
+    def test_builder_api_basic(self, client, sample_pdf_path):
+        """Test basic builder API functionality."""
+        builder = client.build(input_file=sample_pdf_path)
+        
+        # Test that we can add steps without errors
+        # This will need to be updated based on actual available tools
+        # builder.add_step("example-tool", {})
+        
+        assert builder is not None