pyliveleak package¶
Submodules¶
pyliveleak.cli module¶
Console script for pyliveleak.
pyliveleak.pyliveleak module¶
Main module.
-
class
pyliveleak.pyliveleak.
AddItemPage
(html, cookies)[source]¶ Bases:
object
This internal class performs the hard work for adding a video to liveleak.com.
- That is a three-stage process:
- Upload the video file to liveleak’s AWS S3 bucket.
- Add the file to liveleak, yielding a file token.
- Specify metadata and publish the video.
-
connect_string
¶ Parse the connect_string from the page.
This is unique for each page load.
-
connection
¶ Parse the connection number from the page.
This is unique for each page load.
-
multipart_params
¶ Parse the multipart_params dict from the JavaScript in the page.
We need these params to upload the file to AWS.
-
class
pyliveleak.pyliveleak.
IndexPage
(html, cookies)[source]¶ Bases:
object
Represents a logged-in session with liveleak.com.
To obtain an instance of this class, see the
pyliveleak.login()
function.-
__init__
(html, cookies)[source]¶ Internal constructor.
Parameters: - html (str) – The HTML from the index page.
- cookies (str) – A dictionary of cookies containing the entire session.
-
add_item
(path, title=None, body=None, tags='liveleak.py', category='other')[source]¶ Upload a video to liveleak.com.
Parameters: - path (str) – The full path to the video to upload.
- title (str) – The title of the video. If None, will be the filename of the video.
- description (str) – A description of the video. If None, will be the filename of the video.
- tags (str) – Tags for the video.
- category (str) – The name of the category for the video.
Returns: The file_token and item_token as a tuple.
- You may use the item_token to access the uploaded video through your browser::
- https://www.liveleak.com/view?i={item_token}
-
-
exception
pyliveleak.pyliveleak.
PyLiveleakException
[source]¶ Bases:
exceptions.RuntimeError
Raised when something unexpected happens within pyliveleak.
-
pyliveleak.pyliveleak.
login
(username, password)[source]¶ Login to liveleak.com.
This is the main entry point to pyliveleak. Once you login, you can upload videos.
Parameters: - username (str) – Your liveleak.com username
- password (str) – Your liveleak.com password
Returns: A new session with liveleak.com.
Return type:
Module contents¶
Sample usage:
>>> import pyliveleak
>>> index_page = pyliveleak.login(username, password)
>>> file_token, item_token = index_page.add_item('tests/test-data/foreman_cif.mp4')
>>> item_token
u'b86_1502357642'
Your new video will be available here: https://www.liveleak.com/view?i={item_token}
You may specify optional metadata:
>>> index_page.add_item('tests/test-data/foreman_cif.mp4', title='my title',
... body='detailed description', tags='tags', category='World News')
The category must be one of:
>>> pprint.pprint(sorted(pyliveleak.CATEGORIES))
['afghanistan',
'citizen journalism',
'conspiracy',
'creative',
'history',
'hobbies',
'iran',
'iraq',
'liveleak challenges',
'liveleaks',
'music',
'nature',
'other',
'other entertainment',
'other items from liveleakers',
'other middle east',
'other news',
'politics',
'propaganda',
'regional news',
'religion',
'science and technology',
'sports',
'syria',
'ukraine',
'vehicles',
'weapons',
'world news',
'wtf',
'yawn',
'your say']
-
pyliveleak.
login
(username, password)[source]¶ Login to liveleak.com.
This is the main entry point to pyliveleak. Once you login, you can upload videos.
Parameters: - username (str) – Your liveleak.com username
- password (str) – Your liveleak.com password
Returns: A new session with liveleak.com.
Return type:
-
class
pyliveleak.
IndexPage
(html, cookies)[source]¶ Bases:
object
Represents a logged-in session with liveleak.com.
To obtain an instance of this class, see the
pyliveleak.login()
function.-
__init__
(html, cookies)[source]¶ Internal constructor.
Parameters: - html (str) – The HTML from the index page.
- cookies (str) – A dictionary of cookies containing the entire session.
-
add_item
(path, title=None, body=None, tags='liveleak.py', category='other')[source]¶ Upload a video to liveleak.com.
Parameters: - path (str) – The full path to the video to upload.
- title (str) – The title of the video. If None, will be the filename of the video.
- description (str) – A description of the video. If None, will be the filename of the video.
- tags (str) – Tags for the video.
- category (str) – The name of the category for the video.
Returns: The file_token and item_token as a tuple.
- You may use the item_token to access the uploaded video through your browser::
- https://www.liveleak.com/view?i={item_token}
-