npm - @sdelsad/commodity-desk-daily - Versions diffs - 1.0.18 → 1.13.2 - Mend

@sdelsad/commodity-desk-daily 1.0.18 → 1.13.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

package/STYLE.md +439 -0
package/__pycache__/build_page.cpython-314.pyc +0 -0
package/__pycache__/chart.cpython-314.pyc +0 -0
package/build_email.py +773 -0
package/build_page.py +1237 -0
package/build_post.py +291 -0
package/chart.py +563 -0
package/conversions.md +156 -0
package/curriculum.md +294 -0
package/ep01.md +144 -0
package/ep01.mp3 +0 -0
package/ep01.script.txt +71 -0
package/ep02.md +141 -0
package/ep02.script.txt +70 -0
package/ep03.md +163 -0
package/ep03.script.txt +61 -0
package/ep04.md +192 -0
package/ep04.mp3 +0 -0
package/ep04.script.txt +69 -0
package/feed.xml +3 -15
package/fetch_context.py +123 -0
package/generate_audio.py +120 -0
package/package.json +1 -1
package/publish_episode.py +367 -0
package/setup.sh +23 -0

package/build_post.py ADDED Viewed

@@ -0,0 +1,291 @@
+#!/usr/bin/env python3
+"""
+Soft Commodity Trading toolkit — essay builder.
+The site's Writing section reads `writing/index.json` from the bucket. This
+renders one essay to `writing/<slug>.html`, upserts its entry in that manifest
+and rebuilds `writing/index.html`, so publishing a piece is three uploads and
+no hand-written HTML.
+    python3 build_post.py --notes essay.md --slug basis-is-a-verb \
+        --title "Basis Is a Verb" \
+        --dek "One sentence under the headline." \
+        --date "14 August 2026" --outdir writing
+Writes:
+    writing/basis-is-a-verb.html    the essay
+    writing/index.json              the manifest the site reads
+    writing/index.html              the standalone index of everything
+Publish all three with the connector's publish_asset, at those exact paths:
+    publish_asset(path="writing/basis-is-a-verb.html", ...)
+    publish_asset(path="writing/index.json", content_type="application/json")
+    publish_asset(path="writing/index.html", ...)
+The essay uses the same renderer, palette and typography as the episode pages,
+so the reading surfaces match. Zero runtime dependencies.
+"""
+import argparse
+import html
+import json
+import os
+import re
+import sys
+try:
+    import build_page as bp
+except ImportError:
+    sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+    import build_page as bp
+SITE_URL = bp.SITE_URL
+BUCKET = bp.BUCKET
+WRITING_URL = f"{BUCKET}/writing"
+AUTHOR = bp.AUTHOR
+def read_time(md):
+    words = len(re.findall(r"\S+", re.sub(r"```.*?```", "", md, flags=re.DOTALL)))
+    return max(1, round(words / 230))
+POST_TEMPLATE = """<!DOCTYPE html>
+<html lang="en" data-theme="light">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>{title} · Sébastien Delsad</title>
+<meta name="description" content="{dek_attr}">
+<meta name="author" content="{author}">
+<link rel="canonical" href="{url}">
+<meta property="og:type" content="article">
+<meta property="og:title" content="{title}">
+<meta property="og:description" content="{dek_attr}">
+<meta property="og:url" content="{url}">
+<meta property="og:image" content="{ogimage}">
+<meta property="article:published_time" content="{iso}">
+<meta name="twitter:card" content="summary_large_image">
+<meta name="twitter:image" content="{ogimage}">
+<meta name="theme-color" content="#faf7f1" media="(prefers-color-scheme: light)">
+<meta name="theme-color" content="#14110e" media="(prefers-color-scheme: dark)">
+<link rel="icon" href="{favicon}">
+<script type="application/ld+json">
+{jsonld}
+</script>
+<style>{css}</style>
+<script>{headjs}</script>
+</head>
+<body>
+<div id="bar" aria-hidden="true"></div>
+<button class="themebtn" type="button" aria-label="Switch colour theme">
+  <svg class="moon" viewBox="0 0 24 24" aria-hidden="true"><path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z"/></svg>
+  <svg class="sun" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="4.2"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg>
+  <span class="lbl"></span>
+</button>
+<div class="wrap">
+<header>
+  <div class="masthead">
+    <a href="{site}">Sébastien Delsad</a>
+    <span class="epno">Writing</span>
+  </div>
+  <h1>{title}</h1>
+  {dekblock}
+  <div class="meta">{date}{datesep}<b>{minutes} min read</b></div>
+{toc}
+</header>
+<main>
+{body}
+</main>
+<nav class="epnav" aria-label="More">
+  <a class="epprev" href="index.html"><span class="dir">← All writing</span>
+    <span class="ept">Essays</span></a>
+  <a class="epnext" href="{site}"><span class="dir">Home →</span>
+    <span class="ept">Sébastien Delsad</span></a>
+</nav>
+<footer>
+  <span class="sig"><b>Sébastien Delsad</b> — commodity trading &amp; data science.</span>
+  <span><a href="{site}">Home</a> · <a href="{feed}">Podcast RSS</a></span>
+</footer>
+</div>
+<script>{js}</script>
+</body>
+</html>
+"""
+INDEX_TEMPLATE = """<!DOCTYPE html>
+<html lang="en" data-theme="light">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Writing · Sébastien Delsad</title>
+<meta name="description" content="Essays on commodity trading, data science and the machinery behind the daily briefing.">
+<link rel="canonical" href="{url}">
+<meta property="og:type" content="website">
+<meta property="og:title" content="Writing · Sébastien Delsad">
+<meta property="og:description" content="Essays on commodity trading, data science and the machinery behind the daily briefing.">
+<meta property="og:url" content="{url}">
+<meta property="og:image" content="{ogimage}">
+<meta name="twitter:card" content="summary_large_image">
+<meta name="theme-color" content="#faf7f1" media="(prefers-color-scheme: light)">
+<meta name="theme-color" content="#14110e" media="(prefers-color-scheme: dark)">
+<link rel="icon" href="{favicon}">
+<style>{css}
+  .postlist{{list-style:none;margin:36px 0 0;padding:0}}
+  .postlist li{{border-top:1px solid var(--line);padding:26px 0}}
+  .postlist li:last-child{{border-bottom:1px solid var(--line)}}
+  .postlist .pm{{font:12px/1 var(--sans);letter-spacing:.12em;text-transform:uppercase;
+                color:var(--ink-soft);margin:0 0 9px}}
+  .postlist h2{{font:400 25px/1.25 var(--serif);color:var(--ink);margin:0 0 8px;
+               border:none;padding:0;font-variant-caps:normal;letter-spacing:-.015em}}
+  .postlist h2 a{{text-decoration:none;color:inherit;
+                 border-bottom:1px solid var(--line)}}
+  .postlist h2 a:hover{{border-color:var(--gold)}}
+  .postlist p{{color:var(--ink-soft);margin:0;font-size:17px}}
+  .nothing{{border:1px dashed var(--line);border-radius:12px;padding:28px 24px;
+           margin-top:32px;color:var(--ink-soft)}}
+  .nothing p{{margin:0 0 10px}} .nothing p:last-child{{margin:0}}
+</style>
+<script>{headjs}</script>
+</head>
+<body>
+<button class="themebtn" type="button" aria-label="Switch colour theme">
+  <svg class="moon" viewBox="0 0 24 24" aria-hidden="true"><path d="M21 12.8A9 9 0 1 1 11.2 3a7 7 0 0 0 9.8 9.8z"/></svg>
+  <svg class="sun" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="4.2"/><path d="M12 2v2M12 20v2M4.9 4.9l1.4 1.4M17.7 17.7l1.4 1.4M2 12h2M20 12h2M4.9 19.1l1.4-1.4M17.7 6.3l1.4-1.4"/></svg>
+  <span class="lbl"></span>
+</button>
+<div class="wrap">
+<header>
+  <div class="masthead">
+    <a href="{site}">Sébastien Delsad</a>
+    <span class="epno">Writing</span>
+  </div>
+  <h1>Essays</h1>
+  <p class="dek">Longer pieces that are not tied to a day's market — notes on
+    method, on the machinery behind the shows, and on whatever the reading
+    turns up.</p>
+</header>
+<main>
+{list}
+</main>
+<footer>
+  <span class="sig"><b>Sébastien Delsad</b> — commodity trading &amp; data science.</span>
+  <span><a href="{site}">Home</a> · <a href="{feed}">Podcast RSS</a></span>
+</footer>
+</div>
+<script>{js}</script>
+</body>
+</html>
+"""
+def load_manifest(path):
+    if not os.path.exists(path):
+        return []
+    try:
+        data = json.load(open(path, encoding="utf-8"))
+    except (ValueError, OSError):
+        return []
+    posts = data if isinstance(data, list) else data.get("posts", [])
+    return [p for p in posts if isinstance(p, dict) and p.get("slug")]
+def sort_posts(posts):
+    return sorted(posts, key=lambda p: (bp.iso_date(p.get("date", "")) or "", p["slug"]),
+                  reverse=True)
+def index_html(posts):
+    if not posts:
+        return ('<div class="nothing"><p><strong>Nothing published yet.</strong> '
+                'The first essay is still in draft.</p>'
+                '<p>In the meantime, every episode of <a href="' + SITE_URL +
+                '">Soft Commodity Trading</a> carries a written edition — the '
+                'same lesson, recomposed for the eye.</p></div>')
+    items = []
+    for p in posts:
+        meta = " · ".join(x for x in (p.get("date", ""),
+                                      f"{p['minutes']} min read" if p.get("minutes") else "")
+                          if x)
+        items.append(
+            f'<li>{f"<p class=\'pm\'>{html.escape(meta)}</p>" if meta else ""}'
+            f'<h2><a href="{html.escape(p["slug"])}.html">'
+            f'{html.escape(p.get("title", p["slug"]))}</a></h2>'
+            + (f'<p>{html.escape(p["dek"])}</p>' if p.get("dek") else "")
+            + "</li>")
+    return f'<ol class="postlist">{"".join(items)}</ol>'
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument("--notes", help="the essay in markdown; omit to only "
+                                    "rebuild the index from the manifest")
+    ap.add_argument("--slug", default="", help="the filename, without .html")
+    ap.add_argument("--title", default="")
+    ap.add_argument("--dek", default="")
+    ap.add_argument("--date", default="", help='e.g. "14 August 2026"')
+    ap.add_argument("--minutes", type=int, default=0)
+    ap.add_argument("--outdir", default="writing")
+    args = ap.parse_args()
+    os.makedirs(args.outdir, exist_ok=True)
+    manifest_path = os.path.join(args.outdir, "index.json")
+    posts = load_manifest(manifest_path)
+    if args.notes:
+        if not args.slug or not args.title:
+            print("--slug and --title are required with --notes", file=sys.stderr)
+            return 1
+        md = open(args.notes, encoding="utf-8").read()
+        md = re.sub(r"\A\s*#\s+.*?\n", "", md, count=1)      # the page has a header
+        body = bp.tidy_rules(bp.render(md))
+        minutes = args.minutes or read_time(md)
+        iso = bp.iso_date(args.date)
+        url = f"{WRITING_URL}/{args.slug}.html"
+        data = {
+            "@context": "https://schema.org", "@type": "BlogPosting",
+            "headline": args.title, "url": url,
+            "description": args.dek or args.title,
+            "author": {"@type": "Person", "name": AUTHOR},
+            "image": f"{BUCKET}/og.png",
+            "wordCount": len(re.findall(r"\S+", md)),
+        }
+        if iso:
+            data["datePublished"] = iso
+        page = POST_TEMPLATE.format(
+            title=html.escape(args.title),
+            dek_attr=html.escape(args.dek or args.title, quote=True),
+            dekblock=(f'<p class="dek">{html.escape(args.dek)}</p>'
+                      if args.dek.strip() else ""),
+            date=html.escape(args.date), datesep=" · " if args.date else "",
+            minutes=minutes, url=url, iso=iso, site=SITE_URL, feed=bp.FEED_URL,
+            ogimage=f"{BUCKET}/og.png", favicon=bp.FAVICON,
+            author=html.escape(AUTHOR, quote=True),
+            jsonld=json.dumps(data, ensure_ascii=False, indent=2),
+            css=bp.CSS, js=bp.JS, headjs=bp.HEAD_JS, toc=bp.toc_html(), body=body)
+        out = os.path.join(args.outdir, f"{args.slug}.html")
+        open(out, "w", encoding="utf-8").write(page)
+        print(f"[post] {out} | {len(page):,} bytes")
+        posts = [p for p in posts if p["slug"] != args.slug]
+        posts.append({"slug": args.slug, "title": args.title, "dek": args.dek,
+                      "date": args.date, "minutes": minutes})
+    posts = sort_posts(posts)
+    with open(manifest_path, "w", encoding="utf-8") as fh:
+        json.dump(posts, fh, ensure_ascii=False, indent=2)
+        fh.write("\n")
+    print(f"[post] {manifest_path} | {len(posts)} post(s)")
+    idx = INDEX_TEMPLATE.format(
+        url=f"{WRITING_URL}/index.html", site=SITE_URL, feed=bp.FEED_URL,
+        ogimage=f"{BUCKET}/og.png", favicon=bp.FAVICON,
+        css=bp.CSS, js=bp.JS, headjs=bp.HEAD_JS, list=index_html(posts))
+    idx_path = os.path.join(args.outdir, "index.html")
+    open(idx_path, "w", encoding="utf-8").write(idx)
+    print(f"[post] {idx_path} | {len(idx):,} bytes")
+    return 0
+if __name__ == "__main__":
+    sys.exit(main())