joinpath

Join path operator implementation.

class s3pathlib.core.joinpath.JoinPathAPIMixin

A mixin class that implements the join path operator.

joinpath(*other: str | S3Path) → S3Path

Join with other relative path or string parts.

Example:

# join with string parts
>>> p = S3Path("bucket")
>>> p.joinpath("folder", "file.txt")
S3Path('s3://bucket/folder/file.txt')

# join ith relative path or string parts
>>> p = S3Path("bucket")
>>> relpath = S3Path("my-bucket", "data", "folder/").relative_to(S3Path("my-bucket", "data"))
>>> p.joinpath("data", relpath, "file.txt")
S3Path('s3://bucket/data/folder/file.txt')

Parameters:

others – many string or relative path

New in version 1.1.1.