https://github.com/nix-community/pip2nix

Freeze pip-installable packages into Nix expressions [maintainer=@datakurre]
https://github.com/nix-community/pip2nix

Last synced: 3 months ago
JSON representation

Freeze pip-installable packages into Nix expressions [maintainer=@datakurre]

• Host: GitHub
• URL: https://github.com/nix-community/pip2nix
• Owner: nix-community
• Created: 2015-06-15T21:49:37.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2023-11-05T21:36:19.000Z (12 months ago)
• Last Synced: 2024-07-22T17:59:07.322Z (3 months ago)
• Language: Python
• Homepage:
• Size: 307 KB
• Stars: 165
• Watchers: 6
• Forks: 26
• Open Issues: 31
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst

Awesome Lists containing this project

README

        
pip2nix

=======

Generate nix expressions for Python packages.

.. image:: https://travis-ci.com/nix-community/pip2nix.svg?branch=master

   :target: https://travis-ci.com/nix-community/pip2nix

   :alt: Build Status

.. image:: https://readthedocs.org/projects/pip2nix/badge/?version=latest

   :target: http://pip2nix.readthedocs.org/en/latest/

   :alt: Documentation Status

.. image:: https://img.shields.io/pypi/status/pip2nix.svg

   :target: https://pypi.python.org/pypi/pip2nix

   :alt: PyPI status

.. image:: https://img.shields.io/pypi/v/pip2nix.svg

   :target: https://pypi.python.org/pypi/pip2nix

   :alt: PyPI version

Why another .nix generator for Python?

======================================

The original author of `pip2nix` started the project with the following motivation:

  I needed something that can work not only with pypi but also with local paths,

  VCS links, and dependency links. I couldn't get any of the other generators to

  work, so I started my own :-)

Major difference between `pip2nix` and `pypi2nix` is that `pip2nix` can be used to extend `nixpkgs` Python package set and reuse its package functions where `pypi2nix` maintains separate package tree from `nixpkgs`. Both approaches have their own pros and cons.

Installation

============

Be aware that `pip2nix` is not yet mature software. It is a tool to aid Python

developers who use Nix to automate a good chunk of the work to maintain a Nix

based development environments.

The recommended usage at the moment is inside of a `nix-shell`, since this

avoids putting a specific version into the user's environment::

  $ git clone https://github.com/nix-community/pip2nix

  $ cd pip2nix

  $ nix-shell release.nix -A pip2nix.python36

Alternatively `pip2nix` can be installed into the user's environment::

  $ git clone https://github.com/nix-community/pip2nix

  $ nix-env -f pip2nix/release.nix -iA pip2nix.python36

Usage

=====

To generate python-packages.nix for a set of requirements::

    $ pip2nix generate -r requirements.txt

``pip2nix generate`` takes the same set of package specifications ``pip

install`` does.

Contact

=======

Problems and questions should go to GitHub `issues

`_.

Credits and History

===================

Tomasz Kontusz started the project back in 2015, he's `ktosiek` on Freenode, and

`@tkontusz `_ on Twitter.

In 2016 Johannes Bornhold took over as maintainer, since he was actively using

`pip2nix` and Tomas was not actively using it himself anymore. Find him via

https://www.johbo.com.

In 2019 Asko Soukka forked the project below https://github.com/nix-community/

and took over as maintainer.