Universal Pathlib

import os
from upath import UPath

# Example for S3 (requires 's3fs' to be installed and AWS credentials configured)
# You can use environment variables for credentials or pass storage_options
S3_BUCKET = os.environ.get('S3_TEST_BUCKET', 'your-test-s3-bucket')
S3_KEY = 'example.txt'

# Create a UPath object for an S3 location
s3path = UPath(f"s3://{S3_BUCKET}") / S3_KEY

# Write content to the S3 file
try:
    s3path.write_text('Hello from Universal Pathlib!')
    print(f"Successfully wrote to {s3path}.")

    # Read content from the S3 file
    content = s3path.read_text()
    print(f"Content of {s3path}: '{content}'.")

    # Check if the path exists
    print(f"Does {s3path} exist? {s3path.exists()}.")

    # List contents of the parent directory (if bucket exists and is not empty)
    print(f"Listing contents of {s3path.parent}:")
    for p in s3path.parent.iterdir():
        print(f"  - {p}")

finally:
    # Clean up: delete the created file
    if s3path.exists():
        s3path.unlink()
        print(f"Cleaned up: deleted {s3path}.")

# Example for a local file (no additional fsspec backend needed)
local_path = UPath("local_example.txt")
local_path.write_text("This is a local file.")
print(f"Local file content: {local_path.read_text()}")
local_path.unlink()