FileSnipe -- precision file editing and database manager

--#Documentation to use API
--#this all assumes you saved the file as "fileSnipe"

os.loadAPI("fileSnipe") --# in order to access the file you will need to load it first

file = fileSnipe.open(file [,mode][,debug]) --#file is the name of the file you want to edit or read, mode can be "d" for dynamic or "s" for singular defaults to singular if omitted.

--#in dynamic mode(d) fileSnipe will open and read the file every time you call to it, in singular(s) it will only read the file when first opened
--#only use dynamic mode if you have other computers or programs editing/accessing the same file

--#set debug to true to prevent the API from hiding the persistent variable comment block from editing
--#not recommended as this can cause many issues if done incorrectly

file.getLine(line) --# returns the file at line, if line is negative it will read from the end of the file up

--#if line is a table of numbers it will return a table containing all requested lines

file.setLine(line,data) --# changes the file at line to string data, if line is negative it will count lines from bottom up to

--#if line is 0 or less than -file:len() then itll write to the beginning of the file before other lines
--#if line would require the file to have more lines to reach that point it will add blank lines until the file has the requested line

file.getFile() --# returns the entire file as a table with each line a separate index in the table

file.setFile(data) --# sets the file equal to table data, each index in the table is a line in the file

file.len() --# returns the number of lines in the file

file.insert(line,data) --# adds a new line with string data to the file

--#if data is a table it will add all lines in the table into the file

file.remLine(line) --# removes line from the file

--#if line is a table of numbers will remove all lines in the table

file.find(string [,whole]) --# returns all instances of string in format {line,start}

--#if whole is true it will only find exact copies of the requested string otherwise it will also return words containing the string

file.swap(line1,line2) --# swaps two lines in the file

file.replace(oldString,newString,index [,whole]) --# replaces oldString with newString at occurrence index

--#if whole is true it will only replace exact copies of the requested string otherwise it will also return words containing the string

file.replaceAll(oldString,newString [,whole]) --# replaces all occurrences of oldString with newString

file.append(data) --# adds line (or lines if data is a table) data to the end of a file

file.combineLines(line1,line2 [,sep]) --# combines line1 and line2 in a file with sep between them

--# if sep is omitted defaults to " "

file.sepLines(line,point) --# separates one line into two at point

file.moveLine(start,end) --# moves a line to a new place in the file

file.concatLine(line,data) --# adds data to the end of line in the file

file.rawVar(variable) --#returns the raw equivalent of a saved persistent variable

--#only really useful for getting a saved function as the string code

file["example"] = "foo" --# how to set a variables

file["example"] = nil --# removing a variable

file["example"] = { type = "foo", } --# all variable types are supported

file["example"] = "function(str) print(str) end" --#accepts functions ( called with file["example"]() or file.example() )

file["example"] --# this will return whatever you have "example" defined as

os.loadAPI("fileSnipe")
local name = fileSnipe.open("name")
local log = fileSnipe.open("history")
if not name["curr"] then
  log.setFile("om : 0")
  name["curr"] = "om"
end
print("Hello! You are "..name["curr"].." correct?")
print("(type y or n)")
local num = 0
local input = read()
if input == "y" then
  local line = log.find(name["curr"])
  local data = log.getLine(line[1][1])
  local num = data:sub(name["curr"]:len()+4,data:len())
  num = tonumber(num) + 1
  log.setLine(line[1][1],name["curr"].." : "..tostring(num))
  print("Welcome back "..name["curr"].."! I believe we have now talked "..tostring(num).." times before!")
elseif input == "n" then
  print("Oh my bad! What is your name then?")
  input = read()
  name["curr"] = input
  local line = log.find(name["curr"])
  if #line < 1 then
	log.append(name["curr"].." : 1")
	num = 1
  else
	local data = log.getLine(line[1][1])
	num = data:sub(name["curr"]:len()+3,data:len())
	num = tonumber(num) + 1
	log.setLine(line[1][1],name["curr"].." : "..tostring(num))
  end
  print("Well hello then "..name["curr"]..". I believe we have talked "..tostring(num).." times before.")
else
  print("I am sorry I did not understand that")
end