ducpy 2.3.1__tar.gz

ducpy-2.3.1/.gitignore

@@ -0,0 +1,170 @@
+# Test files
+dist/
+inputs/
+
+# Auto-generated version file
+**/_version.py
+
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/

ducpy-2.3.1/LICENSE

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

ducpy-2.3.1/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: ducpy
+Version: 2.3.1
+Summary: The library for the Duc 2D CAD file format
+Author: Jorge Soares
+Author-email: Ducflair <support@ducflair.com>
+License: MIT
+Project-URL: Homepage, https://duc.ducflair.com
+Project-URL: Source, https://github.com/ducflair/duc/tree/main/packages/ducpy
+Project-URL: Documentation, https://python.duc.ducflair.com
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: flatbuffers>=25.2.10
+Requires-Dist: nanoid>=2.0.0
+Dynamic: license-file
+
+# ducpy (Python)
+
+<p align="center">
+  <br/>
+  <a href="https://duc.ducflair.com" target="_blank"><img width="256px" src="https://raw.githubusercontent.com/ducflair/assets/refs/heads/main/src/duc/duc-extended.png" /></a>
+  <p align="center">2D CAD File Format</p>
+  <p align="center" style="align: center;">
+    <a href="https://pypi.org/project/ducpy/"><img src="https://shields.io/badge/Pip-blue?logo=Pypi&logoColor=white&style=round-square" alt="Pip" /></a>
+    <a href="https://github.com/ducflair/duc/releases"><img src="https://img.shields.io/pypi/v/ducpy?style=round-square&label=latest%20stable" alt="PyPI ducpy@latest release" /></a>
+    <a href="https://pypi.org/project/ducpy/"><img src="https://img.shields.io/pypi/dm/ducpy?style=round-square&color=salmon" alt="Downloads" /></a>
+    <img src="https://shields.io/badge/Python-ffde57?logo=Python&logoColor=646464&style=round-square" alt="Python" />
+  </p>
+</p>
+
+
+The `ducpy` package provides a robust Python implementation for the `duc` 2D CAD file format, a cornerstone of our advanced design system. Designed for professionals seeking precision and efficiency, this package ensures seamless integration and manipulation of `duc` files within your Python projects.
+
+## Introduction
+
+The `ducpy` package offers comprehensive Python types and helper functions to work effortlessly with the `duc` CAD file format. Built with efficiency and performance in mind, this package enables you to parse, validate, and manipulate `duc` files with ease.
+
+## Features
+
+- **Python Support:** Strongly-typed interfaces for all aspects of the `duc` file format, ensuring type safety and IDE support.
+- **Utility Functions:** Easy-to-use functions for parsing, validating, and manipulating `duc` files.
+- **Extensible Architecture:** Designed to integrate seamlessly with other `ducflair` packages and your custom tools.
+- **Performance Optimized:** Efficient processing to handle complex CAD data with ease.
+
+## Installation
+
+Install the package using pip:
+
+```bash
+pip install ducpy
+```
+
+## Usage
+
+```python
+import ducpy as duc
+```
+
+## Documentation
+
+For detailed documentation, including all available types and utility functions, visit our [Documentation](https://duc.ducflair.com).
+
+## Tools
+
+- [Playground](https://scopture.com): Experiment with the `duc` format in a live environment.
+
+## Contributing
+
+At the moment we are not accepting contributions to this package. However, we welcome feedback and suggestions for future improvements. Feel free to open an issue or contact us at [Ducflair Support](https://www.ducflair.com/support).
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for more details.
+
+## Commit Message Guidelines
+
+To ensure smooth releases with semantic-release, please follow [these guidelines](https://semantic-release.gitbook.io/semantic-release#how-does-it-work).
+
+---
+
+*The duc format and libraries are constantly evolving, aiming to set new standards in the 2D CAD industry. Be a part of this transformation and help shape the future of design technology!*

ducpy-2.3.1/README.md

@@ -0,0 +1,65 @@
+# ducpy (Python)
+
+<p align="center">
+  <br/>
+  <a href="https://duc.ducflair.com" target="_blank"><img width="256px" src="https://raw.githubusercontent.com/ducflair/assets/refs/heads/main/src/duc/duc-extended.png" /></a>
+  <p align="center">2D CAD File Format</p>
+  <p align="center" style="align: center;">
+    <a href="https://pypi.org/project/ducpy/"><img src="https://shields.io/badge/Pip-blue?logo=Pypi&logoColor=white&style=round-square" alt="Pip" /></a>
+    <a href="https://github.com/ducflair/duc/releases"><img src="https://img.shields.io/pypi/v/ducpy?style=round-square&label=latest%20stable" alt="PyPI ducpy@latest release" /></a>
+    <a href="https://pypi.org/project/ducpy/"><img src="https://img.shields.io/pypi/dm/ducpy?style=round-square&color=salmon" alt="Downloads" /></a>
+    <img src="https://shields.io/badge/Python-ffde57?logo=Python&logoColor=646464&style=round-square" alt="Python" />
+  </p>
+</p>
+
+
+The `ducpy` package provides a robust Python implementation for the `duc` 2D CAD file format, a cornerstone of our advanced design system. Designed for professionals seeking precision and efficiency, this package ensures seamless integration and manipulation of `duc` files within your Python projects.
+
+## Introduction
+
+The `ducpy` package offers comprehensive Python types and helper functions to work effortlessly with the `duc` CAD file format. Built with efficiency and performance in mind, this package enables you to parse, validate, and manipulate `duc` files with ease.
+
+## Features
+
+- **Python Support:** Strongly-typed interfaces for all aspects of the `duc` file format, ensuring type safety and IDE support.
+- **Utility Functions:** Easy-to-use functions for parsing, validating, and manipulating `duc` files.
+- **Extensible Architecture:** Designed to integrate seamlessly with other `ducflair` packages and your custom tools.
+- **Performance Optimized:** Efficient processing to handle complex CAD data with ease.
+
+## Installation
+
+Install the package using pip:
+
+```bash
+pip install ducpy
+```
+
+## Usage
+
+```python
+import ducpy as duc
+```
+
+## Documentation
+
+For detailed documentation, including all available types and utility functions, visit our [Documentation](https://duc.ducflair.com).
+
+## Tools
+
+- [Playground](https://scopture.com): Experiment with the `duc` format in a live environment.
+
+## Contributing
+
+At the moment we are not accepting contributions to this package. However, we welcome feedback and suggestions for future improvements. Feel free to open an issue or contact us at [Ducflair Support](https://www.ducflair.com/support).
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for more details.
+
+## Commit Message Guidelines
+
+To ensure smooth releases with semantic-release, please follow [these guidelines](https://semantic-release.gitbook.io/semantic-release#how-does-it-work).
+
+---
+
+*The duc format and libraries are constantly evolving, aiming to set new standards in the 2D CAD industry. Be a part of this transformation and help shape the future of design technology!*

ducpy-2.3.1/docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

ducpy-2.3.1/docs/conf.py

@@ -0,0 +1,47 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+
+project = 'ducpy'
+copyright = '2025, Ducflair'
+author = 'Ducflair'
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
+extensions = [
+]
+
+templates_path = ['_templates']
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+
+
+
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+
+html_theme = "furo"
+html_static_path = ['_static']
+
+extensions.append('autoapi.extension')
+autoapi_dirs = ["../src/ducpy"]
+# autoapi_keep_files = True
+autoapi_root = "autoapi"
+autoapi_add_toctree_entry = True
+autoapi_options = [
+    'members',
+    'undoc-members',
+    'private-members',
+    'show-inheritance',
+    'show-module-summary',
+    'special-members',
+]
+autoapi_python_use_implicit_namespaces = True
+autoapi_python_class_content = 'both'
+autoapi_module_name_override = {
+    'src.ducpy': 'ducpy',
+}

ducpy-2.3.1/docs/index.rst

@@ -0,0 +1,8 @@
+ducpy
+===================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   autoapi/index

ducpy-2.3.1/docs/make.bat

@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=.
+set BUILDDIR=_build
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.https://www.sphinx-doc.org/
+	exit /b 1
+)
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd

ducpy-2.3.1/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "ducpy",
+  "version": "0.0.0-development",
+  "private": true,
+  "scripts": {
+    "build": "bash -c 'SETUPTOOLS_SCM_PRETEND_VERSION=${1} uv build' --",
+    "gen:docs": "bun clean:docs && cd docs && uv run make html",
+    "clean:docs": "cd docs && uv run make clean",
+    "test": "uv run -m pytest src/tests/src/test_*.py",
+    "test:verbose": "uv run -m pytest -v src/tests/src/test_*.py",
+    "prerelease": "uv sync && bun run test",
+    "semantic-release": "semantic-release"
+  },
+  "devDependencies": {
+    "semantic-release": "^24.1.2"
+  }
+}

ducpy-2.3.1/pyproject.toml

@@ -0,0 +1,57 @@
+[project]
+name = "ducpy"
+dynamic = ["version"]
+description = "The library for the Duc 2D CAD file format"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "flatbuffers>=25.2.10",
+    "nanoid>=2.0.0",
+]
+
+license = { text = "MIT" }
+
+authors = [
+    { name = "Ducflair", email = "support@ducflair.com" },
+    { name = "Jorge Soares" }
+]
+
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+]
+
+[project.urls]
+"Homepage" = "https://duc.ducflair.com"
+"Source" = "https://github.com/ducflair/duc/tree/main/packages/ducpy"
+"Documentation" = "https://python.duc.ducflair.com"
+
+[build-system]
+requires = ["setuptools>=63.0", "setuptools-scm>=8.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+# Tells setuptools to find packages in the 'src' directory.
+# This replaces find_packages(where='src') and package_dir={'': 'src'} from setup.py.
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools_scm]
+version_scheme = "guess-next-dev"
+local_scheme = "node-and-date"
+fallback_version = "0.1.0"
+
+[dependency-groups]
+dev = [
+    "furo>=2024.8.6",
+    "sphinx>=8.1.3",
+    "sphinx-autoapi>=3.6.0",
+    "pytest>=8.3.5",
+    "numpy>=1.20.0",
+    "rich>=13.0.0",
+]
+
+
+[tool.pytest.ini_options]
+testpaths = ["src/tests"]
+python_files = "test_*.py"
+addopts = "-vv"

ducpy-2.3.1/release.config.cjs

@@ -0,0 +1,24 @@
+module.exports = {
+  branches: ["main", { name: "next", prerelease: true }, { name: "dev", prerelease: true }],
+  plugins: [
+    [
+      require.resolve("../../scripts/semrel-path-filter.cjs"),
+      {
+        paths: [
+          "packages/ducpy"
+        ],
+        analyzer: { preset: "conventionalcommits" },
+        notes: { preset: "conventionalcommits" },
+      },
+    ],
+    [
+      "@semantic-release/exec",
+      {
+        prepareCmd: "bun prerelease && bun run build ${nextRelease.version}",
+        publishCmd: "uv publish --token ${process.env.PYPI_TOKEN}",
+      },
+    ],
+    "@semantic-release/github",
+  ],
+  tagFormat: "ducpy@${version}",
+};

ducpy-2.3.1/setup.cfg

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

ducpy-2.3.1/setup.py

@@ -0,0 +1,63 @@
+import os
+import re
+from setuptools import setup
+
+# Path to the schema file, relative to this setup.py file
+# setup.py is in packages/ducpy/
+# schema/duc.fbs is at the workspace root, so ../../schema/duc.fbs
+SCHEMA_FILE_PATH = os.path.join(os.path.dirname(os.path.abspath(__file__)), '..', '..', 'schema', 'duc.fbs')
+# Path where _version.py will be written
+VERSION_PY_PATH = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'src', 'ducpy', '_version.py')
+
+def get_schema_version_from_fbs(fbs_file_path):
+    try:
+        with open(fbs_file_path, 'r') as f:
+            first_line = f.readline()
+            match = re.search(r'//\s*SCHEMA_VERSION\s*=\s*([0-9.]+)', first_line)
+            if match:
+                return match.group(1)
+    except FileNotFoundError:
+        # This is expected when building from sdist where schema file isn't present
+        return None # Return None to indicate schema file was not found
+    except Exception as e:
+        print(f"Warning: Could not parse schema version from {fbs_file_path}: {e}. Defaulting to 0.0.0.")
+    return "0.0.0" # Default version if parsing fails but file was found
+
+def generate_version_py():
+    """Generates the _version.py file with DUC_SCHEMA_VERSION."""
+    schema_version_from_fbs = get_schema_version_from_fbs(SCHEMA_FILE_PATH)
+
+    if schema_version_from_fbs is not None:
+        # Schema file was found (development or first-pass build)
+        # Or if it was found but parsing failed (defaulted to 0 by get_schema_version_from_fbs)
+        # always regenerate _version.py
+        print(f"Generating DUC schema version file at: {VERSION_PY_PATH} with version: {schema_version_from_fbs}")
+        os.makedirs(os.path.dirname(VERSION_PY_PATH), exist_ok=True)
+        with open(VERSION_PY_PATH, 'w') as f:
+            f.write(f'# This file is auto-generated by setup.py when the package is built.\n')
+            f.write(f'# Do not edit this file manually.\n')
+            f.write(f'DUC_SCHEMA_VERSION = "{schema_version_from_fbs}"\n')
+    elif os.path.exists(VERSION_PY_PATH):
+        # Schema file not found (likely sdist build) AND _version.py already exists.
+        # Trust the existing _version.py from the sdist.
+        print(f"DUC schema file not found. Using existing _version.py: {VERSION_PY_PATH}")
+    else:
+        # Schema file not found AND _version.py does not exist (edge case, should not happen with sdist).
+        # Fallback to generating with default 0.0.0 to ensure the file exists for import.
+        print(f"DUC schema file not found and _version.py does not exist. Generating with default version 0.0.0 at: {VERSION_PY_PATH}")
+        os.makedirs(os.path.dirname(VERSION_PY_PATH), exist_ok=True)
+        with open(VERSION_PY_PATH, 'w') as f:
+            f.write(f'# This file is auto-generated by setup.py (fallback).\n')
+            f.write(f'DUC_SCHEMA_VERSION = "0.0.0"\n')
+
+# --- Main part of setup.py --- 
+
+# Generate the version file when setup.py is processed by the build system.
+generate_version_py()
+
+# Minimal setup call.
+# Most package metadata (name, version via setuptools-scm, etc.) and 
+# package discovery are handled by pyproject.toml.
+# This setup.py is present for compatibility and can be used for tasks 
+# like C-extension building or build-time file generation if needed.
+setup() 

ducpy-2.3.1/src/__init__.py

@@ -0,0 +1 @@
+from . import ducpy

ducpy-2.3.1/src/ducpy/Duc/ANGULAR_UNITS_FORMAT.py

@@ -0,0 +1,10 @@
+# automatically generated by the FlatBuffers compiler, do not modify
+
+# namespace: Duc
+
+class ANGULAR_UNITS_FORMAT(object):
+    DECIMAL_DEGREES = 10
+    DEGREES_MINUTES_SECONDS = 11
+    GRADS = 12
+    RADIANS = 13
+    SURVEYOR = 14

ducpy-2.3.1/src/ducpy/Duc/AXIS.py

@@ -0,0 +1,8 @@
+# automatically generated by the FlatBuffers compiler, do not modify
+
+# namespace: Duc
+
+class AXIS(object):
+    X = 10
+    Y = 20
+    Z = 30