https://github.com/gearplug/bitbucket-python
Bitbucket wrapper written in python
https://github.com/gearplug/bitbucket-python
api api-wrapper bitbucket bitbucket-api python wrapper
Last synced: 4 months ago
JSON representation
Bitbucket wrapper written in python
- Host: GitHub
- URL: https://github.com/gearplug/bitbucket-python
- Owner: GearPlug
- License: mit
- Created: 2017-12-05T13:54:34.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-07-25T21:30:13.000Z (almost 3 years ago)
- Last Synced: 2025-04-28T11:37:01.836Z (about 1 year ago)
- Topics: api, api-wrapper, bitbucket, bitbucket-api, python, wrapper
- Language: Python
- Homepage:
- Size: 59.6 KB
- Stars: 22
- Watchers: 1
- Forks: 23
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
bitbucket-python is an API wrapper for Bitbucket written in Python
## Installing
```
pip install bitbucket-python
```
## Usage
```python
from bitbucket.client import Client
from bitbucket import AsyncClient
client = Client('EMAIL', 'PASSWORD')
# Or to specify owner URL to find repo own by other user
client = Client('EMAIL', 'PASSWORD', 'Owner')
# Async client
async with AsyncClient('EMAIL', 'PASSWORD') as client:
...
```
### Methods
Get user information
```
response = client.get_user()
```
Get account privileges for repositories
```
response = client.get_privileges()
```
Get repositories
```
response = client.get_repositories()
```
Get repository
```
response = client.get_repository('REPOSITORY_SLUG')
```
Post repository
```
response = client.create_repository(data, params, repositoryName, teamName)
```
Get branches for repository
```
response = client.get_repository_branches('REPOSITORY_SLUG')
```
Get tags for repository
```
response = client.get_repository_tags('REPOSITORY_SLUG')
```
Get commits for a repository
```
response = client.get_repository_commits('REPOSITORY_SLUG')
```
Get components for repository
```
response = client.get_repository_components('REPOSITORY_SLUG')
```
Get milestones for repository
```
response = client.get_repository_milestones('REPOSITORY_SLUG')
```
Get versions for repository
```
response = client.get_repository_versions('REPOSITORY_SLUG')
```
Create issue
```
data = {..DATA..}
response = client.create_issue('REPOSITORY_SLUG', data)
```
Get all issues
```
response = client.get_issues('REPOSITORY_SLUG')
```
Get issue
```
response = client.get_issue('REPOSITORY_SLUG', 'ISSUE_ID')
```
Delete issue
```
response = client.delete_issue('REPOSITORY_SLUG', 'ISSUE_ID')
```
### Webhooks
Create webhook
```
data = {
"description": "Webhook",
"url": "http://mywebsite.com",
"active": True,
"events": [
"repo:push",
"issue:created",
"issue:updated"
]
}
response = client.create_webhook('REPOSITORY_SLUG', data)
```
Get all webhooks
```
response = client.get_webhooks('REPOSITORY_SLUG')
```
Get webhook
```
response = client.get_webhook('REPOSITORY_SLUG', 'WEBHOOK_ID')
```
Delete webhook
```
response = client.delete_webhook('REPOSITORY_SLUG', 'WEBHOOK_ID')
```
### Helper methods
### all_pages
The `all_pages` method is a helper function that makes it easy to retrieve all items from an API methods that uses pagination (see https://developer.atlassian.com/cloud/bitbucket/rest/intro/#pagination).
```python
client = Client()
items = list(client.all_pages(client.get_repositories))
```
Note that the `all_pages` method uses a generator to return the results.
## Requirements
- requests
- [httpx](https://github.com/encode/httpx/)