python-substack 0.4.0__tar.gz → 0.6.0__tar.gz

{python_substack-0.4.0 → python_substack-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-substack
-Version: 0.4.0
+Version: 0.6.0
 Summary: Write and safely manage Substack drafts from Markdown with Python, CLI, and MCP.
 License: MIT
 License-File: LICENSE
@@ -23,7 +23,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Provides-Extra: mcp
 Requires-Dist: PyYAML (>=6.0,<7.0)
 Requires-Dist: fastmcp (>=3.1.1,<4.0.0) ; extra == "mcp"
-Requires-Dist: markdown-it-py (>=3.0,<4.0)
+Requires-Dist: markdown-it-py (>=3,<5)
 Requires-Dist: mdit-py-plugins (>=0.5,<0.7)
 Requires-Dist: python-dotenv (>=1.2.1,<2.0.0)
 Requires-Dist: requests (>=2.32.0,<3.0.0)
@@ -93,6 +93,7 @@ Substack result:
 - Upload local images referenced by Markdown.
 - Set audience, comment permissions, SEO metadata, slug, sections, and tags.
 - List and inspect publications and drafts.
+- Export drafts to loss-aware Markdown backups without server writes.
 - Schedule, unschedule, publish, and delete drafts with explicit safeguards.
 - Use stable JSON envelopes in scripts and automation.
 - Authenticate with browser cookies or email and password.
@@ -143,6 +144,7 @@ Inspect publications and drafts:
 substack publications list
 substack drafts list --limit 10
 substack drafts get 12345
+substack drafts export 12345 --output backup.md
 substack --publication-url https://example.substack.com drafts list
 ```
 
@@ -207,6 +209,14 @@ print(result["draft"]["id"])
 `create_draft_from_markdown` creates a draft by default. It publishes only when
 `publish=True` is passed.
 
+Back up an existing draft without modifying it:
+
+```python
+backup = api.export_draft_to_markdown(12345)
+print(backup["markdown"])
+print(backup["unsupported_nodes"])
+```
+
 For direct ProseMirror node construction, see the
 [low-level Python API](docs/low-level-api.md). YAML workflows are documented in
 [YAML drafts](docs/yaml.md).

{python_substack-0.4.0 → python_substack-0.6.0}/README.md

@@ -57,6 +57,7 @@ Substack result:
 - Upload local images referenced by Markdown.
 - Set audience, comment permissions, SEO metadata, slug, sections, and tags.
 - List and inspect publications and drafts.
+- Export drafts to loss-aware Markdown backups without server writes.
 - Schedule, unschedule, publish, and delete drafts with explicit safeguards.
 - Use stable JSON envelopes in scripts and automation.
 - Authenticate with browser cookies or email and password.
@@ -107,6 +108,7 @@ Inspect publications and drafts:
 substack publications list
 substack drafts list --limit 10
 substack drafts get 12345
+substack drafts export 12345 --output backup.md
 substack --publication-url https://example.substack.com drafts list
 ```
 
@@ -171,6 +173,14 @@ print(result["draft"]["id"])
 `create_draft_from_markdown` creates a draft by default. It publishes only when
 `publish=True` is passed.
 
+Back up an existing draft without modifying it:
+
+```python
+backup = api.export_draft_to_markdown(12345)
+print(backup["markdown"])
+print(backup["unsupported_nodes"])
+```
+
 For direct ProseMirror node construction, see the
 [low-level Python API](docs/low-level-api.md). YAML workflows are documented in
 [YAML drafts](docs/yaml.md).

{python_substack-0.4.0 → python_substack-0.6.0}/pyproject.toml

@@ -1,67 +1,67 @@
-[tool.poetry]
-name = "python-substack"
-version = "0.4.0"
-description = "Write and safely manage Substack drafts from Markdown with Python, CLI, and MCP."
-authors = ["Paolo Mazza <mazzapaolo2019@gmail.com>"]
-license = "MIT"
-packages = [
-    { include = "substack" },
-    { include = "substack_mcp" }
-]
-
-readme = "README.md"
-
-repository = "https://github.com/ma2za/python-substack"
-homepage = "https://github.com/ma2za/python-substack"
-
-keywords = ["substack", "substack-api", "cli", "newsletter", "publishing", "automation", "mcp"]
-classifiers = [
-    "Development Status :: 4 - Beta",
-    "Intended Audience :: Developers",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Topic :: Communications :: Email",
-    "Topic :: Internet :: WWW/HTTP",
-    "Topic :: Software Development :: Libraries :: Python Modules"
-]
-
-[tool.poetry.urls]
-"Documentation" = "https://ma2za.github.io/python-substack/"
-"Changelog" = "https://github.com/ma2za/python-substack/blob/main/CHANGELOG.md"
-"Issues" = "https://github.com/ma2za/python-substack/issues"
-
-[tool.poetry.dependencies]
-python = "<4.0,>=3.10"
-
-requests = "^2.32.0"
-python-dotenv = "^1.2.1"
-PyYAML = "^6.0"
-markdown-it-py = "^3.0"
-mdit-py-plugins = ">=0.5,<0.7"
-fastmcp = { version = "^3.1.1", optional = true }
-
-[tool.poetry.extras]
-mcp = ["fastmcp"]
-
-[tool.poetry.group.dev.dependencies]
-pytest = "^9.1.1"
-pre-commit = "^4.6.1"
-
-[tool.pytest.ini_options]
-markers = [
-    "live: opt-in tests that call the live Substack service",
-]
-
-[tool.poetry.scripts]
-substack = "substack.cli:main"
-substack-auth-check = "substack.cli:auth_check"
-substack-publish-markdown = "substack.cli:publish_markdown"
-substack-publish-yaml = "substack.cli:publish_yaml"
-substack-mcp = "substack_mcp.mcp_server:main"
-
-[build-system]
-requires = ["poetry-core>=1.0.0"]
-build-backend = "poetry.core.masonry.api"
+[tool.poetry]
+name = "python-substack"
+version = "0.6.0"
+description = "Write and safely manage Substack drafts from Markdown with Python, CLI, and MCP."
+authors = ["Paolo Mazza <mazzapaolo2019@gmail.com>"]
+license = "MIT"
+packages = [
+    { include = "substack" },
+    { include = "substack_mcp" }
+]
+
+readme = "README.md"
+
+repository = "https://github.com/ma2za/python-substack"
+homepage = "https://github.com/ma2za/python-substack"
+
+keywords = ["substack", "substack-api", "cli", "newsletter", "publishing", "automation", "mcp"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Email",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules"
+]
+
+[tool.poetry.urls]
+"Documentation" = "https://ma2za.github.io/python-substack/"
+"Changelog" = "https://github.com/ma2za/python-substack/blob/main/CHANGELOG.md"
+"Issues" = "https://github.com/ma2za/python-substack/issues"
+
+[tool.poetry.dependencies]
+python = "<4.0,>=3.10"
+
+requests = "^2.32.0"
+python-dotenv = "^1.2.1"
+PyYAML = "^6.0"
+markdown-it-py = ">=3,<5"
+mdit-py-plugins = ">=0.5,<0.7"
+fastmcp = { version = "^3.1.1", optional = true }
+
+[tool.poetry.extras]
+mcp = ["fastmcp"]
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^9.1.1"
+pre-commit = "^4.6.1"
+
+[tool.pytest.ini_options]
+markers = [
+    "live: opt-in tests that call the live Substack service",
+]
+
+[tool.poetry.scripts]
+substack = "substack.cli:main"
+substack-auth-check = "substack.cli:auth_check"
+substack-publish-markdown = "substack.cli:publish_markdown"
+substack-publish-yaml = "substack.cli:publish_yaml"
+substack-mcp = "substack_mcp.mcp_server:main"
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"

{python_substack-0.4.0 → python_substack-0.6.0}/substack/__init__.py

@@ -1,13 +1,13 @@
-"""A library that provides a Python interface to the Substack API."""
-
-__author__ = "Paolo Mazza"
-__email__ = "mazzapaolo2019@gmail.com"
-__license__ = "MIT License"
-__version__ = "0.4.0"
-__url__ = "https://github.com/ma2za/python-substack"
-__download_url__ = "https://pypi.python.org/pypi/python-substack"
-__description__ = (
-    "Write and safely manage Substack drafts from Markdown with Python, CLI, and MCP."
-)
-
-from .api import Api
+"""A library that provides a Python interface to the Substack API."""
+
+__author__ = "Paolo Mazza"
+__email__ = "mazzapaolo2019@gmail.com"
+__license__ = "MIT License"
+__version__ = "0.6.0"
+__url__ = "https://github.com/ma2za/python-substack"
+__download_url__ = "https://pypi.python.org/pypi/python-substack"
+__description__ = (
+    "Write and safely manage Substack drafts from Markdown with Python, CLI, and MCP."
+)
+
+from .api import Api