npm-pkgbuild

Create ArchLinux, RPM and Debian packages from npm packages.

usage

In a package directory execute

npm-pkgbuild --rpm --debian --arch --content /destination:build --publish /some/directory

This will create a arch, rpm and a debian package of the build dir.

upload package

npm-pkgbuild --arch --content build --publish 'https://my.package-service.com/binaries/linux/{{type}}/{{access}}/{{arch}}'

You can specify the package content in package.json.

{
  "pkgbuild": {
    "content": {
      "/some/location/" : { "base": "build" },
      "/etc/myconfig.json" : "sample-config.json",
      "/erc/secret" : { "name":  "secret", "mode": "600" },
      "/opt/myapp": [
        {
          "type": "npm-pack"
        },
        {
          "type": "node-modules",
          "withoutDevelpmentDependencies": true
        }
      ]
    },
    "hooks" : "pkg/hooks",
    "output": {
      "debian" : {},
      "rpm" : {},
      "arch" : {}
    },
  "dependencies": { "nginx" : ">=1.12" }
  }
}

content providers

files (default)

content from the file system

npm-pack

content as provided by npm pack

node-modules

content of all (production) dependencies

options: - withoutDevelpmentDependencies when to stip away dev dependencies (defaults to true)

shared configuration

You can import common configuration from other packages see mf-hoting module as an example.

API

Table of Contents

• usage
  • upload package
• content providers
• files (default)
  • npm-pack
  • node-modules
• API
  • Table of Contents
  • ContentProvider
    • asyncIterator
  • FileContentProvider
    • Parameters
    • name
  • NodeModulesContentProvider
    • Parameters
    • name
  • NPMPackContentProvider
    • Parameters
    • name
  • pkgKeyValuePairOptions
  • fields
  • fields
  • fields
  • hookMapping
  • hookMapping
  • Field
    • Properties
  • Packager
    • Parameters
    • tmpdir
    • execute
      • Parameters
  • decodePassword
    • Parameters
  • extractFunctions
    • Parameters
  • fieldProvider
    • Parameters
  • Expander
    • Parameters
  • copyEntries
    • Parameters
• install
• license

ContentProvider

Source of package content.

asyncIterator

List all entries.

Returns asyncIterator<ContentEntry> all entries

FileContentProvider

Extends ContentProvider

Content provided form the file system.

Parameters

• definitions (Object | string)

  • definitions.pattern (string | Array<string>)
  • definitions.base string base directory where to find the files

• entryProperties

name

Returns string name of the content provider

NodeModulesContentProvider

Extends ContentProvider

Content from node_modules

Parameters

• definitions
• entryProperties

name

Returns string name of the content provider

NPMPackContentProvider

Extends ContentProvider

Content from npm pack.

Parameters

• definitions
• entryProperties

name

Returns string name of the content provider

pkgKeyValuePairOptions

fields

well known package properties https://www.archlinux.org/pacman/PKGBUILD.5.html

fields

• See: https://www.debian.org/doc/debian-policy/ch-controlfields.html
• See: https://linux.die.net/man/5/deb-control

fields

• See: https://rpm-packaging-guide.github.io

hookMapping

map install hook named from arch to deb

hookMapping

map install hook named from arch to rpm

Field

Type: Object

Properties

• alias string interchangeable field name
• type string
• default any
• mandatory boolean

Packager

Parameters

• properties Object

tmpdir

Create tmp directory.

Returns Promise<string> directory path

execute

Execute package generation

Parameters

• sources
• transformer
• dependencies
• options
• expander

decodePassword

Decode a password

Parameters

• password string

Returns string plaintext password

extractFunctions

Extract shell functions from a given text

Parameters

• source AsyncIterator<string>

Returns AsyncIterator<FunctionDecl>

fieldProvider

Parameters

• properties Object
• fields Object

Returns Function

Expander

Type: Function

Parameters

• path string

Returns string

copyEntries

Copy content from source into destinationDirectory.

Parameters

• source AsyncIterator<ContentEntry>
• destinationDirectory string
• expander Expander (optional, default v=>v)
• attributes Array<ContentEntryAttribute>

install

With npm do:

npm install npm-pkgbuild

license

BSD-2-Clause