Nostalgic Punchcard Missing

    @papermerge/commander

    0.5.0 • Public • Published

    Unittests

    Document Commander

    NodeJs package for (reusable) client side files browsing i.e. javascript code for navigating documents and folders. Provides look and feel of typical modern desktop file manager e.g. Gnome's Files App. Document Commander is part by Papermerge Core.

    Commander

    Requirements

    The core requirements for this project are NodeJs, npm (node package manager) and webpack:

    Installation

    Install all nodejs dependent packages:

    $ npm i  # looks in package.json and installs dependencies
    

    Playground

    In site/ folder there is a flask based project used as playground. In order to setup and run playground, use following commands:

    $ cd site
    $ virtualenv .venv -p /usr/bin/python3.7
    $ source .venv/bin/activate
    $ pip install -r requirements.txt
    $ cd ..
    $ make run
    

    Document Commander API

    At vary basic, you can instanciate Document Commander and open root folder as follows::

    let DC = DocummentCommander, commander;
    
    commander = new DC.CommanderView({
        'el': '#commander'
    });
    commander.open();
    

    Where #commander is some DOM div element. Notice when commander.open method is without arguments Commander will open root folder i.e. will issue request GET /core/folder/ from the server side. The core part of the url request is so called urlconf prefix. If no further configuration is provided, default urlconf prefix is used - which is /core.

    You can change default urlconf prefix as follows::

    let DC = DocummentCommander, commander;
    
    DC.urlconf.prefix = "/app";
    commander = new DC.CommanderView({
        'el': '#commander'
    });
    commander.open();
    

    In this case DocumentCommander will issue GET /app/folder http request to fetch root folder data.

    In order to open at specific folder, provide that folder as named parameter to open method::

    let DC = DocummentCommander,
        commander,
        folder;
    
    commander = new DC.CommanderView({
        'el': '#commander'
    });
    folder = new DC.Folder({id: 3});
    commander.open({folder});
    

    In this case Document Commander will fetch folder nodes from GET /core/folder/3/ location.

    Install

    npm i @papermerge/commander

    DownloadsWeekly Downloads

    22

    Version

    0.5.0

    License

    Apache-2.0

    Unpacked Size

    1.38 MB

    Total Files

    107

    Last publish

    Collaborators

    • avatar