Feat: BitBucket Intergration

[Gahdloot]

User description

…ntication and webhook handling

Description

What - This pull request introduces a Bitbucket Cloud integration for Port's Ocean framework, allowing users to import and manage Bitbucket projects, repositories, pull requests, and components within Port.

Why -

• Establishes a seamless connection between Bitbucket Cloud and Port.
• Enables real-time updates through webhooks.
• Optimizes performance with fully asynchronous API requests.
• Incorporates rate-limit handling and pagination for improved stability.

How -

• Utilizes Ocean’s asynchronous HTTP client for API interactions.
• Implements authentication with the Bitbucket API using App Passwords.
• Supports both scheduled and on-demand synchronization for precise data ingestion.
• Handles webhook events to facilitate real-time updates.

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 examples folder 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.

---

PR Type

Enhancement, Documentation, Tests

---

Description

• Introduces Bitbucket Cloud integration for Port Ocean.

  • Implements authentication using Basic Auth with App Passwords.
  • Adds support for fetching projects, repositories, pull requests, and components.
  • Handles pagination and rate-limiting with exponential backoff.

• Defines resource mappings and blueprints for Bitbucket entities.

• Provides configuration and setup files for local development and testing.

• Includes initial test cases and development tools setup.

---

Changes walkthrough 📝

	Relevant files
Enhancement	6 files client.py Implements Bitbucket API client with authentication and data fetching +132/-0  debug.py Adds debug entry point for integration                                      +4/-0      main.py Implements resync handlers for Bitbucket resources              +64/-0    blueprints.json Defines blueprints for Bitbucket resources                              +77/-0    port-app-config.yml Maps Bitbucket resources to Port entities                                +44/-0    spec.yaml Specifies integration metadata and configurations                +28/-0
Tests	1 files test_sample.py Adds a placeholder test case                                                          +2/-0
Configuration changes	6 files launch.json Adds debug configuration for Bitbucket integration              +14/-1    .env.example Provides example environment variables for integration      +6/-0      Makefile Links to shared Makefile for integration                                  +1/-0      poetry.toml Configures virtual environment for integration                      +3/-0      pyproject.toml Sets up project dependencies and tools                                      +113/-0  sonar-project.properties Configures SonarQube project properties                                    +2/-0
Documentation	3 files CHANGELOG.md Adds changelog for Bitbucket integration                                  +8/-0      CONTRIBUTING.md Adds contributing guidelines for integration                          +7/-0      README.md Adds README for Bitbucket integration                                        +7/-0
Additional files	1 files __init__.py [link]

---

Need help?

Type /help how to ... in the comments thread for any questions about Qodo Merge usage.

Check out the documentation for more information.