Add PyGerber 3 Parser implementation

pyproject.toml

@@ -58,6 +58,7 @@ numpy = [
 pygls = { version = "^1.0.2", optional = true }
 lsprotocol = { version = "^2023.0.0a3", optional = true }
 drawsvg = { version = "^2.3.0", optional = true }
+typing-extensions = "^4.12.2"
 
 [tool.poetry.group.dev.dependencies]
 mypy = "^1.6.1"
@@ -80,6 +81,7 @@ pytest-cov = ">=4.1,<6.0"
 pytest-lsp = "^0.4.2"
 pytest-asyncio = "^0.23.7"
 
+pytest-mock = "^3.14.0"
 [tool.poetry.group.docs]
 optional = true
 
@@ -112,23 +114,22 @@ pygerber_language_server = "pygerber.gerberx3.language_server.__main__:main"
 # -------------------------------------------------------------------------------------
 # git hooks
 install-hooks = [
-    { cmd = "poetry install --sync --with=docs --extras=language-server --extras=svg  --no-ansi" },
+    { cmd = "poetry install --sync --with=docs --extras=all  --no-ansi" },
     { cmd = "poetry run python -m scripts.install_hooks" },
     { cmd = "poetry run pre-commit install --install-hooks --overwrite" },
 ]
 # -------------
 # hook triggers
 run-code-quality-checks = [
-    { cmd = "poetry install --sync --with=docs --extras=language-server --extras=svg  --no-ansi" },
+    { cmd = "poetry install --sync --with=docs --extras=all  --no-ansi" },
     { cmd = "poetry run pre-commit run --all-files -v" },
 ]
 # -------------------------------------------------------------------------------------
 run-unit-tests = [
-    { cmd = "poetry install --sync --with=docs --extras=language-server --extras=svg  --no-ansi" },
+    { cmd = "poetry install --sync --with=docs --extras=all  --no-ansi" },
     { cmd = "poetry run pytest --log-level=DEBUG -s -n logical --cov=pygerber --cov-report=term-missing:skip-covered" },
 ]
 run-type-checks = [
-    { cmd = "poetry install --sync --with=docs --extras=language-server --extras=svg --no-ansi" },
     { cmd = "poetry run mypy --config-file=pyproject.toml src/pygerber/ test/" },
 ]
 
@@ -150,6 +151,7 @@ lint.ignore = [
     "ISC001", # Checks for the absence of trailing commas. Conflicts with ruff format.
     "COM812", # Checks for implicitly concatenated strings on a single line. Conflicts with ruff format.
     "S101",   # Use of assert detected. The enclosed code will be removed when compiling to optimised byte code.
+    "EXE002", # Breaks on file systems which do not support executable permissions.
 ]
 show-fixes = true
 target-version = "py38"

src/pygerber/console/commands.py

@@ -2,17 +2,11 @@
 
 from __future__ import annotations
 
-from pathlib import Path
-from typing import Generator, Optional, TextIO
+from typing import Generator
 
 import click
 
 import pygerber
-from pygerber.console.raster_2d_style import (
-    STYLE_TO_COLOR_SCHEME,
-    get_color_scheme_from_style,
-)
-from pygerber.gerberx3.api import Rasterized2DLayer, Rasterized2DLayerParams
 from pygerber.gerberx3.api.v2 import (
     DEFAULT_ALPHA_COLOR_MAP,
     DEFAULT_COLOR_MAP,
@@ -32,90 +26,6 @@ def main() -> None:
     """
 
 
-@main.command("raster-2d")
-@click.argument("source", type=click.File())
-@click.option(
-    "-s",
-    "--style",
-    default="copper",
-    type=click.Choice(list(STYLE_TO_COLOR_SCHEME.keys()), case_sensitive=False),
-    help="Color style of the rendered image. When style is 'custom' then option "
-    "`--custom` must also be provided. Default is 'copper'.",
-)
-@click.option(
-    "-o",
-    "--output",
-    type=Path,
-    default="output.png",
-    help="Path to output file. File format will be inferred from extension, unless "
-    "`--format` is given. Default is 'output.png'",
-)
-@click.option(
-    "-f",
-    "--format",
-    "format_",
-    type=str,
-    default=None,
-    help="Output image format. Can be omitted, then format will be inferred from file"
-    "extension or be one of formats supported by Pillow.",
-)
-@click.option(
-    "-c",
-    "--custom",
-    type=str,
-    default=None,
-    help="String representing custom set of colors for rendering.\n"
-    "Custom color should be a single string consisting of 5 or 7 valid hexadecimal "
-    "colors separated with commas. Any color which can be parsed by RGBA type is "
-    "accepted.\n"
-    "Colors are assigned in order:"
-    "\n\n"
-    "- background_color\n\n"
-    "- clear_color\n\n"
-    "- solid_color\n\n"
-    "- clear_region_color\n\n"
-    "- solid_region_color\n\n"
-    "- debug_1_color (optional, by default #ABABAB)\n\n"
-    "- debug_2_color (optional, by default #7D7D7D)\n\n"
-    "\n\n"
-    'eg. `"000000,000000,FFFFFF,000000,FFFFFF"`',
-)
-@click.option(
-    "-d",
-    "--dpi",
-    type=int,
-    default=1000,
-    help="DPI of output image, by default 1000.",
-)
-def raster_2d(
-    source: TextIO,
-    style: str,
-    output: Path,
-    format_: Optional[str],
-    custom: Optional[str],
-    dpi: int,
-) -> None:
-    """Render rasterized 2D image from Gerber X3/X2 SOURCE file.
-
-    SOURCE - A path to the Gerber file to render.
-
-    List of file formats supported by Pillow:
-    https://pillow.readthedocs.io/en/stable/handbook/image-file-formats.html
-
-    \x08
-    RGBA type documentation:
-    https://argmaster.github.io/pygerber/latest/reference/pygerber/gerberx3/api/__init__.html#pygerber.common.rgba.RGBA.from_hex
-    """  # noqa: D301
-    gerber_code = source.read()
-    Rasterized2DLayer(
-        options=Rasterized2DLayerParams(
-            source_code=gerber_code,
-            colors=get_color_scheme_from_style(style, custom),
-            dpi=dpi,
-        ),
-    ).render().save(output, format=format_)
-
-
 @main.command("is-language-server-available")
 def _is_language_server_available() -> None:
     from pygerber.gerberx3.language_server import IS_LANGUAGE_SERVER_FEATURE_AVAILABLE

src/pygerber/gerberx3/api/__init__.py

@@ -11,53 +11,11 @@
     MutuallyExclusiveViolationError,
     RenderingResultNotReadyError,
 )
-from pygerber.gerberx3.api._layers import (
-    Layer,
-    LayerParams,
-    LayerProperties,
-    Rasterized2DLayer,
-    Rasterized2DLayerParams,
-    RenderingResult,
-)
-from pygerber.gerberx3.parser.errors import (
-    ApertureNotDefinedError,
-    ApertureNotSelectedError,
-    CoordinateFormatNotSetError,
-    ExitParsingProcessInterrupt,
-    IncrementalCoordinatesNotSupportedError,
-    InvalidCoordinateLengthError,
-    OnUpdateDrawingStateError,
-    ParserError,
-    ParserFatalError,
-    UnitNotSetError,
-    UnsupportedCoordinateTypeError,
-    ZeroOmissionNotSupportedError,
-)
-from pygerber.gerberx3.parser.parser import ParserOnErrorAction
 
 __all__ = [
     "RGBA",
     "ColorScheme",
-    "Layer",
-    "LayerParams",
-    "Rasterized2DLayer",
-    "Rasterized2DLayerParams",
-    "LayerProperties",
-    "RenderingResult",
-    "ParserOnErrorAction",
     "GerberX3APIError",
     "RenderingResultNotReadyError",
     "MutuallyExclusiveViolationError",
-    "ParserError",
-    "ZeroOmissionNotSupportedError",
-    "IncrementalCoordinatesNotSupportedError",
-    "UnsupportedCoordinateTypeError",
-    "InvalidCoordinateLengthError",
-    "ParserFatalError",
-    "OnUpdateDrawingStateError",
-    "UnitNotSetError",
-    "ApertureNotDefinedError",
-    "CoordinateFormatNotSetError",
-    "ApertureNotSelectedError",
-    "ExitParsingProcessInterrupt",
 ]