/*
* Copyright 2014-2016 Canonical Ltd.
* Copyright 2021-2023 Robert Tari
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 3, as published
* by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranties of
* MERCHANTABILITY, SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR
* PURPOSE. See the GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program. If not, see .
*
* Authors:
* Charles Kerr
* Robert Tari
*/
#ifndef LOMIRI_SOUNDSDIR
#define LOMIRI_SOUNDSDIR ""
#endif
#include "glib-fixture.h"
#include "dbus-shared.h"
#include "device.h"
#include "notifier.h"
#include
#include
#include
#include
#include
/***
****
***/
class NotifyFixture: public GlibFixture
{
private:
typedef GlibFixture super;
static constexpr char const * NOTIFY_BUSNAME {"org.freedesktop.Notifications"};
static constexpr char const * NOTIFY_INTERFACE {"org.freedesktop.Notifications"};
static constexpr char const * NOTIFY_PATH {"/org/freedesktop/Notifications"};
protected:
DbusTestService * service = nullptr;
DbusTestDbusMock * mock = nullptr;
DbusTestDbusMockObject * obj = nullptr;
GDBusConnection * bus = nullptr;
static constexpr int FIRST_NOTIFY_ID {1234};
static constexpr int NOTIFICATION_CLOSED_EXPIRED {1};
static constexpr int NOTIFICATION_CLOSED_DISMISSED {2};
static constexpr int NOTIFICATION_CLOSED_API {3};
static constexpr int NOTIFICATION_CLOSED_UNDEFINED {4};
static constexpr char const * METHOD_CLOSE {"CloseNotification"};
static constexpr char const * METHOD_NOTIFY {"Notify"};
static constexpr char const * METHOD_GET_CAPS {"GetCapabilities"};
static constexpr char const * METHOD_GET_INFO {"GetServerInformation"};
static constexpr char const * SIGNAL_CLOSED {"NotificationClosed"};
protected:
void SetUp()
{
super::SetUp();
// init DBusMock / dbus-test-runner
service = dbus_test_service_new(nullptr);
GError * error = nullptr;
mock = dbus_test_dbus_mock_new(NOTIFY_BUSNAME);
obj = dbus_test_dbus_mock_get_object(mock,
NOTIFY_PATH,
NOTIFY_INTERFACE,
&error);
g_assert_no_error (error);
// METHOD_GET_INFO
dbus_test_dbus_mock_object_add_method(mock, obj, METHOD_GET_INFO,
nullptr,
G_VARIANT_TYPE("(ssss)"),
"ret = ('mock-notify', 'test vendor', '1.0', '1.1')",
&error);
g_assert_no_error (error);
// METHOD_NOTIFY
auto str = g_strdup_printf("try:\n"
" self.NextNotifyId\n"
"except AttributeError:\n"
" self.NextNotifyId = %d\n"
"ret = self.NextNotifyId\n"
"self.NextNotifyId += 1\n",
FIRST_NOTIFY_ID);
dbus_test_dbus_mock_object_add_method(mock, obj, METHOD_NOTIFY,
G_VARIANT_TYPE("(susssasa{sv}i)"),
G_VARIANT_TYPE_UINT32,
str,
&error);
g_assert_no_error (error);
g_free (str);
// METHOD_CLOSE
str = g_strdup_printf("self.EmitSignal('%s', '%s', 'uu', [ args[0], %d ])",
NOTIFY_INTERFACE,
SIGNAL_CLOSED,
NOTIFICATION_CLOSED_API);
dbus_test_dbus_mock_object_add_method(mock, obj, METHOD_CLOSE,
G_VARIANT_TYPE("(u)"),
nullptr,
str,
&error);
g_assert_no_error (error);
g_free (str);
dbus_test_service_add_task(service, DBUS_TEST_TASK(mock));
dbus_test_service_start_tasks(service);
bus = g_bus_get_sync(G_BUS_TYPE_SESSION, nullptr, nullptr);
g_dbus_connection_set_exit_on_close(bus, FALSE);
g_object_add_weak_pointer(G_OBJECT(bus), reinterpret_cast(&bus));
notify_init(SERVICE_EXEC);
}
virtual void TearDown()
{
notify_uninit();
g_clear_object(&mock);
g_clear_object(&service);
g_object_unref(bus);
// wait a little while for the scaffolding to shut down,
// but don't block on it forever...
unsigned int cleartry = 0;
while ((bus != nullptr) && (cleartry < 50))
{
g_usleep(100000);
while (g_main_context_pending(NULL))
g_main_context_iteration(NULL, true);
cleartry++;
}
super::TearDown();
}
/***
****
***/
int get_notify_call_count() const
{
guint len {0u};
GError* error {nullptr};
dbus_test_dbus_mock_object_get_method_calls(mock, obj, METHOD_NOTIFY, &len, &error);
g_assert_no_error(error);
return len;
}
std::string get_notify_call_sound_file(int call_number)
{
std::string ret;
guint len {0u};
GError* error {nullptr};
auto calls = dbus_test_dbus_mock_object_get_method_calls(mock, obj, METHOD_NOTIFY, &len, &error);
g_return_val_if_fail(int(len) > call_number, ret);
g_assert_no_error(error);
constexpr int HINTS_PARAM_POSITION {6};
const auto& call = calls[call_number];
g_return_val_if_fail(g_variant_n_children(call.params) > HINTS_PARAM_POSITION, ret);
auto hints = g_variant_get_child_value(call.params, HINTS_PARAM_POSITION);
const gchar* sound_file = nullptr;
auto success = g_variant_lookup(hints, "sound-file", "&s", &sound_file);
g_return_val_if_fail(success, ret);
if (sound_file != nullptr)
ret = sound_file;
g_clear_pointer(&hints, g_variant_unref);
return ret;
}
void clear_method_calls()
{
GError* error{nullptr};
ASSERT_TRUE(dbus_test_dbus_mock_object_clear_method_calls(mock, obj, &error));
g_assert_no_error(error);
}
};
/***
****
***/
// simple test to confirm the NotifyFixture plumbing all works
TEST_F(NotifyFixture, HelloWorld)
{
}
/***
****
***/
namespace
{
static constexpr double percent_critical {2.0};
static constexpr double percent_very_low {5.0};
static constexpr double percent_low {10.0};
void set_battery_percentage (IndicatorPowerDevice * battery, gdouble p)
{
g_object_set (battery, INDICATOR_POWER_DEVICE_PERCENTAGE, p, nullptr);
}
}
TEST_F(NotifyFixture, PercentageToLevel)
{
auto battery = indicator_power_device_new ("/object/path",
UP_DEVICE_KIND_BATTERY,
"Some Model",
50.0,
UP_DEVICE_STATE_DISCHARGING,
30,
TRUE);
// confirm that the power levels trigger at the right percentages
for (int i=100; i>=0; --i)
{
set_battery_percentage (battery, i);
const auto level = indicator_power_notifier_get_power_level(battery);
if (i <= percent_critical)
EXPECT_STREQ (POWER_LEVEL_STR_CRITICAL, level);
else if (i <= percent_very_low)
EXPECT_STREQ (POWER_LEVEL_STR_VERY_LOW, level);
else if (i <= percent_low)
EXPECT_STREQ (POWER_LEVEL_STR_LOW, level);
else
EXPECT_STREQ (POWER_LEVEL_STR_OK, level);
}
g_object_unref (battery);
}
/***
****
***/
// scaffolding to monitor PropertyChanged signals
namespace
{
enum
{
FIELD_POWER_LEVEL = (1<<0),
FIELD_IS_WARNING = (1<<1)
};
struct ChangedParams
{
std::string power_level = POWER_LEVEL_STR_OK;
bool is_warning = false;
uint32_t fields = 0;
};
void on_battery_property_changed (GDBusConnection *connection G_GNUC_UNUSED,
const gchar *sender_name G_GNUC_UNUSED,
const gchar *object_path G_GNUC_UNUSED,
const gchar *interface_name G_GNUC_UNUSED,
const gchar *signal_name G_GNUC_UNUSED,
GVariant *parameters,
gpointer gchanged_params)
{
g_return_if_fail (g_variant_n_children (parameters) == 3);
auto dict = g_variant_get_child_value (parameters, 1);
g_return_if_fail (g_variant_is_of_type (dict, G_VARIANT_TYPE_DICTIONARY));
auto changed_params = static_cast(gchanged_params);
const char * power_level;
if (g_variant_lookup (dict, "PowerLevel", "&s", &power_level, nullptr))
{
changed_params->power_level = power_level;
changed_params->fields |= FIELD_POWER_LEVEL;
}
gboolean is_warning;
if (g_variant_lookup (dict, "IsWarning", "b", &is_warning, nullptr))
{
changed_params->is_warning = is_warning;
changed_params->fields |= FIELD_IS_WARNING;
}
g_variant_unref (dict);
}
}
TEST_F(NotifyFixture, LevelsDuringBatteryDrain)
{
auto battery = indicator_power_device_new ("/object/path",
UP_DEVICE_KIND_BATTERY,
"Some Model",
50.0,
UP_DEVICE_STATE_DISCHARGING,
30,
TRUE);
// set up a notifier and give it the battery so changing the battery's
// charge should show up on the bus.
auto notifier = indicator_power_notifier_new ();
indicator_power_notifier_set_battery (notifier, battery);
indicator_power_notifier_set_bus (notifier, bus);
wait_msec();
ChangedParams changed_params;
auto sub_tag = g_dbus_connection_signal_subscribe (bus,
nullptr,
"org.freedesktop.DBus.Properties",
"PropertiesChanged",
BUS_PATH"/Battery",
nullptr,
G_DBUS_SIGNAL_FLAGS_NONE,
on_battery_property_changed,
&changed_params,
nullptr);
// confirm that draining the battery puts
// the power_level change through its paces
for (int i=100; i>=0; --i)
{
changed_params = ChangedParams();
EXPECT_TRUE (changed_params.fields == 0);
const auto old_level = indicator_power_notifier_get_power_level(battery);
set_battery_percentage (battery, i);
const auto new_level = indicator_power_notifier_get_power_level(battery);
wait_msec();
if (old_level == new_level)
{
EXPECT_EQ (0, (changed_params.fields & FIELD_POWER_LEVEL));
}
else
{
EXPECT_EQ (FIELD_POWER_LEVEL, (changed_params.fields & FIELD_POWER_LEVEL));
EXPECT_EQ (new_level, changed_params.power_level);
}
}
// cleanup
g_dbus_connection_signal_unsubscribe (bus, sub_tag);
g_object_unref (battery);
g_object_unref (notifier);
}
/***
****
***/
TEST_F(NotifyFixture, EventsThatChangeNotifications)
{
// GetCapabilities returns an array containing 'actions', so that we'll
// get snap decisions and the 'IsWarning' property
GError * error = nullptr;
dbus_test_dbus_mock_object_add_method (mock,
obj,
METHOD_GET_CAPS,
nullptr,
G_VARIANT_TYPE_STRING_ARRAY,
"ret = ['actions', 'body']",
&error);
g_assert_no_error (error);
auto battery = indicator_power_device_new ("/object/path",
UP_DEVICE_KIND_BATTERY,
"Some Model",
percent_low + 1.0,
UP_DEVICE_STATE_DISCHARGING,
30,
TRUE);
// the file we expect to play on a low battery notification...
const char* expected_file = LOMIRI_SOUNDSDIR "/notifications/" LOW_BATTERY_SOUND;
char* tmp = g_filename_to_uri(expected_file, nullptr, nullptr);
const std::string low_power_uri {tmp};
g_clear_pointer(&tmp, g_free);
// set up a notifier and give it the battery so changing the battery's
// charge should show up on the bus.
auto notifier = indicator_power_notifier_new ();
indicator_power_notifier_set_battery (notifier, battery);
indicator_power_notifier_set_bus (notifier, bus);
ChangedParams changed_params;
auto sub_tag = g_dbus_connection_signal_subscribe (bus,
nullptr,
"org.freedesktop.DBus.Properties",
"PropertiesChanged",
BUS_PATH"/Battery",
nullptr,
G_DBUS_SIGNAL_FLAGS_NONE,
on_battery_property_changed,
&changed_params,
nullptr);
// test setup case
wait_msec();
EXPECT_STREQ (POWER_LEVEL_STR_OK, changed_params.power_level.c_str());
// change the percent past the 'low' threshold and confirm that
// a) the power level changes
// b) we get a notification
changed_params = ChangedParams();
set_battery_percentage (battery, percent_low);
wait_msec();
EXPECT_EQ (FIELD_POWER_LEVEL|FIELD_IS_WARNING, changed_params.fields);
EXPECT_EQ (indicator_power_notifier_get_power_level(battery), changed_params.power_level);
EXPECT_TRUE (changed_params.is_warning);
EXPECT_EQ (1, get_notify_call_count());
EXPECT_EQ (low_power_uri, get_notify_call_sound_file(0));
clear_method_calls();
// now test that the warning changes if the level goes down even lower...
changed_params = ChangedParams();
set_battery_percentage (battery, percent_very_low);
wait_msec();
EXPECT_EQ (FIELD_POWER_LEVEL, changed_params.fields);
EXPECT_STREQ (POWER_LEVEL_STR_VERY_LOW, changed_params.power_level.c_str());
EXPECT_EQ (1, get_notify_call_count());
EXPECT_EQ (low_power_uri, get_notify_call_sound_file(0));
clear_method_calls();
// ...and that the warning is taken down if the battery is plugged back in...
changed_params = ChangedParams();
g_object_set (battery, INDICATOR_POWER_DEVICE_STATE, UP_DEVICE_STATE_CHARGING, nullptr);
wait_msec();
EXPECT_EQ (FIELD_IS_WARNING, changed_params.fields);
EXPECT_FALSE (changed_params.is_warning);
EXPECT_EQ (0, get_notify_call_count());
// ...and that it comes back if we unplug again...
changed_params = ChangedParams();
g_object_set (battery, INDICATOR_POWER_DEVICE_STATE, UP_DEVICE_STATE_DISCHARGING, nullptr);
wait_msec();
EXPECT_EQ (FIELD_IS_WARNING, changed_params.fields);
EXPECT_TRUE (changed_params.is_warning);
EXPECT_EQ (1, get_notify_call_count());
EXPECT_EQ (low_power_uri, get_notify_call_sound_file(0));
clear_method_calls();
// ...and that it's taken down if the power level is OK
changed_params = ChangedParams();
set_battery_percentage (battery, percent_low+1);
wait_msec();
EXPECT_EQ (FIELD_POWER_LEVEL|FIELD_IS_WARNING, changed_params.fields);
EXPECT_STREQ (POWER_LEVEL_STR_OK, changed_params.power_level.c_str());
EXPECT_FALSE (changed_params.is_warning);
EXPECT_EQ (0, get_notify_call_count());
// cleanup
g_dbus_connection_signal_unsubscribe (bus, sub_tag);
g_object_unref (notifier);
g_object_unref (battery);
}