geovizpy 0.1.6__py3-none-any.whl → 0.1.7__py3-none-any.whl

geovizpy/geoviz.py

@@ -6,6 +6,7 @@ from .legends import LegendsMixin
 from .effects import EffectsMixin
 from .controls import ControlsMixin
 from .renderer import RendererMixin
+from .insets import InsetsMixin
 
 class Geoviz(
     MarksMixin,
@@ -13,7 +14,8 @@ class Geoviz(
     LegendsMixin,
     EffectsMixin,
     ControlsMixin,
-    RendererMixin
+    RendererMixin,
+    InsetsMixin
 ):
     """
     A Python wrapper for the geoviz JavaScript library.

geovizpy/insets.py

@@ -0,0 +1,20 @@
+"""Module for creating inset maps."""
+
+class InsetsMixin:
+    """Mixin class for adding inset map functionality."""
+
+    def inset(self, **kwargs):
+        """
+        Add an inset map to the main map.
+
+        Args:
+            pos (list): [x, y] position of the inset.
+            width (int): Width of the inset SVG.
+            height (int): Height of the inset SVG.
+            domain (object): GeoJSON to define the domain of the inset.
+            projection (string): Projection name for the inset.
+            outline (dict): Dictionary for outline properties (e.g., {"stroke": "black", "strokeWidth": 2}).
+        """
+        # The actual creation of the inset will be handled in the JavaScript renderer,
+        # where the `geoviz.create` function will be called with the main SVG as parent.
+        return self._add_command("inset.create", kwargs)

geovizpy/renderer.py

@@ -94,12 +94,21 @@ class RendererMixin:
          }} else {{
             console.warn("Method " + parts[0] + " not found");
          }}
-      }} else if (parts.length === 2) {{
-         if (svg[parts[0]] && svg[parts[0]][parts[1]]) {{
+      }} else if (parts.length === 2) {
+         if (cmd.name === "inset.create") {
+            const insetArgs = { ...cmd.args };
+            const outlineArgs = insetArgs.outline;
+            delete insetArgs.outline;
+            
+            const insetSvg = geoviz.create({ parent: svg, ...insetArgs });
+            if (outlineArgs) {
+                insetSvg.outline(outlineArgs);
+            }
+         } else if (svg[parts[0]] && svg[parts[0]][parts[1]]) {
             svg[parts[0]][parts[1]](cmd.args);
-         }} else {{
+         } else {
             console.warn("Method " + cmd.name + " not found");
-         }}
+         }
       }}
     }}
   }});

{geovizpy-0.1.6.dist-info → geovizpy-0.1.7.dist-info}/METADATA

@@ -1,118 +1,118 @@
-Metadata-Version: 2.4
-Name: geovizpy
-Version: 0.1.6
-Summary: A Python wrapper for the geoviz JavaScript library
-Author: fbxyz
-Project-URL: Source, https://codeberg.org/fbxyz/geovizpy
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Provides-Extra: export
-Requires-Dist: playwright; extra == "export"
-Dynamic: author
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: project-url
-Dynamic: provides-extra
-Dynamic: requires-python
-Dynamic: summary
-
-# geovizpy
-
-**geovizpy** is a Python wrapper for the `geoviz` JavaScript library, designed to bring the power of D3.js-based thematic mapping to Python. It allows you to create high-quality, interactive maps directly from Python scripts or Jupyter notebooks.
-
-This library is a wrapper around the  `geoviz` library. For detailed information on the underlying mapping logic, please refer to the [original geoviz documentation](https://github.com/neocarto/geoviz).
-
-![Choropleth Map Example](https://codeberg.org/fbxyz/geovizpy/raw/branch/main/docs/source/_static/choropleth.png)
-
-## Features
-
-- **Simple, chainable API**: Build complex maps by chaining intuitive methods.
-- **Variety of Map Types**: Create choropleth, proportional symbol, typology, and other thematic maps.
-- **Interactive Controls**: Add hover-to-expand controls for toggling layer visibility and exporting the map as SVG or PNG.
-- **Customizable**: Extensive options to customize colors, legends, strokes, and more.
-- **Standalone HTML**: Renders self-contained HTML files with no server required.
-- **Image Export**: Save maps directly to PNG or SVG from Python (requires optional dependencies).
-
-## Installation
-
-### Standard Installation
-
-You can install the core library using pip:
-
-```bash
-pip install geovizpy
-```
-
-Or install directly from the source repository:
-
-```bash
-pip install git+https://codeberg.org/fbxyz/geovizpy.git
-```
-
-### For Image Export
-
-To save maps as PNG or SVG files directly from Python, you need to install the optional `export` dependencies:
-
-1.  **Install the extra dependencies:**
-
-    ```bash
-    pip install "geovizpy[export]"
-    ```
-
-2.  **Install Playwright's browser binaries:**
-
-    ```bash
-    playwright install
-    ```
-
-    On Linux, you may also need to install host dependencies:
-    
-    ```bash
-    sudo playwright install-deps
-    ```
-
-## Quick Start
-
-Here is a simple example of how to create a choropleth map:
-
-```python
-from geovizpy import Geoviz
-import json
-
-# Load your GeoJSON data
-# (Assuming 'world.json' is in a 'data' subdirectory)
-with open("data/world.json") as f:
-    world_data = json.load(f)
-
-# Initialize the map
-viz = Geoviz(projection="EqualEarth", width=800)
-
-# Add layers
-viz.outline()
-viz.graticule()
-
-# Add a choropleth layer
-viz.choro(
-    data=world_data,
-    var="gdppc",
-    colors="Blues",
-    legend=True,
-    leg_title="GDP per Capita"
-)
-
-# Add interactive controls
-viz.add_layer_control(layers=["choropleth_gdp"])
-viz.add_export_control()
-
-# Save the map
-viz.save("my_map.html")  # Renders an interactive HTML file
-# viz.save("my_map.png")   # Renders a static PNG image (requires export dependencies)
-```
-
-## Documentation
-
-For more detailed information on all available methods and parameters, please see the [full documentation](https://geovizpy.readthedocs.io/en/latest/).
+Metadata-Version: 2.4
+Name: geovizpy
+Version: 0.1.7
+Summary: A Python wrapper for the geoviz JavaScript library
+Author: fbxyz
+Project-URL: Source, https://codeberg.org/fbxyz/geovizpy
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Provides-Extra: export
+Requires-Dist: playwright; extra == "export"
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-python
+Dynamic: summary
+
+# geovizpy
+
+**geovizpy** is a Python wrapper for the `geoviz` JavaScript library, designed to bring the power of D3.js-based thematic mapping to Python. It allows you to create high-quality, interactive maps directly from Python scripts or Jupyter notebooks.
+
+This library is a wrapper around the  `geoviz` library. For detailed information on the underlying mapping logic, please refer to the [original geoviz documentation](https://github.com/neocarto/geoviz).
+
+![Choropleth Map Example](https://codeberg.org/fbxyz/geovizpy/raw/branch/main/docs/source/_static/choropleth.png)
+
+## Features
+
+- **Simple, chainable API**: Build complex maps by chaining intuitive methods.
+- **Variety of Map Types**: Create choropleth, proportional symbol, typology, and other thematic maps.
+- **Interactive Controls**: Add hover-to-expand controls for toggling layer visibility and exporting the map as SVG or PNG.
+- **Customizable**: Extensive options to customize colors, legends, strokes, and more.
+- **Standalone HTML**: Renders self-contained HTML files with no server required.
+- **Image Export**: Save maps directly to PNG or SVG from Python (requires optional dependencies).
+
+## Installation
+
+### Standard Installation
+
+You can install the core library using pip:
+
+```bash
+pip install geovizpy
+```
+
+Or install directly from the source repository:
+
+```bash
+pip install git+https://codeberg.org/fbxyz/geovizpy.git
+```
+
+### For Image Export
+
+To save maps as PNG or SVG files directly from Python, you need to install the optional `export` dependencies:
+
+1.  **Install the extra dependencies:**
+
+    ```bash
+    pip install "geovizpy[export]"
+    ```
+
+2.  **Install Playwright's browser binaries:**
+
+    ```bash
+    playwright install
+    ```
+
+    On Linux, you may also need to install host dependencies:
+    
+    ```bash
+    sudo playwright install-deps
+    ```
+
+## Quick Start
+
+Here is a simple example of how to create a choropleth map:
+
+```python
+from geovizpy import Geoviz
+import json
+
+# Load your GeoJSON data
+# (Assuming 'world.json' is in a 'data' subdirectory)
+with open("data/world.json") as f:
+    world_data = json.load(f)
+
+# Initialize the map
+viz = Geoviz(projection="EqualEarth", width=800)
+
+# Add layers
+viz.outline()
+viz.graticule()
+
+# Add a choropleth layer
+viz.choro(
+    data=world_data,
+    var="gdppc",
+    colors="Blues",
+    legend=True,
+    leg_title="GDP per Capita"
+)
+
+# Add interactive controls
+viz.add_layer_control(layers=["choropleth_gdp"])
+viz.add_export_control()
+
+# Save the map
+viz.save("my_map.html")  # Renders an interactive HTML file
+# viz.save("my_map.png")   # Renders a static PNG image (requires export dependencies)
+```
+
+## Documentation
+
+For more detailed information on all available methods and parameters, please see the [full documentation](https://geovizpy.readthedocs.io/en/latest/).

geovizpy-0.1.7.dist-info/RECORD

@@ -0,0 +1,13 @@
+geovizpy/__init__.py,sha256=gvgVlK5oB6meBmYgXkXFVohPKkO3ev9UupPA8BQNzYg,120
+geovizpy/controls.py,sha256=pvSrbrkgyB8VURVXED3Etou3Wk2wfWB5p4nnvHLFrgM,1319
+geovizpy/effects.py,sha256=6F78g0IJEbEG8EsKurmBapE8UX0sho7zKHDnzqJ0ci0,1433
+geovizpy/geoviz.py,sha256=nSkblpSf7MeHtdNhkC-g9ltByBaLCbIjW1URVizeMv0,1464
+geovizpy/insets.py,sha256=ljraMXuPGhyPLfkkA9y7Io6fIQGD7j2dU44F9ZvM8pM,861
+geovizpy/legends.py,sha256=IPn_1drQ9MkmJlQ54XwBqAlTRSyq98sm8gzgE-ATRog,2218
+geovizpy/marks.py,sha256=xqwf8ELY05lnrrXGQljMe-mm315vUt_-qOmdFAsYhwA,5520
+geovizpy/plots.py,sha256=EVjPPBFyUFQpXH7sAuxCz_sctonJVUxoi8edbehKrpI,3089
+geovizpy/renderer.py,sha256=51jdjvR2uHr6fFeCOUHC1lCl8ayp7hU2yN5gD-f9rSg,16905
+geovizpy-0.1.7.dist-info/METADATA,sha256=RxFZorl1X5yKz1CyiZu3egebipETy6BwjO0lQMqjCWE,3581
+geovizpy-0.1.7.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+geovizpy-0.1.7.dist-info/top_level.txt,sha256=3D5AFdMd9bWEvGQUWDy6jccJamUwdKmchgCmxLHaAYs,9
+geovizpy-0.1.7.dist-info/RECORD,,

{geovizpy-0.1.6.dist-info → geovizpy-0.1.7.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

geovizpy-0.1.6.dist-info/RECORD

@@ -1,12 +0,0 @@
-geovizpy/__init__.py,sha256=gvgVlK5oB6meBmYgXkXFVohPKkO3ev9UupPA8BQNzYg,120
-geovizpy/controls.py,sha256=pvSrbrkgyB8VURVXED3Etou3Wk2wfWB5p4nnvHLFrgM,1319
-geovizpy/effects.py,sha256=6F78g0IJEbEG8EsKurmBapE8UX0sho7zKHDnzqJ0ci0,1433
-geovizpy/geoviz.py,sha256=bG1A5AQIhsfIJ9RQ4RJteG9HRuu70k2xI9l_eydQTH0,1415
-geovizpy/legends.py,sha256=IPn_1drQ9MkmJlQ54XwBqAlTRSyq98sm8gzgE-ATRog,2218
-geovizpy/marks.py,sha256=xqwf8ELY05lnrrXGQljMe-mm315vUt_-qOmdFAsYhwA,5520
-geovizpy/plots.py,sha256=EVjPPBFyUFQpXH7sAuxCz_sctonJVUxoi8edbehKrpI,3089
-geovizpy/renderer.py,sha256=ql9eaRGo-274MEA6ZXcLY4QpidJdmHlt65IuHiwAbko,16543
-geovizpy-0.1.6.dist-info/METADATA,sha256=l9WRhOd_vESt9qOK071kioRARK4OTvpCymOEtXRbHhE,3463
-geovizpy-0.1.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-geovizpy-0.1.6.dist-info/top_level.txt,sha256=3D5AFdMd9bWEvGQUWDy6jccJamUwdKmchgCmxLHaAYs,9
-geovizpy-0.1.6.dist-info/RECORD,,