pygrbl-build 0.0.1__tar.gz

pygrbl_build-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pygrbl_build Beltrán Offerrall Selma
+
+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.

pygrbl_build-0.0.1/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: pygrbl_build
+Version: 0.0.1
+Summary: G-code generation algorithms for GRBL diode lasers from different sources; raster Line-to-Line (LaserGRBL-faithful) available today
+Author: pygrbl_build developers
+License-Expression: MIT
+Keywords: grbl,gcode,laser,raster,lasergrbl,engraving
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Manufacturing
+Classifier: Operating System :: OS Independent
+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: Programming Language :: C
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pillow<12,>=11.3.0
+Dynamic: license-file
+
+# PyGrbl_Build 0.0.1
+
+[![PyPI](https://img.shields.io/pypi/v/pygrbl_build.svg)](https://pypi.org/project/pygrbl_build/)
+
+A collection of algorithms to generate **G-code for GRBL diode lasers**
+from different sources. Two algorithms today:
+
+- **Line-to-Line** (`l2l_gcode`) — raster engraving from an image, with
+  LaserGRBL fidelity.
+- **SVG vector** (`svg_gcode`) — vector tracing from an SVG (paths,
+  basic shapes, groups, transforms), a faithful port of LaserGRBL's SVG
+  import. Pure Python, no extra dependency.
+
+Part of the **pygrbl** family, a set of libraries to manage GRBL.
+Companion to [`pygrbl_streamer`](https://github.com/offerrall/pygrbl_streamer)
+
+## Speed
+
+This is the whole point. A full 300 mm @ 10 lines/mm raster job — nearly
+**4.7 million lines** of G-code — comes out in **~0.34 s**. LaserGRBL can
+take around **2 minutes** to produce the same job: that's roughly a
+**350× speedup**, and byte-for-byte the same output.
+
+## Install
+
+```
+pip install pygrbl_build
+```
+
+**The only requirements are Pillow and a C compiler.** Pillow is the
+single Python dependency (image loading and resizing); the C compiler is
+needed at install time because the raster engine ships as a C extension.
+Nothing else — no numpy, no runtime toolchain.
+
+## Usage
+
+Each algorithm pairs a `*_gcode` generator with its own `*Profile`
+config, so adding one never touches the others.
+
+Raster Line-to-Line (`l2l_gcode` + `L2LProfile`):
+
+```python
+from pygrbl_build import L2LProfile, l2l_gcode, write_gcode
+
+profile = L2LProfile(width_mm=300.0, lines_per_mm=10.0, feed=3000, s_max=100)
+write_gcode(l2l_gcode("shield.png", profile), "shield.nc")
+```
+
+SVG vector (`svg_gcode` + `SvgProfile`):
+
+```python
+from pygrbl_build import SvgProfile, svg_gcode, write_gcode
+
+profile = SvgProfile(feed=1000, s_max=255)
+write_gcode(svg_gcode("logo.svg", profile), "logo.nc")
+```
+
+`SvgProfile`'s defaults reproduce LaserGRBL's own SVG-import defaults, so
+the output matches the desktop app for the same drawing. `text` and
+`image` elements are skipped — convert text to paths in your editor
+first.
+
+`write_gcode` writes the path verbatim, so you choose the extension
+(`.nc`, `.gcode`, `.g`, ...). It's just a convenience: every `*_gcode`
+generator is a lazy iterator of lines, so anything beyond writing a
+plain file (compression, network shipping, streaming to the machine) is
+the upper layer's job — consume the iterator with whatever sink you need.
+
+Public API: `L2LProfile`, `l2l_gcode`, `SvgProfile`, `svg_gcode`,
+`write_gcode`. See the docstrings.

pygrbl_build-0.0.1/README.md

@@ -0,0 +1,70 @@
+# PyGrbl_Build 0.0.1
+
+[![PyPI](https://img.shields.io/pypi/v/pygrbl_build.svg)](https://pypi.org/project/pygrbl_build/)
+
+A collection of algorithms to generate **G-code for GRBL diode lasers**
+from different sources. Two algorithms today:
+
+- **Line-to-Line** (`l2l_gcode`) — raster engraving from an image, with
+  LaserGRBL fidelity.
+- **SVG vector** (`svg_gcode`) — vector tracing from an SVG (paths,
+  basic shapes, groups, transforms), a faithful port of LaserGRBL's SVG
+  import. Pure Python, no extra dependency.
+
+Part of the **pygrbl** family, a set of libraries to manage GRBL.
+Companion to [`pygrbl_streamer`](https://github.com/offerrall/pygrbl_streamer)
+
+## Speed
+
+This is the whole point. A full 300 mm @ 10 lines/mm raster job — nearly
+**4.7 million lines** of G-code — comes out in **~0.34 s**. LaserGRBL can
+take around **2 minutes** to produce the same job: that's roughly a
+**350× speedup**, and byte-for-byte the same output.
+
+## Install
+
+```
+pip install pygrbl_build
+```
+
+**The only requirements are Pillow and a C compiler.** Pillow is the
+single Python dependency (image loading and resizing); the C compiler is
+needed at install time because the raster engine ships as a C extension.
+Nothing else — no numpy, no runtime toolchain.
+
+## Usage
+
+Each algorithm pairs a `*_gcode` generator with its own `*Profile`
+config, so adding one never touches the others.
+
+Raster Line-to-Line (`l2l_gcode` + `L2LProfile`):
+
+```python
+from pygrbl_build import L2LProfile, l2l_gcode, write_gcode
+
+profile = L2LProfile(width_mm=300.0, lines_per_mm=10.0, feed=3000, s_max=100)
+write_gcode(l2l_gcode("shield.png", profile), "shield.nc")
+```
+
+SVG vector (`svg_gcode` + `SvgProfile`):
+
+```python
+from pygrbl_build import SvgProfile, svg_gcode, write_gcode
+
+profile = SvgProfile(feed=1000, s_max=255)
+write_gcode(svg_gcode("logo.svg", profile), "logo.nc")
+```
+
+`SvgProfile`'s defaults reproduce LaserGRBL's own SVG-import defaults, so
+the output matches the desktop app for the same drawing. `text` and
+`image` elements are skipped — convert text to paths in your editor
+first.
+
+`write_gcode` writes the path verbatim, so you choose the extension
+(`.nc`, `.gcode`, `.g`, ...). It's just a convenience: every `*_gcode`
+generator is a lazy iterator of lines, so anything beyond writing a
+plain file (compression, network shipping, streaming to the machine) is
+the upper layer's job — consume the iterator with whatever sink you need.
+
+Public API: `L2LProfile`, `l2l_gcode`, `SvgProfile`, `svg_gcode`,
+`write_gcode`. See the docstrings.

pygrbl_build-0.0.1/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pygrbl_build"
+description = "G-code generation algorithms for GRBL diode lasers from different sources; raster Line-to-Line (LaserGRBL-faithful) available today"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "pygrbl_build developers" }]
+keywords = ["grbl", "gcode", "laser", "raster", "lasergrbl", "engraving"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Manufacturing",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: C",
+    "Topic :: Scientific/Engineering :: Image Processing",
+    "Typing :: Typed",
+]
+dynamic = ["version"]
+
+dependencies = [
+    "pillow>=11.3.0,<12",
+]
+
+[dependency-groups]
+dev = ["pytest"]
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+packages = ["pygrbl_build"]
+
+[tool.setuptools.package-data]
+pygrbl_build = ["py.typed"]
+
+[tool.setuptools.dynamic]
+version = { attr = "pygrbl_build.__version__" }

pygrbl_build-0.0.1/setup.cfg

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

pygrbl_build-0.0.1/setup.py

@@ -0,0 +1,16 @@
+"""Extension build hook for pygrbl_build's C engine.
+
+All package metadata lives in pyproject.toml; this file exists only
+because declarative config cannot describe ext_modules.
+"""
+
+from setuptools import Extension, setup
+
+setup(
+    ext_modules=[
+        Extension(
+            "pygrbl_build._l2l_native",
+            sources=["src/pygrbl_build/_l2l_native.c"],
+        )
+    ],
+)