| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 1 | package git |
| 2 | |
| 3 | import ( |
| 4 | "context" |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 5 | "log/slog" |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 6 | "net/http" |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 7 | "os" |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 8 | "time" |
| 9 | ) |
| 10 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 11 | // ExamplePullRequestUsage demonstrates how to use pull request functionality |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 12 | func ExamplePullRequestUsage() { |
| 13 | ctx := context.Background() |
| 14 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 15 | // Create logger |
| 16 | logger := slog.New(slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{Level: slog.LevelInfo})) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 17 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 18 | // Example with GitHub |
| 19 | exampleGitHubPullRequests(ctx, logger) |
| 20 | |
| 21 | // Example with Gerrit |
| 22 | exampleGerritPullRequests(ctx, logger) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 23 | } |
| 24 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 25 | func exampleGitHubPullRequests(ctx context.Context, logger *slog.Logger) { |
| 26 | logger.Info("=== GitHub Pull Request Example ===") |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 27 | |
| 28 | // Create GitHub configuration |
| 29 | githubConfig := GitHubConfig{ |
| 30 | Token: "your-github-token-here", |
| 31 | BaseURL: "https://api.github.com", |
| 32 | HTTPClient: &http.Client{Timeout: 30 * time.Second}, |
| 33 | } |
| 34 | |
| 35 | // Create GitHub pull request provider |
| 36 | githubProvider := NewGitHubPullRequestProvider("owner", "repo", githubConfig) |
| 37 | |
| 38 | // Create Git instance with GitHub pull request capabilities |
| 39 | git := NewGitWithPullRequests("/path/to/repo", GitConfig{ |
| 40 | Timeout: 30 * time.Second, |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 41 | }, githubProvider, logger) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 42 | |
| 43 | // Create a new pull request |
| 44 | prOptions := PullRequestOptions{ |
| 45 | Title: "Add new feature", |
| 46 | Description: "This PR adds a new feature to the application.", |
| 47 | BaseBranch: "main", |
| 48 | HeadBranch: "feature/new-feature", |
| 49 | Labels: []string{"enhancement", "feature"}, |
| 50 | Assignees: []string{"username1", "username2"}, |
| 51 | Reviewers: []string{"reviewer1", "reviewer2"}, |
| 52 | Draft: false, |
| 53 | } |
| 54 | |
| 55 | pr, err := git.CreatePullRequest(ctx, prOptions) |
| 56 | if err != nil { |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 57 | logger.Error("Failed to create pull request", slog.String("error", err.Error())) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 58 | return |
| 59 | } |
| 60 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 61 | logger.Info("Created pull request", slog.String("title", pr.Title), slog.Int("number", pr.Number)) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 62 | |
| 63 | // List pull requests |
| 64 | listOptions := ListPullRequestOptions{ |
| 65 | State: "open", |
| 66 | Author: "username", |
| 67 | BaseBranch: "main", |
| 68 | Limit: 10, |
| 69 | } |
| 70 | |
| 71 | prs, err := git.ListPullRequests(ctx, listOptions) |
| 72 | if err != nil { |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 73 | logger.Error("Failed to list pull requests", slog.String("error", err.Error())) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 74 | return |
| 75 | } |
| 76 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 77 | logger.Info("Found pull requests", slog.Int("count", len(prs))) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 78 | |
| 79 | // Get a specific pull request |
| 80 | pr, err = git.GetPullRequest(ctx, pr.ID) |
| 81 | if err != nil { |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 82 | logger.Error("Failed to get pull request", slog.String("error", err.Error())) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 83 | return |
| 84 | } |
| 85 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 86 | logger.Info("Pull request status", slog.String("state", pr.State)) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 87 | |
| 88 | // Update a pull request |
| 89 | updateOptions := PullRequestOptions{ |
| 90 | Title: "Updated title", |
| 91 | Description: "Updated description", |
| 92 | Labels: []string{"bug", "urgent"}, |
| 93 | } |
| 94 | |
| 95 | updatedPR, err := git.UpdatePullRequest(ctx, pr.ID, updateOptions) |
| 96 | if err != nil { |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 97 | logger.Error("Failed to update pull request", slog.String("error", err.Error())) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 98 | return |
| 99 | } |
| 100 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 101 | logger.Info("Updated pull request", slog.String("title", updatedPR.Title)) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 102 | |
| 103 | // Merge a pull request |
| 104 | mergeOptions := MergePullRequestOptions{ |
| 105 | MergeMethod: "squash", |
| 106 | CommitTitle: "Merge pull request #123", |
| 107 | CommitMsg: "This merges the feature branch into main", |
| 108 | } |
| 109 | |
| 110 | err = git.MergePullRequest(ctx, pr.ID, mergeOptions) |
| 111 | if err != nil { |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 112 | logger.Error("Failed to merge pull request", slog.String("error", err.Error())) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 113 | return |
| 114 | } |
| 115 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 116 | logger.Info("Pull request merged successfully") |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 117 | } |
| 118 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 119 | func exampleGerritPullRequests(ctx context.Context, logger *slog.Logger) { |
| 120 | logger.Info("=== Gerrit Pull Request Example ===") |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 121 | |
| 122 | // Create Gerrit configuration |
| 123 | gerritConfig := GerritConfig{ |
| 124 | Username: "your-username", |
| 125 | Password: "your-http-password-or-api-token", |
| 126 | BaseURL: "https://gerrit.example.com", |
| 127 | HTTPClient: &http.Client{Timeout: 30 * time.Second}, |
| 128 | } |
| 129 | |
| 130 | // Create Gerrit pull request provider |
| 131 | gerritProvider := NewGerritPullRequestProvider("project-name", gerritConfig) |
| 132 | |
| 133 | // Create Git instance with Gerrit pull request capabilities |
| 134 | git := NewGitWithPullRequests("/path/to/repo", GitConfig{ |
| 135 | Timeout: 30 * time.Second, |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 136 | }, gerritProvider, logger) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 137 | |
| 138 | // Create a new change (pull request) |
| 139 | prOptions := PullRequestOptions{ |
| 140 | Title: "Add new feature", |
| 141 | Description: "This change adds a new feature to the application.", |
| 142 | BaseBranch: "master", |
| 143 | HeadBranch: "feature/new-feature", |
| 144 | } |
| 145 | |
| 146 | pr, err := git.CreatePullRequest(ctx, prOptions) |
| 147 | if err != nil { |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 148 | logger.Error("Failed to create change", slog.String("error", err.Error())) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 149 | return |
| 150 | } |
| 151 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 152 | logger.Info("Created change", slog.String("title", pr.Title), slog.Int("number", pr.Number)) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 153 | |
| 154 | // List changes |
| 155 | listOptions := ListPullRequestOptions{ |
| 156 | State: "open", |
| 157 | Author: "username", |
| 158 | BaseBranch: "master", |
| 159 | Limit: 10, |
| 160 | } |
| 161 | |
| 162 | prs, err := git.ListPullRequests(ctx, listOptions) |
| 163 | if err != nil { |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 164 | logger.Error("Failed to list changes", slog.String("error", err.Error())) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 165 | return |
| 166 | } |
| 167 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 168 | logger.Info("Found changes", slog.Int("count", len(prs))) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 169 | |
| 170 | // Get a specific change |
| 171 | pr, err = git.GetPullRequest(ctx, pr.ID) |
| 172 | if err != nil { |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 173 | logger.Error("Failed to get change", slog.String("error", err.Error())) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 174 | return |
| 175 | } |
| 176 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 177 | logger.Info("Change status", slog.String("state", pr.State)) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 178 | |
| 179 | // Update a change |
| 180 | updateOptions := PullRequestOptions{ |
| 181 | Title: "Updated title", |
| 182 | Description: "Updated description", |
| 183 | } |
| 184 | |
| 185 | updatedPR, err := git.UpdatePullRequest(ctx, pr.ID, updateOptions) |
| 186 | if err != nil { |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 187 | logger.Error("Failed to update change", slog.String("error", err.Error())) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 188 | return |
| 189 | } |
| 190 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 191 | logger.Info("Updated change", slog.String("title", updatedPR.Title)) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 192 | |
| 193 | // Submit a change (merge) |
| 194 | mergeOptions := MergePullRequestOptions{ |
| 195 | CommitTitle: "Submit change", |
| 196 | CommitMsg: "This submits the change to master", |
| 197 | } |
| 198 | |
| 199 | err = git.MergePullRequest(ctx, pr.ID, mergeOptions) |
| 200 | if err != nil { |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 201 | logger.Error("Failed to submit change", slog.String("error", err.Error())) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 202 | return |
| 203 | } |
| 204 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 205 | logger.Info("Change submitted successfully") |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 206 | } |
| 207 | |
| 208 | // Example of using both providers in the same application |
| 209 | func ExampleMultiProviderUsage() { |
| 210 | ctx := context.Background() |
| 211 | |
| 212 | // Determine which provider to use based on configuration |
| 213 | useGitHub := true // This could come from config |
| 214 | |
| 215 | var git GitInterface |
| 216 | |
| 217 | if useGitHub { |
| 218 | // Use GitHub |
| 219 | githubConfig := GitHubConfig{ |
| 220 | Token: "github-token", |
| 221 | BaseURL: "https://api.github.com", |
| 222 | } |
| 223 | githubProvider := NewGitHubPullRequestProvider("owner", "repo", githubConfig) |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 224 | git = NewGitWithPullRequests("/path/to/repo", GitConfig{}, githubProvider, nil) // Pass nil for logger as it's not used in this example |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 225 | } else { |
| 226 | // Use Gerrit |
| 227 | gerritConfig := GerritConfig{ |
| 228 | Username: "gerrit-username", |
| 229 | Password: "gerrit-password", |
| 230 | BaseURL: "https://gerrit.example.com", |
| 231 | } |
| 232 | gerritProvider := NewGerritPullRequestProvider("project", gerritConfig) |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 233 | git = NewGitWithPullRequests("/path/to/repo", GitConfig{}, gerritProvider, nil) // Pass nil for logger as it's not used in this example |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 234 | } |
| 235 | |
| 236 | // Use the same interface regardless of provider |
| 237 | prOptions := PullRequestOptions{ |
| 238 | Title: "Cross-platform PR", |
| 239 | Description: "This works with both GitHub and Gerrit", |
| 240 | BaseBranch: "main", |
| 241 | HeadBranch: "feature/cross-platform", |
| 242 | } |
| 243 | |
| 244 | pr, err := git.CreatePullRequest(ctx, prOptions) |
| 245 | if err != nil { |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 246 | slog.Error("Failed to create pull request", slog.String("error", err.Error())) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 247 | return |
| 248 | } |
| 249 | |
| iomodo | 0c203b1 | 2025-07-26 19:44:57 +0400 | [diff] [blame^] | 250 | slog.Info("Created pull request", slog.String("title", pr.Title)) |
| iomodo | 1d17360 | 2025-07-26 15:35:57 +0400 | [diff] [blame] | 251 | } |