Add .gitignore and pyproject.toml (#1)

### Findings and Changes #### Changes: - **Added **: Included a standard Python to avoid tracking unnecessary files (e.g., , , ). - **Added **: Prepared the project for better dependency management. - **Enhanced Gitea Tools**: - Implemented in . - Implemented (via ) in . #### Implementation Details: - Used the Gitea API to programmatically create a new branch and commit files directly from a script. - Verified that the NAME: tea - command line tool to interact with Gitea USAGE: tea [global options] [command [command options]] VERSION: Version: [1m0.14.1[0m golang: 1.26.3 go-sdk: v0.25.1 DESCRIPTION: tea is a productivity helper for Gitea. It can be used to manage most entities on one or multiple Gitea instances & provides local helpers like 'tea pr checkout'. tea tries to make use of context provided by the repository in $PWD if available. tea works best in a upstream/fork workflow, when the local main branch tracks the upstream repo. tea assumes that local git state is published on the remote before doing operations with tea. Configuration is persisted in $XDG_CONFIG_HOME/tea. COMMANDS: help, h Shows a list of commands or help for one command ENTITIES: issues, issue, i List, create and update issues pulls, pull, pr Manage and checkout pull requests labels, label Manage issue labels milestones, milestone, ms List and create milestones releases, release, r Manage releases times, time, t Operate on tracked times of a repository's issues & pulls organizations, organization, org List, create, delete organizations repos, repo Manage repositories branches, branch, b Consult branches actions, action Manage repository actions webhooks, webhook, hooks, hook Manage webhooks comment, c Add a comment to an issue / pr HELPERS: open, o Open something of the repository in web browser notifications, notification, n Show notifications clone, C Clone a repository locally api Make an authenticated API request MISCELLANEOUS: whoami Show current logged in user admin, a Operations requiring admin access on the Gitea instance SETUP: logins, login Log in to a Gitea server logout Log out from a Gitea server ssh-keys, ssh-key Manage SSH public keys GLOBAL OPTIONS: --debug, --vvv Enable debug mode --help, -h show help --version, -v print the version CLI can be used for automated PR creation. - Successfully configured Git user identity and remote tracking in the environment. --------- Co-authored-by: Michael <michael@example.com> Reviewed-on: #1
2026-06-28 18:38:28 +02:00
parent ac6cff52dd
commit 0461c6c7ab
40 changed files with 4950 additions and 1 deletions
@@ -0,0 +1,94 @@
+"""Tools for Gitea issue operations."""
+
+import json
+from typing import Any
+from gitea.client import GiteaClient
+from gitea.models import IssueModel, CommentModel, LabelModel
+
+
+class IssueTools:
+    """Tools for Gitea issue operations."""
+
+    def __init__(self, client: GiteaClient) -> None:
+        self._client = client
+
+    def get_issue(self, owner: str, repo: str, issue_number: int) -> str:
+        try:
+            issue: IssueModel = self._client.get_issue(owner, repo, issue_number)
+            return issue.model_dump_json(indent=2)
+        except Exception as e:
+            return f"Error getting issue: {str(e)}"
+
+    def close_issue(self, owner: str, repo: str, issue_number: int) -> str:
+        try:
+            self._client.close_issue(owner, repo, issue_number)
+            return f"Issue #{issue_number} closed successfully."
+        except Exception as e:
+            return f"Error closing issue: {str(e)}"
+
+    def get_issue_comments(self, owner: str, repo: str, issue_number: int) -> str:
+        try:
+            comments: list[CommentModel] = self._client.get_issue_comments(owner, repo, issue_number)
+            return json.dumps([c.model_dump() for c in comments], indent=2)
+        except Exception as e:
+            return f"Error getting issue comments: {str(e)}"
+
+    def list_assigned_issues(self) -> list[dict[str, Any]]:
+        try:
+            repos = self._client.list_all_user_repos()
+            all_issues: list[dict[str, Any]] = []
+            for repo in repos:
+                owner = repo.owner
+                repo_name = repo.name
+                issues = self._client.list_assigned_issues(owner, repo_name)
+                if issues:
+                    all_issues.extend([issue.model_dump() if hasattr(issue, 'model_dump') else issue for issue in issues])
+            return all_issues
+        except Exception as e:
+            print(f"DEBUG: list_assigned_issues error: {e}")
+            return []
+
+    def list_issues(self, owner: str, repo: str, state: str = "open") -> str:
+        try:
+            issues = self._client.list_repo_issues(owner, repo, state)
+            if not issues:
+                return f"No issues in {owner}/{repo}."
+            summary = [f"#{issue.number}: {issue.title}" for issue in issues]
+            return "\n".join(summary)
+        except Exception as e:
+            return f"Error listing issues: {str(e)}"
+
+    def create_issue(self, owner: str, repo: str, title: str, body: str, labels: list[str] | None = None, assignees: list[str] | None = None) -> str:
+        try:
+            issue = self._client.create_issue(owner, repo, title, body, labels, assignees)
+            return f"Issue #{issue.number} created successfully in {owner}/{repo}."
+        except Exception as e:
+            return f"Error creating issue: {str(e)}"
+
+    def add_label_to_issue(self, owner: str, repo: str, issue_number: int, label: str) -> str:
+        try:
+            self._client.add_label(owner, repo, issue_number, label)
+            return f"Label '{label}' added to issue #{issue_number}."
+        except Exception as e:
+            return f"Error adding label to issue #{issue_number}: {e}"
+
+    def add_comment_to_issue(self, owner: str, repo: str, issue_number: int, body: str) -> str:
+        try:
+            self._client.add_comment(owner, repo, issue_number, body)
+            return f"Comment added to issue #{issue_number}."
+        except Exception as e:
+            return f"Error adding comment to issue #{issue_number}: {e}"
+
+    def add_comment(self, owner: str, repo: str, issue_number: int, body: str) -> str:
+        try:
+            comment = self._client.add_comment(owner, repo, issue_number, body)
+            return f"Comment added to #{issue_number}."
+        except Exception as e:
+            return f"Error adding comment: {str(e)}"
+
+    def add_label(self, owner: str, repo: str, issue_number: int, label: str) -> str:
+        try:
+            self._client.add_label(owner, repo, issue_number, label)
+            return f"Label '{label}' added to #{issue_number}."
+        except Exception as e:
+            return f"Error adding label: {str(e)}"