deploy: cc93948

.dockerignore

@@ -0,0 +1,15 @@
+*
+!bash_completion_smith
+!docker
+!docs
+!smith-playground
+!LICENSE.txt
+!README.md
+!MANIFEST.in
+!LICENSE.txt
+!README.md
+!setup.py
+!pyproject.toml
+!src
+!.git
+docker/tests/*

.gitattributes

@@ -0,0 +1,4 @@
+# Ensure Dockerfile and shell script uses LF for Windows users. 
+Dockerfile  eol=lf
+*.sh        eol=lf
+bash_completion*   eol=lf

.gitignore

@@ -0,0 +1,22 @@
+.lock*
+.conf*
+.waf*
+build
+*~
+*.pyc
+c4che
+config.log
+dist
+*.egg-info
+.*.sw?
+**/results/*
+*.pdf
+*.epub
+dev/
+*.code-workspace
+.vscode/
+docs/sphinx
+tc
+docker/tests
+src/smithlib/_version.py 
+venv

Docker-steps.md

@@ -0,0 +1,37 @@
+You need to install Docker: https://docs.docker.com/get-docker/.
+
+Windows users should also install [Git4Windows](https://git-scm.com/download/win) and [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install).
+
+The Docker file has the following terminal targets which can be selected with
+the `--target` option: 
+  `build-agent`: 
+     Installs packages and config necessary to run TeamCity build agent.
+  `interactive`: (default) 
+     This will install a `builder` user who has pasword-less sudo, and the
+     `less`, `bash_completion`, `vim` and `nano` packages. Suitable for development
+     testing and as a clean room local build environment.
+
+Thus to build the interactive image (and tag it `smith:latest`) run:
+```
+$> docker build . -t smith:latest
+```
+Or equivalently:
+```
+$> docker build --target=interactive . -t smith:latest
+```
+The container exports a volume at `/smith`:
+
+```
+$> docker run --rm -it -h smith -v $HOME/repos/wstechfonts:/smith smith:latest
+```
+
+This will run the latest version of smith in your local image store and run
+it with the absolute path (or docker volume) `$WORKSPACE` mapped to `/smith`
+inside, and an interactive bash session (the `-it` options).  The `--rm` makes
+the container ephemeral. 
+
+Our TeamCity build agent is built like so:
+```
+$> docker build --target=build-agent-teamcity .
+```
+