BPM Utils

Creation and maintenance utilities for BPM packages and repositories

Information

BPM Utils provides a number of different helper commands for creating and maintaining BPM packages or repositories

Provided utilities

• bpm-setup (Sets up directories for BPM source package creation)
• bpm-repo (Allows for easy management of multiple-package repositories)
• bpm-package (Turns a BPM source package directory into a .bpm archive)

Installation

Using a package manager

• Tide Linux: Tide linux provides a bpm-utils package which can be installed using bpm install bpm-utils

Building from source

• Download go from your package manager or from the go website
• Download make from your package manager
• Run the following command to compile the project

make

• Run the following command to install bpm-utils to your system. You may also append a DESTDIR variable at the end of this line if you wish to install the files to a different location

make install PREFIX=/usr SYSCONFDIR=/etc
make install-config PREFIX=/usr SYSCONFDIR=/etc

Package Creation using BPM Utils

Creating a package for BPM with these utilities is simple

1. Run the following command (You can run the command with no arguments to see all available options)

bpm-setup -D my_package

2. This will create a directory named my_package containing all files required for bpm package creation
3. You may wish to edit the pkg.info metedata file inside the newly created directory to include dependencies or add/change other information. Here's an example of what a metedata file could look like

name: my_package
description: My package's description
version: 1.0
revision: 2 (Optional)
url: https://www.my-website.com/ (Optional)
license: MyLicense (Optional)
architecture: x86_64
type: source
depends:
  - dependency1
  - dependency2
optional_depends:
  - optional_depend1
  - optional_depend2
make_depends:
  - make_depend1
  - make_depend2
keep:
  - etc/my_config.conf
downloads:
  - url: https://wwww.my-url.com/file.tar.gz
    extract_strip_components: 1
    extract_to_bpm_source: true
    checksum: 9d19c8884cb22a594ba06a4caa6a3088e15ddfd4f3ede8c3b9e8f5cbb5a4a7a8

4. If you would like to bundle patches or other files with your package place them in the 'source-files' directory. They will be extracted to the same location as the source.sh file during compilation
5. You now need to edit your source.sh file which contains the compilation instructions for your package, the default source template comments should explain the basic process of compiling your program and how to edit it
6. When you are done editing your source.sh script run the following command to create a BPM source package archive. You may run the bpm-package command with no arguments to get an explanation of what each flag does

bpm-package

7. The bpm-package command will output a source bpm archive (and binary if passed the '-c' flag) which can be installed by BPM using bpm install <file.bpm>. If you are operating inside a BPM repository created using bpm-repo the file will automatically be moved to the binary subdirectory of your package repository