Add FAQ and README

This commit is contained in:
Arne Beer 2020-02-02 14:35:45 +01:00
parent ce25516bef
commit b59121e3ed
2 changed files with 60 additions and 1 deletions

52
FAQ.md Normal file
View file

@ -0,0 +1,52 @@
# Frequently Asked Questions
## The Project Does Not Compile:
Do you have Rust version `>=1.39` installed?
If that's not the case, there should also be warning at the very top of your `cargo build` output.
If you have Rust version `>=1.39`, please file a bug report.
## A Command Doesn't Behave Like Expected
Pueue only executes specified commands.
First thing to do when debugging any problems with running/failing processes, is to look at the process output:
This can be done via `pueue log $task_id` for finished processes or `pueue show $task_id` for running processes.\
You can also get a live view of the output with `pueue show -f $task_id` for `stdout` and `-e` for `stderr`.
### The Command Formatting Seems To Be Broken:
Pueue takes your input and uses it exactly as is to create a new `bash -c $command` in the background.\
If your command contains spaces or characters that need escaping, you might need to encapsulate it into a string:
```
pueue add "ls -al /tmp/this\ is\ a\ test\ directory"
```
Without quotes, the character escaping won't be transferred to the `bash -c $command`, as it's already removed by calling it from the current shell.
### A Process Waits For Input:
Sometimes some process waits for input. For instance, a package manager may wait for confirmation (`y/n`).\
In this case you can send the desired input to the process via:
```
pueue send "y
"
```
This can be also be avoided by issuing the command with something like a `-y` flag (if it allows something like this),
you see that a process waits for input, you can
### My Shell Aliases Don't Work:
This is a known problem.
Since pueue calls a new shell session without any parameters, existing `.bashrc` won't be read.
However, reading `.bashrc` files turns out to be problematic as well.
Pueue might add a feature for custom shell commands somehwere in the future, but this isn't working for now.

View file

@ -23,9 +23,14 @@ It provides functionality for:
- Scheduling commands that will be executed in their respective working directories
- Easy output inspection.
- Interaction with running processes
- Pausing/Resuming tasks, when you need some processing power right NOW!
- Manipulation of the scheduled task order
- Running multiple tasks at once (You can decide how many concurrent tasks you want to run)
- Works on Linux and MacOs (Windows might work, but I need people for testing ;) )
- Works on Linux and MacOS and partially on Windows.
**Disclaimer:** Windows support is highly experimental right now.
Pueue uses `powershell` to execute commands, keep this in mind when writing commands.
Starting/resuming commands doesn't work for now.
**Pueue has been rewritten in Rust!!** If you want the old version that's build with python, please install via pip.
@ -101,6 +106,8 @@ The command will then be added and scheduled for execution, as if you executed i
To get the status of currently running commands, just type `pueue status`.
To avoid common pitfalls, please read the [FAQ Section](https://github.com/Nukesor/pueue/blob/master/FAQ.md).
There is a help option (-h) for all commands.
```