s3pathlib
s3pathlib is the python package provides the Pythonic objective oriented programming (OOP) interface to manipulate AWS S3 object / directory. The api is similar to the pathlib standard library and very intuitive for human.
Decision gist · record as of 2026-08-14
Yes, if you work regularly with S3 and prefer a Pythonic path-like interface over raw boto3 calls. The low install friction and permissive license make it a safe add. Caveat: maintenance is aging (last release 367 days ago), so verify it still works with your boto3 version and check for any open issues matching your use case before committing to production.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires valid AWS credentials configured in your boto3 session (via environment, config file, or explicit profile).
- Low install friction; pure Python wheel with six runtime dependencies (boto3, boto_session_manager, func_args, iterproxy, pathlib_mate, smart_open).
- Last release was 367 days ago; repo is not archived but maintenance signal is aging.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license; you may use, modify, and distribute freely in commercial and private projects with minimal restrictions.
last release 2025-08-12 (367 days) · last repo commit 2025-08-12 · 4 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 902,567 downloads/mo, #4,768 on PyPI
Alternatives
Verify before relying
from s3pathlib import S3Path
import boto3
from s3pathlib import context
context.attach_boto_session(boto3.session.Session(region_name="us-east-1"))
p = S3Path("bucket", "folder", "file.txt")
p.write_text("data")
print(p.etag, p.size)- Whether the package handles concurrent S3 operations safely or has thread-safety guarantees.
- Performance characteristics when iterating over buckets with millions of objects.
- Compatibility with S3-compatible services (MinIO, LocalStack) beyond AWS S3.
What it is and what it does
s3pathlib wraps boto3 with a pathlib-inspired API so you work with S3 objects and directories using familiar Python path operations. Instead of calling boto3 client methods directly, you construct S3Path objects from bucket and key components (or S3 URIs and ARNs), then call methods like write_text(), read_text(), open(), and delete() as if they were local filesystem paths.
The package handles the complexity of S3's flat object model and pagination limits by providing recursive folder operations (upload_dir, copy_to, delete), object filtering by size/extension/etag/mtime, and file-like I/O for streaming large objects. It maintains a context object that holds your boto3 session, so you configure credentials once and reuse them across all S3Path instances.
Use it for
- Upload entire local directory trees to S3 with pattern matching (e.g., all .py files) without manual pagination.
- Copy or delete S3 folders recursively in a single call, avoiding manual list-and-delete loops.
- Stream large S3 objects line-by-line or into pandas DataFrames using context-manager syntax.
- Filter S3 objects by size, extension, or modification time before processing, reducing unnecessary data transfer.
- Inspect S3 object metadata (etag, size, human-readable size) and folder statistics (object count, total size) with simple method calls.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you work regularly with S3 and prefer a Pythonic path-like interface over raw boto3 calls.
The low install friction and permissive license make it a safe add. Caveat: maintenance is aging (last release 367 days ago), so verify it still works with your boto3 version and check for any open issues matching your use case before committing to production.
Install
s3pathlib on PyPI
Before you install
Low install friction; pure Python wheel with six runtime dependencies (boto3, boto_session_manager, func_args, iterproxy, pathlib_mate, smart_open). Last release was 367 days ago; repo is not archived but maintenance signal is aging.
Requires valid AWS credentials configured in your boto3 session (via environment, config file, or explicit profile).
License in practice
Apache-2.0 permissive license; you may use, modify, and distribute freely in commercial and private projects with minimal restrictions.
Quickstart
from s3pathlib import S3Path
import boto3
from s3pathlib import context
context.attach_boto_session(boto3.session.Session(region_name="us-east-1"))
p = S3Path("bucket", "folder", "file.txt")
p.write_text("data")
print(p.etag, p.size)Verify before relying
- Whether the package handles concurrent S3 operations safely or has thread-safety guarantees.
- Performance characteristics when iterating over buckets with millions of objects.
- Compatibility with S3-compatible services (MinIO, LocalStack) beyond AWS S3.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release <4.0,>=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 6 packagesboto3boto_session_managerfunc_argsiterproxypathlib_matesmart_open |
| Maintenance | Aging 367 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 902,567 / month, #4,768 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9 |
Evidence: s3pathlib-2.3.6-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “s3 path manipulation”
- s3pathlibs3pathlib provides a pathlib-like object-oriented interface to AWS…
- s3pathS3Path provides a pathlib-like interface for working with AWS S3…
- pathyPathy provides a pathlib-compatible interface for working with cloud…
Give your agent the search over MCP, or paste the wish link into any chat.
More Utilities packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Pygments is a syntax highlighter that colorizes source code and text in over 500 languages and formats, outputting to HTML, LaTeX, RTF, SVG, images, or ANSI terminal sequences.
Install it if you need to display or transform source code.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
See also s3path · cloudpathlib · s3fs · pathy · universal-pathlib · aws-cdk.aws-s3 · fs-s3fs · git-remote-s3 · s3urls · s3transfer