Re-opened PR (#696): Add aioapns version of APNS

.github/workflows/test.yml

@@ -9,7 +9,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.7', '3.8', '3.9']
+        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11']
 
     steps:
     - uses: actions/checkout@v2

README.rst

@@ -37,6 +37,7 @@ Dependencies
 - For WebPush (WP), pywebpush 1.3.0+ is required (optional). py-vapid 1.3.0+ is required for generating the WebPush private key; however this
   step does not need to occur on the application server.
 - For Apple Push (APNS), apns2 0.3+ is required (optional).
+- For Apple Push (apns-async) using async, aioapns 3.1+ is required (optional). Installed aioapns overrides apns2 which does not support python 3.10+.
 - For FCM, firebase-admin 6.2+ is required (optional).
 
 Setup
@@ -45,7 +46,7 @@ You can install the library directly from pypi using pip:
 
 .. code-block:: shell
 
-	$ pip install django-push-notifications[WP,APNS,FCM]
+	$ pip install django-push-notifications[WP,apns-async,FCM]
 
 
 Edit your settings.py file:
@@ -207,6 +208,37 @@ JSON example:
 	device.send_message(data)
 
 
+Web Push accepts only one variable (``message``), which is passed directly to pywebpush. This message can be a simple string, which will be used as your notification's body, or it can be contain `any data supported by pywebpush<https://github.com/web-push-libs/pywebpush>`.
+
+Simple example:
+
+.. code-block:: python
+
+	from push_notifications.models import WebPushDevice
+
+	device = WebPushDevice.objects.get(registration_id=wp_reg_id)
+
+	device.send_message("You've got mail")
+
+.. note::
+	To customize the notification title using this method, edit the ``"TITLE DEFAULT"`` string in your ``navigatorPush.service.js`` file.
+
+JSON example:
+
+.. code-block:: python
+
+	import json
+	from push_notifications.models import WebPushDevice
+
+	device = WebPushDevice.objects.get(registration_id=wp_reg_id)
+
+	title = "Message Received"
+	message = "You've got mail"
+	data = json.dumps({"title": title, "message": message})
+
+	device.send_message(data)
+
+
 Sending messages in bulk
 ------------------------
 .. code-block:: python