Add region, extra_headers and extra_query_params

Now all APIs accepts region, extra_headers and extra_query_params
additional arguments for more control.

Signed-off-by: Bala.FA <[email protected]>

Author: balamurugana

examples/append_object.py

@@ -17,41 +17,54 @@
 import io
 from urllib.request import urlopen
 
-from examples.progress import Progress
 from minio import Minio
 
 client = Minio(
-    "play.min.io",
+    endpoint="play.min.io",
     access_key="Q3AM3UQ867SPQQA43P2F",
     secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
 )
 
 # Upload data.
 result = client.put_object(
-    "my-bucket", "my-object", io.BytesIO(b"hello, "), 7,
+    bucket_name="my-bucket",
+    object_name="my-object",
+    data=io.BytesIO(b"hello, "),
+    length=7,
 )
 print(f"created {result.object_name} object; etag: {result.etag}")
 
 # Append data.
 result = client.append_object(
-    "my-bucket", "my-object", io.BytesIO(b"world"), 5,
+    bucket_name="my-bucket",
+    object_name="my-object",
+    data=io.BytesIO(b"world"),
+    length=5,
 )
 print(f"appended {result.object_name} object; etag: {result.etag}")
 
 # Append data in chunks.
-data = urlopen(
+with urlopen(
     "https://www.kernel.org/pub/linux/kernel/v6.x/linux-6.13.12.tar.xz",
-)
-result = client.append_object(
-    "my-bucket", "my-object", data, 148611164, 5*1024*1024,
-)
-print(f"appended {result.object_name} object; etag: {result.etag}")
+) as data:
+    result = client.append_object(
+        bucket_name="my-bucket",
+        object_name="my-object",
+        data=data,
+        length=148611164,
+        chunk_size=5*1024*1024,
+    )
+    print(f"appended {result.object_name} object; etag: {result.etag}")
 
 # Append unknown sized data.
-data = urlopen(
+with urlopen(
     "https://www.kernel.org/pub/linux/kernel/v6.x/linux-6.14.3.tar.xz",
-)
-result = client.append_object(
-    "my-bucket", "my-object", data, 149426584, 5*1024*1024,
-)
-print(f"appended {result.object_name} object; etag: {result.etag}")
+) as data:
+    result = client.append_object(
+        bucket_name="my-bucket",
+        object_name="my-object",
+        data=data,
+        length=149426584,
+        chunk_size=5*1024*1024,
+    )
+    print(f"appended {result.object_name} object; etag: {result.etag}")

examples/bucket_exists.py

@@ -17,12 +17,12 @@
 from minio import Minio
 
 client = Minio(
-    "play.min.io",
+    endpoint="play.min.io",
     access_key="Q3AM3UQ867SPQQA43P2F",
     secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
 )
 
-if client.bucket_exists("my-bucket"):
+if client.bucket_exists(bucket_name="my-bucket"):
     print("my-bucket exists")
 else:
     print("my-bucket does not exist")

examples/compose_object.py

@@ -19,33 +19,48 @@
 from minio.sse import SseS3
 
 client = Minio(
-    "play.min.io",
+    endpoint="play.min.io",
     access_key="Q3AM3UQ867SPQQA43P2F",
     secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
 )
 
 sources = [
-    ComposeSource("my-job-bucket", "my-object-part-one"),
-    ComposeSource("my-job-bucket", "my-object-part-two"),
-    ComposeSource("my-job-bucket", "my-object-part-three"),
+    ComposeSource(
+        bucket_name="my-job-bucket", object_name="my-object-part-one",
+    ),
+    ComposeSource(
+        bucket_name="my-job-bucket", object_name="my-object-part-two",
+    ),
+    ComposeSource(
+        bucket_name="my-job-bucket", object_name="my-object-part-three",
+    ),
 ]
 
 # Create my-bucket/my-object by combining source object
 # list.
-result = client.compose_object("my-bucket", "my-object", sources)
+result = client.compose_object(
+    bucket_name="my-bucket",
+    object_name="my-object",
+    sources=sources,
+)
 print(result.object_name, result.version_id)
 
 # Create my-bucket/my-object with user metadata by combining
 # source object list.
 result = client.compose_object(
-    "my-bucket",
-    "my-object",
-    sources,
-    metadata={"test_meta_key": "test_meta_value"},
+    bucket_name="my-bucket",
+    object_name="my-object",
+    sources=sources,
+    user_metadata={"test_meta_key": "test_meta_value"},
 )
 print(result.object_name, result.version_id)
 
 # Create my-bucket/my-object with user metadata and
 # server-side encryption by combining source object list.
-client.compose_object("my-bucket", "my-object", sources, sse=SseS3())
+client.compose_object(
+    bucket_name="my-bucket",
+    object_name="my-object",
+    sources=sources,
+    sse=SseS3(),
+)
 print(result.object_name, result.version_id)

examples/copy_object.py

@@ -20,38 +20,41 @@
 from minio.commonconfig import REPLACE, CopySource
 
 client = Minio(
-    "play.min.io",
+    endpoint="play.min.io",
     access_key="Q3AM3UQ867SPQQA43P2F",
     secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
 )
 
 # copy an object from a bucket to another.
 result = client.copy_object(
-    "my-bucket",
-    "my-object",
-    CopySource("my-sourcebucket", "my-sourceobject"),
+    bucket_name="my-bucket",
+    object_name="my-object",
+    source=CopySource(
+        bucket_name="my-sourcebucket", object_name="my-sourceobject",
+    ),
 )
 print(result.object_name, result.version_id)
 
 # copy an object with condition.
 result = client.copy_object(
-    "my-bucket",
-    "my-object",
-    CopySource(
-        "my-sourcebucket",
-        "my-sourceobject",
+    bucket_name="my-bucket",
+    object_name="my-object",
+    source=CopySource(
+        bucket_name="my-sourcebucket",
+        object_name="my-sourceobject",
         modified_since=datetime(2014, 4, 1, tzinfo=timezone.utc),
     ),
 )
 print(result.object_name, result.version_id)
 
 # copy an object from a bucket with replacing metadata.
-metadata = {"test_meta_key": "test_meta_value"}
 result = client.copy_object(
-    "my-bucket",
-    "my-object",
-    CopySource("my-sourcebucket", "my-sourceobject"),
-    metadata=metadata,
+    bucket_name="my-bucket",
+    object_name="my-object",
+    source=CopySource(
+        bucket_name="my-sourcebucket", object_name="my-sourceobject",
+    ),
+    user_metadata={"test_meta_key": "test_meta_value"},
     metadata_directive=REPLACE,
 )
 print(result.object_name, result.version_id)

examples/delete_bucket_encryption.py

@@ -17,9 +17,9 @@
 from minio import Minio
 
 client = Minio(
-    "play.min.io",
+    endpoint="play.min.io",
     access_key="Q3AM3UQ867SPQQA43P2F",
     secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
 )
 
-client.delete_bucket_encryption("my-bucket")
+client.delete_bucket_encryption(bucket_name="my-bucket")

examples/delete_bucket_lifecycle.py

@@ -17,9 +17,9 @@
 from minio import Minio
 
 client = Minio(
-    "play.min.io",
+    endpoint="play.min.io",
     access_key="Q3AM3UQ867SPQQA43P2F",
     secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
 )
 
-client.delete_bucket_lifecycle("my-bucket")
+client.delete_bucket_lifecycle(bucket_name="my-bucket")

examples/delete_bucket_notification.py

@@ -17,9 +17,9 @@
 from minio import Minio
 
 client = Minio(
-    "play.min.io",
+    endpoint="play.min.io",
     access_key="Q3AM3UQ867SPQQA43P2F",
     secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
 )
 
-client.delete_bucket_notification("my-bucket")
+client.delete_bucket_notification(bucket_name="my-bucket")

examples/delete_bucket_policy.py

@@ -17,9 +17,9 @@
 from minio import Minio
 
 client = Minio(
-    "play.min.io",
+    endpoint="play.min.io",
     access_key="Q3AM3UQ867SPQQA43P2F",
     secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
 )
 
-client.delete_bucket_policy("my-bucket")
+client.delete_bucket_policy(bucket_name="my-bucket")

examples/delete_bucket_replication.py

@@ -17,9 +17,9 @@
 from minio import Minio
 
 client = Minio(
-    "play.min.io",
+    endpoint="play.min.io",
     access_key="Q3AM3UQ867SPQQA43P2F",
     secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
 )
 
-client.delete_bucket_replication("my-bucket")
+client.delete_bucket_replication(bucket_name="my-bucket")

examples/delete_bucket_tags.py

@@ -17,9 +17,9 @@
 from minio import Minio
 
 client = Minio(
-    "play.min.io",
+    endpoint="play.min.io",
     access_key="Q3AM3UQ867SPQQA43P2F",
     secret_key="zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG",
 )
 
-client.delete_bucket_tags("my-bucket")
+client.delete_bucket_tags(bucket_name="my-bucket")