Add uv-run hook

[danielhollas]

We have a small python script with a handful of external dependencies which we want to run as a local pre-commit hook. To ensure that the dependencies are installed, it would be great to use PEP-723 inline script metadata and use uv run --script to execute the script.

Would it be possible to add a uv-run hook that would allow for this?
This would be helpful since we don't want our developer to have to install uv (as much as I love it of course :D), so ideally this would "just work" behind the scenes.

I am happy to submit a PR if that would be helpful.

Thanks!

(if there are other ways to do the thing outlined above I am all ears)

[danielhollas]

Related to #14

[danielhollas]

@zanieb would you be open to this idea?

[zanieb]

What would this look like in practice? (I'm not a pre-commit expert)

[danielhollas]

So basically I'd like to change the current local hook (which requires global uv installation) that looks like this in .pre-commit-config.yaml

  - repo: local
    hooks:
    - id: local-python-script
      name: Standalone script with PEP-723 deps    
      entry: uv run ./utils/standalone_script.py --some-option  
      language: system
      pass_filenames: false

to

  - repo: https://github.com/astral-sh/uv-pre-commit
    rev: 0.5.22
    hooks:                                                                                                                         
    - id: uv-run
      name: Standalone script with PEP-723 deps
      args: ['utils/standalone_script.py', '--some-option']

Because of the way uv run works, this would also cover a use case of running a command/script within the virtual environment of the project. The typical use case for this would be running mypy, as described in #14 (comment)

I am also not a pre-commit expert so it's possible there are some issues that I am not seeing, but it looks doable.

[zanieb]

That seems reasonable to me.

[Jamie-BitFlight]

Hey! I ran into the same problem - wanting to run mypy/basedpyright on scripts with PEP 723 inline dependencies in pre-commit.

I built a small wrapper tool called pep723-loader that solves this. It:

1. Scans Python files for PEP 723 metadata
2. Extracts dependencies via uv export --script
3. Installs them into the current environment
4. Runs the wrapped command (mypy, basedpyright, etc.)
5. Propagates exit codes

Here's how I'm using it in .pre-commit-config.yaml:

- repo: local
  hooks:
    - id: mypy
      name: mypy
      entry: uv run -q --no-sync --with pep723-loader --with mypy pep723-loader mypy
      language: system
      types: [python]
      pass_filenames: true
    - id: basedpyright
      name: basedpyright
      entry: uv run -q --no-sync --with pep723-loader --with basedpyright pep723-loader basedpyright
      language: system
      types: [python]
      pass_filenames: true

This way:

• No global uv installation required (uv bootstraps itself)
• PEP 723 dependencies are auto-installed before the linter runs
• Works with any linter (mypy, pyright, basedpyright, bandit, etc.)

The tool is on PyPI: pip install pep723-loader
Repo: https://github.com/bitflight-devops/pre-commit-pep723-linter-wrapper

Happy to help if anyone runs into issues with their setup!