mobi.mtld.da.carrier.carrier

Class CarrierData

object --+ | CarrierData

Instance Methods

load_data_from_file(self, filePath)

_readHeader(self)
The header of the file contains the following data: 2B DA (US-ASCII) 1B File type ID (1: carrier data, 2:some other data....

_checkFileTypeGetHeaderLength(self, startBytes)
Check the first few bytes to make sure we are opening a Carrier Identification file.

_readBuckets(self)
Each bucket is comprised of the following.

getProperties(self, key)
Selects a value for a given IPV4 address, traversing tree and choosing most specific value available for a given address.

getPropertyNames(self)
Return a list of all the property names

getPropertyNamesAsStrings(self)
Return a list of all the property names

getCopyright(self)
Return the copyright

getCreationDate(self)
Return the creation of date

getVersion(self)
Return the version

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __init__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __str__, __subclasshook__

Class Variables

[hide private]

_MAGIC_NUMBER = 'DA'

_FILE_ID = 1

_START_BYTES_LEN = 5

_CREATION_DATE_LEN = 24

_BUCKET_START_BYTES_LEN = 10

_copyright = u''

_creationDate = u''

_version = u''

_NULL_PTR = -1

_ROOT_PTR = 0

_MAX_IPV4_BIT = 2147483648

_treeLefts = []

_treeRights = []

_treeProperties = []

_PROBLEM_READING_DATA_FILE = u'Problem reading data file.'

_INVALID_DATA_FILE = u'Invalid data file.'

_data = None
hash(x)

_cursor = 0

_propertyStringNames = None
hash(x)

_property_names = None
hash(x)

Properties

[hide private]

Inherited from object: __class__

_readHeader(self)


The header of the file contains the following data:
     2B  DA (US-ASCII)
     1B  File type ID (1: carrier data, 2:some other data.... etc)
     2B  Header length - the total size of the header including the preceding bytes
     2B  Length of copyright text
     ?B  Copyright (US-ASCII) "Copyright (c) DeviceAtlas Limited 2021. All Rights Reserved."
     24B Creation date (US-ASCII) "2013-08-07T15:36:44+0000"
     1B  Version, major
     1B  Version, minor
     4B  Licence ID
     4B  CRC-32 - all data after first bucket offset

_readBuckets(self)


Each bucket is comprised of the following. The BucketHandler is
responsible for actually parsing the data in each bucket. This method
keeps reading until either the end of the file or until all necessary
buckets have been read. It will skip buckets with IDs it does not
recognise to hopefully future proof the API against possible additions to
the data file

Bucket structure:

 2B  Bucket ID
 4B  CRC-32 checksum - NOTE: unsigned int!
 4B  Length of the data
 ?B  Data