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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atlassian-cli
-Version: 0.10.2
+Version: 0.10.4
 Summary: Fast CLI tools for Atlassian Cloud (Confluence + Jira) — optimized for AI agents
 Author-email: Alex Fishlock <alex.fishlock@catapult.cx>
 License-Expression: MIT
@@ -136,6 +136,7 @@ Create, read, update, and delete blog posts in any Confluence space.
 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
+confluence blog-create POL "Retrospective" --body "..." --created-at 2024-01-15T10:00:00Z
 
 # Download a blog post
 confluence blog-get 123456
@@ -148,6 +149,7 @@ 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"
+confluence blog-update 123456 --created-at "2024-06-01T08:00:00Z"
 
 # List blog posts in a space
 confluence blog-list POL

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

@@ -105,6 +105,7 @@ Create, read, update, and delete blog posts in any Confluence space.
 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
+confluence blog-create POL "Retrospective" --body "..." --created-at 2024-01-15T10:00:00Z
 
 # Download a blog post
 confluence blog-get 123456
@@ -117,6 +118,7 @@ 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"
+confluence blog-update 123456 --created-at "2024-06-01T08:00:00Z"
 
 # List blog posts in a space
 confluence blog-list POL

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

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

{atlassian_cli-0.10.2 → atlassian_cli-0.10.4}/src/atlassian_cli/adf.py

@@ -17,6 +17,7 @@ Provides:
 """
 
 import re
+import uuid
 
 from atlas_doc_parser.api import NodeDoc
 
@@ -297,22 +298,63 @@ def _to_list_item(item):
     return {'type': 'listItem', 'content': [para(str(item))]}
 
 
-def table(header_cells, rows):
-    """Create a table. header_cells/rows: lists of strings or inline-node lists."""
-    def cell(val, is_header=False):
+def table(header_cells, rows, *, colwidths=None, localid=None):
+    """Create a table. header_cells/rows: lists of strings or inline-node lists.
+
+    Args:
+        header_cells: Column headings (strings or inline-node lists).
+        rows: Body rows, each a list of cell values.
+        colwidths: Optional list of column widths (int/float). If omitted,
+                   divides 900 equally.
+        localid: Optional table-level UUID. If omitted, generated.
+    """
+    n_cols = len(header_cells)
+    if colwidths is None:
+        colwidths = [round(900.0 / n_cols, 1)] * n_cols
+
+    def _uuid():
+        return str(uuid.uuid4())
+
+    def cell(val, col_idx, is_header=False, row_localid=None):
         ct = 'tableHeader' if is_header else 'tableCell'
+        colwidth = colwidths[col_idx] if col_idx < len(colwidths) else colwidths[-1]
+        attrs = {'colspan': 1, 'colwidth': colwidth, 'rowspan': 1}
         if isinstance(val, str):
-            return {'type': ct, 'attrs': {}, 'content': [para(val)]}
-        if isinstance(val, list):
-            return {'type': ct, 'attrs': {}, 'content': [para(*val)]}
-        return {'type': ct, 'attrs': {}, 'content': [para(str(val))]}
-
-    content = [{'type': 'tableRow', 'content': [cell(c, True) for c in header_cells]}]
-    for row in rows:
-        content.append({'type': 'tableRow', 'content': [cell(c) for c in row]})
+            content_nodes = [para(val)]
+        elif isinstance(val, list):
+            content_nodes = [para(*val)]
+        else:
+            content_nodes = [para(str(val))]
+        node = {
+            'type': ct,
+            'attrs': attrs,
+            'content': content_nodes,
+            'localId': _uuid(),
+        }
+        return node
+
+    tbl_localid = localid or _uuid()
+
+    content = [
+        {
+            'type': 'tableRow',
+            'content': [cell(c, ci, is_header=True) for ci, c in enumerate(header_cells)],
+            'localId': _uuid(),
+        }
+    ]
+    for ri, row in enumerate(rows):
+        row_localid = _uuid()
+        cells = []
+        for ci, c in enumerate(row):
+            cells.append(cell(c, ci, is_header=False))
+        content.append({
+            'type': 'tableRow',
+            'content': cells,
+            'localId': row_localid,
+        })
     return {
         'type': 'table',
-        'attrs': {'isNumberColumnEnabled': False, 'layout': 'default', 'localId': ''},
+        'attrs': {'isNumberColumnEnabled': False, 'layout': 'default', 'localId': tbl_localid},
         'content': content,
     }
 
@@ -342,8 +384,8 @@ def md_to_adf(markdown):
     """Convert a markdown string to a list of ADF nodes.
 
     Supports: headings, paragraphs, bullet/ordered lists, bold, italic,
-    bold+italic, inline code, links, horizontal rules, code blocks, blockquotes.
-    Tables should use the table() builder instead.
+    bold+italic, inline code, links, horizontal rules, code blocks, blockquotes,
+    tables (newline-separated and inline-flattened forms).
     """
     lines = markdown.split('\n')
     nodes = []
@@ -414,17 +456,129 @@ def md_to_adf(markdown):
             ]})
             continue
 
+        # Table (newline-separated Form A)
+        if line.startswith('|'):
+            tbl_result = _try_parse_table(lines, i)
+            if tbl_result:
+                nodes.append(tbl_result[0])
+                i = tbl_result[1]
+                continue
+
         # Paragraph — consecutive non-blank, non-block lines
         para_lines = []
         while i < len(lines) and lines[i].strip() and not _is_block_start(lines[i]):
             para_lines.append(lines[i])
             i += 1
         if para_lines:
-            nodes.append({'type': 'paragraph', 'content': _parse_inline(' '.join(para_lines))})
+            joined = ' '.join(para_lines)
+            # Table (inline-flattened Form B) — detect inside paragraph
+            if _looks_like_inline_table(joined):
+                tbl_node = _parse_inline_table(joined)
+                if tbl_node:
+                    nodes.append(tbl_node)
+                    continue
+            nodes.append({'type': 'paragraph', 'content': _parse_inline(joined)})
 
     return nodes
 
 
+_SEP_RE = re.compile(r'^:?-+:?$')
+
+
+def _is_separator_row(cell_texts):
+    """Return True if every non-empty cell matches the separator pattern."""
+    return all(_SEP_RE.match(c.strip()) for c in cell_texts if c.strip())
+
+
+def _split_row(line):
+    """Split a ``|...|...|`` markdown table row into cell strings."""
+    parts = line.strip().split('|')
+    # first and last are empty (leading/trailing pipe)
+    if parts and parts[0] == '':
+        parts = parts[1:]
+    if parts and parts[-1] == '':
+        parts = parts[:-1]
+    return [p.strip() for p in parts]
+
+
+def _looks_like_inline_table(text_str):
+    """Check if a single-line paragraph looks like a flattened markdown table."""
+    # Must contain a separator pattern: |---| somewhere
+    if not re.search(r'\|\s*:?-{3,}:?\s*\|', text_str):
+        return False
+    # Must have at least 2 pipes (3 cells minimum after split)
+    return text_str.count('|') >= 4
+
+
+def _parse_inline_table(text_str):
+    """Parse an inline-flattened markdown table into an ADF table node.
+
+    Row boundaries are ``|`` followed by whitespace then ``|`` (closing pipe
+    of one row immediately followed by opening pipe of the next).
+    """
+    raw_rows = re.split(r'\|\s+(?=\|)', text_str)
+    return _build_table_from_rows(raw_rows)
+
+
+def _try_parse_table(lines, start):
+    """Try to parse a newline-separated markdown table starting at *start*.
+
+    Returns ``(table_node, new_index)`` or ``None`` if not a valid table.
+    """
+    i = start
+    raw_rows = []
+    while i < len(lines) and lines[i].strip().startswith('|'):
+        raw_rows.append(lines[i].strip())
+        i += 1
+
+    if len(raw_rows) < 2:
+        return None
+    # The second row must be a separator
+    cells = _split_row(raw_rows[1])
+    if not _is_separator_row(cells):
+        return None
+
+    return _build_table_from_rows(raw_rows), i
+
+
+def _build_table_from_rows(raw_rows):
+    """Build an ADF table node from a list of ``|...|`` row strings.
+
+    First row = header, second row = separator (dropped), remainder = body.
+    """
+    if len(raw_rows) < 2:
+        return None
+
+    header_cells = _split_row(raw_rows[0])
+    n_cols = len(header_cells)
+
+    body_cells = []
+    for ri in range(2, len(raw_rows)):
+        row = _split_row(raw_rows[ri])
+        if not any(r.strip() for r in row):
+            continue
+        if len(row) < n_cols:
+            row.extend([''] * (n_cols - len(row)))
+        elif len(row) > n_cols:
+            row = row[:n_cols]
+        body_cells.append(row)
+
+    # Parse inline content for header cells, add strong mark
+    parsed_header = []
+    for h in header_cells:
+        inlines = _parse_inline(h)
+        for node in inlines:
+            if node.get('type') == 'text':
+                node.setdefault('marks', []).insert(0, {'type': 'strong'})
+        parsed_header.append(inlines)
+
+    parsed_body = []
+    for row in body_cells:
+        parsed_body.append([_parse_inline(c) for c in row])
+
+    return table(parsed_header, parsed_body)
+
+
 def _is_block_start(line):
     if re.match(r'^#{1,6}\s', line):
         return True

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

@@ -117,7 +117,8 @@ def list_pages(session, base, space_id, statuses=('current',)):
 # Blog posts (v2)
 # ---------------------------------------------------------------------------
 
-def create_blogpost(session, base, space_id, title, *, body=None, file=None):
+def create_blogpost(session, base, space_id, title, *, body=None, file=None,
+                    created_at=None):
     """Create a blog post in a Confluence space."""
     body_payload = {}
     if file:
@@ -144,6 +145,8 @@ def create_blogpost(session, base, space_id, title, *, body=None, file=None):
     }
     if body_payload:
         payload['body'] = body_payload
+    if created_at is not None:
+        payload['createdAt'] = created_at
 
     return api_post(session, base, f'{V2}/blogposts', payload)
 
@@ -162,8 +165,9 @@ def get_blogpost(session, base, blogpost_id):
 
 
 def update_blogpost(session, base, blogpost_id, *,
-                    title=None, body=None, file=None, message=None):
-    """Update a blog post's title and/or body."""
+                    title=None, body=None, file=None, message=None,
+                    created_at=None):
+    """Update a blog post's title, body, and/or creation date."""
     remote = get_blogpost(session, base, blogpost_id)
 
     new_title = title if title is not None else remote.get('title', '')
@@ -203,6 +207,8 @@ def update_blogpost(session, base, blogpost_id, *,
     }
     if body_payload:
         payload['body'] = body_payload
+    if created_at is not None:
+        payload['createdAt'] = created_at
 
     api_put(session, base, f'{V2}/blogposts/{blogpost_id}', payload)
     return new_title, new_version
@@ -506,7 +512,8 @@ def cmd_blog_create(args):
     space_key = space.get('key', args.space_key)
 
     result = create_blogpost(session, base, space_id, args.title,
-                             body=args.body, file=args.file)
+                             body=args.body, file=args.file,
+                             created_at=getattr(args, 'created_at', None))
     blogpost_id = result['id']
 
     if args.dir:
@@ -531,6 +538,7 @@ def cmd_blog_update(args):
         session, base, args.blogpost_id,
         title=args.title, body=args.body, file=args.file,
         message=getattr(args, 'message', None),
+        created_at=getattr(args, 'created_at', None),
     )
 
     if args.dir:
@@ -1311,6 +1319,7 @@ def main():
     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('--created-at', help='Creation date (ISO 8601, e.g. 2024-01-15T10:00:00Z)')
     p.add_argument('--dir', default='pages', help='Pages directory (default: pages)')
     p.set_defaults(func=cmd_blog_create)
 
@@ -1324,6 +1333,7 @@ def main():
     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('--created-at', help='Override creation date (ISO 8601, e.g. 2024-01-15T10:00:00Z)')
     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)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atlassian-cli
-Version: 0.10.2
+Version: 0.10.4
 Summary: Fast CLI tools for Atlassian Cloud (Confluence + Jira) — optimized for AI agents
 Author-email: Alex Fishlock <alex.fishlock@catapult.cx>
 License-Expression: MIT
@@ -136,6 +136,7 @@ Create, read, update, and delete blog posts in any Confluence space.
 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
+confluence blog-create POL "Retrospective" --body "..." --created-at 2024-01-15T10:00:00Z
 
 # Download a blog post
 confluence blog-get 123456
@@ -148,6 +149,7 @@ 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"
+confluence blog-update 123456 --created-at "2024-06-01T08:00:00Z"
 
 # List blog posts in a space
 confluence blog-list POL

{atlassian_cli-0.10.2 → atlassian_cli-0.10.4}/tests/test_adf.py

@@ -492,3 +492,124 @@ More text.
         assert 'Test' in md_out
         assert 'world' in md_out
         assert 'item one' in md_out
+
+
+# ---------------------------------------------------------------------------
+# md_to_adf — table support
+# ---------------------------------------------------------------------------
+
+class TestMdToAdfTables:
+    def test_md_table_standard(self):
+        """Newline-separated markdown table produces valid ADF table."""
+        md = "\n".join([
+            "| Header 1 | Header 2 | Header 3 |",
+            "| --- | --- | --- |",
+            "| a | b | c |",
+            "| d | e | f |",
+        ])
+        nodes = md_to_adf(md)
+        assert len(nodes) == 1
+        t = nodes[0]
+        assert t['type'] == 'table'
+        assert 'localId' in t['attrs']
+        assert t['attrs']['localId'] != ''
+        rows = t['content']
+        assert len(rows) == 3  # header + 2 data, separator dropped
+        assert rows[0]['type'] == 'tableRow'
+        assert 'localId' in rows[0]
+        assert rows[0]['localId'] != ''
+        hdr = rows[0]['content'][0]
+        assert hdr['type'] == 'tableHeader'
+        assert 'localId' in hdr
+        assert hdr['localId'] != ''
+        hdr_text = hdr['content'][0]['content'][0]
+        assert hdr_text['marks'][0]['type'] == 'strong'
+        body_cell = rows[1]['content'][0]
+        assert body_cell['type'] == 'tableCell'
+        assert body_cell['localId'] != ''
+        assert 'colwidth' in body_cell['attrs']
+
+    def test_md_table_inline_flattened(self):
+        """Inline-flattened table (bug we hit) produces same ADF table."""
+        md = "| Header 1 | Header 2 | Header 3 | | --- | --- | --- | | a | b | c | | d | e | f |"
+        nodes = md_to_adf(md)
+        assert len(nodes) == 1
+        t = nodes[0]
+        assert t['type'] == 'table'
+        rows = t['content']
+        assert len(rows) == 3
+        assert rows[0]['content'][0]['type'] == 'tableHeader'
+        assert rows[1]['content'][0]['type'] == 'tableCell'
+
+    def test_md_table_inline_formatting(self):
+        """Cells with bold, italic, code, links produce correct inline marks."""
+        md = "| A | B | | --- | --- | | **bold** | *italic* | | `code` | [link](https://example.com) |"
+        nodes = md_to_adf(md)
+        t = nodes[0]
+        cells = t['content'][1]['content']
+        c0 = cells[0]['content'][0]['content'][0]
+        c1 = cells[1]['content'][0]['content'][0]
+        c2 = t['content'][2]['content'][0]['content'][0]['content'][0]
+        c3 = t['content'][2]['content'][1]['content'][0]['content'][0]
+        assert c0['marks'][0]['type'] == 'strong'
+        assert c1['marks'][0]['type'] == 'em'
+        assert c2['marks'][0]['type'] == 'code'
+        assert c3['marks'][0]['type'] == 'link'
+
+    def test_md_table_alignment_separator(self):
+        """Alignment markers in separator (:--, :-:, --:) are recognised and dropped."""
+        md = "\n".join([
+            "| L | C | R |",
+            "| :-- | :-: | --: |",
+            "| a | b | c |",
+        ])
+        nodes = md_to_adf(md)
+        t = nodes[0]
+        assert len(t['content']) == 2  # header + 1 data, separator dropped
+
+    def test_md_table_ragged_rows(self):
+        """Short rows pad with empty cells; long rows truncate."""
+        md = "\n".join([
+            "| A | B | C |",
+            "| --- | --- | --- |",
+            "| 1 | 2 |",       # short
+            "| 4 | 5 | 6 | 7 |",  # long
+        ])
+        nodes = md_to_adf(md)
+        t = nodes[0]
+        r1 = t['content'][1]['content']  # short row
+        r2 = t['content'][2]['content']  # long row
+        assert len(r1) == 3
+        assert len(r2) == 3
+
+    def test_md_table_in_mixed_document(self):
+        """Table sits between heading and bullet list, all separate nodes."""
+        md = "\n".join([
+            "## Before",
+            "",
+            "| A | B |",
+            "| --- | --- |",
+            "| 1 | 2 |",
+            "",
+            "- item one",
+            "- item two",
+        ])
+        nodes = md_to_adf(md)
+        types = [n['type'] for n in nodes]
+        assert types == ['heading', 'table', 'bulletList']
+
+    def test_md_table_localids_present(self):
+        """Every table/row/header/cell has a non-empty localId."""
+        md = "\n".join([
+            "| A | B |",
+            "| --- | --- |",
+            "| 1 | 2 |",
+        ])
+        nodes = md_to_adf(md)
+        t = nodes[0]
+        assert t['attrs']['localId'] != ''
+        for row in t['content']:
+            assert row['localId'] != ''
+            for cell in row['content']:
+                assert cell['localId'] != ''
+                assert 'colwidth' in cell['attrs']