lboxd
An unofficial letterboxd.com API

Get reviews from letterboxd users. Done with pure HTML parsing.

Development Environment

Ubuntu 20.04 lts
Python 3.8.5

This has not been tested on Windows, there may be encoding problems.

Installation

pip install lboxd

Usage

'''
Pretty printing reviews with a generator.
    => Generators are good for when there are requests to many different URLs.
    => A new requests session is created for the duration of the generator.
'''

import lboxd
from bs4 import BeautifulSoup as bs
from rich import print as rprint

for review in lboxd.reviews(user='redlettermedia', count=5):
    title = review ['title']
    review = review['review']
    htmlPretty = bs.prettify(bs(review, 'html.parser'))

    rprint(f'[yellow]Title:[/yellow] [red]{title}[/red]\n{htmlPretty}')

Redlettermedia example

from lboxd import lboxdlist
from rich import print as rprint

for movie in lboxdlist(user='daqoon'):
    title = movie ['title']
    rating = movie['rating']
    richTitle = f'[yellow]Title:[/yellow] [red]{title}[/red]'

    if rating:
        rprint(f'{richTitle} rating={rating}')
    else:
        rprint(richTitle)

Redlettermedia example

CLI

Example

Redlettermedia example

Arguments

--user USER -u USER letterboxd.com user

--reviews -r Gets reviews

--testing -t Testing flag - for development only

--save-html -w Saves an HTML document for easily viewing reviews

--browser-open -b Opens saved HTML document in the browser

--search SEARCH [SEARCH ...] -s SEARCH [SEARCH ...] Will only get search terms, currently needs to match exactly with letterboxd notation. Replace spaces with dashes.

Metadata

Release files for lboxd 1.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lboxd 1.2.1
File	Size	Uploaded
lboxd-1.2.1.tar.gz	5.6 kB	Jan 2, 2021	Details

Built distribution (wheel)

Table of built distributions (wheels) for lboxd 1.2.1
File	Interpreter	ABI	Platform	Reset
lboxd-1.2.1-py3-none-any.whl 6.6 kB Jan 2, 2021	Python 3	none	any	Details

Total release size: 12.2 kB

Release files / lboxd-1.2.1.tar.gz

Download URL	lboxd-1.2.1.tar.gz
Size	5.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`60aac19b80d5bb68547053ebc1596c7fdc2de8918003c0890a12b0e3272c5194`
BLAKE2b-256 checksum How to use checksums	`2de952e1c72b08380e84f6d30957edb4f9d2cd438e4027d66eeea3067a0706a8`
Upload date	Jan 2, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.0.10 CPython/3.8.5 Linux/5.4.0-58-generic`

Release files / lboxd-1.2.1-py3-none-any.whl

Download URL	lboxd-1.2.1-py3-none-any.whl
Size	6.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ce7ddaa139f07a6d309f2632e8dde22e5907d34e20e54a5bf2a24a710db30687`
BLAKE2b-256 checksum How to use checksums	`38bd926ae6d550ea6d25d1b98b25ab4f0a4dc1c424c9bcfdc7b0cd23f043d93e`
Upload date	Jan 2, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.0.10 CPython/3.8.5 Linux/5.4.0-58-generic`