lib: Introduce Clapper playback library

An easy to use media playback library (libclapper) as a GstPlayer replacement.

Previously we tried to use upstream `gstplayer` library to control playback and
pass all events from multiple threads GStreamer uses into an app main thread.
Since this caused some thread racy problems and we needed additional ABI breaking
changes to better suit our needs, we ended up with a modified fork of said library
renamed to `gstclapper` as a temporary solution.

This new library simply named `clapper` replaces our previous `gstclapper` solution
and is written completely from scratch by myself. The aim here is to have an easy to
use playback library better suited to work with (but not limited to) GTK and GObject
properties bindings by relying on "notify" signals.

Major differences include:
* Operates on a playback queue (inherits `GListModel` interface) instead of a single URI
* Uses "notify" signals for property changes always dispatched to app thread
* Time is passed/read as decimal number in seconds instead of int64 in nanoseconds
* Integrates `GstDiscoverer` to figure out media info (such as title) before playback
* Easy to use MPRIS support as part of library
* Optional playback remote controls with WebSocket messages

The new library will be distributed with Clapper player. This includes public headers
and GObject Introspection support.

Licensed under LGPL-2.1-or-later.

Enjoy

meson.build

@@ -1,39 +1,140 @@
-project('com.github.rafostar.Clapper', 'c', 'cpp',
+project('clapper', 'c',
   version: '0.5.2',
-  meson_version: '>= 0.50.0',
-  license: 'GPL-3.0-or-later',
+  meson_version: '>= 0.64.0',
+  license: 'LGPL-2.1-or-later AND GPL-3.0-or-later', # LGPL-2.1+ for libs and gst-plugin, GPL-3.0+ for app
   default_options: [
     'warning_level=1',
-    'buildtype=debugoptimized'
-  ]
+    'buildtype=debugoptimized',
+  ],
 )
 
+glib_req = '>= 2.76.0'
+gst_req = '>= 1.20.0'
+gtk4_req = '>= 4.10.0'
+
+clapper_version = meson.project_version().split('-')[0]
+version_array = clapper_version.split('.')
+clapper_version_suffix = '-' + version_array[0] + '.0'
+
+clapper_api_name = meson.project_name() + clapper_version_suffix
+
 gnome = import('gnome')
+pkgconfig = import('pkgconfig')
 i18n = import('i18n')
-python = import('python')
 
-bindir = join_paths(get_option('prefix'), get_option('bindir'))
-libdir = join_paths(get_option('prefix'), get_option('libdir'))
-datadir = join_paths(get_option('prefix'), get_option('datadir'))
+prefix = get_option('prefix')
+bindir = get_option('bindir')
+datadir = get_option('datadir')
+libdir = get_option('libdir')
+localedir = get_option('localedir')
+includedir = get_option('includedir')
+optimization = get_option('optimization')
 
-pkglibdir = join_paths(libdir, meson.project_name())
-pkgdatadir = join_paths(datadir, meson.project_name())
+clapper_libdir = join_paths(prefix, libdir, clapper_api_name)
+build_optimized = optimization in ['2', '3', 's']
 
-subdir('lib')
+gst_dep = dependency('gstreamer-1.0',
+  version: gst_req,
+  required: false,
+)
+gst_base_dep = dependency('gstreamer-base-1.0',
+  version: gst_req,
+  required: false,
+)
+gst_video_dep = dependency('gstreamer-video-1.0',
+  version: gst_req,
+  required: false,
+)
+gst_audio_dep = dependency('gstreamer-audio-1.0',
+  version: gst_req,
+  required: false,
+)
+gst_pbutils_dep = dependency('gstreamer-pbutils-1.0',
+  version: gst_req,
+  required: false,
+)
+gst_tag_dep = dependency('gstreamer-tag-1.0',
+  version: gst_req,
+  required: false,
+)
+glib_dep = dependency('glib-2.0',
+  version: glib_req,
+  required: false,
+)
+gobject_dep = dependency('gobject-2.0',
+  version: glib_req,
+  required: false,
+)
+gio_dep = dependency('gio-2.0',
+  version: glib_req,
+  required: false,
+)
+gmodule_dep = dependency('gmodule-2.0',
+  version: glib_req,
+  required: false,
+)
+gtk4_dep = dependency('gtk4',
+  version: gtk4_req,
+  required: false,
+)
 
-if get_option('player')
-  subdir('bin')
-  subdir('data')
-  subdir('po')
+cc = meson.get_compiler('c')
+libm = cc.find_library('m', required: false)
 
-  install_subdir('src', install_dir: pkgdatadir)
-  install_subdir('extras', install_dir: pkgdatadir)
-  install_subdir('css', install_dir: pkgdatadir)
-  install_subdir('ui', install_dir: pkgdatadir)
+warning_flags = [
+  '-Wmissing-declarations',
+  '-Wredundant-decls',
+  '-Wwrite-strings',
+  '-Wformat',
+  '-Wformat-security',
+  '-Winit-self',
+  '-Wmissing-include-dirs',
+  '-Waddress',
+  '-Wno-multichar',
+  '-Wvla',
+  '-Wpointer-arith',
+  '-Wmissing-prototypes',
+  '-Wdeclaration-after-statement',
+  '-Wold-style-definition',
+  '-Wsign-compare',
+]
 
-  python_bin = python.find_installation('python3')
-  if not python_bin.found()
-    error('No valid python3 binary found')
+foreach extra_arg : warning_flags
+  if cc.has_argument (extra_arg)
+    add_project_arguments([extra_arg], language: 'c')
   endif
-  meson.add_install_script('build-aux/meson/postinstall.py')
+endforeach
+
+if build_optimized
+  message('Disabling GLib cast checks')
+  add_project_arguments('-DG_DISABLE_CAST_CHECKS', language: 'c')
+
+  message('Disabling GLib asserts')
+  add_project_arguments('-DG_DISABLE_ASSERT', language: 'c')
+
+  message('Disabling GLib checks')
+  add_project_arguments('-DG_DISABLE_CHECKS', language: 'c')
 endif
+
+subdir('src')
+subdir('doc')
+
+summary({
+  'prefix': prefix,
+  'bindir': bindir,
+  'datadir': datadir,
+  'libdir': libdir,
+  'localedir': localedir,
+  'includedir': includedir,
+  'optimization': optimization,
+}, section: 'Directories')
+
+summary('clapper', build_clapper ? 'Yes' : 'No', section: 'Build')
+summary('gst-plugin', build_gst_plugin ? 'Yes' : 'No', section: 'Build')
+summary('introspection', build_gir ? 'Yes' : 'No', section: 'Build')
+summary('vapi', build_vapi ? 'Yes' : 'No', section: 'Build')
+summary('doc', build_doc  ? 'Yes' : 'No', section: 'Build')
+
+foreach name : clapper_possible_features
+  summary(name, clapper_available_features.contains(name) ? 'Yes' : 'No', section: 'Features')
+endforeach