November's Paddleball Marathon

    seng-disposable
    TypeScript icon, indicating that this package has built-in type declarations

    1.1.3 • Public • Published

    Travis Code Climate Coveralls npm npm

    seng-disposable

    seng-disposable provides a basic framework for disposable classes and objects. Disposable is used as a basis for many Seng libraries because it provides a common interface which can be passed around to be disposed at a later time.

    Installation

    yarn / npm

    yarn add seng-disposable
    npm i -S seng-disposable

    other

    We also have browser, amd, commonjs, umd, systemjs and es6 versions of this module available attached to the Github Releases.

    manual

    Check the build section below to see your you can build for all the targets yourself.

    Usage

    import Disposable from 'seng-disposable';
     
    class AsyncThinger extends Disposable {
        interval:number;
     
        start() {
            this.interval = setInterval(() => console.log('hello world!'));
        }
        
        dispose() {
            if (this.interval !== void 0) {
                clearInterval(this.interval);
                this.interval = void 0;
            }
            
            super.dispose();
        }
    }
     
    // since all objects implementing IDisposable provide the same way to dispose it, we can simply create an array
    // that contains IDisposable objects, without having to care about what they actually are.
    let disposables:Array<IDisposable> = [];
     
    disposables.push(new AsyncThinger());
    disposables.push(new AsyncThinger());
    disposables.push(new AsyncThinger());
    disposables.push(new AsyncThinger());
     
    disposables.forEach(disposable => disposable.dispose());
     

    Documentation

    View the generated documentation.

    Building

    In order to build seng-disposable, ensure that you have Git and Node.js installed.

    Clone a copy of the repo:

    git clone https://github.com/mediamonks/seng-disposable.git

    Change to the seng-disposable directory:

    cd seng-disposable

    Install dev dependencies:

    yarn

    Use one of the following main scripts:

    yarn build           # build this project 
    yarn dev             # run dev-watch mode, serving example/index.html in the browser 
    yarn generate        # generate all artifacts (compiles ts, webpack, docs and coverage) 
    yarn typings         # install .d.ts dependencies (done on install) 
    yarn test:unit       # run the unit tests 
    yarn validate        # runs validation scripts, including test, lint and coverage check 
    yarn lint            # run tslint on this project 
    yarn doc             # generate typedoc documentation 

    When installing this module, it adds a pre-push hook, that runs the validate script before committing, so you can be sure that everything checks out.

    If you want to create the distribution files yourself, you can run the build-dist script, and the following files will get generated in the dist folder:

    • /dist/seng-disposable.js: bundled with webpack, can be loaded from a script tag, available as window.SengDisposable
    • /dist/seng-disposable.min.js: same as above, but minified
    • /dist/seng-disposable-amd.js: bundled with webpack, can be used with e.g. requirejs
    • /dist/seng-disposable-commonjs.js: bundled with webpack, can be used in systems that support commonjs, but you should just use npm
    • /dist/seng-disposable-umd.js: bundled with webpack, works in the browser, with requirejs, and in a commonjs system
    • /dist/seng-disposable-umd.min.js: same as above, but minified
    • /dist/seng-disposable-system.js: bundled with typescript, can be used in systems that support systemjs
    • /dist/seng-disposable-es6.zip: transpiled with typescript, only types are removed from the source files

    Contribute

    View CONTRIBUTING.md

    Changelog

    View CHANGELOG.md

    Authors

    View AUTHORS.md

    LICENSE

    MIT © MediaMonks

    Install

    npm i seng-disposable

    DownloadsWeekly Downloads

    543

    Version

    1.1.3

    License

    MIT

    Last publish

    Collaborators

    • avatar