python-nix

Nix Flake Template for Python using builtin Nix builders

All of this information is also included in the README.md

Initialize using

nix flake init --template "github:nulladmin1/nix-flake-templates#python-nix"

OR

This is how the structure of the template looks like:

📦 python-nix
├─ 📁 app
│  ├─ 🐍 __init__.py
│  └─ 🐍 main.py
├─ 🔒 flake.lock
├─ ⚙️ flake.nix
├─ ⚙️ pyproject.toml
├─ 📃 README.md
└─ 📁 tests
   └─ 🐍 test_main.py

It includes a basic Python project that returns an SHA256 encoded string of the user's input. It has a testcase that can be run using Pytest or unittest.

The flake is able to run in the specified systems listed in the flake. It contains a devShells as an output with Python,Setuptools and Pip, and an app as an output that builds a Python project using buildPythonPackage.

Run using Nix

nix run

Go into Development Shell

nix develop

(Optional) Format flake.nix using Alejandra

nix fmt

To customize it to your own needs:

• In 'flake.nix'

  • Edit description

    {
        description = "Nix Flake Template for Python with builtin Nix Builders";
    }

  • Change devShell dependencies

    {
        with pkgs.${system}; [
              python311
            ] ++ (with pkgs.${system}.python311Packages; [
            setuptools
            pip
            ]);
    }

  • Change package details accordingly

    default = pkgs.${system}.python311Packages.buildPythonPackage rec {
    pname = "app";
    version = "0.1.0";
    src = ./.;
    format = "pyproject";
    
        nativeBuildInputs = with pkgs.${system}.python311Packages; [
          setuptools
        ];

  • Change executable name for app

    program = "${self.packages.${system}.default}/bin/app";

• In pyproject.toml

  • Change project details accordingly

    [project]
    name = "app"
    version = "0.1.0"
    description = ""
    authors = [
        {name = "Your Name", email = "[email protected]"},
    ]

  • Change Python version accordingly

    requires-python = ">= 3.11"

  • Add necessary and optional build dependencies

    dependencies = [
    ]
    
    [project.optional-dependencies]
    test = [
    "pytest"
    ]

  • Change the name and path of scripts if needed

    [project.scripts]
    app = "app:main"

• For the structure and code

  • Rename the app/ directory to the name of your project. Make sure its the same as the path in the pyproject.toml

    📦 python-nix
    ├─ 📁 app
    │  ├─ 🐍 __init__.py
    │  └─ 🐍 main.py
    

  • Add necessary code for the program in the previous subdirectory.
  • Make sure that for the __init__.py, that it imports from the name of your project, and it imports the necessary functions to be used as a library

    from app.main import main, get_sha256

  • Add necessary test cases and modifications in the tests/ subdirectory. Prepend all added files in that subdirectory with test_
  • Make sure that for the test_main.py, that it imports from the name of your project, and it imports the necessary functions for testing

    from app.main import main, get_sha256