atlassian-cli 0.5.8__tar.gz → 0.6.0__tar.gz

{atlassian_cli-0.5.8/src/atlassian_cli.egg-info → atlassian_cli-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atlassian-cli
-Version: 0.5.8
+Version: 0.6.0
 Summary: Fast CLI tools for Atlassian Cloud (Confluence + Jira) — optimized for AI agents
 Author-email: Alex Fishlock <alex.fishlock@catapult.cx>
 License-Expression: MIT
@@ -61,17 +61,29 @@ pip install git+https://github.com/catapultcx/atlassian-cli.git
 
 ## Setup
 
-Create a `.env` file (or export environment variables):
+Create a config file with your credentials:
 
 ```bash
+mkdir -p ~/.config/atlassian-cli
+cat > ~/.config/atlassian-cli/config <<EOF
 ATLASSIAN_URL=https://your-site.atlassian.net
 ATLASSIAN_EMAIL=you@example.com
 ATLASSIAN_TOKEN=your-api-token
+EOF
+chmod 600 ~/.config/atlassian-cli/config
 ```
 
+The CLI looks for credentials in this order (first match wins):
+
+1. `$ATLASSIAN_CLI_CONFIG` (explicit path override)
+2. `./.env` in the current working directory
+3. `$XDG_CONFIG_HOME/atlassian-cli/config` (defaults to `~/.config/atlassian-cli/config`)
+4. `~/.atlassian-cli/config`
+5. Environment variables (`ATLASSIAN_URL`, `ATLASSIAN_EMAIL`, `ATLASSIAN_TOKEN`)
+
 Get your API token at https://id.atlassian.com/manage-profile/security/api-tokens
 
-> Legacy `CONFLUENCE_URL` / `CONFLUENCE_EMAIL` / `CONFLUENCE_TOKEN` env vars are also supported.
+> Legacy `CONFLUENCE_URL` / `CONFLUENCE_EMAIL` / `CONFLUENCE_TOKEN` are also supported.
 
 ## Confluence CLI
 
@@ -115,6 +127,30 @@ pages/
 page-index.json              # searchable index
 ```
 
+### Comments
+
+Read, reply to, and resolve inline and footer comments on pages.
+
+```bash
+# List all comments on a page
+confluence comments 9268920323
+
+# List only open/unresolved comments
+confluence comments 9268920323 --open
+
+# Reply to an inline comment
+confluence comment 10226663432 "Fixed — updated the wording"
+
+# Reply to a footer comment
+confluence comment 10226663432 "Noted, will action" --footer
+
+# Resolve an inline comment
+confluence resolve 10226663432
+
+# Reopen a resolved comment
+confluence resolve 10226663432 --reopen
+```
+
 ## Jira CLI
 
 ### Issues

{atlassian_cli-0.5.8 → atlassian_cli-0.6.0}/README.md

@@ -30,17 +30,29 @@ pip install git+https://github.com/catapultcx/atlassian-cli.git
 
 ## Setup
 
-Create a `.env` file (or export environment variables):
+Create a config file with your credentials:
 
 ```bash
+mkdir -p ~/.config/atlassian-cli
+cat > ~/.config/atlassian-cli/config <<EOF
 ATLASSIAN_URL=https://your-site.atlassian.net
 ATLASSIAN_EMAIL=you@example.com
 ATLASSIAN_TOKEN=your-api-token
+EOF
+chmod 600 ~/.config/atlassian-cli/config
 ```
 
+The CLI looks for credentials in this order (first match wins):
+
+1. `$ATLASSIAN_CLI_CONFIG` (explicit path override)
+2. `./.env` in the current working directory
+3. `$XDG_CONFIG_HOME/atlassian-cli/config` (defaults to `~/.config/atlassian-cli/config`)
+4. `~/.atlassian-cli/config`
+5. Environment variables (`ATLASSIAN_URL`, `ATLASSIAN_EMAIL`, `ATLASSIAN_TOKEN`)
+
 Get your API token at https://id.atlassian.com/manage-profile/security/api-tokens
 
-> Legacy `CONFLUENCE_URL` / `CONFLUENCE_EMAIL` / `CONFLUENCE_TOKEN` env vars are also supported.
+> Legacy `CONFLUENCE_URL` / `CONFLUENCE_EMAIL` / `CONFLUENCE_TOKEN` are also supported.
 
 ## Confluence CLI
 
@@ -84,6 +96,30 @@ pages/
 page-index.json              # searchable index
 ```
 
+### Comments
+
+Read, reply to, and resolve inline and footer comments on pages.
+
+```bash
+# List all comments on a page
+confluence comments 9268920323
+
+# List only open/unresolved comments
+confluence comments 9268920323 --open
+
+# Reply to an inline comment
+confluence comment 10226663432 "Fixed — updated the wording"
+
+# Reply to a footer comment
+confluence comment 10226663432 "Noted, will action" --footer
+
+# Resolve an inline comment
+confluence resolve 10226663432
+
+# Reopen a resolved comment
+confluence resolve 10226663432 --reopen
+```
+
 ## Jira CLI
 
 ### Issues

{atlassian_cli-0.5.8 → atlassian_cli-0.6.0}/pyproject.toml

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

atlassian_cli-0.6.0/src/atlassian_cli/__init__.py

@@ -0,0 +1,7 @@
+"""Atlassian Cloud CLI tools for Confluence and Jira."""
+
+try:
+    from importlib.metadata import version
+    __version__ = version('atlassian-cli')
+except Exception:
+    __version__ = '0.0.0-dev'

{atlassian_cli-0.5.8 → atlassian_cli-0.6.0}/src/atlassian_cli/config.py

@@ -7,17 +7,39 @@ import requests
 from requests.auth import HTTPBasicAuth
 
 
-def load_env(path=None):
-    """Manually parse a .env file into a dict, skipping comments and blank lines."""
-    if path is None:
-        paths = [os.path.join(os.getcwd(), '.env'), os.path.join(os.path.dirname(__file__), '.env')]
-    else:
-        paths = [path]
+def _config_search_paths():
+    """Return ordered list of paths to look for a .env / config file.
+
+    Search order (first match wins):
+      1. ATLASSIAN_CLI_CONFIG env var (explicit override)
+      2. ./.env in the current working directory
+      3. $XDG_CONFIG_HOME/atlassian-cli/config (XDG default ~/.config/...)
+      4. ~/.atlassian-cli/config (legacy/dotfile location)
+      5. <package_dir>/.env (last-ditch fallback for editable installs)
+    """
+    paths = []
+    override = os.environ.get('ATLASSIAN_CLI_CONFIG')
+    if override:
+        paths.append(override)
+    paths.append(os.path.join(os.getcwd(), '.env'))
+    xdg = os.environ.get('XDG_CONFIG_HOME') or os.path.expanduser('~/.config')
+    paths.append(os.path.join(xdg, 'atlassian-cli', 'config'))
+    paths.append(os.path.expanduser('~/.atlassian-cli/config'))
+    paths.append(os.path.join(os.path.dirname(__file__), '.env'))
+    return paths
 
+
+def load_env(path=None):
+    """Parse a .env-style file into a dict, skipping comments and blank lines."""
+    paths = [path] if path else _config_search_paths()
     for env_path in paths:
-        if os.path.exists(env_path):
+        if env_path and os.path.exists(env_path):
             with open(env_path, 'r') as file:
-                return dict(line.strip().split('=', 1) for line in file if not line.startswith('#') and '=' in line)
+                return dict(
+                    line.strip().split('=', 1)
+                    for line in file
+                    if not line.startswith('#') and '=' in line
+                )
     return {}