feat: add pushplus,showdoc,xizhi

Author: jetsung

README.md

@@ -1,6 +1,6 @@
 # ipush
 
-APP 推送通知。支持往 **钉钉群、飞书群、Lark 群、Bark、Chanify、PushDeer** 推送消息。
+APP 推送通知。支持往 **钉钉群、飞书群、Lark 群、Bark、Chanify、PushDeer、PushPlus、Showdoc、息知** 推送消息。
 
 ## 使用说明
 
@@ -31,14 +31,18 @@ notify.send("ipush test")
 | ✔ **荐** | **Bark**          | [https://day.app/2021/06/barkfaq/](https://day.app/2021/06/barkfaq/)                                      | -    | 仅支持 `iOS` |
 | ✔        | **Chanify**       | [https://www.chanify.net/](https://www.chanify.net/)                                                      | -    | 仅支持 `iOS` |
 | ✔        | **PushDeer**      | https://www.pushdeer.com/                                                                                 | -    |              |
+| //       | //                | **基于微信公众号**                                                                                        | \\\\ | \\\\         |
+| ✔        | **PushPlus**      | [https://www.pushplus.plus/](https://www.pushplus.plus/doc)                                               | -    |              |
+| ✔        | **Showdoc**       | [https://push.showdoc.com.cn/](https://www.showdoc.com.cn/push)                                           | -    |              |
+| ✔        | **息知**          | [https://xz.qqoq.net/](https://xz.qqoq.net/)                                                              | -    |              |
 
 ## 开发
 
-### 前置环境
+### 1. 前置开发环境
 
 1. 使用 [**Rye**](https://rye-up.com/) 作为包管理工具
 
-### 开发
+### 2. 开发流程
 
 1. 安装依赖包：
 

docs/README.md

@@ -2,7 +2,15 @@
 
 ## 使用
 
-1. **钉钉群**
+### 1. 安装
+
+```python
+pip install ipush
+```
+
+### 2. 代码示例
+
+- **钉钉群**
 
 ```python
 from ipush.notify.dingtalk import Dingtalk
@@ -11,7 +19,7 @@ notify = Dingtalk("token", "secret")
 notify.send("ipush test")
 ```
 
-2. **飞书群**
+- **飞书群**
 
 ```python
 from ipush.notify.feishu import Feishu
@@ -20,7 +28,7 @@ notify = Feishu("token", "secret")
 notify.send("ipush test")
 ```
 
-3. **Lark 群**
+- **Lark 群**
 
 ```python
 from ipush.notify.lark import Lark
@@ -29,18 +37,18 @@ notify = Lark("token", "secret")
 notify.send("ipush test")
 ```
 
-4. **Bark**
+- **Bark**
 
 ```python
 from ipush.notify.bark import Bark
 
 notify = Bark("token")
-notify.send("ipush test")
+notify.send("ipush test", "title")
 notify.seturl("https://self-hosted")
 notify.send("ipush test custom url")
 ```
 
-5. **Chanify**
+- **Chanify**
 
 ```python
 from ipush.notify.chanify import Chanify
@@ -51,7 +59,7 @@ notify.seturl("https://self-hosted")
 notify.send("ipush test custom url")
 ```
 
-6. **PushDeer**
+- **PushDeer**
 
 ```python
 from ipush.notify.pushdeer import PushDeer
@@ -61,3 +69,30 @@ notify.send("ipush test")
 notify.seturl("https://self-hosted")
 notify.send("ipush test custom url")
 ```
+
+- **PushPlus**
+
+```python
+from ipush.notify.pushplus import PushPlus
+
+notify = PushPlus("token")
+notify.send("ipush test", "title")
+```
+
+- **Showdoc**
+
+```python
+from ipush.notify.showdoc import Showdoc
+
+notify = Showdoc("token")
+notify.send("ipush test", "title")
+```
+
+- **Xizhi**
+
+```python
+from ipush.notify.xizhi import Xizhi
+
+notify = Xizhi("token")
+notify.send("ipush test", "title")
+```

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "ipush"
-version = "0.2.0"
-description = "Push for python"
+version = "0.3.0"
+description = "APP 推送通知。支持往 钉钉群、飞书群、Lark 群、Bark、Chanify、PushDeer、PushPlus、Showdoc、息知 推送消息。"
 authors = [
     { name = "Jetsung Chan", email = "[email protected]" }
 ]
@@ -10,27 +10,34 @@ dependencies = [
     "lxml>=4.9.4",
 ]
 readme = "README.md"
+license ={ file = "LICENSE" }
+keywords = ["push", "notify", "dingtalk", "feishu", "lark", "bark", "chanify", "pushdeer", "pushplus", "showdoc", "xizhi"]
 requires-python = ">= 3.8"
 classifiers = [
     'Development Status :: 4 - Beta',
     'Environment :: Console',
+    'Environment :: Web Environment',
     'Intended Audience :: Developers',
     'License :: OSI Approved :: Apache Software License',
     'Natural Language :: Chinese (Simplified)',
     'Operating System :: OS Independent',
     'Programming Language :: Python',
+    'Programming Language :: Python :: 3',
+    'Programming Language :: Python :: 3.8',
     'Programming Language :: Python :: 3.8',
     'Programming Language :: Python :: 3.9',
     'Programming Language :: Python :: 3.10',
     'Programming Language :: Python :: 3.11',
     'Programming Language :: Python :: 3.12',
-    'Programming Language :: Python :: 3.13',
+    'Programming Language :: Python :: 3 :: Only',
+    'Programming Language :: Python :: Implementation :: CPython',
     'Topic :: Communications :: Email',
+    'Topic :: Software Development :: Libraries',
 ]
 [project.urls]
 Homepage = "https://git.jetsung.com/idev/pypush"
-Documentation = "https://framagit.org/idev/pypush"
-Repository = "https://framagit.org/idev/pypush.git"
+Documentation = "https://pypush.skiy.net/"
+Repository = "https://github.com/idevsig/pypush"
 
 [build-system]
 requires = ["hatchling"]

src/ipush/notify/bark.py

@@ -13,24 +13,24 @@ def __init__(self, token=''):
         self.token = token
         self.url = 'https://api.day.app'
 
-    def signature(self):
+    def _signature(self):
         pass
 
     def seturl(self, url):
         self.url = url
 
-    def requrl(self):
+    def _geturl(self):
         """
         生成请求的 URL
         """
         return f'{self.url}/push'
 
-    def send(self, message):
+    def send(self, message, title=''):
         """
         发送通知
         :param message: 消息内容
         """
-        req_url = self.requrl()
+        req_url = self._geturl()
 
         headers = {
             'content-type': 'application/json',
@@ -39,6 +39,7 @@ def send(self, message):
         req.update_headers(headers)
 
         data = {
+            'title': '' if title == '' else title,
             'body': message,
             'device_key': self.token,
         }

src/ipush/notify/chanify.py

@@ -13,13 +13,13 @@ def __init__(self, token=''):
         self.token = token
         self.url = 'https://api.chanify.net'
 
-    def signature(self):
+    def _signature(self):
         pass
 
     def seturl(self, url):
         self.url = url
 
-    def requrl(self):
+    def _geturl(self):
         """
         生成请求的 URL
         """
@@ -30,7 +30,7 @@ def send(self, message):
         发送通知
         :param message: 消息内容
         """
-        req_url = self.requrl()
+        req_url = self._geturl()
 
         headers = {
             'content-type': 'application/json',

src/ipush/notify/dingtalk.py

@@ -15,7 +15,7 @@ def __init__(self, token='', secret=''):
         self.token = token
         self.secret = secret
 
-    def signature(self):
+    def _signature(self):
         """
         签名
         """
@@ -25,7 +25,7 @@ def signature(self):
             '' if self.secret == '' else signature(self.secret, timestamp, 0),
         )
 
-    def requrl(self, sign):
+    def _geturl(self, sign):
         """
         生成请求的 URL
         :param sign: 签名
@@ -37,8 +37,8 @@ def send(self, message):
         发送通知
         :param message: 消息内容
         """
-        timestamp, sign = self.signature()
-        req_url = self.requrl(
+        timestamp, sign = self._signature()
+        req_url = self._geturl(
             '' if self.secret == '' else f'&timestamp={timestamp}&sign={sign}'
         )
 

src/ipush/notify/feishu.py

@@ -15,7 +15,7 @@ def __init__(self, token='', secret=''):
         self.token = token
         self.secret = secret
 
-    def signature(self):
+    def _signature(self):
         """
         签名
         """
@@ -25,7 +25,7 @@ def signature(self):
             '' if self.secret == '' else signature(self.secret, timestamp, 1),
         )
 
-    def requrl(self):
+    def _geturl(self):
         """
         生成请求的 URL
         """
@@ -36,8 +36,8 @@ def send(self, message):
         发送通知
         :param message: 消息内容
         """
-        timestamp, sign = self.signature()
-        req_url = self.requrl()
+        timestamp, sign = self._signature()
+        req_url = self._geturl()
 
         headers = {
             'content-type': 'application/json',

src/ipush/notify/lark.py

@@ -15,7 +15,7 @@ def __init__(self, token='', secret=''):
         self.token = token
         self.secret = secret
 
-    def signature(self):
+    def _signature(self):
         """
         签名
         """
@@ -25,7 +25,7 @@ def signature(self):
             '' if self.secret == '' else signature(self.secret, timestamp, 1),
         )
 
-    def requrl(self):
+    def _geturl(self):
         """
         生成请求的 URL
         """
@@ -36,8 +36,8 @@ def send(self, message):
         发送通知
         :param message: 消息内容
         """
-        timestamp, sign = self.signature()
-        req_url = self.requrl()
+        timestamp, sign = self._signature()
+        req_url = self._geturl()
 
         headers = {
             'content-type': 'application/json',

src/ipush/notify/notify.py

@@ -8,7 +8,7 @@
 
 class Notify(ABC):
     @abstractmethod
-    def signature(self):
+    def _signature(self):
         """
         签名
         """

src/ipush/notify/pushdeer.py

@@ -13,13 +13,13 @@ def __init__(self, token=''):
         self.token = token
         self.url = 'https://api2.pushdeer.com'
 
-    def signature(self):
+    def _signature(self):
         pass
 
     def seturl(self, url):
         self.url = url
 
-    def requrl(self):
+    def _geturl(self):
         """
         生成请求的 URL
         """
@@ -30,7 +30,7 @@ def send(self, message):
         发送通知
         :param message: 消息内容
         """
-        req_url = self.requrl()
+        req_url = self._geturl()
 
         headers = {
             'content-type': 'application/json',