wolfsoftware.dockerhub-extractor
Extract container information for a given user in DockerHub.
https://github.com/developerstoolbox/dockerhub-extractor-package
Science Score: 44.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (9.9%) to scientific vocabulary
Keywords
Repository
Extract container information for a given user in DockerHub.
Basic Info
Statistics
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 6
- Releases: 3
Topics
Metadata Files
README.md
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
dockerhubextractor.setusername("yourdockerhubusername")
Get detailed information for all repositories
try: repositoriesdetails = dockerhubextractor.getallrepositoriesdetails() print(repositoriesdetails) 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
DockerHubExtractorwith 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.
Owner
- Name: Developers Toolbox
- Login: DevelopersToolbox
- Kind: organization
- Email: github@wolfsoftware.com
- Location: United Kingdom
- Website: https://wolfsoftware.com
- Twitter: wolfsoftware
- Repositories: 24
- Profile: https://github.com/DevelopersToolbox
A selection of tools to help developers. Created by Wolf Software.
Citation (CITATION.cff)
cff-version: 1.2.0
message: If you use this software, please cite it using these metadata.
title: DockerHub Extractor
abstract: Extract container information for a given user in DockerHub.
type: software
version: 0.1.1
date-released: 2024-06-26
repository-code: https://github.com/DevelopersToolbox/dockerhub-extractor-package
keywords:
- "Wolf Software"
- "Software"
license: MIT
authors:
- family-names: "Wolf"
orcid: "https://orcid.org/0009-0007-0983-2072"
GitHub Events
Total
- Delete event: 82
- Issue comment event: 170
- Push event: 128
- Pull request review event: 128
- Pull request event: 158
- Create event: 83
Last Year
- Delete event: 82
- Issue comment event: 170
- Push event: 128
- Pull request review event: 128
- Pull request event: 158
- Create event: 83
Issues and Pull Requests
Last synced: 4 months ago
All Time
- Total issues: 0
- Total pull requests: 123
- Average time to close issues: N/A
- Average time to close pull requests: 3 days
- Total issue authors: 0
- Total pull request authors: 2
- Average comments per issue: 0
- Average comments per pull request: 1.57
- Merged pull requests: 83
- Bot issues: 0
- Bot pull requests: 122
Past Year
- Issues: 0
- Pull requests: 96
- Average time to close issues: N/A
- Average time to close pull requests: 3 days
- Issue authors: 0
- Pull request authors: 1
- Average comments per issue: 0
- Average comments per pull request: 1.51
- Merged pull requests: 61
- Bot issues: 0
- Bot pull requests: 96
Top Authors
Issue Authors
- dependabot[bot] (2)
Pull Request Authors
- dependabot[bot] (179)
- TGWolf (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 7 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 2
- Total maintainers: 1
pypi.org: wolfsoftware.dockerhub-extractor
Extract container information for a given user in DockerHub.
- Homepage: https://github.com/DevelopersToolbox/dockerhub-extractor-package
- Documentation: https://github.com/DevelopersToolbox/dockerhub-extractor-package
- License: MIT
-
Latest release: 0.1.1
published over 1 year ago