Merge branch 'master' into doc-prod

Author: nicolaskruchten

Diff for: .circleci/config.yml

@@ -9,10 +9,10 @@ jobs:
       - checkout
       - run:
           name: Install black
-          command: 'sudo pip install black'
+          command: "sudo pip install black"
       - run:
           name: Check formatting with black
-          command: 'black --check .'
+          command: "black --check ."
 
   # Core
   python-2.7-core:
@@ -25,10 +25,10 @@ jobs:
       - checkout
       - run:
           name: Install tox
-          command: 'sudo pip install tox'
+          command: "sudo pip install tox"
       - run:
           name: Test with tox
-          command: 'cd packages/python/plotly; tox -e py27-core'
+          command: "cd packages/python/plotly; tox -e py27-core"
           no_output_timeout: 20m
 
   python-3.5-core:
@@ -41,10 +41,10 @@ jobs:
       - checkout
       - run:
           name: Install tox
-          command: 'sudo pip install tox'
+          command: "sudo pip install tox"
       - run:
           name: Test with tox
-          command: 'cd packages/python/plotly; tox -e py35-core'
+          command: "cd packages/python/plotly; tox -e py35-core"
           no_output_timeout: 20m
 
   python-3.6-core:
@@ -57,10 +57,10 @@ jobs:
       - checkout
       - run:
           name: Install tox
-          command: 'sudo pip install tox'
+          command: "sudo pip install tox"
       - run:
           name: Test with tox
-          command: 'cd packages/python/plotly; tox -e py36-core'
+          command: "cd packages/python/plotly; tox -e py36-core"
           no_output_timeout: 20m
 
   python-3.7-core:
@@ -73,10 +73,10 @@ jobs:
       - checkout
       - run:
           name: Install tox
-          command: 'sudo pip install tox'
+          command: "sudo pip install tox"
       - run:
           name: Test with tox
-          command: 'cd packages/python/plotly; tox -e py37-core'
+          command: "cd packages/python/plotly; tox -e py37-core"
           no_output_timeout: 20m
 
   python-3.7-percy:
@@ -122,14 +122,14 @@ jobs:
       - checkout
       - run:
           name: Install tox
-          command: 'sudo pip install tox'
+          command: "sudo pip install tox"
       - run:
           name: Install npm dependencies
           command: cd packages/python/plotly/plotly/tests/test_optional/test_jupyter && npm install
           no_output_timeout: 20m
       - run:
           name: Test with tox
-          command: 'cd packages/python/plotly; tox -e py27-optional'
+          command: "cd packages/python/plotly; tox -e py27-optional"
           no_output_timeout: 20m
 
   python-3.5-optional:
@@ -142,14 +142,14 @@ jobs:
       - checkout
       - run:
           name: Install tox
-          command: 'sudo pip install tox'
+          command: "sudo pip install tox"
       - run:
           name: Install npm dependencies
           command: cd packages/python/plotly/plotly/tests/test_optional/test_jupyter && npm install
           no_output_timeout: 20m
       - run:
           name: Test with tox
-          command: 'cd packages/python/plotly; tox -e py35-optional'
+          command: "cd packages/python/plotly; tox -e py35-optional"
           no_output_timeout: 20m
 
   python-3.6-optional:
@@ -162,14 +162,14 @@ jobs:
       - checkout
       - run:
           name: Install tox
-          command: 'sudo pip install tox'
+          command: "sudo pip install tox"
       - run:
           name: Install npm dependencies
           command: cd packages/python/plotly/plotly/tests/test_optional/test_jupyter && npm install
           no_output_timeout: 20m
       - run:
           name: Test with tox
-          command: 'cd packages/python/plotly; tox -e py36-optional'
+          command: "cd packages/python/plotly; tox -e py36-optional"
           no_output_timeout: 20m
 
   python-3.7-optional:
@@ -182,14 +182,14 @@ jobs:
       - checkout
       - run:
           name: Install tox
-          command: 'sudo pip install tox'
+          command: "sudo pip install tox"
       - run:
           name: Install npm dependencies
           command: cd packages/python/plotly/plotly/tests/test_optional/test_jupyter && npm install
           no_output_timeout: 20m
       - run:
           name: Test with tox
-          command: 'cd packages/python/plotly; tox -e py37-optional'
+          command: "cd packages/python/plotly; tox -e py37-optional"
           no_output_timeout: 20m
 
   # Plot.ly
@@ -203,10 +203,10 @@ jobs:
       - checkout
       - run:
           name: Install tox
-          command: 'sudo pip install tox'
+          command: "sudo pip install tox"
       - run:
           name: Test with tox
-          command: 'cd packages/python/chart-studio; tox -e py27-plot_ly'
+          command: "cd packages/python/chart-studio; tox -e py27-plot_ly"
           no_output_timeout: 20m
 
   python-3.5-plot_ly:
@@ -219,10 +219,10 @@ jobs:
       - checkout
       - run:
           name: Install tox
-          command: 'sudo pip install tox'
+          command: "sudo pip install tox"
       - run:
           name: Test with tox
-          command: 'cd packages/python/chart-studio; tox -e py35-plot_ly'
+          command: "cd packages/python/chart-studio; tox -e py35-plot_ly"
           no_output_timeout: 20m
 
   python-3.7-plot_ly:
@@ -235,10 +235,10 @@ jobs:
       - checkout
       - run:
           name: Install tox
-          command: 'sudo pip install tox'
+          command: "sudo pip install tox"
       - run:
           name: Test with tox
-          command: 'cd packages/python/chart-studio; tox -e py37-plot_ly'
+          command: "cd packages/python/chart-studio; tox -e py37-plot_ly"
           no_output_timeout: 20m
 
   python-2-7-orca:
@@ -269,7 +269,7 @@ jobs:
             pytest packages/python/plotly/plotly/tests/test_orca
 
       - store_artifacts:
-            path: plotly/tests/test_orca/images/linux/failed
+          path: plotly/tests/test_orca/images/linux/failed
 
   python-3-5-orca:
     docker:
@@ -299,7 +299,7 @@ jobs:
             pytest packages/python/plotly/plotly/tests/test_orca
 
       - store_artifacts:
-            path: plotly/tests/test_orca/images/linux/failed
+          path: plotly/tests/test_orca/images/linux/failed
 
   python-3-7-orca:
     docker:
@@ -325,12 +325,12 @@ jobs:
           command: |
             . /home/circleci/miniconda/etc/profile.d/conda.sh
             conda activate circle_optional
-            pytest --doctest-modules --ignore packages/python/plotly/plotly/tests --ignore packages/python/plotly/plotly/matplotlylib/mplexporter/tests packages/python/plotly/plotly 
+            pytest --doctest-modules --ignore packages/python/plotly/plotly/tests --ignore packages/python/plotly/plotly/matplotlylib/mplexporter/tests packages/python/plotly/plotly
             pytest --disable-warnings packages/python/plotly/plotly/tests/test_core
             pytest packages/python/plotly/plotly/tests/test_orca
 
       - store_artifacts:
-            path: plotly/tests/test_orca/images/linux/failed
+          path: plotly/tests/test_orca/images/linux/failed
 
   plotlyjs_dev_build:
     docker:
@@ -343,13 +343,13 @@ jobs:
       - checkout
       - run:
           name: Install tox
-          command: 'sudo pip install retrying tox black inflect'
+          command: "sudo pip install retrying tox black inflect"
       - run:
           name: Update jupyterlab-plotly version
-          command: 'cd packages/python/plotly; python setup.py updateplotlywidgetversion'
+          command: "cd packages/python/plotly; python setup.py updateplotlywidgetversion"
       - run:
           name: Update plotly.js to dev
-          command: 'cd packages/python/plotly; python setup.py updateplotlyjsdev'
+          command: "cd packages/python/plotly; python setup.py updateplotlyjsdev"
       - run:
           name: Test with tox
           command: |
@@ -385,15 +385,13 @@ jobs:
       - store_artifacts:
           path: packages/python/plotly/dist
 
-
   build-doc:
     resource_class: xlarge
     docker:
       # specify the version you desire here
       # use `-browsers` prefix for selenium tests, e.g. `3.6.1-browsers`
       - image: circleci/python:3.6.8-node
 
-
         working_directory: ~/project
 
     steps:
@@ -419,12 +417,12 @@ jobs:
             npm install [email protected]
             npm install orca
             pip install -r requirements.txt
-            if [ "${CIRCLE_BRANCH}" == "master" ]; then
+            if [ "${CIRCLE_BRANCH}" != "doc-prod" ]; then
               pip uninstall -y plotly
               cd ../packages/python/plotly
               python3 setup.py install
-              cd ../../../doc      
-            fi 
+              cd ../../../doc
+            fi
             echo 'export PATH="/home/circleci/project/doc/node_modules/.bin:$PATH"' >> $BASH_ENV
             sudo apt-get install -y poppler-utils libxtst6 xvfb libgtk2.0-0 libgconf-2-4 libnss3 libasound2
             cd ..
@@ -484,12 +482,9 @@ jobs:
 
             cd ../..
 
-
       - store_artifacts:
           path: doc/build
           destination: doc/build
-     
-
 
 workflows:
   version: 2

Diff for: CHANGELOG.md

@@ -2,6 +2,34 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [4.4.0] - 2019-12-10
+
+### Updated
+ - Updated Plotly.js to version 1.51.2. See the
+ [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/master/CHANGELOG.md#1512----2019-11-25)
+ for more information
+ - The tutorials of the [plotly.py documentation](https://plot.ly/python/) are
+   now in the main [plotly.py Github repository](https://github.com/plotly/plotly.py). Contributions in order to improve or extend the documentation are very welcome!
+ - `plotly.express` generated plots no longer have a default height of 600 pixels, instead they inherit the default height of regular figures [#1990](https://github.com/plotly/plotly.py/pull/1990). Note that the `height` argument to each `plotly.express` function can be set to 600 to restore the legacy behavior. 
+ 
+### Fixed
+
+ - Fixed a plotly.express input bug when using data frame indices[#1934](https://github.com/plotly/plotly.py/pull/1934)
+ - Fixed how to display facet labels with plotly express [#1966](https://github.com/plotly/plotly.py/pull/1966)
+ - Fixed a bug to use correctly the `zmin/zmax` parameter in `px.imshow` for single-channel images [#1981](https://github.com/plotly/plotly.py/pull/1981)
+ - Clipped docstring width for better display in Jupyterlab [#1939](https://github.com/plotly/plotly.py/pull/1939). Thank you @joelostblom!
+ - Fixed a bug in the case of external orca server [#1915](https://github.com/plotly/plotly.py/pull/1915) thank you @dev-dsp!
+
+### Added 
+
+ - Extended the plotly.express functional API with .. new functions: `px.pie`,
+   `px.sunburst`, `px.treemap`, `px.funnel`, and `px.funnelarea` ([#1909](https://github.com/plotly/plotly.py/pull/1909)) `px.density_mapbox` and
+   `px.choropleth_mapbox` [#1937](https://github.com/plotly/plotly.py/pull/1937). Also, all mapbox functions in plotly.express have new arguments `center` and `mapbox_style` [#1937](https://github.com/plotly/plotly.py/pull/1937).
+ - plotly.express polar plots (`scatter_polar`, `line_polar`, `bar_polar`) now
+   have a `range_theta` keyword argument for representing only an angular
+section [#1969](https://github.com/plotly/plotly.py/pull/1969).
+ - Docstrings of plotly.py are now doctested [#1921](https://github.com/plotly/plotly.py/pull/1921).
+
 ## [4.3.0] - 2019-11-11
 
 ### Updated

Diff for: README.md

@@ -26,7 +26,7 @@
 
 ## Quickstart
 
-`pip install plotly==4.3.0`
+`pip install plotly==4.4.0`
 
 Inside [Jupyter notebook](https://jupyter.org/install) (installable with `pip install "notebook>=5.3" "ipywidgets>=7.2"`):
 ```python
@@ -72,12 +72,12 @@ 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.3.0
+pip install plotly==4.4.0
 ```
 
 or conda.
 ```
-conda install -c plotly plotly=4.3.0
+conda install -c plotly plotly=4.4.0
 ```
 
 ### Jupyter Notebook Support
@@ -105,7 +105,7 @@ pip install jupyterlab==1.2 "ipywidgets==7.5"
 or conda.
 
 ```
-conda install -c conda-forge jupyterlab=1.2
+conda install jupyterlab=1.2
 conda install "ipywidgets=7.5"
 ```
 
@@ -121,10 +121,10 @@ set NODE_OPTIONS=--max-old-space-size=4096
 jupyter labextension install @jupyter-widgets/[email protected] --no-build
 
 # FigureWidget support
-jupyter labextension install plotlywidget@1.3.0 --no-build
+jupyter labextension install plotlywidget@1.4.0 --no-build
 
 # and jupyterlab renderer support
-jupyter labextension install jupyterlab-plotly@1.3.0 --no-build
+jupyter labextension install jupyterlab-plotly@1.4.0 --no-build
 
 # Build extensions (must be done to activate extensions since --no-build is used above)
 jupyter lab build