Merge remote-tracking branch 'origin/master' into orjson_encoding

Author: jonmmease

CHANGELOG.md

@@ -2,19 +2,51 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
-## [4.14.0] - UNRELEASED
+## [4.15.0] - UNRELEASED
+
+### Added
+
+### Fixed
+
+### Updated
+
+
+## [4.14.2] - UNRELEASED
+
+### Added
+
+### Fixed
+
+### Updated
+
+
+## [4.14.1] - 2020-12-09
+
+### Updated
+
+- Updated Plotly.js to version 1.58.2. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/v1.58.0/CHANGELOG.md) for more information. These changes are reflected in the auto-generated `plotly.graph_objects` module. Notable changes include:
+  - fixes for new `ticklabelposition` attribute
+  - fixes for a regression related to treemaps in the previous version
+
+
+## [4.14.0] - 2020-12-07
 
 ### Added
 
 - `px.imshow` now supports `facet_col` and `animation_frame` arguments for visualizing 3-d and 4-d images [2746](https://github.com/plotly/plotly.py/pull/2746)
+- `px.defaults` now supports `color_discrete_map`, `symbol_map`, `line_dash_map`, `labels` and `category_orders` as well as a `.reset()` method [2957](https://github.com/plotly/plotly.py/pull/2957)
 
 ### Fixed
 
-- axes will now auto-type numeric strings as categorical data rather than linear [2951](https://github.com/plotly/plotly.py/pull/2951)
+- axes will now auto-type numeric strings as categorical data rather than linear in the default templates [2951](https://github.com/plotly/plotly.py/pull/2951)
 
 ### Updated
 
-- Updated Plotly.js to version 1.58.0. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/v1.58.0/CHANGELOG.md) for more information. These changes are reflected in the auto-generated `plotly.graph_objects` module.
+- Updated Plotly.js to version 1.58.1. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/v1.58.0/CHANGELOG.md) for more information. These changes are reflected in the auto-generated `plotly.graph_objects` module. Notable changes include:
+  - a new `ticklabelposition` attribute to enable positioning tick labels inside the plotting area
+  - better support for `scaleanchor` and `matches` on cartesian axes for matched square subplots
+  - a new `autotypenumbers` attribute which is now set to `strict` in the default templates
+  - various fixes relating to `automargins` for small figures
 
 
 ## [4.13.0] - 2020-11-23

README.md

@@ -37,7 +37,7 @@ Our recommended IDE for Plotly’s Python graphing library is Dash Enterprise’
 
 ## Quickstart
 
-`pip install plotly==4.13.0`
+`pip install plotly==4.14.1`
 
 Inside [Jupyter notebook](https://jupyter.org/install) (installable with `pip install "notebook>=5.3" "ipywidgets>=7.2"`):
 
@@ -86,13 +86,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.13.0
+pip install plotly==4.14.1
 ```
 
 or conda.
 
 ```
-conda install -c plotly plotly=4.13.0
+conda install -c plotly plotly=4.14.1
 ```
 
 ### Jupyter Notebook Support
@@ -129,10 +129,10 @@ Then run the following commands to install the required JupyterLab extensions (n
 
 ```
 # Basic JupyterLab renderer support
-jupyter labextension install jupyterlab-plotly@4.13.0
+jupyter labextension install jupyterlab-plotly@4.14.1
 
 # OPTIONAL: Jupyter widgets extension for FigureWidget support
-jupyter labextension install @jupyter-widgets/jupyterlab-manager plotlywidget@4.13.0
+jupyter labextension install @jupyter-widgets/jupyterlab-manager plotlywidget@4.14.1
 ```
 
 Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab.
@@ -156,7 +156,7 @@ $ pip install -U kaleido
 or conda.
 
 ```
-$ conda install -c plotly python-kaleido
+$ conda install -c conda-forge python-kaleido
 ```
 
 #### Orca

binder/requirements.txt

@@ -1,5 +1,5 @@
 jupytext
-plotly==4.13.0
+plotly==4.14.1
 jupyter
 notebook
 pandas==1.0.3

contributing.md

@@ -280,7 +280,7 @@ pytest  packages/python/plotly/plotly/tests/test_core/
 pytest plotly/tests/test_plotly/test_plot.py
 ```
 
-or for a specfic test function
+or for a specific test function
 
 ```bash
 pytest plotly/tests/test_plotly/test_plot.py::test_function

doc/apidoc/conf.py

@@ -28,7 +28,7 @@
 # The short X.Y version
 version = ""
 # The full version, including alpha/beta/rc tags
-release = "4.13.0"
+release = "4.14.1"
 
 
 # -- General configuration ---------------------------------------------------

doc/python/axes.md

@@ -124,7 +124,7 @@ fig = px.bar(df, x=["Apples", "Oranges"], y=[10,20], color=["Here", "There"],
 fig.show()
 ```
 
-##### Rotate axes in Dash
+##### Rotating tick labels in Dash
 
 [Dash](https://plotly.com/dash/) is the best way to build analytical apps in Python using Plotly figures. To run the app below, run `pip install dash`, click "Download" to get the code and run `python app.py`.
 
@@ -137,6 +137,19 @@ snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
 IFrame(snippet_url + 'axes', width='100%', height=630)
 ```
 
+#### Moving Tick Labels Inside the Plot
+
+The `ticklabelposition` attribute moves tick labels inside the plotting area, and modifies the auto-range behaviour to accomodate the labels.
+
+```python
+import plotly.express as px
+
+df = px.data.stocks(indexed=True)-1
+fig = px.bar(df, x=df.index, y="GOOG")
+fig.update_yaxes(ticklabelposition="inside top", title=None)
+fig.show()
+```
+
 ##### Set axis title text with Graph Objects
 
 Axis titles are set using the nested `title.text` property of the x or y axis. Here is an example of creating a new figure and using `update_xaxes` and `update_yaxes`, with magic underscore notation, to set the axis titles.

doc/python/getting-started.md

@@ -59,13 +59,13 @@ We also encourage you to join the [Plotly Community Forum](http://community.plot
 `plotly` may be installed using pip...
 
 ```
-$ pip install plotly==4.13.0
+$ pip install plotly==4.14.1
 ```
 
 or conda.
 
 ```
-$ conda install -c plotly plotly=4.13.0
+$ conda install -c plotly plotly=4.14.1
 ```
 
 This package contains everything you need to write figures to standalone HTML files.
@@ -157,10 +157,10 @@ Then run the following commands to install the required JupyterLab extensions (n
 
 ```
 # JupyterLab renderer support
-jupyter labextension install jupyterlab-plotly@4.13.0
+jupyter labextension install jupyterlab-plotly@4.14.1
 
 # OPTIONAL: Jupyter widgets extension
-jupyter labextension install @jupyter-widgets/jupyterlab-manager plotlywidget@4.13.0
+jupyter labextension install @jupyter-widgets/jupyterlab-manager plotlywidget@4.14.1
 ```
 
 These packages contain everything you need to run JupyterLab...

doc/python/static-image-export.md

@@ -50,7 +50,7 @@ $ pip install -U kaleido
 
 or conda.
 ```
-$ conda install -c plotly python-kaleido
+$ conda install -c conda-forge python-kaleido
 ```
 
 While Kaleido is now the recommended approach, image export can also be supported by the legacy [orca](https://github.com/plotly/orca) command line utility. See the [Orca Management](/python/orca-management/) section for instructions on installing, configuring, and troubleshooting orca.

doc/python/time-series.md

@@ -6,7 +6,7 @@ jupyter:
       extension: .md
       format_name: markdown
       format_version: '1.2'
-      jupytext_version: 1.6.0
+      jupytext_version: 1.4.2
   kernelspec:
     display_name: Python 3
     language: python
@@ -20,7 +20,7 @@ jupyter:
     name: python
     nbconvert_exporter: python
     pygments_lexer: ipython3
-    version: 3.7.6
+    version: 3.7.7
   plotly:
     description: How to plot date and time in python.
     display_as: financial

doc/requirements.txt

@@ -30,4 +30,5 @@ kaleido
 umap-learn
 pooch
 wget
+nbconvert==5.6.1
 orjson