Updated persistent_storage (markdown)

Chris Caron 2024-08-23 16:12:33 -04:00
parent acd1de43a5
commit 8863ccd024

@ -6,6 +6,7 @@ For things like:
- The Matrix plugin: persistent cache allows login information to be cached locally for re-use (saving extra API calls to authenticate again each time). - The Matrix plugin: persistent cache allows login information to be cached locally for re-use (saving extra API calls to authenticate again each time).
- The Telegram plugin: persistent cache allows Apprise to remember your user account saving extra fetches to the service to determine it each and every time. - The Telegram plugin: persistent cache allows Apprise to remember your user account saving extra fetches to the service to determine it each and every time.
Aditional Notes:
- Apprise stores all of it's persistent data in it's own directory unique to the Apprise URL you create. By default all directories are 8 characters in length and a combination of letters an numbers. - Apprise stores all of it's persistent data in it's own directory unique to the Apprise URL you create. By default all directories are 8 characters in length and a combination of letters an numbers.
- All Apprise persistent files have a `.psdata` extension and are written to a cache directory chosen by you otherwise it defaults to the locations provided by your operating system. - All Apprise persistent files have a `.psdata` extension and are written to a cache directory chosen by you otherwise it defaults to the locations provided by your operating system.
@ -21,7 +22,7 @@ All Apprise URLs you define have a URL ID generated against them (`uid`). To se
apprise --dry-run --all apprise --dry-run --all
``` ```
The output may look like this:<br/> The output may look like this:<br/>
![Screenshot from 2024-08-22 21-06-24](https://github.com/user-attachments/assets/0ae95125-a9f0-40d6-8d1b-5c754b616dec) ![Screenshot from 2024-08-22 21-06-24](https://github.com/user-attachments/assets/4df2f5c5-2b89-41d7-95c9-33c059e514a1)
Once you know the UID, you know the directory your persistent data can be found in. The takeaway from the screenshot above is: Once you know the UID, you know the directory your persistent data can be found in. The takeaway from the screenshot above is:
1. Some plugins simply do not utilize persistent storage at all (denoted with `- n/a -`). 1. Some plugins simply do not utilize persistent storage at all (denoted with `- n/a -`).
@ -34,6 +35,7 @@ apprise storage
``` ```
The output may look like this:<br/> The output may look like this:<br/>
![Screenshot from 2024-08-22 21-27-39](https://github.com/user-attachments/assets/2383d487-b873-4290-960e-c2e360565771) ![Screenshot from 2024-08-22 21-27-39](https://github.com/user-attachments/assets/2383d487-b873-4290-960e-c2e360565771)
The takeaway from the screenshot above is this is another way of looking at the storage and how it's been assigned to the URLs. The takeaway from the screenshot above is this is another way of looking at the storage and how it's been assigned to the URLs.
- You can see the grouping of multiple URLs sharing the same storage endpoint is also listed here. - You can see the grouping of multiple URLs sharing the same storage endpoint is also listed here.
- It will identify the current amount of disk storage you have in use for the given plugin as well - It will identify the current amount of disk storage you have in use for the given plugin as well