oci-bucket 1.0.3

Package for easy Oci Buckets management in python.

OCI Bucket Framework

For easier OCI blob manipulation, read, download, etc.

Import

from oci_bucket import OciBucket

Load from Instance Principal

storage_client = OciBucket.client().from_instance_principal()
oci_bucket = OciBucket(storage_client, bucket_name)

Load from OCI Config File

storage_client = OciBucket.client().from_file() # Defaults to ~/.oci/config
oci_bucket = OciBucket(storage_client, bucket_name)

Methods

Note that limit is set to 1000 by default, this limitation comes from original oci.object_storage.ObjectStorageClient.object_list. This lib can go further and handle the pagination for you, just use limit beyond 1000.

files = oci_bucket.list_folder('multiples', limit=12) # retrives files from directory
files = oci_bucket.glob('multiples/1{1,2}0{3,4}.txt', limit=30) # Linux ls pattern can be used for blob filtering.
files = oci_bucket.glob('*audio*wav', limit=30) # Using wildcard '*'
file = oci_bucket.get_file('multiples/0005.txt') # Or just retrieve a specifi file directly

Handling Files in Bucket

oci_bucket.upload_file('acdc.csv', 'csvs') # Upload local file to bucket
oci_bucket.get_file('csvs/acdc.csv').download('local_dir') # Download buckt file to local
oci_bucket.get_file('csvs/acdc.csv').copy('new_csvs') # Copies a file in a bucket to another
oci_bucket.get_file('csvs/acdc.csv').move('new_csvs') # Moves a file in a bucket to another
oci_bucket.get_file('csvs/acdc.csv').delete() # Deletes a file in bucket

Blob Usage

As you can retrieve both a list of files or just a specific one, the blob files have methods on their own.

Load Pandas dataframe Direct From CSV file bytes.

import pandas as pd
from io import BytesIO
file_bytes = oci_bucket.get_file('csvs/acdc.csv').get_bytes()
df = pd.read_csv(BytesIO(file_bytes))