ObjectScale S3 Client for Python (based on boto3)
Link to Project Management Software: https://app.clickup.com/14398002/v/l/7-14398002-1
This is a library developed for Dell Technologies extending the boto3 Python library for metadata search calls.
The library takes existing S3 API calls designed for boto3 and implements new search indexes for metadata search functionality. It also generates new S3 API calls with metadata search functionality. A stretch goal for the project is implementation of client-side load balancing to improve preformance of the boto3 library.
The library will be accessible through PyPI. Project information can be seen here:
Python is neccessary to have installed before using the library. The project will function with Python versions past Python 3.9. If the user wants to contribute to the project, Git will also be neccessary. As this library extends the existing boto3 and botocore libraries, these are also necessary prerequisites.
The package can be installed through pip, which comes with the installation of Python. Installation of the package can be done by simply executing the following command:
pip install objectscale-s3-client
High-level functionality described in summary info. As the product is being developed this section will be updated with more specific info.
TODO: Write usage instructions. Structuring it as a walkthrough can help structure this section, and showcase your features.
As the product is being developed, this section will be updated with known bugs.
TODO: Describe any known issues, bugs, odd behaviors or code smells. Provide steps to reproduce the problem and/or name a file or a function where the problem lives.
Contributions to the project are welcomed. Outline of steps for contributions are given below:
- Create a new GitHub issue or find one to work on
- Assign the issue to yourself
- Fork project, make changes, get reviewed by Dell project maintainer
- DCO sign off
Additional details for these requirements can be found in the CONTRIBUTING.md file in the project repository.
The documentation module Sphinx was used for documenting the code. This documentation can be accessed through the earlier linked github code.
The documentation can be generated using the following script.
git checkout gh-pages
git rm -rf .
git checkout main -- docs
make html
git add .
git commit -s -m "updated docs"
git push
The script checks out the orphan gh-pages branch, removes all existing files, then copies the updated docs in the main branch. "make html" generates the new documentation and the final commands push the updates to github.
This project uses the Apache License. The license can be viewed in the LICENSE file in the project repository.
- install objectscale python package using pip install
- install pipdeptree using pip install
- run command 'pipdeptree -p obs-s3-client'
- dependency tree should be displayed