Add script to pull all charts from Chart Studio

Author: ndrezn

README.md

@@ -124,3 +124,64 @@ Just repeat Step 4! Every time you export a new chart from Chart Studio and add
 **Need to remove a chart?**
 - Go to the `charts` folder, click on the file, and click the trash icon
 - Commit the change, and it will be removed from your site within a minute
+
+## Bulk Export All Your Charts (Advanced)
+
+If you have many charts in Chart Studio and want to download them all at once, you can use the `poll_all_charts.py` script instead of manually exporting each one.
+
+### What This Script Does
+
+The script automatically:
+1. Connects to your Chart Studio account using your API credentials
+2. Fetches all charts that you own
+3. Downloads the chart data as JSON
+4. Generates standalone HTML files using Plotly.js 1.58.5
+5. Saves them to the `charts/` folder, ready to be published
+
+This is much faster than manually exporting charts one-by-one from the Chart Studio interface, especially if you have dozens or hundreds of visualizations.
+
+### How to Use It
+
+**Step 1: Install UV**
+
+UV is a fast Python package manager. Install it by running:
+
+```bash
+# On macOS/Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# On Windows
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+**Step 2: Get Your Chart Studio API Credentials**
+
+1. Log in to [Chart Studio](https://chart-studio.plotly.com/)
+2. Go to Settings → API Keys
+3. Copy your API key
+
+**Step 3: Update the Script**
+
+Open `poll_all_charts.py` and update these lines with your credentials:
+
+```python
+username = 'your-username'  # Replace with your Chart Studio username
+api_key = 'your-api-key'    # Replace with your API key from Step 2
+```
+
+**Step 4: Run the Script**
+
+In your terminal, navigate to the repository folder and run:
+
+```bash
+./poll_all_charts.py
+```
+
+Or:
+```bash
+uv run poll_all_charts.py
+```
+
+The script will download all your charts and save them as HTML files in the `charts/` folder. Then just commit and push the changes to publish them on GitHub Pages!
+
+**Note:** This script uses Plotly.js version 1.58.5 to ensure compatibility and consistent rendering across all your charts.

poll_all_charts.py

@@ -0,0 +1,93 @@
+#!/usr/bin/env -S uv run --script
+#
+# /// script
+# requires-python = ">=3.12"
+# dependencies = ["requests"]
+# ///
+
+import requests
+import os
+import json
+
+username = 'your-username'  # Replace with your Chart Studio username
+api_key = 'your-api-key'    # Replace with your API key from Chart Studio
+
+headers = {"Plotly-Client-Platform": "Python 3 0.3.2"}
+auth = requests.auth.HTTPBasicAuth(username, api_key)
+
+# Fetch all plots with pagination
+all_plots = []
+page = 1
+per_page = 10  # Max items per page
+
+while True:
+    url = f"https://api.plot.ly/v2/folders/home?user={username}&page={page}&per_page={per_page}"
+    response = requests.get(url, auth=auth, headers=headers)
+
+    if response.status_code != 200:
+        print(f"❌ Error accessing plots: {response.status_code}")
+        print(f"Response: {response.text}")
+        exit(1)
+
+    data = response.json()
+    children = data.get("children", {}).get("results", [])
+
+    if not children:
+        break
+
+    # Filter to only include plots (filetype == 'plot')
+    plots = [p for p in children if p.get("filetype") == "plot"]
+    all_plots.extend(plots)
+
+    print(f"📄 Page {page}: Found {len(plots)} plots")
+
+    # Check if there are more pages
+    total_count = data.get("children", {}).get("count", 0)
+    if len(all_plots) >= total_count or len(children) < per_page:
+        break
+
+    page += 1
+
+print(f"\n✅ Total plots owned by {username}: {len(all_plots)}")
+
+if all_plots:
+    print(f"First plot: {all_plots[0]}")
+fids = [p["fid"] for p in all_plots]
+
+# Create output directory if it doesn't exist
+os.makedirs("charts", exist_ok=True)
+
+for fid in fids:
+    # Get the chart JSON data
+    plot_url = f"https://api.plotly.com/v2/plots/{fid}/content?inline_data=true"
+    plot_response = requests.get(plot_url, auth=auth, headers=headers)
+
+    if plot_response.status_code == 200:
+        # Parse the JSON response
+        chart_data = plot_response.json()
+
+        # Generate standalone HTML with Plotly.js 1.58.5
+        data_json = json.dumps(chart_data['data'])
+        layout_json = json.dumps(chart_data['layout'])
+
+        html_template = f"""<html>
+    <head><meta charset="utf-8" /></head>
+    <body>
+        <div id="plotly-div"></div>
+        <script src="https://cdn.plot.ly/plotly-1.58.5.min.js"></script>
+        <script>
+            var data = {data_json};
+            var layout = {layout_json};
+            Plotly.newPlot('plotly-div', data, layout);
+        </script>
+    </body>
+</html>"""
+
+        # Save as HTML
+        safe_filename = f"{fid}.html"
+        filepath = os.path.join("charts", safe_filename)
+        with open(filepath, "w") as f:
+            f.write(html_template)
+        print(f"        ✅ Saved to {filepath}")
+    else:
+        print(f"        ❌ Failed: HTTP {plot_response.status_code}")