prawcore

prawcore is a low-level communication layer used by PRAW 4+.

Installation

Install prawcore with uv via:

uv add prawcore

Alternatively, install using pip via:

pip install prawcore

Execution Example

The following example demonstrates how to use prawcore to obtain the list of trophies for a given user using the script-app type. This example assumes you have the environment variables PRAWCORE_CLIENT_ID and PRAWCORE_CLIENT_SECRET set to the appropriate values for your application.

#!/usr/bin/env python
import os
import pprint
import prawcore

authenticator = prawcore.TrustedAuthenticator(
    client_id=os.environ["PRAWCORE_CLIENT_ID"],
    client_secret=os.environ["PRAWCORE_CLIENT_SECRET"],
    requestor=prawcore.Requestor(user_agent="YOUR_VALID_USER_AGENT"),
)
authorizer = prawcore.ReadOnlyAuthorizer(authenticator=authenticator)
authorizer.refresh()

with prawcore.session(authorizer=authorizer) as session:
    pprint.pprint(session.request(method="GET", path="/api/v1/user/bboe/trophies"))

Save the above as trophies.py and then execute via:

python trophies.py

Additional examples can be found at: https://github.com/praw-dev/prawcore/tree/main/examples

Documentation

prawcore’s documentation is located at https://prawcore.readthedocs.io/.

Depending on prawcore

prawcore follows semantic versioning with the exception that deprecations will not be preceded by a minor release. In essence, expect only major versions to introduce breaking changes to prawcore’s public interface. As a result, if you depend on prawcore then it is a good idea to specify not only the minimum version of prawcore your package requires, but to also limit the major version.

Below are two examples of how you may want to specify your prawcore dependency:

setup.py

setup(..., install_requires=["prawcore >=0.1, <1"], ...)

requirements.txt

prawcore >=1.5.1, <2

Metadata

Release files for prawcore 4.0.0

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

Source distribution (sdist)

Source distribution for prawcore 4.0.0
File	Size	Uploaded
prawcore-4.0.0.tar.gz	1.2 MB	Jun 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for prawcore 4.0.0
File	Interpreter	ABI	Platform	Reset
prawcore-4.0.0-py3-none-any.whl 19.3 kB Jun 13, 2026	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / prawcore-4.0.0.tar.gz

Download URL	prawcore-4.0.0.tar.gz
Size	1.2 MB
Tags	Source
SHA-256 checksum How to use checksums	`c7e4d6e1b71e2b9c88680aee467e3e07d22df4c91bb01488ce2a3ab43d76b076`
BLAKE2b-256 checksum How to use checksums	`0806d6eaaaa5ec11ebc56b176e16233c4dbd7ae5a51a9d82649cad8aa2ba3b43`
Upload date	Jun 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/praw-dev/prawcore
Publishing commit: github.com/praw-dev/prawcore/tree/e36511ad47883fd0af4205fa67ec995a32a6ca8c

Workflow

Publishing configuration: github.com/praw-dev/prawcore/blob/e36511ad47883fd0af4205fa67ec995a32a6ca8c/.github/workflows/pypi.yml
Publishing logs: github.com/praw-dev/prawcore/actions/runs/27453259759/attempts/1

Artifact

Subject: prawcore-4.0.0.tar.gz
SHA-256 checksum: c7e4d6e1b71e2b9c88680aee467e3e07d22df4c91bb01488ce2a3ab43d76b076 Verifying attestations

Release files / prawcore-4.0.0-py3-none-any.whl

Download URL	prawcore-4.0.0-py3-none-any.whl
Size	19.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`53f91bcd4cb25a26ca58f3ba7c5bf83d9d93a74025aae2c926bc6b0d5fd11df7`
BLAKE2b-256 checksum How to use checksums	`5b97e52a0a62a14b17ce382d68d00a838887deab52eddac8d9e87f4e6274efcd`
Upload date	Jun 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/praw-dev/prawcore
Publishing commit: github.com/praw-dev/prawcore/tree/e36511ad47883fd0af4205fa67ec995a32a6ca8c

Workflow

Publishing configuration: github.com/praw-dev/prawcore/blob/e36511ad47883fd0af4205fa67ec995a32a6ca8c/.github/workflows/pypi.yml
Publishing logs: github.com/praw-dev/prawcore/actions/runs/27453259759/attempts/1

Artifact

Subject: prawcore-4.0.0-py3-none-any.whl
SHA-256 checksum: 53f91bcd4cb25a26ca58f3ba7c5bf83d9d93a74025aae2c926bc6b0d5fd11df7 Verifying attestations