An authorship experience demo of the perspective API

This repository contains example code for an authorship experience that provides feedback as you type using the Perspective API. It is a web app written in Angular2/TypeScript and uses a node express server. This project shows how to have a development and a production build environment with deployment tools based on Docker. This makes it easy be deployed to cloud services such as Google Cloud's flexible appengine environment, as well as other cloud computing providers.

The app uses the Perspective API to score text, via a the perspectiveapi-simple-server.

This project was generated with Angular CLI version 1.0.0.

Requirements & Setup

To run code using your local machine (not via the docker environment), you will need to install nodejs (e.g., by installing NVM). You'll also need some global packages which you can install using the npm command:

npm install -g yarn typings typescript ts-node mocha protractor angular-cli karma-cli

Next, you will need to create a Google Cloud Project project, and it will need to have access the PerspectiveAPI. Requests to the API will be authenticated using an cloud project API key.

Am example configuration file template is provided in config/server_config.template.json. If one is not present in build/config, then the config file will be copied there when you build or start a local server. The config file specifies your google-cloud project API key, and some other details which you can learn more about in the Documentation for perspectiveapi-simple-server.

To setup and install the local packages, run:

yarn install

Development server that watches the source code

Run yarn run serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files. API requests to the server (http://localhost:4200/check and http://localhost:4200/suggest_score) will be redirected to an underlying nodejs server, based on perspectiveapi-simple-server, which is started at http://localhost:8080/.

Development server that uses compiled sources

Builds the app in build/static:

yarn build:dev

Start the simple server at http://localhost:8080/ serving content from build/static:

yarn run start:dev-server

Production server that uses compiled sources

To build the production version of the app in build/static, which will compile the HTML, JS and CSS and do cool shakedown stuff to minimize the size, run:

yarn build:prod

You can now run the simple server at http://localhost:8080/ serving content from build/static:

yarn run start:dev-server

When run using the Dockerfile, e.g. on Google Cloud, the following command will be run:

yarn run start:prod-server

If you run this locally, you'll need to login to google cloud and set your project id. If you run this locally, you'll need to login to google cloud and set your project id.

Production server using docker file

Assuming you have docker installed and setup, you can create a docker-image for the prod server with:

docker build -t perspectiveapi-authorship-demo .

To start a shell in the docker environment for debugging and to manually start the server there, you can run:

docker run -ti perspectiveapi-authorship-demo /bin/bash

Code scaffolding

Run ng generate component component-name to generate a new component. You can also use ng generate directive/pipe/service/class/module.

Build

Run yarn run build to build the project. The build artifacts will be stored in the build/ directory. Use the -prod flag for a production build.

Running unit tests

Run yarn run test to execute the unit tests via Karma.

Running end-to-end tests

Run yarn run e2e to execute the end-to-end tests via Protractor. Before running the tests make sure you are serving the app via ng serve.

Further help

To get more help on the Angular CLI use ng help or go check out the Angular CLI README.

Notes

This is example code to help experimentation with the Perspective API; it is not an official Google product.

identidadgh/perspectiveapi-authorship-demo