youtrack-cli 0.3.2__tar.gz → 0.3.4__tar.gz

{youtrack_cli-0.3.2 → youtrack_cli-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: youtrack-cli
-Version: 0.3.2
+Version: 0.3.4
 Summary: YouTrack CLI - Command line interface for JetBrains YouTrack issue tracking system
 Project-URL: Homepage, https://github.com/ryan-murphy/yt-cli
 Project-URL: Documentation, https://yt-cli.readthedocs.io/
@@ -136,6 +136,9 @@ yt projects list
 # Create an article
 yt articles create "Getting Started" --content "Welcome to our documentation"
 
+# Create an article from a markdown file
+yt articles create "API Documentation" --file api-docs.md
+
 # Log work time
 yt time log ISSUE-123 "2h" --description "Feature development"
 
@@ -198,6 +201,13 @@ yt issues tag add ISSUE-456 urgent
 ```bash
 # Create and manage knowledge base
 yt articles create "API Guide" --content "Comprehensive API documentation"
+
+# Create articles from markdown files
+yt articles create "Installation Guide" --file docs/install.md
+
+# Organize existing documentation
+yt articles create "Developer Guide" --file dev-guide.md --project-id PROJECT-123
+
 yt articles tree --project-id PROJECT-123
 yt articles search "authentication"
 ```

{youtrack_cli-0.3.2 → youtrack_cli-0.3.4}/README.md

@@ -96,6 +96,9 @@ yt projects list
 # Create an article
 yt articles create "Getting Started" --content "Welcome to our documentation"
 
+# Create an article from a markdown file
+yt articles create "API Documentation" --file api-docs.md
+
 # Log work time
 yt time log ISSUE-123 "2h" --description "Feature development"
 
@@ -158,6 +161,13 @@ yt issues tag add ISSUE-456 urgent
 ```bash
 # Create and manage knowledge base
 yt articles create "API Guide" --content "Comprehensive API documentation"
+
+# Create articles from markdown files
+yt articles create "Installation Guide" --file docs/install.md
+
+# Organize existing documentation
+yt articles create "Developer Guide" --file dev-guide.md --project-id PROJECT-123
+
 yt articles tree --project-id PROJECT-123
 yt articles search "authentication"
 ```

{youtrack_cli-0.3.2 → youtrack_cli-0.3.4}/docs/commands/admin.rst

@@ -552,6 +552,15 @@ Common Issues and Solutions
 **Health Check Issues**
   Review system logs and resource availability.
 
+**Health Check 404 Errors**
+  If the health check command returns a 404 error, this may indicate:
+
+  * Your YouTrack version doesn't support the system settings endpoint
+  * The API endpoint has changed in your YouTrack version
+  * Your YouTrack instance has a different API configuration
+
+  The command will automatically try fallback endpoints and provide specific guidance based on the error type.
+
 System Diagnostics
 ~~~~~~~~~~~~~~~~~
 

{youtrack_cli-0.3.2 → youtrack_cli-0.3.4}/docs/commands/articles.rst

@@ -54,7 +54,10 @@ Create a new article in YouTrack.
      - Description
    * - ``--content, -c``
      - text
-     - Article content (will prompt if not provided)
+     - Article content (required if --file not provided)
+   * - ``--file, -f``
+     - path
+     - Path to markdown file containing article content (required if --content not provided)
    * - ``--project-id, -p``
      - string
      - Project ID to associate with the article
@@ -72,17 +75,23 @@ Create a new article in YouTrack.
 
 .. code-block:: bash
 
-   # Create a simple article
+   # Create a simple article with inline content
    yt articles create "Getting Started Guide" --content "This is a comprehensive guide..."
 
-   # Create an article in a specific project
-   yt articles create "API Documentation" --content "API usage guide" --project-id PROJECT-123
+   # Create an article from a markdown file
+   yt articles create "Getting Started Guide" --file getting-started.md
+
+   # Create an article in a specific project from a file
+   yt articles create "API Documentation" --file api-docs.md --project-id PROJECT-123
+
+   # Create a nested article (child of another article) from a file
+   yt articles create "Advanced Features" --file advanced.md --parent-id ARTICLE-456
 
-   # Create a nested article (child of another article)
-   yt articles create "Advanced Features" --content "Advanced guide" --parent-id ARTICLE-456
+   # Create a draft article (private visibility) from a file
+   yt articles create "Draft Article" --file draft.md --visibility private
 
-   # Create a draft article (private visibility)
-   yt articles create "Draft Article" --content "Work in progress" --visibility private
+   # Create an article with inline content (traditional approach)
+   yt articles create "API Documentation" --content "API usage guide" --project-id PROJECT-123
 
 edit
 ~~~~
@@ -671,6 +680,24 @@ Content Management
    # View article details
    yt articles edit ARTICLE-123 --show-details
 
+Working with Markdown Files
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   # Create articles from existing markdown files
+   yt articles create "Installation Guide" --file docs/installation.md
+
+   # Create multiple articles from markdown files
+   yt articles create "User Manual" --file user-manual.md --project-id PROJECT-123
+   yt articles create "Developer Guide" --file dev-guide.md --project-id PROJECT-123
+
+   # Organize markdown documentation into YouTrack articles
+   for file in docs/*.md; do
+       title=$(basename "$file" .md)
+       yt articles create "$title" --file "$file" --project-id PROJECT-123
+   done
+
 Best Practices
 --------------
 
@@ -690,6 +717,8 @@ Best Practices
 
 8. **Consistent Formatting**: Follow consistent formatting and style guidelines across articles.
 
+9. **Use Markdown Files**: For complex content, consider writing in markdown files first and using the ``--file`` option for better version control and editing experience.
+
 Error Handling
 --------------
 
@@ -710,6 +739,18 @@ Common error scenarios and solutions:
 **Content Too Large**
   YouTrack may have limits on article content size. Consider breaking large articles into smaller sections.
 
+**File Not Found**
+  Ensure the file path provided with ``--file`` exists and is accessible.
+
+**Invalid File Content**
+  The specified file must be a valid text file. Binary files or files with invalid encoding will be rejected.
+
+**Empty File**
+  Files provided with ``--file`` must contain content. Empty files will be rejected.
+
+**Both Content and File Specified**
+  You cannot use both ``--content`` and ``--file`` options simultaneously. Choose one method for providing article content.
+
 See Also
 --------
 

{youtrack_cli-0.3.2 → youtrack_cli-0.3.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "youtrack-cli"
-version = "0.3.2"
+version = "0.3.4"
 description = "YouTrack CLI - Command line interface for JetBrains YouTrack issue tracking system"
 readme = "README.md"
 requires-python = ">=3.9, <3.14"

{youtrack_cli-0.3.2 → youtrack_cli-0.3.4}/tests/test_admin.py

@@ -175,6 +175,38 @@ class TestAdminManager:
             assert result["status"] == "success"
             assert result["data"] == mock_health
 
+    @pytest.mark.asyncio
+    async def test_get_system_health_404_error(self, admin_manager, auth_manager):
+        """Test system health check with 404 error on all endpoints."""
+        with patch("httpx.AsyncClient") as mock_client:
+            mock_response = Mock()
+            mock_response.status_code = 404
+            mock_request = Mock()
+            http_error = httpx.HTTPStatusError("Not Found", request=mock_request, response=mock_response)
+            mock_client.return_value.__aenter__.return_value.get.side_effect = http_error
+
+            result = await admin_manager.get_system_health()
+
+            assert result["status"] == "error"
+            assert "System health endpoint not found (404)" in result["message"]
+            assert "YouTrack version doesn't support this endpoint" in result["message"]
+
+    @pytest.mark.asyncio
+    async def test_get_system_health_403_error(self, admin_manager, auth_manager):
+        """Test system health check with 403 permission error."""
+        with patch("httpx.AsyncClient") as mock_client:
+            mock_response = Mock()
+            mock_response.status_code = 403
+            mock_request = Mock()
+            http_error = httpx.HTTPStatusError("Forbidden", request=mock_request, response=mock_response)
+            mock_client.return_value.__aenter__.return_value.get.side_effect = http_error
+
+            result = await admin_manager.get_system_health()
+
+            assert result["status"] == "error"
+            assert "Insufficient permissions for health check" in result["message"]
+            assert "Low-level Admin Read" in result["message"]
+
     @pytest.mark.asyncio
     async def test_clear_caches_success(self, admin_manager, auth_manager):
         """Test successful cache clearing."""

{youtrack_cli-0.3.2 → youtrack_cli-0.3.4}/tests/test_articles.py

@@ -1,5 +1,6 @@
 """Tests for article management functionality."""
 
+from pathlib import Path
 from unittest.mock import MagicMock, Mock, patch
 
 import pytest
@@ -434,6 +435,88 @@ class TestArticlesCLI:
             assert result.exit_code == 0
             assert "Creating article" in result.output
 
+    def test_articles_create_command_with_file(self):
+        """Test articles create command with file input."""
+        from youtrack_cli.main import main
+
+        runner = CliRunner()
+
+        with (
+            patch("youtrack_cli.main.asyncio.run") as mock_run,
+            patch("youtrack_cli.main.AuthManager"),
+            patch("youtrack_cli.articles.ArticleManager"),
+            runner.isolated_filesystem(),
+        ):
+            # Create a test markdown file
+            test_file = Path("test_article.md")
+            test_file.write_text("# Test Article\n\nThis is test content from a markdown file.")
+
+            mock_run.return_value = {
+                "status": "success",
+                "message": "Article created successfully",
+                "data": {"id": "123"},
+            }
+
+            result = runner.invoke(main, ["articles", "create", "Test Title", "--file", str(test_file)])
+
+            assert result.exit_code == 0
+            assert "Reading content from" in result.output
+            assert "Creating article" in result.output
+
+    def test_articles_create_command_file_not_found(self):
+        """Test articles create command with non-existent file."""
+        from youtrack_cli.main import main
+
+        runner = CliRunner()
+
+        result = runner.invoke(main, ["articles", "create", "Test Title", "--file", "nonexistent.md"])
+
+        assert result.exit_code != 0
+        assert "does not exist" in result.output
+
+    def test_articles_create_command_both_content_and_file(self):
+        """Test articles create command with both content and file (should fail)."""
+        from youtrack_cli.main import main
+
+        runner = CliRunner()
+
+        with runner.isolated_filesystem():
+            test_file = Path("test_article.md")
+            test_file.write_text("Test content")
+
+            result = runner.invoke(
+                main, ["articles", "create", "Test Title", "--content", "Test content", "--file", str(test_file)]
+            )
+
+            assert result.exit_code != 0
+            assert "Cannot specify both --content and --file options" in result.output
+
+    def test_articles_create_command_no_content_or_file(self):
+        """Test articles create command with neither content nor file (should fail)."""
+        from youtrack_cli.main import main
+
+        runner = CliRunner()
+
+        result = runner.invoke(main, ["articles", "create", "Test Title"])
+
+        assert result.exit_code != 0
+        assert "Either --content or --file must be specified" in result.output
+
+    def test_articles_create_command_empty_file(self):
+        """Test articles create command with empty file."""
+        from youtrack_cli.main import main
+
+        runner = CliRunner()
+
+        with runner.isolated_filesystem():
+            test_file = Path("empty.md")
+            test_file.write_text("")
+
+            result = runner.invoke(main, ["articles", "create", "Test Title", "--file", str(test_file)])
+
+            assert result.exit_code != 0
+            assert "is empty" in result.output
+
     def test_articles_list_command(self):
         """Test articles list command."""
         from youtrack_cli.main import main

{youtrack_cli-0.3.2 → youtrack_cli-0.3.4}/uv.lock

@@ -1751,7 +1751,7 @@ wheels = [
 
 [[package]]
 name = "youtrack-cli"
-version = "0.3.2"
+version = "0.3.4"
 source = { editable = "." }
 dependencies = [
     { name = "click" },

{youtrack_cli-0.3.2 → youtrack_cli-0.3.4}/youtrack_cli/admin.py

@@ -153,6 +153,7 @@ class AdminManager:
                 response = await client.get(
                     f"{credentials.base_url.rstrip('/')}/api/admin/globalSettings/license",
                     headers=headers,
+                    params={"fields": "id,username,license,error"},
                     timeout=10.0,
                 )
                 response.raise_for_status()
@@ -167,6 +168,14 @@ class AdminManager:
                             "status": "error",
                             "message": "Insufficient permissions to view license.",
                         }
+                    elif e.response.status_code == 404:
+                        return {
+                            "status": "error",
+                            "message": (
+                                "License endpoint not found. This may indicate an "
+                                "incompatible YouTrack version or configuration."
+                            ),
+                        }
                 return {"status": "error", "message": f"HTTP error: {e}"}
             except Exception as e:
                 return {"status": "error", "message": f"Unexpected error: {e}"}
@@ -231,28 +240,62 @@ class AdminManager:
             "Accept": "application/json",
         }
 
-        async with httpx.AsyncClient() as client:
-            try:
-                response = await client.get(
-                    f"{credentials.base_url.rstrip('/')}/api/admin/globalSettings/systemSettings",
-                    headers=headers,
-                    timeout=10.0,
-                )
-                response.raise_for_status()
-
-                health_info = response.json()
-                return {"status": "success", "data": health_info}
+        # List of endpoints to try, in order of preference
+        endpoints = [
+            "/api/admin/globalSettings/systemSettings",
+            "/api/admin/globalSettings/systemSettings?fields=baseUrl,isApplicationReadOnly,maxUploadFileSize,maxExportItems",
+        ]
 
-            except httpx.HTTPError as e:
-                if hasattr(e, "response") and e.response is not None:
-                    if e.response.status_code == 403:
+        async with httpx.AsyncClient() as client:
+            for endpoint in endpoints:
+                try:
+                    response = await client.get(
+                        f"{credentials.base_url.rstrip('/')}{endpoint}",
+                        headers=headers,
+                        timeout=10.0,
+                    )
+                    response.raise_for_status()
+
+                    health_info = response.json()
+                    return {"status": "success", "data": health_info}
+
+                except httpx.HTTPStatusError as e:
+                    if e.response.status_code == 404:
+                        continue  # Try next endpoint
+                    elif e.response.status_code == 403:
                         return {
                             "status": "error",
-                            "message": "Insufficient permissions for health check.",
+                            "message": "Insufficient permissions for health check. "
+                            "Requires 'Low-level Admin Read' permission.",
                         }
-                return {"status": "error", "message": f"HTTP error: {e}"}
-            except Exception as e:
-                return {"status": "error", "message": f"Unexpected error: {e}"}
+                    elif e.response.status_code == 401:
+                        return {
+                            "status": "error",
+                            "message": "Authentication failed. Your token may have expired. Run 'yt auth login' again.",
+                        }
+                    else:
+                        response_text = e.response.text if hasattr(e.response, "text") else str(e)
+                        return {
+                            "status": "error",
+                            "message": f"HTTP {e.response.status_code}: {response_text}",
+                        }
+                except httpx.RequestError as e:
+                    return {
+                        "status": "error",
+                        "message": f"Network error: {e}. Check your YouTrack URL and network connection.",
+                    }
+                except Exception as e:
+                    return {"status": "error", "message": f"Unexpected error: {e}"}
+
+            # If all endpoints failed with 404
+            return {
+                "status": "error",
+                "message": "System health endpoint not found (404). This may indicate:\n"
+                "1. Your YouTrack version doesn't support this endpoint\n"
+                "2. The endpoint URL may have changed\n"
+                "3. Your YouTrack instance has a different API configuration\n"
+                "Please verify your YouTrack version and API access.",
+            }
 
     async def clear_caches(self) -> dict[str, Any]:
         """Clear system caches.

{youtrack_cli-0.3.2 → youtrack_cli-0.3.4}/youtrack_cli/commands/articles.py

@@ -1,6 +1,7 @@
 """Articles command group for YouTrack CLI."""
 
 import asyncio
+from pathlib import Path
 from typing import Optional
 
 import click
@@ -20,9 +21,14 @@ def articles() -> None:
 @click.option(
     "--content",
     "-c",
-    prompt=True,
     help="Article content",
 )
+@click.option(
+    "--file",
+    "-f",
+    type=click.Path(exists=True, path_type=Path),
+    help="Path to markdown file containing article content",
+)
 @click.option(
     "--project-id",
     "-p",
@@ -47,7 +53,8 @@ def articles() -> None:
 def create(
     ctx: click.Context,
     title: str,
-    content: str,
+    content: Optional[str],
+    file: Optional[Path],
     project_id: Optional[str],
     parent_id: Optional[str],
     summary: Optional[str],
@@ -57,11 +64,39 @@ def create(
     from ..articles import ArticleManager
 
     console = Console()
+
+    # Validate that either content or file is provided, but not both
+    if content and file:
+        console.print("❌ Cannot specify both --content and --file options", style="red")
+        raise click.ClickException("Use either --content or --file, not both")
+
+    if not content and not file:
+        console.print("❌ Either --content or --file must be specified", style="red")
+        raise click.ClickException("Article content is required")
+
+    # Read content from file if provided
+    if file:
+        try:
+            console.print(f"📖 Reading content from '{file}'...", style="blue")
+            content = file.read_text(encoding="utf-8")
+            if not content.strip():
+                console.print(f"❌ File '{file}' is empty", style="red")
+                raise click.ClickException("File content cannot be empty")
+        except UnicodeDecodeError:
+            console.print(f"❌ File '{file}' is not a valid text file", style="red")
+            raise click.ClickException("File must be a valid text file") from None
+        except Exception as e:
+            console.print(f"❌ Error reading file '{file}': {e}", style="red")
+            raise click.ClickException("Failed to read file") from e
+
     auth_manager = AuthManager(ctx.obj.get("config"))
     article_manager = ArticleManager(auth_manager)
 
     console.print(f"📝 Creating article '{title}'...", style="blue")
 
+    # At this point, content is guaranteed to be a string due to validation above
+    assert content is not None
+
     try:
         result = asyncio.run(
             article_manager.create_article(