Python: Difference between revisions

From NixOS Wiki
imported>Asymmetric
m Remove typo
imported>Asymmetric
m Remove extra quotes
Line 3: Line 3:
=== Libraries ===
=== Libraries ===


According to the [https://nixos.org/nixpkgs/manual/#contributing-guidelines official guidelines] for python new package expressions for 'libraries' should be placed in <syntaxhighlight lang="bash" inline>pkgs/development/python-modules/<name>/default.nix</syntaxhighlight>. Those expressions are then referenced from <code>pkgs/top-level/python-packages.nix</code> like in this example:
According to the [https://nixos.org/nixpkgs/manual/#contributing-guidelines official guidelines] for python new package expressions for libraries should be placed in <syntaxhighlight lang="bash" inline>pkgs/development/python-modules/<name>/default.nix</syntaxhighlight>. Those expressions are then referenced from <code>pkgs/top-level/python-packages.nix</code> like in this example:


<syntaxhighlight lang="nix">
<syntaxhighlight lang="nix">
Line 15: Line 15:
=== Applications ===
=== Applications ===


Python 'applications instead should be referenced directly from <code>pkgs/top-level/all-packages.nix</code>.
Python applications instead should be referenced directly from <code>pkgs/top-level/all-packages.nix</code>.


The expression should take `pythonPackages` as one of the arguments, which guarantees that packages belong to the same set.
The expression should take `pythonPackages` as one of the arguments, which guarantees that packages belong to the same set.

Revision as of 15:34, 26 February 2018

Contribution guidelines

Libraries

According to the official guidelines for python new package expressions for libraries should be placed in pkgs/development/python-modules/<name>/default.nix. Those expressions are then referenced from pkgs/top-level/python-packages.nix like in this example:

{
  aenum = callPackage ../development/python-modules/aenum { };
}

The reasoning behind this is the large size of pkgs/top-level/python-packages.nix. Unfortunately most libraries are still defined in-place in pkgs/top-level/python-packages.nix. If a change to library is necessary or an update is made, it is recommend to move the modified package out of pkgs/top-level/python-packages.nix.

Applications

Python applications instead should be referenced directly from pkgs/top-level/all-packages.nix.

The expression should take `pythonPackages` as one of the arguments, which guarantees that packages belong to the same set.

External Documentation