usenetbinary-newsreaderquickboxtraktkodistabletvshowsqnaptautullifanartsickbeardtvseriesplexswizzinembyseedboxtvdbnzbgetsubtitlewebui
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
184 lines
6.1 KiB
184 lines
6.1 KiB
# -*- coding: utf-8 -*-
|
|
|
|
"""
|
|
tmdbsimple.search
|
|
~~~~~~~~~~~~~~~~~
|
|
This module implements the Search functionality of tmdbsimple.
|
|
|
|
Created by Celia Oakley on 2013-10-31.
|
|
|
|
:copyright: (c) 2013-2018 by Celia Oakley
|
|
:license: GPLv3, see LICENSE for more details
|
|
"""
|
|
|
|
from .base import TMDB
|
|
|
|
class Search(TMDB):
|
|
"""
|
|
Search functionality
|
|
|
|
See: https://developers.themoviedb.org/3/search
|
|
"""
|
|
BASE_PATH = 'search'
|
|
URLS = {
|
|
'movie': '/movie',
|
|
'collection': '/collection',
|
|
'tv': '/tv',
|
|
'person': '/person',
|
|
'company': '/company',
|
|
'keyword': '/keyword',
|
|
'multi': '/multi'
|
|
}
|
|
|
|
def movie(self, **kwargs):
|
|
"""
|
|
Search for movies by title.
|
|
|
|
Args:
|
|
query: CGI escpaed string.
|
|
page: (optional) Minimum value of 1. Expected value is an integer.
|
|
language: (optional) ISO 639-1 code.
|
|
include_adult: (optional) Toggle the inclusion of adult titles.
|
|
Expected value is True or False.
|
|
year: (optional) Filter the results release dates to matches that
|
|
include this value.
|
|
primary_release_year: (optional) Filter the results so that only
|
|
the primary release dates have this value.
|
|
search_type: (optional) By default, the search type is 'phrase'.
|
|
This is almost guaranteed the option you will want.
|
|
It's a great all purpose search type and by far the
|
|
most tuned for every day querying. For those wanting
|
|
more of an "autocomplete" type search, set this
|
|
option to 'ngram'.
|
|
|
|
Returns:
|
|
A dict respresentation of the JSON returned from the API.
|
|
"""
|
|
path = self._get_path('movie')
|
|
|
|
response = self._GET(path, kwargs)
|
|
self._set_attrs_to_values(response)
|
|
return response
|
|
|
|
def collection(self, **kwargs):
|
|
"""
|
|
Search for collections by name.
|
|
|
|
Args:
|
|
query: CGI escpaed string.
|
|
page: (optional) Minimum value of 1. Expected value is an integer.
|
|
language: (optional) ISO 639-1 code.
|
|
|
|
Returns:
|
|
A dict respresentation of the JSON returned from the API.
|
|
"""
|
|
path = self._get_path('collection')
|
|
|
|
response = self._GET(path, kwargs)
|
|
self._set_attrs_to_values(response)
|
|
return response
|
|
|
|
def tv(self, **kwargs):
|
|
"""
|
|
Search for TV shows by title.
|
|
|
|
Args:
|
|
query: CGI escpaed string.
|
|
page: (optional) Minimum value of 1. Expected value is an integer.
|
|
language: (optional) ISO 639-1 code.
|
|
first_air_date_year: (optional) Filter the results to only match
|
|
shows that have a air date with with value.
|
|
search_type: (optional) By default, the search type is 'phrase'.
|
|
This is almost guaranteed the option you will want.
|
|
It's a great all purpose search type and by far the
|
|
most tuned for every day querying. For those wanting
|
|
more of an "autocomplete" type search, set this
|
|
option to 'ngram'.
|
|
|
|
Returns:
|
|
A dict respresentation of the JSON returned from the API.
|
|
"""
|
|
path = self._get_path('tv')
|
|
|
|
response = self._GET(path, kwargs)
|
|
self._set_attrs_to_values(response)
|
|
return response
|
|
|
|
def person(self, **kwargs):
|
|
"""
|
|
Search for people by name.
|
|
|
|
Args:
|
|
query: CGI escpaed string.
|
|
page: (optional) Minimum value of 1. Expected value is an integer.
|
|
include_adult: (optional) Toggle the inclusion of adult titles.
|
|
Expected value is True or False.
|
|
search_type: (optional) By default, the search type is 'phrase'.
|
|
This is almost guaranteed the option you will want.
|
|
It's a great all purpose search type and by far the
|
|
most tuned for every day querying. For those wanting
|
|
more of an "autocomplete" type search, set this
|
|
option to 'ngram'.
|
|
|
|
Returns:
|
|
A dict respresentation of the JSON returned from the API.
|
|
"""
|
|
path = self._get_path('person')
|
|
|
|
response = self._GET(path, kwargs)
|
|
self._set_attrs_to_values(response)
|
|
return response
|
|
|
|
def company(self, **kwargs):
|
|
"""
|
|
Search for companies by name.
|
|
|
|
Args:
|
|
query: CGI escpaed string.
|
|
page: (optional) Minimum value of 1. Expected value is an integer.
|
|
|
|
Returns:
|
|
A dict respresentation of the JSON returned from the API.
|
|
"""
|
|
path = self._get_path('company')
|
|
|
|
response = self._GET(path, kwargs)
|
|
self._set_attrs_to_values(response)
|
|
return response
|
|
|
|
def keyword(self, **kwargs):
|
|
"""
|
|
Search for keywords by name.
|
|
|
|
Args:
|
|
query: CGI escpaed string.
|
|
page: (optional) Minimum value of 1. Expected value is an integer.
|
|
|
|
Returns:
|
|
A dict respresentation of the JSON returned from the API.
|
|
"""
|
|
path = self._get_path('keyword')
|
|
|
|
response = self._GET(path, kwargs)
|
|
self._set_attrs_to_values(response)
|
|
return response
|
|
|
|
def multi(self, **kwargs):
|
|
"""
|
|
Search the movie, tv show and person collections with a single query.
|
|
|
|
Args:
|
|
query: CGI escpaed string.
|
|
page: (optional) Minimum value of 1. Expected value is an integer.
|
|
language: (optional) ISO 639-1 code.
|
|
include_adult: (optional) Toggle the inclusion of adult titles.
|
|
Expected value is True or False.
|
|
|
|
Returns:
|
|
A dict respresentation of the JSON returned from the API.
|
|
"""
|
|
path = self._get_path('multi')
|
|
|
|
response = self._GET(path, kwargs)
|
|
self._set_attrs_to_values(response)
|
|
return response
|
|
|