readers

Easy reading


Keywords
reading, json, csv
License
MIT
Install
pip install readers==1.0

Documentation

readers

Build Status codecov

Easy reading.

readers offers an easy way to read different kinds of files.

Plain text files

For instance, consider this plain text file.

Hola, esta
es una cadena
de texto

It can be read directly as a str:

with FileReader(textfile) as filetext:
    print(filetext)

or it can be iterated over as well, iterating line by line

with FileReader(textfile, iterable=True) as file_reader:
    for line in file_reader:
        print(line)

Consider now the JSONReader, and two kinds of situations:

JSON files

For example, consider this file

{
    "key1": "value1",
    "key2": 2
}

In this case, the JSONReader returns a dict :

with JSONReader(textfile) as json_record:
    print(json_record.keys())

dict_keys(['key1', 'key2'])

We can also have these kinds of files:

{"key1": "value1","key2": 1}
{"key1": "value2","key2": 2}
{"key1": "value3","key2": 3}
{"key1": "value4","key2": 4}
{"key1": "value5","key2": 5}

In this case, we can iterate over the file, returning a dict per line.

with JSONReader(filename_iterable, iterable=True) as json_reader:
    ...:     for json_record in json_reader:
    ...:         print(json_record["key1"])
    ...:         
    ...:     
value1
value2
value3
value4
value5
        

Code quality

  • #TODO check python versions at the top
  • PEP8)
  • Docstrings (PEP257)
  • Unit tests: pytest