Python - Revision history

Turnipjs: update line numbers referring to snippet

2026-02-12T21:09:28Z

update line numbers referring to snippet

← Older revision		Revision as of 21:09, 12 February 2026
Line 27:		Line 27:
	In this example, we create a Python environment with packages <code>pandas</code> and <code>requests</code>.		In this example, we create a Python environment with packages <code>pandas</code> and <code>requests</code>.

	You can find Python packages that are available in Nixpkgs using [https://search.nixos.org/packages search.nixos.org]. For instance, type a Python package name like <code>numpy</code> in the search bar and click on the search button on the right. You can narrow down results by clicking on eg. "python311Packages" in the "Package sets" section on the left. Note that in the snippet above, on lines ~~8 and 9~~, each package is listed in the form <code>python-pkgs.<name></code> where <code><name></code> corresponds to the one found in [https://search.nixos.org/packages search.nixos.org] . See [https://nix.dev/tutorials/nix-language.html Nix language basics] for more information on the <code>python-pkgs</code> attribute set.		You can find Python packages that are available in Nixpkgs using [https://search.nixos.org/packages search.nixos.org]. For instance, type a Python package name like <code>numpy</code> in the search bar and click on the search button on the right. You can narrow down results by clicking on eg. "python311Packages" in the "Package sets" section on the left. Note that in the snippet above, on lines 10-11, each package is listed in the form <code>python-pkgs.<name></code> where <code><name></code> corresponds to the one found in [https://search.nixos.org/packages search.nixos.org] . See [https://nix.dev/tutorials/nix-language.html Nix language basics] for more information on the <code>python-pkgs</code> attribute set.

	Once you have picked the Python packages you want, run <code>nix-shell</code> (or <code>nix develop -f shell.nix</code>) to build the Python environment and enter it. Once in the environment Python will be available in your PATH, so you can run eg. <code>python --version</code>.		Once you have picked the Python packages you want, run <code>nix-shell</code> (or <code>nix develop -f shell.nix</code>) to build the Python environment and enter it. Once in the environment Python will be available in your PATH, so you can run eg. <code>python --version</code>.

IllustratedMan-code: Adds a section about using rPackages with rpy2 in python

2025-11-13T16:16:18Z

Adds a section about using rPackages with rpy2 in python

@@ Line 39: / Line 39: @@
    ]))
 ];
 </syntaxhighlight>

Aktaboot: fix broken link to pyproject docs

2025-10-18T15:44:23Z

fix broken link to pyproject docs

← Older revision		Revision as of 15:44, 18 October 2025
Line 546:		Line 546:
	[project.scripts]		[project.scripts]
	cli = "app.main:main"		cli = "app.main:main"
	</syntaxhighlight>We package the application by calling the <code>loadPyproject</code> function from <code>pyproject.nix</code>. Again, we only show a minimal example. More information can be found in the [https://nix~~-community~~.github.io/pyproject.nix/use-cases/pyproject.html documentation]. Note that this example relies on flakes in contrast to some of the others on this page.<syntaxhighlight lang="nix">		</syntaxhighlight>We package the application by calling the <code>loadPyproject</code> function from <code>pyproject.nix</code>. Again, we only show a minimal example. More information can be found in the [https://pyproject-nix.github.io/pyproject.nix/use-cases/pyproject.html documentation]. Note that this example relies on flakes in contrast to some of the others on this page.<syntaxhighlight lang="nix">
	{		{
	description = "A basic flake using pyproject.toml project metadata";		description = "A basic flake using pyproject.toml project metadata";

Lukeb: fixed broken link for pyproject use-cases

2025-08-12T18:59:19Z

fixed broken link for pyproject use-cases

← Older revision		Revision as of 18:59, 12 August 2025
Line 531:		Line 531:
	if __name__ == '__main__':		if __name__ == '__main__':
	app.run(host="0.0.0.0", port=8080)		app.run(host="0.0.0.0", port=8080)
	</syntaxhighlight>Also, you need to define the <code>pyproject.toml</code>. Here, we only show some of the important parts. Please refer to <code>pyproject.nix</code> [https://nix~~-community~~.github.io/pyproject.nix/use-cases/pyproject.html documentation] for a full example.<syntaxhighlight lang="toml">		</syntaxhighlight>Also, you need to define the <code>pyproject.toml</code>. Here, we only show some of the important parts. Please refer to <code>pyproject.nix</code> [https://pyproject-nix.github.io/pyproject.nix/use-cases/pyproject.html documentation] for a full example.<syntaxhighlight lang="toml">
	[project]		[project]
	name = "my-app"		name = "my-app"

LovesTha: /* Using buildFHSEnv */ as second recommended option

2025-07-18T01:42:51Z

Using buildFHSEnv: as second recommended option

← Older revision		Revision as of 01:42, 18 July 2025
Line 205:		Line 205:
	</syntaxhighlight>		</syntaxhighlight>

	==== Using <code>buildFHSEnv</code> ====		==== Using <code>buildFHSEnv</code> (Recommended) ====
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	#!/usr/bin/env nix-shell		#!/usr/bin/env nix-shell

34j: Add Installing Multiple Versions

2025-06-27T05:01:05Z

Add Installing Multiple Versions

← Older revision		Revision as of 05:01, 27 June 2025
Line 653:		Line 653:

	<code>pythonDebug = pkgs.python310.override { enableDebug = true; };</code>		<code>pythonDebug = pkgs.python310.override { enableDebug = true; };</code>

			== Installing Multiple Versions ==

			{{Nixpkgs Manual\|name={{ic\|lib.meta.lowPrio}} and {{ic\|lib.meta.highPrio}}\|anchor=#function-library-lib.meta.lowPrio}} can be used to install multiple versions without conflicts ({{issue\|369997}}):

			{{file\|/etc/nixos/configuration.nix\|nix\|3=
			environment.systemPackages = with pkgs; [
			python313
			lib.meta.lowPrio python314
			];
			}}

			In this case you may run Python 3.13 via {{ic\|python}} or {{ic\|python3.13}} and Python 3.14 via {{ic\|python3.14}}.

			{{Note\|If you wrapped Python as described in [[#Running_Python_packages_which_requires_compilation_and/or_contains_libraries_precompiled_without_nix]], call {{ic\|lib.meta.lowPrio}} and {{ic\|lib.meta.highPrio}} for the wrapped Python instead of calling them inside the wrapping.}}

	== Performance ==		== Performance ==

Bittner: Add more details on uv installation as usage

2025-06-21T05:30:32Z

Add more details on uv installation as usage

← Older revision		Revision as of 05:30, 21 June 2025
Line 307:		Line 307:

	=== Using uv ===		=== Using uv ===
	<blockquote>A single tool to replace <code>pip</code>, <code>pip-tools</code>, <code>pipx</code>, <code>poetry</code>, <code>pyenv</code>, <code>virtualenv</code>, and more.</blockquote>~~uv is very simple to use. Simply <code>uv init</code> to get started. No need for shells, as it creates virtual environments.~~		<blockquote>A single tool to replace <code>pip</code>, <code>pip-tools</code>, <code>pipx</code>, <code>poetry</code>, <code>pyenv</code>, <code>virtualenv</code>, and more.</blockquote>

	As a ~~systemPackage~~<syntaxhighlight lang="nix">		uv is written in Rust and does ''not'' need Python as a prerequisite. Use the <code>uv</code> command to initialize Python projects, add Python packages, create or update virtual environments (in <code>.venv</code> folders), etc. as [https://docs.astral.sh/uv/concepts/projects/ described in the uv docs]. Use uv's [https://docs.astral.sh/uv/guides/tools/ tool interface] to install and run Python packages that provide a CLI.

			As a system package

			<syntaxhighlight lang="nix">
	environment.systemPackages = with pkgs; [		environment.systemPackages = with pkgs; [
	uv		uv
	];		];
	</syntaxhighlight>or as a home-manager package<syntaxhighlight lang="nix">		</syntaxhighlight>

			or as a home-manager package

			<syntaxhighlight lang="nix">
	home.packages = with pkgs; [		home.packages = with pkgs; [
	uv		uv
	];		];
	</syntaxhighlight>		</syntaxhighlight>

			If you use uv it's recommended that you install the Python versions you need using the <code>uv python install</code> command, e.g.

			<syntaxhighlight lang="python">
			uv python install 3.14 --preview --default
			</syntaxhighlight>

			You may want to set the <code>UV_PYTHON_DOWNLOADS=never</code> environment variable in your shell to stop uv from downloading Python binaries automatically if needed. Setting <code>environment.localBinInPath = true;</code> is highly recommended, because uv will install binaries in <code>~/.local/bin</code>.

	=== Using poetry ===		=== Using poetry ===

Guilledk: Monospace styling changes on new debug build section

2025-05-23T01:26:39Z

Monospace styling changes on new debug build section

← Older revision		Revision as of 01:26, 23 May 2025
Line 634:		Line 634:
	See [https://docs.python.org/3/using/configure.html#python-debug-build python wiki on debug build].		See [https://docs.python.org/3/using/configure.html#python-debug-build python wiki on debug build].

	In order to use a CPython interpreter built using `--with-pydebug` during configure phase, override any of the python packages passing `enableDebug = true` argument:		In order to use a CPython interpreter built using <code>--with-pydebug</code> during configure phase, override any of the python packages passing <code>enableDebug = true</code> argument:

	<code>pythonDebug = pkgs.python310.override { enableDebug = true; };</code>		<code>pythonDebug = pkgs.python310.override { enableDebug = true; };</code>

Guilledk: shows instructions on how to obtain a CPython interpreter that uses debug build, related to this new PR: https://github.com/NixOS/nixpkgs/pull/409943

2025-05-23T01:25:00Z

shows instructions on how to obtain a CPython interpreter that uses debug build, related to this new PR: https://github.com/NixOS/nixpkgs/pull/409943

← Older revision		Revision as of 01:25, 23 May 2025
Line 630:		Line 630:

	You can also set <code>backend : GTK3Agg</code> in your <code>~/.config/matplotlib/matplotlibrc</code> file to avoid having to call <code>matplotlib.use('gtk3agg')</code>.		You can also set <code>backend : GTK3Agg</code> in your <code>~/.config/matplotlib/matplotlibrc</code> file to avoid having to call <code>matplotlib.use('gtk3agg')</code>.

			== Debug Build ==
			See [https://docs.python.org/3/using/configure.html#python-debug-build python wiki on debug build].

			In order to use a CPython interpreter built using `--with-pydebug` during configure phase, override any of the python packages passing `enableDebug = true` argument:

			<code>pythonDebug = pkgs.python310.override { enableDebug = true; };</code>

	== Performance ==		== Performance ==

Drupol: Add an example of using the new command line to spawn a shell with python and custom modules.

2025-03-26T13:31:59Z

Add an example of using the new command line to spawn a shell with python and custom modules.

← Older revision		Revision as of 13:31, 26 March 2025
Line 40:		Line 40:
	];		];
	</syntaxhighlight>		</syntaxhighlight>

			=== Using Nix shell (new command line) ===
			nix shell --impure --expr '(import <nixpkgs> {}).python3.withPackages (ps: with ps; [ swh-core swh-scanner ])'
			If you don't use the channels any more, you can replace <code><nixpkgs></code> by an instance of the <code>NixOS/nixpkgs</code> repository using its absolute path.

	==== Using a Python package not in Nixpkgs ====		==== Using a Python package not in Nixpkgs ====