Skip to content

Commit b4ecea0

Browse files
Merge branch 'master' into lock_cdn_ver
2 parents 7e4b256 + b0a5f77 commit b4ecea0

File tree

247 files changed

+19789
-257087
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

247 files changed

+19789
-257087
lines changed

Diff for: .circleci/config.yml

+154-277
Large diffs are not rendered by default.

Diff for: .circleci/create_conda_optional_env.sh

-23
This file was deleted.

Diff for: .circleci/install_miniconda_and_build_.sh

-15
This file was deleted.

Diff for: .gitignore

+4
Original file line numberDiff line numberDiff line change
@@ -48,3 +48,7 @@ doc/python/.mapbox_token
4848
doc/.ipynb_checkpoints
4949
tags
5050
doc/check-or-enforce-order.py
51+
52+
packages/javascript/jupyterlab-plotly/lib/
53+
packages/python/plotly/jupyterlab_plotly/labextension/
54+
packages/python/plotly/jupyterlab_plotly/nbextension/index.js*

Diff for: CHANGELOG.md

+21-15
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,8 @@
22
All notable changes to this project will be documented in this file.
33
This project adheres to [Semantic Versioning](http://semver.org/).
44

5-
## [4.15.0] - UNRELEASED
65

7-
### Added
6+
## [4.14.3] - 2021-01-12
87

98
### Fixed
109
- Plotly.js cdn url will now be versioned by default for:
@@ -13,16 +12,23 @@ This project adheres to [Semantic Versioning](http://semver.org/).
1312
`plotly.js` versions breaking with version bumps.
1413
[2961](https://github.com/plotly/plotly.py/pull/2961)
1514

16-
### Updated
15+
- `px.timeline()` now allows `hover_data` formatting of start and end times [3018](https://github.com/plotly/plotly.py/pull/3018)
16+
- Small change to packaging of `plotlywidget` extension for JupyterLab 3 [3021](https://github.com/plotly/plotly.py/pull/3021)
1717

18+
## [4.14.2] - 2021-01-11
1819

19-
## [4.14.2] - UNRELEASED
20+
### Updated
2021

21-
### Added
22+
- JupyterLab extensions now compatible with JupyterLab 3.x [3016](https://github.com/plotly/plotly.py/pull/3016)
23+
- Updated Plotly.js to version 1.58.4. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/v1.58.4/CHANGELOG.md) for more information. These changes are reflected in the auto-generated `plotly.graph_objects` module. Notable changes include:
24+
- fixes for rendering 3d plots on recent Safari versions
25+
- fixes to inside ticklabels
26+
- regression fixes
2227

2328
### Fixed
2429

25-
### Updated
30+
- `px.histogram()` Y-axis labels now take into account `histnorm` and `barnorm` [2989](https://github.com/plotly/plotly.py/pull/2989)
31+
- `px.histogram()` `marginal` and `facet_*` now work correctly together [3014](https://github.com/plotly/plotly.py/pull/3014)
2632

2733

2834
## [4.14.1] - 2020-12-09
@@ -134,7 +140,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
134140
faster image rendering and smaller figure size. Additional optional arguments
135141
`binary_backend`, `binary_format` and `binary_compression_level` control
136142
how to generate the b64 string ([#2691](https://github.com/plotly/plotly.py/pull/2691)
137-
- `px.imshow` has a new `constrast_rescaling` argument in order to choose how
143+
- `px.imshow` has a new `contrast_rescaling` argument in order to choose how
138144
to set data values corresponding to the bounds of the color range
139145
([#2691](https://github.com/plotly/plotly.py/pull/2691)
140146

@@ -238,7 +244,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
238244

239245
### Added
240246

241-
- The `hover_data` parameter of `px` functions can now be a dictionary. This makes it possible to skip hover information for some arguments or to change the formatting of hover informatiom [#2377](https://github.com/plotly/plotly.py/pull/2377).
247+
- The `hover_data` parameter of `px` functions can now be a dictionary. This makes it possible to skip hover information for some arguments or to change the formatting of hover information [#2377](https://github.com/plotly/plotly.py/pull/2377).
242248
- It's now possible to build a development version of Plotly.py against the build artifacts from a non-`master` branch of Plotly.js, which makes for faster QA and development cycles [#2349](https://github.com/plotly/plotly.py/pull/2349). Thanks [@zouhairm](https://github.com/zouhairm) for this Pull Request!
243249

244250
### Fixed
@@ -251,7 +257,7 @@ This version includes several performance improvements ([#2368](https://github.c
251257

252258
- Child graph objects (e.g. `figure.layout.xaxis`) are no longer created eagerly during graph object construction. Instead, they are created lazily the first time the property is accessed.
253259
- Property validation is now disabled for select internal operations.
254-
- When used with Python 3.7 and above, ploty.py now takes advantage of [PEP-562](https://www.python.org/dev/peps/pep-0562/) to perform submodule imports lazily. This dramatically improves import times.
260+
- When used with Python 3.7 and above, plotly.py now takes advantage of [PEP-562](https://www.python.org/dev/peps/pep-0562/) to perform submodule imports lazily. This dramatically improves import times.
255261

256262
## [4.6.0] - 2020-03-31
257263

@@ -289,7 +295,7 @@ This version includes several performance improvements ([#2368](https://github.c
289295

290296
- Jupyterlab extension now compatible with both Jupyterlab 1.2 and 2.0 [#2261](https://github.com/plotly/plotly.py/pull/2261) with thanks to [@consideRatio](https://github.com/consideRatio) for the contribution!
291297
- Fixed a bug when using boolean values for the color argument of px functions [#2127](https://github.com/plotly/plotly.py/pull/2127)
292-
- Corrected import bug which was occuring with old versions of ipywidgets [#2265](https://github.com/plotly/plotly.py/pull/2265)
298+
- Corrected import bug which was occurring with old versions of ipywidgets [#2265](https://github.com/plotly/plotly.py/pull/2265)
293299
- Fixed python 3.8 syntax warning [#2262](https://github.com/plotly/plotly.py/pull/2262), with thanks to [@sgn](https://github.com/sgn) for the contribution!
294300

295301
## [4.5.3] - 2020-03-05
@@ -364,7 +370,7 @@ This version includes several performance improvements ([#2368](https://github.c
364370
for more information
365371
- The tutorials of the [plotly.py documentation](https://plot.ly/python/) are
366372
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!
367-
- `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). To restore the old behavior, set `px.defaults.height=600` once per session, or set the `height` keyword arguement to any `px.function()` to 600.
373+
- `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). To restore the old behavior, set `px.defaults.height=600` once per session, or set the `height` keyword argument to any `px.function()` to 600.
368374

369375
### Fixed
370376

@@ -438,7 +444,7 @@ section [#1969](https://github.com/plotly/plotly.py/pull/1969).
438444
- The width of a figure produced by the `create_gantt` figure factory now resizes responsively ([#1724](https://github.com/plotly/plotly.py/pull/1724))
439445

440446
### Fixed
441-
- The name of the steps property of `graph_objects.indicator.Guage` has been renamed from `stepss` to `steps`
447+
- The name of the steps property of `graph_objects.indicator.Gauge` has been renamed from `stepss` to `steps`
442448
- Avoid crash in iframe renderers when running outside iPython ([#1723](https://github.com/plotly/plotly.py/pull/1723))
443449

444450
## [4.1.0] - 2019-08-06
@@ -490,7 +496,7 @@ This is a major release that includes many new features, and a few breaking chan
490496
- Added support for all trace types in `make_subplots` ([#1528](https://github.com/plotly/plotly.py/pull/1528))
491497
- Added support for secondary y-axes in `make_subplots` ([#1564](https://github.com/plotly/plotly.py/pull/1564))
492498
- Support passing a scalar trace object (rather than a list or tuple of trace objects) as the `data` property to the `Figure` constructor ([#1614](https://github.com/plotly/plotly.py/pull/1614))
493-
- Added dictionary-stule `.pop` method to graph object classes ([#1614](https://github.com/plotly/plotly.py/pull/1614))
499+
- Added dictionary-style `.pop` method to graph object classes ([#1614](https://github.com/plotly/plotly.py/pull/1614))
494500
- New `jupyterlab-plotly` JupyterLab extension for rendering figures in JupyterLab. Replaces the `@jupyterlab/plotly-extension` extension, and includes JupyterLab 1.0 support.
495501
- Added new suite of built-in colorscales to the `plotly.colors` module, and support for specifying this wide range of colorscales by name. Also added support for specifying colorscales as a list of colors, in which case the color spacing is assumed to be uniform ([#1647](https://github.com/plotly/plotly.py/pull/1647)).
496502
- Added `sphinx-gallery` renderer for embedding plotly figures in [Sphinx-Gallery](https://sphinx-gallery.github.io/) ([#1577](https://github.com/plotly/plotly.py/pull/1577), [plotly/plotly-sphinx-gallery](https://github.com/plotly/plotly-sphinx-gallery)).
@@ -1095,7 +1101,7 @@ must be installed:
10951101
properties are ignored rather than causing an exception.
10961102
- A `to_ordered_dict` method has been added to the `Figure` and `FigureWidget`
10971103
classes. This method returns a representation of the figure as a nested
1098-
structure of `OrdererdDict` and `list` instances where the keys in each
1104+
structure of `OrderedDict` and `list` instances where the keys in each
10991105
`OrderedDict` are sorted alphabetically. This method replaces the
11001106
`get_ordered` method that was available in version 2, and makes it possible
11011107
to traverse the nested structure of a figure in a deterministic order.
@@ -1516,7 +1522,7 @@ gone.
15161522
## [1.12.10] - 2016-11-28
15171523
### Updated
15181524
- `FF.create_violin` and `FF.create_scatterplotmatrix` now by default do not print subplot grid information in output
1519-
- Removed alert that occured when downloading plot images offline. Please note: for higher resolution images and more export options, consider making requests to our image servers. See: `help(py.image)` for more details.
1525+
- Removed alert that occurred when downloading plot images offline. Please note: for higher resolution images and more export options, consider making requests to our image servers. See: `help(py.image)` for more details.
15201526

15211527
### Added
15221528
- Plot configuration options for offline plots. See the list of [configuration options](https://github.com/Rikorose/plotly.py/blob/master/plotly/offline/offline.py#L189) and [examples](https://plot.ly/javascript/configuration-options/) for more information.

Diff for: README.md

+25-25
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,9 @@ Our recommended IDE for Plotly’s Python graphing library is Dash Enterprise’
3737

3838
## Quickstart
3939

40-
`pip install plotly==4.14.1`
40+
`pip install plotly==4.14.3`
4141

42-
Inside [Jupyter notebook](https://jupyter.org/install) (installable with `pip install "notebook>=5.3" "ipywidgets>=7.2"`):
42+
Inside [Jupyter](https://jupyter.org/install) (installable with `pip install "jupyterlab>=3" "ipywidgets>=7.6"`):
4343

4444
```python
4545
import plotly.graph_objects as go
@@ -86,57 +86,57 @@ Built on top of [plotly.js](https://github.com/plotly/plotly.js), `plotly.py` is
8686
plotly.py may be installed using pip...
8787

8888
```
89-
pip install plotly==4.14.1
89+
pip install plotly==4.14.3
9090
```
9191

9292
or conda.
9393

9494
```
95-
conda install -c plotly plotly=4.14.1
95+
conda install -c plotly plotly=4.14.3
9696
```
9797

98-
### Jupyter Notebook Support
98+
### JupyterLab Support
9999

100-
For use in the Jupyter Notebook, install the `notebook` and `ipywidgets`
101-
packages using pip...
100+
For use in JupyterLab, install the `jupyterlab` and `ipywidgets`
101+
packages using `pip`:
102102

103103
```
104-
pip install "notebook>=5.3" "ipywidgets==7.5"
104+
pip install jupyterlab>=3 "ipywidgets>=7.6"
105105
```
106106

107-
or conda.
107+
or `conda`:
108108

109109
```
110-
conda install "notebook>=5.3" "ipywidgets=7.5"
110+
conda install jupyterlab>=3 "ipywidgets>=7.6"
111111
```
112112

113-
### JupyterLab Support (Python 3.5+)
114-
115-
For use in JupyterLab, install the `jupyterlab` and `ipywidgets`
116-
packages using pip...
113+
For JupyterLab 2 or earlier, run the following commands to install the required JupyterLab extensions (note that this will require [`node`](https://nodejs.org/) to be installed):
117114

118115
```
119-
pip install jupyterlab "ipywidgets==7.5"
116+
# Basic JupyterLab renderer support
117+
jupyter labextension install [email protected]
118+
119+
# OPTIONAL: Jupyter widgets extension for FigureWidget support
120+
jupyter labextension install @jupyter-widgets/jupyterlab-manager [email protected]
120121
```
121122

122-
or conda.
123+
Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab.
124+
125+
### Jupyter Notebook Support
126+
127+
For use in the Jupyter Notebook, install the `notebook` and `ipywidgets`
128+
packages using `pip`:
123129

124130
```
125-
conda install jupyterlab "ipywidgets=7.5"
131+
pip install "notebook>=5.3" "ipywidgets>=7.5"
126132
```
127133

128-
Then run the following commands to install the required JupyterLab extensions (note that this will require [`node`](https://nodejs.org/) to be installed):
134+
or `conda`:
129135

130136
```
131-
# Basic JupyterLab renderer support
132-
jupyter labextension install [email protected]
133-
134-
# OPTIONAL: Jupyter widgets extension for FigureWidget support
135-
jupyter labextension install @jupyter-widgets/jupyterlab-manager [email protected]
137+
conda install "notebook>=5.3" "ipywidgets>=7.5"
136138
```
137139

138-
Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab.
139-
140140
### Static Image Export
141141

142142
plotly.py supports [static image export](https://plotly.com/python/static-image-export/),

Diff for: binder/requirements.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
jupytext
2-
plotly==4.14.1
2+
plotly==4.14.3
33
jupyter
44
notebook
55
pandas==1.0.3

Diff for: bld.bat

-8
This file was deleted.

Diff for: build.sh

-9
This file was deleted.

Diff for: build_for_conda.md

-19
This file was deleted.

Diff for: contributing.md

+2-7
Original file line numberDiff line numberDiff line change
@@ -238,12 +238,7 @@ the `plotly/plotly.js` GitHub repository (and place them in
238238
`plotly/package_data`). It will then regenerate all of the `graph_objs`
239239
classes based on the new schema.
240240

241-
For dev branches, it is also possible to use `updateplotlyjsdev --devrepo reponame --devbranch branchname` to update to development versions of `plotly.js`. This will fetch the `plotly.js` in the CircleCI artifact of the branch `branchname` of the repo `reponame`. If `--devrepo` or `--devbranch` are omitted, `updateplotlyjsdev` defaults using `plotly/plotly.js` and `master` respectively. For example, to update to a version from a pull request to the `plotly/plotly.js` repo that is numbered 555, run:
242-
243-
```bash
244-
$ cd packages/python/plotly
245-
$ python setup.py updateplotlyjsdev --devbranch pull/555
246-
```
241+
For dev branches, it is also possible to use `updateplotlyjsdev --devrepo reponame --devbranch branchname` to update to development versions of `plotly.js`. This will fetch the `plotly.js` in the CircleCI artifact of the branch `branchname` of the repo `reponame`. If `--devrepo` or `--devbranch` are omitted, `updateplotlyjsdev` defaults using `plotly/plotly.js` and `master` respectively.
247242

248243
## Testing
249244

@@ -280,7 +275,7 @@ pytest packages/python/plotly/plotly/tests/test_core/
280275
pytest plotly/tests/test_plotly/test_plot.py
281276
```
282277

283-
or for a specfic test function
278+
or for a specific test function
284279

285280
```bash
286281
pytest plotly/tests/test_plotly/test_plot.py::test_function

Diff for: doc/apidoc/conf.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@
2828
# The short X.Y version
2929
version = ""
3030
# The full version, including alpha/beta/rc tags
31-
release = "4.14.1"
31+
release = "4.14.3"
3232

3333

3434
# -- General configuration ---------------------------------------------------

Diff for: doc/python/2D-Histogram.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -137,7 +137,7 @@ fig = go.Figure(go.Histogram2d(x=x, y=y, histnorm='probability',
137137
fig.show()
138138
```
139139
### Sharing bin settings between 2D Histograms
140-
This example shows how to use [bingroup](https://plotly.com/python/reference/histogram/#histogram-bingroup) attribute to have a compatible bin settings for both histograms. To define `start`, `end` and `size` value of x-axis and y-axis seperatly, set [ybins](https://plotly.com/python/reference/histogram2dcontour/#histogram2dcontour-ybins) and `xbins`.
140+
This example shows how to use [bingroup](https://plotly.com/python/reference/histogram/#histogram-bingroup) attribute to have a compatible bin settings for both histograms. To define `start`, `end` and `size` value of x-axis and y-axis separately, set [ybins](https://plotly.com/python/reference/histogram2dcontour/#histogram2dcontour-ybins) and `xbins`.
141141

142142
```python
143143
import plotly.graph_objects as go

Diff for: doc/python/3d-isosurface-plots.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -130,7 +130,7 @@ fig = go.Figure(data=go.Isosurface(
130130
fig.show()
131131
```
132132

133-
#### Isosurface with Addtional Slices
133+
#### Isosurface with Additional Slices
134134

135135
Here we visualize slices parallel to the axes on top of isosurfaces. For a clearer visualization, the `fill` ratio of isosurfaces is decreased below 1 (completely filled).
136136

@@ -235,4 +235,4 @@ fig.show()
235235
```
236236

237237
#### Reference
238-
See https://plotly.com/python/reference/isosurface/ for more information and chart attribute options!
238+
See https://plotly.com/python/reference/isosurface/ for more information and chart attribute options!

Diff for: doc/python/3d-mesh.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ IFrame(snippet_url + '3d-mesh', width='100%', height=630)
8383

8484
### Mesh Tetrahedron
8585

86-
In this example we use the `ì`, `j` and `k` parameters to specify manually the geometry of the triangles of the mesh.
86+
In this example we use the `i`, `j` and `k` parameters to specify manually the geometry of the triangles of the mesh.
8787

8888
```python
8989
import plotly.graph_objects as go

0 commit comments

Comments
 (0)