Circular Import Dependency in Plotly Templates

Offen

#5,281 erstellt am 15.7.2025 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 3/5
Geschätzter Aufwand: 1-2 Tage
Anfängerfreundlichkeit: 48/100

Issue-Typ: Bug
Klarheit: Größtenteils klar
Aktivitätsstatus: Veraltet
Tech-Stack: python
Bereich: data-visualization

Rechercherichtung

Reproduziere den Fehler mit plotly==5.24.1 und plotly-resampler==0.10.0 und untersuche anschließend plotly.graph_objs.init.py sowie layout/template/data/_heatmapgl.py. Verfolge die Importreihenfolge aus dem gemeldeten FigureResampler-Beispiel. Als abgeschlossen gilt die Aufgabe, wenn das Beispiel die Abbildung importiert und erstellt, ohne dass zuvor manuell ein plotly.graph_objs-Import erforderlich ist.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

bug P1

The issue is that plotly's template system has a circular import dependency:

plotly.graph_objs.__init__.py imports all trace types including Heatmapgl
During this import process, it also loads template data
layout/template/data/_heatmapgl.py tries to import Heatmapgl from plotly.graph_objs
But plotly.graph_objs is still in the process of being imported!

This occurred when attempting to use plotly and plotly-resampler and a heatmap.

Reproduction of Error

Minimal reproduction code:

import plotly.graph_objs as go
go.Heatmapgl()  # ✅ Success

# But this fails:
from plotly_resampler import FigureResampler
fig = FigureResampler(go.Figure())  # ❌ Circular import

Versions affected:

plotly==5.24.1
plotly-resampler==0.10.0

Work around

This can be worked around by forcing import order:

import plotly.graph_objs  # Force full initialization first
from plotly_resampler import FigureResampler  # Then import resampler

Vorherrschende Sprache: Python
Sterne: 18.8k
Forks: 2.8k
Ø Merge: 13 Std. 41 Min.
Gemergte PRs (30 T.): 21

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus plotly/plotly.py

Use group_by(maintain_order=True) in process_dataframe_hierarchy once narwhals exposes it Offen

P3 size: 1 task

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 65/100

plotly/plotly.py#5769 · 1 Reaktion · Erstellt am 22.9.2026
Remove `@types/plotly.js` dependency Offen

P3 size: 1 task

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100

plotly/plotly.py#5740 · Erstellt am 14.9.2026
[mkdocs] deprecated geopandas dataset Offen

bug P1

Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 68/100

plotly/plotly.py#5405 · Erstellt am 07.11.2025
Center Title by default for px.imshow Offen

feature P3

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 62/100

plotly/plotly.py#4303 · Erstellt am 29.7.2023
add `custom_data` to px.histogram Offen

feature P3

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100

plotly/plotly.py#3859 · 1 Kommentar · Erstellt am 18.8.2022

Alle Issues in plotly/plotly.py