labtasker-plugin-task-recency
A Labtasker plugin for retrieving tasks grouped by time chunks.
Overview
This plugin extends Labtasker's functionality by allowing you to retrieve tasks that occurred within specific time chunks. It groups tasks based on time intervals between consecutive tasks, making it easy to analyze and process tasks that were submitted in bursts.
Installation
pip install labtasker-plugin-task-recency
Usage
labtasker task recent [OPTIONS]
Options
| Option | Default | Description |
|---|---|---|
--by |
created_at |
The timestamp field to group tasks by. Options: created_at, start_time, last_heartbeat, last_modified |
--interval, -i |
5s |
Time interval to define chunks. Accepts duration strings like 1h, 1h30m, 50s |
--k, -k |
1 |
Which chunk to retrieve (1 is most recent, 2 is second most recent, etc.) |
--order |
desc |
Sort order within each chunk. Options: desc (newest first), asc (oldest first) |
Examples
-
Get the most recent batch of tasks (tasks submitted with less than 5 seconds between them):
labtasker task recent
-
Get the second most recent batch of tasks:
labtasker task recent --k 2
-
Get tasks grouped by a 1-hour interval:
labtasker task recent --interval 1h
-
Get tasks grouped by their start time instead of creation time:
labtasker task recent --by start_time
-
Get the oldest batch of tasks:
labtasker task recent --k 1 --order asc
How It Works
The plugin groups tasks into "chunks" based on the time gaps between consecutive tasks. If two tasks are submitted with a gap smaller than the specified interval, they belong to the same chunk. When the time gap exceeds the interval, a new chunk begins.
This approach is useful for identifying batches of tasks that were submitted together, allowing for easier management and analysis of task patterns.
Use Cases
- Batch delete / update of most recently submitted tasks
labtasker task recent | labtasker task delete -y
Metadata
Release files for labtasker-plugin-task-recency 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| labtasker_plugin_task_recency-0.1.1.tar.gz | 4.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| labtasker_plugin_task_recency-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 9.8 kB
Release files / labtasker_plugin_task_recency-0.1.1.tar.gz
| Download URL | labtasker_plugin_task_recency-0.1.1.tar.gz |
|---|---|
| Size | 4.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c96b1ba0749d926ea7254f1ededcebf360ef175c7f96c7728f7f8bea4b1d7c8b
|
|
BLAKE2b-256 checksum How to use checksums |
57ab63de359f3416831e98c88bc6a9c14e4378b1e7b57e1ebd9754d7a96c2738
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 30, 2025.
Transparency logRelease files / labtasker_plugin_task_recency-0.1.1-py3-none-any.whl
| Download URL | labtasker_plugin_task_recency-0.1.1-py3-none-any.whl |
|---|---|
| Size | 4.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6b6d40c429098962f6a685df2e876d9ce10906a512e876e8ea732ac69cceb93f
|
|
BLAKE2b-256 checksum How to use checksums |
added9db1142798dd3333a7f8d274f96975a6fe711d76b0a3fd9285368555559
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 30, 2025.
Transparency log