Beyond Linux® From Scratch (System V Edition) - Version r12.4-1014

Chapter 33. GNOME Libraries and Desktop

librest-0.10.2

Introduction to librest

The librest package contains a library that is designed to make it easier to access web services that claim to be "RESTful". It includes convenience wrappers for libsoup and libxml to make remote usage of the RESTful API easier.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

librest Dependencies

Required

JSON-GLib-1.10.8, libsoup-3.6.5, and make-ca-1.16.1

Recommended

GLib-2.86.3 (with GObject Introspection)

Optional

Gi-DocGen-2025.5, libadwaita-1.8.3 and gtksourceview5-5.18.0 (to build the demo), and Vala-0.56.18

[Note]

Note

An Internet connection is needed for some tests of this package. The system certificate store may need to be set up with make-ca-1.16.1 before testing this package.

Installation of librest

Install librest by running the following commands: 

mkdir build &&
cd    build &&

meson setup --prefix=/usr       \
            --buildtype=release \
            -D examples=false   \
            -D gtk_doc=false    \
            ..                  &&
ninja

If you have Gi-DocGen-2025.5 installed and wish to build the API documentation for this package, issue: 

sed "/output/s/librest-1.0/librest-0.10.2/" -i ../docs/meson.build &&
meson configure -D gtk_doc=true                                    &&
ninja

To test the results, issue: ninja test.

Now, as the root user: 

ninja install

Command Explanations

--buildtype=release: Specify a buildtype suitable for stable releases of the package, as the default may produce unoptimized binaries.

-D gtk_doc=false: Allow building this package without Gi-DocGen-2025.5 installed. If you have Gi-DocGen-2025.5 installed and you wish to rebuild and install the API documentation, a meson configure command will reset this option.

-D examples=false: Remove this option if libadwaita-1.8.3 and gtksourceview5-5.18.0 are installed and you wish to build the demonstration application provided by this package.

-D vapi=true: Use this switch if Vala-0.56.18 is installed and you wish to build the Vala bindings provided by this package.

Contents

Installed Programs: librest-demo (optional)
Installed Libraries: librest-1.0.so and librest-extras-1.0.so
Installed Directories: /usr/include/rest-1.0 and /usr/share/gtk-doc/html/librest-0.10.2

Short Descriptions

librest-demo

provides an example of how to use the RESTful Web API Query functions

librest-1.0.so

contains the RESTful Web API Query functions

librest-extras-1.0.so

contains extra RESTful Web API Query functions