brew-view

Beergarden Frontend

Project description

Brew View is the beer-garden application frontend. It uses Tornado to serve some REST endpoints and the AngularJS application, and it communicates with the beer-garden backend (Bartender) through Thrift.

Getting Started

The following steps are the easiest way to get Brew-view up and running from source.

Prerequisites

Python (2.7.9+ or 3.4+)
Node.js (Stable, 6+) with yarn installed globally
Connectivity to a MongoDB Server
Connectivity to a RabbitMQ Server

Get Up and Running

A full installation guide for RabbitMQ and Mongo is outside the scope of this document. Below is a small snippet to get you up and running if you have docker installed..

$ docker run -d -p 27017:27017 --name bg-mongo mongo
$ docker run -d -p 5672:5672 -p 15672:15672 --name bg-rmq rabbitmq:3-management-alpine

To do development locally, it is important to note that brew-view is a combination of a python API powered by tornado and an AngularJS App. So we will start them both up!

$ git clone https://github.com/beer-garden/brew-view.git
$ cd brew-view
$ make deps # just a simple way to do pip install -r requirements.txt and yarn install

Start up the JavaScript Application:

$ cd brew_view/static
$ yarn serve

Now start up the Python API:

$ cd /path/to/brew-view
$ python -m brew_view -c ./dev_conf/config.yml

Sweet! Everything should now be up and running. Visit http://localhost:8080/ in a browser to check it out. Hit Ctrl-c to stop the web server.

NOTE: It’s worth noting that the JavaScript App is served on 8080 but the python application is running on 2337.

Configuration

There’s a conf/config.yml file that comes with the installation. It comes with sensible default values but feel free to change them if you’d like. You’ll need to restart the web server after making any changes.

REST Services

Brew-view’s most visible job is to serve the frontend application, but it also provides a REST API. This API is used by the frontend (and the plugins) to interact with the rest of beer-garden. You’re more than welcome to use the REST API directly if you’d like - you can find Swagger documentation by navigating to the About page and clicking the Check it out! button.

Testing and Code Coverage

You can run the testing yourself.

Python

$ make test

This will run the tests for the python application. You can run against multiple python versions using tox:

$ make test-all

To generate coverage:

$ make coverage

We use flake8 for linting:

$ make lint

JavaScript

The JavaScript application has its own Makefile so to run these commands you’ll need to be in the brew_view/static directory.

We are currently lacking in good JavaScript tests since we switched to webpack. We are hoping to remedy this in the near-term future. You __should__ be able to run tests:

$ make test

To run ESLint:

make lint

Distribution

Creating the brew-view distribution is simple. Simply go to the git root directory and run the following:

$ make dist

Project details

Release history Release notifications | RSS feed

2.4.21

Feb 17, 2022

2.4.20

Nov 30, 2020

2.4.19

Feb 20, 2020

2.4.18

Jan 30, 2020

2.4.17

Jan 13, 2020

2.4.16

Dec 5, 2019

2.4.15

Nov 12, 2019

2.4.14

Sep 27, 2019

2.4.13

Sep 5, 2019

2.4.12

Jun 27, 2019

2.4.11

Apr 24, 2019

2.4.10

Feb 21, 2019

2.4.9

Feb 21, 2019

2.4.8

Feb 21, 2019

2.4.7

Jan 11, 2019

2.4.6

Oct 9, 2018

2.4.5

Sep 25, 2018

2.4.4

Sep 12, 2018

2.4.3

Sep 12, 2018

This version

2.4.2

Sep 11, 2018

2.4.1

Sep 5, 2018

2.4.0

Sep 5, 2018

2.3.10

Jun 14, 2018

2.3.9

Jun 12, 2018

2.3.8

Jun 7, 2018

2.3.7

Jun 6, 2018

2.3.6

Apr 6, 2018

2.3.5

Mar 20, 2018

2.3.4

Mar 12, 2018

2.3.3

Feb 20, 2018

2.3.2

Feb 20, 2018

2.3.1

Feb 12, 2018

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

brew-view-2.4.2.tar.gz (8.1 MB view details)

Uploaded Sep 11, 2018 Source

Built Distribution

brew_view-2.4.2-py2.py3-none-any.whl (8.2 MB view details)

Uploaded Sep 11, 2018 Python 2 Python 3

File details

Details for the file brew-view-2.4.2.tar.gz.

File metadata

Download URL: brew-view-2.4.2.tar.gz
Upload date: Sep 11, 2018
Size: 8.1 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.3

File hashes

Hashes for brew-view-2.4.2.tar.gz
Algorithm	Hash digest
SHA256	`83d1ad738b405f8429ab9f69b6285a5a25420dffcacd399f08900fdfbd45848e`
MD5	`f16c79aa512dc87fa7111279f184a167`
BLAKE2b-256	`a83ae69190a8b797c146a3f87692d39b803ea5de0f77068588e29ce2767080ea`

See more details on using hashes here.

Provenance

File details

Details for the file brew_view-2.4.2-py2.py3-none-any.whl.

File metadata

Download URL: brew_view-2.4.2-py2.py3-none-any.whl
Upload date: Sep 11, 2018
Size: 8.2 MB
Tags: Python 2, Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.3

File hashes

Hashes for brew_view-2.4.2-py2.py3-none-any.whl
Algorithm	Hash digest
SHA256	`19f735530bd9457a888acfb242e0539e6aa0abfdc9535c5aefeb456946ba921b`
MD5	`293a42685c3f88d920e4954af5cf8e2d`
BLAKE2b-256	`28d8c39834da2a0091323804c48b36238b8e59644c984470d01fbfa07370de93`