pyzim.pointerlist.OnDiskSimplePointerList

class documentation

class OnDiskSimplePointerList(SimplePointerList):

Known subclasses: pyzim.pointerlist.OnDiskOrderedPointerList

Constructor: OnDiskSimplePointerList(zim, offset, n)

A variant of SimplePointerList that reads pointers always from the disk.

This should be more RAM efficient, but beware that it is likely quite slow.

Class Method	`from_bytes`	Load a pointer list from the provided bytestring
Class Method	`from_file`	Load a pointer list from a file.
Class Method	`from_zim_entry`	Load a pointer list from an entry inside a ZIM archive.
Class Method	`from_zim_file`	Load a pointer list from a ZIM file at the specified offset.
Class Method	`new`	Instantiate a new, empty pointerlist.
Method	`__init__`	The default constructor.
Method	`__len__`	The length of this pointer list.
Method	`get_by_index`	Return the pointer for the specified index.
Instance Variable	`mutable`	Undocumented
Instance Variable	`_item_size`	the size of each item in this list in bytes
Instance Variable	`_n`	amount of entries in this pointerlist
Instance Variable	`_offset`	offset of this pointerlist in the zim file
Instance Variable	`_zim`	zim this pointer list is part of

Inherited from SimplePointerList:

Method	`__getitem__`	Get the pointer at the specified index.
Method	`append`	Append a pointer to the end of pointerlist.
Method	`get_by_pointer`	Return the index of pointer in this list.
Method	`get_disk_size`	Calculate the size of this object when written to a file.
Method	`iter_pointers`	Iterate over all pointers in this pointer list.
Method	`mass_update`	Perform a mass update on all pointers in the specified range, changing their value as specified.
Method	`remove_by_index`	Remove the pointer at the specified index.
Method	`set`	Set the pointer at the specified index.
Method	`to_bytes`	Dump this pointer list into a bytestring and return it.
Constant	`POINTER_FORMAT`	format of a single pointer
Instance Variable	`_lock`	Undocumented
Instance Variable	`_pointers`	list of pointers in this pointer list

Inherited from ModifiableMixIn (via SimplePointerList):

Method	`add_submodifiable`	Add another modifiable object as a child of this one.
Method	`after_flush_or_read`	This method should be called after this object has been read and/or flushed to disk. In other words, it should be called at least once whenever this object matches the state of the object on the disk.
Method	`dirty.setter`	Setter for `ModifiableMixIn.dirty`
Method	`ensure_mutable`	If this object is non-mutable, raise an Exception.
Method	`get_initial_disk_size`	Return the size of this object on disk as it has been read.
Method	`get_unmodified_disk_size`	Return the size of this object when written to a file before any modifications has been made since the last read/flush.
Method	`mark_dirty`	Convenience function to mark this object as dirty.
Method	`remove_submodifiable`	Remove a submodifiable from this object.
Instance Variable	`dirty`	True if this object or a sub-modifiable has been modified.
Instance Variable	`_dirty`	a boolean flag that's nonzero if this object has been modified
Instance Variable	`_old_disk_size`	the size of this object on disk before any modifications since the last flush/read
Instance Variable	`_submodifiables`	a list of child objects, whose dirty state will affect this objects dirty state.

@classmethod

def from_bytes(cls, s): ¶

overrides pyzim.pointerlist.SimplePointerList.from_bytes

overridden in pyzim.pointerlist.OnDiskOrderedPointerList

Load a pointer list from the provided bytestring

NOTE: it is not possible to validate that the string contains the whole pointer list.

Parameters
s:`bytes`	bytestring to parse

Returns
`pyzim.pointerlist.SimplePointerList`	the pointerlist parsed from the bytes

@classmethod

def from_file(cls, f, n, seek=None): ¶

overrides pyzim.pointerlist.SimplePointerList.from_file

overridden in pyzim.pointerlist.OnDiskOrderedPointerList

Load a pointer list from a file.

Parameters
f:file-like	file-like object to read from
n:`int`	number of entries in the pointer list.
seek:`int` or `None`	if specified, seek this position of the file before reading

Returns
`pyzim.pointerlist.SimplePointerList`	the pointerlist read from the file

@classmethod

def from_zim_entry(cls, zim, full_url): ¶

overrides pyzim.pointerlist.SimplePointerList.from_zim_entry

overridden in pyzim.pointerlist.OnDiskOrderedPointerList

Load a pointer list from an entry inside a ZIM archive.

NOTE: it is not possible to validate that the string contains the whole pointer list.

Parameters
zim:`pyzim.archive.Zim`	ZIM file to read from
full_url:`str`	full url of entry to read pointerlist from

Returns
`pyzim.pointerlist.SimplePointerList`	the pointerlist parsed from the bytes

@classmethod

def from_zim_file(cls, zim, n, seek=None): ¶

overrides pyzim.pointerlist.SimplePointerList.from_zim_file

overridden in pyzim.pointerlist.OnDiskOrderedPointerList

Load a pointer list from a ZIM file at the specified offset.

This usually acquires the file lock and calls SimplePointerList.from_file, but subclasses may behave differently.

Parameters
zim:`pyzim.archive.Zim`	ZIM file to read from
n:`int`	number of entries in the pointer list.
seek:`int` or `None`	if specified, seek this position of the file before reading

Returns
`pyzim.pointerlist.SimplePointerList`	the pointerlist read from the file

@classmethod

def new(cls): ¶

overrides pyzim.pointerlist.SimplePointerList.new

overridden in pyzim.pointerlist.OnDiskOrderedPointerList

Instantiate a new, empty pointerlist.

Returns
`SimplePointerList`	a new, empty pointerlist

def __init__(self, zim, offset, n): ¶

overrides pyzim.pointerlist.SimplePointerList.__init__

overridden in pyzim.pointerlist.OnDiskOrderedPointerList

The default constructor.

Parameters
zim:`pyzim.archive.Zim`	zim this pointer list is part of
offset:`int`	offset of this pointerlist in the zim file
n:`int`	amount of entries in this pointerlist

def __len__(self): ¶

overrides pyzim.pointerlist.SimplePointerList.__len__

The length of this pointer list.

Returns
`int`	the length of this pointer list

def get_by_index(self, i): ¶

overrides pyzim.pointerlist.SimplePointerList.get_by_index

Return the pointer for the specified index.

Parameters
i:`int`	index of pointer to get

Returns
`int`	the poiner with the specified index

Raises
`IndexError`	when the index is out of bounds.

mutable: bool = ¶

overrides pyzim.modifiable.ModifiableMixIn.mutable

Undocumented

_item_size: int = ¶

the size of each item in this list in bytes

_n: int = ¶

amount of entries in this pointerlist

_offset: int = ¶

offset of this pointerlist in the zim file

_zim: pyzim.archive.Zim = ¶

zim this pointer list is part of