Skip to content
GitLab
Projects
Groups
Snippets
/
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Sign in
Toggle navigation
Menu
Open sidebar
Dockerized Testing Toolkit
Documentation
Commits
e1c940e6
Verified
Commit
e1c940e6
authored
Mar 20, 2021
by
Lukas Wiest
🚂
Browse files
feat(usage): add basic usage-guide
parent
9ed305b7
Pipeline
#2558
passed with stages
in 1 minute and 41 seconds
Changes
1
Pipelines
1
Hide whitespace changes
Inline
Side-by-side
docs/usage.md
View file @
e1c940e6
# Usage
!!! todo
Write usage guide for lecturers and students
On this page you'll find all information regarding the usage of Dockerized Testing Toolkit for lecturers as-well as students.
## Lecturer
### Requirements
-
testrunner docker-image hosted on DockerHub. Either:
1.
choose from the official supported list
2.
find/create custom image
-
tests code base in internet accessible Git-Repo
-
file-structure of code-base to match choosen runner's specifications
### Create/Edit Assignment in Moodle
In your Moodle course
-
add a new Assignment
-
enable Dockerized Testing Toolkit
-
disable all other submission types
-
upload textfile with your assignment settings (see below on file specification)
To edit an existing assignment, just remove the old and upload a new config file.
## Student
As student you can either zip your submission, or upload a textfile with the link to your git repository.
For the file specifications see below.
## DTT configuration file specification
This section describes how the DTT-config-files work.
They have to contain an URI starting with
`dtt`
as identifier, then followed by the information as shown below.
### Lecturer (assignment)
Information needed in the config-file:
-
url to git repo
-
user and password, if needed for access
-
docker image to use
```
dtt::<git-repo-url>::<none|<user name>>::<none|<user name>>::<docker image[:tag]>
```
Example:
```
# test code
dtt::https://transfer.hft-stuttgart.de/gitlab/dtt/example_openjdk11-junit5-calculator-test.git::none::none::hftstuttgart/dtt-openjdk11-junit5-testrunner:feat-dtt-transition
```
### Student (submission)
Information needed in the config-file:
-
url to git repo
-
user and password, if needed for access
```
dtt::<git-repo-url>::<none|<user name>>::<none|<user name>>
```
!!! tip
Additionally any number of
[
Unified-Ticketing
][
1
]
URIs can be in the config file for ticket response.
Example:
```
# source code
dtt::https://transfer.hft-stuttgart.de/gitlab/dtt/example_openjdk11-junit5-calculator-submission.git::none::none
# disabled, just as example
# ticket response
# unifiedticketing:gitlab:https://transfer.hft-stuttgart.de/gitlab:0815:ABASAEUIBFI44BKW34U7I24
```
<!-- Unified-Ticketing -->
[
1
]:
https://transfer.hft-stuttgart.de/pages/9lukas5/unified-ticketing/api/core/ticket-system.html#by-uri
Write
Preview
Supports
Markdown
0%
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment