nv_python_libs.mtv.mtv_api.Videos Class Reference

List of all members.

Public Member Functions
def	__init__
def	massageDescription
	Start - Utility functions.
def	textUtf8
def	ampReplace
def	setTreeViewIcon
def	searchTitle
	End of Utility functions.
def	videoDetails
def	searchForVideos
def	displayTreeView
def	makeURL
def	getVideos
def	getVideosForURL
Public Attributes
	config
	log_name
	log
	error_messages
	key_translation
	tree_order
	tree_org
	tree_customize
	feed_names
	feed_icons
	mtvHtmlPath
	treeview
	channel_icon
	tree_dir_icon
	grabber_title
	channel
	tree_key
Private Member Functions
def	_initLogger

---

Detailed Description

Main interface to http://www.mtv.com/
This is done to support a common naming framework for all python Netvision plugins no matter their site
target.

Supports search methods
The apikey is a not required to access http://www.mtv.com/

Definition at line 101 of file mtv_api.py.

---

Constructor & Destructor Documentation

def nv_python_libs.mtv.mtv_api.Videos.__init__	(		self,
			apikey,
			mythtv = True,
			interactive = False,
			select_first = False,
			debug = False,
			custom_ui = None,
			language = None,
			search_all_languages = False
	)

apikey (str/unicode):
    Specify the target site API key. Applications need their own key in some cases

mythtv (True/False):
    When True, the returned meta data is being returned has the key and values massaged to match MythTV
    When False, the returned meta data  is being returned matches what target site returned

interactive (True/False): (This option is not supported by all target site apis)
    When True, uses built-in console UI is used to select the correct show.
    When False, the first search result is used.

select_first (True/False): (This option is not supported currently implemented in any grabbers)
    Automatically selects the first series search result (rather
    than showing the user a list of more than one series).
    Is overridden by interactive = False, or specifying a custom_ui

debug (True/False):
     shows verbose debugging information

custom_ui (xx_ui.BaseUI subclass): (This option is not supported currently implemented in any grabbers)
    A callable subclass of interactive class (overrides interactive option)

language (2 character language abbreviation): (This option is not supported by all target site apis)
    The language of the returned data. Is also the language search
    uses. Default is "en" (English). For full list, run..

search_all_languages (True/False): (This option is not supported by all target site apis)
    By default, a Netvision grabber will only search in the language specified using
    the language option. When this is True, it will search for the
    show in any language

Definition at line 109 of file mtv_api.py.

---

Member Function Documentation

def nv_python_libs.mtv.mtv_api.Videos.massageDescription	(		self,
			text
	)

Start - Utility functions.

Removes HTML markup from a text string.
@param text The HTML source.
@return The plain text.  If the HTML source contains non-ASCII
entities or character references, this is a Unicode string.

Definition at line 256 of file mtv_api.py.

Referenced by nv_python_libs.vimeo.vimeo_api.Videos.getTreeVideos(), nv_python_libs.mtv.mtv_api.Videos.getVideos(), nv_python_libs.youtube.youtube_api.Videos.getVideos(), nv_python_libs.vimeo.vimeo_api.Videos.getVideos(), nv_python_libs.mtv.mtv_api.Videos.getVideosForURL(), nv_python_libs.youtube.youtube_api.Videos.getVideosForURL(), nv_python_libs.mtv.mtv_api.Videos.searchTitle(), nv_python_libs.youtube.youtube_api.Videos.searchTitle(), and nv_python_libs.vimeo.vimeo_api.Videos.searchTitle().

def nv_python_libs.mtv.mtv_api.Videos._initLogger

(

self

)

[private]

Setups a logger using the logging module, returns a log object

Definition at line 290 of file mtv_api.py.

def nv_python_libs.mtv.mtv_api.Videos.textUtf8	(		self,
			text
	)

Definition at line 309 of file mtv_api.py.

Referenced by giantbomb.giantbomb_api.gamedbQueries.ampReplace(), nv_python_libs.mtv.mtv_api.Videos.ampReplace(), nv_python_libs.youtube.youtube_api.Videos.ampReplace(), nv_python_libs.vimeo.vimeo_api.Videos.ampReplace(), nv_python_libs.mtv.mtv_api.Videos.massageDescription(), nv_python_libs.youtube.youtube_api.Videos.massageDescription(), nv_python_libs.vimeo.vimeo_api.Videos.massageDescription(), and giantbomb.giantbomb_api.gamedbQueries.massageText().

def nv_python_libs.mtv.mtv_api.Videos.ampReplace	(		self,
			text
	)

Replace all "&" characters with "&"

Definition at line 321 of file mtv_api.py.

Referenced by nv_python_libs.vimeo.vimeo_api.Videos.getTreeVideos(), nv_python_libs.mtv.mtv_api.Videos.getVideosForURL(), nv_python_libs.youtube.youtube_api.Videos.getVideosForURL(), nv_python_libs.mtv.mtv_api.Videos.massageDescription(), nv_python_libs.youtube.youtube_api.Videos.massageDescription(), nv_python_libs.vimeo.vimeo_api.Videos.massageDescription(), giantbomb.giantbomb_api.gamedbQueries.massageText(), nv_python_libs.youtube.youtube_api.Videos.processVideoUrl(), nv_python_libs.vimeo.vimeo_api.Videos.processVideoUrl(), nv_python_libs.youtube.youtube_api.Videos.searchTitle(), and nv_python_libs.vimeo.vimeo_api.Videos.searchTitle().

def nv_python_libs.mtv.mtv_api.Videos.setTreeViewIcon	(		self,
			dir_icon = None
	)

Check if there is a specific generic tree view icon. If not default to the channel icon.
return self.tree_dir_icon

Definition at line 329 of file mtv_api.py.

Referenced by nv_python_libs.vimeo.vimeo_api.Videos.getTreeVideos(), nv_python_libs.mtv.mtv_api.Videos.getVideos(), nv_python_libs.youtube.youtube_api.Videos.getVideos(), nv_python_libs.vimeo.vimeo_api.Videos.getVideos(), nv_python_libs.mtv.mtv_api.Videos.getVideosForURL(), and nv_python_libs.youtube.youtube_api.Videos.getVideosForURL().

def nv_python_libs.mtv.mtv_api.Videos.searchTitle	(		self,
			title,
			pagenumber,
			pagelen
	)

End of Utility functions.

Key word video search of the MTV web site
return an array of matching item dictionaries
return

Definition at line 353 of file mtv_api.py.

Referenced by nv_python_libs.tedtalks.tedtalks_api.Videos.searchForVideos(), nv_python_libs.thewb.thewb_api.Videos.searchForVideos(), and nv_python_libs.rev3.rev3_api.Videos.searchForVideos().

def nv_python_libs.mtv.mtv_api.Videos.videoDetails	(		self,
			url,
			title = u''
	)

Using the passed URL retrieve the video meta data details
return a dictionary of video metadata details
return

Definition at line 448 of file mtv_api.py.

Referenced by nv_python_libs.mtv.mtv_api.Videos.searchTitle().

def nv_python_libs.mtv.mtv_api.Videos.searchForVideos	(		self,
			title,
			pagenumber
	)

Common name for a video search. Used to interface with MythTV plugin NetVision

Definition at line 501 of file mtv_api.py.

def nv_python_libs.mtv.mtv_api.Videos.displayTreeView

(

self

)

Gather the MTV Genres/Artists/...etc then get a max page of videos meta data in each of them
return array of directories and their video metadata

Definition at line 572 of file mtv_api.py.

def nv_python_libs.mtv.mtv_api.Videos.makeURL	(		self,
			URL
	)

Form a URL to search for videos
return a URL

Definition at line 600 of file mtv_api.py.

Referenced by nv_python_libs.mtv.mtv_api.Videos.getVideos(), and nv_python_libs.youtube.youtube_api.Videos.getVideos().

def nv_python_libs.mtv.mtv_api.Videos.getVideos	(		self,
			dir_dict,
			dictionaries
	)

Parse a list made of genres/artists ... etc lists and retrieve video meta data
return a dictionary of directory names and categories video metadata

Definition at line 626 of file mtv_api.py.

def nv_python_libs.mtv.mtv_api.Videos.getVideosForURL	(		self,
			url,
			dictionaries
	)

Get the video metadata for url search
return the video dictionary of directories and their video mata data

Definition at line 661 of file mtv_api.py.

---

Member Data Documentation

nv_python_libs::mtv::mtv_api.Videos::config

Definition at line 140 of file mtv_api.py.

Referenced by nv_python_libs.mtv.mtv_api.Videos::_initLogger(), nv_python_libs.youtube.youtube_api.Videos::_initLogger(), nv_python_libs.vimeo.vimeo_api.Videos::_initLogger(), nv_python_libs.rev3.rev3_api.Videos::displayTreeView(), giantbomb.giantbomb_api.gamedbQueries::gameData(), giantbomb.giantbomb_api.gamedbQueries::gameSearch(), nv_python_libs.rev3.rev3_api.Videos::getVideoID(), nv_python_libs.mtv.mtv_api.Videos::getVideos(), nv_python_libs.youtube.youtube_api.Videos::getVideos(), nv_python_libs.vimeo.vimeo_api.Videos::getVideos(), nv_python_libs.mtv.mtv_api.Videos::getVideosForURL(), nv_python_libs.youtube.youtube_api.Videos::getVideosForURL(), tmdb.moviedbQueries::hashData(), tmdb.moviedbQueries::movieData(), tmdb.moviedbQueries::movieSearch(), tmdb.moviedbQueries::peopleData(), tmdb.moviedbQueries::peopleSearch(), nv_python_libs.tedtalks.tedtalks_api.Videos::searchForVideos(), nv_python_libs.thewb.thewb_api.Videos::searchForVideos(), nv_python_libs.rev3.rev3_api.Videos::searchForVideos(), nv_python_libs.tedtalks.tedtalks_api.Videos::searchTitle(), nv_python_libs.mtv.mtv_api.Videos::searchTitle(), nv_python_libs.thewb.thewb_api.Videos::searchTitle(), nv_python_libs.youtube.youtube_api.Videos::searchTitle(), nv_python_libs.rev3.rev3_api.Videos::searchTitle(), nv_python_libs.pbs.pbs_api.Videos::updatePBS(), nv_python_libs.rev3.rev3_api.Videos::updateRev3(), nv_python_libs.tedtalks.tedtalks_api.Videos::updateTedTalks(), nv_python_libs.thewb.thewb_api.Videos::updateTheWB(), and nv_python_libs.mtv.mtv_api.Videos::videoDetails().

nv_python_libs::mtv::mtv_api.Videos::log_name

Definition at line 140 of file mtv_api.py.

Referenced by nv_python_libs.mtv.mtv_api.Videos._initLogger(), nv_python_libs.youtube.youtube_api.Videos._initLogger(), and nv_python_libs.vimeo.vimeo_api.Videos._initLogger().

nv_python_libs::mtv::mtv_api.Videos::log

Definition at line 140 of file mtv_api.py.

nv_python_libs::mtv::mtv_api.Videos::error_messages

Definition at line 140 of file mtv_api.py.

Referenced by nv_python_libs.rev3.rev3_api.Videos.displayTreeView(), nv_python_libs.vimeo.vimeo_api.Videos.getTreeVideos(), nv_python_libs.mtv.mtv_api.Videos.getVideosForURL(), nv_python_libs.youtube.youtube_api.Videos.getVideosForURL(), tmdb.moviedbQueries.hashData(), tmdb.moviedbQueries.movieData(), tmdb.moviedbQueries.movieSearch(), tmdb.moviedbQueries.peopleData(), tmdb.moviedbQueries.peopleSearch(), nv_python_libs.tedtalks.tedtalks_api.Videos.searchForVideos(), nv_python_libs.thewb.thewb_api.Videos.searchForVideos(), nv_python_libs.rev3.rev3_api.Videos.searchForVideos(), nv_python_libs.tedtalks.tedtalks_api.Videos.searchTitle(), nv_python_libs.mtv.mtv_api.Videos.searchTitle(), nv_python_libs.thewb.thewb_api.Videos.searchTitle(), nv_python_libs.youtube.youtube_api.Videos.searchTitle(), nv_python_libs.rev3.rev3_api.Videos.searchTitle(), nv_python_libs.vimeo.vimeo_api.Videos.searchTitle(), nv_python_libs.pbs.pbs_api.Videos.updatePBS(), nv_python_libs.rev3.rev3_api.Videos.updateRev3(), nv_python_libs.tedtalks.tedtalks_api.Videos.updateTedTalks(), nv_python_libs.thewb.thewb_api.Videos.updateTheWB(), and nv_python_libs.mtv.mtv_api.Videos.videoDetails().

nv_python_libs::mtv::mtv_api.Videos::key_translation

Definition at line 140 of file mtv_api.py.

Referenced by nv_python_libs.vimeo.vimeo_api.Videos.getTreeVideos(), nv_python_libs.mtv.mtv_api.Videos.getVideosForURL(), and nv_python_libs.youtube.youtube_api.Videos.getVideosForURL().

nv_python_libs::mtv::mtv_api.Videos::tree_order

Definition at line 140 of file mtv_api.py.

nv_python_libs::mtv::mtv_api.Videos::tree_org

Definition at line 140 of file mtv_api.py.

nv_python_libs::mtv::mtv_api.Videos::tree_customize

Definition at line 140 of file mtv_api.py.

Referenced by nv_python_libs.mtv.mtv_api.Videos.makeURL(), nv_python_libs.youtube.youtube_api.Videos.makeURL(), and nv_python_libs.dailymotion.dailymotion_api.Videos.makeURL().

nv_python_libs::mtv::mtv_api.Videos::feed_names

Definition at line 140 of file mtv_api.py.

Referenced by nv_python_libs.mtv.mtv_api.Videos.getVideosForURL(), and nv_python_libs.youtube.youtube_api.Videos.getVideosForURL().

nv_python_libs::mtv::mtv_api.Videos::feed_icons

Definition at line 140 of file mtv_api.py.

Referenced by nv_python_libs.mtv.mtv_api.Videos.getVideos(), nv_python_libs.youtube.youtube_api.Videos.getVideos(), nv_python_libs.dailymotion.dailymotion_api.Videos.getVideos(), and nv_python_libs.vimeo.vimeo_api.Videos.getVideos().

nv_python_libs::mtv::mtv_api.Videos::mtvHtmlPath

Definition at line 140 of file mtv_api.py.

Referenced by nv_python_libs.mtv.mtv_api.Videos.getVideosForURL(), and nv_python_libs.mtv.mtv_api.Videos.videoDetails().

nv_python_libs::mtv::mtv_api.Videos::treeview

Definition at line 140 of file mtv_api.py.

nv_python_libs::mtv::mtv_api.Videos::channel_icon

Definition at line 140 of file mtv_api.py.

Referenced by nv_python_libs.pbs.pbs_api.Videos.displayTreeView(), nv_python_libs.tedtalks.tedtalks_api.Videos.displayTreeView(), nv_python_libs.rev3.rev3_api.Videos.displayTreeView(), nv_python_libs.mtv.mtv_api.Videos.getVideos(), nv_python_libs.youtube.youtube_api.Videos.getVideos(), nv_python_libs.dailymotion.dailymotion_api.Videos.getVideos(), and nv_python_libs.vimeo.vimeo_api.Videos.getVideos().

nv_python_libs::mtv::mtv_api.Videos::tree_dir_icon

Definition at line 331 of file mtv_api.py.

nv_python_libs::mtv::mtv_api.Videos::grabber_title

Definition at line 502 of file mtv_api.py.

Referenced by nv_python_libs.mainProcess.siteQueries::displayHTML(), nv_python_libs.mainProcess.siteQueries::displayTreeView(), nv_python_libs.pbs.pbs_api.Videos::displayTreeView(), nv_python_libs.tedtalks.tedtalks_api.Videos::displayTreeView(), nv_python_libs.mashups.mashups_api.Videos::displayTreeView(), and nv_python_libs.mashups.mashups_api.Videos::searchForVideos().

nv_python_libs::mtv::mtv_api.Videos::channel

Definition at line 574 of file mtv_api.py.

Referenced by nv_python_libs.rev3.rev3_api.Videos::displayTreeView(), nv_python_libs.vimeo.vimeo_api.Videos::getTreeVideos(), nv_python_libs.mtv.mtv_api.Videos::getVideosForURL(), nv_python_libs.youtube.youtube_api.Videos::getVideosForURL(), nv_python_libs.tedtalks.tedtalks_api.Videos::searchForVideos(), nv_python_libs.thewb.thewb_api.Videos::searchForVideos(), nv_python_libs.rev3.rev3_api.Videos::searchForVideos(), nv_python_libs.thewb.thewb_api.Videos::searchTitle(), nv_python_libs.youtube.youtube_api.Videos::searchTitle(), nv_python_libs.rev3.rev3_api.Videos::searchTitle(), and nv_python_libs.vimeo.vimeo_api.Videos::searchTitle().

nv_python_libs::mtv::mtv_api.Videos::tree_key

Definition at line 574 of file mtv_api.py.

Referenced by nv_python_libs.mtv.mtv_api.Videos.getVideos(), nv_python_libs.youtube.youtube_api.Videos.getVideos(), nv_python_libs.vimeo.vimeo_api.Videos.getVideos(), nv_python_libs.mtv.mtv_api.Videos.getVideosForURL(), nv_python_libs.youtube.youtube_api.Videos.getVideosForURL(), nv_python_libs.mtv.mtv_api.Videos.makeURL(), and nv_python_libs.youtube.youtube_api.Videos.makeURL().

---

The documentation for this class was generated from the following file:

• mtv_api.py