prawcore

Prawcore is a Python library that provides the core network layer for the Python Reddit API Wrapper (PRAW). It implements the low-level HTTP communication, OAuth 2.0 authentication, token management, rate limiting, and error handling needed to interact with Reddit's API. By isolating these concerns, prawcore allows higher-level wrappers to focus on user-facing features.

Core components include a session/requestor that sends HTTP requests to Reddit endpoints, manages tokens (including access and refresh tokens for both script and web-based flows), and automatically handles token refresh. It also implements rate limit handling to conform with Reddit's usage policies and maps API errors to a hierarchy of exceptions for precise error handling.

Usage and ecosystem: Prawcore is designed to be used as the underlying client for PRAW but can be used independently by developers who need a lightweight Reddit REST client or who want to build their own wrapper. It supports parsing of JSON responses, error reporting, and configurable settings such as timeouts, retries, and user agents.

History and license: Prawcore is an open-source project maintained as part of the PRAW ecosystem and is released under the MIT license. It is developed by contributors in the open-source community.

See also: PRAW.