feat: enhance draft publishing with additional metadata and update version to 0.1.20

Author: ma2za

README.md

@@ -212,7 +212,14 @@ for _, item in body.items():
     post.add(item)
 
 draft = api.post_draft(post.get_draft())
-api.put_draft(draft.get("id"), draft_section_id=post.draft_section_id)
+put_draft_kwargs = {
+    "draft_section_id": post.draft_section_id,
+    "search_engine_title": post_data.get("search_engine_title"),
+    "search_engine_description": post_data.get("search_engine_description"),
+    "slug": post_data.get("slug"),
+}
+put_draft_kwargs = {k: v for k, v in put_draft_kwargs.items() if v is not None}
+api.put_draft(draft.get("id"), **put_draft_kwargs)
 
 # Publish the draft
 api.prepublish_draft(draft.get("id"))

examples/draft.yaml

@@ -6,6 +6,12 @@ audience:
   "everyone" # everyone, only_paid, founding, only_free
 write_comment_permissions:
   "none" # none, only_paid, everyone
+search_engine_title:
+  "This is a short SEO title set via the Python API wrapper."
+search_engine_description:
+  "This is a short SEO description set via the Python API wrapper."
+slug:
+  "this-is-a-draft-post-2"
 section:
   "rick"
 tags:

examples/publish_post.py

@@ -20,7 +20,7 @@
         type=str,
     )
     parser.add_argument(
-        "--publish", help="Publish the draft.", action="store_true", default=True
+        "--publish", help="Publish the draft.", action="store_false", default=False
     )
     parser.add_argument(
         "--cookies",
@@ -38,7 +38,9 @@
 
     api = Api(
         email=os.getenv("EMAIL") if not cookies_path and not cookies_string else None,
-        password=os.getenv("PASSWORD") if not cookies_path and not cookies_string else None,
+        password=os.getenv("PASSWORD")
+        if not cookies_path and not cookies_string
+        else None,
         cookies_path=cookies_path,
         cookies_string=cookies_string,
         publication_url=os.getenv("PUBLICATION_URL"),
@@ -67,7 +69,16 @@
     draft = api.post_draft(post.get_draft())
 
     # post.set_section(post_data.get("section"), api.get_sections())
-    api.put_draft(draft.get("id"), draft_section_id=post.draft_section_id)
+    put_draft_kwargs = {
+        "draft_section_id": post.draft_section_id,
+        "search_engine_title": post_data.get("search_engine_title"),
+        "search_engine_description": post_data.get("search_engine_description"),
+        "slug": post_data.get("slug"),
+    }
+    # Remove None values so we only send fields that were explicitly provided
+    put_draft_kwargs = {k: v for k, v in put_draft_kwargs.items() if v is not None}
+
+    api.put_draft(draft.get("id"), **put_draft_kwargs)
 
     api.add_tags_to_post(draft.get("id"), post_data.get("tags", []))
 

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "python-substack"
-version = "0.1.19"
+version = "0.1.20"
 description = "A Python wrapper around the Substack API."
 authors = ["Paolo Mazza <mazzapaolo2019@gmail.com>"]
 license = "MIT"