---
id: s3urls
version: "0.0.3"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# s3urls — Parse and build Amazon S3 URLs

License: permissive · Maintenance: abandoned · Downloads: 80.8K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: abandoned
- Downloads: 80.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

parse s3 urls, build s3 urls, s3 url parsing, amazon s3 url handling, s3 bucket and key extraction, s3 url builder, s3 uri parser, s3-url-parsing, abandoned-package

[View on SkillFed](https://skillfed.io/packages/s3urls) · [View on PyPI](https://pypi.org/project/s3urls/)