mirror of
https://git.asonix.dog/asonix/pict-rs
synced 2024-12-22 11:21:24 +00:00
Add Logging, Quality, Read-Only, and Danger-Dummy documentation
This commit is contained in:
parent
7d8858f57c
commit
0ee92b2aa1
1 changed files with 28 additions and 0 deletions
|
@ -337,15 +337,43 @@ request to be rejected with a 400 Bad Request error.
|
||||||
|
|
||||||
### Logging Verbosity
|
### Logging Verbosity
|
||||||
|
|
||||||
|
pict-rs 0.5 no longer logs the opening and closing of tracing spans. This means the logs will now
|
||||||
|
be mostly empty aside from the occasional warning or error. Errors should still provide ample debug
|
||||||
|
information, so the decrease in verbosity should not negatively affect debugging of the program.
|
||||||
|
|
||||||
|
|
||||||
### Quality Configuration
|
### Quality Configuration
|
||||||
|
|
||||||
|
pict-rs 0.5 now supports configuring the quality and compression of transcoded media. New
|
||||||
|
configuration sections have been introduced to allow setting values for each image format
|
||||||
|
individually, as well as individual quality settings for different video resolutions.
|
||||||
|
|
||||||
|
For the specifics of quality configuration, see the example
|
||||||
|
[pict-rs.toml](https://git.asonix.dog/asonix/pict-rs/src/branch/main/pict-rs.toml).
|
||||||
|
|
||||||
|
|
||||||
### Read-Only Mode
|
### Read-Only Mode
|
||||||
|
|
||||||
|
pict-rs 0.5 has gained the ability to run in a "read-only" mode, which will forbid the application
|
||||||
|
from accepting new uploaded media, creating new media variants, or updating any metadata. This is
|
||||||
|
useful for complex environments that are capable of running a copy of the pict-rs application while
|
||||||
|
performing maintenance on the "real" deployment.
|
||||||
|
|
||||||
|
For configuration information, see the example
|
||||||
|
[pict-rs.toml](https://git.asonix.dog/asonix/pict-rs/src/branch/main/pict-rs.toml).
|
||||||
|
|
||||||
### Danger-Dummy Mode
|
### Danger-Dummy Mode
|
||||||
|
|
||||||
|
pict-rs 0.5 can now run without any external dependencies in "Danger-Dummy Mode." This allows
|
||||||
|
uploading and serving media, but all of the metadata for that media will be fake default values, and
|
||||||
|
the media cannot be processed in any way. This is not intended for production uses, since generic
|
||||||
|
file stores (like directly using object storage) are more tailored for this use case. Instead, this
|
||||||
|
is provided to enable applications to perform integration tests with pict-rs without needing to
|
||||||
|
reconstruct a valid environment to run the application.
|
||||||
|
|
||||||
|
For configuration information, see the example
|
||||||
|
[pict-rs.toml](https://git.asonix.dog/asonix/pict-rs/src/branch/main/pict-rs.toml).
|
||||||
|
|
||||||
|
|
||||||
### Media Variant Retention
|
### Media Variant Retention
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue