Easy reading.
readers offers an easy way to read different kinds of files.
For instance, consider this plain text file.
Hola, esta
es una cadena
de texto
It can be read directly as a str:
text = FileReader(textfile).read()or it can be iterated over as well, iterating line by line
with FileReader(textfile) as file_reader:
for line in file_reader:
print(line)Consider now the JSONReader, and two kinds of situations:
For example, consider this file
{
"key1": "value1",
"key2": 2
}In this case, the read method of the JSONReader can be used, returning a dict :
json_record = JSONReader(textfile).read()
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) as json_reader:
for json_record in json_reader:
print(json_record["key1"])
value1
value2
value3
value4
value5For JSON files, Filters can be added too:
from readers.filters import Filter
f = Filter(op1='.key2', operator='ge', op2=3)
with JSONReader(filename_iterable) as json_reader:
for json_record in json_reader:
if f(json_record):
print(json_record["key1"])
value3
value4
value5Note: filters provide a functionality that should be separate from readers, i.e, stored as a different library.