Wrapper script to help start and stop the sci-oer docker container.
- python 3.7 or later installed
- Docker must be installed and running
The following sections cover the various methods to set up the sci-oer student cli.
pip can be used to install scioer from the Python Package Index (PyPI). It will also install the necessary Python libraries.
# the latest stable version
python3 -m pip3 install sci-oer
# a specific version (e.g. 1.0.0)
python3 -m pip3 install sci-oer==1.0.0If git is installed, pip can also install the latest snapshot of the official scioer source code repository on GitHub.
# the latest snapshot of the official source code repository (requires git)
python3 -m pip3 install git+https://github.com/sci-oer/student-cli#egg=scioerWhen working on the project itself, it is sometimes useful to set up a local development environment, where it is possible to directly run the CLI and the test suite, without building and installing a local package.
For this, start by installing git and any system-level dependencies mentioned in System Requirements. Then, clone the repository and change into the created directory:
git clone https://github.com/sci-oer/student-cli
cd student-cliOptionally, set up a virtual environment.
Finally, if the necessary Python build, test and runtime libraries are not already installed on the environment (virtual or global), manually install them:
pip3 install .At this point, the environment is set up. To run the test suite, execute:
python3 -m pytestTo run the CLI directly, without building and installing a local package, execute:
python3 -m scioer [arguments]And to install scioer into the environment:
pip3 install .Setting up a virtual environment is an optional step. Even so, installing Python packages directly in the global environment is not generally advised.
Instead, it is usual to first set up a virtual environment:
# create virtual enviroment at <path>
python -m venv <path>Once set up, the virtual environment can be activated on the current shell
(more information in the official documentation).
Alternatively, the virtual environment can also be used directly, without
activation, by prefixing all python and pip invocations with the
environment's bin directory.
# Linux/macOS/BSDs (POSIX)
<path>/bin/python [arguments]
<path>/bin/pip [arguments]
# Windows
<path>\Scripts\python [arguments]
<path>\Scripts\pip [arguments]The complete list of commands and options can be found in sci-oer --help and in the man page, but the following topics cover the most common operations.
Brackets [ ], parenthesis ( ), less than/greater than < > and ellipsis ... are used to describe, respectively, optional, required, positional and repeating elements.
Example commands are prefixed with a number sign #, which also serves to indicate that on Linux root permissions (or suitable group membership) may be required.
The --verbose option will print some extra information, like automatically made adjustments to user-provided settings.
And if there is a problem, the --debug flag will make sci-oer output more information to help identify its cause; be sure to include this when opening a new issue.
** TODO **
The base open educational resource Docker image.
The cli tool and Docker image to create customized versions of the base resource images.
Contributions are more than welcome on this project! Check out the list of issues for tasks that you want to try implementing.
Check out the CONTRIBUTING.md guide for more information about how to contribute to the project.
Like any software tool things go wrong and sometimes there are issues. This section presents some common issues that can arise and solutions to resolve the issue. If these topics are not able to help you resolve the issue feel free to open a support request, and we be happy to help.
If Any files that you edited in the /course directory within the container will be saved to your computer in one of the following locations:
~/Desktop/<container name>$XDG_DATA_HOME/scioer/<container name>$HOME/.local/share/scioer/<container name>
Or it will be saved to the location that was specified through the config file or the cli flags that were specified when the container was started.
If your file was not created under the /course directory then make sure that you move it into that folder before the container is stopped and removed, otherwise it will be permanently lost.
Do not work on any of your files in the ~ directory from within the container those files will be lost when the container is recreated.
If you are trying to access the files from your computer that you created or edited from within the container and are now getting permission denied errors. When this happens it is likely because the container is running as a different user. This can be checked by running the following commands:
$ id -u # This will print the user id of the current user
501
$ id -g # This will print the group id of the current user
20
$ ls -nd <path to mount > # The 3rd and 4th columns will be the user id and group id that own the files
drwxr-xr-x 14 501 20 448 3 Apr 13:33 .
^ ^
| |
| group Id
User IdIf these do not match you can sudo chown -R <userId>:<groupId> <volume dir> to change the ownership of the files.
Then you will need to update the configuration of sci-oer to launch the container as the correct user.
Make sure that you save all of your work in the /course directory, so it can be saved to the persistent volume on your computer.
If you did not save it to the correct spot and the container has not yet been removed then you can still enter the container and move the files, so they can be saved.
- Did you double-check that the container is running?
docker ps - Is
3000the correct port?docker psordocker inspect <container name>