class DeviceAtlas

# File ../Src/deviceatlas.rb, line 104
def initialize
        
        # Set the public constants.
        @PROPERTIES_WITH_TYPE_TO_ID = 'pr' # e.g. bmobileDevice: 1
        @ID_TO_PROPERTY_WITHOUT_TYPE = 'pnr' # e.g. 1: mobileDevice
        
        # Set private constants.
        @AV_PROPS = 100 #chosen as an average num of properties returned
        @CLIENT_PROPS_HANDLER = '_cprops'
        @UA_PROPS_HANDLER = '_uaprops'
        @MAIN_TREE_BRANCH = 't'
        @REGEX = 'r'
        @COMPILED_REGEX = 'creg'
        
        # Initialize a private instance variable.
        @cachedTree = nil
        
end

# File ../Src/deviceatlas.rb, line 234
def getApiRevision()
        _getRevisionFromKeyword('$Rev: 28642 $')
end

# File ../Src/deviceatlas.rb, line 269
def getProperties(tree, userAgent, cookie = nil, typedValues = false, sought = nil, uaPropsNeeded = true)

        if !cookie.nil?
                getPropertiesWithCookie(tree, userAgent, cookie, typedValues)
        else
                getPropertiesWithoutCookie(tree, userAgent, typedValues, sought, uaPropsNeeded)
        end
end

# File ../Src/deviceatlas.rb, line 404
def getPropertiesAsTyped(tree, userAgent, cookie = nil)
        getProperties(tree, userAgent, cookie, true, nil, true)
end

# File ../Src/deviceatlas.rb, line 416
def getProperty(tree, userAgent, property, cookie = nil, typedValue = false)
        if cookie.nil? || cookie.empty?
                return getPropertyWithoutCookie(tree, userAgent, property, typedValue)
        else
                return getPropertyWithCookie(tree, userAgent, property, cookie, typedValue)
        end
end

# File ../Src/deviceatlas.rb, line 536
def getPropertyAsBoolean(tree, userAgent, property, cookie = nil)
        propertyTypeCheck(tree, property, "b", "boolean", cookie)
        getProperty(tree, userAgent, property, cookie, true)
end

# File ../Src/deviceatlas.rb, line 549
def getPropertyAsDate(tree, userAgent, property, cookie = nil)
        propertyTypeCheck(tree, property, "d", "date", cookie)
        getProperty(tree, userAgent, property, cookie, true)
end

# File ../Src/deviceatlas.rb, line 562
def getPropertyAsInteger(tree, userAgent, property, cookie = nil)
        propertyTypeCheck(tree, property, "i", "integer", cookie)
        getProperty(tree, userAgent, property, cookie, true)
end

# File ../Src/deviceatlas.rb, line 575
def getPropertyAsString(tree, userAgent, property, cookie = nil)
        propertyTypeCheck(tree, property, "s", "string", cookie)
        getProperty(tree, userAgent, property, cookie, true)
end

# File ../Src/deviceatlas.rb, line 201
def getTreeFromFile(filename, reload = false, includeChangeableUserAgentProperties = true)             
        if reload || @cachedTree.nil?

                raise(JsonException, "Unable to find JSON file.") if !File.file?(filename)

                json = File.open(filename,"r").read                  
                @cachedTree = getTreeFromString(json, includeChangeableUserAgentProperties)
        end
        @cachedTree
end

# File ../Src/deviceatlas.rb, line 136
def getTreeFromString(json, includeChangeableUserAgentProperties = true)

        tree = JSON::Parser.new(json, :max_nesting => false).parse
        raise(JsonException, "Unable to load Json data.") if (tree.nil? || !tree.kind_of?(Hash))
        raise(JsonException, "Bad data loaded into the tree.") unless tree.has_key?("$")
        raise(JsonException, "DeviceAtlas json file must be v0.7 or greater. Please download a more recent version.") if(tree["$"]["Ver"].to_f < 0.7)

        # Prepare three trees to speed up retrieval of properties.
        props = tree[PropsHandler::ID_TO_PROPERTIES_WITH_TYPE]

        pr = {}
        pn = {}
        newP = {}
        idToProp = {}

        props.each_with_index do |typeName, id|
                name = typeName[1..typeName.size]

                newP[id] = typeName # all keys in the JSON file are strings so make associative array with string keys...
                pr[typeName] = id
                pn[name] = id
                idToProp[id] = name
        end
        
        tree.delete(PropsHandler::ID_TO_PROPERTIES_WITH_TYPE)
        tree[PropsHandler::ID_TO_PROPERTIES_WITH_TYPE] = newP
        tree[@PROPERTIES_WITH_TYPE_TO_ID] = pr # propertytype+name => propertyid
        tree[@PROPERTIES_WITHOUT_TYPE_TO_ID] = pn # propertyname => propertyid
        tree[@ID_TO_PROPERTY_WITHOUT_TYPE] = idToProp # property names without the type char

        # Prepare the user-agent rules branch before we start recognition.
        # To maintain backwards compatibility - only do this if we have the ua rules branch
        if tree[UAProps::UA_RULES]
                unless includeChangeableUserAgentProperties
                        # remove the UAR branch to save some memory
                        tree.delete(UAProps::UA_RULES)
                else
                        tree[@UA_PROPS_HANDLER] = UAProps.new(tree) # stick in the tree so we can use it later
                end
        end

        if tree[ClientProps::CP_RULES]
                clientProps = ClientProps.new(tree)
                tree[@CLIENT_PROPS_HANDLER] = clientProps # stick in the tree so we can use it later
        end

        tree
end

# File ../Src/deviceatlas.rb, line 215
def getTreeGeneration(tree)
        tree['$']['Gen']
end

# File ../Src/deviceatlas.rb, line 222
def getTreeGenerationAsTimestamp(tree)
        tree['$']['Utc']
end

# File ../Src/deviceatlas.rb, line 228
def getTreeRevision(tree)
        _getRevisionFromKeyword(tree['$']['Rev'])
end

# File ../Src/deviceatlas.rb, line 247
def listProperties(tree)
        types = {"s" => "string", "b" =>"boolean", "i" =>"integer", "d" =>"date", "u" =>"unknown"}
        properties = {}
        tree[PropsHandler::ID_TO_PROPERTIES_WITH_TYPE].each do |id, property|
                properties[property[1..property.length]] = types[property[0]]
        end
        properties
end