plotly / plotly/plotly.py

[mkdocs] breaking examples with Python 3.13.3 on MacOS

Open
#5,399 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug P1
Dominant language
Python
Stars
18.8k
Forks
2.8k
Avg merge
16h 26m
Merged PRs (30d)
21

Description

At 36bd491a9 I get the following breaks from make examples-force in these files:

  • doc/python/graphing-multiple-chart-types.md
  • doc/python/hexbin-mapbox.md
  • doc/python/ml-tsne-umap-projections.md
  • doc/python/orca-management.md
  • doc/python/px-arguments.md
  • doc/python/sankey-diagram.md
  • doc/python/scatter-plots-on-maps.md
  • doc/python/tile-county-choropleth.md
  • doc/python/tile-map-layers.md
  • doc/python/tile-scatter-maps.md
uv run bin/run_markdown.py --outdir pages --htmldir pages/examples --inline --verbose 2 doc/python/graphing-multiple-chart-types.md
Processing doc/python/graphing-multiple-chart-types.md...
- Found 5 code blocks
- Executing block 0/5
- Executing block 1/5
- Executing block 2/5
- Executing block 3/5
  - Warning: block 3 had an error
- Executing block 4/5

uv run bin/run_markdown.py --outdir pages --htmldir pages/examples --inline --verbose 2 doc/python/hexbin-mapbox.md
Processing doc/python/hexbin-mapbox.md...
- Found 6 code blocks
- Executing block 0/6
  - Warning: block 0 had an error
- Executing block 1/6
  - Warning: block 1 had an error
- Executing block 2/6
  - Warning: block 2 had an error
- Executing block 3/6
  - Warning: block 3 had an error
- Executing block 4/6
  - Warning: block 4 had an error
- Executing block 5/6
  - Warning: block 5 had an error

uv run bin/run_markdown.py --outdir pages --htmldir pages/examples --inline --verbose 2 doc/python/ml-tsne-umap-projections.md
Processing doc/python/ml-tsne-umap-projections.md...
- Found 5 code blocks
- Executing block 0/5
- Executing block 1/5
- Executing block 2/5
- Executing block 3/5
  - Warning: block 3 had an error
- Executing block 4/5
  - Warning: block 4 had an error

uv run bin/run_markdown.py --outdir pages --htmldir pages/examples --inline --verbose 2 doc/python/orca-management.md
Processing doc/python/orca-management.md...
- Found 9 code blocks
- Executing block 0/9
- Executing block 1/9
- Executing block 2/9
- Executing block 3/9
  - Warning: block 3 had an error
- Executing block 4/9
- Executing block 5/9
  - Warning: block 5 had an error
- Executing block 6/9
- Executing block 7/9
  - Warning: block 7 had an error
- Executing block 8/9

uv run bin/run_markdown.py --outdir pages --htmldir pages/examples --inline --verbose 2 doc/python/px-arguments.md
Processing doc/python/px-arguments.md...
- Found 18 code blocks
- Executing block 0/18
  - Warning: block 0 had an error
- Executing block 1/18
  - Warning: block 1 had an error
- Executing block 2/18
- Executing block 3/18
- Executing block 4/18
- Executing block 5/18
- Executing block 6/18
- Executing block 7/18
- Executing block 8/18
- Executing block 9/18
- Executing block 10/18
- Executing block 11/18
- Executing block 12/18
- Executing block 13/18
- Executing block 14/18
- Executing block 15/18
- Executing block 16/18
- Executing block 17/18

uv run bin/run_markdown.py --outdir pages --htmldir pages/examples --inline --verbose 2 doc/python/sankey-diagram.md
Processing doc/python/sankey-diagram.md...
- Found 10 code blocks
- Executing block 0/10
- Executing block 1/10
  - Warning: block 1 had an error
- Executing block 2/10
- Executing block 3/10
- Executing block 4/10
- Executing block 5/10
- Executing block 6/10
- Executing block 7/10
- Executing block 8/10
- Executing block 9/10

uv run bin/run_markdown.py --outdir pages --htmldir pages/examples --inline --verbose 2 doc/python/scatter-plots-on-maps.md
Processing doc/python/scatter-plots-on-maps.md...
- Found 6 code blocks
- Executing block 0/6
- Executing block 1/6
- Executing block 2/6
  - Warning: block 2 had an error
- Executing block 3/6
- Executing block 4/6
- Executing block 5/6

uv run bin/run_markdown.py --outdir pages --htmldir pages/examples --inline --verbose 2 doc/python/tile-county-choropleth.md
Processing doc/python/tile-county-choropleth.md...
- Found 10 code blocks
- Executing block 0/10
- Executing block 1/10
- Executing block 2/10
- Executing block 3/10
- Executing block 4/10
- Executing block 5/10
- Executing block 6/10
- Executing block 7/10
- Executing block 8/10
- Executing block 9/10
  - Warning: block 9 had an error

uv run bin/run_markdown.py --outdir pages --htmldir pages/examples --inline --verbose 2 doc/python/tile-map-layers.md
Processing doc/python/tile-map-layers.md...
- Found 8 code blocks
- Executing block 0/8
- Executing block 1/8
- Executing block 2/8
- Executing block 3/8
- Executing block 4/8
- Executing block 5/8
- Executing block 6/8
  - Warning: block 6 had an error
- Executing block 7/8

uv run bin/run_markdown.py --outdir pages --htmldir pages/examples --inline --verbose 2 doc/python/tile-scatter-maps.md
Processing doc/python/tile-scatter-maps.md...
- Found 11 code blocks
- Executing block 0/11
- Executing block 1/11
  - Warning: block 1 had an error
- Executing block 2/11
- Executing block 3/11
- Executing block 4/11
- Executing block 5/11
- Executing block 6/11
- Executing block 7/11
- Executing block 8/11
- Executing block 9/11
  - Warning: block 9 had an error
- Executing block 10/11
  - Warning: block 10 had an error

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by rerunning make examples-force, or the reported uv run bin/run_markdown.py command, through bin/run_markdown.py. Check the failing blocks in doc/python/graphing-multiple-chart-types.md, hexbin-mapbox.md, ml-tsne-umap-projections.md, orca-management.md, px-arguments.md, sankey-diagram.md, scatter-plots-on-maps.md, tile-county-choropleth.md, tile-map-layers.md, and tile-scatter-maps.md; done means the listed examples execute without warnings.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.