Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
This release aims to further improve Pueue and to rectify some old design decisions.
Until recently, Pueue managed subprocess (task) states in a dedicated thread.
Client commands affecting subprocesses, such as pueue start --immediate
, were relayed to this special thread via an mpsc
channel for processing.
This setup caused short delays before the instructions were executed.
For instance, tasks would begin a few hundred milliseconds after the client received an Ok
from the daemon, despite using the --immediate
flag.
This behavior was unintuitive and often led to commands like pueue add --immediate install_something && pueue send 0 'y\n'
failing, as the task had not started by the time pueue send
was called.
The new state design resolves this issue by allowing Pueue to manipulate subprocess states directly within the client message handlers, eliminating any delays.
TLDR: Commands that start/stop/kill/pause tasks now only return when the task is actually started/stopped/killed/paused.
Previously, various task-state related invariants were enforced during runtime. For example, a Queued
task should not have a start
or enqueued_at
time set.
This approach, however, is highly error-prone, as it is difficult to account for every state transition and ensure everything is set or cleaned up correctly.
Fortunately, this issue can be addressed in a more elegant way in Rust using struct enums. This method enforces invariants via the type system at compile time. Although the affected code become slightly more verbose (about 25% larger), it eliminated an entire class of bugs. During this refactoring, I discovered at least two instances where I had forgotten to clear a variable.
However, since the new structure differs significantly from the old one, it breaks backward compatibility with some commands (such as status
and log
) and the serialized state.
Upon updating Pueue, the previous state will be wiped, resulting in a clean slate.
TLDR: The new task state representation is more verbose but significantly cleaner and fixes some bugs. It breaks compatibility with old states, so ensure there are no important tasks in your queue before updating. You'll also need to recreate groups.
- Breaking: Refactor internal task state. Some task variables have been moved into the
TaskStatus
enum, which now enforces various invariants during compile time via the type system. Due to this, several subtle time related inconsistencies (task start/stop/enqueue times) have been fixed. #556
Important: This completely breaks backwards compatibility, including previous state. Important: The Pueue daemon needs to be restarted and the state will be wiped clean. - Breaking: Streamlined
pueue log
parameters to behave the same way asstart
,pause
orkill
. #509 - Breaking: Remove the
--children
commandline flags, that have been deprecated and no longer serve any function sincev3.0.0
. - Send log output to
stderr
instead ofstdout
#562. - Change default log level from error to warning #562.
- Bumped MSRV to 1.70.
- Add support for NetBSD.
- Add
--all
and--group
topueue log
. #509 - Add
--all
and--group
topueue enqueue
. #558 - Add
--all
and--group
topueue stash
. #558 - Add
pueue reset --groups [group_names]
to allow resetting individual groups. #482
This also refactors the way resets are done internally, resulting in a cleaner code architecture. - Ability to set the Unix socket permissions through the new
unix_socket_permissions
configuration option. #544 - Add
command
filter topueue status
. #524 #560 - Allow
pueue status
to order tasks byenqueue_at
. #554 - Added Windows service on Windows to allow a true daemon experience. #344 #567
- Fixed delay after sending process related commands from client. #548
- Callback templating arguments were html escaped by accident. #564
- Print incompatible version warning info as a log message instead of plain stdout input, which broke json outputs #562.
- Fixed
-d
daemon mode on Windows. #344
- Nushell autocompletion script #527
- Add FreeBSD process helper to facilitate FreeBSD builds
- Replace
chrono-english
by theinterim
drop-in replacement. #534
- Support modification of task priorities via
pueue edit --priority/-o
andpueue restart --edit-priority/-o
#449. - If no output directory is provided in
completions
, the generated file is printed tostdout
#489. - Allow setting the
parallel_tasks
value of groups to0
. Setting this value allows unlimited tasks for that group #500.
- Include priority in
Task
s'Debug
output #493 - Made the daemon exit gracefully (exit code 0) on SIGINT and SIGTEM. #504
- Fix reading of configuration files that lacks a
shared
section. #505 - Respect the
-g
flag when using thestatus
filter query. #508
- Bump
ring
from 0.16 to 0.17 to add riscv64 support #484. - Fix that
add --priority
flag tried to get multiple arguments #486.
- Fixed panic when calling parallel without arguments #477
- Fixed wrong default location for
pueue_aliases.yml
#480 - Fix typos
- Daemonization doesn't work if pueued is not in $PATH #299
- Support the
PUEUE_CONFIG_PATH
environment variable in addition to the--config
option. #464
- Support parameter parsing for signal names with capslock (
SIGINT
) and short name (INT
|int
). #455 - Better error messages for pid related I/O errors. #466
- QoL improvement: Don't pause groups if there're no queued tasks. #452 Auto-pausing of groups was only done to prevent the unwanted execution of other tasks, but this isn't necessary, if there're no queued tasks.
clear
andcleanup
aliases forclean
subcommand.
The two following features are very new and marked as "experimental" for the time being. They might be reworked in a later release, since working with shells is always tricky and this definitely need more testing.
- Experimental: Allow configuration of the shell command that executes task commands. #454
- Experimental: Allow injection of hard coded environment variables via config file. #454
- Add the
-j/--json
flag topueue group
to get a machine readable list of all current groups. #430 - Add
pueued.plist
template to run pueue with launchd on MacOS. #429 - Add query syntax documentation to
pueue status
#438 - Add the
--priority/-o
flag topueue add
#429. This feature can be used to have easier control in which order tasks are executed. This was previously only possible viapueue switch
. - Add the
success
wait status. With this status,pueue
will exit with1
as soon as a single task fails. #434
- Fix broken bash autocompletion. Temporarily changes the name in the help texts to
pueue
andpueued
. #426 - Reword, extend and format most subcommand help texts.
- Don't fail on
follow
if a followed task exists but hasn't started yet. #436 - Fail with a
1
exit code, when a followed task disappears or doesn't exist in the first place. #436
- Fixed changes to stdout not being printed after each I/O copy when using
pueue follow
. #416
- Fixed missing newlines after
status
,log
andfollow
#414.
- Allow to wait for specific task state when using
pueue wait
#400.
- Point to a new patched fork of
darwin-libproc
, as the original has been deleted. This fixes the development builds for pueue on Apple platforms.
- Bump
command-group
to fix broken windows process handling #402
This release was planned to be a much smaller one, but you know how it's like.
A new major version is appropriate, as the process handling has been completely refactored. Thanks to the work of @mjpieters, Pueue now uses process groups to manage subprocesses, preventing detached processes by default! This also closes a long standing issue and brings the support for MacOs on par with Linux!
v3.0.0 also adds the long-requested feature to add a query/filter logic for the status
command and lots of other quality of life improvements.
The test coverage and development tooling has never been better, the project continues to improve!
- Tasks are now started in a process group, and
pueue kill
will kill all processes in the group #372. The--children
cli flag has been deprecated (signals go to the whole group, always). This brings pueue's task handling in line with how interactive shells handle jobs. As a side-effect it prevents detached processes and thereby covers the 90% usecase users usually expect.
pueue log
output now includes the task label, if any. #355- Enable
pueue edit
to edit multiple properties in one go.
- status querying!
pueue status
now implements the first version of a simple query logic. The filtering/order/limit logic is also applied to the--json
output. This allows you to:columns=id,status,path
select the exact columns you want to be shown.[column] [<|>|=|~] [value]
Apply various filters to columns. There's only a fix amount of operations on a small amount of columns available for now. If you need more filtering capabilities, please create an issue or a PR :).limit [last|first] 10
limit the results that'll be shown.order_by [column] [asc|desc]
order by certain columns.- For exact info on the syntax check the syntax file. I still have to write detailed docs on how to use it.
- Show a hint when calling
pueue log
if the task output has been truncated. #318 - Add
Settings.shared.alias_file
, which allows to set the location of thepueue_aliases.yml
file. - Added functionality to edit a task's label #354.
- Added the
created_at
andenqueued_at
metadata fields onTask
#356. They'll only be exposed when runningstatus --json
for now.
- Interpret the
$EDITOR
command, when editing a task's command/path, as a shell expression instead of an executable (#336). This gives users more control over how their editor should be started. - Don't show the version warning message between daemon and client, when using any
--json
flag. - Fix some test failures in non-standard environments for NixOS test suite (#346).
- The time in pueue's logs will now be in localtime instead of UTC #385.
- MacOs support has been brought on par with Linux.
- Continuation of testing the
pueue
client, pushing the test coverage from ~70% to ~73%. - A codecov.yml syntax error was corrected, which prevented Codecov from applying the repository-specific configuration.
- CI tests are now run using cargo nextest, for faster test execution, flaky test handling and better test output.
- The macos test suite is now the same as that for Linux, including the client and daemon test suites.
- Use the new
--color
command-line switch to control when pueue will use colors in its output. Fixes #311 by mjpieters. The default isauto
, which means it'll enable colors when connected to a TTY. The other options arenever
andalways
.
- Exit
pueue follow
when reading logs, as soon as the followed task is no longer active. - Properly formatted debug output.
- Hide
Task.envs
andAddMessage.envs
in debug output, as they were too verbose and contained possibly sensible information.
- Enable CI linting on all platforms (#323) by mjpieters.
- Add CI caching (#322) by mjpieters.
- Fix missing toolchain bug in CI (#321) by mjpieters.
- Set up code-coverage in CI.
- Tests suite for
pueue
client, pushing the test coverage from ~53% to ~70%.
- Return the correct path from
pueue_lib::settings::configuration_directories()
, when we get a path fromdirs::config_dir()
(was/home/<user>/.config/pueue.yaml/
, is now again/home/<user>/.config/pueue/
). - Use the correct path to delete the PID file during shutdown.
-
Use the
dirs
crate for platform specific directory discovery. #311 The previous trivial implementation was error prone in some edge-cases. For instance, Pueue fell back to the shared directory, if the$XDG_RUNTIME_DIR
couldn't be found. This resulted in a reocurrence of #302 in non-XDG environments.Furthermore, Pueue used the wrong directories for its configuration and cache on Apple and Windows platforms. This is now fixed.
This change is a bit tricky:
- It's a fix on one hand (correct directories for Apple & Windows + fix for #311).
- It's somewhat of a breaking change for Apple & Windows on the other hand?
I still decided to make this a patch release, as the next major release is still in the pipeline and needs a lot of work. #302 will still show up in Apple/Windows environments, as there doesn't seem to be runtime directory equivalent for those platforms.
- Better debug output for migration instructions from v1 to v2 #298.
- Better error output and error context for some filesystem related errors (continuation).
- Add a new option to specify the location of the
PID
file:shared.pid_path
#302.
- Some options weren't properly passed onto the forked daemon instance, when starting
pueued
with the-d
flag.- the
-vvv
flags - the
--profile
option.
- the
- Autocompletion shell scripts. Their generation is now also tested to prevent future regressions.
- Move the
PID
file into the runtime directory to prevent rare startup issues after crashes + reboot. #302. This won't cause any problems for running clients/daemons, making this a backward compatible change. - The
format-status
option now respects the order in which tasks piped back into pueue, as long as they're passed in list form #301. Tasks that're passed as a map will still be displayed in increasing order.
- Better error output and error context for filesystem related errors #239.
- Commands no longer inherit environment variables from the daemon process by drewkett #297. Previously, the daemon environment variables bled into the subprocesses.
This release marks the second stable release of Pueue.
Shortly after releasing v1.0.0
a few short-comings of some design decisions became apparent.
This release aims to remove all those short-comings or important missing features.
Some of those changes required breaking changes of both internal APIs and datastructures, as well as the CLI interfaces and the configuration file.
Since this project sticks to SemVer, this meant that a new major release was necessary.
Hopefully, this will be the last stable release for quite a while. There are a few features planned that might introduce further breaking changes, but those will most likely need quite some time to implement (if we manage to implement them at all).
Anyhow, I'm quite pleased with the overall state of this release! A lot of cool and convenient stuff has been added and quite a bit of internal logic has been streamlined and cleaned up.
Also a huge thanks to all contributors that helped working on this version!
- Shell auto-completion value hints for some arguments (zsh and fish only).
- Introduce the
rm
(remove),re
(restart) andfo
(follow) subcommand aliases #245. - Allow to set the amount of parallel tasks at group creation by Spyros Roum #245.
- When calling
pueue
without a subcommand, thestatus
command will be called by default #247. - Add the
--group
parameter to thepueue clean
command #248. - Add
output
for a task's log output as template parameters for callbacks #269. - Add
--lines
parameter topueue follow
to only show specified number of lines from stdout before following #270. - Notify the user if a task is added to a paused group #265.
- Notify the user that when killing whole groups, those groups are also paused #265.
- Implementation of configuration profiles #244.
This supports multiple profiles in a single
pueue.yml
, which can be loaded via the--profile/-p $name
flag. - Added the
shared.runtime_directory
config variable for any runtime related files, such as sockets. XDG_CONFIG_HOME
is respected for Pueue's config directory #243.XDG_DATA_HOME
is used if thepueue_directory
config isn't explicitly set #243.XDG_RUNTIME_DIR
is used if the newruntime_directory
config isn't explicitly set #243.- The unix socket is now located in the
runtime_directory
by default #243. - The
format-status
subcommand #213. This is a preliminary feature, which allows users to use external tools, such asjq
, to filter Pueue'sstate -j
output and pipe them back intoformat-status
to display it. This feature will probably be removed once a proper internal filter logic has been added.
The simplest usage looks like this:pueue status --json | jq -c '.tasks' | pueue format-status
- Show currently active commands when calling
pueue wait
.
- Improved memory footprint for reading partial logs.
- Always only show the last X lines of output when using
pueue log
without additional parameters. pueue parallel
without arguments now also shows the groups with their current limit likepueue group
. #264- Configuration files will no longer be changed programatically #241.
- Default values for all most configuration variables have been added #241.
- Breaking changes:
stderr
andstdout
of Pueue's tasks are now combined into a single file. This means a few things.- One doesn't have to filter for stderr any longer.
- All logs are now combined in a single chronologically correct log file.
- One can no longer filter for stderr/stdout specific output.
- Breaking changes: The
group
subcommand now hasgroup add [-p $count] $name
andgroup remove $name
subcommands. The oldgroup [-a,-p,-r]
flags have been removed. - Breaking changes: The configuration for groups can no longer be done via configuration file.
This means, that groups can only be edited, created or deleted via the commandline interface.
The amount of parallel tasks will also be reset to
1
when upgrading.
- No longer read
/etc/pueue/
configuration files. Pueue isn't designed as a system wide service, hence this doesn't make any sense to have system wide configuration files. - If multiple configuration files are found, they're no longer merged together. Instead, only the first file will be used.
- Recover tasks from
Locked
state if editing fails #267 pueue log
now behaves the same for local and remote logs. Remote logs previously showed more lines under some circumstances.- panic due to rogue
.unwrap()
when filtering for a non-existing group inpueue status
.
- The
--after
flag on add no longer accepted multiple parameters. This was due to a change in Clap's API in their bump from beta to full v3 release.
- Update to stable clap v3.0.
- Panic instead of loop endlessly, if
task_log
directory disapears.
- Hard panic of the daemon, when one tries to switch a task with itself #262.
- The
default
group wasn't created, if thepueue.yml
config file didn't contain it. #242. This lead to crashes and undefined behavior in the daemon and the client. This bug was introduced in1.0.0
due to changes to the internal datastructures and several added features. It only popped up now, due to #236 being fixed, as the config is now being correctly used. This only affects users with quite old pueue configs or custom config files.
This feature wasn't supposed to be added to v1.0.2 and breaks semantic versioning. I'm still getting used to this, sorry for any inconveniences.
- Add the
--working-directory
parameter to thepueue add
command #227.
- Settings weren't always read on daemon restart. #236.
This bug was introduced in
1.0.0
due to large-scale refactorings and insufficient testing.
- Update to clap
v3.0.0-beta.4
. The upgrade from beta.2 to beta.4 introduced breaking changes, which lead to compiler errors when doing acargo install
without a--locked
. A beta upgrade seems to be handled like a patch version in semantic versioning. This isn't a bug per se, but it leads to confusion when people forget the--locked
flag during install.
A lot of things happened during this release. Even though quite a few new features were added, the main effort went into increasing stability and inter-version compatibility.
The goal of this release is to push the code quality, error handling, test coverage and stability to a level that justifies a v1.0 release.
Since this project follows semantic versioning, this includes no breaking changes and backward compatibility on minor version upgrades.
This also means that I'm quite certain that there are no critical bugs in the project and that all important and planned features have been implemented.
Unless some critical issues pop up, this can be seen as a finished version of the project!
Disclaimer: This project is mainly developed for Linux.
Windows and MacOS/Apple platforms are partially supported, but this is a community effort.
Thereby, v1.0 might be misleading for those.
I hope you understand, that I cannot wait for someone to implement missing features for these platforms.
I want this project to move forward.
~
is respected in configuration paths by dadav for #191.- Use
pueue kill --signal SigTerm
to send Unix signals directly to Pueue's processes. #202 - Support for other
apple
platforms. New build artifacts forios-aarch64
. - Option in config file to use the
--in-place
flag onrestart
by default. --failed-in-group [group_name]
forrestart
. That way you can restart all failed tasks of a specific group #211- Options in config file to configure the time and datetime format in
pueue status
for #212. - Add a worker pool representation for groups to Pueue #218.
The task's group name and the pool's worker id for a given task are then injected into the environment variables of the subprocess.
This allows users to map Pueue's internal group and worker logic to external resources:
./run_on_gpu_pool --gpu $PUEUE_WORKER_ID --pool $PUEUE_GROUP`
- The last lines of
stderr
andstdout
are now available in the callback command. #196. - Add
callback_log_lines
setting for the daemon, specifying the amount of lines returned to the callback. #196. - Add a PID file to
$pueue_directory/pueue.pid
, which will be used to check whether there's an already running daemon.
- Use the next available id instead of constantly increasing id's.
This results in ids being reused, on
pueue clean
orpueue remove
of the last tasks in a queue. - Show the date in
pueue status
for thestart
andend
fields, if the task didn't start today. - Backward compatible protocol for stable version changes with
serde_cbor
. - Detection of old daemon versions during client->daemon handshake.
- Overall better debug messages.
- Use tokio's async runtime and set a hardcoded limit of 4 worker threads, which is already more than enough.
- Add a debug message, when using
pueue wait
orpueue wait -g some_group
and there're no tasks in the group. - Stabilized internal daemon shutdown and restoration logic.
- Rename
Index
toId
inpueue status
to free up screen space. - Remove
Exitcode
column inpueue status
and include exitcode intoFailed
status to free up screen space. - You can no longer remove groups, if there are still tasks assigned to that group.
- A non-zero exit code will be returned, if no tasks were affected by an action.
A whole lot of Pueue's internal datastructures have been refactored. The main goal of this was to prevent impossible/invalid states wherever possible.
Overall, this resulted in sleaker und much better maintainable code. However, this broke backwards compatibility to pre-v1.0 at numerous places.
- Json structure of the
Task
struct changed significantly, as data depending on the current status has been moved into theTaskStatus
enum. - Many messages have been touched, as several new enums have been introduced and many fields have been removed.
- Handle very rare race-condition, where tasks with failed dependencies start anyway.
pueue log --json
now works again. #186 By default, only a few lines of output will be provided, but this can be configured via the--full
and--lines
option.- Use crossbeam's mpsc channels, resulting in faster execution of user's instructions.
- Fix issue where the daemon was shutting down so fast, there wasn't enough time to respond the client that it's actually shutting down.
- Removed the
enqueue
parameter from callback, as the callback is only run for finished tasks.
- Remove task logs on
pueue remove
. #187 - Improve Windows support by oiatz. #114
- Fix empty output for empty groups when requesting specific group with
status -g $name
. #190 - Fix missing output when explicitly requesting default group with
status -g default
. #190
- Dependant tasks didn't update the id of their dependencies, if a dependency's id was changed via
pueue switch
#185
- Show the status of the default group, if there are no tasks in the queue.
Info for all packagers:
In case you updated your packaging rules for the new layout in v0.11, those changes need to be reverted.
The new repository layout with workspaces didn't work out that well.
Managing two crates in a single repository in combination with cargo release
turned out to be quite annoying.
--all-failed
flag forrestart
. This will restart all tasks that didn't finish with aSuccess
status. #79- New config option
client.dark_mode
by Mephistophiles. #178 Default:false
. Adds the ability to switch to dark colors instead of regular colors.
- Rename/change some flags on the
restart
subcommand.- Rename
--path
to--edit-path
. The short flag stays the same (p
). - Rename the short flag for
--start-immediately
to-k
.
- Rename
- Dependency bump to pueue-lib
v0.12.1
-s
flag overload on therestart
command.--start-immediately
and--stashed
collided.- Error on BSD due to inability to get username from system registry. #173
- Readability of the
log
command has been further improved. - Dependency bump to pueue-lib
v0.11.2
- Wrong version (
pueue-v0.11.0-alpha.0
) due to an error in the build process with the new project structure. #169
- Add the
--lines
flag to thelog
subcommand. This is used to only show the last X lines of each task's stdout and stderr. - Add the
--full
flag to thelog
subcommand. This is used to show the whole logfile of each task's stdout and stderr. - Add the
--successful-only
flag to theclean
subcommand. This let's keep you all important logs of failed tasks, while freeing up some screen space.
- If multiple tasks are selected,
log
now only shows the last few lines for each log. You can use the new--full
option to get the old behavior.
- It was possible to remove tasks with active dependants, i.e. tasks which have a dependency and didn't finish yet. This didn't lead to any crashes, but could lead to unwanted behavior, since the dependant tasks simply started due to the dependency no longer existing. It's however still possible to delete dependencies as long as their dependants are deleted as well.
- panic, when using
pueue status
and only having tasks in non-default groups.
This release adds a lot of breaking changes! I tried to clean up, refactor and streamline as much code as possible.
v0.10.0
aims to be the last release before hitting v1.0.0.
From that point on I'll try to maintain backward compatibility for as long as possible (v2.0.0).
Please read this changelog carefully.
- Use TLS encryption for all TCP communication. #52
- Updated Crossterm and thereby bump the required rust version to
1.48
. - Extract the shared
secret
into a separate file. #52 This will allow users to publicly sync their config directory between machines. - Change default secret length from 20 to 512 chars. #52
- Lots of internal code cleanup/refactoring/restructuring.
- Exit client with non-zero exit code when getting a failure message from the daemon.
- The
group
list output has been properly styled. - Use unix sockets by default on unix systems. #165
- Any unix socket code or configuration stuff has been removed, when building for Windows.
- Add the
shared.host
configuration variable. #52 This finally allows to accept outside connections, but comes with some security implications. - Create a self-signed ECDSA cert/key for TLS crypto with rcgen. #52
- Error messages have been improved in many places.
daemon.pause_all_on_failure
config, which actually pauses all groups as soon as a task fails.daemon.pause_group_on_failure
config, which only pauses the group of the affected task instead of everything.- Users can add some additional information to tasks with the
task add --label $LABEL
option, which will be displayed when callingpueue status
. #155 --escape
flag on theadd
subcommand, which takes all given Parameter strings and escapes special characters. #158- Remove
--task-ids
forwait
. Now it's used the same way as start/kill/pause etc. - Add an option
--print-task-id
to only return the task id onadd
. This allows for better scripting. #151
- Removed the
daemon.pause_on_failure
configuration variable in favor of the other two previously mentioned options. - Removed the
--port
and--unix-socket-path
cli flags on client in favor of the--config
flag. - Removed the
--port
flag on the daemon in favor of the--config
flag.
- Properly pass
--config
CLI argument to daemonizedpueued
instance. - The
--default
flag on thekill
command has been removed, since this was the default anyway. That makes this command's behavior consistent with thestart
andpause
command. - Allow the old
kill [task_ids...]
behavior. You no longer need the-t
flag to kill a tasks. This broke in one of the previous refactorings.
- The default group is now an actual group.
- The
wait
subcommand. This allows you to wait for all tasks in the default queue/ a specific group to finish. #117 On top of this, you can also specify specific tasks ids. - New client configuration
show_expanded_aliases
(default:false
). Determines whether the original input command or the expanded alias will be shown when callingstatus
. - New
--in-place
option forrestart
, which resets and reuses the existing task instead of creating a new one. #147
- Don't update the status of tasks with failed dependencies on paused queues.
This allows to fix dependency chains without having to restart all tasks in combination with the
pause_on_failure
and the new--in-place
restart option.
pause_on_failure
pauses the group of the failed tasks. Previously this always paused the default queue.- Properly display version when using
-V
. (#143) - Execute callbacks for tasks with failed dependencies.
- Execute callbacks for tasks that failed to spawn at all.
- Persist state changes when handling tasks that failed to spawn.
- Set proper start/end times for all tasks that failed in any way.
- The original user command will be used when editing a task's command. As a result of this, aliases will be re-applied after editing a command.
- Add
exit_code
parameter to callback hooks. (#138) - Add a confirmation message when using
reset
with running tasks by quebin31. #140
- Update to beta branch of Clap v3. Mainly for better auto-completion scripts.
- Add
start
,end
andenqueue
time parameters to callback hooks by soruh. - Config flag to truncate content in 'status'. (#123)
- ZSH completion script fix by ahkrr.
This version adds breaking changes:
- The configuration file structure has been changed. There's now a
shared
section. - The configuration files have been moved to a dedicated
pueue
subdirectory.
- Unix socket support #90
- New option to specify a configuration file on startup for daemon and client.
- Warning messages for removing/killing tasks #111 by Julian Kaindl
- Better message on
pueue group
, when there are no groups yet. - Guide on how to connect to remote hosts via ssh port forwarding.
- Move a lot of documentation from the README and FAQ into Github's wiki. The docs have been restructured at the same time.
- Never create a default config when starting the client. Only starting the daemon can do that.
- Better error messages when connecting with wrong secret.
- Windows: The configuration file will now also be placed in
%APPDATA%\Local\pueue
.
- Fixed panic, when killing and immediately removing a task. #119
- Fixed broken non-responsive daemon, on panic in threads. #119
- Don't allow empty commands on
add
. - The client will never persist/write the configuration file. #116
- The daemon will only persist configuration file on startup, if anything changes. #116
- (Probably fixed) Malformed configuration file. #116
- Non-existing tasks were displayed as successfully removed. #108
- Remove child process handling logic for MacOs, since the library simply doesn't support this.
- Remove unneeded
config
features and reduce compile time by ~10%. Contribution by LovecraftianHorror #112 - Remove futures-timers, effectively reducing compile time by ~14%. #112
- Update to comfy-table v1.1.0, reducing compile time by another ~10%. #112
- Linux process handling now always sends signals to its direct children, if the root process is a
sh -c
process. Previously, this behavior was somewhat ambiguous and inconsistent. #109
- Update workflow to build arm binaries.
- New
-e
and-p
flags to edit tasks on restart.-e
forcommand
,-p
forpath
. Both can be added at the same time.
- Internal refactoring of the client code. Mostly structure.
- Improved CLI validation. Several subcommands accepted empty task id vectors, when they shouldn't.
- Don't do any code styling, if
stdout
is no tty.
- Fix local
stderr
formatting forlog
. - Fix missing sleep in local
follow
loop, resulting in single core 100% CPU usage.
- New default behavior for
follow
. Implemented by JP-Ellis. - Delete everything in Pueue's
task_logs
folder onreset
.
pueue_aliases.yml
, which allows some shell-like aliasing.-c
flag forkill
andreset
.
--children/-c
flag forstart
andstop
. This sends theSIGSTOP
/SIGSTART
signal not only to the main process of a task, but also to direct children. This is, for instance, useful if you're starting tasks via a shell script.
- Fixed formatting bug in
pueue log
. Fixed by sourcefrog.
- Groups! Tasks can now be assigned to a group. Each group acts as their own queue and each group has their own setting for parallel task execution. Groups can also be paused/resumed individually.
- Added
--group
flag forstatus
. This will only print tasks of a specific group - Add new flags
--default
tokill
. With this flag only tasks in the default queue will be affected. - Users can now specify a custom callback that'll be called whenever tasks finish.
- Environment variable capture. Tasks will now start with the variables of the environment
pueue add
is being called in.
log
now also works on running and paused tasks. It thereby replaces some ofshow
's functionality.- Rename
show
tofollow
. Thefollow
is now only for actually following the output of a single command. follow
(previouslyshow
) now also reads directly from disk, ifread_local_logs
is set totrue
.- The
--all
flag now affects all groups AND the default queue forkill
,start
andpause
.
- Dependencies! This adds the
--after [ids]
option. Implemented by tinou98. Task with this option will only be started, if all specified dependencies successfully finish. Tasks with failed dependencies will fail as well. - New state
FailedToStart
. Used if the process cannot be started. - New state
DependencyFailed
. Used if any dependency of a task fails. - New config option
read_local_logs
. Default:true
We assume that the daemon and client run on the same machine by default. This removes the need to send logs via socket, since the client can directly read the log files. Set tofalse
if you, for instance, use Pueue in combination with SSH port forwarding.
- Pueue no longer stores log output in its backup files.
- Process log output is no longer permanently stored in memory. This significantly reduced RAM usage for large log outputs. Huge thanks for helping with this to sourcefrog!
- Process log output is compressed in-memory on read from disk. This leads to reduced bandwidth and RAM usage.
- Set
start
for processes. (Seems to have broken in 0.2.0)
pause_on_failure
configuration flag. Set this to true to pause the daemon as soon as a task fails.- Add
--stashed
flag torestart
. - Add
-p/--path
flag to allow editing of a stashed/queued task's path. - Better network utilization for
pueue log
.
- Respect
Killed
tasks onpueue clean
. - Show
Killed
status inpueue log
. - Fix
pueue log
formatting. - Show daemon status if no tasks exist.
- Better error messages when daemon isn't running.
- New
--delay
flag, which delays enqueueing of a task. Can be used onstart
andenqueue
. Implemented by taylor1791. --stashed
flag forpueue add
to add a task in stashed mode. Implemented by taylor1791.
- Generating completion files moved away from build.rs to the new
pueue completions {shell} {output_dir}
subcommand. This seems to be the proper way to generate completion files with clap. There is abuild_completions.sh
script to build all completion files to the known location for your convenience.
- Fix
edit
command. - Several wrong state restorations after restarting pueue.
- [BUG] Fix wrong TCP receiving logic.
- Automatically create config directory.
- Fix and reword cli help texts.
- Basic Windows support. Huge thanks to Lej77 for implementing this!
- Integrate completion script build in
build.rs
.
- Dependency updates
- Change table design of
pueue status
.
- Handle broken UTF8 in
show
with-f
and-e
flags. - Allow restart of
Killed
processes.
- Add --daemonize flag for daemon to daemonize pueued without using a service manager.
- Add
shutdown
subcommand for client for being able to manually kill the pueue daemon.
- Replace prettytables-rs with comfy-table.
- Replace termion with crossterm.