Alpha 1

.coveragerc

@@ -0,0 +1,8 @@
+[run]
+branch = True
+source =
+    render
+omit =
+
+[report]
+fail_under=50

.gitignore

@@ -99,3 +99,12 @@ ENV/
 
 # mypy
 .mypy_cache/
+
+# sass cache and maps
+.sass-cache
+*.css.map
+
+# Authentication files
+bucket.json
+compute.json
+client.json

.travis.yml

@@ -0,0 +1,27 @@
+sudo: required
+services:
+  - docker
+env:
+  - DOCKER_COMPOSE_VERSION=1.11.2
+language: python
+python:
+  - '3.6'
+before_install:
+  # See https://github.com/travis-ci/travis-ci/issues/7940
+  - sudo rm -f /etc/boto.cfg
+install:
+  - sudo docker --version
+  - sudo docker-compose --version
+  - pip install -r requirements.txt
+jobs:
+  include:
+    - stage: test
+      script: ./render ci test_with_coverage
+    - script: ./render ci style
+    - script: ./render ci docs
+notifications:
+  email: false
+  slack:
+    rooms: deptfunstuff:abJKvzApk5SKtcEyAgtswXAv
+    on_success: change
+    on_failure: change

README.md

@@ -1,2 +1,19 @@
-# render
-Render Service for generating PDFs for CSUnplugged and CS Field Guide
+# Render Service
+
+[![Build Status](https://travis-ci.org/uccser/render.svg?branch=master)](https://travis-ci.org/uccser/render)[![Documentation Status](https://readthedocs.org/projects/uccser-render/badge/?version=latest)](http://uccser-render.readthedocs.io/en/latest/?badge=latest)
+
+Render Service for generating PDFs for CS Unplugged and CS Field Guide.
+
+## Documentation
+
+Documentation for this project can be found on
+[ReadTheDocs](http://uccser-render.readthedocs.io/en/latest/),
+and can also
+be built from the documentation source within the `docs/` directory.
+
+## Contributing
+
+We would love your help to make this guide the best it can be!
+Please read our
+[contribution guide](http://uccser-render.readthedocs.io/en/latest/getting_started/contributing_guide.html)
+to get started.

build-gcloud-image.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+set -e
+
+function get_render_version(){
+render_version=`python3 -c 'from renderservice.render import __version__;print(__version__)'`
+}
+
+host="gcr.io"
+project_id="render-181102"
+username="uccser"
+get_render_version
+
+docker build renderservice -t "${host}/${project_id}/${username}/render:${render_version}"
+gcloud docker -- push "${host}/${project_id}/${username}/render:${render_version}"

dev/queue_client.py

@@ -0,0 +1,172 @@
+"""Allows access to queue in order to create tasks and get results.
+
+You will need to install from the renderservice
+  pip install -r requirements.txt
+"""
+
+import base64
+import importlib.machinery
+import sys
+import optparse
+import os
+
+
+# Local Queue Code
+def get_queue_host():
+    """Get the IP Address of the queue host.
+
+    Using the command:
+        docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' render_queue_1
+
+    Returns:
+        A string of the IP address
+    """
+    import subprocess
+    command = [
+        'docker',
+        'inspect',
+        '-f',
+        '\'{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}\'',
+        'render_queue_1'
+    ]
+    result = subprocess.run(command, stdout=subprocess.PIPE)
+    return result.stdout.decode().strip('\n\'')
+
+
+PROJECT_NAME = "cs-unplugged-develop"
+QUEUE_NAME = "render-queue"
+
+QUEUE_HOST = get_queue_host()
+DISCOVERY_URL = "http://{}:5052/api/{{api}}/{{apiVersion}}".format(QUEUE_HOST)
+CREDENTIALS = None
+
+
+# Online Queue Code
+def get_credentials():
+    """Get credentials to log into online taskqueue."""
+    from oauth2client.service_account import ServiceAccountCredentials
+    client_secret_file = 'client.json'
+    scopes = ['https://www.googleapis.com/auth/cloud-platform']
+    credentials = ServiceAccountCredentials.from_json_keyfile_name(client_secret_file, scopes)
+    return credentials
+
+
+PROJECT_NAME = "render-181102"
+LOCATION = "us-central1"
+QUEUE_NAME = "render"
+DISCOVERY_URL = "https://cloudtasks.googleapis.com/$discovery/rest?version=v2beta2"
+CREDENTIALS = get_credentials()
+
+
+def parse_args():
+    """Command-line option parser for program control."""
+    opts = optparse.OptionParser(
+        usage="{0} [options] [command]".format(sys.argv[0]),
+        description="Access and manipulate queue, where the"
+        "commands can be add, list, lease, document, flush.")
+    # Configure options
+    # opts.add_option("--key-file", "-k", action="store",
+    #     type="string", help="Location of the credentials file.",
+    #     default=None)
+    options, arguments = opts.parse_args()
+    # Extra option parsing
+
+    # Return options
+    return options, arguments
+
+
+def action_add(queue):
+    """Add a render task to the given queue.
+
+    Please modify this as needed.
+
+    Args:
+        queue: QueueHandler to interact with.
+    """
+    queue.create_task({
+        "kind": "task#render",
+        "resource_slug": "binary-cards",
+        "resource_name": "Binary Cards",
+        "resource_view": "binary_cards",
+        "url": "resources/binary-cards.html",
+        "display_numbers": False,
+        "black_back": True,
+        "paper_size": "a4",
+        "header_text": "",
+        "copies": 1,
+    }, tag="task")
+
+
+def action_list(queue):
+    """List up to 100 tasks in the queue.
+
+    Args:
+        queue: QueueHandler to interact with.
+    """
+    tasks = list(queue.tasks())
+    print("Number of tasks: {}".format(len(tasks)))
+    for task in tasks:
+        print(task)
+
+
+def action_lease(queue):
+    """Lease tasks tagged with task from the queue for 30 seconds.
+
+    Args:
+        queue: QueueHandler to interact with.
+    """
+    tasks = list(queue.lease_tasks(tasks_to_fetch=100, lease_secs=30, tag="task"))
+    print("Number of tasks: {}".format(len(tasks)))
+    for task in tasks:
+        print(task)
+
+
+def action_document(queue):
+    """Save out document results from the queue.
+
+    Args:
+        queue: QueueHandler to interact with.
+    """
+    tasks = queue.list_tasks()
+    for task in tasks:
+        if task["payload"]["kind"] == "result#document":
+            data = task["payload"]["document"].encode("ascii")
+            document = base64.b64decode(data)
+            filename = task["payload"]["filename"]
+            with open(filename, "wb") as f:
+                f.write(document)
+
+
+def action_flush(queue):
+    """Attempt to delete all tasks from the queue.
+
+    Args:
+        queue: QueueHandler to interact with.
+    """
+    tasks = queue.tasks()
+    for task in tasks:
+        queue.delete_task(task["name"])
+
+
+if __name__ == "__main__":
+    options, arguments = parse_args()
+
+    directory = os.path.abspath(os.path.join(os.getcwd(), os.pardir, 'renderservice/render/daemon/QueueHandler.py'))
+    loader = importlib.machinery.SourceFileLoader('render.daemon', directory)
+    handle = loader.load_module('render.daemon')
+
+    queue = handle.QueueHandler(project_id=PROJECT_NAME, location_id=LOCATION,
+                                taskqueue_id=QUEUE_NAME, discovery_url=DISCOVERY_URL,
+                                credentials=CREDENTIALS)
+
+    action = arguments[0]
+    if action == "add":
+        action_add(queue)
+    elif action == "list":
+        action_list(queue)
+    elif action == "lease":
+        action_lease(queue)
+    elif action == "document":
+        action_document(queue)
+    elif action == "flush":
+        action_flush(queue)

docker-compose.yml

@@ -0,0 +1,40 @@
+version: "3.2"
+services:
+
+  redis:
+    restart: always
+    image: redis
+    ports:
+      - "6379:6379"
+
+  render:
+    build:
+      context: .
+      dockerfile: ./renderservice/Dockerfile-local
+      args:
+        PROCESS_PORT: 5051
+        FLASK_PRODUCTION: 0
+        PROJECT_NAME: cs-unplugged-develop
+        QUEUE_NAME: render-queue
+        API_DISCOVERY_URL: http://queue:5052/api/{api}/{apiVersion}
+        STATIC_DIRECTORY: /renderservice/static_mnt
+    volumes:
+      - ./static:/renderservice/static_mnt
+    ports:
+      - "5051:5051"
+    depends_on:
+      - queue
+
+  queue:
+    build:
+      context: .
+      dockerfile: ./queueservice/Dockerfile-local
+      args:
+        PROCESS_PORT: 5052
+    ports:
+      - "5052:5052"
+    environment:
+      - REDIS_HOST=redis
+      - REDIS_PORT=6379
+    depends_on:
+      - redis

docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = CSUnplugged
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/make.bat

@@ -0,0 +1,36 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=source
+set BUILDDIR=build
+set SPHINXPROJ=CSUnplugged
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.http://sphinx-doc.org/
+	exit /b 1
+)
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS%
+
+:end
+popd

docs/requirements.txt

@@ -0,0 +1,10 @@
+# Check Python style
+flake8==3.3.0
+pydocstyle==2.0.0
+
+#Coverage Tools
+coverage==4.4.1
+
+# Documentation
+sphinx==1.6.2
+sphinx-rtd-theme==0.2.4