drawsvg-ui 0.4.0__tar.gz

drawsvg_ui-0.4.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: drawsvg-ui
+Version: 0.4.0
+Summary: GUI for creating drawsvg scenes with PySide6
+Author: UI_drawsvg maintainers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: drawsvg<3,>=2.4
+Requires-Dist: PySide6<7,>=6.9.2
+Requires-Dist: PySide6-Addons<7,>=6.9.2
+Requires-Dist: PySide6-Essentials<7,>=6.9.2
+Requires-Dist: shiboken6<7,>=6.9.2
+
+# DrawSVG UI
+
+This repository provides a graphical user interface designed to make it easier to create files with the [drawsvg](https://pypi.org/project/drawsvg/) library.  
+Instead of writing raw Python code by hand, you can visually place, move, and edit shapes on a canvas, then export your work as a ready-to-use `drawsvg` file. The UI runs on PySide6 and comes with a property inspector, snapping/grid helpers and a set of ready-made shapes.
+
+The goal of this project is to help users quickly prototype and generate `drawsvg` code through an intuitive drag-and-drop UI.
+
+## Requirements
+
+The application requires **Python 3.10**.  
+Dependencies include:
+
+* **drawsvg**  
+* **PySide6**
+
+
+## Install via PyPI
+You can install the packaged app and launch it via the generated executable script:
+
+```bash
+python -m pip install --upgrade drawsvg-ui
+drawsvg-ui  # on Windows this is available as drawsvg-ui.exe
+```
+
+
+## Install all via dependencies with:
+
+```bash
+python -m pip install -r requirements.txt
+```
+
+## Running the Application
+After installing the dependencies, start the application with:
+
+```bash
+python src/main.py
+```
+
+## UI Features
+
+### Canvas and navigation
+* A4 canvas with grid/subgrid preview; toggle visibility via `Edit → Show grid`.
+* Snap-to-grid movement and resizing; hold `Alt` to place/drag/resize freely.
+* Automatic extra A4 pages when objects cross page borders; empty pages are cleaned up again.
+* Zoom with `Ctrl`/`Alt` + mouse wheel; pan with middle button or right-button drag (right click on empty space resets zoom).
+* Rotation handle above the selection; snaps to 5° steps, hold `Alt` for smooth rotation with a live angle readout.
+
+### Shape palette
+* Drag shapes from the palette or click to drop them at the view center.
+* Shapes: rectangle, rounded rectangle, split rounded rectangle (adjustable header), ellipse/circle, triangle, diamond, line, arrow, block arrow, curvy right bracket, text box, and a folder-tree placeholder.
+
+### Editing and layout
+* Rubber-band selection; add to selection with `Ctrl`/`Shift` click; duplicate selection with `Ctrl` + drag.
+* Resize via handles; items snap while moving/resizing unless `Alt` is held.
+* Align multiple items (left/center/right, top/middle/bottom, snap to grid) from the context menu.
+* Group/ungroup selections (`Ctrl+G` / `Ctrl+Shift+G`) and change z-order (bring forward/back).
+* Delete with the `Delete` key or clear everything via `Edit → Clear canvas`. Full undo/redo stack (`Ctrl+Z`, `Ctrl+Y` / `Ctrl+Shift+Z`).
+
+### Styling, text, and labels
+* Context menu or properties panel to edit fill/stroke color, opacity, stroke width, and line style (solid/dashed/dotted).
+* Corner radius for rectangles; adjustable divider and separate top/bottom fills for split rounded rectangles.
+* Arrowheads on lines/arrows with configurable width/height; block arrow head/shaft ratios; curvy bracket hook depth.
+* Built-in labels for supported shapes: edit text inline or in the properties panel, set font family/size/color, and horizontal/vertical alignment.
+* Text items support multi-line content, font and padding, alignment, and left-to-right or right-to-left direction.
+
+### Properties panel
+* Live inspector synced to the current selection: position, rotation, scale, z-value, size, stroke/fill, and shape-specific options.
+* Dedicated text tab for labels/text content including font, color, padding, alignment, and direction controls.
+
+### Import/Export
+* Load or save scenes as ready-to-run `drawsvg` Python files via the `File` menu.
+
+

drawsvg_ui-0.4.0/README.md

@@ -0,0 +1,73 @@
+# DrawSVG UI
+
+This repository provides a graphical user interface designed to make it easier to create files with the [drawsvg](https://pypi.org/project/drawsvg/) library.  
+Instead of writing raw Python code by hand, you can visually place, move, and edit shapes on a canvas, then export your work as a ready-to-use `drawsvg` file. The UI runs on PySide6 and comes with a property inspector, snapping/grid helpers and a set of ready-made shapes.
+
+The goal of this project is to help users quickly prototype and generate `drawsvg` code through an intuitive drag-and-drop UI.
+
+## Requirements
+
+The application requires **Python 3.10**.  
+Dependencies include:
+
+* **drawsvg**  
+* **PySide6**
+
+
+## Install via PyPI
+You can install the packaged app and launch it via the generated executable script:
+
+```bash
+python -m pip install --upgrade drawsvg-ui
+drawsvg-ui  # on Windows this is available as drawsvg-ui.exe
+```
+
+
+## Install all via dependencies with:
+
+```bash
+python -m pip install -r requirements.txt
+```
+
+## Running the Application
+After installing the dependencies, start the application with:
+
+```bash
+python src/main.py
+```
+
+## UI Features
+
+### Canvas and navigation
+* A4 canvas with grid/subgrid preview; toggle visibility via `Edit → Show grid`.
+* Snap-to-grid movement and resizing; hold `Alt` to place/drag/resize freely.
+* Automatic extra A4 pages when objects cross page borders; empty pages are cleaned up again.
+* Zoom with `Ctrl`/`Alt` + mouse wheel; pan with middle button or right-button drag (right click on empty space resets zoom).
+* Rotation handle above the selection; snaps to 5° steps, hold `Alt` for smooth rotation with a live angle readout.
+
+### Shape palette
+* Drag shapes from the palette or click to drop them at the view center.
+* Shapes: rectangle, rounded rectangle, split rounded rectangle (adjustable header), ellipse/circle, triangle, diamond, line, arrow, block arrow, curvy right bracket, text box, and a folder-tree placeholder.
+
+### Editing and layout
+* Rubber-band selection; add to selection with `Ctrl`/`Shift` click; duplicate selection with `Ctrl` + drag.
+* Resize via handles; items snap while moving/resizing unless `Alt` is held.
+* Align multiple items (left/center/right, top/middle/bottom, snap to grid) from the context menu.
+* Group/ungroup selections (`Ctrl+G` / `Ctrl+Shift+G`) and change z-order (bring forward/back).
+* Delete with the `Delete` key or clear everything via `Edit → Clear canvas`. Full undo/redo stack (`Ctrl+Z`, `Ctrl+Y` / `Ctrl+Shift+Z`).
+
+### Styling, text, and labels
+* Context menu or properties panel to edit fill/stroke color, opacity, stroke width, and line style (solid/dashed/dotted).
+* Corner radius for rectangles; adjustable divider and separate top/bottom fills for split rounded rectangles.
+* Arrowheads on lines/arrows with configurable width/height; block arrow head/shaft ratios; curvy bracket hook depth.
+* Built-in labels for supported shapes: edit text inline or in the properties panel, set font family/size/color, and horizontal/vertical alignment.
+* Text items support multi-line content, font and padding, alignment, and left-to-right or right-to-left direction.
+
+### Properties panel
+* Live inspector synced to the current selection: position, rotation, scale, z-value, size, stroke/fill, and shape-specific options.
+* Dedicated text tab for labels/text content including font, color, padding, alignment, and direction controls.
+
+### Import/Export
+* Load or save scenes as ready-to-run `drawsvg` Python files via the `File` menu.
+
+

drawsvg_ui-0.4.0/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["setuptools>=70", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "drawsvg-ui"
+version = "0.4.0"
+description = "GUI for creating drawsvg scenes with PySide6"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "UI_drawsvg maintainers" }]
+dependencies = [
+  "drawsvg>=2.4,<3",
+  "PySide6>=6.9.2,<7",
+  "PySide6-Addons>=6.9.2,<7",
+  "PySide6-Essentials>=6.9.2,<7",
+  "shiboken6>=6.9.2,<7",
+]
+
+[project.gui-scripts]
+drawsvg-ui = "main:main"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+include-package-data = true
+py-modules = [
+  "app_info",
+  "canvas_view",
+  "constants",
+  "export_drawsvg",
+  "import_drawsvg",
+  "main",
+  "main_window",
+  "palette",
+  "properties_panel",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["items*", "ui*"]
+
+[tool.setuptools.package-data]
+ui = ["*.ui"]
+
+[tool.bumpversion]
+current_version = "0.4.0"
+commit = true
+tag = true
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+search = 'version = "{current_version}"'
+replace = 'version = "{new_version}"'

drawsvg_ui-0.4.0/setup.cfg

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

drawsvg_ui-0.4.0/src/app_info.py

@@ -0,0 +1,61 @@
+from __future__ import annotations
+
+from importlib import metadata
+from pathlib import Path
+from typing import Optional
+
+PACKAGE_NAME = "drawsvg-ui"
+GITHUB_URL = "https://github.com/Taron686/UI_drawsvg"
+
+
+def get_version() -> str:
+    """
+    Resolve the application version from installed metadata when available.
+    Falls back to reading pyproject.toml so running from a checkout still shows a version.
+    """
+    try:
+        return metadata.version(PACKAGE_NAME)
+    except metadata.PackageNotFoundError:
+        pass
+
+    version = _read_version_from_pyproject()
+    return version or "0.0.0"
+
+
+def _read_version_from_pyproject() -> Optional[str]:
+    """Best-effort lookup of the version field in pyproject.toml when running from source."""
+    pyproject_path = Path(__file__).resolve().parent.parent / "pyproject.toml"
+    if not pyproject_path.is_file():
+        return None
+
+    try:
+        content = pyproject_path.read_text(encoding="utf-8")
+    except OSError:
+        return None
+
+    # Prefer tomllib when available (Python 3.11+ or backport)
+    try:
+        import tomllib  # type: ignore
+    except ModuleNotFoundError:
+        tomllib = None
+
+    if tomllib is not None:
+        try:
+            data = tomllib.loads(content)
+            project = data.get("project", {})
+            version = project.get("version")
+            if version:
+                return str(version)
+        except Exception:
+            pass
+
+    for line in content.splitlines():
+        stripped = line.strip()
+        if not stripped.startswith("version"):
+            continue
+        _, _, remainder = stripped.partition("=")
+        candidate = remainder.strip().strip('"').strip("'")
+        if candidate:
+            return candidate
+
+    return None