plot3 0.4.0__tar.gz → 0.4.1__tar.gz

{plot3-0.4.0 → plot3-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plot3
-Version: 0.4.0
+Version: 0.4.1
 Summary: ggplot2 grammar of graphics for Python: interactive WebGL figures and journal-ready PNG, SVG, and PDF
 Author: Rigoberto Leyva Salmeron
 License-Expression: MIT
@@ -376,13 +376,28 @@ ggplot() + geom_function("y = sin(x - t)") + transition_time(t=(0, 6.28))   # tr
 ggplot() + geom_function("y = dbeta(x, a, b)") + slider(a=(0.5, 5), b=(0.5, 5))
 ```
 
-Data animations follow `gganimate`:
+Data animations follow `gganimate`. With a table shaped like gapminder
+(made-up numbers here; the real data is
+`pl.read_csv("https://raw.githubusercontent.com/kirenz/datasets/master/gapminder.csv")`):
 
-```python notest
-(ggplot(gapminder, aes(x="gdp", y="life", size="pop", colour="continent", group="country"))
+```python
+countries = {"Brazil": "Americas", "China": "Asia", "Egypt": "Africa",
+             "France": "Europe", "India": "Asia", "Mexico": "Americas"}
+gapminder = pd.DataFrame([
+    {"country": country, "continent": continent, "year": year,
+     "gdpPercap": 800 * (1.03 + 0.01 * i) ** (year - 1952),
+     "lifeExp": 45 + 0.35 * (year - 1952) + 2 * i,
+     "pop": 2e7 * (1.02 + 0.002 * i) ** (year - 1952)}
+    for i, (country, continent) in enumerate(countries.items())
+    for year in range(1952, 2008, 5)
+])
+
+(ggplot(gapminder, aes(x="gdpPercap", y="lifeExp", size="pop", colour="continent", group="country"))
  + geom_point() + scale_x_log10() + transition_time("year") + labs(title="{frame_time}"))
 ```
 
+`{frame_time}` in a title shows the current year as the animation plays.
+
 The viewer interpolates between frames in the browser, with play, pause,
 scrubbing, speed, and video recording.
 
@@ -437,7 +452,9 @@ tree) is shortened to twice its width so it does not become a thin column;
 - **SolveIt** draws figures inline and hides their HTML from the model's
   context (`autohide(False)` to opt out).
 - **VS Code notebooks** block WebGL in output cells, so plot3 opens figures
-  in your browser (`PLOT3_DISPLAY=browser|iframe` to force a mode).
+  in your browser (`PLOT3_DISPLAY=browser|iframe` to force a mode). The page
+  is written to `.plot3_preview/latest.html` in the notebook's folder, or to
+  the system temp folder when that folder is read-only.
 - **CRAFT / `%gpu`**: the same `ggplot(...)` code runs on the remote kernel;
   stats run where the data lives and only a compact payload comes back.
 

{plot3-0.4.0 → plot3-0.4.1}/README.md

@@ -343,13 +343,28 @@ ggplot() + geom_function("y = sin(x - t)") + transition_time(t=(0, 6.28))   # tr
 ggplot() + geom_function("y = dbeta(x, a, b)") + slider(a=(0.5, 5), b=(0.5, 5))
 ```
 
-Data animations follow `gganimate`:
+Data animations follow `gganimate`. With a table shaped like gapminder
+(made-up numbers here; the real data is
+`pl.read_csv("https://raw.githubusercontent.com/kirenz/datasets/master/gapminder.csv")`):
 
-```python notest
-(ggplot(gapminder, aes(x="gdp", y="life", size="pop", colour="continent", group="country"))
+```python
+countries = {"Brazil": "Americas", "China": "Asia", "Egypt": "Africa",
+             "France": "Europe", "India": "Asia", "Mexico": "Americas"}
+gapminder = pd.DataFrame([
+    {"country": country, "continent": continent, "year": year,
+     "gdpPercap": 800 * (1.03 + 0.01 * i) ** (year - 1952),
+     "lifeExp": 45 + 0.35 * (year - 1952) + 2 * i,
+     "pop": 2e7 * (1.02 + 0.002 * i) ** (year - 1952)}
+    for i, (country, continent) in enumerate(countries.items())
+    for year in range(1952, 2008, 5)
+])
+
+(ggplot(gapminder, aes(x="gdpPercap", y="lifeExp", size="pop", colour="continent", group="country"))
  + geom_point() + scale_x_log10() + transition_time("year") + labs(title="{frame_time}"))
 ```
 
+`{frame_time}` in a title shows the current year as the animation plays.
+
 The viewer interpolates between frames in the browser, with play, pause,
 scrubbing, speed, and video recording.
 
@@ -404,7 +419,9 @@ tree) is shortened to twice its width so it does not become a thin column;
 - **SolveIt** draws figures inline and hides their HTML from the model's
   context (`autohide(False)` to opt out).
 - **VS Code notebooks** block WebGL in output cells, so plot3 opens figures
-  in your browser (`PLOT3_DISPLAY=browser|iframe` to force a mode).
+  in your browser (`PLOT3_DISPLAY=browser|iframe` to force a mode). The page
+  is written to `.plot3_preview/latest.html` in the notebook's folder, or to
+  the system temp folder when that folder is read-only.
 - **CRAFT / `%gpu`**: the same `ggplot(...)` code runs on the remote kernel;
   stats run where the data lives and only a compact payload comes back.
 

plot3-0.4.1/plot3/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.4.1"

{plot3-0.4.0 → plot3-0.4.1}/plot3/ggplot.py

@@ -8,6 +8,7 @@ from plot3 import scaling as _scaling
 import html as _htmlesc
 import os
 import sys
+import tempfile
 import webbrowser
 from pathlib import Path
 
@@ -545,7 +546,13 @@ class ggplot:
     ) -> Path:
         if path is None:
             out_dir = Path.cwd() / ".plot3_preview"
-            out_dir.mkdir(parents=True, exist_ok=True)
+            try:
+                out_dir.mkdir(parents=True, exist_ok=True)
+            except OSError:
+                # A kernel started in "/" or another read-only folder (VS
+                # Code does this for notebooks outside a workspace).
+                out_dir = Path(tempfile.gettempdir()) / "plot3_preview"
+                out_dir.mkdir(parents=True, exist_ok=True)
             path = out_dir / "latest.html"
         else:
             path = Path(path)

{plot3-0.4.0 → plot3-0.4.1}/plot3.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plot3
-Version: 0.4.0
+Version: 0.4.1
 Summary: ggplot2 grammar of graphics for Python: interactive WebGL figures and journal-ready PNG, SVG, and PDF
 Author: Rigoberto Leyva Salmeron
 License-Expression: MIT
@@ -376,13 +376,28 @@ ggplot() + geom_function("y = sin(x - t)") + transition_time(t=(0, 6.28))   # tr
 ggplot() + geom_function("y = dbeta(x, a, b)") + slider(a=(0.5, 5), b=(0.5, 5))
 ```
 
-Data animations follow `gganimate`:
+Data animations follow `gganimate`. With a table shaped like gapminder
+(made-up numbers here; the real data is
+`pl.read_csv("https://raw.githubusercontent.com/kirenz/datasets/master/gapminder.csv")`):
 
-```python notest
-(ggplot(gapminder, aes(x="gdp", y="life", size="pop", colour="continent", group="country"))
+```python
+countries = {"Brazil": "Americas", "China": "Asia", "Egypt": "Africa",
+             "France": "Europe", "India": "Asia", "Mexico": "Americas"}
+gapminder = pd.DataFrame([
+    {"country": country, "continent": continent, "year": year,
+     "gdpPercap": 800 * (1.03 + 0.01 * i) ** (year - 1952),
+     "lifeExp": 45 + 0.35 * (year - 1952) + 2 * i,
+     "pop": 2e7 * (1.02 + 0.002 * i) ** (year - 1952)}
+    for i, (country, continent) in enumerate(countries.items())
+    for year in range(1952, 2008, 5)
+])
+
+(ggplot(gapminder, aes(x="gdpPercap", y="lifeExp", size="pop", colour="continent", group="country"))
  + geom_point() + scale_x_log10() + transition_time("year") + labs(title="{frame_time}"))
 ```
 
+`{frame_time}` in a title shows the current year as the animation plays.
+
 The viewer interpolates between frames in the browser, with play, pause,
 scrubbing, speed, and video recording.
 
@@ -437,7 +452,9 @@ tree) is shortened to twice its width so it does not become a thin column;
 - **SolveIt** draws figures inline and hides their HTML from the model's
   context (`autohide(False)` to opt out).
 - **VS Code notebooks** block WebGL in output cells, so plot3 opens figures
-  in your browser (`PLOT3_DISPLAY=browser|iframe` to force a mode).
+  in your browser (`PLOT3_DISPLAY=browser|iframe` to force a mode). The page
+  is written to `.plot3_preview/latest.html` in the notebook's folder, or to
+  the system temp folder when that folder is read-only.
 - **CRAFT / `%gpu`**: the same `ggplot(...)` code runs on the remote kernel;
   stats run where the data lives and only a compact payload comes back.
 

{plot3-0.4.0 → plot3-0.4.1}/tests/test_payload_display.py

@@ -114,3 +114,29 @@ def test_freeze_faceted_raises(cars):
     fig = ggplot(cars, aes(x="wt", y="mpg")) + geom_point() + facet_wrap("cyl")
     with pytest.raises(ValueError, match="facet"):
         fig.freeze()
+
+
+def test_browser_preview_falls_back_when_the_folder_is_read_only(tmp_path, monkeypatch):
+    """A kernel started in a read-only folder ("/" in VS Code) still shows plots."""
+    import importlib
+    import os
+    import tempfile
+
+    gg = importlib.import_module("plot3.ggplot")
+
+    if os.name == "nt" or os.geteuid() == 0:
+        pytest.skip("needs a folder the test user cannot write to")
+    locked = tmp_path / "locked"
+    locked.mkdir()
+    locked.chmod(0o555)
+    monkeypatch.chdir(locked)
+    monkeypatch.setattr(gg.webbrowser, "open", lambda *_a, **_k: None)
+    monkeypatch.setattr(tempfile, "tempdir", str(tmp_path / "tmp"))
+    (tmp_path / "tmp").mkdir()
+    fig = ggplot({"x": [1, 2], "y": [3, 4]}, aes(x="x", y="y")) + geom_point()
+    try:
+        out = fig.show(browser=True)
+    finally:
+        locked.chmod(0o755)
+    assert out == (tmp_path / "tmp" / "plot3_preview" / "latest.html").resolve()
+    assert out.read_text(encoding="utf-8").startswith("<!")

plot3-0.4.0/plot3/__version__.py

@@ -1 +0,0 @@
-__version__ = "0.4.0"