Notwithstanding Precautions, Misadventure

    devuan

    0.0.2 • Public • Published

    devuan

    devuan is intended to provide a JavaScript API for querying and modifying a system running a Devuan-based operating system.

    Install

    devuan is a [npm] module intended to work with Node.js. To install it, provide the following command:

    npm install devuan
    

    Usage

    To use devuan from your own scripts, just require() the devuan module like so:

    var DEVUAN = require("devuan");
    

    You can then use the DEVUAN object to query and/or modify your Devuan system.

    API Documentation

    APT

    APT contains functions for dealing with packages.

    APT.getSourcesListPromise

    getSourcesListPromise returns a Promise that will resolve to source objects, in the following form:

    {
      type: "deb",
      uri: "http://ftp.debian.org/debian",
      suite: "wheezy",
      sections: ["main"],
      options: {
        arch: ["amd64", "armel"]
      }
    }
    

    If you provide a directory to getSourcesListPromise it will parse the .list files that it finds in that directory. If you do not provide a directory, then the default system directory /etc/apt/sources.list.d will be used.

    ARCH

    ARCH contains the Devuan architecture provided by dpkg. It is the output of the following command:

    dpkg --print-architecture
    

    On my system, this is amd64, but it may be different on your system.

    Hacking

    If you want to make changes to the devuan module, you need to set up a development environment. Change to the directory where you keep your projects, and then do the following:

    git clone https://github.com/blinkdog/devuan
    cd devuan
    npm install
    cake rebuild
    

    The source files are located in src/main/coffee.
    The tests are located in src/test/coffee.

    The following command will run coverage tests, and open the report in Mozilla Firefox:

    cake coverage
    

    If you prefer a different browser, edit BROWSER_COMMAND at the top of the Cakefile file to your preferred browser.

    License

    devuan
    Copyright 2016 Patrick Meade.

    This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

    You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.

    Install

    npm i devuan

    DownloadsWeekly Downloads

    9

    Version

    0.0.2

    License

    AGPL-3.0

    Last publish

    Collaborators

    • avatar