s3urls

What it is and what it does

s3urls is a lightweight URL parser and builder for Amazon S3 URLs. It handles multiple S3 URL formats—virtual-hosted style (bucket in subdomain), path-style (bucket in path), and the s3:// scheme—and extracts or constructs the bucket name, object key, AWS region, and optional credential name. The package has no external dependencies and is simple to integrate into scripts or tools that need to normalize or manipulate S3 references.

The package is abandoned and has not been updated since its initial release in July 2018. While it has low install friction and a permissive license, the lack of maintenance means it will not adapt to any changes in AWS S3 URL conventions or Python language updates. It is suitable only for stable, legacy use cases where S3 URL parsing requirements are unlikely to change.

Use it for:

• Extract bucket and key from S3 URLs in log files or configuration to automate S3 resource discovery.
• Normalize S3 URLs from different sources into a canonical format for consistent downstream processing.
• Build S3 URLs programmatically with optional region and credential parameters for dynamic resource references.
• Parse s3:// scheme URIs with embedded credential names for local or testing environments.
• Convert between S3 URL styles (virtual-hosted vs. path-style) in migration or compatibility scripts.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Parse and build Amazon S3 URLs in multiple formats, extracting or constructing bucket names, keys, regions, and optional credential names.

Yes, if you have a stable, legacy codebase that only needs basic S3 URL parsing and will not require updates. The package is simple, dependency-free, and permissively licensed. No, if you need active maintenance, support for new AWS features, or confidence that the code will work with future Python versions—the package is abandoned and has not been updated since 2018.

Install

s3urls on PyPI

pip install s3urls

uv add s3urls

poetry add s3urls

Installing s3urls

Before you install

Package is abandoned (last release 2018-07-10, no commits tracked). Install friction is low and it has no runtime dependencies, but the lack of maintenance means it will not receive bug fixes or updates for Python or AWS API changes.

License in practice

MIT license is permissive; you may use, modify, and distribute this package freely with minimal restrictions.

Quickstart

from s3urls import parse_url, build_url

# Parse an S3 URL
parse_url('https://my-bucket.s3.amazonaws.com/my-key/')
# {'bucket': 'my-bucket', 'key': 'my-key/'}

# Build an S3 URL
build_url('s3', 'my-bucket', 'my-key/')
# 's3://my-bucket/my-key/'

Verify before relying

• Whether the package correctly handles all current S3 URL formats and edge cases, given it has not been updated since 2018.
• Whether parsing behavior is consistent across all documented S3 URL styles (virtual-hosted, path-style, s3:// scheme).

Package facts

Evidence: s3urls-0.0.3-py3-none-any.whl

Tags

More Utilities packages