// it does have comments.
// file can contain an array or an object, same as JSON
{
	// property names can be written without quotes
	someProperty: "string value"
	
	// colons/semicolons are optional. They are required when several properties are written on the same line
	anotherProperty: 239
	
	// basic types are: string, int, double, bool, null/nil, color (#rrggbbaa or #rrggbb or #rgb)
	exampleRedColor: #ff0000
	
	// you can write arrays, array must contain same type items
	array: [
		1, 2, 3, 4
		5 // colons/semicolons are optional here too
	]
	
	reference: @someProperty
	
	// here we specify object type, that can be used for verification or more accurate model mapping
	myFont(font): {
		name: Helvetica
		size: 16
	}
	
	// arrays also can have types
	point(CGPoint): [23.2, 33.2]
	
	//sometimes it is useful to derive object from another
	biggerFont(+myFont): {
		size: 22
	}
}

let parser = KTVParser(fileName:filePath)
let ktvObject:KTVObject = try parser.parse()

public func string(key key:String, defaultValue:String? = "") throws -> String?
public func double(key key:String, defaultValue:Double? = 0.0) throws -> Double?
public func int(key key:String, defaultValue:Int? = 0) throws -> Int?
public func bool(key key:String, defaultValue:Bool? = false) throws -> Bool?
public func nsDate(key key:String, defaultValue:NSDate? = NSDate()) throws -> NSDate?
public func array<T>(key key:String, defaultValue:[T]? = nil, itemResolver:(value:KTVValue) throws -> T?) throws -> [T]?
public func dictionary<T>(key key:String, defaultValue:[String:T]? = nil, itemResolver:(value:KTVValue) throws -> T?) throws -> [String:T]?

@objc
class ChildObject : NSObject, KTVModelObject {
    var somethingElse:String = ""
}

public struct RootObject: KTVModelObject {
    var date:NSDate

    var string:String
    var stringOrNil:String? = nil

    var int:Int
    var double:Double

    var stringArray:[String]
    var stringDictionary:[String:Int]

    var object:ChildObject?

    // constants will not participate in mapping process
    let _constantString:String = ""

    // private vars, won't take part in parsing generators
    private var _privateString:String
    private(set) var _privateSetString:String
}

extension RootObject: KTVParseable {
    public init?(ktvStrict ktv:KTVObject)
    public init(ktvLenient ktv:KTVObject)
}

extension RootObject: KTVSerializable {
    public func ktvObject() throws -> KTVObject
}

extension ChildObject: KTVParseable {
    convenience init?(ktvStrict ktv:KTVObject)
    convenience init(ktvLenient ktv:KTVObject)
}

extension ChildObject: KTVSerializable {
    func ktvObject() throws -> KTVObject
}