Metadata-Version: 2.1
Name: s3access
Version: 0.8.0
Summary: Access Parquet files in S3 via S3 Select
Home-page: https://github.com/scravy/s3access
Author: Julian Fleischer
Author-email: tirednesscankill@warhog.net
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: readstr (>=0.5.0)
Requires-Dist: boto3 (>=1.17.0)
Provides-Extra: async
Requires-Dist: aiobotocore (>=1.3.0) ; extra == 'async'
Provides-Extra: dev
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: readstr (>=0.5.0) ; extra == 'dev'
Requires-Dist: boto3 (>=1.17.0) ; extra == 'dev'
Requires-Dist: aiobotocore (>=1.3.0) ; extra == 'dev'
Requires-Dist: pandas (>=1.0.0) ; extra == 'dev'
Requires-Dist: pyarrow (>=3.0.0) ; extra == 'dev'
Provides-Extra: pandas
Requires-Dist: pandas (>=1.0.0) ; extra == 'pandas'
Requires-Dist: pyarrow (>=3.0.0) ; extra == 'pandas'

# API


## S3Access: `s3 = S3Access()`

### `s3.select`

### `s3.ls`

### `s3.ls_path`


## S3Path: `p = S3Path("s3://bucket/key/part=value")`

### `p.with_params(foo=7, bar=29)`

👉 `s3://other/key/part=value/foo=7/bar=29`

Appends or replaces the key/value pairs in order as given.


### `p.with_params(foo=7, part='else', bar=29)`

👉 `s3://other/key/part=else/foo=7/bar=29`

If a partition is already mentioned in the path, it is
replaced with the value.


### `p.with_bucket('other')`

👉 `s3://other/key/part=value`

Replaces the bucket name of the S3 url.


### `p.with_key('path')`

👉 `s3://bucket/path`

Replaces the prefix/key/path component of this S3 url.


