ocean
ocean copied to clipboard
[Integration][Github] Added Support for Pull Request Kind
Description
What - Added Pull Request resource support to the GitHub V2 integration. This feature allows syncing GitHub pull requests into Port as entities and receiving webhooks for real-time updates.
Why - This enhancement provides users with the ability to track and monitor pull requests directly in Port, enabling better visibility into development workflows and metrics like lead time.
How - Implemented a PullRequestExporter class to fetch pull request data, added webhook support for real-time pull request events, and included configuration options to select pull requests by state (open, closed, or all).
Type of change
Please leave one option from the following and delete the rest:
- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] New Integration (non-breaking change which adds a new integration)
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] Non-breaking change (fix of existing functionality that will not change current behavior)
- [ ] Documentation (added/updated documentation)
All tests should be run against the port production environment(using a testing org).
Core testing checklist
- [ ] Integration able to create all default resources from scratch
- [ ] Resync finishes successfully
- [ ] Resync able to create entities
- [ ] Resync able to update entities
- [ ] Resync able to detect and delete entities
- [ ] Scheduled resync able to abort existing resync and start a new one
- [ ] Tested with at least 2 integrations from scratch
- [ ] Tested with Kafka and Polling event listeners
- [ ] Tested deletion of entities that don't pass the selector
Integration testing checklist
- [ ] Integration able to create all default resources from scratch
- [ ] Resync able to create entities
- [ ] Resync able to update entities
- [ ] Resync able to detect and delete entities
- [ ] Resync finishes successfully
- [ ] If new resource kind is added or updated in the integration, add example raw data, mapping and expected result to the
examplesfolder in the integration directory. - [ ] If resource kind is updated, run the integration with the example data and check if the expected result is achieved
- [ ] If new resource kind is added or updated, validate that live-events for that resource are working as expected
- [ ] Docs PR link here
Preflight checklist
- [ ] Handled rate limiting
- [ ] Handled pagination
- [ ] Implemented the code in async
- [ ] Support Multi account
Screenshots
Include screenshots from your environment showing how the resources of the integration will look.
API Documentation
Provide links to the API documentation used for this integration.
GitHub Pull Requests API:
Additional Notes
- The pull request resource supports filtering by state (open, closed, all) via the selector configuration
- Pull request webhooks provide real-time updates when PRs are opened, edited, closed, or reopened
- Added comprehensive tests for both the exporter and webhook processor
- Improved API flexibility by allowing separate repo_name and pr_number parameters in get_resource method