youtrack-cli 0.3.1__tar.gz → 0.3.3__tar.gz

{youtrack_cli-0.3.1 → youtrack_cli-0.3.3}/.claude/settings.local.json

@@ -40,7 +40,8 @@
       "mcp__github__create_issue",
       "mcp__claude-code__Read",
       "mcp__claude-code__Grep",
-      "WebFetch(domain:github.com)"
+      "WebFetch(domain:github.com)",
+      "Bash(git remote get-url:*)"
     ],
     "deny": []
   }

{youtrack_cli-0.3.1 → youtrack_cli-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: youtrack-cli
-Version: 0.3.1
+Version: 0.3.3
 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.1 → youtrack_cli-0.3.3}/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.1 → youtrack_cli-0.3.3}/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.1 → youtrack_cli-0.3.3}/justfile

@@ -52,8 +52,8 @@ format-check:
 [group('quality')]
 typecheck:
     #!/usr/bin/env bash
-    echo "Running mypy type checker..."
-    uv run mypy youtrack_cli
+    echo "Running ty type checker..."
+    uv run ty youtrack_cli
     echo "✅ Type checking complete"
 
 [group('quality')]

{youtrack_cli-0.3.1 → youtrack_cli-0.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "youtrack-cli"
-version = "0.3.1"
+version = "0.3.3"
 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.1 → youtrack_cli-0.3.3}/tests/test_admin.py

@@ -209,7 +209,7 @@ class TestAdminManager:
 
         with patch("httpx.AsyncClient") as mock_client:
             mock_response = Mock()
-            mock_response.json.return_value = mock_groups
+            mock_response.json.return_value = {"usergroups": mock_groups}
             mock_response.raise_for_status.return_value = None
 
             mock_client.return_value.__aenter__.return_value.get.return_value = mock_response

{youtrack_cli-0.3.1 → youtrack_cli-0.3.3}/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.1 → youtrack_cli-0.3.3}/uv.lock

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

{youtrack_cli-0.3.1 → youtrack_cli-0.3.3}/youtrack_cli/admin.py

@@ -151,7 +151,7 @@ class AdminManager:
         async with httpx.AsyncClient() as client:
             try:
                 response = await client.get(
-                    f"{credentials.base_url.rstrip('/')}/api/admin/license",
+                    f"{credentials.base_url.rstrip('/')}/api/admin/globalSettings/license",
                     headers=headers,
                     timeout=10.0,
                 )
@@ -192,7 +192,7 @@ class AdminManager:
         async with httpx.AsyncClient() as client:
             try:
                 response = await client.get(
-                    f"{credentials.base_url.rstrip('/')}/api/admin/license/usage",
+                    f"{credentials.base_url.rstrip('/')}/api/admin/globalSettings/license/usage",
                     headers=headers,
                     timeout=10.0,
                 )
@@ -234,7 +234,7 @@ class AdminManager:
         async with httpx.AsyncClient() as client:
             try:
                 response = await client.get(
-                    f"{credentials.base_url.rstrip('/')}/api/admin/health",
+                    f"{credentials.base_url.rstrip('/')}/api/admin/globalSettings/systemSettings",
                     headers=headers,
                     timeout=10.0,
                 )
@@ -327,14 +327,15 @@ class AdminManager:
         async with httpx.AsyncClient() as client:
             try:
                 response = await client.get(
-                    f"{credentials.base_url.rstrip('/')}/api/admin/groups",
+                    f"{credentials.base_url.rstrip('/')}/api/rest/usergroups",
                     headers=headers,
                     params=params,
                     timeout=10.0,
                 )
                 response.raise_for_status()
 
-                groups = response.json()
+                groups_response = response.json()
+                groups = groups_response.get("usergroups", [])
                 return {"status": "success", "data": groups}
 
             except httpx.HTTPError as e:
@@ -378,7 +379,7 @@ class AdminManager:
         async with httpx.AsyncClient() as client:
             try:
                 response = await client.post(
-                    f"{credentials.base_url.rstrip('/')}/api/admin/groups",
+                    f"{credentials.base_url.rstrip('/')}/api/rest/usergroups",
                     headers=headers,
                     json=group_data,
                     params={"fields": "id,name,description"},

{youtrack_cli-0.3.1 → youtrack_cli-0.3.3}/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(