Skip to main content

reading, writing and sorting large files

Project description

streamio is a simple library of functions designed to read, write and sort large files using iterators so that the operations will successfully complete on systems with limited RAM. This library has been used extensively at Griffith University whilst developing the TerraNova Climate Change and Adaptation Visualization tool(s) and processing large volumes of data. streamio is written in Python and has extensive documentation and unit tests with 100% coverage.

See the API for a list of the available functions.

Latest PyPI version Number of PyPI downloads Build Status Requirements Status

Examples

Read a large text file iteratively:

from streamio import stream
f = stream("large_file.txt")

Read a large CSV file iteratively:

from streamio import jsonstream
f = stream("large_file.json")

Merge-sort a large JSON file with the key itemgetter("value"):

from operator import itemgetter
from streamio import mergesort
f = mergesort("large_file.json", key=itemgetter("value"))

Requirements

streamio also comes with documentation and a full comprehensive unit test suite which require the following:

To build the docs:

To run the unit tests:

Installation

The simplest and recommended way to install streamio is with pip. You may install the latest stable release from PyPI with pip:

> pip install streamio

If you do not have pip, you may use easy_install:

> easy_install streamio

Alternatively, you may download the source package from the PyPI Page or the Downloads page on the Project Website; extract it and install using:

> python setup.py install

You can also install the latest-development version by using pip or easy_install:

> pip install streamio==dev

or:

> easy_install streamio==dev

For further information see the streamio documentation.

Supported Platforms

  • Linux, FreeBSD, Mac OS X

  • Python 2.7

  • PyPy 2.2

Windows: We acknowledge that Windows exists and make reasonable efforts

to maintain compatibility. Unfortunately we cannot guarantee support at this time.

Changes

streamio 0.0.6 (2014-01-29)

  • Don’t include fabfile and tests (for now) in the resulting egg

  • Make mergesort show progress optionally via progress=True

streamio 0.0.5 (2014-01-16)

  • Added encoding parameter support to *stream() function(s).

streamio 0.0.4 (2013-11-22)

  • Added streamio.stream.compress function for compressing an iterable using zlib compression.

  • Loosended requirements on py and progress

streamio 0.0.3 (2013-11-21)

  • Fixed broken link to the API Docs.

streamio 0.0.2 (2013-11-21)

  • Added some examples

  • Fixed a few typos

streamio 0.0.1 (2013-11-21)

  • Initial Public Release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

streamio-0.0.6.tar.gz (13.1 kB view details)

Uploaded Source

Built Distribution

streamio-0.0.6-py2.7.egg (14.5 kB view details)

Uploaded Egg

File details

Details for the file streamio-0.0.6.tar.gz.

File metadata

  • Download URL: streamio-0.0.6.tar.gz
  • Upload date:
  • Size: 13.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for streamio-0.0.6.tar.gz
Algorithm Hash digest
SHA256 4791ac87828bcaeeddc314a1b51c90679bf5ff5cd2472d14d66c1a03b1728dd6
MD5 5a9ffd0bd290043364dc8586e12f5ff4
BLAKE2b-256 58ef174e4a4ed078130043f9052207f906aa2f723660669a5c0087ad20ec2075

See more details on using hashes here.

File details

Details for the file streamio-0.0.6-py2.7.egg.

File metadata

  • Download URL: streamio-0.0.6-py2.7.egg
  • Upload date:
  • Size: 14.5 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for streamio-0.0.6-py2.7.egg
Algorithm Hash digest
SHA256 a877a68c1d2c568e5933ab7aa9abbb1b870fc1128635027beaa928c999eaf157
MD5 e82c3a6a4173101848654bf8740ba441
BLAKE2b-256 af1ff2cb4808f99a8fb88eb077751aeb952380b9a9b38939359e9fea00f14acc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page