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

geovizpy-0.1.6.dist-info/METADATA

@@ -0,0 +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/).

geovizpy-0.1.6.dist-info/RECORD

@@ -0,0 +1,12 @@
+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,,

geovizpy-0.1.4.dist-info/METADATA

@@ -1,46 +0,0 @@
-Metadata-Version: 2.4
-Name: geovizpy
-Version: 0.1.4
-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
-Dynamic: author
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: project-url
-Dynamic: requires-python
-Dynamic: summary
-
-# geovizpy
-
-A Python wrapper for the [geoviz](https://github.com/neocarto/geoviz) JavaScript library.
-It allows you to create thematic maps using a simple Python API and render them to HTML.
-
-## Installation
-
-```bash
-pip install git+https://github.com/fbxyz/geovizpy.git
-```
-
-## Usage
-
-```python
-from geovizpy import Geoviz
-import json
-
-# Load your GeoJSON data
-with open("examples/world.json") as f:
-    world_data = json.load(f)
-
-# Create a map
-viz = Geoviz(projection="EqualEarth")
-viz.outline()
-viz.choro(data=world_data, var="gdppc")
-viz.render_html("map.html")
-```

geovizpy-0.1.4.dist-info/RECORD

@@ -1,5 +0,0 @@
-geovizpy/__init__.py,sha256=goB5sY5MzuKwxd8llb6zCjtAusMsF4JJjhJs_bDuNcY,15015
-geovizpy-0.1.4.dist-info/METADATA,sha256=HAldRqSa084nhQZ-KpoHGuHXmjrJrnjiiAJlm40Fb8k,1118
-geovizpy-0.1.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-geovizpy-0.1.4.dist-info/top_level.txt,sha256=3D5AFdMd9bWEvGQUWDy6jccJamUwdKmchgCmxLHaAYs,9
-geovizpy-0.1.4.dist-info/RECORD,,