Create separate PlexHistory objects

[JonnyWong16]

Description

PlexHistory objects are unique from their base media objects. These objects are built from /status/sessions/history instead of /library/metadata/<ratingKey>.

• New PlexHistory.source() to return the source media object for the history object.
• New PlexHistory.delete() to delete the history entry from the server.

Examples

>> history = plex.history()
>> historyObj = history[0]  # New `MovieHistory` object
>> historyObj 
<MovieHistory:1039:Big-Buck-Bunny>
>> historyObj.reload()  # Cannot reload a history object
NotImplementedError: History objects cannot be reloaded. Use source() to get the source media item.
>> historyObj.source()  # Returns the source `Movie` object.
<Movie:1039:Big-Buck-Bunny>

All existing methods should work with the new history objects, however, there may be some unknown behaviour since the object attributes may be different. It is recommended to work on the source media object to be safe.

>> history = plex.history()
>> historyObj = history[0]  # New `MovieHistory` object
>> historyObj
<EpisodeHistory:765:Game-of-Thrones-s01e01>
>> historyObj.show()  # Still able to call existing methods on history objects.
<Show:763:Game-of-Thrones>
>> historyObj.editTitle('New Title')  # Not recommended to work on the history object.
>> episode = historyObj.source()  # Get the source `Episode` object.
>> episode.editTitle('New Title')  # Recommended to work on the source media object.

Type of change

Please delete options that are not relevant.

• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have added or updated the docstring for new or existing methods
• I have added tests when applicable

[glensc]

this is an unfortunate method name, causing conflict:

• Feature: Add source property to playlist items to support remote playlist entries #1335 (comment)

what inspired this method name? maybe rename to origin or item or original?

[glensc]

@JonnyWong16: do you have answer? may give some ideas what other name to use here instead:

• Feature: Add source property to playlist items to support remote playlist entries #1335 (comment)