SVG2DrawIOLib 1.0.0__py3-none-any.whl

SVG2DrawIOLib/__about__.py

@@ -0,0 +1,3 @@
+"""Package version information."""
+
+__version__ = "1.0.0"

SVG2DrawIOLib/__init__.py

@@ -0,0 +1,21 @@
+"""SVG2DrawIOLib - Generate DrawIO shape libraries from SVG files."""
+
+from SVG2DrawIOLib.__about__ import __version__
+from SVG2DrawIOLib.library_manager import LibraryManager
+from SVG2DrawIOLib.models import (
+    DrawIOIcon,
+    LibraryMetadata,
+    SVGDimensions,
+    SVGProcessingOptions,
+)
+from SVG2DrawIOLib.svg_processor import SVGProcessor
+
+__all__ = [
+    "__version__",
+    "DrawIOIcon",
+    "LibraryManager",
+    "LibraryMetadata",
+    "SVGDimensions",
+    "SVGProcessingOptions",
+    "SVGProcessor",
+]

SVG2DrawIOLib/cli/__init__.py

@@ -0,0 +1,158 @@
+"""Command-line interface for SVG2DrawIOLib with dynamic command loading."""
+
+import importlib
+import logging
+from pathlib import Path
+
+import rich_click as rc
+
+# Configure rich-click for beautiful, colorful help output
+rc.rich_click.TEXT_MARKUP = "rich"
+rc.rich_click.SHOW_ARGUMENTS = True
+rc.rich_click.GROUP_ARGUMENTS_OPTIONS = True
+rc.rich_click.OPTIONS_TABLE_COLUMN_TYPES = ["required", "opt_short", "opt_long", "help"]
+rc.rich_click.OPTIONS_TABLE_HELP_SECTIONS = ["help", "deprecated", "envvar", "default", "required"]
+rc.rich_click.STYLE_ERRORS_SUGGESTION = "magenta italic"
+rc.rich_click.ERRORS_SUGGESTION = "Try running the '--help' flag for more information."
+rc.rich_click.ERRORS_EPILOGUE = ""
+rc.rich_click.MAX_WIDTH = 100
+rc.rich_click.COLOR_SYSTEM = "auto"
+
+# Style configuration
+rc.rich_click.STYLE_OPTION = "bold cyan"
+rc.rich_click.STYLE_ARGUMENT = "bold yellow"
+rc.rich_click.STYLE_COMMAND = "bold green"
+rc.rich_click.STYLE_SWITCH = "bold blue"
+rc.rich_click.STYLE_METAVAR = "bold magenta"
+rc.rich_click.STYLE_METAVAR_APPEND = "dim"
+rc.rich_click.STYLE_METAVAR_SEPARATOR = "dim"
+rc.rich_click.STYLE_HEADER_TEXT = "bold"
+rc.rich_click.STYLE_FOOTER_TEXT = "dim"
+rc.rich_click.STYLE_USAGE = "bold yellow"
+rc.rich_click.STYLE_USAGE_COMMAND = "bold"
+rc.rich_click.STYLE_DEPRECATED = "red"
+rc.rich_click.STYLE_HELPTEXT_FIRST_LINE = "bold"
+rc.rich_click.STYLE_HELPTEXT = ""
+rc.rich_click.STYLE_OPTION_HELP = ""
+rc.rich_click.STYLE_OPTION_DEFAULT = "dim"
+rc.rich_click.STYLE_REQUIRED_SHORT = "red"
+rc.rich_click.STYLE_REQUIRED_LONG = "dim red"
+rc.rich_click.ALIGN_OPTIONS_PANEL = "left"
+rc.rich_click.ALIGN_ARGUMENTS_PANEL = "left"
+
+# Command groups for organized help
+rc.rich_click.COMMAND_GROUPS = {
+    "SVG2DrawIOLib": [
+        {
+            "name": "Library Management Commands",
+            "commands": ["create", "add", "remove", "list"],
+            "table_styles": {
+                "show_lines": True,
+                "row_styles": ["none"],
+                "border_style": "blue",
+                "box": "ROUNDED",
+            },
+        }
+    ]
+}
+
+# Option groups for better organization
+rc.rich_click.OPTION_GROUPS = {
+    "SVG2DrawIOLib create": [
+        {
+            "name": "Required Options",
+            "options": ["--output"],
+        },
+        {
+            "name": "Sizing Options",
+            "options": ["--max-size", "--width", "--height"],
+        },
+        {
+            "name": "Styling Options",
+            "options": ["--css", "--css-color", "--namespace", "--tag"],
+        },
+        {
+            "name": "General Options",
+            "options": ["--recursive", "--verbose", "--quiet", "--help"],
+        },
+    ],
+    "SVG2DrawIOLib add": [
+        {
+            "name": "Duplicate Handling",
+            "options": ["--replace", "--add-dupes"],
+        },
+        {
+            "name": "Sizing Options",
+            "options": ["--max-size", "--width", "--height"],
+        },
+        {
+            "name": "Styling Options",
+            "options": ["--css"],
+        },
+        {
+            "name": "General Options",
+            "options": ["--recursive", "--verbose", "--quiet", "--help"],
+        },
+    ],
+    "SVG2DrawIOLib remove": [
+        {
+            "name": "Options",
+            "options": ["--verbose", "--quiet", "--help"],
+        },
+    ],
+    "SVG2DrawIOLib list": [
+        {
+            "name": "Options",
+            "options": ["--verbose", "--quiet", "--help"],
+        },
+    ],
+}
+
+logger = logging.getLogger(__name__)
+
+
+@rc.group()
+@rc.version_option()
+def cli() -> None:
+    """SVG2DrawIOLib - Manage DrawIO/diagrams.net shape libraries.
+
+    Convert SVG files into DrawIO libraries and manage existing libraries.
+    Supports color-editable icons and proportional scaling.
+
+    \b
+    Examples:
+        Create a new library from SVG files:
+        $ SVG2DrawIOLib create icons/*.svg -o my-library.xml
+
+        Add icons to an existing library:
+        $ SVG2DrawIOLib add my-library.xml new-icon.svg
+
+        List icons in a library:
+        $ SVG2DrawIOLib list my-library.xml
+    """
+    pass
+
+
+# Dynamic discovery: auto-register all CLI commands from cli/ directory
+COMMAND_DIR = Path(__file__).parent
+if COMMAND_DIR.exists():
+    for filepath in COMMAND_DIR.iterdir():
+        # Only import .py files that are not __init__.py or helpers.py
+        if filepath.suffix == ".py" and filepath.stem not in ("__init__", "helpers"):
+            command_name = filepath.stem
+            module_name = f"SVG2DrawIOLib.cli.{command_name}"
+            try:
+                module = importlib.import_module(module_name)
+                # Look for a function with the same name as the module
+                cli_function = getattr(module, command_name, None)
+                if cli_function and callable(cli_function):
+                    cli.add_command(cli_function)
+                    logger.debug(f"Registered command: {command_name}")
+                else:
+                    logger.debug(f"No command function found in {module_name}")
+            except Exception as e:
+                logger.debug(f"Failed to import {module_name}: {e}")
+
+
+if __name__ == "__main__":
+    cli()

SVG2DrawIOLib/cli/add.py

@@ -0,0 +1,241 @@
+"""Add command - Add SVG icons to an existing DrawIO library."""
+
+import logging
+import sys
+from pathlib import Path
+
+import rich_click as rc
+
+from SVG2DrawIOLib.cli.helpers import console, setup_logging
+from SVG2DrawIOLib.library_manager import LibraryManager
+from SVG2DrawIOLib.models import SVGProcessingOptions
+from SVG2DrawIOLib.svg_processor import SVGProcessor
+
+
+@rc.command()
+@rc.argument(
+    "library_file",
+    type=rc.Path(exists=True, dir_okay=False, path_type=Path),
+)
+@rc.argument(
+    "svg_paths",
+    nargs=-1,
+    required=True,
+    type=rc.Path(exists=True, path_type=Path),
+    metavar="PATHS...",
+)
+@rc.option(
+    "--replace",
+    "-r",
+    is_flag=True,
+    help="Replace icons with duplicate names (default: skip duplicates).",
+)
+@rc.option(
+    "--add-dupes",
+    "-d",
+    is_flag=True,
+    help="Add duplicate icons with modified names (e.g., icon_2, icon_3).",
+)
+@rc.option(
+    "--max-size",
+    "-s",
+    type=float,
+    help="Maximum dimension for new icons (scaled proportionally).",
+)
+@rc.option(
+    "--width",
+    "-w",
+    type=float,
+    help="Fixed width in pixels (overrides --max-size).",
+)
+@rc.option(
+    "--height",
+    "-h",
+    type=float,
+    help="Fixed height in pixels (overrides --max-size).",
+)
+@rc.option(
+    "--css/--no-css",
+    "-c/-C",
+    default=False,
+    help="Add CSS classes to new icons for color editing.",
+)
+@rc.option(
+    "--verbose",
+    "-v",
+    is_flag=True,
+    help="Enable verbose debug logging.",
+)
+@rc.option(
+    "--quiet",
+    "-q",
+    is_flag=True,
+    help="Suppress all output except errors.",
+)
+@rc.option(
+    "--recursive",
+    "-R",
+    is_flag=True,
+    help="Recursively search directories for SVG files.",
+)
+def add(
+    library_file: Path,
+    svg_paths: tuple[Path, ...],
+    replace: bool,
+    add_dupes: bool,
+    max_size: float | None,
+    width: float | None,
+    height: float | None,
+    css: bool,
+    verbose: bool,
+    quiet: bool,
+    recursive: bool,
+) -> None:
+    """Add SVG icons to an existing DrawIO library.
+
+    Processes SVG files and adds them to an existing library.
+    By default, skips icons with duplicate names.
+
+    Accepts individual SVG files, directories, or a mix of both.
+    Use --recursive to search subdirectories.
+
+    \b
+    Duplicate Handling:
+        Default: Skip icons with duplicate names
+        --replace: Replace existing icons with same names
+        --add-dupes: Add duplicates with modified names (e.g., icon_2, icon_3)
+
+    \b
+    Scaling Options:
+        --max-size: Scale icons proportionally (longest side = max-size)
+        --width/--height: Set fixed dimensions (ignores aspect ratio)
+        Neither: Use original dimensions or library defaults
+
+    \b
+    Examples:
+        Add individual files:
+        $ SVG2DrawIOLib add my-library.xml new-icon1.svg new-icon2.svg
+
+
+        Add from directory:
+        $ SVG2DrawIOLib add my-library.xml icons/
+
+
+        Add from directory recursively:
+        $ SVG2DrawIOLib add my-library.xml icons/ --recursive
+
+
+        Replace existing icons with same names:
+        $ SVG2DrawIOLib add my-library.xml icons/ --replace
+
+
+        Add duplicates with modified names:
+        $ SVG2DrawIOLib add my-library.xml icons/ --add-dupes
+
+
+        Add with proportional scaling:
+        $ SVG2DrawIOLib add my-library.xml icons/ --max-size 64 -R
+
+
+        Add with fixed dimensions:
+        $ SVG2DrawIOLib add my-library.xml icons/ -w 50 -h 50
+    """
+    setup_logging(verbose, quiet)
+    logger = logging.getLogger(__name__)
+
+    try:
+        # Validate conflicting options
+        if replace and add_dupes:
+            console.print(
+                "[red]Error:[/red] Cannot use both --replace and --add-dupes", style="bold"
+            )
+            sys.exit(1)
+
+        # Collect all SVG files from paths (files and/or directories)
+        svg_files = []
+        for path in svg_paths:
+            if path.is_file():
+                if path.suffix.lower() == ".svg":
+                    svg_files.append(path)
+                else:
+                    logger.warning(f"Skipping non-SVG file: {path}")
+            elif path.is_dir():
+                if recursive:
+                    # Recursively find all .svg files
+                    found = list(path.rglob("*.svg"))
+                    svg_files.extend(found)
+                    logger.debug(f"Found {len(found)} SVG file(s) in {path} (recursive)")
+                else:
+                    # Only direct children
+                    found = list(path.glob("*.svg"))
+                    svg_files.extend(found)
+                    logger.debug(f"Found {len(found)} SVG file(s) in {path}")
+            else:
+                logger.warning(f"Path does not exist or is not accessible: {path}")
+
+        # Validate we found files
+        if not svg_files:
+            console.print("[red]Error:[/red] No SVG files found in specified paths", style="bold")
+            sys.exit(1)
+
+        # Determine sizing strategy
+        if width is not None and height is not None:
+            # Fixed dimensions - will be handled per-icon
+            max_dimension = None
+            logger.info(f"Using fixed dimensions: {width}x{height}")
+        elif width is not None or height is not None:
+            # Only one dimension specified - warn user
+            console.print(
+                "[yellow]Warning:[/yellow] Both --width and --height must be specified for fixed dimensions. "
+                "Using original dimensions instead.",
+                style="bold",
+            )
+            max_dimension = None
+            logger.warning("Only one dimension specified, using original dimensions")
+        elif max_size is not None:
+            max_dimension = max_size
+            logger.info(f"Using proportional scaling with max dimension: {max_size}")
+        else:
+            max_dimension = None
+            logger.info("Using original dimensions")
+
+        # Create processing options
+        options = SVGProcessingOptions(add_css=css)
+
+        # Process new SVG files
+        processor = SVGProcessor(options)
+        new_icons = []
+
+        logger.info(f"Processing {len(svg_files)} SVG file(s)")
+
+        for svg_path in svg_files:
+            try:
+                # If fixed dimensions specified, pass them to processor
+                if width is not None and height is not None:
+                    icon = processor.process_svg_file(svg_path, fixed_dimensions=(width, height))
+                else:
+                    icon = processor.process_svg_file(svg_path, max_dimension=max_dimension)
+
+                new_icons.append(icon)
+            except Exception as e:
+                logger.error(f"Failed to process {svg_path}: {e}")
+                if verbose:
+                    raise
+                sys.exit(1)
+
+        # Add to library
+        manager = LibraryManager()
+        metadata = manager.add_icons_to_library(
+            library_file, new_icons, replace_duplicates=replace, add_duplicates=add_dupes
+        )
+
+        console.print(
+            f"[green]✓[/green] Updated library with {metadata.icon_count} total icon(s): "
+            f"[cyan]{library_file}[/cyan]"
+        )
+
+    except Exception as e:
+        logger.error(f"Error: {e}")
+        if verbose:
+            raise
+        sys.exit(1)

SVG2DrawIOLib/cli/create.py

@@ -0,0 +1,242 @@
+"""Create command - Create a new DrawIO library from SVG files."""
+
+import logging
+import sys
+from pathlib import Path
+
+import rich_click as rc
+
+from SVG2DrawIOLib.cli.helpers import console, setup_logging
+from SVG2DrawIOLib.library_manager import LibraryManager
+from SVG2DrawIOLib.models import SVGProcessingOptions
+from SVG2DrawIOLib.svg_processor import SVGProcessor
+
+
+@rc.command()
+@rc.argument(
+    "svg_paths",
+    nargs=-1,
+    required=True,
+    type=rc.Path(exists=True, path_type=Path),
+    metavar="PATHS...",
+)
+@rc.option(
+    "--output",
+    "-o",
+    type=rc.Path(path_type=Path),
+    required=True,
+    help="Output library file path (e.g., my-library.xml).",
+)
+@rc.option(
+    "--max-size",
+    "-s",
+    type=float,
+    help="Maximum dimension (width or height) in pixels. Icons are scaled proportionally.",
+)
+@rc.option(
+    "--width",
+    "-w",
+    type=float,
+    help="Fixed width in pixels (overrides --max-size).",
+)
+@rc.option(
+    "--height",
+    "-h",
+    type=float,
+    help="Fixed height in pixels (overrides --max-size).",
+)
+@rc.option(
+    "--css/--no-css",
+    "-c/-C",
+    default=False,
+    help="Add CSS classes to enable color editing in DrawIO.",
+)
+@rc.option(
+    "--css-color",
+    default="#000000",
+    show_default=True,
+    help="Default CSS fill color (requires --css).",
+)
+@rc.option(
+    "--namespace",
+    "-n",
+    default="http://www.w3.org/2000/svg",
+    show_default=True,
+    help="XML namespace for SVG elements.",
+)
+@rc.option(
+    "--tag",
+    "-t",
+    default="path",
+    show_default=True,
+    help="XML tag to add CSS classes to (requires --css).",
+)
+@rc.option(
+    "--verbose",
+    "-v",
+    is_flag=True,
+    help="Enable verbose debug logging.",
+)
+@rc.option(
+    "--quiet",
+    "-q",
+    is_flag=True,
+    help="Suppress all output except errors.",
+)
+@rc.option(
+    "--recursive",
+    "-R",
+    is_flag=True,
+    help="Recursively search directories for SVG files.",
+)
+def create(
+    svg_paths: tuple[Path, ...],
+    output: Path,
+    max_size: float | None,
+    width: float | None,
+    height: float | None,
+    css: bool,
+    css_color: str,
+    namespace: str,
+    tag: str,
+    verbose: bool,
+    quiet: bool,
+    recursive: bool,
+) -> None:
+    """Create a new DrawIO library from SVG files.
+
+    Converts one or more SVG files into a DrawIO library XML file.
+    Icons can be scaled proportionally or set to fixed dimensions.
+
+    Accepts individual SVG files, directories, or a mix of both.
+    Use --recursive to search subdirectories.
+
+    \b
+    Scaling Options:
+        --max-size: Scale icons proportionally (longest side = max-size)
+        --width/--height: Set fixed dimensions (ignores aspect ratio)
+        Neither: Use default 40x40 pixels
+
+    Examples:
+        Create from individual files:
+        $ SVG2DrawIOLib create icon1.svg icon2.svg -o lib.xml
+
+
+        Create from directory:
+        $ SVG2DrawIOLib create icons/ -o lib.xml
+
+
+        Create from directory recursively:
+        $ SVG2DrawIOLib create icons/ -o lib.xml --recursive
+
+
+        Create with proportional scaling (max 64px):
+        $ SVG2DrawIOLib create icons/ -o lib.xml --max-size 64 -R
+
+
+        Create with fixed dimensions:
+        $ SVG2DrawIOLib create icons/*.svg -o lib.xml -w 50 -h 50
+
+
+        Enable color editing:
+        $ SVG2DrawIOLib create icons/ -o lib.xml --css
+    """
+    setup_logging(verbose, quiet)
+    logger = logging.getLogger(__name__)
+
+    try:
+        # Collect all SVG files from paths (files and/or directories)
+        svg_files = []
+        for path in svg_paths:
+            if path.is_file():
+                if path.suffix.lower() == ".svg":
+                    svg_files.append(path)
+                else:
+                    logger.warning(f"Skipping non-SVG file: {path}")
+            elif path.is_dir():
+                if recursive:
+                    # Recursively find all .svg files
+                    found = list(path.rglob("*.svg"))
+                    svg_files.extend(found)
+                    logger.debug(f"Found {len(found)} SVG file(s) in {path} (recursive)")
+                else:
+                    # Only direct children
+                    found = list(path.glob("*.svg"))
+                    svg_files.extend(found)
+                    logger.debug(f"Found {len(found)} SVG file(s) in {path}")
+            else:
+                logger.warning(f"Path does not exist or is not accessible: {path}")
+
+        # Validate we found files
+        if not svg_files:
+            console.print("[red]Error:[/red] No SVG files found in specified paths", style="bold")
+            sys.exit(1)
+
+        # Determine sizing strategy
+        if width is not None and height is not None:
+            # Fixed dimensions - will be handled per-icon
+            max_dimension = None
+            logger.info(f"Using fixed dimensions: {width}x{height}")
+        elif width is not None or height is not None:
+            # Only one dimension specified - warn user
+            console.print(
+                "[yellow]Warning:[/yellow] Both --width and --height must be specified for fixed dimensions. "
+                "Using default sizing instead.",
+                style="bold",
+            )
+            max_dimension = None
+            logger.warning("Only one dimension specified, using default sizing")
+        elif max_size is not None:
+            max_dimension = max_size
+            logger.info(f"Using proportional scaling with max dimension: {max_size}")
+        else:
+            max_dimension = None
+            logger.info("Using default dimensions: 40x40")
+
+        # Create processing options
+        options = SVGProcessingOptions(
+            add_css=css,
+            css_color=css_color,
+            xml_namespace=namespace,
+            css_tag=tag,
+        )
+
+        # Process SVG files
+        processor = SVGProcessor(options)
+        icons = []
+
+        logger.info(f"Processing {len(svg_files)} SVG file(s)")
+
+        for svg_path in svg_files:
+            try:
+                # If fixed dimensions specified, pass them to processor
+                if width is not None and height is not None:
+                    icon = processor.process_svg_file(svg_path, fixed_dimensions=(width, height))
+                else:
+                    icon = processor.process_svg_file(svg_path, max_dimension=max_dimension)
+
+                icons.append(icon)
+
+            except Exception as e:
+                logger.error(f"Failed to process {svg_path}: {e}")
+                if verbose:
+                    raise
+                sys.exit(1)
+
+        # Create library
+        manager = LibraryManager()
+        metadata = manager.create_library(icons, output)
+
+        console.print(
+            f"[green]✓[/green] Created library with {metadata.icon_count} icon(s): "
+            f"[cyan]{output}[/cyan]"
+        )
+
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Interrupted by user[/yellow]")
+        sys.exit(130)
+    except Exception as e:
+        logger.error(f"Unexpected error: {e}")
+        if verbose:
+            raise
+        sys.exit(1)

SVG2DrawIOLib/cli/helpers.py

@@ -0,0 +1,29 @@
+"""Helper functions and utilities for CLI commands."""
+
+import logging
+
+from rich.console import Console
+from rich.logging import RichHandler
+
+console = Console()
+
+
+def setup_logging(verbose: bool, quiet: bool) -> None:
+    """Configure logging with rich output.
+
+    Args:
+        verbose: Enable debug-level logging.
+        quiet: Suppress all but error-level logging.
+    """
+    if quiet:
+        level = logging.ERROR
+    elif verbose:
+        level = logging.DEBUG
+    else:
+        level = logging.INFO
+
+    logging.basicConfig(
+        level=level,
+        format="%(message)s",
+        handlers=[RichHandler(console=console, rich_tracebacks=True, show_time=False)],
+    )