Skip to main content

NixML: reproducible environments with nix + YAML

Project description

NIX-ML : Easy, reproducible, environments with Nix + YAML

Simple, perfectly reproducible, environments with nix specified using an YAML file.

Example, write to a file called env.nml:

nixml: v0.0
snapshot: stable-19.03
packages:
  - lang: python
    version: 2
    modules:
      - numpy
      - scipy
      - matplotlib
      - mahotas
      - jupyter
      - scikitlearn

Now, run

nixml shell

and you will be dropped into an environment containing the packages listed above, as was up to date in March 2019. Conceptually, the environment will always be generated from scratch, but caching means that the first time will take significantly longer (including, it will download all dependencies). Afterwards, it should take a few seconds at most.

This environment will be like a typical conda/pip/virtualenv/... environment: if will place the corresponding binaries at the front of the PATH so that they are picked with high priority, but, alternatively, you can generate a pure environment, which will contain only the packages that you specify. This avoids accidental use of packages that are not part of the environment:

nixml shell --pure

Finally, you can run

nixml generate

to just create the nixml.nix corresponding to the enviroment.

Dependencies

NIXML Format

It's a YaML file

nixml: version of nixml to use. Currently, only v0.0 is supported.

snapshot: This is the package version to use. Currently, only stable-19.03 is available, but general syntax is {stable,unstable}-{year}.{month}.

packages: A list of packages, which are grouped into language blocks. Currently supported:

  • python: Python language environment, specify the version (version) and modules.
  • texlive: Texlive packages
  • nix: Generic packages (i.e., vim or bash)

Author

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nixml-0.1.tar.gz (5.2 kB view details)

Uploaded Source

File details

Details for the file nixml-0.1.tar.gz.

File metadata

  • Download URL: nixml-0.1.tar.gz
  • Upload date:
  • Size: 5.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.0 requests-toolbelt/0.9.1 tqdm/4.26.0 CPython/3.6.8

File hashes

Hashes for nixml-0.1.tar.gz
Algorithm Hash digest
SHA256 5a1f9c58fb0808d49ea49e713310a4dadbc6eea138529c9e61ae851738a17242
MD5 31a881d092f8348ffdd88d95012545fb
BLAKE2b-256 db822ef4f1ebbac71ca20c42ffc4b22eae9e480e23bc4b31d3a4d0e63db9db03

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page