Add minio example (#241)

* minio example

* Add to docs

Author: kylebarron

docs/examples/minio.md

@@ -0,0 +1,46 @@
+# Minio
+
+[MinIO](https://github.com/minio/minio) is a high-performance, S3 compatible object store, open sourced under GNU AGPLv3 license. It's often used for testing or self-hosting S3-compatible storage.
+
+We can run minio locally using docker:
+
+```shell
+docker run -p 9000:9000 -p 9001:9001 \
+    quay.io/minio/minio server /data --console-address ":9001"
+```
+
+`obstore` isn't able to create a bucket, so we need to do that manually. We can do that through the minio web UI. After running the above docker command, go to <http://localhost:9001>. Then log in with the credentials `minioadmin`, `minioadmin` for username and password. Then click "Create a Bucket" and create a bucket with the name `"test-bucket"`.
+
+Now we can create an `S3Store` to interact with minio:
+
+```py
+import obstore as obs
+from obstore.store import S3Store
+
+store = S3Store(
+    "test-bucket",
+    aws_endpoint="http://localhost:9000",
+    access_key_id="minioadmin",
+    secret_access_key="minioadmin",
+    aws_virtual_hosted_style_request=False,
+    client_options={"allow_http": True},
+)
+
+# Add files
+obs.put(store, "a.txt", b"foo")
+obs.put(store, "b.txt", b"bar")
+obs.put(store, "c/d.txt", b"baz")
+
+# List files
+files = obs.list(store).collect()
+print(files)
+
+# Download a file
+resp = obs.get(store, "a.txt")
+print(resp.bytes())
+
+# Delete a file
+obs.delete(store, "a.txt")
+```
+
+There's a [full example](https://github.com/developmentseed/obstore/tree/main/examples/minio) in the obstore repository.

examples/fastapi-example/.python-version examples/fastapi/.python-versionexamples/fastapi-example/.python-version renamed to examples/fastapi/.python-version

@@ -0,0 +1 @@
+3.12

examples/fastapi-example/README.md examples/fastapi/README.mdexamples/fastapi-example/README.md renamed to examples/fastapi/README.md

@@ -0,0 +1,22 @@
+# Minio example
+
+[MinIO](https://github.com/minio/minio) is a high-performance, S3 compatible object store, open sourced under GNU AGPLv3 license. It's often used for testing or self-hosting S3-compatible storage.
+
+We can run minio locally using docker:
+
+```shell
+docker run -p 9000:9000 -p 9001:9001 \
+    quay.io/minio/minio server /data --console-address ":9001"
+```
+
+`obstore` isn't able to create a bucket, so we need to do that manually. We can do that through the minio web UI. After running the above docker command, go to <http://localhost:9001>.
+
+Then log in with the credentials `minioadmin`, `minioadmin` for username and password.
+
+Then click "Create a Bucket" and create a bucket with the name `"test-bucket"`.
+
+Now, run the Python script:
+
+```
+uv run python main.py
+```

examples/fastapi-example/main.py examples/fastapi/main.pyexamples/fastapi-example/main.py renamed to examples/fastapi/main.py

@@ -0,0 +1,35 @@
+import asyncio
+
+import obstore as obs
+from obstore.store import S3Store
+
+
+async def main():
+    store = S3Store(
+        "test-bucket",
+        aws_endpoint="http://localhost:9000",
+        access_key_id="minioadmin",
+        secret_access_key="minioadmin",
+        aws_virtual_hosted_style_request=False,
+        client_options={"allow_http": True},
+    )
+
+    print("Put file:")
+    await obs.put_async(store, "a.txt", b"foo")
+    await obs.put_async(store, "b.txt", b"bar")
+    await obs.put_async(store, "c/d.txt", b"baz")
+
+    print("\nList files:")
+    files = await obs.list(store).collect_async()
+    print(files)
+
+    print("\nFetch a.txt")
+    resp = await obs.get_async(store, "a.txt")
+    print(await resp.bytes_async())
+
+    print("\nDelete a.txt")
+    await obs.delete_async(store, "a.txt")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

examples/fastapi-example/pyproject.toml examples/fastapi/pyproject.tomlexamples/fastapi-example/pyproject.toml renamed to examples/fastapi/pyproject.toml

@@ -0,0 +1,14 @@
+[project]
+name = "progress-bar"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = ["obstore"]
+
+# TODO: remove this; use published obstore
+[tool.uv.sources]
+obstore = { path = "../../obstore" }
+
+[dependency-groups]
+dev = ["ipykernel>=6.29.5"]