Feature/bitbucket ocean Add initial Bitbucket integration with authe…

[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, Tests

---

Description

• Introduced a new Bitbucket integration for Port's Ocean framework.

• Implemented authentication using Basic Auth with App Passwords.

• Added support for fetching projects, repositories, and pull requests.

• Included webhook handling and data ingestion into Port.

• Provided comprehensive unit tests for authentication, integration, and webhook handling.

---

Changes walkthrough 📝

	Relevant files
Enhancement	4 files auth.py Added Basic Authentication logic for Bitbucket API              +24/-0    integration.py Implemented core Bitbucket integration with data fetching +104/-0  webhook.py Added webhook handling for Bitbucket events                            +6/-0      main.py Created entry point for Bitbucket integration execution    +17/-0
Configuration changes	3 files config.py Added configuration management for Bitbucket integration  +44/-0    Makefile Linked infrastructure Makefile for Bitbucket integration  +1/-0      pytest.ini Configured pytest for Bitbucket integration tests                +6/-0
Tests	3 files test_auth.py Added unit tests for authentication logic                                +29/-0    test_integration.py Added unit tests for Bitbucket integration methods              +43/-0    test_webhook.py Added unit tests for webhook event handling                            +52/-0
Dependencies	1 files pyproject.toml Added project metadata and dependencies for Bitbucket integration +20/-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.