A route for authors and author.

Author: pauleveritt

src/psc/app.py

@@ -20,7 +20,6 @@
 from psc.resources import Resources
 from psc.resources import get_resources
 
-
 templates = Jinja2Templates(directory=HERE / "templates")
 
 
@@ -61,6 +60,40 @@ async def gallery(request: Request) -> _TemplateResponse:
     )
 
 
+async def authors(request: Request) -> _TemplateResponse:
+    """Handle the author listing page."""
+    these_authors: Iterator[Example] = request.app.state.resources.authors.values()
+    root_path = ".."
+
+    return templates.TemplateResponse(
+        "authors.jinja2",
+        dict(
+            title="Authors",
+            authors=these_authors,
+            root_path=root_path,
+            request=request,
+        ),
+    )
+
+
+async def author(request: Request) -> _TemplateResponse:
+    """Handle an author page."""
+    author_path = PurePath(request.path_params["author_name"])
+    resources: Resources = request.app.state.resources
+    this_author = resources.authors[author_path]
+    root_path = "../../.."
+
+    return templates.TemplateResponse(
+        "example.jinja2",
+        dict(
+            title=this_author.title,
+            body=this_author.body,
+            request=request,
+            root_path=root_path,
+        ),
+    )
+
+
 async def example(request: Request) -> _TemplateResponse:
     """Handle an example page."""
     example_path = PurePath(request.path_params["example_name"])
@@ -113,6 +146,9 @@ async def content_page(request: Request) -> _TemplateResponse:
     Route("/favicon.png", favicon),
     Route("/gallery/index.html", gallery),
     Route("/gallery", gallery),
+    Route("/authors/index.html", authors),
+    Route("/authors", authors),
+    Route("/authors/{author_name}.html", author),
     Route("/gallery/examples/{example_name}/index.html", example),
     Route("/gallery/examples/{example_name}/", example),
     Route("/pages/{page_name}.html", content_page),

src/psc/resources.py

@@ -90,18 +90,17 @@ class Example(Resource):
     Meaning, HERE / "examples" / name / "index.html".
     """
 
-    description: str = ""
     subtitle: str = ""
 
     def __post_init__(self) -> None:
         """Extract most of the data from the HTML file."""
-        # Title, subtitle, description come from the example's MD file.
+        # Title, subtitle, body come from the example's MD file.
         index_md_file = HERE / "gallery/examples" / self.path / "index.md"
         md_fm = frontmatter.load(index_md_file)
         self.title = md_fm.get("title", "")
         self.subtitle = md_fm.get("subtitle", "")
         md = MarkdownIt()
-        self.description = str(md.render(md_fm.content))
+        self.body = str(md.render(md_fm.content))
 
         # Main, extra head example's HTML file.
         index_html_file = HERE / "gallery/examples" / self.path / "index.html"

src/psc/templates/author.jinja2

@@ -0,0 +1,8 @@
+{% extends "layout.jinja2" %}
+{% block extra_head %}
+{% block main %}
+    <main id="main_container" class="container">
+        <h1 class="title">{{ title }}</h1>
+        <div class="content">{{ body | safe }}</div>
+    </main>
+{% endblock %}

src/psc/templates/authors.jinja2

@@ -0,0 +1,29 @@
+{% extends "layout.jinja2" %}
+{% block main %}
+    <section class="hero is-small is-dark">
+        <div class="hero-body">
+            <p class="title">
+                PyScript Authors
+            </p>
+            <p class="subtitle">
+                All the contributors to authors and more.
+            </p>
+        </div>
+    </section>
+    <main id="main_container" class="container">
+        <div class="tile is-ancestor">
+            {% for author in authors %}
+                <div class="tile is-parent is-4">
+                    <article class="tile is-child box">
+                        <p class="title"><a
+                                href="{{ root_path }}/authors/{{ author.path.name }}.html/">{{ author.title }}</a>
+                        </p>
+                        <div class="content">
+                            {{ author.body | safe }}
+                        </div>
+                    </article>
+                </div>
+            {% endfor %}
+        </div>
+    </main>
+{% endblock %}

src/psc/templates/gallery.jinja2

@@ -20,7 +20,7 @@
                         </p>
                         <p class="subtitle">{{ example.subtitle }}</p>
                         <div class="content">
-                            {{ example.description | safe }}
+                            {{ example.body | safe }}
                         </div>
                     </article>
                 </div>

src/psc/templates/layout.jinja2

@@ -26,6 +26,9 @@
             <a id="navbarGallery" class="navbar-item" href="{{ root_path }}/gallery">
                 Gallery
             </a>
+            <a id="navbarAuthors" class="navbar-item" href="{{ root_path }}/authors">
+                Authors
+            </a>
             <a id="navbarJoin" class="navbar-item" href="{{ root_path }}/pages/contributing.html">
                 Join
             </a>

tests/test_author_pages.py

@@ -0,0 +1,22 @@
+"""Use the routes to render listing of authors and each one."""
+from psc.fixtures import PageT
+
+
+def test_authors_page(client_page: PageT) -> None:
+    """The listing of authors works."""
+    soup = client_page("/authors/index.html")
+    page_title = soup.select_one("title")
+    assert page_title and "Authors | PyScript Collective" == page_title.text
+
+    authors = soup.select_one("article.tile p.title")
+    assert "Margaret" == authors.text.strip()
+
+
+def test_author_page(client_page: PageT) -> None:
+    """The page for an author works."""
+    soup = client_page("/authors/meg-1.html")
+    page_title = soup.select_one("title")
+    assert page_title and "Margaret | PyScript Collective" == page_title.text
+
+    author = soup.select_one("main h1")
+    assert "Margaret" == author.text.strip()