repo2docker/tests/dockerfile/editable
Evert Rol 871b0629a4 Remove dockerfile/editable test from main tests
The dockerfile test is used by test_editable, but should not be used
by the generated tests. Removing the verify script will prevent it
being run as part of the generated tests.
2018-10-08 15:36:45 +02:00
..
Dockerfile Remove dockerfile/editable test from main tests 2018-10-08 15:36:45 +02:00
README.rst Add test for editable option 2018-10-08 15:36:45 +02:00
change.sh Add test for editable option 2018-10-08 15:36:45 +02:00

README.rst

Docker - Edit mode
------------------

Using the --editable option with a local repository, one can modify a
file or create a new file in the container, and this change is
reflected in the respective host directory. It is essentially a
shortcut for `--mount
type=bind,source=<local-host-repository>,target=.` (where the target
resolves into the container working directory).

This is tested by running the change.sh script inside the container
(using the 'cmd' argument to the Repo2Docker app), which creates a new
file, and then verifying on the host side the new file is created with
the proper contents.

In practice, this can be used to run a notebook from inside a
container (which provides the proper environment), making changes as
necessary, which are then immediately reflected in the host
repository.