Metadata-Version: 2.0
Name: embedx
Version: 0.0.6
Summary: Generate responsive, embeddable HTML/JS code from URL of online content
Home-page: https://github.com/kmonsoor/embedX
Author: Khaled Monsoor
Author-email: k@kmonsoor.com
License: MIT
Keywords: embed,html,javascript,embeddable,code generation,from url
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Utilities
Classifier: Topic :: Software Development :: Libraries :: Python Modules

|License| |PyPI version| |Code Issues|

embedX
======

Generate embeddable HTML or JavaScript code for a online content from
its URL in a single step.

The content can be anything like

-  Youtube or Vimeo video,
-  Twitter status,
-  Github Gist, etc.

Embeddable code-generation be simple like this:

::

    >>> from embed_x import OnlineContent
    >>> oc = OnlineContent('http://www.youtube.com/embed/_lOT2p_FCvA')
    >>> oc.get_embed_code()
    "<div class='embedx-yt'><iframe src='http://www.youtube.com/embed/_lOT2p_FCvA' 'frameborder='0' allowfullscreen></iframe></div>"

Currently, supports
~~~~~~~~~~~~~~~~~~~

-  Youtube video,
-  Vimeo video,
-  Twitter: single status,
-  Github gist,
-  Flickr image

Examples of URLs
~~~~~~~~~~~~~~~~

Valid
^^^^^

-  http://youtu.be/\ *lOT2p*\ FCvA
-  www.youtube.com/watch?v=\ *lOT2p*\ FCvA&feature=feedu
-  http://www.youtube.com/embed/\ *lOT2p*\ FCvA
-  https://www.youtube.com/watch?v=rTHlyTphWP0&index=6&list=PLjeDyYvG6-40qawYNR4juzvSOg-ezZ2a6
-  youtube.com/watch?v=\ *lOT2p*\ FCvA
-  https://vimeo.com/groups/animation/videos/150618894/
-  https://vimeo.com/150519302
-  https://twitter.com/codinghorror/status/686254714938200064
-  

Invalid:
^^^^^^^^

-  youtu.be/watch?v=\ *lOT2p*\ FCvA [ because Youtube don't give any url
   like this ]
-  https://twitter.com/gvanrossum/with\_replies
-  

Install
-------

from PyPI
~~~~~~~~~

::

    pip install embedx

Directly from source
~~~~~~~~~~~~~~~~~~~~

::

    pip install git+https://github.com/kmonsoor/embedX.git

Requirements
------------

::

    This library don't have any external dependencies other than standard Python installation.

Usage
-----

::

    >>> from embedx import OnlineContent
    >>> oc = OnlineContent('http://www.youtube.com/embed/_lOT2p_FCvA')
    >>> oc.extract_id()
    '_lOT2p_FCvA'

    >>> oc.get_embed_code()
    "<div class='embed-container'><iframe src='http://www.youtube.com/embed/_lOT2p_FCvA' 'frameborder='0'allowfullscreen></iframe></div>"

    >>> oc = OnlineContent('https://vimeo.com/groups/animation/videos/150618894/')
    >>> oc.get_embed_code()
    "<div class='embed-container'> <iframe src='http://player.vimeo.com/video/150618894' frameborder='0' webkitAllowFullScreen mozallowfullscreen allowFullScreen></iframe></div>"

To-do
-----

-  Create test cases for automated testing
-  Provision Travis-CI for automatic building & testing
-  Add support for
   `conda <http://conda.pydata.org/docs/index.html>`__-based
   installation
-  Add more rich-content sites

-  [x] Github gists
-  [ ] Facebook status
-  [ ] Facebook notes
-  [ ] Scribd docs
-  [ ] Imgur images

Contributors
------------

-  Seed idea : `A StackOverflow
   answer <http://stackoverflow.com/a/7936523>`__ by `Mikhail
   Kashkin <http://stackoverflow.com/users/85739/mikhail-kashkin>`__
-  Author : `Khaled Monsoor <http://github.com/kmonsoor>`__
-  

Please try to contribute by submitting more content-sites with their
different link formats and embed-codes. You can submit through
pull-requests or by creating issue.

.. |License| image:: https://img.shields.io/badge/license-MIT-blue.svg
   :target: http://kmonsoor.mit-license.org/
.. |PyPI version| image:: https://badge.fury.io/py/embedX.svg
   :target: https://badge.fury.io/py/embedX
.. |Code Issues| image:: https://www.quantifiedcode.com/api/v1/project/69f2bf7e3b404e6c90015053e48a1cbf/badge.svg
   :target: https://www.quantifiedcode.com/app/project/69f2bf7e3b404e6c90015053e48a1cbf


