Scripts

Tiscamera has helper scripts that aim to help with deployment and installation.

dependency-manager

The dependency-manager script is a simple helper tool for the dependency management of tiscamera.

Note

Currently only Debian/Ubuntu are supported.

list arguments

Option	Short	Description
–file	-f	Manual overwrite for selected dependency file

Listing

To list all dependencies execute:

dependency-manager list

This can be used to generate a dependency list that is compatible with the package dependency description of your distribution. This list will only contain runtime dependencies

dependency-manager list --package deb

Sample output:

libzip5 (>= 1.0.1), libglib2.0-0 (>= 2.48.2), libgirepository-1.0-1 (>= 1.46.0), libusb-1.0-0 (>= 2:1.0.20), libuuid1 (>= 2.27), libudev1 (>= 229), libgstreamer1.0-0 (>= 1.8.3), gstreamer1.0-plugins-base (>= 1.8.0), gstreamer1.0-plugins-good (>= 1.8.0), gstreamer1.0-plugins-bad (>= 1.8.0), gstreamer1.0-plugins-ugly (>= 1.8.3), libxml2 (>= 2.9.3), libqt5widgets5 (>= 5.9.5), libqt5gui5 (>= 5.9.5)

list arguments

Option	Short	Description
–compilation		Install compilation dependencies
–runtime		Install runtime dependencies
–modules	-m	Only use listed modules, if not given all will be used
–package		List dependencies compatible with selected package manager. Supported values: deb.

Installation

To install dependencies execute:

dependency-manager install

The following options are available for the install command:

install arguments

Option	Short	Description
–compilation		Install compilation dependencies
–runtime		Install runtime dependencies
–modules	-m	Only use listed modules, if not given all will be used
–yes	-y	Assume ‘yes’ for prompts
–dry-run	-s	Simulate actions but do not touch the system
–no-update		Do not update the package cache before installing

File Format

The file format the dependency manager uses is JSON.

All dependency descriptions are located in <tiscamera>/dependencies/

{
    "dependencies": [
        {
            "name": "package name",
            "version": "version with modifiers",
            "phase": "runtime/compilation",
            "modules": ["aravis", "base"]
        }
    ]
}

env.sh

env.sh is a Bourne Again shell script that can be sourced to integrate the build directory into the current environment.

It will append directories to the PATH and library search path for the dynamic linker and GStreamer, thus enabling usage of tiscamera resources without installation.

To source it, call the following in the build directory

. ./env.sh

Now additional commands like tcam-ctrl or tcam-capture should be available.

tiscamera-env.sh

tiscamera-env.sh is a Bourne shell script that can be sourced to integrate the installation directories of the installation into the current environment.

It will append directories to the PATH and library search path for the dynamic linker and GStreamer, thus enabling usage of tiscamera resources without installation.

To source it, call the following in the build directory

. ./tiscamera-env.sh

The script is not installed. It can be found in the build directory under ./tiscamera-env.sh

create-release

The create-release script aims to simplify the steps of versioning and tagging when creating a new release. For the rules that are applied by this script, see Versioning and Releases. These include:

• Updating the CHANGELOG.md file to the next version number

• Creating a new commit for said changes

• Tagging the new commit with the appropriate tag