Live location references¶

Managers¶

class whalesong.managers.live_location.LiveLocationCollectionManager(driver, manager_path='')¶

Bases: whalesong.managers.BaseCollectionManager

Live locations collection manager.

Parameters:	driver (`BaseWhalesongDriver`) – Whalesong driver manager_path (`str`) – Manager prefix path.

__getitem__(name)¶

Get a submanager. It could be a explicit submanager or contained model manager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`Union`[`BaseManager`, ~MODEL_MANAGER_TYPE]

__getattr__(name)¶

Get a submanager. It could be a explicit submanager or contained model manager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`Union`[`BaseManager`, ~MODEL_MANAGER_TYPE]

add_submanager(name, submanager)¶

Add a submanager.

Parameters:	name (`str`) – Field where manager will be stored. submanager (`BaseManager`) – Submanager

find_item_by_id(item_id)¶

Find model by identifier. If item is not in collection it will try to load it.

Parameters:	item_id (`str`) – Model identifier.
Return type:	`Result`[+MODEL_TYPE]
Returns:	Model object.

get_commands()¶

Get manager available static commands.

Return type:	`Result`[`List`[`str`]]
Returns:	Manager static commands.

get_first()¶

Get first item in collection.

Return type:	`Result`[+MODEL_TYPE]
Returns:	Model object.

get_item_by_id(item_id)¶

Get model by identifier.

Parameters:	item_id (`str`) – Model identifier.
Return type:	`Result`[+MODEL_TYPE]
Returns:	Model object.

get_item_result_class()¶

Return type:	`Result`[+MODEL_TYPE]

get_items()¶

Get all items on collection.

Return type:	`IteratorResult`[+MODEL_TYPE]
Returns:	Async iterator

get_iterator_result_class()¶

Return type:	`IteratorResult`[+MODEL_TYPE]

get_last()¶

Get last item in collection.

Return type:	`Result`[+MODEL_TYPE]
Returns:	Model object.

get_length()¶

Get collection items count.

Return type:	`Result`[`int`]
Returns:	Items count

get_monitor_result_class()¶

Return type:	`MonitorResult`[+MODEL_TYPE]

get_submanager(name)¶

Get a submanager. It could be a explicit submanager or contained model manager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`Union`[`BaseManager`, ~MODEL_MANAGER_TYPE]

monitor_add()¶

Monitor add item collection. Iterate each time a item is added to collection.

Return type:	`MonitorResult`[+MODEL_TYPE]
Returns:	Model object iterator

monitor_change()¶

Monitor change item collection. Iterate each time a item change in collection.

Return type:	`MonitorResult`[+MODEL_TYPE]
Returns:	Model object iterator

monitor_field(field)¶

Monitor item’s field change. Iterate each time a field changed in any item of collection.

Return type:	`MonitorResult`[`Dict`[`str`, `Any`]]
Returns:	Model object iterator

monitor_remove()¶

Monitor remove item collection. Iterate each time a item is removed from collection.

Return type:	`MonitorResult`[+MODEL_TYPE]
Returns:	Model object iterator

remove_item_by_id(item_id)¶

Remove item by identifier.

Parameters:	item_id (`str`) – Model identifier.
Return type:	`Result`[`None`]

remove_submanager(name)¶

Remove a submanager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`Result`[~T]

MODEL_MANAGER_CLASS¶: alias of LiveLocationManager

class whalesong.managers.live_location.LiveLocationManager(driver, manager_path='')¶

Bases: whalesong.managers.BaseModelManager

Live location manager.

participants¶

ParticipantCollectionManager

Live location’s participants collection manager.

__getitem__(name)¶

Get a submanager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`BaseManager`

__getattr__(name)¶

Get a submanager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`BaseManager`

add_submanager(name, submanager)¶

Add a submanager.

Parameters:	name (`str`) – Field where manager will be stored. submanager (`BaseManager`) – Submanager

get_commands()¶

Get manager available static commands.

Return type:	`Result`[`List`[`str`]]
Returns:	Manager static commands.

get_field_monitor_result_class(field)¶

Return type:	`MonitorResult`[`Dict`[`str`, `Any`]]

get_model()¶

Get model object

Return type:	`Result`[+MODEL_TYPE]
Returns:	Model object

get_model_result_class()¶

Return type:	`Result`[+MODEL_TYPE]

get_monitor_result_class()¶

Return type:	`MonitorResult`[+MODEL_TYPE]

get_submanager(name)¶

Get a submanager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`BaseManager`

map_model(data)¶

Return type:	+MODEL_TYPE

monitor_field(field)¶

Monitor any change on a model’s field.

Parameters:	field (`str`) – Field to monitor.
Return type:	`MonitorResult`[`Dict`[`str`, `Any`]]
Returns:	Model monitor

monitor_model()¶

Monitor any change on model.

Return type:	`MonitorResult`[+MODEL_TYPE]
Returns:	Model monitor

remove_submanager(name)¶

Remove a submanager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`Result`[~T]

MODEL_CLASS¶: alias of LiveLocation

subscribe()¶

Subscribe to a live location. It is needed in order to receive updates.

Return type:	`Result`[`None`]

unsubscribe()¶

Unsubscribe to a live location.

Return type:	`Result`[`None`]

stop_my_live_location()¶

Stop to share current user live location in this chat.

Return type:	`Result`[`None`]

class whalesong.managers.live_location.ParticipantCollectionManager(driver, manager_path='')¶

Bases: whalesong.managers.BaseCollectionManager

Participant collection manager. It allows manage live location participants.

Parameters:	driver (`BaseWhalesongDriver`) – Whalesong driver manager_path (`str`) – Manager prefix path.

__getitem__(name)¶

Get a submanager. It could be a explicit submanager or contained model manager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`Union`[`BaseManager`, ~MODEL_MANAGER_TYPE]

__getattr__(name)¶

Get a submanager. It could be a explicit submanager or contained model manager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`Union`[`BaseManager`, ~MODEL_MANAGER_TYPE]

add_submanager(name, submanager)¶

Add a submanager.

Parameters:	name (`str`) – Field where manager will be stored. submanager (`BaseManager`) – Submanager

find_item_by_id(item_id)¶

Find model by identifier. If item is not in collection it will try to load it.

Parameters:	item_id (`str`) – Model identifier.
Return type:	`Result`[+MODEL_TYPE]
Returns:	Model object.

get_commands()¶

Get manager available static commands.

Return type:	`Result`[`List`[`str`]]
Returns:	Manager static commands.

get_first()¶

Get first item in collection.

Return type:	`Result`[+MODEL_TYPE]
Returns:	Model object.

get_item_by_id(item_id)¶

Get model by identifier.

Parameters:	item_id (`str`) – Model identifier.
Return type:	`Result`[+MODEL_TYPE]
Returns:	Model object.

get_item_result_class()¶

Return type:	`Result`[+MODEL_TYPE]

get_items()¶

Get all items on collection.

Return type:	`IteratorResult`[+MODEL_TYPE]
Returns:	Async iterator

get_iterator_result_class()¶

Return type:	`IteratorResult`[+MODEL_TYPE]

get_last()¶

Get last item in collection.

Return type:	`Result`[+MODEL_TYPE]
Returns:	Model object.

get_length()¶

Get collection items count.

Return type:	`Result`[`int`]
Returns:	Items count

get_monitor_result_class()¶

Return type:	`MonitorResult`[+MODEL_TYPE]

get_submanager(name)¶

Get a submanager. It could be a explicit submanager or contained model manager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`Union`[`BaseManager`, ~MODEL_MANAGER_TYPE]

monitor_add()¶

Monitor add item collection. Iterate each time a item is added to collection.

Return type:	`MonitorResult`[+MODEL_TYPE]
Returns:	Model object iterator

monitor_change()¶

Monitor change item collection. Iterate each time a item change in collection.

Return type:	`MonitorResult`[+MODEL_TYPE]
Returns:	Model object iterator

monitor_field(field)¶

Monitor item’s field change. Iterate each time a field changed in any item of collection.

Return type:	`MonitorResult`[`Dict`[`str`, `Any`]]
Returns:	Model object iterator

monitor_remove()¶

Monitor remove item collection. Iterate each time a item is removed from collection.

Return type:	`MonitorResult`[+MODEL_TYPE]
Returns:	Model object iterator

remove_item_by_id(item_id)¶

Remove item by identifier.

Parameters:	item_id (`str`) – Model identifier.
Return type:	`Result`[`None`]

remove_submanager(name)¶

Remove a submanager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`Result`[~T]

MODEL_MANAGER_CLASS¶: alias of ParticipantManager

class whalesong.managers.live_location.ParticipantManager(driver, manager_path='')¶

Bases: whalesong.managers.BaseModelManager

Participant manager.

Parameters:	driver (`BaseWhalesongDriver`) – Whalesong driver manager_path (`str`) – Manager prefix path.

__getitem__(name)¶

Get a submanager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`BaseManager`

__getattr__(name)¶

Get a submanager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`BaseManager`

add_submanager(name, submanager)¶

Add a submanager.

Parameters:	name (`str`) – Field where manager will be stored. submanager (`BaseManager`) – Submanager

get_commands()¶

Get manager available static commands.

Return type:	`Result`[`List`[`str`]]
Returns:	Manager static commands.

get_field_monitor_result_class(field)¶

Return type:	`MonitorResult`[`Dict`[`str`, `Any`]]

get_model()¶

Get model object

Return type:	`Result`[+MODEL_TYPE]
Returns:	Model object

get_model_result_class()¶

Return type:	`Result`[+MODEL_TYPE]

get_monitor_result_class()¶

Return type:	`MonitorResult`[+MODEL_TYPE]

get_submanager(name)¶

Get a submanager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`BaseManager`

map_model(data)¶

Return type:	+MODEL_TYPE

monitor_field(field)¶

Monitor any change on a model’s field.

Parameters:	field (`str`) – Field to monitor.
Return type:	`MonitorResult`[`Dict`[`str`, `Any`]]
Returns:	Model monitor

monitor_model()¶

Monitor any change on model.

Return type:	`MonitorResult`[+MODEL_TYPE]
Returns:	Model monitor

remove_submanager(name)¶

Remove a submanager.

Parameters:	name (`str`) – Field where submanager was stored.
Return type:	`Result`[~T]

MODEL_CLASS¶: alias of Participant

Models¶

Model whalesong.managers.live_location.Participant(data=None, flat=False, *args, **kwargs)¶

Bases: whalesong.models.BaseModel

Live location participant model.

property accuracy: int¶: Location accuracy in meters.

property comment: str¶: Comment sent with live location message.

property degrees: float¶: User direction in degrees.

property expiration: datetime¶: When live location will expire.

property lat: float¶: Latitude.

property lng: float¶: Longitude.

property msg: BaseMessage¶: Message used to start live location.

property contact: Contact¶: Live location owner.

property sequence: int¶: Sequence number.

property speed: int¶: User speed.

property id: str [READ ONLY]¶: StringIdField field [READ ONLY]

property lastUpdate: datetime¶

DateTimeField field

Aliases:	last_update

Model whalesong.managers.live_location.LiveLocation(data=None, flat=False, *args, **kwargs)¶

Bases: whalesong.models.BaseModel

Live location model.

property duration: timedelta¶: Live location duration.

property id: str [READ ONLY]¶: StringIdField field [READ ONLY]

property participants: List of Participant¶: List of participants.

Live location references¶

Managers¶

Models¶

Whalesong

Table of Contents

Related Topics

This Page