feat: add Nix support for reproducible builds

Author: willyrgf

README.md

@@ -41,6 +41,33 @@ pip3 install git+https://github.com/Scony/godot-gdscript-toolkit.git
 pipx install git+https://github.com/Scony/godot-gdscript-toolkit.git
 ```
 
+### Using Nix
+
+If you have [Nix](https://nixos.org/) installed, you can run gdtoolkit tools without installing them:
+
+```bash
+# Show available commands and usage help
+nix run github:Scony/godot-gdscript-toolkit
+
+# Run specific tools
+nix run github:Scony/godot-gdscript-toolkit#gdformat -- --help
+nix run github:Scony/godot-gdscript-toolkit#gdlint -- myfile.gd
+nix run github:Scony/godot-gdscript-toolkit#gdparse -- myfile.gd -p
+nix run github:Scony/godot-gdscript-toolkit#gdradon -- cc myfile.gd
+```
+
+Available commands:
+- `gdformat` - Code formatter
+- `gdlint` - Static analysis linter
+- `gdparse` - Parser for debugging/educational purposes
+- `gdradon` - Cyclomatic complexity calculator
+
+Or enter a development shell with all tools available:
+
+```bash
+nix develop github:Scony/godot-gdscript-toolkit
+```
+
 ## Linting with gdlint [(more)](https://github.com/Scony/godot-gdscript-toolkit/wiki/3.-Linter)
 
 To run a linter you need to execute `gdlint` command like:

flake.lock

@@ -0,0 +1,149 @@
+{
+ description =
+ "set of tools for working with GDScript: parser, linter, formatter and code analysis";
+
+ inputs = {
+ nixpkgs.url = "github:NixOS/nixpkgs";
+ flake-utils.url = "github:numtide/flake-utils";
+ };
+
+ outputs = { self, nixpkgs, flake-utils }:
+ flake-utils.lib.eachDefaultSystem (system:
+ let
+ pkgs = import nixpkgs { inherit system; };
+ pythonWithPkgs = pkgs.python3.withPackages
+ (ps: with ps; [ lark docopt-ng pyyaml radon setuptools ]);
+
+ appVersion = "4.3.4";
+
+ helpScript = pkgs.writeShellScript "gdtoolkit-help" ''
+ echo "GDScript Toolkit - Available commands:"
+ echo ""
+ echo "Usage: nix run github:Scony/godot-gdscript-toolkit#<command> -- [args]"
+ echo ""
+ echo "Available commands:"
+ echo " gdparse - GDScript parser for debugging and educational purposes"
+ echo " gdlint - GDScript linter that performs static analysis"
+ echo " gdformat - GDScript formatter that formats code according to predefined rules"
+ echo " gdradon - GDScript code complexity analysis (calculates cyclomatic complexity)"
+ echo ""
+ echo "Examples:"
+ echo " nix run github:Scony/godot-gdscript-toolkit#gdformat -- --help"
+ echo " nix run github:Scony/godot-gdscript-toolkit#gdlint -- myfile.gd"
+ echo " nix run github:Scony/godot-gdscript-toolkit#gdparse -- myfile.gd -p"
+ echo ""
+ echo "For local development:"
+ echo " nix develop # Enter development shell with all tools available"
+ '';
+ in {
+ packages = {
+ gdtoolkit = pkgs.python3.pkgs.buildPythonPackage {
+ pname = "gdtoolkit";
+ version = appVersion;
+ src = self;
+
+ propagatedBuildInputs = with pkgs.python3.pkgs; [
+ lark
+ docopt-ng
+ pyyaml
+ radon
+ setuptools
+ ];
+
+ # Create console scripts
+ postInstall = ''
+ mkdir -p $out/bin
+ echo '#!/usr/bin/env python' > $out/bin/gdparse
+ echo 'import sys; from gdtoolkit.parser.__main__ import main; sys.exit(main())' >> $out/bin/gdparse
+ echo '#!/usr/bin/env python' > $out/bin/gdlint
+ echo 'import sys; from gdtoolkit.linter.__main__ import main; sys.exit(main())' >> $out/bin/gdlint
+ echo '#!/usr/bin/env python' > $out/bin/gdformat
+ echo 'import sys; from gdtoolkit.formatter.__main__ import main; sys.exit(main())' >> $out/bin/gdformat
+ echo '#!/usr/bin/env python' > $out/bin/gdradon
+ echo 'import sys; from gdtoolkit.gdradon.__main__ import main; sys.exit(main())' >> $out/bin/gdradon
+ chmod +x $out/bin/*
+ '';
+ };
+
+ default = self.packages.${system}.gdtoolkit;
+ };
+
+ apps = {
+ help = {
+ type = "app";
+ program = "${helpScript}";
+ meta = with pkgs.lib; {
+ description = "Show available GDScript Toolkit commands";
+ homepage = "https://github.com/Scony/godot-gdscript-toolkit";
+ license = licenses.mit;
+ platforms = platforms.all;
+ };
+ };
+
+ gdparse = {
+ type = "app";
+ program = "${self.packages.${system}.gdtoolkit}/bin/gdparse";
+ meta = with pkgs.lib; {
+ description = "GDScript parser";
+ homepage = "https://github.com/Scony/godot-gdscript-toolkit";
+ license = licenses.mit;
+ platforms = platforms.all;
+ };
+ };
+
+ gdlint = {
+ type = "app";
+ program = "${self.packages.${system}.gdtoolkit}/bin/gdlint";
+ meta = with pkgs.lib; {
+ description = "GDScript linter";
+ homepage = "https://github.com/Scony/godot-gdscript-toolkit";
+ license = licenses.mit;
+ platforms = platforms.all;
+ };
+ };
+
+ gdformat = {
+ type = "app";
+ program = "${self.packages.${system}.gdtoolkit}/bin/gdformat";
+ meta = with pkgs.lib; {
+ description = "GDScript formatter";
+ homepage = "https://github.com/Scony/godot-gdscript-toolkit";
+ license = licenses.mit;
+ platforms = platforms.all;
+ };
+ };
+
+ gdradon = {
+ type = "app";
+ program = "${self.packages.${system}.gdtoolkit}/bin/gdradon";
+ meta = with pkgs.lib; {
+ description = "GDScript code complexity analysis";
+ homepage = "https://github.com/Scony/godot-gdscript-toolkit";
+ license = licenses.mit;
+ platforms = platforms.all;
+ };
+ };
+
+ default = self.apps.${system}.help;
+ };
+
+ devShells = {
+ default = pkgs.mkShell {
+ name = "gdtoolkit-dev-env";
+ packages = [ pythonWithPkgs ];
+
+ shellHook = ''
+ export HISTFILE=$HOME/.history_nix
+ export PYTHONPATH=${builtins.toString ./.}:$PYTHONPATH
+ export PATH=${pythonWithPkgs}/bin:$PATH
+ alias gdparse="python -m gdtoolkit.parser"
+ alias gdlint="python -m gdtoolkit.linter"
+ alias gdformat="python -m gdtoolkit.formatter"
+ alias gdradon="python -m gdtoolkit.gdradon"
+ echo "GDScript Toolkit development environment activated"
+ echo "Available commands: gdparse, gdlint, gdformat, gdradon"
+ '';
+ };
+ };
+ });
+}