dlang-tour 1.0.12
The Dlang Tour
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
The Dlang Online Tour
This is the D language online tour which provides an online introduction to this great system programming language with examples that can be edited, compiled and run online.
The most recent version of this tour can be seen here: http://tour.dlang.org.
Running offline
With D's package manager DUB the tour can be downloaded for offline access:
dub fetch dlang-tour # only once
dub run dlang-tour # to execute the tour
A custom language can be loaded directly using the -l
/ --lang-dir
option
with the path to the directoy of the to be loaded language:
dub run dlang-tour -- --lang-dir .
Add Content
This repository contains the application that runs the tour. Please refer to english content or another language.
Further information on how to add or change existing content can also be found in the CONTRIBUTING.md.
Compile & Run
Make sure dub is installed and simply run this in
the dlang-tour
folder:
dub
You might want to change the settings in config.yml
to change
the ports the tour is listening to.
Compiling & running of user source code
The source code on the tour can be compiled and then executed online and its output returned to the user. Therefore three different types of execution drivers have been implemented within the dlang-tour:
off
: no online compilation allowed. If the user hits Runs an error message will be returned.stupidlocal
: an unsafe method that just runsrdmd
on the local host system and returns its output. Very unsafe and musn't ever be used in production!docker
: runsrdmd
within a special Docker container (dlang-tour-rdmd) and returns its output. The driver imposes the Docker container memory and execution time limits. Additional configurations options available inconfig.yml
.
The execution driver is set in config.yml
.
Caching of the program output can also be enabled in config.yml
(exec.cache = true
). Caching
will only be enabled for the built-in default examples however.
Docker image
A Docker image is automatically built by Travis CI and pushed to the repository
at https://hub.docker.com/r/dlangtour/core. The Dlang-Tour Docker container
is configured to use Docker itself to compile and run D source code
in the online editor. For that to work the host system's Docker /var/run/docker.sock
Unix domain socket has to be mounted to work inside the container. A
sandbox for compiling will then be started on the host system actually,
and not within the Dlang Tour Docker container itself.
The code for running the D compilers in a Docker sandbox can be found here: dlang-tour-rdmd.
So to run the latest dlang-tour version in a Docker container, run the following command:
docker run -d --rm -p 80:8080 -e GOOGLE_ANALYTICS_ID=123 -v /var/run/docker.sock:/var/run/docker.sock \
--name dlang-tour dlangtour/core
The tour will be available at your host system on port 80. To stop the container again just run:
docker stop dlang-tour
For further Docker foo please refer to the Docker documentation.
Note: The docker version inside the container must be compatible to that on the host system! Generally a newer version might run on the host system than within the container.
The Docker container is also the suggested way of dlang-tour's deployment.
Dlang Tour Bot
There is a friendly bot in place that listens to the events of all language repositories and triggers rebuilds and thus automatic deploments on a new change. More information about it can be found at it's repository.
Environment variables
GOOGLE_ANALYTICS_ID
default: (empty)
To enable Google Analytics please specify the environment variable
GOOGLE_ANALYTICS_ID
and set it to the tracking ID provided
for your Analytics account.
EXEC_DOCKER_MEMORY_LIMIT
default: 256
Memory limit per started rdmd
Docker container which compiles
and runs the user code.
EXEC_DOCKER_MAX_QUEUE_SIZE
default: 10
Maximum number of parallel executions of the rdmd
user code
Docker container.
EXEC_DOCKER_TIME_LIMIT
default: 20
Time limit in seconds the rdmd
Docker container with the user
code is allowed to take until it is killed.
EXEC_DOCKER_MAX_OUTPUT_SIZE
default: 4096
Maximum allowed size in bytes of the generated user program's output.
Deployment
A deployment guide can be found in the deploy folder.
License
Boost License. See LICENSE.txt for more details.
- 1.0.12 released 6 years ago
- stonemaster/dlang-tour
- tour.dlang.org
- Boost
- Copyright © 2016, André Stein
- Authors:
- Dependencies:
- vibe-d, mustache-d, dyaml, dfmt
- Versions:
-
1.3.0 2023-Jul-31 1.2.4 2023-Feb-17 1.2.3 2020-Sep-05 1.2.2 2020-Aug-18 1.2.1 2020-Aug-03 - Download Stats:
-
-
0 downloads today
-
0 downloads this week
-
2 downloads this month
-
408 downloads total
-
- Score:
- 2.2
- Short URL:
- dlang-tour.dub.pm