ducpy 3.3.1__tar.gz → 3.3.3__tar.gz

{ducpy-3.3.1 → ducpy-3.3.3}/Cargo.lock

@@ -412,7 +412,7 @@ dependencies = [
 
 [[package]]
 name = "ducpy-native"
-version = "3.3.1"
+version = "3.3.3"
 dependencies = [
  "duc",
  "pyo3",

{ducpy-3.3.1 → ducpy-3.3.3}/PKG-INFO

@@ -1,9 +1,8 @@
 Metadata-Version: 2.4
 Name: ducpy
-Version: 3.3.1
+Version: 3.3.3
 Classifier: License :: OSI Approved :: MIT License
 Requires-Dist: nanoid>=2.0.0
-Requires-Dist: numpy>=1.20.0
 License-File: LICENSE
 Summary: The library for the Duc 2D CAD file format
 Author: Jorge Soares

{ducpy-3.3.1 → ducpy-3.3.3}/packages/ducpy/crate/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "ducpy-native"
-version = "3.3.1"
+version = "3.3.3"
 edition = "2021"
 description = "Python native extension for the duc file format (used by ducpy)"
 publish = false

{ducpy-3.3.1 → ducpy-3.3.3}/pyproject.toml

@@ -6,7 +6,6 @@ readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
     "nanoid>=2.0.0",
-    "numpy>=1.20.0",
 ]
 
 license = { text = "MIT" }

ducpy-3.3.3/src/ducpy/__init__.py

@@ -0,0 +1,32 @@
+"""Python library for the DUC 2D CAD file format.
+
+Usage::
+    ``import ducpy as duc``
+
+Builders API (High-level):
+    The easy way to build, manage ``.duc`` files.
+    Construct elements, apply styles, manage layers, build blocks,
+    and handle document state with the ``duc.builders`` module.
+
+SQL Builder (Low-level):
+    A ``.duc`` file is a zlib-compressed SQLite database. Use
+    ``duc.builders.sql_builder`` for direct schema access, bulk
+    queries, and low-level manipulation.
+
+Search:
+    Query/search elements and files programmatically via the
+    ``duc.search`` API.
+
+File I/O:
+    Read and write ``.duc`` files using the ``duc.parse`` 
+    and ``duc.serialize`` modules.
+"""
+
+from .builders import *
+from .classes import *
+from .enums import *
+from .parse import (DucData, get_external_file, list_external_files, parse_duc,
+                    parse_duc_lazy)
+from .search import *
+from .serialize import DUC_SCHEMA_VERSION, serialize_duc
+from .utils import *

ducpy-3.3.3/src/ducpy/_version.py

@@ -0,0 +1,3 @@
+# This file is auto-generated by setup.py when the package is built.
+# Do not edit this file manually.
+DUC_SCHEMA_VERSION = "3.0.0"

{ducpy-3.3.1 → ducpy-3.3.3}/src/ducpy/builders/element_builders.py

@@ -7,7 +7,6 @@ from dataclasses import dataclass, field
 from math import pi
 from typing import Any, Dict, List, Optional, Union
 
-import numpy as np
 from ducpy.enums import (IMAGE_STATUS, STROKE_CAP, STROKE_JOIN,
                          STROKE_PLACEMENT, STROKE_PREFERENCE, TEXT_ALIGN,
                          VERTICAL_ALIGN)
@@ -192,9 +191,6 @@ def _create_element_wrapper(element_class, base_params, element_params, explicit
         )
         specific_element = element_class(stack_element_base=stack_element_base)
     elif element_class == DucImageElement:
-        scale = element_params.get('scale', [1.0, 1.0])
-        if isinstance(scale, list):
-            element_params['scale'] = np.array(scale, dtype=np.float32)
         element_params['base'] = base_element
         specific_element = element_class(**element_params)
     elif element_class == DucFreeDrawElement:
@@ -204,9 +200,6 @@ def _create_element_wrapper(element_class, base_params, element_params, explicit
             for p in points
         ]
         element_params['points'] = duc_points
-        pressures = element_params.get('pressures', [])
-        if isinstance(pressures, list):
-            element_params['pressures'] = np.array(pressures, dtype=np.float32)
         element_params['base'] = base_element
         specific_element = element_class(**element_params)
     elif element_class == DucTableElement:

{ducpy-3.3.1 → ducpy-3.3.3}/src/ducpy/parse.py

@@ -57,16 +57,29 @@ def _read_bytes(source: Union[bytes, bytearray, BinaryIO, str]) -> bytes:
 def parse_duc(source: Union[bytes, bytearray, BinaryIO, str]) -> DucData:
     """Parse a ``.duc`` file into a :class:`DucData` dict.
 
+    This function reads a raw `.duc` binary blob or file path and parses it using 
+    the Rust native extension. It returns a specialized dictionary (`DucData`) 
+    that allows attribute-style access to the parsed properties (e.g. `data.elements[0].id`),
+    using `snake_case` keys instead of the internal `camelCase` format.
+
     Parameters
     ----------
     source : bytes | file | str
-        Raw bytes, an open binary file, or a path to a ``.duc`` file.
+        Raw bytes, an open binary file, or a string path to a ``.duc`` file.
 
     Returns
     -------
     DucData
-        Attribute-accessible dict matching the ExportedDataState schema with
-        snake_case keys.
+        An attribute-accessible dictionary matching the internal `ExportedDataState` 
+        schema with snake_case keys. Common keys include `elements`, `global_state`, 
+        `local_state`, and `version_graph`.
+        
+    Examples
+    --------
+    >>> data = duc.parse_duc("path/to/file.duc")
+    >>> data = duc.parse_duc(binary_data)
+    >>> print(f"Found {len(data.elements)} elements")
+    >>> print(f"First element type: {data.elements[0].type}")
     """
     buf = _read_bytes(source)
     raw = ducpy_native.parse_duc(buf)

{ducpy-3.3.1 → ducpy-3.3.3}/src/ducpy/serialize.py

@@ -216,9 +216,48 @@ def serialize_duc(
     layers: Optional[list] = None,
     external_files: Optional[list] = None,
 ) -> bytes:
-    """Serialize elements to ``.duc`` format.
-    Element instances and state dataclasses are automatically converted to the
-    camelCase dicts expected by the Rust native module.
+    """Serialize elements and document state to raw ``.duc`` binary format.
+
+    This function accepts lists of elements created via the `ducpy.builders` API
+    (e.g., `ElementBuilder`) and serializes them into the compressed format
+    expected by `.duc` files. Element instances and state dataclasses are 
+    automatically converted to the camelCase dicts expected by the Rust native module.
+
+    Parameters
+    ----------
+    name : str
+        The document name or identifier (used to populate the `source` field).
+    thumbnail : Optional[bytes], default=None
+        Raw PNG bytes representing a thumbnail of the document.
+    dictionary : Optional[list], default=None
+        List of Key-Value string pairs for dictionary entries.
+    elements : Optional[list], default=None
+        A list of elements (e.g., created via `ElementBuilder`) to include.
+    duc_local_state : Any, default=None
+        A `DucLocalState` object representing viewport state (pan, zoom, etc).
+    duc_global_state : Any, default=None
+        A `DucGlobalState` object representing document-wide settings.
+    version_graph : Any, default=None
+        Version history metadata of the document.
+    blocks : Optional[list], default=None
+        List of block definitions.
+    block_instances : Optional[list], default=None
+        List of block instances.
+    block_collections : Optional[list], default=None
+        List of block collections (libraries).
+    groups : Optional[list], default=None
+        List of element groups.
+    regions : Optional[list], default=None
+        List of boolean regions.
+    layers : Optional[list], default=None
+        List of document layers.
+    external_files : Optional[list], default=None
+        List of external files (e.g., embedded images or PDFs).
+
+    Returns
+    -------
+    bytes
+        The raw `.duc` binary data, ready to be written to a file.
     """
     thumb = bytes(thumbnail) if thumbnail is not None else None
 

ducpy-3.3.1/src/ducpy/__init__.py

@@ -1,19 +0,0 @@
-"""Main module for duc_py package.
-
-Import usage examples:
-    import ducpy as duc
-    
-    duc.classes.SomeClass
-    duc.parse_duc(source)
-    duc.serialize_duc(name=..., elements=...)
-    duc.utils.some_utility
-"""
-
-from .builders import *
-from .classes import *
-from .enums import *
-from .parse import (DucData, get_external_file, list_external_files, parse_duc,
-                    parse_duc_lazy)
-from .search import *
-from .serialize import DUC_SCHEMA_VERSION, serialize_duc
-from .utils import *