<commit_before>|licence| |travis_ci| |python| |api|


mapi
====

mapi (**M**\ etadata **API**) is an is a pure python library which
provides a high-level interface for media database providers, allowing
users to lookup and search for television and movie metadata using a
simple and consistent interface.


Examples
========

Searching for a television show by series using TVDb
----------------------------------------------------

>>> from pprint import pprint
>>> from mapi.providers import TVDb
>>> client = TVDb(max_hits=3)
>>> hits = client.search(series='Rick and Morty', season=2)
>>> pprint(hit)
[{'episode': '1',
  'id_tvdb': '275274',
  'media': 'television',
  'season': '2',
  'series': 'Rick and Morty',
  'synopsis': 'Rick, Morty, and Summer get into trouble when time is fractured '
              'by a feedback loop of uncertainty that split reality into more '
              'than one equally possible impossibilities. Meanwhile, Beth and '
              'Jerry go to extreme lengths to save a deer struck by their '
              'vehicle.',
  'title': 'A Rickle in Time'},
 {'episode': '2',
  'id_tvdb': '275274',<commit_msg>Rewords tagline<commit_after>|licence| |travis_ci| |python| |api|


mapi
====

mapi (**M**\ etadata **API**) is a python library which provides a high-level interface for media database providers, allowing users to search for television and movie metadata using a simple interface.


Examples
========

Searching for a television show by series using TVDb
----------------------------------------------------

>>> from pprint import pprint
>>> from mapi.providers import TVDb
>>> client = TVDb(max_hits=3)
>>> hits = client.search(series='Rick and Morty', season=2)
>>> pprint(hit)
[{'episode': '1',
  'id_tvdb': '275274',
  'media': 'television',
  'season': '2',
  'series': 'Rick and Morty',
  'synopsis': 'Rick, Morty, and Summer get into trouble when time is fractured '
              'by a feedback loop of uncertainty that split reality into more '
              'than one equally possible impossibilities. Meanwhile, Beth and '
              'Jerry go to extreme lengths to save a deer struck by their '
              'vehicle.',
  'title': 'A Rickle in Time'},
 {'episode': '2',
  'id_tvdb': '275274',
{'fraction_non_alphanumeric': 0.16940133037694013, 'fraction_numerical': 0.01507760532150776, 'mean_word_length': 3.021390374331551, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 33, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '590326', 'n_tokens_mistral': 672, 'n_tokens_neox': 634, 'n_words': 259}