jwlib 1.0.0

Wrapper for jw.org APIs

Python wrappers for a few jw.org APIs.

Installation

pip install jwlib

Usage

Video API

import jwlib.media as jw

# Select Swedish
session = jw.Session(language='Z')

# Fetch the JW Broadcasting category
studio_category = session.get_category('VODStudio')

# Iterate through all its subcategories
# (this will make more API requests as needed)
for subcategory in studio_category.get_subcategories():

    # Print a category header
    print(f'\n{subcategory.name}\n-----------')

    # Print title and URL of all media items
    for media in subcategory.get_media():
        print(media.title)
        print(media.get_file().url)

See the media documentation for more details.

Publication API

TODO

Search API

TODO

Language API

TODO

Development

An example on how to setup the dev environment:

# Create a virtual Python environement
python -m venv venv
. venv/bin/activate

# Install dependencies
# -e keeps the installed jwlib in sync with your changes
# [dev] installs the dependencies for testing
pip install -e '.[dev]'

# If you also want to build documentation:
pip install -e '.[dev,docs]'

# Show some convenience functions
make help