Development

This doc explains how to set up dev env if you want to get involved with this project.

Requirements

• Python 3.10+

Setup

This project uses uv as a project manager and Lefthook as a Git hooks manager.

git clone https://github.com/urlscan/urlscan-python
cd urlscan-python

# install uv
pip install -r requirements.txt
# sync uv
uv sync
# install Lefthook
uv run lefthook install

Test

This project uses pytest as a testing framework.

uv run pytest

Docs

This project uses MkDocs as a documentation tool and uses Mike for versioning.

# run the dev server
uv run mike serve
# or build the docs
uv run mke build