https://github.com/developerstoolbox/dockerhub-extractor-package
Extract container information for a given user in DockerHub.
https://github.com/developerstoolbox/dockerhub-extractor-package
dockerhub wolfsoftware
Last synced: 6 months ago
JSON representation
Extract container information for a given user in DockerHub.
- Host: GitHub
- URL: https://github.com/developerstoolbox/dockerhub-extractor-package
- Owner: DevelopersToolbox
- License: mit
- Created: 2024-05-30T14:49:41.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-23T05:24:41.000Z (7 months ago)
- Last Synced: 2025-06-23T06:26:58.168Z (7 months ago)
- Topics: dockerhub, wolfsoftware
- Language: Python
- Homepage:
- Size: 208 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
## Overview
DockerHub Extractor is a Python package designed to fetch and process detailed information about repositories hosted on Docker Hub.
This package is particularly useful for users who want to retrieve and analyze metadata for repositories maintained by a specific Docker Hub user.
## Features
- Retrieve a list of repositories maintained by a specific Docker Hub user.
- Fetch detailed metadata for each repository, including information such as tags, stars, pulls, and more.
- Custom exceptions for handling errors gracefully.
- Option to set the Docker Hub username after initializing the class.
## Installation
You can install the package using pip:
```sh
pip install wolfsoftware.dockerhub-extractor
```
## Usage
### Basic Usage
Here's a basic example of how to use the DockerHub Extractor:
```python
from wolfsoftware.dockerhub_extractor import DockerHubExtractor
# Initialize without username
dockerhub_extractor = DockerHubExtractor()
# Set username later
dockerhub_extractor.set_username("your_dockerhub_username")
# Get detailed information for all repositories
try:
repositories_details = dockerhub_extractor.get_all_repositories_details()
print(repositories_details)
except DockerHubExtractorError as e:
print(f"An error occurred: {e.message}")
```
### Setting Username During Initialization
You can also set the username during initialization:
```python
dockerhub_extractor = DockerHubExtractor("your_dockerhub_username")
```
### Retrieving User Repositories
You can retrieve a list of repositories maintained by a specific user:
```python
repositories = dockerhub_extractor.get_user_repositories()
print(repositories)
```
### Retrieving Repository Details
To get detailed information about a specific repository:
```python
repository_details = dockerhub_extractor.get_repository_details("repository_name")
print(repository_details)
```
## API Reference
### Classes
#### `DockerHubExtractor`
A class to fetch and process repository details for a given Docker Hub user.
##### `__init__(self, username: str)`
- Initializes the `DockerHubExtractor` with a username.
- Parameters:
- `username` (str): The Docker Hub username.
- Raises:
- `DockerHubExtractorError`: If the username is not provided.
##### `set_username(self, username: str)`
- Sets the Docker Hub username.
- Parameters:
- `username` (str): The Docker Hub username.
- Raises:
- `DockerHubExtractorError`: If the username is not provided.
##### `get_user_repositories(self) -> list`
- Fetches the list of repositories for the given Docker Hub user.
- Returns:
- `list`: A list of dictionaries containing repository names and summaries.
- Raises:
- `DockerHubExtractorError`: If there is an error fetching or parsing the user profile.
##### `get_repository_details(self, repository_name: str) -> dict`
- Fetches detailed information for a specific repository.
- Parameters:
- `repository_name` (str): The name of the repository.
- Returns:
- `dict`: A dictionary containing detailed information about the repository.
- Raises:
- `DockerHubExtractorError`: If there is an error fetching or parsing the repository details.
##### `get_all_repositories_details(self) -> list`
- Fetches detailed information for all repositories of the given Docker Hub user.
- Returns:
- `list`: A list of dictionaries containing detailed information about each repository.
- Raises:
- `DockerHubExtractorError`: If there is an error fetching or processing the repository details.
#### `DockerHubExtractorError`
Custom exception class for `DockerHubExtractor` errors.
