extern/apprise
1
0
Fork 0
mirror of https://github.com/caronc/apprise.git synced 2024-12-12 09:51:05 +01:00
Code Issues Packages Projects Releases Wiki Activity

Tag clarification

Chris Caron 2019-02-15 12:32:14 -05:00
parent 416d57b54e
commit cdd1137efd
1 changed files with 24 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
Development_API.md

@ -81,22 +81,38 @@ a.add('json://localhost/tagCDE/', tag=set(["TagC", "TagD", "TagE"]))
Now that we've added our services and assigned them tags, this is how we can access them:
```python
# Expression: TagC and TagD
# Notify services associated with tag: TagA
# Matches the following only:
# - json://localhost/tagA/
# - json://localhost/tagAB/
a.notify(title="my title", body="my body", tag='TagA')
# Notify services associated with tag: TagA OR TagB
# Matches the following only:
# - json://localhost/tagA/
# - json://localhost/tagAB/
# - json://localhost/tagB/
a.notify(title="my title", body="my body", tag=['TagA', 'TagB'])
# The AND requires you nest an additional list/tuple/set inside
# your tag list...
# Notify services associated with tags: TagC AND TagD
# Matches the following only:
# - json://localhost/tagCD/
# - json://localhost/tagCDE/
a.notify(title="my title", body="my body", tag=[('TagC', 'TagD')])
# Expression: (TagY and TagZ) or TagX
# Notify services associated with tags: (TagY AND TagZ) OR TagX
# Matches nothing
a.notify(title="my title", body="my body", tag=[('TagY', 'TagZ'), 'TagX'])
# Expression: (TagY and TagZ) or TagA
# Notify services associated with tags: (TagY AND TagZ) OR TagA
# Matches the following only:
# - json://localhost/tagAB/
a.notify(title="my title", body="my body", tag=[('TagY', 'TagZ'), 'TagA'])
# Expression: (TagE and TagD) or TagB
# Notify services associated with tags: (TagE AND TagD) OR TagB
# Matches the following only:
# - json://localhost/tagCDE/
# - json://localhost/tagAB/
@ -111,10 +127,10 @@ You could look at the **apprise.notify()** logic like this:
| tag= | Tag Representation |
| ------------------------- | ------------------------ |
| "TagA, TagB" | TagA **or** TagB
| ['TagA', 'TagB'] | TagA **or** TagB
| [('TagA', 'TagC'), 'TagB']| (TagA **and** TagC) **or** TagB
| [('TagB', 'TagC')] | TagB **and** TagC
| "TagA, TagB" | TagA **OR** TagB
| ['TagA', 'TagB'] | TagA **OR** TagB
| [('TagA', 'TagC'), 'TagB']| (TagA **AND** TagC) **OR** TagB
| [('TagB', 'TagC')] | TagB **AND** TagC
By default, all notifications are sent as type **NotifyType.INFO** using the _default_ theme. The following other types are included with this theme: