Updated Troubleshooting (markdown)

master
Chris Caron 2022-12-02 09:38:04 -05:00
parent 369e428db7
commit edb790ac29
1 changed files with 75 additions and 0 deletions

@ -9,6 +9,7 @@
* [Formatting Issues](#formatting-issues)
* [Apprise URLs on Command Line Do Not Behave Correctly](#apprise-urls-on-command-line-do-not-behave-correctly)
* [PyInstaller Support](#pyinstaller-support)
* [Docker Instance](#docker-instance)
* [General Exceptions and/or Messages](#general-exceptions-andor-messages)
* [RuntimeError: asyncio.run() cannot be called from a running event loop
](#runtimeerror-asynciorun-cannot-be-called-from-a-running-event-loop)
@ -266,6 +267,80 @@ pyinstaller -F --collect-all apprise myscript.py
No more errors, notifications are sent.
## Docker Instance
A lot of us might use Apprise through a third party application. When we put in our URL's, we question why they don't work. We wonder where the logging is (As every third party program does things differently). Here is a way you can test your Apprise URL's outside of this application in efforts to get everything the way you want:
You'll need to just do 2 things:
1. Pick a [Python version to test with](https://hub.docker.com/_/python); in the below example, we use the `:latest`. But you can also use things like `:3.8.10`.
1. Pick a version of Apprise you want to test/install. In this case you can use the stable releases straight from PyPi, or you can use the master branch on Github.
Here is the `Dockerfile` at it's simplest that you need to create:
```dockerfile
##
## First define your Base - un-comment only ONE `FROM` line below for a specific
## version otherwise use the one already set to grab the latest version of Python
##
FROM 3-buster
# FROM python:3.10-buster
# FROM python:3.9-buster
# FROM python:3.8-buster
# FROM python:3.7-buster
# FROM python:3.6-buster
## You can also pull from specific versions of Python such as:
# FROM python:3.8.10-buster
##
## The following provides the basics
##
RUN apt-get update && \
apt-get install -y libgirepository1.0-dev build-essential musl-dev bash
##
## Now we install Apprise, there are several ways to do this. Un-comment
## The one you want obtain and comment out the others
##
## Obtain the latest stable branch
RUN pip install apprise
## Obtain a specific version of Apprise
# RUN pip install "apprise==1.2.0"
## Use the master branch from GitHub:
# RUN pip install "https://github.com/caronc/apprise.git"
## Use a specific branch you want to test
RUN pip install "https://github.com/caronc/apprise.git@branch"
```
Next we need to build our docker container we set up the blueprints for above:
```bash
##
## Build Your Config
##
# Now build;
docker build --tag=apprise-test
# -OR- Use the following if your file you defined above wasn't called 'Dockerfile'
docker build --tag=apprise-test - < YourDockerConfigFile
##
## Test your config
##
# The below will run your schema:// that you wish to test
docker run -it apprise-test apprise -vvv -t "Test" -b "Message" "schema://credentials"
# Alternatively you can acquire a shell and call apprise from within there:
docker run -it apprise-test bash
# At this point you'll be inside your container, you can just call `apprise`
# from here.
```
## General Exceptions and/or Messages
### RuntimeError: asyncio.run() cannot be called from a running event loop