atlassian-cli 0.10.1__tar.gz → 0.10.2__tar.gz

{atlassian_cli-0.10.1/src/atlassian_cli.egg-info → atlassian_cli-0.10.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atlassian-cli
-Version: 0.10.1
+Version: 0.10.2
 Summary: Fast CLI tools for Atlassian Cloud (Confluence + Jira) — optimized for AI agents
 Author-email: Alex Fishlock <alex.fishlock@catapult.cx>
 License-Expression: MIT
@@ -127,6 +127,36 @@ pages/
 page-index.json              # searchable index
 ```
 
+### Blog posts
+
+Create, read, update, and delete blog posts in any Confluence space.
+
+```bash
+# Create a blog post
+confluence blog-create POL "Q1 Product Update"
+confluence blog-create POL "Release Notes" --body "What's new this quarter..."
+confluence blog-create POL "Deep Dive" --file /path/to/adf.json
+
+# Download a blog post
+confluence blog-get 123456
+
+# Edit locally and upload
+confluence blog-get 123456
+# ... edit the ADF JSON file ...
+confluence blog-put 123456 --message "Added screenshots"
+
+# Update title and/or body directly
+confluence blog-update 123456 --title "Q1 Update (Revised)"
+confluence blog-update 123456 --body "Updated content here" -m "Corrections"
+
+# List blog posts in a space
+confluence blog-list POL
+confluence blog-list POL --include-draft
+
+# Delete a blog post
+confluence blog-delete 123456
+```
+
 ### Comments
 
 Read, reply to, and resolve inline and footer comments on pages.

{atlassian_cli-0.10.1 → atlassian_cli-0.10.2}/README.md

@@ -96,6 +96,36 @@ pages/
 page-index.json              # searchable index
 ```
 
+### Blog posts
+
+Create, read, update, and delete blog posts in any Confluence space.
+
+```bash
+# Create a blog post
+confluence blog-create POL "Q1 Product Update"
+confluence blog-create POL "Release Notes" --body "What's new this quarter..."
+confluence blog-create POL "Deep Dive" --file /path/to/adf.json
+
+# Download a blog post
+confluence blog-get 123456
+
+# Edit locally and upload
+confluence blog-get 123456
+# ... edit the ADF JSON file ...
+confluence blog-put 123456 --message "Added screenshots"
+
+# Update title and/or body directly
+confluence blog-update 123456 --title "Q1 Update (Revised)"
+confluence blog-update 123456 --body "Updated content here" -m "Corrections"
+
+# List blog posts in a space
+confluence blog-list POL
+confluence blog-list POL --include-draft
+
+# Delete a blog post
+confluence blog-delete 123456
+```
+
 ### Comments
 
 Read, reply to, and resolve inline and footer comments on pages.

{atlassian_cli-0.10.1 → atlassian_cli-0.10.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "atlassian-cli"
-version = "0.10.1"
+version = "0.10.2"
 description = "Fast CLI tools for Atlassian Cloud (Confluence + Jira) — optimized for AI agents"
 readme = "README.md"
 license = "MIT"

{atlassian_cli-0.10.1 → atlassian_cli-0.10.2}/src/atlassian_cli/confluence.py

@@ -1,17 +1,36 @@
 #!/usr/bin/env python3
-"""Confluence Cloud CLI — fast ADF page management via REST API v2.
+"""Confluence Cloud CLI — fast ADF page and blog-post management via REST API v2.
 
 Commands:
-    get      Download a page (ADF + metadata)
-    put      Upload local ADF to Confluence
-    diff     Compare local vs remote ADF
-    sync     Bulk-download all pages in a space
-    delete   Delete a page
-    search   Search local page index
-    index    Rebuild page-index.json from API
-    comments List inline and footer comments on a page
-    comment  Reply to a comment
-    resolve  Resolve an inline comment
+    Pages:
+        get          Download a page (ADF + metadata)
+        create       Create a new page
+        put          Upload local ADF to Confluence
+        diff         Compare local vs remote ADF
+        sync         Bulk-download all pages in a space
+        delete       Delete a page
+        move         Move a page to a new parent (optionally cross-space)
+        rename       Rename a page
+        archive      Archive a page and its descendants
+        search       Search local page index
+        index        Rebuild page-index.json from API
+    Blog Posts:
+        blog-create  Create a blog post
+        blog-get     Download a blog post (ADF + metadata)
+        blog-update  Update a blog post title and/or body
+        blog-delete  Delete a blog post
+        blog-list    List blog posts in a space
+        blog-put     Upload local ADF for a blog post
+    Comments:
+        comments     List inline and footer comments on a page
+        comment      Reply to a comment
+        resolve      Resolve an inline comment
+    Other:
+        hints        Show hints for working with ADF and Confluence macros
+        changes      Show what changed in the latest version of a page
+        approvals    List pages pending your approval
+        approve      Approve a page
+        reject       Reject a page approval
 """
 
 import argparse
@@ -94,6 +113,124 @@ def list_pages(session, base, space_id, statuses=('current',)):
     return pages
 
 
+# ---------------------------------------------------------------------------
+# Blog posts (v2)
+# ---------------------------------------------------------------------------
+
+def create_blogpost(session, base, space_id, title, *, body=None, file=None):
+    """Create a blog post in a Confluence space."""
+    body_payload = {}
+    if file:
+        with open(file) as f:
+            adf = json.load(f)
+        body_payload = {
+            'representation': 'atlas_doc_format',
+            'value': json.dumps(adf),
+        }
+    elif body:
+        body_payload = {
+            'representation': 'atlas_doc_format',
+            'value': json.dumps({
+                'type': 'doc', 'version': 1,
+                'content': [{'type': 'paragraph',
+                             'content': [{'type': 'text', 'text': body}]}],
+            }),
+        }
+
+    payload = {
+        'spaceId': space_id,
+        'title': title,
+        'status': 'current',
+    }
+    if body_payload:
+        payload['body'] = body_payload
+
+    return api_post(session, base, f'{V2}/blogposts', payload)
+
+
+def get_blogpost(session, base, blogpost_id):
+    """Fetch a single blog post with ADF body."""
+    data = api_get(session, base, f'{V2}/blogposts/{blogpost_id}',
+                   **{'body-format': 'atlas_doc_format'})
+    body = data.get('body', {}).get('atlas_doc_format', {})
+    if isinstance(body.get('value'), str):
+        try:
+            body['value'] = json.loads(body['value'])
+        except json.JSONDecodeError:
+            pass
+    return data
+
+
+def update_blogpost(session, base, blogpost_id, *,
+                    title=None, body=None, file=None, message=None):
+    """Update a blog post's title and/or body."""
+    remote = get_blogpost(session, base, blogpost_id)
+
+    new_title = title if title is not None else remote.get('title', '')
+    new_version = _ver(remote) + 1
+
+    body_payload = None
+    if file:
+        with open(file) as f:
+            adf = json.load(f)
+        body_payload = {
+            'representation': 'atlas_doc_format',
+            'value': json.dumps(adf),
+        }
+    elif body is not None:
+        body_payload = {
+            'representation': 'atlas_doc_format',
+            'value': json.dumps({
+                'type': 'doc', 'version': 1,
+                'content': [{'type': 'paragraph',
+                             'content': [{'type': 'text', 'text': body}]}],
+            }),
+        }
+    else:
+        body_value = remote.get('body', {}).get('atlas_doc_format', {}).get('value')
+        if body_value is not None:
+            body_payload = {
+                'representation': 'atlas_doc_format',
+                'value': json.dumps(body_value) if not isinstance(body_value, str) else body_value,
+            }
+
+    payload = {
+        'id': str(blogpost_id),
+        'status': 'current',
+        'title': new_title,
+        'version': {'number': new_version,
+                     'message': message or 'Updated blog post'},
+    }
+    if body_payload:
+        payload['body'] = body_payload
+
+    api_put(session, base, f'{V2}/blogposts/{blogpost_id}', payload)
+    return new_title, new_version
+
+
+def delete_blogpost(session, base, blogpost_id):
+    """Delete a blog post."""
+    api_delete(session, base, f'{V2}/blogposts/{blogpost_id}')
+
+
+def list_blogposts(session, base, space_id, statuses=('current',)):
+    """Cursor-paginated listing of blog posts in a space, filtered by status."""
+    blogposts = []
+    status_q = '&'.join(f'status={s}' for s in statuses)
+    url = f'{base}{V2}/spaces/{space_id}/blogposts?limit=250&sort=id&{status_q}'
+    while url:
+        resp = _retry(session.get, url)
+        resp.raise_for_status()
+        data = resp.json()
+        blogposts.extend(data.get('results', []))
+        next_link = data.get('_links', {}).get('next')
+        if next_link:
+            url = f'{base}{next_link}' if next_link.startswith('/') else next_link
+        else:
+            url = None
+    return blogposts
+
+
 # ---------------------------------------------------------------------------
 # Local file I/O
 # ---------------------------------------------------------------------------
@@ -309,6 +446,178 @@ def cmd_delete(args):
     emit('OK', f'Deleted {title} ({args.page_id})')
 
 
+# ---------------------------------------------------------------------------
+# Blog post commands
+# ---------------------------------------------------------------------------
+
+def _save_blogpost(page_data, space_key, pages_dir, suffix=''):
+    blogpost_id = page_data['id']
+    space_dir = os.path.join(pages_dir, space_key)
+    os.makedirs(space_dir, exist_ok=True)
+
+    body = page_data.get('body', {}).get('atlas_doc_format', {}).get('value', {})
+    filename = f'blog-{blogpost_id}{suffix}.json'
+    adf_path = os.path.join(space_dir, filename)
+    with open(adf_path, 'w') as f:
+        json.dump(body, f, indent=2)
+
+    meta = {
+        'id': blogpost_id,
+        'title': page_data.get('title', ''),
+        'spaceId': page_data.get('spaceId', ''),
+        'spaceKey': space_key,
+        'version': _ver(page_data),
+        'updatedAt': _ver_ts(page_data),
+    }
+    meta_filename = f'blog-{blogpost_id}{suffix}.meta.json'
+    meta_path = os.path.join(space_dir, meta_filename)
+    with open(meta_path, 'w') as f:
+        json.dump(meta, f, indent=2)
+
+    return adf_path, meta_path
+
+
+def _load_blog_meta(blogpost_id, pages_dir):
+    if not os.path.isdir(pages_dir):
+        return None
+    for entry in os.listdir(pages_dir):
+        candidate = os.path.join(pages_dir, entry, f'blog-{blogpost_id}.meta.json')
+        if os.path.isfile(candidate):
+            with open(candidate) as f:
+                return json.load(f)
+    return None
+
+
+def _load_blog_adf(blogpost_id, pages_dir):
+    if not os.path.isdir(pages_dir):
+        return None
+    for entry in os.listdir(pages_dir):
+        candidate = os.path.join(pages_dir, entry, f'blog-{blogpost_id}.json')
+        if os.path.isfile(candidate):
+            with open(candidate) as f:
+                return json.load(f)
+    return None
+
+
+def cmd_blog_create(args):
+    session, base = setup()
+    space = get_space(session, base, key=args.space_key)
+    space_id = space['id']
+    space_key = space.get('key', args.space_key)
+
+    result = create_blogpost(session, base, space_id, args.title,
+                             body=args.body, file=args.file)
+    blogpost_id = result['id']
+
+    if args.dir:
+        full_post = get_blogpost(session, base, blogpost_id)
+        _save_blogpost(full_post, space_key, args.dir)
+
+    emit('OK', f'Created {result.get("title", args.title)} ({blogpost_id})')
+
+
+def cmd_blog_get(args):
+    session, base = setup()
+    blogpost = get_blogpost(session, base, args.blogpost_id)
+    space = get_space(session, base, space_id=blogpost['spaceId'])
+    space_key = space.get('key', str(blogpost['spaceId']))
+    adf_path, _ = _save_blogpost(blogpost, space_key, args.dir)
+    emit('OK', f'{blogpost["title"]} (v{_ver(blogpost)}) -> {adf_path}')
+
+
+def cmd_blog_update(args):
+    session, base = setup()
+    new_title, new_version = update_blogpost(
+        session, base, args.blogpost_id,
+        title=args.title, body=args.body, file=args.file,
+        message=getattr(args, 'message', None),
+    )
+
+    if args.dir:
+        full_post = get_blogpost(session, base, args.blogpost_id)
+        space = get_space(session, base, space_id=full_post['spaceId'])
+        _save_blogpost(full_post, space.get('key', ''), args.dir)
+
+    emit('OK', f'Updated blog post {args.blogpost_id} -> {new_title!r} (v{new_version})')
+
+
+def cmd_blog_delete(args):
+    session, base = setup()
+    blogpost = get_blogpost(session, base, args.blogpost_id)
+    title = blogpost.get('title', args.blogpost_id)
+    delete_blogpost(session, base, args.blogpost_id)
+    emit('OK', f'Deleted blog post {title} ({args.blogpost_id})')
+
+
+def cmd_blog_list(args):
+    session, base = setup()
+    space = get_space(session, base, key=args.space_key)
+    space_id = space['id']
+    space_key = space.get('key', args.space_key)
+
+    statuses = ('current',) if not getattr(args, 'include_draft', False) else ('current', 'draft')
+    blogposts = list_blogposts(session, base, space_id, statuses=statuses)
+
+    if is_json_mode():
+        emit_json([{
+            'id': b['id'],
+            'title': b.get('title', ''),
+            'version': _ver(b),
+            'updatedAt': _ver_ts(b),
+            'status': b.get('status', 'current'),
+        } for b in blogposts])
+    else:
+        for b in blogposts:
+            print(f'{b["id"]} [{b.get("status", "current")}] {b.get("title", "")}  (v{_ver(b)})')
+        emit('DONE', f'{len(blogposts)} blog post(s) in {space_key}')
+
+
+def cmd_blog_put(args):
+    session, base = setup()
+
+    meta = _load_blog_meta(args.blogpost_id, args.dir)
+    if not meta:
+        emit_error(f'No local metadata for blog post {args.blogpost_id}')
+        sys.exit(1)
+    adf = _load_blog_adf(args.blogpost_id, args.dir)
+    if not adf:
+        emit_error(f'No local ADF for blog post {args.blogpost_id}')
+        sys.exit(1)
+
+    remote = get_blogpost(session, base, args.blogpost_id)
+    remote_ver = _ver(remote)
+    local_ver = meta.get('version', 0)
+
+    if not args.force and remote_ver != local_ver:
+        emit_error(f'Version conflict: local v{local_ver}, remote v{remote_ver}. Use --force to overwrite.')
+        sys.exit(1)
+
+    new_version = remote_ver + 1
+    payload = {
+        'id': str(args.blogpost_id),
+        'status': 'current',
+        'title': meta['title'],
+        'body': {
+            'representation': 'atlas_doc_format',
+            'value': json.dumps(adf),
+        },
+        'version': {
+            'number': new_version,
+            'message': getattr(args, 'message', None) or 'Updated via confluence CLI',
+        },
+    }
+    result = api_put(session, base, f'{V2}/blogposts/{args.blogpost_id}', payload)
+
+    meta['version'] = new_version
+    meta['updatedAt'] = _ver_ts(result)
+    space_key = meta.get('spaceKey', '')
+    meta_path = os.path.join(args.dir, space_key, f'blog-{args.blogpost_id}.meta.json')
+    with open(meta_path, 'w') as f:
+        json.dump(meta, f, indent=2)
+
+    emit('OK', f'{meta["title"]} updated to v{new_version}')
+
+
 def cmd_put(args):
     session, base = setup()
 
@@ -995,6 +1304,46 @@ def main():
     p.add_argument('page_id', help='Confluence page ID')
     p.set_defaults(func=cmd_delete)
 
+    # -- blog posts ----------------------------------------------------------
+
+    p = sub.add_parser('blog-create', help='Create a blog post')
+    p.add_argument('space_key', help='Space key (e.g. POL, COMPLY)')
+    p.add_argument('title', help='Blog post title')
+    p.add_argument('--body', help='Plain text body')
+    p.add_argument('--file', '-f', help='ADF JSON file for blog body')
+    p.add_argument('--dir', default='pages', help='Pages directory (default: pages)')
+    p.set_defaults(func=cmd_blog_create)
+
+    p = sub.add_parser('blog-get', help='Download a blog post (ADF + metadata)')
+    p.add_argument('blogpost_id', help='Blog post ID')
+    p.add_argument('--dir', default='pages', help='Output directory (default: pages)')
+    p.set_defaults(func=cmd_blog_get)
+
+    p = sub.add_parser('blog-update', help='Update a blog post title and/or body')
+    p.add_argument('blogpost_id', help='Blog post ID')
+    p.add_argument('--title', help='New title')
+    p.add_argument('--body', help='New plain text body')
+    p.add_argument('--file', '-f', help='ADF JSON file for new blog body')
+    p.add_argument('--message', '-m', help='Version message')
+    p.add_argument('--dir', default='pages', help='Pages directory (default: pages)')
+    p.set_defaults(func=cmd_blog_update)
+
+    p = sub.add_parser('blog-delete', help='Delete a blog post')
+    p.add_argument('blogpost_id', help='Blog post ID')
+    p.set_defaults(func=cmd_blog_delete)
+
+    p = sub.add_parser('blog-list', help='List blog posts in a space')
+    p.add_argument('space_key', help='Space key (e.g. POL, COMPLY)')
+    p.add_argument('--include-draft', action='store_true', help='Include draft blog posts')
+    p.set_defaults(func=cmd_blog_list)
+
+    p = sub.add_parser('blog-put', help='Upload local ADF for a blog post')
+    p.add_argument('blogpost_id', help='Blog post ID')
+    p.add_argument('--dir', default='pages', help='Pages directory (default: pages)')
+    p.add_argument('--force', action='store_true', help='Skip version conflict check')
+    p.add_argument('--message', '-m', help='Version message (shown in history)')
+    p.set_defaults(func=cmd_blog_put)
+
     p = sub.add_parser('move', help='Move a page to a new parent (preserves body); '
                                     'optionally to a different space')
     p.add_argument('page_id', help='Confluence page ID to move')

{atlassian_cli-0.10.1 → atlassian_cli-0.10.2/src/atlassian_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atlassian-cli
-Version: 0.10.1
+Version: 0.10.2
 Summary: Fast CLI tools for Atlassian Cloud (Confluence + Jira) — optimized for AI agents
 Author-email: Alex Fishlock <alex.fishlock@catapult.cx>
 License-Expression: MIT
@@ -127,6 +127,36 @@ pages/
 page-index.json              # searchable index
 ```
 
+### Blog posts
+
+Create, read, update, and delete blog posts in any Confluence space.
+
+```bash
+# Create a blog post
+confluence blog-create POL "Q1 Product Update"
+confluence blog-create POL "Release Notes" --body "What's new this quarter..."
+confluence blog-create POL "Deep Dive" --file /path/to/adf.json
+
+# Download a blog post
+confluence blog-get 123456
+
+# Edit locally and upload
+confluence blog-get 123456
+# ... edit the ADF JSON file ...
+confluence blog-put 123456 --message "Added screenshots"
+
+# Update title and/or body directly
+confluence blog-update 123456 --title "Q1 Update (Revised)"
+confluence blog-update 123456 --body "Updated content here" -m "Corrections"
+
+# List blog posts in a space
+confluence blog-list POL
+confluence blog-list POL --include-draft
+
+# Delete a blog post
+confluence blog-delete 123456
+```
+
 ### Comments
 
 Read, reply to, and resolve inline and footer comments on pages.

{atlassian_cli-0.10.1 → atlassian_cli-0.10.2}/tests/test_confluence.py

@@ -12,12 +12,20 @@ from atlassian_cli.confluence import (
     _make_adf_body,
     _ver,
     _ver_ts,
+    cmd_blog_create,
+    cmd_blog_delete,
+    cmd_blog_get,
+    cmd_blog_list,
+    cmd_blog_update,
     cmd_diff,
     cmd_get,
     cmd_index,
     cmd_search,
+    create_blogpost,
+    get_blogpost,
     get_page,
     get_space,
+    list_blogposts,
     list_comment_replies,
     list_comments,
     list_pages,
@@ -26,6 +34,7 @@ from atlassian_cli.confluence import (
     reply_to_comment,
     resolve_comment,
     save_page,
+    update_blogpost,
 )
 from atlassian_cli.output import set_json_mode
 
@@ -388,3 +397,195 @@ class TestCmdIndex:
         with open(output_path) as f:
             index = json.load(f)
         assert len(index["TEST"]) == 1
+
+
+# ---------------------------------------------------------------------------
+# Blog post tests
+# ---------------------------------------------------------------------------
+
+BLOG_SAMPLE = {
+    "id": "55555",
+    "title": "Test Blog Post",
+    "spaceId": "100",
+    "status": "current",
+    "version": {"number": 1, "createdAt": "2025-02-01T10:00:00Z"},
+    "body": {
+        "atlas_doc_format": {
+            "value": {"type": "doc", "version": 1, "content": [
+                {"type": "paragraph", "content": [{"type": "text", "text": "Blog content"}]}
+            ]},
+        },
+    },
+}
+
+
+class TestCreateBlogpost:
+    @responses.activate
+    def test_creates_blogpost(self, mock_session):
+        responses.add(
+            responses.POST, f"{BASE}{V2}/blogposts",
+            json=BLOG_SAMPLE,
+        )
+        result = create_blogpost(mock_session, BASE, "100", "Test Blog Post",
+                                 body="Blog content")
+        assert result["id"] == "55555"
+        assert result["title"] == "Test Blog Post"
+
+    @responses.activate
+    def test_creates_with_file(self, mock_session, tmp_path):
+        adf_file = tmp_path / "blog.adf.json"
+        adf_file.write_text(json.dumps(BLOG_SAMPLE["body"]["atlas_doc_format"]["value"]))
+        responses.add(
+            responses.POST, f"{BASE}{V2}/blogposts",
+            json=BLOG_SAMPLE,
+        )
+        result = create_blogpost(mock_session, BASE, "100", "Test Blog Post",
+                                 file=str(adf_file))
+        assert result["id"] == "55555"
+
+
+class TestGetBlogpost:
+    @responses.activate
+    def test_fetches_blogpost(self, mock_session):
+        responses.add(
+            responses.GET, f"{BASE}{V2}/blogposts/55555",
+            json=BLOG_SAMPLE,
+        )
+        result = get_blogpost(mock_session, BASE, "55555")
+        assert result["id"] == "55555"
+        assert isinstance(result["body"]["atlas_doc_format"]["value"], dict)
+
+
+class TestListBlogposts:
+    @responses.activate
+    def test_lists_blogposts(self, mock_session):
+        responses.add(
+            responses.GET, f"{BASE}{V2}/spaces/100/blogposts",
+            json={"results": [BLOG_SAMPLE], "_links": {}},
+        )
+        result = list_blogposts(mock_session, BASE, "100")
+        assert len(result) == 1
+        assert result[0]["id"] == "55555"
+
+
+class TestCmdBlogCreate:
+    @responses.activate
+    def test_creates_blogpost(self, capsys, tmp_path):
+        responses.add(
+            responses.GET, f"{BASE}{V2}/spaces",
+            json={"results": [SAMPLE_SPACE]},
+        )
+        responses.add(
+            responses.POST, f"{BASE}{V2}/blogposts",
+            json=BLOG_SAMPLE,
+        )
+        responses.add(
+            responses.GET, f"{BASE}{V2}/blogposts/55555",
+            json=BLOG_SAMPLE,
+        )
+        responses.add(
+            responses.GET, f"{BASE}{V2}/spaces/100",
+            json=SAMPLE_SPACE,
+        )
+        cmd_blog_create(Namespace(
+            space_key="TEST", title="Test Blog Post",
+            body="Blog content", file=None,
+            dir=str(tmp_path),
+        ))
+        out = capsys.readouterr().out
+        assert "Test Blog Post" in out
+        assert os.path.isfile(os.path.join(str(tmp_path), "TEST", "blog-55555.json"))
+
+
+class TestCmdBlogGet:
+    @responses.activate
+    def test_downloads_blogpost(self, capsys, tmp_path):
+        responses.add(
+            responses.GET, f"{BASE}{V2}/blogposts/55555",
+            json=BLOG_SAMPLE,
+        )
+        responses.add(
+            responses.GET, f"{BASE}{V2}/spaces/100",
+            json=SAMPLE_SPACE,
+        )
+        cmd_blog_get(Namespace(blogpost_id="55555", dir=str(tmp_path)))
+        out = capsys.readouterr().out
+        assert "Test Blog Post" in out
+        assert os.path.isfile(os.path.join(str(tmp_path), "TEST", "blog-55555.json"))
+
+
+class TestCmdBlogDelete:
+    @responses.activate
+    def test_deletes_blogpost(self, capsys):
+        responses.add(
+            responses.GET, f"{BASE}{V2}/blogposts/55555",
+            json=BLOG_SAMPLE,
+        )
+        responses.add(
+            responses.DELETE, f"{BASE}{V2}/blogposts/55555",
+            status=204,
+        )
+        cmd_blog_delete(Namespace(blogpost_id="55555"))
+        out = capsys.readouterr().out
+        assert "Deleted blog post" in out
+
+
+class TestCmdBlogList:
+    @responses.activate
+    def test_lists_blogposts(self, capsys):
+        responses.add(
+            responses.GET, f"{BASE}{V2}/spaces",
+            json={"results": [SAMPLE_SPACE]},
+        )
+        responses.add(
+            responses.GET, f"{BASE}{V2}/spaces/100/blogposts",
+            json={"results": [BLOG_SAMPLE], "_links": {}},
+        )
+        cmd_blog_list(Namespace(space_key="TEST"))
+        out = capsys.readouterr().out
+        assert "Test Blog Post" in out
+        assert "1 blog post(s)" in out
+
+
+class TestCmdBlogUpdate:
+    @responses.activate
+    def test_updates_blogpost(self, capsys, tmp_path):
+        responses.add(
+            responses.GET, f"{BASE}{V2}/blogposts/55555",
+            json=BLOG_SAMPLE,
+        )
+        responses.add(
+            responses.PUT, f"{BASE}{V2}/blogposts/55555",
+            json={**BLOG_SAMPLE, "title": "Updated Title",
+                  "version": {"number": 2, "createdAt": "2025-02-02T10:00:00Z"}},
+        )
+        responses.add(
+            responses.GET, f"{BASE}{V2}/spaces/100",
+            json=SAMPLE_SPACE,
+        )
+        cmd_blog_update(Namespace(
+            blogpost_id="55555", title="Updated Title",
+            body=None, file=None,
+            dir=str(tmp_path),
+        ))
+        out = capsys.readouterr().out
+        assert "Updated Title" in out
+        assert "(v2)" in out
+
+
+class TestUpdateBlogpost:
+    @responses.activate
+    def test_updates_title_and_body(self, mock_session):
+        responses.add(
+            responses.GET, f"{BASE}{V2}/blogposts/55555",
+            json=BLOG_SAMPLE,
+        )
+        responses.add(
+            responses.PUT, f"{BASE}{V2}/blogposts/55555",
+            json={**BLOG_SAMPLE, "title": "New Title",
+                  "version": {"number": 2, "createdAt": "2025-02-02T10:00:00Z"}},
+        )
+        title, ver = update_blogpost(mock_session, BASE, "55555",
+                                     title="New Title", body="New body")
+        assert title == "New Title"
+        assert ver == 2