Skip to content

A library for accessing the usage data collected by the activities system.

Notifications You must be signed in to change notification settings

KDE/kactivities-stats

Repository files navigation

KActivitiesStats

Library to access the usage statistics data collected by the KDE activity manager.

Introduction

The KActivitiesStats library provides a querying mechanism for the data that the activity manager collects - which documents hae been opened by which applications, and what documents have been linked to which activity. The activity manager also keeps the score for each document which gets higher when a particular document has been often accessed or kept open for longer periods of time. This score is also available through the querying mechanism.

Usage

The library provides the following important classes:

  • KActivities::Stats::ResultSet is a low level class that provides a forward iterator to the list of results that match the specified query
  • KActivities::Stats::ResultWatcher provides signals when a new resource that matches a query arrives, or when an existing one is gone (usage statistics cleared or some for other reason)
  • KActivities::Stats::ResultModel provides a Qt data model that shows the resources that match the specified query. This model should be subclassed to teach it to handle the different resource types that you want to show as the results.

Queries are defined by the KActivities::Stats::Query class using a simple range-like syntax.