===============
Local workspace
===============

This is guide to setup as "source code install".
It is usefull to use with private patch by yourself.

When you will develop for bug fix or new features,
please setup local repository by this document.

Overview
========

.. todo:: TBD

Development tools
=================

This project uses these tools to management.

* lefthook (to manage git hooks)
* uv >= 0.6.0 (to manage inner of python project)
* go-task (to manage tosks outside of python)

Use mise (reccomended)
----------------------

I use `mise <https://mise.jdx.dev/>`_ to manage tools outside of python.
If you use mise, you can setup by only ``mise install`` and ``task setup-dev``.

Setup workspace
===============

.. note:: After ``git clone``.

#. Set up hooks by ``pre-commit install``.
#. Set up virtualenv and deps by ``uv sync --frozen``.

   * If you want to develop for screenshot options,
     append ``--extra screenshot`` into ``uv sync`` and run ``uv run playwright install chromium``.

#. Get Reveal.js assets by ``uv run tools/fetch_revealjs.py``.
#. Verify workspace by ``uv run pytest``.

   * If it runs on Windows and it does not install **libmagic**,
     append ``--ignore=tests/test_extensions/test_screenshot.py`` into pytest command.

When you are developing for pull-request,
Please keep green for pytest and pre-commit.