Skip to content

Commit 48da4d9

Browse files
pauleverittpauleveritt
committed
Add an example which loads hello world from a Python file. Centralize the config into a loaded TOML file.
1 parent 3263430 commit 48da4d9

File tree

18 files changed

+138
-194
lines changed

18 files changed

+138
-194
lines changed

‎src/psc/__main__.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ def download(
6565
with open(target / fn, "wb") as pyscript_output:
6666
pyscript_output.write(pyscript_request.data)
6767

68-
print("Downloaded PyScript")
68+
print("Downloaded PyScript")
6969

7070

7171
@app.command()

‎src/psc/app.py‎

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -73,8 +73,7 @@ async def example(request: Request) -> _TemplateResponse:
7373
title=this_example.title,
7474
subtitle=this_example.subtitle,
7575
extra_head=this_example.extra_head,
76-
main=this_example.main,
77-
extra_pyscript=this_example.extra_pyscript,
76+
body=this_example.body,
7877
request=request,
7978
),
8079
)
@@ -91,7 +90,7 @@ async def content_page(request: Request) -> _TemplateResponse:
9190
dict(
9291
title=this_page.title,
9392
subtitle=this_page.subtitle,
94-
main=this_page.body,
93+
body=this_page.body,
9594
request=request,
9695
),
9796
)

‎src/psc/gallery/examples/hello_world/index.html‎

Lines changed: 4 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,20 @@
1-
<!--
2-
contributor: example@contributor.me
3-
tags: example-tag, another-example
4-
-->
5-
61
<!DOCTYPE html>
72
<html lang="en">
83
<head>
94
<meta charset="utf-8">
105
<meta name="viewport" content="width=device-width,initial-scale=1">
116

12-
<title>Hello World Python</title>
13-
<meta name="subtitle" content="The hello world example, but in a .py file.">
7+
<title>Hello World</title>
148

159
<link rel="icon" type="image/png" href="../../../favicon.png">
1610
<script defer src="../../../pyscript/pyscript.js"></script>
1711
<link rel="stylesheet" href="hello_world.css">
1812
<script defer src="hello_world.js"></script>
1913
</head>
20-
2114
<body>
22-
<py-config>
23-
autoclose_loader = true
24-
25-
[[runtimes]]
26-
src = "../../../pyodide/pyodide.js"
27-
</py-config>
28-
<main>
29-
<h1>Hello ...</h1>
30-
<div id="output"></div>
31-
</main>
15+
<py-config src="../py_config.toml"></py-config>
16+
<h1>Hello ...</h1>
17+
<div id="output"></div>
3218
<h6>More Info</h6>
3319
<py-script>
3420
pyscript.write("output", "...world")

‎src/psc/gallery/examples/hello_world/index.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
title: Hello World
3+
subtitle: The classic hello world, but in Python -- in a browser!
4+
---
5+
The *body* description.

‎src/psc/gallery/examples/hello_world_py/index.html‎

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,7 @@
99
<meta charset="utf-8">
1010
<meta name="viewport" content="width=device-width,initial-scale=1">
1111

12-
<title>Hello World</title>
13-
<meta name="subtitle" content="The classic hello world, but in Python -- in a browser!">
12+
<title>Hello World Python</title>
1413

1514
<link rel="icon" type="image/png" href="../../../favicon.png">
1615
<script defer src="../../../pyscript/pyscript.js"></script>
@@ -19,11 +18,8 @@
1918
</head>
2019

2120
<body>
22-
<py-config>
23-
autoclose_loader = true
24-
25-
[[runtimes]]
26-
src = "../../../pyodide/pyodide.js"
21+
<py-config src="../py_config.toml">
22+
paths = ["hello_world.py"]
2723
</py-config>
2824
<main>
2925
<h1>Hello Python ...</h1>

‎src/psc/gallery/examples/hello_world_py/index.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
title: Hello World Python
3+
subtitle: The hello world example, but in a .py file.
4+
---
5+
The *body* description.

‎src/psc/gallery/examples/py_config.toml‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
autoclose_loader = true
2+
3+
[[runtimes]]
4+
src = "../../../pyodide/pyodide.js"

‎src/psc/resources.py‎

Lines changed: 15 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,6 @@
1515

1616
from psc.here import HERE
1717

18-
1918
EXCLUSIONS = ("pyscript.css", "pyscript.js", "favicon.png")
2019

2120

@@ -35,16 +34,6 @@ def tag_filter(
3534
return True
3635

3736

38-
def get_description(index_html_file: Path) -> str:
39-
"""Read an index.md if present and convert to HTML."""
40-
md_file = index_html_file.parent / "index.md"
41-
if not md_file.exists():
42-
return ""
43-
md_content = md_file.read_text()
44-
md = MarkdownIt()
45-
return str(md.render(md_content))
46-
47-
4837
def get_head_nodes(s: BeautifulSoup) -> str:
4938
"""Make post init simpler by putting head node helper here."""
5039
head_nodes = [
@@ -57,24 +46,10 @@ def get_head_nodes(s: BeautifulSoup) -> str:
5746
return ""
5847

5948

60-
def get_main_node_content(s: BeautifulSoup) -> str:
61-
"""Get the main node but raise an exception if not present."""
62-
# Moving to a helper to allow testing ValueError without needing
63-
# to ship a broken (non-main) example.
64-
main_element = s.select_one("main")
65-
if main_element is None: # pragma: no cover
66-
raise ValueError("Example file has no <main> element")
67-
return f"{main_element.decode_contents()}"
68-
69-
70-
def get_pyscript_nodes(s: BeautifulSoup) -> str:
71-
"""Find any pyscript nodes that are NOT ``py-config``."""
72-
pyscript_nodes = [
73-
pyscript.prettify()
74-
for pyscript in s.select("body > *")
75-
if pyscript and pyscript.name.startswith("py-") and pyscript.name != "py-config"
76-
]
77-
return "\n".join(pyscript_nodes)
49+
def get_body_content(s: BeautifulSoup) -> str:
50+
"""Get the body node but raise an exception if not present."""
51+
body_element = s.select_one("body")
52+
return f"{body_element.decode_contents()}"
7853

7954

8055
@dataclass
@@ -83,7 +58,7 @@ class Resource:
8358

8459
path: PurePath
8560
title: str = ""
86-
main: str = ""
61+
body: str = ""
8762
extra_head: str = ""
8863

8964

@@ -98,37 +73,25 @@ class Example(Resource):
9873
"""
9974

10075
description: str = ""
101-
extra_pyscript: str = ""
10276
subtitle: str = ""
10377

10478
def __post_init__(self) -> None:
10579
"""Extract most of the data from the HTML file."""
80+
# Title, subtitle, description come from the example's MD file.
81+
index_md_file = HERE / "gallery/examples" / self.path / "index.md"
82+
md_fm = frontmatter.load(index_md_file)
83+
self.title = md_fm.get("title", "")
84+
self.subtitle = md_fm.get("subtitle", "")
85+
md = MarkdownIt()
86+
self.description = str(md.render(md_fm.content))
87+
88+
# Main, extra head example's HTML file.
10689
index_html_file = HERE / "gallery/examples" / self.path / "index.html"
10790
if not index_html_file.exists():
10891
raise ValueError(f"No example at {self.path}")
10992
soup = BeautifulSoup(index_html_file.read_text(), "html5lib")
110-
111-
# Title
112-
title_node = soup.select_one("title")
113-
self.title = title_node.text if title_node else ""
114-
115-
# Subtitle
116-
subtitle_node = soup.select_one('meta[name="subtitle"]')
117-
assert subtitle_node # noqa
118-
subtitle = cast(str, subtitle_node.get("content", ""))
119-
self.subtitle = subtitle
120-
121-
# Description
122-
self.description = get_description(index_html_file)
123-
124-
# Head
12593
self.extra_head = get_head_nodes(soup)
126-
127-
# Main
128-
self.main = get_main_node_content(soup)
129-
130-
# Extra PyScript
131-
self.extra_pyscript = get_pyscript_nodes(soup)
94+
self.body = get_body_content(soup)
13295

13396

13497
@dataclass

‎src/psc/templates/example.jinja2‎

Lines changed: 1 addition & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,19 +3,10 @@
33
<meta name="subtitle" content="{{ subtitle }}">
44
<script defer src="{{ root_path }}/pyscript/pyscript.js"></script>
55
{{ extra_head | safe }}{% endblock %}
6-
{% block extra_body %}
7-
<py-config>
8-
autoclose_loader = true
9-
10-
[[runtimes]]
11-
src = "{{ root_path }}/pyodide/pyodide.js"
12-
</py-config>
13-
{{ extra_pyscript | safe }}
14-
{% endblock %}
156
{% block main %}
167
<main id="main_container" class="container">
178
<h1 class="title">{{ title }}</h1>
189
<h1 class="subtitle">{{ subtitle }}</h1>
19-
{{ main | safe }}
10+
<div class="content">{{ body | safe }}</div>
2011
</main>
2112
{% endblock %}

‎src/psc/templates/homepage.jinja2‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@
7777
<div class="tile is-ancestor">
7878
<div class="tile is-parent">
7979
<article class="tile is-child box">
80-
<p class="title">Hello World</p>
80+
<p class="title">xxxHello World</p>
8181
<p class="subtitle">What is up?</p>
8282
<div class="content">
8383
This is the <em>description</em> for this example.
@@ -86,7 +86,7 @@
8686
</div>
8787
<div class="tile is-parent">
8888
<article class="tile is-child box">
89-
<p class="title">Hello World</p>
89+
<p class="title">xxxHello World</p>
9090
<p class="subtitle">What is up?</p>
9191
<div class="content">
9292
This is the <em>description</em> for this example.
@@ -95,7 +95,7 @@
9595
</div>
9696
<div class="tile is-parent">
9797
<article class="tile is-child box">
98-
<p class="title">Hello World</p>
98+
<p class="title">xxxHello World</p>
9999
<p class="subtitle">What is up?</p>
100100
<div class="content">
101101
<p>This is the <em>description</em> for this example.</p>

0 commit comments

Comments
 (0)