elizaos-plugin-github 2.0.0a4__py3-none-any.whl

elizaos_plugin_github/types.py

@@ -0,0 +1,413 @@
+from enum import Enum
+from typing import Literal
+
+from pydantic import BaseModel, ConfigDict
+
+
+class RepositoryRef(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    owner: str
+    repo: str
+
+
+class FileChange(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    path: str
+    content: str
+    encoding: Literal["utf-8", "base64"] = "utf-8"
+    operation: Literal["add", "modify", "delete"] = "modify"
+
+
+class IssueState(str, Enum):
+    OPEN = "open"
+    CLOSED = "closed"
+
+
+class IssueStateReason(str, Enum):
+    COMPLETED = "completed"
+    NOT_PLANNED = "not_planned"
+    REOPENED = "reopened"
+
+
+class GitHubLabel(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    id: int
+    name: str
+    color: str
+    description: str | None = None
+    default: bool = False
+
+
+class GitHubMilestone(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    number: int
+    title: str
+    description: str | None = None
+    state: Literal["open", "closed"]
+    due_on: str | None = None
+    created_at: str
+    updated_at: str
+    closed_at: str | None = None
+    open_issues: int = 0
+    closed_issues: int = 0
+
+
+class GitHubUser(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    id: int
+    login: str
+    name: str | None = None
+    avatar_url: str
+    html_url: str
+    type: Literal["User", "Organization", "Bot"]
+
+
+class GitHubIssue(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    number: int
+    title: str
+    body: str | None = None
+    state: IssueState
+    state_reason: IssueStateReason | None = None
+    user: GitHubUser
+    assignees: list[GitHubUser] = []
+    labels: list[GitHubLabel] = []
+    milestone: GitHubMilestone | None = None
+    created_at: str
+    updated_at: str
+    closed_at: str | None = None
+    html_url: str
+    comments: int = 0
+    is_pull_request: bool = False
+
+
+class CreateIssueParams(RepositoryRef):
+    model_config = ConfigDict(frozen=True)
+
+    title: str
+    body: str | None = None
+    assignees: list[str] = []
+    labels: list[str] = []
+    milestone: int | None = None
+
+
+class UpdateIssueParams(RepositoryRef):
+    model_config = ConfigDict(frozen=False)
+
+    issue_number: int
+    title: str | None = None
+    body: str | None = None
+    state: IssueState | None = None
+    state_reason: IssueStateReason | None = None
+    assignees: list[str] | None = None
+    labels: list[str] | None = None
+    milestone: int | None = None
+
+
+class ListIssuesParams(RepositoryRef):
+    model_config = ConfigDict(frozen=True)
+
+    state: Literal["open", "closed", "all"] = "open"
+    labels: str | None = None
+    sort: Literal["created", "updated", "comments"] = "created"
+    direction: Literal["asc", "desc"] = "desc"
+    assignee: str | None = None
+    creator: str | None = None
+    mentioned: str | None = None
+    per_page: int = 30
+    page: int = 1
+
+
+class PullRequestState(str, Enum):
+    OPEN = "open"
+    CLOSED = "closed"
+
+
+class MergeableState(str, Enum):
+    MERGEABLE = "mergeable"
+    CONFLICTING = "conflicting"
+    UNKNOWN = "unknown"
+
+
+class GitHubBranchRef(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    ref: str
+    label: str
+    sha: str
+    repo: RepositoryRef | None = None
+
+
+class GitHubPullRequest(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    number: int
+    title: str
+    body: str | None = None
+    state: PullRequestState
+    draft: bool = False
+    merged: bool = False
+    mergeable: bool | None = None
+    mergeable_state: MergeableState = MergeableState.UNKNOWN
+    user: GitHubUser
+    head: GitHubBranchRef
+    base: GitHubBranchRef
+    assignees: list[GitHubUser] = []
+    requested_reviewers: list[GitHubUser] = []
+    labels: list[GitHubLabel] = []
+    milestone: GitHubMilestone | None = None
+    created_at: str
+    updated_at: str
+    closed_at: str | None = None
+    merged_at: str | None = None
+    html_url: str
+    commits: int = 0
+    additions: int = 0
+    deletions: int = 0
+    changed_files: int = 0
+
+
+class CreatePullRequestParams(RepositoryRef):
+    model_config = ConfigDict(frozen=True)
+
+    title: str
+    body: str | None = None
+    head: str
+    base: str
+    draft: bool = False
+    maintainer_can_modify: bool = True
+
+
+class UpdatePullRequestParams(RepositoryRef):
+    model_config = ConfigDict(frozen=False)
+
+    pull_number: int
+    title: str | None = None
+    body: str | None = None
+    state: PullRequestState | None = None
+    base: str | None = None
+    maintainer_can_modify: bool | None = None
+
+
+class ListPullRequestsParams(RepositoryRef):
+    model_config = ConfigDict(frozen=True)
+
+    state: Literal["open", "closed", "all"] = "open"
+    head: str | None = None
+    base: str | None = None
+    sort: Literal["created", "updated", "popularity", "long-running"] = "created"
+    direction: Literal["asc", "desc"] = "desc"
+    per_page: int = 30
+    page: int = 1
+
+
+class MergePullRequestParams(RepositoryRef):
+    model_config = ConfigDict(frozen=True)
+
+    pull_number: int
+    commit_title: str | None = None
+    commit_message: str | None = None
+    merge_method: Literal["merge", "squash", "rebase"] = "merge"
+    sha: str | None = None
+
+
+class ReviewState(str, Enum):
+    APPROVED = "APPROVED"
+    CHANGES_REQUESTED = "CHANGES_REQUESTED"
+    COMMENTED = "COMMENTED"
+    DISMISSED = "DISMISSED"
+    PENDING = "PENDING"
+
+
+class ReviewEvent(str, Enum):
+    APPROVE = "APPROVE"
+    REQUEST_CHANGES = "REQUEST_CHANGES"
+    COMMENT = "COMMENT"
+
+
+class ReviewCommentInput(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    path: str
+    line: int
+    body: str
+    side: Literal["LEFT", "RIGHT"] = "RIGHT"
+    start_line: int | None = None
+    start_side: Literal["LEFT", "RIGHT"] | None = None
+
+
+class GitHubReview(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    id: int
+    user: GitHubUser
+    body: str | None = None
+    state: ReviewState
+    commit_id: str
+    html_url: str
+    submitted_at: str | None = None
+
+
+class CreateReviewParams(RepositoryRef):
+    model_config = ConfigDict(frozen=True)
+
+    pull_number: int
+    body: str | None = None
+    event: ReviewEvent
+    commit_id: str | None = None
+    comments: list[ReviewCommentInput] = []
+
+
+class GitHubComment(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    id: int
+    body: str
+    user: GitHubUser
+    created_at: str
+    updated_at: str
+    html_url: str
+
+
+class CreateCommentParams(RepositoryRef):
+    model_config = ConfigDict(frozen=True)
+
+    issue_number: int
+    body: str
+
+
+class GitHubBranch(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    name: str
+    sha: str
+    protected: bool = False
+
+
+class CreateBranchParams(RepositoryRef):
+    model_config = ConfigDict(frozen=True)
+
+    branch_name: str
+    from_ref: str
+
+
+class GitHubCommitAuthor(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    name: str
+    email: str
+    date: str
+
+
+class GitHubCommit(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    sha: str
+    message: str
+    author: GitHubCommitAuthor
+    committer: GitHubCommitAuthor
+    timestamp: str
+    html_url: str
+    parents: list[str] = []
+
+
+class CreateCommitParams(RepositoryRef):
+    model_config = ConfigDict(frozen=True)
+
+    message: str
+    files: list[FileChange]
+    branch: str
+    parent_sha: str | None = None
+    author_name: str | None = None
+    author_email: str | None = None
+
+
+class GitHubFileContent(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    name: str
+    path: str
+    content: str
+    sha: str
+    size: int
+    type: Literal["file", "dir", "symlink", "submodule"]
+    encoding: str
+    html_url: str
+    download_url: str | None = None
+
+
+class GitHubDirectoryEntry(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    name: str
+    path: str
+    sha: str
+    size: int
+    type: Literal["file", "dir", "symlink", "submodule"]
+    html_url: str
+    download_url: str | None = None
+
+
+class GitHubLicense(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    key: str
+    name: str
+    spdx_id: str | None = None
+    url: str | None = None
+
+
+class GitHubRepository(BaseModel):
+    model_config = ConfigDict(frozen=True)
+
+    id: int
+    name: str
+    full_name: str
+    owner: GitHubUser
+    description: str | None = None
+    private: bool = False
+    fork: bool = False
+    default_branch: str
+    language: str | None = None
+    stargazers_count: int = 0
+    forks_count: int = 0
+    open_issues_count: int = 0
+    watchers_count: int = 0
+    html_url: str
+    clone_url: str
+    ssh_url: str
+    created_at: str
+    updated_at: str
+    pushed_at: str
+    topics: list[str] = []
+    license: GitHubLicense | None = None
+
+
+# =============================================================================
+# Event Types
+# =============================================================================
+
+
+class GitHubEventType(str, Enum):
+    PUSH = "push"
+    PULL_REQUEST = "pull_request"
+    PULL_REQUEST_REVIEW = "pull_request_review"
+    PULL_REQUEST_REVIEW_COMMENT = "pull_request_review_comment"
+    ISSUES = "issues"
+    ISSUE_COMMENT = "issue_comment"
+    CREATE = "create"
+    DELETE = "delete"
+    FORK = "fork"
+    STAR = "star"
+    WATCH = "watch"
+    RELEASE = "release"
+    WORKFLOW_RUN = "workflow_run"
+    CHECK_RUN = "check_run"
+    CHECK_SUITE = "check_suite"
+    STATUS = "status"

elizaos_plugin_github-2.0.0a4.dist-info/METADATA

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: elizaos-plugin-github
+Version: 2.0.0a4
+Summary: GitHub plugin for elizaOS - Python implementation
+Project-URL: Homepage, https://github.com/elizaos/eliza
+Project-URL: Documentation, https://elizaos.ai/docs
+Project-URL: Repository, https://github.com/elizaos/eliza
+Project-URL: Issues, https://github.com/elizaos/eliza/issues
+Author: elizaOS Contributors
+License-Expression: MIT
+Keywords: agent,ai,elizaos,git,github
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pygithub>=2.3.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-xprocess>=1.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# elizaos-plugin-github (Python)
+
+Python implementation of the GitHub plugin for elizaOS.
+
+## Installation
+
+```bash
+pip install elizaos-plugin-github
+```
+
+## Usage
+
+```python
+from elizaos_plugin_github import GitHubConfig, GitHubService
+
+# Create configuration
+config = GitHubConfig(
+    api_token="ghp_your_token_here",
+    owner="my-org",
+    repo="my-repo",
+)
+
+# Create service
+service = GitHubService(config)
+
+# Start service
+await service.start()
+
+# Create an issue
+from elizaos_plugin_github.types import CreateIssueParams
+
+issue = await service.create_issue(
+    CreateIssueParams(
+        owner="my-org",
+        repo="my-repo",
+        title="Bug: Something is broken",
+        body="Description of the bug...",
+        labels=["bug"],
+    )
+)
+print(f"Created issue #{issue.number}")
+
+# Create a pull request
+from elizaos_plugin_github.types import CreatePullRequestParams
+
+pr = await service.create_pull_request(
+    CreatePullRequestParams(
+        owner="my-org",
+        repo="my-repo",
+        title="Fix the bug",
+        head="fix/bug-123",
+        base="main",
+    )
+)
+print(f"Created PR #{pr.number}")
+
+# Stop service
+await service.stop()
+```
+
+## Configuration
+
+The plugin can be configured via environment variables:
+
+- `GITHUB_API_TOKEN` (required): GitHub personal access token
+- `GITHUB_OWNER`: Default repository owner
+- `GITHUB_REPO`: Default repository name
+- `GITHUB_BRANCH`: Default branch (defaults to "main")
+- `GITHUB_WEBHOOK_SECRET`: Secret for webhook verification
+- `GITHUB_APP_ID`: GitHub App ID for app authentication
+- `GITHUB_APP_PRIVATE_KEY`: GitHub App private key
+- `GITHUB_INSTALLATION_ID`: GitHub App installation ID
+
+## Features
+
+### Repository Operations
+
+- Get repository information
+- List repositories
+
+### Issue Operations
+
+- Create issues
+- Get issue details
+- Update issues
+- List issues
+- Close/reopen issues
+
+### Pull Request Operations
+
+- Create pull requests
+- Get PR details
+- Update pull requests
+- List pull requests
+- Merge pull requests
+
+### Review Operations
+
+- Create reviews (approve, request changes, comment)
+- List reviews
+
+### Comment Operations
+
+- Create comments on issues/PRs
+- List comments
+
+### Branch Operations
+
+- Create branches
+- Delete branches
+- List branches
+
+### File Operations
+
+- Get file content
+- List directory contents
+
+### Commit Operations
+
+- Create commits with file changes
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Type checking
+mypy elizaos_plugin_github
+
+# Linting
+ruff check .
+ruff format .
+```
+
+## License
+
+MIT
+
+
+

elizaos_plugin_github-2.0.0a4.dist-info/RECORD

@@ -0,0 +1,22 @@
+elizaos_plugin_github/__init__.py,sha256=DmD60Yz6hFj05y8niJlGV27OSVl7_675irCqF_dw3yg,2603
+elizaos_plugin_github/config.py,sha256=gsgZWSCLZ-f0GOLRMDZw7oEX6JHEWg5w6jxlO5Upt7U,2184
+elizaos_plugin_github/error.py,sha256=CMtJCSQN52bb4W5ZTXu4WqopFv_-p9mpAgL-VPoixnM,5162
+elizaos_plugin_github/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+elizaos_plugin_github/service.py,sha256=6INsGzW2GdE3DK0NCfurpMeDF5u6u8EKTNyddsl4UFw,26900
+elizaos_plugin_github/types.py,sha256=qScPwJQ_HfbAGxB51jYMMmGWaTyj92MMap_2hvziYJg,9280
+elizaos_plugin_github/actions/__init__.py,sha256=slBIGzYq1Sz67qSRW-RLxvwh2jLVnYPk8TIi_bJ6Zcw,966
+elizaos_plugin_github/actions/create_branch.py,sha256=TGMxTd6h1_qTdLa7SrPq-LBqdYV6Tm47UBBpHnLaMX0,1988
+elizaos_plugin_github/actions/create_comment.py,sha256=ehK3lhO93RLsPTpaIMSDrQuHkIjwV5C8BMhRsY4sR4E,2085
+elizaos_plugin_github/actions/create_issue.py,sha256=MhZkBlXklTR9WxolJk-jgDGGPk-b-X_kMuRcA7ExcU0,2712
+elizaos_plugin_github/actions/create_pull_request.py,sha256=zkfEROgooBklPuHFuDG3xxn7UtfRMK1g1YLzD_60DN0,2389
+elizaos_plugin_github/actions/merge_pull_request.py,sha256=4xMN-WFNz9UpzDegupeLGt8lSjfMuwIJTxaL5qrw7jM,2645
+elizaos_plugin_github/actions/push_code.py,sha256=mJN3pPKUc1UnK2lzUR09irFnsMFGYyKWSxaSR8O76T4,2700
+elizaos_plugin_github/actions/review_pull_request.py,sha256=YAyC7VJwjc_BXyYnkJBealZvj21P-zUOt46fBTn8fpo,2845
+elizaos_plugin_github/generated/specs/__init__.py,sha256=WbH0CDLPo2YBQZdpOeml1DoGR-TmWsdL1WjKq9pHOC4,37
+elizaos_plugin_github/generated/specs/specs.py,sha256=5kJvpVdvX8JeFTPRTlP2TyJwlcVNUAhwVyZctdIreSo,3918
+elizaos_plugin_github/providers/__init__.py,sha256=1XnEBJa5A5ESIRrGmhH4G9f1v29VaxEFqMu92GhiKYQ,318
+elizaos_plugin_github/providers/issue_context.py,sha256=tfLjG3SOSuESiqjI-Iz18ubaztCl35YYVgo30APZQQ4,4673
+elizaos_plugin_github/providers/repository_state.py,sha256=tTSk25PPUwbouS0KC84jZnH2mZypVTE0pqFhze1Yzek,2963
+elizaos_plugin_github-2.0.0a4.dist-info/METADATA,sha256=EllSuSukLGEnG3IHv_WZEEB-v62eiKK_RyZANuWLHts,3946
+elizaos_plugin_github-2.0.0a4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+elizaos_plugin_github-2.0.0a4.dist-info/RECORD,,

elizaos_plugin_github-2.0.0a4.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any