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,99 @@
+"""Tools for Gitea pull request operations."""
+
+import json
+from typing import Any
+from gitea.client import GiteaClient
+from gitea.models import PullRequestModel, CommentModel
+
+
+class PRTools:
+    """Tools for Gitea pull request operations."""
+
+    def __init__(self, client: GiteaClient) -> None:
+        self._client = client
+
+    def get_pull_request(self, owner: str, repo: str, pull_number: int) -> str:
+        try:
+            pr: PullRequestModel = self._client.get_pull_request(owner, repo, pull_number)
+            return pr.model_dump_json(indent=2)
+        except Exception as e:
+            return f"Error getting pull request: {str(e)}"
+
+    def close_pull_request(self, owner: str, repo: str, pull_number: int) -> str:
+        try:
+            self._client.close_pull_request(owner, repo, pull_number)
+            return f"Pull request #{pull_number} closed successfully."
+        except Exception as e:
+            return f"Error closing pull request: {str(e)}"
+
+    def get_pull_request_comments(self, owner: str, repo: str, pull_number: int) -> str:
+        try:
+            comments: list[CommentModel] = self._client.get_pull_request_comments(owner, repo, pull_number)
+            return json.dumps([c.model_dump() for c in comments], indent=2)
+        except Exception as e:
+            return f"Error getting PR comments: {str(e)}"
+
+    def list_assigned_pull_requests(self) -> list[dict[str, Any]]:
+        try:
+            repos = self._client.list_all_user_repos()
+            all_prs: list[dict[str, Any]] = []
+            for repo_info in repos:
+                repo_owner = repo_info.owner
+                repo_name = repo_info.name
+                prs = self._client.list_assigned_pull_requests(repo_owner, repo_name)
+                if prs:
+                    all_prs.extend([pr.model_dump() if hasattr(pr, 'model_dump') else pr for pr in prs])
+            return all_prs
+        except Exception as e:
+            print(f"DEBUG: list_assigned_pull_requests error: {e}")
+            return []
+
+    def list_pull_requests(self, owner: str, repo: str, state: str = "open") -> str:
+        try:
+            prs = self._client.list_repo_pull_requests(owner, repo, state)
+            if not prs:
+                return f"No PRs in {owner}/{repo}."
+            summary = [f"#{pr.number}: {pr.title}" for pr in prs]
+            return "\n".join(summary)
+        except Exception as e:
+            return f"Error listing PRs: {str(e)}"
+
+    def create_pull_request(self, owner: str, repo: str, head: str, base: str, title: str, description: str = "") -> str:
+        try:
+            pr = self._client.create_pr_via_tea(owner, repo, title, description, head, base)
+            return pr.model_dump_json(indent=2)
+        except Exception as e:
+            return f"Error creating PR: {str(e)}"
+
+    def add_label_to_pr(self, owner: str, repo: str, pr_number: int, label: str) -> str:
+        try:
+            self._client.add_label_pr(owner, repo, pr_number, label)
+            return f"Label '{label}' added to PR #{pr_number}."
+        except Exception as e:
+            return f"Error adding label to PR #{pr_number}: {e}"
+
+    def get_pull_request_diff(self, owner: str, repo: str, pull_number: int) -> str:
+        try:
+            return self._client.get_pull_request_diff(owner, repo, pull_number)
+        except Exception as e:
+            return f"Error getting PR diff: {str(e)}"
+
+    def get_pull_request_patch(self, owner: str, repo: str, pull_number: int) -> str:
+        try:
+            return self._client.get_pull_request_patch(owner, repo, pull_number)
+        except Exception as e:
+            return f"Error getting PR patch: {str(e)}"
+
+    def approve_pull_request(self, owner: str, repo: str, pull_number: int, comment: str) -> str:
+        try:
+            self._client.approve_pr(owner, repo, pull_number, comment)
+            return f"Approved PR #{pull_number}."
+        except Exception as e:
+            return f"Error approving PR: {str(e)}"
+
+    def request_changes(self, owner: str, repo: str, pull_number: int, comment: str) -> str:
+        try:
+            self._client.request_changes_pr(owner, repo, pull_number, comment)
+            return f"Requested changes on PR #{pull_number}."
+        except Exception as e:
+            return f"Error requesting changes: {str(e)}"