klayout/ci-scripts/docker/README.md

Author: Thomas Ferreira de Lima
email: thomas@tlima.me

This folder contains scripts to be run inside docker images. See instructions on how to test this yourself in ci-scripts/docker/development_notes.

## docker_build.sh

We need two environment variables to get going:

```bash
DOCKER_IMAGE="quay.io/pypa/manylinux1_x86_64"
PY_VERSION="cp37-cp37m"
```

The script must be run inside an image pulled from $DOCKER_IMAGE and with klayout's git repo cloned in /io. Inside the git clone folder, run:

```bash
docker run --rm -e DOCKER_IMAGE -e PY_VERSION -v `pwd`:/io $DOCKER_IMAGE $PRE_CMD "/io/ci-scripts/docker/docker_build.sh";
# $PRE_CMD is empty for now (useless currently).
```

This command will generate a wheel and place it in `wheelhouse/klayout-*manylinux1*.whl`. This is the wheel that needs to be uploaded to PyPI via twine. See ci-scripts/twine/README.md.
Adding documentation regarding manylinux, CI, and PyPI wheels 2018-12-20 22:01:15 +01:00			`Author: Thomas Ferreira de Lima`
			`email: thomas@tlima.me`
[ci skip] first working manylinux wheel 2018-12-18 18:11:26 +01:00
Adding documentation regarding manylinux, CI, and PyPI wheels 2018-12-20 22:01:15 +01:00			`This folder contains scripts to be run inside docker images. See instructions on how to test this yourself in ci-scripts/docker/development_notes.`
[ci skip] first working manylinux wheel 2018-12-18 18:11:26 +01:00
Adding documentation regarding manylinux, CI, and PyPI wheels 2018-12-20 22:01:15 +01:00			`## docker_build.sh`
Tested wheel build for all manylinux python versions 2018-12-18 21:18:33 +01:00
Adding documentation regarding manylinux, CI, and PyPI wheels 2018-12-20 22:01:15 +01:00			`We need two environment variables to get going:`
Tested wheel build for all manylinux python versions 2018-12-18 21:18:33 +01:00
			```bash
Adding documentation regarding manylinux, CI, and PyPI wheels 2018-12-20 22:01:15 +01:00			`DOCKER_IMAGE="quay.io/pypa/manylinux1_x86_64"`
			`PY_VERSION="cp37-cp37m"`
Tested wheel build for all manylinux python versions 2018-12-18 21:18:33 +01:00			```
tested script for linux32 as well. Also added +x permission to fix_wheel 2018-12-18 21:58:33 +01:00
Adding documentation regarding manylinux, CI, and PyPI wheels 2018-12-20 22:01:15 +01:00			`The script must be run inside an image pulled from $DOCKER_IMAGE and with klayout's git repo cloned in /io. Inside the git clone folder, run:`
Continuous Integration for manylinux1 wheels (first test) 2018-12-18 23:53:52 +01:00
			```bash
Adding documentation regarding manylinux, CI, and PyPI wheels 2018-12-20 22:01:15 +01:00			docker run --rm -e DOCKER_IMAGE -e PY_VERSION -v `pwd`:/io $DOCKER_IMAGE $PRE_CMD "/io/ci-scripts/docker/docker_build.sh";
			`# $PRE_CMD is empty for now (useless currently).`
Continuous Integration for manylinux1 wheels (first test) 2018-12-18 23:53:52 +01:00			```

Adding documentation regarding manylinux, CI, and PyPI wheels 2018-12-20 22:01:15 +01:00			This command will generate a wheel and place it in `wheelhouse/klayout-manylinux1.whl`. This is the wheel that needs to be uploaded to PyPI via twine. See ci-scripts/twine/README.md.