Initial commit

Signed-off-by: Guido Günther <agx@sigxcpu.org>
2020-02-14 17:40:34 +01:00
commit 3663b7d149
83 changed files with 8059 additions and 0 deletions
@@ -0,0 +1,200 @@
+/*
+ * Copyright (C) 2020 Purism SPC
+ * SPDX-License-Identifier: LGPL-2.1+
+ * Author: Guido Günther <agx@sigxcpu.org>
+ */
+#include "libfeedback.h"
+#include "lfb-gdbus.h"
+#include "lfb-priv.h"
+
+#include "lfb-names.h"
+
+/**
+ * SECTION:libfeedback
+ * @Short_description: Library initialization and helpers
+ * @Title: libfeedback
+ *
+ * To use the library call #lfb_init() with the id of your application
+ * (usually the desktop file name without the .desktop extension).
+ * When done call #lfb_uninit() to free any resources.
+ *
+ * |[
+ *    #define LIBFEEDBACK_USE_UNSTABLE_API
+ *    #include <libfeedback.h>
+ *
+ *    int main(void)
+ *    {
+ *       g_autoptr (GError) *err = NULL;
+ *       if (lfb_init ("com.example.appid", &err)) {
+ *         g_error ("%s", err->message);
+ *       }
+ *       // run your application, emit events
+ *       // ...
+ *       // when done:
+ *       lfb_uninit ();
+ *       return 0;
+ *    }
+ * ]|
+ */
+
+static LfbGdbusFeedback *_proxy;
+static char             *_app_id;
+static gboolean          _initted;
+
+LfbGdbusFeedback *
+_lfb_get_proxy (void)
+{
+  /* Caller needs to check since the proxy might be gone when
+     the last event gets finalized */
+  return _proxy;
+}
+
+/**
+ * lfb_init:
+ * @app_id: The application id
+ * @error: Error information
+ *
+ * Initialize libfeedback. This must be called before any other functions.
+ *
+ * Returns: %TRUE if successful, or %FALSE on error.
+ */
+gboolean
+lfb_init (const gchar *app_id, GError **error)
+{
+  g_return_val_if_fail (app_id != NULL, FALSE);
+  g_return_val_if_fail (*app_id != '\0', FALSE);
+
+  if (_initted)
+    return TRUE;
+
+  lfb_set_app_id (app_id);
+  _proxy = lfb_gdbus_feedback_proxy_new_for_bus_sync(
+      FB_DBUS_TYPE, 0, FB_DBUS_NAME, FB_DBUS_PATH, NULL, error);
+  if (!_proxy)
+    return FALSE;
+
+  g_object_add_weak_pointer (G_OBJECT (_proxy), (gpointer *) &_proxy);
+
+  _initted = TRUE;
+  return TRUE;
+}
+
+/**
+ * lfb_uninit:
+ *
+ * Uninitialize the library when no longer used. Usually called
+ * on program shutdown.
+ */
+void
+lfb_uninit (void)
+{
+  g_clear_pointer (&_app_id, g_free);
+  g_clear_object (&_proxy);
+  _initted = FALSE;
+}
+
+/**
+ * lfb_set_app_id:
+ * @app_id: The application id
+ *
+ * Sets the application id.
+ */
+void
+lfb_set_app_id (const char *app_id)
+{
+  g_free (_app_id);
+  _app_id = g_strdup (app_id);
+}
+
+/**
+ * lfb_get_app_id:
+ *
+ * Returns:  the application id.
+ */
+const gchar *
+lfb_get_app_id (void)
+{
+  return _app_id;
+}
+
+/**
+ * lfb_is_initted:
+ *
+ * Gets whether or not libfeedback is initialized.
+ *
+ * Returns: %TRUE if libfeedback is initialized, or %FALSE otherwise.
+ */
+gboolean
+lfb_is_initted (void)
+{
+  return _initted;
+}
+
+/**
+ * lfb_get_feedback_profile:
+ *
+ * Gets the currently set feedback profile.
+ *
+ * Returns: The current profile or %NULL on error.
+ */
+const char *
+lfb_get_feedback_profile (void)
+{
+  LfbGdbusFeedback *proxy;
+  g_autofree gchar *profile = NULL;
+  g_autoptr(GVariant) var = NULL;
+
+  if (!lfb_is_initted ()) {
+     g_warning ("you must call lfb_init() before getting the profile");
+     g_assert_not_reached ();
+   }
+
+  proxy = _lfb_get_proxy ();
+  g_return_val_if_fail (LFB_GDBUS_IS_FEEDBACK (proxy), NULL);
+
+  return lfb_gdbus_feedback_get_profile (LFB_GDBUS_FEEDBACK (proxy));
+}
+
+
+/**
+ * lfb_set_feedback_profile:
+ * @profile: The profile to set
+ *
+ * Sets the active feedback profile to #profile. It is up to the feedback
+ * daemon to ignore this request. The new profile might not become active
+ * immediately. You can listen to changes #LfbGdbusFeedback's ::profile
+ * property to get notified when it takes effect.
+ */
+void
+lfb_set_feedback_profile (const gchar *profile)
+{
+  LfbGdbusFeedback *proxy;
+
+  if (!lfb_is_initted ()) {
+     g_warning ("you must call lfb_init() before setting the profile");
+     g_assert_not_reached ();
+   }
+
+  proxy = _lfb_get_proxy ();
+  g_return_if_fail (LFB_GDBUS_IS_FEEDBACK (proxy));
+
+  lfb_gdbus_feedback_set_profile (LFB_GDBUS_FEEDBACK (proxy), profile);
+}
+
+/**
+ * lfb_get_proxy:
+ *
+ * This can be used to access the lower level API e.g. to listen to
+ * property changes. The object is not owned by the caller. Don't
+ * unref it after use.
+ *
+ * Returns: (transfer none): The DBus proxy.
+ */
+LfbGdbusFeedback *
+lfb_get_proxy (void)
+{
+  LfbGdbusFeedback *proxy = _lfb_get_proxy ();
+
+  g_return_val_if_fail (LFB_GDBUS_IS_FEEDBACK (proxy), NULL);
+  return proxy;
+}