geomosaic 0.1.0__tar.gz

geomosaic-0.1.0/.github/workflows/deploy_pages.yml

@@ -0,0 +1,53 @@
+name: Deploy notebook to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  test:
+    uses: ./.github/workflows/tests.yml   # never deploy a demo from a red build
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Check WASM compatibility
+        run: uv run marimo check notebooks/png2svg.py --select MW
+
+      - name: Export notebook to WASM-powered HTML
+        run: uv run marimo export html-wasm notebooks/png2svg.py -o site --mode run
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

geomosaic-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish package
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  test:
+    uses: ./.github/workflows/tests.yml
+
+  build-and-publish:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build package
+        run: uv build
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

geomosaic-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,37 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_call:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Check formatting
+        run: uv run ruff format --check .
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Type check
+        run: uv run mypy src
+
+      - name: Run tests with coverage
+        run: uv run pytest --cov=src --cov-report=term-missing --cov-report=xml

geomosaic-0.1.0/.gitignore

@@ -0,0 +1,20 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+.pytest_cache/
+
+# Virtual environments
+.venv
+.python-version
+
+.ruff_cache
+
+.coverage
+coverage.xml
+htmlcov/
+
+notebooks/__marimo__/

geomosaic-0.1.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.5
+Name: geomosaic
+Version: 0.1.0
+Summary: A Python CLI tool to convert images into hexagonal SVG mosaics
+Author-email: GRANDJEAN Mathieu <mathieu.grandjean@etu.imt-nord-europe.fr>
+License: MIT
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.12
+Requires-Dist: numpy>=2.5.3
+Requires-Dist: pillow>=12.3.0

geomosaic-0.1.0/main.py

@@ -0,0 +1,6 @@
+def main():
+    print("Hello from png-to-svg!")
+
+
+if __name__ == "__main__":
+    main()

geomosaic-0.1.0/notebooks/png2svg.py

@@ -0,0 +1,108 @@
+import marimo
+
+__generated_with = "0.25.1"
+app = marimo.App()
+
+
+@app.cell
+def _():
+    import io
+    import marimo as mo
+    import matplotlib.pyplot as plt
+    import numpy as np
+
+    from hexagrid.hexagon import generate_hexagonal_grid, Hexagon
+    from hexagrid.svg import export_to_svg
+    from PIL import Image
+
+    return Image, export_to_svg, generate_hexagonal_grid, io, mo, np
+
+
+@app.cell(hide_code=True)
+def _(mo):
+    mo.md(r"""
+    # Hexagrid : Convert an image (.png, .jpg, etc.) into a SVG mosaic
+
+    Drag and drop an image and adjust parameters to generate the vectorized mosaic.
+    """)
+    return
+
+
+@app.cell
+def _(mo):
+    file_picker = mo.ui.file(
+        filetypes=[".png", ".jpg", ".jpeg", ".webp"],
+        label="Choose an image to convert"
+    )
+
+    size_input = mo.ui.number(
+        start=1.0, stop=100.0, step=1.0, value=15.0,
+        label="Size of the hexagons (flat-top)"
+    )
+
+    margin_input = mo.ui.number(
+        start=0, stop=10, step=1, value=2,
+        label="Grid margin"
+    )
+
+    mo.vstack([file_picker, size_input, margin_input])
+    return file_picker, margin_input, size_input
+
+
+@app.cell
+def _(
+    Image,
+    export_to_svg,
+    file_picker,
+    generate_hexagonal_grid,
+    io,
+    margin_input,
+    mo,
+    np,
+    size_input,
+):
+    if file_picker.value:
+        uploaded_file = file_picker.value[0]
+
+        img = Image.open(io.BytesIO(uploaded_file.contents)).convert("RGB")
+
+        hex_grid = generate_hexagonal_grid(
+                img.width, img.height, 
+                size_input.value, 
+                margin=int(margin_input.value)
+        )
+
+        for h in hex_grid:
+            h.compute_average_color_random(np.asarray(img))
+    
+        output_filename = f"output_{uploaded_file.name.rsplit('.', 1)[0]}.svg"
+        export_to_svg(hex_grid, img.width, img.height, output_filename)
+
+        result = mo.hstack([
+                mo.vstack([
+                    mo.md("**Original Image**"),
+                    mo.image(src=uploaded_file.contents, width=500)
+                ]),
+                mo.vstack([
+                    mo.md("**SVG Mosaic**"),
+                    mo.image(src=f"output_{uploaded_file.name.rsplit('.', 1)[0]}.svg", width=500)
+                ]),
+                mo.vstack([
+                    mo.md("**Result**"),
+                    mo.md(f"""
+                    * **Generated file:** `{output_filename}`
+                    * **Hexagons size:** {size_input.value}
+                    * **Hexagon number:** {len(hex_grid)}
+                    """)
+                ])
+        ])
+
+    else:
+        result = mo.md("### Please select an image to start the conversion.")
+
+    result
+    return
+
+
+if __name__ == "__main__":
+    app.run()