Index an archive in Elasticsearch.

Make a search request to the iTunes Search API with retry and adaptive backoff.

List all subscribed feeds organized by folder with unread counts.

List all folder names in the user's subscription structure.

Create a mock requests response with given raw bytes and encoding.

Normalize a loopback URI by stripping port and mapping localhost -> 127.0.0.1.

Normalize all keys in a section dict using normalize_section_key. Drops keys that can't be normalized. If merge_lists=True and multiple keys

Move a feed to a different folder, rename a feed, or rename a folder.

Extract datetime from a log line (format: '2026-03-04 08:26:25 ...').

Parse an iTunes API podcast result into our feed format.

Parse a subreddit data dict from the Reddit API into our feed format.

Recursively print a dict as key: value plain text.

Print analysis of remaining gaps.

Print analysis of remaining gaps.

Print analysis of remaining gaps.

Print analysis of remaining gaps.

Print summary of discovered podcasts.

Print summary of discovered feeds.

Print summary of discovered newsletters.

Print summary of discovered subreddits.

Print a summary of the generated taxonomy.

Publish category update event via Redis PubSub for real-time WebSocket updates. Args: user_id: The user ID archive_id: The a

Concatenate section HTML blocks in section_order, with fallback for unordered keys.

Make an authenticated GET request to Reddit's OAuth API with retry.

Queue reindexing of stories affected by category changes. This updates the Elasticsearch index for all stories that had categories chang

Remove an archive from Elasticsearch index.

Remove a list of nodes from the soup.

Escape unbalanced quotes to prevent Elasticsearch query_string errors. Elasticsearch's query_string query requires balanced quotes f

Save/star a story for later reference.

Format a classifier score with color.

Search across all stories in subscribed feeds by keyword.

Share a story to your Blurblog with optional comments.

SMBC-style stories: shared feed-name prefix, unique single-word suffix.

Subscribe to a new feed by URL.

Remove a story from saved/starred stories.

Unsubscribe from a feed.

Update folder-scoped classifiers when a folder's full path changes (move or rename). Updates the moved/renamed folder itself and all of its subfo

Count questions asked this week for free users.

Count transcriptions this week for free users.

* Add domain to user's blocklist * @param {string} domain - Domain to add

adds a feed processing job to the pool

Convenience constructor for read stories meta-feed.

Apply clustering to a list of story dicts from the river view. For each story on the current page that belongs to a cluster, fetches all clus

Transform YouTube embed URLs to enable captions by adding cc_load_policy=1. This makes captions show by default when videos are playe

Check if user can make an Archive Assistant query. All users can query, but non-premium users have a lower daily limit and ge

Atomically claim story+channel notifications before sending.