Tweaks to make images + shelves look good on retina displays
[books.alexwlchan.net] / scripts / render_html.py
index 051befc..c9f11e3 100755 (executable)
@@ -1,14 +1,23 @@
-#!/usr/bin/env python
+#!/usr/bin/env python3
 
 
+import datetime
+import hashlib
+import itertools
 import os
 import pathlib
 import os
 import pathlib
+import re
 import subprocess
 import sys
 
 import attr
 import frontmatter
 import subprocess
 import sys
 
 import attr
 import frontmatter
-import markdown
 from jinja2 import Environment, FileSystemLoader, select_autoescape
 from jinja2 import Environment, FileSystemLoader, select_autoescape
+import markdown
+from markdown.extensions.smarty import SmartyExtension
+import smartypants
+
+from generate_bookshelf import create_shelf_data_uri
+from tint_colors import get_tint_colors, store_tint_color
 
 
 def rsync(dir1, dir2):
 
 
 def rsync(dir1, dir2):
@@ -20,17 +29,20 @@ class Book:
     title = attr.ib()
     author = attr.ib()
     publication_year = attr.ib()
     title = attr.ib()
     author = attr.ib()
     publication_year = attr.ib()
-    cover_image = attr.ib()
-    cover_desc = attr.ib()
+    cover_image = attr.ib(default="")
+    cover_desc = attr.ib(default="")
 
 
-    isbn_13 = attr.ib(default="")
+    isbn10 = attr.ib(default="")
+    isbn13 = attr.ib(default="")
 
 
 @attr.s
 class Review:
     date_read = attr.ib()
 
 
 @attr.s
 class Review:
     date_read = attr.ib()
-    rating = attr.ib()
     text = attr.ib()
     text = attr.ib()
+    format = attr.ib(default=None)
+    rating = attr.ib(default=None)
+    did_not_finish = attr.ib(default=False)
 
 
 @attr.s
 
 
 @attr.s
@@ -39,18 +51,80 @@ class ReviewEntry:
     book = attr.ib()
     review = attr.ib()
 
     book = attr.ib()
     review = attr.ib()
 
+    def out_path(self):
+        name = self.path.with_suffix("").name
+        return pathlib.Path(f"reviews/{name}")
+
 
 def get_review_entry_from_path(path):
     post = frontmatter.load(path)
 
 
 def get_review_entry_from_path(path):
     post = frontmatter.load(path)
 
-    book = Book(**post["book"])
+    kwargs = {}
+    for attr_name in Book.__attrs_attrs__:
+        try:
+            kwargs[attr_name.name] = post["book"][attr_name.name]
+        except KeyError:
+            pass
+
+    book = Book(**kwargs)
+
     review = Review(**post["review"], text=post.content)
 
     return ReviewEntry(path=path, book=book, review=review)
 
 
     review = Review(**post["review"], text=post.content)
 
     return ReviewEntry(path=path, book=book, review=review)
 
 
-def get_reviews():
-    for dirpath, _, filenames in os.walk("src/reviews"):
+@attr.s
+class CurrentlyReading:
+    text = attr.ib()
+
+
+@attr.s
+class CurrentlyReadingEntry:
+    path = attr.ib()
+    book = attr.ib()
+    reading = attr.ib()
+
+
+def get_reading_entry_from_path(path):
+    post = frontmatter.load(path)
+
+    book = Book(**post["book"])
+    reading = CurrentlyReading(text=post.content)
+
+    return CurrentlyReadingEntry(path=path, book=book, reading=reading)
+
+
+def _parse_date(value):
+    if isinstance(value, datetime.date):
+        return value
+    else:
+        return datetime.datetime.strptime(value, "%Y-%m-%d").date()
+
+
+@attr.s
+class Plan:
+    text = attr.ib()
+    date_added = attr.ib(converter=_parse_date)
+
+
+@attr.s
+class PlanEntry:
+    path = attr.ib()
+    book = attr.ib()
+    plan = attr.ib()
+
+
+def get_plan_entry_from_path(path):
+    post = frontmatter.load(path)
+
+    book = Book(**post["book"])
+    plan = Plan(date_added=post["plan"]["date_added"], text=post.content)
+
+    return PlanEntry(path=path, book=book, plan=plan)
+
+
+def get_entries(dirpath, constructor):
+    for dirpath, _, filenames in os.walk(dirpath):
         for f in filenames:
             if not f.endswith(".md"):
                 continue
         for f in filenames:
             if not f.endswith(".md"):
                 continue
@@ -58,37 +132,229 @@ def get_reviews():
             path = pathlib.Path(dirpath) / f
 
             try:
             path = pathlib.Path(dirpath) / f
 
             try:
-                yield get_review_entry_from_path(path)
+                yield constructor(path)
             except Exception:
                 print(f"Error parsing {path}", file=sys.stderr)
                 raise
 
 
 def render_markdown(text):
             except Exception:
                 print(f"Error parsing {path}", file=sys.stderr)
                 raise
 
 
 def render_markdown(text):
-    return markdown.markdown(text)
+    return markdown.markdown(text, extensions=[SmartyExtension()])
 
 
 
 
-if __name__ == "__main__":
-    all_reviews = list(get_reviews())
-    all_reviews = sorted(
-        all_reviews, key=lambda rev: rev.review.date_read, reverse=True
+def render_date(date_value):
+    if isinstance(date_value, datetime.date):
+        return date_value.strftime("%-d %B %Y")
+
+    date_match = re.match(
+        r"^(?P<year>\d{4})-(?P<month>\d{2})(?:-(?P<day>\d{2}))?$", date_value
+    )
+    assert date_match is not None, date_value
+
+    date_obj = datetime.datetime(
+        year=int(date_match.group("year")),
+        month=int(date_match.group("month")),
+        day=int(date_match.group("day") or "1"),
+    )
+
+    if date_match.group("day"):
+        return render_date(date_obj)
+    else:
+        return date_obj.strftime("%B %Y")
+
+
+def render_individual_review(env, *, review_entry, **kwargs):
+    template = env.get_template("review.html")
+    html = template.render(
+        review_entry=review_entry,
+        title=f"My review of {review_entry.book.title}",
+        **kwargs
     )
 
     )
 
+    out_name = review_entry.out_path() / "index.html"
+    out_path = pathlib.Path("_html") / out_name
+    out_path.parent.mkdir(exist_ok=True, parents=True)
+    out_path.write_text(html)
+
+
+def _create_new_thumbnail(src_path, dst_path):
+    dst_path.parent.mkdir(exist_ok=True, parents=True)
+
+    # Thumbnails are 240x240 max, then 2x for retina displays
+    subprocess.check_call([
+        "convert", src_path, "-resize", "480x480>", dst_path
+    ])
+
+
+def thumbnail_1x(name):
+    pth = pathlib.Path(name)
+    return pth.stem + "_1x" + pth.suffix
+
+
+def _create_new_square(src_path, square_path):
+    square_path.parent.mkdir(exist_ok=True, parents=True)
+
+    subprocess.check_call([
+        "convert",
+        src_path, "-resize", "240x240", "-gravity", "center", "-background", "white", "-extent", "240x240", square_path
+    ])
+
+
+def create_thumbnails():
+    for image_name in os.listdir("src/covers"):
+        if image_name == ".DS_Store":
+            continue
+
+        src_path = pathlib.Path("src/covers") / image_name
+        dst_path = pathlib.Path("_html/thumbnails") / image_name
+
+        if not dst_path.exists():
+            _create_new_thumbnail(src_path, dst_path)
+        elif src_path.stat().st_mtime > dst_path.stat().st_mtime:
+            _create_new_thumbnail(src_path, dst_path)
+
+        square_path = pathlib.Path("_html/squares") / image_name
+
+        if not square_path.exists():
+            _create_new_square(src_path, square_path)
+        elif src_path.stat().st_mtime > square_path.stat().st_mtime:
+            _create_new_square(src_path, square_path)
+
+        store_tint_color(dst_path)
+
+
+CSS_HASH = hashlib.md5(open('static/style.css', 'rb').read()).hexdigest()
+
+
+def css_hash(_):
+    return f"md5:{CSS_HASH}"
+
+
+def main():
     env = Environment(
         loader=FileSystemLoader("templates"),
         autoescape=select_autoescape(["html", "xml"]),
     )
 
     env.filters["render_markdown"] = render_markdown
     env = Environment(
         loader=FileSystemLoader("templates"),
         autoescape=select_autoescape(["html", "xml"]),
     )
 
     env.filters["render_markdown"] = render_markdown
+    env.filters["render_date"] = render_date
+    env.filters["smartypants"] = smartypants.smartypants
+    env.filters["thumbnail_1x"] = thumbnail_1x
+    env.filters["css_hash"] = css_hash
+    env.filters["create_shelf_data_uri"] = create_shelf_data_uri
+
+    create_thumbnails()
+
+    tint_colors = get_tint_colors()
 
     rsync("src/covers/", "_html/covers/")
 
     rsync("src/covers/", "_html/covers/")
-    rsync("src/static/", "_html/static/")
+    rsync("static/", "_html/static/")
+
+    # Render the "all reviews page"
+
+    all_reviews = list(
+        get_entries(dirpath="src/reviews", constructor=get_review_entry_from_path)
+    )
+    all_reviews = sorted(
+        all_reviews, key=lambda rev: str(rev.review.date_read), reverse=True
+    )
 
     for review_entry in all_reviews:
 
     for review_entry in all_reviews:
-        template = env.get_template("review.html")
-        html = template.render(review_entry=review_entry)
+        render_individual_review(
+            env,
+            review_entry=review_entry,
+            tint_colors=tint_colors
+        )
+
+    template = env.get_template("list_reviews.html")
+    html = template.render(
+        all_reviews=[
+            (year, list(reviews))
+            for (year, reviews) in itertools.groupby(
+                all_reviews, key=lambda rev: str(rev.review.date_read)[:4]
+            )
+        ],
+        title="books i’ve read",
+        this_year=str(datetime.datetime.now().year),
+        tint_colors=tint_colors,
+    )
 
 
-        out_name = review_entry.path.relative_to("src").with_suffix(".html")
-        out_path = pathlib.Path("_html") / out_name
-        out_path.parent.mkdir(exist_ok=True, parents=True)
-        out_path.write_text(html)
+    out_path = pathlib.Path("_html") / "reviews/index.html"
+    out_path.write_text(html)
+
+    # Render the "currently reading" page
+
+    all_reading = list(
+        get_entries(
+            dirpath="src/currently_reading", constructor=get_reading_entry_from_path
+        )
+    )
+
+    template = env.get_template("list_reading.html")
+    html = template.render(
+        all_reading=all_reading,
+        title="books i’m currently reading",
+        tint_colors=tint_colors
+    )
+
+    out_path = pathlib.Path("_html") / "reading/index.html"
+    out_path.parent.mkdir(exist_ok=True, parents=True)
+    out_path.write_text(html)
+
+    # Render the "want to read" page
+
+    all_plans = list(
+        get_entries(dirpath="src/plans", constructor=get_plan_entry_from_path)
+    )
+
+    all_plans = sorted(all_plans, key=lambda plan: plan.plan.date_added, reverse=True)
+
+    template = env.get_template("list_plans.html")
+    html = template.render(
+        all_plans=all_plans,
+        title="books i want to read",
+        tint_colors=tint_colors,
+    )
+
+    out_path = pathlib.Path("_html") / "to-read/index.html"
+    out_path.parent.mkdir(exist_ok=True, parents=True)
+    out_path.write_text(html)
+
+    # Render the "never going to read this page"
+
+    all_retired = list(
+        get_entries(dirpath="src/will_never_read", constructor=get_plan_entry_from_path)
+    )
+
+    all_retired = sorted(
+        all_retired, key=lambda plan: plan.plan.date_added, reverse=True
+    )
+
+    template = env.get_template("list_will_never_read.html")
+    html = template.render(
+        all_retired=all_retired,
+        title="books i&rsquo;m never going to read",
+        tint_colors=tint_colors
+    )
+
+    out_path = pathlib.Path("_html") / "will-never-read/index.html"
+    out_path.parent.mkdir(exist_ok=True, parents=True)
+    out_path.write_text(html)
+
+    # Render the front page
+
+    index_template = env.get_template("index.html")
+    html = index_template.render(
+        text=open("src/index.md").read(),
+        reviews=all_reviews[:5],
+        tint_colors=tint_colors
+    )
+
+    index_path = pathlib.Path("_html") / "index.html"
+    index_path.write_text(html)
+
+    print("✨ Rendered HTML files to _html ✨")
+
+
+if __name__ == "__main__":
+    main()