Merge pull request #1003 from jasongrout/changelog

Update changelog for 0.17 and reintroduce embedded jupyterlite

Author: martinRenou

CHANGELOG.md

@@ -1,7 +1,24 @@
-## v0.16.0
+## v0.17.0
+### New Features
+
+* Make it possible to use Choropleth layer with data containing NaNs [#972](https://github.com/jupyter-widgets/ipyleaflet/pull/972)
+* Add Map panes [#999](https://github.com/jupyter-widgets/ipyleaflet/pull/999)
+* Allow setting Map.dragging [#1001](https://github.com/jupyter-widgets/ipyleaflet/pull/1001)
+* Add visible attribute to GeoJSON layer [#1002](https://github.com/jupyter-widgets/ipyleaflet/pull/1002)
+* [BREAKING CHANGE] Remove get and set decorators in LegendControl [#979](https://github.com/jupyter-widgets/ipyleaflet/pull/979)
+
+## Maintenance
+
+* Compute the public path automatically [#988](https://github.com/jupyter-widgets/ipyleaflet/pull/988)
 
-## What's Changed
+### Docs
 
+* Document use of multiple basemaps [#971](https://github.com/jupyter-widgets/ipyleaflet/pull/971)
+* Add a small introduction text [#992](https://github.com/jupyter-widgets/ipyleaflet/pull/992)
+
+**Full Changelog**: https://github.com/jupyter-widgets/ipyleaflet/compare/0.16.0...0.17.0
+
+## v0.16.0
 ### New features
 
 * Add bounds attribute to TileLayer by @davidbrochart in https://github.com/jupyter-widgets/ipyleaflet/pull/907
@@ -44,7 +61,7 @@
 * @PROgram52bc made their first contribution in https://github.com/jupyter-widgets/ipyleaflet/pull/914
 * @HaudinFlorence made their first contribution in https://github.com/jupyter-widgets/ipyleaflet/pull/953
 
-**Full Changelog**: https://github.com/jupyter-widgets/ipyleaflet/compare/0.15.0...master
+**Full Changelog**: https://github.com/jupyter-widgets/ipyleaflet/compare/0.15.0...0.16.0
 
 ## v0.15.0
 

docs/environment.yml

@@ -18,4 +18,5 @@ dependencies:
 
   - pip:
     - ..
-    - jupyterlite-sphinx
+    - jupyterlite-sphinx
+    - jupyterlite>=0.1.0b9

docs/source/index.rst

@@ -1,18 +1,25 @@
 Introduction to ipyleaflet
 ==========================
-Ipyleaflet is a Jupyter / Leaflet bridge enabling interactive maps in the Jupyter notebook. It is an interactive widgets library, based on ipywidgets. This means that everything in ipyleaflet (e.g. the Map, TileLayers, Layers, Controls…) is interactive: you can dynamically update attributes from Python or from the Notebook interface.
+Ipyleaflet is a `Jupyter widget <https://ipywidgets.readthedocs.io>`_ for
+`Leaflet.js <https://leafletjs.com/>`_ , enabling interactive maps in the
+Jupyter notebook. Every object in ipyleaflet (including the Map, TileLayers, Layers,
+Controls, etc.) is interactive: you can dynamically update attributes from
+Python or from the browser.
 
 .. image:: _static/gallery.gif
    :width: 1200
 
 Try it online
 -------------
 
-You can give ipyleaflet a try in this documentation by clicking on `Try it on RetroLite <https://ipyleaflet.readthedocs.io/en/latest/lite/retro>`__ or
-`Try it on JupyterLite <https://ipyleaflet.readthedocs.io/en/latest/lite/lab>`__.
+You can try ipyleaflet below, or open the example in a new browser tab with
+`RetroLite <./lite/retro/notebooks?path=ipyleaflet.ipynb>`_ or
+`JupyterLite <./lite/lab?path=ipyleaflet.ipynb>`_.
 
-Index
------
+.. retrolite:: ipyleaflet.ipynb
+
+Table of Contents
+-----------------
 
 .. toctree::
     :maxdepth: 2

docs/source/ipyleaflet.ipynb

@@ -3,29 +3,58 @@
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "1d3b8b34",
+   "id": "f2fda73d-1e28-41a8-bf5b-901e3f38866c",
    "metadata": {},
    "outputs": [],
    "source": [
     "import piplite\n",
-    "await piplite.install('ipyleaflet');"
+    "await piplite.install('ipyleaflet')"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": null,
-   "id": "48a5cc23",
+   "id": "644c9514-a50f-4e9e-b95f-f8560f1052de",
    "metadata": {},
    "outputs": [],
    "source": [
-    "from ipyleaflet import Map, basemaps, basemap_to_tiles\n",
+    "from ipyleaflet import Map, Marker\n",
+    "center = (52.204793, 360.121558)\n",
+    "map = Map(center=center, zoom=12)\n",
     "\n",
-    "m = Map(\n",
-    "    basemap=basemap_to_tiles(basemaps.OpenStreetMap.Mapnik),\n",
-    "    center=(48.204793, 350.121558),\n",
-    "    zoom=3\n",
-    "    )\n",
-    "m"
+    "# Add a draggable marker to the map\n",
+    "# Dragging the marker updates the marker.location value in Python\n",
+    "marker = Marker(location=center, draggable=True)\n",
+    "map.add_control(marker)\n",
+    "\n",
+    "display(map)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "790628ed-dfd6-4ac4-af2c-6ea91d1d16ef",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# We can also update the marker location from Python\n",
+    "marker.location = (52.2, 360.1)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "253e96c1-7673-43c8-86dc-9d5244ff10d0",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# We can run a python function when the marker location changes\n",
+    "# Here we'll adjust the center of the map to follow the marker\n",
+    "def on_location_changed(value):\n",
+    "    map.center = value.new\n",
+    "\n",
+    "# Call the on_location_changed function when marker.location changes\n",
+    "marker.observe(on_location_changed, 'location')"
    ]
   }
  ],
@@ -45,7 +74,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.12"
+   "version": "3.10.5"
   }
  },
  "nbformat": 4,

docs/source/jupyterlite_config.json

@@ -1,25 +1,25 @@
 {
     "LiteBuildConfig": {
       "federated_extensions": [
-        "https://github.com/conda-forge/releases/releases/download/noarch/jupyterlab_widgets-1.0.2-pyhd8ed1ab_0.tar.bz2/jupyterlab_widgets-1.0.2-pyhd8ed1ab_0.tar.bz2",
-        "https://github.com/conda-forge/releases/releases/download/noarch/ipyleaflet-0.16.0-pyhd8ed1ab_3.tar.bz2/ipyleaflet-0.16.0-pyhd8ed1ab_3.tar.bz2"
+        "https://files.pythonhosted.org/packages/py3/j/jupyterlab-widgets/jupyterlab_widgets-1.1.1-py3-none-any.whl",
+        "https://files.pythonhosted.org/packages/py2.py3/i/ipyleaflet/ipyleaflet-0.16.0-py2.py3-none-any.whl"
       ],
       "ignore_sys_prefix": true,
       "piplite_urls": [
         "https://files.pythonhosted.org/packages/py2.py3/i/ipyleaflet/ipyleaflet-0.16.0-py2.py3-none-any.whl",
         "https://files.pythonhosted.org/packages/py2.py3/i/ipython-genutils/ipython_genutils-0.2.0-py2.py3-none-any.whl",
-        "https://files.pythonhosted.org/packages/py2.py3/i/ipywidgets/ipywidgets-7.6.5-py2.py3-none-any.whl",
+        "https://files.pythonhosted.org/packages/py2.py3/i/ipywidgets/ipywidgets-7.7.1-py2.py3-none-any.whl",
         "https://files.pythonhosted.org/packages/py2.py3/r/requests/requests-2.27.1-py2.py3-none-any.whl",
         "https://files.pythonhosted.org/packages/py2.py3/t/traittypes/traittypes-0.2.1-py2.py3-none-any.whl",
         "https://files.pythonhosted.org/packages/py2.py3/u/urllib3/urllib3-1.26.8-py2.py3-none-any.whl",
         "https://files.pythonhosted.org/packages/py3/b/branca/branca-0.4.2-py3-none-any.whl",
         "https://files.pythonhosted.org/packages/py3/i/ipython/ipython-8.0.1-py3-none-any.whl",
         "https://files.pythonhosted.org/packages/py3/j/jupyter-client/jupyter_client-7.1.2-py3-none-any.whl",
         "https://files.pythonhosted.org/packages/py3/j/jupyter-core/jupyter_core-4.9.2-py3-none-any.whl",
-        "https://files.pythonhosted.org/packages/py3/j/jupyterlab-widgets/jupyterlab_widgets-1.0.2-py3-none-any.whl",
+        "https://files.pythonhosted.org/packages/py3/j/jupyterlab-widgets/jupyterlab_widgets-1.1.1-py3-none-any.whl",
         "https://files.pythonhosted.org/packages/py3/n/nest-asyncio/nest_asyncio-1.5.4-py3-none-any.whl",
         "https://files.pythonhosted.org/packages/py3/n/notebook/notebook-6.4.8-py3-none-any.whl",
-        "https://files.pythonhosted.org/packages/py3/t/traitlets/traitlets-5.1.1-py3-none-any.whl"
+        "https://files.pythonhosted.org/packages/py3/t/traitlets/traitlets-5.3.0-py3-none-any.whl"
       ]
     }
 }