Skip to main content
This utility allows you to extsact sample lines from a CSV hosted on Amazon S3.
The use case is that you have a really large CSV on S3 that you want to look at,
but you do not want to download the entire file.

What it does is grab random bytes from the key and assemble unbroken lines from
the file to create as sample.

The use case is for determining a file format, file contents, etc. See the
cognoscenti project for an example. (Um, this doesn't exist yet. Check back later.)

_Usage: sample.py [OPTIONS]_

Options:
--bucket TEXT bucket name
--key TEXT key name
--headers / --no-headers Include headers in output. Defaults to include.
-d, --delimiter TEXT File delimiter. Defaults to ','
-l, --lines INTEGER How many sample lines do you want? Defaults to 1000.
--help Show this message and exit.

Allows you to indicate the number of lines you hope to recieve. It will
grab 1000 lines by default.

#### Installing

You can install via pip:

pip install sample-s3

#### Example

ss3 --bucket foo --key path/to/bar.csv > sample_file.csv

Metadata

Release files for sample-s3 0.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sample-s3 0.0.4
File Size Uploaded Provenance Actions
sample-s3-0.0.4.tar.gz 3.7 kB Without provenance Details for sample-s3-0.0.4.tar.gz

Release files / sample-s3-0.0.4.tar.gz

Download URL sample-s3-0.0.4.tar.gz
Size 3.7 kB
Tags Source
SHA-256 checksum
How to use checksums
c32417f7a9ff233dc922cb22790e74f25dc282290b710328938b215ef7a2de65
BLAKE2b-256 checksum
How to use checksums
95fbede7f0cc7844c683f5f00a71252426fe6f2f4090f8b555d0660144501deb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for sample-s3 0.0.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.4 This release

1 release file No provenance

0.0.1

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page