❄ devenvのscriptsで任意の言語スクリプトを実行する方法

devenvのscripts機能で特定の言語で書いたスクリプトを実行したい場合の手順が分かりづらかったので、忘備録的なメモ

背景

• devenv (+ direnv連携)でプロジェクトの実行環境などを管理している
• devenv scriptsの実行ファイルとして、特定の言語ランタイムで実行するファイルを指定したい
  • 例: uv (Python)
• かつ、スクリプト内部でコマンドライン引数の解析なども実施したい

方法

TL;DR -> devenv.nix で以下を指定すると awesome-script という名前で実行できる

• scripts.*.package: 実行に必要なNixパッケージ
  • 複数あれば scripts.*.packages に配列で記載する
• scripts.*.exec: 実行したいスクリプトへの パス (文字列ではなく、相対パスをそのまま)
• scripts.*.binary: uv run などスクリプトを渡すコマンド名(文字列)

devenv.nix

{ pkgs, lib, config, inputs, ... }: {
  # ... env/languagesなど

  scripts.awesome-script = {
    exec = ./scripts/awesome-script/main.py;
    binary = "uv run";
    package = pkgs.uv;
  };
}

例: scripts/awesome-script/main.py

#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.13"
# dependencies = [
#     "typer",
# ]
# ///
import sys

import typer

app = typer.Typer()


@app.command()
def main():
    print(f"Hello: {sys.argv=}")


if __name__ == "__main__":
    app()