@dbg-riskit/angular-devkit

risk-angular-common (Angular 6 and @angular/material based library for RiskIT applications)

Used by:

• dev/DAVe-UI
• dev/DAVe-MarginEstimator-UI

Browser support (tested via BrowserStack)

Chrome	Firefox	Edge	IE	Safari	iOS
Latest	Latest	16	11	11.1	9.1+*
50	50	15	10*	10.1
				9.1

* In IE 10 and iOS the application is working, but with layout issues.

Packages

To use in your application add the following packages into your app:

@dbg-riskit/angular-auth - JWT based auth module 
@dbg-riskit/angular-charts - Charts based on GoogleCharts
@dbg-riskit/angular-common - Common code 
@dbg-riskit/angular-datatable - Data table module
@dbg-riskit/angular-devkit - Angular and Grunt build tools
@dbg-riskit/angular-dbg-layout - Layout that contains all fonts and logotypes (not available in public NPM registry)
@dbg-riskit/angular-dummy-layout - Layout without fonts and logotypes
@dbg-riskit/angular-error - Errors handling
@dbg-riskit/angular-file - Components for file upload/download
@dbg-riskit/angular-http - HTTP service implementation
@dbg-riskit/angular-logging - Logging service
@dbg-riskit/angular-login - Login components
@dbg-riskit/angular-testing - Testing utilities
@dbg-riskit/angular-view - Common view components

For best compatibility you should always bundle also:

core-js - ES 6 shim (Required for older browsers)
file-saver - Shim for cross-browser download support (Required to allow download)
hammerjs - Used by @angular/material for better UX
web-animations-js - Unified API for cross-browser animations

Usage

Tokens to be provided by application:

// For all other modules:
// -------------------------------------
// Date format string (eg. 'dd. MM. yyyy HH:mm:ss')
{
    provide : DATE_FORMAT,
    useValue: 'dd/MM/yyyy HH:mm'
}
// -------------------------------------

Prerequisites (For the first time only)

• Install npm@6 first.
• If you already have NPM update to latest version using npm i -g npm@6. Use sudo if necessary.
• You may need to setup http(s) proxy using:
  • npm config set proxy http://proxy.company.com:8080
  • npm config set https-proxy http://proxy.company.com:8080
• Run npm i to download necessary packages.
• Run commands in the following section.

Before each build

To ensure you have always up-to-date dependencies run following commands:

• Install Grunt CLI using npm i -g grunt-cli. Use sudo if necessary.
• Run npm up to update already downloaded packages.

Build distribution packages

Build all packages using:

./.circleci/pack.sh

This will generate multiple .tgz packages in dist folder that contain all files needed for distribution.

You can (and should) test the packages in your application using:

npm i <path to risk-angular-common>/dist/dbg-riskit-angular-*.tgz

Publish into NPM repositories

We deploy into private and public NPM repositories. In private we store files that are not supposed to be distributed like Eurex and DBG logo, etc.

First set following properties in your environment:

# Our ptrivate registry
export NPM_PRIVATE_AUTH_URL=https://cmqaart.deutsche-boerse.de/artifactory/api/npm/auth
export NPM_PRIVATE_PASSWORD=...
export NPM_PRIVATE_REGISTRY_URL=https://cmqaart.deutsche-boerse.de/artifactory/api/npm/npm-mdh-dev/
export NPM_PRIVATE_USER_NAME=...

# Token for public NPM registry
export NPM_PUBLIC_TOKEN=...

Run:

npm version patch #(or npm version minor/ npm version major)
grunt dist
./.circleci/publish.sh

This will increment the package version, will do a commit into Git and will publish the package into NPM registry. You have to do a push afterwards:

git push

Executing tests

To execute all test suites locally you can run one of the following commands:

• grunt test - To run Karma tests in locally installed IE, Chrome, Safari and Firefox
• grunt testIE - To run Karma tests in locally installed IE
• grunt testChrome - To run Karma tests in locally installed Chrome
• grunt testFirefox - To run Karma tests in locally installed Firefox
• grunt testSafari - To run Karma tests in locally installed Safari

To execute Karma runner in debug mode use one of the following commands:

grunt testDebug
grunt testIEDebug
grunt testChromeDebug
grunt testFirefoxDebug
grunt testSafariDebug

You can run also tests using BrowserStack cloud provider. To run these tests you need to define following environment variables first:

export BROWSER_STACK_USERNAME=...
export BROWSER_STACK_ACCESS_KEY=...

Then you can run:

grunt testBrowserStack

If you are located behind a company proxy you will need to export also HTTP_PROXY variable.

Then run grunt testBrowserStackProxy instead.

There are also tasks to run BrowserStack based tests only for a selected browser:

# BrowserStack test tasks
grunt testBrowserStackChrome
grunt testBrowserStackFirefox
grunt testBrowserStackEdge
grunt testBrowserStackIE
grunt testBrowserStackSafari
grunt testBrowserStackIOS

# BrowserStack (behind proxy) test tasks
grunt testBrowserStackProxyChrome
grunt testBrowserStackProxyFirefox
grunt testBrowserStackProxyEdge
grunt testBrowserStackProxyIE
grunt testBrowserStackProxySafari
grunt testBrowserStackProxyIOS

# BrowserStack test tasks (in debug mode)
grunt testBrowserStackChromeDebug
grunt testBrowserStackFirefoxDebug
grunt testBrowserStackEdgeDebug
grunt testBrowserStackIEDebug
grunt testBrowserStackSafariDebug
grunt testBrowserStackIOSDebug

# BrowserStack (behind proxy) test tasks (in debug mode)
grunt testBrowserStackProxyChromeDebug
grunt testBrowserStackProxyFirefoxDebug
grunt testBrowserStackProxyEdgeDebug
grunt testBrowserStackProxyIEDebug
grunt testBrowserStackProxySafariDebug
grunt testBrowserStackProxyIOSDebug