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.

# run the dev server
uv run mkdocs serve
# or build the docs
uv run mkdocs build