repo2docker/tests/conda/README.md

Overview of tests for the conda buildpack

Tested configuration files

• .binder/
• requirements.txt
• `postBuild

Tested repo2docker command line flags

• --target-repo-dir

py2

• Test setup of a Python 2 environment by declaring python=2 in environment.yml.

py35-binder-dir

• Test setup of a Python 3.5 environment by declaring python=3.5 in environment.yml.

  The reasons for testing 3.5 specifically is that it is the oldest version of Python 3 supported by repo2docker's conda buildpack. See repo2docker/buildpacks/conda for details.

• Test use of a .binder directory.

py310-requirements-file

• Test setup of a Python 3.10 environment by declaring python=3.10 in environment.yml.

  The reasons for testing 3.10 specifically is that it is the newest version of Python 3 supported by repo2docker's conda buildpack. See repo2docker/buildpacks/conda for details.

• Test use of a requirements.txt file, where an environment.yml file should take precedence and the requirements.txt should be ignored.

py-r-postbuild-file

• Test setup of the default Python environment by omitting python from environment.yml file.

• Test setup of the default R environment by specifying r-base in environment.yml.

• Test use of a postBuild file.

r3.6-target-repo-dir-flag

• Test setup of a R 3.6 environment by specifying r-base=3.6 in environment.yml.

• Test use of repo2docker with the --target-repo-dir flag.

  --target-repo-dir is meant to support custom paths where repositories can be copied to besides ${HOME}.

  This test makes use of the test-extra-args.yaml file to influence additional arguments passed to repo2docker during the test. In this test, specify --target-repo-dir=/srv/repo.