The @io module contains functions and classes related to standard/file input/output
and manipulating various text file formats.
Load file at path into string.
Save data to file at path.
Prompt for user input.
f = io.prompt('Degrees in F? ').number()
c = (f-32)*5/9
print '=>',c,'degrees in C'
##
Degrees in F? 99
=> 37.2222 degrees in C
##
Print a status message. Multiple calls will re-use the same line. This is meant to be called within a loop to give progress feedback to the user.
The output is limited to 79 characters, so that it will fit one line of a terminal 80 characters wide.
This function prints to stderr.
At the last step (index+1 == total) a newline is printed.
for n,1000
io.status(n,1000,'step: '+n)
os.sleep(10)
print 'Done.'
#while running:
#[203/1000] (20.3%) step: 202
#when done:
#[1000/1000] (100.0%) step: 999
#Done.
Wrap string with ANSI color codes.
The code should be like "format;color" or just "format" or "color". See the following chart for formats/colors:
Colors
black 30
red 31
green 32
yellow 33
blue 34
magenta 35
cyan 36
white 37
Formats
bold/bright 1
underline 4
inverse 7
Reset/off codes aren't included here because they are not necessary (this function automatically ends the string with a reset sequence). Background colors aren't included here because they do not seem to work on most terminals.
print io.color('1;31','This is bold red')
print io.color('32','This is green')
print io.color('4','This is underlined')
Determine whether or not file exists.
Remove (delete) file at path.
Rename file from old_name to new_name.
@file MethodsConstruct a stream to a file.
The flags can by any of the following:
The underlying implementation uses fopen().
Read n bytes from the stream.
Write bytes s to stream.
The return value is equal to s.len() unless there is an error.
Seek stream to a position within the file.
Read a single line from the file.
The character '\r' is ignored for cross-platform compatibility.
f = io.file('bigfile.txt')
while (line = f.read_line())!=null
print 'LINE:',line
@csv FunctionsLoad CSV (comma-separate values) file at path.
Save data to CSV file at path.
Parse string as CSV.
Escape a single CSV value
If value contains commas or newlines, it is quoted and quotes within are replaced with two quotes. If value contains no commas or newlines, nothing is done.
Split a single line of CSV.
This is useful if the CSV file is too big to read into memory at once.
f = io.file('bigfile.csv')
while (line = f.read_line())!=null
print 'VALUES:',io.csv.split_line(line)
@html FunctionsParse HTML table.
Only <tr> and <td> tags are parsed. This does fuzzy parsing for maximum compatibility.
Extract text from HTML.
This is similar to .textContent in Javascript.
@ini FunctionsLoad .ini/.conf/.cfg file.
Comments can be indicated with either ';' or '#'.
Each subsection in the .ini file becomes a subobject.
Any whitespace around the '=' is ignored. On any line, leading or trailing whitespace is ignored.
Value can be JSON literals. If values failed to parse as JSON, they are parsed as strings.
#test.ini:
##
;this is a comment
#also a comment
asdf = narf
local = false
port = 1234
[narf]
asdf = [1,2,3]
zxcv = 3
##
print io.ini.load('test.ini')
##
{
"asdf" : "narf",
"local" : false,
"port" : 1234,
"narf" : {
"asdf" : [1,2,3],
"zxcv" : 3
}
}
##
@json FunctionsLoad a JSON file.
This is equivalent to io.load(path).parse_json().
JSON serialization and parsing are part of the core library, and therefore not repeated here. See :parse_json() and :json().
Save data to JSON file at path.
This is equivalent to io.save(path,data.json()).