Sync Fork from Upstream Repo

.circleci/config.yml

@@ -339,7 +339,7 @@ jobs:
           command: |
             cd packages/python/plotly
             locale
-            tox -e py37-core -- -a '!nodev'
+            tox -e py37-core -- -k 'not nodev'
           no_output_timeout: 20m
       - run:
           name: Commit

CHANGELOG.md

@@ -2,6 +2,16 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [4.5.3] - 2020-03-05
+
+### Updated
+
+- Removed development dependency on `nose` testing framework [#2217](https://github.com/plotly/plotly.py/pull/2217)
+
+### Fixed
+
+ - JupyterLab extension now compatible with JupyterLab 2.0 [#2245](https://github.com/plotly/plotly.py/pull/2245) with thanks to [@consideRatio](https://github.com/consideRatio) for the contribution!
+
 ## [4.5.2] - 2020-02-24
 
 ### Fixed
@@ -11,6 +21,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 ## [4.5.1] - 2020-02-19
 
 ### Updated
+
  - Updated Plotly.js to version 1.52.2. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/releases/tag/v1.52.2) for more information on bug fixes.
 
 ### Fixed

README.md

@@ -26,7 +26,7 @@
 
 ## Quickstart
 
-`pip install plotly==4.5.2`
+`pip install plotly==4.5.3`
 
 Inside [Jupyter notebook](https://jupyter.org/install) (installable with `pip install "notebook>=5.3" "ipywidgets>=7.2"`):
 
@@ -75,13 +75,13 @@ Built on top of [plotly.js](https://github.com/plotly/plotly.js), `plotly.py` is
 plotly.py may be installed using pip...
 
 ```
-pip install plotly==4.5.2
+pip install plotly==4.5.3
 ```
 
 or conda.
 
 ```
-conda install -c plotly plotly=4.5.2
+conda install -c plotly plotly=4.5.3
 ```
 
 ### Jupyter Notebook Support
@@ -128,10 +128,10 @@ set NODE_OPTIONS=--max-old-space-size=4096
 jupyter labextension install @jupyter-widgets/jupyterlab-manager@1.1 --no-build
 
 # FigureWidget support
-jupyter labextension install plotlywidget@1.5.2 --no-build
+jupyter labextension install plotlywidget@1.5.3 --no-build
 
 # and jupyterlab renderer support
-jupyter labextension install jupyterlab-plotly@1.5.2 --no-build
+jupyter labextension install jupyterlab-plotly@1.5.3 --no-build
 
 # Build extensions (must be done to activate extensions since --no-build is used above)
 jupyter lab build

contributing.md

@@ -1,6 +1,6 @@
 # Contributing
 
-The bottom line. Follow your Nose, or our Nose. Write-run-love tests :fist:.
+Thank you for contributing to plotly.py! 
 
 ## Code of Conduct
 
@@ -128,34 +128,40 @@ classes based on the new schema.
 We take advantage of two tools to run tests:
 
 * [`tox`](https://tox.readthedocs.io/en/latest/), which is both a virtualenv management and test tool.
-* [`nose`](https://nose.readthedocs.org/en/latest/), which is is an extension of Python's unittest
+* [`pytest`](https://docs.pytest.org/en/latest/), a powerful framework for unit testing.
 
-### Running Tests with `nose`
+### Running Tests with `pytest`
 
 Since our tests cover *all* the functionality, to prevent tons of errors from showing up and having to parse through a messy output, you'll need to install `optional-requirements.txt` as explained above.
 
-After you've done that, go ahead and follow (y)our Nose!
+After you've done that, go ahead and run the test suite!
 
 ```bash
-nosetests -w  packages/python/plotly/plotly/tests/
+pytest  packages/python/plotly/plotly/tests/
 ```
 
 Or for more *verbose* output:
 
 ```bash
-nosetests -w  packages/python/plotly/plotly/tests/ -v
+pytest -v  packages/python/plotly/plotly/tests/
 ```
 
 Either of those will run *every* test we've written for the Python API. You can get more granular by running something like:
 
 ```bash
-nosetests -w  packages/python/plotly/plotly/tests/test_core/
+pytest  packages/python/plotly/plotly/tests/test_core/
 ```
 
 ... or even more granular by running something like:
 
 ```bash
-nosetests plotly/tests/test_plotly/test_plot.py
+pytest plotly/tests/test_plotly/test_plot.py
+```
+
+or for a specfic test function
+
+```bash
+pytest plotly/tests/test_plotly/test_plot.py::test_function
 ```
 
 ### Running tests with `tox`
@@ -187,16 +193,16 @@ Where `TOXENV` is the environment list you want to use when invoking `tox` from
 * `tox` will automatically manage a virtual env for each environment you want to test in.
 * You only have to run `tox` and know that the module is working in both `Python 2` and `Python 3`.
 
-Finally, `tox` allows you to pass in additional command line arguments that are formatted in (by us) in the `tox.ini` file, see `{posargs}`. This is setup to help with our `nose attr` configuration. To run only tests that are *not* tagged with `slow`, you could use the following command:
+Finally, `tox` allows you to pass in additional command line arguments that are formatted in (by us) in the `tox.ini` file, see `{posargs}`. This is setup to help with our configuration of [pytest markers](http://doc.pytest.org/en/latest/example/markers.html), which are set up in `packages/python/plotly/pytest.ini`. To run only tests that are *not* tagged with `nodev`, you could use the following command:
 
 ```bash
-tox -- -a '!slow'
+tox -- -a '!nodev'
 ```
 
-Note that anything after `--` is substituted in for `{posargs}` in the tox.ini. For completeness, because it's reasonably confusing, if you want to force a match for *multiple* `nose attr` tags, you comma-separate the tags like so:
+Note that anything after `--` is substituted in for `{posargs}` in the tox.ini. For completeness, because it's reasonably confusing, if you want to force a match for *multiple* `pytest` marker tags, you comma-separate the tags like so:
 
 ```bash
-tox -- -a '!slow','!matplotlib'
+tox -- -a '!nodev','!matplotlib'
 ```
 
 ### Writing Tests

doc/python/axes.md

@@ -741,6 +741,27 @@ fig.update_yaxes(domain=(0.25, 0.75))
 fig.show()
 ```
 
+#### Synchronizing axes in subplots with `matches`
+
+Using `facet_col` from `plotly.express` let [zoom](https://help.plot.ly/zoom-pan-hover-controls/#step-3-zoom-in-and-zoom-out-autoscale-the-plot) and [pan](https://help.plot.ly/zoom-pan-hover-controls/#step-6-pan-along-axes) each facet to the same range implicitly. However, if the subplots are created with `make_subplots`, the axis needs to be updated with `matches` parameter to update all the subplots accordingly. 
+
+Zoom in one trace below, to see the other subplots zoomed to the same x-axis range. To pan all the subplots, click and drag from the center of x-axis to the side:
+
+```python
+import plotly.graph_objects as go
+from plotly.subplots import make_subplots
+import numpy as np
+
+N = 20
+x = np.linspace(0, 1, N)
+
+fig = make_subplots(1, 3)
+for i in range(1, 4):
+    fig.add_trace(go.Scatter(x=x, y=np.random.random(N)), 1, i)
+fig.update_xaxes(matches='x')
+fig.show()
+```
+
 #### Reference
 
 See https://plot.ly/python/reference/#layout-xaxis and https://plot.ly/python/reference/#layout-yaxis for more information and chart attribute options!

doc/python/facet-plots.md

@@ -118,3 +118,24 @@ fig.show()
 ```python
 
 ```
+
+### Synchronizing axes in subplots with `matches`
+
+Using `facet_col` from `plotly.express` let [zoom](https://help.plot.ly/zoom-pan-hover-controls/#step-3-zoom-in-and-zoom-out-autoscale-the-plot) and [pan](https://help.plot.ly/zoom-pan-hover-controls/#step-6-pan-along-axes) each facet to the same range implicitly. However, if the subplots are created with `make_subplots`, the axis needs to be updated with `matches` parameter to update all the subplots accordingly. 
+
+Zoom in one trace below, to see the other subplots zoomed to the same x-axis range. To pan all the subplots, click and drag from the center of x-axis to the side:
+
+```python
+import plotly.graph_objects as go
+from plotly.subplots import make_subplots
+import numpy as np
+
+N = 20
+x = np.linspace(0, 1, N)
+
+fig = make_subplots(1, 3)
+for i in range(1, 4):
+    fig.add_trace(go.Scatter(x=x, y=np.random.random(N)), 1, i)
+fig.update_xaxes(matches='x')
+fig.show()
+```

doc/python/figurewidget-app.md

@@ -31,6 +31,7 @@ jupyter:
     page_type: example_index
     permalink: python/figurewidget-app/
     thumbnail: thumbnail/multi-widget.jpg
+    redirect_from: /python/slider-widget/
 ---
 
 #### NYC Flights Database

doc/python/figurewidget.md

@@ -31,6 +31,7 @@ jupyter:
     page_type: example_index
     permalink: python/figurewidget/
     thumbnail: thumbnail/figurewidget-overview.gif
+    redirect_from: /python/ipython-widgets/
 ---
 
 #### Create a Simple FigureWidget

doc/python/getting-started.md

@@ -49,13 +49,13 @@ Thanks to deep integration with the [orca](https://github.com/plotly/orca) image
 plotly.py may be installed using pip...
 
 ```
-$ pip install plotly==4.5.2
+$ pip install plotly==4.5.3
 ```
 
 or conda.
 
 ```
-$ conda install -c plotly plotly=4.5.2
+$ conda install -c plotly plotly=4.5.3
 ```
 
 This package contains everything you need to write figures to standalone HTML files.
@@ -144,10 +144,10 @@ set NODE_OPTIONS=--max-old-space-size=4096
 jupyter labextension install @jupyter-widgets/jupyterlab-manager@1.1 --no-build
 
 # jupyterlab renderer support
-jupyter labextension install jupyterlab-plotly@1.5.2 --no-build
+jupyter labextension install jupyterlab-plotly@1.5.3 --no-build
 
 # FigureWidget support
-jupyter labextension install plotlywidget@1.5.2 --no-build
+jupyter labextension install plotlywidget@1.5.3 --no-build
 
 # Build extensions (must be done to activate extensions since --no-build is used above)
 jupyter lab build

doc/python/interactive-html-export.md

@@ -0,0 +1,65 @@
+---
+jupyter:
+  jupytext:
+    notebook_metadata_filter: all
+    text_representation:
+      extension: .md
+      format_name: markdown
+      format_version: '1.2'
+      jupytext_version: 1.3.1
+  kernelspec:
+    display_name: Python 3
+    language: python
+    name: python3
+  language_info:
+    codemirror_mode:
+      name: ipython
+      version: 3
+    file_extension: .py
+    mimetype: text/x-python
+    name: python
+    nbconvert_exporter: python
+    pygments_lexer: ipython3
+    version: 3.6.8
+  plotly:
+    description: Plotly allows you to save interactive HTML versions of your figures
+      to your local disk.
+    display_as: file_settings
+    language: python
+    layout: base
+    name: Interactive HTML Export
+    order: 30
+    page_type: u-guide
+    permalink: python/interactive-html-export/
+    thumbnail: thumbnail/static-image-export.png
+---
+
+### Interactive vs Static Export
+
+Plotly figures are interactive when viewed in a web browser: you can hover over data points, pan and zoom axes, and show and hide traces by clicking or double-clicking on the legend. You can export figures either to [static image file formats like PNG, JEPG, SVG or PDF](/python/static-image-export/) or you can export them to HTML files which can be opened in a browser. This page explains how to do the latter.
+
+<!-- #region -->
+### Saving to an HTML file
+
+Any figure can be saved an HTML file using the `write_html` method. These HTML files can be opened in any web browser to access the fully interactive figure.
+
+```python
+import plotly.express as px
+
+fig =px.scatter(x=range(10), y=range(10))
+fig.write_html("path/to/file.html")
+```
+<!-- #endregion -->
+
+### Controlling the size of the HTML file
+
+By default, the resulting HTML file is a fully self-contained HTML file which can be uploaded to a web server or shared via email or other file-sharing mechanisms. The downside to this approach is that the file is very large (5Mb+) because it contains an inlined copy of the Plotly.js library required to make the figure interactive. This can be controlled via the `include_plotlyjs` argument (see below).
+
+
+### Full Parameter Documentation
+
+```python
+import plotly.graph_objects as go
+
+help(go.Figure.write_html)
+```

doc/python/legend.md

@@ -243,7 +243,30 @@ fig.update_layout(
 fig.show()
 ```
 
-### Size of Legend Items
+#### Hide the Trace Implicitly
+
+`Graph_objects` traces have a `visible` attribute. If set to `legendonly`, the trace is hidden from the graph implicitly. Click on the name in the legend to display the hidden trace.
+
+```python
+import plotly.graph_objects as go
+
+fig = go.Figure()
+
+fig.add_trace(go.Scatter(
+    x=[1, 2, 3, 4, 5],
+    y=[1, 2, 3, 4, 5],
+))
+
+fig.add_trace(go.Scatter(
+    x=[1, 2, 3, 4, 5],
+    y=[5, 4, 3, 2, 1],
+    visible='legendonly'
+))
+
+fig.show()
+```
+
+#### Size of Legend Items
 
 In this example [itemsizing](https://plot.ly/python/reference/#layout-legend-itemsizing) attribute determines the legend items symbols remain constant, regardless of how tiny/huge the bubbles would be in the graph.