@dbg-riskit/angular-devkit
    TypeScript icon, indicating that this package has built-in type declarations

    6.4.2 • Public • Published

    CircleCI Branches Coverage Coverage

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

    Used by:

    Browser support (tested via BrowserStack)

    Chrome Chrome Firefox Firefox Edge Edge IE IE Safari Safari iOS 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

    Keywords

    none

    Install

    npm i @dbg-riskit/angular-devkit

    DownloadsWeekly Downloads

    31

    Version

    6.4.2

    License

    SEE LICENSE IN LICENSE

    Unpacked Size

    131 kB

    Total Files

    95

    Last publish

    Collaborators

    • dbg-riskit