mapyta 0.1.0__tar.gz

mapyta-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,36 @@
+name: Publish docs
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install docs dependencies
+        run: uv sync --group docs
+
+      - name: Build docs
+        run: uv run properdocs build --clean
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site/
+
+      - id: deployment
+        uses: actions/deploy-pages@v4

mapyta-0.1.0/.github/workflows/lint.yml

@@ -0,0 +1,29 @@
+name: Lint
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: uv sync --group dev
+
+      - name: Check formatting
+        run: uv run ruff format --check .
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Type check
+        run: uv run ty check mapyta

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

@@ -0,0 +1,26 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.13"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish

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

@@ -0,0 +1,23 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: uv sync --group test
+
+      - name: Run tests with coverage
+        run: uv run pytest --cov-fail-under=100

mapyta-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+.idea
+
+# Virtual environments
+.venv
+venv

mapyta-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,29 @@
+# .pre-commit-config.yaml
+# This file configures the pre-commit hooks that will be run before each commit.
+# See https://pre-commit.com for more information.
+# See https://pre-commit.com/hooks.html for more hooks.
+
+# To use these hooks:
+# 1. Install pre-commit (https://pre-commit.com/#install).
+#    In most cases, this will involve running `pip install pre-commit`.
+# 2. In your terminal, navigate to your repository and run `pre-commit install`.
+#    This will install the hooks.
+# 3. Now, the hooks will automatically run every time you try to make a commit.
+#    If any of the hooks fail, the commit will be aborted.
+# 4. If a hook fails and you see errors, fix them and try to commit again.
+#    The hooks will run again and the commit will only be made if they all pass.
+# 5. If you want to manually run all hooks on all files, run `pre-commit run --all-files`.
+# 6. To update to the latest versions of the hooks, run `pre-commit autoupdate`.
+
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.4
+    hooks:
+      # Run the linter.
+      - id: ruff-check
+        args: [ --fix ]
+      # Run the formatter.
+      - id: ruff-format
+
+    # As of january 2026, ty does not have an official pre-commit hook.
+    # We will add it here once it is available.

mapyta-0.1.0/.ruff.toml

@@ -0,0 +1,90 @@
+line-length = 150
+
+[lint]
+select = [
+    "F",     # pyflakes
+    "E",     # pycodestyle (Errors)
+    "W",     # pycodestyle (Warnings)
+    "C90",   # mccabe (complexity)
+    "I",     # isort
+    "N",     # pep8 naming
+    "D",     # pydocstyle
+    "UP",    # pyupgrade
+    "ANN",   # flake8-annotations
+    "ASYNC", # flake8-async
+    "A",     # flake8-builtins
+    "COM",   # flake8-commas
+    "C4",    # flake8-comprehensions
+    "DTZ",   # flake8-datetimez
+    "EXE",   # flake8-executable
+    "ISC",   # flake8-implicit-str-concat
+    "ICN",   # flake8-import-conventions
+    "INP",   # flake8-no-pep420
+    "PIE",   # flake8-pie
+    "T20",   # flake8-print
+    "PYI",   # flake8-pyi
+    "PT",    # flake8-pytest-style
+    "Q",     # flake8-quotes
+    "RSE",   # flake8-raise
+    "RET",   # flake8-return
+    "SLF",   # flake8-self
+    "SLOT",  # flake8-slot
+    "SIM",   # flake8-simplify
+    "TID",   # flake8-tidy-imports
+    "INT",   # flake8-gettext
+    "ARG",   # flake8-unused-arguments
+    "TD",    # flake8-todos
+    "FIX",   # flake8-fixme
+    "ERA",   # eradicate
+    "PD",    # pandas-vet
+    "PGH",   # pygrep-hooks
+    "PL",    # pylint
+    "TRY",   # tryceratops
+    "FLY",   # flyint
+    "NPY",   # NumPy-specific rules
+    "AIR",   # Airflow
+    "PERF",  # Perflint
+    "RUF",   # Ruff-specific rules
+]
+
+ignore = [
+    # pydocstyle
+    "D205", # blank-line-after-summary
+    "D401", # non-imperative-mood
+
+    # flake8-annotations
+    "ANN002", # missing-type-args
+    "ANN003", # missing-type-kwargs
+
+    # flake8-pytest-style
+    "PT011", # pytest-raises-too-broad
+
+    # flake8-implicit-str-concat
+    "ISC001", # single-line-implicit-string-concatenation
+
+    # flake8-commas
+    "COM812", # missing-trailing-comma
+
+    # pylint
+    "PLR2004", # magic-value-comparison
+
+    # tryceratops
+    "TRY003", # raise-vanilla-args
+
+    # Ruff-specific rules
+    "RUF002", # ambiguous-unicode-character-docstring
+    "RUF003", # ambiguous-unicode-character-comment
+]
+[lint.per-file-ignores] 
+"docs/*" = ["T201"]
+
+[format]
+quote-style = "double"
+indent-style = "space"
+docstring-code-format = true
+
+[lint.pylint]
+max-args = 10
+
+[lint.pydocstyle]
+convention = "numpy"

mapyta-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright © 2026 Mapyta - Enrique García
+
+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.

mapyta-0.1.0/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: mapyta
+Version: 0.1.0
+Summary: Mapyta, open source python package for GIS mapping and visualization.
+License: MIT
+License-File: LICENSE
+Keywords: GIS,mapping,visualization
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.12
+Requires-Dist: folium>=0.20.0
+Requires-Dist: geopandas>=1.1.3
+Requires-Dist: pyproj>=3.7.2
+Requires-Dist: shapely>=2.1.2
+Provides-Extra: export
+Requires-Dist: chromedriver-autoinstaller>=0.6.0; extra == 'export'
+Requires-Dist: selenium>=4.0.0; extra == 'export'
+Description-Content-Type: text/markdown
+
+<p align="center">
+    <a href="https://egarciamendez.github.io/mapyta">
+    <img src="https://egarciamendez.github.io/mapyta/_overrides/assets/images/mapyta-logo-light-mode.svg" alt="Mapyta">
+    </a>
+</p>
+
+---
+
+**Documentation**: [https://egarciamendez.github.io/mapyta](https://egarciamendez.github.io/mapyta)
+
+**Source Code**: [https://github.com/egarciamendez/mapyta](https://github.com/egarciamendez/mapyta)
+
+---
+
+
+**One import. A few method calls. A full interactive map.**
+
+Build OpenStreetMap visualizations with hover tooltips, choropleths, heatmaps, and export to HTML or PNG all from Shapely geometries.
+
+Perfect for geotechnical site plans, infrastructure overviews, or any spatial data visualization where you want more control than static images but don't need the full power of a GIS.
+
+*Mapyta is standing on the shoulders of giants like Folium and Leaflet, but it's designed to be more intuitive and 
+Pythonic for users who are already familiar with Shapely and GeoPandas. It's not trying to replace a full GIS, 
+but rather to provide a simple way to create interactive maps without needing to learn a whole new set of tools.*
+
+---
+
+**Key features:**
+
+- 🗺️ **Shapely-native** — pass `Point`, `Polygon`, `LineString` directly, including multi-geometries
+- 📝 **Markdown/HTML hover and popup text** — bold, italic, links, lists, and code in tooltips
+- 📌 **Emoji & icon markers** — any text or Font Awesome icons as markers
+- 🎨 **Choropleth & heatmaps** — color-coded maps from numeric data
+- 📊 **GeoPandas integration** — `Map.from_geodataframe()` one-liner
+- 🌐 **Auto CRS detection** — RD New (EPSG:28992) coordinates transform automatically
+- 📤 **Export anywhere** — HTML, PNG, SVG, async variants, and `BytesIO` buffers
+- 🧩 **Feature groups** — toggleable layers with a built-in layer control
+- 🔌 **Set of tile providers** — OpenStreetMap, CartoDB, Esri, Stamen, and Kadaster
+
+---
+
+??? example "Full example for power users"
+
+    Complete map with points, lines, polygons, popups, feature groups, layer control, and HTML export in one block.
+    Everything below this fold explains each piece step by step.
+
+    ```python exec="true" html="true" source="tabbed-right"
+    from shapely.geometry import Point, LineString, Polygon
+    from mapyta import Map, MapConfig
+
+    m = Map(
+        title="Amsterdam Overview",
+        config=MapConfig(
+            tile_layer=["cartodb_positron", "cartodb_dark"],
+            fullscreen=True,
+            minimap=True,
+            measure_control=True,
+            mouse_position=True,
+        ),
+    )
+
+    # Feature group: landmarks
+    m.create_feature_group("🏛️ Landmarks")
+    m.add_point(
+        point=Point(4.9041, 52.3676),
+        marker="🏛️",
+        tooltip="**Royal Palace**",
+        popup="**Royal Palace**\nDam Square, Amsterdam\nBuilt: 1665",
+        popup_style={"width": 300, "height": 120},
+    )
+    m.add_point(
+        point=Point(4.8834, 52.3667),
+        marker="📖",
+        tooltip="**Anne Frank House**",
+        popup="**Anne Frank House**\nPrinsengracht 263\nVisitors/year: ~1.3 million",
+        popup_style={"width": 300, "height": 120},
+    )
+    m.add_point(
+        point=Point(4.8795, 52.3600),
+        marker="fa-landmark",
+        tooltip="**Rijksmuseum**",
+        popup="**Rijksmuseum**\nDutch art and history since 1800",
+        marker_style={"font-size": "24px", "color": "green"},
+    )
+
+    # Feature group: areas
+    m.create_feature_group("📍 Areas of Interest")
+    m.add_polygon(
+        polygon=Polygon([(4.876, 52.372), (4.889, 52.372), (4.889, 52.380), (4.876, 52.380)]),
+        tooltip="**De Jordaan**\nHistoric neighbourhood",
+        popup="**De Jordaan**\n\n- Narrow streets\n- Independent galleries\n- Brown cafés",
+        stroke={"color": "green", "weight": 2},
+        fill={"color": "blue", "opacity": 0.15},
+        popup_style={"width": 300, "height": 180},
+    )
+    m.add_linestring(
+        line=LineString([(4.8852, 52.3702), (4.8910, 52.3663), (4.8932, 52.3631), (4.884, 52.3569)]),
+        tooltip="**Walking route**\n*Centraal → Leidseplein*",
+        stroke={"color": "red", "weight": 4, "dash_array": "10 6"},
+    )
+
+    m.reset_target()
+    m.add_circle(
+        point=Point(4.8812, 52.3584),
+        tooltip="**Van Gogh Museum**",
+        style={"radius": 12, "stroke": {"color": "green", "weight": 2}, "fill": {"color": "orange", "opacity": 0.5}},
+    )
+
+    m.add_layer_control(collapsed=False)
+    m.set_bounds(padding=0.005)
+
+    print(m.to_html()) # markdown-exec: hide
+    ```
+
+## Quickstart
+
+Install mapyta:
+
+```bash
+uv add mapyta
+# or
+pip install mapyta
+```
+
+Create your first map:
+
+```python exec="true" html="true" source="tabbed-right"
+from shapely.geometry import Point
+from mapyta import Map
+
+m = Map(title="Hello Amsterdam")
+m.add_point(
+    point=Point(4.9041, 52.3676),
+    tooltip="**Amsterdam**",
+    popup="Capital city of the Netherlands.",
+    caption="AMS",
+)
+m.to_html("hello.html")
+
+print(m.to_html()) # markdown-exec: hide
+```
+
+Open `hello.html` in any browser and you're done.
+
+## License
+
+This project is licensed under the terms of the MIT license.

mapyta-0.1.0/README.md

@@ -0,0 +1,147 @@
+<p align="center">
+    <a href="https://egarciamendez.github.io/mapyta">
+    <img src="https://egarciamendez.github.io/mapyta/_overrides/assets/images/mapyta-logo-light-mode.svg" alt="Mapyta">
+    </a>
+</p>
+
+---
+
+**Documentation**: [https://egarciamendez.github.io/mapyta](https://egarciamendez.github.io/mapyta)
+
+**Source Code**: [https://github.com/egarciamendez/mapyta](https://github.com/egarciamendez/mapyta)
+
+---
+
+
+**One import. A few method calls. A full interactive map.**
+
+Build OpenStreetMap visualizations with hover tooltips, choropleths, heatmaps, and export to HTML or PNG all from Shapely geometries.
+
+Perfect for geotechnical site plans, infrastructure overviews, or any spatial data visualization where you want more control than static images but don't need the full power of a GIS.
+
+*Mapyta is standing on the shoulders of giants like Folium and Leaflet, but it's designed to be more intuitive and 
+Pythonic for users who are already familiar with Shapely and GeoPandas. It's not trying to replace a full GIS, 
+but rather to provide a simple way to create interactive maps without needing to learn a whole new set of tools.*
+
+---
+
+**Key features:**
+
+- 🗺️ **Shapely-native** — pass `Point`, `Polygon`, `LineString` directly, including multi-geometries
+- 📝 **Markdown/HTML hover and popup text** — bold, italic, links, lists, and code in tooltips
+- 📌 **Emoji & icon markers** — any text or Font Awesome icons as markers
+- 🎨 **Choropleth & heatmaps** — color-coded maps from numeric data
+- 📊 **GeoPandas integration** — `Map.from_geodataframe()` one-liner
+- 🌐 **Auto CRS detection** — RD New (EPSG:28992) coordinates transform automatically
+- 📤 **Export anywhere** — HTML, PNG, SVG, async variants, and `BytesIO` buffers
+- 🧩 **Feature groups** — toggleable layers with a built-in layer control
+- 🔌 **Set of tile providers** — OpenStreetMap, CartoDB, Esri, Stamen, and Kadaster
+
+---
+
+??? example "Full example for power users"
+
+    Complete map with points, lines, polygons, popups, feature groups, layer control, and HTML export in one block.
+    Everything below this fold explains each piece step by step.
+
+    ```python exec="true" html="true" source="tabbed-right"
+    from shapely.geometry import Point, LineString, Polygon
+    from mapyta import Map, MapConfig
+
+    m = Map(
+        title="Amsterdam Overview",
+        config=MapConfig(
+            tile_layer=["cartodb_positron", "cartodb_dark"],
+            fullscreen=True,
+            minimap=True,
+            measure_control=True,
+            mouse_position=True,
+        ),
+    )
+
+    # Feature group: landmarks
+    m.create_feature_group("🏛️ Landmarks")
+    m.add_point(
+        point=Point(4.9041, 52.3676),
+        marker="🏛️",
+        tooltip="**Royal Palace**",
+        popup="**Royal Palace**\nDam Square, Amsterdam\nBuilt: 1665",
+        popup_style={"width": 300, "height": 120},
+    )
+    m.add_point(
+        point=Point(4.8834, 52.3667),
+        marker="📖",
+        tooltip="**Anne Frank House**",
+        popup="**Anne Frank House**\nPrinsengracht 263\nVisitors/year: ~1.3 million",
+        popup_style={"width": 300, "height": 120},
+    )
+    m.add_point(
+        point=Point(4.8795, 52.3600),
+        marker="fa-landmark",
+        tooltip="**Rijksmuseum**",
+        popup="**Rijksmuseum**\nDutch art and history since 1800",
+        marker_style={"font-size": "24px", "color": "green"},
+    )
+
+    # Feature group: areas
+    m.create_feature_group("📍 Areas of Interest")
+    m.add_polygon(
+        polygon=Polygon([(4.876, 52.372), (4.889, 52.372), (4.889, 52.380), (4.876, 52.380)]),
+        tooltip="**De Jordaan**\nHistoric neighbourhood",
+        popup="**De Jordaan**\n\n- Narrow streets\n- Independent galleries\n- Brown cafés",
+        stroke={"color": "green", "weight": 2},
+        fill={"color": "blue", "opacity": 0.15},
+        popup_style={"width": 300, "height": 180},
+    )
+    m.add_linestring(
+        line=LineString([(4.8852, 52.3702), (4.8910, 52.3663), (4.8932, 52.3631), (4.884, 52.3569)]),
+        tooltip="**Walking route**\n*Centraal → Leidseplein*",
+        stroke={"color": "red", "weight": 4, "dash_array": "10 6"},
+    )
+
+    m.reset_target()
+    m.add_circle(
+        point=Point(4.8812, 52.3584),
+        tooltip="**Van Gogh Museum**",
+        style={"radius": 12, "stroke": {"color": "green", "weight": 2}, "fill": {"color": "orange", "opacity": 0.5}},
+    )
+
+    m.add_layer_control(collapsed=False)
+    m.set_bounds(padding=0.005)
+
+    print(m.to_html()) # markdown-exec: hide
+    ```
+
+## Quickstart
+
+Install mapyta:
+
+```bash
+uv add mapyta
+# or
+pip install mapyta
+```
+
+Create your first map:
+
+```python exec="true" html="true" source="tabbed-right"
+from shapely.geometry import Point
+from mapyta import Map
+
+m = Map(title="Hello Amsterdam")
+m.add_point(
+    point=Point(4.9041, 52.3676),
+    tooltip="**Amsterdam**",
+    popup="Capital city of the Netherlands.",
+    caption="AMS",
+)
+m.to_html("hello.html")
+
+print(m.to_html()) # markdown-exec: hide
+```
+
+Open `hello.html` in any browser and you're done.
+
+## License
+
+This project is licensed under the terms of the MIT license.

mapyta-0.1.0/docs/.nav.yml

@@ -0,0 +1,4 @@
+nav:
+  - Mapyta: index.md
+  - Tutorial: tutorial/
+  - API reference