e9625e9feb
Persist following properties:
mopidy.core.tracklist
_tl_tracks
_next_tlid
get_consume()
get_random()
get_repeat()
get_single()
mopidy.core.history
_history
mopidy.core.playlist
get_current_tl_track()
get_time_position()
mopidy.core.mixer
get_volume()
Details:
- moved json export/import write_library()/load_library() from mopidy/local to mopidy/models
- new core methods save_state(), load_state()
- save_state(), load_state() accessible via rpc
- save state to disk at stop
- load state from disk at start
- new config: core.restore_state ("off", "load", "play")
TODO:
- seek to play position does not work. Timing issue.
- use extra thread to load state from disk at start?
113 lines
2.9 KiB
ReStructuredText
113 lines
2.9 KiB
ReStructuredText
************************************
|
|
:mod:`mopidy.models` --- Data models
|
|
************************************
|
|
|
|
These immutable data models are used for all data transfer within the Mopidy
|
|
backends and between the backends and the MPD frontend. All fields are optional
|
|
and immutable. In other words, they can only be set through the class
|
|
constructor during instance creation. Additionally fields are type checked.
|
|
|
|
If you want to modify a model, use the
|
|
:meth:`~mopidy.models.ImmutableObject.replace` method. It accepts keyword
|
|
arguments for the parts of the model you want to change, and copies the rest of
|
|
the data from the model you call it on. Example::
|
|
|
|
>>> from mopidy.models import Track
|
|
>>> track1 = Track(name='Christmas Carol', length=171)
|
|
>>> track1
|
|
Track(artists=[], length=171, name='Christmas Carol')
|
|
>>> track2 = track1.replace(length=37)
|
|
>>> track2
|
|
Track(artists=[], length=37, name='Christmas Carol')
|
|
>>> track1
|
|
Track(artists=[], length=171, name='Christmas Carol')
|
|
|
|
|
|
Data model relations
|
|
====================
|
|
|
|
.. digraph:: model_relations
|
|
|
|
Ref -> Album [ style="dotted", weight=1 ]
|
|
Ref -> Artist [ style="dotted", weight=1 ]
|
|
Ref -> Directory [ style="dotted", weight=1 ]
|
|
Ref -> Playlist [ style="dotted", weight=1 ]
|
|
Ref -> Track [ style="dotted", weight=1 ]
|
|
|
|
Playlist -> Track [ label="has 0..n", weight=2 ]
|
|
Track -> Album [ label="has 0..1", weight=10 ]
|
|
Track -> Artist [ label="has 0..n", weight=10 ]
|
|
Album -> Artist [ label="has 0..n", weight=10 ]
|
|
|
|
Image
|
|
|
|
SearchResult -> Artist [ label="has 0..n", weight=1 ]
|
|
SearchResult -> Album [ label="has 0..n", weight=1 ]
|
|
SearchResult -> Track [ label="has 0..n", weight=1 ]
|
|
|
|
TlTrack -> Track [ label="has 1", weight=20 ]
|
|
|
|
|
|
Data model API
|
|
==============
|
|
|
|
.. module:: mopidy.models
|
|
:synopsis: Data model API
|
|
|
|
.. autoclass:: mopidy.models.Ref
|
|
|
|
.. autoclass:: mopidy.models.Track
|
|
|
|
.. autoclass:: mopidy.models.Album
|
|
|
|
.. autoclass:: mopidy.models.Artist
|
|
|
|
.. autoclass:: mopidy.models.Playlist
|
|
|
|
.. autoclass:: mopidy.models.Image
|
|
|
|
.. autoclass:: mopidy.models.TlTrack
|
|
|
|
.. autoclass:: mopidy.models.SearchResult
|
|
|
|
|
|
Data model helpers
|
|
==================
|
|
|
|
.. autoclass:: mopidy.models.ImmutableObject
|
|
:members:
|
|
|
|
.. autoclass:: mopidy.models.ValidatedImmutableObject
|
|
:members: replace
|
|
|
|
Data model (de)serialization
|
|
----------------------------
|
|
|
|
.. autofunction:: mopidy.models.model_json_decoder
|
|
|
|
.. autoclass:: mopidy.models.ModelJSONEncoder
|
|
|
|
Data model import/export
|
|
----------------------------
|
|
|
|
.. autofunction:: mopidy.models.storage.save
|
|
|
|
.. autofunction:: mopidy.models.storage.load
|
|
|
|
Data model field types
|
|
----------------------
|
|
|
|
.. autoclass:: mopidy.models.fields.Field
|
|
|
|
.. autoclass:: mopidy.models.fields.String
|
|
|
|
.. autoclass:: mopidy.models.fields.Identifier
|
|
|
|
.. autoclass:: mopidy.models.fields.URI
|
|
|
|
.. autoclass:: mopidy.models.fields.Date
|
|
|
|
.. autoclass:: mopidy.models.fields.Integer
|
|
|
|
.. autoclass:: mopidy.models.fields.Collection
|