oEmbedPy is a powerful oEmbed client designed specifically for Python, enabling developers to easily retrieve rich media content from various online platforms. With its straightforward usage and Python 3.x compatibility, oEmbedPy simplifies the implementation of oEmbed functionality within applications.

Key Features

• Simple usage: The intuitive interface allows for quick integration and retrieval of embedded content.
• Python 3.x native: Fully compatible with Python 3.x, ensuring a modern approach to development.
• Multiple endpoint discovery: Automatically discovers and uses the correct oEmbed endpoint for various providers.

Installation

Install oEmbedPy through PyPI to get started easily:

pip install oEmbedPy

Usage

Library Integration

To utilize oEmbedPy in Python applications, the following example demonstrates how to fetch content:

from oembedpy.application import Oembed

oembed = Oembed()
content = oembed.fetch("https://twitter.com/attakei")
print(content.type)  # Output: rich

Command-Line Interface

For those who prefer command-line usage, oEmbedPy offers a CLI that can be enhanced with Click:

# Basic command
$ oEmbed.py 'https://www.youtube.com/watch?v=Oyh8nuaLASA'
title:            Yoshi ( ...
author_name:      attakei
thumbnail_height: 360
thumbnail_width:  400

To receive output in JSON format, use the --format option:

$ oEmbed.py --format=json 'https://www.youtube.com/watch?v=Oyh8nuaLASA'
{"title":"Yoshi (NES - Nint ..."}

Additional Documentation

For comprehensive guidance and further features, refer to the documentation.

oEmbedPy streamlines the process of embedding content across various platforms, making it an essential tool for developers looking to enrich their applications with external media.