Added files

Author: bovem

examples/Dockerfile

@@ -0,0 +1,9 @@
+FROM python:3.9
+
+RUN apt update -y &&\
+    apt install git openjdk-11-jdk -y &&\
+    git clone https://github.com/bovem/hamilton.git --branch=examples-dockerfile &&\
+    cd hamilton/examples &&\
+    bash make_python_virtualenv.sh
+
+ENTRYPOINT ["/bin/bash"]

examples/README.md

@@ -21,3 +21,34 @@ folders.
 Under `model_examples` you'll find a how you could apply Hamilton to model your ML workflow.
 Check it out to get a sense for how Hamilton could make your ML pipelines reusable/general
 components...
+
+## Running examples through docker image
+Examples could also be executed through the provided docker image.
+Each example directory inside docker image contains a `hamilton-env` Python virtual environment.
+`hamilton-env` environment contains all the dependencies required to run the example.
+
+NOTE: If you already have the container image you can skip to container creation (step 3)
+
+1. Change directory to `examples`
+```bash
+cd hamilton/examples
+```
+
+2. Build the container image.
+```bash
+docker build --tag hamilton-example .
+```
+Docker build takes around `6m16.298s` depending on the system configuration and network.
+Alternatively, you can pull the container image from here: ...
+
+3. Creating a container
+```bash
+docker run -it --rm --name hamilton-example hamilton-example
+```
+
+4. Running the `hello_world` example inside the container
+```bash
+cd hamilton/examples/hello_world
+source hamilton-env/bin/activate
+python my_script.py
+```

examples/async/requirements.txt

@@ -1,3 +1,5 @@
 aiohttp
+async
 fastapi
+sf-hamilton
 uvicorn

examples/make_python_virtualenv.sh

@@ -0,0 +1,33 @@
+# This script is used to create separate python virtual environments for individual examples
+# A python virtual environment named "hamilton-env" is created in every directory containing requirements.txt file
+
+# USAGE (inside hamilton/examples directory): bash make_python_virtualenv.sh
+
+# Get a list of all the folders containing "requirements.txt" file
+export folders=$(find . -name 'requirements.txt' -printf '%h\n');
+
+echo "List of all folders containing requirements.txt";
+echo $folders;
+
+for folder in $folders; do
+    # Change directory
+    pushd $folder;
+
+    # Remove previous hamilton python virtual environment
+    rm -rf ./hamilton-env;
+
+    # Create a new python virtual environment named "hamilton"
+    python3 -m venv hamilton-env;
+
+    # Change to that virtual environment
+    source ./hamilton-env/bin/activate;
+
+    # Install the requirements listed in hamilton virtual environment
+    pip install -r requirements.txt;
+
+    # Deactivate the virtual environment
+    deactivate;
+
+    # Return to the examples folder
+    popd;
+done