refactor: rename package from nutrient to nutrient_dws

- Changed source directory from src/nutrient to src/nutrient_dws
- Updated all imports throughout the codebase
- Fixed all unit tests to use new package name
- Updated pyproject.toml package configuration
- Fixed test expectations for new API URLs and authentication
- Applied linting fixes from ruff
- Updated type annotations to fix mypy errors

The package is now correctly named nutrient-dws for PyPI distribution
while using nutrient_dws as the import name (following Python conventions).

Author: jdrhyne

README.md

@@ -21,7 +21,7 @@ pip install nutrient-dws
 ## Quick Start
 
 ```python
-from nutrient import NutrientClient
+from nutrient_dws import NutrientClient
 
 # Initialize the client
 client = NutrientClient(api_key="your-api-key")
@@ -173,7 +173,7 @@ client.import_from_url("https://example.com/document.pdf")
 The library provides specific exceptions for different error scenarios:
 
 ```python
-from nutrient import (
+from nutrient_dws import (
     NutrientError,
     AuthenticationError,
     APIError,

SPECIFICATION.md

@@ -81,7 +81,7 @@ The library is architected around a central `NutrientClient` class, which is the
 The client will be initialized with an optional API key and timeout. It will follow modern Python library best practices for configuration.
 
 ```python
-from nutrient import NutrientClient, AuthenticationError
+from nutrient_dws import NutrientClient, AuthenticationError
 
 # Option 1: API key passed directly (takes precedence)
 client = NutrientClient(api_key="YOUR_DWS_API_KEY", timeout=300) 
@@ -143,7 +143,7 @@ The Builder API provides a more elegant and efficient solution for multi-step wo
 
 **Example Usage:**
 ```python
-from nutrient import APIError
+from nutrient_dws import APIError
 
 # User Story: Convert a DOCX to PDF and rotate it (Builder version)
 try:

pyproject.toml

@@ -59,7 +59,7 @@ Repository = "https://github.com/jdrhyne/nutrient-dws-client-python"
 where = ["src"]
 
 [tool.setuptools.package-data]
-nutrient = ["py.typed"]
+nutrient_dws = ["py.typed"]
 
 [tool.ruff]
 target-version = "py38"
@@ -110,7 +110,7 @@ testpaths = ["tests"]
 addopts = [
     "-ra",
     "--strict-markers",
-    "--cov=nutrient",
+    "--cov=nutrient_dws",
     "--cov-report=term-missing",
     "--cov-report=html",
     "--cov-report=xml",
@@ -120,7 +120,7 @@ markers = [
 ]
 
 [tool.coverage.run]
-source = ["src/nutrient"]
+source = ["src/nutrient_dws"]
 branch = true
 
 [tool.coverage.report]

scripts/generate_api_methods.py

@@ -337,7 +337,7 @@ def generate_api_methods(spec_path: Path, output_path: Path) -> None:
         '',
         'from typing import List, Optional',
         '',
-        'from nutrient.file_handler import FileInput',
+        'from nutrient_dws.file_handler import FileInput',
         '',
         '',
         'class DirectAPIMixin:',

src/nutrient/__init__.py renamed to src/nutrient_dws/__init__.py

@@ -3,8 +3,8 @@
 A Python client library for the Nutrient Document Web Services API.
 """
 
-from nutrient.client import NutrientClient
-from nutrient.exceptions import (
+from nutrient_dws.client import NutrientClient
+from nutrient_dws.exceptions import (
     APIError,
     AuthenticationError,
     FileProcessingError,
@@ -15,11 +15,11 @@
 
 __version__ = "0.1.0"
 __all__ = [
-    "NutrientClient",
-    "NutrientError",
     "APIError",
     "AuthenticationError",
     "FileProcessingError",
+    "NutrientClient",
+    "NutrientError",
     "TimeoutError",
     "ValidationError",
 ]

src/nutrient/api/__init__.py renamed to src/nutrient_dws/api/__init__.py

@@ -6,10 +6,10 @@
 
 from typing import TYPE_CHECKING, Any, List, Optional
 
-from nutrient.file_handler import FileInput
+from nutrient_dws.file_handler import FileInput
 
 if TYPE_CHECKING:
-    from nutrient.client import NutrientClient
+    from nutrient_dws.client import NutrientClient
 
 
 class DirectAPIMixin:
@@ -60,7 +60,9 @@ def convert_to_pdf(
         # Use builder with no actions - implicit conversion happens
         return self.build(input_file).execute(output_path)  # type: ignore
 
-    def flatten_annotations(self, input_file: FileInput, output_path: Optional[str] = None) -> Optional[bytes]:
+    def flatten_annotations(
+        self, input_file: FileInput, output_path: Optional[str] = None
+    ) -> Optional[bytes]:
         """Flatten annotations and form fields in a PDF.
 
         Converts all annotations and form fields into static page content.
@@ -106,7 +108,7 @@ def rotate_pages(
         """
         options = {"degrees": degrees}
         if page_indexes is not None:
-            options["page_indexes"] = page_indexes
+            options["page_indexes"] = page_indexes  # type: ignore
         return self._process_file("rotate-pages", input_file, output_path, **options)
 
     def ocr_pdf(
@@ -174,19 +176,19 @@ def watermark_pdf(
         """
         if not text and not image_url:
             raise ValueError("Either text or image_url must be provided")
-            
+
         options = {
             "width": width,
             "height": height,
             "opacity": opacity,
             "position": position,
         }
-        
+
         if text:
             options["text"] = text
         else:
             options["image_url"] = image_url
-            
+
         return self._process_file("watermark-pdf", input_file, output_path, **options)
 
     def apply_redactions(
@@ -246,35 +248,35 @@ def merge_pdfs(
         """
         if len(input_files) < 2:
             raise ValueError("At least 2 files required for merge")
-            
-        from nutrient.file_handler import prepare_file_for_upload, save_file_output
-        
+
+        from nutrient_dws.file_handler import prepare_file_for_upload, save_file_output
+
         # Prepare files for upload
         files = {}
         parts = []
-        
+
         for i, file in enumerate(input_files):
             field_name = f"file{i}"
             file_field, file_data = prepare_file_for_upload(file, field_name)
             files[file_field] = file_data
             parts.append({"file": field_name})
-        
+
         # Build instructions for merge (no actions needed)
         instructions = {
             "parts": parts,
             "actions": []
         }
-        
+
         # Make API request
-        result = self._http_client.post(  # type: ignore
+        result = self._http_client.post(
             "/build",
             files=files,
             json_data=instructions,
         )
-        
+
         # Handle output
         if output_path:
             save_file_output(result, output_path)
             return None
         else:
-            return result
+            return result

src/nutrient/api/direct.py renamed to src/nutrient_dws/api/direct.py

@@ -2,7 +2,7 @@
 
 from typing import Any, Dict, List, Optional
 
-from nutrient.file_handler import FileInput, prepare_file_for_upload, save_file_output
+from nutrient_dws.file_handler import FileInput, prepare_file_for_upload, save_file_output
 
 
 class BuildAPIWrapper:
@@ -127,7 +127,7 @@ def _build_instructions(self) -> Dict[str, Any]:
 
         # Add output options if specified
         if self._output_options:
-            instructions["output"] = self._output_options
+            instructions["output"] = self._output_options  # type: ignore
 
         return instructions
 
@@ -169,7 +169,7 @@ def _map_tool_to_action(self, tool: str, options: Dict[str, Any]) -> Dict[str, A
                 # Map common language codes to API format
                 lang_map = {
                     "en": "english",
-                    "de": "deu", 
+                    "de": "deu",
                     "eng": "eng",
                     "deu": "deu",
                     "german": "deu",
@@ -181,15 +181,15 @@ def _map_tool_to_action(self, tool: str, options: Dict[str, Any]) -> Dict[str, A
             # Watermark requires width/height
             action["width"] = options.get("width", 200)  # Default width
             action["height"] = options.get("height", 100)  # Default height
-            
+
             if "text" in options:
                 action["text"] = options["text"]
             elif "image_url" in options:
-                action["image"] = {"url": options["image_url"]}
+                action["image"] = {"url": options["image_url"]}  # type: ignore
             else:
                 # Default to text watermark if neither specified
                 action["text"] = "WATERMARK"
-                
+
             if "opacity" in options:
                 action["opacity"] = options["opacity"]
             if "position" in options:

src/nutrient/builder.py renamed to src/nutrient_dws/builder.py

@@ -3,10 +3,10 @@
 import os
 from typing import Any, Optional
 
-from nutrient.api.direct import DirectAPIMixin
-from nutrient.builder import BuildAPIWrapper
-from nutrient.file_handler import FileInput, prepare_file_for_upload, save_file_output
-from nutrient.http_client import HTTPClient
+from nutrient_dws.api.direct import DirectAPIMixin
+from nutrient_dws.builder import BuildAPIWrapper
+from nutrient_dws.file_handler import FileInput
+from nutrient_dws.http_client import HTTPClient
 
 
 class NutrientClient(DirectAPIMixin):
@@ -29,7 +29,7 @@ class NutrientClient(DirectAPIMixin):
         AuthenticationError: When making API calls without a valid API key.
         
     Example:
-        >>> from nutrient import NutrientClient
+        >>> from nutrient_dws import NutrientClient
         >>> client = NutrientClient(api_key="your-api-key")
         >>> # Direct API
         >>> pdf = client.convert_to_pdf(input_file="document.docx")