ENH: Create script to set up a development environment using docker

Author: gustavocmaciel

doc/source/development/contributing.rst

@@ -159,7 +159,15 @@ Instead of manually setting up a development environment, you can use `Docker
 commands. pandas provides a ``DockerFile`` in the root directory to build a Docker image
 with a full pandas development environment.
 
-**Docker Commands**
+**Unix/macOS**
+
+There is a script to help you with this::
+
+    ./docker.sh
+
+When prompted, enter your Github username.
+
+**Windows**
 
 Pass your GitHub username in the ``DockerFile`` to use your own fork::
 

docker.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+#
+# Set up a development environment with Docker.
+
+run_container () {
+    # Run a container and bind the local forked repo to it
+    docker run -it --rm -v "$(pwd)":/home/pandas-"$USER" pandas-"$USER"-env
+}
+
+# Check if pandas image already exists
+docker image ls | grep "pandas-$USER-env" &> /dev/null
+
+if [[ $? == 0 ]]; then
+
+    run_container
+
+else
+
+    # Pass the Github username in the Dockerfile
+    read -rp "Github username: " gh_username
+    sed -i "s/gh_username=pandas-dev/gh_username=$gh_username/" Dockerfile
+
+    docker build --tag pandas-"$USER"-env .
+
+    # Revert change made to Dockerfile. This will prevent the Dockerfile
+    # from being commited with the contributor's username in it if
+    # the contributor eventually runs "git commit -am".
+    sed -i "s/$gh_username/pandas-dev/" Dockerfile
+
+    run_container
+fi