#!/usr/bin/env python3
"""
Yeah. Right! — Daily Static Site Generator
Reads today's content from a CSV file and publishes a new HTML page.
Regenerates the archive index and search index on every run.
No external dependencies — uses Python standard library only.
"""
import csv
import json
import logging
import os
import sys
from datetime import date
from config import (
CONTENT_FILE, OUTPUT_DIR, SITE_DESCRIPTION, SITE_NAME, SITE_URL,
)
# ── Logging ───────────────────────────────────────────────────────────────────
logging.basicConfig(
filename=os.path.join(os.path.dirname(os.path.abspath(__file__)), "generator.log"),
level=logging.INFO,
format="%(asctime)s [%(levelname)s] %(message)s",
datefmt="%Y-%m-%d %H:%M:%S",
)
log = logging.getLogger(__name__)
# ── HTML templates ────────────────────────────────────────────────────────────
BASE_CSS = """
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
body {
font-family: Georgia, 'Times New Roman', serif;
background: #f0f0eb;
color: #1a1a1a;
line-height: 1.7;
padding: 2rem 1rem;
}
.site-header {
max-width: 680px;
margin: 0 auto 3rem;
border-bottom: 1px solid #e0e0d8;
padding-bottom: 1.25rem;
display: flex;
align-items: flex-start;
gap: 1.1rem;
}
.logo-badge {
display: inline-flex;
align-items: center;
justify-content: center;
border: 2px solid #1a1a1a;
border-radius: 4px;
padding: 0.2rem 0.45rem;
font-size: 3rem;
font-weight: bold;
font-family: Georgia, 'Times New Roman', serif;
letter-spacing: 0.02em;
color: #1a1a1a;
text-decoration: none;
line-height: 1;
flex-shrink: 0;
margin-top: 0.2rem;
}
.logo-badge:hover { background: #1a1a1a; color: #f0f0eb; }
.site-header-text a { text-decoration: none; color: inherit; }
.site-title { font-size: 1.4rem; font-weight: bold; letter-spacing: -0.01em; }
.site-desc { font-size: 0.9rem; color: #666; margin-top: 0.2rem; }
main { max-width: 680px; margin: 0 auto; }
footer {
max-width: 680px;
margin: 3rem auto 0;
padding-top: 1.25rem;
border-top: 1px solid #e0e0d8;
font-size: 0.85rem;
color: #888;
}
footer a { color: #555; }
nav { display: flex; gap: 1.2rem; margin-top: 0.5rem; }
nav a { font-size: 0.88rem; color: #555; text-decoration: none; }
nav a:hover { text-decoration: underline; }
"""
POST_TEMPLATE = """
{date_long} \u2014 {site_name}
"""
INDEX_TEMPLATE = """
Archive \u2014 {site_name}
Archive
"""
SEARCH_TEMPLATE = """
Search \u2014 {site_name}
Search
"""
# ── Helpers ───────────────────────────────────────────────────────────────────
def ensure_output_dir():
os.makedirs(OUTPUT_DIR, exist_ok=True)
MONTHS = [
"January", "February", "March", "April", "May", "June",
"July", "August", "September", "October", "November", "December"
]
DATE_FORMATS = [
"%Y-%m-%d", # 2026-08-01 (intended)
"%d/%m/%Y", # 01/08/2026 (Australian Excel)
"%d/%m/%y", # 01/08/26
"%m/%d/%Y", # 08/01/2026 (US Excel)
"%m/%d/%y", # 08/01/26
"%d-%m-%Y", # 01-08-2026
"%d-%m-%y", # 01-08-26
"%Y/%m/%d", # 2026/08/01
]
def parse_date(raw: str):
"""Try every known format and return a date object, or None on failure."""
from datetime import datetime
raw = raw.strip()
for fmt in DATE_FORMATS:
try:
return datetime.strptime(raw, fmt).date()
except ValueError:
continue
return None
def format_date_long(d) -> str:
"""Convert a date object to e.g. 'August 1, 2026'."""
return f"{MONTHS[d.month - 1]} {d.day}, {d.year}"
def load_all_posts() -> list:
"""Load all rows from the CSV that have a date on or before today."""
today = date.today()
posts = []
skipped = 0
with open(CONTENT_FILE, newline="", encoding="utf-8-sig") as f:
reader = csv.DictReader(f)
for row in reader:
raw_date = row["date"].strip()
content = row["content"].strip()
if not raw_date or not content:
continue
d = parse_date(raw_date)
if d is None:
log.warning(f"Could not parse date '{raw_date}' — row skipped.")
skipped += 1
continue
if d > today:
continue
iso = d.strftime("%Y-%m-%d")
posts.append({
"date_iso": iso,
"date_long": format_date_long(d),
"filename": f"{iso}.html",
"content": content,
})
if skipped:
log.warning(f"{skipped} row(s) skipped due to unrecognised date format.")
posts.sort(key=lambda p: p["date_iso"], reverse=True)
return posts
def write_post(post: dict, prev_post, next_post):
prev_link = (
f'← {prev_post["date_long"]}'
if prev_post else ""
)
next_link = (
f'{next_post["date_long"]} →'
if next_post else ""
)
html = POST_TEMPLATE.format(
site_name=SITE_NAME,
site_url=SITE_URL,
date_long=post["date_long"],
content=post["content"],
prev_link=prev_link,
next_link=next_link,
)
path = os.path.join(OUTPUT_DIR, post["filename"])
with open(path, "w", encoding="utf-8") as f:
f.write(html)
def write_archive(posts: list):
items = []
for p in posts:
excerpt = p["content"][:120] + ("\u2026" if len(p["content"]) > 120 else "")
items.append(
f' \n'
f' {p["date_long"]}\n'
f' '
f'{excerpt}\n'
f' '
)
html = INDEX_TEMPLATE.format(
css=BASE_CSS,
site_name=SITE_NAME,
site_description=SITE_DESCRIPTION,
site_url=SITE_URL,
items="\n".join(items),
)
with open(os.path.join(OUTPUT_DIR, "archive.html"), "w", encoding="utf-8") as f:
f.write(html)
def write_homepage(posts: list):
"""Write index.html as today's post — the first entry in the sorted list."""
today = posts[0]
prev_post = posts[1] if len(posts) > 1 else None
prev_link = (
f'← {prev_post["date_long"]}'
if prev_post else ""
)
html = POST_TEMPLATE.format(
site_name=SITE_NAME,
site_url=SITE_URL,
date_long=today["date_long"],
content=today["content"],
prev_link=prev_link,
next_link="",
)
with open(os.path.join(OUTPUT_DIR, "index.html"), "w", encoding="utf-8") as f:
f.write(html)
def write_search_page():
html = SEARCH_TEMPLATE.format(
css=BASE_CSS,
site_name=SITE_NAME,
site_description=SITE_DESCRIPTION,
site_url=SITE_URL,
)
with open(os.path.join(OUTPUT_DIR, "search.html"), "w", encoding="utf-8") as f:
f.write(html)
def write_search_index(posts: list):
index = [
{"date_long": p["date_long"], "filename": p["filename"], "content": p["content"]}
for p in posts
]
with open(os.path.join(OUTPUT_DIR, "search-index.json"), "w", encoding="utf-8") as f:
json.dump(index, f, ensure_ascii=False, indent=2)
# ── Main ──────────────────────────────────────────────────────────────────────
def main():
log.info("── Daily site generation started ───────────────")
ensure_output_dir()
try:
posts = load_all_posts()
except FileNotFoundError:
log.error(f"Content file not found: {CONTENT_FILE}")
sys.exit(1)
except Exception as e:
log.error(f"Failed to load content file: {e}")
sys.exit(1)
if not posts:
log.warning("No posts to publish yet.")
sys.exit(0)
# Write all posts with correct prev/next navigation
for i, post in enumerate(posts):
prev_post = posts[i + 1] if i + 1 < len(posts) else None
next_post = posts[i - 1] if i > 0 else None
write_post(post, prev_post, next_post)
write_homepage(posts)
write_archive(posts)
write_search_page()
write_search_index(posts)
log.info(f"Done. {len(posts)} post(s) live. Homepage, archive, and search updated.")
if __name__ == "__main__":
main()