pax_global_header00006660000000000000000000000064152672037100014515gustar00rootroot0000000000000052 comment=736fcf36c5acabe153e5b0b0b444caea8dc4c235 caronc-apprise-dfec414/000077500000000000000000000000001526720371000151175ustar00rootroot00000000000000caronc-apprise-dfec414/.codecov.yml000066400000000000000000000005221526720371000173410ustar00rootroot00000000000000codecov: require_ci_to_pass: false comment: layout: "diff, flags, files" behavior: default require_changes: false # if true: only post the comment if coverage changes coverage: status: project: default: target: auto threshold: 1% patch: default: target: auto threshold: 1% caronc-apprise-dfec414/.env000066400000000000000000000000641526720371000157100ustar00rootroot00000000000000LANG=C.UTF-8 PYTHONPATH=. PYTHONDONTWRITEBYTECODE=1 caronc-apprise-dfec414/.github/000077500000000000000000000000001526720371000164575ustar00rootroot00000000000000caronc-apprise-dfec414/.github/FUNDING.yml000066400000000000000000000001331526720371000202710ustar00rootroot00000000000000github: caronc custom: - 'https://www.paypal.com/donate/?hosted_button_id=CR6YF7KLQWQ5E' caronc-apprise-dfec414/.github/ISSUE_TEMPLATE/000077500000000000000000000000001526720371000206425ustar00rootroot00000000000000caronc-apprise-dfec414/.github/ISSUE_TEMPLATE/1_bug_report.md000066400000000000000000000017601526720371000235600ustar00rootroot00000000000000--- name: 🐛 Bug Report about: Report errors and problems in Apprise title: '' labels: 'bug' assignees: '' --- ## Notification Service(s) Impacted ## What happened ## Apprise URL(s) involved (redact secrets) ## Steps to reproduce 1. 2. 3. ## Environment - Apprise version: - Python version: - OS and distribution: - Install method: - If using Docker: image/tag: ## Logs (redact secrets) ```text paste logs here ``` caronc-apprise-dfec414/.github/ISSUE_TEMPLATE/2_enhancement_request.md000066400000000000000000000014051526720371000254420ustar00rootroot00000000000000--- name: 💡 Enhancement Request about: Suggest an improvement to Apprise title: '' labels: 'enhancement' assignees: '' --- ## The idea ## Use-case ## Proposed change ## Compatibility impact - Would this be a breaking change? Yes / No - If yes, describe what breaks and any migration path. ## Alternatives considered ## Documentation impact - Does appriseit.com require updates for this change? Yes / No - If yes, please also open (or link) a documentation ticket/PR in apprise-docs. ## Additional context caronc-apprise-dfec414/.github/ISSUE_TEMPLATE/3_new-notification-request.md000066400000000000000000000023471526720371000263570ustar00rootroot00000000000000--- name: 📣 New Notification Request about: Request a new notification service integration title: '' labels: ['enhancement', 'new-notification'] assignees: '' --- ## What is the name of the service? ## Proposed Apprise schema (service id) ## Proposed Appriseit service slug ## Provide details that help development - Homepage: - Official API docs: - Authentication method: - Rate limits (if known): - Message limits (if known): - Attachments supported: Yes / No / Unknown ## Example payload or curl snippet (optional) ```text paste example here ``` ## Anything else? ## ☝️ Documentation note If this integration is accepted, it must also include an apprise-docs update so the service page exists on appriseit.com. If you can contribute docs, open a ticket or PR in: https://github.com/caronc/apprise-docs caronc-apprise-dfec414/.github/ISSUE_TEMPLATE/4_question.md000066400000000000000000000006631526720371000232630ustar00rootroot00000000000000--- name: ❓ Support Question about: Ask a question about Apprise (prefer Discussions) title: '' labels: 'question' assignees: '' --- ## Please use Discussions for support questions https://github.com/caronc/apprise/discussions If you are filing an issue anyway, include: ## Question ## Apprise version and environment - Apprise version: - Python version: - OS and distribution: - Install method: caronc-apprise-dfec414/.github/ISSUE_TEMPLATE/config.yaml000066400000000000000000000007201526720371000227720ustar00rootroot00000000000000blank_issues_enabled: false contact_links: - name: Documentation (Apprise Docs) url: https://appriseit.com about: Documentation - name: Documentation Source (Apprise Docs) url: https://github.com/caronc/apprise-docs about: Documentation updates, fixes, and translation work belong here. - name: Support and Questions url: https://github.com/caronc/apprise/discussions about: Please use Discussions for questions and general support. caronc-apprise-dfec414/.github/PULL_REQUEST_TEMPLATE.md000066400000000000000000000046041526720371000222640ustar00rootroot00000000000000## Description **Related issue (if applicable):** # ## Checklist * [ ] Documentation ticket created (if applicable): [apprise-docs/##](https://github.com/caronc/apprise-docs/pull/) * [ ] The change is tested and works locally. * [ ] No commented-out code in this PR. * [ ] No lint errors (use `tox -e lint` and optionally `tox -e format`). * [ ] Test coverage added or updated (use `tox -e qa`). ## Testing Anyone can help test as follows: ```bash # Create a virtual environment python3 -m venv apprise # Change into our new directory cd apprise # Activate our virtual environment source bin/activate # Install the branch pip install git+https://github.com/caronc/apprise.git@ # If you have cloned the branch and have tox available to you: tox -e apprise -- -t "Test Title" -b "Test Message" \ ``` caronc-apprise-dfec414/.github/badges/000077500000000000000000000000001526720371000177045ustar00rootroot00000000000000caronc-apprise-dfec414/.github/badges/loc.svg000066400000000000000000000016351526720371000212070ustar00rootroot00000000000000 Lines of Code Lines of Code 79,977 79,977 caronc-apprise-dfec414/.github/workflows/000077500000000000000000000000001526720371000205145ustar00rootroot00000000000000caronc-apprise-dfec414/.github/workflows/codeql-analysis.yml000066400000000000000000000017221526720371000243310ustar00rootroot00000000000000name: "CodeQL" on: push: branches: [ master, apprise-v1-release ] pull_request: branches: [ master, apprise-v1-release ] schedule: - cron: '42 15 * * 5' # Cancel in-progress jobs when pushing to the same branch. concurrency: cancel-in-progress: true group: ${{ github.workflow }}-${{ github.ref }} jobs: analyze: name: Analyze runs-on: ubuntu-latest permissions: actions: read contents: read security-events: write strategy: fail-fast: false matrix: language: [ 'python' ] steps: - name: Checkout repository uses: actions/checkout@v7 # Initializes the CodeQL tools for scanning. - name: Initialize CodeQL uses: github/codeql-action/init@v4 with: languages: ${{ matrix.language }} - name: Autobuild uses: github/codeql-action/autobuild@v4 - name: Perform CodeQL Analysis uses: github/codeql-action/analyze@v4 caronc-apprise-dfec414/.github/workflows/lint.yml000066400000000000000000000007161526720371000222110ustar00rootroot00000000000000# .github/workflows/lint.yml name: Run Lint Checks on: push: paths: - '**.py' pull_request: paths: - '**.py' jobs: lint: runs-on: ubuntu-latest steps: - uses: actions/checkout@v7 - name: Set up Python uses: actions/setup-python@v7 with: python-version: '3.12' - name: Install tox run: python -m pip install tox - name: Run Ruff lint check run: tox -e lint caronc-apprise-dfec414/.github/workflows/loc-badge.yml000066400000000000000000000024601526720371000230560ustar00rootroot00000000000000# LoC = Lines of Code name: LoC Badge on: # Manual only workflow_dispatch: permissions: contents: write pull-requests: write jobs: loc-badge: runs-on: ubuntu-latest steps: - name: Checkout uses: actions/checkout@v7 - name: Generate LoC badge (Apprise library only) uses: alexispurslane/GHA-LoC-Badge@v2.0.0 id: badge with: debug: true # Run from the root of the repo so the pattern paths are exact directory: ./ badge: .github/badges/loc.svg patterns: "apprise/**/*.py" ignore: "__pycache__" - name: Print the output run: | echo "Scanned: ${{ steps.badge.outputs.counted_files }}"; echo "Line Count: ${{ steps.badge.outputs.total_lines }}"; - name: Create PR (if changed) uses: peter-evans/create-pull-request@v8 with: # [skip ci] stops the PR from starting the test, CodeQL and # packaging workflows, since only a badge image changed. commit-message: "Update Lines of Code (LoC) badge [skip ci]" title: "Update LoC badge" body: "Automated update of the Lines of Code badge." branch: "automation/loc-badge" delete-branch: true add-paths: ".github/badges/loc.svg" caronc-apprise-dfec414/.github/workflows/pkgbuild.yml000066400000000000000000000060221526720371000230400ustar00rootroot00000000000000# # Verify on CI/GHA that RPM package building works. # name: RPM Packaging on: # master - v1.x branch # apprise-v2-release - v2.x branch push: branches: [main, master, apprise-v1-release, 'release/**'] pull_request: branches: [main, master, apprise-v1-release] workflow_dispatch: jobs: build: name: Build RPMs (${{ matrix.dist }}) runs-on: ubuntu-latest strategy: fail-fast: false matrix: dist: [el9, el10] container: image: ghcr.io/caronc/apprise-rpmbuild:${{ matrix.dist }} options: --user root steps: - name: Checkout source uses: actions/checkout@v7 - name: Build RPMs run: ./bin/build-rpm.sh env: APPRISE_DIR: ${{ github.workspace }} # Drop RPMs into dist/ inside the workspace DIST_DIR: ${{ github.workspace }}/dist/${{ matrix.dist }} - name: Show RPMs found for upload run: | echo "Listing dist/${{ matrix.dist }}/**/*.rpm:" find dist/${{ matrix.dist }} -type f -name '*.rpm' - name: Upload RPM Artifacts uses: actions/upload-artifact@v7 with: name: built-rpms-${{ matrix.dist }} path: ./dist/${{ matrix.dist }} if-no-files-found: error retention-days: 5 - name: Upload rpmlint config files uses: actions/upload-artifact@v7 with: # Upload the specific files needed for verification name: rpmlint-config-${{ matrix.dist }} path: ./packaging/redhat/python-apprise.rpmlintrc.${{ matrix.dist }} retention-days: 5 verify: name: Verify RPMs (${{ matrix.dist }}) needs: build runs-on: ubuntu-latest strategy: fail-fast: false matrix: dist: [el9, el10] container: image: ghcr.io/caronc/apprise-rpmbuild:${{ matrix.dist }} options: --user root steps: - name: Download built RPMs uses: actions/download-artifact@v8 with: name: built-rpms-${{ matrix.dist }} path: ./dist - name: Download rpmlint config files uses: actions/download-artifact@v8 with: name: rpmlint-config-${{ matrix.dist }} # Download files directly into the correct directory path: ./packaging/redhat - name: Lint RPMs run: | set -e RC_FILE="./packaging/redhat/python-apprise.rpmlintrc.${{ matrix.dist }}" if rpmlint --help 2>&1 | grep -q -- '--rpmlintrc'; then echo "Using rpmlint --rpmlintrc with $RC_FILE" rpmlint --rpmlintrc "$RC_FILE" ./dist/**/*.rpm else echo "Using rpmlint v1.x on older distribution" rpmlint -f "$RC_FILE" ./dist/**/*.rpm fi - name: Install and verify RPMs run: | echo "Installing RPMs from: ./dist/" find ./dist -name '*.rpm' dnf install -y ./dist/**/*.rpm apprise --version - name: Check Installed Files run: rpm -qlp ./dist/**/*.rpm caronc-apprise-dfec414/.github/workflows/tests.yml000066400000000000000000000111121526720371000223750ustar00rootroot00000000000000name: Run Tests on: # master - v2.x branch # apprise-v1-release - v1.x branch push: branches: [main, master, apprise-v1-release, 'release/**'] # Always test on pull requests targeting any of our long-lived branches pull_request: branches: [main, master, apprise-v1-release] # Allow manual triggering via GitHub UI workflow_dispatch: jobs: test: name: Python ${{ matrix.python-version }} – ${{ matrix.tox_env }} on ${{ matrix.os }} runs-on: ${{ matrix.os || 'ubuntu-latest' }} # Allow selected matrix jobs to fail without failing the workflow continue-on-error: ${{ matrix.continue-on-error || false }} strategy: fail-fast: false # Let all jobs run, even if one fails matrix: include: - python-version: "3.9" tox_env: qa - python-version: "3.10" tox_env: qa - python-version: "3.11" tox_env: qa - python-version: "3.12" tox_env: qa - python-version: "3.13" tox_env: qa # Test compiled libraries omitted from all-plugins - python-version: "3.14" tox_env: qa qa_deps: python-qpid-proton # The newest Python may lack dependency wheels, so this is optional - python-version: "3.15" tox_env: qa build_tools: true continue-on-error: true # Platform validation only (one version) - os: windows-latest python-version: "3.14" tox_env: qa - os: macos-latest python-version: "3.14" tox_env: qa # Minimal test run on our main Python only # this verifies Apprise still works when extra libraries are not available - python-version: "3.14" tox_env: minimal steps: - uses: actions/checkout@v7 # Run on the Python version this matrix entry names - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v7 with: python-version: ${{ matrix.python-version }} # Install headers needed when dependency wheels are unavailable - name: Install build tools for compiled libraries if: matrix.build_tools run: | sudo apt-get update -qq sudo apt-get install -y -qq libusb-1.0-0-dev libudev-dev # Install tox for isolated environment and plugin test orchestration - name: Install tox run: python -m pip install tox # Run tox with the specified environment (qa, minimal, etc.) - name: Run tox for ${{ matrix.tox_env }} run: tox -e ${{ matrix.tox_env }} env: APPRISE_QA_DEPS: ${{ matrix.qa_deps }} - name: Upload coverage report if: always() uses: actions/upload-artifact@v7 with: name: coverage-${{ matrix.os }}-${{ matrix.python-version }}-${{ matrix.tox_env }} path: .coverage include-hidden-files: true # The codecov job below consumes these in the same run, # Prevent them from lasting for the default of 90 days retention-days: 7 codecov: name: Upload merged coverage to Codecov runs-on: ubuntu-latest needs: test # Waits for all matrix jobs to complete if: always() # Even if a test fails, still attempt to upload what we have steps: - uses: actions/checkout@v7 - name: Download all coverage reports uses: actions/download-artifact@v8 with: path: coverage-artifacts - name: Combine and generate coverage run: | pip install coverage # Create a consistent temp dir mkdir -p coverage-inputs # Copy and rename each coverage file to .coverage.job_name i=0 for f in $(find coverage-artifacts -name .coverage); do cp "$f" "coverage-inputs/.coverage.$i" i=$((i+1)) done # Confirm files staged ls -alh coverage-inputs # Combine them all coverage combine coverage-inputs coverage report coverage xml -o coverage.xml # Upload merged coverage results to Codecov for visualization - name: Upload to Codecov uses: codecov/codecov-action@v7 with: token: ${{ secrets.CODECOV_TOKEN }} files: coverage.xml verbose: false # Used for debugging only fail_ci_if_error: false # Avoid failing job if Codecov is down env: CODECOV_PR: ${{ github.event.pull_request.number }} CODECOV_SHA: ${{ github.sha }} caronc-apprise-dfec414/.gitignore000066400000000000000000000015121526720371000171060ustar00rootroot00000000000000# Byte-compiled / optimized / DLL files __pycache__/ *.py[cod] *$py.class # left-over-files from conflicts/merges *.orig # C extensions *.so # vi swap files .*.sw? # Distribution / packaging .Python env/ .venv* build/ BUILD/ BUILDROOT/ SOURCES/ SRPMS/ develop-eggs/ dist/ downloads/ eggs/ .eggs/ lib64/ parts/ sdist/ *.egg-info/ .installed.cfg *.egg .local # Generated from Docker Instance .bash_history .python_history # Installer logs pip-log.txt pip-delete-this-directory.txt # Unit test / coverage reports htmlcov/ .tox/ .coverage .coverage.* .cache nosetests.xml coverage.xml *,cover .hypothesis/ # Translations *.mo *.pot # Django stuff: *.log # Sphinx documentation docs/_build/ # PyBuilder target/ #Ipython Notebook .ipynb_checkpoints #PyCharm .idea #PyDev (Eclipse) .project .pydevproject .settings # Others .DS_Store caronc-apprise-dfec414/.gitleaks.toml000066400000000000000000000010311526720371000176700ustar00rootroot00000000000000# Gitleaks configuration for the Apprise project. # Reference: https://github.com/gitleaks/gitleaks/blob/master/config/gitleaks.toml [allowlist] description = "Test fixture key files are intentional test data, not real credentials." paths = [ # PGP test fixtures under tests/var/pgp/ are synthetic keys generated # for unit testing only. They are not real private keys and carry no # security risk. '''tests/var/pgp/valid-prv\.asc''', '''tests/var/pgp/valid-pub\.asc''', '''tests/var/pgp/corrupt-pub\.asc''', ] caronc-apprise-dfec414/.vscode/000077500000000000000000000000001526720371000164605ustar00rootroot00000000000000caronc-apprise-dfec414/.vscode/extensions.json000066400000000000000000000002771526720371000215600ustar00rootroot00000000000000{ "recommendations": [ // Ruff – linter and formatter for Python (replaces flake8, black, isort) "charliermarsh.ruff", // Python language support "ms-python.python" ] } caronc-apprise-dfec414/.vscode/settings.json000066400000000000000000000020071526720371000212120ustar00rootroot00000000000000{ // Use the Ruff extension (charliermarsh.ruff) as the sole formatter and linter // for Python files. Install it from the VS Code marketplace or via // ext install charliermarsh.ruff "[python]": { "editor.defaultFormatter": "charliermarsh.ruff", "editor.formatOnSave": true, "editor.codeActionsOnSave": { // Apply all auto-fixable lint violations on save (isort, pyupgrade, etc.) "source.fixAll.ruff": "explicit", // Keep imports sorted on save "source.organizeImports.ruff": "explicit" } }, // Ruff reads its configuration from pyproject.toml automatically, so no // separate ruff.configuration key is needed. Leave the extension defaults. // Testing "python.testing.pytestEnabled": true, "python.testing.unittestEnabled": false, "python.testing.pytestArgs": ["tests"], "python.testing.cwd": "${workspaceFolder}", // Python path "python.envFile": "${workspaceFolder}/.env", "terminal.integrated.env.linux": { "PYTHONPATH": "${workspaceFolder}" } } caronc-apprise-dfec414/ACKNOWLEDGEMENTS.md000066400000000000000000000021531526720371000177740ustar00rootroot00000000000000# Contributions to the Apprise Project ## Creator & Maintainer * Chris Caron ## Contributors The following users have contributed to this project and their deserved recognition has been identified here. If you have contributed and wish to be acknowledged for it, the syntax is as follows: ``` * [Your name or handle] <[email or website]> * [Month Year] - [Brief summary of your contribution] ``` The contributors have been listed in chronological order: * Wim de With * Dec 2018 - Added Matrix Support * Hitesh Sondhi * Mar 2019 - Added Flock Support * Andreas Motl * Mar 2020 - Fix XMPP Support * Oct 2022 - Drop support for Python 2 * Oct 2022 - Add support for Python 3.11 * Oct 2022 - Improve efficiency of NotifyEmail * Joey Espinosa <@particledecay> * Apr 3rd 2022 - Added Ntfy Support * Kate Ward * 6th Feb 2024 - Add Revolt Support * Han Wang * Apr 2024 - Refactored test cases * Toni Wells <@isometimescode> * May 2024 - Fixed token length with apprise:// caronc-apprise-dfec414/Apprise-overview.png000066400000000000000000017263251526720371000211140ustar00rootroot00000000000000PNG  IHDR8 pHYsodtEXtSoftwarewww.inkscape.org<tEXtTitleApprise OverviewIatEXtAuthorChris Caron9o?tEXtDescriptionAn overview of how Apprise Push Notifications work.btEXtSourcehttps://appriseit.comJ`PtEXtCopyrightCC Attribution-NoDerivs http://creativecommons.org/licenses/by-nd/4.0/U IDATxw|SOҽee*Qu{O^[q+lDVޣݤMs~JK&i&yoiz<QEQR Z0^6kF "jv9KkI<NDdDDDDDDDDDDT5) %E=%NDdDDDDDDDDDDFj:ApvMNQ8; c<^*Zg%= B""""""""""c^tAй)$L!*{VJUz29HDdDDDDDDDDDuAЋ1MZLY!=wN!eL[DM7%B[һo(p NJD(L hp$.HDD1AHDDDDDDDDDnRsvNepE B"" $"""""""""hp*N/ VՋ B"""""""""rKUn^="\kY!A6wP&XAHDdDDDDDDDDDv :N.zӃDD1AHDDDDDDDDDnE4&ݝ +,b܊ڠ { `pvA"1AHDDDDDDDDDnՃ .\AA"1AHDDDDDDDDDnC+\71f+D&шDDDDDDDDD6X=xՃDDVy:;""""""""" "4h .)&widd /r (񁟿#X (89D/Jzh=.|kK*Eop[("#='Á}P(Cdd$"##!^P" 0(Im:1Z@Sc'rL[iap5mt0[%@/ME~^vڅ=vC ::f6"1) ^^^N1AHDDDDDDDDD.O#ЪFQeB]wjGV6_ظ~=څpj ~~~fzzzM۶Ե ۴tD!LK!X] Z[AZ3A;v?l߂s9 =̭ L=w#66mڴq|||0bةS B"""""""""rIje:hv Z\I_uyD-DhĈH~Ν9Eh׮,۩K4fxyy5!jX l[yu:n QcFCb=P* 5[M(ɐ6mۻ_QK"uvDDDDDDDDDD&"a4;2󽷷7f7o{Bqq}x(.2N䮘 $"""""""""; lK+PB~nݻ?C^pY\p`Z![UYK"7'atLQX=hrfc*Ֆ*z~V?kv{PP^yu3^رch4&Z-VXN $"""""""""bEh 'W^i)J++lRA6D)Ӧ_FѣGQQa:`5k~ݱ &ȥz2wS3yvQ\d!CμyQjWyv0AHDDDDDDDDD.E#0Ah;XA䕖ய?G^iې NμyǩS MzOemD B"""""""""r%#L6'iEK z$y3gΘMj4OU늇c\ՃHAaaq:7w}9 = (Q*m&qYP*iY8w_c#ji PDZK N/J(\-=0CƓ)KA0Yt8uzӇ8eN~M~hLrIE+؛QSmu>P}S2 rps/TU6aXqrn|s`/{l^C9Pj5ՂR:⻃3#t f8 Zghr,;ug 1[z\,# w|+-KCd튃9XAhDЊN/ pDz2 (m%׽oHh(~Q|8}\p!!!H Q!r l$zA![.]SVOɣ Eb&,Pp G?@cfk]JS?w_uX 2\d6A-"]Vل&}Ǧt·⟌ cՌ_2\'Ap(7b)*R"5&' aEʊ>쎃QszQH(9&^h^|y&9LY Af*<"ME#-- JNw.̘95_L6*.'r'&CQcpb2?ieAj`L޽g8yr)RbqfPcAp$/UXx=Φ5.ƥtBV p0/^@aE]6P+~zɶQ&|EJck>x]+1Vt IO\?>?d{qk%kt @a_Nu!W+A8{OX\ њ߄:Z34 tQ!NKt a bp؋o be&+63f_B"*4lKmiQѠ_B"̘p?3N))LjAY\UiSIa2.MۆG %򺋷Գ5UfԙybghiEC}Pk+Մ9(|:ѝlfir:Ch `_FZck,tM%K!A@&?w>@.J"+AQZ}L'Md.DS]<$D&?vP&?hw,1KErKJj%+bx.6(BYU%Bra7Ƕ-[T*RWT&%1AHDDDDDDDDD-$R `p,AaxHVFsq8;2!3'߳7q$*5jK/*BIv(-)Aqq1% x"rLQtyAa:A{%+4jlQ>Npv6dU$ E/*T% 3Чm;!H0lp^ & BVj5LQEV:_׼^ Y 9JJpX3EU(.W;!R.'Df T"듧C"wLHc4PEȕ(./G%Jh␕y\M({I=++@QpškB"M^A\Y²2*ʡ@?`@JU~Aۘ8tIh֑QJ*(PA^y5J*:^G">&['"ﺏ-"Vxq+*p.|^.Ҋ QRDyuuA~~ GLH(R[K׮#:j尸)X B"""""""""jq\` E%.&AM=Mdž BnҴsŒ|}=)mN],PTVr WЀ `?Ln={cR im(.S\rȕ뻲J$€)ק/FmW"/D^xjq~{Rⷿa#uPPÅ<:wf{Lh(JGH͜o%Jt{Q8ҺW ;4x&iSF:KK5`hV B^Eax{d lb߮&"RE IDAT1[&m yJ2e9CSP[ Ӫ*ϧbTb Fg&NE6m/ Xj:wΝ;}iPy9XsEٲbdˊlnDcΈQxx- ,ׅొʰXvtOS&a9h>WC""""""""""Ė=eӴ(J+4Ugf`WlDTv>aKȨ1P)cC̢bE0(bcxoP^]X>| /-b+Xq`os푃I^|~.vNgbWB;.ĘԙNTfxQm&(<wɦG/5>^ѧmϧ6%J%D^Ovo9>^/ǫږxjmK!:=G n|gXnHVizQ02KJ*}|%eE IB0CG,*W80BS螘dSE2sWɔe >mNs5nkZV:ej!JZiV!LjN<>j kߘfPAUORlS68.k:F߸~|鈪>?oiz޾)1զj8rG7_{ [~lsi6ރ/jg}S&7yLF\J3W8%@&G)?̼z~߅[c zQQUco56iM7<&r~^$"&+U)ff/^{crj5v9WV" ĻO/HBچW@_?TUVt?x?6خdBѠPA\siX~#^ ux rvdU[ᾩѿ{7g2rp/!-'ǤMѠF.'""""""rv'}5UeJ%To$-z0ʊ mfT"H_DDZFNuU]_A:)ҚIgI}PgE#DĨ>@^ 4'59Q! ˚yHO-!H0cgl>qԦpӛ/ѱc9&[ZV–}Ӽw#%!DQī~R=RSͶK}}UA,GΜ5ֻS'3 #7.^46GwĴ ș+6GaCeD`͎>Az:%&r,Z-mKGώx5鹹8}6[>MKc̃V4$6-!AR֝2=AhiWd_AP??50mBgʊ f^ JKj۸.tv~ޞHt}4z>kM};%v1>!Z|f۲8wN MK! luԩbݰ*w<<607[.1kmš;'l@Q#z;w|FCtNƿzlg;5yLx~nmGу5yL62޾lۥM $Лo*gD~Lr<[f8=_xc m۷}ٶE1O~K B@ j!^avSZ Q^ iv BOCJfbxئV_^\Ǹ> EBmu89:Q+4z^Z fλV$ֶR/q>?צS:9czA$UUf:|ini`oOggFAp\`xͷ!6y}#+EO!g@DDDDDD4rϿu6'xH$aEhC#!Ծ)AU:V۷N_SG/tqXq̢" rEeeWañ67{/W[\Y~=g (4__A<'ٴO/uK%ﾇٜl1>$&-ܱe>2١ >˷_Ӧ  jDDDDDD*!+Umￋ>;AU/5w t,0*ލ7hBX8}T^P *rY\HK>0lƊ3Q Ez 8}jcuXlA@G3Ұa;zȦ*Fi?~>٦S"Cfq]3w{$%ۇC|^}/^c9 ~ލ[i,L:IeÖ}VO&[W'CrCq}hvWi\pZ^^x_5ϯ㹻u'""jK>Ci CMtB=Uta!MYN"3P #&2m2NGZvKKQQU ?~蘜Ԣ+ȗ +UJBDHCBƽ6oW CPҮ-|0Aye%.ffU*}}8D4BΠBV~> r ЭC{x{;dYY R F6ɼN9NGf^>JPZ^/OO :< 1'_@\Nmܨǣ#2P$/ AA萔Hgl!Jht:"$(f@&CJ^??CR""69+.\QȰPE|TCij5r QRVr""$Qyn @&GJ@$ƠmBBrb d2 萘;ap"ewcxs^~ 0ၳk`Z8p2}$ ڵNp-ѩmBU8iҞoOzn*o|nпInv;~7o_\l/у[՛,!>c#GPQ}iǎwW/?qRnIY}-{__L3N3fdn)O,+9?m,Qa x`T꘵WVb-XeNy㣣0z 77t3G8vjSG!y\*xy͝5}MRvY"5=lO#=o^Ł'M{yy_c2e˪-4~ CY31} HgcXN\ιd5"1o_y8 a7ݏBӧ-q xSòذk퍛#w݁ݻ5Ŭln=6܍<:m #nČeߢ5j˳x7rR3<$8ܮ 3Bi|}|pdqzn.?ٶuŢ|`}ml_̶zܲvƮ#GQYmԘGA-Qہ0W̶={߽xhkzJ Z />p?Ӱ\O¬ SG=]c)ÝǡMB+R3jJǽUyX߾Hnj5Voہe6sP]yی0?qg6 0_??}lGc̶Xտ[R30'̶=x4O`͎W\s0[eK~sΏ+V_ݑV =7lĸ8L&̚x⭿m l/< 7()+üc-h/^{ Đ!X[o#f ;I7k,!6~0NϏ?cն&_2|fMHr6mƟ[̥4e`|{1nŇWyf@vyۭغwKKcrݒKYu~S1GwKKغo?K53)Hе};wOb[,Zl\\_}֜JzlW Ou,z>{%ql睘(L3Ldm~a1c 56:6wN .#H!Dbw˩%6)ޘ5p0ܱզYedf$Y%o< N0Guj #==axpX<8j,NfebX}h?rx ݓ\c0&[?__EEeʫ ?R̎a폫ROV!".eRv]SG;sk鹹煗q)Eᛷ^^MwQJM>hg%Ĭvsixo!}Uj5ۏ.='˪ذk1YWqC6.*$AX^Yin_[X7 eRoڂ囶`̐lrVٗ()3)lN~ ~/zp|& kϭۭxF,^I{]T_V6Z']o08x4X;1OϞeF떗1/Yt~ 8LƻO>nufF ]Ԧ9 dr,ݸ K7nBAv 컥˰~\nj9A(;|?w†]1g${ VxiJ7#7p%x .XgmrzOa>SNzH葒;w6#4 IDATVTKթ}9kgk0oWp#Mk`ɆXa#no>դkŕq׳/"-aO]Ka+BA0?3Qݩ#tz=T*SyEE?  Z~Wg.]ђ uJ;{s^yC׺>Z}!׿+DQ2MT 3sEu1|]Pg?ئAp>#32E=i^ oב#x/I@pHgxO,> d܊[0?|S& Vh GϞ3ٿO-{Z|F 6}HZ.Y#/,YMWk5:X>MAsVnي1 {OrX YY=q 8(Σ0GZAa!N 쓫@t> ܕy`ذ@GI% izT( t6L^*@'ΨX 2 ?y yp1F 3_*qP19n"5[Z2sgT~^.ؾxAy,p\4iL\^yCA,=o0]ӽV$䟤$Ϥ߷Jlb0R*qP>?G%+USR\]'WT\\J51bB,ݲM?91{:AQ߼#FZ}Yi ,\"{^$0WizPq[Ɀ#b+᚝>b}R"2zB7owT8XhdE.Dܖ/w= ߹$i3(.^FeK˜1RzO*UAO>n"G8(JqI <#FdH^XQJJwFq";k^~/a/k~13I>byVlK$XPZTT[o}c#E])ŝ&. q~bLV`',XVv}֤yaXtvڵ'd ܸd>9\g䠨:1:d_orO &&Lz0P_ 9ZAϘl~Egw8O7nQ_͜#sg_U=4Sc"‹ƻ U:sUL$x鿓-gI2fϦ(>CQ?" @s-E%1ܸE]?nR"xRT!3fI|Bǩl^5v˼SПhi-y_P8 2X0WN&"Ѭ $0@l`?% ^q1&[3VVڍCɿ}k+e95巃b}O۝7T1A,}B 1[[\ h#F-$!ldIDǣϤB.@"0n2mHǠ 7$Ar"5<~},wJczyoRX_Q>egN{G(HqK(XƉ8Uv:7.y!q:L e:gUE5_+/ʂ-v&ʔ/ࣄn@Xr6@[]}8l4X E V!{' 'KryYD=SXKG=wuE+YQȞSk /S&KUSk.f-xK7o<rN0%He T8,0P:~&/EvEދj9ā?.Z<ţ>޾ ŖxVՓzjTbJP-=a pb H߻Z}b ZfD)+~Qxr2y_[ObpH/;}U&Vffp#[ & |Alx2ɘ2Zd=uNe<,,ذ*\289^(ĕXAebh"u-SL١eFQBscc*ђSYIB>i|?W5TVn)1#fKU1Wf檵J "DLO[L,ذ1haɦ Q\RqKR܊z p7{jkQRTa :t /^JTfrZF؊vmYښp]=F/0a "q q- oތ>fA-Jw7R2_&޾rJ_YSJfT(Tٔ ʹ6HUzB{)SV]_.^Av$XS-*Ɲ"بK"J^XvŲaqg5 zʷWͤ|P,qE le# 'EܺX7l$ȵg+6#]4A&gf-ˠ𴫯󝝳V•qjDmI N)z1LMKϽoc[3:Sֆ>m=+ {N-t`ok 'NaS ΜÜ#BVpwtWq))8x>Q`t5%Z4%f^[6- `}zë 55 /\ľSgo;BVAp aG/^f:V~u~?Ā.;O'֍_1R1ƨN-0K'8فUAT8r* }{ z/eG06Ї:223qC߳:<Vy]UƊ)g]ǤY>e"z.HIx[3N[bt>.~7 p8"m@ǠjMu5|p! (GLV-|ckCKQ޽+W=L~<cb'?-.w8E7<.ZU;#$(<CdaY=}w9cL~hhzz x>/]Ǝ#Lj)^yʋLfL\ ux?J_I4&tNOߌ-Ðf]ijhۗ?bumQj=$:!&!;1vRLy,/#G:ZZ ԳTfml֨4^اBx+.F4%88_ };?-NE=N櫫at> >tȘ߳*̝VDu55Dcl"6n ݏŦ⪨`P. ;+K!26Cgf`﫱k>2W\VRQ`aG\(~‚ fe=BCncx^I͌ФBGqϱ9^O[K'M@`n~>v>wEs7n2Cey "0u꾷R3T(}[p+X"Gvљ'=p5&|?nn014p=b<~=}.]˗JᖅϷoU.{~Y^h9}{k NV`\Mhahߢ̌)+"cT{ܸ.9z\rUTn.9HI{'>l)ii8~" kP](At!f#j-gݪ AUEA Jr4򆱎9 J 0K}3qim |ƾVUh!\Ǜ:o Mu]Muz6Ҿ\>AjmE:wBISu\ap?6̝%>OD}YX 2Z]';;mPԸ*lm0in肾"{ Š#觥)󨣥?BfMZ%|D=}&d(p:yB6m:25; tuقB?*AW[: (6?H\wI BhYbIx(PӲZ :BQZ[oh'aP [aXu;q4!&n1Qqb}k l;:H},xAgչ\.v.YFNa\r r!,2(I|Pi᪨HKv)b~}c"XjVȾ`ezuw tuxçLD>Ag#rmS-%U.Wi{Z6͟#FA}IzS /FuKڷh}{cԼk7-lEG b1͌hWۆb/3ߊ@T8ֳs*Ju'goܤf*M2~*fCptDaÉB͡WA*u@.#:FZ(fDS_WMh& [K x5v$V<;Z\ddf K[H_X<:>o?dĘxK"Z*U3~F텖 '\ŘKKJX6yB秵m\.[#^.3i*qߊ+4٘Z&WJ~|>6g:ֳU }1D0hT*yp`z{%|>>ffPJW,Sጙ0)xPV,caa}0`dgr_JK- pX,kMU_ƒJdKWI}=k\ġb3 4Ԃ!50݅x9˜!j\d"U^ʝ ^~HWV}^ a%܎W8^v 4+QfE78z!I;ش9 fW6*v(!÷Pso̜\۳o{hf 1^=¨Qe ֵʮk I},KEqiP-[,6(fSԌLASeR&[y–LLfMhX!q"M<~L/(\7pHCLȬaJ+ :|Fpwp+joK2eSk}k+\jeca}\IxHqwt?0NdPOrrqfjW)^U~L1qqCu_:o?dPiߖђMEuM<~HuISqse޽GOT ;AޥljeX,L=L/f.BB93q1|uln!֫yH}ϟ1hLb5Y3>ٚRT]&޻ʼnM6ӲFU8g Y3n}k+Lu%n}PU练&3X. fHBW[ (zرd!\m=/78lbcBj+<=߶C5M5]w=!"ZJ1׋2ut2#geaYrp6kv\1ghntǜIcA?qyS&`jl4/B %f }M- ~MWAd Ũ&r"Ow8"hiaE!r^Bex2O#3<(Έ-Ҙ;fĨV' k(.߹^R_AKҹUKMUPn]OŎ)Cqܘ]h[-tcT{/v+Y4ZBif^D& hBǖA8~gτj+Ѭ+9l Xx89b`?Ӝ#pe/ ?)J|ѻ]['1fb$$1n ԌRM<-E|#?OIn섌,,Ŀx)$\вC}\SL>r6$ IDAT0\.1v~kK`ۡpl1{:g;Ŭ 1 Soޓ'L~`y& uu,?'S׮ -^IZbfch3lwY|+(]JǰmOvv-|!̯"?@ǠbRM6hڰ:v` 0kgjhQsre`WP#J .lFkUUI -Ē9$ZR!Ņ&dwge\fl$_jka0f!*{ڳף}3clB&%,M"LwScPƲ&g,PD%RR*54S$Hvāa`kh]8LX,,Ƅ:5BF^ xqOq5.^QrI;!ki-fⷌ&f ;$k8`O4W}cI DFZ .m:uKebl@IHD 7C&/Ҙ Ahs4L autֵ440{HHc G$$R'ZI}.ԉ{O'B =BC 32y?.zSjXxb4eQ3Dص3K@NI [ZHaMיcZ!I 99 MGzP&YY;+K3=QvUalb>gEl\X[#i@("Ѭ+o'إT Щe;/bJfnlLea-8wqݘ}1w &^d Qwl=ivNWZB$l665eҴaj#ܑm&$f ^u[L N`u55JLh܍~aT )IAƮ QڊrA 2iㆲשDfc@Nz-qhp,X,:YS0~ .rMcrHՖ@֭0s:dU#cbSݻ}[AhhAMܜՐ!N+sS$HZ^k BXJ^q8U/p9ppB 4UU.geΣ(.hf/<ł-XL9ڻW_GgE4Չ}O(clUbgh/u_p-d{HkzE6 &$0(ǏxIx$$$xqsa!fFFRGE^8uU<(+k_^J>io%-V}+@aaeFp)8(7$񹄇7iz39 %LfcL+}$ut]Is$#J Tg[uba\.mmy%`QJp~[K1Xq0c.Yө}:P7ڭEPWGRmփ捽ѦI 6k KS-@k,T́ba0bdѥ;wq!6B6阴A.J#EGKjZS'T&_goc]~ N\'1x\iUApst E<rXTxhdTfdfbs8l6|$m6hVS`+8nAl,b4iؠ%QȌ|S.2|`oc }!wx&xFYev'X ksţiY(e @hӦ01QIWn<{.)]bHt/bȏ} RK[#;{z)[B?}Bxx55c=[ڿ220||9+L}gQl(ߘՖ,@!sa!"3z ܲtAvV I<N]OY}W[C1GD5졥ElA3ScpS\^UemV?u :̣(lY0#o=)=%]<>~prVʹ |_KEŤ콻0wg`wO74T˓Qtp@H?=D^e֬GqITYLV4ml Y2+oF="3':ZPR~?":BBh9TUU\ł] Br8ն=-q[@;ʂeJ=8 "nf|_:u l 6&0ӃfP\DvBc"s]r1/=^ȶ`KCLC5qoX?g&.؊Gba5NDiɍ1_igqn$:='O+k23G/yRW!Ŕq.%m2V["7<1R"e~+?w*Zz9t*`X8w6N T'JVb0x,}Mc5a +>֣gоn@hpqII@[+%l5SCCߺ w[4/qu!aerq4BK**RSEd`˜# c 17浟AN%O9™\*'//܊(^AX2d|ƱJ WhL!+T{QqѴ2P]#p:#8zeBsȁiMEA+˚[ oH S-N_MUV&&sDgO8*0B[O2o8@____^y: C)߿ú'rޣw"$nC:'&\iir}h!_ϚF]a5a٣GTe(- q40^P#bL7Էf,-abhCabVL6RLm[ZtM Ӥ)VbÜkwG4rv+z{qxBף(L 垢ϰfwl63p!̟v9  s߷R&~?~(6, ,-FuwZ Re)+{ -ATM\ |] uK3dtuŲNr2=Z>Y  i`Q⃘ Qh IgqlOk&qlM.VNcF+8x>Hsa!F[ 6W]uw<},1=mm9:6Dso^?P z:ZKϪDJPcEt|edؘ:Npr5"͆*1@E!yoE\C^ dhB xDnE=Ĥe+%fFFpsG#g6DSo/_c-H d0o5`VSaQ:eAGE"\q!FR&<@κMk:[Jč~Xl$u胧@p014~}Ѷi8fU_3 ޤŴ^"chV~(pAݸ7oTCr_0G*bn>|į;qsa=".eMBKCUQX~ ?}"fyM v?!>S$EOj\551K' ~6ݼtQ<+Υ*zI,ۺ*jkaT>h׼"ՇX;Po5,Wljk-d0?П}]zbR$Yw@ w1K'\wx|غ"0sp$K4rrM+|,Uq ڐ fYG0_i;+́8>+y-=C?ҾI)X,VyfzmEi4.|R94VVUvʦN !}Y43 z)4?{&oEH4|2eʞp\,#4]1Vy$edP'Ǎ侾ڂ:4Չ6,S oAD@i3[`W[̍ǣ8:emg\٨r @H`VLpMySжY*p0>{W,{L 銠{Q08X,z`ݞb#"0K'\'.X,=Q ϯPjJS\#zVM JcCITLE>ód:o׆8v (ՍT\ Q{I<6G)3YO$X`fn-[*\ɵ>6mk UU}4pCPS#TP#ￄ.v뉅I70kwuwo˵pl ZUu5cN<_Q&y =C7 Rkvi$m*t `5Ԝzb&ķL#g'T"GV+0kފn4=~`ASf[[jkΈV>ncf٣G]/\Ik2{fcQTqXuM$8V0b$6-f+*naabOkʹ*R}V--Y|bWhY oR;?~B˼]hWO̪Mz:7 i%%"hcP 5'_E<^yăاԠQ}0|>_ڳL$IY^ ru554r72-pEKJ~Sr}~'ł VUSKɖ)_ʀ&j]|/+l,93dqn:5 ["p`/f-,VoJW ]~+8 ҂+ 5zMFE[י^-Ѭ*t ]m]RaJ`i;CCD17chhxP4RڱK/)kIJJ5$ @C- p` ؾskA))<^̎Fw N-[PG Fh5.Ν'nWTuj* k\ xD_~~Ӵz5UUؗ0M,JFz>>NufA\XOS5W mu^ ]йUu_Gz?v4YY`oې"zE,$9E$\ԇ3&&nԯޮ.8.҆\E H^׷i]?^1 ajj2Mp+Muu!{a6٣Fߔ۟r 7DOc^Gp?n*܍bDZ Og܊~%zztqV5!MT}ދJ)/p\8q]mdG/A+w#Uǻc+arASd)Z8_~̸ T1U(x'(l>pBZK T:yuLdWO,[Kǥ%KGUB[QRFTj&^BAe9ùXB,!`Ei?g3/2sUXȝgUW[^UkihCP ;~X}\ڵZ_H9s}]mz/_q3 Ak$ _ ͚F'U| VϘ&$& IDATW4uH 2AS?b z'>]Ú$Щ/:`ű8p놘3‚'aNAZla.;q?.mܽa:Wo_tE~a!?…Gq/1>*Y#vRByeQ'~1DRD<|oP"V\|h݂R"N몕aa"_jqm?(Hs l|~]37MFWdŶH~N_WMegx%57~{}ݮ-^Hwqýt,c3umZG=}mcx0ed`޺ Z-/go>KAY<_O`H 5~QuiPv۳Mm.GL*kImhXp~&߹ zmC#ѦEyXy+Ƨ]=!koY)BRNN{ {$*ڹUuyt F+Bm2'`e}ҢGPnZM|V|mjn]ͪXG^-E<,rln߹ X>p0Fîqi 2sP:vEH#r:v)[^,hkkàt~@Lq?4J}S3kaQ5Fk1В̏>NΘ=7}Vt$(g@GCSq3)z|->+ix?fa^6i. RSUMV&ʺ?oc}ꀶCf% QZ泤d KSSN\AݻŸ!*4'=yNGKX ¡p|)G/^iؼ`X4(lڳuWʐsT7M(~?m&\X&cVn.F_H@zk[,w-Mb򕈎Sߩ{H0nJc>b,1eůc^A2pgKҰ1Gw_Ǿ=*uMy ( 6lį?MMxAg*҇OBYiʢu@HC\ tv 扡~Tfcdl]O@]MsF 3֗]kJv?$Z%`c޻bߏPq;R+K@ie@m,x`Ȍزp )~7ĿeX U\{4ul7op%:KSS(zϹ! zx)/_8z4' 1w^_W=Cۈ-ߩ>Jg޺?4fϧfXᇰb+@k]7;l9ݧNcMJ^=0iJ /^bX;sQ$Χf~эۄ`g\&^u֭ڬ Q\z0<ѧ};ϒ1n ^.WE:wx}ʢ/ Ip8Һe\({O* ux<nن-QҽBLmۊmѬx8+7#-7ⵢCmx99Yco@%: =Db<8%:W=SGJP3Lk 9_f4n$%X kn\}3s[ e]|ÐA@#g:f氓"SV-,ΖS6vL_ie}7f -.GV] M+g`zMeN ᪨͕I4)  +l-,P!.%/^J5x=ͦKQz.[!fFF060@~Aed(vj/Ծy3 --98zݾ-- FVhHLMы5}PK 5om =*͈bQO!hj.񊑘#.R'2,MM][_~1s'8Ճ@=zT5I=N-[9yyҒ;ㆫ ߿Gc _8}>}FǤuMʤKVDYjzZ ##3cbqU~Os E=K |Ά^D9#Rdx<][98^;}=X<~t40G*Aȸ/`:=6w[™7гM+gq8v2rK;$B6ՁƱ _Dj6<Km )CT6#^đ ѩeKJ$Zfuu\qd {Obߧ?|`cnx"WT=]4kMCk@F032r\wg fНPL_vAn>B@#J'Y0|Bw;}p8HxG/]F[:GsоyElBn?fП?ݯ/9sh#[c}4F=K h~1wHnD kD+#G =mddfASdQS*֋]mQ4=r"S0_o4򄮖~ͨ(l=x*8׷.5`,ص!>x=Eӿߌ-^ nc@Nhhl/߼KWi޽$P&*T$GMYq(_-2>"VcGKS^7{&pEQ1q8z2rr:lױh~ G.e2Юy3XçL\{"08x`Wd8,X@Pg3Z_ @nqWLY0)UE^Uc_AhT𭢧=M-Qz (=O&1O_L-.)ыp"9♆* ʴϷFx\L{1TϟY;}VX,=:H4aMx;Wԉ9q&& ulWҝYr'\sw>egaQ@0525Z RCam\!ݻ{A\_\R[$&$U&](MjoNԡCJ2LsLB"*DٽxrN)BfͰaxd?!O3e: ttvB-2D=|#}}Է"nؐQ dXhly TqջXl}HgJOSN_A0-SvV~~Ԍ2H/J'0iptw!5 h9r8&|?RЫm(l?E<52GKYa3ReWDW[ #[U.(Tx5_{(6pAb*Y0+(`Q܎K˳deR-e˨A:gLC)?iR/Y.4ձv bAQz (rUTЩdF֫U\;q*N\*8e9+' چJ%{+YYs/C=3s-t:^n{tČN1;Zx,DkwowMWDΎ/d1YG/v⾛bgYxY4gV[XŧL_{t9pj3k>!,'1o4uӧqO]w/yߌ..\3" c;,O9k++V%ѱ#Gۯ迸Vt_fM7!Ыn!?ek~_F g_:R^Uū_|eё[cD*7ѥ=Nʺ?"7HD"t{}JF2S~ʈ;TWgºyICZH?8ѠTnj"9#*hiBQ ba24,5ŭrl75iH!9#Ә+)(@բTA$BӑORZXLVXRJVÐ щfO:RIJ B1,J+HɥNGNAg3I=C]CL*+9Ź9F<Wh`hX(ޥ_ZBl^E}߽l^EÃY<=:jG$Al_y[ bg`en>X^|A&s†/?ㅇή  d?iw1q֕6Dƒo3ۛ浿0~ZH>enOa;oX[ ƺ?GP⠁SppRn=G .|367xt@c@_6~i )qwqʊnlD,7^۽sվСow=NȁK}nW;^vNNz'a=eC:u]Ѿ=:/ax yZ4*5|YƳO{*y'X=6<1-[nI=<"^|nzD"w,Ϯ­i'N~wC5SUUxyym!Rؠ ʫɼp_Dqysj(74`ogg|DDG3Iyr9JމJU#QTա/*W'Gz=2ϛ[klZnu!ADGk9F@iE%В*u"Ҳs).&LMMh4TQPR .;QfC{d ;(qwv&:r^3y']6ǩR2ϓSP`6hlfĐpN֣=QSWϮGфDJ**hT6BŸ:9qcۥEhu:VlԹTiW/xE[Vֲ!v#> F+wT oobG2wR,&j\b?]'(lld2dn;G-:5;v?8u6VQ|n4i4?cgLY3qyoWa6iS/iJ!mXݽ'''FaVλ^y5T8rkVr A>xsRF$9# ;k3稸$\-/hK: o/N IDAT<=-($ #u!J B"SPRJvA#;?Ҋ*]pGam\n$È0zuz=u h5JJpqt`p`O'LAhu:Sk4?LrԜFV %+Z!=3<5 BTj5 JlrPHv}[@4(Tj{rVeHT!BtY JF겋t_sR_jkh@ 1P]WVƦEG,zLNGum-b[ڗT %@ThP*d}rsa[ aG{> 7J% uS }~Z騮 C=V^C,]_KT~7Rɀ7|wuV̝/W@ؖҊJ:-}ږFUSN}zn 7i47`k2U & 2O+~:b铼yC- WgU/Ɔm-b1/ {J x{"JJ;l(gS! TbPwH+ǒ냷{xؑ#ȺGEuY@)*+FD0i9T2zX9 ?/OSçTT`gk==B䳄^hb~XYCtVV*<^J.7W{ccmݫS0UUZ?<7H%>Y@*-}%b1.}Rו%/9W uMz~3 ɐ;bX,#/}OJs-n($kpںivT:M/R^p4tk5E#c(櫃:-fgǓ3zxu~y >Lz6 ڈ.NzSPZf̓hc XL"\vr TJdVH$"ߏ\С gGG+_P@@@@@@@@@@DV鐈|juDba1K@@@ G^yS{5?%!H$B&$d2CSݤE>0[G1)8fmi. 2W-`jyδ+kӏKcĈ5 ̔};loXl iEn/X,&<0F&5rIÆwga|.rwX.4(H$ dOs LXndD8 J%-j^ё R k6Ԙ8,ǂgk7?+t}N?ԼʪmINсl6ݏRX΅y K?R&04a+a%Kގ0wO͘ř+PUv%_Împuu%""bX.? GD/|~ m;SX[ŵִ>X$BM0QBNɤCZʊbZm{{@W&||-ԬlNEGF0"|pI@ga#Eh{)֕NeO2cM*+*xIOMߟBBC`זBaMݔA :ft7A@@@`@GE@\ v  dD$`76r",յuQS_\FMWR2?sj:9ALd~ ѵ|&*kk̶;q K>Eʺn=Z Šr8ɬYbtYr֭ё0yyxzp͂89;y;%>Dvv:gAI UՄ º7\(,Ȑ`$I꺜˧A>u&4ZҲ\\&#<(Lt:] A,q&=2.x_%$gdRQ] zpuvbhXnNfeU*2rrU(,2)AA־bRq߽:2Ӻܜ뺅1nMum-߭giNjb=7^o"o iu ܜz 15ſ#w)GuZ>.!6a̰q,a?/c7DŽ=Ga^y쟄ws(,-/ޞ/^~q'';{3RN~o-kKjCtdnNXVNMỷ^t_fjjxk7L?o׷<Ɠ Su}DGFB&büSF7ټo?{s[%, Wg/ g@&Є}T R5zII>|f q;k=n̜=>^$d?c3VUSˑ KL}K^OV2 EՄ-_;d[RɺSMEof61؅Rysģւ\MsfWԜIO'=;O-`nz^ `Vݨ'QU*nψL<W8ywu|-@<-|um-g1$eB:H$blKF]69`h߬\ͣwĘ" ry7X[YaP\>O/=el%2i\'{;kk!ēB)bP4qB^iR9?ǏoJ.3jbF}w A Ey{s݌fo5ϓݥw]_K-X*f׭u;wcgcc̟:lQT̟:f5M ,^Y:8tvw[ U3gR,xɌqcyÏ9|3Ǐ#24[1gR,s&w3ڰhl͝0r)D" Oe=>uz \Ē7_6 4VVW5yww)7er7Ϲsܹ~m÷گ \b4zjT($R!hHI>WƍCڎH$bHd$&bʹ^vpcd]0'=z}};<_}c#  ǧ.U55䗔bocӥPOU"@c Maǡdv븬 yHNˋoޢ=Ϝkױ?jk)(.J.'۾JDv~X+*{[y{w=PYSck~))(Q ˘kRts2lmxxHn˘sIc"iWӑ_\LUmv6 ]\ڽEqy9eѣKQY`T6G|&2s#֔SRQ^ONGv~*nn8uUdQXNGiy8֡[iE%%uҧzBT)(xw{Wq>/uS^]{u gүk/./7˒,Dyzv)DxIy98:XVYEiE k+<.s0*Uj<\y/wx 54WT^ݭK9g 9:W\Leu Nxtsrlxxt:\N^dzqHv~|{e^/G;J.?4r hhtut*J%E"|==; k k+$@sFAX!i⌶(W+񴲹,ߥW;zz592a„vD"aas;:F C[xE7K(E72{b,v66&9&$b&J+.g~!#MڞW\̒I=m`g fvC)|6|I۶f~n;nnNϿqwq,aM]߮\͉bbGrߢMB~W<ׯ—?V}ӓ$pօ<~}99mVr9Nʢ9;}|RΘ `| ~:~p/ȤR6ˊH͜I8r֬5OKL;vP:?a|D"F [o6,WoΚ;XsW5)Y|zQ%/ 8W4 T<+nwEe|j5g32 >{y>odA̻SPR'/1 nzdft޾ݰu"mm~Ii鼹kjj7u2dnn]ϨQ8ƇL* 񦠴?d/!4*Ƥ5wPu3Av^>;V!JwƮ#GYj vv|\Hao1^r1>.y϶E?aCX"&=;]G3$YnEeeܷF\9|]G^4_n'@B9~ٴ^Ƒ-˓ ߵVNXP ~rm|ܨcO\y]˩șt<_/'7^+*;X8cZ}9̻㏚(*_z#e )Y|l96:o...y~>_Ay5W?FCxP8te6РThNC.]r&ɲ^D&rILM#9=ٱpsq6,u%O$ׇ)G!ɈO:ñ$x /Kx%b͝;:-/!] ^G?,%31QD"!37ҟPXYqIKXb# &7 ̄hZǟWU?62O-AoF`q+x%G[AV3odYmn]ROǍNtJő zzhl"CBܲgGfO%ȯ9bArF&|RӧCaY[_W":ftm|2ϥ2ȟ"J9z:)x˯y}3$hIHН>a>]ݝk/%4(1CcC|fjky/cQDS][GYi3u f9;"6:U[h_La)vA~~f-q f3ɨj&ҥ/~*͝3)?~wYkO>v.~Z /> ƍΈ641~߾Zn/ rV ;NJ,FwG:zlߺǏNP` Dpww'bhC"#;,' uINVZ}}xwZ p.wy vGio IDAT ?h83Ǝ1Zj-X 0rjEU5/a1:873!zd546|&lmx' ƍaHp_6߇),-#;?P=SFBӱh 29.B>oAEu5ΦpAalmx':f4n.lܽ[mMLMeBGF Aղv.RE#y&y&C/jT˓]Guڱ1l޷DPst6֌> oA{j"M7glcҨ.y&QSWðU(3l(߭)hhlĦe{k KKy٧l A;uhWy_.&%3$騮'3GRЀ RQ3g_c0='gx9"f2ȟA޺gGG1tz:7FF 1n;l(1?oDlɳgI^RB._q!FD 1 Hd2` a/.!<(De(jkM£"BF 7**TԐ*^gKWʟ ?GKAruIJ? ݽ_x< $8H\\\L% 2G{;oNSf`&0ȤRr,1 EFPHĐ`D,&dT" cc8Z+$Axp..FoH܂BZ-YC [XViaTlHܵ9,B"Ҋ *kj[[YQXܶ܂B:!r:DIy>w3{DQY)ec]j%r Q(L0Iy5ar0lv1`LyOpuv6Rh;{ڛsÃ8r: Ef®ys 2x`gGnAپ?I$ǁ僻% *"$u;w/.AnDX3PW_|ndr,1N^`s&;[u74Sk\,1Æ]KQC#tL'=,=% ClMVrKArZ!?mm}mocCIE J1gW4>+˓Ѳ5ߋ{> tH1:$4/QIz ILHx pttŅ苩 R)NN-N } "2"_ThOWz=m&v%’h"< JMB;X +<{ⷒ˻7+:9W\LqYywQӺkrs)w_:Ӈ][hϻ:55pkw\O#9#*ܜ{`=&=%`j<\a^-y3|ptsC"]P`Qo H+)/'+/` !s;#6f$IiiKJHԱ!{ڨn2 aQ,Y-!.!F%z)rRwDv^IWs%r tf}Rb,&2]GLs1iZ7&8 ^Vl'K_j.f  bpJjů4i4feJ**XVfOkh;dofykk9pVr9QmrşIM(In,zj[0y%l?x(76RR^NU!nBVs]n%b޸c]~BwONqVF@$?'$q;8l_4Z-ϗ@҉pnȝ5zhT^MF!J̽`#lѣp/.!Lڼwzwi*Nu6W_Sf^uqrD&i.NfP/-9ói^}ҟHȀqɹVvǦNǩtJtz=[0۷i>b"#{t=qxk7fu2Fo냋#SΑƀ}ǑdfFmij/gnpP v68~lnTn7%2Qè@ }*u2fgc@e'#'d^盕dO=2;|2çN@dhX ORZ:t:O-V-; #|6`g!ݛ7{uwg&ݒ{l;*u EuKLbQZQItTMMvcqD?~%e>8y.NFPTR#1gjvBL&Ǽ`b tZU^ѝqÜ 93?Ͼ@HaնHJKÔ1J?^^tn^=q$ 8Lrl+6_ci * F;͹ w|0~0Ȳ{S s߫K4.\{.Ӧ](,)]{Pb4bˆ}1 ~̝9ݣ:Āą+Ie9+XWFzv6"ۇK-C`زo?dYàjq\>PBzsO_}sg@Q(6]H|cuq*.:vt?ƸlfLGV8stE||% F#zu邬\v= 0b@t Z{cgcaE¥KiZL7MƩx|";m Ŋ-H1(xꍷn1%""a| F9#k,Qh HiB6/Y}۶og?-xǶѝթfמz_'bkk5̼u rQYn>5yHJzA[k IDATɓ*{M[u(iS1BPS YQpiG8>ޘlѽNmƸq8#1gr``xчq:dV9O;O> {%^X?__tK7lӸݑ$ ^|x)>acN=cgc1ChH"qt 5 G ؋ D;x|zAp밡xxU~FN.&'#}h'#1gpIYc펝xk\7ʵ Ա|flwmp0yGZ[wOIɥs}c ֯/qc݀=0lz-\iQwS1VTY/.ǗKc;oB,Xmbہ۵n'ztP^xYXv=xh8x4J^~XXuף;G޷ dFdbArVܲsh\9\ -mǪm:GsɣFbہ|Rm;DOh"‘p 2 G@QI ~޺1kZmoqS֭ZᩇU-7m&]#If&N6u'oW68-oo<#N bϫ͊ 5pĜ ; Yp#9k}C7,!Cj}Ħ={]Hu;WcBoW~`}:A3=Cc. ̭s{}_,]^o~ݻɇlBn6 l>DAV`ce\ۭЈ"4uK"!cnTUŹKr*Ttݣ/2NCjf&ch>8t:/^sf;Uvl Hʂ"нZ/ňm[k*#' QB`vjN'`ϱxr z?/}wChƬ6NCzv6ѿgkuK0[m>]zK|}1WJs=۰嗐 0͈ E4lEBRR32QXR@DGF"^^4jWQKLDRjiPmRfn.NĞ,+ߣ:9PUg/\@Rj{{T8$ggtu*p% /A`!*+8p)DЫKZU7Bo%#:ٌ;;} &< -)k[ը( b/&"9- vYFvз{7h5$$!AA9E%%8q.EEǐ>\.1q:>yyCtް FGN~>u{ߛf߯M`@t=̼<b@ < k#ؘF[0!}`MgJj*~\+6oNb;&TND7 -+0{ pI'I0YEXS6EAňz^%F&r!ӵ+ 37:Q"0Oz kN x=%2G@5?dEiqLSO8$hDVػ'"BC==<iƸ[~ݺaP^>sL9&oM"""jD%͒ZQMaU\MYVBt qB"""""""""j쪂à:PU+е"XaQ 9b@/JFcPhxzD1 $""""""""&-F7 B#9"6AD-B"""""""""j6ozAfW`3hyzDB1 $""""""""&mF7\!!5DDDDDDDDDԤ>uB"""""""""j$-^uB"""""""""jD1[ :cHHDDUUDDDDDDDDDԴ"/KׅJB""jb@HDDDDDDDDDM–E/W0$$*M!5mR0DTOʳ``HHD*- 8!5u"Xm҈0-,$,Y<="jdUAbwc@HDDDDDDDDDM(8ZQFoH͂,2$"̮(2aUd <-^ۭȵ șMe1*1 $""""""""&O#RfK$E CdmȵE#bsߪDDDDDDDDD䱂:Q0=SY0$$d<`@HDDDDDDDDDM$RfKDhY%zìPl bvfR~Qa@E 7ʦ(ȴ` 5"UUg5fV%""""""""&-FozQ f7NQUd[(aP@D[{`DDDDDDDDDIF-^|G͂| *%$jlLEq Y<7Q-J I݆ly ZlG{F%""""""""fA#rBDh1,,ZVQUd bR a~QaME'pBzcWd 0ح ݀ opQM1 E T!+C>fX^D͉Uk1թJDDDDDDDDD[|ނ"zeېi1(Q3Rl"lp "݄[|~%j[̨Zj~Q*›^NIX[YMPUq%jjLf^-|Q3Qh$<= *La*Њ"uЉBtSUv+ mDDDDDDDDDle)5}¬ؠ,'lz#l<#!5VEFaUfŎzXMH%v+ ƀ|{00{"|u \|mѯ]nTM됔{O€>=/%xbhoƖ noٱ0CG׭BFqq|:K١ )];[q@϶xeTTs}d_ޜ:]BZ;ejal(<9jcnǢSDZ..Ʌ۴|=%O[6x}tz͆GV,3m&Cz%rJxp`HeG!>._k%?VZa0oxi4 x}!ަc}ٌ,w9`tuZ[p.3{6NEʳ1Xy4R ܵ;4 c~^ $ZIOsm#> vӶK.̱{G莝aN1HAkNc"""""""jT4<= j"3$l Z]5 j+`+Ϟvcf^ HVbxi4ZXr>qShyHr{ /DՊج c܇ IE@6PFqW,έ . u`y$%6E#\n_y6q_+TzU|tZ[,Uto039eDUlx( ZWZInɴTLK <x6+YU7ٝ'.=2)IPU Z+ ǟ3cƹQu{N']Ʊԫَu%_;Ӱ!#$kߕKX0{.FD:]GlV}m68sN!B|vYNge9s׻>Lt'hDlVs'ʄ((:Uw^Mfß+fb2׷Fc"""""""j"위Dx*̊9?yCxnLcV VĀ@o[ώߴ{\~E*5D u ~2lLS"NL^mCrp^NW&MÄ记1|~h?8"1.*{'Nn=V7vm XVɴH-*FaWl:njD_9.+t>oڎW.!1/`\T4ޞ6^Tg7\,:uU,y '9X) t`3Q;v_N[/$ja"*~UUkW|o7~=uN!QKEeh ^"6 "#l@V?s fY`ȿGC H/.N~d/^<zưHd<^"@U$(l2h$+yUO/w(vSBlTjm~uk*ݮpqxk]#:tM1dc{SR͆1'όӺNFvy Dsv. ͮϱ;iEE8Z1:^G[zH+qvoEJaGbXY(x}+ d,+2ߘ]׉u^*w}0K7c!""""""jɴEk4( fRfFx-Z"UUQd \p l8xxoWSc:F6IԙU(% ^ZcbtJLJG*tJ~=viVrnsm,2B\tc;uvyH5[wVJOæqjVT7٧ƭ2ܿG<{f `RQai0lջm٫/6ɴ2tnڨx fG:69v&ˎn 3bcB6Ҋ`.kׯ/B\[bb)=|qyTm|m(}K~n?,چwnZۖۑxI}B9ͱ,bJ炬%""""""jtluH Q ̦(Ȳ"Pwٙ3v̰)g@J'e p+XN=9r,tKEuSvw#1qۧ6sNZ ڵonFxaJDUH`ޞ8b{]Q*FDvq@ط]&v/`Y̩ᣝ6ZEՈ@xzL^ٱױ']Fل@ n=&.[.$o&Brj6EɴPTCЭud kW Y:`yUXiYe-wj(p,cF$ǓcYK@<6xym\lu{M/O""""""@#Ji:QgnI#@V oUMV,04 +yҩ3>sv7lIN=4pwQ)/ \Ie<\ o!>UeچbN_9_zʫtB W q8%Yt jƄsP ,F8ϧw=(+qɑc3"dUŤ.нB },U]|XԻC.UZmZ`6!c4 "fQٵ;##;_GW1M8v$%ispޟq$,) jD>vz]BZC/"䙌~8>98vg33p R mhem<+oSU(g}k_ŌzEZM*QK#6əN H`6E-m;jmhNd_멪 Ev E6IIBD`PzixZ*("[{-8aḷoZqBtW}W.W[TQ]V'JOŶ Z=TӮbgq7%5\1.Z?Kf Y6i9;(QQUqYƟF={bA՟3ՊKbNbVvNxA^"!{kcDtl\eY.jńo>tHЈU>&͆\QBm]Q+q ]2  Ny0(?*P]A 9!]Gx @TV(vV5"#lFmGʘd; H;ъ$QߩMPD@ <8^ 2Pd1c0!+Vc>!c/^͞6eQ>3o IDATfcnد".V7@P6V}_aբB>8gOA>,9QiLh0{ dcJ2ŗ>ZA;*ox˞I>օfSg_2 jHo&YfNHT([am+iZ:YUPd 3XV$!1㠕$|{0$_+!ױ+{9?*իO#GcC9Ln3+͇ N -kaz,5zbCBi@8[JL g3ӱBEU];ԯꖪuѷ]>u^ںrq9/if܁1!>wo7|N6d;  ;jbPGR`eh%` 8Tڵ6FqQؘ=# .}W#䎻ոئ$<5ftryls_Qr}E:>uq-.#z Ň3gոny*=R@jnR0@%""""""jj$A$ Ex65 bGaP aSeXd%5EzQOYXȹ llnkU(Kp#/8OCxbˁ]nEDDD @,VPӣ*̊ ϛ4Q-i#i%;U-hm0vOaAW6[!2, #Pn:6?n؄QGT'O@"{z˜e;켄, 4P*̊FYPRTY LV|j;BC=="""""چ{z(DDTό E6A-]Uaml9ڌhޒޒzVԲ_lI_(B/j cɀ}j f==""""""a_ #YUm1xzB) jҼ-)9DQUeZPm1ItBW2 l@GttC!""""" ۀcFu OQ U; /7W [K5U#5",0+vXd{ -i 6P-6ȭ`Z5A͜5v{zDDTJT_zIsIVUحȱj*FـfR5Mh!jBf leϙ׀4+i,~c65;wc zvB+!"z%(54 BDeXLؼYVEF Q%xIE Z[:RUUZʰ)Ը@/6@K1 lhӪކ XzΣcja.;_[iNLɌѝo$ed:}})G L%uD7$&xuoSUUq%ǘ;On+8թc9EX @D6>WTk7BztL L%DQaa뗈O+n4;߯]πщDApJPD>VUMQ6A̓0vd;@h:Q,4ٯ6YU`eGXkU]XI%i 4 `v;Gyz-ï15UqW0ɧ!+  }:o^0y,zmi=ñɵ ᯟ\{.NG>_}|!Qug]ǾQxaZC"K(j'э 4lg0( *RVaZ,0%D AаʫJy*27Zj# h2 ɹ9NnI~&$xч}>^F#FFྉ<=.㭅?9{p./ #Bilv.Z UU1WOL>C"bL6C!"z%1 %4;T6EMQ`@g@S"b?_®** l Zz59xZx0 lڰ^=ѱݵG 9G|}{t;o.\~1^IJza`7[w,7.(?.oێ¢FCMy .vzu`_wᓕwrCa`١^ؔ,ݶSQi.;|u=;`swg΀ ܾ=}c96o蘚֭1Oی'IaRl9zPCC(@WGPDH @#E!]U! [ٿVO]#5zf٠i==ChTUū-t,i휺pkxtx~:N͇mi5xzzyNۏoaɄ,s,C)Çu6`!bwĉ(6> w]Ժ/tzn.هdC%D0~@v⓯>LV0XW9" !pϭ\Vm:xSS ;_NKwY~SP%w}i]5:'(ft0$!;IB` Ǝk2aAI6A ~}p SU2Ū@l|jsDjv0oo5nl?[nթS[əXyN0x1-ٶ ))(Dp@ZSݶ!VUGQ";թ#f5-(.ƃp\r ae qu=lbN6:+N.ok/`p*ףm F v8=n,۴jŊ_wXd ½ƻJnarcW)︭ϯ r(R]P ?Q#нvY8д)@Y/plףM L2Ss Zt",޶iwV߮c{n=\ъb}4SߨaFܕJۏwZ{'܊w=|\k*|%>X]y+"ڶyઢMc@ 丸ڽc$TdEqz^rl^?˪uEK0{8py[~Z symoE|R2f/dT:mV.sF^G{*X?ZF O?r%{ue8b<9n ^},ݶe۽׮Gh|.͇8Х JL&#%3i5{aX?+]\s܅.ccufW6ia[u;Z_9Dž*>\.[ ğ:瞩B+F0c rZlǯUXʿ շAr(^N6 eQ}{cAy$}-{} $}wxgb<2c^*6ͅ?`mɶx)*mmn_?]i]׈ᶣE@zs'MQ@'?gՏ"/Qc'U[(9/1eu`X~ǹe(6ow zӺϟc'ⓒynQSPgc>\v[ ^zu94]ĺ՘8dxq 吀̝<s}\|cvo،#K/s=kM:Ix[?={?:o;r Fv<>鹹s7^_{~߬]r#p\\N6 p*xC$&Vڶ{?-Llonp<F&Gf^>?rZIr }-\NKw9t/?E[),o#G}/~c pJz=X[/< }N?<}jaSN9.‚XzBK\/|p\ш?_]S w;W3.8(KwwA[r%>D= ޓ Of(1tяօ6"b߅nJƁE%Kqih*azϨO,MsfVy?L-O`F^a,jI񯝜š:Wh6l:vwGfX4n,Rl?}v1 ڨ.ѱa}.}}{hB%o/< d嘶7NT67GUa%")-1IIJT V Eao/P̬,Z;}6_.xߏKq1]d)%^}':6jD\]soѸ:%?+_tY`^gg 3֭bWPSӰIl<^\m7 ;>l8|Q0Nبb1D F 5- 3۶%;:ɓ ^bj\;k.­'NgNC 㧘r5Re2@c󤉼6=%0{n^p]_92Ή[V@u?_Tjħ@&һp,kss^3*xz >%Gpd$;x*"ZQREe9؍u!_9Y<[qדɳ(|q 'X;m2zlh6LX l߇Сa}=w!;M`TW%XJdfeaռ:=t܍[|KSg0{W p;pwU ;[d[f`Xan:> ZN!t[+y47^8'8X#0<=f+A`QQ0cFn͚`ʹɰJ,8y nJƛ'~5TL Ò(QB(1B* ͓@Py ="DvnՂge.# lkMͲXe@S~wYؤz5,j-[h,]kn&T"\$%!&) "&OҺ4YNFDl,֋vddpjٙ(]w0su01}wܼ}z3|=ѫӄqEQ\ncCA|?bCAc^lc^-^G36%#NPT@  @"&Xi"PUPK͆@ <‚ aoqU[z*|\]дFu4^Vk *5T 33N | e&tSjW`8ǀvmz7`H{qX<6q#_kš6 M+ԽЉDzIg4-n^D8gX *Uh]vh=Ť oXw0s;G7,7Z/!Vw Nx z`ƪ:"62rtuj 8f|Q:7nh8KRZF!5#Y9 UEcƒLW`@{\$^\7p bk'*CDEwzKD}S?ObhèU-a?>vC ,6 L9Ԍ ͔6Mt9 (R4S֖\Me3 ǎŒux hocx.ʹaPۣ+,x<##_; g9~|\]иZUn12.^qQ?Yk B5T~7d~Ðw&o,),X7}'' QD`鳀Fa΋׊V_cx:;kMKN?8r\VyE6j [eᷙ_pԲ݈-Ki}u}?y.C L?+Gd\cb+!o\*/zyr* ҩߒ?kh!FЪ[ Sdgg<,{-Kcz`QO(Rd["Pyiu![Fܟ\7cDb֐Aݵ ︮p1IIqzdzFΣ5'GO0`";t:~Ym\"!_gyFU~nT?tK=b=J%*k GzֳX?tb(U1J]2s"}Zuu @o1c}mlEw#"ԤF3h(gZ98ŹnՁq/EQFcqnds_Z6kWw_ocp047a)3+ "i%8ӂeN &EAD1014hҜ 52gg)eQ?-C~~ a T-tvB:tR6nnfqդ)5| []|cPv"]'$sK,MGOT/ ws H(v$uƼޘ{ q'!bu}z⒓e)x> IDAT3>}Q{zdT&{Q.;'c.G/FC{989Gsso6P]~>jR<9P@(A4 <2Bqv@!gѯMkB"!!%W=Ԩ.cG\ӷnժ9$"׸b3lL40}.ѝE!ZG^Ex˳[ߏ-ԩX}۴+߼Ծ-\p? i,;J{9qLi! ^B*wqδ9p25Lnг{Qm-nj ڷ=½8ps}9^0aJi*WLӷnQ+z*CC~¯z톿1z͙ #(<G^=UnL/a˸uIܸ,Ϟ㟻aG[ѵkOooYYq7 )htoP 23Z݋p(z;+/[͜ HJ^^6NJGto11Ю~]\zks'Z׭jk}<^s \W@cA3k@T4ߗrJt=ڴ$HLMxmy^\}ķ4sɞGêUc\?$~X>^% FȹT1] o4RHe5Dyn=e,3Fp\yswıȸxl8|U|Ѷ^p {щh7y:vOg'<umۨZ_AѲv-d.>NXWsTrsJ |}nİ.MVybb`e+U^_G`E^w^ģWTs{s} ]\ШZצ( ]6DweeƷ^V 8bʹ9͉EلQ^EE\r t?OΉ,0oޘ7o-jDvN.>xO{l(@ BC"aͪê?o1@(9XB)ks"zlOq?cQ+zyb/W931qjNzgsff$Ю ~{@o7q9774q?M`xNܸY YMˏŷ뉈KN2 \ Lh}˜Yr*ryh03æogO/ >-׫\ ]1\Y:yD%p"\_0 ~< MkT/.>/.8j|U:ɿՋӡa}k 424my66X<~ O2`֩QC,7[Aػ"/P 졃-ܱXPCE{mX5oLK} )l=q vg;M:ұ=Ȼ~-4oߠ&Y-&azkN2oɉڵ)*0X=[\M}\>Kl?}i nTsJM:)IVOq+W(x tm˿w ;~CYzD/{pr+$oP VY;ꛭs*7=6b Y*Z3 ]W3{ѥ;vs.{j~eGԷ?ɉHtlڶ;V2ʣǸq+jcagMǺq _kKО;k}ܒm;`afCkU. ׼p gu( w󐓭-v7#GythP'M@Bj 7gYѾA=pU޼)ߴg ݽmAʕx.'+s)~=D+e͏dh1 ˖+M:<mlM޸a-˘n]e,T1X?VRsw+ԧglk0WwSzvڑJ$zb.Eש`hSIq9FʕrsǴqaj=bJD"|;lHiժbzl--|җ {i VR_˾`ԥ^ q  S.+uhК__oq^?^={Aӎ\lgg}cGaϢ=/gg,?GTbq1DYY_H(ĸ]ulch{/@F ƸU*ԪswC,->_MssEѩQC ]6)Kɸ`tv+0k IѢvMiIscGaF%ID] cI7@Bv)ؽp'%Y[&z{n} k&zu_RE\SsSگ-.+>zRK.A=>haf9Æ`1{/0z$-YFժ|;:bΰ!vUϏ@ T@܌>_4 )##4~.4EAА2 WƠXC E&.) _ CiL$&"!5 2XNvN# 3npwt,+ύXDC&ς5*xz$$hT" <ɩpwtC -JH;˵<0/q1x{r726֨a=YIШhe`m wG=%?R222,l@ME&B`x8a%5#\ Jt'@ P';Bǡ,*r!H͐U}O,o  SW\D$"M&DW|*lm Z e<4 IɰDrFOȸxC\;;x:9„3ߣTd04 W{{(e.!IiP,R9kX$udR3`!ɑǴ EXt4ڦб3k,4y}w HP[պ!b5ˢx̲,W{B K,CC!g HNI@pd$R22`ki 'G8ږPy *8@([+2b @P,rX5D ` (ŵزZ/a@>q@ O $b0N] @ |$2  !Xȁ J5˅!3P!h0sahJcN @ ,˂%?B&??E"01e %1%|!MA0K5K @ Q|.@ >"4EA!WvQCQ`@A 9 9ĪAQf @SčhA*\.>A @ x5v11|1 "CB@*BHӠ(">Mh!eS4MR мNm\A @ |QeYr@ (")bef 4D,$|n\[H1@bYb?\xՅMi@ !15 r9TZe"/ʲB R@V"9;A IXPUCV% @S,f@6 WV8vji@  . BI ?!nP (HhRFuMJ |L(  eD" XBMjJ(@ @BVc۾mi@  EH  œB`h"JLPsZ@D%H5r xXE!@ eҥ =E u!h@0 b`F aN !a( 4QSP0cB4E&V% A0 vQ@ ?KBmOwpup( Sf#]] >yT, PY@(CE,?:D H<{ةIi@ @ S õ0G7H.@ ,XeeY&% ejV ˂Pi08 -u@g)pUHbtibD @ 51x*Y횥]@ Qҕِ+Bȳ.T,`Vv\+ABق@RZ.ݽEv6$bT,ͥ$@ @ ̬,2[y Z /W[/E |P,2bCH |$C˒ڧ 6e(MZ m@Xd)x&@ C+\(H B@*A 'Qi, Uju,Kbҕq(*](P>)@H @ @ X Ċ@(^PYX5 K h A0Ӈ%LRJ*P XLEFEM;T+.{EFB$ɤd2Q_PR( 53)U*(JZZD!)56tu)릤mt DB*u?6r9$,E6ܝ`gcm0OB@Ur`>}o\Rba!5j5^v(W(ZSS)(PFc&ͻws~) g{{BfVB"ޢr9_ھ!RRB@H(ܝ`g,#cc!ƴTDJ$purT"oo7WXYXk?gTj5^;,̥]@ LB ˲`B@ZY'-F( h) 4f?K[¤dXi n>zlwbP*U~ G4ڻOk׹O0uDnڂliit.߹;40nĎɓ@)ȅ,qu,ݴ'._)>`; +*)RAR}8xK7m/OJM[tdb-s_KH)rƎq e?c/Xڶ_4)";w>L./r}l"cbtg6}9"7qyD1z>z_9eȰv.&$x>6׿/,!!͕OHJMYOJFH`kvMUՈKLDvNyn VA {DxиS(\\Xl4_99J } \g{HD"< zX+B,OYYx&iBEMaa\:9- qIIEdL,J%Qˋsexp`d[o{XYi`hBJy^G@PR3<DݪUPR%xҒWdBNN\k@dJHNFP0 ^p>swqFm vYBTTB3A@H22do >`t\]f 04 ))Dr{IH@|R2`APTQ",͑! Q,t0d( JD"T˲xP˓sٰf !OJ K"TWT Ê>c,Wo/WДWkRP\><=T"0$k4m]TȵUJNffe!:.nNF]FC*ZkXKdgyvNb@4\ʒT"&>E[6wt$ VVF˥MbJ R3`gm#j@ XJ11`h]$$@=|(֖zc a*I)HIO,.(3rD'vQ0 '{{#( *pqXETlrJx8ܴtY&l0eY1X9;덩,%&A,$,mt luɐe"61֖w.1ئڏX,Ѳ#)%NvvE)@ \ \ClOJcu< 8?wYPP,&!B Pj,es `. ,(˲&{_EbYw< 4M~nbIJA@upYy]ZMhT&q9?} &wE\R@,adhӸ`馭p=1;`iq}.ݾiw<,Tj5[E'a~i>q!hR_##3X7aȐericiÇV<eY 4"At|< Zy׫V]; IDAT}~xw<=0/!Hp; ff[Na0{W|ѲK)UH$,RL9 +T4aQվ- ֿ ΆRM[z3ga!5+@A{Y:j 04/^`tqogryVo߁ Y&f58t,hٱs)53Øq.9- kw\Ral8rݷ7^x(ps?qe3f 5)\+E*"8<O}wpOJƔӧXžgp54+au0gXԮk%=+&ŤsbSWͭCޝ@ F!EH |P`PxlQ!X=euy jҠ(Z hb*Tyn:hB@F?6\WݧPbXjזwO۶5Ұi,C,M}Ѹv-]{G-\\YA#լT7j[~7>T"AΝЯsGXY!m$.ݺ+ۘ$${֨\* Dt#`c}p Rp,#SG]IfI3\%0*)/^pWϿ4 $M[ ̮]ZgļiSe/ 9bu/>\?[MyO"l!n1LzZh:oW|U| MM՘6zxe|spuu?~ Çaҗ(il~.d95 W!5#) *$>5=E7\.xg -+/kEeM56V/D|d>|9|?w Zz:˓|Kclmo\"QQSڮeV~WliL; X5y"? ^~Cmܝx +|ĉχDRL4b/ ABw`K/WqX˯BiSlؕn ˗W|-x/~/6|qmm tv˖<4>{_&!~=}5xO/[nƾXyٶuM/^}y/hmo;vAk7oŒ_[7h4Xq3b1"\xчmnݻr ~4ֽqW [˗}EEnFߏOê 0gd|xo l9:my*4*jjɿ/eL&""""Iq-"+Q1D`'C*@&C&XXm]m@,lWd8$A;OWEEM <\\P[߀xpBzTbk .n:B-vڪTEd*K Xs(Dlx8c~nD"X:|e!fpqs?TÆ/~e)( [A7l(&k3nzK6kQ#=;;;b1&_3A;4E8ш^{Btz=ymauLa;[𧇠R*qx쥥mhSfa..C*iRTVP)HD?5M(7͘5c8L;0f}zlNk\RL4"zzb1 ' -^H%ǣ/46 Q|A(r̚4Ͼ.ccvݿ"9e/}]=هʚZZ@k }7ԫ)b/Z̞<0fFnݻ[q/E7 ,{";55pCB" 9&?ʐy:1axd"DgF3xA!A&A,q "1kR5Q࢛ĉlގ?}GE"q1p 5]ٶ5B.B.ǒQRQVC|d  ?W ڤ NH$Blx.8;8@"Fu* EBd\k舚zmNJDlxWVpw3ye6{&>XjkQؕ 5褑#y:;2ﺋ L*\L11,vR32;@3dPdD[t x/ d?R*!H JͶ#p׼9B #aT4RbQoq7# .'& 7XF&j?͞TTSۉxۄl1I/*Ǝp3m%D owwF ׼ "IQJ$tsţߊvt_+r$  ļiSy:{v?̙:~@jFĽ ׌@ʑol]J]bRMDDtaw2">}1gdJOL*5N"#9&+YSy!aVAՙT(ގH:}<ၢrW , n(k_~ELh(0*)lή0ӼxݲHX{j{Srd|px^_9r+ TGG#["c0&t:#"(9(*+7 b46' Q;n%][#;i+* QXZ J:9[X+0!D"vY5˹ϯeF$l̝6caVZ-<ٲ']n5 غwJ**ze]Fs7"tx\Yt5Z-^3a83raYYpdAFi{{[Κ^EYչ kA8rZڐ=9&1OWW,SC\D8""m Bz^_#k|~߶aCX*zuJJĐPE[, gw olıS(Ff^~WI=K+o6?P DvdR)S:ͭ(xl Q!8 Ǵѣ҂SӸnܘ>߃_DJkrs5ywh:QU[&7a)ouY଺wW_GΕWlF\{k )hni ّK0 SB'1$<Cz \),0`PAN*4~0v\;v`*L9l;j +u2&""""Jʌ/q""ˁ߉J(? 7>[N^r͵pM):Ύe[=G!O}[ь 56ⷃCGn:]WSۉ֮.fH cte*&Yʹʭ=osV!*$::+]jq׶s3e @W~=>{=O6fk[l^mT*gf%؉U7 ~~4 P)rcq <[^ᖙC&'Ŏq8$>~5tz=;qxGہC}kHGG-8STl\)#9&+"ڊ2DO H_K < \f}-m0 mh85oP11f⌷XJzzZ[RY綶we/e}|vܜߞŽq,#[L*mgZ75kmoN7d3X] _oRef/ADDDDtA[ M"$"? Gc_"='g Y]WىFJLء8t"]-v:cFޟ3:;4+Zѡ`ʨk(Öm,Y eeawSugbU֡UH{z{76ϙ.@Vl޳NcTܳ`<\]_Tӧaq7^/5R cWMNgX 4_~Qkܜo?و t«g;\n/EEp6^®Tu][Qcj1ƿb1z=򋊅mjK/>z`.߉GneVQ]cSEM]uǷ7`q򜂳[֎'ƣwƚM[0">^]sz^7n,7NlJكo8Dڧ36-.G}/IT^ۏ,IQm=#폛gkqw Fu"tblVh4VQQXضo?!aXy+87g]*Nj5dR)&_3R1]S_'c䞔 D"r5u U ,t {R{oه`?_!+puX)fD"̿v_; X\pAFP*5[lI)N eAw,JDDDD6R9Zu1`,hK"!: v66P*HySm}{U%DC!C#b;Nz=mL3745zMzN.6ڍ2,[P"*4Yg˯b8:"."\޹|%>]``BlfVV!* :56SH5^:Z|ja۾8|"0li)Voڌ gTA.!)fp=6mc/@}S|cQ˅̺SP؈|*,y97Vmnl>~W,y9< d"aݨklĚ[}ΆJ]7Oaݖmp0`d…MFB i"N?MS{*?i2}+Y8& f<9*jjC/*Ʋk!Jl|'dSav"!qNC#-+?󨪭j!:D!swsiu:ahnm`@xP 炠22KR!]E:ҳsKKJ~-Ǚ}k|jᱯ}|՚f5ûe '"(9g?:oD,Ax` 5:tXxSŋ7o]O7Wxb݈2CC!ɰaWJ]fî-ܫvv`TYcL&the:6ϝS~;x,{-8xz.q^Rͮ+XߗF䚵(D?xJ ߑT"8l&ԓ "7atR"mmDbuBD`okk5#o ]L^}>D8AYU[~x,z ̛b VZ46mu";AfndƑ8~..(&j5srq8,): =:=\n6۲MXvpRu-'}ǎdn.~%L HL±S8]XD" \qn۔Qs0ymtv m]|1c8lص_ 6G̟I9i~ٱ7mM#2`0DvfOd|Lr"r {,1S}h?` P8ըklQnNP .piHEie^x+H3ӧbx Ξ ow7ۆ1>9MԌL<;H;cF*..U?|q بTGzN.##`gy_< !~FLD"4x[ VN> Z,Cʫp ]5)e (x;58 @BT<;4K|IG`pur0qݫtu&[\"QD ߫[f^׬CUm-|q<3558`Tb"6JoHcTNJI&Padۉ Agg'~ͣ IDAT l!Z;p=!!*EeHݿk?=aeyL2[bD|ꛚ?8>>l|*{zO)d: :v>I?|==0fhmXɤvwGb1FB*MM } űs!~B3W'GWT@[̴h9j$DE""(6*lJxx@CcjaR!*8ѡ!u0cXINVE7n=K2,\O$DF "(*T %|}/77D^`o U0,v7~HF_w;*$DpR5duR@lQib- R(gRɉhtsL  ﯍J x;M/.\&Ò تT Ȅ8k4(BGg'F&9! pM|<4NUVccq9{`o@գj[[,52_ dR舨`$FE%%pvp"Eetuns O(:*1r gKKq13upb*64 2(.Z(F[?/O #׼\]Cb 1&J%x"RnNNhnmEqyBow7 ujT⚄x ۬T*+B!HV ²230:(j;;L1 v66hmkGu]pX;."aY &Deehmkè9Fᚇ!"(5A_>6^VB<]]`oh75"ƌܩS{#+j {; gʚVV"w͛G~s0"> M(.#,' 󅳃C^JDh:5(*+8he~ C"!IKDDDDG$f JdVwh^*..prps=]\`g{e$"1lIDDtcQ"""""""""0h]DDtc!K0.DDDDDDDDDDH!K.a]A-c!] $"""""""""H [rych HD^%"`DDDDDDDDDD$bQ""1@HDDDDDDDDDtb > ""Ac< ܇ADD4( 'H{rѠ0@HDDDDDDDDDtl$2Œ}DDD!R,4JDDW .T$F!E`+(] $"""""""""HXj ]$,5JDDW."%"+DDDDDDDDDDLB"""""""""L"C-cQ""21@HDDDDDDDDDt $2(%}DDD0@HDDDDDDDDDt E,5JDDW.HGr.!X;)#$"+DDDDDDDDDDTXr` Sr>B"""0@HDDDDDDDDD;DPK0 $"""""""""(%Rr>B"" $"""""""""s>B"" $"""""""""9r>B"" $"""""""""E"8ʔ0R"er%|DD;p) $"""""""""\lr(%}DD?@,I".'21jr)!uox!"""""""""De*E}(DDe/U@! $"""""""""$"eJ0DHDDR"TfB"""""""""+\,Lq@db1d^ $"""""""""BHd&Q"e* ]A2b> "" \m $"""""""""8}KDD秿0DDDDDDDDDDWDp+!ADDdLt@N2Dg"""F"l $"""""""""Bb8ʕ0*K).DDDDDDDDDDW0Xv&X2% ]T}DDtp)UB"""""""""TyX$\ hp2@HDDDDDDDDDtp)H/a@ d*HDNӮDqCR)ӝГ\"Rj!n6ut !0Z;d =К?&+ǮЮ4{]MeOi`0/!b:'k,zt /JLc hzϑӝ\kd[g'JJiO""":>"~acX$ڡWI56Z-:tZ "Zh,,G>Tf~t7VڼeM;joouN zb( ЖVMljJgAgѥ'(WBv2@xIOê(oj=fGD7 Q؈v!l#qmx$>qΡ}x#e'*ej553#czVV'FÒa#rǎ% s*1/--:w$ \Nu^ٹG s׌Ƽ8u?z]n75߻w`k^􆮭KbLXز@Y;['njw]Nw`Uqh ׆E'oDqC=5:̍ݣ%Ÿkw8_E ŧV_7_.X$<^s֜LZ;Ye#<7Юćc\P0Ư?GyS߻3J=t8 @!]t93OXu)KB)b}EX^mpmx$4jY@ߘfȊrwSc' GXt.gvcH|.7c<ځŅf]?`![]y+z]X}dXs?=BQױߙ< ;QXouz^ٹ nֻ[rMLm+~8kX!xquqvaˡ3 s0%4 0AofN`fd ^>_ԈikJxjؚ=38vma~xfRG~^;z\XnjCgb_ܓFJA>:Bhk} ~:lxՀ=ؕ')e 3X|w"rK_7[SQw I>xt8yz=V^V}cu{"--x=7l΄#abH4UhtoY39$ ΜXzoݍ/o\xGJ r9Jʴ=5}krvc|MX:9Cg0m nAz5Xs;r̋䡽}lߊ}p×7/mN3#]x͉R|wr=`+cA|nM>"+DWpP DV8wlL"ANTcni]} ~@FΚksV(z66MQֆ^cQ;@dlh:Pڂ QnwcL]-n_ ::fMjMhh,c]UHj4H)8 ٙooçsn9m:b ?c\9Ee2y U.YWPxos~)54*Lh{ נSC]PP#Ex{nXtΔyw_ >[.8YQnD$ƍ:.e(wZc~١բ+RMۉ'OﵾR; &VۗǽD"[GJC{J ? ::dkkC ⽼Q҂}gԣD۸I_۽a#66dY<~ #6r`@qc2cI(;yA\r9aʛq -bSI|~ kk ku Lm^&y |Busp-+qZoZAs;.ρtN6*zuvz^{׭BQC=|vnjhjuDDDWF{PiCsP*aPBoУ "[|v_Уܣد?xY)\mm1: Z-vǶԴ9|3ZѡBPB쪀sS_:Z7sÍ~ͶdVV CxQe#c--BFt}Bgjkp_w3sCm[ (nh3X|mUs3MMŝÆ&mhwsG JVR/J&_""tdJ(. 8/oҎ޸n!ZROZL?_9U8][Tu);^V߯Į<40jm1=,LJzoمG?);1)$ϒvBcN]*9{,@h@ >{<ǻR=X`VR)6u_pUI$XN8NUoW`Tv` ǔ33 {ڞ+_ g7*kV)x!V.W'n_֞LMfٞL qG}}(FYl@o?N||HGS UoqD7-F8z ٙ4@>+0v4ccvVBXlvw76dg⟓ Q-1PҌ9_-G}{v9f:Tfn?A}{ _X6:8b;3?e37SVkrHXvutxm|t|L PM~M75iaxiu㔂|<dWU,GLHIGGF#%_.Xcosn6\5kO'! <:(?m2?5q,N&۸Ig`k^G+ۀ'+QP{nKGE"ZtЧq7~9RKKPP?G+fm;|E-1}^-/ΚU7˯ B<'ˬO1Y`יx觵PJecܶh@;{&%ݼss0>$,~Uq\O{{|hZxx9sV;2Ep\"uQ]x/oHD"kF;_LZ\,zumm/|>o!> HԵAP) 5"3A.K&X$kkނ3?/Τa1Af8Z}Wm|Vay'ϻ.r@Ogj!D⸠!8NxlXL84| Xk{3 麷vjm;b܅븉}g0%4pt l >=~2`,,ݍv9}ܭbAKvM]49uH)ȇD,#F]>G v]݃.6xaJWxY)r/{jsLc A~X6w!>qyMNDDt%WXy9)u`@ UR {́=Pv`@]g|1]8)b^ HWwnNwf**T,Ss2/z5J!BpfF`˱{ۣCG9i;ygvY錈|e .Bp tRge pP*^^ .nGySf >F'Fj4}|{D358ޣq:J$͵-{ RY,Rh@]o>JK!fZݾVÓ1 ^3|QP_/G7|~BF@)81Gdeig.y 7(fG$z r1;3".x=8UQ~a~XO/$`j#5-s >8J \0evy٫13*+R [1H|7jko&UIc0/aS;u:lE^M5U6B]_}|a#S?C}}! gl({@g59ZZԫ-lcOjqGm^v0 ] frcvW x|PH9>Nc c=] Hd6 긱iH7wxۤ%B?629JWwm{SܤKD\mmQ҂\cx}lADDGѩ߶azX0r ]5ᩍ\BIRo]_[q^ވFXb vv 9ouؘ1>" ڎFXw9_>:7[;m܉ؐ̊ HDb AȪ@ʙ|/)A{m@$ȯ_w]wD# r).'L꿃*ͽ oĞ38ZR%ŀ:-O&h=gqkB򀎭٘q)&K S"`_MBJgNL C?^x\|p`2*˱t.;]YSC/x?DDW#%xfs=/j^7ɯY1K`zX2++!;jPcOMB+U>:_? ^zxcRHXu::z*|6oGycܛξ-)ž3c,JĘVｦJwb66lE*(Vtۥ/ qlY9\llq{b2>:{Ϟ~~;V X,u44hi l;rQ|"Vǚ4,Ur9>w3PQ!u]SX{c.DDDӊ#lign>ןO{;bz-[,,O/ 枝u&%H-$07&Mvɲ$=s=5M>=, C>+3/jضַdj5ut@-UQa$A?֮[-ϱW/FVe%`_AN!cccRhҳ/jp ^zN߶AIӄ2PyevcÝhx3ޛ9Z-*qrq,8z޾BgitURsdC!HЩxi N[s :Z4htA5He V.\kyH\wnU8YQ󰯰_?Do\k,`MV2 s=[ummfe1~O8躾Jpg0||h?>=| A}{2**V^3Oy= sd]ᛅ)y,'k؞tr©rۏb@qC=`|spĜX,:~ۄvr9}IR0ºC]۱|U^|Bh4Ȩ@zE6egTe9^۵}-f}1f3 A7605lɾ92V# c͹Y8ZRU-|gp|Ǝv ,k: p<1\M^DcG2v ۑROO{׭+;C)?SB]yhjUUؚ#%E ǨIDDt9Tࣃ1#" խͨnmU)N*ŚGoo` w7ؼh>wZ7fBN*WaWi.ǚiHƜ>ξ8lxm?zgjq"c Suʂܜ|т>`r9 JhlH/,"~fM+YYm9(;C.ru4""꛽T[i%7Xs<=CI޾`G9-ܚj/- &!Xz$ܳ{(:B0kNhI5uk$ )$z{Gnk1ɵ鱢2-3mFqC= f,!2#Mݮb/ЩnDdRb2b58ZR ' SBUrQ|q R q" UӚW77XIq7lLch{.dԽFnjt|q:Ps/{ ΠqĨ@ ĭ ɘhj$y^~.Nܚ*!n5;YUlnwx0}ؙfo1{Ng0`SN6nKm'qѧ|nOlq;ef*z9]ZZj8:a?anO\zdTVX Fy*>XJՠJ8wޣ훱 w1foݍ|B{ȨlGzZ&協|>1fTW0-Qs-y۟JB/,NHƭ߯W1@HDDōh`49f#?ٻ{MH#"QT^{Wvu׶{{m?2d2J$~s'ٝV{Gȿbb4QW dJe]X,ѭSZ;ä)?זMhB6]֬ Lll?\7ADzYgCچ~Jq9Qe)^ JنRi am||Y,۽tNNG˖ JKcPZDŽ>f{v$@(KL#ju)% /΃$7ƞ]{xbT:>]:봮ݱ[;k_\dgaPU/9JgO(z1!xWUl&Ss_!TbTT (¼9c,_ʎrJJ1^U;2/};'u}>tm?;w͚ϫLb38Zά[ybT53^N͟YBh%_~DNIjE4 `>ҋhђ1][VBY&M׃ӫz>1G*Mqy}ѳeJ/ʂe)a#¾kܼ10(SRDj2hU[<pȟ1N!B z> !2:k=>eu-׵?ZOXo/̛];UivIq8ן#7'_g0|UOqz! }cSH7n-к :ČtoULnPԐ6:9v9xe+]WoB4XF "+|t&NfQ#}#n!9:wbtHHdgn|'wL̊}{ؒEsG6<@jlܝ;xju'}'7}SZkdn^ݒ[I i?ۻ/OzF?7_qvWWE},߷>cSy6i!`9 ؙY۷r_08-sOعAkO4/6㧌_;rǞ|jX ֘**qϸx{1ھFUet2 IsB𫽆r>{k_7׍8X> ƒOo@ꦬ~uUu|S:w=}7Zhe&df}x8,d_›`@Tzb]~.wjc}?hd|( ihԅo 9:c0 zֹAezm̝ĴydU@'Fe_ƚѻNiEvq1s5GwtMY\>mv \UKWh/_3bASytԩ!5B#Ijχ":&e21(- >>db~bUQxim l8-]LYCYCVJYKWQlF:v"6AAa:1!zRKmդ/+&%EYw7\f.0[rhDEcTTQUu艼44kR6!ǫ#'}cUN}ذ1>! n`k zcMvxS#_=ydg!!1$.8.)fO~>6 Z:9n^vdN2 L,c8BqXěX s%@(B!B!G8M8qkH7E!D% `?A$@(B!B!Gs;pIP! s# B!B!B{8}H7E!z`b:A$@(B!B!G'BAQH00*jD/B!B!B!8 {zݑnBuJنAQ"  !B!B!QqFBq0V"DB!B!Bqtsk>rNtdX!`nF B!B!B!M#@b!hF3Fs B!B!B!t<E)BqD3Y2"݌  B!B!BNۅKF)B쩊BɊY5D)!$@(B!B!"HMf!DePTV馄%B!B!B!!J| Mt !h* &AmEx5Z |BQ }CUQD`Di©x8|H7E!obR nJ#݀#ժlfcNIH_Lbz5.ǍieXBQ?:#|TɌl&la~}x|>ϋ DB!h4FՀhj4c3L4ld%N' Va-lݽ-vG^a%NnhB~&Ŋ=6m蘖J.ا6kOCpda#N {lLb_]N %8dl4I8P!Du׋vz2Em>:;wUpx9x5_S!>Ej4mce eV6ϘɔXaB4&>ݻpI'p戓i&Q&KH*歽=^A+ % v[tBDWQt(AUbX#ݬ&>u(tPt dl0b21 UC -XY0!Bڨܧx5n7&`Qf 1ViշZ wBq0*C]p64 ɂ|uJ{ [J=[Imx**@ueU!DӣStS\` 96s34|ׅ%"3hRaeblEBqdiZi +d` >*X YΣ?f.^?6F)B!Dߣ^9D) ƨěK - pՐ˪xM_$D`nB&MurK(p&5  %b+hh"?+_ !px:hhl&5-MB!C[M˖n!L5ӔV !SQvIVa!hTE!):̂<7)>}emky%%XGEJA!B4I6SiV-&g %%x5^ ZI_N_tSBj¥,YnqG9ug`;b:GΛ43iIGBb4<ڞ)DZ@bFBTL$B!D* h( ]rj>\^{rۢH=AN _15MB!"ϼUkxX,nRTx6vdM3r4wB4oڞQ57/M"ݤf+@pb4DXB(B5v$D>%FWX/A!?s}WX(`"uB!CA!%.HF~nPQ3co^%ELK#-! IRp !yS Z{)t]5ge3I,\6MB!7s=s0'7M KU̶#`8 B!D+Cx0?Mi6>/{sspz F⓰ۢ"4!Be6IO$!*uUT\|Clر3MB!-;wq탏_X$H7QIP!*.C$i7{ssj)Ec6&$a6J:Q!BchmOC;J8Pϑtq}vH7E!hҶŭ?tSPP3Y7YQ2q B!!QX;ExD}ѱK]b!BR0Jg:da{_zkEB!D|{mY5l"p~B!d&j;jEՕ! _El QёnB!ae2HOb,x+v8Pp䥪a|H7C!hVcΘu؟F3flB cpy=#ES≳JA!B JD ayDM2ۓy;{!B!'_هy@%h=)B!GE[Ҵ K7eiE[cF9B!* 0J0;J+)tCAf!RQgџSVk0(\5XB`Qx|>w$FA!Bҕ ҚŅ8ͻ9sR̝f!ڟspF`QVk* B!DQXB̚(jB!U( iZUo~I B^(ěěGnB!,V{sb{u ët :z6(AQ1* &ՀQ9eB!hX j imOtiS IDATl,Y>B!6nf קAe0k2G=D  !A Fh[c)r:Ycyyd`PURHӣm;|)=M#hd1؟ͬ" !ϲd撜Pc4KHP! f6S\feem5[p0mrfZq3Ẏ|Bm4c3DKeg:o]`;f_6ןs3}BR"ݤ-[/n=5_rWy<:F6z J :6ퟅL7^7]O|l!BSX4r">YNB!"rg:H"ُjA H:B!D)шCހn\B @Jr\;!'jvv{j*[çiLYw1yepFIW%d؊~§SG3GPظ1.];oMl%$e*?),.p-7aYys{UKP!VNN|G v[OD+L\B!DÙ6oa&@ьIZL}H7A!hE)%(r:QĶwߋ__0!&+OMg \ӻ}޿NwLz m^]# p4 nhxΝO4~wߧi< r?!M_rLܒ'DZɊ" !∴zfNWx$Mu$$B!D9 ߍ d 4Mj2˯N;5;wA&A€8[ʹ?-!>:gj.6 Bs\;֗K*y'M_YY!9fw8yy?̣ĿϨ=xﻛnNt[_}C~QQY!Df16[(r:|r굸=2a\!h 7=PZg0dhSk@a1/B4e/@c|I˅<>q"t`檕M&FceM,ڴQsic4~g>[39\uo/:y'6H)f+LǑ_Yz ' rlcbP}s^vuhΥs8<cu ۷WXD6mhӲEضR[f ql+Rѩ#R)5ٕNtLM ފw젨Ԕ`4ʪ>U6}:xmAn8^|k9uCjB!>*b s7Z6otB#:p@о(Y " 6  !TE0uJ鞖JӁeіtVtEWtA^gQœuk9{7&|2˷megf&?3OR#nsxu &ku]n7͞ؾx8O3f ]K//yweԔZ.sjе _L [n']P ࿓{A׎6 _%cGg햭vDz^3^S An4#v?9!;.d :VTR3}N nM. ϯ6Y\f/Y~xWpJӿ4}&w]uE[f܈!Bj2a3q:$EǢ4->B!Z Fbf$l l@ !584.ˢEhQ97gS^φ S!n/]…'c{~vdeE=4{Xb I۶-ǵiCz9nIf[$޽hӲGt9#\}-[NYFPp̿qKk4s҉ti6亍wЯ[7MgEiׂb&=fgjwlՓemViPn? c<f[qDNu\íjQ`V XT(9~BF3}E' #6**p|޺ulڻ#C), տ?SZmؽ6l` rHj61]{kUnsvnzzڸIڕSڴs:J?H؀A¼B/X>kחҌΨ1@"1_x<&݃я?vI'1#/{ Yv .#s嗒Rz@NLj˖\uٜ]U,̓WPSFpجVc|4hU{B#K?SO<hf ܛy_/`U<|ld^ !82(BBAۅO9J"݄Zxkhתw=bS(f5aH65/~))+}̋h9(*n>ߵ͍P.͇6hr7Mq8}^\X Fl]B!=u;4ߩ mݷM{Æcnn @xLΌXj֭4s ?kmfcugT.u3_m̦",[ڼ,nۙ:W8I0hYspg0*ċ?s=wa&]]8?9{" 4@*OzS 5(k՞MmV+=!SXEӌy몭dZY[U!DmRtI"X7\%brXZͷf6|v+OמSP4w/+ 6+Ҽyx4gBm4c3ȯBq =.ܚA{TtȌBl 5pLcdhj9Fŏ'>m|z\ę,*UHoY^YFE\3T彆 <&d ރ ҒNiiAbث', iH+;Zt2,fPUpVmܾ=}_жRqszzҋftWFo`P^~׊wߕL7^ !hl&3:& t{nv3CwhӚ['\Ug oa8 g[2w#݌՟՟EBѤTN1-Ds.Wo`8^]#ثkȊB!>/%q@1R1Brʊ!,V|=[0./O v$RZ%>fՀ&;pVym񧹬.@U}SPTDrBVa: qaW%j>]<ti֭gٺ< |,o? g;N,]V3rk7~զlU^3`V_y3 iْc+Ytnז#aB=Ej4qٹ/{^x<ĸ8.=O*#,jiBfv׮cwff( :uO$4rYy [vzvZ`/;Iv;iSz:N6UrÎ@JNmβ дpuО]:hc1+,b p@yܭ5|Vڴf`$ǣ:srY~}gNU5UU~}ڮ6Y[&ձL эڑKIFv67ldBF͜z]8|McƚWu;FL RP!5)3SD/)8/){ clQAr ˟v*UQ8SW ~VEfҎ ¤Oq Au[n*;ԛ@ڎ}1w/f!+o`1wnȀ%KyŗxǰVHںE2\p^ҿ_Qq ҵXv]2o&vsuׇxVBq8oCϹSiߺ.%g  Wr!iu]g<۬uv̇ف}mSRQ>//㵯ßޫ.cyN>^i3g6'o+Ə ]ڴ3z՛mCGa;.OV5wZi]irwn`ڂEڴ:?3wxC MF#N.:$=丮['z6mBO͘B Se68eǟWiP+/snٓJ.Kˇd9B!ѤBʿbڔAA٥5f x!)*a=lo(k* ) \};. 6ڹkO~ߵeށJ uJ'8ś&r&sީ_~+ X16-KgWk~Hx0Թ]:6Փcz䑛gK.~{}yyX >.xi?MYk2Yb%' XB`c 'ϋM3tYy`@Xf\VgJN=KGQ_oʍO=/愜sϕWU۞Gy0!2i)1׆(背"Dq͍ڿ?ec{襁jsf`yZl"! 厉=^={g_xݻqӅMFn|&#j1'ONފ0l1+\;I~3!h|itmccǟͬo +QUW]Ó']qbӌę4Z½0bf7U Vbqv.ߴj,\%k-\waoq{G>M/ l~Itm߮VoS8׬etu8CjBԕKᬔn]1*>M%K_qܹ F-t̆}<ۯo/q(n9(Ƶ/:s29NQiQ*r :%ߴcgjcd`aV8}f·OIlti?f}|#:ËƓwO?+µ~Us_^:{ Iwе}; p{pPpЧil߳M1Jy2V֕29^b6irK'0oJ^MWX(c'iNwP҅~ݺV{=&.ȝϕZ''=^/.;$wL\v|__T $.:&hudÁsZk=;lp~Fs^w 32~FxI՛]ux{vwYBN,b&%֓SBx$@hziͭk4UŜ\6G'BPUyzs|N'l>#2ïBg$9|^5ҡxO 4U{hf-Yx7%KyOB}HZ&&ۛcr_zB7 lkݺƒ9A׎<8 d)}RHP&d{N6:)1Q&ԗ'VH-Z&EvY\Ōt4טM&̕V;.|Dg ?P2gR'[8-BQi9 -SPˤwXjP,SqU\a#Z:1K+,$>6ߖ]u\}98x˯5rVٞw܂|>՛6?uОҦe 131QQ8n0f-x¬AQug*z&uhφm;oso=E65eu`_ Lg͚ӓs#BԆ`vپw_Ⱦ5Rp郏mSRƧo%(Vn RZ#rBs>{</YJz~:;XZާq g+UUp\շOA??:':$ NZޟGV[''#p12@߅~|hߞLzf-]'养 [2o>NW?U69} yN?qh2zqO}1&>_'Z?}L|Կh\Ņ浯ӻ !hx lF4]'1u3!Foܾ]~@P +8m\6R̘:MgdGA֠u 33xkzK׮̓BCtpה_XontNӀ>o?ǗN`|\: ҕ'r{=LxYF\Ն7&$jAW㎯@a!jNFQ~PퟴX&:7 E/]67-RPyu [t亮e8o*G=Ϟqp:mm۸K[LԔi|758lCm:Iל.i/9/yy&6}0+,dǞ\#!״JN6eSfV=u Uƍ0k2N4&O IDATBԆI5yu4*,]W>yꪳ{OV>ˬۇڳig:]Wsb{2ě04}ui;{o'7l2kHp #}M 8L !}]>`{gK.Δb~Nv5/-MPfs.μmRP?xBVݴA"Wl|ǿn!o3BQ5 6vb`٢z3 Ds0;8!h@aaa~MvƵf=K.  ?vd5ҵرgofl!j'|,Y6$@l}Tvh_*[=(h^?'ؑCS  }ZmN]ݺ1S'Vnoӧ]{F``HL[E7W\L)r:8WiMMy_} 8X-yx,,@AtJva EN' iz't*}^EzQ>ckE^wmGUTڷ)]vc=Aгs'JK֬  |㱇??Ѥ+/箫Ry? iْyc:M8]?k{1kӢE`ooƃ/ČæҮ-O5A{W,[>|UU;|VڴlrYKN9tLKEoeUaV(vδ=66{#fPUV͘Z֟Z;8Dmmgˮ]AiH8οcZ&%,]H^}?1]Z*A_}o836:ǜ@*qlpvN,|F3N*_7|j_g CÒuѕ(v80iG~9sٰc'-mU!Da3>8ϟv :HڍRpUp; hT Հ}jL&6@]qf׎={Yqzt\n7{ !6{\ڑO~amZb[-> <~0#NQIfV6:: ղ@Kjg86K¬,,;6spyܴJNp7V Z$&Mׇ.96!D%{Bؙ[(nN@N P4_}y3p |l|2-^ vϿ0cJܙN8ؾ7g_>>W]Wt  009)`wML-jyu VZtf7_x^Ȭ?vmZG3kCb=( uu>e'<_@m1xPT_wӄiam݊Ϟ}99ڸYY8.bbݥ3}v ׽c~ 6n͛)(*EBvP>8~߯}*sB!W)k1䓂ν\}x t9.bƢ%maǿr nVyerLލޝ;ѫSGt4>]W-XsZ _Cŝ2/;g21=h1.fβu(qIӁ\Om饋dQPFp) 珫f^]#$lw-)3lz%?hܥ˹˷?>%0Kj`6S7p3xNJ|V*a¿y +-%W5aʜy灕B!"KM\Dž[cn]ǓY^մ yDC.U8qH,KฦiL^~ u~/"TV,%;//}ީٳ?//3o U /۬9A,_ 'Kτ3Ow8]kkcVsW+d6r\~\1L.{} 'x7x:9oJjEEܴy\0zT`P5˸SNmpQU*'%a\ 22n"j5Z:d{R kw$oѥ3Orثy#@hߨq%[O?RAO9_oo&$r[O.y[?5 I퍟&)!+fC/ïP:j5 W!=$:_7iV6@вBaKҙj'Mx1]G,36?OX]n4t8F,(8I=[dTWGYn%4 !d H K T46~dWEdLSՕDwd@o6⩾4/-@  z~YWF:>,%-H}Dzʸ埯ve%?ܶ e! A$~%6S\| /sذ{/T;׎~:PZRQ5&"D5֥w~gEG3iP& Jvmzyxߧ`\5@xbe zj6BM(7*_02{x5(7+I.0zAVF @Nmەknj`x~)aFظ7͜#]i3dYVcKy呇.;87>zoOO&O.o;9t<^NBj'n0Ώ؟f`;5=r7~XDYOsM7g|O2qB_w_oo*-"m|I}qwsw&dl ֑n>^^6c{OOgT>;݀+w43iO?G\@.!, XNa_XDN'f/x]e\ A(@r 7cٮ]JK󼞶 ރ)Pױ3+SעҪ-qS1 4,/kd/YdmA˗jS[^lBBP$B@ KĽ^Cߠ|>Y`LJ/8d=y|6W>+L6NMsOwEwcKFf!ve+k1| d.}mRbNn:37lw?@vmnz=aAAJ.q@"+J\:d85hMP[CXtAVNLQOÅVonQ#꒛8|"|-߼w}.vc6.WcFۚOڄ&w?5DFOz%ĝN¶YM]iBϿ⡛1w/ ߽%V1,MLٯsjuF}Ns8=syPѝ{a|#%``㮆{\ޞL{)H[z( @Νy[xu e_Xu 1* Vadl6uAzp$Q.,06DEDif2 NST^AQy9nnx+ْܓ++(ѸkѸYfCu55%%A%Ixi4[aϨ9S^,NS{j4{PI,˔|)Es͞i ֱ_=̳ ց#@ W2ޞ<4z^~>Z^Lgʧ쬒G]e@쵉T=N}D2.qf@`z Kx*EeeZ9+W\"B\y^\aʙv?'Ȏvᝓ'vT:ftex<Ι-9s+'s1{.K6n"ile@(!^&t.#rF=eM mVaб+Й&]pDxz=JJΞedFkNrƍ2DO`06"(~?{ !9#N9fPnT;X}ތ?V !lj5;vmױ̬f {Űu>J8q*w7%4h}QgdUTqN~CÃZ|$#ө@N6LeYpzkNo8Om7ve^*2.NdݞTlF +WV\Nڕdi%0cUUTTPP~ TWqJC& ZT* *FF$Yٖ)(A%ãƐ,$5hIu%uFc9L=)"`XW@hetݞvCp@-'@ SdKf|`WOmw?ډJ,`:f'_wØQ|ܳJP0Uo{DnjW֣SGBmh;#Ϗs)%%諪A$%AtHSe>K>[zיLTU\$ t@em_BTI] 'n0Ѩp@ W2>^^\SڞO,u(1i3kvRY]Mn j4+yROp8#?G2 d.􋎶Ex4+C6s˫榔}4iKb[~[fWUwN6ӟ5ڷ#;#t%m蹻n]Ve .Wʆf¹V!̹ (*+sű*!wzB#}|>|܂3iޱ#Q-hF@ d(/˟5Doۆux/qɈܧM1^OMcjZWm/ox `҈l?Cso~=V0=tX *Iqz6Wыg+hʆ1<[QP8DESle6nNИ`/o!^!^aO;u:^;W$ZQ|4 K(%[}:Ad 9U=ܴLt /f&B/JY6{Dрu~\3@ I&?׾Y'?u%ZD?wLഽvw?ڕMC@Νٹ6juzp@YhV](~ݣ=?U bBf0ݮs6tnFu0m.m@qYCÙYIҮuk~ߴe൯KvVk~[nǿqP\vWVyߥRIE͠r[N?|I#!+*c"˲^gkpBU*=z8q vBx.*cyx`*mڽÝ;FgmtshPSq)'?j|bf.g ]ZI#3ip&;SlY\y MżˏNc&^e F#_mH٪]ڵmۛHHNAe`UdbK?O9JAy^y?3fg^@Q:*Gg47/-I{͖{r5+@Dp0 v+AB5P!2N!Ts!yh_ YB,nbH=j5l]/\ *B@ ׸/Yۉ2ַ#%<$ZMAI IGv.juM9ɤ'-}jߎ jյdAv>Ҥp=9> cFөMޞioR>>jd"Gkr,˯Y~׏Apjt:t6E슼j9דsa>čҵ][(-`MNwſ3,Z̘8&8 Y),-e#lٗLUMy|y;X@\ I%Tmiy'sټwsNN@ 9 dhlBN NWku\2-ZAS_QG8wfehz%鈪iǹmPS[?v)MGum-#p082/U+wqύ1<9~$-W$I􎊢wTl6oӵ};ef'*mFw~tz1,s硛28~O||sm'NM~[uu\S%>xH#m&ŜyM&3yf]B"/jw^zAr% 4}x6L"e^@kZ*$#6dLĘRqwi0<}!T3Uԙ\zD@ \&[%e_ so]:},oBV^\=tS18z{UUtd96CC8++~;F~a?uȸ9,787;BBr ҎSYUM`wTyd?>xy)K:-;qjUDdLun>]>@  d2,ՒJ-F&7.mp @ @ 9s:w wI8Q٦7Sf4j_ glfe3c;w~qiQ Øy#g*ӧ%GmDp0O[*e ISe2Tphj%mXhhZѨH*k~`Y<Hg*SejIC#9UC0jЕ딿P反O:_z~[&M 6֐_Tij%t9wӄH9zwDu?Ϯ\VDlt7'Ne_WHFw^w :?Ҧuk=lYOxX(OEkQs^L&^ zv|Iqۇa](޶S VKxh5RMYE?nz\']$RXq7MР̜5nQ<bA_ù͂׫'UUt-{F:DFZ7%%Zl'OУKnAr.w7ؐd<==(-/L:|$I"!y?׏m7PGv^c{ h$-;aXn4<6lYHZ ۆN:,$=`< :=G3زg/z3)&-@ B 0] 1(7QֵgݔYEBq-KO;ee:/K?@ 9bX=z2yk\N_T  8d PThZHT)¤E$L]֨,#)O*KDJUdd>7mL^I9M3'{`4r,ߴEEږLZ ^;s5Z6v;ھCR.b]Lz(Ҝ))dm_*JdU.wW$vˏ^$8Gʴ,̜5e0eX^SWpL 5]'!){q")a=G$"~i2x/Xv^ @ £$e6CP}΍sq(oii¥}uA˶i݊6[x@_ӋʊTJytD$wIh@!~~;7UfCا$0@Ҋ Йa%W"2T81ZYDG{Wm4C L W׎Ū-HHNƫ:r'rؼ{啕Djń WUTfΜǛaۅ5ܑL$Ib}B"յDuj4HJ&:e63qp2rNR^UEvmYv==vaX~TUװyr1i݊C k=ͻvsI囶[P@d0ˆĝ ߏ HaCALTW%t鶽/\_i3G@VSz5;vpL!>> П;UmLo`iy"),)aׁП??2O GΌJŦ] WTWejjkٰsb{2XfR0,۴^1RUS dҧGw=i̮Mƺ*jҾ-GMk׏8[YIXpӦwTVאƝ?Iҵ}{Hl6r*r{Ulظs7QTfD\e{ F#[%+7j‚3xmZ ;Fwc-a>ps#{]XԬlVTЭSGo™CB4jr~ɲI9JMm-mÙ0|hz6E\TD?MGd"kVlf$sr("8Пу!"OHd\`6[SVY\6CYE!!Oe ;9] us*;)+/UHW B됆vX=B|ۛ~=+MF?mm"4r^9x\JYi3c``GR2W r7܅aDN~"bֲ>q'yШڅqP7iǹIxzxݯ{ϻ$Iޝ=QXRŤ#G8~啕,۴Q񡴼-(ˋ1=;ũ3:yCBXu5xy`Zw(nL@ D+Hlž3qPzJ j *ۻerCQې-%|)TG@  * ˝WO(e""xl$n¨1jߞV~ݻ<'(Ew1cytD}Q=5OGD0`vCǰCdL~d`]Z_UTp$#aMϮ]HLv8IqYᡡ$93>,(.楏>aô w۶+mlH6Ŝyǯ0eWPף3PXRlPql_}Kfn,c0y/Y}~>>u>bȲE w.tF+S $d.~WԒc8Gd0dY cFJ(,)ENǟ|(CB(୯aݎDgh:IG2*mڬ%ьL 2Onub[Vqfv۶sY4Zum-UU2%ꨪ_|ĝ#T|`!,X,q{Xq33gǗO+u[_}CAq1CB8ū3>%-;PDUM %eƝH>r ٬늪*Z+`$n3 VOw~Z.R[JExXG32y/(9{@5jYy_JɡYU]ë3?cCNزl}x8ۓypJE`˾&Ûf{VmN[aW/!9+V?-囷*m[;,J\^ E阿bX 0X=g_PPTDdd򌙤Q?e+pjpjl\:|:οf~F^Aᡡ*/,gt~ww 1y?7mӃVlʗs5,mMHaI)&2X:eT* KEYm_G;wVEKXjKϖ] 2C!.&ZMbJg9yVdѲDNYP#!)o/t&O, yt)@ { W-YNB*!U""‰6+-B4JB#PIecC2\lf S\!~ϴ9r*;w *ZE,hM8YQk4QYD"EP%I.;S$cc'~<:mtȸpit2inn=tnq]AZV6Ck'}_׌ItM=v7d0][֛y2^1tjۆ72‚ؼ{/׏ôǃ:y;u9ֱ#a$$%իjzqјfvKk'3qp|79ADXudif^F~\ `u"3:́4x^s|$eYE߃$I KH0*==yg|ފ,^у*#g뛿/ WAetayywĮVbX~5+5N'-;m{߳'.FDQi)Rr|TĻӟےpɺ ,Z13f3)ZMCCILAHMiiHMc.3@  hjpK)7d{lP IDAT4V6[v.>J"\ݲeVUY "ߝ#F&\-*IWwMp]wZw6 5)[66/Dˢ_sEBR2}G+/QzYM;> bˆaJ'{}eKc`4r-JCB3gwwE޹g|<7L`l^7?_‚Kɖ{a"~X_~_ʁ4sGS$IbAvuVޙFEUa|?˲̑ b3~"neYffq1h2qD6}{X=|t>T[`=>=tǛ,.gIf.Ԭl#EjVRi]: CB1Xͼ3T2ie W Jvީ -x8=* yL&6Ɏm"@xHFɥA1>͸JYXp016|Ɲ(Yo*^{osr¯Kai)99HPys.XFG੻nwھhV34qHf} `H=}.Z]C#UT8lLeۚu6[3v$nv{M @wA88e[ԶcD>'! 8: e:@ wɵPFK#!CoƸFTp>&䖕Տ6l2Q\YIE(+PEk%Ho@xL!y(*-w޳;Ʃ0uV{le%:9V0cHʪ*sUOsRٶwyg((.v)W3F~}ʿ3N]PMӜ:EQI)DڕMX#ii)./OO;QȖ f9˖+OұM$άJefda23ݒK`!5bTj^} ׏Mb~||}QZFve* %*M?l"#VuwuH0,STZ,u;SX#NQP\␯|ѿg2JEXp}v\z >??zEuel x>B ,X{Jh&f':mt}:u۶蜅~ϰmd6#2Up=  %'?6)UsޕYQU]0O\~4.QVnGDp}HMđÛ}ꌄdYfh/'&W\lڵRv$'3__.pGht:epr4e@s<置O.ѣׅpӺӉw o|%1Q]vxڅG:<]gkڭc>~EN:ő SxC;nH< XfG3غw[;墸f~F2n,# Pva ӓhK}?g(: JNg߆l`P1s.7 uQL>NOg˞=HJ棗aחs#):ܺg;)5;ݘ㈷xlZ]uzl,W˶|Jy``ϡ̀v.ߴD'@ @P1zRDp8:wy8Q%l'ܨn[@ 4$$-?^kDȶ>eH-a=c\hqD޽ZnՋBťSUA^Thrj,Bn߭&hHHtzD5T[=|_Ν;Aم3bU_eCtmߞ@RS[ۢR  U:c;m0I9z'^UÆ!27s/OO}}).;kwuu_ @9h.I>aqf>´3a0:MKu>t ?Y <7ePffڕ=˙"B[Shga=/zB9on۞i٤=ZϞb404dPUb !2ɣFg @jKmfeo$^Q]uD| k^ o/Ov?(-/d6X* ۸sԩ @Vq.nD^PTD0NR][%YOxh(;wEId2q$#-Q\Cd3R*ilzxz2(7֬XfF#Gsr=x )ټ{u9h mZ"&C\YGΩ|tz=׭LqyfVoێ@^ώd"}:k6KّVk={hΙb锁cd#ۑ@ޙ3|B܋ζ!$0!*@|_KȄK KXp0~&wugr︅cF^> < wg]3z$[憻MO?3ONXpMV n24Asd؅WG۵0~t7N%{նk ,m齩 ET,{n4DSM5MLo5`C`Wl.~,Şd̙3eg|0}8dޞOrz"oX4>puϻ*ΎES'_9u%KT71'P]]!(-+cyǔl#?GJܡ= f񌳶`!*kV* Y0q<_EW^P(d6YتY3FaWv<kcZ[7512B#o/r(JFo 9akeՠlɴ)|;^\A}/6/~fLsƍoڧ  HpIN~>~~!lwiOID L[++!5H}=)VV6NLJ۶{AS۽/5Iޞ v^a L]*+$aGVs#);iIbh`@ΝLuu5RIMuv'H.־k,o72ssvolٵ';[V͞٤OgEe%ֵQkG[[TU߃gK7>{ҳ 9AiY9\Y:)wĪAiw@WNDB+T9"k2};@&3¨{l3mHJKJu0c&jl)i hD=fQ'П~dGԘΏ+-=mwsqm=I?'Rw'V5!,]?As-mGo̭[;XkDX?X5?~¨Owԥ(ϝg |g},R}'J%_y vj*&|Kif2cԨ?j+(doVɗES&5h3yjlqW$ס=gN?А!d?o$_{1*(P>ZNcT**H[w'gYaIGEVDbq!zz%X sB~z 2"=;Rl)9x'5 eU.MRHȤRzR)d٩I);E%TՈbҳqFr o}߼0Y_V^NrFf&rm {+%J0d`ajcȍ}IKCO*$;$o/h< 3 I,2rr/,ڪhuu57120+P*LMw{ ($)-{ (+/')=K rUT>.4f %9(Jll<AA=_c66@OVn.EE8ablDB&QuΡLML|vJ*zzR9:>O&  NvOFZZMv^&&dRiƭ"z7,*)%#'C { _oaOO,Jh,,Lp}*9%E!hahϦ? >xËiԥ:tWp,ԟޏ?{r4}1;=b:.]G4]ݫEsb okϑ_[bןꗸxF9xݍ8fË),*捏>HЗ3o1{XveʒU9/C_Fj?u֖ |X``S5KTO^bTz Z]9q 9X[4>qˋ%IDJjR]]ͩzwŕ'[)NMW:ki`}E! șT*N{{3f@?eLN/DUe<]qM:|AT.!ӫ7H{T$˃hf&?h}99޷X,M鄝=cyxhAuu5#pwuѪ124ģE uKxpn(i.cưڕ[eUOhں$Ir!7Y4ɴPl '0f2}=YIjU7OZCnmzcI<ڧ4|D"bx2cH\eQa,T '$"ɞ4Xסсˉg ?sY P?tX,&NDESuv;ǣN3,7-[ǾB. šVr B7?Xİ~}040}VjAx!'#j~kbPZYN6Y\GK7!GNPRV͠n]pqR$ebJN^Q*0$9:{'\Is 󥋏j ?sΎ 339I)i8FqI ǩsd -ѵqdah`>A5s#aܸէ|JKK֯Ɔ\vTT Sc#F a Ȉcԧ'6s(4\ 9j%{t팞D¹KW;{g?UDD{b7Cp04A?"O;O|!a`n*gp^8ؓˡaeޭ3o`.3ww@$N~bz6)i 4 E5rަrsxYw# Q(DŞlnA@r;)N4y{ )-KeFtl2O-\)-+ĩ3BJeyprS՜)(/ֵGck #CGA<1oO99ϡ Ҝ<$%#f$"4 Ӿ-%%Lsg'R32s3>2>}ꌾ>78Ѥt@nIF_ϰAl߽윚{o/])(*HX$7û>bgmEn~GãզGtʄo IDATRY w`W }=){ɩ PQYI2'<=hH$"sG|ڶA__ouMҷdq84\8RlFJEBոW_}տʕ 5XwD"eՍK< h@:ӮN͚QBJDTRJY]^Uoy#mJJ.ƞ#"(z]AY*33p>~I?~}}=??B04PIMc9q&JB-( 8~ OVJ vVVi,.^O‚(BϜ%%3G[[A+Sq bb"-Z}}==!<;/DƞNZ~d~^H^{ʂ޲s7. IHD$.8ky8 $rDFѢ9͜9~ zzt{xTV'">yJ%G{)$b1 ##LJ&4-lbK`猹႐fL ߤ Wt_&%SҶ;&#+'nzlZhƌ)(*̔icF`ldxFO;OL1pY*ځ)#ڽFXrD-7psu>^L;KoZ'hP-F }== x-ٓbf"g@PwҳiʍGs%ɚѨxgJ$1jUMEWpEjҫwՂ̟:’b 4r(]9y4o{Ow7 qxSzlxi5&<;w:ff`ƸQzDZPa_>m8 j8In~v6|ޛhI~A]}xjHΜ;ON^>< ${fM\Ωu nR*+ݯ 1AF͏?〠7owȐڭ93ǏT*.5fN<-l7-_vrl99hdm9slmI# c##L9x< [~M: m1~ 7$ Yx>* eNL3g(,.F__MAkxmCAA_tڊJ G+77zHRZ~AcddAهGjg-w;K09ӱDiDb1_ox>^ҮuKfMKFv3xo< DL?L7q3mY<3kjCCfOX̮!:Q].xy"~{f`kCxt{N;S^1w OCFtrg{oѶ;Etnnjq~6iHbyMn~V7H$<[$|oST$F,zBjju BWw7ȉRGf)9Qe?5j ,,)-#&o,2vo$%s:>/֔sHN`d=qwܜS9rW,4~p:["%#?BOt4k>g/\ӭRCaY[caZ;ps#y۱Ѿ_J;W~;z'xcRLMIՏ?C,٢9nf,:sa(J iߺ!$2 onҮ;9ukVc&sL4$g`T"3H$r XtsCa `5{\rhT"tY~=͛q-=O}71ЮUKccͣGkҲ8p2%S' 5<&NZZCz-焨Z&"6.^0Ձ1ZulݵXrpqtLB88p-v9oGSU]5Q9kKcenNZfMRz'Dө][Hl=5b86HJf'loa1?v+cciZ~"\<^QNg09=;iiwWl,-=G@G&שKzvM6I#RX:tӑ%HO7 GNro{v[OORU/T*xsJҗd} 1 ԥOn]Dlq.fTUU!^sbm0l  [6w7_m+w.\fp ˙t[:)v?*líS -3}=)0eJJʰ47gi߆L|'寽T"~ wɈ}3 8x"w> JؘMXB;+_}^ ?EyE@'e#X6g:+$":F`ݭ+3V̟E|ͷ|{L)1G7]5oY,Zrlx9[8jU$N}?M[լ,xjsTTV"w߅qZYlt6 [fb9a 7mm_Cˆ7 n#edTV*X5o6Y9,~J$j)k9Kʩaz׹x!a^4f3;irwԒSQT*EKJJlǎc`:oӫ_&4O/-](/_egp_vj[-c 5jB퀠DFRT\sbldg'S[1wgLhVeP ^߇MJ $F;RyҲrb/-[q&.J|폠_vm?_h ^}ZM jg`62=q,5 n^P׋ښ}$uo /-]H,f܋˟y3 78|h }|=Z3fP3v\mÚ%5g1-5 ՍOW@W@?]?zj3I,m A^5mD 5']z k,NǣR  }FJf,JIŅ7a<+fNW?!p ,],<+cen W֊e7W/gk^$'Nˋv\NHrRo/.^OůCF+˜qcxi|]]k;v28o>ӧaJ %?~okG5Up|$v6NEe%* ϭdlXv&ƚwV.g|)ʪ*~Ӈjt>}Oܠ?G"pgh$\K5/ǚsX=g==Usfu.^kX mH7WPZ^ޠmVn.]$\Ɓa|s7frNIǿTPZi ^ln&j5#9:8(F\uD/ Eo/]pP? #CC|x0ur;%e8Ak]2_ʺKen~JJ֚Ŀ|1 欄cA߉k tjߎ_]ت~Xb$oI@3hO3'G*J k@3gG\2 5Qy'=} N]&*33:{N+(Do`g__&b.pZb񭥝G+M|ӯ iqi){'#i䈛&Yf.?R ܉_?$j5w@&ûma_/jI?&޺X"FmݒL]⻝`ks= *4sB*w00_PUlߵOhKHh$ިZf5I:ʠOSY@&ӧW;߳~a~l,-qo~WX)!8p" *zwMZ~TեV?Q\R{ۈK3BpP kGnp`$\`9bΡP(%۷ !8ސJ%vh6s*H͏{SZVsTj~ؽ 39mZ0~lq j-*#aQM,$|᝔4 |k9*ђ555GYm?_vq:}+_`Wރ?Þz\3@л[W(DZMAЦl~>~~AvZ=47UB4Oy7߄L,ybj՗yA7\ W5AxL[\Smۋo%2 v==N\쉿rUeϠWgrűR-ӯ$putFZ8Yh BڵE,qEzu#+7;IVKjfY,2Q4˙3n 2}}j5'2i`AQ,3__N'p+%E`m]540ԌN rue%rwlۆ6n_Jn ѝ~݄/Fң4VEjBµ ]] ),=PH3131^GJťL5B%Ō ˋ|DRZP= umSyIxeU5751!N۔;"&K33ڵTtk)qt~1W,551aH ܭ=p-ZY͟#Qw_j5cdhhD"EE$IUfd|ʋq.MDs5st+ZҨuWl򞶧 iY*Va]B++Bа~Prž&zTu^T*7,3\~3q ?r\E̚4#ډ/感9w;cؑL9s6?"e5V8rj5T=,v66WrDBdlt}E"Gp2srIlB{:A?\ m<9p^]\.CVv+3&um`(eUUmmDd b"0пsARo+nGD^HzV(Y:^*+/[Nvv\Ԯ wSRh\PBXd x/PTRRoUD#yMjU5.T Ϯvu ؓZr4R-#f{H2 ^l--iʝk8=;,־zYX5u-r~=.k ѷ7 7Cǿ #'~U՜H姫WZNF7+c+:tСCǣloǪs`6n%Km?hgK@ euS |Սz U?ZuuCZ_vRZ0V笖s0z|۷w{z3v@ּ1,9Qu0ͤd2aF(zV[-Ś9֩3b}+ʩV8E@i'}ۡ##PjIY]MAQat! כN^0l0fƳkv;h+jڶu 9ɺK073Fe9Uu(PVWs!႖_`-5ی8Y ՁN3׉|G; IDATHQz)fruHDTUW78wR=I Z5Bpu0g)ͤdlٸ2:/x;/~ taKuùJf8jh • & o u;;ʊFϋO1fԝM&"4E}ՖH;yɫ= d!|yYDO[g_:{gܟ=5Ϩ㟋nv';Vk4 $FށU j ,В}BMDڤ|Dl,"^]Vfr91$&%ѪY&} eU/}*ƭ@d(R3eDѽoh^(z}WջvT*jcL{IP{o7쁳=n֒c'jIo#]c| >؉DSf( J•1g5>~"Ae]U{,RQTZPUu5"qW=inke+q39+WtN!ѷ7RwWJZj+5#"6#zuZ.HrB-? =VpTr=Uj U6e%D$qu2 042ʆIiM/`աC:txdJKЎ@?_a-2}}!%-Zs g 0a*,.vB"9$KʈIkOƃ?`}=)!<:Dǟ?7ۣ1 כv7?֓?;iJjz4״#|=cJdjUtH3gGa[!a6}JJrQگcג}ddfQ]]M;Z5iWUv/S1˹xS+: ;&+m؍B8qc⻟ٿ qP(ՅPkX* gάi kVD:^]Yv)ihC*2{NFnlȁ $2&Ș@gd0*&JƎí9~VhVIȤGKvi;;!76 ,K덯[Oo\* UZȐ>A\7vV g `'(D ۋ׮»eT*{ڊуx' :;2u*-iX:i \ jZk񗯐ء-+__>֟swu`kCp:8~d߶/֩#{EBԾ_Z83w\ų}q4?oezylmt3y0<PZ 80(x 5w4T7 4>*8ں3*/6bs߫n+vZbjb% 8X[s#)Y+HS]]Mbob~=Bjf=4raoSSuW?`=alhznd>94] ddRV'CVsM ę3Ȍ#G[ǫz&-3Aɵ۷xb&c qNuߣaq{:n%WV^N1cb05eZaC47#26N[|zR)5jZ6=ť7qwuat`X =: q+)+:[xNCU՜Owާ7DV6Dz 0j ʸsp` ۄgc\l ϚĘmo}s$HZVF %k+7k*OFeolO#-+H^A=}~V9/̊dv=(x< /~ ]} _oymСCCØ=q,C{ Q&FFL1r#aX1oDdD"YӨ|á_Lta)MVAgddgs~ ;o'{[^\'ƽH*Ă& RvZ[ '{[ww֌:}=J:>t2V͛ؑHbbG fޔ 6.wZ")i((;T}do#iPVq,4Fí9h|#:a<#cQY`Ղ9w_<^}!bL9DHRl,MO1w8Z)007ť ѺDT*)㩬Toá2v5SG;mMPp:wbH^H$R) Md҈P^Yɬ c3y0n-\03P* ;øwD8=ޥL.gՂ9bz fk tq2M LRs84Z3r.GgS\RvxYJRL zX%%X :֖,9:L9uŧЕ¢"5gǚcL1Vnͅ{/4 /!JsբRHOs'rc]ڵj ~)024|FmtJb.^"8[Z$ۛ?NWxpsqֆ9F7oo{Y=gD@ h1/\$ 5Ԕ2ӱxiepPD"^mt2};66DĞkC", US"%7"*X2У 2X }BJHa*I'VJ &di2t IzHR{JTǟRU"?VdqL4/_īqi)RRGfrQV^Nn#rSGn]uСC _| !P*ӓRV^ζ{رSxӯX5o6,*Vbϴpu/?GIY&FF>>A9L; yk^^ͯ_}D~A!f\z*~EE].^x4ZB__q%fTT}}ya}9EXYq6?ܕUՄF0sh9-?#_&&*EGZfC{gp;ge3_Z~)KV-*l\O~a1frnI5bJycV%gSxmRؾbLMritLÌqub~|x%lَ [6'73,V./r:6^ l,-9uӱ L:L?t?}Ǟo>%/ sS6+m[dL_iȗFN^>r99yyTjݸSrҰ0 <à>A$Y27P*)`t.(9Ÿ9t"H ~صc 024{9a4h2y'3ƏfA4E8l׬`Ϊ7j٩xB"yE<;wjOl'-&wMtt0L(S(dF=^:z&ҦcГJվ:p5.\OˣumEs''}y8ڐ_TL֭Ձgq~Ds''9{}Dܔ~hwLyz֓SlES'YPX\LΝdL2l}rccJʰd圙 Bjf&s^x XQi Y RԨ煍~ųOK O_~%\T;{kk6ɱcjb̗?µ]<2}=1[cSP\LoGj( pRI@GF?чCOw'MGkVC Z5oƴõ@&6 G&fѺ70).-ʒ#jƞn-2|(?G"T3I8,LMipiY84F"b+}C(TJ ;;Z;qXOkw7T>g$b o>Sa^Ay~==oߠ={AIZСC: o|9~=m[/''7wxRq43thZwqǿ]Ҫb˒ܻ;@BN.\.%?:\څ HK{$Nw˖fҮZ5lٲy=fߙ}gf]͙sN}/&/f:pn8xJٜR3ilixle߰|a>w^b><>|N>ohRRvtQ9Nmvr#-baU^|}3W0ρ!V>j~|s/,7P0đcBM]|?X4 v[cxr m YOUG:j^z^:\Pyq2o^v9s_ =NʏVM|kb^i b^_C{}7~K,[0F"YI˿♍Q2"g6\|K̠#551?q}߁1yΤc1s׽ 07XN>+e>*h2J]S(f#i`̚Q#1Ӫ*A1?T'~v9~}lw0ڎ50W~3Egwյ^~aM? &+#ohđȊ 9ukG-ۼ}טiHCS 7}k,;8]-?L~n=~^>oڎ??Jf2`gPUuW|׿c^,hnmXvq,ҏq[ue{Uz8J_|}ˇ;Zs~,7}+xc~Q{ Jg5yZM͗EGWGk?ﺮq s T?s';'^O=7mt՟^2c]~)e~s_zG">7~Sȇbz1AQˇ#kpx}X׭DVT{-!'#x~+(əTP,f3e%c~/=p8ux^Q]s3m]$%$0xi?07>I0 q64bT?NL&# 4 xT;N(fVa!)?DcyU5pe1 N]s3=8"ndÑNjȈf)# rqyS(w=}4Hb̙@;g?V2SS))|=@0HM}R)),th42Gb”8bXpX;9~<4]MKOa6(SXXt㖭,]JK{ͭ7$z[vveV2DY'ܰhষMwֆ֑hS^UEgOoLWWm'+=EsfO8G-[|J^߹u8\J,&O:]]feq+c~?7]ڻ~}9vǎ`qe۰ofbyMlܲۿ^ݶ>ٰn혟+&vщhkFˈ1 g7Ago/Y\w1A5l޵Üb?{ۨDJw?>1V/^4|[ _~ʪiG%=e`9[p8@8_'/;O|MTEcg#$ހ7hx3FpDG=(g(Q#prLz**,`Vቆ6e̋O'kT7`y=~'i,;6~|A>"w~l2rB0/n~}~>yG:y>ώ̤WnPU5Esfomo~SaZ4Mg 'g#G3UXH㼺m;ߺ'1ߑ1,f]˹زo?I ʌ3s& dc>h6x?aM?|GQš/ >[F~/`649.Y"`~,aMyK/ E3L5 IDATQ4_} ~oĵ_;cTU~/E3 rybU;5+=@{?|ee|`0wN=$'%a6ThnMow|wzׄXx_-(oo>~Þ_D+O?rh%׮7c,_0lڱ6^t w?m]',B!.,GwUǧ{:b U_?CEU-*{:#sTт?=BMq`= gq32Gc^P6a@!xnd-e%ܰJJKiv#S./+[{71))*׼K1A=śdA=/Z, PLԆukx64pvlIеK7~in(Hbe1<@g//_v-+fZei#.V ~s?sҋ2 d Aw]~9 WY^.W4cr"YYE{G[WWt_$G9CAzq{5sd۾4M=WڥK餹/~Is,2:{F#AhocJwN{yWLW-dv 47vbg!Z;:%1atTcm o~VlIܬnIIt9h6'=JQUqn0P6qtP0"хDV|L1Q@5 u=@6NRtFˏ !:AbBC  F3~ Yf>s(-*56)Tnm'˹K(ɡ蘥a1}-dOWd٭V|~r3|;4Fn8eX}N6HՓyxxUdw=P8e#YϏ}\e4>Ip GxAN)8h6$J !g`$l'lê'f%rSF~փ#%'%aZv:JO~ x<7?@9quf~, x1c&}e+W@Q*jjcEUU3҇-sEQˎiAsZxb[Ndr6[{3[xFKyeeC|A)>q]yuvR(ə|&EIWp| ͍׾~W1on_);c433?kWJK8 B!N8H5[1QBi"zl d'19oyyA~\ݬzoGуAP] nKѼaI㟛Q1bыB!ۑŠbeM d1LA)o`U$,dYH1Yr'( W]_e_t]?=0hfpq P]_ϽO> #2-YLyU5}n7X]~O;8ʅ xŗ9\SK0b_~mXS-~ @Gs/j“MOIaɼ64:Ǐ?ݾ;=OIMvpߏ8Z/eڥ$x\|m^ݶcLF#T+ǏP5|]^m#Y GBw=]N ?<`e&\79) ǓOQ]WTh4Ne9w@ƶx#i?r>r̾m;s!B!x{T=,HF^8 EKˆŌ{f B 8 :1G'ʌz} [ 8T@6%+B16j¦}BFPȗͰS2~*asEzjJLIJ} n7/ŗ1{F#{MR̟bt ҆4w;G` +==&#d4Sfo }wE\vUӹaÕ`܂nuӱD~ 6[>!p}|wy_d1~ϵp=,[n[{7߹{?DQr2 =W~s`Ճd=f~˿"8?KQ'@Xǹg' v>yXvMt#j^ : gXƧ?'_En󗝞-`>?-a( -7\uhGBlI^&k7?t~*׮Ճٮ`w,Z!B!B/)3MLz_w7ַQs\u`pxAȷ'Z :&5?ub|i'#U~_|jfmłjӸ//&nRC! 5f 8룸`50SrɊ1|9]==t:LK hhi%9)1ZsRMo?2:ظu=hjkhT)EQ:Oj.(3sGO4jYPuǔvB M>P=Ӊ~U=!+= dG `&3#G=~gs7( 1@#ATHoxxp4Ę441n6(RXT!gHwd423?6LZ`<FV-Z3nBP.^Yii' pڭV*>) kl0fYNf)%$ǣ( yYes1`tsxDT93g,M;m !B!xyƠ(m~</w,uF&*Bot'YY/UI&Bq^P=XgfiߙdPHM!B! yH& fJȏ6,`wջ-o?Ha>ja|%0.rd*/3!B?R#%G$BB!BܜǬA ;s8L7(BQUYptOC!B!⌑yΠ($X0M|!(B!B!B!= @X * nШH0I9Q!B!B!BsDs.0و_ Cqw*&,1(B!B!Bq^bPTt/¯ ha4…EٶU5 =B!B!B!' )(T6@Hj!]#t#CEQPP0(*TŀQ1`2 +B:P`0jcƨĸ wZha6چkC0Yf2IJǵ~ Zj3HM8[jb6`ŵ?`<ՑwcTo+jjjĵ,SHu8Z_t.ר v8ϥ!=F#!!{=%%1=@(Yf6Iz pxF-rij1cZZG-OK\Z`b1Zb )IIq4\Qv̦嘯'Uő) P d9B!B16 FUB!G@> ׋J q\,&SPQg r:@p9$جqCڻ R:^Z;F-ONJD3@9*@wY qZx㘟wE;6(dXcbs^Ng/{B7qۺG)ӓ<^ڻG-7w妻/fh;@ z*lKw_Zwb6϶B!BX BU.BLv1u<^=u&hNM߃e"?:k,~Qt#/@l]Ш]wf/}>b&x{p9?C!{BK/y & 8ϥB!#3dqbsI8{OMǬʡBq}^ S3{*>m;tu(Jǧ ̌6S+tFi%.p.!5\ !B5:,Fɶ;!\4:Ht`Tgd @(ą̻w8SB!B!.h <tvLtB):Nlf3IV*>>;~\n 8'~ @OwPLjZ*Fi̱^'P[䔔nnuW?&=ug=$`Ofd6xq( ɏA7ᰆ$ !1Grr>E!1)v,V+)~:;q$% d>nLf3 [4L/.P0j%5- u㡿P(Dbbd)ݸz㓀D_?c4#ji===ddd`Zq:ddfچB!B!,INMDtOG!2>tt2프' u4Gu*UR4*3d֨Uډ$$&drS&AXrπ{]( 3f`Ea}>l6sH1LV_|Q)f9I,_2&طk]]1Ht$|*moQU΢kVS ~eדH:++1,\{F#9u\iX꣕TWV ;yee̚}c8f=Ɣa,Y윜P(}hmn5c?`͛6: /bְ>x5t]g%XVvmAь HHLdμ۽,]| ts xxͷ8V@MRB甲Y-44qn#׽ O<Gw=V|3v ^cRy5W6YŸ_zMZZ}=.6nBs[e ʸd*a7A5{0=N'2 #/'{7R2sW\vUp흝u$'%1o,._M,l|qҵ)_?ź+(3;63z#W_v ϼ*&:7yꚚ$;(;֮jDǵk3N)\1yvۓm IDATOCS |ϻ˜}lM͸8Y8oW\y_B!7e1 Bnr*~?]鞎Bqچ2ɩRFMNGkuuddep.WLnHS]=G+ x2rrs )?D{k[tlc]GSE3Yb9)) ٶP08UWPWhbفp۶CJj*k.kbi q0V5j=|w0U!T.NX,-?Lo_̶U@Ä4-s 5u zՍ->^~w'-X \DnV&O2_7]?g'+#\eKhjm3ƝcoaE[G=A#1˶~w'GjjY0w]E~n6l' MOfs~kU 5;GkQ<1rƦ=&^|V,c!ڨ}  `oEƘljm6f%oڲ_'54l>]EVF:/mOZ;:cn桧cč4-m~TײlW]~ 3 xy[/w =B! ³hPOMK{d*⼤m}Nt ?% "Ã4xQ5,[UU^5xM-,Z x^/ ǏH6ׂ%HMOg7QFz{z-TUAUU9e7`ʕm۩=F9 2xKBR" ORMU~eepٺy3Fޞ2 @٢E ;;lJ^A1#=S[S21ue+(@1蠹}&:%˗_XȦލx<j@_G|E!3+A.7-(@٢F_z/?"9N!:Ҭ:q:qHr$A$@yX@jQ4c]].223l1 18mڲP8Yݼnr~?[xUWr>oR7\7f]P2Ǯ嬉ξWG˲E pIlFuo_RfL~fX{eY|ysIyQ/O:T[nbq/n{n'|.¿xo~1#sOfRny{b.{qϽݯ}/$f}3_{MrY9'=F#^^a/뛹hrSO^.?R㲵ټ}'dS64G>9^䊋rS]}| 1~ el|M,&­ьXU˖wŶ]{lI9!Bqh(H4rB/` /9Ug=kb>?劢@`KȈm\y;c]߽'+%=33H`ʊ#TV}0#! M$b G). D&5`xF׆kWm 3{7xctlfc6ffXVEfjhʙIv#  ~ݮQE!5=m;ٖ-Kܿ2̌,>=\ZTs"#&^YY$$Y" fΈ=Vr~CLmC+<\MFZZLpKD[ ar758gղ%Xc"7W뺺{(,Sʂ D"YEK`m{Z:x{HKC#I|wyss*Ҫ.+.fP1,`pUW _~xW(^3njr2tvw}nj)=rcyZxRB!ę%W2b /%Dnz=B!>MpC=lGdŸeCG3 =6bi07T+ W:nǃʢW:*[믛Xv8QUYh!/$i=xx9ٙ?ѓ>W~v._De^5u]lLM *1?|~?u,.?v;5<^TUz=O/@GcK+Z1VQAyWĖo-)*+y⅗w}Lgˮ=>|sEkNkB!ԑ$՞lՏ%-!D55BGG;0ɨRIl6bzFyA]C{ ¥Kس}'^#GD8c$eT=ƽ]rH9ruk4x P6@8Bu` 0Xs9X1#/pUU^5 ,]EKMG[;-|>*+q$37Ǒiz: gh<@ь"q@u-2RRHIMW]~ u <܋<Μ攒=`Y۬S <ҫ$G=`FʖƫhnZyp?n2dJKX0w6iJ**bå[[9Xq敖0o,fϵ`ߡ<3|Sgk^)͝:RCS]$/gt}WO/aM##-5[~MףrOzP rvG*y#skƖ){E`ni esf1:B!bzid1(HM3gMN:ao!L ia\>^@Fb r#˔粒.ܬ NnO_( HՊwXG7F6D 9ll(_AQͧpDԴ422=.GQwE8/@(/<,-jX'$ œ]fZYs0AB݆l" ̎>7( sϧxfL>g-G'ۧo>2/Dݴzc@_lPS]p00&-=̬,2([7^} Eܼh#ﻞطT3f‣l:#gB0nxw9fE?#,]PCO=˞ ='kHVo?~VeqټQcR˟*kkyx?&(%.B! 66~>.l&ٌhDBqt] CAf3I/f3''?ζv #z YZCh%i46E{,)H)YTVNMei# b0 1dƬY4v8.EQ+ȧQ?wf… kNRR_9R|( 3KfQu%5=cATAE# wr@FJ;T,g]tWS\ZBE!8Bzf͸#f̊ݵ};nNt`r1(. \a=<5|qLM ՊcDT1} ^N[[ 1,&daY1(/g룹6‘J(*JiaI vTC|3oms# C-V-VBZߏ7 iT* 2=B!NXjaB0Flaa7H69&::ho̜lҳ2lk$P݃玞赤*#3DЯd<Zd2tJlv۸sRŋعe+^Q\dbEkٻcn۷Gq$'|3ދd~554R5ߔlbRkְ{.kOH`5=|vnf'0AYYx<?Nue%Օ5 ̙7\^-[iin% EQ(5aVkz{ؿg߉c`1rj$$Jo`H_©PXTD{[;--TUV Ybapрf koYuw\ם\AAp/pqmjٴa2mYWfV3[Ľp@){s2.C:C>sy=g{uGlmֿ/Qr Rb8hm9Ͽ]tlcR#•pܶzj:98`km+tn߮c ""iѴI$'{{,-uK~J7n<{DB`7x9ը[wsERqJ8>-&??kס<6l0s.b]s3se: C‚~=IMMs`:3=1,0mq7=P; jN_ž'=Dh}ɏ͛ܼ|_ߡGYg/ɩeONyڷhΘ>uWCQősal;tcQ£B T6Ei74Z-5jnA6DT"A"QeH%K_]&HХ3Idgeaies=W2өOWymvmjҘd QT8`2\*Ji۱5!N  jFDj0Ggg:uZ1{gkgG@`B*ammї =wt4)R)m:ШiR鸞V1E_.K+K{DVF& G''ۡiQ( :wBV|.gWW:w:-Dzj* z7T% mݸ1IbnaQ֖s'9l4 *YmffIʝ;dg鰴ť̠ ~]:/)XXZSeggG.UB}|(,,Ģ R]ENN(I.ɳa»Q(+Hq pF2vmZH$lڱ[q w|]ǜk NoF0/ZQKWTQ`abr ޞPk~"(ueE`Εz5A"Эc{>Jy9*i4oR4gۛsr9vgê dǁУ+CAA!=t,<6֌؟UUbʌ119 @xW^~ǰiFccDPӆ.>mx'rϗQ2-[SSݹ[{iB-,*;uNNN厡k+I*¦H$p{cw͔wK(-5۷nиIcHf*%~?66:"+3A J&i8e2JߝM;w`O8S_ً9v;0Ump*,n}M[k^ӷes}LNhY) tj˶23e&ڐšc'~IGЭ+GNaڧ7nH$bnfm8;9Ҭqů{%ui99ܠ]._eo+7m}$1{CB 9~~A4_=E?ʘhӼ \ dm:;ӆKL$g7sXZӢic\ȸa4fH^\zo}iKss`ϜeĀ~XY;p9"oDWd2ueϡXYΧql'3(Ѯ-_H. R! э׭ӟZT{q:S F* BΔ!'O^6ٝBv<= ;1b`?cr)FCĵt)Ƨ5bD$ J0W~8 cabeYX嘙) 3Rm o&\.g)֯7:tsufXa+_|=<2n$2\R sRquܼD:W\La]lnۡgmi! ޵ԾUH0ݛ)P)Oefjqss3=o65mz{1y(r9a`eiI֭K=o\!F-V*K<23ìxJ%= d޴Uښӽ~kLr_@"a Ve?{ظov\NPPN0݌ y٧ELK߾ߝM|ڟ>f =h?BPoߎis?%;7שu+~x.8toˬoB$:GARsyZ’n*u{sv+[ U:so) IDATu~9jbW#rG G"Ty5[*3f`j6jȦ_x G|KXXל|oMFv9_~t.& ̜y5Q9w~BAA*BSipEբQN[\4"@hڙ5\~kAxpD4O{S1:v]Ѳ?B˱h-jJJ*=BBkHRIo,EYw*n2WHȨ;;op pE]ȉd5i4XL䬒m- ,0|eSHWXVj߼ |0DQAAAaRi)h `wȬ4mr?NjYNxZoEcN/ZQSE2T7 ZBE~tcxkeL(HyZ{4wޯqr>|ZIjq8M9JӒxWp5X#3&41Z!>Wֆ|gy%5vN;kk@؟S|VZ u    Bgea7oDZ+^۠f9 ,eù|/Ohh[_—#o ?5o.L؟?﬑0n ]|TبL %4jr|s1_"ڜqĊZܘQl s5r/%%E8ч-,*>_합͚wwfٹs'~zP$ ê6ԏ>~ )F 6OI`\JCݼPYFCvA>i(d2 RxAGx‰BBTBRR%  PGXZݵc 3{„5Ζ'滵VE_a.bFo̤͍Yyd咧.\Bi5 ZA":t+, +/LJlTXAAջ6E!XW3/GqW<5|h2IVURV-Sg{/ZCW+@do@ӂ{M41ږ ѱc˗7ox`}WH& ȜPWv<%(8X[8h-#/)Idci7[{l-P HR(OgJ3LV~Ah%z-R33k{8 +6'TwJ=ƿJiӤqWGJ<"J1P&ԻKgܴ5Hrݻ1cưaÆj<_AAK.婧*38(Ԝ_ uְmoTfk\QBbS5Nؚ[ BKYX%w3B uΐ#t,gͩ Ԋ[IxrxBuݻ@)S:e*O_;;9Wfio-ݰS->vRsxI:3mZWnq"SzvhWc:Ts)jBjVFlOf?PtoS{V*)((L>S{9bbb|ޒΝ;DŽ Xt)jr??C0w= D"UîeW&+LSRh`ꡌOA*CXwBPpxb `GW_6oZCA(W~a!Worf,ii5v[L>Nz/xb\Jl,-D^ 忑EfM:r(`Pn5&%=7#JyJiI&=+B$z =Bp>>S%<=0S*ms,Jˁug]Z,+^koS4ı|t*C.[u$ODRRʧYՏ2e _5O>̈́ _jvh"}Y ʕ+Z"U_,<\a T<[+W&N(d PI$,4SFna.ֶHM(D.'=+ll,-1{]Tꆓn ,+Μӻt÷{md *^`[=x׎KZbt4jBuVx7_#ڹD&.Q%dR)U=zvZ,Yڵk0{lM>ghh(~)̘6m'OF*rСj]([U)ZR* IiAP ={eq#j/w7&D.mt:gݮ&$bRѻkG^~|,*}ޟG^A fgXN2iГ[z͛'Od/t%XOΣ+_ߺ͢U8u ^<7v$~-[Þٵ[ fґ'5|5&֬lD$yysrdD:sKW|o)H*ƒo+t1y!dѺ7ͽXk7.``dL,cR3x}#cb9^TSO8NJfS$ܹ=۷3~%n܎G&0*8$9-'=;>\ΠHfb}]PGb8H m{͸t4Zې5ںǖ-ݥ5_^._9-dl. Z00TS+ `ii̙3ӧ#::Z/,,'2}t EdѢElذh_={6P1*^S'ޙk *DB=[{3ҸB};Q?t/+ t턥9Ɨ_7oXʓq%*?$"*>zDD"!_,Y-!ɰ&95͛pj"o 㰲(Za\zrwƚNJ|5 +1I>$=+m}pe{_ѾEs^nƣ+O DxT4+ɕ{DBfv.O~0쎫Ofq ՙ mΜhw6rf,O8|v~ūc6o>q;>>WXXȇK~O4y +wb߉S׌IdLlk֔INKooid۰gr-J?-.55:1r[Yƽp:r^:߮m礸S~̝t& ˸}6ocQhLԟ> @rZq5h`۰ _B.giۼ) Ú]{hрQ ήq fz {z\VbuI-` -oE%i=FAtJG;;{x ޻ŹTfJ:iSCɩi\~KK*j|5uBbk2ی^f8=wY:6GJtÍ2ٹt>8ã6ϜEҩukU U}* k׎+WtRVX_MV_ eٴj؃gdʊW^y#GV~+dd]sgjF#bin_r4<~He!ʩ=2DPAJ6v$fs;-w;n8~j :1س/E`o[4s8%=_Y3iԠ֝s%][qz\Ɩ+=i%Ưes'O1$(]ΐ bd Lԟ-q>rI_/ҳӚD"ّ;wڷhNjz&7mwgأ(eRJF&_$yEJzͽ„}xc"pup`Sqcu?y~-rwCTlλ}{ގ3^٬aC18&O]}e ӟֆom^o8ّƖ wg?KYr."]GӦI#f,ۼORPPtس+; y ӯ[g-Q]Jt:O}ѽt#>߷Mߝ>]:boObj*[w?~8`kWLZV[bDЖ'seYxW'EhLbt_~@6T){թ^;:_|wҍ9;ҧk܈boѕk xz:l%j{8kƐ8y2 aAuzQ1|5_NxLlDj r$yv4B.'<*^&c{:jczcan<;Q^M{AR>Vugo9pU#8|[XZЧK' 9BVN7bopu.D^qkS ~% < Jc'RI7_2«(V2؞E W!3_0Kn`{H(o=9\[DD`l{%-(P7sF8PJ%Cz0O/:nU,FÌ/rf,[/9[ot:m4bthќɃuۯ7Ɏ#rQ|(>ʊC2y@"8|}'NT(Du6nX[#&@h]Rwu@\ROϞ??..L:GMzLH/3&46EwtV+u$5C<߳llv-Ӵvkˊk+W3фւP9"@( BIPƎwF>HRdl؎wšwCxT lzNN,yM{6 ;6Vcבc7pu!^ڞZ۷j^fzݚ>{\=F}5LXԪ8^isƯjj  +'ѯ\xb%Kf9͚ܠt;~HZ7iL.] Sff!b@88}\(,,7zPNĞcDZ&KgViEZ}ƧiJVe:nU!hK;DY+NF)jaR ӋVdf0?4@]Ѱ30^ښ=*\};BΦe#o0JqN]LpąSDDEssmkɉ4;VƭۼB Vӳ?dPce( ܈b3INW~dӱu+Z/}v-lՐu_}Wx󫅴 8z.~Hc}- 38Qq#R S0\' / |`{B|Mg72^17/q32H ?՛؀#0}A}uMX`>t:^+Vm ӭm[9˳cFѩMkBυ¯ @lBcoя;i Uss :z$ Bl!mc%wgہ{Vض IDATkr߬q,_UVdڸ2k,+&W X/""X b'z-YdO j&{)ֿ G'[  զR(Vmٵٸgxr Z7i̘rw>he` 1WcہF}a~R32`[2#zp,"\x$޷mք3Wu8ώB5Xn:u`4\ENnbt@䒵II`x4iđlnm[34'w!}[:M|VDp\x$_\BΒ˯O"`,~ڰkKsYٕחIt:2&NLЗCq⒓E.1$z-м8F`}FD6;~];|r`wg;9ɺX6dҹUKWq(N%N WbIKpܳ΢ݸiژQA _1ZbRSS:s%JJ&+?DBn%jmՃ w hp)NU\hpiZ‚wI$0w}Z&pApS}]b4uބ»5WӳHNK5vٙes?DefƌϿ0 aDp/j!ɩiחicF!}%{ bkm͗#}GXD,>x__Dt44`ژ4W?sa::ɌIM`+hFx)T{)iD3 u|u>c 5Mm ҋVf,eYz '.\w.,xUG^>ܜ gh4͛C-vfrUwbkeŗoƭD>R9sf͘6f4YٹL=IC >Z7mf{)ҳ??"wzN F7*#Tĉի1ǏMH$ 83gbcS7Ud:Vna{,|kF 3٧Yj !ϰe~>zq:]\'Щ `_Pk4|toז߶nM[XecDPA`iMLJ9X(j{8 *3v9N0:j\"p$ coZ[_ݏl;BrZ:bbiݐW'=Va?۵ !g0<8`vqfrgoFݎ04ПƏaȡs7ʛXs!֖x(-9oNܥ˙':tt˓&Ξ]Gסl@1w}+!53#aQkQddǰ~'V-J$hu:=Oǖ-8_aЩu c)Ӳ2K9שu+x6jL,߮^NgvNP*̘0sn&$q6=ȱ8vqّ i҈6M1O/WѧKGm۴fB"'/u/s5& \] Vέ[Գ1,Zqt;B׋paX`OFijA f~og?,z~"tX*n3#ce|eV4/{?'bt+K+-#Ԍ :BX>owput";7/!JТ7陙hu:}zPaқ~55N{knܾͷ̚4Czp5&֭HY礒2^JTҧU39t:X8 ek*ò9V@zj0,T*NУ<9|AS.I-Ѯqcy8e.΅Gi>m7)Ǎam֔;wYVJb8#H8r.h3_cndi/qwwgܹ0Ovi4"""HJJ"//'''<==qrrVie~ki< сdBN}L3;vϑ)~?2:.>mt:œĒҌ+5MAAR; KRsD{k?̭Dt:;0,(%n?6 q~b^sսuܻG*337m֖Vus**`k/?ᷭ9s%VA2t \+#6! wg'F1_o X#GIfxf %+')|Ę>del_d0s!臟|\r^D_{ʞkJ?B߮!e Nh\NFNr6t ڄ\~6>)T]=:я'O|r566 dgGhg}#\Пfq`MZ5iL*Ĕ [E׉o{%_יx7.^JOf,o_'oPU٨a;?4ŵN_LY33!&.Vo٢as//I|x $'/̉Zw[YKjJ4<˲eؿ?œJײeKƌÐ!COY$+ s(.`my9ޗ‚y?(T$WwLAA16* r-,\Q\+ޞƓRލuD;=גMU03sONiA:@M &ݥT(X`>Q9C! -[1S*6vרtxZ 'edeϛO-lnvo6V$QbFuvʲ?e/8˾BWңVR4:]琒q+%]馭 SVƞԌ 홸W3~)5-TEi6J3l<%f)'.\d܀~<9|(VmE v['č*AXeШZ^Y5}zف :Rs19[GNXTB8""/,۰ ' -ڝ1ΌI1i ~F\r2.X[ZÞcӵ Q>5[oN[s>"߷Š27oԠ>v ЮEs݌[C~Awme^eDIEh:U]?.R~ YU{ ^ϼ lŭDd2~E]8&5$ ĔTT(v&߯';;:вq#8Ɇ{ӷ9ylؽ±t:^ _߷mc iZ}ve1W^͛+""wqէ $aeaONA.*}A* AFY̹z RDAH$tmcr{W%ʒNZ܇uulq\WR^~> +' 0jbooT&e2<\W}ȤRS5h@c/̌ɃظkAGB*Za",9+ N&O.zpvny[:jZBvk9}SG:6)}j6brAnhZNJ}'XjmPO4~pcہ}88z. =#J6f4_g̥/at:9Tqcs?XճFKd$+}W7' 2q8cR/bnfƩKWPP Be  5J)#-DzDAAm=׮S:a\u|cq-{uPjM;٦:tcoTgk /˸83XWdxOdfot%zrehP tf{aݟ8u Z[=ޙ'`T-;q7m*/5`7}y/%\7nҪQ#^2!E]aڧYS~>Y31lOLfS4jP4u-Z_W9+8_{'y҃&bڭ][=~EƿC{& WР@ݗ~׾X՛7qqp`aZ[14(+[x{14(РfpδlSX:ܹs% ^Dzõ\pʥoߎzTB.chP OjWAjH߶s( ݱ47aqM۷υ Xq3RĔkM}g͔ ,Hm3F}N'(Ԡѡ-_߽> Kt8Y٘єͻ7ϘvIsRƗ[%号:Wco{9ZUZkպ,:V\55Q(`K9*6 gdR`ɏƖa=TCϪ}}Orv -l`1д1_+rBnI%Щ&NbRuТD|^B7o)yjjI-Z>WWwWE^U:̚Wv yp&[Hтn.)W]3_8rV׭I(#fMw>x~/<6X%ٹT83*u|-[o+2m4N>q4iN&!AZF[ȩK3LAuVܪ59]  8s  52*R|_VCx >lmAҊ&$UXcQUKL s3V׃I&& wUf4s<{0x M~F{׽QѼ|l:j$ٹy VV Ǘ*_P@rZ:N|9sޤ];ORZ2gã*ozNBUz.4 "(X|6lH*R{o)@BB: 6۾?,LׇGݙ{g.=3 Xyj Wdh3B#(PoD5xAsAA/Shuz\2tzZ2LjAt:Wp^)RH ƒ"3SZ{ޓ1UEd|, lcl)զ:Iyӕz]ɰR>3v+e %."SzPjMڿh(Z!n8{%#;lq\]vj/ ˿ Tu1.ǎ0J+k> 3FF:#`h+H(R)2DB*C.A~JI+8d GUAjJR%}_o(RGƠ@)q27L][ 3q nn$>Hfdi@7b`gk M]%9J2ar-Av ^+gj7Py˶lRBbs&<2Cj/>lgL"ت^{ݬ )//#:L; ܱ]׮]iٲ%Uyx'OĕK7Kz_`Nܻw~W_/ 1uw]pAƠ'ߠJ6t%K%R* TT"f} BeYYXJZ>n. r#F"\EmA/q,XW?n?]i xqʿ5@yRBz֫Xh"aۅȥD{oUt->YƎymkml*^&Yo#sjD {` IDATG9_uJD縷n}Ko0WoLʢVYhYYY 5&9s&!!!'qD<J4R}9Z"4hPll?r-DP\fF::$hPXb  TR!G&>E'v)|޴ljgӡY< ҂;bQfZ/D`{ #& .ҳ9Rwv\¡3hZ3OJ"<6lMQVDGǐ3=ڶFU"hlD$qHұySxy=΄_Fj*~AA>c [s w#%k|HOw(æ槽KΪ3ndB1"0X]Z)}BJFFjr2/|%|TZHxgf8u!\``4葼Rs4&5tAANDŽǖĿ&l/v2FXvB΋4:Xjn%g҂}M\%i#cb)V"0X #3ǑOt/_T@{+z۰窖/Z@B(O5Vj!"ZFGի5~3FӢE &Lҥ'w0kaWqoት rܴ\R.$uqttdlT}IW+{"dj5w?0X@6lJ(A:&2.?!HX[1r8rS< ƽYF "شcEU&#;ԌL/A;yz~^7c{kklII൯`c˔Qñ4!ݻҶi._/+sщYm'lܜ{^XUA;gŜA7r5LS~k=[ҹe   ޜRSh%Ѽa}v̚ c5e4XoJvn'_wvXNc÷_`[Ή-vK -.=+;Om73#q<2RRġyrHἙ/Q)bAA7:c4IÆܱ&s8qk-D%${oTmeԷla\L|*$X+$T0p3|L|ҵz?ʹK̛2֖w|R?o_:hIM4>At(/~6ԌP N},O#CPUkƠFBZAZ'ذg?[ujyޞE@ҭ[fm2n(JOJ"v"#(38XQ4CN P˓a=1yX\OI%}RHV˰cAAMy }=i4kP$TSN^7_-<=;L|P)U>\\D[[E6hvn)ݻµ.J"O3h /^޽{IMM5k#Ji޼9GfH+jV-5>y!5@DnCF S!G_f^]bH6 [@A4D\w4uq!ݷVlKW`O,'*> HE_$2Y6p(j'EYˤR~hpCpW%$2},7鉸:9^^AA9Kg2Kg& LQK ٹ%p3-VƐd5<5b苯Hx:qw rje WyOd9OΨ>pv@Ϫ歷"::ׯhpttGGǻz`Hp+mg}huu#P}}`,݌sqPV#hDL,;5m02.۴̂.؟ >vmZ>Z4c٦͕kkeͤIM`-wlV* lЀ-[WfN^))99VlsiB.NQ;_39|ip- dAݻȯ5/޽Mk7ovðꔻ-42'OR(yn iIWay 1 OGL؅W}XhA3gwt:+ "Lp6D7Gfv.7RRru$e5f!ڭ[4_ڴ s.*qoǁ3!huz\ ;7wg't@fv.y2W0F%3  Bm19JБXtjќ ]_#TNNnos]M!$ݼɧA#_:6oFC_\P}I}Y9\MN&"6a\RC2OмaC47NvwLNVz aw\,]'".!a{ƒE#\tFCZ-Z\UKɜ~5mwjٲ+Vsff3?WAi]L9^Ε>O+W3?8n5^ne JdQ:yAAAAD>`H惃9x<'"#n$JqSt u+r/ :B0A^z }y]gn߼]ZZ4iM˷l!5= WoD/#@vmiӴi;#;ǎsu(/ ~~iscc;GZ6nDł``n^qqfN_7j 5m.qX&@h:R4s52כ?~Å8,TJ5D"ar-=Wo7eOq>:[+++uL'2C\MIS?lt:mmKh٨;~QKPQyq*3'#5u;:RIJgLcքqD'^F)W[~4Yfk&b# OO+8akW%AAA @j~ZC/^  Bb|\o0ʆcGp(|}yv V\YtFi<aMhݴپtavm=2;R6}=7npvB23J#rR's<1 f撒A&{[[,-*3:,thl#njSfz\Or;ݹJ͵GKRpήGosupp AF}*ΓPAAAt"@Xej55v'O2f82{w?l~Udj5*Dq"jG峅`0H\'Tܪ忶ө#.Y/ҪIcB".M>/EE7C/nP(ڦih4v~\<B^-budfgxlfU#ATZ&ކE*TZl4{$ڶAYObgmMzVASlaA{F׋pBxb[47[8cR猹|GMK% R}Ϲ/L+y}76o/1/< F7{lyJΝs3ipxu{>_e[Rca:ާ.厷'ҳoU_u!IȤY)E83sȤ{:6AAAAfL7Ijjxcp O''$Hr7on3x::xϲWUUVVB*CV㯾Qn*nj•gN.rsPsQ~VҋGv`Zpx)x\ lմ |%-#._AX;wߏM9)۶c0y(/@_pE$ ڶRi -r5v1[Xe\~Dc.]f <ƻłV JŶ~K6lyLq?blCΝ~&BӑǴo"3lnХu+~z]qF~/neeV*RVmukODb<7p1tm\xf԰{2AAAAa`fb\/ۃJJ$oӆqټՔ:HӥVW-ٽ6 ۻc3b$S^QY99>mNL4 gfy~v;nשU + Vԩcө)@x6 (I+hD"m@S?PXB:F#,Yn?1yEv#??>g~_Ǎ-D"a{o3z@( X>:U2 V*7@:)s>cݎ\̍\ l[ؔj֖!Aޞ:_"y~dO \&[,^t۱O,Yx481/Bדϫ0``Р>K>ՕYRø/5{썹DNǏ#F1AL&šrAAA4bJ1jxQ*ȧV*:RAOGG^>OOJm`4cUuhj`ɆM<ʫ?Ͼ>w1=.JyI>'hヿgє6326Q 52{M!+3]%WRFV6Νg: M#<:@Xd)(EaQM WGE~G*1P(Y )s\t.o`nZZ2_R+pDli @2 Tj t\ty_vf\vR]gږH$ۈ_FlAºGm+Kj{(    1yz:ck.9tM͚- дm0z.EaRӾQCzhi thܘ>Z+q_PcB@^ZV񷤵%66e>&jOTؠ ~%ҷ<}NGN?X\N .GQP[wgg H0έ4S^oL0;}x2{]ZWRZiru-FP` fdͼXR#S3JKNr:/_>] ?>7 mڣVJS5_شKGo_>?F% p*YYXYZҸA= 'efp%)J GF.F @b-jUdz`r\իQTx_n;kK+=IKZr2#+{TL,f)]W]'3;=2&gGzb~r WWL#\Byd2|4_;^G;;\r5xRg!2:l sayQ1ȤR *6|f+W<]VR\<)(r(u$3]ޗ.ښ;&.R)..f  p:&K_;Yj#]n4`şxѴoWYNFF1}cu+ <sjfk.R٤Ùأ5r=OVVԑ+Vp6\qϑN|\IJcݺ0f`.ƳU̞1ow;``4baaAf:u`!h/Ű([ IDATݙ/Q8aqdyrkӦf<;,|Y\lѣ= A;tIcc/GFеC;(|.]4kHۓ|ߧ^XZYpBܼ<&'DLm*z^9:biF)W5dq ]3˚UY4+KdғڕKN^II\\F4>1kt 4m [v8<,8XdwH0[c4qVWRJрƠG%~)Tʞc'Һ%3X+SXYXL+ڔH60W8& ݢQ#Lm<\n@ΜRQ.WTW[O/aQQ6?fd\F'&͓bPq*1 /?ݍΏ=IN^|ޟ#|q "0( ԼϰQƍFH$z;m;ts#q#ۦ>{e뮽| 'IŊN - 8j 򋦌|lG5RAdL,/=3 2>#KK,zlPڷjYd{`ӎ]l۝8ҵӶE3F`ZYx%՛o3]gזmo l y۳|ᩉ"/c5e}GinCn]Q*ڃ#}w5slv"B1>|m&EyF3t0ڶ1UĔQN޸.2l@_ $$zYקMDu[hu9: сY=m/']%d߼r J``. كmZR;P7iu:΄GIڹk=$0?zwhG&L]myN?#X{7kmUiڄ1Ы};,a6?HVNNmIA{tz=%#-8,>!1揹rhdx A7۹ۊP(toJ,^wvfv6ڂרA yM3fkyigLyϘH-&h;n4mkri_=+,з`ŪRYw\N7R*<;7E7뗖o0mwit]Pi,7''դ[dSz~_Ëo1Dp :tj{(B-1[:O~)= vZ=17XC`ힽx|ٟl.:3;7Ԓd GGN!ɰP}0Sf ;GV-hДӡL-Ԫ)lP(̎]<Z2{乊(2ەLyxcmiꍛ.7752)O{,3߀L*5{Nʢ YX9J,(eO|cӎօ{)JE>yڬO~~>!tj׆&8j ׽'m0~HSp/<4j56_F!JYeIddf2wOSpÝA}zCVv!]j?Fէ'r9Z4gԊe,x4eO9tN|MEp>cVѳ][>}i:akW}Х;],GGӴg쬭ԭ+?:Z{=[n/#~Fh5R@*@yNJ"JBZClB?@NU Rf8DBMdC;kkm~u<+'a^bMv8ؙ{v#U~M3&6ϜԹLmzсL)Hоy3c_,\ėr10UlS'ƙ2|vAkD`8;ӹe Z5iTCS"F쎛sÍZׯ@#o؟ݻEZVFyxܻ3d567h${vڠ&3_J/<2\:iEۖ4|)JƍƹHNt9r4ؿ̛JA{p5\n>wFC+ חݺ}Fc떴kތ._8 `00|P2P3CDƑ|i{UI\vc[6Afn[qhB~ R C{tgPU!+SUY|+lq>:uR!gЇ9}O_WcV~ mK,D_6V8/{p Ryz]5o&JqV71 ^f=tgcb0 ūWIFkjUe42ϼ"; }}|xcWHF Q*ՃVt($+S9p)\~3_+F.o/R&!)|VέZ2aİJ?Dz<3>bZɸ1v9V'پogɐIB1ob-Z\K`bceIxDűhS)+iN]iUB CKʊicFP*eTUw̶nܐ֍p:˃vTx?zjd|q|8)J<:kÙ{:iE`F4CT\z'Cpuw 5BhZD;\ kk+n𼕚F╫fm$Ym{%QC:i-hܨ̚8R h\0A%61єn$DY"B(H\e,-ʭᆗپ!x쌝 SagD<\VШiۖ9ª y y{ņ\u@6#j/*];S+0rǍ{<{\+ؿ==X'4jZ͜ѽMkSs\ﶺ:4 dputj=][d |K|"@XGh WwGaN˱Pp#/LJg]&E.^γgض e hSNwƬ1Ess9Cq|E5GoR,HPw|}V`f#?_3?SΗ:/OόOTx { ΛOHc$loϰyfp1q|Rϗ[`wš`5P%[L٢eΐԈ!UϊIv[jۊǍ+W~DD']CjJy暈D"ᅱyr2~_9ql,߹#3ƍ1brg#dеu > ֖M߳[t {kzm͌qcp(gBOБ㜉țƗJ/~7VyMk^04\L v667 /MǯfWf3ߗ|EѾy}IK ]{ԥv⽟~#">B7^KD'^ӣmk^Pw=XO7n gƸ1+aAx7RRqat^L3g̜}m&x#=j_._ɈtZ =yv9):= <ZzAvN66e-bei\.'3).Pj'o0X$+',o2sfDRѬI#NcAUГͿ\4c#2ؼsD"aӓ}(gαr&i"uc C^5؛!1[ZJWWV?{ F#HG!ƭmݚ{LfnҘm c˯p&ldžo@wGs2jP(UpVӾy|A]/dܥ=۵eR gFɉg> K Ҵ)u65TygO4m9il;jA;h`q`Y\eq}_q/PF~:OYZ- 4_ZQ ||'N;sIIKֆvԲE/fCDţV޶MiNjU*xu&&Od߉$&]Co0Lvm]nB##9Frj**x}R0~dO?R* B5+= Mԅ6M~"0Xw8d¢M̋hzGǒts-v&82׿f ꣔Ye>2 g{;^n>]\ V9_F=/OlW'%AavGOʗbmfdfej.Ά_d7s2g뜋]5,_,^u&2>e|1B.#Oas#5u֖A;yW;put\t WDZD̂k3O D//wPmh}>)a=\îi!]xu8+ օȄDوHΝSVg޲x81q Ƕ>k% pH %3o@B.対c`))?w~ͦoFJ a1ggakiMז-X?ۀ+O %a1HR?+8ڒCn46w'ZqD_g@惇y1C ڽﾢF_|͎'hݸSG`|l%o0gcB/ɯ{Lw? )&tɑ?wx`u*,B[Aߴ/qZ7nĴ#w,s$)%ϧO *!'1*Cwښ 1˯d ob.;Ͻ`%zï 0 $\ʅ(NU ؟q/j +pfi&77s 6<7R+,J|9xmJ["G֖6kcVO*J4wqj 3O<پ;k 9_q&4 D*1֖dfeq1:F 4nJA|VKtc~e[(sEZfH ۛL"cG8zfLǢc wǬ OV+8xKc`NH:W|쾚dzR:j :>;Ȕۓw&Okk5@(_ww9Ϩ..5 ~Qv_JBST[pD;N0\ 94sPHﮦڱ6)?1Af۴nҘe|X^'**{\VRѠA,,Jfh|,^P"@X茆Vw{`3~߱luxVnwsQwߐ]FJZv6Kv!Cb0 k֖+W^H$thќ3+KR1_Wyܜxl ,eƴl\ uec~@߆hY~^xx O<6L5ϽvGvuع k ҉/N`t O={Fի<Ժm]I([UȔZ7 [kkR)>x3W~Z';`@sl(r=٤R)B* 7xm*^غ'Άrfy<\] >w/hOo7W2I˰6C}yeUӎIu e3^4iB Ld؀@ΥQMcoLv1Q_77ܝ-.!-'!mW! ėAFn>Wy ݨ8S/[<ƅpօD0-d"h4LLx3sq{/ JMF_&gNIe53pvOc$g0qH(CBs,dRC'ʣT*)*qrVskHHĺ62gXH$!95BmDUM Y̙:A?nFԹ81 LMc΅aMsYvx@v?K8*kYgXcB-/ VV綬-./7(jZɤ}jwZTvO|u;e莐>-ԧ~mIIIĄ_= K䟻\o*a6q*O|cGsB6x %i˫dghSF, 3&r9V:AHm#Œ!Jxep22r9g{po\9;m;)*/g`~Yb/su&y9i5ҙX:sE>ÏlJ*/]Lh,>h5|pi4)<~ϝ='\,>F,‚s3N#Ϟmgv66,5-u1oD"93IxY]dj[.KoΘ477Aeu57͜ΰfLDؾfʸ1lۻ<\eu1#Gp۰H_!vrv. \8p9|o7/,Z*#{NhFs!~,e"Tj *Ji]GN(B}f 6 ;;^UkB6*.#qݺuEb1nFaH,=S@$,t/2>Dz-:"tD"Dmh.ۼy3~)NWnIy.>UXޞAA?s&هTKmԖ}  ;h$b1vVV( YD2 XIF} KRf["^9Ι)L:)&?ݴӘ>*fM{`gmEEu ;s7ޡ<˔❃ ",2/P1.: Kpwv\J%D"i₃5el?~Χ{|jֽFi>+MMe5Ӭi~.cYqaQT[D",#[`T wΙȠ,~}4E}=p'dT i/ʒIcF26lDf#nU*FεX]LEUHD*١3-Md2RI}g"&.Rbɂz{Խe,J)31 6b{n,|<[)ɸw魌l|Eb0r`<?~}mge͕`[ >l\m3eI>ǖH= DB\j:6V9wv糲'xNI||&& aaāS8Nv~/2o8~?tɉo>G3s(g^$ۓtmr=wG?M~I eՌ #jFn<챣3ڗ^d}5"?yuybs8,ſ`^)Fiϻ~dI]Unh&0O/&TٔTT)LHD.q) ]7b= Hf~>E%"mAT@mCr)Ç(< .vy0:$'~b/p~9pߏř;fkmF 菩\NQyxW{{KK흷vs%ۋ{XꛌHF^EL9>:q܂'9èAKeDo9`fp9&?&25K0e`" $GQX"t6ߘD,u.%oObV[.%ʱ~G:9:h\X D''->"UzRqa;C.upr6]7(П@.elmqsq (!@˸2&J&!6D7qN1< %!sK7!zT*Emag`Nc0qqf45G6Z0K@AQ1Ǐgʕ=f02 Kss=aބz?]j UkM`K@`7`A}]S{Cǒ^~v4e k啕K'MҪC%O!S>t(=x J4tllv7G-̙1fAhCBih.{'G~{-~سR2)A73[oᖩ6r8]ɯ]PH CBX4y{PyE3_B$Ą6TJG@@@~3b]Cg'ba1j5YM,We1qz馍_QmŲl$Ș#J:Q{yNgh֟۷3+괮an`\...WE4׈ZVQ-cZW5^u9~tasw|NWyj] //>oU .s3}(kӮ'Tų=60MTLQcrý;l7[/^AmX[_OD\e,9 T3<{8r۵=e+o[hmëv-!3yO@;5~uWlܳfLG}vWZWr9ܳkڨRRTfXW X-lim5U E"|]uK(Tr/z\Ily3сT9+['7RcT5u^ j%vOZ^*Y())r>x|U< NPV)++~۸01SgܸmLzϪ{6zm ,1S<|qpfGYQЮmD;>L<^ˮ]=ی@l?3=pE"DQk4d8<)89]Kb=g:rbN'MJqY(  s p`tsm"JIԊ=D&c՗( ".lܵS喀O'+Qؠ⃄jʚ.9,"ZvIec>uQ"`0 -䍻J|ض{!'!^SM>.ƭ}Yx衇u먨5ZY=; bD@9ZԷ/SBB;|[#"(,f*.^d[d/l;?QQ{*nh3(!% {NQQnnZKڢf0<*؋)+HFw@afڻsԤg1:X_S O[ޙq3)%. ⠀>4(/=y$ꦺN+.m9Ԅ)#P*DųydsͧD"jAPמ"HZ bryP.c#Va<6Аr㑆bX/74Pɤi,iTs{y*e>bSSQ)Ux 2lATo6읷cn 6%OWڵ`,mD_Dv:kNK$HeJe r`)atnE¶utayU5T#,6^yO@J"R{f78IMCAݻhVswpc.yFb :lI8XYQDuCyeeO|x zD"o*4`& 7T^X"-S^m_^Ҿku8>@mZ AbI$h{FCV^>eý5Y 93 XgQSWꪏlrW(Jd22zdrLD/oiVėy}]zK|}Z3xeJⳟ~౥K051a~u hcԨqf$(x8F,a"b"2ݛ; b(:=>poܢbxG-[9~ H#GNL5k7y/}T}ɋŔaW0 t ^T [{)yyM2fnPԎrϞLz_D,[n (D&~AycϱdxKҌ>۵.~ءC>(?ϥ϶yxm3IɜIL[nIa#Ƀ3ۋуe3AXe RR9q IDATd2_MvqtP7N/>tפRS)IJl( ZT*ZрL뼃PR =y{k9IolG3757Sߠml΋7)ONa58{)#ègˁ 0ji.JӭFh -YY=@'3" vv&>F#X>y2㍍?k๳,= ?=ʥ] yF*kj@V*kj%; 9|NlJ &&r=qBWVǣ/ !=f蘖󺡤D҆܂BS+gIEc?OFP\\%mJlj/}5[jw[YAbFUƥ;Z`뼍09/ `A#y*JDb&a Zydb g K ^u,ef8|q%6hocÀ~>$gf1ǘ0l(Ã2ߏFaaֹ&)#iG1G2??R=&r9VG,ZgeL_I:F  f.ҠP J .7`o;c2}YyyY~9/`2cO&1f=&M;2)#8sB1s sȍV>չ;=؊l5[ɼxpՆ% pEXȚm3;F\ *kkuAzP<]]~=p0sq52>?l,ؘ-62ldݏ\"I`\?/{?-lx{%|Gc8yɸcލz-ÃK47̌D2s?pBɢiSډzZ{8s@ &/5DD4AD&q&1FCO_Bu~:.2FD2idʚEES\V%ch-T*Ϝ%#;SB߮T8GN~M͸991~İ.'8#;/ؔJ+47gXp^F붜3 D=RR))/nt6h4 G~>gcol͕ÆVH JJqerl;Mi)*+ΖÆh}YhllxT*:ծ@@bz:2C죰\,,ΖI#ð2'&!tyӷ/m? KKIN`(m3I`fjʑSihlۋ1C#9DAq daeb+ h%Wj㍿P*y,gΧ܌ $efuW‚Ff_$9+ JC 3jN'$tJEcs3qƲU;!*}z{cocF}c#(CK3SZm %BUH$R‚ mjHH';^O+<4*"4q{3."sGj\tѨQTgQ5X~]Ǎ[EM]=g9w>C8-[s;{|}\ElJ*%܁-SQt=X,6:YЗy fJw^VЀ>PTRVVX,b1:P1jPiE\gk/Ft\JL&L@x,,_RQ];:t&9gcr›8u @"h>_lcê)NųG?eBU?[O'`رl=x}'" s4573ipK@]=xt Me>>WPTYѡ#zgW^vYcV| yex;;whm5(Jf3v@ʻ'y8{}r@XR^['37~Deϱpӈboނ[ſ/Hŋ(ZQӭa~@R?q^xkKKy^ ܲo?$g0(0*?m7֏XT4~|051O>'{N|^_G;[yzWT#GYznx84 KqY{si,1hwdבca"s(#O{KHMӯ:DŽ)(.5#L:̓w, VRκ/OnNNFǞ[T[k" Mxt 8ȳM6Ħ !-Ax8,Zȴ1ڇ6op)zcnj5kqsvқ.d\;wu qvTl{GqϜ<{ ??R #Ost4//|e^ y(66d] ߏچ3Y>F3(.+׋£ U%='1gMK#=7?OGakiStCSs3$\V 9~}3}?Efn-B) BU5u<ѧ8gЇ-{FhwK** ~0"Mr8*ƠOiڍKrZSCW;8MTV~5VO?ֈmG!ؿK8Wu}#:lcL@p~R+ Z{[* Ԋ[ s/sQ^UEBzrQ!L>Ç<=~;%ϽbB$b1o}NK~@%40:α3LףT*Q(XZZPSۨP(())E")Ԍ mKj"D:YeS#"SLg+=C?^.fj#<_hg˽ oX^9q0F0yp‚8vImn`C?X!}XR)t x#= 1  Xu.;AݿHMS&M|qyE,aJWA N0B XVڡlTV óg(ŶȈ1tvV.]_6:@[ڹ8i҅@Za.iP6ܢ"<\\ V!7&698ؓs’R/F?Ohq.^yǞFp:۳b"n4'VGRF=W}{N1odlܱ7Lٳ9ÚL=tv6ּ_#26@ gOF[A& Q <|n_ݱ?|Hf\E Oܱ [aciɛ?*y8Iڅly <ݴ\7o{<2$|_~)m31S ߏX/[f- .8ّNh@*),)҂ -,!P[W׿ΜIXzjjx郏e^u199D"ǟӎ]~@(pɜ{~oWA B!n7d"Ӿj:R%INdli9 WĹ8Ly|-8]$ef}dgL&͇VIN'$bgeœ˗~rL>J>ysŋkcemG;ꮵ'7Q[_'xrb}'":wg  gTlK)W8./" T~UC"~5Rko䶁=h%= Hf6:}ݵg}}O?1V,ZɭB7+`Ӟ{^]Dbd2JZMEES^^4 ; iC-"bDx cI$4T2ixxxu9d_R&LLPҒZ3KZ7ea8ڐCV^NF.1kaA FH1PX&zmAk .ڲ6"0lT+I(m+Itw[wѴ|q;jeBG̡:ie}ZfefvήsP߾ +*8Btz: e17FyMѶ"DWxYX#CCŜzqÃAK>xZPT$gd2s8CD,f!'hIMĜIP(~JB[Q[acSǾ+YFrȀ$Ύ3HLԔ>}I ,:QhceİK6 y4ylo1},NH$̙8Ҋ r u ->5 [++fO>ϗFVN_eiokÌcKIAѐ^O@߾ħuz, ɬ(UJhljB6@H8>۩6,qL:O}'bv~| P1Gcq:!1!1XPK[T̆YӘ,CAg{w$,߲; cy)-Ym}=9:kӦ] giniS iS5HcFxB&N -73IZQsp4:ﾂ2Φh.:T@@Q76QhJg6*]p݅],hsIM|1d@j 7>81;x?g"u\cafH$w?}jvgޤ"~ݻk~ 93vX,x[p#B6nwo 2 FF:R3E"p69fKʵt%R@ii9Ǐ ᭲, ;; -_hhΗr9X NgΊ]- 2y:z//a"4hفj6)%bwZjhg9Y~yZZ $|߼|4趪gggF1ܸkHHMlVj *ε l L //OOOJ`W\z5cXussٳԵ]\Jd3yqgˁ|ݻ"I8M[;?7l$"2 BA.׶‚ CˊU֘rA߀})@5z=k##-b?%攡k OZ⠪~FiNkFaM8ٱӏP(;hZM}9\&_3l۵B % A\i5@TyDIjV({->D_N\+??6eE]S2Tg}TZ^➣G$:{0}(#6$Ynnӌzryk;DVM~{Lʍ,Yƾcһ۵ۋ=G1JFiQVprzy2qJ٪T^V~(TϠZr rTT\~-Zgho9WNu |Sһwۋ֮vaPr9/\\t c@xhMBcT A.cgk#m^G['ZI24>r@?Ҵ)\\Q(Voi r=er EEtVBǁyy= :9tha|/*.fG* nwoż8 ,}&,8%sC.q| /-Ͽ^=.ƀ]jf&_l@RԽyE6|k?bE;{'~~MIBϳ_[c苗x$$R())ARsO2o/>m )e > ^xNoSüEe)З33J4v=n>$ܽw3{XVڸ]:1r5D})W4_~1c.͢"％eٙ8xJ^jhM=qf3]ZT(wO{efH]JK>i&=ASfLh. jXD",^oϢe})G|HLbJ>zI&Cm;8p1TS!ۨ,wrʾC,sTy.@Kv17I'7kTM A_T\=#JO%fzwR^kQ:X8S/w7!i\J$ooZ)zz{G #5#-[dok>b̃cpB!ӦyyJ$yf7RBSEɹ$INNNdffh*9^¶E'd6j@ יьAor"o߾=,[ ///ZnMDD'O̙3DEEѽ>YvBq<q::xl-[חݦ~MЃ|<<㏚x{sI^B3Fm֊f&&bVg86^zPK1H~`広*My{w!Ǚ7SJjҞG( ⵠM *WMqI #Ƿr-ቻFF&G!,/v^..D1[YqƌᵅPX.墣Z,;]9߀6m񺆑Pz={WgTy IVm=G]YǾc{EjzoϚm)*.MPܪW<).)rZ9hqJJzv:#U.=dr`+*.Q~Bn~>>Vf|y7 *.6C-KwRNNبHeJgnAŋEϲQyy涥^)Wp6:W}aׯF$<4ǎJXHNxn. `ăB|-|8A~A`0p!>`2gctsڹ$IبTmQ6.>)}",S&=vBs:X@Tl98t6:G{{`hZs{ h٬2AnnE8w>9<9.6`R^ v>ro,g5a籱Qʼ8u!OӟBQe+/lL{#Nҷc{ gsʛ{y^kZwٵ퇥|ifW>3fa:z*n[fImx_95&s瓐ӓܽfڗҥu+L?_SïhꠍMWү 3'ڱO7Σpqfψ/W/ga8g5_l>pmEG=ɜbV20boO|jjbl?r wg65|5GRinm~Id|O~0st ki ӑs<=.<5vo2kg$I1URZo}mBӷ7 "=w3ePvX:`G dmܱk'IL y)%]fҳMkQϭ) (R*y\ \ѡ,(XZ߻TNDŬ 8#)<)8y!ژoh B}/,r2[<E+5NcrGAZ@R|W+"z}t kŪm۹'We^|j[RAP01f=޻lf?)Ic?bx^V7k;jTORRL04-!VוF =ǎsSORO܂_;!BErFNf(䖳FFq1- n?=+JvMյL4FZdijcTZSuc}egUiə9w>;ZUKLRJ ᡡ;aU=:c{8OMTҢ5)<4WX܏B!u),.rL&CmkCJzYh?`)ui=Fώ%bX*ճCVn_kqب8tW'sk$ѫS'6M-hHzf&֬~RUӹ XĎCץ3E%%a#6*W+( {;rYX,ɫ)On~m;s+u cU8sз eî݄d}ضEsa2w"vD%:ļ=Imj^y\9t;殡*`JKյmw=x7C4+޾KĽQ)޺K))VݴhͿx3gٺ?#Mu3{vsZߞ$rRS6a|R)^Nk`T ,TJ%(%/S^ƣRytXlmS),*Nͦ:j-xpH^/yOLi^Gd\M if^6ߗP+g7ibRTվ SR3|=\[Ěq@4C1HH6m?u! Q<5.dD/c5ؼSGtߥc(=fEżcѱU ~X NŔ<\ֳ;۷Eo0@{Pj IJ7t?%pbfjזc|MО8{sqtގ.\J4ţw!Nj@/:Йsl9x.a̟Vb( O]9p)ix{h8z9V?դ3>_LIٳЁY=̬6/s&6Sѱ$6?M玁||%F:{fq+7ZYfW2xp: ޶+W(ڛգ/^2n_/;ŀ.p'9 ?XNkx|`mAťyj" WGR\Gtlzxwe6nx|3?Pq 5%I\p Z p/8*F@4UdѨXúb,*Fc*!H2 ɐd2dsePnKQQIIIaQW1}-{ɓ\t e-1zS+޶y\]0kJ˖gXvQwhՒZVZW7rMG &]T UbQIj8{%j$:ԇBZIm[BFV@Eh]PGͯz>[L3? z) 5Z-V0N.}p5|\yj}ju:>[R0,S*$OGT(֮{uɨ(N`u5p19m-ݍ?i\_*J~O~|\Nfldޑ#e 9`V͐^Xi3s; ,ǥ)*.y4_/O8-g]mm),*baVh.8ƌ"%=/ޞ=H۶ޞQlڳBcʒݺA~_@sVb%a!e9~.AL)<2a< Wbہd24Z-SF"\gWmya^p.{+Wq= {{eQ^C7' =<3Д -{@t$jx 2veWPhpֲ\m9W'B51EKeeRz:LJnj zMJ?E.:8Cq߈a$ ZS*u#37Wގ'1ѷc{vۥqNwKW؁M2ssߴnƕ:3{W>K\Rވd=ZT{&r9狖pz& ]Aډ/Kx52&SFdH z1hs!x^AWDEIv ~D_bicU$IݝdȔ* ck\G'eg׬5ۏftwf`냤KQ\\L^^aaa.^1ޛԷ,@GeS;V{@ ^v볹Y][6꽵iޜw?KfNM}qr_>cyDW>?t0Mtz=}u&Q(ǟ`_iRzm$$&akkC`2-;J5j@"cbQ(cSSbuBp@hUNL1: RɛO=ADR32pvpEPU/=KLΎgqsqW_!26bZDpSRts#VcFӯK.H@:Zn%m)/wJA֭-18KII ^TT8gG OjF>^e䵓L脋geBHŃ₷ߨޔ vLVE&l޽HJKřЀ}ѣ;]ڴ!*.@h`yӻSGzwhgz2WOcAf-{tg`-js P:j d2d29CWM:EFL_*IFg>ȸw݃_~[VE5*R*g*k(}P͆V(; i!lFxp3{qxO(R?V)Sʬq.5sT9PTU5,޸fA8;s/AY~ TYYa2WX[>x-\09Ʈcl?zb8q!4^{~mU./Tzva| r y{qxy> 3~Ρgxͯxx0oJ׿+LL,/[i~}lm;Yn%\7}WK93W z4h 1d 5H7]ޞ,e'yJ*> )肄J?$qѣt+W>+WB֖~z`cՕ]Q#S뱷Bq5ZP>W1`X}e<,#z&v׾fP"N\LhDɱ+,Rt shs\.'|׺54E<}E;vYi?Cӣeiչɫ\&;1];lUehVsguf+׉kԌ/9Ϥí< E~A!OzJOӅ|\<)l֬u=43*J G{{>{;: b ~VҾU*ڨu z6uu1,T(Ҧ5or$BkpXCΏ>զtrc'ɬς 4MߟR/,AmF>E$Njp1].$Szz`_:Pg0(2,#;8〨&Exp36?h~__uߏ% mC3`0XiaSL>ὺs9=4`43]5ZF.q)5w''Զγrs9LYE?Q1yFAJF&E譤9;Ow}yyV14r p|BY dk\uBi:._a@myq;p ^OxPyF0,a Ko0ă]uYO2nU?4Bj#2[gTʫϴvTqS˘~}," P?[H?8%IW\Z?!҇6|F|t.dq42-[e:8ŗ/Ovl=tYNk?k14|4>Je@*ێӃo\E^S˖8ڗevJ6hN"IXHt:o~ aޟ 냔KJ)KQS}b 훇?ۺ5RɅDZG)z6o:Ǭ!)-̢Ovt%$c5mݾmBiZLFVPa^?Bj9`o~2rrQ>{Yi/M7+h:'#wnR[_;XuO3-cR̤|R~ZL>L̥Kn#~)7S./Xl7J3ChĴOsY\` >y3g#l=xC`!|_mh?%|h [-ueƔ<<:CO>-`_Kr=9+>=.WH*0}m\xчkծG1,^K?`Ґ;hif7ؤdVlɊ;vm݊wʝ__epRd8*+]XLheu݆ WfAl[kx)%E)b.c=8z ޯҧͶޝŘ}|勾}KR3p&ЁՉ7o['m(Lϙ5 hd(!=4m 5W׽LƖm5Y~'}*WݛͪfkkK0aAgkoє]ٱK %f6rJ=% //ziؾ^=Jd\L7NaM;91{NC~QUQ*֝XaJ&AA&$‚ Hk$ ?+OTٽoVӮEh4T5<,卣RђqNWT>Aܜ$,Ь9մɨkx+4ꌝM<*DOjm%\=߮gJ:֠Ɔ:ULONU.B.U_M5շGW `yyZ=+ jCP5 4?n5vp.6Ì&_vT~_:p 2@(jxWxl{5};u,Ɔ;}]ףBޥ\\ 'Ky(koi$5Vɶtz=/}9~9 d2:vOZf&#A5& b~a!@L›BR#AAۂj*+un5šm%9\mF%T^Fm+Ȉay8ت5oC_Hq\ wTV1Jd_@۠t P+ ~1˷l<4v40LvJOOJV6:dM}5oFYL}-ƳN}G\ey\ "@Xo_adRJvWۈ  `z!+'At:9ddPXTA.Yٌ" {ې۫kRep@Pt(.2QA_W^&9uoÃ!7!4$Xc"㱧58`0<9 u_Bڰwx#7$Rc'W6tSjNUFsABHNK#p[O'(*.Oq /s::#ԁ">?ʱs7l{GGnr[ʕl^+?=7llBlVzV̴"3'#\'EC7@= pRڠoYb%$6i&  B" B#.ͮ? GpGn/fr!"K6mf굤ge7Hry˯%<sLLz??;ݻmz͈>=۩s~Qtt:3|D%g|lP|o/m\&'<8'M>?Α3gշ7UGNH&I8(Th)p[R+b&  By#EmGӡ7NG]XY#p[Ftt,N*8{{<;|,~֊;y?{9q::-܇qY$DNA{?/O4 nn{yRQ6mն0ox9\LIY.&p*:+|Ah2J$1In(\ZAAh.I"]*HJM o:f\]2 }r8EAqR)+ML/66 ݤ:WsH02R] l%%%<{= ՝ 7"s&&f|d9C1izy?+ajFE>U@(wi'/MgީUjވ?zSGN\ҳ+!~t kYGIR&IeCA $Ib  B:t+u76:Sdc+Oǩ>|" {- PF7 1) Ϳ;ةI$;'VGv~>ve3pK<],ٳ\0Ok,۽CrY,^F|櫸8uE[J&G3u Q-$IƾJAAh4D)"5F}SK׳q^"EjΈ}I'q0ӹ#[̅M@^+W8bk 4kZX_22vlթ[s.6M28{Q D3?2rrO`x<^s֌BCG`}5x.n+h#}cF[rY6~}8:]OJb3_0\mW23twcԀstm8~92~ su=D3o/v>JD:b,'"Աqqts&y;s ^NMcM4ݍu;vÆu;w>v i۪A0~lfaccx8zD~wE]uxhdj1~{:Tpq&-3,Q*8YlOTT5KWW*T^~h*1z(Qa*^~h5~ZAnGrIB.  p O:uH%M}|lܳBB`:u>ŹX\`0;-iD@ ќ:# z{K[kz X;?Vˉ(22:Mpj^0Zyg"$;Sַj '{{T*Ŗ۱lVnJ$@xߙc 4.I<$)i4Ha4ib&pjvƨ}9~.'~^O77df|3 w,´hv>J׶yoYm2IBTq^n ;e=޺̜0 w=II:ofU\k!zê-ؼw?G \+LWm#ߗmACzFz{r9>9Vo٘uش'x繧߫&nԽ7lW-o=?j8N%+7I 6Pnߢ9bIذg][TX;]B.GPjILbˈO%ϗ`?_l 75J?;w=1yĭ9Z#^O{@n>A5qu%-N5XC5 HJK#eJ4چnRlJ憝BM*(*)&ĔTg;[[BpurGRPTD$5tsz$H=W# ظg/>,=29S_~vĤ VQq1s_}NF] 5DZձ=nɉ ލȸ8 /prٳ Yopif~y[9yy|22oq IDATw ^x>NFgxά/f=|/O{ؼO|oYz&LϢ3*ڸk7CzJV6lcîaLx;zt_cM,\"`s'/?'z-gcbhğ|@F3ckcSkUsH0*hۀR`Ml=p31 ڙ7CgΰaƿQq ثmy)ޟ$Il߆G'iGN~ wiٴ '.жyZ`Rq瀾y.6}'N"rQ[KFÅpqý$PlJӱ=ML|Kr9:[,޽};csDQ\R¨}Ys79!o~^{F NMn]h)S126"X&TJ#2[z s↧4秿,dѣ؁oy&M.tџL0p9{WTJ%giܼ]G{;2sj5Vq\L$LJAAh:8MbJ9 ۔}{=wt&9g#쌻3#Uk8ztF.Ǥfҧs'2a7yBM1jhe呔Fzqޞ8ެ#%x^JhZ6IwmO>`6*:r.N \٘4g㣨>lM/BhCH/b`b~bAAED Qz/IHo[gc7K"%H|>ΜsesR%:5c=_z/qcXa3 FzwăvEDukc4]j)t@ l2}0/324WvMFCz: "\`i߀V x'Xz  G?M'kBN1ج)5es%<̢ziki:er~Ovmٮ-Ȥ?oӼ z@(.$#*[+RbxjUp@uk`ѣlڵ@Y*J&ͳxOCB=2]+$'3{rJ[v/:%8{EQ EnۛWqժ֓ݍNkjVo-9'^|Q @ *Yiaѿ=4ūy^"K9H7ؕV6+;px5~_w?S:?z"Q_~͎(Zӿ\MJt%M*l3Uڋ^2ϗK$qgv١W=uo/@ #7bPb;$1]Br]# [BF"_yB%p =۵aY|2Njȿ|49dY( zvօO&J汋Wg6|kC//= ޓ7F+)kW\\((wԱ3=f-^'tRG;Ye2>ZUm4BQf.ZJթ_f-uc@}v+}i)ɳIoє_/G;Q5\1Ƚ}t{rtT5E*\o7K֬)diO͟Ǐj|=?Nu^)*t*X|8"*Q6[* 6ZtT|E@ @pr e '3d4IS Cf*ر|׾Yt`_~;îV1]w qlf+fִТ~=;!3i{| :GD2f\Gd*6:Y#,Z4``ѿkU*fF4+8Qa,YؘΞKa͖mCqj@~,SRڦ5::ի}~LF#sL'?? 8inlu*EF-B/>qqCߣE|}Oֽ D`_)׺ z=>ЇO'L&moYu;{&,$kLZf_MBH&ϙW`{>{/!(31{mLfu)@ \%>}v*˓I2  ( 2G6+T#koGsW9xuj֮V?ADhօ9ꔓ- G3UsU,N NGՂt i]%=~1ʚmǗ#d^stl֔_>_ ?｛ ?#Eh"PJLMM\Aat*DT/<ǰ3N}0iܐu=aNDD 4WF,eǫWk$ߟ֮ @5پo?Myl\6Ow7?Ξ'MbDjzjO ,ߌl6j'h_f !>=*FӴ~+,ݱ;}: Y^76 ϵjg2o:nmZ:cjym(>ݳ-B^ kg߾N//2뱞cdIoKu= z=Z6gxZ4n@w(+7nP٧筅mϨi>>f>|q ~~ڮ-7oeٺ czD)KcfG4Ua8vba0W_((Ƶk18xqg[!وvEP$Z%Iؔg\ir^nmԫ0\-+N@SjWOh5EUI8|\ԩɒDWfcs88DvNq5ylܹyx"lv;N bvl5גuå2Ǖ勔,2-yȒD)PZT횞KL%SA-P\f4 MCIHvhtO]X}^׃.!@v)󰉐0aZtzR7 Z7'|ʩg]^5 LK]1w KVNG+j'۩=]eOʱ\4F!HDu?!:0*7:j4?ΝOgUkfFD2-B#R >|cj qF6/,Fk]tNiWY\Z} K׬c7S=+ٲ{/Ub< LF#k^o%I"V\Tg6hRemb"NS:TȰ D67罖YTDGFv<C7+a%2@Ddl2Y/@ ./cxur44EéH]r=;\Q%/*BqkT$IjJH d3#M̏')2ׯZ;wdcL5p;`I'bg5_V<{},\5wJ{x O9Y༔mؗQQ:zW61lsظgNJdA, omU..D Ơݔ5tAW eWwt~cx?}:Z4竷^/zd[ %C7+9 F|BP@ Jy"MKsس9NV vp@XN,6paDڒNU S92kVx/-\)0e9оsy]71eB:| Ngr >}_y[v`W3Jh̰i< C%O)z94m62 h$˂q5޺%Kmv^~b wQN95{ɪs o74ĻHFfv69yy%3;4ݩ#8C'N+/UĤ7GRV1$zFC$| Fr7 #_>fku+C7I zm)@ :u\U>uz":e4;HHd $ AMmf(bQP2]CfiJVN'ccb8|$[ѡYSv:nF<; Z1͛kͯlFk~RJeSIIf/[NZf{鋖0}RN%&mob=m67m&3'fҮV'uENyۊsҼ&-6*SS- u a!vKbcWaW`ifxmAqF:GN^GNBSZBs `ㄇxJ.8Hv^.b1mv;lZJmf3Yx:~BY"!^eB|8$gg(j2zYLvFwInqJ+ob\)5n4M#)+syz@ {:wڶA=[Y8!!$!*z}(“2l:uHbzYTѩ# -sI6CfMٲ7ӲwVg@U5}؉LhP.gٺ ,1lٓcahPOĘ!I#ٲ7eo?/ !ߟ*Qi37ldsG[8{=ȹt|1 ^0/ÎQqR239t$+'Ξ%\J;?TAhҦQC"+if+ےKWV >E뙮Z{(:oC{ NicK_cر}謨*þpG3l@O'N?r_.lصIHG-Z9n'hR/彯%3'j+2׽Z޸KG!^Gok@T`vɹvA/jˡs_[i 7r_] +ЍNrv&e@n9~sY @p3c2i{xLF;<+\ yyd܋7pA/aIaIj!'Պ-ϊ%׊%JFſ_Y2!l޽-{0 4w޼u;vY!MOe]n@Rp(g3I " HLEUq jەG2$e D]}u1D C7 T ED >v}}qo-d31P ?Laӣg;ߌg {[|`oxI,sKtn̳mʂE|K֮c֭LLΎ<&)%,$ij-"4 Se 3]*T(d@zf,dmKx)&ae IDATүdEwv8Z,/JʕDTT7')l.oxUlU*X7YIHS/73𨃓ٗk8n]e@lRd*Q.*V JZ_&ծa/Uq_55souTR32emxlnmז.b)DGLF#yV+*Zw脫N/.dJGرb]oycJp5$_$LTF*u#(-t,&DՕ!Op3cu8Hl0.rK +(%{o|N͛0|4OJ]%5w2k2|@֮ mѺ%Bbj7eYy cq߳Ic z i*s]*þ݇y yBא} d GޝK߼9-38uF'ˬݱV/h/a ,^ڹVΞKc ~/oƘg th^OrZ0 𹧨['C?^K)^G@POyv8 y*z\h4'MP; d*W51ؗ#VT4wJnLIϺ|INJlw֭'jnmDž#Ni{B>"%8oQ#Hdub6Ű CC8Ρ'iT1 ݑ%;ci~p=xka?l9pTع6% jtr @:1 ܴ yLz} Wfîd2lD]&--Mk6s)mٹy\7mB$m;ԍ>?Q?OMIֺ5\}QVnW >&SXrw5 2|×W[ٕз#VYz@gsqijG'~jt*Ӓp^YSɻ3^,H|G&L2J|LS!w\QȰ *kmlgVT.q۱;;g+/3╗yԑ͛y|ytTւ_+#B|58EJ??@ mQo &$Li,lv;Yyr Xtӧ[r"YLdO{S*Ua|;m6Z6㗿УuKH$RDE*GF;(@JFvk#"$IQ)"lN%'Ӓ>'-3\ųTBڋvժԩV}ǎYhՂ_,{tg 315 MU>gLlvJАBddr2)9ʑgecR1µdTM,۽3^yiY.AY* 9yy@ Ÿ{`iW5KYs 6ؼ֬LEr\^^oS]Ozz%i2iX+{RbEӄ֍rn\^F,K|XFfb|%F511db=7S~Pbt#wθi3xxILIa9HD.=T:ud Gt:y #'LZf&s|@LHrsH&Y/ATm,ydaA]JUAaVRSIׅ ӣuxH0C+<c[$Rz}׈)ދ_wĺD9rU7qh<4ynԦqU+FSb}Dh(:u,t,K۵ vܢ%߰V-֪u&oɃd{{m`[XH0%)O򾎚Q]煗84$.'9Oc"lbF{I]:2|ҏ8NR3E|6G'_*o*s ?̘y2s:NJ yke^{q^Z Tv4 dؠޕK1tx7mŒQ-{k 9S݇`>yH0y$b&ϜvQp*O#}_|̧nqHʔcީo"!SeY'o5RO&|t65RG<6BMF#c}7Ih0ЬnBW\0ovm5$eI; ϏFkyLWq'_77QT\N%EU1te:YF$$L@pq44TMCUUSU:|F;Lr 7[@$zwH~Olص6 . ='/%0׊U%Bf})S,r۹n#C]v|S { ϷX7Z΃^1/^~I['{Uvn.5nHD,F̵0MQ置MM'ӦܲmdbE+%mzڇvAnֳ&E!Ѣѻrdy*N ?ͩwACiFtcZ!rN 4hvM(CqP4MJe Y:ze3\dΓA;:_W 6lf[ؼwV 4(`R3{(m5 +7OP`}\=׷eO McȒD u??/Z]je@‘c7MpZUp< &9-=ҮqCs]*.6AyG<5F{*.@ [ át8p8(vDu8Mu" eNeݨf@*Ԥh)E(4~vH.'ΰ*7P3,9އ MUG'XHLᓧxȲwB>oР :lN|\ucc9zZ}݃j4Ii>y&~[۵70uB~c_m5bͶi:uMkgGZ$ITs ~,na! S^ e72᫓2>s6:%jtd8cQ9bW(Q4HdyQ?dF@t#D:YF'1{X@ +YHc' ֭Ų XFvk'&Ι54ؕvנxGWp2ۣ cnYi VZqܾIc*qYML2|!&]ӧעA$I:uk|fr-LF#M)zwȄsYv=M ƼWx?أ;c~c'зGWVl܂UzԬ6oiҐJHLbO._ (z]@pIUt N'Np9(NH i$:3{NSiu4t+jPqGj*٣z=kSG@x`_8(ӵ:gw«Xbňuu/v{>m7l21z<3 tiՒ=SJB dY"$04))ddeel֦S,$څ5۶t:4kʶ}DҶq#f-ueHNMg]uNWcg`=Ҵu!ۋue76CM9)a\5)qGE=!FlIMFvr"@p!B@ kLH` !$Zsڕ||9w8_"&"w~ A|F##|@;0_3qYϨ_\*Ԩ!/xl_1}BwE,3}qKb_?6>ZJ' wODD0偼wL?s/Of|179FӪ?Wx,\}宎@ %'=S#=݁Cp:ܜyi(;]Aq:P*ÁdEi C.OvDFihhhZK$t(^!(MBLg$?PoW€R-* ^/;fMltEU{2lxKX5y/e5:x_o Ӱ<рCsJT rQ')H;;cX~ZBQU,c\Hq6ׯk>wlEd 7I|T(gYb~ױ gSNfa+j\̰&o|KtI @ ձGN%=+PUmc&vmP z=_CKD*QZ &'kƲ|v>jV*_Jz,k.5ѧ[gzuhDZ3gI$"4j+bvmԴ K?՗x?Hhp uU,ͧAl,+ÇɳڨUG@pm4l'NE(Ȟ.j_DFtER]44 BU=6 {@J|aP4TUCUTQFZP> D~m'1 A@'A} l2]tAl;rt!6r:v+db"C>U[^ QaԢ9+)D#Ҳ%׬e/pON!xerXqX5">t+lyKwȁQ1jXx lNShsj fECS.( B @ ܔFV/~[\92ʑmˠѤKa6ll4zULuZE%*!ivSSt~,88 L_*8TId (K$TLZԯ@Di^8Z6ly-<~W/zz!TG tjp0[X@Hg P/s@\'lLSxXd{'L#u@p B@ @ :@4NUASU4UbDUBf@% t=;(àGͯ7O-zv(A BUCQ5$UEQ.4ڌ{mjH.(KXᑺ'AV,=G6oڄU[1q|fzw =6/=0{fM lSѝ=F'8̥6a"~>>mcwkkpwN#F?o(fbYȲˏ (>T)(6EA/APF,8lXWE}KǑSV~~(v8@XOt@Pֈ(@ @ S pZm(hht=Q ) Sf+b8AͽpA@䠆Ӌ*r>RNNL_ ;J w, Cz.:\pCc҉=PMӺuI{Yvz_|ήINKI:T׆xl}}O9ȱ3gQU+S@fUXhOp(fuj[l_/o:0u #'7ՉxNJpz"8[N! IDAT8.bY$ 0X3NSWFRlZ Fnajsg\Bӈ Pt؉ikKwJ|8UXmSw|!p*8T3@ J,I^è{ @ CRw**SA@P*+j ڃ"Jx! sg{lݑ:V̜\"BC.OrZ͗%4jHJl;plv;jK/߲AdYa룾b?p* :w_(_yCM>Gˈ`4б-l`؝ⲙ^bsNɤgI$,86#t,<}9Ʃ<~24v`Hj(芑cĥ½p(!<ɮ+<*)[CLT$[*t|F>C?뮃 pW6ȩӬ߱>qT`7_Qû2ɩi<3q2sT|8jc `pĨ+6n)Yj6,鋗xo7܌ȱDI?Ĕ6roM޽O`Z[ϗ#ag-4w_{i,0L-&/y.14v%_8ۏBqfjGrfVy䂓-j  VJζvx;R4n%Ɠ.  R|r Wn2"Iu0{MA9(h30_8{)\$4/6ݏ=~#`GpW#IԑOe;SX r'%f󬙼kxl)~5!ƥ ΅0g7f͋}{Qt̙64WXP {#0ZABN=j$s1]'|ŝLqϿT+QrxIb}v@طSKЍ{GjgdfMώګ'qqY6s9Z`ӷ_㌏QT~e^nFK`4pT}>q;M~s+{cbd2V"1%za|~%L&YBbok˒\|f-$1k4`C?lHh]RʏAXV:^lөVzq9 #C!lcL2HnZ)NAǏIdSTX(A[W918ڛ5]{첡rM>v1_ Z{6<>Tj6ه6+끷OLMeۡb۩->x\S+v*m;JKp=vrWy7dV]5VW]]*[dPK0a^.92Vooퟭ8fmÞWob/i`}xlޞ1ϝ ?;qut,j$1:  [ks`k;ҍ.K.1ikJQ'  <"d2vYYq75LOg2QA$G|ʞ8e,  |&ҳm 5p>+{œMF hʙs`.5*$ .r5AF:(򜲢Gd88q ٥@Kj.OWÃmdX:thOrjvIXx8kIHNaӞ|[N@;Qa4XǟkxSb۹Yop!|FllrٷPԌ ~gk?XfNB.gڈyoowmB8~. {8{*V-aڜ\;B!v>™K8K== h_N̨r [پQw7yYxQ~ʥ =RAXA8pPAxX)UTuqGNrb/|}wK  TTK_+g/_K>r,/\ν{8DLbNKB΋Ȁol"nF&fWp/1ڪp\pE6;P62~mKe;^%6BiΊUΏw٫׊m&VT-;WRF߷%95 gG??4ϏqII:uknμmc fl^dn`2I]3.\Dݚ>,x*aEDމw쳗μl aCٲd!?>N.KđǎK\*͢Lel`bawAAx\e2\KKNr"ή(#E`FԩVRݎ)̞8gt P.^d?<|˖7'pn̄ N$}I` J@/Ðe7wRn=5]~khpyEގX;Gbc^R328u8-#ˈMLd{]Z$613.Vh۴Ic89]dt?wGGB_-5ތEK>v4ս*s-^`荆.{߿oFOOzk[m q>z?%BAA tp"6-$]EQХ#t,rNG+  <T :$S Ʋ=vf.]ƌŗt1/8_v}PZ*P]`4ѡyCzȷ޽H ]=}9.O7RץM'cǠP(X;6#QFn)WܡyVj^nv4~}΅M&~9׮`4r%*ѡy69ʐYp#G%RO)u@x=*7/>!'Z/K.|AA(o)I(dr*9:Wtw$Mn*Q%AyMM-r¢WúMl %>)7''wī{[?䅋؏4m"CIpkXq-<Ց{uK|g4T*o1w-m:6`°Ayut_y|NL&cܐgڳ+2 %=E|$i yu & nWq<<#'Ce gjhۤG Xx~a%5k0xs7i4|1i,- )%d߉Ӥi2UwP[;'0kh]{e؞)Ç"HLIu7txz?Yj"UAJZ:/ ޝLu KV{qilWc}Hݰ䯫dBP(]GG|z*)25+`ǭcׇ~LWGG^87%6С,9 !$g%vԔ,T*5JREm;^AmGkݓdٱ\|1im{!(#'b"V#PI- Z{)PUG6+Aojex}@m^Փ/]D M5;2U$R}MբT(PJVd,I ۟ZBkLm6֥ $tM&vO\RMzTTS}9_' drtVRmJwb_akmM%77dYޜ@Q1DFGŊ_}7nt@#ZhBFJu7W''fno̗hܵ:]q!q "15g&MahV?zBƀ~jSs#ȅMd jD,f[|j[B9۽܎  |s}OQUA=W4R[ Dsv|KfV>Wl[Ы 61@|rVWCQJJ&}~BWpRp0N4yAPARTrp&:%*(S+<;r6/Iѓm>nNN(H6/#_ 0vbϿqm݊v*Fv6Ե:~O@Ff&Oܲyw=٫ذS#'r\8g._/ ŽGy991g/,7GϝysthaV^?"*#1c)Ж'15Lf0sQTh'{{;oOJz:/^6VjF 4  L¬ cyoBQPG?n"D'rr?֊Ms-~4r.-݃.ZksMֱ|aNu//"zM}sߢ9nsԫcr9`xTO+V!+{ޱps3,YDKNg:YJԯCh9SXϗ   mVSg}^>?kUtRh|vVJ632U K# 6l*9:1#йs溔ˠ %2BZfL |e@  W;n&ơea%ܞd-Iil9bY.AJgiSޤí]:s@@g lڰq8-y/\MJγ1˽ry9'Y85%8#3[wPlR{h  78yG`^Ӌ.ZVK~7of.Vn CjF.fkx__w^^N]wmh Ý8FΘܕZgХ󔄭B]&!ދ`. eD- P&2.v$iE@ojb&Exe|ȵ[Q\qG_D̒ps*˧tRRZR( z.SBV#,^UO=cH%B( O$f[al[sB IDATiݨ! Ԣ%#<5܉HnBbEw򍛼[}uм^]jWVj1ZQέ\$RO" PfmIda?pu.DDRz?Rb;PRAAܼVNj͛QյT,laS?s3OewwN]LL|rБѴ1>G⒒oTruaC,m;&5# _`ָQTQG" £Nղq;^]sWn[ a2I]B+APA2#p!M)'X#<۵3+͠OϠ ߥ+7oa we?|);w0zkScm҈mZ#(_j]gzS}8tdpߦ^M^FrZ:o8AvMq%]feQZUygrvzCgU1AAAAxPA2eomCTR&{G䥘?NxMeבc'&S_x>Y4d·Fu2/7zmg=<߫;)(U :hg}/O֮Uh\ dlk 5=2ޞڝ{{$)thAm`0Sò+ڶ̝Qf zmVjzmڪ%v6>JV|nɡ3ak4oք;ԬeAMQoQ~~իѫm M}<1ho3eQÃG?UJnh~Nll }AAAAIb2/K.|AA(qʺRn4LuDmԫW_V-E ޾+WU(y WB/ 6lbPoC=Av7kwcKI!#+ 7<hR'ۜ Ʉd I% )ܽy2@)Qd 2qǐ ̚s++FR@xӍt]VqoDטѭ=| -TIHN`SQz %VjU==_6֖@wّj^^VjYρar..TղsGԪ+tZ'_$.9g'5mLjUcO.2!iӨ>>-=AlrvZi~t:_d_W#?D-M5OO6Fo06xO o7nb> B N_}8{-sW#putg`"Yt ZUZ7_zT쬭ױ>2Zj,s(\˓ƍ,;5ΆcGѣ97iˢɉKߒQԞOƌ@T#?\`ul } Kn`4iӽM+3 Bc'Y>mJ F|ma=2C1q ܼŇ9YBN䯾AiV+}zPן9~N\=[B}_~x{8vמm 8앿PjK@ } k*U@Bo00y22x{xX50mw 9W޺lg{<ǰaA6>G" l4Tz>51|W fC`keZw{#ĈCP0~s5k >"&>\]g_zZ[15k,lP?;I2ױ,vs<ҀΘ#|f2ZRҵgTx:Ϧře?mƼ`#?P8>LYtmwhc48~*ǯ]~o&KjJulрh@FV %6 Vb2YAB2Fx2 Q}'Oʢ/g.]a{ȑ<=4L9pkיb4j3Ww]t/'`2r>"u.xMxStoӚ^^dd0@*Yҏfd̛2 qJo}Gr0gr:rwcs=.k?W;C-$g{M}^l=xY?t6VƧcG7L%I& HVVZ^dB.RB\.aCߏߤS>s`9m0Ͼ5RNQe lsUy)΅(_mѰdF^M|s(ΝL"CflovSSC +|^ЏJnn>}ffǃ3YYnYVJU.݉B$llx6-+swx:9Hp5o }g@@"%,T)ؔ “jF^,;~, eR|)>6hxi2ۗPv>g1yv㣑wurdp. ґ/$K#<m4k^esc՜p9qwb@ș0\sݟ_!&!lM9Fhj5[Vڕ/&%5=yvqgH xJ~-"ռhհ>>J6VVTvwcH :>hےHvy u8BZ9+}5Z6gyn-3uui,_\֨Np%Zvxna~tz=,x{*͚0uR34l 9=r{*U=?gҼoXw? / ֪%?7G̙͘0a, \{S]e*ߜH9sbe_rkva-tmٜ', ׬h2qM>Ni^[kk>#$6W>èHJKJ&K?b~AB$IKK#!!3gիWd2RϏSN\]]qttDR!/ыB~սX;w6=N$15LڹE8P.̚ɠE7龛OJf%>[ 쑂2 dc E?e`SjF%Ʊ24i2[׽{ |~YY |1H&RZ2 rTVbD B.kXbGT$lp-Au;F_wƴnKZuJ/et;q kk5mD:}.ҲAB3r SQhWUDo0r7\ [J6+Mgp.tiќm .ui4I}O[X[&~g\eg_пS7m xzZ&Y48r<YZ5]Rftvp`a(^^LmCv0Z 3W;tdd+x;ϤiXp Cxt1!Ivi؈ϿJ^..<Ӧ r7wg?ղl/tL __>X3nJuw- Heb%W⨲BQ'Qwnn6Vּ1(ٮg8n }{Wtu92B,;0w"Yf-Yz]U %5V!iS:vaa_{Axvuxڿ7v4Z:6oJ"( Ne#” a}He{¯]cAknFǰ|?tn›sh4r bprchnFپY& ?ױI;J Y& DR057kZMf=~B8 f%ϲ >W2s٦@HeS_yrJJR\!swe}R}\eGܝHNK0U<-KN4|oXc !\$ɄUf4H`$<=|m^ز쑯M|P Q[[KH|ZbaU*Ǖ۷M*߶9JrZ:x3S:4mBPF=yӮĂ O{[[L}k%IBpU̙_kroŲeXz5Çgܸq`gg'FnmZ|e[oshݨavڅ`SNTRLW*Uмysˮ]D@4-C8]١fEu/[zK 6ŔSN_ #jX3_O0}:n4Gq#|J" CargW0 yȸXz4ܕPǗJMN&L_*_*S@fֳ|Xg[LⳌ8.Dz6,k<>vq~,>5p?,+ m{ieI+h {[[~e bYvI'u e{naչ}7 =ƴy oeʜo,:90oDlmkvfGNӶIc8c4WoMZs@5m>v=Or|6OƼ\GVJ:!x;'8x*=NrVKC_Ӈ[wcW £Ng4"!a%r- >~z=`ڍ,]Ѳ.6)S.Ӽ~NΨAPݍV b]Hg:Ѽ~=*~5jPV7m_^[CBYiK'+>oxWw^՝8Ξe{B#~F_'pEZ7,ka^ݓz,1#h70uw6̳}PM}~o֘/ '{ԪgWvgytB< ې}^'R{AXy8Omw /\ }]`[2'D.\2&r1J~>|w֫QxIoHjv_k:ߍ 2G;;^7L$''b >C2C&/7QX¿?EHF.]_믿駟U$,'Nܷ7׬-~F>;e '[c:tkӊu|aX gh%͋#.٘s WLHVhUG #$0:^Y e_^7oUtW=go$1=.3>$I ;"r!ۗ[рAEe]kOƝ;oXm7f \)֮áXswB_lVș0._,b%/+N^'ډ[Lg#&Ibv޴U]zvgId%tۖ?d⠎L}!a-nb3vprßVtWc rwFù7hSNOǃ\-䌭Z]MFuml^¿vMv뷣8}M떼VNGTl,.k>$V<%b0qwqstnݲm4Z-wpwv7O_abd>P? R\8QT,<[:p<$IbYc';{Nnq.,#d>ܹ߆ SEw`,T݃QR۷G4bPr (۞e[`+>eG=^,> }̚Æܭ zΐ+[/Oh٠.;vFS3sAGׇ: B #hSa|l%ש͝84تܳ-$O1FϚGhībo>¥ț6nd ҡYVгx$G%I{ >*>}gYzuyWPnW~XZbДG!Iիҹy<_/sbP)Rw6nOޛļ=ܘ8dpe/f]Lð_HM| /WWLKw7nƓDPP+{ΐ]>6)7nyȠR$]/ɼy]˚8~陙( z S@3xxǤ y>\yK A*BVI$Z-߶z=[{Bz$B'ޔ^D@l bG(XAE@{ ^7[c7K6T}] ;3̙l&yKd:]ua.AN_3S$+"|fϞ͚5kС֒H?a͛wQkkn=v킝 E%%?Oj8bBW-HDδ8ʘ,h##XGT7@+T8pUl]"GL쬤O1f@_I {1zV~toy'"9'/ ͼy 9x893d}{tN ,󣩇'R8#"(֪sv] rriTFԑS^_ΔPk4l9pи췍fԜ@x\OΝwgU|˯ڼ2_V-3c:;w4;FQk,xY^ND^‚2wSxV 0gO͘0FŅix2oϜݺ 4eײo8{9 V IV͚qL6Z&Zfoif bA]H0L|gWi,njNǖy桉&A`Ұ!@rzF}$$u:+V/TxsNVRA7~ϿTm* Jh8h|zok[0r9iY\޸ ?#ڄqr-Ru613} Ðn]X|fO1nM~Ou-K x!` LV`Ϭ'2zGѲYzwhg[(rsrC <}4D މ'F g嶝l>t bҭzPnAgN5J ;kkVΛs,&.)[) 6͚T޻o$%s#) u~b CwֵnXM iS䗵<2oq<.Z+7ot( ?.l!~ɛo*v'̶;1Ҳ9r"G.\ ~z,,ݷgl9r-Gބ^A %t kݨZTy ֳٌ:CpJ-ϑRǭ[xꫯ Bi;+һcF }:vۏGFPУ]Fgg :` "ɚ~2Ś;TE8\Jp'n/c)YP,gs?A>>JN>z w9%*y%ݾaaq'ZRQ о=BO*E'&{6ٶB$癬P?L)WsMݼkWYw . oт,Bk ]Hx9HJKg}ƭ2 fZ yb7/a#&m"F,yu& S;Le웖/l0d!{/GE/ $0WRaئJoV+,"Wn0O9s9%o~\j{->Sυk1x=^b 58oǡè NJs?ؼoB _~*#/3UGoM}!*=NcVM{z! z`&̐/ҋ UlmZNvx{1f@_N}6ڴbwKP ޘEna "ǎa}M}٧SRޞOmq{dg,V;Y'QJM!&.xzu he_şsٴCPyo1vi_r 1["WeX]_hӢ$#H]N!#CToe !S >/%ն98AvAz-€f˺XbJ8{QyYkF3GC#Sla?މoL#3 )tղ~V܉2ct:DQKݹY̋1y>tjՒ[~;l^36.]lvw%#'ZR_L;v1v@7-Z(* = _d1oiռltwޞ‹1HL_-{Λ,Tώ7!YRq9<}_RPNxh?J_3*𪒑X[튺uaeiqll1V7tWho:fMs\J~7Z_`ʼpv|c&E~99toߎ&Su.\!ȸn'WˆqU?A?}zF`yÏu.>Y#_l,*?O/^l1jZ-)պTT*G^`MuNtjղ=HH{p1 ZD`޾:%oU*+{mxԑjo`iaA˦A %$$1jvF26oLFl@l[85d[13`qhP6./~4ֺkpebbbu#޷q%7k>qיb9kQ;F`Zqચ-H2c쎪@mrurj҄!<9n ߿##XmCy/5rEϰ޽ѱC#?Sk]O dXBFԥclNyc܀9ħިr:Nxcg}kgAFCnn. ٶmW&?t6noFddd AEZrôφ?=yo bj:0w/amոϔeݟt5Y@(Vww; `#E4qQ|["P} Dk:]OcO9r>蛷{z||:̙+:B:|bc)|WxRHZGw"2 J;ϝኡ>SeRRmKJY&")+ ٵ 0ME/|l!Vɑ7ޜh#3feq\׸ݻU_ף{OߎGTN榶.tj݊\3ڻS'!.š7ΘE1v=-};1[WvfRr}CB?0٧J=7i\c>~L*ی^ϕծSCxl(fN"w BJ2GnRZ*ߟ9Ψ0aT`Tz@ÐgiLֳ(sq'c/|@>9רtE2(gΜ!//wwwrM֭z0'.\46Nrnmprt4 _X`ڈOٙ˛~kp'O ʍn) q9wA1cӧO'??ئGر+WoRV)ȿ]vlݺ|,:Qeˍ99,x:o}4ǛKDƴ'purɋxr [N(7uBw2 -sV# {pQ KR@ZgFW$u"Ҵl^oo ;spqtµ.SRXmM>i,eIHRw)0txp0.DB\jbb8S Xm]Bj=R7o y~@yEKv&BPp,#>>x("RQ᤬_TAv^Μ5.d̸jyZB/3Q+t\*mVÅ9ld:B.!xKX[Y[)۴:FnA~+}˱+WBؼoagZV a̠t5|)/!?aY:O\QIKK0?֘Y']U_D*NFmf%9*fڅwII`okÅXd2[kk"_)دsjcp#1o/ThJJ&O7W|=W7#'Ĵt2knkmMqi)4JJ7'gšP( D0ǫIF!N\B"E%%hzɓT B?qŋ\xSݮS lLFqOT*}hbavmy{ƓKAPr;]0+lMJSVSKdrHg.еߡe(̜ΣǍnr.]fkޮ =;|~5GGҪYS9/~Ygls#1 `cFъϧm|8 %o?q1&VK7LpډJH]J5Ѳ%.DOroSS}2HIʆgچAl} DEڦbRUɵX~rࠉmk1\V0Q>y- ʺbSƺ[AQTkce^-Y݈ܸ'O8E!]bTkM2]֧w qlkw"I=ªl9OM{vS%$K8[a<7tNy{.~M-!!!!!!!!!!DEnT\V[d9 ̐x8$[RlPbZIf~~{yƥXzvhk4ݝHHM#++1 v+LJR`ә1] ILK3֮->$&yzK_Vami3ȮcǍfS_ ً?}LӘ+<Ĝӌ[Oѽ][4ZQjӢ9+ߟ;1pgޢ IDAT[6ƹ_I)4:w_3/2۷o/~)+VdffҤ}欏;&mFDiҳspqppF\&㫵nёh,}#LzW̃CjSSqqԋH_]GBj*6eѨ}j{``fOa0GIb7fNrU Jxh˱HZCN~>=;]p ؁W7j ~7nqt1EE6*bcP*9u2^nnp9^S|9%Lzuҳshլ)2Ahf+'sEB * ?'"Pq1'>*59[Z-(nܳ6)(*3 !"zMLUΐklVOI;[:Ngbݠc Rɰ>֧7zMJv6O77c?;>{m__EhOHM%j4ZKHˌ.jNi s15"@BBBBBBBBBB⿃V%7 ^ $G':htj .ځ-۸p-.aa\q1΁3gIRl,=;G4\y+BL|<.^bw?СILKcCbÜx~G c|&-xX[Zym[Aގ;yr|"65\k0&VFD5!CvQ7Ǐc'|=?_)ɡ6n g.Gqz3,ؚf/muhfȠ!Eԩʕ+jHbb*f\{\&c˖&`!\t:fRLy/]oLLyzuh\.gͶ4aJN_$gdfKK<|(CCX r9}:wsi3^nn\5tZ} @:XM$,UX[tu6J)QL,M+z ңp>c,y-!4g&NvOz0Woӓ+G!3ɏ+ֶ\ftoז.2D\FpM,-ާ+ C爸zM%v$.LAS%K&1e [>;?(J>aaz(B$G2t:DFkcX[_#Nj%@$(Ng|`sƃKY> 2*7&Ȅj42+y"FCf~cߦkm4Y50ձ~r$M$=uTCÇ߯Z;N?6/ ]LItD;͌NR9 \V>;tq逃žvyo^8N%KѪcbuUy9BC[ECvLj֣ɴgxX(t:"bnVr2^nnFʊ&Oڭ[xy1w/f@T唪T?3F닕%wcl>p@T(c"xrXz>:V\ߥ[6Gfn(lo߾񽣣#FZV r ^%$([[v?ns^gAl>p 1^16xpT*->wI ֕~v!$gf&؁;\0qשd ߙR9DLݗT,M+DBzTts&j4GGp):\!m>\#SRW;i3sQj۵]H0j2U9]ۄqlOt%k~ܕ9WͿ7HG-[1CDFy֮ iMC}9{LCmܟWRy}x,j-H/,GZn2 K(*+;ɍ2T`_OscT=?7y|癧 6w-~߽='NR\ZjŘX&*<4R>^yM7dO73bbxm> [[Zq1F9wm]]ݩ6VN`mƶCC Rl,:iof"7R>Cx+S9{BdϙdPV5z==&!q!<֯!XI{ŷ@/!!!!!!!!!!!AtTO]P^b K͇1_>B*i jUV  U:v@TpZ 1CCD"FUQЌPVQMP`ogKAq1 V̜ nc׸K{Mb%@pp338i/S\qx si6tk𶱲Wl{B TVSWhccSkЦA8rr%$&e~x!:Ԭ,~۳Mѷ> i{f*xgS?}}N U]ƬASFƆ^*<ڨ1 KE&96e4/Me2ZN法| _VTwur2pu1ʵFe/,d v6NtmӆoުŐh Ҍ]J=XG?_rz,{2 4Z-+mպ5?+?L <;|m̎#" IRj q(Պdn(:"yѳ*QJWz{߷ Uѯ}iY7͍x71o>79mۘ /KY82I#T弹x)~LdW2S7ڋbcɧh:x(ß~(:ܷ [4.^8H럞ZJHHԎ 3ڊD |-T LF@@qV!:5dg-/2-`2(3҅}~o®)ZQWӡO`kk[M4k6$,JZ7k#^^ͥ_nG)-S1Ǖhu:^~Q0~ ]~Ŵqcp'mYg368NǼ0/ =;ǘ=TAy렫$Tdr}ڿf_D:nќ(tfuZ ͠yH̪Lqyx&>ZXh. v#XNA%{#jͱH #:ZrZ9b1*{VUIxĆw2\VWwא}3)ɸڭ >pmuJoq` @xQ= KPSJǜիQcӾܕJO~uGP*y}xo##nŃND@Ġy`gwqwg&Emϵ}h>ZZۯ kѼc8t9~ޣ~m%i/!!Q?:1ӝݷ˥݁Z>hZԚ-5z=w/MBBBBB^E<<> gGjmYYޜ>7O3Mp Q㈌&%#Z! lLvm9jGDr1&¢b<\ڮ m< ֠B`OU^IG 3Rj*g'n:S:2}cRmyǟeB ۶ð`sͿcgc' OzS&c;;:Qh꣏TaV6n0g7f?6Ԭ,ZΓW%B[C{fǟںsߴj5Rq&*o|-ZTILKw"˓tͯD@EByiw; ;M}#!zՎ?iv|$g2uBj&?F1wHIYrז~mёA g `Yykv&1=K i[SEz7RUpFW71#>C_|~q3|Ï;{A]™TNE]/L;'|DlBz^ 1FѠs/%%<2oyy<;~72݋ ӲeKN>*V^dM7o߾=*%-C>4ĸCh(vn@Xaݙҟע*/g,KPha"s ~Czt;uكt Z5kF\qL`n;t.`,|y2&~}iju늯iYvS9|<4ON :o =] vŅo/*9k.y*ULհ2Qy0eHF\ąڲ)cF5 (}ڰ^ٍ$K)g MLqd"nS%ty| ._jdKfО{'xb$\ԇ{`5BɏbkmMM$$.$.L$ 0{Np$*D$BIfA N-m׉"Rt#kyhZ&&o2x)|EQe\ N!uVA t$TM^T: /yUxdԈF  $80o?kѼ^Q*N. !q/#L^޶SiM{/:KH%$q&*V>Ը J%.Τep+9ӗ8q2?͟LH"+/g{,J'$}+='ы3շ7e*5g'?wJT$eRl[c 1)tu1/-+cHʦw>$ۋb3P*xP>xRdutu_Z \AL|~o.jEtuAEbz6;dѬӯEE$g`oxhh)7QH"%3 g쭭cJEBwwq\G5mZk_~<(Us|$Q7nmxDŽ9sƆ/gn$0{$22)(.6+ !-l\R"!Mv1#2PM1:{2OWWt"bbYw FE%ue*q䄧[HHHH #Æ i}=mԲn'*?wZϦ.Ś rYS`9l0jCj҄L:wlRԡA6zbc|G<\]xtpoK).-%LJ>LJye#^}iǶCv0VLtiӦZMݺbeiInAGΝ7ܺ|GKϛj҄`>ZnN|9 IuӱUKr9έۋXYּQq7tl\ Kh(r]IHMcW=]9p,:u ;]f;ح ~K<ׁ' b]U;۞G%:Ėag%[[ϖ|ޝ䈓ڃ5+^w Z[Z3gGZv6nNN2{7c Nƾcß{K8;80wQ~ذ,*}`âOpi4|è~(rn%`a̤y`@jph@xP[xRrrH$2mpst$k7BU'{$U)2\NNr*ZBFP?0 k 'X_P!OUZE)!GĽ= 六 &ɯʺ{[(*)!+/LU .H?'WĊMsT $ ~փGxo9M\Bw^zx ًHE˨Mv 2A 5+ޘGZv; 40cG1}(Ҳs>[ﻷ_ebliYX[@2wHU^nÖ?6s zcT(&n遥]Z%U(\.c֬c`ۮ^!08y)bL>Վcɯʼn_]<}.EP9o-fbvf>0r|}.od٦-̛>[3;|_k-<9js}  iJ6Munʱ2ssؓ,{mUw糞7ۦ.&[TZ7 ]\4Ԫh>g$6661KC\צ־#u| C=3gۚ8= yk :SoFXX5 ۯwjՒC̵?~{Ҳ2څ`me?kf9s9 +KKqqt'1-;Bqr`i̩ʊەлY9ٱ8qJmT_'ㅜEqi)ڵ5)Sz8Dc>Kw+|ܛ`ceŜ/wGܿk8ΎiZ1]._ABj[⹇&MDIY,Y eX*I4qv6CP<E<<:92wOޘ6RܸyW -EgDABHb/c|/{Cu0 cThEٖ6#g IDAT8.yͧKo>RHɯH-whB ueP-%Lj:v6mÝOgB#Z=llөc0LOH` !`Jc7kH]By#xb>]QXVFjA>IL :7 GaDaiЉ)`*l \H,g Iϯ61UB9RtHN Bk!!!!o tĚH}tjZa!sґc)/H 5JJ(V`W{O`s,1d٩>z/CEM ll׹3G".nv?CV-APUQ2JJ8q]Qn1n2^\OH$37=Nd>xv>MhCYy9^CP*AZ gHzN. Yv66t kKQdV'/EQ*|l]j&nDrFw4Z-JǍ‚=EfN.[3D\`D9tjNG]eH. :-eþCƐ˥5j_& c.$!!!!qwP\ZZVՑx{{3rHVZޖͩJ{ؚ&tqi;yM?Bضk> _aSPЁL %/`9]\HF|59RtdK ԉ"QBh䈄ĿbZ*R>o&Xg_ [ɩ'ㅏ{zuh˯YZsN[/r U$Sy-Vݒ&څ4}H .\B NmUNf7[XM}HRF{O%g1~7)Yhuzˤ;& MbZrzN.7Ubf%:QбR͠l;z &yp>n&3hDEm}-#w24k *3W>_G{;3ڬ6/O KKy$~)$gw^N=N 7ԈS RҼEs[3B}I+dkZmR- wzIϞ=qtt1{P⯑@rF&!Օ|6RY6Quv*|*l#CYgq^Qʋ_QP#↊rވbMV{)9Z>#"V!A#B5wѝ-u~ ɑ+IbQlĀ.]ɻݒ»u#34 澮]pGYlu9(JP"S_N@&>BCT T<(FUT r>B1}֝G nVKvQ15D;[X!3_@X[VQӡaxXkXf\vh쩏3e$+8 G2 C&LoF|jvc}5 9+,b&d /ɺ &zE{\Ç~ sh X\=Ll erjg58v_|v֦ߒ(!!!!#6>FEΞ=_!u{GtbšI U>SLJW_}QĀ]ذk  `âOJFߵ[^)MB 6>s6nq!`٫>&Ee Q'\~"VK /2 >iJYiA62L[P ӋƼ[+)I 4"{7V,˴i=2AŅTcV}SO$Ң FKn|VJf B.Fw|elf{%{opST<^Sy^DN $@HHޓ-c%Ky3<3~5y'FF*jShJI }+}Yc&KoIj9ҴYOҶk?}=뜟-BMEFSqscϚh5eI.wbQéȩxpZ5f$N$B_mҞuݿh>sƍZ-(^[O%&9 Փ,_FK}S5AKa2Iekhϥ:_ |jNE'y^ܜZ< ןR-n.,БNΝZ,# W5:t^FR5= Wƣ5}osvvfŊ :gg?m'~^MWpqt7XK9uꪷ8ݖ`vUo~*6Bx}#N5=9 M9sֹ@@ ZU0ж*9l$j8vdYoWqt Fd2{)%]ΰ6ZKeujc0ߌ,3_?n8Y!(-+m$hgd :VmHDh|n08l> QT898JsI>sfV{t!|־ k0$b}>x/^èJ"bΰ#hu6wdXr+4HLrU{{BZԝ!21gPT,_h*s@qԚ -Ƙ_TrEE ĜWT?w }1/2ב[|CC~^۽UJƱБ]];PTZJbZe(?,~-=MS,J+LžQi@9|vwgD%P\tRhj _OO|==qv HXtDDDPe'L; ]A {sy'Ի8ś21]~ 9&iKpݝ+V0m4<==Q* RZQAة~HjuݛΝ'-;o{ӂq.wSPB?ܿ em,S)d[bt{qLaoaȄxv8l4b4dԩIĺK JJ2.9gJr)8_e+KH*m<@`T"˲i~ m,* y|Dz\nޝĺ3W?O>OUןSpdmM[A<絯WSe.[RVAzN.Yy9RXb m=ο>}"L5:=9~*UH`$QQUt啕:;j,1kܸ \õ0~@K.=O,7n%%zGTJ%- ۋV|e[隣cLV~mň}2p}H%%#) yl{yEEj|=<4bhTaq&b.]'#2R\os /'_\~A?̽l Y`׮s]侓D<tvԿF^ eTa0 e5TǗQ1cI7ݹtP{=/^L@@a-[Wl~~mO&$r|jk;>Zj V=Mc`1p=dTV8e*n]9i4udz*.nrfF[vIAJ^1ZZoG?_?zywY;{)Çu;KIYE{hr&;Ko_7ůʛ,6WnZDxL,i}ib0;o>%"S.1 s)7QÝBF>M9s=e3{iqDVmNsKVzmx<;싌fpmYfms| :kuUJ^{M3au=:m7pˌl:tq,{5KRʿ/Getg\v=FtB"n@nL1>L6 O7W Klscsr9|4U6n؍q:OnQ1'&0{(&BQ3z[y黧3+[Ʈc), džL<[Vax^=.N}UJ}۶QєWVҹ-Բa{ʗvR3p3__?RÝcзk˾OJ99YΎycǘ9ҘnAA;.6wCG]_QAz/:b8jUF#999_.h_~L8=zOTTeeMKƍ㮻o߾ >g՛Z*V\l:p&o~ _o}:ֺ]{x}س!|+ pUAB?7%O.r)([Qzϭ:>InI}I#>vywNuᰊ*=$Ֆ[TXe.p;E/I(*PQHjJBDR!U8JJ%8k5|AXߨ(,䎯D/˦"2ozE)JP@d<4rk~ wj pvk(ft3[Kphpc(h~s\˳cLjpk^}-{9f_˕86?A>ތ4c66z^ed*=[P@4G{{OuMk6WnMlNaA:RJ*QH],tyNv]%5Nӱf|M=z4#Fwww\\\jz?~sQVVNCVA׮]3f }% P*֕6_~l͡?ٹ޺+VЫW/nV9VKdzbŊ~?S xaۦj>;6 `hHUuJy_ G0ȗI挗:EBGY4;xjo?f/8g&2g  ɪ`(9ETUנꊝ Noi!uҭML-dϧBRdm 8ۛF(RaHygI.f0؜lͥw&%0S]AA*F ϨlT*Y`GqvvFѠP(zӷo_/^Luu5  vvvhZppp@Vۇvtz=j2xXʋ(3gΰ{n:wL[IJJ… 9sUqϊWZ-8p",/%/Dh5 pc 7J+=[IBz-yz*H p* Q+XÈ8iE`GqEp;n IMk4t%6eYum-%hphԕՙsy,!tfI [RV*ᡐ(\J:Ѽkm,9!d FYX_ۿ^>jܢ -36hƨA?;^ߡg΍S(lt-JRn;uSVܯFGxS[}ۏ?GZ>n8vݻ8qu &''s&Mj:kjXܿ9t㞅 i?. ubVІ򊊸Z\paүV3 '.=e(Bqv!RxrKeLEz& %H2r4ZZmgn$9hb䖕5 /lL;we &vMaWV_y,&zLb"a'zBӲyv/89/[xSɕooOPF v~Əg׮؛Nqcmjsz_Rɚee\NΦkk yzdV@A󻶱۰W5-  Gai)}X^=mҀv,5:&kc|~z7yPiӘ6Ν={6gϾ3*.+3mvU55|[>; ^BAF",Se!ɦ+mI7P݀sKIZkO>`4ڴo|]J0"N)=ЦAg(l}Ve{X8;2DpLdv*3Y'?ZdYba #]4'IFS";NOsdFZ#(U(F%5 )Q(UHȒl6@nYd*zl^QJ Ǯ}}yK>Ň߯t|iD/ IDAT Ӓ7D,4[edezB^%'Sc.gqb&!Zt GR1۱͘ƢwĩpGޯqg̜O  бU i. רO׭翫Ss.+w-ZT(()UՆ:`sÑY},<.ߧl^s6;]ZvÚ2n@o'+?̼7M%!d P*jHTa2CSY,14Yl.?UR`Kk1Ƞ6N%I6g i*_TdY&2gbMJFFg.4BAv~>gLeDEӿG\,9CLbvv4{&)/RVQF`YWScOx8yx1eH\.`0p8*t5v ۗ]4yuIP0WO^QJl9NFs? CcgRWY]MxILScQH;QP\BSFe|}")$Ibt )ΦQexxXR\VSCPңk?wH{#"(,.!ϏI#[ p!3#'W.xy7q~^t qg4rODt! '&յ>Ǚ$~=3wFK>EqiYY8-,P JJpuex_¢)ӓ Çj#V1$O7Wly.gԠKODljӽ*Gr."L1c<OFv6%ee `uU _/OVkY9x< 3q3r5{VWyE%y, oL~Q1^3/^ zލaYHĞfKm̼tuhv{AAvqxA:CQL~fy2bvjq$9-wf7|VT{ 4c*ڥ/µO~v*ۥyy,i%oe p${8h$)~ض_Gg$o *뻏ןGSZsyTQ@?o77\\tr;wr)CsO)I<0k6:iH˦҈ %KV"2d6\b4t4g:PxO'$ I=\}"N_n( @ q2 9 @TY<\]-µwP\VNJH`끃  .KeUGOSpAo0G䄇+[H|I*:~YYك 6Y3ˌ鍞k~2S :)u~ݵG.:;fs4;a#RZVkDشoQqqJboHb-7yGgGG Kۭ1II `P^ҭs';㑼ܳh{FCJ~03ƍ98WXH^a!]Q*|q'ye`wx)oۄͯKaCHVn_[OrZ:t 8t7yO77dYq4z@ev>Ay @X&F:DLB"g 9ûVM/bشo?~|}m:`=WggdӞ}|1勵z1)) %\2[_CC $]HOh( 9l?twWuqϝ'ZGOfXT> GG~ݵ#'yǐ$j^cף;lܻ n`MkĩSF,|q3'a ܍+q)ҕ*v>cX|&zvBlr CRPR¶y,N o{9 蓦 NH`4YWp6z3gn7 xquq&$(a@cZ[7O/7wP|{hT+@{RQ]x>Aڜ` \  Ee=,{{FGn!"w:ʪjr ILKhR3ڻKYkV~5;3__u '4̼<ϧ~:E4}Cu޽ Ւ tg߻{/0ײ/_/OY ?_Vo MAGV)ͧ^^z2^1Ob=j@^ҳֹG@7z=vdoQKT|OsCK]Y&jjkQ(|vލZ~Fkky$RzUb4b8N}>B-_1jD; ԉ n@e>i]yo˱Sǟ_x'|vCѿ.EPP^Yɿ6|774 ul*͵zh4Kρz7ߒSPw좨7yWW0qش79hvfٮ{ Dm^~ܲÆX&O',ˬ7~پ*rc9ȳ\>WVr17J}Z9,  fHlsIi$w7?Qtbڻ+ T̺W\ćhDұd\y|"(/Wn=/G/eBHT*9(hPziTࠩdB$ٜAh࠵gJ$&c  ك]дѣP*M[_OO[8$I?82?]T\ *i9k8*U踳t *&ͳgMNFP`dzooFD}ս.>>|}>uW.oDFZBzt=۱{1eHfOO ϳMVNR[>:ϖjyVtܩlR֠NgWQ)ؙz ^<;8;92eHLO^{6kpra-Լ IB!I4={[GND9 X-%,*fͰ|ou:~e7g9̺;q0o<[4c%+C_3gwlEn A+*>vղ;δ̙,$I|sq  g'JvJ$5Ko0Me-#V)xEh5v г'_,YagFBQ뀷y$Y/.h1W!m37Ch<mڻ= na_TLyZZEm39qlN6DnB]ΘJYA4vvJ9AAADд(maN=oH螽ׯ {ޞgf\p#NR kL"cPu쮲 "N泟q*>0z J+*a _v";?qCXAZ?lODqt 3VmȮ#ḻ6;d0sF[QU]M^u멪AeDl ipmQ@nA%Hs>#`0̄+חA|q3y&+,M>n/AF#,q~~ٹ KN Փ;wYڦge~n鍣VK/aK`7y:!DNFc`-(*-m01c bN.?oێ`V_~i͖~žpN' 25|zͥLC'PTЯ޺P(:iY͆={1T08&&1G#2|ZҧMQY]10B8'ڕoH~-(~<_AVLI@Evӟ#݂NcGX;"eGX"LLm;nvOxŀZcIil |ylee=,’268p艸~ܾWVH6mcp++Ju3rrxwjcR'0#G9 eYȪ_coQ :ͥwhJ^Θо}=fS=䉻i)Frb&[gGGjjkةyKqh$[Ny|߸-LCKnGcFG\FCeu5SFdQWunb|W,4͚[ylCKnϾޞ[M[ڬCC}\l\ŋo|Co;NZf/=ݼx 'GJ+ ⾛9w_+qrp=zp smk=۽/~1~^0z u` ɢu8h$ϗÆJ 7Ãa<[!]_1 v8O֮g e*Sw#B[:Ë~ɤ9u,7}8_8qy*쨭ՅO,jjkY=cե3_5kڧ'?ِ    t\XMC +G6}Tm˰k=UJH*50ٰF{.RX[VN$>6eB$^ˢ(- 15dn;vEƌ2s !2q)TVWӿGw5'-3 =:aR.a#48^0smBQi))iU*z`VNg`6GU5< ijdZgQ* H҅4JKtu[N~S)ӓA-ꧩ| KJ #ׇ S r I͸ޞ>!_i49Lmm-{jvξ2ssIёn:kzp}SKNAo0гk\,mk1ÆXJ 98xydR*uh4zr= g:VEݰCr-Kphp}e٪ңmh 7kcqm o~C񍗑̙*y_ ۛwV_7%wzF3|șs,4<`ߔ.6ZK< ~xֿqڳg)O(,)aߟ8Ggd4_Q*l•6ݰ2=^oFm^CMlNaA:RJ*QH]|ۻ;V<'Nk. ^݅?$A8(U6z6*o} IDAT(˄egYYZ 8r98[cSAL%I}we}~^^-๹02k4T{swqwt m}c*{hŞŅaM\+i k} ]4Jr$Ib} gGGrh|< = !窶Ύ͔ uj=g-y( ztc; dE7IcXj8%u͛8}#%ׇCѧ(?>vEDpܙ 0uJBo)OWW|KHa)wL9I3wN%|=QRQ@ZvQg3^~7^~wǽw ,; RTAAAc^BWZNs1ghbR1G/ ZG._\Fm6W鋝죺T6QAhi>Ywd fTpy1vDF#(.#X8u"$73@_oJ(ٱٻhoڿ`0 zۧe0G7ê߶rEyP* iez4vvhZw    B[YUUlQ9ɢ<4J >^j9 \Y5^h4zt0W{{^67(evncͭKvtaŸٍ'r 2]GY2g#P),< 0`0\7,o0|@TkjQUgRC . [˜9á$BvA!~s/   GFtzp Y~д,C^BӂlCAL1ޡ!M5~\ bіDžU~<=G#7#7S1$~    \/"@A94H>YQ·, (%N ŭA*=(О6,O\L'ST̛0Y_IVm2x->zGٺ 2sj}zzZ~"8}nL 鼽>XβN6,=i`/._}Ʉ$~ܾ<Ɣ_\ }ŜϿLy.a vvToq^嵯V?    [NSSJj źE^ڤBJ)1ۏ~( Ul' $9j+*x:S&Ƅ1oY|e;JfMg$^y~^+lŚm=|C1nx7x%VTS[J6[cm5a eW{߬εɍy=¶Ml׊a\:a=t_Fw *K\siƿ3#yJ zDJ}},ZZ/ }B/1`cyA8jjkIN7̓憟g{wIAA݈a'vV38FY"rʺHrI1J޾ dD@Z8Mmգku:MUu5ee O|y~:ƞJ.~ܲ{1?JNϩx^cv͌6*K[ȘZ1IȲ an%S>?=:x|pWX8UU,:,ϝiv"2cr 8q&ni>|~ztgX?S`ׇ<0r 29~1T!ۻk(d_S'Ύ,KAAAAc w* r uz=dR2go\4:䄪(%vkDɣF1j +OzP;_7Lj=Viyg:we5h jW;X=IHBPF7f.NMNgRd ߏL KJУ;RX\jeH<SSQcVl\r a0JJ&'s$6"]]أ!U1lܵTvfp^=+CCz-}G[50,4!}z~}ٶw ):;s͠xX++/),)Ý 9 7%Xi{}*;F"B!B!B>Y2TT$(U }i(UxiP529XV^A O77:kK Rn~^^T*nhKҩ];ޘ-9XZ^3fh:ˉ>q?ͻ#mcVmƺ;շD8~XgUjEE|˘6gg[Pȷ`NHHdњuu.lBV^^9r"vu( =;7ߑF?WogَS_pˉ3Yα ч0$LF˖S\VƉ$ޞ5[":?2gr ()-kwәl9_ϝǎ}:9ƌWiVlg?̑x,+gl؅Q{y8_>Jy,Yrf/\@jf̛|zPjf&/Rwe醍HLl6x:>~>O?gՖmWT/(}%~œ_@Qi)ч0LDaMD;NIYUC8ű>b| q)_Kٶ2[D1o>~GxcƗOH 2z)D8MS}<Ɍ%#;܂Bf/\?h{mS3e̚{{ƌUǝK|Gٴ+WϠ䬯8!myOe~ sB!B!B\deFPqԨllpQE5kjehy{%KI&%>y:)M[jҹAsuvnaxqڧ#,W-cҢ V`4٫/ eeͶm랽Ly F]IHM͚u ={r4.5wmcb߱%r @fn.킃wTG'_ҧKgs#T'0njn$ӌ%=+^KYE_y wXܥ߽5flijޘ8Tn1 !5^b{ g/\kf9O>ne;_}CFvm\Yy.NN<4b/NzשѸxź;m(o?5BAYE/NC'N2b@: ̐aDgeDGgBBqF !B!7!⮶ot@&JRXV:pP(zgF?G϶8;:l1G7#w߉7[ɏ?Իך1nnKz5 F'ض]6Vy.h۶ҧ7ZGXkLXh(]:tmV{Ԩ(H$;߳(#Çؒ^-F#quG2GZ [F h2>|n;+ ua}}Q͵ڒ&'suעQPTz9d|TnZ1F,V+>tiCd![{ā ߯N&FSkƐ@9[Vbb5,''J%wp=: <熈9j뮱m kCwf;;y'=ΧX)Gbbxɦ;ХC{8YÆھA=+#?$JQcqQ˝8T0O抇 ;Z!ZJ+n8:7`B!B\de^eFԤGg6v8hv.)ZSnA!'g۶۩TD?GJ חIwn^V_tŅ‡pCV+Yr5?.`S\Z]>xXBAqI{?o:}z'0nKfniF۠@qb4/*f({/Tv~>]:tۻ֌"޻Ԭ,2s(.-gOQs>} Of \ֶhJ|[kΎ DF&37̬:CyldR2yE Xnn5&NޞRTZh$X}}Q(svbCdRkCN* 6DdbYyeeP(6a'קN4ח3uր1ѣ_y{{ӵck b)VdںU?VP\G{QVʚB!B!I2T(pSc2SjcZZ5;WYIܹ? k @U#qŽ}KI!,tbNC>xomBK<<~A חNO`}I>}Xy+I;r`?:R)i]o3Aqv眑twHl1'c8p۶ǹ][ C[X:c.J 9 |0zuDxބճ ?;뛯ƶdM!LkZ}sõrp_~ܫ'H\<{&,4Vr>:SM̖ZJ͙f~-Jng >FBWYgbAu9e+/¡'aH&q;=8p۶瞞YxjvVi n^ϧ7ڡ !B!B!.$Z DɀҲB;'; 滥v;@cA" l fzv:3f3{m^l} KJXm~u]S }}}{cbz}>>df=c$ʭ kJ6Dbpҙ]:scxat"KzzbZkcqi)n' &>lc |O>,#LJd;J}6?oo MsLLK'2];v3fKd#qwٶ%NXh(;gc5.N&Z_1.9ՊT/F%%~:YW0?BI瞱% ,/JuR9 F-iZMJ}6 ;iDvm k]o_~c lBCY`C|,b׽Wk&-2O]0lSPNF>,&B!B\d +Vi*&[>2͚LJO'-;}isuvkǎ:ޞ?JlR2zCUɌ7ZMx ߏU۶s$.Պ-qs>z}!bdڷ7z ʦݑ[VZ7NVdYzfZzveeyUگvFpd,VJ9͎}kKx!ˡ'ٱo-Z'{qvpʪf%eet9SӖu_,Xږ,(.f$gdԚzfҲYa#k 0wOۏ``H'T]^߲!Ϗmm 5b:wёZb+vNScP[3I\1 ݛ ߗ:tFҲ%Xku -]FIuR2slZ3\_ԵU4*FũϷoxnN%DSh x=1Z;$$0ٗ~j x;^|N5?QzVϾd.(l״v<2!K׳r0WUB!B!.2 U*UXV*&3%BPwU9Sw{v=Oo O1f/_3W^BR1WO.>]8Ǐ\vNWGʹd랽8m:>A幇`sy쭩8SQY}7]uIݫyYn%ee\ծ-Cah||sH|<=Yy iõc͖=QةTL&Ə ֛짟yqsv@;l}^;C=@EõqsFf^]?X+q((^aؽKk+_~G\J*#k7-SAxy]:qVnoϳ_SYES> ^Q3WOJ+*zhzSHVB!B!.' #aSXQΰ6)4{<1Y--LV +XrVP((PTJDPbPVV*%#|TJ%>׻.ZZV6iٸ9;14.Fiy9'P* յ9VUUR1WiZv6iYٸ:96I1;? b+9IuI چBFN9t 눣}_j%.%b|<rNL=NB_% +y#@4Yen?{F{;\ ?pFMx%h=`ZY1s:W\wŽVqM|Z:[~3ʟ=|(6^|w~7Gk895=,䕕P@PKx4GvB!/$ &T oԷB1l˷S߾DĤ 8QGq[ڳӋqwpI۴IK$:<Ǽ+ ܫ/WwZ-2(c)ktOO@+PZ^dӞ(+psrd䠁:R/$#I !n lRb )e |/JrP\*;>=G-U>~A%hm3.@P0gqP\Zΐ2+$Q~}muYcx1:|0Ye;1Gg槸:9Q\VNL|"j;;YOXH&3c:'~ 6~~f[0 GmU¬ kOW7K8t:畒ӟh2ӧS:%9x׭DSPHL|BY1|6|xk>|~bapu:V#,S=1<<K@ŽCYq,( 97s,)N!dez{CU #*ATSF/FǓOˠm` gZ'gЏ}GO:b7iٹx^zB!B!ĥHMH>BӃW_7:wjph2!2ZnX ճ \ޮ*`SFqi"7挲sݺ2ݪ^7Z?wЯk'Rskzuh2q)d|v&V8L{>XcS>ɞ#ǰZh5f2 ]%[=LhPn 7?vŒ=6`4&;)EzNn?};w;o#ק`32?c/Xlf-cxI|Z7Cp߼QGsk1h5jg&%k=_>\0͌2{}!B!WI6!J.6GFa,n܍TV? @|~ӷmFa2Pꢁ=@lNwӨf=jeo~4j>=mNpS&cs<)Պ#=ªZUѷUܞGlJZ}vlLNatn kUpqrlO gw[rk~ضCzvgHREt kFjZIH`x^?r~ѱNN{y60tbSt k_\p!Ҫو>:)xM>ONi㉖e0w*B!VRI5!2_}=GrI,1 j5m˃37)Q/% VW^͞ \Ł'y/3T)O䞳C՘Z=\m_kkV~Y5.jtsi/'OOe:t:8UXl׬kv꩟^%eک.Mb1S\@B!B1N!Acy`M&>޲o#ͣûdUtd撧 [aᄅؾw?g2̘_z{{CAQm[^Q1Y8;:o/ʰX5 xh5ݫ~3lRs.z9El%w}괻89HYEyŧYrfxK7%Ɵfg&k[rowt:mR[0!B!eȔ7!B4JG/o^~ 6o@!3ۿnQ>#S?>}M$ed}j3#v`0¿wt ]% Ș5٨h`}HN!y+ם-yyǟm9O*z^4}U5[m;_~E7J#5*a[B`x+^~;0r 9ݭB!B\dB!n=ٟH**bvT$]}]k& KupɿroE6qgcw]Ħ2ٗpwupl<ΎNo⍛3t-qZW'bYs7c{D|z:!~ݍ{3s5=\X<#~g%d1sLu !~~O,߼\z1OOƏ޶v>!qZ{n  ZmW>zJzѽC".clBN=))+㟭;-k۱M0c]P`vХm(/N־˿Vq,)Wg%7 ̣ͥjEB/N!WO6E%}{16w#fכumLEQkRӉɑQOgbGO}>x+pZ1B\ZJ(UT(h׀-ꑭBqߺC" &PM>Է#B`&{#(ymJ~k|Rv..:;UY1 qzWf`4?;{iL^4j5O}؍Ύ[G kB!Bk*rm<6`Y۟8۝$BqX-ymќ,޵Uc( TJ%*$E3 g)Eݢ瞪US6r`fLy?/HNWۻoҥmhk'B!B4)1L$1;j'P/A!WV LX;%P]mۮ)1zJVeYۥh,p-Vk=3VZ^{ Z1NJ !ĨB'%Fm&״ȐP2 rBc'Z!ĕKg4Px]'F+0uZ;W%)g{az !B!IfSDvi2QS!ĕlSR+v v A+ymJLK+E*B!B!@RINiqk"B49JvI-.u;۵}8+##Z8J!B!B!DM l&rJZ;!IeW?\P7_/ؕb1 !B!B!ja P*yPaГ'IB!WJVI&7XޞGވJYb䖗`B!B!BS$AB*= da5 B\ ŅX,=P#9xJ`0}7֭B!B!BISIBBza>CB!.H@Za>*7x  }/=v7SB\ؔ4~{9GZ;&9j??,YƮC1v~Xf;FKZ~ZʉE4B^O^Q_L!B/' T( tޞ| +ʰ !8J^Y)Ņx89~βQ*|8j NNm?FfOZJ3D,ą{g֏2}/j쿖)j9$fdoWT|Q6;l{Y_u><`_q(.ve~Z~$.O4RoA!B!Ix8:IAOja:$M(RcZ)URl"W{Njޟ#c+KjZys**ʛ0K_qYMLuupIv]/x|Fn3~_#^’]/'W'=РRg~ ,xR򹏳d,kDB!B!8]koSEiŠr +pupEJ)[!h6SQN 'I? O{#ȯ͵udY,,Kkg2bBܣ+OKDr .. ,$WwYVNNUט76mp\Zƶ`4Gy ՊB{;mG ض `~1q<闶1iFds|ťem.|کM&|MNVw^'W$|1o!};w:op?y塉1wIHϨ?ÍU񗔗3lc^Ǽ몮ӓ u="v=IBew>vLw~.BO{pFZkϵ !ǧyrPP\5ř_L'ȷv?!B!r% Kg=frC%:b]9f; RRDP%B4+łld1cRjVR|ٕ p.KNw w@ݙM"yxP䛅 kGj[c;ݝ_Nbz6,\}7݀ s>21y[rs.,c|u|y !~ 232Э m{0mgNqi7Ȓ|L-֬7o[G߈O$*>-7spzth_me$gпkgՖ twqeٌOxoMI~Pk4wH3Q)(.+cQcly ፗMIY1[,xǿ-xk畫ye}yo-,d8ދfB!bZ9ߟ !BHR*qwdjb B4R@PVPZ3p._kWމ_&RҘU;(4gJ'xi`+nN=J3pשm(Bow7whW8NNt.7 &6u=?5v**ߙK^V`3܅F;nEQ@Ee%5Jvnۆ&GַIʩsncF[rOBKWmʄ{x[pԪQ1T9yTTVhoNEqVNhC E}~xJu8T(ګ'n .-g=fzukIٱ١2,F!mZRfhl yZ!.oB!h* bB\Y>@:_e~ 3oO5*{w{5bݶ}<=X>sz39W0[WקNd⧥@4yT .?ZzWqY9_>'b).+Rgۿd^%%3 //4IGn}viw:a^._^_VUb>QG!2I!׷g[c'㯴&ѹA}2"%'QSZ^k @hm':Iwi{:{*[77qiS*8;:vB`V,B!$BѪ2 33ؑsﾭ9)_^^E/܀$h_/XRM9-tkߎz'&8ݖ$P I"NS'%3rƍR^]>=uY` IDATNoViɑﹳ>?ΑDn4{F^GqY/;1^\ZƃS?Gnˈ>$_-X\߅_ӳ(BSΜ/B!.$BѪTJ%} z̈mg@`kwValBjnx.wN~w'?d+,)xR*ݻiOHO [1|=:Ի=QCgKZ\pB@P`Z4WŜ Gl[?=U"1#/r\0LLh:*7yu>i99$gf@uDDrI^xuڋK8SWXG6kk?5٘5kX0̵w1 T(x}T<ksJ%Ǔl32y{֏898Sl1B\zf4/!BQEB!DwqὑmtL [Eq;e?S[}2G~_t(0g݇s:~[dWT{Qyf8 sf-ckxz cѨ~U:j.&. m䪐6+J66sAΎ)APӲ<ٗLe 㮿>qO}'>;vޟƓOk͕ Bxዯ9P5{<<7s~gdP.fF=:~>|x3믥;>޽1&^B!tڂ B!h: kCB!hZl۶ׯq{j\g 7Ӱz[Vru{ų^rivY^-*F`_ZmGIfH8sĦA  H̤mpX$g_\#A>8;:k4 nx{J䐜Eǐ`<=ZOLBTұM0vZVN$%_TWv3Th$REWs-)/ZGCqY IBTIgs=B~Q1;ȱdiPWd"&> mdc4rsɡ-.+G{ uf7?m曆=y6&!ĥRB=}l/^WlB+^ Iٌld`XXXM!SVR(SPTMR2)1aW"ԨTr}t=ؖ!@AR{BI6lϒ\i1[)"p,p) B!2 0S2IB!Dadc+R#ï;h6SnDg0Pi4`.VPD٘B! V,V VٌlBTbवP!5I|j9?nTk[dB qLf$/ts1VUVRRCo2䂦֑B!j@AO~y)j 8iuCǫփ%GZT3mivJKk"BqI X _9%A(BєZgjlu5}e}ouQ+ޞ^>(A!-BhԸ;:A 奤Q׵xL/N5ʊ=c1-GKpӶvBqEOKCWYڡ!.B^oZf !B4-I6wl=o9۷@uR//DW ȪB!.E g=䌻S?݃WF\ kЛMn3{;u**d4C@T!B\,JZv.poB31W`wwhp.;n.. ٝݺ!4vAxyhoVfc !`bӈOIgO"@M ?or@7jO!e@P䌓VKvI(-ʊGH(myQ~FBQOZV-$V'JCiy9v*~(ZoVVT(8k{C8;92v0uztG{B!NѠhpuchn܍b!p n`WTvH-V)A!`o@FQң1|%} uHFr2=c=, !RuCT,2oG_ #^4d(QuHg{*!fg}ZZkG4B!htJ~ya9ߌ8W^జp1dvd*mɅ!TC qT(tSuYE*7|߼"#o!8ƍ8o_{ i&۰Bd aO`q! ,?}%?CEgnXz\?wk0:O @zMӅ /+ u:c)s:k]TbA Xg2Vz)pZdOy’!dc$&ĴiZo5c2b:퍬թ*I 1()sDS\}QpU,F.erGES݆>Kj.YcxpDy=$&ܶ:Ō5VN WBrBlQ5gd4t2NӑSR^$0bn.)/|=q t{8**ˁ@ @fFzq !.ghAɌ97ǒSO<;!%'$'?pD#H@(BC**da504`_3? S HoGfߏDFUQա4 `0HIZ&c |~ EvقKťxAD-p}P]bGTT\R+TJMJ$.JhTGl( K()(='NMl2׻oGE%e 1 *`10t"gc@x/*8YPbPXRFxl UtEY$'$\_\VurzRq1g%G֩ja  0IkD@MFy5^Ol9 ,,-+mq1cHIƨ@FfEQHձd<1@%B.FMӘh&B!` lQF?_4n9a^{gekSP0:LZXfLU[Y0=RLV,1Vxjy F3)ت Cs%1W ZaDR`]c h{k7v(-r_c1oB\1Mê3E;n4/ܙVS0bӤ3`RkcѩͰ`TuBNI۟OFUFk`6DQ5 QZu@,1^{WTtQձ> e(* JxK@(Q+{ba<} !hTU{%׶pD $ B!DH( kʡpPVOv9/-'Kkx2Z1&eZo4~}jJp1,c5蘞~U̍h`ժ̊% #sXqlתk`0D!=9 y UFhJf8׈mVk1JtjQ+ lL+${<stdYטדScRR"7BEC5B#1 *x1BhCq7?7# ,B,TE!jqXB¶|U2C&ڸ֣ٛACUNqhl,xHsuG֥֏ 1 6AHcQQC>ZfbN<lA?1~.&!Yk :p'~VKab4P_OF!vB#? 򳜪(ddnjt'6B!DkK{"bCo!B!hlyM&?p[Q x UJ.n;~\?ꕇeݮr.!B#EP)=8p͎!vNJK>0BF=pqZkC4@B!B4EQ-5 ўǜ^._]hZu?|蝹q旗Q !BeSZno>MrBB$w_uIv{ ["B!lqךC%]:tu/oK`j 8)rU44rJB!U[^:g4j 5]=Y!h-x>!!B!QG:r Si[?+ 벣Ǘa3&idI%B!YVyӔl0nOykYZ{B!!gg0D$ B!DLm* f3z*5zq{a~ d&-tW|P)+(&BqjAJQ}B"`MgN'ՃB!x >AB!B4;x b^+kQɰ'TsyX-Bڼ?p>#Z F:&*ri*SOj!!SD=IC-̄BcQŠ k~ٷn?PUZ~GdA#Q,NcB!8:]8ŸL&2Qr0*ƨ[{B!D=xv2"j+QB6AP-~r6)$TAPWdmR XF:$&cpy/.y Bq jAK+/ JΞ$`=$7 !8jT0DiB!đBӵ{ۿgRx:=~?JKe@fR*60@vi1٥yB!GrE]8>!Z7_BѬF Hf!hT~o(,eiwߦCxJr&s͜1UQȰ'jېVx=+.!+BqDr()$@h*HfR VcBqI" \B!RE7d77i?N˚PDn4Z +ӈ7[ y`Oa5!BURDVInBU tHHFZ{G"BKNZ{"XF$ B!@k2XM Hқ@yuWNO).cCl&3r~?AMUAEɌdBѦn7^?^QVlN "vI ҆U!%.mm_0O Ђ-A0tWEAQ@AA7(: 2IB6bDf'&t;X! dvHǰMX&7N<~AMBęX&,\pB!aq<8=\>oc`XIġMgD3()/gǁ,J1&&ҫs' c-xQ[οc>n7c)BZ6Y!-1~ݺocvgPtdOdlwekپo?Nxy\}:&vY彭-SRœU+Xg7@ PETq$q\O&RM9V#~-Zg3UQ0: B!Z<}4>۴7WB_Zì74*d&dA4 J]NAC!B!8TA-/}ި :=f3vUf`2[{ƗKܯٸsW)fSF 3@Gg-{_Ysw$8oBZRn0_{stHcK/D}l-<y#gLdlݿX~ֽ>)#A=z5WQUWN'Ko/wHKilHmG9\ʋ8zױxf𢘃qc150BTE1ol+! AaPYXHv-2Φ( jP.77|ˏOQNDB!8yudf`6hM y~uuT=]o-?]erXx8|:gV9Kg_Z\Qpǟm0_}m/7.< GIu4 LT7hm|C0d-_ m4:E%No? B~qv((|m2Fc{aA bnVެzqxZ k؛!BK0 X F,F#F\RJ 槟cۧүk*<l݆[>oc>iB+%Tݒs_ pָHOJ9uyϸ<殬ln}yn\&vHc,u8x"e$'ӧKgTUe_^. pyqLZrm> j_ B^?Gaii~Ix: =Z;\zMxxx k{1ainAMceΙpb$؟y+VA(~*8VoD,b__|#(1UQ׭+4g ۩lsgr3kgodۥp) YcmZ{Oǎe6kPp4 )H00K! Oݗ7+) 5Z%EQ !B!D]*:Ԩ>qo*nᚵ|tN44U3s/K/=qO<>:]..~߱3깋yꃏX7^]`3xiĺ]}l2۞{z=S9~@N?a,f1bdS8xChZR" =p@nڭg~h`AY,uW?y/S糟tF>~tH8+6c^|pI<'iN52b. gpcc{yE:_AMcA GÕ5rozϝ/nQSXȖ!Inڸs M0ƞ<jt];1M>%>7֠xhFr 7~1l1G]֮cզM$3Z{H+*⛅ezr Q Ǒu|Iqy>ә>lܱ=|EH!D,6uywͯ#'B!82m=2Pޝ;չ}.]j_~SUΝR絳olsFh'Ocb∀pǾl֝uبc林^x*ԑ#߽N;vMԩt:v׭`yu<[^zL> M.,b}|_-0X%&in*>|Z$,xoΗ^rzQR^N΄Cqկ_23<_EzH]/ˊ=w2enݓ˗Zҙw[u;qNs -6g(uхjrro-!DA4M¯̜n]9GSnaO 3) tHa/"hALi|6Zg#\sUCD |1zsٵoWFN-KK(;#d!ùh0Mx8kFᲡ#U\HDlC;B!Bv)):~] wkj6d JawI_/۰9"޾?5Iူ;w1wS p;wE}/xyl۷/Mf0x:ޝ;qeHUQH8I\0u2%c҅={]\^+"tƈ}o& #)):l;{[vmƔ[nclڅ+v)1_Ggb h_Nh׎w]r)ɨ9.9I~-HdYB_7mfOVV8  _@jR? v*NUٸ}o"|G_!C>.Y=^YقB^Oߴfm6[֮/  Դ!BTEAAAUTTU7{7 !&5ZW"<clS&B+WrZMĴ'U|b%߯XY︳ pRfLI& z ׬otk;1}|\6)GqQd`z~ݺ6ULy}\> NW@~>7zϓ]PXc waCHN&Bs^0u2+Ɓ!uCr "_'roU!FUP=ֻ3;k,^œΑ}zs4!VA``@f&23gﻘ{'Ƭm[LJ挞15 FV4bdᯭf3v`o[ҧwx#)NRQ(*-A4Ll}WRV? 5)IG2ip-(DC#51 {p5i%<;egð~}M̅gΩW_O~GB!Dlˍ%C4^׮&Y/-ƥCᣚr:߇ UCQTE=!BXi4M# 5|?b0 F,c$8V9ig/ꨬڲgOrL>$+ 3eU N;~LP_'IÇEAtJv#-)wڿZI"oag~rX@UU`T.: Vm<|x?G}ٹtФ㻽:rN1cx^UҴ*>'hj!ucElnBՔ3;/ QXZZkەmҿ?O/>K=E#D['aW߯ 7mSOghʹd3^Lރy;юmp9ytr62SOz$$6J¯)I6Z\]#*nB^92.Zx}; ח{q#E{3υCу-7rO44ɳhIxhOodǞ\{l_sq ;Jh"2浗k?+7l PP~=ssjxm,ޞ9s ݋?_t&>os뮉t 7`ov6d|.!70nUPޚU7p>)ћKPӸaNO/^l>c!47NχAb0g2cd^V!B0///CSMě,LcAfz:=2;s𺷾goֶe'-m!z'r(Y~|nOx[j\3i\Mm5*F!<.ڑ`oV/()aon^xB5wD?[Vp@8?רnlr,5*F;mhn.T:]жO|CQ ϛ2W>"|?ղ_u옘׸.aiWcp673}{%{%c{ص? }~ʜN~ټƌq4i{E;=f/[\}~ۿEǡ8Wr2ۡy<|g'ۍ_]G}nUV>}I>]+sD0X/৤<ߞ~W?Vo¹G_ ό U!~ݸV8Xݼlӆ&[Vʞ|^6ɩd&bf2c%B!Dҫ7'%X'-5rʊW\@I B vvEyYp򊋹(Vgp)':y'?zdvdd?@Q춸Z}^\ 6W=rU|Z>'몷TN),dنe1tjn+7³ n9IG>2LKJOǶMF#s,7y3;p@xs(s<؋w_W9nͶ7' WөQsW#ښfs\?}sȋl*ımO_LK_}wksZZ)d枑c韞"|Z%\ұ+)T|T]_1^ّ&O䃯 +/70vH=ӿy!f#xXz `MӸg7bkn6:fd0__+[DrO1빧WTh=|8랙Y'SU8~ 8i F?.󗯀ФɗM;nY ~},Eg8և3}iOQ! k[E7 A:㦤/BZ|!B!hN&@r K;MV(a3}xe9=xsѿ[W.vW#y캫HڰK 7?oR9g8> b{s8S> ,ݰ%7лs'.:yJ~x9sMBS! +rX7:1__ғ),-(V(pyl?g^3ꅙؕEzR"_-]^pʹ3EkS'xY&&ҽC{,&lٳ7F b /y9,NfpϞ z Xu+?XEI#as-$k[ۧQّƎ륕Uqbʈ֕ ;wlF6.zuywgp=s٩й]:>Ya#K7l_\8uu^.yП!-DwcLoBeQ-HivKQY9-ZH}o e?+]z0̑]AQ)zwwN$3.9|Q3U|`;&O`a$68ncOۑ~1'{4Mv/k;f >x ,7=OfP\.u5mg`jWT!萞`uknOҥCegpn K2ag}y-\sȭ?_}o`k꽺/m w5|)r:Ы*q6֛[Q!"VfHrFBLf6٪P* ~ w>߅n&-}A᫯quvI"՜1q|~͕fͶ'do³jryu>~ G(t8uuřqc"uHKɛo4.^Zk CpcWZg-,bݙ'φ]yWT l 'I=>)Se^>wPHUrU㺫ٝnIs MkԐ4NL6E|Jk|^zg ԯs/bŲ۹wx/)sȴٹ举)~eq*ihjvY+zNwBxܟDr#*6y'=s%?HTm ţm`6;o鲨ujߎ$x{GcͶ KV*!55;\YKh0p@A(;5USZOz!h+3yWpв%m|?YET8I!1YA!BqtJJ\V+'<t˩Gպ*=BטJδ'ryls;LF\{d4Dfpyˣ>~ژ|C ݫVd {h~6_?W 8~,_u$2g;6; %!?LNKONf!$lQLL8=|7!RAyz[Vٴg#4MCU>H. #3ehCF7M;qqcǬb] ݫ1 &SxF8ܰ-{NY]s6_UVCSNic6 (v:(sWd`i67B!IU*x2.09τhnpQ:f ;(.+l4`Gǎ1W V:AӸ~4摕#%!Ғ"*}w7<:cTKN%L[TBnq  2;6؅ `x^#''Czr:ujtEs]5F?mq$?iAMRѩ*I)sL5rȢ"b!#)Ĩ_z\zɍ}tY [ˆ>~ nq78'5OF?8?'5!DRkwh߃id_ZJIy9D2R[-(-OfmPYE<1p8 /D*q:p„Fgw^)(5/'x)]9g`yM`e>/i_%%bexEQ IDATYUke_(ʟca(=;Ts0 RZ^NjRRm@>_aQiYmRO4v[}~nח;|By!z'O;nb6S\vN9?\9J}Н7{ؽ@2 ێomS? UQ蔔*Bq1tHL"( q,Y- qs9#1l :e)se$'ܬjNHZR"}ti1Y3ڑ)( RVcm+'cڶcj*%%\>y g>33/`h6Hs9|nsA>|NGh R䨠"Z@;!BPIg 㓢`@8b:V2WpZ>oܾ>ݻE -9)jз'+2=vШ6`0pq>~@ek1租­?3OU5oZywO;YeD _+R{,ı3-2][Wcg,iU~Xg@'36y"ڂb>apaQx,nփ/` mgg再L3{ NǸ7b{<F4F_N{ܾ}x]NA8].&x⍷u`ccz ̬ۺyd lb{yoCFQŠ^Xm`{ҙ-;wq3υ٧{: uǭ\y߃|>A2zupI(ľk<ҵ8qb]9ÈpS!bւAGn)rB!i8TU!I&$B!|k#'J@hݫ7ofݜĿ'O@ h^>ؼbGQ!~UՅA%T[Xd4*)z(PU(z(yŜ''עE0yᯇ]ou v%LzRڥtZY[뱋:уZOhQI)/C^߇Tu{D硸b9J<^/{۩<m8jcBs +ڥkױt_n{(--<~e!Bn]Z,7P !BF~:̳.E{ǃ5znGQ*_!Ճ(@PY*ӫ*h(F@ }ۚP՚o={gMlҨCs%#%%b(\6l:߻[7Zmq2ftkz:mL=2nH|Su΅8b@| 8gss\.un3w/f>WC-MdpOpQm*(whgOpP!xKYEkL"B!ZU(IGiO<\sRAXjOE~l&V T& w,.BQ:USMQр]̹E=;cY^CAmxnNOWWp /o t:s̮IOn'૯8q0f=4~o-[ǎ1an48o_۷VT]Vʖ\Vւ\ـh^ jNEE*hAUQųR4MCR aH2Z(`0HM;k!/[%g٤}{uJ]}Lup\FWz&Q#cغq:F!8ָ:KA!BœSVLAr#BqL kCuV]\Lr8~zMG3u3ZQBC j&Tjpä)/.bUjEN~?&C if+^  = ׂ+Dz XwB!"6 /.l0`5Z{8B!G= _+^/3cƒoGQ޻|סh@5TT@S44t= x *3B~5h\Q>4cRR%M(Z9}y5tj/A: X6:=6 rR^L?PA!B'[VBfR*:U !B$ .7w*7mdH$Qv)dBeW)JECo2Bz0Pg((E5b2pg ((h :B^QQT+Ǧ6|a/ !NՇSzia!Bl0b3[(tB!8I@ 4MҍQ..̌ 6dUpPCCѪ-?/ݻ׋AռҷC&C ܲ:ǩ* q>o8Xt|hIZ]‘6sY--2>!B!Xlϋ`l!B$ lm ֬F рyy'%WN!X}?*(DCTT4M窠@3Ev \;qr0fkx Ryzj)zBsllh8դ}3e.$B!BJO̤TD!B44to4b 4''WV<8QLZwUhԪ*S`XÇLՎTYa]RZXM:}Ø[l|U!B!B Lftj!B$ lYmBNIqx)#^V!RE=*۔j@E~>¢j`e8GON0(f*fTM@sGS"2B!B!Iq6J*= !DH]/DVBc^bonN^}7|ɞz%؊%xoZ}2WiQQ[s+oU"B6@b.gDsT :Yih;#6Ӏ8N9Fg2*T&Ze{Z?{; I {n'{Zmeavij[VPAQ@P7$dH8U[߹K/ys<1Hj+H4֠JL[MFECp` [8RiE.W嘭r-[r89Uj5.ə o/Yк-;g2d2dRi]PrT FA$`L!8%MUx4)@rwopnkd2:uKjZVo%}=O"V z-jjqc :XDB*C)Z5"8{1Uv˞n-7ˆa0 kɜMjl=x+,J&Ý~=3aP|=u^kzz#5ke7@NyffxZaf=mivUc""G{{]AiEmiKbZOqnQY R٠/$&2*:TԚj/LvK_CzSSR7OPn/&3rˎ)"Q H$ΘV*iWuj Z[cT⤴RSV`I$Y,ݾK:92__'\kڹ)Yu ;[[9azUTլܽ}Q7+Nǫ#cb\Lģ ']~q1v$!%RA k2OsYʫԼ7e|RѿsLΎd6(і PZUwv'NKQuJtfujv=f-6QR1}MUk4|oS&^DDDD㠴\]Ռ-EDn?:?1g& Ķy6)YlNЉy lӧң}{}=DyCVV<;u2MiE0`JPf+NjO%SGb='{ӼO<9^B:vddX}JQY9L>FV~tsDDDDS[ې]\?N\@T6& w~C.\!(0*/+d'"g&Ou>r8sM}(WUdvuxn`º&-Mܧjվ=_x':|(:eTg_j[YriÇ1{wa;Kĥ/8R}Qq6zoۏ=*V*Xb%)Ъ?0w'l,Gחݺ"k۶ }쮾}xr½ԙO?CL%w fOD$9ŬxM1v6w̙4_o̮F`fTh(,YNvLzA܉#_zApؽcΝ0غ5Czߓ]hgZ:˶`ΤaPn̝2:Cd\}¾Slc֥3^S׷}!"oE~Ύwz*5?&sPbt>+sԱ7@ףR@$22+ H0HDbs-kF;2L"-n[JJ+Mn#"""r(dVȤRT dd. ڶ֖LA l-䙂:22hWIvKbZ=vee7еޞ.\ά=T"kqTKO%x2Gw}1II ލ]1t}w?/%+az2k0>M_+:8]wiE9eef*aԣ|KKLi7Jc(:9_l|/33`v}x9#[w1*{voԒl%*L 3/[7TTV{XdvLm{t a|JoH Vg^L&Bo-7HJKmpԴn A^Qzb:r )*-eh^R#Gˤ.gfZGD俆(ÚC`|_< ׼[8#H1I( MOT z=ݷ-nW\Z#c{'zɣFmvw#zzY=7nٙح xZBHu''p//|yI|փy惏~1G3!u fߚR"މ{KStȭFJS- "8jAH Y`޽*J*N=Nv6mֶt:(ۥR!H*(T²L&3 В& OW<}Ek_yG-fR?/ODDrXɓeΤƟ{+U{z]-OΜaJOBռ*5z+VHR!PVQRa<շXYYĽpsvZ`ڛoSieM6J%|uJyZsXY Zũ޽Om[bg AV-qcP2S rY[J';e߷sֽ;SV]%3ų3ppk+93{rLv@&whJBNvm=! mY Բh(: C닦wk_ |==x^Tͤ :.-褉P[<`0Y}'zľޏʿs])r"\,z!a ?CEUU̺EV~⳿\Dhv"l)GѩMUF~=F@˖7^d@(L32p?2i (֨[(%U:Ɣ˙0|8GOa!Aa}f>GN6[w)*߼*mqkט|3S^cljO`5P\VƔ@i,+-%o~-)|Rϝg&Րs >&61g1>1߾l"iִ)tQX{njSbq_7oe6}%}|=S ~o}jwr(2_.jTO1\jnq-9Dv^~v ^74X_j劕d훯5z'~QeT~:0%%fY18(➡-YDDD`#WP\UA gBdQFiG JJ(,)ϳyAI:9Cc,?#p'!5yz7!d .gf0qРƁݺ1[7tz=^Ï[4jHP` /͸ /+xt(dRzJ^^pqcoMdMk.-= ?^/d%gfL:Tz™%Om8V(Lb">|Oxr LBLuDH$.gfe& VRS ](x#1go?ypC&z_xSQUŔaCqo犈(@x z=vve>)_z&hiwtP.<4x0YTX^x] !/z_D :h0^+mAh0UU,ܬ/Io. Gǐr[k lEb0 tjHHPN5ls?]ڶ1(N5MJ_PRV҂!&gʈ<Kv^VRͮbtz=~^^^^ mRdY0ٶ) u4\JJ@X`kNܾ<ˌ{bT_TH++ٹ$0(6ſcϐWX Cz y("*)i<{u<<KZV6jػŐ_TL Փΐ=CBCqk|"L4]ڶeJ _O٩Uk4;},llUI1nt:=kw1VVލ+W((.nZӧIֆ>ݻMM=vv6~~̞#!9S/7ޱ9+*eP"Ξ4l bNZ7Bz }[s=ckmM+h:Zxs3)Wpjj5NFгKfHsen{"Hp3&ΪtZ*Zȭʦ? ގ{KWӸp2A,G\pi]Z0v }8:k_|͐x4د_Ν٩#g9{1LЯ}>9ټF,Ϸ}u垡C0=~cgXc'3ƎɾA'{{}hn?[q38bxm]Nú7)*zq! ֗WV[T*eo q ?&l-t\>MJjE dAݚ/*"+7}Kjrwqj3t0-;D?/et~oh!URVΏuljHHNarhpCB{#H}8IIw?$ f#c[ɣF Ng3`DmVzS[\zqX} /b0޶=u)c`HRYf܏Nkqqr"c,&;&}Yyy$g3e~ܲΝbSxEzu@[|(}'EjFvghB0ZN[۶9S5X[2N7{tݺ"peºt.|JqY'_zo..D'&ֹp°ߴwP,Z;m|}i`ƾ(2q1sʸ&ļE_q T"!)=-Z *"[RbfQ+VVV bkm͠~fi;Ot(ptTEd0e`Ep6 HzU\"8> q2R37n}Vk^ϹK١=}™^{O<=:S x}""vDJ"E*ܒȗ-,u~\ 8ĉfl{&114lFDp42Z Fqh0eUVQՠr*값e)u-F/7SRѦQ}8&/6q "8p2x鱙'JII-ՕSmDVn-k[q0"m޼ghI~Q1}%6J%)-/gϱПMO1WX/2U۶sE^yTDhoG8Œ _`˟xt0zؼa?qwzrxoqrۛN_KR3JF3iǡH8ȫk"bϣRHϾلB?/%9-n; J aɓ,|d2Ҳm6b(*)'"wYcBR}hIK/OcΚ _ eJJqqv֖cp0"w}ÑQp53V>Xd$L4͞L*L\< )j򋊘4r$,c#Aacmؼvpr={9uL&w@QI ]ڵ%53m1s"w}N=`_Tk4ݹ1g;yQyyH$9@/SZ^Amx|$,;5ѹmTj5?t5 rw=o[OW7]Oz%>H%8LK'gloF \03'sr5__l\W bw A[bIZs7=}7oL*E1z OFaaqi)SGiStunS.vѧƒ'1'HHNP)zq-Gh DД#Jl',]~]Bh_3Zb]E%7oѣ/W%$=}"KKީ#z¸v / >ҋQBs>gܐ8۱e7t1v.,ZJ&ٳiD⭟LZG g>3#2g N̂+1r9'~1}PRVVX+WV2O M•xv66g\Z{y`S|b%ڍ@|Ya} ?7ޢo_|za`n1>]J&C&ݷpՇdንص*Λ ^}~ش֭'M +~y}Q#罀-ZWAh طϷ6tcؽPiyoNCcF߰@ظs}\$Zͫ=ȇ7ޞJzw/R/{K1ypt 7W{ȝ(!(2T{J(?nJQed/_2F JLJ&M"979rPJJ 7AzzEّmm-)n"BkO=D"9~@$9t?Ogqx%0$adUv^[X9i .Nμ3iJ5^Kv<  HA 8w1IHzZrvfgjռ>If Gj9v={J3/ GO ?߀o͙ʊ"+گ~xG[Yj>{%^/~)Bz5:}KyuBcrZ:o~ ׮k̜Zg!xa'$$'Vs}£cPȭ5ejލ{lYøo>i{v>B񗓙9iӤgKs$`噐݃2㞱HRRGuw  ),Z+rh{QVQg}ͪm ꂋsQgbjN(ג1” arVӑ' kvA/hoWmF.B;"c -8sG'M5w|MD"Z~>o|u+/akmMZG?IJ |Ǟ}L1L1x-/׿-,^CD#B&O+lJ殁t9g]?Dh7*Yg6 zև'3?Q=z| 9,N^Meyt4: ~-\ #LJg 5)Uaߴ (rFl7fٳ* Æ-0\=p2¢@y癧X+aבhZ #P ե3߾Zք1 <<4Ɔ?\Dh5`9)Xx ` 3Ǝ+ff۸W\ե80,۸I_I5+?Y`iZjZ={vm О rp'/ztg҈۽L"%w!5L>IDG;;A8l^Tm魏->]sC7)Gя:"OQѠ˹.X[+ڊYeVht_hR3QBDXjXɤ Л5^fի;*4Q²L&Ә7u YyHRA]F Qְsyɐ;̼|쬕 zmmYRYc\rvl3e@ZNJo7WcA ͵B<[֖'A;pwȼV IDAT#K^Oye%ep7s^j۠]2b_e6yk?0fL _TʳS̔d=]Z/1[vseӂG.F䣧d3VX#u/=שT.(u:@x٤$8n46}"@o/ܼZ!m<-qC?9{EP]mP^Dr%f7 kSj\I(1ՙ3h Tz4-*UU n-Z @k M'ޙ;ǺK]\zF ̙qK zc/*jV bč<ϗJ~Qq?}vLvh -+B<\\&,5:>} Æ!j{׺p9-93ލUv'dְjvekz #&>Q ⠱Cy )BhAháHYBr :c}/77Ł5$'6J%GeWTDȤR}׳M6mpuvAV>XEEnC 7TKm[VXHt`l,=׬BkZӽUkfVk8d]q2];2{l:HD  D1f4Z/ę}cI|[/\_6 GhZLHI^7d;(;(FF!5}øk3VL}EcNJMmR t7UT6uۮA~w a]q(ɖc`@ˣgeY{69I{Իa? ¬9wIy9GOi%MD^ZZ+:U~-ն55!@N,Qxכ**-k pth5p242[89Rtڸ]-< I/Q c/zZ[\fEZՌ-o&tP\UU@(""""3ȝ(!HY,ǏsjI!3 Aй };5BnvJ/ŀm9̰."SJ(Tˤ0 hmZ[J7GS V2|8rD+4R %=CqKM~=Ψ Ćv1f@Zzyx +euI7ק:w^ZѯnjΫ7^S7CqoijV%RSyڡ=}w7vv5ō7gQ gfTr:KMVLV;lvS } jZ(ީ#~ɜODs9zgϢC?R~=ӥ]z6w":__zvl^DR)/+H$ {SםosmPXW},ʐ[XXh^ lyV֏`]Nq;ٵNvdЉ~|w.]lNK!ٕ>-58YQQ(o^Ҧ}̖Ohtmf86]+(3JJ=^ v.`x0֭DYv9ƞd  <+>7l7mO.9h>y\ vZ5Zm`gc#D[ mc0K(rONKLR?ֻn${?yZ{C3h=:v$};|߼x7yԈZ ޚ'bvv0 XIeho* J,Ȉ[)*i[߇(A\ p L֖y'tK@zNkοL"E"1N(n2FZoww j֬v:wl#LW=8݃6:Oye%]ڶet7yehms?yG9ŨꢝOlr9-kyi'oYZ!53u2 S22L66f@Px knA \ez='bҳKg6ky:g’RpO kTT]` 1Y6EJş'N֭+:v[?n^3"ΝS@<\] f}ZZ^GHI +7g J&c\ +EneTť>zfMxSRq53ul4KrլnfBr owJJ(*)m`m{)j&a1گ}GZ߬hq}Xd3KnV 5K'7w.+ΧPS](/U4(2#,z6?6-,DYX.nbbh{8J6Ť[ JЫ'zd 8ĶXey|\|d93n² oMփm 4 z=1u_rsC& Tw ǀ^;lݙ Ύ6Q'>k`V,HXͻb}ohȸÒ1݃."""RmN S23h֎-DDDDDDI9XۊR*C~5}Gvm hа`w3htz³өxZchmTRzף_dqߟhZ 8ɚ; e]P|O^Gs?ooz˺JHN!\l͙Tdލm @fN.djgcKnAp+8|NRm1 nIJ*l5ѝGlb 9;8ܾ=m"~X;9f"sP^YIE4q)*-B@NaنTT £c8}!Qb:zJqzG*2sĨflidݱcf C{&-8}Z<֪?iV[8ϗ+}tiVG2z$Wa{0իٿ/kwͯaE"™_6m4fN^,^{Nmף;'ch'_V‚OZ`XX(q/ ̾o.[ ?ޞrZI6n..,|-z=S8ĄD㍾ozΝ4sÏѭC{l&&\yLDOXHW^2z>=߭Z ͧEǴfݬӵ+,t~$7\ߢ168oJOSBےpTzllP]RRkw_# #)TGCpI{tFwhٲG/yAA:x i>oTYm ß_ۦVJlu8rVBqyԭ;a>)M9?UŘ::accnA!$eltLv ~4܂ύ~A<~(UDGD)VyUGaե3FC8NNWUMtD۹JdQXZJ{ng#Ɛs?utz8XEVn.OOTU%-(U'g:iiHVV;B~Q1yڅ_+s.'H*/>WR)]6^C]}=NgdRSWGĴ@UM Yy8D| -( 80cqB[PHna!AAtsX6)8:tPN~>&Q =Yr gNMVÙYyJ3w.-/u1+,'d"|u5}=cƦ*I?kW ;uC>lv޽>z=;%RwQm7]Ku,@4,##nMpgAߙy'ƍeK/4+W^+/2uh_?Qrcx}?7? :#gv~P@K?xϫjx74y:_/qG LnjN`6=v<ĵ>K8~]y<~`1gv͸ʚw]s5/& 27E~l)lJ ۽'F^rv'ax&AB*UjtZ?ZJd^B &guL 8T5 GWVY/:=#cZϷ@ID8ŝq:^]ynLSwĀ^:% PF8_ǴntZٹr,23lY1@ݽDs~{I,7WHPimccilJhKB߁fM&>}F^LD1&M&65z_NhI}T1ii~,9%%x^A@DDNL`iǒoŶ}>ۣSG^^ߛCfo+6鿪efN>W`cF~,,L7=t񺩗“oGƱ҆+{Is~#2_<ϼ>_.^~}\1wN_4ܺ{qt^{'xw?6,k6{JE %^QE"K?`Ƭ;7sN ,ܼzՉ[9vpIdXX6 9i"?4m;uzC(_ǎtEeevCBӵ wk1edR][K\t#%?C)Im>zj\9Aeu5a gPLVTy^ KJMܙ{bw8ظsYyD2~ؐSNZǑlKƩ( ك{yUb8=O>@| IDATL {A_A5Zvvnq#8_G˄WUgmX"iSyGɾA|z~V\ @MU6Wnm53Pid0$:0!=/%Οݺֿ')uL>={4)k0gOx5h 㼍I8!<$гXfYΖw_m?zlڀscPdNO#86y?QX]BhHȔVQchGϰ(JVJlN95t /Si?gB_,f33'M<&=e³]\ŵicdYfP^~eST8ڟaYУ;N?["u=ߌuV٣SSVb8>Փ' GS`jbYRH(\b•a#ϩ+MK7n! pfŦͭ= "@xIv['RSiq &YF/KcpT,Rћq%,$ #͟Ү [?!AA̸Hn -6U{828.@ZW ]]t4wFqSf&lB|$Y5MBQ4Jj08*u9 H9V[K9 K;5E(B:^\¶}8Gw)_1&p^ C]&ں:f-~y=  M/NM8{Df )mPeNj Y,ŤDϬ8, UxWٚ"I/2F 5N;5N{k/: B#3t:Yq#NXP0$ԬY:סh@6Hih&ΠS[Zt2h ɀ$3*b~UQ(%><fd%4j;󣂀CUDPA#2 onBJ6w%7bw8yd4pAp+toEqAz\SB"`&DA dZ<2.0i _Pdlh'T(99{SW\^#@o (BqMuc 12HޅRtyN~eAA~dIOl_+7o=EYeekEAs<6P3 3zXt^"Ie |MA.J aW_)y?*u I;y?wsűc(6-$@Ӹo_zǷ hlaDCGQu^> $I"hIB\yN_ϱDAh˞$.l" mݷ}@HEN$B f" g^0Z7*%& UNe]GjN4UEU5r =##ih B4$@FFYWGenxDlh(\2ɳ`Ž? U:j`  xq1?(&Aλj߇PPRΐH0:LT'5N5:SzI&Po ABѲ 6mBQWRY&,S"ԽJ&t/<-MUkTUHI *dj' 4Iֻ~]/PmyUAA,MXz-kfA~*||*o?"\D4W$1UzŁUQZ|_f΀Q֝c ¯UKUeozF%'tm\K%w뿓iu%%ԕNZ.܅K :ŠGBr6$$U%Գu'U57[\" kV^U볾 b~wdF ( >EUٖk~bŦ׷D#ĠaU4?2:Ir[YCBA3;jSU_É~<EQl9Gﮡ]\\k>3~ݻ1v`tw.e+ Wrj쿟~δc׽{kum\e::]%?rq_5|]wsy2Y`tJH Y qôڡy}  …ADNABAFj:4/  *;CyT5JWOY 91jGx !#qQ(,pNөRtf6+{ѨW를[9Κĭ~|h1 W).+HfVOM|rsHkC:%$СmnK֭?9&cM ݓࠠOcv$|xUiHD(,)6Eeefjc/)j35wu #CQWo%Xnuݚātz] j؟FxH3/&2l^VmvEej%>r¢?EI88㻣i$9}ޔ<;= 4k}  ~"$PCUZf oiM 'H|fXfB zU/-a`nGF|<ߵ!!IT`-+G]ח/㝵d ހ` dB/dZӽ=J54M^u 5]n+rIܳYt($n@۹TXRhax>D&SQX~#{d$ hoD]de=гgiŗ,^3&MĠ?w((.FwU()/'6*'POUMV:ɘNrsq?_BB?ϝc;1m8٪{ۭ+U$Iba>:v ]ڷ*Ͽ!߯\ec} AAUU&aCu [W>vS~uMtmߞ\o%ؿ>]zn!Ȇlv8HQYA{1?Vl.ѽcG󪨪bӮ݌2PR2gɺN'?M\kk`EG+5lرiDZ|&+ګ8ͦml,SFlvk$M` Ç2cT66Ǝ!,$ij5[).+#80C{&hdDҾ=Sǎh0yr Q%3m8J+ر?'Niilܱ UӘ0|FJF krx&{1ѵRҏ@yUW>Ve,*ɧόOܛDv^ςcFc6(.+g-`aAͯp0=*&pU؞̝^ޏL}Hn]IܛױAA_];RtPaRcSd * '8T7~|NglqߟF<]7K5 2,c/,Fֻ狀jh+#* DjT~ɪlV $ٵo} 2O>'d1n`c6={O۶Q^UEDX(m7ߡjw?^{})G !'~-lF^#"4^g/d(fwPoRsVoI}@v^Nz'|n%( e6'uN.d7V|]vOhp0俟~Μ˩q۾/lj7f}źm(-/p,<MBNq|&`Cng[t'aVlĮy#&"zkVovm(=KnܹmZ][Km]NE AYe%zm6lIhp05uu9+f/]yǗ6xO\B1|x lbϼ'WŽ}y7-(D4JPUZ*]6n@j:NE̕\QUM;p㎝>bt:yo=c4W?+V"2lKJɷߥN4cie%5uuXm6,])9ZVQ?_;wLu]%s-<]lFGDGD|ϼŗmXO[,˄gw8xYe+Ƈs5)/zYK\t46};;wyֿ|ÏJdXI[RZ^UŜb"oz6ɳOqY9!!lK?_Bk3J z=v>#Y٧|^;wxq1aalݻg5p󖯤0Z:*fLC/L➽L=/,C|Ow'3kbxL>( {SRK ٓkBQUtLJF&aJ`z{D$6E.}zֿ7MIaь8̣s-lٽQ,:v`ټkxw8>lkbUL16Qi΁4c}!ޔn~%5uYƎd[ͷt:v$gAL9)#7<$ۯɆ;|XҲ mAzQ^#$0!>֬廕8r>\ډ IDAT̶(>~!V ^;eUz`֢K9ʱyz2eHf\Oaaձkt7t?fc6g̜<z?^ˍ;wyJ῟~NBߟ NE2v \w٥<+߾k.Wɳ3&Mp|GFh`T^{Qb""0b p:>'(œ˹|XnzGoCn]]oZ:|̓/.pfleh߾XL&,&ڒ7~{znv5i=+.O~Q1ee7 ??b|",]θCNYn;ؙǏC$tJp` [&yg:p@}}=;$&AA߮_}P49 6&z goL, ˦y-M~Fr'`7b@.[A޽̘4>Ҳsl\qɉaw 5;&北G~v<$)ͱS>Ȱ0=?;WơѲa!!MYlZ'%I"*<Ǝihޙ|QzΡNc^M^wYz;=$IL= ;vr48{ded;FRse|`EX,sͥ]wxO>2das{npf 9p8+ MJz&Gp:Q?J̤#XtRۙ:F=A)F&:UUdziF^upقUk8 *{i8NLF#=ѧ[WbcԻW56U' 56v`q(]YAMG+qNjvv+'\Yo4dP/_iddҵC{@޽hLp*]auFEQH᏿^$&g]d{JkKIy99.ܳ:?mhp׵c%f,9pss=5h*I1\=yLs4Mq83/UfK"9Gߣ'w5aϡCl2سnXlٳٮGs{'6*ۯƶ  f;wvU8qAwر= ^%8?r`>6 kFqȑۭHBAsF͝X^[xJӉ^v.I2~eI LΦ=%I"qOR¢2C@Z8v+f<>g}Dҗ!^`M:p={-,M\M?~ݻ7Y⇟T|<[g'qC{->?V+6o`Z%%WUa6=OV^'^ETx8As0b8߯Z͡L,dfcDQPRBYk ںz}_2cEGӭC΃i5 @F"BCYׯ{7Ov{$ɫDnՊngC^$tnP6%~ xv7#;Em!餲7sj%X mͻb1˽b=ze/y~i(/yl;v>( !&X4kux=6 ՓiȲL0҅Xٹ'O?&ҭk s.XAg#s#qoGc1p* NEhH;;%L#fz${0__:vqqҥӯKhyά'UqԻ=i99HMg=lرWک\;u WNiiOMc[yn^}'rq[үGwfND8b""O4ٶ5`40su cյ;|=+IܳIPAANǿ;68RSebS"8( tTA9_?=FM]A&'Lkcxw鴋psgjBIa%:m$˴ ?H\8m1__&iO|L4qg$2<蔐>{[ܻ7ΜN &1e^*R㚙\:zb2ovzlv맪Ijvɇx2tʡ e0wOpgddrL;N &cܻ:̷KRVY#&%#kYna!U5GGh_=,ddl֖&5+۫CcSsCy[ҧ1[NMt)jj눏w ({ǎ\;u >7,&G|Ï{隸Ӕn! Kld$S9c; F=#dhde{߭69G߯KZghp8#k}8guLo4VEQ}_2b21?k[XIz*]%U'\;eˆaǞg X<|.Ogfiq i8߶/EQ5y#gߑTjj~sAA~{.]Uۨvpb1dTP~ kSch2޼~0gvzNE9bAsakJ=[_Fݥ4MpEzbVٌ`&>BMmc4͆klٛ䳿ti qEUY9NdP[#(B~Q1ϞKqy'z멃}a!Q.7?޲f9{PL&n@%tfMfK";cyg.5:a`E^a̙KiE'ۧ[Wgx&֕J0݃.bדúmٚ+l21W/6I.D< #!lItRTZGsJn=hǬ9vEQؼ{vb^<DŽ-,仕lT0{2B$,8ZPR^ \jlG gM܊餰'*<=;glڹWM}s[f^c{d|&mێSQlMڇA' fjf6̒lЭCbc`\ KK4|BwaCyQY]MUM-;ګKg]|4M#q^:N8r8$kU|vugHG^2lv;s.l?ĽI(BƎXL&/K=Ζ{ d@%G)]}4O1;vg/pqf-mOѺe:m܏4=FAAZ+16ʼnMqӞ=gw|[vggr~me  UӨڲU&]5,wMC\2G>}hAf3^61]3#}.#SSE,aut =>tz~rMt}v!b%ytJhN$v^b_dYF't@-3>YQU^]:nb67 '&eنz>z&]sd^9z[gL磹xxǨ7p d:YHi&l2T| X0N+`@IY Xз\1QTZZ,̘3'ݙ&Vp0-뚗Nl4btgԉo?CUU⢣"IG qo5-­3}GpP ]ڵ#l?`ĉ\:f:wMj4rNjKbbXs<ת`hRQs]L/a]dIj% Ҋ R22q*'ݛ#Gw hFp`nfKhDQ]=Gϻvěof+QQ]׋D\t4 |PeW<2\5:s clqgVwО&NϷ_|㯽,HI<}2*x/=]ڷo9qM^^L&o7,ӿGw}>Dҡf6Kƒ99T6hotr(#C _n;rstK-?_O3ml ?mODAA~]$ ' 40`6Sn]2g6&AA8_*jۈhsu5}=cͮ K*[z9Y IHzwQT]3{O wBｩ(VĂ  ~6T, "(*E@!^{O6[#’B A޹sgvv;gιRO/BdppnbfEd$tjXPVE!.9b@ e2sHۋ@e]qqBUbnaX(lrsiQ\ׂ|$@dhñ|3wf}uN~>ix{x8a9$I4n?#;,掬Stw'$Dɸx\] `mۙpLx)wi)$15^GDpSश)BBJ y%9=_fq񸻺V8gu9@sYQS(4iAb+( >%`?|<+ T\ z(;@f#Wf_smW&;/ԌL :m( i@٤dR{&PPd$407rmʞ ^wI)!%"Bpwu-xfN)xyxZ`Nfv6ef`i;S}74,\ B׊?ku|tB"f`\Vn.xDՅ;J_޳o˛RA\pMWd2}q b`AI6c!^=B-X{٪Q1gNҩ%0փ6)lV *5a.՟{P-u2$I4 ~5?_%IIe4j5"+Hy{_r6A>zyGEbZYm;-4vs*r<nnNA fe6ҹMK㊇[e:$I"׼Vqd֔AIq޾S{77Z5.:-/b\r2es5V(d$ ĺ z.\r* zyUw_ -p*>cg2jc5Dh^gc\fxzVAA+7x(m#0kz&'!!.<AAᚕUX^ŠvB 7Ks] ?f.[F~FA3vn+ [RI**DѠ.j ͽ.)M-ΗkՍQZձ._k1w?j_}Geޞ=~ jT[%Fdj5 53gNѱisݫWIGQUiG5P+dt.h)[vbO&#;OGE]tήMFvGNeFxAm9;}LTxx2-Ĩ  7uvnSY-X{qU*tZ-y9{"yAkn'-/?7Lp.kt>ao֫]Qؐtt* !tk,˴jܨqYձC}CY^tiۦ!  9r59EQ(Z3`N$Az~n}EAj(`p{8j:Y^uUݻUNƢ3'ّ ZMߠ|t6/^AAAAP6+V bUs3_THzAn5^A6H w͆r~2J*,`cdqhQI.nm%;)#ك    6NłڹI+ . EQHj$h $ёc)8VeeF*z=:YFDG@d Rxht9#   PoxQ0/Ȓf)y9ؕ/3@Afn'G̱[*5.*M}8^ظYG_XZiZ9 FAWNKtb4voaނ+8s:!l]v^.ŏ?7''\ҳ[e>vVFc68-[%   fZvfl,IxRh4IZuWyAj+IŠ!2눻FUc,q92 ؚDzI5c1ן{+!henu\ZҩNQ׊ IDATk߮AAA2W$:Pd`ݺגr.M&s2rq*. W5UO~_7<5MzF,`WF9ʞDN栨5xHPsϹZxj7ob}(”ٿƄEwggugq߸dr oAAAA(SBN,Jj^ӡQ7+6↛ . WEQ+6]TN!JUO4,j%!3< 5kNO~nnkPB"*IGkrK֮[v;}2j4ddrV2.4 IRj,i:lghumHTx8"V9ƼɠXqgAZm,Y\"B__ sٓ'Oq aP9oXXj5psu_N4mX2&[ݩ#gugϠ/={HDV<*>;*}s8JE6n$7`{{Ql6ӺIc}|8țO<{`XEEa=neu{O$#'>::O`Y6ooN>yVҶ Zr;aٲwl 4!=c   ¥9V VBR^%tr a  Tf#Y p$[0YR|@7nB-Ь.4 Z k}2X/@Q8^sbNӓS >Kv<^t2[ZͼV2ePZ"r;pd)NAZflܹ;S>,Z.vnNޝ-iix{z7~9'/(:Ylw77>;SaCYҲ[/O>lbRlb}90sB~oG{|t*5>,^q) ~4}upQ(*|aCxgj so 2.,^§?Xa}Gbf;/"15oOvO>sJl71k":nUxLf33-`hwMP1Δh1o9r;O~}4j5t?aZѨ/5oopn,.&+7 vlvNcXe  ލ^Z-++|scki`3յu$&_X~}*ves1͎}:wr:X+2=1iդ1aDlAtǂ   YL 'K:䢈(vv; ]*ʶ^*YF#ܐ \{$$d*ZrѡUYz, 5#/fv:WˎC~aaEa}8pTR32ֵ};7#NON.iZJ[YY nsdhmB4-9R33xiҧNmv;6"jdl6lñ$^_.XeVuZ_=݈ON!ח6M0g*AAA]Q(*h]$ Jbާzd4Zq\A*Uj| UvcNVZy}twQap,ϯܲEװ`*^= ؙ3|2ܜr]۶ {]bhIOe0N 3ybiݲ6n..UnC 2}LC׋_f?پ#A d],Yީ]U\ lv;f\ 4m؀{IE?:jKuh5J3.F"I/?:s<ݰNp/-?{CNiħtA{F͚Vfզ-۲6wgYvC-ݺ%]?ilT\rԙZrs`tZsQצnn`_$jo855OOF5dʏiyhDi^8Ի;w-t坫K}R9Fmԫfl<0*d?pPjn'bAeSJqSSAJȒFրZsM-h xkuV=,cX s3[ݾ)Vf۾ԑ eFRd,vjFFظ{;rXWK2bOrZ{$.S6'8z ZM_BȲtR3[a"}i@6l@Qqq5<'EQ)LU==:9/+wanvNB^T!$Rd4:M&ƾ5]]d݀q*8vVI׊efdҴaCn2I/=Aѣ5SAvunKfM.ym[ӸaDjπte^<8V~s[+ʀpq1h֡MK4)_MId6ÒUk1L9 ^zG zu̒,3g7|ѺvEj[ώsZӱm+N%%I ϖ]{ز{n.ҳ|9 +TeĐWzn..q#MCZV VtB>p:޺\_պ`ֽ};.oEX6FFVnXP M4`xф{~ˀn~qdl ;waZ09LHxp7nbOa?p.Am-Z /'q&>7'}^) /Kq׸g/31^Yn;{GYj-1GWǿMP?weBYr m1|'(ݺ׹iHJ?#|o|o#Bwߞl6ދjzLӾ:>|?~1"c ծFWsbl*VlbW\4Z1/ pjtZ5& dN躚Pt*5\wwL˺z֛2W&|5*YfӦiS389l(fdPxqvNu,e1$gOgț_|^׿n]QTYm}!tw类K6ezc9Kgp4iFS9?ƣoN@e\ n<\)(**9V;>}߽|,^h -m!9NoXP/]NأCBRJY(|=={ $,8\CafЦ%,3b@v?Hqu1ТQ{ucރ Ս;8mJVYjjK1[%*n֔mΝslsMC@ )unՂ^]K;?[;=г BPNvkEFxsl<#ӝ}bYq G1o/dYf]ʉ; KHPڸkP*")TQ fܢej9/ \ 5mjƌs>b݆n~NdIB+**5R=&EzV6>/d6,4 E%$SPTD$I"-3K?D֟͝4c&/yN#!5ܼ|M^A)zz:JT($_XHp?^/8~,OdQT\L|r2z`$I".)EQhrIc9DðP {\,xTahmXIHDRxɥRS/($߯F%P 'qsqqd n'8P \NeXpwP} BwWW~0ov!χMٴŒOǾX9ﾃGC/,kt;<ͳolF$& -5aC_XHƍxOٶw?E&ۛe5|;Dm~dYkt;ⓒ(>=yfgfr6) _.l޵换ضg?~>tnߖNg?k|ؗ7~[ƌ02닏Iw?Qp~r=G\B cbCdҭC;R3xױX݇0[,%e7.f-vPpB#ot 3vubb+(kt;:3oɌ;?}Օ.۲j{gtZ%8NZrڷjΖ{i(f"y =J/?|EE:vȰPG5dk8[ s52Bt߮lM7ZA04T% bbcUJٕ@bI%PI2*IF-hd|>> i4i\^l@JW];m5uj~."CCkiXEN77Z5vQTWcq1+6o~}E5#Bk45<,h5Q/k@kZ4y w߁;<9<>zO=4wkՐGScɪuDEçsa^^]:ұmk|UNC%|tsBwlӚ.f߰ڷlN˦y8tuvr82}c_~"Fpm#WwsɃn IL.ɚޡ=?6,@Q6Ek8KcFΘn| |9 23ٹ ;dǾWcJ=u#橇F2?hۢ)~8۰/戣Cywr̓eڶhG_Ocъ5w^x@??K?3ob7+\/ ` 4҉)?̮K?/+A:Jjԃl+d"ocd|3kn.9|S~/<=yXy+o?$ޞd<ǃd]5QT|ܕUNYqIR\R/UZFtnhg&GiX,3ˏ۽#@x5lwGS| 1k"膧;<2uU IDAT으}{_|nިA8c_~CG!I?N]:rϓ/Va̩tnأ IKfdYbѿGk*@(ԍjv;Vs UvŮf؈FV! 2% Y*4j:,)/$V]]Aޙ &FJkҠ}:u%YuuzyPAAC=:u`U qm#Цmpj߽S4i x6C홽`1{d8׭k=;E;eX1g.v{5CN0)(- /-m0+ۭ( +7lq~6!Gplw՟c[\;d;(D5h@XP )ټs/V>];hh߲9/+Ѩi߲NoE*.K`{Ǘbeӵ'^P9W6BM4mACh]^ddg9e޴c];gEz+7lv_eYBӡjeQ6%=q(MH"7/t(}?INMG_zS]ө]kދݮ0k|,j6VsݏjnfCKh7 c@]fcXlXl%x*$!IH fcEncٰlHAŠӉp `쨑Vw-ijAJQҫ(E%Ãpwse;-#$ȡ#ǝOHJ.WJF[V@F ˆ vWTT\|; \q}+x{8Yz= ERqYcq14%-ivsfSҪܗ& bLfV0督/UjcI+2=4jQ:RZ{gMfvZп{4W}"w(^?ˋkvLz%rrs0u[vv%\E&"b̈́L7~XӲcq8GnYnłbjc0hhUT VA.3Ef5<.w ZoW  >vʍ[ؽ|%1%2FBJSg)\rf8_R\h6;_OݎOzMw|&NcXդ|1c9doUNQp.xΫ{sЦ%۶a@n1|MKٌFSf-Fv.eXF[~~dkghtTmצySޚ%ʉO%*"n55>N+X|%S66 G[/L0.Kps1T٧M\vvʒUkܶ5}4u8GSsĩ ?XZ[smϛTZ]ܫT*$YRAfgu޼ =C**2霎6/Zf1,X?Yɳq=~exljFBrjfsIÇXr-t|"|s5"~=ҽc{waٚ 7շpG͊Q/ɪ7}_D7mB%e;}L&JN/2A+Jtj :/+6S1Yd⊻/_   \=lv;Iii$٩;F 'dzvޘXrLfiS|R2M"m(\_~@8ū~X4^kQ{͆rzna(knglso~_Mb@n| Lf3-4bzoA֭xIHNMNK\bL|J ѭZ8-* BFVv5tn׆[;ϧjɮ`VM΃Ͽ ;c|R2~>X>wYzm`羃(S>`#1g^c޴cW\lmn&m{U>1%ĔʏD>½ [^\Xcq19liٸ*Y06ڃfҨA8}uMfsy1-DΘ^'Ir}xb=~\R2}vbX[ &;s,_Nw<^{ufn$$2gߌfƌ}"T"8X3^~6?ج`Z $AAze< .DJvQ9Y/DAAAm%]ɔz=/>㔭TfmC-ܻύ}ȑٶl&Z6m #o|nx\A&t\z I /'AA˟^%VGN~}8 GRj:~5>9Xly [;~'E{2+eѕ?g|Mfv>|?g-6/WǢ2/>>̉gyXqsvϾO<Š_ 7?//v?%%"gB9CspᣎE+VѴQ$o?$Ϗ}"ޘ%mr4o͘QQ9v[w^qxy|jICŊF&;7Ϧd9y660;dXVmʠ=9_Kϰqs10u֯;}1fY#95 Z͜?clٽvv-۹c0+UZ;X>yeEf!2KV)̥Ax_KMr̳Έ!33|}bDzzVβo?}>+~bNųl&<u;>9ªM[سgi9KϿ浧r~x˂lV| ,1"cZ9 ԃi 5Osҵ}[~S2ps#7.R W$w"X;GWΙ2A+dF"?]T@iS6fKu>AAkݩT{N|!TKðP"c'0ΉUw77ڶhıSgHtR IdqG6$!*,NҴQ$aA$q) z=](-ݪ,sirU&/9{Ծ5w{Nxh0VO]:wcq# IdC/`ULvml۽9ׯG}q<GFVv_](;R8rz9sՕ-!I2O&5#qoOwZ5ms(cq1m7ݝͻ8Rh٤>dsD +\^E{QUA+ y9v=QUck  \Y"@xuyuä@%M `SJ~ڝB~FqR@)`) YP URIRL7TQ#k<'Δ;)kωq|8{>}E#+7FS֎1<*6:xwߩq.&-3C#_x r!/w7k8q6ek7RRVnϳdN]Kєznc~o7yўŠ9~Kz'&pyxGvcS22r:wb`n\ɂe+-ֹ GE|[쿣?7e_`ޔ;ڮE(2DRVqG [kk dJD2n@##/*_s'X)L}- {/*ΎG@ӱpZUUģcFѡuJ%֬`)ȤRƒ¾),)A!6<Wo߉;vRU$ϗ -8xZ|omtsFdT( f89ZZU5+lRfתqwqf@DblIy9Vea8:|55lfmW``\-)aD>Çӓa{BJż׮-۷c5ϣ,_bWZ gM@yB߉ʜy4 G•;җ x_ޑ2>ޞ߶GǸn Ӌ/A"0Sal(r Y tm-[;1}=.N5V!tl߆7nEޱ29XnSꇇ3ipޙ >= ~NL S@r V(PlyUkvbԪTtl{;o~@X&Q*1ZoARIڥt~֑1geDH`YYG2sjt(K M5J%yW@ӑz5J%"[|~ ֠VZFr!3HI=ɗ~A0i0bXy ɇ&PUj -g/_fH$%vn|\4]s0/k׳x‚կ55|d6'ȽzkUU<ʧ~ÃGՅo/1Sռ7jF+RROtE!ѡuN$,0W''M{pZZ}ndž=z}B޾UvYJ%|=yWFi{y1_@_̶۶e18oo[DTVW3堩ᓧHI=ɞLe k++r^ec|W3qPjjU̚sISfl**kOs߱|x ><q}]os;3~o/1vIlT$"E ڰDZ[ѣSGwʩ y4g 8vi1#$*kUDY[}fnfߙOhm\&mx~^։mhJ|p+o[ҊȬ5;vrY:ř:1mxΎ|nZÛGL|~&G û韔Hxh0/!6ߘhtOuw%%]~}Q!y7!7Ax!#@~b1kvd 7 ds!#L*Er)+&A(:2<*<]]ȤRv:w-5 ɤ89RZ^D"z <=).+?Ĺ4]N'*4ImG;>BK!SFÚ;xbxè_|Fv^NK؛^!9;S\VÙ Ņ@Хc,˷=|[ܔM핕_Wb:ho=^ql\BY[=!A7% ڠGg,u(I/773 mZsE.ee3>݇SP\œ_͹N(ssvji-ZU5^IG-ѬFE0ehN=lטܫWKzzQtO\jJO~\aɻy1?ҍhƐ=}V0~`VnƋL{[[څ@ }$pEB6Ǟn$taݶ]fLId OwWKشs)D°~  uvQXTlz_.1wBP4;r' ( S٥C R=H%+ W2ْ1߭qXm'#ƚWZKfUU,_?o/Sٰ9v 9(rC3ذ#sAUV*WGGRϥ1=+`f9[}<ZSOsI&bމ Dϲ;)7Q!8zQ+ڲow7gؾ7lFh?z$bkkCFfwa$Z= I@uQ bpP]bߡf AzGMGA\^s(uֲ5GG{r Y}* '(Pכ'OD"GB'"C&M;P~#=;vvJTUU~G29y8;92W:"8~:uzO.Mމ ;AD+ r^] J 37MvS]$χnqԫGN&*}weӮ=LLhP_/^qR:=i;rODHlرα, OG z?]@@@@@ JhuI0;ϗ~5ˏ+3IqnM67Ifcmͅ+ zB"3O/=GFn^aѺ:~"_eD7ﾅJBFmxջj刟b/ݬlڸئ s?x :ŌL?al(:2;wqJzl##8%YٔWPZQBAdH02GEe%Ǎ)1ЃC;^ښW8o,tY0-NXأ6FBljjkDRd|ށ*.gH DŴgdN'C g c&@.Xnc?bq)+f?v<0>YygҧgMtlbn~7Coz(uj뮗bz/efbb[GpS1yyt:6D"=:P T5zte:imC0>]cp\۷#+/bsdףL*l`mՌ8Wrry&E(U*v1${v3 \{Vl?ՒRbZG+p%?2rxaDr "(*-#6V(+25:V":*DGFEGsmތV*ttz󉹰@8ީH$W|}DB&9>  $=+I]T/ 8}"*$8֝1 qTȪHbǫ~~OR&D"ӓczh`<v1a|>oY9yW@zf1a0&*9ymf2b<èK\ʊo>z?/сfU|7Z2uXLf2)x67NTJJy2g|ʪ*|yyֿ7{㔝\&⧥+65fu_>>9e2]8~ [|GttUV-qP(\ʵj>8ݻ271 D C^a!ӯC#,Y $FsiĈ1{Ya0hΓA.ߡ=Qa8p^n<+uvЯ{"o3-Jcy``|=n@K$?Fd텕BaBf'`mcѓg b9lߛBO=N"$0ٸs766ּcdfRZ^Nxޟ<(,*1z&=7oGAQ9?9v% jj&J`}LjJ|==y ""8+2ٙX)$PZQBm{0X:!3s~L E|Dr,ؗ_xww:=׭s' KP*kyb̐î9)G`+oqell荗ٜW2@x'%h#HD"t$= N]fBAqY.\DRVtgdкU(2^w-ec pqivlsjU-;J.[ѤnEb H`VC]]C`0k,k- k_Dѐv "<[ e_ɸz z*bXe;9T\Q8Vً|yL)VE.4**+ݘOXM۷DjmgC9mm}=drBLFǶm8p"ۑz \|+(*f xZow7qGvmbњuDGF LCץۭ?%崏Ӄ3/jc6:9qe26D_DsQx⑈fq?n_)cGkmڼ,^S]sFǮ{[[rܩ'KZ5BqyNb]d!J Azb0lT*lrs#};v9ʀ UH%⢯[0W^j]6yWkz 9~_ud6™yGV̯/##{(F #ׇG^z+FؑL{~6%c}L8nqٜذ~N=y |b@Os>b|SEX,&<$S,e^:1~}2g8z8>Cۋ ϾLaQ1rvz"߳zKÑӼ;<((*bx3Ly| tK=~}}}o c)OQX\;1;w7s}ع d&}oGrN'o>FJϮy_ewݘ|3MޗJ,-wqt$dsd07N^cۖzcf6,兯'lIKmm-!>)(R1u oB.an΄p)#_ ~0zYW裖1HEb\T55 dX$ied*ķkUm)T7r6KL4_,ZT%vmRGsqviS E"0J'XI(,)Ogm<0dRYSE L:#j>>Z1&*/ A$&g.]B.>"E:iKq^LVu-2hZyIF$qjh|x ՌעhdH0EElܳmʤڶì2ZMnA!aAz~[%tL-HmO N1#|)(*ҕL:bߡxaͶ[O\dsn c7;.߹cZ1W` ۛ 5MȤg/h ۨU^t=HDʉT'0io/N`ʳp'(ڶd/ژ*0iPZod;:;;wmֱ^ugʉT|#Ȭ >Cx# Jrs 6*MT՚6BYf2qCqR(3_?/^Ozvm).k~2zFm씉X[c0޹#~ޞH$~o6\]6/f|r* zΧgp>=KV`cmMϮyjCzs&?goO '/IEťfFjݻ9=ބ#KnccmM[y+V4)rw'q^d6w%;t1 O  j]`oqrtXlѹ@*;+ ~18SQYz {t"gsvEղ16'I=CGٴsw _ygOѓgٰ3f"Kuz=v2Ϭ IDATLy460g'`ʟ}+43ߘR֫QT7jts#  Ǜaf Yl" A F,r} }aX^ؼ7sIjJJD2O$LΘ)d4X6ZWZ׭\MKe+DhQw9^9& Hm4 " 7Yxx~׋9d6:DQ7CC'ל/ !;/’ ݐI9r|^GX[)4>ݺin3!AW_EFtVtl{]\ԝϲ+ XYIxгk\v,]nB){?7@NCNlؽQYf-!~x{o>]I9J/NLё.1~#":Vԃ7|K;!+99$>7mL*%mEdHEPG;;lmu0j? rsX6dX^?~˖OһKt›n5w>c@׳dFr9,Cˢx#, y׉hBBl4:w`;1[T>*y# bqQr;cIX,FհssF^ܤQs97tSx'I={՛jJ6lOFg h" & ,|iϊ[ث=p?TԻ4j52YSW9Z5Js{#chϲu".gȡJgզmhu+];usL;^yj[yﳯnR;ێ?I<;M=s"c=Gt(:ǴgBgF { gާpEǥ,rزw'L~^fRU]MRB' KV(wxz1#7I9ֽMuU5Kk>Ҳu ^zwM৥+Z^`@gУ1WOE"T,F"#%HE-6WB y8ۙrYgt~ز>9|D"?h #l%r"E}m+euAL7RZ^5>@Rq!#oo:wrYhF ߙKYY=r<bIuyW?WWvmZ1*Kl UUĶ2ٱMk$`:c-\ô_6ȩп[W4bN-3O=<%kQPTX$b;u^M9?rpy :2r@lw:ښa0ssv[\'JJ4 )|F.gf" eX>ogGZb٦ֆa>L1,4YoZuPS?I(W Gg{b1Mܥ+xYXY18OȜ E4Zf~n}=lreR)Sǎam\d°zn؄3<ʲMMfX$b͎n= كڕJ$OJV~>u\!kx !|ðV=lqqrB5{]\hFsƑm,Z֟[Kva~^^fybr+yxDXDB0`gkmM04Z-WKJi0P(x6?aoKQ+Ӧs5%}}<iv6'1o[;:^xx"kuDccedG^{1l &+aaߏ75x3yp:͆xivz5YkmmE031ڶamgg괩|~#۽ IqLmf2&3{?JEסZQWVgE,!KP%(RB AA>}MD"tOd@DTj5bĪSm5.DMbqn;ЭcTjiG&qurWfձD,q3uzi]C1FܬL$1aP:]6GsE&2yp&Rjvh:T6a T*r9"㚌o/jU*SUC7.8cFX,l›=ZA"7cڶ&mfpv92O/ ⾍dׇWzVLn/fʊ>NWzrjka;Og;䉦052SO"M6h|DjWpڅ_%6,9oJF.}N3I_5iظ#3i0Tjlb4TQKkƘ9ۛȠ`R; ym\D> 7V1^7۱V(̶ӓQRUӼgh?fJA& 6F4vmhviok'h XB*QL5gPf Ϙ͞ёL>e)͏'RRڴ5Z gcfKbzh鵛_f׻ݠ5tf](rydҵc,A~<`ogGXH 9Woв93ҧ'v$cPSh5>tTo}u^}TQ:esUH敧sgM|K<} ZGAU1ѭ#>NM#;u]{xi$veߑzs:XE\`:Eeh^T\v佌؏eD" Nl޽-X3WSxoWTVW6"7yWYʊXe{Rx`}xǓsJ FIY5yn$ 8~,QjJL0FߛNϩ Ow4gie@pk+\)*-Ɔ~ ߢP|3vMߤFd7ʪj g'Zqdp"̌ǧHάok/|Ms( ?^RA @NKN k eF/n$>[:.X|C[A,&oAAON78E ' ,-4jȥ N9#GH$@x+I%( : :fH$nW"#CΕ\^Ee>rsӺF|{-I$[ݚmwHgdDMUKi. Wqr:g3y\Yu'}h s{?|Eiy9\-.Ͽiq?w&*4ןygLZ@Y[۟~AY5S*yk3l\55898roOG?1b`_4-2#?4|WJ`kUL41 |h)?6\fmL3_{>}͋~HQq :>~.s7W$3ODzuxmw7yIϿ"X ED5BRa)X2k[ERUfַT$V*Z"huTaP`٪Mj-{xD SYc7mE,3|@_JCjL$F! >_Ŏ)HRTj5mZCqKP?,Ksqgz(Z[%7pMۂZ"atwJv.WԑdhEetdx+yy*$JC4ol kk"ʤgf[(A.&NTVUGaqSKz0 xG˄3H3rzy*(RϦݞZg:.NN `0p:oB.}Hdf E$U5]ڋh55tf۳#U6VV\ ÃtE In .SXT;<{ݝdr9}gbPԝSi(-/'ׇ ?>^Nnaaӷ9{߯_`ĐO^ [ RPi3Y\q{7`"U(8鍕ݥ e,kj5|eDMu j##M6RT&C$ain@z6=EO?ж42BX=-T(*Rϔ5 Q172X$9\\?iS#.riykk^ⵕ_t?]pe?_ o寿;obeaww'%jjxig,:>>]\+>mݙ3qB޶gΦWV䵧SwݹL e` 0`ߏA R)IP>`qPVYXBHlD6m5je2 N$PV؉f;~7>7poT}^z(g"lZJ*s_֨>eaj;3d|@mKNe%EnU%6ffћyAGA@DSSW@DBjV~>>z| Y..[ёyI&S+^O`wXNw׮w_VQsXjV-g_}GL3/i_u0cr[S+'{{["B/+HhJV"Az)==y)%F_[ϦWcP*J$%Vt|`b#1(7֨JwZED"l{ʵbokٳeevI 0`?/ W. qXRqzkשԊ@$ryy~R  d|Mݝ{șr8aul~2ya<&5%:u #W(P|j6cϐRgng2g?ݮ5FAj/F%A(|D QTD7JZ}ǁvJJ`ZFP5D*ajb7-0CƩT&* =N(T*{ږ{^%W(A̒D{F\LJa"A>0Oïo=聵gin=2w d꨿&H€ 0` @G ?\s&:k,<S;P`jDoinN]}=srOINܖT&#[leTVж"[ R#eD[SXR5\:qLq8})ʪޟJE~q12Nvvzs qvofV)*+CR/ţ &90T8s9F{ѬcӶ-ƻ{#~ݻئ\.z 7g;LIǤ^]`c9*yEr\J"7gfDRQTZ\!`elk <9d"8|(NBU:XRbu=}O1*STTW5xi;ATJ/O||j5Yy T135et;/./E IDATǍ!dݨ8vEPPR1A;ɴq 8۵ Zͩ PTt9pmÁ'9@Jf_,´E%\IXL̙2 EXBO77&I]/'hz) fLaB;?qg\N$ݦ[kkɈ:۾j.,z, ̺m;)Djjkj5g.\ܥXjjps`l|nܵ{w ד055aܰ!tCGښiWX.&P\V 9~, FZ:J69xbfM/lӁ'p\3C7ZJ X3WO|Wa 2O@VEnJ$G'c##|y3+d<:U.^Xykkhw}}>9sdʰO<4zFb15uuk3Cqbffư0l("u[XDEu5uu<;oh-+:MQivwJ7@ uI>"#W?3zj^Ҳ9q"}fΥ96Z>\Sc9v1Wo(k C6Hw@#W4n_o& H$=^WT;^VTabP^UG?&V VVt򤰤vpˎ#XYhjۥeeNUIZ)(LƮp:,,H!pU[Q\VF.quv"&`*ɨH8}.\ZMjfly_/֭')5 {[[R/qi @TR'P'?%Ru 2!˩HHJMS`$vo׭l&R$;O$PTo;퟊{(,)gGGr e6.iZMHȼ? uqtf$$ )5kK #KsSf>~mǓ)cGho/qJKd~ݾHĜptgî|Z=2g$T*5?o.]o;vʼn!cڷ1Wa:z{`k5022"+/kzںg#ܧǎ!\D8=s]:3oD:uqJԦXYq*ߒosr @6VF_<<~, ڭVo!~.5;vɑcFcanWmkg<F7i"va=s򅄫|v=<4z$>l9tGC5DzC{,,pVt5׭ޞ!/;vqIОlDDT4AL>t¦8NxG;{jjxUdd2aPH|r2Z-رľ'u^:u̐qX[r\d >Y 94P㴡VrThug ׇcYCoh3m;ZtVA{Od/ИQ4 WuW3ٱKmm|zAk#{!*v vܜr7)5p.&[)umCEU5RiOO-hɬXY~sf7ݻIVm:&7ZkR?t0SG$#'/1WQ\V1ثOa}%~&!C1n 2~i '"*6o%SF \MQi)hpVhߋ!I ':.(F f`ⓒHEJ+];l,-qY~ظ;C٥3ǍA ix߼F''fO 8٘+O^8]mjZ߮\bgb<}53EV AҩC{҉/Fb1o=E~@um-3Ǝ2J%nF;uKssvg|Fb|;>ݻq.:ڶiWbfj#,2`@RK/ӃcXmEEKzY]};lS ^tU5oϲO"S(x֑w[wvVyl4 Ro#37s<ZTTʦc##e HIcd<Lf0O/(+R\6fU*~9<ݸu[wp#"\9MF )Qլ߱ O@ʢpٙyMj.y?]USô c~=Il֔}pl>DTJ鳌6w{i"ܻlGoofN@[wWZ%z2qLMfoUVHQI)bC35uuHw׮\JHVRϨz;'  }J܍$Ayu5&g DJF&YYwѹf\N&XG[u20u-({?ϟ+f 8(=u;:"BiySGSvAYzs㵧@$1"?ff=ɤܻ'_ݝa 1?z}zceaވ2޼2w/+-;5F`E1"&;~Z} c_q6 chND¾̛4 l}zR*q4~)ҊgAP!yt#,RxU,پV۵ 0n@a=xw@f^ei&V  T>T{~8gKP*e^=v( 9:.A{6'(Jv1v@{bٗpr ۱3,owwXpz͆ML5vzVFK{ ʽ ag#=+8|Js*&&&8ʓ3Q\V-K h꥟ Pȶ+.+׻vK~ơSgxK?*+k++ߴR)׳B`7??\/KA #P]JK8 27o>Z]a$$Ζg``Dg^&t$w-$=3ִXo%Z26nb(J?aV]A/޼@x!&/L|yd 9ixzw]JFc`@WTū llçbnf>J9JBV2O/A%-<\]ݥ3Io ѝK|u~{z^;xz2ypb" ֶ#L=JDj&A416ѩiA8Evvd ]k3hffL9\'PXZ6M,3o_vGe5 5p;7W(-*kz&A416f적xWTѳZlwޤ%\8¾573iSiHڕϗw735`w!zjgϣ_n ՓѶKmhυ.s33& 5Q Ǥo̟K#+?_/cӰ4̌Qqqpd(YӥcG073c@@N] kX0e[) LIAckqԔqwv!#7hT*e۵oI uA>JmxrC8rL$RxoGolBm;(l8OVLD $)-KWybƴ<<~,9í$޼ \p} f[yS3С=hZDo70 ###,p!Wȩ&P̨yM&M' :t k >ZEJf_Tʯܙn~ -^ vƅ^ݻrJzaPNxjŀ~=9~R32S}MDxJ+({11NW_o&cҧh10i7UedRZ^Jb!Kc'Z[[b0Z+0R 4z0M"TT֖~C^}1aZyUngPPRܪ vbU \bU2#3BJ' aʨc@}sXzaCZ753ܼf֯޹0r@0GΜ%;;[Q]MqY9;vyz '=' 33=AԄ=+ *#'~8жM:z{-\G|p:W''bYai)م N )YYY8ϻb#Y1ff([9162bL>;2G𝔝T&ÿ]{{sJ,U55Xk{ҫg:G& IFn.yEż`~~QUS^ףH$g~dd2_u<\Dff ffZ[qTJ%=:w"};!(%R۽^1з[WD"nz(DZԭmmiwZ[Z#l v A/R._MDV|vA^mܖA(YE"yzcv>= wG[oD 0` ?j5{Z͏GsE\xt(, 5?{*+M斈*x~?yJw䍇nq}5 )&>[W_OH CzVR]B[k+v}PS,~#apxa˕XYXP*y債+k]#g̢m6ܱ7iBtO>Τg_uPͰ}c2_~GN`̇yiJX8}n=C} Y'2Bs&{?JBRq)lxOO TTbaD"Ĩ\$|LZ[ ѺQF>/k'~Z%nW\^Ӧ2y0llrsk+zm& Di/0񶐅|ͺ /]%/ RTg{2r77 6V+a`3ŗ-yzt--yEtYO |Gqqt۔Yk N6:5F(&61MYTJRz:?Z|ڶ*/ /EAlx¹qcVVY0z,,rwVFGHWfdsKvZ͊5݊oBᭌ -ڷ.Z+!fbrztrZAsvp1˸gme)\f)ȨXܲYSۘ34&֕ڇ(* Ԁ;&O L$U՜ts.cjj¤#?y]`gןe]^ўR+&XԤuw_SSNw~_ijnÜv5m]]1n )M~ʪ*Ϩt䈑=`krvh<) VFj/w;)fTpvR)zlu:Gør:UU88`Sa'>k8FRZ2W}DŽlx7u iA0jlJDByE%vv;E֮BOڱT9%ݔK EEs,yXXӾzJqRMYO-i'{{^IvE;2chڷ=>ZI}֖x5zO۶B. +lFֳ?~O6[ X[Q~ںZ7mj5a8y"EXYZ\wkv8:p9Q#JervsUJ+p׫@}Ў5Jū}tB>%"*sXYXз{7fMb wҒJ򖳯b.NN wɑJ^Dqr^*R cll#%H,;kJJkbkc%e-073’2]{[LML[mV1 IDAT3SKKt111NOзʒV # Rz=Uj5O6:ew93Njnp$&{xe:t`B> oǎU\,w:*",q"aRH=xj@L> !C סSg80uv £[+mt_~s - ^nl{P5}X8scbl̚ߧT;(0Ou&{Ą9Bl4a?p-%J-*%t7X=hea(my6.EfTW ַbJcv@8w/Q(jCGKAbpT  ;X?#GL=G;;&"LD<9} &[XW|9W޸ȨK!~?x#G꽷116F. kNlinλ.fڒ@[_BB"#cIɡB3{=Iސ{=@a@+frnum^};}-={Fﷰs||b6UX=@D"\4%H><֫/oaVx!# g)J.&h5|\} ۏG`16NNy zHHȨYЃFW ܯ BKj$ZqC1j@2HW)+d_h{4f:5om𧼪Z- NWTjO_i*5goXdrjjkBxY{d{oO̸seu ߮@.ypsqF$w]N"ڲeF{u]:`u Lsi텉1r|J #ѝ߅mipnaffu ^õ "?nEޔ [)v ikw!%#sr6 wkj5C5ո41ԭ )W(XZ<]]ygn뎑X̪-ۚU8 6z]K-w9B-{Y[ zšAGW.o58:.gI {[[Rxa++j8[(J?B`?TTWs#%(o\V^cAlJ{qKɁ={a>$R)qL16kGXVY^k,xlC#h˛tNwas-XY5-W()(mWdza}h*cgcCeu5F{.4FHrpťI|n]۩wbkm~4bF #d>KNa!/]@cI^I<R)d3 ~9.jϜV bלxzL,-,l>l)hJfPb%A.WsTW((._7 6gô_̔e-dAIظk161W^`̐A"JKygw\ӺF5eL3K1,; SS+*y{7<2у"c)_G+Yi k}O問VWaױ%ܯFb1յ60`@>EU*_ϱf2xotjݵ}4v9)7s[9u*"Doƌ R,iޖE+@V#Wʱ +J2shIFv-5߫%j:֛d hچ ㍳I$9qZAxfGfNk(k8: 9ydrFTTWTqMhDuu 9qrl]7b'1fh㱍v6L TTf)wh!5?K;zQUSCZV65NRwS&BTʬJWg;݀1v̥2rsyvޜ;Οɐ>V.Xq>>AO|ѭ\\VFEU/>2_\/a:":y8;8`anN|R@x!>(yn1^nxjbt/w7G_ЫWY]MJf^ReD'% Z<^|tYma {v' J%Fڀ7wk;p# aoc^=K~F~q1ھ%%ٳ9s[3x.vc8JUM..ΘXYXGtw#>)YO xz9۵6څ]:زoQ vw'!9zpO|5U[IĻm[nt))oWQUEJf&~> dRktnef?(ݻ sV zA-*+#5+A[އoww$R22:[A*ilZOWWr^P&f|^|NDʄQCY46g/^&5# c##ly٧l/$1n`^{)\̙9(|}as$'G=P/%X46}ɩ<=o&L`HJr yE|GTbanl\XasOܫo6.k&L~b16֬X2K\eWS:vbiaηǡLzl|̜87ľ[FeM-GeM 3'%PX\Dg9x$Wjo)m]]y1l@{luuk 0``a+(- J={8y5]zC/c5N^Moq,bOV7FR˕ `wI[VRZ m\K+,lپְb{g+kk9|,OȈcǰ՗07\G H8xQ^UyMWJ87~j8ŋ ߯Q nۭ+0) J%+3XVYɫ+%u111iN]SNʪb1=:efnVm.;CX|UYQU}_}#gM&m}ugNFʍ$j%n351a G^Q1K>]+1ނlt' ?Y^ib|9~R)qIIbeiAum-DV3w/-5=UU|i3OL;sr{8 7+.B4!8q"%sIA$1I}}ՐwvkvfL!+7\RogacmIv&GGd2,`ogGYEFl^SĄ;vs)J++:;3߭EU»ϔ~0'Esf mm!:` vN=k!DT4#SQU)L)E+ T_!Dcިp16q񘛛QQ]D"J+*(*-Q_G;} L NȈ>ݺT022""*C2\˨J),G _K 5<\v>ݺanfF̵k9uBIAq n.Ό<'OaeaA`@霼pQww̌/`kKDBX9Ri뮗|9oneeH(zlE"%%W`aCq#]|;[T}wn~mˏ`$8EYUWҳvwgԀu1n,JGC135eX+\ dݮ=Ӄi i,Z6B|<0D"yEEteAxo7mfIٸ Ap%;LzvkvbQsY,,h違{=HErm>|+ְGNDP V-}1zF v^O"V >`o6lb ֶj'G JJXs7SG܌3cPՂPהCxqVDum-[_nXJdb֝lv  Hb1ô)3UV2e6+ ɚ@++n$7B㾒SP j׭gH29޻"(.-\m]|;yd\r:O`kˎ08:ҹcGʫ/"Z^Y3oVzaߊO/81hl}}8x$c53krv-M  e-4ގ1COk9w)Mӽs|;ana!6lFRS^QSg;縩1+~\#8Øz UHU=\Xrr4(_1a,NEq>:oPw{ohD?3L&on +Fsr*LH`j`:P5j Nꤡϧ[)GFkץh-յ6D-VQ_e+=d0j` 9snDJ%;B051doτCZiYv]{Qӗ. MwD3 +ˉׄlLcczt vn./ٓ:g|=kk0ypӻkW\Vj ׶M>5jBFYe%ߝ;of?Ļ.&DCV7{nYZ>(#m]C `gv!4iYD 3AµTBSGO JmabhK/%\ 28!6/l}Z4kT*2ZvgD~ 5Of{.( ;Fwo"& LbIJK'3/Çɉ+T!qIJQkӆ!ㄌ%GG֘Adjb"dk>XYxckmN 76B5+Op56ê+s&O77`nj*Xҧ7QW.( uNlvs ?In~y #BDhl=HQi) 3'PTRJaq1NM:xӓ碑+tlc3 F ߗrn$##yM433SN=ݘɯ{Mvm'Ega#af8ٴ [ɇWwkf A-fyivb{/eV8T*g"q7gg^}q:9f&,Y0+d܉n;y|C<6!N_đg016fP<>Q٥3_|3}hSz֖П!Ak)Ovn~޾ZM`?K %yzho?SOgB6;'?H$"};}n`fClL'Od`x~e :z{yl;|MJ`?o,z ?afjB.]kKK5;wb=;碑fdOxgc`dd=%ح/0[f#HRlm31DȪDtöQJ嶱bgI~4I}=,=SxލgfWX8g#135_`w::--yG}cã?BbDHpBFʖvmWnm륰mKHB$hwL2I&y'ι{Ý=K!rs㩻· ^v yE|(Jy{fݯ,_O ^g굴3ݭ~cu|*^b)" .".O>w"LJ)goYZN-J-}=,ȓoʏݝ6g/Vl_XCJ6qTձn.Z6cnfF\xn%1>]r 5khd鏫&:l^Fxw8*siǛ_6mĩzn8qL\zQ}2E\)^Hbзf&}jSKNtLYEㆬMiEND@ %- ɏg^^Z!?RJ9rzC!djUzjgOE}+&N6-wRF9;ww!IL=n,Nd^GB_AI MzjZ߫gѨ0gxLR 6Mb:{gq`=emiɇ?kTo7cJņ={3."c†cocC]c# taAC07'fW׬=C`QYN72v}cG:GO^{݊~&4LMۭ"cOt,C/\a|lL{>DRO H$"FZ7\EtEkJu۾ܝ/ C|}|O')r@uZ[0J17`}4i=.V,bX̳2,Yo{\l cc+:QzBT"YQ(Hbݾy<=yPT5.Ř]~{^|A}j-7z>h'/Mf_?u>G{.}p知 pb#'`4^x\In3y3Qlb;bnj#܅\.G$26.BH$R‚[q\@*|˺c"H@*jmmy{}&2!.V`rBn?\DiE%r #c >μc(J".U]lX,yq9~u&c†6˵TsFqwD&#JD͛LZUn‚fs'Mg?[kO5k?e&cU0͡!fݯ:K {uc;T/}.˔Q J$a|\ aCGֆF!!r²2h-_ }1FgTuYp\1rEyD^X>&˦Ih4;Z{Q9--ijiNa~<jvu>H}BΦ9yto? [3zDT񹾩1k#+:Dq6{ǟtc-7Џ++FALFjf Ȩb1j5,hm /Mw􇄨~ڴ@?M7tYZmOn|kS3*m]kbifq9f;4ЀB Eq{T4Ҟs F$uHDc&NDLN8}jM`_N3cmL3!::]G$J:_L%=#=Ň1:"W(atu[Ds0$D"]G\nΧ}>z?φH$Y7jh }Χc}ܗ~{b1f^tybvd, gC֙qh<εƜ)6n :gJbVh4WV"m/ajbCW(*8EFc*r8- ѣ:S^Qqehg^^İ &&dQ9w[@O5 2U<çGGa.QČ~2Tc0woL-ynnGM4,t:goZ o#ڭa:F^nnL  3s2+/W'GbinFvE(0"4HDdp0dfgVWg \^S]Zdv%Z'ú:G]BXLThN>$!icoq'֮FRd2+zz~/|19yFEE(D~d@s$,[g" X…Yc' 5rޗ7Sۡ\g穻ҒleŦ-Ǐû&R)2m3.Ru+/1)!dmԦi#lKv~3/77B.OHvjh4w"\yZZ{q0 ^#?$g4i{?>Hc2 I܎ԈАE&ֶ6v<čӧu)LtOt}9suzTG\狟Wuə&grݴ7n \Sb1{^GG&r_׫mg۹&ܢ"2u㻬 1ÆqC$ڸhyzRPҾpC8xHZTj)pϣTHN`=]-֜U[O>ƩXQS?iSuLmsfA9J;7>pwvg4OE(~zu=k? q-ɦ$β趥^oP= юGD`gKm}flߡ5+~%!,yx7h4Ukuw|)vvL72)`=?ח~͆nz:+~iٺCo.h4|j-ALϱSкTVհU7Lpwyz2s8jj/alqU#"ZjZgAU&#n+:SavV+U*c*сɑQDk/d~I2)yzΈE"\ͬTGw$gmݺD$ra1t9wgï|8DCS^^\7q^TyN=KIE% ;[kB82[ITr(Y465DBTWWF&'gP_A_&XrrhimՅz֙̓XHM]=&&RJl^:%R㢣 w.{(58:pӌi8;8 NCTԲu~qwqf1XV%+/6 /77&5hm@sNk{,di=1yEږ&-ʨzވR4 A`.*GDDU:-•@P!kO }jz? IkF= q`WzzAks 5ш;E=S3=e۶&3ޜb.\ fȐ>% JY[ss(ٕ`/}C[nRH&ŏ4{wԔcF1}̨AƆc0clw?h .{+VMu'\6ΖV 0(\A~:e\MQ+Cꏏ(5b,v?ftYG>!fv;"×?{?ntP\e &kۢsqrbE UE QBU  VkUj5)YY-*2}/^}QȻ܇9LRRPQat&N _3cў^<7a #GYx.?z/-aKKtyl,~i 3+~◖ &GOwcKKضǵ5!}r5+o}(I),}C)]T*1O?½]y/u%<CѐvGx_˿a喭Wؕ|yEE,~i UXYqj*aB@@@@@@/os ˦Vp9fj̚'q^N<8k6oXk6> OGGBBBy:"l  efpݍ JV9:Fsk+ e߄ֶw54䄍qy'kQߝ͏ *,gLM&C'T*tۭ6ʮtj4(*L ֶ.~]OIE/?wrkK>b/?wD"VV{ nQQQ42g{l >JU" Saъ‚! _QFZU Z Gst+3ڵhVKLZ7JjjX827cj;Ϩc@82<.mZ[}ý7'"xOh035BDjܫBD"hmd2̌D*EVSC-dؐ.e[Z[ 2Jej5J SˢJ5݂)FB;;rETj5jP*HxMyӦ!^+*LDbbզsꦖlG|EphW[f piE"5ƠPW*I9v&GFyb#bڿ6ؔ}f`e$ -з"nxQR@@@@@_.o#(*/5)#_7b"%z77q9 b W[r =a<?}Fw@\ϛpx2v66L3OE,hxvɶ(()奇uy :zM-y d=|85`HO"#Xa3 fMʚ׭ގѱlޕHLFz3;Z!8n[-Ye;EE(U*,-,Hs0J)/7[Xi+XZX0kfM;2lJvn>W''NLB]/nv KJH$ e B׭gQ ied2cx}HMK {ˍ$:Za|zUuue;o,?ɴ-`?RRbǾ445 g+wlI)WV!KtJ<\]XySǍb\H ّrj ^n̛>/wwƩMp:+"Bp묙8u/.!6R 3Ǎe Ȅqd2^đqJM]=km\LML Ӱ4j02{[[Nf›aF<=u& pJ9};h*|t@cES_<֥LgѺr)Yyʲ_Ş`] Rޔsd4yogRboJ*߬W+0ąP*Yc'z RVlLF/ J%o-]Fґ(U*"R3xhhi@TJIi9]斖*U ~}VD".'_rv6h4]m;hljBAvvx#ٛʖ]hjZZ[iimeϫ)Xo ;7ں>Ν ?o/*< @~aE :_/Oso)qzܜrgHX)N:w1uc[p!@P399$&0k6<~\[((,fgAVHtxǏ.܋?aafƼiS8fg/\࿫/琻X\FJZ:W wWohjnf̜4F+J;2Ϝc1L0|^ ώ!+*8xCjF&45_W\S'3et)(UQʅe$H;>8ٱ7%]%l?pG{f!Ijl{u~^1_DѰG;Y?HCS3μ̓H?k|/<-\Xk;"{OWWRlgpL[H;ss33yIll+*BbJ*s'OĭCe bvs_]x{'ߏ#G)()D*Ã^*jjؗrꬨ溩gFGNwaDJ%۴s7[v怒 h4B,m>o.2oTfNOLk}JM]=9yLKk+n#q.&&701alٳJŴcY8oKΰe^߾Ĕ0'5 IDAT%"B8sN79yxzu]+],ds;6.$>:J_P{FVe.w="'zmpǼ@kɼ) &r  ~/.gİG{;R3N驫Ύ=I@@`p B!iPn@T'gbΈD"F}y?vvN01>N7=on„H̴8mTT|dnAM}=9ښcN뎱03U&#+/_O yLBCzlV WGGF`2Yz+gNR%>9[ZZ[u'Fd'é'ir/r,= RfGhs33== vA162Bpʸ1xyz`t֊u*G0386'yݶ7 fR.|XVYmm̹a>߬ZCLF"J%=\ }}ub%^gu B)Fؑ"L&3P#B KO<kSZQAjZ2!#7U55^/]4^L[|jFC~Q1w/^/ᄸ8~ڸb\n/"Ht֖| : CY]c# (*/7:w^Q1n:qR1Çu>LTnraceE|dn 9;?HD7պrlJȐ`l#gL̬l 𧩹&mĥT .B[k+8;{TT,=FáP hPt# gDD"UO;_*?=qRC@@@@@@gr/RVUێZD Xҫ@>D[;w1'pvpzayu%Ulm{mRΝrks5jv6xw \򕿐ښ[Re!(Т;,X[Z6 F646wPR^Ι֊n'(s33Ξ\˓`D';D+++^PN6݆;I?sFڎ}R}^R2TrQςǦ1ilnFTvihme uFU5Y[w;~'dTvwC܇w:yF^zg8ux+kjP<އ=!HIjIn1#'173#.ިT*OW]CEԴ ]|ty|<8<ؾwzC0!!^/AZ{aC9y6b"M VTr9'vo?FE <4XgZU[k<XjmOjǽC.W)U*>^)OIgX+;X;uF>w xx +8}rTBϾ$5#ҊJZZy |==h4jzc]\,)B$l{}mh Zֳ*M&\/[uNH?Nl?p3r0Cdfe&knmeɧ_c"HR39|"C#Q@@1B5T,F],93gr#Y>wbVԲ3=Y11c(D# !ߠVwHDv- pqݤM9BqyObs Z|ZpBH\qqp 40sy |Ej1,/7>[f'NaY9rg&slGtxf8uIPՔUVl^OWWs|.vd_e=WYlb8vHĜ1Jضw?%ܻf;y"KW槍=r~ڰtf"S^]CrW+Wqς8۳5iJH0Jy(SIaanFk[QZYIM}};1#mn>{wflܓHSK 3Ǐ\~u\lmٶM--Xh'x{+~fqwv3lJLɻ2HĘlٻ?OO./ؘ5~㳟~fژQDbmAmCA~=֋v1֤}H$D*NfK56hPsV@@@@@@@τ䅗_z_JŲ*Vh}^hmC?͖GcBx86HAE[B{?]{TF%ONoIǶJ$x ,dWaNe]EGR\^FxpPJN~+6maTTUo'g1"Cf';^'<ŎC6 e`"lx#ؾ&&R</545xcei|`D CV^?oz&^//j$kD*Lzsm 9?jTGG1&pur}RD}c#nNNA$[X5Q!99aeaA7`km}7̓Hbn> bl :d2w(Uu̙833Sr ."HϽ7G" ".afjʬh9qsrbdD-FCN~nNNi?Ō *jjHFt֌5u2|<4TWeSs xў󯱹\k77b#)a|,173#Jqqr$~DRUaYy%R@0',$*J+kh͕E7.E8:IQIE70ߏ{D XQU[qC;[ Ӌ,ʊm K9'6~,8"#ڧ667?"`gbmiN=Tn_'|9u.ͻp (6,iG3IJNaIT`jbBX\yw"Px[9u.éA.W ˉ}+*&O7W "9~OL4,-[pkFj@LM}= >RŒ#";v'f&!*oEgsVIL939!6ذ@{nĆ&H$"6<%lؽ=)b6<151Օaw"Nf8FF`25݇S8ySXZ C|}0J6rٰ{̌@vkֶ6ʫ^{EBpu2~b\(,d}?vwgn36>J6΃Tqs۾ȲM.Q#073;[}{[*+9n >"7m ЉlNL"9.98ڲ7LF룀_ږf,o7_m*ϾZU/5ňմ |21w/6lنuS)WVrqT{}x99U'L3*v&XH  z Z P[]fUV@۾'G&wrx՗ԾgO?z=v:ÿgEw2k{I<ʧ/7͘= 2_}VaCYWPVY;6oiDaShɘ0}GQU[g˲̪pUꉱ1zV_WچzR22y;x[8r$܍0X̚m;H1fq!]Tk43yŃ*I$z{4B@LH$u+b@,uGD}ww *zЬ-z8c~gM*@1¨X, }o.Ynړ.S@@!؋ kHX$2*`wDB//^4|s[o\}{E/.QSY|>٧ϳhG,!abyyr$9t7ZBILIW&'cG&WFbjdRH JSЈ㰳1دc {SR=)445z͢+K b†nuxu \,-ecFj:M^Q-mmqjm:s2;sS3mmq FD1Z͡/)Ç1lHޱe=GeM Ą P]"+/#PTDtj;BALɍpi2J&99-+/R)Ghim%240II@$AHZCS{P]W :/h#:ͩ瑈% eİPU $/7W&'*\PTz{3..FPH3LNgZZ[?uzd29FaY֌ֳlmk#%=  ~^1Ci'▙3w37yTʫ>1GTFbJ* ]Rʪ}pur$6<GF`c~qiZZpqfbHkT8x,BkR/.ʊIaEu5rN {0eTn(J;N~Q1GF.Q]WǾ#Ǩٙ #㰵sMIeС\veU>#"`Q(D 7LFLήC|b%h'Nٳ }}Lj5k'Sڠ&R)~E tfV/lI#^;Xkǭ])҈.6_bI~ƠhhSߙ:Vv;P |Rʹʦ2Ν㶹sp#$4}0\GRanj-Nax1lHIŋTV䄅#)>&&_˾!7g'v'f3.{uMyR'Vճ/tyI~ܰS9yv͍6˓wEBT$'ΜRS _XɱS ̌-ڜp=8r=SJ$9XDxp wb"C)nia$L­sfoow7KJظ'ɘ8xo77]Uu-)߷WuBiIE%_>hئRr -I~$nn-, +ؕ|1dJv~;g^Sll<̛O=/V$5$Q!5v8$;;6NdwayiLMk+͉I:g M5x ZƅB†bgcm"YN ܒwggdœ#hmk/ KJؔĢ=a>l;pIx)";/̓8;8~^I,pgD?k,T"ay>wUb-큅 pB2o.GҨѠAձs`cewQ]]!!$@ H.m)Rjv*numޭ˶R+7➌1!C~g;s=/hе1DkD)+h~5&*b˩"܁FbQ Ak% z\by$'sa$%aE8{t~<'1m^c ٌLn8ǁ#ڃOY IDAT;eHnIh^08"̞~]%mJpw_˃3g8g;Nj>L|l !z-V L;)g=F{s$zߟ~NTx8My)b$f}'e<Ȥ|u:|gp6m&='ן۱o,e@D~nb:v_fϑ$MEU`Xb_fu PXR‹lx[GO!1;y.dSsFŭߵ0W/ͧFDH6'|gxg``+rlS ,.+gQu]hLᕏ?c7u {'(/zx)ޙ z$Gw_ RkO<'V~GFnnŚ;o~;"(?_jrRhu̓xz""o~9kKӜ+*N:̧7|meϑ$E-B| 3!Gx}&0mXNcݎ]@|'r+h;3 2oU*7(5Fu7on]_FEyrr +,Ch_y<~Nq`ae2Incg):Htt8 -Fb8LyU99\9q6bWnv6d2յܼ\)iEȠ ? )*-u!BWTUT(ؾSR)pWESPR^^.uDث?Zb!#n-9E4b^V|.4B5ۻA!!8v|% ..+#ϗҊ ,V+BC\9/`|aȼz7bR\^Nhk[Tx8QvJlv>BnA!% KJ8I`#cr6qsέ14m8d_:BC\Fw77ܚӽNLΌH0J*k8({U.T_la^ WWSP\ oͶS{ӊHIGLgvIb!SBBIF6DQl(!!!q9H+hso!1~RPiHŹ\Xo@SBBBBBBBI ʕmM3?mmkӤZv: EP`Cdeӱ#3:>%:bix-V GdRDH0}Y329̾ٴg/61Z:̼s:׵k)l\h܂B^#:E3o3?/~1r]0we%='C07a}=?aA 9v:ǖ;&5+fnbL?ׅe;8"?NjLIxY&e펝<}I\.#Gwh(7aMV05ҷo \.c@ZRYmCt&E! ] ^TZ"(%PBB Pc8[y ޒf`KC QkLBiz|++.k.* n} k6΃f1.+}q s.]RwVWV:JN Zm;;vKT$]"mxޝ3I lr%H?G.>5>rJKqclvD5,^! UVt  |d"='Ng3\[(v>3L;پcofEk3$h**)*-#z*50G$W?y.mȒ V˩49$_p}qgIH@pe2|IfV;b٦-̓lٻ>ݺ2;7eZ,^0&˫s$;B@|Tj!dI UU.ѿRӜc% m'!.ccI>DB8B0[,.Ro4tFp:-E/h1JAf]][M[3x !@jv6aAm955޵k{l&Lf3q>%~ߵ+W;?.4_dQQUo O@#/~@qi̜ȩ|Oi5|m wZi{PZ^=o%W|+h_ }ݻ4GZ_}a>7hqkw!Vц u<}oE!Yټ׼Sy{j4.S|>o>_W5Bsf-Vl<=w; KH"8s .?G.Bs3[FC Qr^c+Tm*%<=dPKL4M -{Fn.9tw'JV/EAE?cZ/j2gbF#V囶p63#:ꇥ˩sE01aMAւ{$qIիj1WVC"hES}M`#N{K-g]xzUi1&u-^^YҊ DQdoQ&m޽y05-v7Gun7iZqrl"^,.`fn.Iv FC&ɪ۰_muq׹9ˬ߹# KK|eOEsO"kw$9#am7p,.WUdFsRRQN,Xe k u .:1YUc[ 7iqIcLq3YٌsɖP*޶+W9soPR^C&A?a?v/e=x5~ MCs,\Պdf΢%m`hBwȩ܏s-a˾xzsW.,ZÆݻj_kj``TԲa׳w}e-KܸfjztZ3̙ q,{omL7P׷bڬ~ڼo]Jբ`Vws7D_ ~~Y-FohAgyEk׷CϚ&zf__*6O@-aXZX㮧%rNGа6S7R_{[=wkyM+&^7"7b^E k\(B ̙l9~r]Ñ '/o ?6r2 ,7u 4Mu+yӷ㎃Q*٣ͱdMYzRhdpL>ԹOxpU5as/dPp aǍe5lٻHc d펝Yn_ﻇ~cVj1}8~]֥=㙻x)viB%%#7O,u雇N5G|l f_~Rdba vؙu殛'ӊU,Z3g'_M``Aͬ䫟aϑ$T{uQ n=s5 S SF}ş:5ZGf9^K^{6A}z/ 9 X7G_7&0qx!!TUW`19i6T_~OjvQ#7dY0hӽ sU:׍[njfܲFDHH4&vjX,Z}N߇_7Ãj E{pMtrDhۛˣ_ Hr ؓtRTL(tnKj"\/f*8~XqCBj˷ƵXnN½$PBBBBBBFE(5JO:h$[U6&?3ڬ_z!VH! Ǎcpn V<'1nuNLjx&MSp06IG~f \N8Y'ٲGm^-,۴;w/Mqy9!t u~2RtZ:t !+CHZV65z=>>D5{lfcgABck)( /wb##l$>"1?\&oR,XIKFSD8>>CNQ- p),)!#7FCh/-($OwwDEbH:}/htZ:f.Q_^UccbYlJKE!""g3ChH啕dfT* ]נ=Ou4F^ϙ ,],-,ˋN"\u$g`mt 7J+ݭkⷍش{/<)YYW48?.YJFN.a폄vnHkLF`m \&s$ QЧ H##I£}b2Aw-LƸ> Ɋe -jv#;vs3A[t&?תt6 KDP^Ro \ޠ>>%65c*,(%G\.opȯuwQۆsK`Z .yӓ&"h=:MrsD7O6XNTxxAؑ͗inLw=6[&86Ҹh- #G&5{/Fִ-YJf6q%U&6*{r@fڣ c#;,Wg1 8-F F#5z=mGӓ2N͢<ЈŨaq1 9:e?vgMqYe%;"2W"ϯLJJx9f J/A7|F4 w#+/yL\f= MiY9knG&6iV|KVn~r2,.`40il:AVR׳|&"É^χ_ϥJMâUk,V}BAϸsqҳsx婿Q1Ll޽&AYy)h)O=l~Wee2"#))+cߑ_A.S7b0Q{a(rG%:v^yh5luQ)tө|8;_BŐG1x9B8p}9- mhs)32ѨTL.~0; JJeH rÇXowge8v? ]GLd%'ّ ??FQ# 0m-(d ;_![G3OIQI)`?k`L5_Ŧ={zq zu㾩SHbMzy1n zp<%b\9}Kk\5Gpu[PGAsjBk:UBBBBBBBBQ<jV+bR|e2v LtH0*EvM 򦰢\Taa.`}  fBB"9%EĶ1 Eˑ;793{Ee}Ml'!!a_|NZv6];Eѣ $~td$gŒLrD?oocmf~^3i鈢!7w}/ޟ@RߟݝC'NeFO:sZMݙu|M:ʙV Kod61,W3//`2Fu[w?C(jz^~2s8xzչix?uYaweҨHN!+7oOTJ?c͌4q1[,N|.lر|xYxyzt:Vm:oLE~[{ʠ,V+ EElݽ #9{yYxظc $5# ͆``Nr ۇ^z}2srI" ۿ{Kb?%ͻ0yH0b(|+("=;E5 Gp>_x{1rg՛VxQ)]x/8z4{qt2S'e`!ek7P]]MtΤe'#,ؾHۛ?-hпhۓSg!&*]QXRʫ<0WO|mͭcFp::ҬGⰧWnПU[)< },۴Goͼb5k:>:f4= (KT$ue蟈FJ3Ѿ:_|<zE2rrIA&u O`42oDJ*'Sx'>>|üeHGبHz2r3=Ynz&8ՊV"BB8F/յLIeXb_NV)c9[/аľMNQIt&#1UV9fnݜ9j"_F#ruaXg%!om&G1~9lLLuщTjsu(0#'ш\&"pblZ@841)N9Ub0/ 9ޞ{j&s&ATJ%"((.F[ŸMO`HM55[;J(-/a^s;EE$=vay>f3ٹ- zw*knhq\ZVAQi)Uյ.d@&ظtztI n2(<HàFD<Əhp> b;EQYUܦs#=;=eݨ*zuFp@Ӹm4 @B|Fvq_&:/3fq2!!de#"a.#kV Lf3]Ocǩu1BԻ>>6َ'o<7pC(*)ɓ8ٿ.Bo0hy0=bc\,U[˩TB\o:wnpwsC((rr<,djqd] 'EeNdeܴZxu\󯬢BU]$tFIJL[&7KRQ^Y`{cx{yRXR L&35DAzvow4jKmqjuǝKu繪|o>,Z^](k^ 47Y3\ NJ?(!!!!!!q#p54(YiJԳ׹ѽz^: [A2l\ŘA tKd$(j5gaХrnI5z='Φ[7Ee6 @!SSPTVFfʵ||NMu)A`nv{2`CV(rܴZj g3C녋G܎pzVU#24-+77[ՏٗtEF#1vDUUޗPV0il||Id2ǟ>1 7&K>!q`'sv)`N$uO 53 eeRә/5l3$s{Ϥcmhę4Lh/dCd2ƒ}:;vm"8xO9~#"|;B.%*N!>6̼ffԱc`QiYr{"6ˀ^=QΣ!PZ~^D?>t ey{CDH0:]OPBIrE|˺L&XrsbtZ%[(+zxTg`.t!luqREi&ABBBBBBBݐ"|ZJLzb2J:8'rAJۦ"7oY({BJN.Âch()Y,ݰcg9WT䌘4Zo3z˨>DFn.?hjʫ\-CZ-#d|\b())#@??DZlVW;76~P4j5}{`-?!"4 jjk1p:VAlܹҲ ^z(-+G&9/AiyWnun]熻ݢO,ٰљU:wfϑ$=:$K7l❯ֱr`?{$twgD~_ J7mA6Yp +,OOZ+Z"qP̝R.1?,[+Mtrq2M!]{Y:72@x TZz혈^&n5B#72ӚLJg0zvEE9rX 3Oj%YVq$GTY1tvy$$߾r p"%̼\& FH` ;`h2s'>6i !7ł'a{92,o^ 4m*&939.d614囶`B3FC-S׷{:u AjQ7gWt<|m|1Z/Fq '<(icpd{n~=Iʢx~z=κi4.Zswz@pXo4J%]baa\oپYSrZƥ-|]Ӻ"\NqA)`KL٭iM|(!!!!!!q##j%GvBo4p߃*tEaE͆˒rQik exjܮvW. 5&#?UeO<ޟfL.zRIl9ш7ߥɀF &"~6V)^ & Byhe0QTF.-dyCu&B乴ll6BJ+Hʦo|w JZ=OO<'tns7y# j u-atk<(7T(f*UFM&{yN1b()/lfz;CM/^xAccT߅q1XVDQll?vȎx{x`sDgDSԦdF=-nUٞ|x^tFVD:V"Cj+ ! 뾻 -f+ kE#P'mJHHHHHHvnH Re6RkmVB ʫ0 3 \h T29U#zkXWLR}E#d, ՊY!"6FN:?A@)P(R.(bٰ6 QO]+|?  1 ņjA+WS\w4g(q}p)1/Vՙ?N͐~}ЛRr3c{p#?ۼXm6|<ΟF KJP*^ch(iJ+**PB%Z{Dozj>W2`Xѩ[Eߞ$d6ۍ]-!!!!!qɤ˅4y#4r+Ufc.' AnRlV :9D 6V rA@P^knEV :r@E{Vuˋ**u;Ǣ(Rm1a]ˁM1l*)PB r)a\Np@@{#?x{ vr#~',KHx)Q̖CThP^\A{m-QX$$$$$$~oګ݅I APnm2d*W0*ԘMW]cE&=T]QhblZ%."ՂBU(.9OM4_vff2⡒rJH\)noCBBbPFv a&+=6cEV d1:V%$$$$$.#+@le Tn=9QiW]QqbQy DLJ"ڨ4UL(!FDtEQm6]nHHnOe[U"b/gI{)}^ IDATb0P+W⽥E+ #^<"aGoP29J ^J5UoA&h j5:WN/L "Ren&T \~McY"o l!f{ +(!q= K@e BQ]nȢE-FfZ:!"$EBBBBBHdh d1z# +ʕN1lXDV&'7A a C!PdSb9I\TMxm7juD^~ԉJUUZl6gnL. ;$$}.yj M\6YQUo O@??kR1a>?{UV33U|x);bpBo4 G/8\.᥸|~oxyz\v$.7oȉأѽÆ؛MvŶ=ٵ*1*W0%:I7{S7Yzy_kVM׶iV^ &UDCJRR6Q*2ޚt2EVX-LmZ uSc$& O"43Nىdd"gsSٶeٵOmX0LW k41L_0`Y1LXV׸x=#dYXvN}ˡc'\f|~gkJvf^RF{ev[mV[ǛкeL;Zu,[z-[q^\rj??/OD ꨕ `\%BzjtjLs+|t:8NzomՔAخu6AAEnChDPh2N9؄fDp3ج4f9d'zmj,*i/YlY2QXX\7%9=5۶)@x-X64jU,Պ@zxp0w:p *eͿlv;~~|h+9bͭE4V a&BG~ ӛa}zd{:0QQtja^Bh rі: sPo6aWY) Bm ѣldu&zi9˛Oa_xcMkG!I}u`u}t9~Ǹ`4'%s٧]FnC}ש΃3Or-7_8԰jgzݯ,시p[ۗ{~jV>+4c%.bY|ӯzݵ& I} ,c {cDF!FK*-: 8NyݿyvJV/Y5[ӭC4/=Pd6пR22p1IihܸX~#9U*tCOǧ_Zbt},߸@s5x nj"#3tR aa1fvҬ/W㡻oyե3PbtjCހ;zqc\BĒ& w77v[哭'OaNf6б][r}&$T*Ծ=ow5 M&+6nLJ*Ez=>> Џ1=ZYIcǰe^bOBVѻ{7&A~AWf˜QQ$ݕgYVVmL86 aaL=-/,bъU{XEAa1S+!9wr.$ѪEMp`{bu[vH'$ q}ON'.`˜Q9pCOT(յ3njF(xc$=CxYf߱ef)2֓OXP:KXffh:NV!oӳ\=F\R2L ً2w/Τe˾FE1yxnn^, fsf-8~HXpwMt6U#u8r*Jd˖}Zp8׹M&6Gv~>'/zy Ӌ:^2u?ٶ\⽱GIHI'Òe $Ͽt^e]=-f¼}%VcjrpBɹcA."$6a =fKP[p9)pYe/MW>-۽ 2>dFkSj?,:SF\Rtp<]4Φ{mvoe~^;{˽^K6 Au=X7 uI-v:c+Jt2ilݻ gʕ4%&ngîGa򋊪<ׂ,ˢb#v$I□]L& &K~^m6; RM&>Gr*z$)-7O-rm޻ QX\L.]cX~k}JL&dYwL&R32[^Fⓒ1Ltԁ">>dڴcHϟ9pFB#/.)1j4\׆%ױb&N]:Qeٶw IsT;<<=gϹ2~D):>6Դt M{$EY-dX]c sp88p8.nsmֱ+6lbׁCzx,)uUyLYk/}zvg¨ F>>L(^8z.+ϸ˗3f3aFDL[u[ˢeoӚnj[?́c8z/Fo0rτ[څ5m>LIRYF L'\I={9t䶑77x Ξ;@~Qo gϟQ#5?{f~gfq4>޵'O?8}elݷEk1-Z|}\=J\ӓ{nG3gSWzN'3o&Ev^o-YHD(T*oUR@o4~g{vV#|1g|u:{ ڶ忳pZGI*,b/;' V{ܩL`G{wc bˆ?3/WEKP)\l?mNd̐Ai8gxR7_أܼY 12{oZ3I8Bc٩ Ve⥕~6rISuO}zfZP)hT ]UC}po  Ⱦ}z͚ GbڱաP]k#c2gO:D>x,#;?z.lJ"<({WTMp,Y }lݻ ڵnŐ>1@`;G#ãʲ̇fH,ztg/VٶʄQT-lہVCqux:O/-Cp!/?wAV3j@.f*s2 6 u̚T:u*-j6ٺJ]Ip@{ݲwEŌ8'N-%]@vľX23 oxΟÃуvvLV+7g ,zwDZve,N;*EY׳gc_9=+,[nfddL"vlF!+'1 )oݒaAO>dHr 8u&]撐>܂ FGqT:һJ9Vh^[ᱱC0gMp9N]1<8q|ۮ޺H>:sWbş˙ɲux{;}99lܽÇ8 "[FαS2Sgp::KV`4ҭS^x^-Xf=ۻg0ػ#KY~A``jNa7?dN'ХCJ}=vjaٹKXpP?aatj={گ/$b&Lf3o+cST;~ 2?Jf}"}TU۫'N&9-KJӆ0Β ;rL"gܷ7uL;sYH;'Mt )OGgi1x/YyO=pk[ONʅS2/ЪE }Ac_7V_/g6Yqn-Ç0w/̲5b7s=:w">)tF[vCo02՗] :E~[xyLy>~>o}xXm;6^%ڵ_G;a;_u3I<^lڽPnWx)F5:.'oGONgKT{~_#VnwɨXv=ڶ)w={%f<ݱXm?vƗ,\f-:wG`x>iXeFʚ\>hN?z3g?^eXɊVaoIJK'^Gznگ7*3}VmJ(> 6}=Wr 3x j GͤeX7D|bY99 UnTbF /c_ɴӒ0WzZfe~f3c Mqn(|fp13!!?zW\fX<~c|9u&}b|xm4ֻ%&0p*]ړ_z]۶kՒow`Ӯ=(J^i}6U.@rVW!!t9'=ǚxe}~Ec%Msv~= IC/qLs¾kϼ!c )<L&f/\u5hf[D|R dPLO~=TFNݶ;w3i|ۮ}9Kۈn- Xt L}||>Gu%4@ՄK6%[@%?Cfh =ƺFEQ2Y^l0º; e\kn`@PmvK*UoQܼՕC^A,,.f=tdfT!^=IJK8F  ۳$XrOѰmoIWY_ڹsX.ɠTT<|yy厕zÁF!%=pofdvCKʬ ENѼBLuP:/O5OlܾDhߦq;VGN*}ztS;Y.Yƹ,;Ynuj]\G`Xr:E{u̳tjW:E0Z)}K*!1\۸i4 qegӹ+8X6R3 ԡyrU3LH@$Ǘ~= U&9=__Wp͍~ݻ^.קk_C'N2w Nf3WOLf39?rڧ7IzfV]r}w28p&,\A֭NʲչS2:;v 9=130Y, sT*_QH,sYy+;UX,x6M@{YBgzi`&Ӊ[,S=m $3[A* C둘v0It:OI鳘\YqˣOT*Y5{k22ZgƼ>|[(/ǖ֫m %F  ߱ ,s>;{mF0g26KygyvKԁw!n=Of}OK=̨Ajko*7Oâlٻ[%=/lL=Y ߙ9o!=dkoQף;}weXis2!Q='No.^^L}y4 {v:q\@9<8>BABYRR٩#];y ~ZvW lA{iZ)~7^SRMHuh۶7/u0_:+W3o_T $Itl&r9]1}ϕ_XYaekc`b )fN&,۳;c=*YFe VlV_^RXٌ bO")$IGNW17\}2mVMfWˣsWPDۖ/UdL-(uYm*̔e_9˖uJMV#ׇjʆq=;uDIzi -|{j1W||o#Iw`Ys[X_%%LJ ]'/;o颊b,VWa5^_PQx ~ǹeGq^ bdCɢXE뵓MAo5ISÂpB[sۘA{tx QZz{5#fՎQsR$d tlSZ207KLtl'3Go(uQmOp@nn9`*WRy Ǐ?rѝ%0[,`Vj>>DG!>1;v_HxH0-BKzxOLkݝԴZ˷4[/Pbtd[x98r$ Y?ɞÇֿ_)UJreg'Jz3]s~ah8is,/`PA+;nŖ3w ,u-B]2,}WTfNIɟW\mW_eЯMD>xLc4>98Q_2ז]̨TJ]ςUknn+D6؍@@i ;vw wey{%A\bONQ W>JW;e@?W[$I~ΗNL;Nrp2_~5nNA+"}m$S8ڸs7/7m;mK|r v~}}rׂ_<=$oȲ̼I``,V~={-AᡜII%!9/ɠ;;t徻k}aHDAa1Eńcw8y2axzzh*^~1n6 /b`VPTzL!!>tL/,"5=ޥ/z6oESz`* Hդonlضm$UjW-BC(HJ=Kdi֫,9qܢHJMgNc^k#<$I8w\ vt6gzVi{1ybJFl\<=;u7(JKFqlv <Ξ;Ǩ}^b7Ӹ{b:wSH:$yRϝ5adm + ;N~]︭v?ZfK{d~}%"$חG_Wu5.um+ɲgن7U.@$/*Bo4J0Ltjy ]=$|}$W̌,6CT65f) |1Lls=[w_7] ĞJ$gΏ,˜=_@Dh-8$I6z$۵姥FlيJO[^UJR`kθܧ3g_TĔ*/}:OOrQ(>m$1iH~c%_]SדNEWrޕyW`- q1@8j`v8́ǹ^JHpw)cpͤCd2/dCڵi L^Az>.r!'FCNjq>NM 48u> Fnt:ZwTVjՃN΋{~>n_k+ N&$΋GDF]Rv6|׫-DNJa;q\3|@?ܵn5*,6S(Lo7v$=+'M!ٲw0Gb2w*|u UufM$I"+'|eX7DΜMcd%ntBH@_nփ[-wwzt'yr'o+VCΝHJOg5 U3,8mЭClܹ"tm1Xa0ƍER3w*BٶV<?p߸[QT,]Ƙ+lŰr5J-}8t;0q[NG]/Apj¯nk!Ϩ]it4 %Fm~߸ 5XAA\?oC B I1@سsVm¼кأ8.5c|}}KLcҹ}+$6z}\ףcLN?f"4_sI#%͝Ovt邿]{W5,(Ӂdb1N'URkJxBW)kx6䣴đ#t,3ooN'zYƉ3ټ:w77:D%.19r!|lwZ=fv\øYy ?,Z>}x*l4£1bŌy+Vh:6YoB7Q?̽Ʋ~NfEH{`tMtے2gRӈJܖQHRBYC9!J'6S.&,v)ɸ~ecg䵏?oXm6*=d?:/.7nhK^EG3xMmkp8nRGݢ*Fy!5n]\vUjWYhui;oC}8rZa1ihW6ߟy6q2!qQ)DjŤ[\uyzx;ܷ7/?8_3G$#{]lk2Əe-,_@??83ߺF Ovz߶ /WT$zv̶=SC)DBO<0k!#~7/7LE]uȇkYr-?ow #J˅KDvxOZ|yGOU*0 \ g!Y}E[ϧ0P(tiߎWU28UCd eC.Nto+V'煇'3{R/|y` ӻsQy}d)_3N^}/J"wlX]p -qÇp:Ye+Ko@Mm\UiK<$庍90m_NiǏMeyzx 1_|IMCd[K_^yJv=׈OJ`/?2c|^ǛOas" }[du|:t/< F>k~jM\bk\:_:Gr.gگwr}|勏ټ{}Nh>M˰0w域~ÇK`G1Y2Itl][/>yp>7JZ-gϝCUJZ,;{1~\r밡垛iڲﾓ b ,(DO-n[W߰JKŻɄD^z.)ֿgk(J0V=KaG42srx_oq!bk-WN/,bS$Xr vl¨Ax9ȼ>'I?fcwOyλ[篿Fޓ$I=:/&<,yy<ݻEQǎϘsiNTV\X|aAt*Ye>d|R2YtnߎRi޲̜Bu0-(8]ev:0t-ÆRH 7b ]z05e]V۝xX%ݎB׮%ՊZb1 TÎ^Belv;$z^-ł{ Zz-5,2±6$ĪjVYZ*/OZaX;ȲzNYsp9YZU"-ՊRrUIZ7AkP7ýV BQoʮ,c+=VÁMS\pT_klFVP}^c_6Yk}.eYjW{)כSvK7͵հQe}}?x% A?50n"@X}CЛgHn,uSs`Y\fjF'$_XDbv)WB,@s" yE S.ВϟP*4zڶM!}}tR"MɊtHNK'ϗa}V>ɓ[P@vn>:+8Ai,/(__<ɄD޿/ijڵjIrOJAt,ͨɡ s4jj%o]zhPJOX,TIJ?h$$0 L~aY99xzhL~tjχxM2f Wf]{((*O.v>TP\\Z^.V-e\~yyEM&9ʹ D0wLe F#i3]Us#ˮudPX\LxH^e. ^GimKC[w18iIL=Rte8l&"42n7mX09PqW6D,Mu0nnaseq:([Y:y$$'Âż#tXҰ7] sB6~nm#G4AGhTj=o!݊nqb=w= /d_q BsĖ i   g8_?m~}_PB}k,@dLrJI§P&S-k#l+@>V(P~)Z5=X`4`Z4[sQaGDK6g6^w_̜Mܙ$SY͑BFBWz붒2>#5c=$jնv.zArSYgڥrCiz >1<5i"=wҪm5ڔ-RQroB%AE/$*5z 7%9?d ĻQ7sy p j= zz %$J#o =u[=hWBBFP+(%Efݵ3_*/1WAPH|?Ep kd^S)HHbmDp*Y-9xj%U:OR(V}UC)\j&tnn%/ZT7ZѦZZ 켡 s|QIF)7"iPjU])*67 @cRlbE2Xf!_H I'_nC!5&`D^ @ 4*q냗ZCR7m[Fb+.$$&dY&:w1Q_O|=<9W&J[6""4f)Bs#2 1Xʹ @} ڕzӀ>,_w&cA{tg}z(7< MV+t`~Ԣ pQT?ڶh)l/Y)2Ըt`p2 B)IhUs2!6RQpS*[)8Zy핕S 5 hY*.pdWWj/_NYE($`O$kN'&$4N Ug 4fb;V[( <<иHvlrL B}QIZ!P'SI`f]FSh3>GNƱ1D=  'Oҫ'CczѷKgTJ*)p81ZLȲ^+jr- ׊,Mxy7y.y;'ϸ,m_LV; Q9 P^ς lRl6cre[ 8qRϑSPh`@5n( $n,F#ϼSع7 ߸Mw3{d4oKYUK׬#:"0}&-v;=UYu;2sY}0*kxߧqQQd 9oܸ:=1QDGD{/ryh4(,A2l@jg)"h?=-&( -UPXZ9$/Ozvwڭٵ7Y'Yvj8~'m){xE?֣Zeťe|XJٛNjvN}欙Dj/_q)# 9zE%ex}^>l6 KHJ򵛶ɽò^7*ƎIv^>ar)P[nvnŷrf]gLo.^鑳55/7:]^RQ:%]ɥEQ(phqeh |5̚˿'.:nFCCc#lN16qMmQZ-o h$i{M|>Ic8He%$PXRJyeek\pGg2yO=}*OXmS9{cȀ̢ƌ8.39twĠ>x0NlF%e- Al8].O`e)Wѣ0 /e3v7j$---_&O$$8]6=()+'6:G? |>2+($$$Ic1eƶ])4 ؿkli{^k눍bၶn1L?&RsOUXL&&I&$uMٻRFGjPTZFyU@\y3.9)E`QRQAB|6IȡCЏ|N';1zpGV0eh­V ʺJf~>h48p`N~I)V F%myu5 F¬VoN'p JKٟG|L4OOnQ1b60{@^4KJjUF'&2oIiw c'kXQSCvA!N-){<:9fjI2$0ztg~FOd>p u855LK}A9eF`sJ U חq#G( Md0t@n݆$ivM]=SRhlnf`>L2m㊉dсVfпO}plKMp&J"?ꩨۍ=;e2-vknEaƸ##'͠~};b8yw àz;~X. 6؉L3Ӿ]I$+AHRg2fpmNUmC'0͈&P#shh}/KPUEQش{7:JQY9457G%#-#-V˔1q8lڝByU5`&%'_f~>Y(ط5udliw G/7pJ**(bIHˤQIeUU70b{aN*+ahUiixܭ-&ZUKyuޗ9$h KK@Q6@V~22iLJ/DoVu4]8BHkQ!h$aE/NZECΈ"A!#jB-mZ?ҵyÏiۙ1~7^yyj0t꺺}0kgw>?CClml.S&K.ft%힓DM}}ౢi2xXCCxh(1!y[w[>oᗼG,_z~ߝ磱?g|=wxJxﳅ|}'LKg OD=«`k>e再O{,^ Άm RC*))`FmM?KL3ޝ]i鸽 |XÅ_2o457w?zEK;vye~E3ijj⍏>hjn/ 56y7xZ{6oe7Kpx<˯vxy,]{xWIO\LQIYk `%gf_jjkh xy4/?ϽDGAq)Z‹Gm]=Uյ<ڛɥ’R\n7Yx(j4467D|TO~~Qi&ʫ+.o΢/Xe+w=556t<7Ih<{ڼ >7E_ǒ5xÏ|w4PPRϿHZf zrrZff͚(.`n<v>O?cm467wx93dd`w:z*x՛PU[>O惿?~ߟyϗ^aǟ$#'\y_-+'ɗ+V/$0𸪦>@vA-;EeTTx /3446d:}YZ)||!^o׮SodWzxe.fKV^>u e+_fkDZe}5ϼv{$<| żG64P][Ǔo7 '<{³X^U[<ˊks.Ŋّ޺|m|׼<#\.7;/lS^]EeM u 6|7|d)Uuu3|qNi{gZi3&յuVT/g~),-t?Ǣ+2+iji>vǢߓoVh=k|>fx),|v땫ٺ' ;v<[mElר#z-){~ Sdq49($ Aܞ;i 4=@JyuueUUDRoauo]{3Xm{mlKMcBj7n"\D4Yz64`5'wxkng{Z:V+`ϝ7^Эm`1iT~Njr RY}%=dˮ&(OUk/,)&4 U33/?(n7C `\ro<ӧNp8 \ >lݕQI>Ń $CeM-q;Fso÷pMQUS @LTD˵JDxxP<BvI0kw˸_uW˿'ykLJ[ܹXn!AuhU{6t$%e?8kG)b6ſ+aa=^#kؿer ;.It8o,kXv=w{Xg_/;@YE%w[ jlkjdof6s&Mj ]vOzw7|7{229cڴ@EO1gvec@x9m;/7gￇPc{EVp/ =+nm*>íVo|lܹ^^ mlnnH{>.;N}K8&gÎxe467ekyzqX8Dff2k@풊S8!ğ}=pi3x8 g_g_-3'MdK_o5F`z_R335y"7\ӦrOp0_psغg&Md|qu <}=zYko[55_Z% ۇg} q465sIyUHݟ﮼{} IDAT;3ݕM\qi7jmԷϿkqdjz_x'=+?^m%Dʮ}1m*υ I#9szkyFnϿ[NTX8TU;{[@^Q>pF#N'%LHJ"3/W{N`ʚ{>TU%-+ qmG#3/ɣYu;yF`HJ+9a̝:V{ٛCH2ve46wbhlj~_[.Lcw(dRoU߭;/bR(;/z^Vz\X[*Bq(D襒dhIrPp \!K֬cr(ؼ;ܢbp/ؗ>gĀ>}hݕҳ)(-Ocg^kܺ'3M <;CB0PXZJf^>L"ee!mh۵9ib`[9cT"/`kǧّ΢=wl42__tZUaA4;a#gNcW)*/zo'fiU 韀VUYõϤQ,3Əb2_<[4~qlȿN{@ye%%\|T`0uwJcw#H6wZҕ3r$ǎaf$`Ү_|Yynnp2M~+|]CG$j6*2r [c1,]w^x8r; Ϥc8ƍAV^A A8|`tNр^d0b E_3kdiRhce̝1aq/4֬ŭJ+$K/EiM*RnVYF' V&eub"#%5m10o@"j6?M<}nJ**-*&8T)Q]btI|jk3uJ[+9FJ**ْ=er 1__ޜfO|p_S&ޢ/),-#6*V7Kd"`j5h=&|>5ѣ=ȵʌ ٶ'5~sO`5pwcx^ʫ),-#em[Y,WUƖeghW#.NGHpnO8!!ᠰ;62?AgD.?2e@,?&53)`~^]XD?QAFeMMBkf׍p@BtBA*T!ip}\2ICsPBkVUQ4\{Z,dyLyu5_|!D_y(*jjԷ/Ǝ`w>Vm'?߹8N8~'׃ݺz/xA'*kk6` Ϟư5)ftXFGa1Uᦫ䕏>a5x}^n+b s|x # "b/䩷OzSH0u 6fΞcDESR^fwP.I-*o[ =^rCZflciDCc<93dd\eͤoQQY.oN&ƌ8VrA \.*kkӺ26[#U5зo45`9X@cs!!폝)8-붛Xn|#se!<~5T֒8xɪ[#m]pe( :@Ye}q.9sn/ԡdym [s>>ظk7}b sppJ$?Uok ζtw?iϰ; \?>u -}UUmw.jUSp0u6SnjFVm·֣38oq9ق] DOX̦vmC/˖c5sHH[;!)d= >kƐ XM=׃o؄lnCݶVY ۇ޲(~w o3 }]C>l=N{KJF6@ۡEG!]80'aˎ cǠ7JjPr۵t{7Ww.IC_3}X"BCy /~1A:p+y%lD7k/Ie>R8wL.8cNٟS߭aЀ7[kxz<kk%("yOb`"ƌNJTD8W_tA`z VY!AK~#Hڍ[;MܰNˈaC0[Ij1PS_htXr5:0vϩVYshYTR۟~ƪ6rs9Nl\q\yyTTUgXbj;TvP93 琴55xꢚGiDQ[p k(Q+>bw-5ﻛ0ukh( Uux^"BsR0yt2Ww.PSWϗ߯lNyU5$*|L\BCc#UU1t@aϘ4GlSFAQ:ZIv^uuŗ7"4CǡrX|@+W7'[Ϗ k?FǢWpx*Ts\^7\ gw60:V;knb4w\ "Do2hjT$FUKӪBzIr"dj!zVUݧQN;+}:vuZ-:d0O0 1:܅BH=C)=@lFa{ls[FÀ>/EQ t(-,E|L4vlvlM3ؗ6hKW n:Ea耎C-Z/(h4&dJhi›;mzW]t>e8|j.=l?~Q<"9yddg[g:]L_!a6m߉h`lض=p󹤬MqTVUKRoM!IlKZFEc1:P}8d05ulٵ7 _-[$@bw0o gP_6J}d㡢Of2aTiYo׮gҨQ~p: 6**jjس/of;Ab13-cpB@؝bPZWoDkhmݺv_χ%NB\,KV問>UU$$hTZvZr8 ĵrkёowzY~Cm8&Jb K[1cզ-LJ:Z`xGם8*)㨩gLLNng jNNT&0攔nKFbuϜlR3#ew8iYٔUVgy9$vl1(B\ihlbÎ`NĆ;R>kZe55*%}|>]s%ւ28nuvߥBtEU,ZT!D7)UgĤv(g0iBq £lӦ\ cYn\ZׯOsXf*$􉧦5l ǞƠakn憫h4rΝ3WxSH0e\qhZF„eRŅgw>$*"f¬\|Y}=4fں:n*Ea ?~p+6aI?>"o&FB-&fOk|B-Θ oG\L-hZtcklbT_\z\|>~Œrt_wX&jywa0Ќkd,_sp0u FGqZlKmlޝ,eUU='*<]iyg%g?N|L45㢹Z̤d~w? A⠁߱aGGaw:狯\DNW] c8.|^n' .5,dmT3!) [Z{vFFsH55ˈ NG.7f/V˹3 /!jo'ϟ=,dm z=/!rgN; %c?6ƍa燚-,\٧Mgq^ПArOAFҐ!ٺ?l$9qa}}pl?'iSys/008!.cP\}91knGQoO%?ʪ+q-7uvqcyԯ/յuL5bbzd2T"-=ItDvIf^M\Ku@Qz={X SyWlַⰬ:# '2ih .G`0rU+x=K/9hQjr { nrcb() 6:*g 7eδx9( b%.{}>e7X ,)lML&j^/ؚaʚk&ڽJ+b678*kjn'.PAz%` :P),)ȈvSZQ0+ё]ƭӨt=7fP+q r_Qg@x>Y$fPXZFu]ICZ %!>[ifPRQImC#;{h0PZYI@cf^>} ).Ā}jsqt-*p/.6mrAQ.,UHkϊjJ**$6}yzWQ\^ALd1G:SXd` db oL 52o@j)*/Yq_ Av"$y??y-v;o.]sѵ9ٷ?CB]Zd>BqFK^B9>]2/q'?ߠ Bq"  Ww`NtnݚtY!~΀͹KOU4{eBBHM=.((XtdBTNiIGApT[3 * ~L4d0tp8i+J!=QlKSB!B>/. LEzUgD{vB!Np cPker[!hsT;ZdT).\^5!a6S;!V' !8iȰV!N1^T!ZECTҬ:$BH J9V -`I !8HPSvB!8: ScϋKCMѠWTI !q'dNJ-*2Bq4*( CG$BE .#G;h)I !8H( 1vBtʬ3HP! -7.{o! s !8x}>=.=.>IB#HI+Q!,i1*)@(XC!89v|2~ i.zh`U'S!cnw_nO=ZbwCFvC5tmK&mJ!}J!UF4B>HB!NxzJH!V$D`6B'Ljcof6\tv˾v9M4;ګ@tA#qi=o再̝1u]>[dȍ^MZ~Ntre*~aV+N\}93-\r!QLMg^z1>||&a;gV`]Ѻm6~t:Z}Uu=|XFi!B'<>u\] U77PB>/v}R\4*FQբB)2N'91j>n#.:ݺ7p5WrF2r9l;2eX''{2g@isKL0oV"[q [j0{TѢe㎝_R[_OSsK6_\Z-[QΡxs̜tZ84Z:\O !8i &z>׃9!,( AEQ{[!Bz=k6ni.|>r֭#*"ب(**kb6X_ cF0}xm6r AQE!6*jfNLRP*h0-oW` n[ёWUc AiEu #1i d]) 8t) :C!8(Ug3 _!Z=a҉A!)F(:BuF !D 㦚^hVuXR !XuFVBnA2?sӺ\Oh#Z^hP4/ KJ3}jmm;嗄 {wIDATߖ T.[n _y)%X ;cZOO2kw+ZhWXf.8sw$#3_^~ :UM[3c6{31t;[EA' !ǭ`UNPrN`eg!ŸӪ_>x?ZmQTENѠh$Bqa8&_}à D[[f"( bw('.bPhܱEť+p\Ϗ(zAJUBqiT" \h3Z,Zi)*BtEt NhMz}>Z'}ÁV(h?1Q4r?C!aJo$~p\xB*kjgqؚY.9L6nAna.d.`$H [SkW^N <8Nl܌UsٕF:W_t>ťl۽p` ,/,fh*Ww( }V2}x X7eo[v<>ol\t;΢kUnn !' MqBsѠ` RuB!B$A(IJQ1B!~"G)ՄǐAŢ3*!B! i1*IʨʟBq"( ^&Q`I!B!)G%,IHO-B^erC- cPd#!B! I q2jO[!8Y:-6i;zČVډ !B!8IAFQkC!GFQ :.gkTZ: B!BHP̡#BTEEg XqvH=FŤգTB!B!Dd8(^B!IOhh4]x2GaTVVA!B!PI$bTl:B!ĩ@EIvXFUT1(B!BtIB$4ABSFQ qz=4{\8L%v8GRMZb"Χq>tpc_ݴ @w {44y:ti^.ŮZDAE^Ceơ8\3LS,`zVVqː4q8s/ic?M-7p;!lXpmc{s %† #CplԮhi .ed`BؠC>@ iY3=|@0 K/06dzmS`#*3 9!lıK/<6`Z e8Uf2;!=8Z"VlztGWVfz- N "*@+;|-V >P# XX-/ aA*{a!} $23]dʃm pc}& Ǝl=`*б1V[z7V>,}]K/jzE R{ Xdx_czL+Bc|5[| OR끻k]V~qi V9O|ۯ6nA`uTuP$;VO y:IENDB`caronc-apprise-dfec414/CONTRIBUTING.md000066400000000000000000000120331526720371000173470ustar00rootroot00000000000000# 🤝 Contributing to Apprise Thank you for your interest in contributing to Apprise! We welcome bug reports, feature requests, documentation improvements, and new notification plugins. Please follow the guidelines below to help us review and merge your contributions smoothly. --- ## ✅ Quick Checklist Before You Submit - ✔️ Your code passes all lint and style checks: ```bash tox -e lint ``` If it reports issues, auto-fix them with: ```bash tox -e format ``` - ✔️ Your changes are covered by tests: ```bash tox -e qa ``` - ✔️ You followed the plugin template (if adding a new plugin). - ✔️ A new or changed multi-target plugin records each success with `mark_delivered()`. - ✔️ You included inline docstrings and respected the BSD 2-Clause license. - ✔️ Your commit message is descriptive. --- ## 📦 Local Development Setup To get started with development: ### 🧰 System Requirements - Python >= 3.9 - `pip` - `git` - Optional: `VS Code` with the Python extension ### 🚀 One-Time Setup ```bash git clone https://github.com/caronc/apprise.git cd apprise # Install all runtime + dev dependencies pip install '.[dev]' ``` (Optional, but recommended if actively developing): ```bash pip install -e '.[dev]' ``` If you use [uv](https://docs.astral.sh/uv/), one command sets up a `.venv` with every dev tool and plugin dependency: ```bash uv sync uv run pytest ``` `tox` also works through uv: ```bash uvx --with tox-uv tox -e qa ``` --- ## 🧪 Running Tests ```bash pytest # Run all tests pytest -n auto --maxprocesses=8 # Run tests across up to 8 CPU cores pytest tests/foo.py # Run a specific test file ``` Run with coverage: ```bash pytest --cov=apprise --cov-report=term ``` --- ## 🧹 Linting & Formatting Use `tox` to run through the same toolchain as CI: ```bash tox -e lint # Check for lint violations and style issues (read-only) tox -e format # Auto-fix lint violations and apply consistent code style ``` If you prefer to call ruff directly: ```bash ruff check . # Check lint violations ruff check . --fix # Auto-fix lint violations ruff format --check . # Check code style ruff format . # Apply code style ``` --- ## 🌍 Translations Apprise presents its human readable strings (the names of the settings each service accepts) in the language of whoever is running it. Every language lives in its own directory under `apprise/i18n/`. Start by seeing where help is needed: ```bash python packaging/i18n_status.py ``` Each language is listed with how much of it is translated, followed by a bullet for every string still waiting on someone. The report also names the exact file to edit. To improve an existing translation: 1. Open `apprise/i18n//LC_MESSAGES/apprise.po` for your language. 2. Fill in the `msgstr ""` under each `msgid` you want to translate. Leave the `msgid` lines alone; they are the English source text. 3. Remove any `#, fuzzy` comment once you have confirmed the translation below it. A fuzzy entry is a machine guess and Apprise ignores it. 4. Rebuild and check your work: ```bash tox -e i18n # refresh the .pot and every .po file tox -e compile # build the .mo files Apprise loads tox -e i18n-status # confirm nothing is left behind ``` To start a brand new language, let Babel create the catalog for you so its header carries the right `Language`, `Language-Team`, and `Plural-Forms` values for that language: ```bash tox -e i18n # build apprise/i18n/apprise.pot first pybabel init --domain=apprise -i apprise/i18n/apprise.pot \ -d apprise/i18n -l ``` Name the directory after the language code, such as `de` or `ja`. A region may be added when a language needs one (`pt_BR`), and Apprise falls back to the plain language when no catalog exists for the region. Then translate it the same way as above. Only text a person reads gets translated. Anything a program reads, such as a status code or a key in a JSON response, stays in English. --- ## 🧰 Optional: Using VS Code 1. Open the repo: `code .` 2. Press `Ctrl+Shift+P -> Python: Select Interpreter` 3. Choose the same interpreter you used for `pip install .[dev]` 4. Press `Ctrl+Shift+P -> Python: Discover Tests` `.vscode/settings.json` is pre-configured with: - pytest as the test runner - ruff for linting - PYTHONPATH set to project root No `.venv` is required unless you choose to use one. --- ## 📌 How to Contribute 1. **Fork the repository** and create a new branch. 2. Make your changes. 3. Run the checks listed above. 4. Submit a pull request (PR) to the `master` branch. GitHub Actions will run tests and lint checks on your PR automatically. --- ## 🧪 Need Help with Testing or Plugins? See [DEVELOPMENT.md](./DEVELOPMENT.md) for: - Full setup instructions - Tox environment descriptions - RPM testing - Plugin development guidance --- ## 🙏 Thank You Your contributions make Apprise better for everyone — thank you! 📝 See [ACKNOWLEDGEMENTS.md](./ACKNOWLEDGEMENTS.md) for a list of contributors. caronc-apprise-dfec414/LICENSE000066400000000000000000000024771526720371000161360ustar00rootroot00000000000000BSD 2-Clause License Copyright (c) 2026, Chris Caron All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. caronc-apprise-dfec414/MANIFEST.in000066400000000000000000000010531526720371000166540ustar00rootroot00000000000000include LICENSE include README.md include CONTRIBUTING.md include ACKNOWLEDGEMENTS.md include SECURITY.md include pyproject.toml include tox.ini include babel.cfg include requirements.txt include win-requirements.txt include dev-requirements.txt include all-plugin-requirements.txt include apprise/py.typed recursive-include tests * recursive-include packaging * recursive-include apprise/i18n *.pot recursive-include apprise/i18n *.po recursive-include apprise/i18n */LC_MESSAGES/*.po global-exclude *.pyc global-exclude *.pyo global-exclude __pycache__ caronc-apprise-dfec414/README.md000066400000000000000000002034271526720371000164060ustar00rootroot00000000000000![Apprise Logo](https://raw.githubusercontent.com/caronc/apprise/master/apprise/assets/themes/default/apprise-logo.png)
**ap·prise** / *verb*
To inform or tell (someone). To make one aware of something.
*Apprise* allows you to send a notification to *almost* all of the most popular *notification* services available to us today such as: Telegram, Discord, Slack, Amazon SNS, Gotify, etc. * One notification library to rule them all. * A common and intuitive notification syntax. * Supports the handling of images and attachments (_to the notification services that will accept them_). * It's incredibly lightweight. * Amazing response times because all messages sent asynchronously. Developers who wish to provide a notification service no longer need to research each and every one out there. They no longer need to try to adapt to the new ones that comeout thereafter. They just need to include this one library and then they can immediately gain access to almost all of the notifications services available to us today. System Administrators and DevOps who wish to send a notification now no longer need to find the right tool for the job. Everything is already wrapped and supported within the `apprise` command line tool (CLI) that ships with this product. [![Paypal](https://img.shields.io/badge/paypal-donate-green.svg)](https://www.paypal.com/donate/?hosted_button_id=CR6YF7KLQWQ5E) [![Follow](https://img.shields.io/twitter/follow/l2gnux)](https://twitter.com/l2gnux/)
[![Discord](https://img.shields.io/discord/558793703356104724.svg?colorB=7289DA&label=Discord&logo=Discord&logoColor=7289DA&style=flat-square)](https://discord.gg/EGg4rhmpC2) [![Python](https://img.shields.io/pypi/pyversions/apprise.svg?style=flat-square)](https://pypi.org/project/apprise/) [![Build Status](https://github.com/caronc/apprise/actions/workflows/tests.yml/badge.svg)](https://github.com/caronc/apprise/actions/workflows/tests.yml) [![Lines of Code](https://raw.githubusercontent.com/caronc/apprise/master/.github/badges/loc.svg)](https://github.com/caronc/apprise/actions/workflows/loc-badge.yml) [![CodeCov Status](https://codecov.io/github/caronc/apprise/branch/master/graph/badge.svg)](https://codecov.io/github/caronc/apprise) [![PyPi Downloads](https://img.shields.io/pepy/dt/apprise.svg?style=flat-square)](https://pypi.org/project/apprise/) Visit the [Official Documentation](https://appriseit.com/getting-started/) site for more information on Apprise. # How It Works Apprise provides one consistent URL format and notification interface for your apps, automation, and infrastructure. Use the CLI or core library directly, or relay through Apprise API, to deliver notifications to a very [large amount of supported services](https://appriseit.com/services/). [![Apprise overview showing notification sources, entry points, and supported destinations](Apprise-overview.png)](Apprise-overview.png) # Table of Contents * [Supported Notifications](#supported-notifications) * [Productivity Based Notifications](#productivity-based-notifications) * [SMS Notifications](#sms-notifications) * [Desktop Notifications](#desktop-notifications) * [Email Notifications](#email-notifications) * [Custom Notifications](#custom-notifications) * [Installation](#installation) * [Command Line Usage](#command-line-usage) * [Configuration Files](#cli-configuration-files) * [File Attachments](#cli-file-attachments) * [Loading Custom Notifications/Hooks](#cli-loading-custom-notificationshooks) * [Environment Variables](#cli-environment-variables) * [Developer API Usage](#developer-api-usage) * [Configuration Files](#api-configuration-files) * [File Attachments](#api-file-attachments) * [Loading Custom Notifications/Hooks](#api-loading-custom-notificationshooks) * [Persistent Storage](#persistent-storage) * [More Supported Links and Documentation](#want-to-learn-more) # Supported Notifications The section identifies all of the services supported by this library. [Check out the wiki for more information on the supported modules here](https://appriseit.com/). ## Productivity Based Notifications The table below identifies the services this tool supports and some example service URLs you need to use in order to take advantage of it. Click on any of the services listed below to get more details on how you can configure Apprise to access them. If you're having trouble constructing your own URL; try our [Apprise URL Builder](https://appriseit.com/tools/url-builder/) out. | Notification Service | Service ID | Default Port | Example Syntax | | -------------------- | ---------- | ------------ | -------------- | | [AMQP](https://appriseit.com/services/amqp/) | amqp:// or amqps:// | (TCP) 5672 or 5671 | amqp://hostname/queue
amqp://user:pass@hostname/queue1/queue2
amqps://user:pass@hostname/?exchange=alerts
amqps://user:pass@hostname/?version=1.0&to=/queues/name | [Apprise API](https://appriseit.com/services/apprise_api/) | apprise:// or apprises:// | (TCP) 80 or 443 | apprise://hostname/Token
apprise://:password@hostname/Token
apprise://user:password@hostname/Token | [AWS SES](https://appriseit.com/services/ses/) | ses:// | (TCP) 443 | ses://user@domain/AccessKeyID/AccessSecretKey/RegionName
ses://user@domain/AccessKeyID/AccessSecretKey/RegionName/email1/email2/emailN | [Bark](https://appriseit.com/services/bark/) | bark:// | (TCP) 80 or 443 | bark://hostname
bark://hostname/device_key
bark://hostname/device_key1/device_key2/device_keyN
barks://hostname
barks://hostname/device_key
barks://hostname/device_key1/device_key2/device_keyN | [Better Stack](https://appriseit.com/services/betterstack/) | betterstack:// | (TCP) 443 | betterstack://token/email
betterstack://token/email/team
betterstack://token/email/team1/team2/teamN
betterstack://source_token@ingesting_host | [Blink(1)](https://appriseit.com/services/blink1/) | blink1:// | USB | blink1://
blink1://serial/ | [BlueSky](https://appriseit.com/services/bluesky/) | bluesky:// | (TCP) 443 | bluesky://Handle:AppPw
bluesky://Handle:AppPw/TargetHandle
bluesky://Handle:AppPw/TargetHandle1/TargetHandle2/TargetHandleN | [Brevo](https://appriseit.com/services/brevo/) | brevo:// | (TCP) 443 | brevo://APIToken:FromEmail/
brevo://APIToken:FromEmail/ToEmail
brevo://APIToken:FromEmail/ToEmail1/ToEmail2/ToEmailN/ | [Chanify](https://appriseit.com/services/chanify/) | chantify:// | (TCP) 443 | chantify://token | [Delta Chat](https://appriseit.com/services/deltachat/) | deltachat:// or deltachats:// | (TCP) 25 or 587 | deltachat://user:pass@smtp.example.com/friend@example.org
deltachats://user:pass@smtp.example.com/friend1@example.org/friend2@example.org | [Discord](https://appriseit.com/services/discord/) | discord:// | (TCP) 443 | discord://webhook_id/webhook_token
discord://avatar@webhook_id/webhook_token | [Dot.](https://appriseit.com/services/dot/) | dot:// | (TCP) 443 | dot://apikey@device_id/text/
dot://apikey@device_id/image/
**Note**: `device_id` is the Quote/0 hardware serial | [Emby](https://appriseit.com/services/emby/) | emby:// or embys:// | (TCP) 8096 | emby://user@hostname/
emby://user:password@hostname | [Enigma2](https://appriseit.com/services/enigma2/) | enigma2:// or enigma2s:// | (TCP) 80 or 443 | enigma2://hostname | [Evolution API](https://appriseit.com/services/evolution/) | evolution:// or evolutions:// | (TCP) 80 or 443 | evolution://apikey@hostname/instance/ToPhoneNo
evolution://apikey@hostname:port/instance/ToPhoneNo
evolution://apikey@hostname/instance/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [FCM](https://appriseit.com/services/fcm/) | fcm:// | (TCP) 443 | fcm://project@apikey/DEVICE_ID
fcm://project@apikey/#TOPIC
fcm://project@apikey/DEVICE_ID1/#topic1/#topic2/DEVICE_ID2/ | [Feishu](https://appriseit.com/services/feishu/) | feishu:// | (TCP) 443 | feishu://token | [Flock](https://appriseit.com/services/flock/) | flock:// | (TCP) 443 | flock://token
flock://botname@token
flock://app_token/u:userid
flock://app_token/g:channel_id
flock://app_token/u:userid/g:channel_id | [Flowtriq](https://appriseit.com/services/flowtriq/) | flowtriq:// or flowtriqs:// | (TCP) 80 or 443 | flowtriq://apikey@hostname/webhook/path
flowtriqs://apikey@hostname/webhook/path | [GitHub](https://appriseit.com/services/github/) | github:// | (TCP) 443 | github://token@owner/repo
github://token@owner/repo/issues/42
github://token@owner/repo/pull/1807
github://token@owner/repo/discussions/7 | [GoAlert](https://appriseit.com/services/goalert/) | goalert:// or goalerts:// | (TCP) 80 or 443 | goalert://hostname/integration_key
goalerts://hostname/integration_key1/integration_key2
goalerts://hostname/path/integration_key | [Google Chat](https://appriseit.com/services/googlechat/) | gchat:// | (TCP) 443 | gchat://workspace/key/token | [Gorush](https://appriseit.com/services/gorush/) | gorush:// or gorushs:// | (TCP) 8088, 80 or 443 | gorush://hostname:8088/device_token
gorush://hostname:8088/device_token1/device_token2?platform=ios
gorushs://user:password@hostname/device_token | [Gotify](https://appriseit.com/services/gotify/) | gotify:// or gotifys:// | (TCP) 80 or 443 | gotify://hostname/token
gotifys://hostname/token?priority=high | [GroupMe](https://appriseit.com/services/groupme/) | groupme:// | (TCP) 443 | groupme://bot_id
groupme://bot_id/access_token | [Growl](https://appriseit.com/services/growl/) | growl:// | (UDP) 23053 | growl://hostname
growl://hostname:portno
growl://password@hostname
growl://password@hostname:port
**Note**: you can also use the get parameter _version_ which can allow the growl request to behave using the older v1.x protocol. An example would look like: growl://hostname?version=1 | [Guilded](https://appriseit.com/services/guilded/) | guilded:// | (TCP) 443 | guilded://webhook_id/webhook_token
guilded://avatar@webhook_id/webhook_token | [Home Assistant](https://appriseit.com/services/homeassistant/) | hassio:// or hassios:// | (TCP) 8123 or 443 | hassio://hostname/accesstoken
hassio://user@hostname/accesstoken
hassio://user:password@hostname:port/accesstoken
hassio://hostname/optional/path/accesstoken | [HumHub](https://appriseit.com/services/humhub/) | humhub:// or humhubs:// | (TCP) 80 or 443 | humhubs://token@hostname/container_id
humhubs://user:password@hostname/container_id
humhubs://token@hostname/id1/id2/id3 | [IFTTT](https://appriseit.com/services/ifttt/) | ifttt:// | (TCP) 443 | ifttt://webhooksID/Event
ifttt://webhooksID/Event1/Event2/EventN
ifttt://webhooksID/Event1/?+Key=Value
ifttt://webhooksID/Event1/?-Key=value1 | [ilert](https://appriseit.com/services/ilert/) | ilert:// | (TCP) 443 | ilert://IntegrationKey
ilert://IntegrationKey?priority=high
ilert://IntegrationKey?action=resolve&dedup=key | [incident.io](https://appriseit.com/services/incidentio/) | incidentio:// | (TCP) 443 | incidentio://source_id/token
incidentio://source_id/token?action=resolve&dedup=key | [IRC](https://appriseit.com/services/irc/) | irc:// or ircs:// | (TCP) 6667 or 6697 | ircs://user:pass@irc.server/@user
ircs://user:pass@irc.server/#channel?join=true&mode=nickserv
ircs://user:pass@znc.server/@user1/@user2/@user3/#channel1 | [Jellyfin](https://appriseit.com/services/jellyfin/) | jellyfin:// or jellyfins:// | (TCP) 8096 | jellyfin://user@hostname/
jellyfins://user:password@hostname | [Jira](https://appriseit.com/services/jira/) | jira:// | (TCP) 443 | jira://APIKey
jira://APIKey/@UserID
jira://APIKey/#Team
jira://APIKey/\*Schedule
jira://APIKey/^Escalation | [Join](https://appriseit.com/services/join/) | join:// | (TCP) 443 | join://apikey/device
join://apikey/device1/device2/deviceN/
join://apikey/group
join://apikey/groupA/groupB/groupN
join://apikey/DeviceA/groupA/groupN/DeviceN/ | [KODI](https://appriseit.com/services/kodi/) | kodi:// or kodis:// | (TCP) 8080 or 443 | kodi://hostname
kodi://user@hostname
kodi://user:password@hostname:port | [Kook](https://appriseit.com/services/kook/) | kook:// | (TCP) 443 | kook://token/channel_id
kook://token/channel1/channel2
kook://token/@user_id
kook://webhook_key?mode=webhook | [Kumulos](https://appriseit.com/services/kumulos/) | kumulos:// | (TCP) 443 | kumulos://apikey/serverkey | [LaMetric Time](https://appriseit.com/services/lametric/) | lametric:// | (TCP) 443 | lametric://apikey@device_ipaddr
lametric://apikey@hostname:port
lametric://client_id@client_secret | [Lark](https://appriseit.com/services/lark/) | lark:// | (TCP) 443 | lark://BotToken | [Lauther](https://appriseit.com/services/lauther/) | lauther:// | (TCP) 443 | lauther://Token | [LFG Alarm](https://appriseit.com/services/lfgalarm/) | lfg:// | (TCP) 443 | lfg://Token | [Line](https://appriseit.com/services/line/) | line:// | (TCP) 443 | line://Token@User
line://Token/User1/User2/UserN | [Mailgun](https://appriseit.com/services/mailgun/) | mailgun:// | (TCP) 443 | mailgun://user@hostname/apikey
mailgun://user@hostname/apikey/email
mailgun://user@hostname/apikey/email1/email2/emailN
mailgun://user@hostname/apikey/?name="From%20User" | [MailerSend](https://appriseit.com/services/mailersend/) | mailersend:// | (TCP) 443 | mailersend://APIToken:FromEmail/
mailersend://APIToken:FromEmail/ToEmail
mailersend://APIToken:FromEmail/ToEmail1/ToEmail2/ToEmailN/ | [Mastodon](https://appriseit.com/services/mastodon/) | mastodon:// or mastodons://| (TCP) 80 or 443 | mastodon://access_key@hostname
mastodon://access_key@hostname/@user
mastodon://access_key@hostname/@user1/@user2/@userN | [Matrix](https://appriseit.com/services/matrix/) | matrix:// or matrixs:// | (TCP) 80 or 443 | matrix://hostname
matrix://user@hostname
matrixs://user:pass@hostname:port/#room_alias
matrixs://user:pass@hostname:port/!room_id
matrixs://user:pass@hostname:port/#room_alias/!room_id/#room2
matrixs://token@hostname:port/?webhook=matrix
matrix://user:token@hostname/?webhook=slack&format=markdown | [Mattermost](https://appriseit.com/services/mattermost/) | mmost:// or mmosts:// | (TCP) 8065 | mmost://hostname/authkey
mmost://hostname:80/authkey
mmost://user@hostname:80/authkey
mmost://hostname/authkey?channel=channel
mmosts://hostname/authkey
mmosts://user@hostname/authkey
| [Microsoft Power Automate / Workflows (MSTeams)](https://appriseit.com/services/workflows/) | workflows:// | (TCP) 443 | workflows://WorkflowID/Signature/ | [Misskey](https://appriseit.com/services/misskey/) | misskey:// or misskeys://| (TCP) 80 or 443 | misskey://access_token@hostname | [MQTT](https://appriseit.com/services/mqtt/) | mqtt:// or mqtts:// | (TCP) 1883 or 8883 | mqtt://hostname/topic
mqtt://user@hostname/topic
mqtts://user:pass@hostname:9883/topic | [Nextcloud](https://appriseit.com/services/nextcloud/) | ncloud:// or nclouds:// | (TCP) 80 or 443 | ncloud://adminuser:pass@host/User
nclouds://adminuser:pass@host/User1/User2/UserN | [NextcloudTalk](https://appriseit.com/services/nextcloudtalk/) | nctalk:// or nctalks:// | (TCP) 80 or 443 | nctalk://user:pass@host/RoomId
nctalks://user:pass@host/RoomId1/RoomId2/RoomIdN
nctalks://host/RoomId?secret=BotSecret | [Notica](https://appriseit.com/services/notica/) | notica:// | (TCP) 443 | notica://Token/ | [Notifiarr](https://appriseit.com/services/notifiarr/) | notifiarr:// | (TCP) 443 | notifiarr://apikey/#channel
notifiarr://apikey/#channel1/#channel2/#channeln | [Notifico](https://appriseit.com/services/notifico/) | notifico:// or notificos:// | (TCP) 80 or 443 | notifico://ProjectID/MessageHook/
notifico://host/ProjectID/MessageHook/
notificos://host/ProjectID/MessageHook/ | [ntfy](https://appriseit.com/services/ntfy/) | ntfy:// | (TCP) 80 or 443 | ntfy://topic/
ntfys://topic/ | [Octopush](https://appriseit.com/services/octopush/) | octopush:// | (TCP) 443 | octopush://APILogin/APIKey/TargetPhoneNo
octopush://Sender:APILogin/APIKey/TargetPhoneNo
octopush://Sender:APILogin/APIKey/TargetPhoneNo1/TargetPhoneNo2/TargetPhoneNoN | [Office 365](https://appriseit.com/services/office365/) | o365:// | (TCP) 443 | o365://TenantID:AccountEmail/ClientID/ClientSecret
o365://TenantID:AccountEmail/ClientID/ClientSecret/TargetEmail
o365://TenantID:AccountEmail/ClientID/ClientSecret/TargetEmail1/TargetEmail2/TargetEmailN | [OneBot (QQ)](https://appriseit.com/services/onebot/) | onebot:// or onebots:// | (TCP) 80 or 443 | onebot://hostname:port/UserID
onebot://token@hostname:port/@UserID/#GroupID
onebots://token@hostname:port/@UserID1/@UserID2/#GroupID1/#GroupIDN | [OneSignal](https://appriseit.com/services/onesignal/) | onesignal:// | (TCP) 443 | onesignal://AppID@APIKey/PlayerID
onesignal://TemplateID:AppID@APIKey/UserID
onesignal://AppID@APIKey/#IncludeSegment
onesignal://AppID@APIKey/Email | [Opsgenie](https://appriseit.com/services/opsgenie/) | opsgenie:// | (TCP) 443 | opsgenie://APIKey
opsgenie://APIKey/UserID
opsgenie://APIKey/#Team
opsgenie://APIKey/\*Schedule
opsgenie://APIKey/^Escalation | [PagerDuty](https://appriseit.com/services/pagerduty/) | pagerduty:// | (TCP) 443 | pagerduty://IntegrationKey@ApiKey
pagerduty://IntegrationKey@ApiKey/Source/Component | [PagerTree](https://appriseit.com/services/pagertree/) | pagertree:// | (TCP) 443 | pagertree://integration_id | [ParsePlatform](https://appriseit.com/services/parseplatform/) | parsep:// or parseps:// | (TCP) 80 or 443 | parsep://AppID:MasterKey@Hostname
parseps://AppID:MasterKey@Hostname | [Pingram](https://appriseit.com/services/pingram/) | pingram:// | (TCP) 443 | pingram://ApiKey/Target
pingram://ApiKey/Target1/Target2/TargetN
pingram://MessageType@ApiKey/Target | [Pinglet](https://appriseit.com/services/pinglet/) | pinglet:// or pinglets:// | (TCP) 80 or 443 | pinglets://apikey@hostname/namespace/topic
pinglets://apikey@hostname:port/namespace/topic | [Postmark](https://appriseit.com/services/postmark/) | postmark:// | (TCP) 443 | postmark://APIToken:FromEmail/
postmark://APIToken:FromEmail/ToEmail
postmark://APIToken:FromEmail/ToEmail1/ToEmail2/ToEmailN/ | [Prowl](https://appriseit.com/services/prowl/) | prowl:// | (TCP) 443 | prowl://apikey
prowl://apikey/providerkey | [PushBullet](https://appriseit.com/services/pushbullet/) | pbul:// | (TCP) 443 | pbul://accesstoken
pbul://accesstoken/#channel
pbul://accesstoken/A_DEVICE_ID
pbul://accesstoken/email@address.com
pbul://accesstoken/#channel/#channel2/email@address.net/DEVICE | [Pushjet](https://appriseit.com/services/pushjet/) | pjet:// or pjets:// | (TCP) 80 or 443 | pjet://hostname/secret
pjet://hostname:port/secret
pjets://secret@hostname/secret
pjets://hostname:port/secret | [Push (Techulus)](https://appriseit.com/services/techulus/) | push:// | (TCP) 443 | push://apikey/ | [Pushed](https://appriseit.com/services/pushed/) | pushed:// | (TCP) 443 | pushed://appkey/appsecret/
pushed://appkey/appsecret/#ChannelAlias
pushed://appkey/appsecret/#ChannelAlias1/#ChannelAlias2/#ChannelAliasN
pushed://appkey/appsecret/@UserPushedID
pushed://appkey/appsecret/@UserPushedID1/@UserPushedID2/@UserPushedIDN | [PushMe](https://appriseit.com/services/pushme/) | pushme:// | (TCP) 443 | pushme://Token/ | [Pushover](https://appriseit.com/services/pushover/) | pover:// | (TCP) 443 | pover://user@token
pover://user@token/DEVICE
pover://user@token/DEVICE1/DEVICE2/DEVICEN
**Note**: you must specify both your user_id and token | [Pushplus](https://appriseit.com/services/pushplus/) | pushplus:// | (TCP) 443 | pushplus://Token | [PushSafer](https://appriseit.com/services/pushsafer/) | psafer:// or psafers:// | (TCP) 80 or 443 | psafer://privatekey
psafers://privatekey/DEVICE
psafer://privatekey/DEVICE1/DEVICE2/DEVICEN | [PushWard](https://appriseit.com/services/pushward/) | pushward:// | (TCP) 443 | pushward://hlk_apikey
pushward://hlk_apikey?level=critical&volume=0.8 | [Pushy](https://appriseit.com/services/pushy/) | pushy:// | (TCP) 443 | pushy://apikey/DEVICE
pushy://apikey/DEVICE1/DEVICE2/DEVICEN
pushy://apikey/TOPIC
pushy://apikey/TOPIC1/TOPIC2/TOPICN | [PushDeer](https://appriseit.com/services/pushdeer/) | pushdeer:// or pushdeers:// | (TCP) 80 or 443 | pushdeer://pushKey
pushdeer://hostname/pushKey
pushdeer://hostname:port/pushKey | [QQ Push](https://appriseit.com/services/qq/) | qq:// | (TCP) 443 | qq://Token | [Reddit](https://appriseit.com/services/reddit/) | reddit:// | (TCP) 443 | reddit://user:password@app_id/app_secret/subreddit
reddit://user:password@app_id/app_secret/sub1/sub2/subN | [Resend](https://appriseit.com/services/resend/) | resend:// | (TCP) 443 | resend://APIToken:FromEmail/
resend://APIToken:FromEmail/ToEmail
resend://APIToken:FromEmail/ToEmail1/ToEmail2/ToEmailN/ | [Revolt](https://appriseit.com/services/revolt/) | revolt:// | (TCP) 443 | revolt://bottoken/ChannelID
revolt://bottoken/ChannelID1/ChannelID2/ChannelIDN | | [Rocket.Chat](https://appriseit.com/services/rocketchat/) | rocket:// or rockets:// | (TCP) 80 or 443 | rocket://user:password@hostname/RoomID/Channel
rockets://user:password@hostname:443/#Channel1/#Channel1/RoomID
rocket://user:password@hostname/#Channel
rocket://webhook@hostname
rockets://webhook@hostname/@User/#Channel | [RSyslog](https://appriseit.com/services/rsyslog/) | rsyslog:// | (UDP) 514 | rsyslog://hostname
rsyslog://hostname/Facility | [Ryver](https://appriseit.com/services/ryver/) | ryver:// | (TCP) 443 | ryver://Organization/Token
ryver://botname@Organization/Token | [SendGrid](https://appriseit.com/services/sendgrid/) | sendgrid:// | (TCP) 443 | sendgrid://APIToken:FromEmail/
sendgrid://APIToken:FromEmail/ToEmail
sendgrid://APIToken:FromEmail/ToEmail1/ToEmail2/ToEmailN/ | [SendPulse](https://appriseit.com/services/sendpulse/) | sendpulse:// | (TCP) 443 | sendpulse://user@host/ClientId/ClientSecret
sendpulse://user@host/ClientId/clientSecret/ToEmail
sendpulse://user@host/ClientId/ClientSecret/ToEmail1/ToEmail2/ToEmailN/ | [ServerChan](https://appriseit.com/services/serverchan/) | schan:// | (TCP) 443 | schan://sendkey/ | [Session Open Group Server](https://appriseit.com/services/sogs/) | session:// or sessions:// | (TCP) 80 or 443 | sessions://public_key:seed@hostname/room
sessions://public_key:seed@hostname/room1/room2
sessions://public_key:seed@hostname:port/room
session://public_key:seed@hostname/room | [Signal API](https://appriseit.com/services/signal/) | signal:// or signals:// | (TCP) 80 or 443 | signal://hostname:port/FromPhoneNo
signal://hostname:port/FromPhoneNo/ToPhoneNo
signal://hostname:port/FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Signalgrid](https://appriseit.com/services/signalgrid/) | signalgrid:// | (TCP) 443 | signalgrid://CLIENT_KEY/CHANNEL
signalgrid://CLIENT_KEY/CHANNEL1/CHANNEL2
signalgrid://CLIENT_KEY/CHANNEL?critical=true | [SIGNL4](https://appriseit.com/services/signl4/) | signl4:// | (TCP) 80 or 443 | signl4://hostname | [Simplepush](https://appriseit.com/services/simplepush/) | spush:// | (TCP) 443 | spush://APIToken
spush://APIToken/Topic
spush://Password@APIToken/Topic
spush://IntegrationToken/@Member
spush://IntegrationToken/?broadcast=yes | [Slack](https://appriseit.com/services/slack/) | slack:// | (TCP) 443 | slack://TokenA/TokenB/TokenC/
slack://TokenA/TokenB/TokenC/Channel
slack://botname@TokenA/TokenB/TokenC/Channel
slack://user@TokenA/TokenB/TokenC/Channel1/Channel2/ChannelN | [SMTP2Go](https://appriseit.com/services/smtp2go/) | smtp2go:// | (TCP) 443 | smtp2go://user@hostname/apikey
smtp2go://user@hostname/apikey/email
smtp2go://user@hostname/apikey/email1/email2/emailN
smtp2go://user@hostname/apikey/?name="From%20User" | [SparkPost](https://appriseit.com/services/sparkpost/) | sparkpost:// | (TCP) 443 | sparkpost://user@hostname/apikey
sparkpost://user@hostname/apikey/email
sparkpost://user@hostname/apikey/email1/email2/emailN
sparkpost://user@hostname/apikey/?name="From%20User" | [Spike.sh](https://appriseit.com/services/spike/) | spike:// | (TCP) 443 | spike://Token | [Splunk](https://appriseit.com/services/splunk/) | splunk:// or victorops:/ | (TCP) 443 | splunk://route_key@apikey
splunk://route_key@apikey/entity_id | [Spug Push](https://appriseit.com/services/spugpush/) | spugpush:// | (TCP) 443 | spugpush://Token | [Squadcast](https://appriseit.com/services/squadcast/) | squadcast:// | (TCP) 443 | squadcast://WebhookKey
squadcast://WebhookKey?region=eu
squadcast://WebhookKey?action=resolve&dedup=key | [Stackfield](https://appriseit.com/services/stackfield/) | stackfield:// | (TCP) 443 | stackfield://WebhookToken | [Streamlabs](https://appriseit.com/services/streamlabs/) | strmlabs:// | (TCP) 443 | strmlabs://AccessToken/
strmlabs://AccessToken/?name=name&identifier=identifier&amount=0¤cy=USD | [Synology Chat](https://appriseit.com/services/synology_chat/) | synology:// or synologys:// | (TCP) 80 or 443 | synology://hostname/token
synology://hostname:port/token | [Syslog](https://appriseit.com/services/syslog/) | syslog:// | n/a | syslog://
syslog://Facility | [Telegram](https://appriseit.com/services/telegram/) | tgram:// | (TCP) 443 | tgram://bottoken/ChatID
tgram://bottoken/ChatID1/ChatID2/ChatIDN | [Twitter](https://appriseit.com/services/twitter/) | twitter:// | (TCP) 443 | twitter://CKey/CSecret/AKey/ASecret
twitter://user@CKey/CSecret/AKey/ASecret
twitter://CKey/CSecret/AKey/ASecret/User1/User2/User2
twitter://CKey/CSecret/AKey/ASecret?mode=tweet | [Twist](https://appriseit.com/services/twist/) | twist:// | (TCP) 443 | twist://pasword:login
twist://password:login/#channel
twist://password:login/#team:channel
twist://password:login/#team:channel1/channel2/#team3:channel | [Vapid (WebPush)](https://appriseit.com/services/vapid/) | vapid:// | (TCP) 443 | vapid://subscriber/target
vapid://subscriber/target?subfile=path&keyfile=path | [Viber](https://appriseit.com/services/viber/) | viber:// | (TCP) 443 | viber://token/target | [Webex Teams (Cisco)](https://appriseit.com/services/wxteams/) | wxteams:// | (TCP) 443 | wxteams://Token | [WeChat (WeCom)](https://appriseit.com/services/wechat/) | wechat:// | (TCP) 443 | wechat://CorpID:AppSecret@AgentID/@all
wechat://CorpID:AppSecret@AgentID/UserID | [WeCom Bot](https://appriseit.com/services/wecombot/) | wecombot:// | (TCP) 443 | wecombot://BotKey | [WhatsApp](https://appriseit.com/services/whatsapp/) | whatsapp:// | (TCP) 443 | whatsapp://AccessToken@FromPhoneID/ToPhoneNo
whatsapp://Template:AccessToken@FromPhoneID/ToPhoneNo | [WPUSH](https://appriseit.com/services/wpush/) | wpush:// | (TCP) 443 | wpush://APIKey
wpush://APIKey/Topic1/Topic2/TopicN | [WxPusher](https://appriseit.com/services/wxpusher/) | wxpusher:// | (TCP) 443 | wxpusher://AppToken@UserID1/UserID2/UserIDN
wxpusher://AppToken@Topic1/Topic2/Topic3
wxpusher://AppToken@UserID1/Topic1/ | [XBMC](https://appriseit.com/services/xbmc/) | xbmc:// or xbmcs:// | (TCP) 8080 or 443 | xbmc://hostname
xbmc://user@hostname
xbmc://user:password@hostname:port | [XMPP](https://appriseit.com/services/xmpp/) | xmpp:// or xmpps:// | (TCP) 5222 or 5223 | xmpp://user:pass@hostname
xmpps://user:pass@hostname/jid
xmpps://user:pass@hostname/jid1/jid2@example.ca | [YouLMK](https://appriseit.com/services/youlmk/) | youlmk:// | (TCP) 443 | youlmk://ylk_token
youlmk://k_key
youlmk://ylk_token?priority=critical
youlmk://ylk_token?failure=critical&url=https://example.com/runs/1 | [Zalo](https://appriseit.com/services/zalo/) | zalo:// | (TCP) 443 | zalo://BotToken/ChatID
zalo://BotToken/ChatID1/ChatID2/ChatIDN | [Zoho Cliq](https://appriseit.com/services/cliq/) | cliq:// or zcliq:// or zohocliq:// | (TCP) 443 | cliq://Token/Channel
cliq://Token/@Bot
cliq://BotName@Token/Channel1/Channel2/@Bot?region=eu | [Zoom](https://appriseit.com/services/zoom/) | zoom:// | (TCP) 443 | zoom://WebhookID/Token | [Zulip Chat](https://appriseit.com/services/zulip/) | zulip:// | (TCP) 443 | zulip://botname@Organization/Token
zulip://botname@Organization/Token/Stream
zulip://botname@Organization/Token/Email ## SMS Notifications SMS Notifications for the most part do not have a both a `title` and `body`. They consist of a single `body` which is usually no more then 160 characters in length. When using Apprise, the `title` and `body` are therefore combined into a single message prior to their transmission. | Notification Service | Service ID | Default Port | Example Syntax | | -------------------- | ---------- | ------------ | -------------- | | [46elks](https://appriseit.com/services/46elks/) | 46elks:// | (TCP) 443 | 46elks://user:password@FromPhoneNo
46elks://user:password@FromPhoneNo/ToPhoneNo
46elks://user:password@FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [800.com](https://appriseit.com/services/eight00com/) | eight00com:// | (TCP) 443 | eight00com://Token@FromPhoneNo
eight00com://Token@FromPhoneNo/ToPhoneNo
eight00com://Token@FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Africas Talking](https://appriseit.com/services/africas_talking/) | atalk:// | (TCP) 443 | atalk://AppUser@ApiKey/ToPhoneNo
atalk://AppUser@ApiKey/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Automated Packet Reporting System (APRS)](https://appriseit.com/services/aprs/) | aprs:// | (TCP) 10152 | aprs://user:pass@callsign
aprs://user:pass@callsign1/callsign2/callsignN | [AWS SNS](https://appriseit.com/services/sns/) | sns:// | (TCP) 443 | sns://AccessKeyID/AccessSecretKey/RegionName/+PhoneNo
sns://AccessKeyID/AccessSecretKey/RegionName/+PhoneNo1/+PhoneNo2/+PhoneNoN
sns://AccessKeyID/AccessSecretKey/RegionName/Topic
sns://AccessKeyID/AccessSecretKey/RegionName/Topic1/Topic2/TopicN | [BulkSMS](https://appriseit.com/services/bulksms/) | bulksms:// | (TCP) 443 | bulksms://user:password@ToPhoneNo
bulksms://User:Password@ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [BulkVS](https://appriseit.com/services/bulkvs/) | bulkvs:// | (TCP) 443 | bulkvs://user:password@FromPhoneNo
bulkvs://user:password@FromPhoneNo/ToPhoneNo
bulkvs://user:password@FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Burst SMS](https://appriseit.com/services/burstsms/) | burstsms:// | (TCP) 443 | burstsms://ApiKey:ApiSecret@FromPhoneNo/ToPhoneNo
burstsms://ApiKey:ApiSecret@FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Clickatell](https://appriseit.com/services/clickatell/) | clickatell:// | (TCP) 443 | clickatell://ApiKey/ToPhoneNo
clickatell://FromPhoneNo@ApiKey/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN | [ClickSend](https://appriseit.com/services/clicksend/) | clicksend:// | (TCP) 443 | clicksend://user:pass@PhoneNo
clicksend://user:pass@ToPhoneNo1/ToPhoneNo2/ToPhoneNoN | [DAPNET](https://appriseit.com/services/dapnet/) | dapnet:// | (TCP) 80 | dapnet://user:pass@callsign
dapnet://user:pass@callsign1/callsign2/callsignN | [D7 Networks](https://appriseit.com/services/d7networks/) | d7sms:// | (TCP) 443 | d7sms://token@PhoneNo
d7sms://token@ToPhoneNo1/ToPhoneNo2/ToPhoneNoN | [DingTalk](https://appriseit.com/services/dingtalk/) | dingtalk:// | (TCP) 443 | dingtalk://token/
dingtalk://token/ToPhoneNo
dingtalk://token/ToPhoneNo1/ToPhoneNo2/ToPhoneNo1/ | [Exotel](https://appriseit.com/services/exotel/) | exotel:// | (TCP) 443 | exotel://sid:token@FromPhoneNo
exotel://sid:token@FromPhoneNo/ToPhoneNo
exotel://sid:token@FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN | [Free-Mobile](https://appriseit.com/services/freemobile/) | freemobile:// | (TCP) 443 | freemobile://user@password/ | [httpSMS](https://appriseit.com/services/httpsms/) | httpsms:// | (TCP) 443 | httpsms://ApiKey@FromPhoneNo
httpsms://ApiKey@FromPhoneNo/ToPhoneNo
httpsms://ApiKey@FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Kavenegar](https://appriseit.com/services/kavenegar/) | kavenegar:// | (TCP) 443 | kavenegar://ApiKey/ToPhoneNo
kavenegar://FromPhoneNo@ApiKey/ToPhoneNo
kavenegar://ApiKey/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN | [MessageBird](https://appriseit.com/services/messagebird/) | msgbird:// | (TCP) 443 | msgbird://ApiKey/FromPhoneNo
msgbird://ApiKey/FromPhoneNo/ToPhoneNo
msgbird://ApiKey/FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Mobile Message](https://appriseit.com/services/mobilemessage/) | mobilemessage:// or mobilemsg:// | (TCP) 443 | mobilemessage://ApiUser:ApiPass@SenderID/ToPhoneNo
mobilemessage://ApiUser:ApiPass@SenderID/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [MSG91](https://appriseit.com/services/msg91/) | msg91:// | (TCP) 443 | msg91://TemplateID@AuthKey/ToPhoneNo
msg91://TemplateID@AuthKey/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Plivo](https://appriseit.com/services/plivo/) | plivo:// | (TCP) 443 | plivo://AuthID@Token@FromPhoneNo
plivo://AuthID@Token/FromPhoneNo/ToPhoneNo
plivo://AuthID@Token/FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [RingCentral](https://appriseit.com/services/ringcentral/) | ringc:// | (TCP) 443 | ringc://SourcePhoneNo:Password@ClientID/ClientSecret
ringc://SourcePhoneNo:JWTToken@ClientID/ClientSecret/ToPhoneNo
ringc://SourcePhoneNo:JWTToken@ClientID/ClientSecret/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [SerwerSMS](https://appriseit.com/services/serwersms/) | serwersms:// | (TCP) 443 | serwersms://user:password@SenderName/+ToPhoneNo
serwersms://user:password@SenderName/+ToPhoneNo1/+ToPhoneNo2
serwersms://user:password@SenderName/%23GroupID | [Seven](https://appriseit.com/services/seven/) | seven:// | (TCP) 443 | seven://ApiKey/FromPhoneNo
seven://ApiKey/FromPhoneNo/ToPhoneNo
seven://ApiKey/FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Société Française du Radiotéléphone (SFR)](https://appriseit.com/services/sfr/) | sfr:// | (TCP) 443 | sfr://user:password>@spaceId/ToPhoneNo
sfr://user:password>@spaceId/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Signal API](https://appriseit.com/services/signal/) | signal:// or signals:// | (TCP) 80 or 443 | signal://hostname:port/FromPhoneNo
signal://hostname:port/FromPhoneNo/ToPhoneNo
signal://hostname:port/FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Sinch](https://appriseit.com/services/sinch/) | sinch:// | (TCP) 443 | sinch://ServicePlanId:ApiToken@FromPhoneNo
sinch://ServicePlanId:ApiToken@FromPhoneNo/ToPhoneNo
sinch://ServicePlanId:ApiToken@FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/
sinch://ServicePlanId:ApiToken@ShortCode/ToPhoneNo
sinch://ServicePlanId:ApiToken@ShortCode/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [SMPP](https://appriseit.com/services/smpp/) | smpp:// or smpps:// | (TCP) 443 | smpp://user:password@hostname:port/FromPhoneNo/ToPhoneNo
smpps://user:password@hostname:port/FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN | [SMSEagle](https://appriseit.com/services/smseagle/) | smseagle:// or smseagles:// | (TCP) 80 or 443 | smseagles://hostname:port/ToPhoneNo
smseagles://hostname:port/@ToContact
smseagles://hostname:port/#ToGroup
smseagles://hostname:port/ToPhoneNo1/#ToGroup/@ToContact/ | [SMS Manager](https://appriseit.com/services/sms_manager/) | smsmgr:// | (TCP) 443 | smsmgr://ApiKey@ToPhoneNo
smsmgr://ApiKey@ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [SMSC](https://appriseit.com/services/smsc/) | smsc:// | (TCP) 443 | smsc://login:password@ToPhoneNo
smsc://login:password@ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Telnyx](https://appriseit.com/services/telnyx/) | telnyx:// | (TCP) 443 | telnyx://ApiKey@FromPhoneNo
telnyx://ApiKey@FromPhoneNo/ToPhoneNo
telnyx://ApiKey@FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/
telnyx://ApiKey@FromPhoneNo/ToPhoneNo?profile=MessagingProfileID | [Threema Gateway](https://appriseit.com/services/threema/) | threema:// | (TCP) 443 | threema://GatewayID@secret/ToPhoneNo
threema://GatewayID@secret/ToEmail
threema://GatewayID@secret/ToThreemaID/
threema://GatewayID@secret/ToEmail/ToThreemaID/ToPhoneNo/... | [Trigv](https://trigv.com/) | trigv:// or trigvs:// | (TCP) 80 or 443 | trigvs://APIKey
trigvs://APIKey/channel
trigv://APIKey@hostname/channel | [Notifyre](https://appriseit.com/services/notifyre/) | notifyre:// | (TCP) 443 | notifyre://ApiKey/ToPhoneNo
notifyre://ApiKey/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN
notifyre://ApiKey/ToFaxNo?mode=fax
notifyre://ApiKey/ToFaxNo?mode=fax&from=+FromNo | [Twilio](https://appriseit.com/services/twilio/) | twilio:// | (TCP) 443 | twilio://AccountSid:AuthToken@FromPhoneNo
twilio://AccountSid:AuthToken@FromPhoneNo/ToPhoneNo
twilio://AccountSid:AuthToken@FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/
twilio://AccountSid:AuthToken@FromPhoneNo/ToPhoneNo?apikey=Key
twilio://AccountSid:AuthToken@ShortCode/ToPhoneNo
twilio://AccountSid:AuthToken@ShortCode/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/
twilio://AccountSid:AuthToken@FromPhoneNo/ToPhoneNo?method=call
twilio://AccountSid:AuthToken@FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN?method=call | [Voipms](https://appriseit.com/services/voipms/) | voipms:// | (TCP) 443 | voipms://password:email/FromPhoneNo
voipms://password:email/FromPhoneNo/ToPhoneNo
voipms://password:email/FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ | [Vonage](https://appriseit.com/services/vonage/) (formerly Nexmo) | vonage:// | (TCP) 443 | vonage://ApiKey:ApiSecret@FromPhoneNo
vonage://ApiKey:ApiSecret@FromPhoneNo/ToPhoneNo
vonage://ApiKey:ApiSecret@FromPhoneNo/ToPhoneNo1/ToPhoneNo2/ToPhoneNoN/ ## Desktop Notifications | Notification Service | Service ID | Default Port | Example Syntax | | -------------------- | ---------- | ------------ | -------------- | | [Linux DBus Notifications](https://appriseit.com/services/dbus/) | dbus://
qt://
glib://
kde:// | n/a | dbus://
qt://
glib://
kde:// | [Linux Gnome Notifications](https://appriseit.com/services/gnome/) | gnome:// | n/a | gnome:// | [MacOS X Notifications](https://appriseit.com/services/macosx/) | macosx:// | n/a | macosx:// | [Windows Notifications](https://appriseit.com/services/windows/) | windows:// | n/a | windows:// ## Email Notifications | Service ID | Default Port | Example Syntax | | ---------- | ------------ | -------------- | | [mailto://](https://appriseit.com/services/email/) | (TCP) 25 | mailto://userid:pass@domain.com
mailto://domain.com?user=userid&pass=password
mailto://domain.com:2525?user=userid&pass=password
mailto://user@gmail.com&pass=password
mailto://mySendingUsername:mySendingPassword@example.com?to=receivingAddress@example.com
mailto://userid:password@example.com?smtp=mail.example.com&from=noreply@example.com&name=no%20reply | [mailtos://](https://appriseit.com/services/email/) | (TCP) 587 | mailtos://userid:pass@domain.com
mailtos://domain.com?user=userid&pass=password
mailtos://domain.com:465?user=userid&pass=password
mailtos://user@hotmail.com&pass=password
mailtos://mySendingUsername:mySendingPassword@example.com?to=receivingAddress@example.com
mailtos://userid:password@example.com?smtp=mail.example.com&from=noreply@example.com&name=no%20reply Apprise has some email services built right into it (such as yahoo, fastmail, hotmail, gmail, etc) that greatly simplify the mailto:// service. See more details [here](https://appriseit.com/services/email/). ## Custom Notifications | Post Method | Service ID | Default Port | Example Syntax | | -------------------- | ---------- | ------------ | -------------- | | [Form](https://appriseit.com/services/form/) | form:// or forms:// | (TCP) 80 or 443 | form://hostname
form://user@hostname
form://user:password@hostname:port
form://hostname/a/path/to/post/to | [JSON](https://appriseit.com/services/json/) | json:// or jsons:// | (TCP) 80 or 443 | json://hostname
json://user@hostname
json://user:password@hostname:port
json://hostname/a/path/to/post/to | [XML](https://appriseit.com/services/xml/) | xml:// or xmls:// | (TCP) 80 or 443 | xml://hostname
xml://user@hostname
xml://user:password@hostname:port
xml://hostname/a/path/to/post/to # Installation The easiest way is to install Apprise from PyPI: ```bash pip install apprise ``` If you use [uv](https://docs.astral.sh/uv/), you can install the `apprise` command in its own isolated environment, or add Apprise to your uv project: ```bash # Install the apprise command uv tool install apprise # Or add it to your own project uv add apprise ``` Apprise is also packaged as an RPM and available through [EPEL](https://docs.fedoraproject.org/en-US/epel/) supporting CentOS, Redhat, Rocky, Oracle Linux, etc. ```bash # Follow instructions on https://docs.fedoraproject.org/en-US/epel # to get your system connected up to EPEL and then: # Redhat/CentOS 7.x users yum install apprise # Redhat/Rocky Linux 8.x+ and/or Fedora Users dnf install apprise ``` You can also check out the [Graphical version of Apprise](https://github.com/caronc/apprise-api) to centralize your configuration and notifications through a manageable webpage. # Command Line Usage A command line tool named *apprise* is included. Provide one or more service URLs to send a notification: ```bash # Send to several services. The -vv option shows additional details. apprise -vv -t 'my title' -b 'my notification body' \ 'mailto://myemail:mypass@gmail.com' \ 'pbul://o.gn5kj6nfhv736I7jC3cj3QLRiyhgl98b' # If you don't specify a --body (-b) then stdin is used allowing # you to use the tool as part of your every day administration: cat /proc/cpuinfo | apprise -vv -t 'cpu info' \ 'mailto://myemail:mypass@gmail.com' # The title field is totally optional uptime | apprise -vv \ 'discord:///4174216298/JHMHI8qBe7bk2ZwO5U711o3dV_js' ``` ## CLI Configuration Files No one wants to put their credentials out for everyone to see on the command line. No problem, *apprise* also supports configuration files. It can handle both a specific YAML format or a very simple TEXT format. You can also pull these configuration files via an HTTP query too! Read more about the expected structure of the configuration files [here](https://appriseit.com/config/). ```bash # By default if no url or configuration is specified apprise will attempt to load # configuration files (if present) from: # ~/.apprise # ~/.apprise.yaml # ~/.config/apprise.conf # ~/.config/apprise.yaml # /etc/apprise.conf # /etc/apprise.yaml # Also subdirectory handling allows you to leverage plugins # ~/.apprise/apprise # ~/.apprise/apprise.yaml # ~/.config/apprise/apprise.conf # ~/.config/apprise/apprise.yaml # /etc/apprise/apprise.yaml # /etc/apprise/apprise.conf # Windows users can store their default configuration files here: # %APPDATA%/Apprise/apprise.conf # %APPDATA%/Apprise/apprise.yaml # %LOCALAPPDATA%/Apprise/apprise.conf # %LOCALAPPDATA%/Apprise/apprise.yaml # %ALLUSERSPROFILE%\Apprise\apprise.conf # %ALLUSERSPROFILE%\Apprise\apprise.yaml # %PROGRAMFILES%\Apprise\apprise.conf # %PROGRAMFILES%\Apprise\apprise.yaml # %COMMONPROGRAMFILES%\Apprise\apprise.conf # %COMMONPROGRAMFILES%\Apprise\apprise.yaml # The configuration files specified above can also be identified with a `.yml` # extension or even just entirely removing the `.conf` extension altogether. # If you loaded one of those files, your command line gets really easy: apprise -vv -t 'my title' -b 'my notification body' # If you want to deviate from the default paths or specify more than one, # just specify them using the --config switch: apprise -vv -t 'my title' -b 'my notification body' \ --config=/path/to/my/config.yml # Got lots of configuration locations? No problem, you can specify them all: # Apprise can even fetch the configuration from over a network! apprise -vv -t 'my title' -b 'my notification body' \ --config=/path/to/my/config.yml \ --config=https://localhost/my/apprise/config ``` ## CLI Template Variables A YAML configuration can leave a value out of a URL and have it filled in later, which lets you keep the configuration in version control without the secrets in it. Write `${NAME}` where the value belongs and declare every name you use in a `template:` section: ```yaml template: # A default is used unless the call supplies a value smtp_host: smtp.example.com # No default: the call or environment must fill this name api_key: urls: - sendgrid://${API_KEY}:noreply@example.com/you@example.com: - tag: alerts ``` Apprise looks for each value in this order and stops at the first answer: 1. a value passed with `--template-var` (`-tv`) 2. the default written in the `template:` section 3. the environment variable `APPRISE_TEMPLATE_` The environment is the last resort, so it only ever fills in a name the `template:` section declared without a default. Values supplied for a call or through the environment are trimmed. If one is blank afterwards, it reads as not supplied and the next source above applies. A default written in the configuration stays as written. Use `name: ""` for an explicit empty-string default; `name:` means the value is required. ```bash # Supply it directly apprise --config=apprise.yml --tag=alerts \ --template-var api_key=your-secret-key \ --body="Hello" # Or leave it in the environment export APPRISE_TEMPLATE_API_KEY=your-secret-key apprise --config=apprise.yml --tag=alerts --body="Hello" ``` A service missing a required value is skipped while other services continue; Apprise then exits with status `4`. Use `--dry-run` to check required values without sending anything. Only names declared under `template:` are replaced. Names ignore case, values keep their original case, and each value may be up to 1,024 characters. Undeclared `${...}` text remains unchanged, preventing similar text in an existing password from being replaced by accident. Extra supplied names are accepted and ignored. Variables may be placed directly in a URL or in a named YAML setting. URL markers can change any field, including the destination; whole-host markers also accept `user@host` and `user:pass@host`. A named setting changes only its option, so prefer it for values supplied by less-trusted callers. Variables cannot replace the service before `://`, a setting name, or a `tag:`/`tags:` value. Services and tags must be known before values are filled in. Template variables apply only to YAML configuration; TEXT configuration is unchanged. ## CLI Tagging Support Apprise allows you to tag your services in your configuration to organize them (e.g., `family`, `devops`, `critical`). You can then filter which services to notify using the `--tag` (`-g`) switch. It is important to understand how Apprise handles multiple tags: * **OR Logic (Union)**: To notify services that have *either* Tag A **OR** Tag B, specify the `-g` switch multiple times. * **AND Logic (Intersection)**: To notify services that have *both* Tag A **AND** Tag B, separate the tags with a comma. ```bash # OR Logic: Notify any service tagged 'devops' OR 'admin' apprise -vv -t "Union Test" \ --config=~/apprise.yml \ -g devops -g admin # AND Logic: Notify only services tagged with BOTH 'devops' AND 'critical' apprise -vv -t "Intersection Test" \ --config=~/apprise.yml \ -g devops,critical ``` Tags also support an optional **priority prefix** and **retry suffix**. In your configuration file you assign a priority to a tag like `1:alerts` or `5:alerts`. A lower number means higher urgency. * **Escalation (no prefix)**: `-g alerts` dispatches priority-1 entries first. If they all succeed, Apprise returns early and never runs the priority-5 fallbacks. A failure in the lower-priority group triggers the next group as an escalation chain. * **Exclusive (with prefix)**: `-g "2:alerts"` notifies *only* services whose `alerts` tag has priority 2. No other priority levels are triggered. * **Per-call retry**: `-g "alerts:3"` retries each matched service up to 3 times on failure (overrides the service's own retry setting for this call only). * **Combined**: `-g "2:alerts:3"` selects only priority-2 services and allows up to 3 retries. ```bash # Escalation: priority-1 first; skip priority-5 if all succeed apprise -vv -t "Alert" --config=~/apprise.yml -g alerts # Exclusive: only priority-2 alert services apprise -vv -t "Alert" --config=~/apprise.yml -g "2:alerts" # With retry override: retry each matched service up to 3 times apprise -vv -t "Alert" --config=~/apprise.yml -g "alerts:3" ``` ## CLI File Attachments Apprise also supports file attachments too! Specify as many attachments to a notification as you want. ```bash # Send a funny image you found on the internet to a colleague: apprise -vv --title 'Agile Joke' \ --body 'Did you see this one yet?' \ --attach https://i.redd.it/my2t4d2fx0u31.jpg \ 'mailto://myemail:mypass@gmail.com' # Easily send an update from a critical server to your dev team apprise -vv --title 'system crash' \ --body 'I do not think Jim fixed the bug; see attached...' \ --attach /var/log/myprogram.log \ --attach /var/debug/core.2345 \ --tag devteam ``` ## CLI Loading Custom Notifications/Hooks To create your own custom `schema://` hook so that you can trigger your own custom code, simply include the `@notify` decorator to wrap your function. ```python from apprise.decorators import notify # # The below assumes you want to catch foobar:// calls: # @notify(on="foobar", name="My Custom Foobar Plugin") def my_custom_notification_wrapper(body, title, notify_type, *args, **kwargs): """My custom notification function that triggers on all foobar:// calls """ # Write all of your code here... as an example... print("{}: {} - {}".format(notify_type.upper(), title, body)) # Returning True/False is a way to relay your status back to Apprise. # Returning nothing (None by default) is always interpreted as a Success ``` Once you've defined your custom hook, you just need to tell Apprise where it is at runtime. ```bash # By default if no plugin path is specified apprise will attempt to load # all plugin files (if present) from the following directory paths: # ~/.apprise/plugins # ~/.config/apprise/plugins # /var/lib/apprise/plugins # Windows users can store their default plugin files in these directories: # %APPDATA%/Apprise/plugins # %LOCALAPPDATA%/Apprise/plugins # %ALLUSERSPROFILE%\Apprise\plugins # %PROGRAMFILES%\Apprise\plugins # %COMMONPROGRAMFILES%\Apprise\plugins # If you placed your plugin file within one of the directories already defined # above, then your call simply needs to look like: apprise -vv --title 'custom override' \ --body 'the body of my message' \ foobar:\\ # However you can override the path like so apprise -vv --title 'custom override' \ --body 'the body of my message' \ --plugin-path /path/to/my/plugin.py \ foobar:\\ ``` You can read more about creating your own custom notifications and/or hooks [here](https://appriseit.com/library/extending/decorator/). ## CLI Environment Variables Those using the Command Line Interface (CLI) can also leverage environment variables to pre-set the default settings: | Variable | Description | |------------------------ | ----------------- | | `APPRISE_URLS` | Specify the default URLs to notify IF none are otherwise specified on the command line explicitly. If the `--config` (`-c`) is specified, then this will overrides any reference to this variable. Use white space and/or a comma (`,`) to delimit multiple entries. | `APPRISE_CONFIG_PATH` | Explicitly specify the config search path to use (overriding the default). The path(s) defined here must point to the absolute filename to open/reference. Use a semi-colon (`;`), line-feed (`\n`), and/or carriage return (`\r`) to delimit multiple entries. | `APPRISE_PLUGIN_PATH` | Explicitly specify the custom plugin search path to use (overriding the default). Use a semi-colon (`;`), line-feed (`\n`), and/or carriage return (`\r`) to delimit multiple entries. | `APPRISE_STORAGE_PATH` | Explicitly specify the persistent storage path to use (overriding the default). | `APPRISE_TEMPLATE_` | Supply a value for a `${NAME}` used by a YAML configuration. For example `APPRISE_TEMPLATE_API_KEY` fills in `${API_KEY}`. A value passed with `--template-var` (`-tv`) takes priority over this. # Developer API Usage To send a notification from within your python application, just do the following: ```python import apprise # Create an Apprise instance apobj = apprise.Apprise() # Add notification services by URL. # A sample email notification: apobj.add('mailto://myuserid:mypass@gmail.com') # A sample pushbullet notification apobj.add('pbul://o.gn5kj6nfhv736I7jC3cj3QLRiyhgl98b') # Then notify these services any time you desire. The below would # notify all of the services loaded into our Apprise object. apobj.notify( body='what a great notification service!', title='my notification title', ) ``` ## API Configuration Files Developers need access to configuration files too. The good news is that their use just involves declaring another object (called *AppriseConfig*) that the *Apprise* object can ingest. You can also freely mix and match config and notification entries as often as you wish! You can read more about the expected structure of the configuration files [here](https://appriseit.com/getting-started/configuration/). ```python import apprise # Create an Apprise instance apobj = apprise.Apprise() # Create an Config instance config = apprise.AppriseConfig() # Add a configuration source: config.add('/path/to/my/config.yml') # Add another... config.add('https://myserver:8080/path/to/config') # Make sure to add our config into our apprise object apobj.add(config) # You can mix and match; add an entry directly if you want too # In this entry we associate the 'admin' tag with our notification apobj.add('mailto://myuser:mypass@hotmail.com', tag='admin') # Then notify these services any time you desire. The below would # notify all of the services that have not been bound to any specific # tag. apobj.notify( body='what a great notification service!', title='my notification title', ) # Tagging allows you to specifically target only specific notification # services you've loaded: apobj.notify( body='send a notification to our admin group', title='Attention Admins', # notify any services tagged with the 'admin' tag tag='admin', ) # If you want to notify absolutely everything (regardless of whether # it's been tagged or not), just use the reserved tag of 'all': apobj.notify( body='send a notification to our admin group', title='Attention Admins', # notify absolutely everything loaded, regardless on whether # it has a tag associated with it or not: tag='all', ) ``` ## API Template Variables After loading a templated YAML configuration, developers can supply its values when sending: ```python apobj.notify( body='what a great notification service!', title='my notification title', template={'api_key': 'your-secret-key'}, ) ``` The per-call mapping takes priority over `APPRISE_TEMPLATE_` environment variables and defaults in the YAML file. Names are case-insensitive, and extra names are accepted and ignored. Templates are enabled by default. To turn them off, use the same disabled asset for the configuration and its Apprise object: ```python asset = apprise.AppriseAsset(allow_templates=False) config = apprise.AppriseConfig(asset=asset) apobj = apprise.Apprise(asset=asset) apobj.add(config) ``` When disabled, the `template:` section and template environment variables are ignored, and `${NAME}` remains unchanged. A configuration cannot enable this feature itself. ## API File Attachments Attachments are very easy to send using the Apprise API: ```python import apprise # Create an Apprise instance apobj = apprise.Apprise() # Add at least one service you want to notify apobj.add('mailto://myuser:mypass@hotmail.com') # Then send your attachment. apobj.notify( title='A great photo of our family', body='The flash caused Jane to close her eyes! hah! :)', attach='/local/path/to/my/DSC_003.jpg', ) # Send a web based attachment too! In the below example, we connect to a home # security camera and send a live image to an email. By default remote web # content is cached, but for a security camera we might want to call notify # again later in our code, so we want our last image retrieved to expire(in # this case after 3 seconds). apobj.notify( title='Latest security image', attach='http://admin:password@hikvision-cam01/ISAPI/Streaming/channels/101/picture?cache=3' ) ``` To send more than one attachment, just use a list, set, or tuple instead: ```python import apprise # Create an Apprise instance apobj = apprise.Apprise() # Add at least one service you want to notify apobj.add('mailto://myuser:mypass@hotmail.com') # Now add all of the entries we're interested in: attach = ( # ?name= allows us to rename the actual jpeg as found on the site # to be another name when sent to our receipient(s) 'https://i.redd.it/my2t4d2fx0u31.jpg?name=FlyingToMars.jpg', # Now add another: '/path/to/funny/joke.gif', ) # Send your multiple attachments with a single notify call: apobj.notify( title='Some good jokes.', body='Hey guys, check out these!', attach=attach, ) ``` ## API Loading Custom Notifications/Hooks By default, no custom plugins are loaded at all for those building from within the Apprise API. It's at the developers discretion to load custom modules. But should you choose to do so, it's as easy as including the path reference in the `AppriseAsset()` object prior to the initialization of your `Apprise()` instance. For example: ```python from apprise import Apprise from apprise import AppriseAsset # Prepare your Asset object so that you can enable the custom plugins to # be loaded for your instance of Apprise... asset = AppriseAsset(plugin_paths="/path/to/scan") # OR You can also generate scan more then one file too: asset = AppriseAsset( plugin_paths=[ # Iterate over all python libraries found in the root of the # specified path. This is NOT a recursive (directory) scan; only # the first level is parsed. HOWEVER, if a directory containing # an __init__.py is found, it will be included in the load. "/dir/containing/many/python/libraries", # An absolute path to a plugin.py to exclusively load "/path/to/plugin.py", # if you point to a directory that has an __init__.py file found in # it, then only that file is loaded (it's similar to point to a # absolute .py file. Hence, there is no (level 1) scanning at all # within the directory specified. "/path/to/dir/library" ] ) # Now that we've got our asset, we just work with our Apprise object as we # normally do aobj = Apprise(asset=asset) # If our new custom `foobar://` library was loaded (presuming we prepared # one like in the examples above). then you would be able to safely add it # into Apprise at this point aobj.add('foobar://') # Send our notification out through our foobar:// aobj.notify("test") ``` You can read more about creating your own custom notifications and/or hooks [here](https://appriseit.com/library/extending/decorator/). # Persistent Storage Persistent storage allows Apprise to cache re-occurring actions optionaly to disk. This can greatly reduce the overhead used to send a notification. There are 3 Persistent Storage operational states Apprise can operate using: 1. `auto`: Flush gathered cache information to the filesystem on demand. This option is incredibly light weight. This is the default behavior for all CLI usage. * Developers who choose to use this operational mode can also force cached information manually if they choose. * The CLI will use this operational mode by default. 2. `flush`: Flushes any cache information to the filesystem during every transaction. 3. `memory`: Effectively disable Persistent Storage. Any caching of data required by each plugin used is done in memory. Apprise effectively operates as it always did before peristent storage was available. This setting ensures no content is ever written to disk. * By default this is the mode Apprise will operate under for those developing with it unless they configure it to otherwise operate as `auto` or `flush`. This is done through the `AppriseAsset()` object and is explained further on in this documentation. ## CLI Persistent Storage Commands You can provide the keyword `storage` on your CLI call to see the persistent storage options available to you. ```bash # List all of the occupied space used by Apprise's Persistent Storage: apprise storage list # list is the default option, so the following does the same thing: apprise storage # You can prune all of your storage older then 30 days # and not accessed for this period like so: apprise storage prune # You can do a hard reset (and wipe all persistent storage) with: apprise storage clean ``` You can also filter your results by adding tags and/or URL Identifiers. When you get a listing (`apprise storage list`), you may see: ``` # example output of 'apprise storage list': 1. f7077a65 0.00B unused - matrixs://abcdef:****@synapse.example12.com/%23general?image=no&mode=off&version=3&msgtype... tags: team 2. 0e873a46 81.10B active - tgram://W...U//?image=False&detect=yes&silent=no&preview=no&content=before&mdv=v1&format=m... tags: personal 3. abcd123 12.00B stale ``` The (persistent storage) cache states are: - `unused`: This plugin has not commited anything to disk for reuse/cache purposes - `active`: This plugin has written content to disk. Or at the very least, it has prepared a persistent storage location it can write into. - `stale`: The system detected a location where a URL may have possibly written to in the past, but there is nothing linking to it using the URLs provided. It is likely wasting space or is no longer of any use. You can use this information to filter your results by specifying _URL ID_ (UID) values after your command. For example: ```bash # The below commands continue with the example already identified above # the following would match abcd123 (even though just ab was provided) # The output would only list the 'stale' entry above apprise storage list ab # knowing our filter is safe, we could remove it # the below command would not obstruct our other to URLs and would only # remove our stale one: apprise storage clean ab # Entries can be filtered by tag as well: apprise storage list --tag=team # You can match on multiple URL ID's as well: # The followin would actually match the URL ID's of 1. and .2 above apprise storage list f 0 ``` When using the CLI, Persistent storage is set to the operational mode of `auto` by default, you can change this by providing `--storage-mode=` (`-SM`) during your calls. If you want to ensure it's always set to a value of your choice. For more information on persistent storage, [visit here](https://appriseit.com/cli/persistent-storage/). ## API Persistent Storage Commands For developers, persistent storage is set in the operational mode of `memory` by default. It's at the developers discretion to enable it (by switching it to either `auto` or `flush`). Should you choose to do so: it's as easy as including the information in the `AppriseAsset()` object prior to the initialization of your `Apprise()` instance. For example: ```python from apprise import Apprise from apprise import AppriseAsset from apprise import PersistentStoreMode # Prepare a location the persistent storage can write it's cached content to. # By setting this path, this immediately assumes you wish to operate the # persistent storage in the operational 'auto' mode asset = AppriseAsset(storage_path="/path/to/save/data") # If you want to be more explicit and set more options, then you may do the # following asset = AppriseAsset( # Set our storage path directory (minimum requirement to enable it) storage_path="/path/to/save/data", # Set the mode... the options are: # 1. PersistentStoreMode.MEMORY # - disable persistent storage from writing to disk # 2. PersistentStoreMode.AUTO # - write to disk on demand # 3. PersistentStoreMode.FLUSH # - write to disk always and often storage_mode=PersistentStoreMode.FLUSH # The URL IDs are by default 8 characters in length. You can increase and # decrease it's value here. The value must be > 2. The default value is 8 # if not otherwise specified storage_idlen=8, ) # Now that we've got our asset, we just work with our Apprise object as we # normally do aobj = Apprise(asset=asset) ``` For more information on persistent storage, [visit here](https://appriseit.com/library/persistent-storage/). # Want To Learn More? If you're interested in reading more about this and other methods on how to customize your own notifications, please check out the following links: * 📣 [Using the CLI](https://appriseit.com/cli/) * 🛠️ [Development API](https://appriseit.com/library/) * ⚙️ [Configuration File Help](https://appriseit.com/getting-started/configuration/) * ⚡ [Create Your Own Custom Notifications](https://appriseit.com/library/extending/decorator/) * 🌎 [Apprise API/Web Interface](https://github.com/caronc/apprise-api/) * 📖 [Apprise Documentation Source](https://github.com/caronc/apprise-docs/) * 🔧 [Troubleshooting](https://appriseit.com/qa/) * 🎉 [Showcase](https://appriseit.com/contributing/showcase/) Want to help make Apprise better? * 💡 [Contribute to the Apprise Code Base](https://appriseit.com/contributing/) * ❤️ [Sponsorship and Donations](https://appriseit.com/contributing/sponsors/) caronc-apprise-dfec414/SECURITY.md000066400000000000000000000005771526720371000167210ustar00rootroot00000000000000# Security Policy ## Supported Versions | Version | Supported | | -------- | ------------------ | | 2.0.1 | :white_check_mark: | | < 1.13.0 | :x: | ## Reporting a Vulnerability If you find a vunerability, please notify me at lead2gold@gmail.com. If the vunerability is severe then please just open a ticket at https://github.com/caronc/apprise/issues caronc-apprise-dfec414/all-plugin-requirements.txt000066400000000000000000000015661526720371000224550ustar00rootroot00000000000000# # Note: This file is being kept for backwards compatibility with # legacy systems that point here. All future changes should # occur in pyproject.toml. Contents of this file can be found # in [project.optional-dependencies].all-plugins # Provides fcm:// and more cryptography # Provides encrypted spush:// sends PyNaCl # Provides amqp:// support for AMQP 0.9.1 pika # AMQP 1.0 requires a source build on Linux. Uncomment this when a compiler # and the OpenSSL development headers are available. # python-qpid-proton # Provides growl:// support gntp # Provides mqtt:// support paho-mqtt >= 2.1.0 # Pretty Good Privacy (PGP) Provides mailto:// and deltachat:// support PGPy # Provides blink1:// support hidapi # Provides smpp:// support smpplib # For xmpp:// support (slixmpp 1.16.0+ needs Python 3.11 or newer) slixmpp >= 1.16.0; python_version >= '3.11' caronc-apprise-dfec414/apprise/000077500000000000000000000000001526720371000165625ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/__init__.py000066400000000000000000000101361526720371000206740ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. __title__ = "Apprise" __description__: str = ( "Push Notifications that work with just about every platform!" ) __version__ = "2.1.0" __author__ = "Chris Caron" __email__ = "lead2gold@gmail.com" __license__ = "BSD 2-Clause" __copyright__ = "Copyright (c) 2026, Chris Caron " __status__ = "Production" from . import decorators, exception from .apprise import Apprise from .apprise_attachment import AppriseAttachment from .apprise_config import AppriseConfig from .asset import AppriseAsset from .attachment.base import AttachBase from .common import ( CONFIG_FORMATS, CONTENT_INCLUDE_MODES, CONTENT_LOCATIONS, NOTIFY_FORMATS, NOTIFY_IMAGE_SIZES, NOTIFY_TYPES, OVERFLOW_MODES, PERSISTENT_STORE_MODES, PERSISTENT_STORE_STATES, ConfigFormat, ContentIncludeMode, ContentLocation, NotifyFormat, NotifyImageSize, NotifyType, OverflowMode, PersistentStoreMode, ) from .config.base import ConfigBase from .locale import AppriseLocale # Inherit our logging with our additional entries added to it from .logger import LOGGER_NAME, LogCapture, NotifyLogEntry, logger, logging from .manager_attachment import AttachmentManager from .manager_config import ConfigurationManager from .manager_plugins import NotificationManager from .persistent_store import PersistentStore from .plugins.base import NotifyBase from .result import ( AppriseResult, AppriseResultStatus, NotifyAttempt, NotifyResult, ) from .tag import AppriseTag from .template import NotifyTemplate from .url import PrivacyMode, URLBase # Set default logging handler to avoid "No handler found" warnings. logging.getLogger(__name__).addHandler(logging.NullHandler()) __all__ = [ "CONFIG_FORMATS", "CONTENT_INCLUDE_MODES", "CONTENT_LOCATIONS", "LOGGER_NAME", "NOTIFY_FORMATS", "NOTIFY_IMAGE_SIZES", "NOTIFY_TYPES", "OVERFLOW_MODES", "PERSISTENT_STORE_MODES", "PERSISTENT_STORE_STATES", # Core "Apprise", "AppriseAsset", "AppriseAttachment", "AppriseConfig", "AppriseLocale", "AppriseResult", "AppriseResultStatus", "AppriseTag", "AttachBase", "AttachmentManager", "ConfigBase", "ConfigFormat", "ConfigurationManager", "ContentIncludeMode", "ContentLocation", "LogCapture", # Managers "NotificationManager", "NotifyAttempt", "NotifyBase", "NotifyFormat", "NotifyImageSize", "NotifyLogEntry", "NotifyResult", "NotifyTemplate", # Reference "NotifyType", "OverflowMode", "PersistentStore", "PersistentStoreMode", "PrivacyMode", "URLBase", # Decorator "decorators", # Exceptions "exception", # Logging "logger", "logging", ] caronc-apprise-dfec414/apprise/apprise.py000066400000000000000000002572571526720371000206210ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from __future__ import annotations import asyncio import codecs from collections.abc import Iterator, Mapping, Sequence, Set as AbstractSet import concurrent.futures as cf import contextvars from functools import partial from itertools import chain import json import logging import os import re import threading import time from typing import Any, Callable, Optional, Union from . import __version__, common, plugins from .apprise_attachment import AppriseAttachment from .apprise_config import AppriseConfig from .asset import AppriseAsset from .common import ( JSON_COMPACT_SEPARATORS, ContentLocation, ) from .config.base import ConfigBase from .conversion import convert_between from .dispatch import ( CallState, RetryRunner, ServiceCall, call_with_retry, compute_deadline, configured_max_attempts, prepared_failure, service_crashed, service_metadata, timeout_result, ) from .emojis import apply_emojis from .exception import AppriseImproperlyConfigured, AppriseTemplateError from .locale import AppriseLocale from .logger import NotifyLogEntry, logger from .manager_plugins import NotificationManager from .plugins.base import ( _PAYLOAD_PRECAPPED, NotifyBase, ) from .result import ( AppriseResult, AppriseResultStatus, NotifyResult, ) from .tag import AppriseTag from .template import NotifyTemplate from .utils.cwe312 import cwe312_loggable from .utils.json import AppriseJSONEncoder from .utils.logic import is_exclusive_match from .utils.parse import parse_list, parse_urls from .utils.template import ( normalize_name, resolve_values, validate_overrides, ) # Grant access to our Notification Manager Singleton N_MGR = NotificationManager() # Extra seconds of patience for notify() calls. _ABANDON_GRACE_SECONDS = 0.1 # The backslash escapes interpret_escapes turns into characters. Anything # else after a backslash is kept as written, so a Windows path such as # C:\Users does not make the whole message fail. ESCAPE_SEQUENCE_RE = re.compile( r"\\(?:U[0-9a-fA-F]{8}|u[0-9a-fA-F]{4}|x[0-9a-fA-F]{2}|N\{[^{}\\]+\}" r"|[0-7]{1,3}|[\\'\"abfnrtv\n])" ) def decode_escapes(content: str) -> str: """Return ``content`` with its backslash escapes interpreted.""" def _decode(match: re.Match) -> str: """Return one escape as its character, or as written if invalid.""" try: # Let Python turn the single escape into its character return codecs.decode(match.group(0), "unicode_escape") except UnicodeDecodeError: # An unknown name such as \N{NOPE}, or a \U value past the # last Unicode character, is kept as written return match.group(0) # Only well-formed escapes change, so all other text is left alone return ESCAPE_SEQUENCE_RE.sub(_decode, content) # Shared pool for service calls. Coordinators use a separate pool so they # cannot occupy the workers needed by the service calls they await. _shared_executor: Optional[cf.ThreadPoolExecutor] = None _shared_executor_lock = threading.Lock() def get_shared_executor() -> cf.ThreadPoolExecutor: """Return the shared service worker pool, creating it when first used.""" global _shared_executor # Avoid taking the lock after the pool has already been created. if _shared_executor is None: with _shared_executor_lock: # Another thread may have created the pool while we waited. if _shared_executor is None: _shared_executor = cf.ThreadPoolExecutor() # Every notification call reuses this same bounded pool. return _shared_executor # Coordinators dispatch tag chains and synchronous batches from this pool. # Their child service calls run in ``_shared_executor`` above. _coordinator_executor: Optional[cf.ThreadPoolExecutor] = None _coordinator_executor_lock = threading.Lock() def get_coordinator_executor() -> cf.ThreadPoolExecutor: """Return the shared coordinator thread pool, creating it on first use.""" global _coordinator_executor # Avoid taking the lock after the pool has already been created. if _coordinator_executor is None: with _coordinator_executor_lock: # Another thread may have created the pool while we waited. if _coordinator_executor is None: _coordinator_executor = cf.ThreadPoolExecutor() # Keep batch coordination separate from service calls it waits for. return _coordinator_executor def submit_with_context( executor: cf.Executor, function: Callable, *args: Any ) -> cf.Future: """Submit work with a copy of the caller's logging context.""" # The copied context lets worker logs find the current call capture. context = contextvars.copy_context() # Run the function inside that copied context on a worker thread. return executor.submit(context.run, function, *args) # Services abandoned on timeout that are still genuinely running. Lets # cli.py poll instead of just sleeping out its whole grace window. _abandoned_futures: list[tuple[cf.Future, str, str]] = [] _abandoned_futures_lock = threading.Lock() def track_abandoned_future(future: cf.Future, name: str, url: str) -> None: """Record one abandoned-but-still-running service call.""" with _abandoned_futures_lock: # Remove completed work before adding the newly abandoned call. _abandoned_futures[:] = [ entry for entry in _abandoned_futures if not entry[0].done() ] # Keep safe display details beside the future for CLI reporting. _abandoned_futures.append((future, name, url)) def any_abandoned_calls_still_running() -> bool: """True if any abandoned service call is still actually running.""" with _abandoned_futures_lock: # Completed calls no longer need to delay CLI shutdown. _abandoned_futures[:] = [ entry for entry in _abandoned_futures if not entry[0].done() ] # A non-empty list means at least one worker remains busy. return bool(_abandoned_futures) def abandoned_call_descriptions() -> list[str]: """Return "name (url)" for each still-running abandoned call.""" with _abandoned_futures_lock: # Do not show calls that finished since the last check. _abandoned_futures[:] = [ entry for entry in _abandoned_futures if not entry[0].done() ] # URLs were privacy-masked before being stored here. return [f"{name} ({url})" for _, name, url in _abandoned_futures] class Apprise: """Manage and dispatch messages to Apprise services. A service is any loaded notification plugin. It is not necessarily a push notification server: email, IRC, XMPP, desktop integrations, webhooks, and other custom protocols all use the same service interface. """ def __init__( self, services: Optional[ Union[ str, dict, NotifyBase, AppriseConfig, ConfigBase, Sequence[ Union[str, dict, NotifyBase, AppriseConfig, ConfigBase] ], AbstractSet[Union[str, NotifyBase, AppriseConfig, ConfigBase]], ] ] = None, asset: Optional[AppriseAsset] = None, location: Optional[ContentLocation] = None, debug: bool = False, log_callback: Optional[ Callable[[NotifyLogEntry, Optional[NotifyBase]], None] ] = None, log_level: Optional[int] = None, ) -> None: """Initialize the manager and optionally load one or more services. ``services`` may be a URL, a URL dictionary, an instantiated notification or configuration plugin, an :class:`AppriseConfig` object, or a list containing any mixture of these. URL-based services are instantiated with ``asset``; when no asset is supplied, a default :class:`AppriseAsset` is created and shared with them. ``location`` applies an optional :class:`ContentLocation` restriction when attachments are prepared. For example, callers can prevent a remotely sourced request from attaching local content. A value of ``None`` leaves attachment locations unrestricted. ``log_callback`` receives captured entries synchronously as ``callback(entry, service)``. ``service`` is the plugin associated with the entry, or ``None`` for orchestration messages exposed through :meth:`AppriseResult.call_logs`. ``log_level`` controls the minimum captured level and defaults to ``WARNING``, or ``INFO`` when a callback is configured. Both settings may be overridden by an individual call to :meth:`notify` or :meth:`async_notify`. """ # Store notification services and configuration sources. self.services = [] # Assigns an central asset object that will be later passed into each # notification plugin. Assets contain information such as the local # directory images can be found in. It can also identify remote # URL paths that contain the images you want to present to the end # user. If no asset is specified, then the default one is used. self.asset = ( asset if isinstance(asset, AppriseAsset) else AppriseAsset() ) if services: self.add(services) # Use the asset language, or let Apprise detect the system language. self.locale = AppriseLocale(language=self.asset.language) # Set our debug flag self.debug = debug # Store our hosting location for optional strict rule handling # of Attachments. Setting this to None removes any attachment # restrictions. self.location = location # Default log_callback for every notify()/async_notify() call made # with this instance, unless overridden per-call. self._log_callback = log_callback # Default log_level for every notify()/async_notify() call made # with this instance, unless overridden per-call. None defers to # _ServiceLogCapture's own WARNING default. self._log_level = log_level @staticmethod def instantiate( url: Union[str, dict], asset: Optional[AppriseAsset] = None, tag: Optional[Union[str, Sequence[str], AbstractSet[str]]] = None, suppress_exceptions: bool = True, ) -> Optional[NotifyBase]: """Create a notification service from a URL or URL dictionary. A string is parsed as an Apprise URL. A dictionary supplies the parsed constructor components directly and must contain at least ``schema`` so the matching plugin can be selected. ``tag`` replaces the tags in the parsed data, and ``asset`` is passed to the plugin instance. Invalid, unsupported, or disabled services return ``None``. Plugin constructor errors are also converted to ``None`` when ``suppress_exceptions`` is true; setting it to false lets those errors reach the caller. An example of a url dictionary object might look like: { schema: 'mailto', host: 'google.com', user: 'myuser', password: 'mypassword', } Alternatively the string is much easier to specify: mailto://user:mypassword@google.com The dictionary form is particularly useful to callers that use :meth:`details` to discover the fields supported by a plugin and then build those fields programmatically. """ # Initialize our result set results = None # Prepare our Asset Object asset = asset if isinstance(asset, AppriseAsset) else AppriseAsset() if isinstance(url, str): # Acquire our url tokens results = plugins.url_to_dict( url, secure_logging=asset.secure_logging ) if results is None: # Failed to parse the service URL; detailed logging handled # inside url_to_dict - nothing to report here. return None elif isinstance(url, dict): # We already have our result set results = url if results.get("schema") not in N_MGR: # schema is a mandatory dictionary item as it is the only way # we can index into our loaded plugins logger.error('Dictionary does not include a "schema" entry.') logger.trace( "Invalid dictionary unpacked as:{}{}".format( os.linesep, os.linesep.join( [f'{k}="{v}"' for k, v in results.items()] ), ) ) return None logger.trace( "Dictionary unpacked as:{}{}".format( os.linesep, os.linesep.join( [f'{k}="{v}"' for k, v in results.items()] ), ) ) # Otherwise we handle the invalid input specified else: logger.error( "An invalid URL type (%s) was specified for instantiation", type(url), ) return None if not N_MGR[results["schema"]].enabled: # # First Plugin Enable Check (Pre Initialization) # # Plugin has been disabled at a global level logger.error( "%s:// is disabled on this system.", results["schema"] ) return None # Build a list of tags to associate with the newly added notifications results["tag"] = set(parse_list(tag)) # Set our Asset Object results["asset"] = asset if suppress_exceptions: try: # Attempt to create an instance of our plugin using the parsed # URL information plugin = N_MGR[results["schema"]](**results) # Create log entry of loaded URL logger.debug( "Loaded {} URL: {}".format( N_MGR[results["schema"]].service_name, plugin.url(privacy=asset.secure_logging), ) ) except Exception: # CWE-312 (Secure Logging) Handling loggable_url = cwe312_loggable(url, asset.secure_logging) # the arguments are invalid or can not be used. logger.error( "Could not load {} URL: {}".format( N_MGR[results["schema"]].service_name, loggable_url ) ) return None else: # Attempt to create an instance of our plugin using the parsed # URL information but don't wrap it in a try catch plugin = N_MGR[results["schema"]](**results) if not plugin.enabled: # # Second Plugin Enable Check (Post Initialization) # # Service/Plugin is disabled (on a more local level). This is a # case where the plugin was initially enabled but then after the # __init__() was called under the hood something pre-determined # that it could no longer be used. # The only downside to doing it this way is services are # initialized prior to returning the details() if 3rd party tools # are polling what is available. These services that become # disabled thereafter are shown initially that they can be used. logger.error( "%s:// has become disabled on this system.", results["schema"] ) return None return plugin def add( self, services: Union[ str, dict, NotifyBase, AppriseConfig, ConfigBase, Sequence[Union[str, dict, NotifyBase, AppriseConfig, ConfigBase]], AbstractSet[Union[str, NotifyBase, AppriseConfig, ConfigBase]], ], asset: Optional[AppriseAsset] = None, tag: Optional[Union[str, Sequence[str], AbstractSet[str]]] = None, ) -> bool: """Add one or more notification services or configuration sources. A string may contain one or more URLs and is split with :func:`parse_urls`. Dictionaries are treated as parsed URL components. Existing :class:`NotifyBase`, :class:`ConfigBase`, and :class:`AppriseConfig` objects are stored directly. ``asset`` overrides the manager's shared asset for services created from URLs or dictionaries. ``tag`` associates one or more tags with those newly created services so they can be selected by :meth:`notify`, :meth:`async_notify`, or :meth:`find`. The return value is true only when every supplied item was accepted. Valid items are retained even if another item in the same collection is invalid. """ # Initialize our return status return_status = True if asset is None: # prepare default asset asset = self.asset if isinstance(services, str): # build our service list services = parse_urls(services) if len(services) == 0: return False elif isinstance(services, dict): # no problem, we support kwargs, convert it to a list services = [services] elif isinstance(services, (ConfigBase, NotifyBase, AppriseConfig)): # Go ahead and just add our plugin into our list self.services.append(services) return True elif not isinstance(services, (tuple, set, list)): logger.error( f"An invalid notification (type={type(services)}) was" " specified." ) return False for service in services: if isinstance(service, (ConfigBase, NotifyBase, AppriseConfig)): # Go ahead and just add our plugin into our list self.services.append(service) continue elif not isinstance(service, (str, dict)): logger.error( f"An invalid notification (type={type(service)}) was" " specified." ) return_status = False continue # Instantiate ourselves an object, this function throws or # returns None if it fails instance = Apprise.instantiate(service, asset=asset, tag=tag) if not isinstance(instance, NotifyBase): # No logging is required as instantiate() handles failure # and/or success reasons for us return_status = False continue # Add our initialized plugin to our service listings self.services.append(instance) # Return our status return return_status def clear(self) -> None: """Remove all directly loaded services and configuration sources.""" self.services[:] = [] def find( self, tag: Any = common.MATCH_ALL_TAG, match_always: bool = True, template: Optional[dict] = None, resolve: bool = True, report: Optional[list] = None, ) -> Iterator[NotifyBase]: """Yield loaded services that match ``tag``. Services from configuration sources are flattened into the same sequence used for delivery. Top-level tags are alternatives (OR), while nested collections are intersections (AND). For example, ``[('a', 'b'), 'c']`` means ``(a AND b) OR c``. When ``match_always`` is true, services tagged ``always`` are yielded even when the requested filter would not otherwise select them. ``template`` supplies values for pending ``${NAME}`` entries. A value not given here falls back to the configuration's own default and then to ``APPRISE_TEMPLATE_``. Names are case-insensitive, unused names are ignored, and a blank value reads as no value. Unresolved entries are skipped and may be added to ``report``. Set ``resolve=False`` to return pending entries unchanged. """ # Build our tag setup # - top level entries are treated as an 'or' # - second level (or more) entries are treated as 'and' # # examples: # tag="tagA, tagB" = tagA or tagB # tag=['tagA', 'tagB'] = tagA or tagB # tag=[('tagA', 'tagC'), 'tagB'] = (tagA and tagC) or tagB # tag=[('tagB', 'tagC')] = tagB and tagC # A match_always flag allows us to pick up on our 'any' keyword # and notify these services under all circumstances match_always = common.MATCH_ALWAYS_TAG if match_always else None # Turn down unusable input before anything is logged or built. template = validate_overrides(template) # One value table can cover several configurations. Extra names are # harmless, but acknowledge them in the local debug log. loaded = None if resolve and template: # Reading a configuration can mean a network request, so keep # what each source returns and use it for both the check below # and the matching further down. loaded = [self._entry_services(entry) for entry in self.services] self._log_unused_template_names(template, loaded) # Iterate over our loaded plugins for index, entry in enumerate(self.services): # Without a value table nothing was read ahead of time, so each # source is still visited only as it is needed. services = ( loaded[index] if loaded is not None else self._entry_services(entry) ) for service in services: # Apply our tag matching based on our defined logic if not is_exclusive_match( logic=tag, data=service.tags, match_all=common.MATCH_ALL_TAG, match_always=match_always, ): continue if resolve and isinstance(service, NotifyTemplate): built = self._resolve_template(service, template) if built is None: if report is not None: # Track the entry itself, never the value # it was waiting on report.append(service) continue service = built yield service return @staticmethod def _entry_services(entry: Any) -> list: """Return the services one loaded entry stands for.""" if isinstance(entry, (ConfigBase, AppriseConfig)): # A configuration source may hold any number of services. return entry.services() return [ entry, ] def _log_unused_template_names( self, template: Mapping, loaded: list, ) -> None: """Acknowledge supplied names that no loaded template uses. ``loaded`` holds the services each entry already returned, so no configuration source is read a second time here. """ known: set[str] = set() for services in loaded: known.update( name for service in services if isinstance(service, NotifyTemplate) for name in service.template_names ) unused = [] seen = set() unused_count = 0 for key in template: # Names arriving here already passed validate_overrides(), so # nothing unprintable can reach the log line below. name = normalize_name(key) if name in known or name in seen: continue seen.add(name) unused_count += 1 if len(unused) < 20: # Keep debug output bounded for large caller mappings. unused.append(name) if not unused_count: return # Names may help the operator find a typo, but values may be secrets. # Keep this out of result logs that an API can stream to its caller. logger.debug( "Template variable(s) %s%s were supplied but not used", ", ".join(unused), ( " (+{} more)".format(unused_count - len(unused)) if unused_count > len(unused) else "" ), extra={"apprise_capture": False}, ) @staticmethod def _resolve_template( service: NotifyTemplate, template: Optional[dict], ) -> Optional[NotifyBase]: """Build a pending service, or return ``None`` when values are missing. Missing variable names are written only to the local log. """ try: values = resolve_values( service.template_schema, template, names=service.names, ) except AppriseTemplateError as e: logger.error( "Template variable '%s' is not available; %s:// was skipped", e.variable, service.schema, extra={"apprise_capture": False}, ) logger.warning( "A %s:// entry was skipped; it is waiting on a" " configuration value", service.schema, ) return None return service.resolve(values) @staticmethod def _filter_entries(tag): """Return top-level filter entries in a stable order. Sets are sorted because they have no order. Lists and tuples keep the order supplied by the caller. """ if isinstance(tag, (str, AppriseTag)): # A lone filter is the only entry there is. return [tag] if isinstance(tag, (set, frozenset)): # Sets have no fixed order and may appear differently each run. return sorted(tag, key=str) # Lists and tuples keep the order the caller wrote them in. return list(tag) @staticmethod def _parse_filter_tokens(tag): """Return a flat list of parsed tokens from any supported tag filter. Filters may be strings, :class:`AppriseTag` objects, lists, or nested AND groups. Match-all filters return an empty list. """ if tag is None or tag == common.MATCH_ALL_TAG: # Match-all does not name any individual tag. return [] # parse_list() sorts comma-separated tokens. Use separate list entries # when their order decides which retry value wins. tokens = [] for entry in Apprise._filter_entries(tag): # Split comma-separated text and flatten any inner group. raw = ( parse_list(entry) if isinstance(entry, (list, tuple, set)) else parse_list(str(entry)) ) # Parsing once here lets later helpers reuse the same metadata. tokens.extend(AppriseTag.parse(tok) for tok in raw) # Callers can now inspect names, priorities, and retry counts. return tokens @staticmethod def _filter_has_explicit_priority(tag): """Return whether a filter selects an exact priority. Exact priorities use flat dispatch; other filters use escalation. """ return any( token.has_priority for token in Apprise._parse_filter_tokens(tag) ) @staticmethod def _service_priority_for_tag_name(service, tag_name): """Return the dispatch priority stored on *service* for *tag_name*. Missing tags and plain strings use priority zero. """ for stag in service.tags: if str(stag) == tag_name: return stag.priority if isinstance(stag, AppriseTag) else 0 return 0 @staticmethod def _parse_retry_filter_tokens(tag): """Parse retry-bearing filter tokens once for all matched services.""" # Keep only the tokens that actually carry a ":retry" suffix. return [ token for token in Apprise._parse_filter_tokens(tag) if token.retry is not None ] @staticmethod def _match_service_retry(service, retry_tokens): """Return the first retry override matching ``service``. Plain tokens match names; priority tokens also require that priority. """ for ft in retry_tokens: tag_name = str(ft) if not ft.has_priority: if tag_name in service.tags: return ft.retry else: for stag in service.tags: if isinstance(stag, AppriseTag): if ( str(stag) == tag_name and stag.priority == ft.priority ): return ft.retry else: if str(stag).lower() == tag_name: return ft.retry return None @staticmethod def _inject_per_service_retries(all_calls, tag): """Add the first matching retry override to each service call.""" # Parse the filter once instead of repeating the work per service. retry_tokens = Apprise._parse_retry_filter_tokens(tag) if not retry_tokens: # No service can match when the filter has no retry override. return all_calls # Build new call pairs without changing the caller's list. result = [] for service, kwargs in all_calls: # The first matching filter token decides this service's override. retry = Apprise._match_service_retry(service, retry_tokens) if retry is not None: # Copy kwargs so other services keep their original options. kwargs = dict(kwargs, _retry_override=retry) result.append((service, kwargs)) # Keep service ordering exactly as it was received. return result @staticmethod def _resolve_call_level( effective_log_level: Optional[int], effective_log_callback: Optional[ Callable[[NotifyLogEntry, Optional[NotifyBase]], None] ], ) -> int: """Resolve the explicit level or the callback-aware default.""" # A level supplied by the caller always takes priority. if effective_log_level is not None: return effective_log_level # Live callbacks usually need progress messages as well as warnings. if effective_log_callback is not None: return logging.INFO # Preserve the quieter result-only default when no callback is active. return logging.WARNING @staticmethod def _build_tag_chains(all_calls, tag): """Group *all_calls* into per-OR-token escalation chains. Returns {chain_key: {priority: [(service, kwargs)]}}. Each service joins its first matching OR chain; unmatched services use ``""``. Match-all filters create one ``""`` chain. """ if tag is None or tag == common.MATCH_ALL_TAG: # Match-all has no tag priority, so every service uses one chain. chain: dict[int, list] = {} for service, kwargs in all_calls: chain.setdefault(0, []).append((service, kwargs)) return {"": chain} # Flatten OR tokens while keeping true AND groups in the catch-all # chain. The CLI wraps a single --tag value in a one-item list, so # treat that form as an OR token rather than an AND group. # Use the same order as retry matching so sets behave consistently. or_tag_names: list[str] = [] for entry in Apprise._filter_entries(tag): if isinstance(entry, (list, tuple, set)): flat = parse_list(*entry) if entry else [] if len(flat) == 1: # single OR token wrapped in a list (CLI convention) or_tag_names.append(str(AppriseTag.parse(flat[0]))) else: or_tag_names.append("") # AND group placeholder else: for tok in parse_list(str(entry)): or_tag_names.append(str(AppriseTag.parse(tok))) # Reuse these names when assigning services without an OR chain. filter_names = { str(token) for token in Apprise._parse_filter_tokens(tag) } chains: dict[str, dict[int, list]] = {} for service, kwargs in all_calls: for chain_key in or_tag_names: if chain_key and chain_key in service.tags: p = Apprise._service_priority_for_tag_name( service, chain_key ) chains.setdefault(chain_key, {}).setdefault(p, []).append( (service, kwargs) ) break else: # No named OR chain matched, so use the catch-all chain. # Choose the most urgent matching priority, or zero if none # of the service's tags appear in the filter. priorities = [ stag.priority if isinstance(stag, AppriseTag) else 0 for stag in service.tags if str(stag) in filter_names ] p = min(priorities) if priorities else 0 chains.setdefault("", {}).setdefault(p, []).append( (service, kwargs) ) return chains @staticmethod def _split_and_dispatch( batch: list[ServiceCall], call_deadline: Optional[float] = None ) -> tuple[bool, list[NotifyResult]]: """Dispatch sequential and parallel subsets of ``batch``. Results keep the caller's original order. ``call_deadline`` is passed through to the dispatch helpers. """ # Remember positions while splitting so results retain input order. sequential: list = [] parallel: list = [] for index, (service, kwargs) in enumerate(batch): # Each service's own asset decides how it gets dispatched. group = parallel if service.asset.async_mode else sequential group.append((index, service, kwargs)) # Run services that require ordered, one-at-a-time delivery. seq_ok, seq_results = ( Apprise._notify_sequential( *[(s, k) for _, s, k in sequential], call_deadline=call_deadline, ) if sequential else (True, []) ) # Run services that allow worker-thread delivery. par_ok, par_results = ( Apprise._notify_parallel_threadpool( *[(s, k) for _, s, k in parallel], call_deadline=call_deadline ) if parallel else (True, []) ) # Restore each subset's results to their original positions. merged: list[NotifyResult] = [None] * len(batch) for (index, _, _), result in zip(sequential, seq_results): # Put each ordered result back where its service began. merged[index] = result for (index, _, _), result in zip(parallel, par_results): # Do the same for results from the worker pool. merged[index] = result # Both subsets must succeed for the complete batch to succeed. return seq_ok and par_ok, merged @staticmethod async def _split_and_dispatch_async( batch: list[ServiceCall], call_deadline: Optional[float] = None ) -> tuple[bool, list[NotifyResult]]: """Dispatch sequential and asynchronous subsets of ``batch``. Both subsets run together without blocking the event loop. Results retain their original order. """ # Remember positions while splitting so results retain input order. sequential: list = [] parallel: list = [] for index, (service, kwargs) in enumerate(batch): # Each service's own asset decides how it gets dispatched. group = parallel if service.asset.async_mode else sequential group.append((index, service, kwargs)) # Use the caller's active event loop for the blocking subset. loop = asyncio.get_running_loop() # Run the blocking coordinator outside the leaf-call pool it awaits. executor = get_coordinator_executor() # Start the blocking batch in the executor so both subsets overlap # without blocking this event loop. seq_future = ( loop.run_in_executor( executor, contextvars.copy_context().run, partial( Apprise._notify_sequential, *[(s, k) for _, s, k in sequential], call_deadline=call_deadline, ), ) if sequential else None ) # Start and await services that support asynchronous delivery. par_ok, par_results = ( await Apprise._notify_parallel_asyncio( *[(s, k) for _, s, k in parallel], call_deadline=call_deadline ) if parallel else (True, []) ) # Collect the blocking batch, which may already be complete. seq_ok, seq_results = await seq_future if seq_future else (True, []) # Restore each subset's results to their original positions. merged: list[NotifyResult] = [None] * len(batch) for (index, _, _), result in zip(sequential, seq_results): # Put each ordered result back where its service began. merged[index] = result for (index, _, _), result in zip(parallel, par_results): # Do the same for asynchronously delivered results. merged[index] = result # Both subsets must succeed for the complete batch to succeed. return seq_ok and par_ok, merged def notify( self, body: Union[str, bytes], title: Union[str, bytes] = "", notify_type: Union[str, common.NotifyType] = common.NotifyType.INFO, body_format: Optional[str] = None, tag: Any = common.MATCH_ALL_TAG, match_always: bool = True, attach: Any = None, interpret_escapes: Optional[bool] = None, template: Optional[dict] = None, timeout: Union[int, float] = 0, log_callback: Optional[ Callable[[NotifyLogEntry, Optional[NotifyBase]], None] ] = None, log_level: Optional[int] = None, ) -> AppriseResult: """Send a notification to all the plugins previously loaded. If the body_format specified is NotifyFormat.MARKDOWN, it will be converted to HTML if the Notification type expects this. if the tag is specified (either a string or a set/list/tuple of strings), then only the notifications flagged with that tagged value are notified. By default, all added services are notified (tag=MATCH_ALL_TAG) Delivery and message-validation outcomes return ``AppriseResult``. ``bool(result)`` preserves the previous True/False behavior, while its status distinguishes success, failure, no match, and timeout. Iterate the result to inspect each service actually dispatched: result = apobj.notify(body="hello") for service_result in result: print(service_result.name, bool(service_result)) ``result.logs()`` combines service and orchestration entries in time order. Orchestration-only entries are also available in ``call_logs``. A filter tag may carry an optional priority prefix and/or retry suffix: "endpoint" -> match all entries; escalate by priority "3:endpoint" -> match ONLY priority-3 entries; flat dispatch "endpoint:2" -> match all entries; retry each up to 2 times "3:endpoint:2" -> exclusive priority-3 match with 2 retries When no priority prefix is given, matched services are grouped by their configured tag priority and dispatched in ascending order (lowest number = highest urgency). If every service in the lowest priority group succeeds, Apprise returns success immediately without running higher-numbered priority groups (escalation chain). When an explicit priority prefix IS given (e.g. "3:endpoint"), only services whose matching tag carries that exact priority are notified, and all matched services are dispatched as a single flat batch. Attach can contain a list of attachment URLs. attach can also be represented by an AttachBase() (or list of) object(s). This identifies the products you wish to notify Set interpret_escapes to True if you want to pre-escape a string such as turning a \n into an actual new line, etc. ``template`` supplies values for any YAML configuration entry written with ``${NAME}``. A value not given here is looked for in the configuration's own defaults and then in ``APPRISE_TEMPLATE_``. Blank call values are ignored, while an empty configuration default remains valid. An entry still missing a value is skipped, and the overall status reports PARTIAL rather than SUCCESS. ``timeout`` limits the entire call in seconds; unfinished services report TIMEOUT. The earlier call or service limit applies. A value of 0 leaves only the service limit active. Values must be finite, non-negative numbers; invalid values raise ``AppriseImproperlyConfigured``. log_callback overrides the instance default for this call. It must be synchronous; schedule any async work from inside the callback. ``service`` is ``None`` for a call-level entry (see ``result.call_logs()`` above). log_level overrides the capture level for this call. It defaults to WARNING, or INFO when a log_callback is active. Use DEBUG or TRACE for more detail. """ with CallState(self, tag, timeout, log_callback, log_level) as call: try: all_calls = list( self._create_notify_gen( body, title, notify_type=notify_type, body_format=body_format, tag=tag, match_always=match_always, attach=attach, interpret_escapes=interpret_escapes, template=template, report=call.skipped, ) ) except Exception as e: # A single service that fails is handled per service, so # anything reaching here is a problem with the call: a # message Apprise cannot use, or nothing to send at all. return call.unprepared(e) if not all_calls: # Tag filter matched nothing, or no services are loaded at all. return call.result(AppriseResultStatus.NOMATCH) # Apply the first matching retry suffix to each service. all_calls = call.prepare(all_calls) if Apprise._filter_has_explicit_priority(tag): # An explicit priority sends one flat batch without escalation. try: outcome = Apprise._split_and_dispatch( all_calls, call_deadline=call.deadline ) except Exception as e: # Hand the crash over as the batch outcome. outcome = e return call.flat(outcome) # Without an explicit priority: # - Each OR tag becomes an independent chain. # - Each chain starts at its highest priority. # - A failed group advances only its own chain. # - Active chains run concurrently. call.escalate(all_calls) for active in call.rounds(): if len(active) == 1: # Single active chain: dispatch directly, no thread # overhead. chain = active[0] try: outcome = Apprise._split_and_dispatch( chain.batch, call_deadline=call.deadline ) except Exception as e: # Hand the crash over as the batch outcome. outcome = e call.settle(chain, outcome) continue # Run active chains in the coordinator pool so their # service calls can use the shared worker pool. executor = get_coordinator_executor() future_map = { submit_with_context( executor, Apprise._split_and_dispatch, chain.batch, call.deadline, ): chain for chain in active } # Collect in submission order so results are stable # even when chains finish in a different order. for future, chain in future_map.items(): try: outcome = future.result() except Exception as e: # Hand the crash over as the batch outcome. outcome = e call.settle(chain, outcome) return call.finish() async def async_notify(self, *args: Any, **kwargs: Any) -> AppriseResult: """Asynchronously notify all loaded plugins. Arguments and results match :meth:`notify`, including ``timeout``, ``log_callback``, and ``log_level``. """ tag = kwargs.get("tag", common.MATCH_ALL_TAG) # Pop these -- none is a _create_notify_gen() parameter. with CallState( self, tag, kwargs.pop("timeout", 0), kwargs.pop("log_callback", None), kwargs.pop("log_level", None), ) as call: # Entries held back because a template value was never supplied. kwargs["report"] = call.skipped try: all_calls = list(self._create_notify_gen(*args, **kwargs)) except Exception as e: # As in notify(), but this signature takes *args/**kwargs, # so an unknown argument lands here too instead of being # rejected before the block above runs. return call.unprepared(e) if not all_calls: # Tag filter matched nothing, or no services are loaded at all. return call.result(AppriseResultStatus.NOMATCH) # Inject per-service call-time retry overrides (same logic as # notify). all_calls = call.prepare(all_calls) if Apprise._filter_has_explicit_priority(tag): # Explicit priority prefix: flat dispatch, no escalation. try: outcome = await Apprise._split_and_dispatch_async( all_calls, call_deadline=call.deadline ) except Exception as e: # Hand the crash over as the batch outcome. outcome = e return call.flat(outcome) # Use the same independent escalation chains as notify(). Active # groups run together; only a failed chain advances. call.escalate(all_calls) for active in call.rounds(): # Run active chains together. Keep one failure from cancelling # the others; gather() hands a cancellation back as a value, # so settle() receives it like any other outcome. gathered = await asyncio.gather( *( Apprise._split_and_dispatch_async( chain.batch, call_deadline=call.deadline ) for chain in active ), return_exceptions=True, ) for chain, outcome in zip(active, gathered): call.settle(chain, outcome) return call.finish() def _create_notify_calls(self, *args, **kwargs): """Creates notifications for all the plugins loaded. Returns a list of (service, notify() kwargs) tuples for plugins with parallelism disabled and another list for plugins with parallelism enabled. """ all_calls = list(self._create_notify_gen(*args, **kwargs)) # Split into sequential and parallel notify() calls. sequential, parallel = [], [] for service, notify_kwargs in all_calls: if service.asset.async_mode: parallel.append((service, notify_kwargs)) else: sequential.append((service, notify_kwargs)) return sequential, parallel def _create_notify_gen( self, body, title="", notify_type=common.NotifyType.INFO, body_format=None, tag=common.MATCH_ALL_TAG, match_always=True, attach=None, interpret_escapes=None, template=None, report=None, ): """Internal generator function for _create_notify_calls(). A service that raises while its content is prepared is still yielded, carrying its exception, so dispatch reports it only if a chain actually reaches it. """ if len(self) == 0: # Nothing loaded -- same as an empty tag match: NOMATCH, not # FAILURE. logger.warning("There are no service(s) to notify") return if not (title or body or attach): msg = "No message content specified to deliver" logger.error(msg) raise AppriseImproperlyConfigured(msg) try: notify_type = ( notify_type if isinstance(notify_type, common.NotifyType) else common.NotifyType(notify_type.lower()) ) except (AttributeError, ValueError, TypeError): err = ( f"An invalid notification type ({notify_type}) was specified." ) raise AppriseImproperlyConfigured(err) from None try: if title and isinstance(title, bytes): title = title.decode(self.asset.encoding) if body and isinstance(body, bytes): body = body.decode(self.asset.encoding) except UnicodeDecodeError: msg = ( "The content passed into Apprise was not of encoding " f"type: {self.asset.encoding}" ) logger.error(msg) raise AppriseImproperlyConfigured(msg) from None # Normalize falsy values. Each service applies the cap from its own # asset below, which may differ from ``self.asset``. title = title or "" body = body or "" # Tracks conversions conversion_body_map = {} conversion_title_map = {} # Prepare attachments if required if attach is not None and not isinstance(attach, AppriseAttachment): attach = AppriseAttachment( attach, asset=self.asset, location=self.location ) # Allow Asset default value body_format = ( self.asset.body_format if body_format is None else body_format ) # Allow Asset default value interpret_escapes = ( self.asset.interpret_escapes if interpret_escapes is None else interpret_escapes ) # Iterate over our loaded plugins for service in self.find( tag, match_always=match_always, template=template, report=report, ): # If our code reaches here, we either did not define a tag (it # was set to None), or we did define a tag and the logic above # determined we need to notify the service it's associated with # One misbehaving plugin must not stop the rest, so # anything raised while preparing this service's content # fails only this service. try: # Resolve this service's actual output format for this call. # A single-format service always uses its declared format. A # multi-format service may resolve differently for each call, # based on its URL's ``format`` option or the ``body_format`` # supplied to notify(). target_format = service.resolve_format(body_format) # Apply the service's own cap before conversion. Its asset may # differ from the top-level asset and have a smaller limit. capped_title, capped_body = ( service.asset.enforce_payload_max_size(title, body) ) capped_len = len(capped_title) + len(capped_body) if capped_len < len(title) + len(body): logger.warning( "%s payload trimmed to stay within the configured " "payload_max_size of %d characters.", service.service_name, service.asset._payload_max_size, ) # Cache by the resolved format, title handling, and # payload cap. Services with the same output needs can # share converted content. key = ( target_format if service.title_maxlen > 0 else f"_{target_format}" ) if service.asset._payload_max_size: # Allocation settings can produce different capped content, # so each combination needs its own conversion. key += ( f"-cap{service.asset._payload_max_size}" f"-buf{service.asset._payload_buffer_threshold}" f"-min{service.asset._payload_min_buffer}" ) if service.interpret_emojis: # alter our key slightly to handle emojis since # their value is pulled out of the notification key += "-emojis" if key not in conversion_title_map: # Prepare our title source_title = capped_title if capped_title else "" source_body = capped_body # Apply escapes and emojis before format conversion so # their source markers are still recognizable. if interpret_escapes: # # Escape our content # try: source_body = decode_escapes(source_body) source_title = decode_escapes(source_title) except TypeError: # Must be of string type msg = "Failed to escape message body" logger.error(msg) raise AppriseImproperlyConfigured(msg) from None if service.interpret_emojis: # # Convert our :emoji: definitions # source_body = apply_emojis(source_body) source_title = apply_emojis(source_title) # Conversion of title only occurs for services # where the title is blended with the body # (title_maxlen <= 0) conversion_title_map[key] = ( convert_between( body_format, target_format, content=source_title, ) if source_title and service.title_maxlen <= 0 else source_title ) # Our body is always converted no matter what conversion_body_map[key] = convert_between( body_format, target_format, content=source_body ) except AppriseImproperlyConfigured: # Bad input from the caller is not this service's # fault; it stops the whole call as it always has. raise except Exception as e: # Hand the failure to dispatch rather than reporting it # now. A fallback that escalation never reaches is then # never blamed, and an optional service stays optional. yield (service, {"_prepare_error": e}) continue kwargs = { "body": conversion_body_map[key], "title": conversion_title_map[key], "notify_type": notify_type, "attach": attach, # Pass the resolved target format; downstream notify() # calls use it directly without resolving again. # Preserve whether the caller omitted a source format so # downstream code skips automatic format conversion. "body_format": target_format, "body_passthrough": body_format is None, # Confirm the source was capped before conversion. The private # token prevents direct callers from skipping their own cap. "_payload_precapped": _PAYLOAD_PRECAPPED, } yield (service, kwargs) @staticmethod def _notify_sequential( *services_kwargs: ServiceCall, call_deadline: Optional[float] = None ) -> tuple[bool, list[NotifyResult]]: """Process a list of notify() calls one at a time, in order. Calls with deadlines use the shared executor so Apprise can stop waiting on a blocked service while preserving result order. """ success = True results: list[NotifyResult] = [] for service, kwargs in services_kwargs: # The outer wait needs a deadline before submission. deadline = compute_deadline(service, call_deadline) # Preserve retry metadata before the worker consumes its override. max_attempts = configured_max_attempts(service, kwargs) if deadline is None: ok, notify_result = call_with_retry(service, kwargs, None) success = success and ok results.append(notify_result) continue # Allow a small grace window before abandoning the wait. abandon_at = deadline + _ABANDON_GRACE_SECONDS wait_start = time.monotonic() wait_for = max(0.0, abandon_at - wait_start) logger.trace( "Waiting up to %.3fs for '%s'.", wait_for, service.service_name, ) executor = get_shared_executor() future = submit_with_context( executor, call_with_retry, service, kwargs, deadline ) try: # Keep a final guard for unexpected executor failures. ok, notify_result = future.result(timeout=wait_for) logger.trace( "'%s' finished after %.3fs: %s.", service.service_name, time.monotonic() - wait_start, "success" if ok else "failure", ) except cf.TimeoutError: # The service took too long; report TIMEOUT and move on. wait_elapsed = time.monotonic() - wait_start # Track only work that already started and cannot be cancelled. cancelled = future.cancel() if not cancelled: name, url, _, _, _ = service_metadata(service) track_abandoned_future(future, name, url) logger.trace( "Stopped waiting for '%s' after %.3fs (%s).", service.service_name, wait_elapsed, "it was still queued and has been cancelled" if cancelled else "its worker thread may still be running in the " "background", ) notify_result = timeout_result( service, wait_elapsed, max_attempts, ) ok = bool(notify_result) except Exception as e: # Safety net; one crash must not sink the whole batch. notify_result = service_crashed(service, e) ok = bool(notify_result) # One required failure means the whole batch cannot succeed. # Optional failures already count as SUCCESS in NotifyResult. success = success and ok results.append(notify_result) return success, results @staticmethod def _notify_parallel_threadpool( *services_kwargs: ServiceCall, call_deadline: Optional[float] = None ) -> tuple[bool, list[NotifyResult]]: """Process a list of notify() calls in parallel via a thread pool. Each worker handles retries and deadlines for one service. Timed-out workers may keep running, but Apprise stops waiting. """ n_calls = len(services_kwargs) if n_calls == 0: return True, [] if n_calls == 1: service, _ = services_kwargs[0] # Only take the no-thread-pool shortcut when this service has # no deadline whatsoever -- there is nothing to abandon, so a # plain blocking call is strictly cheaper and behaves # identically. Otherwise fall through to the thread-pool path # below so the deadline can actually be enforced. if compute_deadline(service, call_deadline) is None: return Apprise._notify_sequential( services_kwargs[0], call_deadline=call_deadline ) logger.debug("Threaded notification mode") logger.info("Notifying %d service(s).", len(services_kwargs)) # Keep output ordered by input, though threads finish out of order. # This is the shared, process-wide pool (see get_shared_executor()), # not a fresh one per call -- never shut down here, it persists for # the life of the process so a chronically hanging endpoint cannot # leak one more permanently-running thread with every call. executor = get_shared_executor() success = True results: list[Optional[NotifyResult]] = [None] * n_calls # Snapshot every service's deadline once, right at submission # time (they all start at essentially the same instant here). deadlines: list[Optional[float]] = [ compute_deadline(service, call_deadline) for service, kwargs in services_kwargs ] # Preserve retry metadata before workers consume private overrides. max_attempts = [ configured_max_attempts(service, kwargs) for service, kwargs in services_kwargs ] future_to_idx: dict[cf.Future, int] = { submit_with_context( executor, call_with_retry, service, kwargs, deadlines[i] ): i for i, (service, kwargs) in enumerate(services_kwargs) } for future, idx in future_to_idx.items(): service = services_kwargs[idx][0] # Give each expired service one grace window, not one per loop. abandon_at = ( deadlines[idx] + _ABANDON_GRACE_SECONDS if deadlines[idx] is not None else None ) wait_start = time.monotonic() wait_for = ( max(0.0, abandon_at - wait_start) if abandon_at is not None else None ) logger.trace( "Waiting up to %s for '%s'.", "no limit" if wait_for is None else f"{wait_for:.3f}s", service.service_name, ) try: # future.result() re-raises any exception that escaped # call_with_retry (should not happen given the inner # try/except, but guard here as a safety net). ok, notify_result = future.result(timeout=wait_for) logger.trace( "'%s' finished after %.3fs: %s.", service.service_name, time.monotonic() - wait_start, "success" if ok else "failure", ) except cf.TimeoutError: # Stop waiting once this service's grace window is spent. # NotifyResult keeps optional services successful. wait_elapsed = time.monotonic() - wait_start # Still queued -> cancel() succeeds, nothing to track. # Already running -> cancel() fails, so track it instead. cancelled = future.cancel() if not cancelled: name, url, _, _, _ = service_metadata(service) track_abandoned_future(future, name, url) logger.trace( "Stopped waiting for '%s' after %.3fs (%s).", service.service_name, wait_elapsed, "it was still queued and has been cancelled" if cancelled else "its worker thread may still be running in the " "background", ) notify_result = timeout_result( service, wait_elapsed, max_attempts[idx], ) ok = bool(notify_result) except Exception as e: # Safety net; one crash must not sink the whole batch. notify_result = service_crashed(service, e) ok = bool(notify_result) success = success and ok results[idx] = notify_result return success, results @staticmethod async def _notify_parallel_asyncio( *services_kwargs: ServiceCall, call_deadline: Optional[float] = None ) -> tuple[bool, list[NotifyResult]]: """Process a list of async_notify() calls concurrently via asyncio. Each coroutine handles one service, including retry and wait logic. The outer wait_for() keeps one stuck service from blocking its peers. A timeout means Apprise stops waiting and reports TIMEOUT. If the plugin is running sync work in a worker thread, that work may still finish later. """ n_calls = len(services_kwargs) if n_calls == 0: return True, [] logger.debug("Asynchronous notification mode") logger.info("Notifying %d service(s).", len(services_kwargs)) async def do_call( service: NotifyBase, kwargs: dict[str, Any], deadline: Optional[float], ) -> tuple[bool, NotifyResult]: """Run one asynchronous service with retries and waits. Plugin errors become failed attempts so retries can continue. Reuse the caller's deadline so the outer wait and worker agree. """ # A service that could not be prepared is never called at all. failed = prepared_failure(service, kwargs) if failed is not None: return failed runner = RetryRunner(service, kwargs, deadline) try: for attempt in range(runner.total): started = runner.begin(attempt) if started is None: break # Treat validation errors and plugin crashes alike, # matching synchronous delivery. with runner.capture() as capture: try: result = await service.async_notify(**kwargs) except Exception as e: runner.crashed(e) result = False if runner.record(attempt, result, started, capture): break delay = runner.delay(attempt) if delay > 0: await asyncio.sleep(delay) finally: runner.close() return runner.result() async def do_call_bounded( service: NotifyBase, kwargs: dict[str, Any], deadline: Optional[float], max_attempts: int, ) -> tuple[bool, NotifyResult]: """Apply an outer asyncio timeout to one service call. The service still owns its normal retry deadline inside do_call(). This wrapper limits how long this batch waits for the result. """ remaining = ( max(0.0, deadline - time.monotonic()) if deadline is not None else None ) # Add one small grace window so a nearly-finished service can # settle before it is reported as abandoned. wait_for = ( remaining + _ABANDON_GRACE_SECONDS if remaining is not None else None ) logger.trace( "Waiting up to %s for '%s'.", "no limit" if wait_for is None else f"{wait_for:.3f}s", service.service_name, ) wait_start = time.monotonic() try: # timeout=None makes wait_for() behave like a plain await. # This keeps the bounded and unbounded paths together. ok, notify_result = await asyncio.wait_for( do_call(service, kwargs, deadline), timeout=wait_for ) logger.trace( "'%s' finished after %.3fs: %s.", service.service_name, time.monotonic() - wait_start, "success" if ok else "failure", ) return ok, notify_result except asyncio.TimeoutError: # Derive the outcome from NotifyResult so an optional timeout # remains successful. # Apprise stops waiting here; it does not promise delivery # work has stopped. A send already running in the shared # executor cannot be cancelled, so NotifyBase tracks that # worker until it finishes. wait_elapsed = time.monotonic() - wait_start logger.trace( "Stopped waiting for '%s' after %.3fs; it may still " "be finishing in the background.", service.service_name, wait_elapsed, ) notify_result = timeout_result( service, wait_elapsed, max_attempts, ) return bool(notify_result), notify_result # Snapshot outer wait deadlines before launching the async workers; # do_call() reuses the same value instead of recomputing its own. deadlines: list[Optional[float]] = [ compute_deadline(service, call_deadline) for service, kwargs in services_kwargs ] # Preserve retry metadata before coroutines consume private overrides. max_attempts = [ configured_max_attempts(service, kwargs) for service, kwargs in services_kwargs ] # Run all coroutines concurrently. return_exceptions=True ensures # one escaped exception is reported without cancelling other services. cors = ( do_call_bounded( service, kwargs, deadlines[i], max_attempts[i], ) for i, (service, kwargs) in enumerate(services_kwargs) ) gathered = await asyncio.gather(*cors, return_exceptions=True) success = True results: list[NotifyResult] = [] for idx, item in enumerate(gathered): service = services_kwargs[idx][0] # gather() hands back BaseException, so a cancellation lands # here too instead of being unpacked as a result pair. if isinstance(item, BaseException): # Safety net: an exception escaped do_call's own try/except. notify_result = service_crashed(service, item) success = success and bool(notify_result) results.append(notify_result) else: ok, notify_result = item success = success and ok results.append(notify_result) return success, results def json( self, lang: Optional[str] = None, show_requirements: bool = False, show_disabled: bool = False, indent: Optional[int] = None, path: Optional[str] = None, ) -> Union[str, bool]: """Returns a json response associated with the Apprise object.""" details = self.details( lang=lang, show_requirements=show_requirements, show_disabled=show_disabled, ) if not path: return json.dumps( details, separators=JSON_COMPACT_SEPARATORS, indent=indent, cls=AppriseJSONEncoder, ) # Accented characters are written out as they are (see # ensure_ascii below), so the stream has to be able to hold them. # UTF-8 is named here rather than leaving it to the locale of # whoever is running Apprise. with open(path, "w", encoding="utf-8") as fp: try: json.dump( details, fp, separators=JSON_COMPACT_SEPARATORS, indent=indent, cls=AppriseJSONEncoder, ensure_ascii=False, ) except (OSError, EOFError) as e: logger.error("Apprise details dumpfile inaccessible: %s", path) logger.debug("Apprise details dump Exception: %s", e) # Early Exit return False finally: # Reduce memory del details return True def details( self, lang: Optional[str] = None, show_requirements: bool = False, show_disabled: bool = False, ) -> dict[str, Any]: """Returns the details associated with the Apprise object.""" # Use the asset language when the caller does not provide one. lang = lang if lang else self.asset.language # general object returned response = { # Defines the current version of Apprise "version": __version__, # Lists all of the currently supported Notifications "schemas": [], # Includes the configured asset details "asset": self.asset.details(), } for plugin in N_MGR.plugins(): # Iterate over our hashed plugins and dynamically build details on # their status: content = { "service_name": getattr(plugin, "service_name", None), "service_url": getattr(plugin, "service_url", None), "setup_url": getattr(plugin, "setup_url", None), # Placeholder - populated below "details": None, # Let upstream service know of the plugins that support # attachments "attachment_support": getattr( plugin, "attachment_support", False ), # Differentiat between what is a custom loaded plugin and # which is native. "category": getattr(plugin, "category", None), } # Standard protocol(s) should be None or a tuple enabled = getattr(plugin, "enabled", True) if not show_disabled and not enabled: # Do not show inactive plugins continue elif show_disabled: # Add current state to response content["enabled"] = enabled # Standard protocol(s) should be None or a tuple protocols = getattr(plugin, "protocol", None) if isinstance(protocols, str): protocols = (protocols,) # Secure protocol(s) should be None or a tuple secure_protocols = getattr(plugin, "secure_protocol", None) if isinstance(secure_protocols, str): secure_protocols = (secure_protocols,) # Add our protocol details to our content content.update( { "protocols": protocols, "secure_protocols": secure_protocols, } ) if not lang: # Simply return our results content["details"] = plugins.details(plugin) if show_requirements: content["requirements"] = plugins.requirements(plugin) else: # Emulate the specified language when returning our results with self.locale.lang_at(lang): content["details"] = plugins.details(plugin) if show_requirements: content["requirements"] = plugins.requirements(plugin) # Build our response object response["schemas"].append(content) return response def template_vars( self, tag: Any = common.MATCH_ALL_TAG, match_always: bool = True, ) -> dict[str, dict]: """Summarize the template variables used by loaded entries. Returns a mapping of variable name to a small summary:: {"api_key": {"default": None, "services": 2}, "smtp_host": {"default": "smtp.example.com", "services": 1}} ``default`` is ``None`` when no configuration default applies, either because none was written or because two configurations disagreed on one. A value may still arrive from ``APPRISE_TEMPLATE_``, so ``None`` does not always mean the caller has to supply it. Defaults are configuration content and should only be shared with authorized users. """ response: dict[str, dict] = {} for service in self.find( tag, match_always=match_always, resolve=False ): if not isinstance(service, NotifyTemplate): continue for name in service.template_names: variable = service.template_schema.variables[name] if name not in response: response[name] = { "default": variable.default, "services": 0, } elif response[name]["default"] != variable.default: # Two configurations disagree on the default. Keep # the stricter reading so nothing is quietly sent # with a value its author did not choose. logger.warning( "Template variable '%s' is declared differently" " in more than one configuration", name, ) response[name]["default"] = None response[name]["services"] += 1 return response def urls(self, privacy: bool = False) -> list[str]: """Returns all of the loaded URLs defined in this apprise object.""" urls = [] for s in self.services: if isinstance(s, (ConfigBase, AppriseConfig)): for s_ in s.services(): urls.append(s_.url(privacy=privacy)) else: urls.append(s.url(privacy=privacy)) return urls def pop(self, index: int) -> NotifyBase: """Remove and return the notification service at ``index``. Indexing uses the flattened service view: directly added plugins and plugins discovered inside configuration sources share one continuous sequence. Configuration containers are never popped by this method. When ``index`` identifies one of their services, that service is removed from the container while the configuration source remains loaded. An out-of-range index raises :class:`IndexError`. """ # Tracking variables prev_offset = -1 offset = prev_offset for idx, s in enumerate(self.services): if isinstance(s, (ConfigBase, AppriseConfig)): services = s.services() if len(services) > 0: # Acquire a new maximum offset to work with offset = prev_offset + len(services) if offset >= index: # we can pop an element from our config stack fn = ( s.pop if isinstance(s, ConfigBase) else s.service_pop ) return fn( index if prev_offset == -1 else (index - prev_offset - 1) ) else: offset = prev_offset + 1 if offset == index: return self.services.pop(idx) # Update our old offset prev_offset = offset # If we reach here, then we indexed out of range raise IndexError("list index out of range") def __getitem__(self, index: int) -> NotifyBase: """Return a service by its index in the flattened service view. Configuration sources themselves are not addressable here. Their discovered services occupy positions in the same sequence as services added directly. An out-of-range index raises :class:`IndexError`. """ # Tracking variables prev_offset = -1 offset = prev_offset for idx, s in enumerate(self.services): if isinstance(s, (ConfigBase, AppriseConfig)): # Get our list of services associate with our config object services = s.services() if len(services) > 0: # Acquire a new maximum offset to work with offset = prev_offset + len(services) if offset >= index: return services[ ( index if prev_offset == -1 else (index - prev_offset - 1) ) ] else: offset = prev_offset + 1 if offset == index: return self.services[idx] # Update our old offset prev_offset = offset # If we reach here, then we indexed out of range raise IndexError("list index out of range") def __getstate__(self) -> dict[str, object]: """Pickle Support dumps()""" attributes = { "asset": self.asset, # Prepare our URL list as we need to extract the associated tags # and asset details associated with it "urls": [ { "url": service.url(privacy=False), "tag": service.tags if service.tags else None, "asset": service.asset, } for service in self.services ], "locale": self.locale, "debug": self.debug, "location": self.location.value if self.location else None, } return attributes def __setstate__(self, state: dict[str, object]) -> None: """Pickle Support loads()""" self.services = [] self.asset = state["asset"] self.locale = state["locale"] location = state.get("location") self.location = ( location if isinstance(location, ContentLocation) else ContentLocation(location) if location is not None else None ) for entry in state["urls"]: self.add(entry["url"], asset=entry["asset"], tag=entry["tag"]) def __bool__(self) -> bool: """Allows the Apprise object to be wrapped in an 'if statement'. True is returned if at least one service has been loaded. """ return len(self) > 0 def __iter__(self) -> Iterator[NotifyBase]: """Iterate over the flattened collection of loaded services. Configuration containers are not yielded. Instead, each service discovered inside them is yielded alongside directly added services. """ return chain( *[ ( [s] if not isinstance(s, (ConfigBase, AppriseConfig)) else iter(s.services()) ) for s in self.services ] ) def __len__(self) -> int: """Return the size of the flattened collection of loaded services. Directly added notification plugins each count as one. Configuration containers do not count as entries themselves; every service currently discovered inside them does. Calling ``len()`` may therefore cause a configuration source to be read or refreshed according to its cache policy. """ return sum( ( 1 if not isinstance(s, (ConfigBase, AppriseConfig)) else len(s.services()) ) for s in self.services ) caronc-apprise-dfec414/apprise/apprise_attachment.py000066400000000000000000000341541526720371000230160ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from collections.abc import Iterator, Sequence, Set as AbstractSet from typing import Any, Optional, Union from .asset import AppriseAsset from .attachment.base import AttachBase from .common import ContentLocation from .exception import AppriseImproperlyConfigured from .logger import logger from .manager_attachment import AttachmentManager from .url import URLBase from .utils.cwe312 import cwe312_loggable from .utils.parse import GET_SCHEMA_RE # Grant access to our Notification Manager Singleton A_MGR = AttachmentManager() class AppriseAttachment: """Our Apprise Attachment File Manager.""" def __init__( self, paths: Optional[ Union[ str, AttachBase, Sequence[Union[str, AttachBase, "AppriseAttachment"]], AbstractSet[Union[str, AttachBase, "AppriseAttachment"]], ] ] = None, asset: Optional[AppriseAsset] = None, cache: Union[bool, int] = True, location: Optional[Union[str, ContentLocation]] = None, **kwargs: Any, ) -> None: """Loads all of the paths/urls specified (if any). The path can either be a single string identifying one explicit location, otherwise you can pass in a series of locations to scan via a list. By default we cache our responses so that subsiquent calls does not cause the content to be retrieved again. For local file references this makes no difference at all. But for remote content, this does mean more then one call can be made to retrieve the (same) data. This method can be somewhat inefficient if disabled. Only disable caching if you understand the consequences. You can alternatively set the cache value to an int identifying the number of seconds the previously retrieved can exist for before it should be considered expired. It's also worth nothing that the cache value is only set to elements that are not already of subclass AttachBase() Optionally set your current ContentLocation in the location argument. This is used to further handle attachments. The rules are as follows: - INACCESSIBLE: You simply have disabled use of the object; no attachments will be retrieved/handled. - HOSTED: You are hosting an attachment service for others. In these circumstances all attachments that are LOCAL based (such as file://) will not be allowed. - LOCAL: The least restrictive mode as local files can be referenced in addition to hosted. In all but HOSTED and LOCAL modes, INACCESSIBLE attachment types will continue to be inaccessible. However if you set this field (location) to None (it's default value) the attachment location category will not be tested in any way (all attachment types will be allowed). The location field is also a global option that can be set when initializing the Apprise object. """ # Initialize our attachment listings self.attachments = [] # Set our cache flag self.cache = cache # Prepare our Asset Object self.asset = ( asset if isinstance(asset, AppriseAsset) else AppriseAsset() ) if location: try: self.location = ( location if isinstance(location, ContentLocation) else ContentLocation(location.lower()) ) except (AttributeError, ValueError): err = ( f"An invalid Attachment location ({location}) was " "specified.", ) logger.warning(err) raise AppriseImproperlyConfigured(err) from None else: # do not set location if no initialization was made for it self.location = None # Now parse any paths specified if paths is not None and not self.add(paths): raise AppriseImproperlyConfigured( "One or more attachments could not be added." ) def add( self, attachments: Union[ str, AttachBase, "AppriseAttachment", Sequence[Union[str, AttachBase, "AppriseAttachment"]], AbstractSet[Union[str, AttachBase, "AppriseAttachment"]], ], asset: Optional[AppriseAsset] = None, cache: Optional[Union[bool, int]] = None, ) -> bool: """Adds one or more attachments into our list. By default we cache our responses so that subsiquent calls does not cause the content to be retrieved again. For local file references this makes no difference at all. But for remote content, this does mean more then one call can be made to retrieve the (same) data. This method can be somewhat inefficient if disabled. Only disable caching if you understand the consequences. You can alternatively set the cache value to an int identifying the number of seconds the previously retrieved can exist for before it should be considered expired. It's also worth nothing that the cache value is only set to elements that are not already of subclass AttachBase() """ # Initialize our return status return_status = True # Initialize our default cache value cache = cache if cache is not None else self.cache if asset is None: # prepare default asset asset = self.asset secure_logging = ( asset.secure_logging if isinstance(asset, AppriseAsset) else True ) if isinstance(attachments, (AttachBase, str)): # store our instance attachments = (attachments,) elif not isinstance(attachments, (tuple, set, list)): logger.error( f"An invalid attachment url (type={type(attachments)}) was " "specified." ) return False # Iterate over our attachments for attachment in attachments: if self.location == ContentLocation.INACCESSIBLE: logger.warning( "Attachments are disabled; ignoring %s", cwe312_loggable(attachment, secure_logging), ) return_status = False continue if isinstance(attachment, str): logger.debug( "Loading attachment: %s", cwe312_loggable(attachment, secure_logging), ) # Instantiate ourselves an object, this function throws or # returns None if it fails instance = AppriseAttachment.instantiate( attachment, asset=asset, cache=cache ) if not isinstance(instance, AttachBase): return_status = False continue elif isinstance(attachment, AppriseAttachment): # We were provided a list of Apprise Attachments # append our content together instance = attachment.attachments elif not isinstance(attachment, AttachBase): logger.warning( f"An invalid attachment (type={type(attachment)}) was" " specified." ) return_status = False continue else: # our entry is of type AttachBase, so just go ahead and point # our instance to it for some post processing below instance = attachment # Apply some simple logic if our location flag is set if self.location and ( ( self.location == ContentLocation.HOSTED and instance.location != ContentLocation.HOSTED ) or instance.location == ContentLocation.INACCESSIBLE ): logger.warning( "Attachment was disallowed due to accessibility" f" restrictions ({self.location}->{instance.location}):" f" {instance.url(privacy=True)}" ) return_status = False continue # Add the initialized plugin to our attachment list. if isinstance(instance, list): self.attachments.extend(instance) else: self.attachments.append(instance) # Return our status return return_status @staticmethod def instantiate( url: str, asset: Optional[AppriseAsset] = None, cache: Optional[Union[bool, int]] = None, suppress_exceptions: bool = True, ) -> Optional[AttachBase]: """Returns the instance of a instantiated attachment plugin based on the provided Attachment URL. If the url fails to be parsed, then None is returned. A specified cache value will over-ride anything set """ # Prepare the asset before any URL can be written to a log. asset = asset if isinstance(asset, AppriseAsset) else AppriseAsset() loggable_url = cwe312_loggable(url, asset.secure_logging) # Attempt to acquire the schema at the very least to allow our # attachment based urls. schema = GET_SCHEMA_RE.match(url) if schema is None: # Plan B is to assume we're dealing with a file schema = "file" url = f"{schema}://{URLBase.quote(url)}" else: # Ensure our schema is always in lower case schema = schema.group("schema").lower() # Some basic validation if schema not in A_MGR: logger.warning(f"Unsupported schema {schema}.") return None # Parse the attachment URL into constructor arguments. results = A_MGR[schema].parse_url(url) if not results: # The attachment URL could not be parsed. logger.warning(f"Unparseable URL {loggable_url}.") return None # Prepare our Asset Object results["asset"] = asset if cache is not None: # Force an over-ride of the cache value to what we have specified results["cache"] = cache if suppress_exceptions: try: # Attempt to create an instance of our plugin using the parsed # URL information attach_plugin = A_MGR[results["schema"]](**results) except Exception: # the arguments are invalid or can not be used. logger.warning(f"Could not load URL: {loggable_url}") return None else: # Attempt to create an instance of our plugin using the parsed # URL information but don't wrap it in a try catch attach_plugin = A_MGR[results["schema"]](**results) return attach_plugin def sync( self, abort_on_error: bool = True, abort_if_empty: bool = True, ) -> bool: """Itereates over all of the attachments and retrieves them.""" return ( False if abort_if_empty and not self.attachments else ( next((False for a in self.attachments if not a), True) if abort_on_error else next((True for a in self.attachments), True) ) ) def clear(self) -> None: """Empties our attachment list.""" self.attachments[:] = [] def size(self) -> int: """Returns the total size of accumulated attachments.""" return sum(len(a) for a in self.attachments if len(a) > 0) def pop(self, index: int = -1) -> AttachBase: """Removes an indexed Apprise Attachment from the stack and returns it. by default the last element is poped from the list """ # Remove our entry return self.attachments.pop(index) def __getitem__(self, index: int) -> AttachBase: """Returns the indexed entry of a loaded apprise attachments.""" return self.attachments[index] def __bool__(self) -> bool: """Allows the Apprise object to be wrapped in an 'if statement'. True is returned if at least one service has been loaded. """ return bool(self.attachments) def __iter__(self) -> Iterator[AttachBase]: """Returns an iterator to our attachment list.""" return iter(self.attachments) def __len__(self) -> int: """Returns the number of attachment entries loaded.""" return len(self.attachments) caronc-apprise-dfec414/apprise/apprise_config.py000066400000000000000000000462641526720371000221400ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from __future__ import annotations from collections.abc import Sequence, Set as AbstractSet from typing import TYPE_CHECKING, Any, Optional, Union from . import common from .asset import AppriseAsset from .config.base import ConfigBase from .logger import logger from .manager_config import ConfigurationManager from .url import URLBase from .utils.cwe312 import cwe312_loggable from .utils.logic import is_exclusive_match from .utils.parse import GET_SCHEMA_RE, parse_list if TYPE_CHECKING: from .plugins.base import NotifyBase # Grant access to our Configuration Manager Singleton C_MGR = ConfigurationManager() class AppriseConfig: """Manage the configuration sources from which services are discovered. Apprise supports a simple text format containing service URLs and a richer YAML format. Sources may be local files, remote URLs, in-memory content, or any other registered configuration plugin. See https://appriseit.com/getting-started/configuration/ for the supported file formats and examples. """ def __init__( self, paths: Optional[ Union[ str, ConfigBase, Sequence[Union[str, ConfigBase]], AbstractSet[Union[str, ConfigBase]], ] ] = None, asset: AppriseAsset | None = None, cache: bool | int = True, recursion: int = 0, insecure_includes: bool = False, **kwargs: Any, ) -> None: """Initialize the manager and optionally add configuration sources. ``paths`` may be one source string or a list of source strings. A source can be an explicit configuration URL such as ``file://`` or ``https://``; a path without a scheme is treated as a local file. If ``paths`` is omitted, the manager starts empty. Default configuration locations are selected by higher-level callers such as the CLI, not by this class. ``asset`` is shared with configuration plugins and with the services they create. ``cache`` controls whether a source is read again: true retains parsed results, false reloads on each request, and an integer gives the cache lifetime in seconds. Caching matters most for remote sources, where reloading requires another network request. ``recursion`` is the number of nested ``include`` levels to follow. Zero disables includes, one loads sources named by the top-level configuration, and larger values allow the included sources to include others. Keep this value low when loading content you do not control. Configuration plugins declare whether they may be included from other source types. In strict mode, a local ``file://`` source may include another local file, but a remote ``http://`` or ``https://`` source may not reach into the local filesystem. ``insecure_includes=True`` relaxes this strict same-type boundary; it does not override sources that prohibit inclusion entirely. This option is also required when trusted in-memory configuration must include local files. See https://appriseit.com/getting-started/configuration/ for the configuration syntax and include examples. """ # Store the configuration sources used to discover services. self.configs = [] # Prepare our Asset Object self.asset = ( asset if isinstance(asset, AppriseAsset) else AppriseAsset() ) # Set our cache flag self.cache = cache # Initialize our recursion value self.recursion = recursion # Initialize our insecure_includes flag self.insecure_includes = insecure_includes if paths is not None: # Store our path(s) self.add(paths) return def add( self, configs: Union[ str, ConfigBase, Sequence[Union[str, ConfigBase]], AbstractSet[Union[str, ConfigBase]], ], asset: AppriseAsset | None = None, tag: Optional[Union[str, Sequence[str], AbstractSet[str]]] = None, cache: bool | int = True, recursion: int | None = None, insecure_includes: bool | None = None, ) -> bool: """Add one or more configuration sources to the manager. ``configs`` accepts a source string, an instantiated :class:`ConfigBase`, or a collection containing either. Strings without a URL scheme are treated as local file paths. ``tag`` is attached to newly created configuration sources and can later select which sources :meth:`services` reads; it does not tag each service found inside. ``asset``, ``cache``, ``recursion``, and ``insecure_includes`` are passed to sources created from strings. ``asset``, ``recursion``, and ``insecure_includes`` fall back to this manager's values when omitted. An already instantiated :class:`ConfigBase` retains all of its own settings because it is stored directly. The cache setting may be true to retain parsed results, false to reload whenever services are requested, or a non-negative integer cache lifetime in seconds. ``recursion`` limits nested ``include`` entries. ``insecure_includes`` relaxes strict cross-source inclusion rules; use it only for trusted configuration. The return value is true only when every supplied item was accepted. Valid sources remain loaded when another item in the same collection is invalid. """ # Initialize our return status return_status = True # Initialize our default cache value cache = cache if cache is not None else self.cache # Initialize our default recursion value recursion = recursion if recursion is not None else self.recursion # Initialize our default insecure_includes value insecure_includes = ( insecure_includes if insecure_includes is not None else self.insecure_includes ) if asset is None: # prepare default asset asset = self.asset secure_logging = ( asset.secure_logging if isinstance(asset, AppriseAsset) else True ) if isinstance(configs, ConfigBase): # Go ahead and just add our configuration into our list self.configs.append(configs) return True elif isinstance(configs, str): # Save our path configs = (configs,) elif not isinstance(configs, (tuple, set, list)): logger.error( f"An invalid configuration path (type={type(configs)}) was " "specified." ) return False # Iterate over our configuration for config in configs: if isinstance(config, ConfigBase): # Go ahead and just add our configuration into our list self.configs.append(config) continue elif not isinstance(config, str): logger.warning( f"An invalid configuration (type={type(config)}) was" " specified." ) return_status = False continue logger.debug( "Loading configuration: %s", cwe312_loggable(config, secure_logging), ) # Instantiate ourselves an object, this function throws or # returns None if it fails instance = AppriseConfig.instantiate( config, asset=asset, tag=tag, cache=cache, recursion=recursion, insecure_includes=insecure_includes, ) if not isinstance(instance, ConfigBase): return_status = False continue # Keep the initialized configuration source. self.configs.append(instance) # Return our status return return_status def add_config( self, content: str, asset: AppriseAsset | None = None, tag: Optional[Union[str, Sequence[str], AbstractSet[str]]] = None, format: str | None = None, recursion: int | None = None, insecure_includes: bool | None = None, ) -> bool: """Add raw configuration text as an in-memory source. The content exists only for the lifetime of the resulting in-memory configuration object. Set ``format`` to ``yaml`` or ``text`` when it is known; otherwise Apprise detects the format. The method returns false when ``content`` is not a string or its format cannot be determined. ``asset`` is passed to services created from the content, while ``tag`` labels the in-memory configuration source for filtering by :meth:`services`. ``recursion`` and ``insecure_includes`` fall back to this manager's defaults when omitted. Enable insecure includes only when trusted in-memory content must include a source, such as a local ``file://`` configuration, that the normal security boundary rejects. """ # Initialize our default recursion value recursion = recursion if recursion is not None else self.recursion # Initialize our default insecure_includes value insecure_includes = ( insecure_includes if insecure_includes is not None else self.insecure_includes ) if asset is None: # prepare default asset asset = self.asset if not isinstance(content, str): logger.warning( f"An invalid configuration (type={type(content)}) was" " specified." ) return False logger.debug(f"Loading raw configuration: {content}") # Create ourselves a ConfigMemory Object to store our configuration instance = C_MGR["memory"]( content=content, format=format, asset=asset, tag=tag, recursion=recursion, insecure_includes=insecure_includes, ) if not ( instance.config_format and instance.config_format.value in common.CONFIG_FORMATS ): logger.warning( "The format of the configuration could not be detected." ) return False # Keep the initialized in-memory configuration source. self.configs.append(instance) # Return our status return True def services( self, tag: Any = common.MATCH_ALL_TAG, match_always: bool = True, *args: Any, **kwargs: Any, ) -> list[NotifyBase]: """Read matching configuration sources and return their services. ``tag`` is matched against tags on the configuration sources themselves, not tags on the services defined inside those sources. This lets a caller choose which files or remote locations to poll. Top-level tag entries are alternatives (OR), while nested collections are intersections (AND). When ``match_always`` is true, configuration sources carrying the reserved ``always`` tag are read even if the requested filter would not otherwise select them. Each matching source applies its own cache, recursion, and include-security policy as it builds the returned list. """ # A match_always flag allows us to pick up on our 'any' keyword # and notify these services under all circumstances match_always = common.MATCH_ALWAYS_TAG if match_always else None # Build our tag setup # - top level entries are treated as an 'or' # - second level (or more) entries are treated as 'and' # # examples: # tag="tagA, tagB" = tagA or tagB # tag=['tagA', 'tagB'] = tagA or tagB # tag=[('tagA', 'tagC'), 'tagB'] = (tagA and tagC) or tagB # tag=[('tagB', 'tagC')] = tagB and tagC response = [] for entry in self.configs: # Apply our tag matching based on our defined logic if is_exclusive_match( logic=tag, data=entry.tags, match_all=common.MATCH_ALL_TAG, match_always=match_always, ): # Add services discovered in this configuration source. response.extend(entry.services()) return response @staticmethod def instantiate( url: str, asset: AppriseAsset | None = None, tag: Optional[Union[str, Sequence[str], AbstractSet[str]]] = None, cache: bool | int | None = None, recursion: int = 0, insecure_includes: bool = False, suppress_exceptions: bool = True, ) -> ConfigBase | None: """Returns the instance of a instantiated configuration plugin based on the provided Config URL. If the url fails to be parsed, then None is returned. """ # Attempt to acquire the schema at the very least to allow our # configuration based urls. schema = GET_SCHEMA_RE.match(url) if schema is None: # Plan B is to assume we're dealing with a file schema = "file" url = f"{schema}://{URLBase.quote(url)}" else: # Ensure our schema is always in lower case schema = schema.group("schema").lower() # Some basic validation if schema not in C_MGR: logger.error(f"Unsupported schema {schema}.") return None # Parse the configuration URL into constructor arguments. results = C_MGR[schema].parse_url(url) if not results: # The configuration URL could not be parsed. # CWE-312 (Secure Logging) Handling secure_logging = ( asset.secure_logging if isinstance(asset, AppriseAsset) else True ) loggable_url = cwe312_loggable(url, secure_logging) logger.error(f"Unparseable URL {loggable_url}.") return None # Build a list of tags to associate with the newly added notifications results["tag"] = set(parse_list(tag)) # Prepare our Asset Object results["asset"] = ( asset if isinstance(asset, AppriseAsset) else AppriseAsset() ) if cache is not None: # Force an over-ride of the cache value to what we have specified results["cache"] = cache # Recursion can never be parsed from the URL results["recursion"] = recursion # Insecure includes flag can never be parsed from the URL results["insecure_includes"] = insecure_includes if suppress_exceptions: try: # Attempt to create an instance of our plugin using the parsed # URL information cfg_plugin = C_MGR[results["schema"]](**results) except Exception: # the arguments are invalid or can not be used. # CWE-312 (Secure Logging) Handling loggable_url = cwe312_loggable( url, results["asset"].secure_logging ) logger.error(f"Could not load URL: {loggable_url}") return None else: # Attempt to create an instance of our plugin using the parsed # URL information but don't wrap it in a try catch cfg_plugin = C_MGR[results["schema"]](**results) return cfg_plugin def clear(self) -> None: """Empties our configuration list.""" self.configs[:] = [] def service_pop(self, index: int) -> NotifyBase: """Remove and return a service from the flattened configuration view. The configuration sources remain loaded. ``index`` addresses the services discovered across them as one continuous sequence, and an out-of-range index raises :class:`IndexError`. """ # Tracking variables prev_offset = -1 offset = prev_offset for entry in self.configs: services = entry.services(cache=True) if len(services) > 0: # Acquire a new maximum offset to work with offset = prev_offset + len(services) if offset >= index: # we can pop an notification from our config stack return entry.pop( index if prev_offset == -1 else (index - prev_offset - 1) ) # Update our old offset prev_offset = offset # If we reach here, then we indexed out of range raise IndexError("list index out of range") def pop(self, index: int = -1) -> ConfigBase: """Removes an indexed Apprise Configuration from the stack and returns it. By default, the last element is removed from the list """ # Remove our entry return self.configs.pop(index) def __getitem__(self, index: int) -> ConfigBase: """Returns the indexed config entry of a loaded apprise configuration.""" return self.configs[index] def __bool__(self) -> bool: """Allows the Apprise object to be wrapped in an 'if statement'. True is returned if at least one service has been loaded. """ return bool(self.configs) def __iter__(self): # type: () -> Iterator[ConfigBase] """Returns an iterator to our config list.""" return iter(self.configs) def __len__(self) -> int: """Returns the number of config entries loaded.""" return len(self.configs) caronc-apprise-dfec414/apprise/asset.py000066400000000000000000000725641526720371000202710ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from collections.abc import Sequence from datetime import datetime, tzinfo import math from os.path import abspath, dirname, isfile, join import re from typing import Any, Optional, Union from uuid import uuid4 from .common import ( NotifyFormat, NotifyImageSize, NotifyType, PersistentStoreMode, ) from .exception import AppriseImproperlyConfigured from .locale import AppriseLocale from .manager_plugins import NotificationManager from .utils.time import zoneinfo # Grant access to our Notification Manager Singleton N_MGR = NotificationManager() class AppriseAsset: """Provide shared application settings, paths, and delivery limits. Private attributes are excluded from configuration. Callers use their public constructor arguments; ``_uid`` and ``_recursion`` remain internal compatibility exceptions. """ # Application Identifier app_id = "Apprise" # Application Description app_desc = "Apprise Notifications" # Provider URL app_url = "https://github.com/caronc/apprise" # A Simple Mapping of Colors; For every NOTIFY_TYPE identified, # there should be a mapping to it's color here: html_notify_map = { NotifyType.INFO: "#3AA3E3", NotifyType.SUCCESS: "#3AA337", NotifyType.FAILURE: "#A32037", NotifyType.WARNING: "#CACF29", } # The default color to return if a mapping isn't found in our table above default_html_color = "#888888" # Ascii Notification ascii_notify_map = { NotifyType.INFO: "[i]", NotifyType.SUCCESS: "[+]", NotifyType.FAILURE: "[!]", NotifyType.WARNING: "[~]", } # The default ascii to return if a mapping isn't found in our table above default_ascii_chars = "[?]" # The default image extension to use default_extension = ".png" # The default image size if one isn't specified default_image_size = NotifyImageSize.XY_256 # The default theme theme = "default" # Image URL Mask image_url_mask = ( "https://github.com/caronc/apprise/raw/master/apprise/assets/" "themes/{THEME}/apprise-{TYPE}-{XY}{EXTENSION}" ) # Application Logo image_url_logo = ( "https://github.com/caronc/apprise/raw/master/apprise/assets/" "themes/{THEME}/apprise-logo.png" ) # Image Path Mask image_path_mask = abspath( join( dirname(__file__), "assets", "themes", "{THEME}", "apprise-{TYPE}-{XY}{EXTENSION}", ) ) # This value can also be set on calls to Apprise.notify(). This allows # you to let Apprise upfront the type of data being passed in. This # must be of type NotifyFormat. Possible values could be: # - NotifyFormat.TEXT # - NotifyFormat.MARKDOWN # - NotifyFormat.HTML # - None # # If no format is specified (hence None), then no special pre-formatting # actions will take place during a notification. This has been and always # will be the default. body_format = None # Always attempt to send notifications asynchronous (as the same time # if possible) # This is a Python 3 supported option only. If set to False, then # notifications are sent sequentially (one after another) async_mode = True # Support :smile:, and other alike keywords swapping them for their # unicode value. A value of None leaves the interpretation up to the # end user to control (allowing them to specify emojis=yes on the # URL) interpret_emojis = None # Whether or not to interpret escapes found within the input text prior # to passing it upstream. Such as converting \t to an actual tab and \n # to a new line. interpret_escapes = False # Default number of retries after a first notification failure. # Individual plugins may override this via their ?retry= URL parameter # or the 'retry:' YAML key. Clamped to [0, APPRISE_MAX_SERVICE_RETRY]. default_service_retry = 0 # Default wait (in seconds) between retry attempts. Individual plugins # may override this via their ?wait= URL parameter or the 'wait:' YAML # key. Clamped to [0.0, APPRISE_MAX_SERVICE_WAIT]. default_service_wait = 0.5 # When True, as soon as any independent OR tag chain exhausts all its # priority groups without success, notify() / async_notify() return False # immediately without running further escalation rounds for the surviving # chains. When False (the default), all chains are allowed to complete # regardless of whether another chain has already failed. abort_on_chain_failure = False # Defines the encoding of the content passed into Apprise encoding = "utf-8" # Automatically generate our Pretty Good Privacy (PGP) keys if one isn't # present and our environment configuration allows for it. # For example, a case where the environment wouldn't allow for it would be # if Persistent Storage was set to `memory` pgp_autogen = True # Automatically generate our Privacy Enhanced Mail (PEM) keys if one isn't # present and our environment configuration allows for it. # For example, a case where the environment wouldn't allow for it would be # if Persistent Storage was set to `memory` pem_autogen = True # For more detail see CWE-312 @ # https://cwe.mitre.org/data/definitions/312.html # # By enabling this, the logging output has additional overhead applied to # it preventing secure password and secret information from being # displayed in the logging. Since there is overhead involved in performing # this cleanup; system owners who run in a very isolated environment may # choose to disable this for a slight performance bump. It is recommended # that you leave this option as is otherwise. secure_logging = True # By default, HTTP redirects (3xx responses) are followed, matching the # behaviour of the underlying requests library. Set this to False to # disable redirect following globally across all plugins without having # to add redirect=no to every individual URL. Individual URLs can still # override this via the redirect= parameter. http_redirects = True # Optionally specify one or more path to attempt to scan for Python modules # By default, no paths are scanned. __plugin_paths = [] # Optionally set the location of the persistent storage # By default there is no path and thus persistent storage is not used __storage_path = None # Optionally define the default salt to apply to all persistent storage # namespace generation (unless over-ridden) __storage_salt = b"" # Optionally define the namespace length of the directories created by # the storage. If this is set to zero, then the length is pre-determined # by the generator (sha1, md5, sha256, etc) __storage_idlen = 8 # Set storage to auto __storage_mode = PersistentStoreMode.AUTO # Internal settings are not loaded from YAML configuration. # AppriseAPI passes this internal counter between chained servers to # prevent notification loops. Its constructor support is retained for # compatibility with https://github.com/caronc/apprise-api. _recursion = 0 # AppriseAPI preserves this internal source identifier across chained # requests. Its constructor support is retained for compatibility. _uid = str(uuid4()) # AppriseAPI still passes these private arguments. All other internal # settings must use their validated public constructor arguments. _KWARGS_INTERNAL_ALLOWLIST = frozenset({"_recursion", "_uid"}) # Language for user-facing text. Codes may include a region, such as # en-CA or en_CA. Apprise tries the base language, then English, when a # matching catalog is unavailable. None uses the system language. _language = None # Default timezone to use (pass in timezone value) # A list of timezones can be found here: # https://en.wikipedia.org/wiki/List_of_tz_database_time_zones # You can specify things such as 'America/Montreal' # If no timezone is specified, then the one detected on the system # is used _tzinfo = None # Default budget for one service, including retries and waits. Apprise # reports TIMEOUT after this many seconds; 0 disables the service limit. _service_timeout = 60.0 # A safety ceiling on the combined title + body character count, checked # before any format conversion or splitting begins. 0 disables the check # entirely, which is the default. _payload_max_size = 0 # A title or body at or below this length may remain whole when the other # side can retain its minimum. _payload_buffer_threshold = 10 # Minimum reserved for the other side. If it cannot fit, title and body # share the cap proportionally. _payload_min_buffer = 25 # Keep result logs in memory unless disk-backed capture is configured. # Apprise reads this setting from its existing asset when it notifies. _result_log_memory_size = 0 # A zero disk allowance preserves the existing memory-only behavior. # When enabled, both limits cover the complete notification call. _result_log_disk_size = 0 # Whether YAML may declare and fill ${NAME} values. This internal setting # belongs to the host, not the configuration. When disabled, template # sections are ignored and markers remain ordinary text. _allow_templates = True def __init__( self, plugin_paths: Optional[Sequence[str]] = None, storage_path: Optional[str] = None, storage_mode: Optional[Union[str, PersistentStoreMode]] = None, storage_salt: Optional[Union[str, bytes]] = None, storage_idlen: Optional[int] = None, timezone: Optional[Union[str, tzinfo]] = None, language: Optional[str] = None, service_timeout: Optional[Union[int, float]] = None, payload_max_size: Optional[int] = None, allow_templates: Optional[bool] = None, payload_buffer_threshold: Optional[int] = None, payload_min_buffer: Optional[int] = None, result_log_memory_size: Optional[int] = None, result_log_disk_size: Optional[int] = None, **kwargs: Any, ) -> None: """Initialize shared settings and delivery limits. ``language`` accepts codes such as ``en``, ``en-CA``, or ``en_CA``. ``None`` uses the detected system language. Zero disables ``service_timeout`` and ``payload_max_size``. ``payload_buffer_threshold`` and ``payload_min_buffer`` control how a capped payload is shared between title and body; see ``enforce_payload_max_size()``. Result logs use disk after their memory allowance; a zero disk size keeps them in memory. ``None`` keeps each class default. """ # Assign default arguments if specified for key, value in kwargs.items(): if not hasattr(AppriseAsset, key): raise AppriseImproperlyConfigured( f"AppriseAsset init(): An invalid key {key} was specified." ) if key.startswith("_") and ( key not in self._KWARGS_INTERNAL_ALLOWLIST ): raise AppriseImproperlyConfigured( f"AppriseAsset init(): {key} can not be set directly; " "use its dedicated keyword argument instead." ) setattr(self, key, value) if plugin_paths: # Load any decorated modules if defined self.__plugin_paths = plugin_paths N_MGR.module_detection(plugin_paths) if storage_path: # Define our persistent storage path self.__storage_path = storage_path if storage_mode: # Define how our persistent storage behaves try: self.__storage_mode = ( storage_mode if isinstance(storage_mode, NotifyFormat) else PersistentStoreMode(storage_mode.lower()) ) except (AttributeError, ValueError, TypeError): err = ( f"An invalid persistent store mode ({storage_mode}) was " "specified." ) raise AppriseImproperlyConfigured(err) from None if isinstance(storage_idlen, int): # Define the number of characters utilized from our namespace lengh if storage_idlen < 0: # Unsupported type raise AppriseImproperlyConfigured( "AppriseAsset storage_idlen(): Value must " "be an integer and > 0" ) # Store value self.__storage_idlen = storage_idlen if isinstance(timezone, tzinfo): self._tzinfo = timezone elif timezone is not None: self._tzinfo = zoneinfo(timezone) if not self._tzinfo: raise AppriseImproperlyConfigured( "AppriseAsset timezone provided is invalid" ) from None else: # Default our timezone to what is detected on the system self._tzinfo = datetime.now().astimezone().tzinfo if language is not None: if not isinstance(language, str): raise AppriseImproperlyConfigured( "AppriseAsset language must be a string." ) from None if language.strip(): # Store the normalized form, such as en_CA self._language = AppriseLocale.normalize_language(language) if not self._language: raise AppriseImproperlyConfigured( "AppriseAsset language provided is invalid" ) from None if allow_templates is not None: if not isinstance(allow_templates, bool): raise AppriseImproperlyConfigured( "AppriseAsset allow_templates must be a bool." ) self._allow_templates = allow_templates if service_timeout is not None: # Store all durations as floats and reject bool values. if not isinstance(service_timeout, (int, float)) or isinstance( service_timeout, bool ): raise AppriseImproperlyConfigured( "AppriseAsset service_timeout must be an int or float." ) if not math.isfinite(service_timeout) or service_timeout < 0: # Use 0 for no timeout; infinity is unsafe on some platforms. raise AppriseImproperlyConfigured( "AppriseAsset service_timeout must be >= 0 and " "finite (0 disables the timeout entirely)." ) self._service_timeout = float(service_timeout) if payload_max_size is not None: # Reject booleans even though ``bool`` subclasses ``int``. if not isinstance(payload_max_size, int) or isinstance( payload_max_size, bool ): raise AppriseImproperlyConfigured( "AppriseAsset payload_max_size must be an int." ) if payload_max_size < 0: raise AppriseImproperlyConfigured( "AppriseAsset payload_max_size must be >= 0 " "(0 disables the cap entirely)." ) self._payload_max_size = payload_max_size if payload_buffer_threshold is not None: # Reject booleans even though ``bool`` subclasses ``int``. if not isinstance(payload_buffer_threshold, int) or isinstance( payload_buffer_threshold, bool ): raise AppriseImproperlyConfigured( "AppriseAsset payload_buffer_threshold must be an int." ) if payload_buffer_threshold < 0: raise AppriseImproperlyConfigured( "AppriseAsset payload_buffer_threshold must be >= 0." ) self._payload_buffer_threshold = payload_buffer_threshold if payload_min_buffer is not None: # Reject booleans even though ``bool`` subclasses ``int``. if not isinstance(payload_min_buffer, int) or isinstance( payload_min_buffer, bool ): raise AppriseImproperlyConfigured( "AppriseAsset payload_min_buffer must be an int." ) if payload_min_buffer < 0: raise AppriseImproperlyConfigured( "AppriseAsset payload_min_buffer must be >= 0." ) self._payload_min_buffer = payload_min_buffer if result_log_memory_size is not None: # Booleans are integers in Python, but are not valid byte limits. if not isinstance(result_log_memory_size, int) or isinstance( result_log_memory_size, bool ): raise AppriseImproperlyConfigured( "AppriseAsset result_log_memory_size must be an int." ) if result_log_memory_size < 0: raise AppriseImproperlyConfigured( "AppriseAsset result_log_memory_size must be >= 0." ) self._result_log_memory_size = result_log_memory_size if result_log_disk_size is not None: # Keep this strict so later storage calculations are predictable. if not isinstance(result_log_disk_size, int) or isinstance( result_log_disk_size, bool ): raise AppriseImproperlyConfigured( "AppriseAsset result_log_disk_size must be an int." ) if result_log_disk_size < 0: raise AppriseImproperlyConfigured( "AppriseAsset result_log_disk_size must be >= 0." ) self._result_log_disk_size = result_log_disk_size if storage_salt is not None: # Define the number of characters utilized from our namespace lengh if isinstance(storage_salt, bytes): self.__storage_salt = storage_salt elif isinstance(storage_salt, str): try: self.__storage_salt = storage_salt.encode(self.encoding) except UnicodeEncodeError: # Bad data; don't pass it along raise AppriseImproperlyConfigured( "AppriseAsset namespace_salt(): " "Value provided could not be encoded" ) from None else: # Unsupported raise AppriseImproperlyConfigured( "AppriseAsset namespace_salt(): Value provided must be " "string or bytes object" ) def enforce_payload_max_size( self, title: str, body: str ) -> tuple[str, str]: """Apply the configured input cap to ``title`` and ``body``. Checked in order, the first match decides the split: 1. An absent side never competes for room: an empty title leaves the whole cap for the body, and vice versa. 2. A short side (length <= ``payload_buffer_threshold``) is shown whole if the other side can still keep at least ``payload_min_buffer`` characters (or its own full length, if shorter) out of what remains. This is checked for the title first, then the body. 3. Otherwise, title and body share the cap in proportion to their original lengths. When the cap allows, each nonempty side keeps at least one character. Very small caps may produce short fragments, but proportional sharing avoids dropping one side when space is available for both. """ if not self._payload_max_size: return title, body cap = self._payload_max_size total = len(title) + len(body) if total <= cap: return title, body if not title: return "", body[:cap] if not body: return title[:cap], "" threshold = self._payload_buffer_threshold min_buffer = self._payload_min_buffer if len(title) <= threshold: # A short title is worth showing whole, but only if the body # can still keep its own minimum out of what's left. body_reserve = min(len(body), min_buffer) if len(title) + body_reserve <= cap: return title, body[: cap - len(title)] if len(body) <= threshold: # Same guarantee, mirrored for a short body. title_reserve = min(len(title), min_buffer) if len(body) + title_reserve <= cap: return title[: cap - len(body)], body # If neither guarantee applies, share the cap proportionally. title_budget = (len(title) * cap) // total body_budget = cap - title_budget # Rounding can zero out a small, nonempty title entirely; borrow # one character from body's share when it can spare it. if not title_budget and body_budget > 0: title_budget = 1 body_budget -= 1 return title[:title_budget], body[:body_budget] def color( self, notify_type: NotifyType, color_type: Optional[type] = None, ) -> Union[str, int, tuple[int, int, int]]: """Returns an HTML mapped color based on passed in notify type. if color_type is: None then a standard hex string is returned as a string format ('#000000'). int then the integer representation is returned tuple then the the red, green, blue is returned in a tuple """ # Attempt to get the type, otherwise return a default grey # if we couldn't look up the entry color = self.html_notify_map.get(notify_type, self.default_html_color) if color_type is None: # This is the default return type return color elif color_type is int: # Convert the color to integer return AppriseAsset.hex_to_int(color) # The only other type is tuple elif color_type is tuple: return AppriseAsset.hex_to_rgb(color) # Unsupported type raise AppriseImproperlyConfigured( "AppriseAsset html_color(): An invalid color_type was specified." ) def ascii(self, notify_type: NotifyType) -> str: """Returns an ascii representation based on passed in notify type.""" # look our response up return self.ascii_notify_map.get(notify_type, self.default_ascii_chars) def image_url( self, notify_type: NotifyType, image_size: Optional[NotifyImageSize] = None, logo: bool = False, extension: Optional[str] = None, ) -> Optional[str]: """Apply our mask to our image URL. if logo is set to True, then the logo_url is used instead """ url_mask = self.image_url_logo if logo else self.image_url_mask if not url_mask: # No image to return return None if extension is None: extension = self.default_extension if image_size is None: image_size = self.default_image_size re_map = { "{THEME}": self.theme if self.theme else "", "{TYPE}": notify_type.value, "{XY}": image_size.value, "{EXTENSION}": extension, } # Iterate over above list and store content accordingly re_table = re.compile( r"(" + "|".join(re_map.keys()) + r")", re.IGNORECASE, ) return re_table.sub(lambda x: re_map[x.group()], url_mask) def image_path( self, notify_type: NotifyType, image_size: NotifyImageSize, must_exist: bool = True, extension: Optional[str] = None, ) -> Optional[str]: """Apply our mask to our image file path.""" if not self.image_path_mask: # No image to return return None if extension is None: extension = self.default_extension re_map = { "{THEME}": self.theme if self.theme else "", "{TYPE}": notify_type.value, "{XY}": image_size.value, "{EXTENSION}": extension, } # Iterate over above list and store content accordingly re_table = re.compile( r"(" + "|".join(re_map.keys()) + r")", re.IGNORECASE, ) # Acquire our path path = re_table.sub(lambda x: re_map[x.group()], self.image_path_mask) if must_exist and not isfile(path): return None # Return what we parsed return path def image_raw( self, notify_type: NotifyType, image_size: NotifyImageSize, extension: Optional[str] = None, ) -> Optional[bytes]: """Returns the raw image if it can (otherwise the function returns None)""" path = self.image_path( notify_type=notify_type, image_size=image_size, extension=extension, ) if path: try: with open(path, "rb") as fd: return fd.read() except OSError: # We can't access the file return None return None def details(self) -> dict[str, str]: """Returns the details associated with the AppriseAsset object.""" return { "app_id": self.app_id, "app_desc": self.app_desc, "default_extension": self.default_extension, "theme": self.theme, "image_path_mask": self.image_path_mask, "image_url_mask": self.image_url_mask, "image_url_logo": self.image_url_logo, } @staticmethod def hex_to_rgb(value: str) -> tuple[int, int, int]: """Takes a hex string (such as #00ff00) and returns a tuple in the form of (red, green, blue) eg: #00ff00 becomes : (0, 65535, 0) """ value = value.lstrip("#") lv = len(value) return tuple( int(value[i : i + lv // 3], 16) for i in range(0, lv, lv // 3) ) @staticmethod def hex_to_int(value: str) -> int: """Takes a hex string (such as #00ff00) and returns its integer equivalent. eg: #00000f becomes : 15 """ return int(value.lstrip("#"), 16) @property def plugin_paths(self) -> Sequence[str]: """Return the plugin paths defined.""" return self.__plugin_paths @property def storage_path(self) -> Optional[str]: """Return the persistent storage path defined.""" return self.__storage_path @property def storage_mode(self) -> PersistentStoreMode: """Return the persistent storage mode defined.""" return self.__storage_mode @property def storage_salt(self) -> bytes: """Return the provided namespace salt; this is always of type bytes.""" return self.__storage_salt @property def storage_idlen(self) -> int: """Return the persistent storage id length.""" return self.__storage_idlen @property def allow_templates(self) -> bool: """Return whether a YAML configuration may use template variables.""" return self._allow_templates @property def result_log_memory_size(self) -> int: """Return the result-log memory allowance in bytes.""" return self._result_log_memory_size @property def result_log_disk_size(self) -> int: """Return the result-log disk allowance in bytes.""" return self._result_log_disk_size @property def tzinfo(self) -> tzinfo: """Return the timezone object""" return self._tzinfo @property def language(self) -> Optional[str]: """Return the language, or None when the system one is used.""" # None tells Apprise to detect the system language. return self._language caronc-apprise-dfec414/apprise/assets/000077500000000000000000000000001526720371000200645ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/assets/NotifyXML-1.0.xsd000066400000000000000000000017321526720371000227340ustar00rootroot00000000000000 caronc-apprise-dfec414/apprise/assets/NotifyXML-1.1.xsd000066400000000000000000000033361526720371000227370ustar00rootroot00000000000000 caronc-apprise-dfec414/apprise/assets/themes/000077500000000000000000000000001526720371000213515ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/assets/themes/default/000077500000000000000000000000001526720371000227755ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/assets/themes/default/apprise-failure-128x128.ico000066400000000000000000002040761526720371000275250ustar00rootroot00000000000000 (( !8KVdpwwpdVK8! GG  JJ =qq=,,D ) 18?CEC?91 )D BAf&&,,003377::;;==??????>><<::884411,,&&fAB R<$$55::<<>>@@@@@@AAAAAAAAAAAAAAAAAAAAAAAAAA@@@@AA>><<;;66''<RN 6''==????@@@@@@AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA@@????>>)):N4k1199==AAAAAAAAAAAAAAAAAAAABBBBBBBBBBCCBBCCCCCCCCBBBBAAAAAAAAAAAAAAAAAAAA@@??88##{<][*)5588::;;<>11k]* i22658899::::;;;;??AABBDDEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEDDDDCCCCAAAAAAAAAAAA??::$$|*e O216566889999::;:<<=>?>@@DDEEEEEEEEEEEEEEEEEEFFEEFFFFFFFFFFFFFFFFFFEEEEEEEEEEEEEEEEEEEEEEEEEEEEDDCCBBAAAAAAAA@@66Q  +%%325466767788:9;:<<>>>>??@?@@CCEEEEEEEEFFFFGGGGGGHHGGHHHHHHHHHHHHHHHHHHGGGGGGGGGGFFEEEEEEEEEEEEEEEEEEEEDDCCBBAAAAAAAA??//9.^00335565667777:9;;=<==>>?>??@@@@BBDDGGGGHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHGGFFFFEEEEEEEEEEEEEEEECCBBAAAAAAAA==&&.H('22435455656698::<;<<====>>?>??A@AACCGGHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHIIHHHHHHHHHHHHHHHHHHHHHHHHHHHHGGFFEEEEEEEEEEEEEEEECCBBAAAAAA@@22 #HG;-,21434454557699;:;;<;<<==>=>>@?AABBBBDCFFKKMMHHHHHHIIIIJJJJJJJJKKJJJJJJJJJJJJJJJJJJJJIIHHIIHHHHHHHHHHHHHHHHGGEEEEEEEEEEEEEEDDBBAAAAAAAA::NG8^..213343445477:9::;:;;<<<<>=?>@@BABBCBCCccqqJJKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKJJKKJJIIHHIIHHHHHHHHHHHHGGFFFFEEEEEEEEEEDDBBAAAAAA??&&8F $#{0021323343658799:9::;:;;<<>>??@@AABABBDCzzeeKKLLKKKKKKLLLLKKLLLLLLLLLLKKKKKKKKKKKKKKKKKKJJJJIIHHHHHHHHHHHHGGFFEEEEEEEEEEEECCAAAAAA@@//FE%$0/1022324465879899:9::;;<<>=??@?A@AABACC@@V%ppXXMMNNNNNNNNNNNNNNNNNNMMMMNNLLLLLLKKKKKKKKKKKKKKKKIIIIHHHHHHHHHHGGEEEEEEEEEEEECCAAAAAAAA22E,&%~//102122436587889899:9;;=<>=?>??@?A@BBCBkkCCZ..?xxzzXXOOOOOOOOOOOOPPOOOOOOOOOOOONNMMMMLLKKKKKKKKKKKKJJJJIIHHHHHHHHHHFFEEEEEEEEEEDDBBAAAAAA66 +, #('/.0/112143557687889899;:=<>=>=?>??A@BBDCNM66IeeQQQQQQQQQQQQQQPPPPPPPPPPOOOOOONNMMMMMMLLKKKKKKKKKKIIHHHHHHHHHHGGFFEEEEEEEEEECCAAAAAA887 ((/.00101143546676878898;:=<=<>=>>@?AACBCCDDpp%YYRRRRRRRRRRRRQQRRQQQQQQPPPPPPPPPPOOOONNMMLLKKKKKKKKKKIIHHHHHHHHGGFFEEEEEEEEEECCAAAAAA88 +&%|.-0.0010225565767787:9::<;=<=??A@BBCBCCMM]]} ssSSSSSSSSSSSSSSRRSSSSRRRRQQQQPPPPPPPPOONNNNMMLLKKKKKKKKJJHHHHHHHHHHGGFFEEEEEEEEDDAAAAAA66[ m.-/.0/0032546566767798;:;:<;=<>=@?A@BABBCBEE bbUUSSSSSSSSSSSSSSSSSSSSSSRRRRRRQQQQPPPPPPOOOONNMMLLKKKKKKKKIIHHHHHHHHGGEEEEEEEEEEDDAAAAAA22Z#e-,/-//0/31445465667687:9;:<;=<>=@?A@A@BACCED^^BBXSSoYYUUUUUUUUUUUUUUTTTTTTSSSSSSSSSSSSRRQQQQPPPPPPOONNMMKKKKKKKKJJIIHHHHHHGGEEEEEEEEEEDDBBAAAA..#Y,+.-/.//10435454656687:9:9;:<;=??@?AADCEDGGss::MXXVVVVVVVVVVVVVVVVVVVVVVVVUUUUTTTTSSSSSSSSRRQQPPPPPPOONNMMKKKKKKJJIIHHHHHHHHFFEEEEEEEECCAAAA>>IM&&|,+.-/.0/2143435455779898:9;:=<>=?>@?A@CCEDFFRRzzyywwXXYYYYYYYYYYYYXXYYXXWWVVVVVVVVVVVVTTTTTTSSSSRRQQQQPPPPOONNNNLLKKKKJJIIHHHHHHGGFFEEEEEEEECCAAAA99 d,+.-.-/.113243445465879898:9<<>=>=?>AACBDDFEFFxx66H]]YYZZYYYYYYYYYYYYXXXXXXYYWWWWVVVVVVVVVVUUTTTTSSSSRRQQPPPPPPOOMMLLKKKKKKIIHHHHHHHHFFEEEEEEEEBBAAAA11A<*)-+.-.-1/3232434465868798:8=<=<>=>>A@BAEDEEFERQPPiuuZZZZZZZZZZZZZZZZZZZZYYYYYYXXXXYYXXWWVVVVVVVVUUTTSSSSSSRRQQPPPPOONNLLKKKKJJIIHHHHHHGGEEEEEEEEDDAAAAAA""u=*),+-,.-/.213232435476879798;:=<=<>=@@BADDEDEEHG WWtZZZZZZZZZZZZZZZZZZZZZZZZZZZZYYYYYYYYYYXXWWVVVVVVUUSSSSSSSSQQQQPPPPOONNLLKKKKJJIIHHHHHHFFEEEEEEEECCAAAA>> -qh,*-,-,/.002132324365768797;:<;=<=<@?BACCDDFEGG^]66H"dd[[[[[[[[[[[[[[[[[[[[ZZZZZZZZZZZZZZYYYYYYYYXXWWVVVVVVTTTTSSSSRRQQPPPPOONNLLKKKKJJHHHHHHGGFFEEEEEEEEBBAAAA--E5)(,+-,-,0.212132435575AAVUa_ecdc`_RQAACBDCEDFFHG|{~~``\\]]]]]]]]]]]]]]]]]]\\\\\\\\[[[[[[ZZZZZZZZYYYYYYWWVVVVVVTTTTSSSSSSQQPPPPOONNLLKKKKJJHHHHHHGGFFEEEEEEDDBBAA??Hh ! i,*,+-,..1021213243cbVUEDFFHGHH]\WWr cc^^^^^^^^^^^^^^^^^^^^^^^^]]]]\\\\[[[[ZZZZZZZZYYXXYYXXWWVVVVVVTTSSSSSSQQPPPPOONNLLKKKKJJHHHHHHGGEEEEEEEECCAAAA33 03)(,+,,-,/.102155[Y||XXq88H&&1"!+))6CCWGGFFHGIIKJtt88J zz______````````````______^^^^^^]]]]\\\\[[[[ZZZZZZYYYYXXXXWWVVVVUUTTSSSSSSQQPPPPNNMMLLKKKKIIHHHHHHFFEEEEEEDDBBAAAAMP!!n+),+,,/-1010EDZYr%%/ IHGFWWddZYMLWW||22B@@Ucc````aaaaaaaaaaaaaaaa``aa````____^^^^]]]]\\[[[[ZZZZZZYYXXYYXXVVVVUUTTSSSSSSQQPPPPOOMMKKKKKKIIHHHHHHFFEEEEEEDDAAAA::'0*)+*,+--/.10QQ(eepoFFcbQQQPggvv vvaabbbbbbbbbbbbbbbbbbbbbbbbbbaaaa``````^^^^]]]]\\[[ZZZZZZZZYYXXXXVVVVUUTTSSSSQQQQPPPPNNMMKKKKKKHHHHHHGGEEEEEEEECCAAAAg9$#u+)+*,+/-/.JI'NMGGttWWqnmSRUUllWWr ccbbbbbbbbbbbbbbbbbbaaaabbbbbbbbbbbbbbaaaa``__^^^^]]\\\\[[ZZZZZZYYYYXXVVVVUUSSSSSSRRPPPPOONNLLKKKKJJHHHHHHFFEEEEEEDDAAAA:: -)(+*++-,/.88mlFE}|((3rq^]UUWWuuddbbbbbbbbbbbbccccccccccbbbbbbbbbbbbbbbbbbaa````__^^^^\\\\[[ZZZZZZXXYYWWVVVVUUTTSSSSRRPPPPOOMMKKKKJJHHHHHHGGEEEEEEEECCAA??Yq! i*)+*,+.,0/cc$$.GG[EDWVji..>H9*(*)*)-+../.0/10vtEEW ZYBA&LLc||^^]][[ZZZZZZYYWWVVUUTTSSSSQQPPNNLLKKKKIIHHHHGGEEEEEEDDBB??iO*(*)*)-,/./.0/11@>WWo@?`_\\u;;;***GGG444&&&ff^^]][[ZZZZYYYYXXVVVVTTSSSSQQPPOONNKKKKIIHHHHHHEEEEEEEEAAAA'' d*(*)**.-/./.0/2154rp&&1BABB jjjqqq ``` gg``__]]\\[[ZZZZYYXXVVVVTTSSSSQQPPOONNLLKKJJHHHHGGFFEEEEDDBBAA--$#q*(*),+.-/./.1/3132CBff?>dd:9I777888''3iiaa__^^]][[ZZZZYYXXVVVVTTSSSSRRPPOONNKKKKKKIIHHHHFFEEEEDDBBAA00 &%u*)*),+.-/.//1/313242TSA@BAyy!!! ,,,bbaa``^^]][[ZZZZYYYYVVVVUUSSSSRRPPPPOOLLKKKKHHHHHHFFEEEEEECCAA449 &%x*)*),+.-/.//1/31324265FEutnmFE>=oolllAAA+++ 555NNebbbbaa``__]][[ZZZZYYYYXXVVUUSSSSRRPPPPNNLLKKKKIIHHHHFFEEEEEECCAA66 Q+&%x*)*),+.-/.0/1/314243657687:9<;>=qq  yyy nnbbbbaa``__]]\\ZZZZYYYYXXVVUUTTSSRRPPPPOOLLKKKKIIHHHHGGEEEEEEDDAA88 &d9&%y*)*),+../.0/1/314243658687;:==>={z66ETTTVVoccbbbbbb``__]]\\[[ZZYYYYXXVVUUTTSSRRQQPPNNMMKKKKIIHHHHGGEEEEEEDDAA:: +rE '&y*)*)-+../.0/10314243658698;:==>=lkww```iiccbbbbbb``__]]\\[[ZZYYXXXXVVUUTTSSSSQQPPNNMMKKKKIIHHHHGGEEEEEEDDBB;;/zJ '&y*)*),+/./.0/10314243658698;:==?>A?VUSSj@@@RRRwwddccbbbbbb``__]]\\[[[[WWTTSSSSQQPPOOMMKKKKIIHHHHGGEEEEEECCAA;;0vH'&y*)**-+/./.0/10314243658697<;==?>@@BADBpp44C iii--:iiddccbbbbbbaa__]]\\ggeeSSRRQQPPOOMMKKKKJJHHHHGGEEEEEEDDAA:: -k>&%y*)+*-+/./.0/20324254768798<:>=>>@@BADBEDONxw..< !!!111AAA888eeddccbbbbbb``__]]\\))7 &vv__RRPPPPOOMMKKKKIIHHHHGGEEEEEEDDAA99 (Y1&%x*)+*,+/.//0/20324243668798<:>=>>@?BADCEDGFGF^]ttEEEXXqffddddccbbbbbb``__]]tt99K UUQQPPNNMMKKKKJJHHHHFFEEEEEEDDAA77 !F$&%v*)+*,+/.0/0/20324253668797<;>=?>@?BADCEDGFIHKJMMbbDDWuuueee "mmffeezz``__]]++:PPPPNNLLKKKKIIHHHHGGEEEEEECCAA55$$#r*)+*,+/.0/0/20424353768798;:=<>>@?AACBEDGFIHKJKKMMNMppCCC///iii^^xhhnn__]]NNh@@VccPPNNLLKKKKIIHHHHFFEEEEEECCAA22"!j*)+*,+/.0/0/10424353768798;:=@?BACBEDGFHGJJKJMMNMOO__.-; #jjhh11@==P]]hh%%1QQNNLLKKKKIIHHHHGGEEEEEECCAA..X*(+*,,/.0/0010424353768798;:=@?AACBEDGFHGJJLKMMNNPOQQSSut;;LJJJ___hhkkhh;;Nqq[[55GZZNNKKKKKKIIHHHHEEEEEEEECCAA**B*(+*,+.-0/0020324353768798;:=@?AACBEDFFHGJILKMLNNPOQQSSUTbb??Q <@?BACBEDFFHGJILKMLNNPORQRRUTWVYYJJ`lll---@@@III ~~hhggkk&&2llZZnn##/VVtNNKKKKJJHHHHHHEEEEEEDDBB??Uf+)+*,+..0/1010314354649798::=@?BACBEDFFHGIHLKMLONOOQPRRTTWVXX[[QQh---III__yhhhhggffnn{{ZZZZll%ooKKKKJJHHHHGGEEEEEEDDBB>>3f2('+*,+.-0/1010315354758798::=@?BACBDCFEHGIHKKMLNMOOQPSRTTVUXXZZ^^CCWqqqOOO&llhhggeeddxx55EII`__ZZaa"KKKKIIHHHHGGEEEEEEDDAA<< 2_+*,+-,/.1010214354648798:9<;>=@?A@CBDCFEGGIHKJMLNMOOPPRQSSVVXWZY\\]]&&2uuugghhhhffddddccyy&yyXXYY77J``KKJJHHHHHHGGEEEEEECCAA66;+),+--/.1011214354648798:9;:>>@?@@CBDCEDGGIHKJMLNMPOPPRQTSVVXWZY[[]]^^ (jjhhggeeddddccggXXWWmm\\|55H]]JJHHHHHHFFEEEEEECCAA$$z+),+-,/-10112143546586:8:9;:>=@?A@BAEDEDGFIHJILLNMPOPPQQSRUUWWYXZZ]]^^``aaakkkhhggeeddddccbbbb&&1YYVVVV}} kkJJHHHHGGFFEEEEEEBBAA8>%$u,+-,/-1011213254657598:9;;>=?>A@AAEDEDGFHHJILKMMONQPQQSRUTVVXX[Z\\^^__kkvv444 JJ`iiggeeddddccbbbbbb**8XXVVVV vvIIHHHHFFEEEEEEDDAA??FP,+-,.-102121326465758799;:=A@BADCEDFEHHJIKJMMNNQPQQRRUTVVXXZZ\[]]__``uuBBV!!!WWW vvggddddddccbbbbbbbb%%1WWVVUU {{HHHHHHFFEEEEEECCAA++ .,+-,--0/21213254657687:9;:<;?>@?CBCBEEFEGFJIKJMLNNPOQQRRSSUUWWYY\\]]__``aahhggeeddddddccbbbbbbaaVVVVTT ||HHHHHHEEEEEEEEBBAA@ s&%x-,--0.2121323365768699;:<;>=@?BACBEDFEGFIHKJLKNNOORQRRSSVUVVYYZZ]\]]``aaaa&&&##-ggeeddddddccbbbbbbaaggww +VVUUTT {{HHHHFFEEEEEEDDAA;;>_-,--/.2122323355768698;:<;=<@?A@BBDCFEGFIHJJLKMMPOPORRSSTTUUWWZZ[Z]]__aabbjjLLc***HHHvvvqq}}ddddddccbbbbbbbbaa``//?NNhqqVVUUSS zzHHHHFFEEEEEECCAA''>6,+.-/.1022324354768687::<;=;@?A@BBDCEEGFIHIILKMLNNQPQPSSTTUUVVYY[[]]]]``bbbb~~!!!SSS%%0ggddddccbbbbbbbbaa``nnVVUUTTSS vvHHGGEEEEEEEEBB@@D('.-.-1/22324344768787:9<;=@?CBCCEDGFHGJIKKMLMMPPRQSSTTUUVVXXZZ\\]]__aabbcckkxxddccccddccccccccdd++9VVUUSSSSbb))8llHHFFEEEEEEDDBB44:O.-.-0/2132434465878798<;=<=>TPPo^^GGEEEEEEEECC@@$$y: -,.-/.2133434465879798;:<;=A@CCDDFEGGIHIIKKNMNNPORQRRUUVVWVXXZZ\\]]^^````aaddmmbbOOi%HH_VVTTSSSS*MMFFEEEEEEDDAA>> $YS../.0022435454759798;:<;=<>=@@BADDEDGGHHJIKKMLNNOOQPSSTTUUWVWWYY[[\\]]^^````aaoobbrr|| //>jjTTSSSSXXvvHHFFEEEEEECCAA,,Y-,/.//22435454758798:9;:>=>=??AACCEDGFGGJIJJLLNMOOQPRRTTTTWWWWXXYY\\\\]]^^^^``aa**7bbbb *55GTTTTSSSS55GCC]ssFFEEEEEEDDBBAA ^S/.0/10325455657698:9;:<;>=?>@@CBEEFEGGIHJJLLMLNNPPQPSSUUUUXWXXYYZZ\\\\]]]]^^cc yywwbbbb  XXuTTSSSSSSbb||xxNNEEEEEEEECCAA((_))0/00315455656698:9;:;:>=?>@?BACCFEFFHGJIKKLKNMOOQPRQTTUUVVXXYYZZZZ[[\\\\]]]]^^|11@aa````??SIIaVVSSSSSSRR&&5FFEEEEEEDDBB==jW/.00215455656687:9;:;:==?>@?@@CBEDGFGGIHKKLLMLNNQQRQRRTTWWWVXXZZZZZZZZ[[\\\\ooqq____^^KKc 00?llttUUTTSSSSQQ))8hhVVEEEEEEEECCAA kj+*0010325565767799;:;:<;>>@?@@BADDEDGGIHJIKKMLMMOOQQRRSSUUXXXXYYZZZZZZ[[[[[[\\BBW[[x^^^^^^]]]]^^TTSSSSSSQQKKe$$2HHEEEEEEDDBB66 u>0010324366767787:9;:<;=@@A@BBEDFFHHJIKKLLMMOOPPRQSSTTVVWWYYYYYYZZZZZZZZ[[}}yy&ff]]]]\\\\\\ddffVVTTSSSSSS__RRp ]]EEEEEEEECC@@^u! k1021336676778788<;<;=<=<@?AABACCFEGGIIIIKKMMNNOOQPRRSSUUVVWWXXYYXXYYYYZZZZ]]"ss[[[[[[[[ZZZZZZZZjjttyyzzzzxxrrjj]]VVUUTTSSSSSSzz77KwwEEEEEEEECCAA114,,21224376778788;:<;=<==?>@@BABBEEFFHHJIJJLLMMOOPPQQRRTTVVVVVVWWXXYYYYYYZZZZ77I..=>=@?BACBCCEDGGIHJJKKMMNNPPQPQQSSTTVVVVVVWWWWYYYYYYYYpp^^}||iiZZZZZZZZZZZZZZZZXXXX^^}}yykkbbeeoo::ODD_[[EEEEEEEEBBAAF e22325476889899:9<<>=>=?>@@CBCCDCEEHGIIKKLLMMOOQQQQRRTTTTUUVVVVVVVVWWXXXXXX @@U[[ZZYYYYYYYYYYYYYYXXqq~~^^11BLLjkkEEEEEEEEBBAA&& K ((324365889899:9;;>=>=?>??A@BBDCEDFFHGIILLMLMMOOPPRRSSSSSSTTUUVVVVVVVVVVWW77I VVrhhYYYYYYYYYYXXXXWWWW[[(&%%2++9,,;))8"". ppooEEEEEEEECCAA22K104344769899::;:;;>>?>??@@A@CCEDEEFFHHJJLKMMNNOOPPSSSSSSSSSSTTUUUUVVVVVV\\XXWWWWWWWWVVVVVVVVVV}}%%3mmEEEEEEEEDDAA== # "2244657699::;:;;<;>>@?@@A@AADDEEFFGFIIKKLLNNOOOOQQQQSSSSSSSSTTTTUUTTVVVVddVVVVVVVVVVVVVVVVVVUUUU ````EEEEEEEEEEBB@@;"=32546687::;:;;<;==?>@@A@AABBEDFFGFGGIIJJLLNNOOPPPPPPRRSSSSSSSSSSTTSSTTUUUUuuaaVVVVVVUUVVVVUUUUUUTTTTTT!!, 00CbbOOEEEEEEEEDDBB??Q"?N54557798;:;;<<=<==@@AABABBCBDDFFGGHHIIJJMMMMOOPPPPPPPPQQRRRRSSSSSSSSSSSSSSTTSSTTTTTTTTTTSSTTTTSSSSSSSSSSSSmm??U)AAYllccGGEEEEEEEEDDBB@@a?aV65668798;;<<=<==>=@@BABBCBCCEEFFHHIIIIJJMMNNNNOOPPPPPPPPQQQQRRQQSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSRRRRUU^^JJFFEEEEEEEEEEBBAA""raT667688:9;;=<==>>>>@?BBCCCCDDFFFFHHIIJJKKKKLLNNNNOOPPPPPPPPPPQQQQRRRRRRRRSSSSRRRRSSRRRRSSRRRRQQRRQQQQPPPP]]YYHHFFFFEEEEEEEEEECC@@$$zL447799::<;==>>>>??@?BBDCDDEEEEGGHHJJKKKKKKKKLLMMNNNNOOPPPPPPPPPPPPQQQQQQQQQQQQPPQQQQQQQQQQQQQQPPPPPPOOOOOOhh{{~~oo[[HHHHGGFFEEEEEEEEEECCBB>>c;548898::<<>>?>??@@@@CCCCEEEEFFGGHHIIKKKKKKKKKKKKLLMMNNNNOOOOPPOOOOPPPPPPPPPPPPPPPPPPPPPPOOOOOOOOOOMMMMLLLLLLKKKKKKKKJJIIHHHHHHHHHHGGEEEEEEEEEEEECCBB<<I329899<;==?>??@@@@AAAADDFEFFGGGGHHHHJJJJKKKKKKKKKKKKLLLLMMMMNNNNNNNNNNOONNNNOONNNNNNNNNNMMNNLLLLKKKKKKKKKKKKKKIIIIHHHHHHHHHHHHFFEEEEEEEEEEEECCAA;; + *)99::::>=??@@@@AABABBDDEEGGGGHHHHHHIIIIJJKKKKKKKKKKKKKKKKLLLLLLMMMMMMMMMMMMLLMMLLMMLLKKKKKKKKKKKKKKKKKKIIIIHHHHHHHHHHHHFFFFEEEEEEEEEEEEBBAA33 f77::;;>=??A@AABABBCCCCEEFFHHHHHHHHHHIIIIIIJJJJKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKJJJJIIHHHHHHHHHHHHHHFFEEEEEEEEEEEEDDCCAA>>##uU40/;;<;==?>AABBBBCCCCDDEEFFGGGGHHHHHHHHHHHHHHIIIIJJJJKKJJKKKKKKKKKKKKKKKKJJKKKKJJJJJJJJIIIIHHHHHHHHHHHHHHGGFFEEEEEEEEEEEEDDDDBBAA66<U1 g<<<<==>>AABBCCDDDDEEEEEEFFFFGGHHHHHHHHHHHHHHHHHHHHIIHHIIIIIIIIIIIIIIIIIIHHHHHHHHHHHHHHHHHHHHHHGGGGFFEEEEEEEEEEEEEEDDCCBBAA""r 1 -22;;==>>A@BBDDDDEEEEEEEEEEEEFFFFHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHGGFFFFEEEEEEEEEEEEEEDDCCBB??55.|W11>>??@@BBCCEEEEEEEEEEEEEEEEEEFFFFGGGGGGHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHGGGGFFFFFFEEEEEEEEEEEEEEEEDDCCBBAA44_|5Q33??@@@@CCCCEEEEEEEEEEEEEEEEEEEEEEEEFFFFFFFFGGGGGGGGGGGGGGGGGGFFFFFFFFEEEEEEEEEEEEEEEEEEEEDDDDCCAAAA55U5c@44@@AAAABBCCDDDDEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEECCBBAAAA66E c700==??AABBBBCCDDEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEDDBBAA??==//7H f..99AAAAAAAABBCCCCDDDDEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEDDDDDDCCCCBBAAAA99//f HK (M&&66AAAAAAAABBBBBBBBCCCCDDCCDDDDDDDDDDDDDDCCCCCCBBAABBAAAA66&&M 'K- F%%}44??AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA??44%%}H -7U""r((..2266776622..((""rV7VVSS 88 ,nn,?????????????caronc-apprise-dfec414/apprise/assets/themes/default/apprise-failure-128x128.png000066400000000000000000000374071526720371000275410ustar00rootroot00000000000000PNG  IHDR>a pHYs   IDATxwՕsOA%@"`xqZ ,Kt/1`FDFy4ɩg:V}ԭꞑ,avtC|`P> @a`8 ^}Bm.yCRY}ѨgS{D+K@  iG^/,<\PSSPrtp A\ tEtD4 84DG4zYB }6<Ҭ ph'(\Ԃ39ĭ(i{B!6bD5>&,pt ˁoIDE!`R0|0!:\)sXO<_?b]o/gpD5mpZF(e~ G,*(`b0Hϗ.d pCC_;:hvQ@5hO ŧ(%UVCA@׉kÚ~~۽ީW%ON+,3-'I}bȤ"ao(ĝpf_ Ew:,v9+WJpNXD=wt;[ev Vvuў9xG`v.t*../gZn.CQG1NVDX`5nm%=n:(,ϝ&MǛH LR M,JK$?4wfK&#&W 0WrTOUښ!PTETM|߱|u"773H8*9M2Ɉ|I9AT1ۅ*IB _E [9'$Ɉ 䌊`.P[L.Npԓ,O s:PO׋EAQcR#6x] M尜'c6+;0k#En7疖rFO#1I@Mc+ 7O܂Ӯ Ej]=pmm7@3hZvP(V!]gk?W.tpZI$-]~|7s1*(BIY,f". !MTױs@eguKu31 ^=.^{J 0c/HD+K1߰XRXďN%2̻b>~Č_1AUͰV%IG aTEIlHX&8Yr~i)74d?4HsWdL %+B@PUcR!!~t2YMNSYZ\+7v}-C H$5:Pp(UKWz7#r͏WV55O7Qb(')xi,MXg[Kg**٢MCqMM A';64D[[e>' ODUW#-!DJn|9пObU1R I 9|;N;.眃K$D8Cs{; iI%R\.Wi)qWUC .9yyx7S#! o #O\QWP]|%>PeCRguVW[o?۶fv 49&pƌ̨}:99(.IB!❝@Y^RNzb1RxRb)}*ߝ8"7 ބ=&ތPR0_KT>koy3԰A>z?33g$|jn.ÇѣT_S}}&Mbl=pMeQuWVRW^Nuq1Eyy^xy_yRP<0񎎴#沦^d2S½'0v K,̒br9X<)@H 0Xg 3fM^@>-Jww}&巿m={Ψx*+YHCRG]'i Kѣlojխ[yqW+?(ڵq=tc_[2'.-@rZP%UDK:ӓD (&_5gd @ ߄ s aߏYB\N;wy9Ǔ|=.J0EEbhhc#B>Lظ7GqٻO/_nXUPLnF>CKسKKoe\iX̥:^؞_s]aht)|UP^yeLGPgg2 SSwD<{z}1(\K.pJj/Kn::[[K%੯O ak57siӦ}MMfj'9rA.,/ s[-@LY ;VVTpF"lOCi7c39HPQL ) L'#SX7= /o{M厦&X r!TX[[FM# rݽ /hz@pd͸JK E")QW?v>M1='HfHEd,/-eZnEpKᆅS, 0 0(nG OC5ŋI( WtT,hiogRM q@6aGY.:Sp4ɓq\Y#!Htwyf{{Y8y2p1}{zDx rb*X쒔q;Or]n,.!IzEM֑4~3tJ=hl QT1_h{DuϞb}}D9s _0-T]~}R&9WB ++dw I{ط@lyuB4s|C9̖I/uO ̞M4gqqoz ]QAӦ!ȁ].wU(KU5ˢ_'nʊo\ee) oߎW8'}U3$]o ^?aR~T&9`U3u#H \%i 0D@J^YQd(C`\ܥӬB<}6AWQі4#L5.s.;W^>)>,7\B!V4=ʑV,Zd` E!:4 W~>UUݲ>bBƕ n;vCƲcMGݩoINmM\P^NC0')1Zb$KoP,ɠ$0H$a4 CC-*"8w.P1 :,0B0X[.4(JWށj 8דּ|}{nmldqLUXhPpB&B!孝;ܜޒ<Ξ5 4hkA[/- uݾФX\Xtx9I34XQϴ SQ\Kh `^)I ``tPU}56"iaϸqKKB!kC72q#;v޵O䵷w?c?ddaZN̝8:7޽;Լ<rҝZP@7u-1@)py\oօsbQ|$'_ \m>[=fwe%ߍY |c?7;iXMdo"-6lEk_KO͆ݻ nצ0]]̨Jm2]BQPd%Qb99kDh 0J`ZnjRXf1sSBx<ԟXg\3ҦM wuu2'zz-+Ka!*Kq :( 6K=^*}2=CiHJ]Q#!#$"0:yPssW=reM7YjvW^y%3gL9?'Ov xYvu!…j$aIX`xWH[D Ų)6s8ە@Fuu1qi<"%??^].G _ kY0ϼvj%o4tqs`| b3bs]eK%H. QJ* S):_rZ>e99?~Lx`ɒ%\~#N⧏ r_ DCX۝ kl/_b.Fͬ 0ê%.!cjEw Bވa6 V\`_FiDP'$gBPK9/^|L rk3Zoʔ%NJvGC$c*`iijƏ73J+FSY) &C<] Mu! KO"ٟx1j4]#vZ},X|#;mڴV`_k+<JKqWVf4S.{[Zh11E'#{%3f$A¡LzzQ `ziF ax>[>+G`uQ,_WG$;`\ϝ;o5\r'f*= @`|1RKKNH8QYБ"SN'X[TW]gfc K=r]ieR)rVT>)3],^USf=BPhсz߯Y39ak.y^~匮g?=_(n7yF\IO{'L@~^X>m.7Mto PUڱÇS3ji֪1( Ӂ1Yj{nYO5׺M Qj ibb,_N\=ϗ.]O$h7t K/ .p<=fB0n\>xo{o{NĒSNATJJ64CKx@ӈdo̠ .!dyvH*!ⵚ}Ĭ!I)P/'H-+Cx/};3_?x 2n:ΠPojR%BK-n4$qz :Dv;7`m]B^09g*۷gv%.!DNɤ)eopԬTgA⯯| \99t[nǶOw|AY^=44C=DsNϟW\x^c z/+]U5T/V,Z+VwM?kRZgz$3}:&O6MvKq{Oݞi-&E6Ǒv!#ZqQzƙ,9gGS_Ox׏ITWW;kiiIZ3\/"a|{6|N5і<<ζK<_\=Axn❝Lopo5 ].Bn7;,^d`'].{bU>gxLO tɴZܹT}7 T׬n[9Rd""?S3Rčq`X Ԃ?{x{{DLrWEO}M{^z,=mxckN0.P]֩57eR> 0EEq݊K/h!u]\w睎XƼya,Cyf~_fNNNy|jv9=f`j|̬`Fu5!^}7L}P: k_]'8al4J@M+  KOQYTA5[R(lM[\LgPr%k~߯^}|vRA2_i!9Ang+^x|3wo*}5kȧD?9>~?x#.U%лFY*2$7=7MA?y#/jB)|Q>>&oë-[8#Sppp*B~~>/ޫ_[i{I._iu3IDATu++qWU?thT?r?Ngo/_y%3Ǐ7ZƼJ'@2ߒPoȾNL.ew::.˸MDJHT_EG~[b>c\pTVVRSSCUUTVVfzVG?+WL"uX:q"GӢ^}˖ށr* ц_: TXs)hArh-ѣg6/HU]+-J¨Ǹ'9ѣ;@EEwqxE]SO=v썭[5\l2 眍PrTUQ4yZ" 8sl.X|IU2G h{a`vm^o1y]g( ɓfbm381̆yxi6dPJۄkintP9k6|wZۍKJoc#s\Z}F57nO H<#uO~Bgo/y->{EB9pp7on2G=) pie<807x#<]]]K___F8%ѥK)/*7ej`)<},9)dci`{JXcz7<.tpUU,s FQaُxLPơ􆔃V/r8p8; ̠^}5P8<2Aܹ2|bٲQ>vBh4k6l`l lnAnp ]@z)lem}r$%tt݂:Pxa۬xa:n[34qW?ּ'FϚ5#Gw^9B[[;v8y/FW?L6W;5<`((!ՙv9:{mrv9 0$i Dy)fyU$4ql_8kTE|l9Y}Bntww7 UQ ^ rr(.| ss xeݾb1#z#G   D,`FCZ8lhv*˦v ABNy)3VdvA\Pn3:O2,^L}e%F<`K }Ά(c LebM ƍR2>c1aN_nB"1M =4MQv77֎r~Ι;_vں$nլ|L!3<6(cgՍRg@<O+vz%vUÁ瞣}&Vڏ}~.t%gŅK0BdoD_n۶1 nKaIc,UPRXHEQաw"h7$*u'.x/ =2o=)N ) "h"Au.hwn.n+0xY.[2o`\x1O2[G?1q8y\rY^MCFwv2mq1mo*|$&fܤ$?`pnː3,/>Ӛs&w~/15"턷n%֖nw dkc(9wtoo7v4g՚"H{|VNw('yFH`M PLÕl([j,ͭ[9Ж}GPUZ<9D wt 8}2^ۼts5__y%%%D oFdmm҅l<݌|u{ MKŏ))''_Kjl`Znڳ0KLlF`vF"E":0HySurw<}At]l|fZZoo3f"H3ۍJSDE&y5f}&4oc}3a+LN$|m`t 0< 0qǀ SR+sp!OXP8L.p\|%% /_Ϳ5w=DNX^.ZPRhkkلeһ&3qBGHo[e*Q&ȥD ]'ôw ӽo>.,X9PUEANy4TVpL7B3r@Dɟ6e𕕡;t{/>tihjbԩB1v5X 33E6;ҵv_IʙB6^k{7;s/]$f\\5@0݋jCgS>s&\0w adx(ġ_"c.R{%'>+*b0Kɮ\ccS`3 ?QX;?50I*`k?i}Ky$nmx $q60Cnj*jߺέ q\ƹ8~=ɝCEuuF»;f;xo\vB$Y qVQ޾&ne!F̿"47X ()f;zOƻ %]pj/9:BwKr$0vtR0i~q5D)-eĉ(K11Yx'rHU(߷+Ip?dkǻ>Km5_NVВLwBʒOH_VDW_9?K'Ь(6=MPR ۪@S|"1&vv}׺yg]㘖@- _Vm70 ș)5fEiZ@T܄ W/ ˲X!(Guzu(Ə'/mmE}'!<~ k[tg#lǶ-[2nIɿ Mpy LSRAU LA_\6tRk$+zBʏ*/=0y8.Z(D7씯mP6W ȍf:opݎU=V%!ap?9BQ,D <FcѼZƚDmT0(P_OIx~bZZ=XB+}NMu"fV0jͱO!ƥ S!'-AR)"66u7!cj&̱' xH[Y.|ˉz`϶+AK8;}} 椀$d1XicaV£(u$фA?/oTk;? Xe@z^Xj,c ŲWNєĉ8O9—m's;Uٯ;Q)`"0~p@?)x(u{,$kf5Xj$7Zl !Ɣr0c/p>hG{pE+r<%d P$QP;y 8EYG[xq>.wO2 I$_yN@~{fvNX]umQ!nۿh\~68 VGsP(p =Bޘ)x;N6IvmVci?uvBh' >\pVXTYg^u2>\'ÇʶmɳG ~pɰl[ZG,/`rN} 'nïr+p*𞈦s`Wy[8 |#/TsaK*yNbJ}>\..~3cm↣`mw7=t dza,d8'0=J-+Knqk$k-@\YGm`Db43o0='a2;{o:%%,*,ƭ(m{Bmc1M#blcU{;a - )9<6yTxq c1:Q7bW(d3ֱ&FF_: |cKrsT5WQpR<Dk`x2yߍ `S0_e~= a`ORsKXq\w3#!g_ R`t HKaRw=!?qB `F fut]m&gvqFz5b́-p5@t!AI@0RHKޅl=fDf( uIENDB`caronc-apprise-dfec414/apprise/assets/themes/default/apprise-failure-256x256.png000066400000000000000000001217131526720371000275370ustar00rootroot00000000000000PNG  IHDR\rf pHYs   IDATxw|Vze˒-WL)ƐRL!MMrpo !  !0Mƽ&j+iwc>3;3; 6|i;;<9}'}'}'}'}'}'}'}'}'}'}'}w >rR Q("(2I@;7~Z:]`O-3}J9p"0 4*߯0^Sw HͿ5 m:`)X j @SL&~$RMuE`/et}}Oe0Pc ejGM=[jx}g>2P:T|?^l^1s}B|\d.ph5bcm܃=xGI"@1VaܳI_pTI p,pp&:Bؤ($0"B*JLU*?itit6%tT&,뀅cF'}Ӏ)C"qEapAb1 QXH],F"ҕ\Q( zPvBXAWe3FёNn$Z[Y6ttЙ>p$ɿA/)8X_LH"BBUH0"`Bq1㋋D(P#wyw~VtLӵ$] 3R*(c1آ" (4ugnOdXβVm$;:;i?xD;p5pЄ^'}*t8⸒2".g@4Jnmni(@-Hte2lK&ʶ6^oliJ~< g O 襸,/S3p؊{䲢;WnY߹oft{O:3y{p0d:p0+~H¤>Y]ͬ CNV}57C/T[6ʆi0<5ⅽ{ypvoi-&9.5<>3=\A"13Wvoy%6{pasG+]]]rEOBob>+S/+.挪*1_<G nILYΒ&ݹZZ X7AG{sS+*EEwL\$2)HA2aYK lݻ{{@I\ + ]Y%uu4X7T1nC0d}{;m3{?N'Wg>w L ]Y9 @dl\zgzn^![I߶gae[[oζzgb||Oઞ8  ŬZVq!7 f(ME[A0kܖL}߶8UFg>rNU064pJE UEn@QCʋ|8W-3); A7f'4tgٚL ˌ0})!>ltB@R 1/%*YG F@JewS} Ca.ك[7nmh Y'(0I5|ћuIy(*XSCm;`Wyy7Jws buzY% 047׭[ydΞ5 \NNg> \ޣHQ;t(ǗQ2o3m{Zč™^tLʕџ Q"s; ׏ '! Y-lt`FN ^riR|7~v-FLڵB5%`z痃l~(XpPAQ^x9s+Pݼ U30Z;;t5m#dw7l7l _KƷ#G_qA6H ]RzPU(>?Ǫ/!Dʊ8‡k>nk=%= C+Z[eXho {}×i謱ey!UYɷ) J-BQmW$; #() l4 @C2Hk_;vYa|6:o~_+T#$/G!xUAqj YkpĮ(뵽F1q8U*E|$$_>(Gu_O(* cFEBѕJ)\]}Ŋ"ŗvPq\͸FM>[׋z'f zb|>آ"흝ys@3?G]pZe>h̽G+@s/dу^B5!/;W0@XHTOJ`,%}fCFd4R̓>>pq/?o@^_o8|W90C^s "Q W :*Ӽw.1@5Y1|<a6mKC83+鱷dWjz9?>u>灙6,92P'+/) fW}(෪xw)|TMV.D@:J LP:ۣe' 9Y{ J(c`_;w5ke(0\-_/(ØXZRH. 7YOw[ZsS~3.| pRxѣ/0?i@57.cO=ɥ,km b3S#] , ~:r$ ]sf<1l&@9\ݝEYݑ~-XNpu\SOKHAECg$4mH __sw7-_K9«d @/|1fWTzTEXUh){ϩȺ/-VNO!/FJ u 4&wiշ_6nbMpD"z&CnӐN"Luw[ AZ:30uZ;1 gz&Qy6ͤ[[ɴ= <@*Ꮫ6qA߁ @%|}vX3(gVrz(b}UH5( q$tK]Wn?/Ë/`>n@~aDx@GFùsݎCW2 tmJƍ'FQ*%d˖-z { }Y-^͠JJst+V$G ű紭:^Wi"oCsJj Fp?< YrLILJbdB> CzBè*+ L|Բ2MMh1K%%$3ݿ?_ KDG0p<{ikwK)U\r@;^m՗k?+  Dʸ;>~<st6Z;:h`_K --kiή.i SSVXH2 HbPTP@Bxx ;wҾt)ݻv靁&8ؓ̂Kk/֬͛}4i CN$OmqAm-a7^}_W}+*q8:uTC6^V7 +Ϫ C(-izEA@z89Pw F!/'c)8Ѧ߹f)|E"& (/Siڽ5$/Fdvݺ|gw~ @}F% j( #|~XkcPV3[՟ߋn@$".D('l?~;ݩS#sС\O3g$ᰫBI3ǠTY L:>L;@ k7H\VkoO.3mBP~ [\J}y n S=PHsCI@Cf& SQ=7}7v:l؎F~Uy*)-,?بQ(ݻ!qr܃07N\NZϏ_6 QÕ{7?ovk^NOd$~ 8s cAtpC*/G( ♞x Aňm}kn厅 i NuФ-w%KزgWZj&TYIt2d D(Iwd" ^*|ѸW-28QЌ.8uŁ 8 RoӛG,<3|{6dIK %U)8r"uu!!t 袯Q(Qs>xEZ:>fQsշUG(dX?[RwZBQ\yV|8>(9qEEsB&kjP Z5xG[a{c#M3 b,VVtޝ%E!6jeK Yu+KWHV쳴'3dX̆ DޱL[[`,nMcUw>?m0s @{BmmR7Vq4DGQ-%U$%u ncڂ| Ȑ!'L1wΟϭ'=<Ͻa@qkHto݊n)q oً̬A\ͻws$+Yr% P[UedD !D:r&U~ہ%34dtD\0h]!^+!0V}E|E48@hҀIGg׮.y I~|Sww$`7g.?Ÿab:! l?\Z&M%PzU۞pe~ʞM!= ӂzƔ-S褓P$Wŷ;dKwvrڤIH]Ӄـn`fsHM BB1BD,FA4jz0B"IO|N6t@+پo's 㺅Ҟ=dPTEw_PŸb7O bvŗ%@d,%7 C3#xnr 4 Kh͛Kqwn@E 8bn`B^e2N뿝@Yl#RBDjks F޺u|YiS>ʧgO;hz@I,jl!)>SNJ0"H-<˹cЁ+(Yp+* F;pxJD!9D4Jbҿ</N֭㋧N()JK޾]o=%&3M*}wNfs:IKѺI77ӵiOj^MPapqќ9tvubf:$0eyw޶-pjP4jq4Wp'`j(t4%u 9ٕSQz+N?yIQ\i%W^b}SD8!z"َod_Yv55Ř1vu~\E3g1Xxp=>AHJYr%OHiU%TVFUCξ Ea@,Ƴ{j vK&05PUU(4:y{^Uxr@9Ise# 1<4g\vB%%z]4jgʕwvܩSϥҽmΥL߮@U LtPG7NT33z4#l53i:WXᅯR\@7r3&Mbgc#m>ttxJ.:㌬-K$$&Ixm${{n 0H ? ..ڠ:Z[wo)2KJi.BɩC^mU7Q*1@TqVI A"{Vc5pI)D J7z:đ#\]PHO nK\uJ,Ft0g&:x0JBh4 :~HDoT"\WaZG} IDATZ*|遤Rtm܈L0T ;e ;`lj-dք,Me YXݻi:lF= @57 zB!L9q?Bʩ+oNs9UH/P,yK%P\mנ8+Fb'4{,ԃ` G-bsϑ>P-̩SY5 o s(3" eOH#6r$~t+!OMC֭)IΜ~%6lG_{^y%?<+6mbOs3ɮ.ҙe2 t֎6Ţ˹xwZT!(,( C5g bD[mހt^M' 9'. Zi[3fdxdRΩM@i8LK*=c+8p*}cFkCWCv|kƵ^t2K-#&_ /Sql$ 0E cuB[Q_60kD˳@8yqB$&MBҥ|g?5HilW^Eؾw/E8iTErE sFBпڪ*~@׷3dudC&,@Hۈ Bg^$5xu8TvNfjIy(H^_qٺ\Ss[KV`%jFDBڪ<[iw$2hm8ZZYhUYg)!IjCHTF"o/@5*YUL+/G ЄMpKq cs3} s݃@ۈor|-RW.Hx%~wsŋy|8LlhO:sx}ٲ_&~eNR;1GmQ^M^˒~y8-xϳf92Xq}_4rYmGʼ68U |4R(җD E5C_E.&\5~xWAa_ia!%!;{Ǽ"1}:HD$^:zTc3&MbJܐ[ԛo‘J]>ΆU ?B/9p4g /\rqх09sl5)Zi]_#:y Zf ϼS~x4IqihmnJ>jF|XqɊ\_aÈ KC/*/) g\ y+b+}8oJ"нJ7 Te+g,q]t#c[ {j8=awlcdVP1\.BJQQA0޻'JoOcqKLd ڻ׺P(w;j0:Բv6.X㨋(8QҬ@G59'`Fh*H}JD,?pߟ\9,O--cRY{QhpǍeׁJB$d_۷ly{A&ʪH{ŷ($N橁5[G?KVnĉ&02Xja!ݛ7gn%RPQcyg;;d2JQ8%t̝6SHKZ2$QbY Ț*.3 Æq̙:!< KCAC/4fck+?y}rz[H=ڊϘڵG!|9d"~R:/`*eI{Կۿ]ַ,& oϧMEWW%~Lq V8';(,P]̪Am)N@z~sJY[mނ+z0' 8ه ,,W@Qaی=V~XC!Cl_z ŠC--㳳fY9~%G$o_ڽIOjRvڹ[\$ׯ{6YCh%a+oBdΝL(hLvG:; j a^],8G3UɚwzŠ3|67@0/eH,w*c zV@&@+fx7")mT44x(s=yNH5K qijmo?Y+]N͛\U$Wszw Lf~RwӹnmK⋴}69{D* "$c.#ݞÃ5 1q@9Hz8_?*˃?m!7i^oIPNjxCl?\rR4 |LC.Ys^yMFqycCZ۹i9moeE@@*Er |3 8~0y j"tHEQ@-ҝ'< Enf.R/k3#4{\jyx׬kF^|;\ʲǺp6,еش7$\-,s2A޾SZX\{[ZC8rcy]!E!ucA> xT_Z毩UPVccLY)yyq^iO"2d4 :T:nYG[L@s55kࢹs]&v75d/)f3z-+IACM2{߈ވ) u^J2&AS7))迖!rW|!,<|56z4AlۼoiI%vDt$/ {ͣ0th t~_K e( ()>&"г;pO 㽶PdcsM lX~wW`aq{X]sjƠeuA/!#W=K 6j5;ٻ㈖nnyaI!roji 1,i@QAmeAA"jb1?4~\ex"ZSuu|~xBy ٰ|]Ko,ji"ͽz՜9ǐuo[/_΂_Fl1VL MlΠ25EtRY1W6PgZ9U:GqQ| 8TSN e %{9AylU%>n!g9E4n~vIuRuu6rh\fyкr\MBnҾbж5-`;vo*@&H7@E4rݶ<8]*sj@β_GӼs(KLj}c3sφ,]+G>*vV~9Rg卑GGO=~IZZj;wKGG&&2 xA@H0? 8~AX8͊Hpr@ lj {!f=zV;{JN?Ѽ Ġ JO0>%^%%$/&bԲ4D.#Ɲ{os3MAm PmT!_pLuu .w-͗XCA@OYu4w0G TYIĉmyw(e7db|VCgjP-/V Q%X,h>KkΡ,jƦ]:di(j-]cSW%D>7ċ X'giŅhx&S8y.w?7=UYl>;-4)4n`}2UP~~gB$ZTd=Y]fstfڼgCAix"AwMBl>*=  ZM 0\hYwމ7h1UE>l+G\"x4BEE/o+[n,LymZZJT"|Q `Ѳe q?v PDZŅᱽpVmH&CF 3W 1'ƠX ;qZA3Fq /-q(ǍE,mf&Tfw^o_w7&&UL1Bpbzh$''xIjq CxvX"o> 7ۀHM !Ζp:!g2{U&qj.ߚ9?hs 1%[2_ط_4J??1'y?a\WP-SbPshV KT<0PSO%ўL_礱G׏o~O׿fΜ9|f-_,V0afc GIt{\3MJ3)fV蹍| Lr&LCB!#t 7jVH~MR)~rP-I'Dii)-G?^R4y1RP@LJʹBH}M)Z[IMo39!OQs*;"w z$繾O됭-HpNQ IDAT-l=פوNNӤ l+3TP~ID9_}Ίw4UUU\r%tM 8vR ?eNΝ;ӟą^ȹ yg).._*1iAFL4W_}H$´iӬlDB't\[=ᰭ'G6s Z1gin(V'NsۮON=8JK{N}txc{c*&* {m CxGh{5#8hs )v* ;%]fqcƌ;gaʔ)碋.sO>uJRg9s&ӧO[oeҥ̝;N8;:~s[?_l猍^Z`Ǿ}$քC!.;nE%JJb;~Ki d^Nj/g1|嬳h‡ts3][dՓkB;h#W<>DHFc~WvPq(y܊4 R"ʏ?~fמL<ȷGgUU^{-vFkT+kkEM~GSS_}ә >4kl~%ѨUk~tmlFW\Aia!T55/f޼yrJo~Μ9DZm6"72ƠGH[G;諾A6hNBXoYmW q!Ó(;Ur-_~7^S_R0·޲az,\9M r*ϴ8k\^{ >hŃN((~C 򃛞=n7r&*o%'S}꩒wˣJ)++˙hs-n:ʿʯ~+:::硇/gСi&>֮]K&aʔ)vm466ӟƠҊbtI,\.QSSCķ%AkhCZlΝ>Bnr㷾eSLk+2 `g[y8^(J5p>.T`RBk^V}naFCR~˃P2=_qfc[%dH94#ctVŸ^}5pjÖ9s}k̛73fsNYʜ9s8뮻xYneee(®]xw[k馛Ncc#f͢˗2g+_w7?կ~_\vel޽lڴ-[0vuuq`/^L,ga\s5yɽwTFFmVa>˗Ӿd mӶx1o+bMt^Imƌ8f`mfrM:mT!(.g/cB.TYPr{)>ϓ_˹AY"=?cgA:[)]/??(;}[$7o\tEC&a֬YL>[oe͚5$ .Rlʨ>v1g׮]dԩs9pkQ{:5J2me~ oa)pf2 P9!< $;p\Z#ȣ Y/~1Qyw*Ŋ•?Ž{u)fNwuuquˬz~Zwc?  ;9YnCQ+d馛~a/^ܫϱiNY"L@x,?=ˊ%|>ݍMr }l* _[Kia!HH(D,aȑ,jf\-;x:"N B.^=v |p%%tsQYޞCJ=0Rw#ΗA=YD(vp < ǢB}˦l-=z[}ٳgSWW֭[Y|9Ceĉ 4jƨQ8y7yTbYl'tF"H`Ryhn6?|~a*ϒ;kp<"B*]۶٘5?@*=OpǏ)&s@ή-[?E~Xs' ~`ePeP v;j@MM$+/gԝv K{g'\ӟr?{(̜9Kj*x.\Ȯ]83khiiᤓN3RC!{7}'|I&嬶RYY_ݻ׿Wb%dw*ihmd5vB7meGÀ3s&_: 9>HLlIVc7s!@ s8n|'!W_o:}wffj.-ĦPNtPgn UμR~lurHii)~:_w,bL8z^zsOm6x^zիW}vvwAKK _~9o޽{g^l|sP x=t- Ah}u:9UYI~-/`(Ud? 'lcK<9B>N?55y|dK؎ٝ$%k)Ki).mh҅})!i =qNlNڥ1xf4R@'/Dzhs>g\qڸg?vG_O<믿΃>]wE='p=~!˖-?1'tz*gq^x!S~;wyJ HJ4eʕtttif&x?>?rgOSTTwo_,XފϦ:X,ƽK?ƍ# DOOaS<|sg Q3ǩ=$in&D)ݗ&i=nqIl눽7$DBg @d:I(?Rp)!v} 5_3)((oO;Uc=_~ b3{^seÆ *t?EEMM 4''}~#4O?:JKKy饗뮻w_Ntwȋ/ U?~onAoJJOpjh̒9(Na{`IdZeR\a"ܢ`͢H0 4~QP; U "Sqi~L^\!Ï}t9/^?Ϻr'Š+c~{ofѢE̘1 rWzyꩧ8)//'o뎑gÆ |\zL>X,oazv/LQQ ,?lb=̲enV,^LB.\n7V!1!H2;⸴66BҘX)]"{KK 88˩V@\CHþo Q4'yxo ny'&K @MM O=]w]FYv-o)--.c޼y,\S 7p'N駟FE.2OWb„ [Od`Pr8_̤믿Kr8|fq{&LSQaEc[#gOH KҒ$nR +:8|ALc^H@K{;=Y-pRRRo~}n~~>}O>$'Ood֬Y<3ر 6p[or/~AOOg梋. .+W^ys9G+Z\~۞S0dڵYC-w[X Ϥ~on+2dIrC @"mb87dHK䓙dtk6Ox;~`8L - ;ͦMxGMQt7tDŋxT%ٴi+W$ r 7pYg6 \z,uI_{>UD1Ǥ_'8G aPJ$d\qI(?Õ$!Ҏ~[HtzxgnA!yc/+CUAIij70b,_LnV0˖-K_bܵk;ʜ9sxشi̙3~,[L7ʛoɻ >HZ^z%ibuV@f1 @Rػw/===<$ n7+WT=OEδ(/YZMrRpdpH|d~ 6Ý>/Zs@L¦\UPoh\{_i)38q !lȯdyԋ(%oD,pDQ{1ۆSLa֭4;(+.[W^yEe1C=Dss3f_/"N;Ｃz=igk*wߑ, DŽ!۝U!SS`H$Azm=^LDAl ]}4I6r|91ßEf=SS%+VdIm10jcDz}v.](?>/"*pҢ?)S]˹[@cc#zls{1"'|2~zs ֑"ϭ^;IHYfNnOz"tbt8+m~z-R @~hG2PiMqI'Q8a=DT"̜ׯ'\I!ΗLM2L:::,wɜ;SN9^{-1kjjToc۶m8gݺuu]\K/-ObӦMr 7q}r5੨ g 2h&3,*&4Hs6ފ({ms0h Z>E,F My gZ0P24b,&T0;Ǟ6N\0_}z0 P2UUO#Ɨ urRXXh![NmW_YI SO%|| 9䓙;w.> \}<4Tb1UW]EuuYAAUepKç IDAT!57`81UYy&UAcxL&) vn3&}vew_,F*f8h?)'?I Vy 54kY|DjsMƍc9'ȬItvv>v󝝝\r%42"NnvE>HSSnW_}e˖owqs=Gnn.7>^/F͚sr/X0|wBȡy`ּFuE$@diهl4>of$|Q)b  'RJ@ n,JeC17 )6U*!iʓerG"zzھ]~ A'Nmzn6۝;)ַx'?0k֬kF-ɖ-[8زe Un7ޙ3-wUJ,Z{տ[4aFVb8XkPLe25EDqv"Y/>|ݎ=%;$8ϼ^7j]. vnF,ev\ ¥Xzcƌq>>,ӧO'Hcn2|3 x$<帕![ݨvz2'2݆Pt9ca(0)0ss?_N?Whpoiիu|%j0EO}=̙2k;f ;v)W^Iww77|c2;?OMƚ5kxZz\ ^[.|&cN 96d)ՂM8{;tnD @ 6 Io Swk$jf>CCf qгҭq=HWWK,+n)L^Ztnڕ`IY..!0<%Еu%` *7^ &.\{:ް|JwhֵktSZT]rIŴk.K\93yxwt ي_{ｗZʍb)~\:(m};XpHN=AC `gl{Kp $}|x WZ$xo&h^\t>\Qːc9ff?O=80&O< 9>{3>qDSQl1ÕW^ '^`[1{1,(팀Ɵ!@PtD"V,@iu؉xP"@I0fAR`ٙ,=mmuy L ҹen*YKO`ѬO@XZJ͛8餓z0k׮OTah&hGpH-$3$qVӀm\yGTFeh{ahH?$zu? OHϿ.{5|nژʎK[T(A3ի7:i$?e``qzc-M@ue%ʨ`1QSz䤔+ݮH$E" D 麟;:hlmeO[~>5g:DHSJVv`+%9@ʌr&QIbݼYwg@ ;47Z߆?xQނD,&f'H=(, Q2c][8p@%{L ,.ޛظqϞ<3gr¼y5u*evcXleDQz)5P%P9YQR¬I8sɒݵ׮SB$vxL=\9x{wX*ULnQ)4S3E:*7>o F I\hYP\,Z?qt"?S?y1=<,),bB:6lP@|"B kGD4$=D&ٳg"RUQI8nXDn|2mfj˼ xR,&'.u,$$_2#29ABɑo;ɴK f`zDQ)Z?kt%T:8)9 tb0oۇLock @G$L0Ǘ)8|+PNp@O?߼2T̟OCQ c.ZN^5xr;vXjT-GM™Kp,MN1QbpO(D"HDVX )=P -"##\.DoAz~\ňyyKx(2k?O8LpF»wOi00X|Y㜩'`1 S6Z=3Atnz=kN%^x]>OGJ0v" x4r5;a`֭z꩖vUUM}>.8$> M@IAe[Hٿ)clO=K(_]99[kת ZKԩ9 .`}m-P-[};Yw"̘3SƍQ]]%Cd)I JEh53ity]߬`!(9pM&y!:I$x׎hPUG໏!CM\DWR[0k+q-XQ.E_mʮ{F G",@)Dhj" 3U՘]lkh̬+&eEE@⽽D |z6/31 ET{΂6h2C>/kՌo(*&Z' =57|0Pv3U0HI @K=GGLZ::Xzє$}^`D~L'̟㯾Jkrl.\5NV?J/R @`&B۷miAR~'w ԵFf`!M*IeJcl6>]5 *R8ULC4vwu}@2rxp' S@PI"1cQ YpX4v,ϧP?2 зj&Y4j!92#NM*eǍ ' 0 ]vJ# ;z!Cm_?x].TPA6 E+*DQU;t*wsNUs9E IJQvS^\kfݿ^=v,_t|{LHyC :2C`6ׯG G Ape\I7.g3H 41Ɏwɮo6ci@MeI9C98vmNc^GБ0Cy@yK5\@L2,NٌꂚP^Nt0˩tP#UUtoۆ#Pۃr&+عw)g^=\~t5x Z6HMڼh{;(*uHVU3TWS]KLPUZRoiGNg$A!Ya2JLo'Z[Kh%@uuXwwTԥdL)r'".QղY2tuQBAW'?O^,_x *ADyq1_>t&MJ<gp6z}P UQ{-]wT9`{Oy>R--HJ&fL<4M,Z'ǻ,&Ri*Ym1]NI̒n59^L{c_onKDr ;F\\LV:D`+A@_K3ϗk+|Δvv{_"_8XDATPw^>#ŢN0i&#+O;^s X[iU &?pk0`w$/_SUJ7o{{zӧS9f˅'s3ĜM<v)P"bC/8 ÏS證Q~|Ri`i&>ˋ*9 ti p`: @$̱EEAU4]%="PjjTCpܜ9ԷД%WQvp9TUU Hnq1}uu?n<5\P^N]s3ss˗3. 67C GtGɲeϞ@QZ}v +6lm\4tQMcY-d8KSҔ#eӕײUd;N{oΟE@:7|)Hr{)& &Ix].&*_jM&wAi1ͥp8yss9oiٲs+nX @S-Z[)=h\LGʲ1jGKLt^MMj.E9EE*5V >?)޷OrtQYZiy9a-/PxIu?#Up 8I>jw~ Go>_`(?|Hx\.}.4)=ڊt RUN_9"(;1 Bq̝ٱCUD4 xu--e֤I@lptX_ˍN?m.ܝk垧͢O$h'/ɠ Hf6Cّk(c<-"/lfKd:j,XZ_O #73u$ EϧW /Sx55_QX$sQUŞ6:Oʎ={8eb" 䖖_;'EԩYyխomJM˸qws󡍅twqrΦMi@O;kz]DZ[;σQt3^mBO #L~B4i U g5 I85F,q8`v~>9jLPD53UGn^>c >e8pqi׮H,F iɆ$yy˂lB7׫[% j0e˖Qtrt81| n>^Y.-V6_Z<DhUpd$V&%6哜4".Ѓ1m6SЃ*:|7m۞"JEc5A``1Qͥ2׫P@$zn U"h\pO&)+f},1j  ݛJNmNpg'^["a(J2MIGU IDATL駓3t/I;ї^~aA88>Ϙ1E2sxJm+Sl`$c/4އ5wRH,>_61%y$dƠyxA 0'G`w7Rr~dsũRYZΫ'Ēsl$rɳÝ] ; %zP ?%K(;WeZy_t]8ubƗ̢""ITv϶58lqזBf |9G5IBpml&1Z3i]H;RY#rVOr!""h0I ЃQ1{6.Ed@m]]Է. '7'1cPV㨩%;8=ɨ)W":Q엎d&"(L]'x'G04ţz}vCV8MH4̐R^E%h158F$&)iғ&ʁX{poc#6?=Bk1<..,%Ij L%Ɍ8Gӹ};/rwkc#E|ii12f$LF&"T~a9顨w: %v;+6"M2\/e>bu*ʞ %{Ҿy3_iU Y(C0n*u~#B!jAYmǻMO6N?3Ma]L mNUK=#~rd%r,(,Adg%It|G.zpq18H-lgSR riؤ#QU#$aA!)I^x}]zGmLFa9^3Ŗ,2SOFՌCt]6dנmh"D?K[#*Cy=$cQNBt9aXC݇ oGS"J&͹UOҵ O8֭c\ffJeeʺ60ۥN]ɸZ۴d$ &04 NjvFN! ֭tك~Q<'$ ̞RvS(jPJt . ,h]#hsf BI;\@)eH}}άQqYa߹N; 2LzID s$L%+2Z i3u˒_>77j{f}׌N` pU(X`APo :ct}o@A&S ćx -MO(/Ý;ixB_NKf"MMH9u9#7+nv^&d:PM:$atI?Ģ spvf:~aOJľhZD=Tov.^Cx`!h;Uo:iw(Im-;:`Z#.@+x:Dj_D؅L<cuOo &Pp#IrBPyi&PfL;55!"#4hRMRrҽNpނ^,f"zϞtXy}s}~NR^hov`@u9V1+39ΰ/=Y, @RM-$1@X$ۮ|hÚ #srSn31RKNf62v(t<~Nϑu87)wBO)i1IŦ¤fQjmJ hH t@[%H ߱Cw cpe},♨hS~I!|*#Vadc4kT?]^"]҂eZP-А.׭D`@.o܁ 1Xs 0$Fyn ),x"L&,D!+; %YytrϜy-n4:aы0KبڝIbq|=yHwH7CRt჏C?.k'ƢywIWov[J"f@(B<8 $:yWw|;|ٸ!himndjgHYzKu:P|Ɇ|jwl,pktӎ>(:K ?Nr-Tn//j*.9fsi=1)1lν.yԩ(]Lu]=`+O„G׭!(TO+ȕwjyIOm-ٱM>4'KYsۆ)1VFһ6C$6( F~$1e 1&y>ם}aKss9eB#DX|1)MRP$Talw|~;U Dx.=EY>`Ll7"&% ka ɤ݁Xо^0+A!cci`sC!.]ʿsne40n$vӀF=V!콆Bi/$;e$Ba|'n*T>+dPP^ɞ@|I~pp 3! a=%0s 5OP/0VSA.>gyСKNw6 s1@hZPauz}&0ÀKpL R,#KnEb}Guu4r}% ĺu7܀VO&N)O9`q.+玺:Gd/Z^UiI4( 탃 "F@gua`101 S~IRO ۋJ%\̝3GS.'9չȆZ҅BϰjB4X?Ei}Mú:H?.TaY(%'}L%_$Vuu?;wlʇ)#E$r8p H |}] |8PT6? c)&HdbF7Ln_?RtUX.O6<`4w'A>CG"@{/A[<.7iy[ vecnH]@K7l>a2a)w+kgr< B#7dRc9%Isn;^iQ/ : )^'vFl-L B!5 dx )j#84 fjFen)/SeOVJsO} GdVtoİ$u`Py(aJ,}^Hx o%6& 5 ^QUYHϕu6 yAg?ҿO $J7NƟ$l/*JybrH`O&jB2w@ŧƟ(wJ眗Qlv}S.rg;*(ށ.:\LH3K$Wqެ[-rHV2@&߷%V~_@Bơ,4)ShS〴 `߯cQjiL ʭƒ~ ٰ} iD+z.m5o9\†=Hʦ 7$0_NQ} g|Ӧ,F )X"Ԋ(ڪ*&z}>Dì˅@#p yP=ax,dЌt͸ %5F#[@y:Bp.㤅7fo~)6#$lEvG$ª.<TyrP4M h&&)u䁨#+ %V]K]7ܖ4C; 0۶ :- j?Ji6Y )L9ypD2* i:)eVzu,YvZЌD$ᴏkPpc\!(y(wv;y }(kQpdJrp =(Q74O N,ZU RdHnQ$׬"vj~/x|߾t S-WSH܂@W&L`vAkr6*ic\ß$)oJ/ MH_æ~™a zi6+5Cl-Ң".?*%5.2I .:S0*\;>T*d$h"AC CMMё٭}jr=sdkN*)ayfqk`,3|N()ayi)խ` Bۅ.o2ޟd9Jm$ٻ*1Fytv %y@ǁ5)94]|Ei)VVR+4dc'*u3KYqyvl?f3,V߃!taط3%~LQ`ԁc?39,/-܊ E\I^'y}{EJof(ao:(CX"A0cZg'g'2o] 7pPFJK9yy2! )Ҝ܆ILJ[]zgg @,ƮA>獎6;38Љ 5J!mbਬr1gAAKSPN8b9E}}~ꆆF-!t/2䨌e"p&r`A 0R.;i~2bUROQ0zu/8]]B `#rVet)AIDATV~D$Ҭ8$cp1T|x\.`̔>)nśqOHxx`;;y=I-rw5ryO]POa"r*99gAAS~|TP㿌y瘅RpH{A6e`Ȉ@=p+5|29#uP P06'\LzT|GWZm,Y),@r{(cw @= "DNo3qdJQ5L>0<d$\Gp"99Lz3#/j˅G;W {knkuw EK  RP {hhh"ATynbox93F 'QȈKa{{]>ING*[ I<& qB&>`VqjGV:vڎNg?NP_ h 1aW IM6f_7!9s~sw~PH Q~ OI[[ދ.Xz,1͊@Ҷu<9U*u]/9@YnOxVTQa-.)eeQ#MubhdV-[[KM!˼>KJWMўyM5 !v9~42Zf`@T=Nϭ %vg'㺫@[Rds9fWWsܹ̯czQDkM"Y8OAűmK$@LB zөenV͚CWsl.GMe%\jk8##080UU8'Omlq0柱gVk8@kxhxEVUa;PrgK w+L;IYt.cضNM$pr9VObƦhTbl wj0YCJH,cUnn߸;:cRD"qξnrk_F?dq y{Sp̙t;{^?,ãbL9y ڽq9C6ڶIftp(thS$" }x0kIPArl,͠uvߑ,_w``.1~޿OlDx ݽmds6Z;9;o߶6~n8ۑQf3fl==lFG&VdMMMG*=Ua 9)$1`ׇz\3{N#9>hcҾbhؿxʪ[7 LePЀ!3!cAq֤2F~ 콬ĕg֬d(2s% ]cf_[Q>K$v"߂ݭى+Ĝ5xpaQQn,/@\g4Dc1>8 xm!\"P <_nY]u>^Z\o.+7z߯75K]T\ yA] LʁR[ .h흉*p1b96IENDB`caronc-apprise-dfec414/apprise/assets/themes/default/apprise-failure-72x72.png000066400000000000000000000166601526720371000273730ustar00rootroot00000000000000PNG  IHDRHHUG pHYs  bIDATxy\e?{NoIg%IN$d%K'121{u\+hQ!Q@  @BF:IwNoꮮysNթjBG>MëH!rBu)rIR)`0x;xٕ|R^}Ά+'Nu]5& Ԉqoe0M z[Ϝ!Gg%f'MƣHMC hR"̕0 x>qΣTvOY|ΥUU@lgf۔.h.*3f i]Jt!ХDHTB7R| R%4912?8g+? t`3LK˹]2hR4 ({=PoEJ!lUJWV"4Q$*njF1a0ͬj*H2-{co@;Q˂ a#ѥHnZ=Yh%%*$#u4Ɏ$_8r_9l-0v p5r>@׋GlHZ M˨º[!AHX<^/Kc=]Yd s1c1R== ٙ9H"$U#H׋,.D,RII4])fl9#%B 6 ߴi gpxE)nf8c8#<2BGOaԩL9ϤIty5Ŝx,pjxHr>*I˿U)()RZ!-ݖxN7oͫ'O2s 'F%qP4]M]2v6  tLA$ AHי x؉.^RMf3>4ucxR%緆$"o\<mW⇟^yf%^/&š`H0Hpph}}O"ՅCm8LkQ7^vqiFIuwÊ .l~H`z0H_"He太,@Kk}>644"m0,uKDMJeޝ%SSoytEG Fb1,YBQe%ɓ'J!;y2E-^LpsojB+.ΘxzzXVVexm]](X=>K N-*b#Eg7Z644ReH8#"cNJ i !^/3GhZ:RSÂPt?2B_-w_dǫrT3gR܌z11#&G̺"v;F$c믳 LsxJ_J$N\]lE KKhiQ;iiGfAu Zy9'ʸkT ӤYV/X@ zzJKy wŎW_ectc;/Gu~xjk .\Rbմ44r[{54 |64[`xKvzAi)K+*h% LHUHZAΑR:- F"ZW+0e n&Wfp̝>== F"Dqvi=# R TT 4)t"h4Nyn`Kj'B40 _S KZ:-=+[Bs'=zڲg;4DK8̢!f=5EEl۰˗/GA4܃aεalDJC!oX**Ƥ\>\WSHJm@Z/;8q;EV%Yggo/ @CC7x#wy'9tw}7`mףWW# X 52ki2A~mzy9L`ӧAJchM e'#1`PIJ`﷥DaoS TIi'%Z @j,6>8'{ztg?˷m>On:yϺu2wK"҂*\K.jASwyz=zy9޺:=Xa*`icc&xŽϗ&)4Ǥ\'Lp+vk$T|Tyhn 1:q"ë9K>@;wdӦM mFm~c8_޴ 4 ̛gqP =[P׮%kh./`yW&qf:]'Y-B@A4rQR%d1kkZ^(\=ݹR߿q1555r-}G[͜HvT&qM7QHxR~Sh_RRN!KE, 6Gx$iR\Ն1s5Z @u [[\y(஬*F"LCq̾ 6xǶm7}:B׹e">wy9D_z  u~~䓙hkR:S_^!K-}!2sP55ܱy3WqH2k,ڵM6ei|iGǐ 3 g2?XyTObnlچ z*bРɩV*|+K/~u_yؘ1N zcɸq_< ;SS׶t7GӝV #/!]4Vפ\,Pz0HլلjkID">~o oo߸ǦR)/{ｗnG}4G=}&QMMV#P2MiIiL`sp={79`d+'Ldvc#Ov&*U:7nܘJ0jiaqeSNqFnvnf|?pOLlˀxiz4S;1^`U8DӾ $n_~ :zO${Wb6Be~ӟrU3G AIQ+*(+.o;lTp$B ٔ=ێҍg/4N?QnskvIȮ;;&S)ܲ!%}Y2{6-eyvn"5RD"~BK[ZXu,>2F4J$P5`t-^ c{q~o}H lso.Slk+20O&BU^/JA*>w'c믢\v-{7IUU,5Ws٤:;b믓"O:3M҂ 1o' #q*c1M&9}ہQ7@+hǙ d5}%Vq"aUTɓ0,]֬H1`>7ތLQȈ5h?VE!]?ח1X kr%^!kNSZǏsuJ+Z񕕑zu&^8t(\u%|ꪫfmm-QOspNbgD9,OO[/{nvH~!JygS"$ ĉcygo/'O^&h:mĻ/3׼_Hٳ}O'4>Z҃98OY&|ey`0822·-+0Lי KhNC)ʼn.޻j%GYc#1{.YBc4'0id{Oq4N'W=i=\娖kcǜNp1%p*)gSH r"F4-SZ4MV-ZJQe+3S)3gWPBr=|k~kd Ib G > j>9&=9;m, vw7͚2].}B W()0 |^/% KfF@-.rBSr#o}'NLHì]o @# 0&_B"ZYů;>IcMy\-x4iV/h.~`i j ptS]KCC|(i;tBv@ U.Ǒ4MG"ܸwf{"j\R&a\P\Z I=h_/~BYm00r}ғd.#P]M QKL?G%w9AKSXs^z={t'r*s:VV а(-=^ <2BctToq :qILjKw7??}u=:&4XQ֟=$Hf:͌ZN: qS=m#G,.o۷3dT+78:~.˷c-&#>NNtLSo&Tf0 Yi?)$R)RVGa~pRsm l$Y ߹X Ţl"m,NZB*{;ʴn0c_x.Kdr )uM/ #ka_gu{{3udkp}6gY>DiӜkIZѸkm`9Reta<7I\\ V𮓱(Lфڀmf!rLY؝e2o+Iޝiϥ@<樌0͌g, x7?]4y[vjg G)VFEPLН^u^^ IjD^ikC'ׯ[ I;U;B }|_)ϻNےÇ)Q:qu]|: xwu5ź]k83eg R#PS (*.8v*9_px wfjnps-oe@" T)?%&̑"@E{{VxH )TlIkFq~365M7;طC'qmd46e'3Є$`u B@' 9mǏ#}8aS3?u| ֔MbqAk֡=IK͂FP$sb( }@>v bo8]xX/@/xXY^5&QKrgܷ0גo$ttΦRC-oRo;V?eqqe%W25$i,HstѩS=5 $b0LI$_vm(ۺW̃5d"ZmCUkzdןeKOÚ?X3jIvmNa-aF՟}O&G䆑sDIENDB`caronc-apprise-dfec414/apprise/assets/themes/default/apprise-info-128x128.ico000066400000000000000000002040761526720371000270310ustar00rootroot00000000000000 (( !8KVdpwwpdVK8! GG  JJ =qq=,,D # *#0(6-90;1906-1)*##  D B7.WIq_%n+x/268:<===<:863x/n+q_%WI7.B R3+q_%49:<>>>>>>>>>>>>>>>>>>><:94r`%3+RN .'xe'<===>>>>>>>>>>>>>>>>>>>>>>>>>===<{g(1) N -%]N|06:=>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>=6iX"3+ ] OB~i(36778>>>>>>>???????????????????>>>>>>>>>>>;z0[M]* [L|03566788<>????????????????????????????>>>>>>>>><8jY# *e E:}/345566789;?????????????????????????????????>>>>>>>=:RE e 9/l)13445567889:>????????@@@@@@@@@@@@@@????????????>>>>>>>=4E: & p]#0223445677899:=@@@@@AAAAAAAABBAAAAAAAAAA@@@??????????>>>>>>>>>>;o]$.H{f&{/~0112334566779::;=@BBBCCCCCCCDCDCCCCDCCCCCBBBBAA@@@@???????>>>>>>}1 HG5,q*z.}0011234556689:;;==@FHCDDEEEEEEEFEFFFEEEEEDDCCCCBBAAA@@@??????>>>>>8C8G8UFu-z/|/~0012334567799;<=>«_ȎɐƋηmFFFG¥G¥G¥G¥G¥G¥G¥G¥G¥G¥G¥G¥GFFFFEEDDCCCBBBAA@@?????>>>>>=o^%8F n["w-y.{/|/~01223356788:<<=?ͥĹy̥ԨϞʲb¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥GFFFFEEDCCCBAAA@@?????>>>>=t- FEr^$v-w.z.{/}/~0122346678:;<#!oǠ֬ʼnŪS¥H¦I¥H¥H¥H¦I¥H¦I¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥GGFFFFDCCCBAA@@??????>>>>|1E,s_#u,v-y.z.|/}0012245678::<=?¬fͥWQB<9-v֬ӥѻvŪS¦J¦J¦K¦JæJæJ¦J¦J¦J¦J¦I¦I¦I¥H¥H¥H¥H¥H¥G¥GGFFEDDCCAAA@@?????>>>>4% ,  ze%t,v,w-y.{/|/~012345688:;<>?IŔFB5̘֭ʰ`æKæKæKæKæKæKæKæKæKæKæKæKæJæJ¦J¦I¦I¥H¥H¥H¥H¥G¥GFFDCCCAAA@@?????>>>7/( |g&r+u,v-x-y.|/}/~022346789;<>?@įmЩ#!׮˗ūTçLçLçLçLçLçLçLæKæKæKæKæKæKæKæK¦J¦I¦I¦I¥H¥H¥H¥HFFFDCCCAA@@?????>>>7$ r^#q+t+u,v-x-y.|/}/1233677:;<=?@Iˠxq\ ׮θnèMèMèMèMèMçMèMçMçLçLçLæKæKæKæKæKæKæJæJ¦I¥H¥H¥H¥HGFFEDCCBA@@????>>>>4[ dSp*r+t+u,w-y.{.|/~1224568::<>>?@ʸ~ ~waׯƌéPèNèNèNèNèNèNèNèNèMèNçMçMçLçLæKæKæKæKæK¦J¦I¥H¥H¥H¥H¥GFEECCBAA@????>>>>{0 Z#]Lo*q*s+t,v-x-y.|/}01235689:;=>?@ZЪTPAidQׯ˖ĪRĩNèNèNĩOĩNèNèNèNèNèNèNèNèNèNèMèMçKæKæKæKæKæJ¦I¦I¥H¥H¥H¥GFEDCCBAA@????>>>q,#RBn)p*q*s+t,w-x-{/|/~0144688:<<=??BƘ jذ̗ƬVŪQŪQŪQŪQŪQĩPĩPĩPĩOĩNèNèNèNèNèNèNèNèLçLçLæKæKæKæJ¦I¦I¥H¥H¥GGEDCCBA@@????>>=l[$e2)j(o)p*r+s+v,w-y.{/}0~134578:;<=>@A®oȢJF9̧ذǍūTŪRŪRŪRŪRŪRŪRŪRŪRŪRŪQĩQĩOèNèNèNèNèNèNèNçLæKçLæKæKæJ¦J¥H¥H¥H¥GFFDCCBA@????>>>?@LřywذذϹqŪRŪRŪSŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪQĩQĩOèOèNèNèNèNèMçMçLæKæKæK¦J¦I¥H¥H¥HGFECCBA@@???>>>7]Lk(n)o*q*s+t,w-x.z/|0~235689:;<>?@AİuϪEA5ٱٱ͚ǭWƬTƫTƫTƫTƫTƫTƫTƫSƫSŪRƫSŪRŪRŪRŪRŪRŪQŪQĩOèNèNèNèNèMèMçKæKæKæJ¦J¦I¥H¥H¥GFEDCBA@@????>>x/A7-j(l(n)p*q*s+v-w-y.{/}1~245799:<=>?AMͧfaOɾٲدйrƬVƬVƬUƬVƬUƬUƬUƬUƬUƬUƬUƫSƫSƫSŪRŪRŪRŪRŪRŪRĩPĩOèNèNèNèNèNçKæKæKæK¦I¦I¥H¥H¥GFEDCBA@@???>>>eU!= i'k(m(n)p*r+t,v-x.y.{1}245689:<=>>@Bʻ oiV֯ٲ̘ǬVǬWǬWǬWǬWǬWǬWǬWǬVƬVƬUƬUƬUƬUƬTƫTƫTŪRŪRŪRŪRŪRŪQĩPèNèNèNèNèMçMæKæKæK¦I¦I¥H¥HHFECCAA@????>><'! q`Ni'k(m)n)q*r+u,v-x.z/|1~346889;<=>AAYɦEA6!Ƽٳذʰ`ǬWǬWǬWǬWǬWǬWǬWǬWǬWǬWǬWǬWǬWǬVƬVƬUƬUƬUƫTŪSŪRŪRŪRŪRĩQĩOèNèNèNèNèMæKæKæK¦I¦I¥H¥HHFECCAA@????>>p,E2)}g&j'l(m)p)q*s,u,v-y/z0=S]aa]N<==@ABñxΪ}zt_ڳڳӿ~ǭXǮYȮYȮYȮYȮYȮYȮYȮYǬWǭXǭXǭXǬWǬWǬWǬWǬVǬVƬUƬUƪSƫSŪRŪRŪRŪRĩPèNèNèNèNèLæKæKæKæK¦H¥H¥H¥GFECCAA@???>>=>4h cRi'j'l(n)p)q*t,u-x._öʾʾʿáĠ̾Q?AABWϫЬѬnhVٳڴѡɰ^ȮYȮYȮYȮYȮYȮYȮYȮYȮYȮYȮYȮYȮYǭXǭXǬWǬWǬWǬWǬWƬUƬUƫTƫTŪSŪRŪRŪRŪQèNèNèNèNèMçLæKæKæJ¦I¥H¥H¥GFDCCA@@???>>}101(~h&i'k(l(n)p*r+v/Vɽ{oiWFC70-%*(!41)UPCɧ}BABCFq̦ЬѭGC7 ڴڳѼvȮYȮYȮYȮYȮZȮYȮYȮZȮYȮYȮYȮYȮYȮYȮYȮYȮYǭXǭXǬWǬWǬWǬVƬUƫTƫTƫSŪRŪRŪRŪQèNèNèNèNçMçLæKæK¦I¦I¥H¥HFFDCBA@????>>B8PgU~h&i'k(m(o)p*>}ǼpjX.,$ ʧƷCAR`UHR̻Χӯԯ{@<2RM@ڴڴ͚ɯ]ȯ[ȯ[ȯ\ȯ\ȯ\ȯ\ȯ\ȯ[ȯ[ȯ[ȯ[Ȯ[ȮZȮZȮYȮYȮYȮYȮYǭXǬWǬWǬWǬWƬWƬUƫTƫSŪRŪRŪRŪQèOèNèNèNçMçLæKæK¦I¦I¥H¥HFEDCA@@???>>8'-%}g&h'j'k(n(o)Lµ(%xdɧʨj@^ǞͨƜƴ|LLb԰հȦu ڵٳйqɰ\ɰ]ɰ]ɰ^ɰ]ɰ^ɰ^ɰ^ɰ]ɰ]ɰ]ɰ]ɰ]ɯ\ɯ[ȯZȯZȮYȮYȮYȮYȮYǭXǭXǬWǬWǬWƬUƬUƫTŪSŪRŪRŪRĩPèNèNèNèLæKæKæK¦I¥H¥H¥GFECCA@@???>>XK9o[!}g&h'j'l(n)CŹ|&$ȧʧ˽HBȡrnhVʨЬɟ¬jORĮhϤձײϫmhV }vbٳ۵˖ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ]ɯ\ȯ\ȯ[ȯYȮYȮYȮYȮYǭXǬWǬWǬWƬVƬUƫTƫSŪRŪRŪRèOèNèNèNçMæKæKæK¦I¥H¥H¥GFDCBA@???>>7+# |f%~g&i'k'm(t2ɧȥhAz2/'pţү‘ZQSѿկײٴӯtâ۶ڳɱ`ɰ^ɰ^ɰ^ɰ^ɰ^ʱ_ʱ_ɰ_ʱ_ɰ_ʱ_ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ^ɰ]ɯ\ȯ[Ȯ[ȮYȮYȮYȮYǭXǭXǬWǬWƬVƬUƫTŪSŪRŪRŪRèPèNèNèMçLæKæKæJ¥H¥H¥HFFCCB@????>>s- v`#}f&~g&j'k(s1÷gaQȧɧMAƶ >;1ձΣϽ©XīZʵk…Ѣӧnjʲaʲaʲaʲaʲaʲaʲaʲaʲaʲaʲaʲaʲaʲaʲaʲaʲaʲaʱ`ʱ_ʱ_ɰ^ɰ^ɰ^ɰ]ɰ]ȯ[ȯZȮYȮYǭXǭXǬWǬWǬVƬUƫTƫRŪRŪRŪQĩNèNèNèMçKæKæJ¦I¥H¥HGFCCAA@???>9)# .H;zd$}f&h&j'k(b _ZKȧȧt@]ʧhbRztaϬײҧ̶qƭ\ȯ^˳d˳dʲbʲaʲaʲaʲaʲa˲b˲b˲b˲b˲b˲b˲b˲bʲaʲaʲaʲaʲaʲaʲaʱ`ʱ`ʱ^ɰ^ɰ^ɰ^ɰ\ȯ[ȯZȮYȮYȮYǭXǬWǬWƬUƬUƫTƫRŪRŪRĩQĩNèNèNçMçKæKæJ¦I¥HGFECBA@@???>YK^3 aP{e%}g&h&j'l(ĹrlYĺȧDFȹ(& άٵɓ˴gʲbʲaʲaʲaʲaʲb˲b˲b˲c˳c˳c˳c˳c˳c˳c˳c˲b˲b˲b˲b˲bʲaʲaʲaʲaʱ`ɰ^ɰ^ɰ^ɰ^ɯ]ȯ[ȯ[ȮYȮYȮYǭXǬWǬWƬUƬUƫSŪRŪRŪRĩPèNèNèNçLæKæK¦I¥H¥HFFDCAA@????~1 e! u_#|e%~g&i'k'~CǽA=3lǧȧf@d̪20(HE9ڶٲʒѼw̵g˲b˲c˳c˳d˳d˳d̴e̴e̴e̴e̴e̴e˳d˳d˳e˳d˲c˲c˲b˲bʲaʲaʲaʲaʱ`ɰ^ɰ^ɰ^ɰ^ɯ\ȮYȮYȮYǭXǭXǬWǬWƬUƬUƫSŪRŪRŪQèNèNèNèMçLæKæJ¦I¥H¥HFECCA@???>>  <1zd%|f%h&i'l(b*(!;7.ǦǧǹDDƢ}h >;1ܷڵӦɑҽx̴e̴e̴e̴e̴e̴e̴e̴e̴e̴e̴e̴e̴e̴e̴e̴e˳d˳c˲b˲bʲaʲaʲaʲ`ɰ_ɰ^ɰ^ɰ^ȯ\ȯZȮYȮYǭXǭXǬWǬWƬUƫTŪSŪRŪRĩPèNèNèNçLæKæK¦I¥H¥H¥GFCCBA????>`Q (]Lzd%}f%h&j'l(vǦƤ`@³¸,*##!rҰڶ۵د͘Կ~̴g̴g̴g̴g̴g̴g̴g̴g̴g̴e̴e̴e̴e̴e̴e˳d˳c˲cʲaʲaʲaʲaʱ_ɰ_ѼwćĈҽyȮYȮYǭXǭXǬWǬVƬUƫTŪRŪRŪQĩOèNèNçMçLæKæK¥I¥H¥HFECBA@???>6w# zd%{d%}f&h&j'l(|a\MäǦĶ>Xǥ|ubSOB}¹̬ݺݺ̘֫ćҼwϸnηmηlηlͶj͵i͵i͵i͵h͵hͶi̵h̵i͵jϹp‚˔ӧ۶ͪģڵ׮ҽyȮYǭXǬWǬWƬVƬUƫSŪRŪRĩPèNèNèNçLæKæK¦I¥H¥H¥GECCA@???>>n)! zd%{e%~g&h&j'l)|ǦƤH@Ŷ¸<:0b]NkƼճݺݺ۵֭ԧҤѢϟРРҢӥ׬ٲܹڶohbRA=3%$1/'ojXΫڴ~ǭXǭXǬWǬWƬUƫTŪSŪRŪRĩOèNèNçLçLæK¦J¥H¥H¥GFDCBA@???>SFL?zd%|e%g&i&k(m)x'%keUťǦj=`ȧTPB ! 0.&GD9a]Nto]~jrxxwslxr`d_OPL?20($" ]YIٳ֬ʱ_ȮYǬWǬWǬVƬUƫSŪRŪRŪPèNèNèMçLæKæJ¦I¥H¥HFDCBA@???>t-lX!zd%|e%h&i&k(m)iƻ<8/ãƦƹBCɻ***ڴӾzȮYǭXǬWǬWƬUƫTŪRŪRŪRĩOèNèNèMçLæK¦I¦I¥HFEDCA@@??>7Qzd%zd%~f%h&i'l(m*NɿfaQsťƦ^=gɩ&$333lllJJJ ڴʼnȮYǭXǬWǬWƬUƬUŪSŪRŪRĩPèNèNèMçLæKæJ¦I¥HGFDCB@????: Q zd%zd%~f%h&j(l(n*q.Ⱦ C@5Ĥť>Eǥys`ڵʼnȮYȮYǭXǬWǬWƬUƫTŪRŪRŪQèNèNèNçLæKæK¦I¥H¥HFECBA@???<>47-zd%zd%~g%h&j(l(o*p,rUQD ĤģU<³%#_[K۶ڵҽyȮYȮYǭXǭXǬWƬVƫTŪSŪRŪRĩOèNèNçLæKæK¦J¥H¥HFECBA@???=ZLL>zd%|d%~g&h&k(l(o*p,{;mgV¢ĥ:[árlZ;;;***GGG444&&&Ƥ۶թʲbȯ[ȮYȮYǭXǬWǬWƫUƫSŪRŪRĩPèNèNèMæKæKæJ¦I¥HFFDCAA@??>r`%`Nzd%|d%~g&h&k(l)o+q,t0o0-&Ĥâ==Ķ jjjqqq ``` |g۷۶ɯ\ȯZȮYȮYǭXǬWǬWƬUƫTŪRŪRĩQèNèNèNçLæKæJ¦I¥H¥GFDCAA@??>m+kX zd%|e%g&h&k(m)o+q,s.~@ö¢ãĤc:_ǦGD97778880.&ܷ۷ѣ˳eɰ]ȯ[ȮYȮYǭXǬWǬWƬVƫTŪRŪRŪRèNèNèNçLæKæK¦I¥H¥GFECAA@???v. p\"zd%|e%g&j'k(m*o+q,s.u0Pãã<=ɼx!!! ,,,ܷ۶Կ}ɰ^ɰ^ɰ[ȯZȮYȮYǭXǬWƬVƬUƫSŪRŪRĩOèNèNçMæKæK¦J¥H¥HFECBA@???19 r]"{d%|e%h&j'l(m*o+r-s.u1v2CrjA9lǧlllAAA+++ 555a]NֳܷҢʱ`ɰ^ɰ^ɯ\ȯ[ȮYȮYǭXǬWƬVƬUƫSŪRŪRĩOèNèNçMæKæKæJ¥H¥HFECBA@???4Q+s^"zd%}e%h&j(l(m*o,r-t.u0x2y4z5|589ģp yyy ܸܷͷlʱ`ɰ^ɰ^ɰ]ȯ[ȮYȮYǭXǬWƬVƬUƫTŪRŪRĩPèNèNçNæKæKæJ¥H¥HFECBA@???6! d9s^"{d%~g%h&j(l(n*q,r.t/u1x2y4{5|589ŸƦyD@6TTTkfUݹܸnjʲaʲaɰ_ɰ^ɰ]ȯ[ȮYȮYȮYǬWǬWƬUƫTŪRŪRŪQèNèNèMçKæKæJ¥H¥H¥GFDCA@???7% rEt_#{d%~g&h&j(l(o*q,r.t.u1x2y4{5}789gǧȨʿu```Юݹժ̴gʲaʲaɰ_ɰ^ɰ^ɯ\ȮZȮYȮYǬWǬWƬUƫTŪRŪRŪQèNèNèMçLæKæJ¦I¥H¥GFDCA@???8)" zJ t_#|d%~g&h&k(l(n*q,s.t0v1x2y4{5}79:;PȻɩʩȨhcS@@@RRRwݹݹ˲bʲaʲaʱ_ɰ^ɰ^ɯ\ȮZȮYȮYǭY˖˖~ūTŪQèOèNèMçLæKæK¥I¥H¥GFDCBA???:)# vHt_#|e%~g&i'k(m)o*q,s.t/v1x2z4{5}79::>?lƢ˩̬A>3 iii85-ݺݹң̵h˲bʲaʲaʱ_ɰ^ɰ^ɰ\ȮZȮY̴fթޟװԧʲcĩOèNèMçLæKæJ¦I¥H¥HFDCAA???8& k>s^"|e%g&i&k(m)o*r,s.u0v1y2z4{5}79:;>?@Kǣͬάv:7. !!!111AAA888ݺܷ~˳d˲bʲaʲaʱ`ɰ^ɰ^ɰ\ȮZȮYң42) $"vذժȯ[èNèMçLæKæJ¦H¥H¥HFDCBA???7# Y1 s]"{e%g&i&k(m)o*r,s.t/v1y3z4|5}79:;>@@CE[ƶάϭ¢sEEEmhWڷݺϟ̴e˳d˲bʲaʲaʱ`ɰ^ɰ^ɰ\ȮZкqױHE8ذ͛éPèNçLæKæK¦I¥H¥GFDCAA???5 F$q]"}e%h&i&k(m)o+r,s.u0w2y3z4|5}79:;>@@CDGJ`ƝЮѯƦTPDuuueee ¹ݺݺͶk̴e˳dƋ֫دңѼvɰ^ɰ\ȮZͩ75+ԭ׮èNçLæKæK¦I¥H¥HFDCAA@??3$mY!}e%h&j(l(m)p+r,t.u0w2y3{4|5~79:;?@ACDGHIKĴ}ͨҰӱoCCC///iiito^޻ݺŊ̴eϸnԨͫЭ۶̘ɰ\ȮZ~ڴc^MSN@دҤɱ_çLæKæK¦I¥H¥HFDCBA???z0 fS}f%h&i'l(m)p+q,t.u/w2y3{4|5~79:;>@ACDGHJKL]ξѮԲ96- "!ӳݺժ̵i̴fɐϭ>;1LI<ӯ۶ʼnȮZ̴eڴ̧/-%ׯƒçMæKæJ¦I¥H¥GFECAA???r-TE}f&h&j'l(n)p+r-t.v0w2y3{5|6~69:;=@ACDGHJLMORðsϩճťJF;JJJ___޻ܸƒ̴fͶi׮|hJG;۶دϸnȮYƌڳʿD@4Ѫ֫ƬVæKæJ¦I¥HGFDCAA???zg)?4|f&h&j'l(n)p+s-t/u0w2z3{5}6~69:;=@ABEGHJLLOQTaΧִִNK? IF<޼ݻң̴h̴fζk۶lgVnڵ̘ȯ[ɰ^Ϟٲq ׮æKæJ¥H¥HGFDBA@??>dT!(! }f&i&j'l(n)o+r-t.v/w2z3{5}6~79:;=@ACEGHJLMNQTUWʞ״ص]YJlll---@@@III æ޻۶Կ}̴g̴eͶjٳ0.&ɧڴͶjǭXͶl֬ѫ-+#oiUԫիæKæJ¥H¥H¥GFDCAA??=J>f }f&i&j'm)n)p+s-t/v/x2y3{4}679;;=@ACDGIJKMNQTUVYœ׵ٶe`Q---IIIup_ܺ޻Μ͵h̴f̴e̵gΛܸmzڴ͙ǭXǬWŊذl#!̥׮ηmæJ¥H¥HGECBA@??<,%f2xb%h&j'm)n)p+r-u/v0x1y3|4}678;;=@ACDGIIKMNQTUVX\ĐضԱTPCqqqOOO%#æ޼۵ηl͵h̴f̴e̴eѽwٲ԰C?5\XHԯڳȯ]ǬWɰ_׭!֭ɒ¦I¥H¥HFECBA@??: 2[Kh'k'm)o)p*r-u.v0x1y3|4}679;;=?ABDGIJKMNPTUWYZ[Ȗڷڷ0.&uuuyg޼ݻƒ͵h̴g̴e̴e˳d˲cȎ۶y$#ΪڳѻvǬWƬVɒٱFB6}v`֭ҥ¦I¥H¥HFECBA@??48.h'k'l(o)p*s-t.w0x1y3|4~679:<p\"k'l(o*p*s,t.w0x1z3{4~678:<=>BBCFHJKLNORTVWZ\ë]ĭ^ʴlժܹv444 \XK޻ݻϟ͵i̴g̴f̴e̴e˲c˲bʲaʲaƋ̩63*ٳ̘ǬVƫTŪRΛ ֭իлt¥HGEDBA@??=FM@k'm(o*q+s,u.w/x1z3|4~578:;=>ABCFGIKLNOPSVWX[ë]ĭ^Ʈ_ϻw۶۷SOB!!!WWW ɪݺܷѼv̴h̴f̴e̴e˳c˲bʲaʲaʱ`ŊƤ/-%żٳ̘ƬUƫUŪRňǢ ϧ֫ҽz¥GFECBA@@?|i) ,# k(m(n)q*r,u.v/y1z2|4}578:<=>@CCDGIKLMOPSUWX[ë]ŭ^Ư_ɱbƋܹɨ{h۸ݺ̗͵h̴f̴e̴e̴e˲cʲaʲaʲaʱ_ΝǤٳʔƬUƫSŪRЩ Ȣ֫Ӿ{GFDCBA@??8/ sq]"m(n)q*r+u-v/y1z2|4~568:;=>>CDDGHKLMOPRTWXYë\ŭ^Ư_Ȱ`˲bϝݹ&&&+)#ǧݺٲ̴h̴f̴e̴e̴e˲cʲaʲaʲaʱ`˳eرw)' ͩٳćƫTŪRŪR~ˤ ˤիӾ{GFDCAA@?: >YJm(o)q+s+u-w/y0z2|4~5689;=>>BDDFHJLMNPQSWXYª[Ŭ]ǯ_ɱ`˲b͵j֬ݹ`[L***HHHvvvqݺݺ~̴f̴e̴e˳d˲c˲bʲaʲaʱ`ɰ_Ȑֱ<9/c^MԯٲϹqƫSŪRŪRĆĺ ֬իҾzFECBA@??r`&>3)i'o)p*s,t,w/x0{2|3~5689:<>??DEEHIKMNOQRUXYêZŬ[Ǯ_ɱ`ʲaʲaܷ˪!!!SSS.,%ݺݺϟ͵h̴e̴e˳e˲c˲bʲaʲaʱ`ʱ_ڵnٳٲƫTƫSŪRŪR̗  ֬իѻuFDCB@@?>;1xc%o)p*s+t,w/x0{2|3~5679:<>?@BEEGIKMNOQRTVYê[Ŭ[Ǯ]ɱ_ʲaʲaʲbϝ۸lݺڴҽx̴e̴e˳c˳d˲cʲbʲbʲb˳dƌ۶64*ȥٲȏƫTŪRŪRŪQժxb63)֬թηkECCB@??3:K>o)q*s,u,v.y0{1|3~4679:;iY#: n)q*s,u,v-y/{1}3~3678:;=?@@CFFGJKNOQQSTWêYŬ\Ǯ]ȯ]ʱ_ʱ`ʲaʲaɑܷ}wdɨݹڴθo˳dŊذǥάģe`O$"[VGٳٲȏūUŪRŪRĩQŊȽ(&֬ҥ¦JDCAA??< YO@q*r+u,v-x/{1}2~4578:;=>@ABFGGIKLOPRRTUéWĬYǮ]ɰ^ɰ^ɰ^ʱ`ʲaʲb۵ֲp۸ܹƋ˲bϺqر| <9/ٳٲժ̵hŪRŪRŪRƬUԧuƟ֬˖ECBA@??m+Y o*r+u,w-x.{1}144789;<>?AADGGHKLNPQSSUéVĬYǭ[ɰ]ɰ^ɰ^ɰ^ʱ_ʲaĆܷzt`52*ɩܸ֭˲b˲bʒϭ(& D@5ӮٲذŪRŪRŪRĩPϦD@4YSCЧ֬ϹrDBBA@?? ^N@s+t+w-x.{0|124689;<>>ABBFHHILMOQRSUéVūWƭYɯ[ɰ]ɰ^ɰ^ɰ^ɰ^˳dدش yܸܸѼvʲaʲaΛͪ pjWЫٲٲǎŪSŪRŪRŪQɰ`Ҥ{x֬իçKCBAA@?ta&_~g't,v,y.z/|1~24589:<=>@BBCGHIJMNPRSUêVūWƬXȮYȯ[ɯ]ɰ^ɰ^ɰ^ɰ^ʼn۷wq^>;1ܷܷ̗ʲbʱ`ʱ`͙ԱPL?]XIزٳٲƒūUŪRŪRŪRèO˕˥2/&ȡ֬ćDCBA@?;jQCs+v,x.z/}1~245799<=>?ABCEHIJLNOQST©UĪVǭXȮYȮYȯZȯ\ɰ]ɰ^ɰ^ϸp׮ǥâܷׯкrʱ`ʱ_ʱ_ڴǥ_[K =:0lȤְٳٲ׭кsŪSŪRŪRŪRèOǍׯ52)h֬իƬUCBA@@?]Oj k(v,x.z/|0~235789:=>>ACCDFIJKMNPRTèUūWƬWȮYȮYȮYȮZȯ[ɯ\ɰ]ɰ^ΛԱSOBsm[۶۶ʒɰ^ɰ^ɰ^ɰ^ɰ^ԧ۶ڵڵڴհڴڴڳڳٳٲ׮ʓȰ]ŪSŪRŪRŪRĩPǎխa[J0-$֬֬ćECAA@?4u9.v,x-z/|013468::;>>@ACDEGJKLNOQSèUŪVƬWǭXȮYȮYȮYȮYȯ[ȯ[ɰ\~ڳz$#ά۶׭̴gɰ^ɰ^ɰ^ɰ^ɰ]̴e˖֪ڳڴڴڴڳٳժϟƋ˴eƫTŪSŪRŪRŪRȯ]ɒԬjeR ֬ӥɯ\CBA@?>REudRx-z/|0~034679:;=??ABDEFHKLMNPR©SĪVǬWǬWǭXǭXȮYȮYȮYȮYȮZɰ]׮¸!t۶۶ɰ]ɰ]ɯ]ȯ\ȯ\ȯ[ȮZȮYͶiлsҽyҽzҽzѻwйr͵jɯ]ƬUƫTŪSŪRŪRŪRѽyѡ̦HD7w֬իƒCCAA@?y/4 o*z.|/~114468:;<=?@BDEFGILMNOPéSĪTǬWǬWǬWǬWǭXǭXȮYȮYȮYȮYʒٳFB7:7.Ϋڵѡɯ\ɯ\ȯ[ȯ[ȯZȮYȮYȮYȮYȮYȮYǭXǬWǬWǬWǬVƬUƬUƫTŪSŪRƬVӾ|Ҥ֭xq[өիРçKCAA@?>43+x-{.~0134688;<=@@ACDFGHIMNOPèRĪSƬUǬUǬWǬWǬWǬWǭXǭXȮYȮYϹpڴxr^|ڵڴ͵iȯZȮZȮYȮYȮYȮYȮYȮYǭXǭXȮ\Ӿ}ƍŊҽyͶkʲb˲cθnΛذ̦KG:ZUDѨլիȮZCBA@@?=4 \L{/~01255699<=>@ABDDGHHJMOO§PĪRƫTƬTƬVǬVǬWǬWǬWǭXǭXǭXȮYٲ RM@ڴڴǍȮZȮYȮYȮYȮYȮYǭXǭXǭXǭXϹqժǤɾϪٱٰ֮ʤ~zt^?;0e_LԪ֬ԩͶjCCAA@?o^% K {f'}/1235689:==?ABCDFHIIKMP§PĩQŪRŪSƫTƫTƬUƬVǬVǬWǬWǬWǬWÅڳFC7 mhUͨڳժ̴gǭXǭXǭXǭXǭXǬWǬWǬWǬWȮ\ժ&$$"0-%74*96,52),*"  pԪ֬ԩθnCCBA??}1 K y.0233579:<=>@@CDEFIIJKM¨PĩQŪRŪRŪRƫSƫTƫTƬUƬUǬVǬWǬWɯ]ӧٳԯѬҭװٳٳćǬWǬWǬWǬWǬWǬWǬWǬWǬWǬVӿ}Ԯ0.%ի֬ժͶkCCBA@?<  }0123577:;>>?ABDDEGJJKLNèPŪRŪRŪRŪRŪRƫTƫTƬUƬUƬUǬVǬV˳eРذٲٲرׯĈǬWǬWǬWǬWǬWǬWǬWǬVƬVƬUƬUnjù x`֬֬֬Ҥɰ`CCBA@?>4+"8.}/234679;<>?@ABDEFIJKLM§MĩOĩQŪRŪRŪRŪRŪRŪSƫTƫTƬTƬUƬUƬUѻuňŊʱaǬVǬVǬVƬVǬVƬUƬUƬUƬUƬUƫTƫSňׯ*(! @<0ybʢ֬֬թĈĨOCCBAA@=G<"?G;124568:;=>@ABCDFGHJKM§MèNèNèOĩPŪRŪRŪRŪRŪRŪRŪRŪSŪSƫTƫTƫTƫTƫTƫTƫTƫTƫTƫTƫTƫTƫTƫSŪSŪSŪRŪRηmذRM?'%UPAlʣ֬֬֬ɐʱbFDCCA@@>TG?aNA234669:<=?AABEEGHHJKèMèNèNèNèNèOĩPŪQŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪSŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRƬVΚذӫЩʤƼͦШҪլ֬֬֬ʔȯ]¥IFDCCA@@?cT!aL?34568::=>?@BCDFHII¦KçLèMèNèNèNèNèNèNĩOĩPŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪRŪQĩPĩPǮ[̘֫׭ׯׯ׮׮׮֭֭֭ժԧѣƒǭYFFFCCBAA@>kZ#D915679:;?ACCEGG¥H¦I¦JæJæKæKæKæKæKçLçLçLçLèMèNèMèNèNèNèNèNèNèNèNèNèNèMèMçLçMçLçLæKæKæKæKæKæK¦I¦I¦I¥H¥H¥HGFFECCBAA@?2 [L59:;;=??BCDFG¥H¥H¥H¦I¦J¦JæJæKæKæKæKçLçLçLçLçLçLçKçLçLèMèMçLçLçLçKçLçLçLæKæKæKæKæKæKæJ¦H¦I¦I¥H¥H¥GGFFEDCCAAA@?@BCDFF¥H¥H¥H¥H¥H¦I¦I¦I¦J¦JæJæKæKæKæKæKæKæKæKæKæKæKæKæKæKæKæKæKæJæJ¦J¦J¦I¦I¥H¥H¥H¥H¥GGFFEDCCBAA@?44,U1 \M:;;=>?AACDFFFG¥H¥H¥H¥H¥H¥H¦I¦I¦I¦J¦JæJ¦JæJæJæKæKæJæKæJæJ¦J¦I¦J¦I¦I¦I¦I¥H¥H¥H¥H¥HGFFFEDCCCAAA@?dT!1'" {0:<>>?@BCDEFFFF¥H¥H¥H¥H¥H¥H¥H¥H¦I¦I¦I¦I¦I¦I¦I¦I¦I¦I¦I¦I¦I¦I¥H¥H¥H¥H¥H¥H¥HGFFFEDCCCBAA@>3(" |LAz0=>?@@BCCDDEEF¥GG¥G¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥H¥G¥G¥GFFFEDDCCCBAA@@3SF|5H<1=??AABCCCCDEEFFFFGGGG¥G¥G¥GGG¥GGGGGGFFFEEEDDCCCBBAA@@3K?5c8/2?@@@AAACCCCDDDEEFFFFFFFFFFFFFEEEDDCCCCBBAAA@@4=3c0(v.<>AAAABBCCCCCCCDDDDDDDDDCDDCCCCCCBAAAAA>@@@@@@A@A@@@AA@@@>3n\$?5 -0(K?dT!wd'q,|1464|1q,wd'dT!L@0(VVSS 88 ,nn,?????????????caronc-apprise-dfec414/apprise/assets/themes/default/apprise-info-128x128.png000066400000000000000000000404371526720371000270420ustar00rootroot00000000000000PNG  IHDR>a pHYs   IDATxw|ߙ͒,ے-Wm1565Bz˅vp@@H$'@6:EdɲVZmݝdc/Ei;3}y?:;hxxH1 . xx>7op:0ߋہZ f3}xF 88 xv/+3\G qglzڸOȌ"޳:|U+.(,DQ\nda!}D{;l'rP޳F_ 6 _dK7Kq(>B@wE8<_@b}E~Rc$0J`Nwa %VQۅP"M|1|R) r &FВIF&ܼ3 |ݰ -XjS;T_.M3]A(:ӌ B(+Q :f7PXftؖ!M㥤ϿOE9t@rD~EL;SfW3D>۳߳62g&x@i&6U`g){m l}=JǣE(? 'K?>E6!B:#e>?}ٽ@ڏ3!Ʃ! clS\pBD/2>?IO +;5.Љ."L?/M'x!RZUA>@3 $IhH) b$8adIi n0n}5TMwC *N|! o"z{f6ڈ,ĶJCvar7R"),gMS:2~ۿV)).2-(聱G/8 2ܘwٟ6.0c#" KߐB1 nP2fODu>:260 vcT~P(_qўN"qaKm0{N |־r:jϼϟ5L.PTTE(aUA¤"U 7w5!e/^7nEA٫iR4FIIz#1}6Mibc{nڟ-܀ų\sP{3zNW  m*Fɺbn]GLt8GWW dHHIdJoh=f [RX{۹ {E?9?\j]q00.@>z hF\6đq *CK&I%D" vݾރ"5 EQRC.E*T̯(`4N4ա(Μr1-ڀd"לATլ_*(f5 $bP ~<&LBÐ4D-𳶾{7՗:W͚XpjϞǔi hOx͝L&GKhOi~ODx(3o,]tu}5u ~~ Bd EAUIt0oEA]l#K78h"e#)+kJSABEZe')\L` r{#ɔ:H%&^x~>Xf =;35Ә>Ρ(:c D%)`S,(XSWNϝ9NJ ,K-%87.<{qn7ťqΧ?뛻?0A'Ra`[jX|8;nζg.u ( xiӴ\7tO#$M}#\DT/-{3DS(=q LU9vg^Iڴ-zXr)TA1HOAFۛtw/GV`3>|)חq0AlȊv Bb)y?yOäRI{{8x< .WFC}cq88e `4"҈4±$]#QG3V[Ig˼+D#9Ao3{rPV`w)(4?_Ŋ81R1%V'tipO\S?)Sfpz}f$i/ucO} @?6-Eq /U5tkѻIxhgڬ4̛OЭM&G6x>7~~/~~E^7! Iݵ7L̵8ǭC1yLP:ZNZ¥PH'[Bi#I qR20=8[nCo 5$D@o]s9\sfp3~'ﻇ>T "^9(Z&"϶oxK}-[sOvnc`VIb LjZr1&ީ(2¼Ď5gz} Vlb97xj@ >3v` ]짷Sj:]̌OZ~[/>7ioN^p1.UA#cW^HPhzwyflmS<1CiU%啸Ah!78Je: Gll sg -CG74m 5fb.+O%4cv֐C12G`$@Kd! 3("gkB?zTSR>K">Ÿd칔lUPcvl)z*)L&5h.LO'}IX{~q=S20[6}޶D<#w0o) y\+#v->" ˕(j~a\OgyeT3p{9`"o*3xX `8Q}J;3Ex)TsAW3̚!.iIYu~яY\U"9q?f`^yp,ɮV=_<"rKܵUpg/ej,knzn;RSV`6DJcPƅK>{n n܊IJ,#P3}\:N89Syrݍ ^EP;k/"e=&q$ SWH 0RM|=۶4~3lߊ0 6K/̛up=Վ~tN||ʟ=w6ӂB&Hhƅsz[_4(B63BܥxK+̧ zNZT'7: h'sfӪt4ݴ wpD碋.q/FƳSBM[3$5ɖa^S1皻7o!%!+H9p6L`{FE\jN:zBg 37̳?BpYfz3JIFIӳ)Az2)E t[~sg|{͛7#￟/am<{- PZ$\2I+y`0k/ūOA|Y~hکUOܪșpLQ)[ aL2^!SiSTlIW9]>ivzi^cK30yH\&kJ(ۆ'=VzkضmO<_=Yp+ٳg;WuwɆIaPTs=D<ChRȦḘ)_vYyi>rYpl -ssKu]3A0cf)@N߼֫.yB/_>qHTU;Jgs,Rw"@zc^(s/Xñ#X%CFD NVIUG<4=y zCbŗRGW~!%"]V6,F1݊a7[B}Rē}3/d JWs@ْ?}D u3h ,T&g@zs͒rH 6.AWX;盧)7o^^)޲?Szx `ny!nE޼SgH,sB6!&;},1gG}04XM AJ!+k˙Q$qwoOӗ.]o˖-\veyϽk@*?U2HϾY%!(CuYy\.H]*~ڛ8f /=0 I!se2e\BqZX) `rDW ɪ  A]7 ?/X ﾝ;w#qƼow׶'QTzGU } xGI * Q`qrNmLʫkGrq'Mpj=<UX ^i.)-ޞէ6V\ԑUOkJ}i+xhaޓO>q{*]/|5אL:/ 8묳[5Κ?, =+rm\85hJB$bQ׹Q3Ҡy`4gSrPAEzZ^;8[VePZ~;/B2grQ,9Rd$KT| ῾e7~'p nk#}W_}z( +z\:h]wUEaC$ec.Ù|’Rڇ# xTe%xT{m@A!K?UU3h7ٕ⯬BT8iLDO:V/ F^Z纯>(2?xj$ᮻbxx˗я~q }ן{ȹ$LQZQsΪSqG>A\F|7rΙX-!%a{ﰳAN7 {K,=X{i_]{6n9BkXS_߭oN~/_mkAAߟ?8/q+Q!2 )M6ᴋ.a隓s֍z#1Bs _4w|3wDsDq !Ԙw9`JilZ\- //BUy+?)2:=ؼZ[[ْ:/ǯZ*/D|`_ vW z:sŏ-i=_x}~چ"l1DyuHhڒyYh &RdX'W&ʁT_#5vSRfsLo-5M8Tp,NRdƲegD"-;شi?^n  9_淋i7KQ-] 4Υq.^jF4IYRQW )X|BL3vHRح٭:kQea3d/9qTY8b!^x1r~`d`dd}9o;G2G0[nqф IDAT#)C|Ϊaɣ;M爵(P,/i|\ߠ\Eb9Ye%klKŝVabpL=Nuo>53r1 4V/go37}Q._DGFFhjjX%%%׳tR/_g>q_<L)eDDs$p"_20a_hxJcc[^0 G,+Kg2Ǥe.t鱓#*1PB ]ՍɖW_&r$ƌ3xYgEuu5uuuP[[Kuuu^C \}՜s99A".704O<&;oeE\~ )Hs 4F"ǓcU"7mwit/d m s}=4g* C:ӤR[x?H3fP\\oʔ)tMú'̹˃> /76<8"*>C~Z"mǓ<s a hb{<ݩ8fc(A;$U̙ *Eg\8S5 `,aۛm1P尉O?`n_\w >pB#IihRg78"Ic]vRWF I'F07ef!d+/q5Wp7|Ԉz6k׮eݺuz{(i, 9yX8qK%:F 0eV 4Kͥ(q=^]^ݸ9|^, 6pwrWiS|͎CRJ~Eݪ%[$גO qq JYiۢFQS^&s$!AXzm[_Qez6mDAAAξ/^b p+V`֭oyZ)%/jTHg[V-kd6+MX"35ʢv+M($x٬0r՝]\z,!2ŘjJ S]NJKJs;;8 PYYH|_|p8l):4bUW][a fJf`S{XTt,r Y&U0d~#P3j( hoˏ.&zBsW?|H>c5o!_oӦM<^!s=}Ǎ7c=vo~܅mqD~~^V6=56j/%9[0%{b2ò=v7P/<|⳨º3yrj; frg/wQa|HWOd/\uUq1<< CCCyac'?ijϣ兴Exr|_dF<$:w僚{R}]?љ=vM&x|27oMhUo2"֛?4#g4ciS8 OfcѱHf+B|F  ?w?8'!֜~6g5R\VNaIiFEl2 3LYf&s-m]f B?Hd%g܌ 1r)"xq/аVqn@5^]NrO{3'ղz @ 1ֹx2Ɲnd희=TNb wUkOfGSg˾Ig}χxJk4^F'N}v sLLh$OwuD'G&h޺C#B &F~uõrfQ].Um 9Krb X$X{GM<{:yGh8.NooOK#Q g8涫z v{A˗h:ŧȣe8zc +u@K$,w%RJ+&$W^䥧E!*JHjv.EEէɕ^ZCSzxM]C2u@fWӌOF4oRo+mOg$\?F̍s42pp"x3%{]#A%S^tRI䇌-+gT?L[0_C"s̢cg5uv ݑ>o4cM&̌~$liCѲMʼM' `-"֦*! o7.  \LI޲)x˫3meUUeղ%lC$&HQRVǥ"#%,5^ _LmE=F_p_O;^N6CR%o<@>NޠUl# d!{BЌPfL(hXb,1J EJvƄ3wˏvw;4gʕ<ģ } ]͕S2lŶ^"~7!U1$ϭf/aÝc[:2.>=ef Hof$12Lc#og|wMҁDrdLDBR79cZJNF WA( Avc(㘺)O[aU 7 s{Qq%L+ pU*^FIy2ͮU>HLs4e@L@S6 I`7mH-ewn  d k8ybBFǘVYVK wVVr7D0^%:Hqy/|i?!)%jX32K!RP\B T@uF9o.SS5&1{i#$sxh8f1ג < ;'v `"=? -$>CܥzWp͠7aYYͯHt,2i^PB7}CdF-E͜ͷos Ϸt *pQXt{ooxG(b(B=4;oBZc!Cev1hPL1Bׁg$/<1sYy‰ݶ@^k '0=4ʱ˖I53{:ŨX>c*"0iҿb߲4lޚz]C,zgjdBZ<(w#}pav{d,B%؏.0W^6n8̞Vē-Amfij'f}o5r%fHۇ#`d)teqXA MhK`n"1;7otD2kGR"I hںfnvVPa1SB>He [8}Gen}Zff3lH4h=v?a8JfW\-YHIS_?0#idެ |SmND'ALSWL-M0i=Jgq:c`2`[+'s>B.w'g ;n&975NFYv5meϯsza: p/s$EA9#[2.=ij>NJ@p4fn'tXRc_3geFcqCrqל/Cǻiz&q8^2^؋7tYIfd.BSgD@ɸ*f,VP3~&s_~1a}s71f .uwƶp. ƺڝn߀N&8t^ό.%8!SbNa(b zI:)ILEQ9w4} v޼ Q}^"/#="z.<ؓR2mvZ_8 `HuԜaׯ7\7UD:! PtFЏ׏/-σbۆ" [TGptޟ;ZR"S):_ {)Z<'܁?Ǭ洋pBtbFFQ*VtX*ŀ5V?C>-'Amۆ|;| xHI= ׀O3Aݛ͘+4e [+Va С]ǐb#xN/\Htc݁&z5;fnHh3dU}o<_5ըfr3΀5-YGBQBɇ(+p' \HctWr|zVG@G@_ 0 g޻{q))3_3ssB(Nl /;>&+D}>O4voaooc㽻 - T<w'P+>ЮMD{OecŔ`fD5&r&s lyz6?A~Nw3[+%9.Fת([.\zpeaVB;|}XևM!Ld;]=5,1Bͺ ([GQ]Y0.e0.7a(=nIF&̿njcZ֚;TDP4g1=$(*¥ 8K`B0GAK񕆑mo˫t$ Łϣv& y\L@[B٢UxJq^o.n)s{l7^``˫[H Ot$ҭbo{\ {Ê>Φbٖhf :O},<][/㌴6E49g=|%(_1I)_qEs"\.523@%yt7:d0CM[}YZ  1@z 臆8))'T7@ 5xJqB._ә15ǔHMCK&qXTlddddP?cDcXGy$8 *~76!?qBQ^` z !%TÆHwJ7wL7KszxdYa:5 eQ_^ +=w{7EHMIENDB`caronc-apprise-dfec414/apprise/assets/themes/default/apprise-info-256x256.png000066400000000000000000001245031526720371000270430ustar00rootroot00000000000000PNG  IHDR\rf pHYs   IDATxw|l/ZnYr1Ձ&@s/$oHiBM^ HnƸ.ZJcgg6`=|ٙg99sct1:Fct1:Fct1:>CނܨZ  WN >WS mV`-U$8xEl|MK ҪȨ 6:Gͨ?|_GTa?%yIRGhTWYPK몵SFǨǪB*5w `}Fǿ8Wb/3ރ==9yJaAύ=+UuN>Dφ') FJxB<#<d:L $LN''3#q3xxEuFǨ8h #dCnPABu Տ%2PM#`o( j PAQ٨PRP+3u{dRC ҉Jb6INfxݼ5`5p'jUUpM6Qit*wUN(I3(2HB5 *jBm'(2C$;H"}^w[CgGx7TS1T}_!gA)i7}r?PZf y]oIgh͛ dH o[=(>Gfhp/ln 8(r`ξA(4E'P9(|h~_=Xa{_VviU$Bϕm]O:9L"xjQ0E \,׃K+L|<?`epȷ,Ô~()%t4]oHM uW1Q:|e_8×R6uf<&s2<(=?o BJwI1JWi{q?ӹ=+>F#YDTn_PybIxBgÏ)):!x]$@W.߷ m}]} g4hTW#]AOk҄~$f~+|ݱ7t\W__]]L{oI ̌ZV ? GT]H4jBiVVE`\ axh3(unRژ.R:6 $wx!c\sĽ*Q| H;c>B+k/@ ԥ\dnmnQ>(kU,۬pW$N MxC1EtvoFuF|3F%_Y%Ns('+T"[O.^˪_PmVΑ(:]Mh}&Ҥ cetjL 'WCHxY{#{[G^*w&KYܗJhXO5UAW;(B(8j]+QKbY9)Ƣ(^RBzhmݏ?p_H.clB/r-)RK:l1 , 5U^5HBu'F؅9/lIXH}3ERJ{ؾNW?poH.c+qeFU(.&SԨ^p,uKOdܔʞ t澺]y0P/6Bfbvͮn@)R7 M.)RһigɔwȒ*Co~MFaϦt0L}_s@͗;aQ%9I ]- mbdRnx=Gro8DM>?N?>*^TE˻8fvTB`aK;@ ZAZY feOeV ６֧&(v瀇F}lQ#6qc>ؤY9V5\Vr 5Ufv_ >+Pr [UP"g ̶ֽoWFrE851lu^c?rU ዔhBR,&{t 0b;'`J':hϭBSAVeZR\HxͿ>/ ~~Ay֑lQpY9#Moʇ}hA+H!z@~u2h@ng:( E 8A$v .4*,$[^b=^*[Dg $CP,>[ dRPrBq 21>";l?Ioo \鲏±s d&.Ute}~P!."K*1?IӇϯ :>)zs_h#?c՟0 thsB Ot 8B[U<;^"(ý-KWҿm#DA0|X!!>"J&`/Q>X;E>cҏF Vc b,EXYt4ЧP;';EL%@Ȅ=[W %-):- vc|mq&G{3.{k*OMƊ֫>=o'BW](К  KجpPc) yJƒ͡i/t"* U dY9/H{۲x=Ux82ḏϢx*<*o2B׎7yKh"leXC`ǬLA8[(v"Q^9֪IrB<0=o^P!u!QIข~I9-Wsyϐm$3qXRi>P(BoHՕr 0XtAr|Oဘ,Ne҆VlաP+z&@Vxף(x$3ttLdvvssMLWtQOG*p3B;!N8^+ǶdWQԗS}hX!F+C \P1I)2,u n9WTTTD|^J>!iS$L ;4L`CA Vw1̊ cC[nV2fnc7s{n$84Nu|O7J޴7x)&л #] 84M@Gd-.$Ĵu >EtU Jѕfg_wzdsmA CEag dR)v>r7Ｖ[rQoU}Gi8Toƕ:U?]ћꪮ7ѡhQL9YA,FDe;0)c*9/e(ܿ(D^LQ3b0qtl Yo) fJҷBj1UgZK΋.0 ǟjYȾc?hȽTQLAN=jpp4s_oE*y{-ljݘUSܺ21$N!'EO7}]{{$JEDK(%\RB0!-!-! ok<ɚ]]OY&n|z\L7n+*dխcTXlj#,嚣NOct]9֒YvZ]1 s̥8BSn LHk;4b/'%?ȃܲζ=t(!V^AuC# cBɴLIS\$7@*mpl#!;?\-= ȏid'Zv*y8>%Cv>.G3BL("bCZ"SmYM$`2Vڡ5AQ9O!-.5̫+3l'㉿;"/fA"R*j똽p15sܿ}` }k ڹ!,[]h[浬Uٲg&N8H$&};0X6*%'Utq||߸[&Й& $ d,^:?x><ްӭ\?&5<`f/|ˎ؀}OnK`>2` Bq]u>=_hZGS* dE'2i}y3\ `^Xl3MYY HP$<)93RquQ4+|9@8 ?9*0Wp륿mjk噕ѻoϺ$DK KeZUCk<A?bi:C]{]qlWVZ>E|R 7}EK5kj/:ޘ͇_{s Pt@SnE2(4FC̩)cfM)3kbL,aRE -e*CG 1sRtCS$zFdq"17t¦ȥ=v+07zW#o[+0 1UP|Q1&by "պ4̨.<#S|G!P34B]4HFBw)n.5mTz(LiʓD}{ˬy|]L;ϧ]Hali%-No(By>w-` \Ը9ͧIZE{f[~ ;hX@zWOIU}v=BP\fg_d*㊞=__I)f:^~N\5Bcv?cT;:o 0ę!ZPy(j)-Xvu9E",޹u,SQ Ѿgv F" 02]k4c捼,d"A˔B^/"ҦI+N`t^uB%PA&AW_CaK;fX1;b b f|P+dxtAHH  |q$"ͥaԕ鬗ÝW]ΝWr#x^^tehTˇٗ JEg_ OɆ^}N5EǶP8FK y"t'v8Y{fhE|vk~ÀG%OtS||=ɇ6 ` ̵ v%VP"uTڶA.9РxcIUxtd<| W @YU5 hhOU} "%1CIz;;dǦlߴ]&+o'~ 2޾: Y/= R * lW0ĸOMdJm>>Z.9_1uﯨ<^C1",L*t0yfGzd1%!^+=VYzuU+m/b޾]ʬqj<74}](B!RV`R)%Ɂ~e_lz^؏u6=?wS)vi!t{(}c6 #gOHGz虭4S_#z̥c zg.dxh`"i*`SW?LaHJmR GOr1>STEQB!3p+8S4KyG!{{L&+hkl̅}ڻU Б2pg_iGx.P{.=Ji^3$0 C Dt|Annf%Hi$y !Og0t&jfe8-S ٳRCn^{pI6Txƒ;$:=(7lM|&7|2٪-'KȮ{l`O !%!yǛ3aÏ9L&o eٶEl| K:2MKwseN9%~?HgmbCk,=YN+8r_gm9m0jUٗBS(6:ew[=T7m'O?ìGiooKVPHAr^i aXes}p"زM~om[to|WW{OBm$5 m21nO wH~ p7:ӏXHMC>p++ pmL͢]|LH=&AVl=̹zn]Śݗ`!-LǠ90ҁPżD̾te~Cam<`p L5 .})["XA$hE190@pK~/M0u !p>sM TwTMoV5f2i:cOhĠ%XԮiDz7w0B6f0lɼ>~jx9"\l)$4#0Dž_܀-ӳ)Iƃal,<ވk+b 7iXp/rD8ܿ=6BPZы%~=t5A3Є )fbE԰U+36dL&d@&!Ji۹/c^uoP4J0VCI10 ;iFJ.4X~yb-Rw.}#yh21|~z7 !x)8Sx}4z&@d =-Feӻ 9#|0 i$VH1Jz DBLr?{귾CEMOZ rUBP~1.LJɎyz_ynJ:ZFkGS*cćRY $X X˪kihuv4a2-SkaK`L 4)*|9҉[YPR^f9Ph9Ӎ9M+Wl*GyG" 7`A0X1a! ZihJh:?u/Jqz<̭cɁOٹeLz{yYL}ђX$XWaW_Ucba-`ZUc [ |v^٧ j >voOQZUbiR xJv9N9> ;Pq>)e0έYcHH9 DĻ"%|vqY(7K|hBsOf{ՉJYo=o7i6nӼuaS2;@55&LV!+4-mza]˥EiI:5Ρ1'lw.=aCx"TTYl7_ ޫⓏ#jīV vE@H]ヷe˺7 EM$1xQ wwѕ6Ï9)s57ғ\;As,`-߻|_m/+/Q'M/Vi.QH_qUcJi~ R[qk:Mʩt_PFjwGm)ѽx8ŸӭͿ:4b!661ԍK)zE~/[R'VD\-B{r[1rU^q$Fjx5?b6&fMkJ4n*(yw#m(E J{Ddq\#M[gv+ԃG^KI;RƋ7\2 )TF1/xSc׾.0!#_Sҝp".Ї/ ܻ{wU8@kJmjIe*kNc3g>,<oI`3&L-vps+4zᗎdz,Z>yV[6?wk_\# fj:[iꛙ0}&h׋#R:*) _lkG4ڽ(2.q>F X)Oݺ}٢=G0$dh `1+/l|$vV@V_֟lzsc ~0w1Ԯ>οZr~X: Ċ1W27]  ?*HIFJnm z==Ϡ6Sü̓ںK}S3U5#<^C${i۹6x땗[#+n ZGԷtyr[:RfjRrlK ͥyN>t>Tyyۙ!$<ò뙃l-)߶7.!mN eOgN(~S̎7_?E=!V_ۦJ?,BǐW1(櫘 t v~`qSa_vvp|sػ>Zw`YB :^UX*#IҌ+ƖL;ɳ<JJˈ+q Ng%y܉,U!HR2p&C:fw*jK~I1Hpտ%9"AjAXm2R?a>n|"-}ݚV=pXS.Pe=qpiտelj;}\[oߜd+Z 㯢}lL"jץH1%iUWDŽ-eù~}޹lGZwcyi]1tĜzE60zSm K78ow]$]ao0j")gfs u6&̘EQ ;{;"'L5yoy; sLZ {mȡ7g>abT`oW2k+=ؑgvRWJiR)Mlzt-2 قfUڢ!؟{g\d"LBhxyip?7 ׍qyꃻ T`sՒ0JӾ6Hy*ftN#Ts pXmy(E]|?cg6!8\351+>鞖Om*A)5hz ζV.oGa|yԑ/WڪS@ :Fzߛ'v5Gt=-^vT|َCɄ.E_:g9 \'`ݥ3ɤMowB"l]z/̊@/yiw^(&Θ]\mx ]Rr+:e{$--\ip9|xع:g'

 x :d\Q<(Jq NbJp/5<f(~UVtMB[8O~ö !@;K ĠbYE}]tyt#y׭DaBmCzLƚ+,vղwCN EL2) DlJ~DŽp hE<.$͸PiDŽ9e Sbz_s=ە*>ZJÆRX7M$Pq QJIOqzl  1<4T#F1-Dѱ Vչl7k}_vDƌGx$fsYaI56DHFTM8H{? eOzU[T__[k_ZS?B%4 *WO2"Y>w\డn@Uuővh!:!܉Y=BϤ$5<\EK,swmz$ msؘAUurd"Oa!Sn܊nn#@s'@,HacgזiXuwCJ]_IwGvʂ~b!cl) f VVE8Sx@H42Bۨ^p>(J#}}2|:K lVf]W]K:%!ycHeיR*jKҏŴU9沈{^yk|P-k &xLxHJE3Kisl}{3 3_E P:c9[ҝ7h8nr}EbG? o֜6_09{avu+YkitQy-5=Q oꐶ!wǗGе.}?k`|sÌ꘻Uez yhD0Mj2 hd*,iq?Ct Ūp$5c,CL@0Ҋ Gin/tYI ]J~W@!J^{>?!R4st, _cʍE#|{0 Y8@-Gi^puh0و; 4fKpD" m G(ЀSE!T74f޼F̰}rxl`Ku!tXty!%Bd[F1k>|ן7_|Gƥ9Q__^Dp䪰 J;QVQ:ߕij>Ezغ~]Q7mᭈ(Ȅ v7=،'vڡ\VuZb@3icVki#=H:U:# mLGq=SEϘyd2&:nfiDŽee<aʣ  k_\]ag(\;S֪! a)1#( $Fedw$ GߠAe)3օPA~FKL1bpL,! J ܋Q2ZbxKNCq477 X+<_a7l}- P;%=zEͫJql΄ #ݹm<(5Ad*MpwRv6mr"c5B*#{:%Wo"˿=([( 1v {{>Dַ?y]_; SrZ\]4†d">RN;`:K(ʟ-PizvϯzsL3N30Dއ!<"-$* }ɍ`ox !\X$AJQ_s @~*5+v3 ^z)rJwkSJ\w]4]EeO !h2P8Sqqe|77E݇I30l]#;;(٫"n]? d7퓍 PCU _ -< IDAT"Da0M`IQ \6U3P.Y8?>oz+|k_cyKm<[4B^Z]oV;0dJ 0iEV'pt05jA4IAqyN]mmx{pR&5/ u4YF=[na͚5TTTpW2i$ \g:!4=uDL̕UU1i>.# gQ~7uڦf'pI[ol#Oo| &sIY9nm7hұ3 !x(zm= .(NaQ@q& ծWT[G"Zva 6|$݅l#w/ 9z|Qc]?~}wx֛yS:444000 `>huQl߾iӲoȽwQc\&:Qs-@Ths hG}CFQ8wlȚWDYrG  =n8 GATCMP!O*&]EZYD2ˡ.z<`1T~`2?CzD"wqs=r 7~O?;３{X,E=̟?;gy…ջ۵&\vl(}:7x#>( ,+3䓟$<?&JO|%KyGu\s k֬OgtSf[ДW>Vř^_:%{i472J}4d8Ϟm[+2]m^ӭ],W.:cƝ3TY?.hrTh^HwA4t/a6L&S,_ ;tU["mV$aj]%s*-SޱeW쇼ӇO6?O̞=?/mlk֬[nᬳ /dڵ~D".R.2vMڦ~#sxz{\ђ;'9򸓴3RA%ͭk Յt_E,966isNkYn&l@J|%xa҉h `:`{}25uى.߮B҉0je`h $c٤1i4}i5|K;֞Ͳ{h 5M˧Mö}Y2Q ﶙ3نjG0*#V1G!ZJì3tn=MNYo;bHW4(L)U}bƷ9^8 ^xnƢCƥ,_͛77ZXf*qS*HiE%{-V)yfGa)%?v?+M}_ԏm3b{π/f.I%%P!6R p4 )mL' yJĊY+ s2sKdÛj8vt-CȳK/뮻Ғ}ڊ>N*wTUUfi;ٱeS zTHv;Ns?͵DcٶոeEdu;a=\zmTsi2do8e+_!rW(v!$FN*TW`>^XW=naKjXB8Ӽjп㥩ٍpm~oxCW>P(ĪU~%,YcDza 8dΝK:駟{a͚5vm|+_aŊ|W .9-y9[VXwzֵ0aU `I'3nt|vm݌cY'|[o°>Lo0K/,XsG48Z؁w..^`D >?HrYBQ4!JdQ | TT GEysDfqB( 3}qrR6̟GQj!S^̆*J "4m-*nͯ'?aӦMuQ$ pBl·m$w~:&L^`Ŋ~z***%\b/_Yvbܸq  1nJ>kuSW?/6M]$*gNgAhC! ^LPՎ.:)b1Ŋj6ō ?O?]tDq?z|;L0mƺuشiL pusoؘ ,]'|+W244=R\wό^yRs$pw Myz^rݽFRn{чGt_v 7nVNh}L;RBpgap6T`@YxQmF[VaJnuדVaemV[a C﫟MPtmx> Oo22YNYU+]i,_/˜}٬XEʮ]Z?˗xbny6oLyy9ƫ]w5\å^o[nv8c?~u~g+͓<)_HSY A`q"~oRćҬkm=*6^lykmQoK4öG6!J+L}#gC&PNڊu./VNÉ_^AEфE3ٳ ܭ‹@QBSPt}t&N((W09cjE@ yqύ7gO&NH8côpSReٶmmرc]]]+{o6|7k</`G}z.ŸVZöiUwv$xջ:y~g'/nVWi:S αyT>{ =8kglg b;5 'OUd8c9|;k7D7,{n-_# ؇m0`l" VJsttJYz~Uo ֏R|ԕ;E%{[X6x1YZB:&YgIӁ k-K2*K8ף8{o|~~ͮ*>-c``Ib?W_Rug}vS r'@ < W}m`ӏ+~>A.oG@.zl=H\W3EeA>?@ir˟∣[:z%zHA%{5痹* VVy~$YXW&BуeJ<=mJqmY1VQ[Q>!kcN^]/>^i'NdΜ9[osWr׳l2 5x>E5qO<9NJ+8${\tE<3<#vo? '}>Ι T^H`T۩4g]|nf1U?oN 6m`qS2ea佽nd6& ²@ [ /FTX֧bop`*OX4a,*Y!N9t< gL=+_ fNb5n) ҩTT>$ir2@!qHؼ/ХƤ.+fָj&>L$I47ֳr]wcǎ?!X Oʊ+g֬Yq^yլz<\y3sLb#G>.kwHW-㟥kOqEJ]KW(&Bdٹ+sCiY ! BJ|]6|79 8PΟй]UR@,- ʌZת Sf^:,I7ug̚ʤzG8=__y߹yyN<8sy>`Yd mmmh" 1k,n)))3'o^{G}ٳgs 78묳زe gy&D;３^jjjM8&yϲ$3*Kl %h gA ltB ;5򭑓mod>.[44ai;CYcs}} *[v:>bnF8<ǮJy䑼̞={'Q83;Yt)9sXv:{M7QZj^Y_`ݻ{Mug?ʿ/9ضm vmر￟}kwm<ĢY AFg ߄da<8s!nK@\{L¸mISr&M-(xȪe*WBIhs3x);ɔjx?FOgxyun/l۶;w= ꪫ۹7oSLaܹ\veAx ;}]|A6n~mȼ'2jLm"9d37#H\gUNib{Yb=V#v@,Itig *C`UeU\"[/<ˏ/=Dkii:uGg|_eժUK/3g2w\^Kmm-O>$,s饗2yd];`̘1,[zH%es^s5jTk8c9sXf q-7꬀1%T\anpLrlΙ/- ͜+ [M˴kL ֲ:JzGlH_wא&YWWW^l8Q^^{~9[TTć~?>}:O=7ofڵ\tE,[ u]ǯk8C WB]]W\q/g}G饗x7r-YjՐ@׳dN` O^\ 7I!Z@͢L [6/\,@F*\s ֭cɒ%aZDX*2\d0a6lΣ| ,ॗ^Rrrӧo~3 /'o>V٭ꫯ2n8o[[*UFN9.u&:u:l|O?47nTi};ncɒ%\r%\6Cn:^{gگ?&ނQ,1|e !Cp!r +OcP"d Z)͙ǢPjL!<(#ԓfϨi4]7=:85᧦-FDI[Q^' ծ .ӗ{7L:ӧ۞ H$T>>H8餓89󨫫_:sv2*v͕W^ɸqۃ$궪 ;H,_A,>fIB!#gfH鯷Ħ>ƤD=jcQ,2L}E:!w`d`i.[മD:l,e.V68LIȁfh5AnIcܠi:qe:z3K;7mԯ\ tDUxhJ->pe]v3ORSSÜ9slSeYO˗ljD"a9Xr+͍72yd?X4`?ǜH F'Tmp&/+ǘ+#^{ <4<_ `7@_n:]v2nURĤ:aݺ=敿=#g:"lۦ;)]Dwa~[Zk?ʝyywꫯVvc,Z:uֽ"kI+M}TYH% E}=V;&ҲL Gr%}t} PR>+) t+꽷w&,{i[ճ|^TS66ԋ ҽJE̮ -#F^;oL<EQO~W^ɜ9sb8>}O5d# ,Xd SPi哿oVa++p>Lr `3C%EF1lq^*2{%۳wdUs^TRQRV[-8~tU&USSeoUU)W\Agg'_k)v7|I&;) 'CpkZ7^U2 sXsvXud"oFkXZV6.v[jGB] EPC?˪W_Fɻ_vw/0*_ X]H<ԥ){?QY]RveI|QQQAEEx fyKi3 60|^:::8c˾n㏷NFtyv]ʳsɳ ЕXڳDڛM*tuEP%nٛ{AW,z_ 6H_ݶc)$Œ +c:B!n6V\g]wd1vo 0ԣSccbK8L$IY| j QO4ٚ X(47:m: _B,J9ZD-5T傒rꕶՂMMMX֚& 3gW\qwcs=ǬYXlwBJ2wo'Vu`q>!n7ZSmNb=Ca7 eˇh3{P5Bg77枕a/<.0oh YL{ ̺ә>k3DvD"-[+9s5XWW 'FYj<{*g`х>r75 B02c=z$n@݇vߞMUvt;}ͼ^P ٤ǑƨKN_8ϯq||~͛60Z_|1>,W_}5{lbb7BE̘@<[%GW#lz +'_QBl+nZܼlAkLR/˙Tf`I(w,{$4-M]at0ohGOg^RG}545X﷾-.֭[w@ eHD " B~|^Ϗ/eE()t]($I$$qpXh$B,ap63q?_WMjj,⭤.OXXzrP'PE%c2`s첿 ]Kк)2!-LĽ$SIаs^>Eu! 2sloKyć{V]Iq(3.+H\ 75B~__>R{{;˖-Ą1'RU;ʪFÈQU**PQQZtf$X4+H@?vuAw{T=t:䅜y7-{H*!4`3w?g׆%ҏ݄-DN ` L_r$LiAF<#d2AOVX497ܕ%Z= {[i@"X3fNQݴb.?[|G}L9#ׇ?Fl6s,CCWdxX&n;uDY͓C}GFoeނ9|lLرd236eGuXw 8C̣ٵ$?7"ՎlDnyA\ʑ2uǜrߎXRּ];Ix}^͚W|caή;3sQ;֕xVž@`߿RHE=ܲxoאd7"Uツ[R2mVMbL ͯOEi,6(@Zp|X߬빬tŞ TXYW|->ԅ3`u衇~*>*`ԘZ?vM@21Sv0`4iڞ@W[+.ffGk'$f0Z[ps?IOyfK0n8 U=&L;cNYԙs|TXxXhHR!()($A"-_:rd9 $)# |^ʂ> }^^M>#L8TSJB@5DZaYj̬: Yˆ~z>y*ՇNbcrZfZ+B-BV.:C]^'f欯Uf$a.\hin;-[4rr%3fUZڸ26Gi0OYs@Qf*.CJRQA ,4d5$0:& JJ][@XdYv?ּmw8d@xJ& P@M5A$HDŨQ4?crYR;q x<;JWi#(/ +)_ןy[S;;)G✯]żO?A-$I$i6%>D5F˹*6gckod (6d&0zN_7eyOp#9ҝ6)L[iI OdLACO>`nr'T3DN!omn|~.՘w׌Ÿ曙:usFeh'7gdK(vk?Mx'/lI;vo3Y[+9J&##_ z;,CU+@`?I DyMױٿ궝:cN÷#ksp8LWW*s=ɓOJ^cnW};~6kZg ^ʆvwkބ)o*1.uY_";u+qԹPp`[crGviYu5ydz@?4w: ~ô1AUN>cX'_^DQq {<7e,ܫUu{4LoD"_6.~N9b?NM̍+(;iꏤ]ONJFe6 Ya*6pt=22w0Gd_01`zM&k`"Nu數џUW# R)%WnJgENoZn*oR~jۆE(XNBvw'%)0De23ƺmʕ+YxmСqr~ko#4 #RfMSۻ%,&db~cՓՑ&Bz6+Rϵb\qfdfY"B: J8)+oѾ<ޥ%1h!POQ[XBpdJz)^0GO^Rl^f؄u_#Gy e@*%󱫽[* [Q.#NGҿ-+m9>q'V؁P:mA`P(Ӎ,-(5}e0G,'E#atJRVwH) A Ș>ڱzaϽv>4Ҥ"Z c$4PCa?im^24p+n l#ݖp?-gEFXZ`y4JGKāi%5x! ƌ gt!Ǝnf0}Mػkxqb Gp rܴ$} Lw-S?4Ęu$I,\p9xUYv $UI+/豕L,%+%Pcz})1$ D<icxCgﮝR)XCɨ1ҡ&tFSVLqЯ5iع}1H7ws93V$W3OffoqoڕoYtn]8}MTV|л$C~+L%|v5G?3N)<}j|}?( dr8 IDATábʃ4D?@VYt }.A94i58߱a*κ⛪} SԿ=^/յ8ȣĈԪ|A*}I\U=<2S*K9uJ~ ##&I%ɶ?k{#VYvwt0bTfnY`k{H ?@eo yf&'Y)faBVE;] < `)3}>C/B* ufQ_^D<c϶-$EQ$?Zǖ] 'SGB^1CLj%e;UGRxqj&W r:OZzAPoeE|^uK4 =%HQ~^ &fJBdjY_S}YG{عi=_>bBH# h|T -iI21_+~YC r^ݔ+.2$N!e"gFm[瓊} L0~# VT+5 -j532s6'}>xŷ5eT@ГTvw`,Nz14M$uabe gL?t^CUBgn{؃t}pGŪ,P3@, j"n7ck)1%25BѼb)_ǁGpAy@"D^bu@œg'LjIdB}{a*BZי@(Ĭc .eĨ*%$(d 'p0d`(Ǜ-fwGOȘi$O\Y--U^SȗIbߞ]?r}wly'|u[YG[;\D i wR7V8cCiq}G.v`_l'f%H ğvc"pU'Kԙ$ )S $[ʇI2%!bZ~9-6fAGk3-CQ$I&**fDU 5Ԍ;y:X$9z E .*B̩Ÿbdϐ.^S/]pI3<vv^v3p)Њύ#IRo$:7  v/3X[ogazaO X3lǠt` 3f̴9QVT˜ sLU F.x:jC=>d7 F'tiTk׫ACWkZc#9B^VdqMM}y;hvDhif 'SXRW2#TAԭ.F.>>OwM3Y $/0za#oZ:.]m(ԆI \j@B"uMFbĒT+ |b }bT_w0c G [/IDw%{ͧNGq3;Zy~6hlD%=2u "i&08fw`{(@+SRQm~rVekwb6^p p~s?ζŷ.k%*MG#ȲGh9] d9#|nj] JB  >>@AǓ dhHn|9(C23EXt9V؂/f^{+f&N#,3 9.q|W^dJ}߂VTƮ<{ ]q#.LbOҥ`_.\ ,v%ν2I#fCw:i9sQ!ELpPjC oa U @_9&?@'a,k\t_}?=(ӫ*9 x}>֮xQ[׭eŗMfx=ذ~Y".= Dy~T_;OƗBd> jnZ? R %#\})6 9CbRhF+hufnƇׂwH^*3y%!?# BY3m`(U{zT2Q&\~:+gOϥM~U_81׳9%{$v Ĝ&piG Cb%] *̲9߀d`nf]X쯱.2Q΁SGM'C x׆ߚǝ8yl}FyVݚf/ŮG}Q1''O{ov}_ݾִ)A*7QAbOZ-2&Hj6F/D&VJ|,_U6-tHIJ@mYq*;y [?((.#AJg+ D=, LLg%WdQ\e maVhok&a*m,g3].| ̶!JaD kYu9{IǴu=PIIYY7AHMP[ZD߫n0}ooCTܟc:tYU@*p =C3k|sw%XbbvrM=TEzmȹ9q%:%>8@Cd9+Fɐq'2de!(Te^ad$ $oBI-/VҊ$ 6y+d2AKC='szeA?mQzq]ђ/?#y0;΂C29.ߝ$#LQj'Naݪtt%TC&0~tu VޗBGbxAVKf$ vmD&V;eגŴo)R?sV`0jƝF V`Ӻ);_2y&?9HzAҹzls0¡UCB!>\'n[E_ϟJW2B!Ak }>ol2:1߅ҵvXnga5T ()oE !??Wva`Ҿ\_ld<>58% ,.HO Ӻ+hx!t"`kG>uy { ,^]s&;֙6Kq0 Ǯ4y)CEvR4a:ǫ6gE54"Fa6& i}}m/kmX~rEJY1}L@$$ ť~Ճ !ho˼_BO4Awdj6ѸHC*5mY'GYl7WI}x`wl&W8xhre}.$ 78Moow-P9T_JѹR^f)eJA}vHмYfw(Hr^Vn?s\Cެۧ[JJ9kWꃮU"`9Xҭmݙ} ?VۅMֵiҞc~Aű, UjA;$KH5<|6iFb|خ;ÜO䈣;y#tф2lnLsNEO@51fp܊>AnOÜL~0NŢl{tov7eTTœް/e@渁j eyjvC} B}tdr~3l׮Њ\\Bo}Qq (\vpbxHםNӘ| @)2ѳH0G[$c'Yfb}Z3{aB,tcc$[IE!I $jҶo/u6Egr֕WISǒ TfAr}tRl;"rp#!5qov@=߾7NqNJa( R BFJMxCls^_[!_߮ A5r%LڜIS]RHqG&i3Y³D\GCo-pw$Ψ!z cdz}ZZ69z ~΍ȉ6]e ޡ83 <4sE2C>XX5߼?|'" T_Pi6+*%8jƄ /EN9s#gn ACS|}aH8>?%eyu̢2^r9WuiG}$Y]a xD>y=F6%(>/Ho vZof|eG6w cGR.h pHU VJD,K*+vFMÎ4>tﴳO~Ή]DyH)v64@[ z.n`3)Yh_IG :׿{~f_E&lQ K/U'EZP08$PA0a'ʮ݋eX}D)I3WSYRDsn~ 3'yB Ds FJW/zIgi8o׵d%yxUN=p i2ϧXO#mW귓):dZ Ӣf~Z`t*C.] и&j;=)„b0)*-gl\skQ,|{0}F6eNV"T5Z!14N㊃r0k$jխ5&J+2`pC 8iO^pS=&J6 3 δ7IG-8P 8# CU=Î=m0(g7~t#'bG՘kuASQw&0 P=|W9΅ M~Gܜ}1T '`i+,64sH#P#Fb t2!?Ϝ#Qdp}ظzvCQ?0͞K)[zL$?67%j$vŸ7'(|HmC+ܮpi@p-01}FզHA% dӖFn򑬉>nęȁ6*^]CHC ȔK9.KCng8ƪZp jXRXȣv@e# 4Ա0аcj ExY*gHO'vLuӿ{+R#4佹9cHZRԸWc "O "H,Ȳl6a]s%,Yu2/>Mګv KP?AIH._[c_nv%px~RT N BU3;s_j4bwCO&vuFPQ@l° Diꏸ@{@rLuF&_e{/IYi3}J) o6O4Wv<|Wѻ+ϒ@I|6G!p?pgK͉g RG7q!ô@Pm2l, ƝJ~b :7#1(i w1[ ?/9V{_k?c|nZ[Q}c1%sIi 2Bܚqh=dk?B[/SJSy( >O*uwyp.vmA(k#p;IDAT9 DY`g Ж~Ire`Ua\n||~DŽ1 fL{t|U ?yϣ&t%Ypdj*5ِ%D !@9>Te]Xg<A0dm.|}.P2 cAGp=_9w @;T}#ȣN찹 #*7(M s|* 3 ~VPMjSUy.aE3?s5o֋l׎7GRe2oMRx(ȘER4n%h6PM9T֠W23 OpBAdr\ݹKL_x^wwz2;_(N[̘KIYpд6 0LPOzxYmqX% (ix ׼=#oGT"AYHḶ)y &oE?:4N:MHZ@i-RZ*=/ !7ĉN!NPh+C-Q>4ΫW0]Ҧ#ֱٙof~**[T%.wh:ξ8 tZ$]!hg͟B&EbSǙfQCr6.[ 4C`Qz?HxAOƷ5Gw5i+y6 z u7J y4(gO2335;jy,UV`=yx5K` Ӈ5OWלD@Ӕ>X9/\*D'u78qgDI\q *40|$UR~.':V0n#kV0협GEW&7 l SHDܺ9rsf Nϡ& ߤ3JJmzz ?Ӆr^_e"=uui') E>8މei`RFċ(|f:tO mނ1{1! ,EMS {9G1IO%/%qErO nҵEee cWR\WzFQ뙍IaʪԉǣH 篠;rwDZ|Ճ1ԡ&LL7g~;djl6ּ(ʽhC^FCg U@@p.#Vd"0P .Qʯ/Zo}w]ۃ`:&4σ)nPeq'Fg,A79EGRsʪj]HBlț>ol^l\n7n`c:ah:^7RIX@4r4{t*NaD+"; Mh5V:Z,x9XheK͛FaRJ].CwwVUvgܧ_›¾uo3u l?O^/ mRi[VnTҳ+YJ%It7+}X)ښWT:ξC :ہ0r`d t K2܃4S%( EOT|v5+IqB9T+J&w|.F/;a! GaxS0)nݛGGhLEiPOl²aey2t1}|4[#L.1 !p{0in r!t%%J)RB0fOnw>j7-t>/gRpOipßu 0S#cIIRRL>V?k6\Vvo^wJf%5mfbҦ'G)yNM4 , M4&dmMIi`+/0< zѸ@9a#a [^iz14T ~KlO*w?yƀiE%r`6P)-"@B]i ionXS#-73rEee%1q%>~iC0}~{9vmxrY)h)Fhg@([~{CgGbow=;9̹! $\&,:@?AeHsmHtkJfFmϱFa/!wX!n6#6*籥oq̹+E/N,al,&a$lI,a2 .CMG)EgGzj%"! fz"F$tE98qp['TlQ 訍VmtAۆUr-O8lr*it;̋O_o3UIܖN ɖRaXΎJlӺZ$t]c=9D,Eg4NB6$#{>+ރrӷ IK%K:gRX6VsfWZu(@Yt|x*R%PXEBJ,[bI%,̮Z8ȅlm5K6EZUrVw00 аFΈѤӏ,xyNЛQ$9+  JrfW|;v0)]Il `yYy٥1SR\ntd|~֮(qUHFh:RJXm+Ow[.k0q RGyݍ&{R ォ$ŀZ*%A*~oi> pK0z4+]Qlo~:zBq`\1Rl/cM#԰}kxp@x5(WW*sr +Ve8w7rT\ ; dA.!bSc&{IENDB`caronc-apprise-dfec414/apprise/assets/themes/default/apprise-info-72x72.png000066400000000000000000000173031526720371000266720ustar00rootroot00000000000000PNG  IHDRHHUG pHYs  uIDATxwx?̜stz-˒dl\۲ՔdY@Hvs yH \&ln 1&\@h)qْ%Y^fcʙ#ɴM>w̙~}.ot_(<:F2@H1 _Hji@LY$FN`; e+T,S,0\OQ>A( Б,z:Janh^^+4Voq9Z *-**D Q=>IDGH#CP?T ) pJ+(nGaL5((W\+pxe^R}Ļ9=u2~t+ Ծnq&KϧjBB@J0)!!H^x};ܧ  Sb3i5aup\HJ9G9@0oM+|2h"XAETEq{y T_}z>o++U-QEETEEQUTS|< ҵ&GeK~%^F(` TD[b-f g\EUPUQLEbp}@tp`'”LG%+k޷#,^8PX 4tE MX"(@b!@(ug#N*\d@ټ @嗽}*h!(yu~ UCTUCUT/EլX7.ԙfnB(j* 0ud 2̠KDbH2({u޴/ G'P8p&BP:g_EQQ5UL@4[A2UN2n/&ᤋgi(Ч9\dxڐ %RtDK0Dl*{M_O\=\P|.oa :ਚbWl)xH!*HzxT",ɬGHsͫUa믒ǐRyTNHӼ|yLi>xVX4ɻ$R[t?w 𩿔~ | 8y/oE1UKQI+,r̪,⤚C4@"q8GA˽}~hGسu3n [^{IS@m؏GtR @ѼHtj95H5O+V-.3 &` EQQj&a !,L R-i+sby-/>G]L>]$I@6H%o) ]GTYXK@fgd 2I @`b=}vLw r*?-2 x7O#`[MEjAjW5< ̯.~Kk`K_KJkO/I) j"B$f=vyoL߹ډl`{Tl~f[N+} 8-Sz)fȠEera%GyH1SyjjL {?7wvR=ӛIduFY1Q5$f$=R}$IW$IwZ2(%xλ{U: LumT&UO1"jH3Һ Sa_i%u\kȩ AB0MA8&j0P}ĆgJ%$bQN> ʊ´ ǭ~ZYX[bfW14DCJ׉uS:E3Ob9yw!:ByZj$ woAf+t R6oC"LplV*\hB1SsLBbNXyt~uz{ʊ2cI }:7Oo;6ηd믲sӛ6%%̞1XdV'[\I}m[,90H‘vE`8l?2i_T!Z v8ַb.BҔUU!TD,:صx%!s\߱N6"? UԄ XP["A75ܹ;aJqeQmu"TpxWE9\ZғR1a^N fgM[RO2cL+@)ളᴋ.˯ێ"khffS C U4mN ⤥sx8N4uo"=g'Asf35 [`JҔOq%,鲥I`kBUżCcY{DGYs/4SKÌ U OIy=үd" `:sB sJ^Ǫچc+aՅXe)HAy5n`("OE|Ŋh8H-;３{={pwxG9]T DV'D3m,r'M7ekL))hBTM3kER-USδo;vQ5BPP^PKmr* m)2GZ7NC ՕS;7\x1Pzaa!W_}5555ߵzHfu.tcmAWQQTeTt8G5BP,M5^+&WRmJWZA&8ҥڬd#Ś~wBUUUc>\r g7`o'V]U>ϘRbCdi3v*,B񴞳bBZ P= M$/#d(̯-EwqoX̙2݆agќ׿ɓ qoGS*g߻yU# Fɸb0M`2m z~JU)i8P fxBp –.8*!FY8kի̭.B7|s9gct]'w~?䓹KPM>϶7S_"C0ϭ~\McĭbCI~N ,LQ6QpCUL'T7_R|KʂTi:vWر1 І XjJ䭷RWW@2g~a̩*F`˟y}۷*.+fW~/>v ]i qKrDiAUp7#\$-rv}.pl%) h?\{nyk̙huRsNv̓>SYYɍ7lߵg5~¤Ws;)O8&=&\x jڇV$ G{R*׋Z̓ 9~5OJx~҆Z6rhu9 2˝X,Fgg't5kp!뮻 :RSkh$|z&ul UZ^xt3~ПH;y1 Gm *PTk1X)a \:g*U?!wW9nL(r}7G7ndժU5RU%E;x<33<2m}DY2IOi%V>BIul!`Fޖ؏-U !Ψ'lyV,qkMMy qe1|Y`A^yz\s5^mJ~)g˔ 8MbHdp)lf,2HeƩ2OARsuPV)]ꔻHaYꊂٷsＱCؚ \9眃ih(coG%p y/<ƒݑd% U䖻{^>:H,#FinGUT\4HCf\払$Ry-k]'ʼgÆ \믿|ͤR{<ZM@< 38H@S1nØ][H]Ȥr:_Ӛ9gT;q:TK }·< vaiiiaŊd3-ӟv3d2AVX᜻iKl~m~a6}Z9n߈2Jkdb{CqadR$5XUJ/]pؾ}qd2q]+Wr뭷O窻~L,2´!⃘8Գi{&,idRDg3R2g]Ŗqlgqo깋8cf6mMY|=sG/r7ne(qz8\eɜG[R#2ѓsPVv&RJ]T88㲯$|~\<qk1mOBcIJ%vLq6`Y2I[N;^c;ru3lXzŬ_O<?L& E!.PQ^Jte1@77#% $2&Ns# Iw#6@ `= hoQ)Ґ=P_~Ѫ~'ddlé\ΖF߿SJ"AN8d.na\ꦐB#1 fF"TFbc*9X)JyU5Kin9]{3:tGۣ,(Gx:M$x/E<w,V]A8P?c_nzwHKzF$XicwE^)OݼEM]GqԪ 8s9kJkO^exRkІ˘{)ǐ햦QvD np9.ǜ\rxWMDI)%J*z;;Xr gZY[7;:PrEW|| Xd P7F HpP#=RAK?32#`Ng .g78O(d~j sy ̚5H TG+],8Lpŗ+'bjY5Ԇ LdHpsYp;zґ.[l^JbG[9C'ǫK7jbXFgzS3c RJ􂋨)-f۱AT'\^"%%3L( 2B[7rLih@x$deSp EAyrW@ yBRFM,8ij}ˍ޷L:M6axS<H!tIBKd4<@ƂcGӺ^"3_~ɗ}_q9Bm/P0RbIP|^M#w{w?ΆyiU?7_m\YmitG7kU|PrT&+fM[TVg g$F_4I41n( }^+y5zν**Zbd 9~{TGn`l29rT˹-xml~3(n?x˫T vWE sam hF乳ٺ :2g)ݱK&-];%leƀc!UKJɱk\24sG(j P(NS_Zjѻ:r{Ͳ?ECM5{"dtR "qcx^!%C>YƜ@|p6A]5{n7\n`~:'|)~{,| ֞5 +~r$p-'q\p l<ѵk;hc|70nšٓwrAͶ]k0)>9%E`mH)gd +H0mPܳ wtl\g ƏUHJ H]GJUm5ryVc8ʤ%gQ7uqopޕc(a.ꍚc$%59HD7һU7Nפ;W̉ DQ WZg:BA EX%$ ٲ ku +ng\[dž&qq-Y>YQqʙ/8O0'} R ( Á(TvSILٝc6s3~kǀk`􃖏3g@ ]?#~PF Mk%Ӈ'D!5*Id$H9dwZ8` "r/2c0zsv ?{=Z#P5ՁR=!WZ"/,u<7H듿fp3ZG_:o~D$\?>EjBDY@[aO\x1y=9]myavnFO[sz5ţeiBJf/"cBUԆz`]jn_::Bгq-w`;YŊR:T-'PY ǔ>1c=}Ix]SOZyYwVXq.)7{- CCM߾|~1_AeUVEgS4}6&Փ V@X %RѓqGо5~`,LOj 7P'a9=:Q|%xBEad80>lG/Y+|2-]a R iMfIZ!6*mjyV믲-ނbN\Y"̙~ͤar]oC/zKYU/<(/(sIENDB`caronc-apprise-dfec414/apprise/assets/themes/default/apprise-logo.png000066400000000000000000004722131526720371000261150ustar00rootroot00000000000000PNG  IHDR?GriCCPICC profile(}=H@_JE*R ␡:YU(BP+`r4iHR\ׂUg]\AIEJ_Zhq?{ܽFiV`tL'b6*_02$)u_b<ܟ_[ ij0m mp'tAG+-~\tY3'.VLx8j: 8kkߓ0WNsI,b D( lhIKRU# ~?ݭUl%@ϋ|]YwcigJ `zGuGS`ɐMٕ4Bx?o@Z>N u"e{ϴTrbKGDPPV pHYs  tIME9z IDATxygyygzIт]BlB l0X ,9v'>I,N|8xcb;`vd abB  AY%|~y033333G$߄i3766Q$.> L fR_Ӗ3E 4T+jِhj}CBT e_<T< e"! }黐w #]133333$j AJAGH ڀIuD )ALJ(TB)J`۪6pR}J@(ULJ}dԝ"K JQ[u'B^(ח&_p8H2;=GWԀE;ԐF0jS4bpfHБIt3R H}4'}-k?WyVLU%DZK*8)E I|з! ڭ2f8H2;E?CG٠`JuvK+88 qs5I]km >Eݾ #4UՆIm+\{g;uOnipA 2\L(C 6;neBzi9X233333sdf,3_ pi4OVGQ* T*VT$1G r?'>rpB3箶2~SDm˳oW[Bbi7]ۀ[oj!)/;lu#tiv%6F.mʥ-bL}5ݷ1ESgEE_Tvʗt o Jfffffvpdfk+\Ĉ!t !M$IJ db0;J rG @uMipVi9UwPw7{[oB]+ͥmfffffIf?\tf#|4plY #AUpG˲AJjL}.14nJ! 誑&uaʜPiK#`p'p'ff|=}L(AA=8P5,l.Iڊ8 R ¢_ݶMWei0M4mduwR?l6@*k+$V9GJ_mjTu8# "ho;inx~gdF@wȁ=$-AVfg8Fy<=s1mVuH?D3sZ--L%*K V$ ƳѶ'lD|-͉|g0Qw733333{ 5>fvP;d3< `7ps\Cn2A\ q,.ЉZ_@ԞԅJjzQP2KiDh1_%ibN";/&ֶkAsTf^ρgGY/-΅84M2Zbvh$i0oItS9U;A@ZDڀR mmpVu#>*$ZԈ6'S{v<ǟ33333ۧ$١C?0͹Á-9B}bpj$#j08 Jjlv6$7mRs5 $4jWtmK" ޟ33333'$CmE@m8'SnmG!`^ F mkzJ:kU$!@D#4:BMFIRE&n3`fffff?IfvQJiGץH"mi8,&u+T!m4lXV$~APAҦ.H)9I@$D#)P3q_M$zWkq Þ7IfvgL׮{offfff{AY1"$`#p!ecIA Jayjrm;{!1ZJ}v3M>;zCJr; H vFRS)QiyS"$R_v)e)/{{33333+nm33k}b m4J;BoP*r7 ( C$џp* |*ϞS4|,I%S\*W O73333{$3ÆQ(?1}>y]mH6)+6ՌxG"aĜ*2HiD3hskDWH$=)}n#&;Xf=s9?V t 4uE3ꍹõskBʵNtmi6Hן댤ų]l:Cda]fiGW$F*osR7#I$`$Ѩ!5H*'!RZN͉10Gg?ﻙ63{so>F)jvo n"$JDۺ[V.}+Ziim)u*K"rvP293`􂄞.8RO֯ｙMqdf7S.o^)> Д,G3^rA>w 44]NDPN)!+ T: xBK!$33333wosE419B,(Ph*JVB mmkT9ԮV+ѴshPڦDj+קr| rE~scK?k{:MfN! VQ/6X_EuHJ]o>CK9/s!J>%b&HJ$ !9%HI.AR;|집jTt PVT<1~cnm33}ؾP*2p')//EOT%p$4R]{ZEVT%Emmkg&i]ʨ>JDDЯMuEA7^۰<xDogIs#fffff)W$Kyz$Dz:e;"ijjҝl:CKyІ=!ږ*1R$mk1h_K$V+I)uLmER+;[OHvx=G~#H23ۗd-w񿀿7h'Be5 %ukmgou%t"D^BElrO+~#H23_>36.xp|T$Hų残7kqkOC4*G%A4AER02#]RP._iRas3333C+o O | 4y]P?)or]nD{c`Ѹ^cP4ԆHg!6#=;`3牘jV[q*÷Q{M Hr{q:s:،x{nffffvsdf@%w3HsƱncV(H߲fgM]Sͳ+)Dq' qbۮ  rGfL䫉n|iHf fFoҰm[.S+}l.VtK)6 tK=߸=73333;8H23{]&(݊?x׀岲fahf7\n^-*7qժkåHI. B8x󩤹_g$y޳G;.ǹ _+ԋٸeܓ-IlTb$5eE6R"QBr{ InmwIAڶ E;+&Iu^R7 @܋.[_^ @dfvWO_@?t,p$ƂHKjsX#wݓw%bRIDXI@ĊQ*~4W&=<#̬*m.G;3bxL;~i_>I4;/^*9unQtE{[r)Gےv,R*c DFxS\#"K"țsΗIZ7^كAp̏=w–- dQ`(~!UϟWؾ~=O" ֥<&1o[DLFѵFa^-&DEX 5 IDAT$|[NoIK)(-rl#do o\A {'+ӨfWF(gSL&׼}_{ؓHs<| f&R?v}2DvjVRʒR[fڤKk[ N7VF#䆹OKv˞AJ_K+o a~Kb.c| n *bP%UCNb*M1\e85?AyAw%3IfvY^ޒ'4F;hoDx|0ߤZO n)ImYQ"ۦ&I2;<:#i_}T!^WcӁC,;n?fffff$3;?/FdGm]bYD,S=8Rb SPFD%Q.zm ڊ&͔{ #uG} T}<xl1wb[ns33333o$a!/|y1۶)^m3ۃcͥ'K'6I>|!xF0ޚHOnv ҿ“6x胡nVROmV[\S/ѰiLX!<$xrj}Eҧ@׿meRU ElvPvKbW?udmu?PQf+#>CBOƜjnglsdf_O~ի9ڸ'x K0ChzlOQ%ar;G3W-<zl}6ȟpL!)IeU5uiyF^ƧوMD iJguڕ$ҴFTG0!atгD~fffff9H2CIy/i^?SMrԶpa`To*Z+ ZfXm#oEDFD[IZzJ4u#c/r]{Uڲ&E,q17𮛿_3333}ANzDΛb2Ʉñ.MjmO_Zb0;Dyy嬋> $)$IX[#T$-uv\! 3j4xgD&J>ydƧջ03333$!׾5~9r>"//:XX"wAPmGSiD_>n&L$"'!#b֏V$EeQR "rr[YMPpts sZ)8n$3333}ArN~~W<ꡜeiE% 0ZC5 &ix T(E,1~ ED.M~%I 'RPD(+ՏRR@ KZ] &FR Fz`j-VB9"AMeVwTW e9…M }~q^wEQ5ٓɄ3~v .']L*MHVRWuQ5fHRqցp<w"#m9"Ê4=h;(%J,]A[[3D }'J$XxJ]Z[7Ifv(oz9yi'˧NJ+["gLfSjX XhT*6GQ%( rW JV&ډApx))[E/uBdT}[j[۠. o#AQBe/v_o z\ھF1K4P*$нC1J\DLH-g]Ύ&*)=e\xg^YUZIՌ")%uwhW;[JƠ!=3L☙7ޱb<>g2}m&ݭ3Zq_1~ُRO >)6pl Jf4\MD6D*"AW%ʁ 9hڬ*r9~y }fffffi3;h?.c&2X]B^1ŧKF:9@{Z' ߃~ny$ڈq%D3R*qTR BRՖ5PnNsITjWĈ!ihjefffff{A4θ⍛&Kc1U/ՅN2}m }S\U랦$rց>|_cYG_#rDLA@ѷX]GOD)AVk!Im⤮ᶪJeZƒ|epw-xzN瞗dffffWC`fS^4ٵiyiSby\al,#E<˸ioOqOetmƔ7n{{:ߛ}._R.)cE[VßT(,TnH@jRT&w6)l#ꎣ>PJRJA*tIfv~7IJOqmC V10{k0Y%kirNʳ.bp(R0RRD= EW}DۗVg$;hn){stt~YA,!> qТ-Ұ,̃Vb[9ҊUcߚ!=R^OxG-nfffffkqdfs韧_ 8//9'$>`TAjDfB M1IPq-3g^X ӱJY1uXA"i3D/Q;{끋vpIKAPK"[c299/-lHa:V|j1^0Hz|^Zjg^D"q]| 4dO Ꭹbwv^R[ٔ^R4 c7!4ñ ~nq33333[Aν ?+&UҪʠXc]ϚiM_f$Znzۀ^u| WKnkjWuzzs9Gikn+ ki\g$3jtѮgfffff=If;?|՚4?8"ʢZ{W9RL}Z,i ꢮHTcۺۺ}6lϜ]E9"&kq n޵.`ҠI3owq5VB~ۀ&4߾ֿfffffAu_yk4愙ru=G{8uaTBB+ފG^kl@*öt6L ;j웲rxxhmwR]Mv섫A1XT7}z1jffff?>f`89^}([Ktm 0,VhJSu`*ESPg5hJK4u(-ni!r.yUw[䈮I<}@W~}3]-$L~"p{ِ$3{PLOF]"r!*%A1D.+M70 5 2@Xk̞Xy5w8{Oi^w/;*)IKtp=ml О>DiŚwJ{G{0t[Bݟ.=i.IМ/-nfffff$3{@zg_޶MhL<0^Z&/-,fӄ{Quկa^rcW~XW R:2ǣ3Ӗ |-V{JPWb%XBO3D$rg#kڤd\mp<+EoY XKK,p‡F6dimw`bPW2D2hf~Q-.>m{Z.0q&tbju3ܟ\B53:h rڒ'GD.Q #rXm*TA 4 w$W\r/jYvݐ"QKXW *LZk0b.ܠ0V^*%g*ϴ4p{}p0o<Rc&fs1$vSU))ӒRn;> 2 BGB 6n9ʿffffvrdf^8Ou O,/ͬSWN E;_U4#qFgk7p;VL /=?zP~S&wD|6wkqې* rDXB(@)k}{hRu ƶ1.o/}Iف^9Ow/$~u^pxK3?hnn 9)!% aڞLZfWVM7ijދUٗ`Iͨy},tqJ5\uu=t}Wޖ,EWqZY ô#wkjE\lr[bG09Gz~mffff%If_oK֭{HRCR_qԵM2c eN? g۶[nPto+M5LiJmDiװ08"QsJㅃж.ѽs>02J;uZ m*ܣ6V̴neb*$1H"o^-4/{6333Ò$3oNm~/`: G)ALv$//IWhEuUjAԧQjYcmQ[cihE5BLs+xv5 1C33 4$E1 jxeʻi[v͈j,) mK]}iXR[KoʿffffvXqdf1{޺3aii4_2]uOy5i8!K5j us(a4 꿷+MU' u Wi[mOjض 4su^r7%$b00;wl7p==iYB )JkjL0ޚb{_єϹx+syeȇ`ffff IfOl>w-y-,jSOvbyH@+#D+zPuRՉ jVX f6-AR0}l|<=U-Ű Qs"o<>7s)'_Q]-L]@r9|&ܮ6f+ǽYjcOgO$40/Offffvpdf?S^μʏu .@jE,/3޵osKCB+1肞3lŬTSKL07usbܰ- 5I i F7|6uсJ}쥤HJ]莀&I$D d) !ֶZkV盝կJ4NFDR7RܦH3qF䃷]6$vxܦ l?Yc>O,mVVk̷ZΆ>``۱r崩]j  nÇڧ6|]?yJ(4P>~{>JoR;s뎻U1򗁑 ?b*n*[Qd{n.!RyG#A5@@|o`ffffIfv?-faݩ`UH݌wL+{}trH>pV"c IDAT>57)ۺWVӚ&i@pgyT>P-i鏀;v~{ |ѽ%\ @yO`d8LP(oltڈbffff?}8+~7_fOܑ3~bm,oimO WncED5,IpoϫMDihⅩF};[iAS] ~jU#`՗0gLerXp#OVo ] Mi`(̒<\R{TKj-YW~}=[D #괮 Lؾc>t>A!AW/W?}c]5̕o]ocfx36 /7c@ &BtU]U?2#yKЭרֽy####Ns~?0I#$]47UTw}fXQKevPSOs"eTۮS+D ȸ wg6 jBB¼u Ls>1DӐEίUqgMțQ3D68N!>f\JuFH6r n>qpku\e.%A^LEwO~=2 2yF# Yg$6@ۻb"AD=<!ToSۥ$s{jBBBBBBBB HJHHhg?3absU6>~6sf`fԦHDaK@Z"4~UMIU>S-+2M7jQðoLe'fŸ&[W$0u7* }:R%A 3{uJkLiBBB1;nM?|b"$"Pb0=HO0#D[E)l 2k)`*mx,\S mş"V; /N[y"UbDEDh$*e 4gp#x{+e:_yIC0#HHڲI-PEˆ'IDLS_ꨚcq"rLBY[e`sQ*nxI~{HNBBBBBBBB D$%$,3M0yS ]jF:4čM5~פSƏÓYGSFVUkJ[tŶPT7GP9BzLsYj˕wQISYYΔ-M5$A+%Juw h 1 HJHX&u㍫wp u>9YA0-̾}(}l5D ۶¹*fuuaѤۈTc*̅dS#q+QDIHňp6 5Ir!n&m;'z-UI@!2S9gT(FuVIڂ74"kc*ڸV=DL|N(m '8v~?t:+:gA(}klTuqB^+ - j.R?ZTV\*J\+k:#Iz(lV+UV}ZZva ?T ED9L62e|ly Cø:.Icˌ1w'.޸' F '")![nYW̼tWtG$t_?+P%ۇb8gG+46t0vm $hԚe0c:ANTۛ$$"ڃ5 "Iw?0yneˡ߰l 0[ (TMhª2o>*$FWD58EVzi JHHHHHHHH8I ' v|*d٘gGQ[Q Pa0= EE$Q-ݏѶ)CkB:N+JC)-b[R! 뜡@T ȩXlˆZqc(КML|mHO^)wH( CE޾BĜS\/XK>Ve-Nwl,|Y.iz)m5YLԕ).:zQ$wg.o]Ol +!!!!!!!!a#)JzWw|𼕧lOK"ՐCB ve l XETJa *5Y( TJ9¡bg *]\8NWjixsX&dZHDf&+SA ֭DxRf)Ul;6UGB@ >9 R&y]keyCwg4yM\q_۸6ϷkY}ʈWY gfV#x5GZۈЂ+VK%<i:Ʃj5Q(^Du`RHut6U2f JS::_E~bv lYȌnpזI!wmj^Q=֍ $chk*>$I8j\oBBBBBBBBBqD"ML/|tk,AQeIR3uILFM}LPVfhݱ샵-w~gqԖ&T55=i0VNQ/ֶz;qcѴR q?I<$=[ӅpObi)P43WI0.^;WBH`J5UQQ .4(vm?h KHJHX׼=g]n|CGDZ^J1;aUqJT^^s{* \Q'j>U7.l(,V(6ˠt%nAQIK9Q 4QwHήt=|듟v x-{1$b}j mHm /)J"R.S@sOHHHHHHHHHxf n=}v֮vk閻ǎDȘ _l&h }\q4bTVPf9: sbL AqA@bP* ?@g*%hWF99AS̲t| HQE# %%K$RuIq$UmqBtEM "&?.PrSHP*ʑQ ڂd*{(V~Ӏ䐬m vU+-y3|秚<\F{6(Ν.U3 ҈-w[H띂F&Z_ӯLD-K\WpT<&֙,ۺ\WR dAuaWLQDXV3#)`hQ*oLighM%%pMҸ,4:&$$$$$$$$,5$")!b7*Z"dٓ,[,l,^GY6IKjBF ¤#(tZFB]{J*I\ABU$zœZ失%]TNN,[\?og^5JԮJ!o$D7nl(-GRYZry_mDQ @ 9quŮoNnwG0b"Qt{7S0ڛ]q)lp. K HJH8Jظua0fɲKl|8 $D:bnÇAkYVd?Dڿ &* qzQ%hK{"aPX.'#?E9 SWoQX{鮳w}0u*kVÒsD2+Ƞ'1DXV+%N IuGj Nw3!!!!!!!!a)!I ?%V>fSde/a=dcmFc~bH (H3XN/0jHuEm[BcK+T&Sɭ+"bcM N{#- aZrxHW+`E.ר=IoDU; AvHA|:At?IH!( $:mNDNIHİֱQo׿&ڜq-^|.\~gLb뽎9smsrm_)DRƏla͚iudE0D@ZMZ>/@osFLVeXf$o2[Cj dph;$$;ҍHEQ8_C֤65-V$(D5f;>~*ҕ)_λ O4A,L@24+Nz,MV9!LP B2<"m:m KHJHxuM@0,ڱ,1Ik%HD:N6 00LH1Ace󗑑-L&^'fQ/ ?p[f%O}avgZR0JRXsqloTUn[<'Q}ZfvY^Oų lkpO*ʟ˺`: V bUIm h$V:Iiv`w5!!!!!!!!a IUf/ IDAT o^S u?pPx׾ .L|5V_\ T۫$w;U߻MR&&X 嫖u[ _p> ú F( ?6YY].].ս )s!iMHHHHHHHHXHDRB_6F@tnlfل >0v gg1wR#)2]IX;F짌*jDj#-qTIYCh+{`z{o&8\t t7YS Ba#ùt\TV%Qe$ h-h̆t)f4n' 6Z1aYUOHo/ >Ü B'%p2 <\BBBBBBBBR@"=%[HB$Zsvj{Luum;xJuxB C(Z}r.X?EҜaKB>p0U SWhZA7IU$7)""MRQ"v|I%E̹foXl۶5{ٿܯq;1 -@&C@{Ot3LRcӖEe]&ܻI߇e%YO%7 KHJXv| wXvc9&ϟa ldY"\,[,&KD0lmyQ#-Uَ-MGvڮ%*-#-0Z o+C ) J\l-ΨrfMjGM4vUJ9(Q2Άgc~γ𮻾eO4dع<]W}TZPPIi{nu MP-"CV<{?xiNHHHHHHHHXHDR²>k&Ƭ$)69ps&&?A0J<_lvZq9ORnJiKf٘wdjJk&&!I*13b}Uʐ }Ԭ݅m M͒b$`qŀܚN[BBBBBBBBbG"NLr֮v;Wcvlvf.8$5lFh~*I__+^;uHPͭYSx-m\!6ϼ)n]wrEkN ?yWxg"rt{ JIҪk YFE;kuI*SUFuJQeڲF(2` FUL;aﯠ:s Op O\3ĄED$%,iU&5,;Mxwfcq_baѩV1FſNCVj]HբRԱ7*+1Hrg@8uG p0NHRmr.޻q%$$$$$$$$$")ay`O2rCk 1,!An=6;t;YJeYk1&ccE7;򛨵6Wmm5q?5f4eKE µyҦ,yL 6$L tZE&*2𩫜 LMg#6GQLz[,Ogmp ɸ~pjXNu:'PD4iM<ߕF!^?p @DX D&2t5kW*ޝ/A)xW]EgMHHHHHHHHHHDRѢBV_t,}nd+i*ciT2϶Nw6`ec-15U5*օ [#r85 Z?1`z+R.,[T.)&p^n9بƠYwͦԩ3tV1DmnWt)ŷlƦ?xFF{o %ݙme̲ixC4(:ݑF4V94f:^k$cH\BBBBBBBBB",a|ƍivYjη]old674L5F)EӁ0"B 8FgZ ¡=F{$ŵ j$cm:$Eqv2F*犫0W>*m$S?$d|3\낳.* [ItQdׅvMJpc|EYJa`PvA c/C_:G}BJT߸:mtVJ$"N sO#ͅ3ϹNbBBBBBBBBB"%Q$k.Y'M<';Vcf٦ymv8Uә0Zf% Mf kcE*OLo "ZTk8ꌀs#V2+Q%R 1Be{v~bRuӂ(IWQl>ha'I$\͒taSII$ڵiX(0[`00(0%**bKVHVM8E 8(huzO#M8SNRBBBBBBBBB"<\zuK/=\J0回Gټv:k&::(h֥āE,b.%(=̺ 5n'd92QGYT$RՖÙfQY= +PC}/^Cc3'aϣ#XJT{)?tss{>Wb8u5/Ti1Tgp$ћS9ZI;&CXW+Z տ(J]|qwή>{Ӟ2s_+^ʫ$]k741c3Kc lKZ7kg]<)%*܌@/A*6$[U H$>\l֡a?ԕs0*Re_ӼJk2b,}·>E1P圇m ýl"U_G4IV3^kfگvaٔON=$" ;k}!cFy]t#j[]RYתR*t77"Ļ6=d!OX*+I{ ^BBBBb=Vƚ4ZyEرE̲v%3d ?OWZOuZ"@^ "2b8]{Ç?K_o|sou3()!!ƞpnu;vxpt׮];u]V|~ǝɗØ ,_w;e9LZ[(2zh 9>mŌR5Є|Г a_h#:}&t@sH:kERQߏ}*u}ސ7 (:%afQxn%%>lzm3`v߾?}[_͊'=5_V.rtҠiKJk)!Iq T|8CkJLBҘJU;,i{_O,iui8`}s#iY0){Ҟ8ǂƏ=о!HJsW_WngqCX[$NPÚ֩+)\@ ssfvx>UE0%RB1BR$-bI ,9 V^l7d;M3a,3$A&T/.// dP=IZiz錘eE-yaamb'{be|䫬z̲.KcHgCuZ6U%(.- tQ)E*x ,L6BR(vL$;S/5BԙoXH7e Qa%3M"!|DuBb8=-{O|~?ac[U4t_BȤui=!>f{[?E~ߑ\rJZ{Lph:($ #aĔ4SS&1eskdy6NK1 XEQE1keD++NJW wm:{9guicl9j,/R$wx>|Zc`zt@ddjaH#>LuV$yD;s.Q DA?ɗ>LGj]UpACH!b/E1@13;u7cbʍ~ l'}&N n!\#pts鄛2y Gh;( Ma1[C^}o}[?ûo{[CN_o~n_yY7vN&3Y^c%aҥ Q>quqgjE]",R@C  ٙ_>2Nj?',/;^:"Ě/~m]XSNh!)A&#V{M69[KS,кkّn1Y~cVc1eضB eS,6dmj{ķ}K4?]u3 A!0@/aOM?2ʆWYv E& ꁥGƹ[6Mgt??z>pRiǵW\ylwccgr km-z߬s>Rd }O9ó]2pfF<$ssw:a׫n\c*ۇ`T&[MJ5b6n;*r ƍOpmE ae]b55ZGJۺUFL\8Aևwmfrڶ=m0]i2k8RdG)E)j/feJ.$\ԁRsB "jNzqL5Fc*`8;41?wR15VƖ̟#H'd|b !@Y<QR[ 9I^"om@ ZXcjXue17'fPV(&Hۥ.NѿWU_֘Ir 8᭵^K48팗̪s9xv_`__ZZaŊbucN9i=登O'}m㳞u\> Z(dd6sd0w=~Hw_&i-vv7[o⎋[CÉ)5lȬtrBЅH쁱rs0!P*f;KOl+x.y?ӘOJLE7}Eݙ Yo_1[<9dY-o,!i`ҒxծH8n#]Jڸ8'GAh?}_K{x17(v乩'˴p#8lLl1A "w:h_drIHh,$ZOkE@ڽ|֥6]+|t,#J-']6v9KqL]ҭS|)[$}RZ8쭕ߗbn/(;H]7xeQ:&/6y6NX4cvȇC:f%&1ZYrAi$SAZff?"!KeMlm/r. gdk娛b$cp]Hx WQW6FVT%{MoTOIv{^"eX/y z~w-K6ۃEm? ㇠d;͖8L.mSV?׿%4ZP wΈTauv<.NƇp-rE"0VP`7|_J_y+siz(@ލO< ښZЫEKAָ$ID&JMBl!jgQöM$E&"iu7d8@\DÂ`kG$z\{{L*=O%$H۴??7?D2H`0*cyAv+ Ԫ֎#9%Pt~[w0C }ޣH!Le- ( i|yaFhё,fQA6)gPDp"J L=똍e+>Ǝ@"ܱhL%Zf^^Z=QxS3yU:(& |Šs 믹{2c?[^B^LRHi<{G!Ʃ;HLŒ@ua#ɓhTDZ|UD@/bMe7O8}з1 Yf-2"Z9GgsXЁ[QZVm,NF}pQQq"AkM[`|m/yA~{˝oy; -Ѽb/;:}Qa.:Q`{cm^"pGmFq>vQevD.Ytyaom+mjUW= T ["͎ݲ^\s֗=6J oR6۔enΠ舢ūE*al{Z5Oo#:Tc+H>(R,>r8u]6oj._ ;6t8~,t$Kpk(vU-/a$|Qoh5ⅾ4) 'H-cTRUh-_*1c6R~e>: $-$(3jPّQjnͶ0j@;pW>{HpX>{C&͏JZ0TZQ๙^Dk-YUQTWD`hPa#f%:eksXAX5,a{㱑GT5tP4XO<~嗿d~yY}%=amj;mP م 3‘HRսSiULFP5 N7t{;e8\}ֳu8?~_ܷHxQZ*3-te-,ctd $)GnQDpxE-xt֮Y5s$Q`2rVnۀƬ^ Jo߲#Zvt#j|U|7Dir1iҺp0!m@`{uO_кg᪫~osv}l]RҨ^*,樣. 5)ŵ_Εlj.:Vpk}>seac~Sa$ͳx.ba 7e^[Wiښ)FZ%xKPM0Tw=kp+SUI#Zym l3MNvdz| `%zAܣZ'Hp4-,G8gҜ;q; 5? t{'?Woކ ۸ΪUc1Ɛܱ)ym87 aX,pT=A]/ g iEI#y9!r'GeeoG2OlA"E0w~ki6k(/Db*ђQ$'~ݟ>Tes9mWH1(-M̕7Ԟr%m]a^Y(<:Vc֍}SGoLY{{p{`,(MvoiYVV53r$Ĭ;rQiTB^0#z6<{\~;\tk8#r{E:uh߉3sQ _pG4 )}7rvMAT쉶煮%:h ;k_QWEdfDΩTJ [G,xIx-(0U4]*UU.6UC6)CDWfW2:~Gq˻/~C}v~ko=RF&ĭOfyHq]6a%h`wPh1 G2JpyJ;7ne;~x[#~3![gҖ"g;RLz C?ײc}k:=g@Ҟ{îO{~avk s``e.)sգ{9ͺ#] t$ZTjʨ!mGob>O!_HLCc66Ғԫ.w$`{p2@#3S3 @ƍoSFrޟ_=vCr둌@gg}}k^{0qbT1n{O e(wnnzQmu",Om"B3_صΔz3t/G6r`9tqG] /=7e1sʁ/u3d!O }agKnsoIrIAU٠HB0 *w{p#I: i~]2{9TCFQ"I?{fڀ3I~58L$kLp:"Gˢ@01@t]MhM@(r㱝A#u1Rϙ7]BFUq'>AX9r'nWƛ䮮#NXXMD J*{ئgUL轴%bp*u=΄MR@%VFӾ}x8|ۊx} $)3{\5XX;?oY 1(Vcm^ЀMִˊ3?s\I;ZyOS`hXjНS^ xQ97]~^C['YH0N؟tS򈰠b< ڊv7U|J;,AcL GL]HܔzBakcɵ5hl3-vT5i s'&ilSܧw-4ܻetlJJQRz{PL򞺮TLÑ6%>Tg& qmN0 JJW:[s5xҢp4XۄʔT:?v35':GaN>]+ё/[;ȧ)1` aH0:DHӛ|۰ʲ@ٻhxG|2C4%h֘=l׎NDx&Xpẑ֍M c٦i415hLvEo^S}d׳hDŽ'4@E'td5R1 y,`/z95`F@[Cc IB \(ߟd⃿{{^^n$4E66S 4sfј=[EeK̭)Gg}L0v~$= &lضVoc~bK^{^ǟi ] 5~)ivz_Q7kӋ^.ذ;T:mC^tFr9`Ђ~MzG@ cv IDAT A7`'0~/Gxi+یsڞ5S\ʅõ}Mm:tIOѣdA4PH0.дM0" 6kƈ@33Yu-[m],`)&S3AD:LB@wDH3%}T}7LRaƋ96eks~4fVbq<:P 4/1vN%=,A*| 1wc7|v+Tݸ>TBM$|hƥAfsq/Ph n- hhM R[MX~4 ǜDa:AB  ]|G'wʌb%r͇[Lq2/ fǒHwv/Y/~I )WΉlu,B4^ܮ.f_ջgv.4t7.I<Л={ٟV@żeoFJ>3x@xE$:F jXmjDmbCkШek.&L8Scj!' ҄dRq-N(LlN|Y= -]6V5IOn_] 뱢ı݃Pc|d)4ڵJ[ITg L#<>mt"P@PtnT8am@* ml }Ae ֶƒ{.D.F­(gZӅ2aj$0 Cg)!W '`xw ;?pS |(*SR%{1G*ڠQwv?9W ~qfϞyfm堯N|_EQ3rop<:ºvikvL(0i"ik)JX[ |Oվhj$G\I2SX2cѓtUb`|⯓ѷ=-"xqwA11t9u[}3YU PLzac.?vtLA.&&(]23t.Xu۰:u@A٢w ˼yC1 "`֍Sk0:nExsz#赥1{O-\s[Ed_"옽p<;z J-AP;:/0 on*UA%Iӄ nj S%Hq۶.Ў'?-8Da8D^dh;5$'B۶qOϧ:V/69rY`Xi*$$ B# ҨvdHDz۶m;poϓӂ̫֕ߣ KF>`]r[gvzYWyPB#Hc_&YcZ$ƿgڝ0KDCLuYJr14tsF/.tGFϪGN~D)Cl8TfQ-BTH 3fj"FvS#S{d}m#IMe<ؕK ik{w;ٻb']®.ʲD|kz綊qu hY9Hd'Z} Anj!a=Ŋ,E:?$%WjqQd<ΈHqwhYjܤ?(Wy`lGcJvWg>[jWU>L}Pȸhh5-HDR|,~ǣeKPHag>`1ES9(m25 , HqZD5FpYǾxcƴ|^܂yg0`e!!KӤeС7|3I8%ZK˰1$[[3g"6 &T:2-ԙ3"l30a\O9c6z3+'>@ҎU V2k5fLM$>~]eMX C7w.]I?z;x,"3[h[ZLv8*LOO@lPWz"ư Lt> [z`q'lxi0A+{{,oPʙK5 :G#hEg $0|Եf`bM']eC]mJTR_'I:H9mNպɃ]\m 6OPfU^5;.m@̼r{{77'RLݺQ@YtuZ=ʺJtw;ݢh1pԐZDlizԚktb Z6HzpQGj<Б6wk~i OD|N5h $i# X\-..Ǟ7k+mǑ뫫GNKf3Q@iMb5ch7!(ʹr{V~찘U H]D@CFZhsPc4#9ảx)NJHP[tc-.&MZ#cr.w^s/iU}l8I+8 G<ԙń,CthI;v j]M#/qK]kJ~K`VD(N&ZhH1\G;`nUW}nN)^d' 5eV1udJqiZF/:z_nkK>D7I5c¼{4(eСe׬-*y0+:2܌Bhٌfs\Ftښi4q$;qp)'EI76*va-"szg>?Hyz5) ˪3J%h9=j:EttЌKe.yFSra%{υ[=JZ!ړ3{/a~.t N 0xV|IYBDdbTˋc;$!KyaNYn O cӢDk?2w𢟼e/[s@#kRMDeuFn ;/za ( wotǁ4Yuͳqp f0ˢOGuQsojec7x6a5+&pwnV[5Œ0] H ]YC`S&cɭ}YtF6R1`l;g\3SlqٻE"-(#jKGQHQsRh|k]F"2752x͹.G+09h {tgi& ֔@vO*IdFCbh3Aa!pdGv 3u{h_9#j|$K'>n%VT*|?s`+zn= M۝m ;JZOȾ5L6fMgavp<Ƣ„bvQ@R`ӈHI$pl YSf^S;}ֿ:MPzlItҌZK=M$:Y+7 '-@ObMcc܂VcPŒ-y1 ~X𜌬>g{SnK ՚gGJH2e wq/f`+!ϟzMu؀y0ePXv-lF K_3[$T8cǞ4RPgm$hs5߶>㽨8F.oV2E P F7ز6PNH:f)@Uqَ2"flye f-o4fQ|Z|pq>cB+~8b7f ӾǦ}jz$PY+јZs=ظT LgkxA#ߛ}iasY95! Oŷ~eyNHU$- I4r3+4dJxL:1̶`wW AH3 [7 wuv|_KT)Nk]SNF( :"Fg!hۯ=s7Xw*x^*K( LդS[owzY4.ޞͺEms@j-} V0BUgal_iPQ8H"B19jA; u_ vz֫OK0L򉐔vzCbAj4+ew$25$*XkjP5h2ՇJ~WwN_I[w&ӊȔ~=#bzL&aD˙}_iXxR "X7),vd'urrfDb۳{/BA#ʼn`"43g*~ٟ/y6GEQfgJzZ+_:VnOX9k}ߞR E0s8G53avLye0IVk/q7zwҘ+G|q|777QuEq Ȅ5+,F5po e;Yy jaT ?0t%1*njqAR_{֩8A 9$}v.pG33.4W)w#% sgQcU4 Ɗ&`ے}8i욃X{rkD( ~&NcZ>쐥Z?|p̮tŠYRD޻bk>-,tNg9wE_,3y_z\*!KV E+1 2#$: Dx`.h\AQܮM P&;J, Xݬ nK%^12m,AJdpJJ BGҁx7ݫ`; {4޿?tiht\du &>i3B'h0ەJ.9 it qk 5{ @QƮCj #"De!."r45<:(-LKJWq),:f;ґ38'YU 5< `ll-5v5vz|Տ4y{]2^HZR:S.z˯(] mF KT4oGǶ/4z`?F]m,zZP)>)]323w(%(Hg*!nYO~$3 xOm"պv )qrbwo'$erR54 ob@nzZ3Zsꪹٷ;z33kQs!N^ )ݳ淼]Zz=!55ѡ/NBnm@ D!Q1mBQ%`d ږU1O& gXhŻV.AAfd(/7U2etŏbz`>x<^7R/-UR'1lv{(ӱUlguю"TLb+iKP&/*|&=5:tT >3xs"(G,#rX+ !M-l g+$q2MMnӆ(fڸA x]"d*zJI@2D;+ (5MO195(-AqP=֬@VHL6fC21Nq i=zw>)"N5h+@~ #雠-ՍA,&8 QfY4v0r]ayuտ*h&XX-{0D^UM;xL|2w G0a|m)el[C/6Vۂ=#/LY3lag1v`mBhI(d# ӡZcg~GdSڢ]e4#EmN U{< TI4ZeriϵgҞ`;|v=9O?{}ofhݮ ':1a:^({ˋe[=}odUú&Aiw uo]6-;?yYU|/g>p}iC]Es1vhӻA!*Ɲ `A۴)1&kj$V`Ut|` &]NŤfոJfߙ܅ $ݚNQ74>YK tjsuʢ$v=lz-=6BX=ODI4(ӕЫ /AW;1kE~v6b̍XS gHP03s5}{p@QgKwm^ {DY΢Fo(ZYht3Nî )6tn3t@6O!H"9U*Y4us)o<t]"xXFĎe1LQnք4Ŋ#l߿ qV#65?rdí4־:&8aC()K$iT`@< \3Md&e#߷]O Bi f\~r=4Oy7II6&IW ިœ4qFirS-PQ DF7U]2`CRPj{Ɓ%#ܴL(XF&v6b=4IeM?a%"N=fg40.X%AOZ"aeВ%w32k!P (&MTʐ'go*3z8}13?_yS5Н6Wy)3Y)S?=2o(HIޥ hcEȲ tޒKDK-}:*Q$v/g X-on^|EMO5u;Y/)v婒JfȠut7UGS+@ɂ NB뜙e V 09 $y?П77[J^c!"٢R6A,/*fW>ƪP7_R1iiRҞM554~J+Ω"pjJa . 5QU--):  :ǽl:6J5c|LdP.[O?:aͺrI^+ E*0q=ƻڱ4*Eqf" $*Kز,܌.VVma48(wA"ڰt x0t FcK޺Le!;&F_@M#JE=HY7LeU f@j J8~LڀeőzT 9%NP]10ӼMС֨jhٱ T!; Z}ы'><5a|qcpBlm2FL[azպEi ͐g{Z+~*x\WT2T4IMd9>^=sF[ap"86ZDy :!OZۻҲ[ƢbqhI8"m֭8N4PLX✮Qo W'/mZOqX921Ε}w6ET^5!"a3sZ#;4HMv&vvamC^EWL.Ig9y`~̓=̌+aY+HIZӉ)E;SWwԣZihei:#wstJ 9S'p,%1[ ,`ńIY^SP bl5-ɬfY Y2 'JI\?_~U-7l@WYu19XlƦQιv;Bt(>xBޔS |f0dlP¡ymKX 9L'toW&GYRoZb.cC6}$3X5sA=0xVǯK@ fjF4=w tIV ie#p7%gF16:P*@K]QođQ\I?_8y4Z2w% HQmX}W#q 7NPT;6޵,ȠF-Y-$Բ&d Վ4\'ћ߱ E""yN[KV @Xڕz7_ 2:0.vER MZ2ʭUM;Dl͹F dz(߮oT~ ~Օ򋛞km!dkZx~IL&cQɨڛ"_>kIZg34f[A zO) -3$ID"t)ŀvbR\ۯ~ҁΝbgGO:ZqA-P\"^9Y!k]x| )_qĔ(iQa"{ 3ahu@*j%$~{\򲰪LDnZ##ɔ Hjcq GG?/=3 d]E8Ȳ[}@D pZ64IC&d){m RξF$OY޻@am=>1Rx[XT6A6sC;v0TS1Fzf@}BEzP1%P9/|ؽ7N%,?1 s='y]?g&(L0o:=%Uj PTbI>MŎvL@v|Aݫ8)r/x# {#IjޤՓHc-*נtN ą%}>-V#;/4$KKHFed?/ ?˙vMJIT΄lF߼yO n{W7g0wmƙN>;` YN=r~wݗL LCiҁ`-i3^Y}Rcڝx]wJU}䭠&P.{(F嬪$ژNxEKbVF>?"?}l71vGKM5u˞2f3ƕ寥Π.V:0%>5sFRSRucz"7V|bB9]N5{vxr9Th+؎*QENJ&.-uR cW{GW񫣭^?mcJcQlmڋ G,Q .k>(q9 щn9tϽ-EJst莎 ȋ,ny]cAԫ+"2>N-5ժ kM&!"%p$fkSҙ@XvӼ  "1GW㥤!`_7VFDžŅ`?VcY󺑽ܬa ߭edS6N*_=z_ȏLJ@?H Wq tˆ"Ȓ|t"Ƚ-ܝAsYv 5f\lF)W"G@fҚO~FF- O DʞU=U1YI%:Ew8?Rk; "qݑQwt̀/َA#_JmOH}GQdY hjYRnGiv*7P񉏿rv~FH,r(3Hl'Qalbd۳Gp4:^W33OkH]W"2&9L֫Z^9zttU_¿+ʲ'eٓBJa͡}RW+P/Z d9)zo{>e<퐭kY B5ڝF[ܰ˫]3'iHP魋$ؽ JoJ#v^sՃ]ioR(- jQ3Twp+]vhͭaAŤ;m2ZZ= P57yfY9 dTلS:N 97|$x,(:2'JwLS%Z3ԯ`:^"RWO,|'g㽮ZZ۳25ݛ'ٔ.4@TJAm}FN*V)w͠R.tHfQja~/걈, }B_()zwRIO;f=1#*dY t b0G@p 5i'>;XRցx* Ȩ,b`:[jz 5R9&N܉(#uUr^ȝ\?")EQEb"ltU`އvTlY Z4]]R Y tb1lmvIIl-9et0qrfVq]ܪOD' RIȷǬu}wUP|"'((JY.s<^Er!@EE^9C4L‰0:uG4vͤm%Z !({?]޷N@d<˂sb+(GO}ϼ<;v̰dha4q7l\tlf~3iBÂ*4죪щߨ-_{[=|JDV6ߜݻjW3hE~QSuqyvr<oY©FƄqCشUToF0" ;úխ)qM z$#Y?'MU DNlD7ॳHw>zg]5s^: Vb;\M=i/6YxY@rU|cĭ×6V͑PE(i4$;)Sly15X)3=qMBnhZ xAN%Qh}LidnkIf.N^]=r7pO|yp8eY.Oا((ke5x\VWUUQϤVZF;>vWEb >g>1sMS8h=f{?_:i0`Fh|ɝ0YndX[w {z$5G\a]IzU*\;z/e$^vi9|#{@b[QsRc %9+@_9RY|vFY} e\xz@/J^PLx4Ro^{+7;c rg #1 m>}nާZ\]ͪZY e\^Za]/\WKǏX>vZ&è=W{}zsEYl#!z>zu5(DPBu]({((8Ki]~?z7d'~$:i\ڿرADNoFۊ;[BjZ :3@(gg!u5s 0l _Lj9T18 @0jḒ?BwVr_-fd nAT^-e]_."?S BSͮRlG7;_4L8+l4a[z]㗎d ];](aGw-=8ۀ`|,vv:,0K#YəA,Ky0_g54wHoq~a }i@3; hK5]Rʹ"򍭾;몢'k)$ӷvpA$iL¨[B֡ ĐXsܑ9 +3էKOEۄ=CBJdLdj$/Xvf\13`qE"K] LK-fzǞS&7yw|G?SYKZ-rkE?|/#e +_WCQ:[u~`:=*'H6/3IHi z~nf&D40Fr5cc0-vЬ+~}l׿^W"ѵqѫ_qR;Q}!)35F`+t̻ʼn`Ի$5vӎD%jr]Pi$jqqmi3̔!m,Ϊ#FΘɽX\O ~wxٔ|;L}ӛ> CspR=dD+)ť?ߺQ :ZT;y;"(кRWZE>W++7$8$1Fh藞e2JN..iY9uVIw|g>??mQ(ZՉ ?8!`F, bH3RVGd=Y`|IhcAe"hf~:F2ېr֭0lIY>)>)v6DlFoyCLrB]nZ;"T՝G&*_?24ZukK׬R"JEP%K6'fiMqg P?lCQcH$r7"rLDZo]PxFBHJA+ge˓.9'?bsXWiT023az^X6[A]=mpG?Q$I@ -j|ӫ`REI%T:iXzIDY~Dm@>uĞ^w'`0"kX^gw\ҿÿ_o0ζKuul|dJɱs)*91nc[~a!"r5X`]d9{,zEw`Р7;,sjJ*Ih>[R33^W>淿OOW=wjz:gPiwwץ?#$)@5XwG l z`ie?~hq_W~Ӵto{E""{ӛ$sR ױiF z/lߞak6%rH]ځ;M@AmlZXwcrp@H93|yǎ+0 Pӯ@59@a'J)ep/K)O}$!"JEUu&n%Tsk ίgc Lo3Z)ҒTRE*m`%akbREe?ڂ +D cRy}gmG#~-q}-$uD)n, _ IDAT̀n1nև@E!Egv VӸPAV4qf("h-Ej ԬM9`d1ڱc.}Co2?lsvw)v5) 5Fmi;k6i۶ZěE-^L +*"iLE-tp {ct#3VeuE B5g2zN.Õ4oh-~SO.q|f] Esr&RąpgoM"rx1`G!͹R v0x?'RQy&P5N YG?!"$Qi9/|F).{3!)/3WOzRj6Neлnxqqq}{ǹBmo|j_>EfUu}N+q9V^?[̢lpVF_iZʵzxpm]m i3Žfgg ֕4m7D}s'{Alb8xF Fz(U!+ؑ!s׏>EA A teqTM6Rc2yoȺ#G6.VE:] ap3"$1uI5ڬz<_:dWE;\_tjQxF;ik0'VvlTt!W[Q0t t_5XIZʚݒ h-/P8Qg*8ڱ辭F ?z#/?qe,ꦿ!9@#VMҮvNGn׿P j IJPه<)^Wxё3$3g/[u_\Z?&";Wx#Eb0ؕϡa8EzA@0B"F߾7$g靣)MKZIxȡKYL8gϊgzc r8|#"T%iG$"y%}!ʢ}lq@4= 4nei;Z^.\]Wq6_Y4]u6LBj!Fel@CY^O۱7oM;Ti ?5ж=v~ ݒrA<}6hHP:K|ޡH64՘A7֛xtQM9p#9-m%v%|6#p!?ɉ`^ZRqΆsO9/Q6 Gr6Thm_FL9~!cNf FyB+"X^\:HuG_ M:3G}_rz+,ZY#MqmcfBJPٛP7 dѠْH@-U۹dnJb~BEژ\ҷw\xiaݷ1X8WK)Ҍ[I!dvZk(SJ$M_+mpkd mBWQ\hܐ 8$&E'Լ #YZEeR|s "gէG2ů}w?W++?2Z\+\/f#M MK)%,[yp8۾ͧ~ i"sqPR[%M:'iMf\9pHݛU%k]֯گh?%J2z\a6HڟH\@.\4ԛ}CI8u9 2g~97{`O.VI-Rn #s&UD7k0Bu$ʸET2^YQtQ 7Kb,$(c{PwkJ'o\Ǭr~I )%M Dd, Wk1Sm&eAsu.$F2%6#1pղp36pȚ7ӭ Rvekm&:~J {wP:C={ qLX`)QmC۸Poĺ'E6\&8:oU7T+,uvׅ> ;kZ'=OyKN>gv~{ 0[G:۹L:vƋBʯG=~F 鰨x^ eoީ9XxM':/RN%?>ůy`sSr>vn'H4zT_u=__w~7sK"hwbzgj^Fې!)XDuI;K{۷E,`I (cZƁBBZ}aUUU1v(<3z+n 0YvA-0A3TsW7klcǔ6B(.=ȏZ{L[Bwn`p\Yߵ/?V.8lBNv-zS5h00ljp!Rb{~hVJFFφ!nРYzHOniM^mUK/!1ƿQEX.PG61 ФCvu'?R z@&D )S2hn`?[`^CJUp=W~t2%3cpqJ7WWl(3jl`Q-T̏>c׷^{n{hi"5 "yOqȅ Īr`8 sCo4]KBkړ [9lQf)gдٷ>X$`葏W/˛^e8ڀ_Ĵ\@.\,ܶ+y&քƄ6*&US:B|PHގ3f^V>#@h-~U$ٍ=(jDJ)׃`v !e6RW GmZQd#luִi ǵ/zQk*m[@֟& qb'1pC69FQEշ-EFxĶ]]3t<پp-"HI)5&{cڀ.7Y{c؋_p|8~F^e'gůC"CDj^q-2Na!.t#mЕ4k6dːnAV՗ _њ@7%O7HQZHaxLA~L/0uG??UMmHcU"J`;3)]`>׀u}j Yg@>谓ڬn27?ى**^4aS"JHO5Ӷ'8;l\Bم/ itDnHHND Y$=۵CT~u`LBEFE!EY@Y^u 1KB3õ$H^#ƄL?hV$E5 1{Q&pj!~Xs7[=v|D2PfMLr & ZW{^pU'YWkdx|uq]"z= Vp<k)Zrn Iqaaz :=!?7H:QqX--aEL)5 i$B ]~Z J9yQbͅY9{~G8QMUβc488m20yK]U)#}~LE0t~_dZ9Y{ED߸7.ud8=2y9Ȏ< :@E=ZP XK<\KC\o˗ \8?;?X1qċ@ ]u~Z^#xbvߋ_|iJ](1 n:F"ˏ6x ˲˥Ifp4FdIF20"ExT>倬@f%rA&uIO=)`);;s7ڭ\,VAkCŀĽxt{5am]$B+5sPhؘ LM@"O11 V= j;w^Yr[)%N $?/tkӥcsbL8 /;Rfٍ+X|ɺ^iV 1X?uM ^CGyWaԊ~H:bʉ1ڴ&pE6èՉn/Ai*?]d̲o^WD}ھ͠za溶cV('bx`bk}@}yyze9G q5Zqa-F"sYjuV6߱Qb/(`sAWpYڲ=Lj\*n/""7R_uߘ1xkK Rh-CHfM)Aǎ?mvd8fK[O1hQ(Y-+z8Ռg1Bp:yv^~FjvKS72\np@R9<ݹ3i0uB44Lٟy8x-w GlVZQB64T9ݍDBޅI>՛u慜KoG#Y=vL$٠fP9LɯbQzW itգGq}9gNXMN4Ih=q(gDkj;E^`.&u*No ; H eEBUzmѮL8i!rGaΨ]G`ޅdÍbl EsȚpzh+bQlD ?["![4jsʙLmxI.G8+'4ˀ&DlMV|{}ϥIQ) XZi6,[:Vt<2>n (f´) "QjLV:-)m;s|T߫ǣHOy.4 D;0MI-<$e xn"E{97:g>*TCց_jѵDZw$I{ EK䴘y>S)rJNI M:֥MLS]*҅A9;{]onv(E f>)P-uۿ$aEEn_v=κHr6Q'wYy/hHPA@),w:}v>xu-ʊWT*?(6"6裥Ǩ<ӧ3n>Vz}z8ήP%$hzuZg?{.IzEI:A?uݾl|"bE%h~c2-ٶ96LHw t2p{y\1EV:^њ pj.a=\3HrS|Yj<=ںaiYNM Ε nQ(z%&cg n, FgZVK66Tހ0q~$5W8a\FL~밉 6u12쟊x 0aYMаdFLqҚ_KWkC 8nhE!(6j FLxX@ldZڇ9+[`AzX*Vm7](Rx`̔9jv@>hւa  _Oz%+h#a FVW w3Ѯ Z(K?g],˪2}ΉGwQDTD߭b_ *%O g=:znu W<,ZJP*/@. o WVU""#✽wךsω̌̌=TfFĉs^k9;iD%NQ;\I%tggJbrJ9DaAS!-O?f4Ғe>>]%&|TR" iKH4O߃-3:M#gSU_3u>t1C75ldb>@$˵,p+uZ7m xXWR[_v 9A Wa<ކ)nhm1)`B/{EZ3+]<Ƿ-=ꒋCqAסvi4>#\Y19U9@6LƞəM3V:+;^e &:,|:Т9/1=s,/욤δݡ`m'#+$:ƺg,ϖUBŲ4fD&7 Zr ,G& Z-!La#I%4ɏi9FkH *JfaT~0.mRbm yw: 9 1imRuNI;0(d [`Fu^FUDHocힰ9#t;nZ*JǍ$I,Vz1Elڄ]@Ȣ]!-4RInݫe3!R'C3mC,`J) իkK#;o?YW_ L445V,HG.{bO< )286u@*΁jX)}%"#OONC+Ă'[D64T7 ɴ^ٵ;*b 㕠~RƒiOX2Mr57Y7 bb Zz$ԎRLN4I(N4W #HT7V`ҤYUE_f"0oL+sF/D;aTmVikjmFLLΗCeec (foo6 v ^NK*:A"0fTm_F9qH[qv|;'$M}:v tO1n3s HZX_\$BGoc:j`fa04eNkw[3kfը"i2F;=h;-D ZNt]"ёӊ$׉zʣ:GexV>s̰ψv3az{ZRgy.kƱ~nu@a,I0$C?i:z@fG%0趨.g5[17ɊKpcJJ8PKYɄ*|X,5$vžGDb<^sUý 70ޭJsNЬ,/*gx A墠Mʣ IDAT F6Tj-Ukϵx!bg%9Kre4lM3]yɧ5Ŕ36LucfTݦt P$VsRm22yRzȱ*"g Yɐ&ߙ-6Nq*98ioҟ2)~ dILRʫ].?WoROR+1LNhsS錧k:W/QQiqJ7K>6L eolEL!bI/(^æ9tFڪX1[f<%?'tm^9@I:’;rlw;f}9AσH(d sjiCG#'<*IKR _ Pi].uSp>jn yC"> iy/RH7KˀbpAd Tځ,ޥyr`tu C\mL&UTYBH'scE3=bx M3yP_Mo}ܷl&O܀y g$ Aan_fQȑl#rJ>!,NNɸ9E$ߔHI9Rh&.->+1RTdyhN8Iɀ/!;AvnJo0iۖpȝtQ2QPcEPNVo"64:4 Zȩz6Mhh`FP"M:4 8-gV52س2lI?K~'H66 ovZ(mnm_\XҝW UP -Rј m6E )AkVQaaCLBXllq3DGoDaLGu7$5&(DnU×b#(Qb2u0AFu*ݾ 7XRG(ij"nZYG0;k3hBsO&L-]ofGG"\" fy?XpTK $&$85 ܐSRr螻Qf [r}{vub zԙbL6©E$U+"1 y h 2KU p*p#a guFfx)qK;@Qq-9S&^i6L 3jT iǂxG8JjQꬡRb(g F`RRʧ|}" 4˃I_èĉf+6'|s SNŶs HB1{e,Jq 36Gh:ajjiQWJҭzyht'ZBZ_T6we.e>YPp ŠLdC0@G|@rOꪒD& 5$=I\RCD^#:9L4Z\{n@y@ک6=y0E4wp\ #dM?{A 0vJ2 HEzrIJF(H-f-qFUdx%]\OGi 9J2aG lŬyX&J*]-5=ؗŬ0Jm i/q\̀]`i 4 jvF΀>tU2,Ԋr8J(dV7sQGԹzƉVfp 9 kظu:\ ^# ,(3mFh'>:˺i4˦$Ld@*ed0  b0=|3t*4ɓc@x^]2AL @uIWe,2J4&h6 #^[Zů(7:rWn9ΪuyV!DE*)BD.MjW7 c H|6Z޳bׅU +PHwC-#t-w\ )kbl"ڭV/<$9 .d+(EPAqlr"A@_%A++VOȝZ @?jUZIǏry4j'7"lH؛)6)-[]uS&չو PW&H!}>SsNN~5Sٽۊ7VvT"aR1[ L-v"Bö\4@ks>c xO3јz0֠q$CLS1-3F9bhfP, M-b}2k99]bɜ3FP6qHLYf;RU9@Xv61{îy!7vF) .sort> e:a"+b8=KT^* hmRunI{ˋ"ꌘx)XuBn`T@T( [ہ5_t 6`: (},Hg!Ma`fmŬA9@ N&]8h7aMeHNV'V+cZǛ IZ~Z/A9 Fؑ _dXuhm(b]kqO 'ҿ8$kceMMCCs:$`&Uiī:LE`m_$;] ;CxFAUa=C ؚ}HQhy3q>\F%-g㉍Ii)/CΦtJ|i_8Z: f>UFؑlD4$6OqۇM#H7lueZ͉xΖVkv֌s[OWHoV RJ" Pp,TUS]]ND9̠fjQ6HQ}"MgmR7t6 X = l6 =&vZPH ky8=Zibw ZJ"05A E}3Z\1MMw=|4$m?;i$8QJ~ F_l|nLQ-kUBӼCNAdBO8 %ob+AI^TtP~9uDqF*W^@fCkNu4UK+ ގ3CGCzbk?yW߽f-52v YNV1cJU^=W_mЛ)Αry@wd(<) $S`uK$*=LKТÌz8g$H7瞑qT Jލ18C4}6 TB竾0>b#94D22胰"R^F(*g72Q0I#% r5RXvGG+?eSWw'^"dfO4KG@!)]h9;Õ*bxy; !d3g#v@ EDp`J*j}SCQf`}!dM#$J Vᅔg(&#i!h#{ڀҴ x'oX=@*! )B>x6{70qE082AkYd tOV(}5FZLMoŮ,L}{/,~2 M-雷IOql ,ގ=W]ۗEO~v9S*b<:a_D]Ulm_g9T EwROA$P&kqmf-S90 ޚ܆Ӣכ+柸~`}굵otSR\8sPG٨IOŒ(IAk~(&g4UDQqQ_@AqT~NcS`_Y߬W>Ճ%5 8'Uo!Ag?s: _HB -gNPRz6$Ĩ$VC)HL0%ͨ }O#!ki$!Gӌ'EM*aEW ٠<( : {kz!sP20p Ȟ8GY7tKfv J#czZ.1N0#d5jjyԳ.VS B TaҮd6Fb`/ٵ%ևpNDplM#t{" erҚ8%=KhahJ(fH5f읍\p4kkўZѥ,vdQw$1ׅeo ᆭ޾ZY>w}חvI}ʠt=AYܸԏB\P魕#پH:ve,uՖtMv,MiG 6tb(r/|gKK04b2&zЅdX֍ y*`1aE.MVH ggf8vjTO''mgNLNbEdp`26SgVYkFwX7!x8Ql:Jfa׵f'azئ|w&{. ŠssSZ6D6J<0 UˁL"Pl|șfyNbrLʁFG@dq [ĊSiɚ ZYFSvJ&sL"8NOq 2vTk_c!P [qS8q5X1?lSI^ R,`Lfb-DrNp ŕ `RŨ4C3l3qsC. &v{Yy7\4>^Ӭd)'P29K ֡.9s3ǞyJ Z]]G_ Ϊ @Ym.G}fL ŋ.zUye]$2S;xݵXZR+Hھv IDex_RHC)\`..d <Iq6עS Ǟ Wu-lqRpRL\2&a`4Y <{Qq_AZ%c("[#f N^zwsT A eC;fm`ɦȖt.B2Te"I|?ш&KutŅqQ.nf~K)F>QUD9ZP#PL|&L#66̩O}BDS¡hË--ZZ)=Ȍފ=մq Iy m >$d#M=-e åA^]}:gV'Zd`k HhT]it9A)gn=%=d:D R'R$dWMwN^/. f]5ƽMg0_f5 CF93 g0gRu] l uȆ܂7pqrnaj4GnG'yD|ZTf> V!8~n% V5`7:AScu&wguI$+9oے4y]2FNѹ:xIG"ZE4e(,ڡC{Tf4j#=?#*{HqǑ(H29Wh[2yP(93AW?꿧VXsZ.(vMZT~*(X«̡. ?pWQO8j8ZFJ9Q? VH4*mF=t<hƉf=Wl 0:-U xo`q)Ш< <53Q8h2ƺEFa&o JMܞv5^;~ w=Z]lԐMf]9e[_ّ!x"h0&Z# ɞe瀇xo|_,bM@ْs22sǘ{SE e1 ѭzE- YPP Fo$i@+zz .eYJ Ümsi-fh]Yx<\ݼYөe(ƩvDDO1ڮ۸kX&j & IDATE5kM%(`}Rs{vfg@`dqR }8 ؈aPh;*Nж-^VԴMfD1n p=(5A!716@:'Bx˗][W>2}1opaT: ǟ}mC+HzAȵֳLV[+QLP aPd̷厢rtUT{;%j=z4A=lA(g)Ιr2 6G5VD\>fE.Cw0n<9{ GIc^yNf(pBm#jbK AkC{WT_|o[%f{ɰ  :(WVv?~ի_}_RY$HZ9Ml{* 0G2%ZuVIE<ړ,棹RBnG0IHf`jKx3K'P@ENźz.^`: ぀` xD5l$[Ku]7Ѥ3>`mEkA1uB*ax j&jDr0x&Gf|RҘhB3q-5jOzK''"2m ^yv#O! SI3H7 Hi].*^[@I}caYW)&QTc7,"GfȂ9¯}6B1P 0<,Fϧ(ZUќ Bؓѹi,HUj@Ă 1L Ͷ]l . Zecyנ3NKa#UŦxʇ;ώj-kTgUYFJrtؚ׋yFP 34XR * kus 1Drqu`Ϟ^W\Wru_%?a~nL>GđILLtT`uI"lݑDgm98-&ԝ'm%r( 5?7z4G࡚jLIڅM1)&-+"ԙLT#9~ (d$ \VXB12` 6M k <|T9 ŀѨ˗4 \9Fcn1MrsSazj5X}vR(zjMrIMcw R%U$N|2P`1aJ.6Ǒ#G>pY&ƵGڦuLh1ùN{61N~1 "hݦ@%ra࢛ݢu ^8W=bTB4 º:^ʥļ X8m|:&T&zyiEU OS`aSG32sՌFtܦ#'$h㓺zOwQT,#3$]x){!E7pxSTZ"O=I( ="p((`rLC8@ j'T2E:tnY?$d2sãGׇjGC}Y$\ZUBK Z@3Xb!@! dүnڍA&^ul30oZ @kږFq1wҁ'"$|ӺB\P,R2(Vo`hQ+q-=/Y^_{FG㼭×L{ @2I#{TdU]we$΍K  ٕ3f hM5(=&~ر*#JF}H9E߼ͼ觯}q,l\skC(ь6il΁ÛsIej0 YM,ý0Yy*ozSsͽ^Y6M1fР,]D4Eq1.ѭՖ ї;/e]_Z}^~GoMK(HQ ߏXqݨq~*;z;eW!ӚMM ˌLݧqu}%!G@@Ju|延a:mo_kz;gxtn2|eΌbsz>&jZV7N>Ti3(i"l8 T' #3lNaTwj)>:6F 3uQ ~At0w;DS2}3q^PpV-'ur p">$`|ħܕ3tƋ7A߭CW9e T'`!+]dH" u2 L[uI4IGȐKڻQH|q?(頻F(xyL $lbXUٟݲx|/榱U}8MC̉(Q]B2VyBe׿@Sտ/$C1%nPݎÇom6pR7ipicdIp”ѕy^Ÿo?O\_ڒH6Vkp: ,sDxb]sP|>i 0lM1at:Ǧl@iה^;i"xLXf4sȡ "65 )rN(SׇZrCAc)0e*-aIw:JU%B'~l -OJ͓ '06mmFZdgWBݐMEr4[]1DҹL:b6Z?fSUT'XqԕTٵ q|2_t,R&e׾VEO}3t{7r xs 3v o?/ߐ+{ bgMf= |N3KEz$+4Wvu}Mo{޿5"; f&}2.rJEϸjeJ|fs":fNwbfqYru-kM 0s+Lğ3P`] 3P֭woCOqHȬӜ =.^\ I4Ǜ*"5RA],A9C^)P$.7EoΧoViޖR3~=NL$0z˜^r' BtB|~V_yN5h ɳ`c8<ȗ7=&wEM+TNafL4 V~gWu أuC$/Mױ(F`0{| V C.ˀȃ,McH`}k7 R6.Æ%ΊFϔ3ϒj%ipec]97nOV3"U_nt|~$qҨDq18:~gU( ݳwO?_nE/z%/x%&,SpDQl"[ o)/Z ThfV:sm=sڦݝ1gLiyi[:$YmYIVrSgw?^_1Dzi }|Xq&˻Bͭ'F6g35 jNzSЊg>sw^EZB5i&ΏBQ*~N_Enï}-oyϦ﨣Ǭ9\~o,."hm+b9qF`7^LkWv-鉰9{RIKd'2K֡RS&UF=Y}RR'0;?ah*n;の7Q Л'?NhN%vdlU;,вS.g;h 9߼k+_ꎷwi݃ڵ$ Q%:g}|hiñT*;̬kmFQiR&=S.xֳ.`U}w3=IPp BQ_ 7>[H)v] )ӏ)Ri-mX@y'.DOU_Lw>b7#cݓZ$'{bԻ@)N. bS .or~~EBDdS袰͓,Vh73b0zJS,Kvn[Vp7N^wLY(Q9dcbZy'_#חs{"l"z8QEd͙ {҈- )~0aF `_VV]gss۳BSSY;3]@oE2sP]"w]ݐ fGvd*M+ҡDFnIg3$UuFBηFrYdf?h;@(?3q뚺:ZW;wI i"-@fzҷ. '% naJ$̔5㿗&&u ;!Pgj~t!Ưެ=pxvj$ƺ!/B'v1N1 Ygј-G{RcJԟCv\MI}2 f)qңލ0 A7?.x6- x@rֈU^gH5\/?xߎcG_}}9VwAT KCAT<>]J4 ҝ. +(_׿p߻w˦I>}\рLacl4Ľ(N3vx^۬y޽߇~Z/b/fTuY0=6uRU31ssn[9j3ʿ FFtzP%XFrS)TP(9)Ber'rGQ E7(P9Aawڗx(6A #:k.61BCww]7!L> X~Ft4QxZ@+^r~ o-E\c@X3;cݱ(3(fōF@,Ho{_g=뿕ss Bb>mπ14 0ӞtD@1oF:gc'4Lm 1JTƥ"n$>zm{j~>q B#3OC0[TT( xe9WO|ЃO,h".$"IWGAFZH&tTe`uBt*kcTI L=lte?;axjr z~S'nAuyc P.pXwE9 :D%p0H)"}jMKii؀iȘf!(b[}K˛XX/{ԩDp$cx)a׶>㜈, iq"" "`4+K// ֎//ovut8~נE){PZvzhb2#v-r9=T#;ȑvHJM=&Ti,_gKb:.}{ot2 1 XM8tX͓&Ip%v#Q?֡) >rhMh$?( 4玗X#1瓋!@}[ްi9o^Woxï\ʗ_Zx1zw`ض-mO9`fB>y>9/ (8Ceڢw{ߨ;rr_3|YX5fIǧti@]×(n:#6ukMnFHo퀚QjAi։n }]@pz4usU˷ML{d9eC ͘ʄuPEQΈs[3_ _c]]^/!l$@:L ]8 HQ U'#p.i&Xva@)})=a3KV:U1mB^`FU)>VКK9ay6jec7KkUwbZ L`_s4klb[#r2"'Hc)a5CF+iuMPeY`"l.jT֣Qur4**.|w}_#"M42ވZOM`Ayڂlh@!T`'\).fq4q@ &S`=Mrd|b?Q eTBS`@6,J,g]/Ǣ,ds磋~ҹN+bfΜ9´d/ؖ۬H9zhgﭬ말Og9!Y׌Qj\7ܧI`*^1?xȃρ_>8W {nr競6@#"Cf;Sf%pl$+`C1Hyi**F ّ@;ҬK9#C󺐎k@U*#\ʪ;NVn)˥}I7 g.ɍ@v+5M8"ȸڴ/QqJ@n}LuZ{chQ.G{{S}se<^o} e8FQy|yepcKc+kѵXUzT5<7QWd-8,ŚcFqfZ0RN Y҇oCDX]dV 1#`DyM()t9L` Ox;:J-kQ]{jfWQXo08ErgQQ{s3u`}.( OZBD**_W:c"K =塘4 )rYȈKJJ\qƬm5)nm]c6Qǰ I5)h4yvc_iXȦHI^!?螐Ӌ$}yOs'~ox/Zoa"Wjh]$=Cƌ$cT 4rcjhC"dE2W/"}޹uwSrisȁc*1@D$9Qf{*͘,<{Ѻ"L;ɀ*m"P=r JB k*=vI_\]UuI)dF&' Y+⒴pڤZȨ3}rZQUSkR..|O9'xti) ^ *%J\v&8]$o݌Z@DFFMZh!=[7TM&ab&)՚jdO|oCcT' +퓃}׌6SVMsj8⣀qDG|0aD|}zXYN' Qg}ߵkO|/2̽I8,,@vor@Q눜jzBT%6e@A uׇT͗D"ʒ ߃dfW\G<%šV gҁz4zMgmǩhJd=e۞p3Ѝ#4hkaJ99xH=ߝ@ LDk&sbNj՟љd%f+HŴ4nFw%BƵpT,UbS7 ohFL@,BGYY!Ii2{\gp_- `!ݍ!ۖG i&e^JZkѬcaשy ōRPWZ^Y<ٯ>~]\^3p>¼ϖz5fI0I[&WK,l%s?v  i9 "_)H'E}6z'XCw*vn8(gʄj߅yT.Nf1嗀rsiDZPB6W"E)Һ@+@Qj_T m-,Rx{H(),żw^=:ﾗlWuGpY$FylNF&(s ;L^͞z+`#GĐ-I(3IAcPp)VNP "N̉2EHJ0#-VN\Wc򃣥c2R 7!? a֓g:-éT iV]L?fOI%㘉kĚ\8鳔LNdwC1)#"†w?y$ HrZ:@wLs,N9VN!ҩ>V>Yh5HTC@nc_j$&U9;8-1}e⻴>33gpģLK [\Woz~Z[ z`=CB'k$Y>g؄+ޙYpmh9kDf)ppM )wXG~y?>yf#[=I 3xӀT Ν˺0$ҌzBbeeW3Yjٖ=,٠j6tƯ_k\DoN/:8ɶ]/3".ϣ,ĽcӠZ]67JhQTwIsagst]خ +y %83K| m[7!5(q'""iɭ@8)b;l\;k.$;CRHSU2\YyvX~}i$Aa,U$(& %v,t&'/5 J^'(DzSr ;(OiE_5[C&6؏EAgAv=tY` :*3䌌ۉO=3=s aoaO!FHpØOj "S < K8+c4uH·mcFH5 qrzZunXuˎ%w5٩=vKo0_Oift.q?(S :?U£ASDoje6>(=tH{OFQGfd17AI [鎟vB ܇T? {* yU/y>>Aad`F}ipF]۲}F̸~q^`SzGf`l@uEE<^p@:׀$i[؊$);.$2BNnJaI;L##Tw juWͼ^ٱYK' aQlaDNfMn($$Q) _4M|?В*P1eCC:=5zd ¸+~{x;$n0XUUccIFv@Tm,T[|P754-qV N0 )5sa#ҍ@-)fA*q^Mӄ=HƴI$] ]LiÈjGE͌^'0Ç}É/au$|$-J$]:3^ۑP 6bH ֋P۟)xv}C2_rCDNhL2rq7/^IȜŢ`O\6C-aAC5AG}׻׿iILy 8FA(dޢk"E'G'5Y"[9|6MAcG?=W?qѠ֟U9†]fG}یK]Lg;;PS pjlIb:Hq/5 .q?i$?wH:Wzmb8@ tt]Q; (D뤆j(^3R6j};·T `p贇.ƿEw5!J1AXY#,,m[PN~?Ӂ$1^ `a\PIVOC`a2qrAF(hW1ݭkjx3:rpx{n8Z,F_1!`"Eݯ̀"EJ-MtZZxF!%Y>ս8JtgEѕ7t5aWE!m‚D*B^љ0FMKo>sn?]v0TtDz-:'ьF.he&Lѵ4Z3>gѥ:hw{DE^Ģ7DǷ!@BzR{ZBah >,QԲ|Vz H  $4OD%h"$4;ng9s}Mr?iZk17: X)&Ϭs5žFZ@ ٿ IDAT2jlX#n2=3`S@)Dj[ܶfG׮/,/P~d6l,RΠԒf?Ԯ5todͨxyU-.V.ysX;Y6͠Pd4@_8iY4`\h0<<; KOva%/vDj_mEu(C I!?g^@R=\dep{'mEcFAJ=PSmBmOqD8Cz͹mNȃdrz=)@Բ=̴6ѠȎT7t(EB׎P*UIpXf "Qwh ukk*Q"0;P;3Gv#g8gz~OjWVߘãX ɑ ut`;qK|?oVڕ4>+ŭ"%|W^%x3ER0"R T;N1DU}"FX׉*JTRȈ oSjEoGBM`^ LP{Ivw!{ 7>(J I4ujៅBPtv@% `2TDӹ~St#*5PY^2ylJDU4٭{Dd򀗈IHH38m4Xh`m 8 d䗰 Y̌YY#bJt ~X#,t!Ekby~7Cc]ws2ҲjTՖHW:GZݣGɃٍF\L5X:,GrW.\**C&c+ <}fX&}[iDI1ZނJ>٣qRwt L÷Bw@_!MUa<\ٳCQT5%Q= h;p:tٌ-Z\paF˖'?diJㆣrbZp(v85 49_ 0tHJ;騤n?*WfIkA~:C4! 7 m_Icn ̣e.QDnID %*N)g5љDPxxRz0-H[!z 84 ] ֲx~K"E^h {ӳխ1jVیf1v=|Qi*LWTVS eA=Ldt=wq;)\EDLBd6M C+TO`@`*s_xޥ_Dzd#Ad;bu@FU^z89B$tyt5Mi(,a~ UaAl^:Օo WToY͑k!<1c\XϭgLyv}:z-.+813 T-eD6񴢬J٫ftoC,h?t3޷v ˛HSʶSڭ)ލ) ̘>:]x\:[xkaΝoŝ8j6RJӟuw;'kӢC\Cq$OHP:Ǥ\^Op*[4B04.}'*|7%TV;w_ ]"Tfy1cxMEf%;EJJI/":&'w,X@J[?Tz6o: hϥ&wggԀsVJ(^7DƵ4y,#d [>ϻ?}U?PAct@%Ri:v*]J;U9-ɄwmbDjAbёJxL/XԺ4:%K[~_捞GEv6 A\ ;DdQDV3[)z#CRpCw}d{2_ºF=ج\ $Px-YZjrS1!Vk cB RA,3GZD+sW߳!\{f=ko|&=)DtInlV^*Tl0(С]9j+{?J|ӃQpMmq.}6q6ZXysn2HiZ5T<[%mʀ(R<:xu}CW?xK)nj‹[Ykzq}RGqp oq *);ENPB( t"GUϚrZ*"FR8[S.y#mŦrz>R7me2FOF ʛ ;~Nυ*7Z$>@gGNU`͈+%Tvf?vmb oa wQ_wt^ =@]2 )X}i&AT%D%tp*Eݵqi;K&iqc1;Eӭ=DD%T}]?ؾ!g Ӗ;>RuOjl .%Dg"ŕtg_#"Y'eʩPפMSkq|P43(СxVZf]$'(YwꙔnyC:Ƙ+FuDHL̮Wbp,4V@$4۱•F+ Ϋv@${9Ե" r^EO4@#)7ڌFa QioT%=P:۪3,-{@$·g<$MëP 3,&1Z:xe<1B3]:FxҌzW_{\qf_6mvب: =\3u67++O:UtdTMf#Z`=YvHr_NӎRiP}Ģ`w3vMk3Ny/|G)0+KAU4Rd2,'86 SpW;b?1 FZAq~"@p/Ƈ8~𶃴cZ \+B߷eJje5 Z~5,tru"MW-X]qE0wF EZogGoհàE2͠7/FMSd,loJx8woۯ Tȃvk4ՋX[D^v?T|i A8̺͜YJZucau&ϣŒsqXk\jczäD܈cj.놓+?{aY-psDc%537vGkeQA&]wXy.,ߢ5m}[V,nHAXu*8Ɍ0@4b]CW/o첏ף֫vxx^?BNs.Zrmn㝏-{Qc,KJ40tPHQmosXH ts@ Ԇ)^*I):6\)o+iӹ,CSouҙ˜tI?ώ~7:&gAtLyd}A]"U``5(hGG/0bF:Ep Mx @{)cȘMƇԓWϟRvZ k# צ\. idtg)|tGozÓ8f<>f{ʱ҃l|ҍQ@bb4[~I @v"" m:'])"`Fܲ<hYͅI x#-I4 F\\> ut2`h#n%@am1?Y?nmt9o'%*v1w TN>"A,Jܱ7< =x,BvҾ\f&ur8G(S%r~d76Xa8Jon :Gb“p,s,PԼ.NkSH[,%P#Ie@-KkTX|f]`6yBPj´,v&f" l^\tS^zʣ5(:Mw)ܰEJfh<ݴl']&mc˸@)3DnE8[VƎ&03SRh>](5e0X/떫f p`̘6UCz[3o۠ۤʨ/B$ܡ.uJ!* >o2:Mgy? 'si@5kI忨 IDATd2,-_{\#y&MVasjA #INfa)Z E,YbGf4KaLn,-+v_yI"B.uϫrk}n(6=;/~/du奟}& ,Y3_l\6@2ضu¶my/B!]Oq"HɱOC2pS,sCv¬=_=R ͇̬P:Nvn ?8ij]T즍؆Eטj{T[QyOw?3-[;'CYj|@wZ bFFDӿ.#rJir+fte%;JEr+*xtd4f$BZvŁ%5FG\dp4o?or}h20\ώ7NyNH按p9ܺO;&aCteС6mZX# X@yu7{eP#">zljqdTD̢CstL:0I dpvv:#݆DnBSBdFH/h2v@t윊9W #Gs3 p˱W#P*\ }MDw+.fDr|,:4mBi.tȠtF=Q}{ lb H ؉^{UЉWkY4hX+8"FGy],bDLiU*7cW}0|NFU/գ?uimgUC ~ SW5uymtMqt2_s8oD\WZB)ML~Xފox2#Jpގ75JUm&ymLw Nev΍!d%*Z4*Nh OCL`Ac%,lRᆒUO oB1#L5z W}\sUG<GrӃtcx,uJrҍ YPNwnDS7#wN~Oƒi 7O;җUO~1 +N|te?Eb`!Ãx>Ip($sK(&'-/Jq\m^ZTj{oxXo'~0NNt$[Y%!5%`.,mҨCe#Fh/n BQ#! G%hwZE^hV|-a̦y}aPәX/2NVVnl>~UW "rϿt[4yE F0_Yx?;db^rϡqy;PJƲ3;.Oҳ?e0sQ\sU%M?z@/: ls>(ٮQKpu&Uo0J5NA ix+~vxVq Z4M+vdJDDBUz".7.|A[ɄzTM%}(jˆBEn;Uz6[!T =TR( IH8Xd = `>f!UeAÎK=F9JQ2mb*m XS3O9͚o5:]R@fT? 7U!tﰎI;!LS 7>[cM@tc0Pz^x4>5 `:^hxH639TB%ҹTP^B}Ќ}!br`Y8Z` 1|׻-=zӛN2H ē{kl2@J2d5q}u1etE/}OVV^j0jaaYZF:&_FGwݐY-rwW!IA'զO\ܲmp.e+3)~1dhVT0G:Wu|G}^]ii:chu+Ŕl ͍U ggT/-a]Ҍ'3tRN0%gmewLh\P[ypǣ1ڲh` "zJ܍EԵCw PKJdDFdq-34KVd62CZ"oށa! Dfq;4xî@9 QIđG4k"@;:Uѣr%'HO.fT_0 HӲiFpt3{8[eja0ɍaC\o\d:2 EL]L \#^9^|~T iB3= F>b{I=|!;PuɳytuVj= X3~_5:gvSDbNۀq:_.57* ) Gk7|z_D~— "\T-nz"zĬ2B~nG)QH*`61ض9" 5W$Sng'8_$z/mق_mbCad:ؐXul!"N{w_ſS M4YYYoٲY3&,B:\sMew|N.#2rml"Rܬt`V9u1Pk۲,B ƏA1h$S$4.?|-T6B6~ëᖕYC~vk\"`F+'PLEahp>,d?yC4Ed]=*@1H- *dFKc"}1\v0V,|77vLO(,gԦkpV_{Lp2W|x 7Ya.!ŀp8q=QUr#(Q(q6h Z (LJQiA8Mn^LXYGd4?T,#.s?2Eb+dJ2G,s4DdY#:X8b%H!jYXi)2,l:?ݧDQ Ndwҋݸ6UZPϋȳEWfzOA0-.xyX K%fyF,nU z֛iaΉyDΞf@`M:s">6pL_N^^8:|xH= Z˝CRJZL}];`~OPAI٬rKúr31ìeK2:kg,=o&*y5DEYf pG[ K6Xer x:XI< zgtM>oܽaGC?\#k@4kCf h9~ ޮYF0)S~F~GHHha]q)C/pY&:`.`HiݧEgMú5ѧYׯ OwHĭY:wRf@ ' $4" -N7띩G.ݶXWaK5Hu.tk{1k3{Şh G7`2;9@$C8-,EI*\^J.1`SFZpw3tghtnF{BxZoO g *)NM~?rnfhвDc^|[^׾Md<$l)H3I2A"'ђO6Q@'PP* m NA8_Tӻz bݷ\0b^BU+^' kGqcwbp&F XMA7I!VH{qjT,N~f,3 S.x&]lTȬB )'Řa:#dg "tK ߋO?\MeM]LKs`TGpZ\WMM5n $\˸JtSWrZ6CFZ،9=Qz֫N)UBw~ZIIn{~+y?~IC6_fn,xHxݫ1t)EIMaB0/{pzn:?(>2\e=l9n~;rѣ}YoqzBt yh%!7U-Q)nMp{B>Ny.eM&9hGj;Q JFOaox֯?Y0HLsq@O)55`\4h Uf4I3Wgod+eX1XJ2,: 3߇XۑCmvTQ`ͤe:g%ƕ09ޔ3BV%Nki͠T lcϭl&(']R},*b$Vk}Fֿ{`trXʩ0ݐo)CB&L8$"_7~{ :u5'a CO! II8TB%J7)EPEӁi8T٦\gpW76͈u}@*Q}w^LB[N+гcin(it)ciPL:b7FJ[j0K Q|E؀ Io a|ZzG3~CɽxvrMi_\\i.ltm̯+EW{Foq,]3K3wd_Ќ&ils7&TGg/lny#PhΩ}$B5N@}}n›7uUsOU8Ёiz$HPxO/9!jjƓi&z}jN􊥩SA8 #5T Z1Y`[185l쵕s*=acs11hA6U$ȨEY[ڵNC#:q" q"TkZXO$iS^uvKCW/!fur;} "6)0 ,@F} !Mщ- ܋?;vm!90R֒lA%"ZI!so1jM)(vxLXŰMB߱2Ӻi"҃i>𮥕}^{nOS?NS"CY*N]Lz3N+7%vZ;[iKׄB$醹 sHqNM]sRHU- >s\O*/l3!5S\$[ [Z/QDꥥW_ȇ}_~vstug'N IDAT&-9ĥ2}4,lHNz;~Ň>N­{AF݀jFrN@yE8ֽn}=1?|#SQU5ZS v?5{1bXD-+vA TOϯMG6/K4ҁHs$i~=$o/ر /6dQqW}DR坶UNș:IY{DP+j0Ri.- nK4#}hxVҕ9oWLvZ\+Mxɋ" ǧ`L5̺\6m(+^hoH1RЁ0l}gtYJ0JfA=I_xǢWT*p_s(H$3 PTSDS|tb)A% ٙ>8pCBtW=aw_JhXDMӊJC$J3 Oo vN [^{v,T,.r-|gO~?Eo;⹷ )&vm .hCzQ~tl6&T:ً IW=P 4krT >GuuO,exu:u! vX2h{{Aw\qϞ۴elwu(ٮW:%DzwnDhOml!;}ձ"#~}{t_uq<_. ; )4$m AA5r7PEioU58{^_ 6M{!6pRaռ!0+_g i:r?ӿ_x['إBLIئh> I ۧwr\JUMX_ CF6>;`"v0WRtN"OI:IJVn'LUS՝-Jo2RAv&U6,4ھDsJq"MBvyP/Td;LuoaiT7#=8qc)1K|.4) Zﮪ("Wo8WIZua y,nJ)֫a ux,(+ͽٺGY]2|n޼ =+Tpj0Fjݎ8ctFFM(`vZC\nf1iִA8TYf=|$4`jcX Sbwuk|o49y7q20@!9)0Nu|#semA Cx3u?''I+_}>0mdL.VvDbCŲCu]K_ߺ^-[M[4`9zS(k(lӵ8">wO"[%vLk[|F(}CX5NkyrUůzgv\ʍYh(z;m|m+uEr T~o9cr`߼!z_鐛gb9L86X. if֓As²,CkwɈ$.4N E6ATCF7^~OLʌ9AǼO"ؠٌ1VPnxbt}є>( h6]Z])ѿA^X lEsv>Z+׮=~6t IcXPl-0~ցX+>/QenCc )`ͽ'~'^%  xƎ~ O#O';tBh oWMaΩYnlUn9;I H C.%mb!ɴ"u_'i(ḧ́ '>z^svT& _أVm}GCSL'9{k^{ ;Qd4maKT_I: R A* ]tѵ+OzEKdù4?cҢ)æodSmk^K=>cmdu*:@EbӘt䃅4mTU%զM߰qTt:!Qٱk1IdԀ VhA 2̧ $?]Ja\x )3%K-CŎTFwq6=QBru2޷ <JT & XʸxfހE(" /Ēnl ڹI=yB~ъ1Gɬa:QPڇg`?$')MQ/nK` wxl R0LI2ڐx,J /5eךvi5X8ɲ>E\Pbj0.U}>Q)~ &⤼5Ы3qj`\BKٞ&4B ZѪ~I]C| UUI~~UɦA6/6o6y#_p_ ?pM 5(b*4P8ȗDD|cFXA =nR@j}Hv7F"l(Z=F̸dMR)K۲EٰM3dSbûzr '?^Dy OVe$ #E7Ҁ+H`.}%~Cg&5:`.Q56)j96QӯzU'>+{|{oIOS*>|fkcwn;>g@yw'MMNPAlEףz_5۲)#z  Ry !5DMZO~D}k~} I""K7ݴG鉿vN ;Y:6,!1ǻQ\եF%*(O{iF}9[;Q?sL#4 ʂ$őB8RH~RG5 AK/jnZm?(b N_T!anMEbMWtb4J(Y[[ (i%1L4S ߢ{5݁xҢ`]FΉ|iX Y-xj.~DTȐ?wٚzJRR dFWr̢ѐ2lįC#[O;"|V%*-lT !TZj;RM8 @3*JmZJRtPQD~ʂ.𸉝 ףܑ_|-?aHR7h7@4 NYuT*ʱv_u:E/ډMC f- DD*8NNv*F o3$'_i 2S|IL1kl9t,W]yۅ?Y//e9Ѷ-Ke5سyQ5TaIJBՀHU zrVcj@JY64 xGyrs+.#__f}jxM#C:N6Xi`J,-KU3$ sh%2w qj@ .YLȑb-ԀCYFIKj[.$gX0@a)%: *}!x}͞Ngo[@jy&i}>QTxJu(Tq+L=*jI{AG?;`$8p*dWZ6<& L4AO _D=0dm[ղ3\-N$qHҫ9e@sҸԮNVkHilyf8 ".a#:`)oUD>)g%ӍӦbAࠗ/E)*@6OO,=Xܙ TF0IM(3ѹ:x}ze#;_GG[/BugAG0v2J<+NM?Gfr??GާU OH(m.^fdC;XJP PTZOӯm.- tP >ԃ=HGD' T6kZnu" &eiuXjjgL3h&*G;1o{@&j-j0Xmژs-ՈZ;^؎"i >1'hkAT-;n )B2Di !"bF͵4XIMơ4"N]⽔ <$"0 \$ 쇎3GU:H6ObĚm3J꜏IrK$>Vww=]QW f(q[v\-ҥ@u5VޏmoO{yXylQDóedȸf~+X9.$F ҡ9GN3MɝKu_"ߪ'L6Cx暫9i~4^ib߈S Qy.(vf=Oߺ-g3g?9)D'yWrje!r8?FBzts76cm#+1N33>?Hb]Yy^Z`uʼAͤn9m0Ev90H9[޳UGndem:uMf$+GH~۷ SRՓ rD# a,&}j`8-8Hfxy--ljf|YvI]1-3Mr:tY PFdZCV :X*[+Vc4U~d~Omaڡ!ŊT0$kpiӮQDv=PDU ILC@1s6r|`v}#LE.d h{ '増g]v_$"Q1ytm Ыd]3_0~P:,@{b`MqID"9_en@c- Xt-rNvm~ AC?Gidzh%2_C}߭JNM6tŰ !S%X07RU}|N.0ڵI5=*asƱiQHZ\(>pyտiAS1n5ݎw( N}٣ji/<ŕ 霳L!ˬ2@f05@`V]%t̞_kHY6-~px/_ڳc' gg h7["ft "`qg~OڛFzub="Dth8Av'o `y)!v{z|md5`5iLgPbYyij|F 4޼o]#nL0'" =?mܼ02(^D6}J =_J9cݎQ7tYr4=#gD%%9L|*EZ4PoDǣ3|mϯm ID(|u/^޳+{o&㜄hqXQӪ"4)SBO*|MIxxefJF X-sA~iJ&fbz Ѱt`T70RmI-p$#Kwhu]v}}5M?TYy,ݯT i%+WF[dj8.@̮q(&HH_sm>iVdfx. se&Q,Db{F,$p)>JҀAGTb@ͭ5Je@ ;z^1t q[ M@Ek#T.M~3Rֹ Ij;GNŶ)NTÒ@{*5yT}$sBBL#d6m(B1Sx8g e*<bKQ5jҝv?wSMs<e RxjFZ` QB23:,ff z^xO>č5b%Y8vet9qZ_:Q)sb4B).sbt6ϔh~-*BaRU#7@!IWh6դcCYi\C'')2m__ 7ϟoD֭O~o7᧚.y~~պѱ)D[Æ:[[UAȟ0w>i֣^<&kPXA68Y:q;dvJUHpܔ L`FuysaCicr[UU[`遒'>'fbqFdG((8}̖_۩5 dҬ1QZ.HJum,s 3}T5PڏNZi7H +l%S`D'6էoMBYͲU@m0G t*̠wP,AGϗY_bի.`3&R^s⭢;zt| E#b߯}tPM'";[)tSU iB?ltѓhH5}k6ToBx>)RN6luR; HjXtF6ep<;zыϐ~wL!xLCU@YbdmI-'eS]4U;?gOb!tK/"}=[S@ u`ŦǺl233mZdeNAϠF4QP̚ 弸-tڬv.Ѷ䱷_s T'\[O&K/Y<ع`c}ZɏR1""=Wf<9$>NK[16t'5"amjvOJؖJkto)O֎ M-li&GI3 p3>z|f2Mdu}7p4K*ѡYGyfIE5B Ly7 &QhआŒrrL& '9kׯ j IDAT?xԂjG'T XXj͕K\ p+-V P0釹 -]d[PB*V@dfEĆ,[@X'?K &* qɌ/蔛lzD>Vգ7TNɱ2`dZw0iߡhZ/!д/DHORRab'2dR;B&AD*Ӹ iKS<$1K^g,:ϯhaЮ.ݙ̙lj#ǫ7l~u뷧M΄ePlP әq~*-Jzg~׿c#}7޸D IX}|]/V- O˲83 莆5.jd3;&?ys{p-c0d$mF漂;igᔿILG"mLW>xN-‚iwhf:Coqb "4եf4"'FPz(ZoJTg$2V̦Yb8.3lx△oU‘a"5') ltXU.Z=kF8y?UU`pVx:A5WU2xArN(<4==Aq("7D^KJ3&0BX}@uigFGͶlGqZαQN[ OXRH "hrKңHN(S&?d9gC-o'M9KB01҈7_&6[v)$ƩwUȲ|L]:{.YaL~pr|ѭ2L7e\\+ c[[ GOd;Ǽ_m Rc]etʁPS?&exbDg{?6N)F>ЎQzpzn~q$HGn5.3(Ƣ8`01f#;zvVG!QWV#>z24.-̯5f^G>{E۟ύ`l~`j0`6!(%5&]նr@-!N&d&r:t7:= s ;u-4ºz2nx\F8,7^#om~6f2æqUչZNU34ЀИTz7I\4w_ 4Ơ$hI0TWw];?ouCuٿU=g=ONesYՌtEq]g-xWj-_D;+1Z4U` dTXEo@6pX1BȺt~G/{|`h@SĤ1&IQt2F ħGS1NV8nDJ18EfmJ'D,!&9b(Z$臼Ywbnzney'@Bi[/JR!uUYC?:0 { ,5 5Q40FG4䉡nLǼU = n&سq26.|%[z#yl|-Xn6}81 [` 6,@%̃dJU$8y q 9ҝUW>=g@.j婺C@5 Q8KwuZ;v:4>tz ӃP9ic-\D'Mnx#!՞ajcJ\bE /ҕ`#q!{*"\y1'܆AHsuR~ek82W1+u[ o%8qP)Lwn1C}‹6Tֵʴ.I#~{; "@,o.CDs3P1-QHsIq; \U%Nsix-Da-,ØiYe&1C dv_̩fuFLjof+3p92: {D-+L oEm*I[-}?[[غTO9j굄L<Ujg$yFD+zmVc>`B1c IaDPky¢~/.`噊nߙ ]gQeqt]Sv̸ lDH_S#9熅[oF R8 IhA@b.׃CdÀG2 @k/D7qrmAyk6AQ> `&,$~X(P: FenßkAa61I1uF&j$-ܕPGMǿKݫM!$!Xs:1*|TW|ޞ7İ=| >^͵(E@Gyq,Gq6U&C=3Qņܕec%!@eS{"XhXV2%QH 9 #uYYHZhq\s^V{Eh,?jREG"y:M=%b4e^xmS_栝0HKgNwNNfm$mhY(tӬke|3Yt6^}?΀ڋ6SI{ ;ovk_{E21Ҋ+#kc!b,` ^)D ĂefEU?{` HBZ;v\?kݳÛІ~{\0vg#8s&s$9=՞aŦRM_}< UOс9EFA1 ttz3{\Uq-+љ@ʐH9[ZwiC͠'NG#a Ύnf !kY\gąsFڄJ&dxPEŐkrm#&A*RQmbs"AII@ۍ,v$qV^Znhݨ,s :BfHHTT/(0nT +H`^L;2Y "[URM!1}H ,:06u{-;m0O %DأP/,(:ƬF溜ĜkQ r .UjWk"vuQZȨD|uk<g/]QI(ݱ cS?䳒_DڳFc}TTLRA#@3%c}g7n%|KgNx ,i~M۽,uNw{t>K{evHY_:ݢ H{xы66=mۢd kqjtp;kptp(wCJ˿{];w0mƞܗGڋ1NN1Qo5ZFAcM\Hw87:Ƞ,dNdJh+,3P$ZpQ9s6l2⼽!k{'@)yb$ p- 1qg0tI* V-+@ ,;QA;YJ!JG7q$MD#D+Ї)- <˴c%fR@mIRs?^nCjwylZԨjMR'X#Vbl5čx|]_s' lKTх4.v>>0>A@Tw"Pϵn!tbAvf-Qns ޞ @P'ݐs53 |y^HZSS7g!j4^l*sjyX㌨R]U*$L+$1sMr㓴ޕ67v<)ڝi$&d;׻7t/<}ٮՎ;QJ.5Fj#{t0TP7CN2 Zv]3=^!*3*1wi)h|QHcQ`R0f_9@X{|X) h9s H uG/0HZTr}$([[^#&pkI%j@1w wKaK}rXRkΝMoK' m3J0 uV̏^5#Hm=Փs= ).U^e˛~ ;Tt}|SLrpcQ Xyrp㡿 :9 мȏdHI+d 㰎g = Nbfc/dMt3`9Ub.j0|r@~m= _sqBS>7TmxVOզR"8{(4oeμ%v;{M]Nihs$_]{nk񽐤 !FPmȄN#ɞ)3Z"&D,ŒК/iy}p|j384/7IV?TǛZ}e\&f*1LU*oPWuʳ%Ұb ڠo2p ؇ (*r1N Iq f3@oP] \ yvS"Kk 3`!7-GQ0##aDh#K#"(P9N>7tDFnj:SP6UjA]=+xK6OD>¾ݽXhp뿧zwzUe{s,xtN=,|:(] 'Dյk7橯BbTq ΅n4h)iEcdxeM7g;G)>ן"SkgEf:dOK4KkuN/-wҋH^[2r Er&۫9Q%yzTT*rbTI2k5P|U wd \Q08" \xUS.>PѠ,k"!YQ{v7=8LCkn*O{x|쌨^?7O6I2a*$ 1}'8--!ʜU==8zoH$ Zu>`Hb0vU9%=s3'7$I<ڿf܆43Gbx`_2٦>dQe`huHh0M@dx$lr& &%n= x)8 .ǡ3)O] Vv bm#[">WR'%t[vQXuBmڏb;VJڻT`R:O{5wmJ]JG)J[$ N'kg휿+xƉQ g'DӣzmUTWqGh U!IB0j[5V!FrVz߶U6 Bh *Wl+FQV1  ~H~{ ΃B` eD 7Ce PD0H1bQ'%aik7`Ĕ;)wyX{RLNDPe1GH&{(hi0\bq>~W;?=ЃoK/*a?~d p(3B5$7|F2>6}3;ЬaQ[#s: |\D` cLCm)MOϿK/}e鏻v| Uqa$:+^׻S9d:,M0idk}W5f QH:AtZޅ3VI<>?ɺW ay$-b`i% &=G3kwEǮʪO'V^R\jVM.;^Ok `)FX!&D#%,'*(P"E!}3")_Ǥ1{"Z˼ iǻ@8JVlwZ13*JhmE 니V?qK!^җnӟaE6л/!҂Uqo(9tkА{ƥ &b'#W"OW~h`;ߤ%@j|Z[R"$%Ue6` +qQ\+FEwcu&z bߪIOuN(ƨѸ /׾vW D\]9X .+LTC#j ,Jg:g߱@?^}up'Nzg%+>nI%"D˺@ ZH]CD(fk DҔz֕{zvVt94{;薭l(r-c^2Dh Sf/+=@C}6 9[v%#ބ 4^8}G.^MN>Ek߫$(* bٿ9A-tx_u-%Oƅ w { :0RR@D`0i6 7bva,$d{KrYY}>n|{~5Վ n Ƅ#dsäP>sN<)@LnZ@Jk8Q@eL AP; f1i(ѨčK4}ij:o>CcdOU oyT@_ c S#-H'YhQU6:j8Ҭ+?Lő`!>b{EEl:#Pr@R9aLvٶ@.d\ђÕKjL<賑=?V#Dwi4Lwzsձ7zgcL51hAS: aЀ^6BZEZIwAV .D#@2bdn?85tDzNÈU8' =wX+ )*:j@!` ϳ] 1L(BmͰC|_2"l =2H@[c|C E/h2y/?j*A7OL;!þcHɍ1%l\VNo5JbdL?bo2ևy3"woiz\tۯfJ\Ze2(i"?p?m'CfgPX"kZQoq ipo(PFjjR0K}HItWrtL$Dӎ QJ/82sWeET]Hi:։``y珖@R9qկ~Oju2-W*J$9#)ߨZI[Vۣw|Q 7'j~z5ߙ4kMZ1I8\fy@<`n;xe ,Tx H\UyI,J"|};|SWQ)lIQ37V=N$&Mc/CqfxM A t8H\N/jL v'Y 5]J#t j 2һa% =BXPg/ |&#Ttr0o=Nsw@ic}&ީA"(2 p:[%;lYYio'e1fH^ Jq7VM}Ԯ~a"tAw@bkݨ!@n{#x 2TpFRW@2(rpSk˪WA! 9j#.xBŢ9%^3;Aܱ_M#k}pxյ;OɨV !G<\X bh§]׎>,bsQA,+mG!͑\1@?:2c(6M'Y*~de=Z+B '"02 2= ԀaP(Փ+6})S ɯK@V4D/Z{Q|%(zlOX2r,+ .(}`S$#O%VP1ڸ+_tz3Z/Bع}6 >'8cݛ/c_گ#ܒX?h6z\I?fՀX9PYd{0fj}*?IvS(3Q%. X|-vP4wqu૵g=Ċ˒+NjĉQ"x;ovcK 8G,kA<|muac0I8ݳg#EK6v"EhB8KvQjmSB}`N,gY棆cy 5h]LNR$t ʱ\&8lϝ+sdVnogPZݹͪ D>@PzD@BC L &R1&_?'0m*@ rp7ّy B>^UXauZ en\ Mh"0J5?ni@R@]Ȩlg&(ց* NLIy ?) "eTkab6qH|McSd;ΨN;M)DkBk D!ƏgH{DpKK#HH `H2Ghd GwaʔaL9Q?㌤qύ?YZ?68(IkW~S=gKyAFC,@ R*1ZC5.J~u=O^Ɵ3e˕͝;{ siE7l "BT! }rAő6 5HRnFDƙROo$S^C2sP%A_(wm%ZOOh02ջ? #ڄԻC#2qxޅll0ߐkSa pgii!<B9|ZV5;{iW< 1@4D2Ĵ\K8 4BmC041y1^x!E(=j>Xwn/JԜ|_F21$vޚgi=8{䃯ލ&9`*hp-(gWV@ڊCp)!RTE!1[ZlCkHDVjw PEc1U(F~_?b\IL58JbؐݔH!&9~!>kI{ΐвٴp CB5hX:e,%TcD)'+՝M5m,xxLTR3aE+ouˀ,ܹb %8!2bi@K-myS[5?Q@eMu1 "67F;I @a~B z+00a%oO}Nwn;/߲<]i edxwjWH"ACCntAzq| s q :c%Q ѳƼ  95aHAʔ$ be#&{ۗ]tDܽ f$u#N] U\pt!'%ўBއ^ RqFU+/HV8E\w)l<[6e{K!6' xmLzC.e[lnG~`RMm8ݿ|KG;gY/hB sNj0t|b֪dzgp 1ت<? F?L].Q( xMEe A0X,l Ff"} +/Cv[ 1!A%WVɉmbh?gX.3o!m(U_i㐤M5DvNY')&t<1YF֫ctՇjS=XK@E7} C-,aH}^s'1n++_+Sɺ*xe>뒔 Z THLHml 5Lp㞌 APrPDY?>оʥ)~UYKNOj.2[:ɥ/B P;h*|e%\D$,Yϑ,Ϻ$[t_W D2(]ʱG㬳Έt%',`>a[lc;NT$zy+v*}bڙ}[Ѽ 3qOn3dq8ƌ'& n:83-ӢOXœa2` U>~ùL_i %HSL[Dk{!0).\]jP= ⃡y+ FB'OdD`ߎu0q44* ոB ! H]k9njA YVːEh;"ʂz@,[gaC*Mۼuc*/~lEcL!&zWhă|j(T |l{y(5O@~>-].[gISvegKoݴg%T{O̭ +^Ff<H}_3Dh~qZ&sZ[>>@cJrm$6HF,Wχx@Ɋx,q"wX-*bYLg$ڮBboT8Gu%5@֢ڗ\=UȁzJKB$%A"gbH kޡڣD!EYX|%nlX~x܆|z:׵a0sBKu:YncU 9P 9[T7jf.2ҡBlCXpɯIeѪۺ5ɏ?4>JA JbX /r『/z/$~6%~L2P$G qd+.npLle{jv|ftz(>l{ooG7_cnn۳m| 9D9uCŀ$9P@rx@Ӭ} _P -M눃*Q!TdQ*6n"$QhPfم:uMŒbkr%1=L@wQt64B!p?%o7{Zt1I7r, l 5 4cp6q ض&C'JIld^o>N^|=13w0I&_!(5_ÁB" pd'֖gq2&]&}vNh8Q!!,d5G3Y6HƤ4Ђ7ِI.v0{Kգ[h':%NF a% W#@9 %3@ma;/j+rc5ﭬC?6ͶumޝR:[Q`:P>&%]bl@#2p&A3jZx;iVfw-v5פ@`{cdIKoFT%u@bX$ Q%e܋}뮽ٍPnNFĝx(")!t11@֐gyқߑگҋƁ`rRO͆k< ]dCj{l`qxމba:cDvC4{C|@l_nIXcK_h|Vsv\ٲ@>aPDa,O2Т-X+ ;O<'LNyM<>vAu3M(v>M8xB>->Js9.P "dBwvz? R1/䲀y RRSNA1SIp u#Xȉ7~'H,E E(M{(c \1)'ÒQE֊K&c9HmGsXLėTm43s0u_ $9N$=JېkK_:lʃn 8~ɁM+8Eά>"]81=}Pڪ@{>,$DŽ]S0_t42}c =Ⰵ Q SB)h1o DjCeEpFXDL'|.c@ҽˌgvZoMeQ2=B<#v); N?;@9c©$ *MHc*MΩBnPxp:sCF:hr,QZʕye (4,@UCYMRq|n%IDȪ;m~/Ѿ ;qqjOO~`qjsͩs)M?,mPg"c:\.RV~Z~̉QCOx6n}Ƽ 8TdX@L|QUhS r7FqtB mCLw]hBSVbBeIsY"F+ *ಜ"lsbTiDoˁi.3/ zf(u|%Te;VLTNZrjÓ`p3wB d`y0 Kv2?~bc_#{N;ol]3hmrkGVKWUP4! b *=,j$a~R(d])D)SR1! I6U. [ٕbȄ3ѱYQND{Y;p9L4db,asqlwδ@W?1>NLd(\2!պ$[BjJN }@Ue0e ]Ub~ͧd[K:{|0KMje댬v4QQ.>8:DL0 a] zݥ矉 %/n;C7{?w+/xQDR}$ MIĹa4 }Xo1"ke$ 1aT>YӕJȶ PFЛLzThDaxd XV-$Ӧ\:&C 6=ؖ R#1=,fdu$~q'vcu}%ֲD(I5@R9Z1Yu!@RBm=|.yn \Nj"du-a?wsov£~sls)|rAz`6rQ!gE^rSGL%1E .#uA'6Vjl!6ǩ3r7 H^"y@$pq#‰94l% j p[u  ) ]C5z484\Bo+w*/)?LNOQ({L c(k/!0(Fg0juk/> /gȵUHxUNܰq_*wYI@WlL вF5?20(bb~gE87Y%DН{8MO_kVq3QYcزRL{3/h$ssε#PBgϞ?Q>Pϟo_csqjmY'{6e$y䁜\ p)1Fڒ6Y.<,NUƆP@bJU P$F4M Q6 0 Kdzv0 $e ;~'訤PECbHROU? Ҳ!|Y I%If/ @@>qdԝ| Q 0zCx #Q":GL_afNQkоaRNr RE$,ɲ)fDjW$&&d;7ǹf$hK# FTv$Fv >U,.{6PƂeQ| O;?xlmg/ a$ t{\\ ,lb DR1S߮fWIa,3/Yܭ;r5mdrH 9aHX8i]I(Dz*ccccq'g0udtOޢe!yAO>[v6&NU` ]Xt.a(=w폽7fݎM醠4,X*A #bh tʘPm?" zhГHJR4qDҙI:f_f-ۈ9 D6юavR4g~m[r`0.(NH kmO.T c f44z#C:VVFDGޘB?Y;c #rPH*O.&$ǟ𵽛2$(aK(9rh-A&.@6E5hF$be~54kʇ_/ p!A)A CS#y}څ7Loamo8OhhΣJvS(QX<:pmZW1>-)/>_L.t[an l-nR $c5KVNQo /& @Kadt]KPaH6C$W:1^::ӛ((C[nO;w~c?wl-̧Tda4ro mJ=!(UNA52B*=mO5k'L1ЊܭQ"S8d-B@v3_j}@yfJ xIp/Q pcp IPj.ۓ4:RҹmY" .B*} u?xDL͗eU( ul/34q5urﰥJz |1lD{^ˆu؛3|~z3 b##g;f75 ,Z{BG/Akdk;?;]["(?fObgYv_庳Ux)އn[o=>C :ŵ`"a`cFz(r』?+.ju܅W7485Ν3iEeE=X7zt00!%AɇϹS5~iuU= lȣ#md[yHRDS@bQVr8,dyk!i~2>i,tslY Y[F &A*8-2FY=rP8 5HGRo0ty " șDn[]S$I8ؿh\ lO!InFmW1֦E{)`YNjaˀlm+G9}Q;?LXek$Vg҈F@֌(:WNs_oټo/q{oHkzݹ=q DA r നR/җR L@hm@K#e:xr"Q 6Z-Β{8qIqPK qSaf{:Jo|#峟-@"P_PˈA+T"xlzh=kf(!tgYbiCs$3coR o}˺ K㉀&vJsAu:id͒z2YY!3!U$4tBwnM݅ ^y tPninB0^@ˢ{ *a1p`b }}5%\I~6j% uJ 8c^+^n* "]RpoŢ)i/מ5k6 v: N$'cD.;ڕ `HT$c@JDշ0E#K6A&wk~ <{4oqwl+kL[aAi{\ 83`΀pC ~|_c7ICIb8v 73zaђ'Xz.6~ܪ-1<`(Q hY(_D_:<=/`he8W7137_~]WIF EF_$#\ʎ} )WK @47IF". $ /ql ~5[-.wR1p=lj }րAő'zNs6 BFeDݹ{>g7\ W=P0Ä7`|:轸gπk Fy]t,ذ\ GIZ(qPկ<ɳL>_ ?+PϛUJy#T.1iض9xAQ>|HۖӮF{󀜻bd$㐍կyG0G lSF+Z_WDϾUKm$~"֞5ƥ>=;@c0z;nzMՓNzsgFР׊)DYgoDṙ[-hܤ7$XhfD-$J6ɜnW.[Ċf9ZvL.8B@Av2A Oj"D<}ge63j?|A. 2C'gȜYힷaYF\f(RFIaRNB;i"a96o 3/GQ.(צ'ܫ\%9ur q|Sd>uR+A95kngۮ[ \rfuŊ?"cU(24, %iK.q"C_*ضIAB)$2;rP0=~,R6׻}]wyڇ~/, MK@Pvkc H nD)O=Ri2|7 5H {h(M!Q?"տUfVmBɄn(#EF;`Pd?p_G:3{qf3s䛓F 5km4eu6DN`Lh"o2aydMݺIQ/ȲE y}B0ʦXhrLʸa2c%%4 G+-]a|;jzLx8T:*!Hc2 Ci@/=9e'"r1u:m=.:^Ma 3 3Fʏإ]=vLkC-6YOniBgisa$:vLEM#G1KgU?a?p1:nnNDr~>f d媡wNc\3ǎ R>y7Za/j%W X1JP7=%xxss>m~r8;rajqqgՅ#'30a眹%uf9:~ʟ,+' \9IΦc `0(.g羼as-ֿQ1l̇ۺyEKin5F'eʨq_._ֺ-+7q|EH!ܴ&ЍsiYbJوԗUMs׋9^g`rQb-}Yp`s456>5.Tm{5(߬6yߘX79~Qcי^x/@޺q~Kj yޣ ?/q8rBWPZY]%ݷ(05Y v.ɵhÆs~6к<\s)jLW;\ )^A ڴ9/c[}ݙiot7(msvZOd嗀6uRDp]~X'Gt)ַݛZ{HWwE6%)0}["˝~Xjyt-{s y˭ @Jmԇ /r~/ΖۖcD<۬U>g:n1u‰b>Nc{FC-6ukNYd-j-mccsLr}}ZVՏ_4JHie?ݟ )/\,vf9'P-"gŘNՁۘf<+WqnԿ5bP_яύv?z@X鄖l_Ⱥe"-;Xwqʜ aY垫ZrI{k>DbS$:I1=36k ^$5'eIlwck wZ)#%nDS}i!}o}‚@wP e~\Y$G]Dg'?/w9 O1:1F9nA"-c|;nVs+/d5Y͗E'u ̿ Z븒9DRgӺ:=JW?]yz# έa[8R]Gkfa؎480-nYS F$Gr\+\EJb9hŬlۨe1m{t27F䦆8դ2{{krr'k06 cV 1j$4t`Δٕ>VojN_|Ya87g.TBA)wy_UXk׮bi5Jڿ'툯.nt'߾gʇu0xcp;IC[# m =0#]-JI_K3 l"vm?+Iх Ue of[%_|g=ZC<~y"3K^d׹>۬F<KWpϾ,WxoK7|UMq A -)wEZk nkproj!뜇%Q̓uy-[ˋa5gV:3( xZEsmm_m#֗XLN^oi8N( f;26#c"DrG+j`Wjas?M{x:Nn#UH\{n8vA0l [-rG5mYS"R/) T[u6.Ɲ_dVsB=4}aDZ'V7&ر{}k1qLZ5Zu9 9۾5b7ӧ[S~AzSS[a￬ܳ}d=`fcC>y>1SG16ev82ʦ_ GG:36.FkN`$8.(Yw{)nw r#sLqI_>ۿ?gyۼ>;>oy{s'ʜם5+9nrgQ&s 8W+9*1/.OkUCVM&Y掙YU ٢~0:?c<w;}l|{y_9^cSYyQYakRK|WA5wQ6jN+Hre:.ـam룃;:{W,y2SҟxK/'>%+YŽ 2`D]0#l_'>7^+?=DaڙD璀ӊ(!9 x0cPkb8 G(I;Qhr$? ,&!I!>o{/^EE1 Y(145Xv4r> {3Zc|Um]~0>K4BHHRAxo<∿[EaryUgk4m# lw k64[x4nҗ5b&O$WXҗ?}s>=u&ױ3 Tm2v%pYm,-["Z4] OUm)~lEL=z _S=X1=&d4;.nF?,;oX08s%k_g䀨,E7R]0(9GO(.j!`̟/1lm$10xsDB! {e؛^K=lafj?Lɺ ogkBU &HD{u=첥}Vxconrp~K4Ǻ` 7v! yt  vaxKSy>tм%dϥlXf080?Rt poER!Bq@ !I<tw?v&p(940T! ]\ǧujȔff k{E|ǟ%ziN28PStp,,k(:):%i=Y"zTg=GcuU M]p/_&C}B!$8ub͚'ȬTVz ]XwJ ܖ?Cڍ)f#B1N3ʗss`vvQ{߲eҖ-G"(~zFK3%ɍCy/8X֖+)I,b "ZGϬbbR=Ie&ˤh&{S#,FI?.gB!)Xܢ>jyZ‹BM˙vQjI=vZ[ "iݧt:ŁM@1*&dvwT.. v#3W^l$Sn\hm}ӽ7Y + PB8]sgeVzF3g懑ppv8F;Ňl !B@ի=zpEXeE|W/hlbb&RTwbnqu7U*y`uZҝ-CS3 ggʅ^Ж ,7O6j f/#p>H.ДpiYU Fc3eP,cni"8dD"A&W߾~ȓ4B!E$tS'֬9r Jb-`m-]9ȬHхS(kLTvRQLeRT ffA \el $|o0x_NѹWx~3|wzbkͬ!i;k[llT.^B!,r$=Ί_tPժW99\MjȂMZ[vw Fȵ,cɘ¥EaVVG#[RoI0(童v[4B<5H(Npa,bB1a; IIKwYKE: ?zY{4[26-IQ B}p6AB!4r$= OW:grݺ7Ӯ^#pg(( -IYY\(FE6\[yH^K8,_Q n$v`!HW ?l{bNS,%}#;]j)o)˿ EJDB!\[wk֬vi:YqT)D 0>)Ak(b,;4E70dtLIYf(wmKKK4BsCq=6E}s"-Kf>䬙va6lu)m:Ě6r$̛}FQ!Bz!8c:gbꗸ~$.0U4Tb+ ;q%l/QVM]*yxeMK~02eu!Bu2SLrXۋ,m̵- jGR2vEúmOUg]MB!ļXUV¹R^eN"s1w u(O;ף-e'm|K5xC97үkԅ5; <ۖBuԔNO䂗ؑ[B@v^3d]G]CpB!Bbի~ibڗIBk彔ZיK $kp8^ KY'lq}i83sF]]1ɡsY] >s`.E)(o[ bm\#6֤b[6L8am1޴aS!B$G8׬kR4شnE4&iģ|K-)M v} -P>R-.뮓EAQJTS*.W#CwV֜f[yl&o6ٙ\6#lXs B!$۬:ɟX$CnY IDAT\-_׍E|J]'R"άn$: eɦOZZgg?;4B4rӔ4hB҈vyZˤ(#]f҆Nf 8%d$PNqK!B$vC49qPoŊX9VC55fa#\B.W:ŮX-K .dfUrvAѹ_iԅX_f:7|lSLMk`1L i. m*cp2|a@| E(%" !B@ӧ27W^Vv@N5^V#v.wQ1QOmg,_Uc76Z^#M7{bbX/%9RIfl#,n7s3Zhfݙ1=ln0]xdw7`-WB!ˣe[W>~#N` !B }9914a%iG4B!BJ[ vZ뭀sYud8"6ucSbɓ= ]Zsdnm6 c|OQ-.?k_۬b<巀 * E^jf0O1J~ 3cS$w~ؤ$:7) nfe濸zaS!B'AB]HȤX]ʖ/,4j:eegF*}_¬~O]ŪM_K+n(ggU,O^E >dYW0 #ĸQ<+ H&q.jyw|#ɃL]~H !BdHHGQ,:cțuڴK:idžڰ BS\xz9i,I2Q.?^~`7U-x޿8{`'yB6B@Z\ s:bh:_h; t'3[ v I!BJOolX>brV֤:U$•4lYVFj"R%7<j87FYQׯbŏ ̬4Rf55 :D&}kH4k j{E3w1 !B !Iz`>L"f5DbRд(YmfRycNJrC1=G{8Y*CϟxKd!ڬ8?% z9WHH2 =q6/ї.;>x˨c2L$@㊄@->p=}FoI!BJnacte-",l8ra>p192Ghu"٪dfYKU0wP#,(o7}+^l&@GG]u HiNt\H8 3< s1􈴐93Ǒpf@a=$" !B"!Ip*AtQkpigeΥZ]etczõ/yv[U]g8/wۼFXQ 8Gf]dD#h0OҲƍشwQ 3Ac 8pxҵS# 9HB!BHH VΝOݕZɺWؓFGH_tsFvLpbs" ù_~htQQ430R눴zyyo.Ycd!¥pl`rҗ[* WXT0B!?$ncZ\Yg}Vuyl1%FŚo(K V֨ 17} G\<pZZt$UC5jI6G_J2BmIL@AZ<&hR "SFC'7i5]B!@BmjXҎn-`w)>7ޭAB!@B#vW93 -̖$kGk76oAdR]Rp1vp .QU[s;?4FTt2&Zi#:0|u$D4ut("TOKZl)gf+oJ;NҠ !BC"!I]zUK[}9[suyRhV=,>moQ3;•a_kruyss32snh ww_P816fuXCR8ͳYPf#1ۼ#n| p#Y_솥Y G_8d B!$>L wqKz*ۢNS҄h[{1tbZ ƥj<(o?Q!9JnY::q*07p$<=LVT|$@owM{B~Gc}goՠ !BkbO+֋/~{s1l⏲.j#ahb7Y<6-j):hK-_Z+W(Dr58׮"qh IҴ8ݢ0b'DuGu$(Ԫ#̢jdqWg* n : 7# 7B!O@in>v?\E/6h )׍!.cCH%jHLyؠ&l8pίv͛k]ye_E$'A1.قgkɘ].uc,Qttѥ-p"r~/Р !B$63\n\ez%Z+R$)-QXӃP/'R\6a2k|t03/*C4IF=̢Hh0Ǧ,A_XZ/JB?@:tG,5Kk0AAAq㪸SHB!B9$$.-<>}W۰z0aey+iEkuhےdl0+I@c};+ĥ_\ fvm!5z0 `Ehʀh7-Y.90l*:DI7Mm] YZr/esV_ p$_$B!@<#GZp!眳iP/[ +V>:f4yJpGjO:P;I)qwFVU/|ZZ_6df(~p`g\ifIBQK] ZraT(N"ꂶqV,}֙GQG6K%tvqweGSR1X2gQbvR린w6F#> Q7ti/ S !B$*Kowߵ09Z_T:3;t=TW|3fC¹* Ý3s7iTāN*犉x5 >ͼkE1,QIn$YTRjZ-O6*o ׍py _> B!O3¦MOׯ~8|!ιΡ*ud YZ{ kUrvL97?^tх@+[$"p;iڤ745!n1[]JK!GJ(5%D q+a1d"I!B Ie˅MwN]`9G}ekJQ\3F(%rep >{IO;$" !Bw$ >X}cns/ssh)z)?4JssÙU_o첇"R868{#+& d@AjTVQ6yb~٨Bdۥ4R 4yGy7'c[>U+B!ӌ$O1x¦M;Z3(t\K52u~RQ8:2!N;K9o'$B!AB'YڼyqaӦzntz$8^4KN+prn~G5Ν?>{u;ZrS;+ICt[R߈H@uf,!Y8s v ]J Zv 5B!B%@}YGgu~V m4WՂ/.^>_[-ﻩ;)dkA n6y#tFET0xƼCJ,ۮQH2vQthm@Y Tm `lؑ'|c^/};\!B!~Ūtmocz^oCHo%%CUY>nf[ ?QD 3D$D BcH83L%nua.׏NYv(Wk☂Ij;.o?xM_J+B!^DBx6PrBQo wx 3x#&X-EP Icb7Srh`fd(s {9qV[\ gðDGΘ lfS^9 B!{,@%kB,u7 /㰉u'|HLQHԬٸmqCDR}MHtf5_fODB!-Bg'߄g;uw6 bD:jof#Eu51QRlL:Rdk@#<5.hfB!xQ6!x'] )$"\c6bVG!$1mjţ]-W3mYҒb.#PFrU+=4 B!0r$ !ij?08LT8w":G )l[pة`1 >fGxlma2y)0 IXJbHDB!bBIB,ssV0 ߼g8f.8\T{c.^cvWwnK BGR7DȔ`1;kvCr`xD$!B!$$ !ij?z/;&]ICIlI"Žr$EK B*--5pMRжZ5"ڝv e ~]"B!*mBU}ߟ)λE k 6m-osT#oFG Z=ʞѳĩ:~m.0 xB!א#I!s?}+V^kf/5ZπrQ25QsIlhH fnpᰪ,Px֫)I!B9b HP e8AX*cXgGǶke>q\;=5!mΑ7~f$ !B@BB<üƋ *P <8+Ag!VZ+9k)s7:n>e#!gӳ!Lc>26=HB!BHm_wiKpʀmYdA[tr} (`f m_?,5B!BHHB=埊 I01\@`j{Xw^딬風8x !$[p}{O8-ZZ20nM:%c!B!`$$ !B_`r"0CKnvU?| dD0RڳGnƽVKOd+urm:nqRB!8e*_WD@* %'T# HIX20j(e}X:9|HlGo[xFqx*[е $B!HHBϜL8;1*>>, Er2q'Qvk|#|HJoFylז:[* l9xU&B!h!!I!~k[~{j/H(0ƢrF,f7iEPv ):,96{KEptBp!mp{}Z!B1$!x*,ࢫ)/V8& hT@<̬xRQM@ ,vmsShf!.$( 37jUݥ-JTcE؍Χ,$!B!rHHB'~7WV; E\/Q HYIɺ27R<<;/L jM63EGRE2>٭$-.$ !B! IBgpKwA𧂮Jؘ2RiZnHGaނTW,+tCSxa ;pQN`2\E( CB!BHHB| z(`|16hT!LF1Cɝx#hY \Lj "@$f7^!a}0[4/w!JB!b$8nDY {yFPEQբͥ@];,l75ndgW6K[xA4Be@*Wxv~&-@o C?B!b !IqO4j=w؀+Ŭ1|ôwyrQ)n4¬ou6_yImE|mww0 L1ۋ/{\!BG$xsi@2h+wz) `ZPTVFR)\l<31q);Ea܎+B۝n82<ئџs!B!ӂ$!ij/|X9.VG@Dpx1 EeQA-& NٚƉTw^U׶͚P3XpB9n 2rw!B!ӊ$!ijKS!TU<ǃ\`eiָ,f5خ8#-(s.5]Ur$s)=1{ ٲھ*#s!B!^CBb-6<qp(0=X1+c )"Psw4hp0`=U(3KG>A 3mu~MWPzy6Pu]`*k@NX&7/sΊDw|?B!BHHB[`j³S5" 9XFS sӎs.ku6ƻ\:qO+V@< Mq$ExB!<<}Hp5QpPܰ:07)èU:pM6<&=>fay5C(e3(j,rC [4î%B!bAB!/[ N# !ϭjrQ1l#Tj"4m-({LzGBCe%6ޱop=$I^I^gǮ2 [\![hцTA5V1+jC4\"E}0T8Q?=gT+Z[D@;Zy?b̥V+x $I^JI߭7::Q^yb}3"\Bl>hkbz]&VDͫ2ʱlcT>m{O|VI$I: $s~GB:u(v:" RlUGQNKR&*8֎W#혜]F8Vmk؆ [[$IS IBFYG:QڱVr 3AOLep Ɩ}~|9 rl/+" :}/wظr jx$IS I|1\|!֨AOVmkX@OĉC5-kȣk4 ŞogAQ4ܟql[[ڝD:*mԧp k$Itܚ)͗퇡ъj`5"&& qr1-ZqΜLy0vIQQh] sЪ6LLe/xxמGxbc%I$$IWF ^nT{8PӇA(*cZNj2UڰqQ/jƘ7 B9FË꼥Œv v!CO,<׸n} _T$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$I$Iv|IENDB`caronc-apprise-dfec414/apprise/assets/themes/default/apprise-success-128x128.ico000066400000000000000000002040761526720371000275460ustar00rootroot00000000000000 (( !8KVdpwwpdVK8! GG  JJ =qq=,,D  # ( - 0 1 0 - ) #   D B. %I0`7o=yA"F$I&K'N(O)O)O)N(L'I&F$B"=y8o0`%I. B R+ 0`D#J&L'M(O)O*P*P*P*P*P*P*P*P*P*P*P*P*P*P)O*P)O)M(L'J&C"0`+ RN' 3eM(O)O)O)O*P*P*P*P*P+Q*P+P+Q*Q+Q+Q+Q+Q+Q+P*Q*P+P*P*P*P*P*O*O*O)O)L(4g)  N & 'N?} G$L'O*P*P*P*P+Q+Q*Q+Q+Q+Q+R+Q+R+Q,R+R,R+R+Q+Q+R+Q+Q+Q+Q+Q+Q+P*P*P*P*O)O)O)F#-Y,  ] !B5iE#G%H%I%K'Q+Q+Q,R,R,R,R,R,S-R-R-S-S-S-S-S-S-S-S-S-S-S-S-S-S,R,R,R,R,R+Q+Q+Q+P*P*P*O*L'=z &M]* 'M@} D"F$G$H%I&K'K(P*R,S,R,S-S-S-S-S-T-T.S-T-T.T.T.T-T.T.T-T.T-S-T-S-S-S-S,R-R-R,R,Q,Q+Q+Q+Q*O*O)N(I%-Z *e :@ C"E#F$G%H%I%J'K'K(O)S-S-S-T-S.T.T.T.T.T.T.U/U.T.U.U/U.U.U.U.T.U.T.T.T.T-T.S-S-S-R,S,R,R,Q,Q+Q+P*P*P)O)L'"Ee0 8lC"D"D#F#G$G%I&I&K(L(L)M)S-T.T.T.U.U.U/U/U/V/U/U/U/U/U/V/V/U/V/V/V/V/U/U/U.T.T.T.T.T.S-S-S-S-R,R,R+Q+Q+P*P*O*O)C#: 0^B!C"D"E#F$G%H%I'J'K'L(M)N*O+R-U/V/V/V0V0V0V0V0W0W1W0W1W1W1W1W1W1W1W1W1W0V0V0V0V0V0V/U/U/U/U.T.T.S-S-S-S,R,R,Q+Q+P*P*N(;v) .$F>{A!C"C"E#E$G$H%H&J'K(L(M)N*O+P+R-U/V0W0W1W1W1X1X1X1X1X1X1X1X2X2X2X1X1X1X1X1W1W1W1W0W0W0W0V/V/V/U/T.T.T.T-S-S-S-R,Q+Q+Q+P*O)L'/^.H 4g@| A B!C"D#E$F%G%I&J'K'L)L)M*O+P,P,S.V/W1W1X1X2X1X2X2Y2Y2Y2Y2Y2Y2Y2Y2Y2Y2X2Y2X2X2X2X2X1W1W1W1W0V0V0V0U/U/U/U.T.T-S-S-R,R,R+Q+P*P*O)?~! HG, :q?{ @} B!C"D#D#F%H&H&J'J(K(L)N)N,P+Q-Q-S.V1[5\7Y2Y2Y2Y2Y3Y3Z3Y3Z3Z3Z3Z3Z3[3Y3Z3Z3Y2Y2Y2Y2Y2X2X2X1X1W1W1W0V0V/V/V/U/T.T.S-S-S,R,R,Q+P+P*P*H%8G8$G=v?{A|!B~"B"D"F$F%G%H&J'K(K)M)N+O+P,Q,S.S.pR{ʄˆɀ}_[4[4[4[4[4[4[5[4[4[5\4[4[5[4[4[4[4[4Z3Z3Z3Z3Y3Y2X2Y2X1X1W1W1V0V0V0U/U.T.T.S-S-R,R,Q+Q*P*O)0^8F0\=x?z@{ A~!B#C#E$F$F%H&I'J(L(M*N*O,O,Q-R-T0ăϝsϜ֠ғsR\5\5\5\6\5\5\5\6\5\5\5\5\5\5\5[5[5[4[4Z4Z4Z3Y3Y2Y3Y2X1X1X1W0V0V0V0U/U.T.T.S-R-R,R,Q+P*O):t FE1_=w?x@z@}!B!C#D$F$F&H&I'K(K)L)M*N+P,Q-Q-S.ŅBN<"ujʘ٣}gB]6]6]6]6]6]6]6]6]6]6]6\5\6\5\6[5[5[5[5[4Z4Z4Z3Y3Y2X2X2W1W1W0W0V0V/U/U.T.S-S-R,Q+Q+P*P*>| E, 1`w?y A{ A}"C"D#E%F%G&H'J(K)L)M*N+O,P-R-S/wZϞES?09+|pڤ֜hfA]7^7^7^7^7^7^7^7^7^7]6]6]6]6\6\5\5\6[4[4Z4Z4Z3Y3Y3Y2X1X1W1W0V0V/U/U.T.T-S-R,R+Q+P+P*D#, 4e=u=v>y @{!B}"B~"D#D$F%G&I'I(J(K*M+O+P,P-R.R/\9Ȋ}8C3ŕڥЎqO_8_9`9_8_8_8_8_8_8_8_8_8^7^7]7]6]6]6\6\5[5[4[4Z4Z3Y3Y3X2X1X1W1V0V/U/U/T.S-S-R,Q+Q+P*G%(  6hw@z!A{!B}"C~#D$F%F%H'I'J)L)L*N+O+P-Q.S/T/|aӢ"~ڥЌgB`9`9`9`9`9`9`9`9`9_8_8_8_8_7^7^7^7]6]6\6\5\5\4[4Z4Z3Z3Y2X2X1W1W0V0U/U/T.T-S-R,Q+Q+P*G%1_w @y A{!B}"D$D$F%G&H'J(J)K)M+N+O-Q-Q/S/T1t fy\ܦ̀d>b;b;b;b;b;a;a:a:a:a:a:`9`9`9`9_8_8_8^7]6]6]6\5[5[5[4Z4Z3Y2Y2X2W1W0V0V/U.T.T-S-R,Q+Q+P*?{  Z#'M:p;q=t>v ?x @y!A|"C~#D$E%F&H'I'K(K*M*N,O,Q.R.S0T0kKӢDQ>VfMܧыg@cv?w @z!B|"C~#D$E%G'H'I(K)K*M+O,P-Q.R/S0U1~c̛e>e>e>e>e>e=e=d=d=d=ct>v ?y!Az"C|"C~$E$F&G'I'J)L*L*N,O,P.Q.R/T0_>ʐs~qިݧbf>f>f?f?f>f>f>e>e>e>e>e=d=d=d=ct?w!@y!B{#C}#D%F%F&H(I(K)M+N+O-P-R.R/T1V1hӣ8C2ިިՎkEg@g@g@g@g@g@g@g@g?g?f?f?f>f>e>e>e=d=c;cџTbLÔߩަahAhAhAhAhAhAhAh@h@h@g@g@g?g?f?f>f>e>e>d=ce>e=d=d=cu @w!Ay"B{$D}$E%F&G'I(K)L*M+O,O-Q/R/S0U2iJ͟9C3 ߩަrMjCjCjBjBjBjBjBjBjBjBiBiBiAiAhAh@h@g@g?f?f>f>e=d=d=cs ?v @w"Az#C|$E~$P1cHlRpVpUlR`AO,P.R/S0U1U2mӣwdwZolDkDlDlDlDkDlDkDkDkDkCkCkCiCjBjBiBiAiAhAh@g?f?f?f?e>d=d=ct @v!Ay#Bz#mU–×ęƚǙbCS0T1U1W3iIԣդեZjRٕpIlDlEmDlElEmElDlElElDlDkDkDkCkCjCjCjBiBiBiAh@h@g@g?f?e>d=d=de>e>e=csQ5w]kU&,# ͠~W5U2cCpSfD[7eAyԞ٦ڧu4>/CP=׍qInFnFnFnFnFnGnFnFnFnFnFnFmEmEmEmElDlDkDlCjCjCjBiBiAh@g@g?f?f>e>d=cd=d=c;b;a:a:`9_8_8^7]6\5[5[4Z3X2X1X1V0U/T.T-S-R,Q+&K90\6h9j:l;oe=d=c;b;b;a:`9_8^8^7\6\5[4[4Y2Y2X1W1V0U/T.S-R,R+H%# 6g7h9k:me>e=ce>d=ce>d=d=ce>d=de=d=c;b;a:`:_8^8^7]6\5[4Z3Z3X2W1V0V/T.T-S-R,@~"e3a7g8i9k;nS:6>2shˠ̡v[S1sVѣ*1&d=d=b;b;a:`9_8^7]7\6[5[4Z3Y2X1W1V0U/T.S-S-Q+ 2 6f8h8j:k/ߙقdwNwNwOxOxOxOxOxOxOxOwOxOwNwNvNvNvMuMuLuLtKsKsKrIqIqHpHpHnGnFmEmElDkCjCiBhAh@g?f?e>d=cd=dd=cd=d=ce=c=b;a;a:`9_7^7]6\4[4Z3Y3X2W1V0U/T.S-R,;u /Z7f7h9k;l;m=p vb29.ƝɠW5U4‰***jlEkDjBiBiAh@f?f>e>d=ce=ce>dr ?t"~j›HRB ȟȝfJP/}$N^GhnFmEkDkCjBiAh@g?f?e>d=cd=cd=cd=cr ?t"Av"Cx$D{$F}&G(I(I)K,M-ɝvl yyy }WsJqIqIpHoGmFmElDkCjBiAh@g@f>e=d=ce=d=cd=cd=c 3a7h9j;l;n=p ?s @u"Bx$Cz$D|&F'G(I)K+M,N-P/Q0T1U2]=uΛԥզ|r19, !!!111AAA888kvNuMtLtLrJrIqHpHnFmEژ+3' #|pިۡnJdr ?t!@v"Bx$D{$E|&F(H)I)K+M,N-P/Q0T2U3X4X5[7]9_:_r ?t!Av"Bx$D{%E}&G(H)I)K+M,N-Q/Q0T2V3X4Y6[7]9_:`/?L9ڦznGxSҟ&.#{ܧvb;`9`9^7]6\6[5Z3Y3X2W1V0U/T.;t %F8i9k;n=o >q ?t!@v"Bx#D{%E}&G(I(J)K+N,O-P/R0T2V3W4Y6[7]9^:`c?f@e١ޫ͝>I8JJJ___qyQ}Ulb=I7^nFŖ7B2բۣjE`9_8^7]6\5[5Z3Y3X2W1V0U/T.6h58i:l;n

q ?s!Av#By#D{%E}&G'H(J)L+M-O.P/R0T2V3W4Y5[7]9_:`;b>d?eAgBtQ؝߬BN< >J8{SyQ~VZlRsh׌oHrKؒvk ܦs`9_9^7]6\5[5Z3Y2X2W1V/U/S-,V" 8i:l;n

q @t!Av#By#D|%E}&G(H)J*L+M-O.P/R0U2U3W4Y6[8]9^:`;c>e?e@gBjCkE֔O]Glll---@@@III ΝkzRzQ}V(0$ҟ|YmE}Zݢף%,!ZkQ٤ڣ`9_9^7]6\5[5Z3Y2X2W1V0U/R, ?f 8i:l;m

r @t!Aw#By#D|%E}&G'H)J*L+M-O.Q/R0T2V3W5Y5[8\8^:`;c>d?e@gBiCkEmGӇUeM---IIIcvZ{SzQyQ{Rݎshu׍lElD|ިqg"ϝۦ~__8^7]6\5[4Z3Y2X2W1V/U.P,% f26d9l;m

q @t!Aw#Cy#D|%E~&G'H)J*L+M-O.Q/R0T2V3W4Y6[8\8^:`;b=d?f@gBiCkEmFqJӄݩGT@qqqOOO%͜X{RzQxPxOeܧ7B2L[EܦpIkDrMݤ ۦ·_8^7\6\5[4Z3Y2X2W1V/U.N) 2)M:lr!?t!Aw#Cy#C{%E~&G'H)J)K*M-O.P.R0T2V3W4Y6[7\8^:`;b=d?f@gBiCkDmFnHqJ׋)0%uuular|S{RyQxPxOwN׀r$աgkCjB҆ߨ9D4ey[ۦל_8]6\6\5[4Y3X2X1W1V/U.E%/ 9kr!?t!Aw#Cy#D{%E~&G'H)J*K*M-O-P/R0T1V3W4X5[7]9]:_;b=d?e@gAjDkDlFnHqIrKۑߪ!'~V{RzRyPxPwOvNySϜ}kCiB}[ިasW7B2ۥؠoL]6\6\5[4Y3X2X1W0U/U./Z 9k2^;n=q=r!?t!Aw#By#D|$E~&G'H(I*K+M,N.P/R0S1U3W4Y5Z7\9^9`;be@gAiCkDlEoGqIrJsLZ|p444 N]G}T{RzQyQxPwOvNuMtL{ԡ,5(֌jCiBh@Ր ڥ٢g]6\5[4Z4Y3X2W1V0U/Q,F"A;n=p>s ?t!Ax"By#D{$F}&G'H(J*K*M,N.P.Q/S1U3W4X5Z6\8^:_;b=c>d@fAhBjDlEnFpIrJsKuMeFS?!!!WWW  ԡc{RzQyQyPxOwNvNuMtK|Μ'/#“ՌjBhAh@{͛  ӟ٣m]6\5[4Z3Y2X2W1V0U.8l $ ;o=p>s >t!Ax#By#D{$E~&G'H(I*J*M,N.O.Q/T2U2W4Y5[7\8]:_:a=c>d?fAhBjDlEmFpHqJsKuLwO|Ӡmcވ{SzQzQyPxPwNvNvMuMsKېΜԈjBhAg@q֡  ̚٣o\6\5[4Z3X2W1W1V0U./ s 3`=p>s >t!Aw"By$C{$E~%F&I(I*K*L+O-O.Q0S0U2V4X4Z6\8]9_:a(Kr ?t!@w"Bz$C{$E~%G&H(J)K*M+N-P.R0S1U2V3X4Z6\7]9^:`e@hBhCjDmFnGpIrKtLvNwN~XQ`I***HHHvvvvkmzRzQyQxOxOwNvNuLtLtKׂި1;-RaJۦaiAh@f?y ڥ٣m]5[4Z4Z3X2W1V0U/3b>* :l>r?u!@w"By#C{$E}%G&H(I)J*M+N-O.Q/S0U2V3X5Z6[8]8_:`;b=c>e?gBhBjDlFnGpHqJsLuMwNwOpբ!!!SSS'.#ߑ|UzQyPxOxOwNvNvMtLtKstiyiBiAg?f?ԍ{  ڥ٣i[5[4Z3Y3X1W1V/T.27f=s?u!Aw"By#C|$D}%G'H(I)K*L,N,O.Q/R0T2V3X4Y6[7]8^:`;ae?gAiBkClEmFoHqIsKuLvNwNxQޒqfgyQyPyPyQxPwOwNvNxQy,5(НтiAhAg?f>ۢg{]+4'ڤء}^[5Z4Y3Y2W1W0V/E& :!@=r?u!@w"Ay#C|$D~%F&H'I)K*L*N,P-P.R0T1U3W4Z6Z7\7^9`;ae?f@hBjClDmEpHqIrKtKvMvNwNcҠ&-"WgN݌yQyPc}ۉڇ}{ڋΜ_qU|pwThAh@g?uRݧAM:TeMڤמoN[4Z4Y3X2W1V0U./[:=s?t @w"Ax#C{#D}%F&H'I)J*L+M,O-P.R0T1U3W3Y6Z6[7]9_;a;b>d>f@gBjBkDmFnGpHrJsKuLuMvNwNلi}_Ӡ]xP{ОȘؤ͜~SdK#KZD҃iCh@g?f?Ó!'~٤֝`:[4Y3Y2X2W1V/Q,Y$B>t @w!By#B{#D~%E&G'I(J)L*M,O-P-R0T1U2V3Y5Z6\7\8_:a;bf@gAhBkClEnFpHqIsKtLuLuLvMwOuj}xPav 1;,ݠ{Xh@g@g?kEٟ{o ʘ٤ό[5Z4Y3Y2X1W0U/9oY =r @w!Ay#Bz$D}$E&G&I(J)L*M,O-P.R/S1U2V3X5Z5\7\8_:`;be>gAhBjClEmFoGqIsJsKtKtLuMvMxfz\,5(ӡwOwNم٥"(8C2٥ߨth@g@g?f?uԟ7B2GU@ӟ٤e[4Z3Y3X2X1V0U/ ^"B@v Ay"Bz#D}$E&G&I(J(K*M,N-P.R/S0U2V3W4Z5[7]8^9`;bf@gBiBkDmFnGpHrJsJsKsLtLuMyQ sgwNvN܎բ  \nSأсiAh@g@f?tQ؜ur٤٤a<[4Y3Y2X1W0V/4d_ 8kAx"Bz#C}$E&F&H'J)K*M+N,O.R.R0T1V2W4Y5Z6\8^9_:`;c=d>f?gAhBjClEmEoGqIqIrJsKsKtKtL|cwZ4>/ڋwNuMuLیީCO<M\EujChAg@f?g?ҋН(0$̙٤|[4Z3Y2X2W1V0P, j%E@x!Bz"B|$E%F&G'I(K)L+N,O-Q.Q0S1U2X3X5Z6[7]8^:`:ae?g@gBjCkDmFnFpHqIqIrJrJsKsK_О̚auLtLtLtϝO^G 2<-qfϜިޥdjBhAh@f?f>σݧ+3'ncڤ٣iG[4Z3X2X1W1V0*Pj :nB{#B|#D%F&G'H(K)L+M+N,Q.R/T1U1V3Y4Y6[7]7_9`;a;c=e>f?hAiBlDlEnFoHpHqIqIrJrJsJsKۏިFS?`rW؅tLtLtKsKsKߝިߥԈqLiAhAh@g?f>τۥN^G&."ڤ٤}]7Z4Y3X1W1V0H' u0 Bz"B|#D~$F%G'H(J(L+M+O,P.R/S0T1V3X4Z6Z6\8^9`:a;b=d?f?gAiAkClEmEnGoGpHpHqIrIrJrJot$ؤ|UtKsKsKrJrJzT؊ޡٔ~yUjBiAhAh@g@rN҈ڥVhN ٤֝pNZ4Z3Y2W1W1U/%Fu-UB}#C~%E%G&H'J(L*L*N,O-Q/S/T0V2W3X4Z5\7]8^9a;bd>g@hAjBkCmEnEnFnGoGoHpHqHqIsL!znqrJrKrIrIqIqIpHpH~Zdkkkhb}ZqKjCjBiAhAh@g?lؙҟ:F5~q٤٤y[4Z3Y2X2W1V0A|#4 e>g@hAjBkDlDmEmEmFnFoGoGoGpGacwZw~ZqIpHpHpHpHpHoGoGoFnFqJoҀ}k~[uQxS`u֐ިў=I7HWBՠ٤٤oL[4Y3Y2X2W1V05 )NE$E&G&I'J)L*L*N,P-Q.R0T0V2W3Y5Z5[7]8_9`:bf?h@iAkCkClDlDmDmEnFnFnFoFoGʙCQ=ՂqIpHpHpHoGoGnGnFnFnFbޠΜĕ֢ߩݧўxcwZ3=.QaIأ٤ء|][4Z3Y3X2X1V02_ K7iE%F&I'J(K)M*N,O,P.R/T1T1V2X4Z4[6\7]8_:a:bf@h@iBjBjCkClClDlDlEmEmEnFy:F4  ZlRԠޡ|XnFnGnFnFnFmFmEnElEqJݠz%$'/#-6).7*+4'$+   wlآ٤ءb[4Z3Y3Y2W1W0C%K C}#F%H'I(J(L*M+O,P.Q.S0U1V2W3Y5[5\7]7_9`:b;ce?g@hAiBjBjCjCkCkDlDlDlEmErLݝݧڤڥߨznFnFnFmFmEmEmElElDlDoۦ'/#٣٤٣}^\4Z4Z3Y2W1W0Q- E$G'I'K(K*M+N,P-Q.S0T0V2V2X5Z5\7\7^9`9a;cg?h@iAiAiBjBjCkCkCkClDlDlDxTڕ{mEmEmEmEmElDlElDlDkCkCр fz\ڥڥڤ֜sR\5Z4Z3Y2X2W1U/- "0D%I'J(K)M*N,O-Q.R/S0U1V2W3Y4[6\6]8_9`:bf>g@g@hAiAiAiBjBjCjCkCkDkCkDlDg|}tvRlElDlDlDlDlDlDkCkDkCjCjB}ި#)  3=.h|]Λڥڥء}d@\4Z4Z3Y3X2W1U/ ="? >H&I(K)L*M+N,P.R.S0T0V2W2X4Z4\6]7^9_9a;b;d=d=f?f?g?g?h@hAhAiAiBiBiBjBjBjBjCkCkCkCkCkCkCkCkCjCjBjBiBiBiBiAhA^ߩCP<%ER>shΛڥڥڤ͇uT]7[5[4Z3Y3Y2W1V/&I?a#CI'J(K*M*N,O,Q-S/T0U1W2X3Y4[6]7^8^8_:b;cf>f?g?g@g@h@hAhAiAiAiAiBiBiBjBjBjBjBjBjBjBiBiBiAiAiAhAh@h@lE֐ި٤עНƕӟաףڤڥڥڥϊpO`9\6[5[4Z3Y3Y2W1W1-Va"BJ(J)M*N+O,Q-R.T/T1W1X3Y3Z5\5]7_8_9a;b;d=d=e>e>e>f>f?g?g@g@h@hAhAhAhAiAiAiAiAiAiAiAiAiAiAiAh@hAh@h@g@g@g?qMԏܤݦݧݧݧܧܧܦۦۥڣؠ֛xmK]7\6\5\5[4Z3Z3Y2W1V00];F'K*M+O+O-Q.S.T0U0W2Y3Y4[4]7^8^8`:b:cf>f?f?g?g?g@g@g@h@h@hAh@hAhAhAh@h@h@h@h@h@g@g@g?f?f?f?e>e>{Yo}σφφφ΄~scoM_8^7]6]6\5\5[4Z3Y3Y2X1S.'K. H'L*N+P,P-S.T/U0V1X2Y4Z5[5]7^7_9`9b:b;c;ce>e>f>f?f?f?f?f?f?f?f?f?f?f?f?f?f?f>e>e>e>e=d=d=d=ce>e>e>e>e>f>f>f>f>e>f>e>e>e>e>e>e>d=d=d=de>e>e>e=d>e=d=d=d=d=d=dE&W0W1Y2Z4Z4[4[4[5\5\5\6]6]6]6]7^6^7^7^7^7^7^7^7_7^7^7^7^7^7^7^7^7]7^6]6]6]6]6\5\5\5[5[4Z3Z3Y3Y3X2X1H("A5c1G(X1Y3Z3Z3[3[4[5[4\5\5\6\5\6]6]6]6]6]6]6]6^7]7]7^6]6]6]7]6]6\6]6]6\5\5\5\5[5[4[4Z4Z3Y3Y2Y2X2I)5c* A{%S/W1Y3Z3Z3Z4[4[5[5\5\5\5\5\5\6\6]6\6]6]6]6]6]6]6\5\5\5\5\5\5\5[5[5[4Z4Z3Z3Y3Y2W1R/@z$* H )O@x$N-Y3Z3Z3Z4Z4[4[4[5[5[5\5[5\5\5\5\5\5\5\5\5\5[5[5[5[4[4[4Z4Z4Z3Z3Z3Y2O,@y$)N HK ;4bK*Y2Y2Y3Y3Z3Z3Z3Z3Z3Z3Z4Z4Z3Z4Z4Z4Z4Z3Z3Z3Z3Z3Y3Y3Y2Y2X2J*4b; K- 62`G(W1Y3Y2Y2Y3Y3Y3Y3Y2Y3Y3Y3Y2Y3Y3Y2Y2Y2W1F(2`7 -* "B.X7h>v#E'I)J*I)E'>v#6h.X#B* VVSS 88 ,nn,?????????????caronc-apprise-dfec414/apprise/assets/themes/default/apprise-success-128x128.png000066400000000000000000000420461526720371000275550ustar00rootroot00000000000000PNG  IHDR>a pHYs   IDATxw\guϽSvfvgjw+zfInrB&ɛ` ͐@z1! l+rm٫fh{3s{geTdď>ݹw9)ssx{=G_|` PA@@Y $q< xޚ?dup)pϋG6Yoh{L{S˩>,qDN;+K6D ֗+%P + >HdL,Ef,Iz$dɞqGȌ$O;K`o pb#`!t #"(]XGZBh>-pSIy-)hu1Ht ;@~Rȴ< P| [4QTNZNdjAhZr}T*']c#d(1dp#qx%WX7ԗRS5E pNrA}!'#D29'5^Ft9VK5<6@c@+ZXLxVZByQl $ۡs1TC"%ȬJ3q`"hmF/2z[}([4?[Jhz%en\ @Ro~@R]Ɛ&S$:G9oHef02W`5=`I7<(z@+\MyQ$Lc/w[m%L0Z"Q:n}b*y76x` 79Oh!Ry.Є@hBDžk?b 'b>n^sVmG" o݅TtxD~d~-W,$<\4]C8V)vO|JS Ñ6[ߥȪjl|2)%~{>UO1 d< .]@KTE}a_ˉ~Mɽ-D"ErLLP':^5RJ vyʒTתPz*Z8@lG"n$|{ԙ7S:"e@峈t[ꄢ9HV( {X6xu"d,Ұ{ T7@b?0ľ=xa(i}YT2 5DMB 4 ! mU[5+(HmUP~cZ~%m8}5;+VYr+ SsLw:E m:xfDz~K4W}%UД1lMBPhcbE;woTUM%kXU`;}Tdɮ14l',S:V9硗G-iA0,`Ք^XpR dQTP-z.XI4!mgHd6D&Hj   ) b6=ČYuL9Dt\=[̀ĵ@$y0%BnU@3 p~BU[9a5%& p:pfЊ]p˘k}*V0'Dͯj >ky<@\='XXYRΫ_Eu jcde2Mi sٵQ9S|D](ՕlIf&y3tL"-&(Hafb].`q{l7+ 2C7$VpTݭ"u&(fCL{ }VlQA&M}ԇф;9hj;(~?ܺ $'\2`0H+OH) Bh$# W0c,v PU_C]s=kr F 3.:ý<{SNBihBJ27>d~I[*ziO2YbN (^ڵ/d>Mf^h%z.wfk ED!UAy\An3.ew/c8 w?gб6a `Z=)T9u+Ȍ$8OYE2J!0H&kl{N_{?Ad/pҰ0\4t?]?4bXaTJoZPuL[&\>~ P_Sk@N.)vU&C̋N-{zu1m ΚFmCnƤ bsM'x}?BOt:WazC3Xv5+/\(]='@FXr*|fw3I$*#çV?ݠ4@{ SL ǃԇ"Kb!`dbi`UUqEg3YFYs+kT `m`0=Kg()#M2b4H|=cxmh/fξ<\gv' 2g|h6k #snbɃ|5V͑>1OR5e=34rj)" nJZ Pa O9f}mGx{{>Tg/MsӲh=DM3էDAHeg! k3ĹG/Dmө VГ0b1ɾu9F8jdlyWm'4|Gx3_a|{ىIո.+MG A2x*ZיyZCH\sI ^JӶjudnM`%w|4w t#%@m@| -Dq_+q~~C#H,5-U:Ta]?"c]\3o"w:A s+S(U6r4y*ʭ0oUsZlr5Pd(s~^kM./%RDZyeӘ?ͯkyWnЅFG/Ћg%3_΅f&w/-w120LjЅάH=A3lGUseI%R6h|h$ + BB+~#nYK! pAuui"RmzU 45%O*ڧ",剮i ƒ&~,G7飀0^L?` 1#0#H0qn":_)%71L1g||>?S5DaźA)H0j-sglfi h1P !k8 1fW- mS~T8vu oWӦ=/|f!WLXI|||\#Yϒ&}: u}w|_F0/:Umʡ1p2Vn}<#/aZ~)G߉25Ni+vEYIzR(ȕFҜ6utKhBr!4r¸w}fit6w\k 4 ݧ4Tn}YYԗTXB^ka^e j=^⼼ڢR? xD7t{ΊWt&lihG dGGC?OXȔJ׼s.xmsŅDB*8f4kJ KXqcUt-w9֯î\>:zdk>4M=֝R,Ͻ`aSd2ŊPP_:OQ0[].pB p 5S~tJ GdOsZuS\@rz_-'EZ>;6XڪErn.q#!XA"aXST̋#{vy4m:XXl*Ot쵃;ѪrCw3Ii5kDҎQWl~:oRL|wM鸲rn)ng"Ѕ`Yt>܃p}?p=u*0cx/ ]l<=ʝO_˧۽0 "slI,QFYKks﫯+VhT`7._Ry6@-pz <-m(VR*:[]zm;rhT"}3hDzBuo三CHӤSi=<7o|ufM|}Пf"c4ЈC9ulP6@ޱ` Qe)+"j9{)Um/0,!=ȊyhBo7}a…~ƶmLWA.>yNB&,%\O}IM~5۴ 쎵z민%g.w!|_!Θ%`6MAsH5ħUsS 5k cEc2Y!_iW"Pq]HI^+(-R}yKVg0<'ͽjAԄ񕗸'k3Ĵ{Pa1BZsg h+W;$zR`~ CփXPuaM75Lj\cL*V;~wM;ˆk:G _Lc1@ ' J]8p-\IGƱRԋr- T<:Ðd Sii)3g<.{3䪫x;c#`n _gN5ʢ'|6: 1HynRMܐ4yO^ӝXYl %FIsESR!;@/\{E۱&K:"X@/̙Uх{+𩮮@4>D\b#[t,:T|6C"~=SmQeF 0岖).oX~,vEY_YHwPzlʰ_']0%to￷Ҵ5qFenL;ک5ϟϵ^y;cM:O cjғixD U{lƾ &_.NSm6yLDeb6p,pYI}%#)%JFtݺu'>E[H >MgqLt+w@ 3:8؀Ocx4i {h2i;Ӵ,4NbeΏ~`"V趢=_9^:V=)W:08v͡)H)ioV<~m.XPT th%*Jjm&*/to˾ciyЗ_b&8кQx # $Gg;.vfV8R7 ۤ?r^pzjBHxͽGtΨY¬ҩS|ξ^?N_|۷wwE׾),~:zU.ƯA`JeI''kw5K^0-RO:v]l. WB ld 5OF.-ƉnN+o94 -lcEͽ˦M:;0 ϚJdW ej~~l}Ej;mj?22U'4vCv8!w1]\/EJ@]QLH#9è~o9YׯT`Wo]ՋtYe>L*P 5ʵ1<UNIE HWJ J`7u!= /n SzKzg}@뮻*7;$'BcI,418Wmd9j%MfVЎ&(Y\>7^w>6^{`CgN{C~*25`C* ۤhHå,lY]us `=o=Ӌ;|0=I3LQ}f*O/eni'~Z>/ލS IDAT7 88q{Ast~s`[x=\N,gžbNs/VG/| lC:‘疯%A4ҩ2 LTq͂_D/@<[o+Vp4=|Eo~RSHG;k*D6}=ϲ#,h~~3$}'_WфX] 0}?#)\b@ J\MNP"Bvr@[Tq5\9BQb<ƿaݏ|bX,ơC<'? DyPOaY;zdlG6Ǹ68<9NI$DYM m_E5Sla#QvΕG McS@u޴r\ iBkܚ3/d'0v`,c߾}y+ϦMذa{ /:wͿf70m uL-#уc$]^?@MC-hY8TvG'#"jD2j"͵\N]? TB ɓ<tZM_F/}=o?d L&ON)^qFhnnSPS/\r%. ?ЄƢh =&e8zpDltP$DE]5t@II Їx'q_}V]xhe2 bkyY$ۆmhҜbDI[V Pz4muedP,~/SFU+RWSF|03}uԵA =ύ 2Fg 3Y2vJ xf#Hʎ;hmmeΝ1118XT*?Ζ-[<׿u>򑏸 }_sjNg]-̵)&iR!tcCO4& 䤫ĠӶ[ BLyr[^ YuӸrF^B? 7~+f̘Akk+eemmm,[,ZUN{//*5VZŎ;<[dRlN+fV,7 D?W)1 |ka9 WU0JQn!Pg!Ř*Y0e&ldrּSuuuxgOQap E`/}KEo̧-*APQ}5Oi,Vk&q#HW0Ȗ`g'4inX޼p|7ًp3i:1U֪}jlݺo[bJ&9x 7o旿%ַx2v`-wdnV#4jA5l6o_˅N"#sJ)1SB Ak%e 幇 = $w~\8y >gRɹzYC$r'''jM/a%T*l]EjLdMIwEͪrHF z}64H/ ;4 =Cʁ > ZEKTZ'/y}ND/]GOOGa)Lf'yew8VtyzBIUR( +$ T&{b%%/ IG%C? ^quM4F]=:=I}'y9.YO T! RF /+O56qj.I4ME)`jp` ; ]A__5eW BԂ^ÜwIߩ/"NH P-v3֔U2Wy݇nz4MP 0m#>4ϼlFy#Q .>a-( %ud//=xfo*ET=^ifJױ= X]lU3^= =ݮry`- Ŭ1 4AɌB?aY/}D졡YӈKId$㢳/`2?gq>{/jcw0[Gc ^& ;fsU#J:xi3U2BjģpΖ**X ~qD2\}kdmu.l#= 3(0KtLO2gJw Y׼ qhC]W>zB6ÿkg_u>]I !W5*DC&Q#'S:{*רS/\c8̰t;))v-hyx/Q)kkj3J)C %Ռ N:V-:r8AHZ򼟯V^*:5cfԈ)` >Upn±yh 0 JpYE&mIP|ͬ\^ɗ@+ R^]I$b"h7_勖 PQS_w ?ñn&ɰn17'LOQV%\)\G~WS$M2WZypҁJ({XՊ=3<R%#Hg|l?NN X ^Pi#@ls2oB*D7޿m_N4!BH+Fi39ϟIIK}4Fj\5 T"]߽{ʺjXiB,ns#U۽^J{W%zn^+(ݔϐ^MrW!kE2@'XyF"ChFehidxra[ʳpp>GƊ^ PQSɌ) M0e͊,>}Lys OQfMRlXFP6/u7g_q!R*et'6rJ`NJ (@ͩb*v2j[Ͽ(0C{};p< 0 A,Epz%z؟rP|C]4Om\N(&H 8Wvg.+EJC O6IZq`_ g5.c]RDB7nNa;F (уMtcHI']wPsD.@:#ոS @˕>#v6@$Kս+ 0!oȕ͚;WB3*-[\Myt=Is5vjZ.,gʴF\ԙTV5.2R&He,ųϦ`'~&=x;w[# Fϋ,!sz6`sƟ*pkPR28Bh6#QJW1;G~gTmKpJinV\-X1me%uRb8ĨJ7+⽋/Η?ƽl:s\_='yȳe4.<Ҭz$ ֺKEHT.=<31# i_Ȃoп=w8rOG),İ6! ^mū) E&\§dedpu,Ҍ4J`ve3Hś>1xH/~N.jgi3;GE( +3+,d)YTYc..A#d2!]p2e^Ŀm\q蒖AM+iۿkڹiFcO 71D|(tj?T߾p@JIW/[CP-62._wI%J}+\ !=旽jVdA?nDHK9::^OM](-̚3m4ϛAi $GLlaWGξ3y)D7\*xk'tNjd'^x;9 zԄ#!^Qao)lW al]h6)u 1ݜ{?i#CG(Ru.`H:`e%(Lh%y-f_*Kԕ W`uV$VhzQ\ɫ ̢O1rF*NoCGv;gGTЕ'`4ҶKD:3q`x!okG?@`^\ak rzOa JGrqLUEcϏn'._:CiCuacCO'v{gMV mC6>RV`$;G_\}+.o2%\ؑ^ҿҊ a ʫ+D&ad 7T1~rk2a P3r05"zCZ!C1 t V׿X4bJm$3^o&tfL|Y$QS#~Bm~l#(d 4X9w)#C~Z4yG:/n繞m [6!;J!cz!:<-,H.(8" PVSwMeY;ta6΅s 4͌h50{Z5ϣ t1R])qV3L:_cz 'P }{fiH]=* pR՟ XYgfDf%XiVM\ֱjkfѬͮjfALB0Liƺ9ti{bR"WIx;WdrWl?GsN? ;+5|Sz,"i W{^]DHMC YHzP A ^ `_UFCUSU(\K{^,65#'H)dd| }P2=(Bi;|#i4 |I֢uG LCzsox{ & yxm͍v'OkP6HA6*Mbj"I}.!UCPdIE.LĈm! :FO!:V(b{B' 6tIb$޽l#6Qm[S^P YH pe5|˗gdj^P!RHW Vm/B:dHG 3 1+giƶt,BK \܊eMD>м3ͧ+ ("<6 uxn^/;%1Jl{/#ϴNk.&;7Lȍ(f;8F-'%2e*JKJ/P(_va;@!aĶ<4r4>72[*fe;4脦SqN ѕb AQE !b;/3Y^adaG̺>g?椿ٹ{QdQՍՠG[P022E%cd#L;[og# 1@xmm<~ârSDokfsl4,"Of1&Ɍi#&3$;d1gۀaxL[q!E`%P‰=7=Zg1@" &d#&HHr{O`XrFVE=Yc[yR'1@nT[ 3x hy^`)gް% ޅl~S~:|_e.NìnNjtIܒad*fxd-KD,Bb 32fY郘q7{3Ty#`IENDB`caronc-apprise-dfec414/apprise/assets/themes/default/apprise-success-256x256.png000066400000000000000000001371311526720371000275610ustar00rootroot00000000000000PNG  IHDR\rf pHYs   IDATxw$Gy3sOtw) ؘ16cmd ȒB("SNyo6܆ٝ {{fN-V;USy>̘3cf̌13f̘3cf̌13f̘3cf̌13^C,GC 5KܼK[]GQwv(G:?YF`#/x(<ή~" G< "8 p pRQ/&yMĻj"!mʄ12`Bm2D*W_^7dQ&v1m- NRKep1p9p43f*79BE-@hs hTQ 1-o=x/d9W>!k]Kف rL;SwRz.e & E0F?{;};01!Įa 8>X3cFf^u+iC%ۉ}PLn o"e/]{IeW#bhHI(sX2a&%7t'YBjUlUަUE!ji~ Q-S* @HU}EʆAolQƞg}L|VɆ?Y3 htc#o:uh{b;. d$BFCJE.}Wɤ&JӼPEh{z6T KX LM;8z@̐f2>|h?'"ԯKwչBn y&WsfifH3_5i _w&6iI)e@gwf䡃91ݱ f+tXxW_Mswla[_7M՝n  PQbR:slM |~U1ho( II3pNF:Hf?L,(W>|X?@ӹ _N|Q-anOoz>2GDt y{ q<ʐ4 [a I9qF?mu\8go;.Œx8Ipcη~mDpRtK~"‡{Z@۵(oӥ* )dzr:ׯaR/>NhB,xAHn)oFJ&sv*w~i\ҹ*tL @H l_>;ɏed&x2p-vN~],"^P[o X W4J! U!]A G04>%A*?u@zbb[9z~ǤoLcQ/\Mj4:sd 7%]ܲ'ߎY lύ@]Q{,P VI LĽ ,nT S0d,:TKd ݵXN$#3 '_ѯjDkդcE,oG,prꑈX  d=X d*8WP"(a$:E@*d >+A[w|3r3ޱcYG(d\|*"bx\:ߺ^Xn9;!<_X8%_Xx4KZW5)wJz9\ϷA%C8)Ԋ}o2 uB 霫snU}Q/}Ff^ԒVG-Ov}cA8(mbЅ_'U M EP g1Z~`D@@?/(e蓇Ʒ(vq~FF6Ϫa7.لQwvwe9BvHВ^t@b#B;`7qfҟPɯ+P!ǐ <0i:'/|Պȧ ޾?Bz?Q/ҙ98>&U{.h_BoO /v2`x%S@q%LAݼ6DJCp>W p-)}y9B!tFAsb{q`83 bWmˆu|*̃ u%a9 钁J.X* yЎM/eo8頾,F'bbDo+D9_>H1ȠI $4db}yV[0]w`{㴜{d@gy}!jB(|M؅pJa ~^g Q9_h*K/tUB n3+@ce>Q".Yɻwr U]ؕO:cw"Uwne+^l?NPx ԝdhX-($SHK;V(E (q¾ )}_}]<Е<\%(\2}\5~a|} ze/;fnmdN,igrF0k'S~Ě K0,P7:A"|9ŏ͠%ja0*`* *y畮3"@-xJ8Z~%HP=E>wSR9U%(hcbrrQdat<„' [n;Mߏڗ|}dI<[n$@*p>2! L'RL@˂' ɒ~w (5@=|:R/Dӈr хVZȇ E*)5` {.'uUK5x"(Ӧ;(1:Jν%0P,2'o(%kBZJЭ`+r1 Dt>  NVTR}M(4pfTMo pc0p6Una7,S潌=^U{(PDڮsoKh/4r5 }.*Xt[ALS:yH'LY X1[PYO^HXn &BH(LTD [d,-LsE$,Rt~\v^b`Њ Sy_S-&p8kϚG녋zVCz.(-|/J,`)k ,Q1o˿?`X B_080(A F $,bM'h7P!ZK<#@Ku% cS ě025cSi\yEXHCgԀbHOsgOVxvšPt|Z_%xq~ey$VRx VtÇ(0}|# ,(;Un*L;H*B0@ΚJpDO i%"#\0?R)sM̌o0GP0^*E?FEo|ޫfM@WY]@U2^Wb:_x *@ ,Oy@,/g!j* +Pj*iFcЮ#TRYj!SV<7H,gᴶU4 ~>A*BE"F%_4ʌ)NiY-5/L-.LRQKZB1'khK_R^j;sBފUh`k ;€p.Ї9p@gDP+NAF1}x4 Ũy_@YBmZ)-}߷X(0>2 ƇGc|x8|!HDTC- mM$jkԤjHj%>qzdA$<@*_ɣitFǫbNC녋Cg7L|-sw9JwY" UX b\EX9?5_P1QvLr/+t,C p#2O_x]Fjƻxqh>";zX!zZhjcN=f3g|zQ~;ɡc"!K "I?kF \< <1Atkg^f.DPg;o Fh>r@K D"PN]h5 6@+q>(㚦Ell>I__zL_͈Ģ$S45 bn܎~'E<<1%vO(H`p_]Ff)9 o_UrW znj+A\2TdѾ`J#4^@dPָSa2s~pN"Z6\"Iڸǿ{~ Ñr1os6F}],JGM * @:t (C!cϥ0ش<ǀM)|/[LCik!`tp \ePlT]K#\ - K R`Uxi qaI8IνZV&lY!,"oR(/1$z9tSy-rJr>'F\+8r[`?u$SE(~BSP =s?7LO-3ቻ[cP? MԷ6jD#{H&ʎjZP) nYP<ʢNb̫.P,hVI5B9z^dXC; ly%)wJl[VPE [֫UBQ IUQ麖R5KkPUT w=0s 9UHE 7]s׳q ך,@KSfմ ppC*DBLD@VSc8orR& ]|Jԭ4SV1H+Z_eJ%G "ܖ =T!$#)~vi&[?߸^yw^w3ݹPJѕhadVWз reDKh7IB2Exl+y)?͎G}v'-=mw"̯a8;!uw(l8[ z_aS'nw&\smx%ո⣻1x( *F-?X$-! K`zT/ 2 ]a 7ti{~]LeOf-}_|? Np݁W@Y}:+Ϋ;7r$pտW?Gz ts^͝5SSro*eth9rsHkxGsu~p3OsRG&* <󉛦= /x!@؎'pX0ZMbvYfJ~b:O`(݊( և[%(d!·<uPbZJ?Zsj:c_W 4u7]Nmc}O`Z-ϼnE]љh+ !)t\GRJ?oLCق}_?Sw>ۍ(*bgnt" B | 8i:oHac7_V%_XA淙[ <2_n5ac߻t~)$1'~x[]eғd&3|WMlG^uW>F)dvxj9"VYkq%G?RA8}V''jyߛ8՛H֥H3",F~AoZF B¢3ʑaFJF lPru^N \?+ _Mӫ(~ސӈKf)?nmC<ZQQ7X.#<zkNQ[;CNmYNS9n:>ds@6]P}}|;P}a|ÓF IDATER$qE &"FVt %J!=O`d`N;Ua+ĬT3QjRh@l̾Y_ ]sAY?Zn3{fE_ƛqzYeA g@ܘZ?rGx̰e6zR  0,Hu3'>DrƏV=9ى kH(l/HIF$-I1+R%XD!3G Hҍɍ3=J3~^Ma {8!VTA#p4L٬9{=k@PdS;kݲ8U$aNm';G3UNzK-k)L*ˀ>rkpҦ5rwpG]YT[=>~aaSK>sQXD%K6ZbMKu17I we`{䲏}3ڳۯV7=5;n7q0ut}?OX YBQuݚ֍5Z~bN4RiwugiIDYѭB-I`!8(EI֊ +U*f7,GCFhFLgdz:[PC3_?Fxr` /Pm+.^ &>Ѫ2XXÜd?|[+#G%,߸x3[ ki)75g}P5͗Gs?֣{9bVd8 kGWnJi.>A~Qv*x+{8(ChydCH x'+Ck:kVouBu{{گYMޭX&ll&EA#7EM 2,bA,zI3aveV[$ TȔ;1ȞC gGi7 E15ggoV ;ygoPC4:j5jV$D9 tG'.ˢz]ݩ#Z2΄զ3(yL^k}0/}PcIXfzRj-ʄfMn1eQ_ͫȳ/̐dOs)Z~@N޿.pFDynae6-amb4,bU"V;?n]4 Ery f)ἒ#lG29ޠ}D*l!>4d#[lsd8A2K ,ښdjpe;Y@=y5n V$d{^\܄n{.O,&*D0`*-r(\kEtPhAO%][%2g_[bN^FN;  E3ѫSvŠb,k:OeAx#u$P&,V"bԆkh71/ɪƅ,K̊0ϐ'0%/;@&'ٮ%JBa֟*C~(#d&2#YŲD(R`nR"B@5FK 6Lɺe lرz߿лs:|K\P< vn6ixuTGLL"EX O5N^ײM;H2,f x*RvBXqY'QXc}W'@__1N{3z_۶L7%w>}K%@</U `~7kpl__ z]oGu(mjp p r T0Ks 0wS*ywwq5{͸4bgwQD+OBj[ӥat矸F2R,mE $GfOru7ˮfS;,Dx"\ b젻}>r2ԪD3%-X H,œyZ$%GxљD% pxb 4ÄTb:Ďɓ/9p/)o9 +znثl>$Z%u?7@s۷NBV@jѶ\UpDafWҦ2S?O}[wShj-6p03UjHabS }~.w0)%w7AZ56dE|s^3U|J= s56}7Y ѽ`wjXd}6pcG{)N*E9x@r41MZ|w,CzR-%&Ar*jnvT'%`)#OR: aK-'K:d-YQWٲqDeKs K1ZKofBFNJ<qZC?'g[x3,ZR%,:s:.EYwr9;۽p6UVw< ,kձehS2"A N2s&}sV6Tu1:]#|#Oí,TyݼiيZ3+^'y|hRu)w^nm-mh[Aoc{犵$i:g~K5:2y)(V/j5 ^( mR".ŕ'& JIJE g¥Y /X0 U1nSEPo%/W+=FM⍴4}_ 5. - ;?Zo|?C=n7󪎵JX#Zy숶֞EkUuv;<Ʈ%,uk5_7[_p}‘]|a!H,l!ҐPvNioRRGvW`j)|pײૹgj avfsҎnh Z#BcnһkK6B,"~fx2Ggkb^MQHyͦkɬ^{usY^?Oƌ9n96Qu Z F>6-K=WP5aXQ{Q>]0+ۍq§('}~ɳ4)RwRIr0kr[P(sp%zRKiSHE,ϭW~^;qa[:Z0owSg|郟uAںD;pv'vhΩ=#MԄc]2S"5.i%F>M{SJTKi,;o  gкuKc0 -/\W#%%Q|v;N\S՟jؾgLkWԅk؛sWu)vϚ:ZXa%Nv", BS5&I֥HDI!Lz7˙o>X">=<:M1|QALKu (G Cӄ&38}-m: j s~ QIW)Px1@Wmin)XX/dSHjcJ1wC`2][Cg #uXa|7OaǪ`VY;OckXb~t=/0:8† O'Cf$}SäKy2,fX[8]e,Xuʫz.7r{zzi,߸E!=z~civ<F,nM huMt$iչoY6~Ȣ x ,u$ {z *+fJBK _hΑZnRGK-!7Tr[ރJ"$*"Ԫ[jo~cUՒeyNZnFى /8ry'-b9Ntq tjYz)silk"PK.Emc==]UgepԵ4)m9Tfgw"Zz'˧(7%xnmKߎ%l{x }{{a_p8@0UȱcdŒ)ZѨ{G/T$n7boNND\d@L^ChcImT"䋀L[2* rTQ|M9¿(5Hv[5#ü#Sңi)uZIjQ#<٦20V&R[w}Ϲ잫9M߲Ս m7Lw2Uw U]s;+VK2*I_QfHX =hٽ:  Pf|^;*Pwd)k캠~1j牀>\Ja^FF"yh\#()H_z0ja#4)7A"cc2+(cGG3b{ cN V-q.\^3c JRRR@A/P&dS_{lxK܂B>A6^t2@;ړHk& %_OvIOgwd<7pE.Y)k_ 7*CV+eiR^N0+j>q?Z|n=AUe /ʄ؁YK%_d ]K]e 1g|uv8-Nq$7qE;5Ďq(3Hov}y&-ٖϾ~F,:kB1M W.flq&Uk^XDϢɾtnթ1Bs9B>^,YϐbX/CQ!чURseÎH8 pDĺTN CnW8d H=>o24C.\u| 5x˕S([ ZH[-o~{'/q\/m ̱k[nö~e0hnOǸn9 'r٧F̥EwuOuAap$‚K >UskBq!Y4 6H~#ϻh/tO3 @٭V@z[R/n',)IHE҄Iݟ\~wY+99>ɯ.ً |oqZ # j{&|u'YMs둇xpx-,'nբp w^{3%xԊ~.v) %&aͮ0 4RXXLPӊi Tv3NGB,P'>>H/lze]"KC|ڎ@4TXnnT5GmT*z(]NaƆGW\>{ƒq,NO̊*o$gVb;m}COQ ǯcUm{ܾLm8i|>ͻ}iWK5֑Zcã6`뜪 ij0-5Vl>W `J},jFJyFftȢMȠRQ˴7Ϊ5( QH$&edY/B (*MQ E-&kg]G>ˮvmF (**j[RKּ(glOǵ59oziԂchNYS$"P`r,W4DH@`) V4Lɝ.*jI/ v`S4FZjKe⮓HeyʻvXԔ@(r#M72YE BJGhtxg-g^M9Ze%4Vٛ-m3$!53g5-cO0%365 ў_{P /O}]Uu |0j z~pjQ}qUQFz|XBY,yRJ!_h@Q3݀Xx8>/ :dSAU{}+C`ஂrآ_kcr^zG\eH\sXU@˚xqO~͉8Aڳ:qVàZC;Т:g@XD$6=:?6<#Êḹ"7*p-k^"NKWEZP+RVtχA켖 IDAT%Tv8IpET O\{- hdAO<POe$17I!WQ5}8??!@.;ů3FFgQr"gQTp83lӎ1͚Z*[D-kʑ.;T&<0G蛘\WF"-J2~< `jݤ6@˖H7p3 :PVHuA Pʠ*jr ~o^{l{x 'x';",N"fq!-HDt0 Z䠩 Yq7B;u#$,Bn3;RI4b&VnMq(ΏdYjqMSfԕ)!)鳧|bZXWCjW-!XWh?gCJ/#Cp7GꘟT jil3)NyJm몶TT:kdk,ҭgғU2U/|փM)(C?uq(v_ౡ8+yUi{xYKz6*9ƒ2Hw'hXZy)Bp>a :♇8k?Ov>q+#zgfRFP,8hisr|$ڤ*LM-JꀩNmL~<pz7Í ~Y^[",W |YTpC4 I4 P,Nbu"#Gȑa^No^ާw*nE9n,=mD`:4yASGdՍin(LciB/RW!AꤶJp#ω( ڞ$0!qeP_jqs`]P0E `(A3B7R5IEđrxGy9٘-)R-jSYk\:h5h-ǥ{:9"ښĪTg.*0CPC\Uj*T"ևz`p4HLL_0*ISЃЪv2s>y['|G455ŋs]wpuW!8.G?xf0B֭?!7o.Eq)Sh;DݲQ "w^{ _TAJN۵Kh7ўhIwPig <<16Ee1:.HfHCb˞86m) N纄\rBgIZp~ZRHX>: _;|[[ַ[x%\…^044Ts{B{Е0;F(eߖ\V}"mw˖eaa?@Ֆ[Yx,&؅g"2`#rZr(!RYlro:R}^ Q)xK&Rm¯3CGs4!H N3wrs*}esYg}g>xi?W[bqj6!]2SUs?wj  N2W ]_?̵^ {젷X5*A먭U[q "xn OV\fFIsw/J|@>sni^XF.} yKr~OC/%NxS|ߠ >i+ 83~vӦM߿elKtӻzx ևkDԆks_+髒Ώx{ɧaj?Yۨ÷W/L#\& L5AkʄX5mID{fh,cݺu?{!rꩧ[?d6`AMYQ+K 7T{ŜRmlEYtac۱T8Y,w6WqkoBctmVfQHw*VZs< 2DdV/ V*]5ƥ{ʞDkG5-4-sϱss_|9W^y%z+6lK/}{o۹馛\?i=5mꭌOO֌9a\8.@y r}fU5w>ZtenF5 $&ǏK*7$-H?<"j^V?zp>ݏ¿l2jVZ_׾5FFF͛7|g˖--o!L/|+zqǵ7]sOuݵ ˸u`H^I% t.`OSJ{әha]R,es .lzٴtPvCVSkjar `Xˁ@UrVV@z Ivkf@l) R/1Q^M)~&p֩k]ٺIϞ'?ɪUЇ>ħ>) ~֭[{^6ô >Ɓ4Kp}X+k ʢ2Z枴`3o"=5ћ`~o"޺ӈ~MDV Hɓ; :k!-e_[TR#ǬfkcLh|b@< *u%i/3Ua.v򦹯r|_ os }kkkҷwx+{v___^x!vU1w`>~]}{gVX͒mIp7cfCL}@!GHSK<%5y8!61`c"jJݙ{g$c;{|'յRu91 Jaؐ #L1|:|}$ᮻƍ /$3g"??pp̙7n0n݊?woK.[oex-<v;>UTwVc/dUvTԡ-ةn=UxKp,O@}E ,6+ .aP{9* 81EJyb;Ogf-A# ]cos%(jTAnJ EVwvX>JH_g^U$MEbuGHsPy $f$2-GR~H"E_y_ "Eё]D}\YM":%M]Ñ? j }|Sσ>x6m^/6l؀ .O χykAa1޹s'.] ǃcǎ!55/O G]] @ g O~# ]Ž#Egk.NsP}\ӈv"SGpM\d!{|r aCtX]R10z4-fz6@e_SL䄈Ud <X?%bP"d8jo#h'^yqs:%;;7zc?A|Ʈ#<X)^pN" t{wWqSxkΈ"3"nlm>mGaAʼn`tJf[V}Gtow+f,Y''7;Aksb+4vr;)H `nMt mpXS\0I@aYHdC~)bĤB#qH =R $XYu35]~86)&N'|SLA\38q˖-ömnO>cǎￏK|ZZn7dYFww7 n믿e˖᫯ܹsqwW_E @(B||ק4MZVq䮏bj#)o*)FF`ٔ@fO*_A\ d3`:Dv|j[_“?|;c XbvڅsbժU(**B\\/^`0FBVUU7D0e][ZZPUU @}:=Z?;wl<#rqC#?EoþRliُy?i==uJMKqS o׌@[{BfR,S)R jK8< jtD`q9'Z$S15b3B~l JqT Q d!+AA@X$cp5uo~/][_`رXlz'`ɒ%e^x!MW_EYYn7~f}%zcԩꪫpTuJ)܈1&Pf()%<Yj@(*e U?nn}G2P+eR2\bOa$ΈVJJ(;GDdۢ`j _ _PSa eД|k0&ca._(BJ<|/?>ֆ>u 駟 ٰa6nrmvWW ͟?s{:5exտZ ;w^06p<= a$Tspr.<r΃bat長-Ƨ^L?QPPy!??8r 1a 8K)ň#0k,ݻ}>ٳgcĈpO Ŗe˖aժUxM)=*c¼H:- F<Ϟ5Q`WC9I%cfNԅ31tH>WXrύHJ DW=6d߱+W4fTU$ɞ}[^o50ﴐؘHaRˈ\OC$N3qYK6\/-ּT^$̜9w`ڵhll… # g… _Պ;YdL8]!X,HOOm݆&vm;g  g,sHJR3D)Yzbe1{0tHfFlߡ ^67Q} M@G ILaqZo( FQGCS%"af\{| Onx/+_yuS_1|u]LN&Lʕ+e/uPWWY Ry\=voҥKsN|>dffrw^~~# IDAT0tPlٲGSS^utuua+r?ѝ1驣[ ɠܸeSOxk#DHaCuQJ (򽈂J,It!bLY{hihVk$철4)B4mMxzBaWzVlm:]"To]/b0i_٢ ֘DcK9󒑺`R0p_U9Rp0\(j ZA1Iu}?Qs`By1HKlWo7҂1m4<裘2e F]K.;k`O{Eww7Fj8yW7߄fýދEX] ¶<[Kh)!Tfaرx܌D,Zbƍx뭷0n8lPRRK/P>,:;;;^UUUhkk;g]k[?ބ}Z_]b|0uA%87dnG]認?1B-[󚔠ZF3Rv< fY$i0&C5ܟ [Q=dq 0l)w@40}Gg̵ oj,^T%L<WƸqb0`-Zg}֭ß'\qطoJ}$nҬR>nGmm-^~e䪨~;tvv^裏b8~8RSSgGYY^{5xg=hklڿBPڵ _= qF}(//իqfo_>|qp͙Y(,DbCU)(%қ@׌ &X[ɨg`Cu'QA4l(%g7ߖuv75*"0P(;!iؒ %#;1C0t{bg_{5446l}]yz=l߾*RSStR3&L~{0p@{$ K.EQQW!xgM679n':***pwc+{nzB3`*ST( ٠èPS@<;*j14pGl) aʇ>/9t?A6D|kim@W{酛mmRa/~sw^;=}kŦM`Xp0rH,YpUW˖-Ú5kps95k_pyM^۷o?R|߸H gScD@)o5Ĭni> &hx{z*H[Bn"84&S^vvbSk'J f]yr Ntrڅ6`͆{ <8555_>ȲI&fF|wXr%^/\z︫ /^/zL>WC]EoŁChS~ QAӋx-\bOŋ۠6&(LDPM.GGRpwg3g4 9$k_1*If~$HHUChT Mfdb Yr;wСCs=v܉~f}L9JKKq5jVX ??F/~ ̚5?[(J1/2nwtu`KSayH' +qfN`yJ(l{ZE ۥ=Ǫ0e: 8 ii)3t njzոeUnB,T5w;#gHP(Sn@YYY;g!;;[CSOPtD>!R8y$K/AeXV\R0;:::Tv`II|kƑ*g!% Z9tGu Ԁ ѿ1W)1A ¡B(`oЙ2@8)P]JNa1pٜNKGQj(&S{j_Ipۯ 1S!CСCXx1{=߬YfU!G+ƈ#p뭷_d yf5NX;?{lذvwj?ↂg:#KrczqœO̲0U/#=';HE;h@ATM!u!HAگV"ay31 >ԏWbd\Pو*CnjkqQJ\t"33G;1ydc555#=]A322QYY_mihh+0w\,Xkz}rXߕϾBVM c`#7߇ ,uF)Q@ (ӅhyŢtTg ~n)c7XJ ŠjLSg2rEkވi\4Ts:qUĉ"l?s,-p]Z\MMMnWkjjpEaݺusذa*uXp>>|X;v?+W֭[׽8pt^9>XiȏdQRݮL%؝Pàk"QFQJL;84!/DXb0){VOQ$Y*=}qM8?w MnhnK$NUa&e'exc|@ uUӁ}וkaǎjMww7֮]aÆaĈ1# z|RzLNNܹsqcŨ7ߌ^z Bĉ馛_:;< `N@IIl`r <2"I>"go 6m3۪;avB+SAkyLP*{Ӎç2^ N-W-OgދbW!4yڴAi g#o>/f47:ZVC>܌뮻+WIIIx~QUUՊkb֬Yυ]6p8dQQ\."dô.Iu?ʌ ;"E?$s]Dlbj˱F#r WAjDFwHQсT_#"?-&X*lxOS8\y,T#$W:hiS#FF8',V+nۧ_Yq5ר>% Xj51~TbIp"!![lA0W\dlݺO"FQQ~._^O&͟}lqh)8\g X,XR5V | zO&q A 78aV:w0>"+a,E21t é$>|-}O^?h*t8s Sbwߍ_1wo:@Omۆt~j/Q\\K.zݴ6Ɋ1ɅP䣈 y!Q6(|N٦DY0K{uB[F@t~U4DTta#=}a|rḰiǫEeY5"%%4zHKKŋG,7 ছn^uMd9ӑJ!:*H:N 9ܞ7҇>@'Ơ~;0L5q":%5 uXl8<?)ik+mW , P4Wzަ6k9hx.>-zSoffP`ٲehmmE/Daa!mۆS$׿ޏ}_ۙ(yЎy`3G. &D3 rK\ XGO 0Hg0wD5q=]ݩ˃6?yojTT=csF@̯OC0e\^TeeEjj*RSƬY{n曦AoGnn.:I&_FKK .p >o< g>Xᆆr5o )p _g'o@m7ڒ=zx]~;h0;bgd%Y L-}eHi/=osG"٥qC]YbjJKKM%h"X7otOp:X~= g}%%%eh=Ռ]1+ w5t2>U.L(5eFE=ccRԨiH5xР'.`1m/l6v=::Jd8`;!]vj({s& GҀ n(C}WwK'̙cGĒz|4!r֭[h"5Z/6 q}=c̈b"A")SEj}qk( gr m}ט?UUo˩cgצ t`oa3O]0Ə:P(BII -[1cƨ ̞=@ؾ};fΜ+g\EupazpOȯemZpo> oE*U=ӶᾌB0>@  H&ŝ'_TZ|n3zX,!(J e8iӎ L񦩙Xeŷݿ?n>]C}}=~_zz{w܁{8+SuN rri`uaYaas`Yas!I(ȔBAeP P(P ϏP0Ϗ_xp aYUê $SQ>O FLPli;n, `"f3lSF Hp! {u-l ٜ3kot{)Htj,KnlF]1Ks O<~ߣشi?t)À,fg`@n&3NpÕF\qqpƹ)6p;e}}><=u{Ag[:܆:Q:53x4,IqSZ+;%!\= D<F7(7PHBVf+a_v?l)N]T$5Sb lNN& @ p1w6)¦ysX|xWO߿;q#qc1xT!Ӓö+;nO[(wI"HĔ$F(B(@Dgk;Nđr>c:eYw8|i`9~rl"a>JqWY<4!]F!Xot7\#Kh53e|Gv;1aw}s*kPV!)*r;~2GvWVVp8uC6$ 0rhL|.M<I ƤW?w "vqHHA!| u(>b;QW^P0ՊGb-Wa%J:O xMG%-F@P$| "`Τ* Oo`řp>_A E"AܰtzJp$t9ĨcSD@ 7;keM W")H\8,q1;`ȑ#)r"#/yc1-O S9 #DCʡȀ0dȐeeGgj B,dYD,DXa%X+!atL5"*= {݆` naY M2tVaW `<4`caK: zAc;LbZa`qρ`&OM cGHimM/a]OxJ[N bL,9S0nd|;wG:|nU\F`%3P4n |K3ԃPwgz>040 #Li 1exT}[ lHI=[.8ou!ՖKlq1 slHJK#G;O 5}de1, @ &O G'`(1e`2  `郝JRrڌӀa~]omRl[.dvdpX o,V~: $uY=p!̟?4CII93zۅW\ D|J,+D*JPׄP'jM2dȠJ%൩E͈T"P8CԀH DJoʼnlg*2u&Y1::Z1!5AÄ20Ū0Yh-ߏX3>MT xL싀@' ( 7a˧  <5fA G0}X"؅;1C/ 0qijv2sp`Ýoː2Zh]/D[ֆ\sxwl^k{"Fr@8M6H&`;2dgF $Q]'au4 TT Usq6'a?1)*a@wSDJ'l IDAT]MzaT9u"nhpqzou ,/Cʰ¢ e@:k꿵Ѭ}c̼|+Qņ 9P) R=Q(`5GpDNb mןUnjV: ǢۮƸٓ)"9oȇN[oEt7ݘT5h J O ʨF-؉Nk;֨Q'D8~z>n5S{vyu 0.y08\a/AS{8zl_GD"7{ iCΘ/qlaj䪋Mʶqja5mx1l0NLi'~h3(Br&liُMivA9CnQ]r Zn^F?ފiҶEHw1RN 2CՙKV;e6dF稨Akhs~*pΙP!jnV YRSᡇ3w^>} F ?Rx~Oȋm%+llڅZ4xaJ {RTF9pt7TW"QsfɔXf:ZasZveއ'VD1T 1'< sُ1!Zs΁IL}TZuYtF ꃗ3NtaaN$|ub'`X`حʭZmkql|> =6o|V1q3BnQ4BGNۨJ| J@ * ]6 c)(2R]t+fW+m)Aԏk(P:|_O!T7\AH$ThrPFwI37[GDlO4,s}+G=Z "Urb7 =}PNEEk5>Lee@dg BmyNc֭XbE̡{ :{ z>$&q ڂ]֖b:PQZgD`"@cE]p*!TPȨPrK0N ]&c 48*R./l> +9Z,3[;nYu 3NPY$مϘ55`ԔHJOD$NV`prNXWT]lq9SpocgMR#zz>l=Ps p_gDU5+`za`'&R:u#5`Lޭ #|.k٨I?s~b9؀c{?Pv@ߘa4Fܰ fPGߣREcHlv;nˌ}v a HMq% ."DA9"hs1``v/X+]u bЇ+a"XE ,<*i3 j>G/)]T]3" \h=Xjhp5D'1 LzZP ]ʁ0ו_kZ?rk8d! ‘KM =ᾺX  x=7H&$Jԝ8s.N9 9#U5x e' ݭ6XAF,ASm÷yYXC%HHIL(|mn+=a&㼍c  }"zY 5 p0f Xb%NJkRxPT!z䥜A + ;OeKe[}hx8+VmP .ӲGn:'nxd""Y$$$%`]}Qq.YbI4ۡ&4al0ڬHNO[cfWy~o/}v ["Dv&b"C&`%V5ZlpSl{fMZgMvzF &@C =F@cD) 5d"! PQ!oM ]CKir1w3\ `pA VKd'3PB!9ҲU'ΘhiDؑj1(%N@2@z~,V$d[iFv&KO8'rn1y % b /0vEkSa s0>yF&F;EpYh t"$94nW+2<@Hpcia =ë˔ N dCYR$"2E݊LfyI $S񰦸-@sJPWlðk6m8UbN`! (mR ӊCڕIr ULx:_`ڥs ( v58,a.ʜHs$mumuFivۈzC b!Cն.}L 38JME*0m'fZj2Qyu踨~A<Ѻ1f%IZ|k@_ Nf$8&HP0A65a9FQ`MӁؾUsH+ wD%HC(HS)9=m87 )-w?3\{MHJK֔#s;X_me06[$ 'ܙ(Lȅj,p[<(~.#ٝ@I< q"ˡ&zє]4R j20 D-i&sm/EPu?M(o i6(a釫( Ӫ2Z d즮V ٝ 2E遣gl164cؑḦ 3ǡEAI&6v$|jF2dRz .R,A …`1lO{Nl8'cD X$poڛZt?gؓQC@!ue9$Pb:FPQM^? 5_O!F'b߇ƈT<@ez)F -Kc< x@@F !SH- KT}IRfB0xd!QWyfw^?&̝Ix4 BC(LSq B 7k6sH_;f]uQD=H=TƮ#pU կ^|"%3M∄DeUL<4h>(9OGPVx:/1K5Ҕ40Q kNlAkKX% h ODU腷_?Sk2Z0pEE5l4F& PZ@˄D0Rk@1a=%@ ECbdy6A*O |ci Bd"-a_ONtX z1a_ &qkt@'1Q [fV$E9LelEfr:#C9y4 B}U-:[ۿW?sՄSP\F(Mm>NdY%v/;jGz1qV'ÂToml|5ڶknolEjf:N#S >tES1c2ZmH6ΉGԔ? !;L؃"@G!gG0>E ,@dxInY{ |[(?6[Cr@sp2$E3| &5!W  9'9SCO[Q8]F&n ]Mw@ez001.IY/Q^ o8E+OYLҝxWOa߳G2Y2_ %TF}OWgĐk%RL >!p }3fb쾡T7RSC(s5:Nk13&6~QLK;cpu"u^F ֞ l.V؀,(m<ņLRp:P4f8f]1PUe'@ t45hfDA@E[VAwЇ5]f?6?JQ [(J "ÕUKձJ+Y"`aSA"Cuϖ"O>lVs}o3+ lԏhr2ַ7ϳB$zpX$`A \4TRvvqs8hBdC @ NЋjO8,t`Ԕ,Jӆj-28vu7ӄisV40g$ ulGxO[ee&jO.U4z ŚN,qnћL4b$uD(i7(gJ ,6 $U~ !4Wj3?ڔbc IZ헽]BM(4;N7>e/QӤQ誃_1p3цh? 4@ɦ]||D,^ZSC&bqgHqOc-?唅`X )0ʃzR":ह;jb?bkgIrA7Hn"AI܎Mt@keC" jis(B0%R jjbbDz@wꊹRIh6X45_?^|-g\@4pN`ܜ)p'JVX% jzb,` "ᇚ4 B5݅M>Tj thAࡨHԃ#ܶ8v7Ai;y ȾuNCš\ SP  MCʼBM(2\ͻ!)83`Tݥ#%x x;݈;ocڏy9_(@zB~<HȠ! ^A?ÉnհV #>)~"2sԿ8-MEJĖu?S36P  !@WU5TYN_FU}CQTPbooz"3vXz fw8 [.׎&ѼL{O/;CY$j̠hD"($FwhDblUsn› ?}~HhwD,t[7anjryN PqZ)@1 CГG^W=I|X1 J=e-?=kFŇRc߿ƍ:H3}OEle($C> >B+%(c[1X.% _zI`I#DyEsq.XlVܲż` 9qYh{`Lk4Ư| "`61mPE5KG X; r㻩(Jf мaPzn PJ4[_N π0>W!+.v`@VDSוh`#F_g t#ٕ W\Ҳl ZN5s)ULw&Vas|*>hllEJL[j0zِ~L%R})D"@yo_M;f,gq=~ v(2EqӵU8# USvhLDYc'NE} Gو<,7vbTzeu\p9g7EMGK}̜T$ 'F*nV3 c0F d5e:*m(4R!.ԃ2)?r [+D(n頂'a=3aBY:c58CEF$Uxz.?o0p ?s<]Kpc1 ׁ(݂- z?:.K@;j{j= TO;#""&mQBfFйMze.p֐eY^g`Ky &oWB\gCxQ ~p,8V2š<AThF^Rv  [0s/R6jl."'Pqo!`J ^ԘW?  ݱR]w=P,1Cm>HqV3x0FR9}[Cz: Pʉ0 :9sȘ@CO Rgs-ǡm~ΝuCԿe`[)oa =PahIDATT茁}5VׅRD}9!NIAͫ1 xᣣY[%Gvub9GF=_{NxO./ Xynyj "}|4y[1:Hubvv7] E8bM4E J!$NؑVĘc9?nD) J7Xy#?s=Ga@c8@RfO v9$& `~G@_9a-#~-es!ӝ ҳP)ΐq*8xodj+C@g1G (2a F սSB\"1c5Bۋ?m%"Qn[b65DBsF,p=E̥&&h ED"Չ~^N0>(`I@juyBӆi* Ov$7lqAJRׄqs'#!{(@Z2%ǚ &'D ´" EM$MǨPnF}|O`5s>ڃĐ P@ iT?ފ|-%b9ǛQ(sg=!pa $\`X Q%\ -rAȐ1$iz=CrQSz5eU< i\Wyso/,FeɖW2vI H يP PR!l P66YdI-/LόF,=}n{nw6Z=3{-y\m7]G8TK~G%oNʅ6 )Q#f(`,ꌂ (Eip F1Gc)…?#MϿsy}8{{<:D1G^ބ~ڪ2K$qR>[(yF#֢ZFC6r`SJ*t;íl.]9Ξ`25M亍U] -E$RلLj1DH(F. qTʗ$#SՌǛ]rS?yk}Y-E%u;UvjzE<^\}u`/Ut>ibHebPT1HiJu&Y3ߕDjS|PQ';|IGkAqN/nAIHY2[ {H-<~>r~ R^Fp4c͸O;%f,?ZlPWֿW|w'}~ѳr0oxՍ>E>"ѓ%~xaIh"MH$,\=Qvua=gP}1i&4Z[Hw'l[{}@=ZАv[T`DD|Ըbku 2cN@ ,ϲk7о;cp5w\GNxoh'im >@S+FêAB6L?;:-rI/uh&L"~8ůz#e<[ȑ[ӭRdzc 91hb_A~R[bksVdq_8}+９ÇFww9=4 ROi6!vUd]1Pip|4JDiNq }vvxx m] x2H}MkG 0Pl'(IbQ- ڕaDX"ֹ!dy-|0Au!঵'?..0:sÜWFQr/9x*$*B}' a"x ]Xj>h耺dc|-~q{B\h 6M#+5: D T"tCo8tJM(Cj JPu* 6#'G˖')Ϸ}7.+2L)]8ůF^=l g+kuEm[wRO6BX?A& x8?v>KJdwpϴs nF.Ev!;Yk͜@Xzr8:g@)#9 bc`TBp0Scma5n^| sr5wʻ?ndcV1G3p* K/HI^̓qkv ͝C)B%͙wa.Qe,Z(JlB~I<ε8ÀrL2J< q*.j{(,JN |Q Eczaml eFb~fUl*~-k@.3mSϳ{ro,hH=55iOePjAb"pH13`[տQ1'(nv" 4- X`՛EcEPqه޿RHtʾck\jWjqP(ǽῷ kiMqd|dIѪj1SڟXɳ-w aXZ&-Vh>$<4vS91uzJXT r77=^xdL!Ofu(WEjAT Q 8 #qzs=p9ǓMZtGx,ĻƟ(UnM}[ XZ U:WLUN$;s=p~ 2JJqntl%+'I9op41.gmqm+mȄyb8Uau_ 3@&PI-+=`+|zޞPfG*ScE֖u\si ОUEنX<)д, ]x+ ABEP t?sՄfw 3Lte9ʃ0& .-C~=sMciA*>‘ZoۜoG:expr.N΍ZpB2Ru=Ch}՜^(]M}FJ.SH=oH]MDxh{SȥeMgRp5~m徰5 v0gja B{Q%=0ΌݧVc 4D ŭAoqެ80zI!-5= =sT֠ReG):-\Km!\ ?>t-X8RqWtf V*d !Egr hXӉPIW8eaVTmD AqԴH!FXe$3;5?#] RwkYVZC>_]yVl*H0 9zcD3/DC4`Z >:ECO2S,)5"؄>Wef0=ELCm '1v)_5_\+۝{fLA$4JVa'E)O٦dOOI mKz(6[iooG}[t/,􎨠禵z9q/;\swNC2rrTC*T5X/!*.Pt,)E+~fwoPI/?XiK t߸έ6p;۝Coh{h'/Ef{ Ig3<4O/,Qa$=EGN(_&`I/,ztʒ]Cוt]-83Ii>Gwe\Rq8ZJ.D;P_<2ܾQMR.Q08Ot}O2mނ5@d:~Z^^'i)!~?ڵ!J:) x{Tg9"KKeZl/^UPzL.ftݙxn Qx:=]DM+?Ħ[m|ڊ!|d$Zb'ci=W%^{OlΦ#w etlrzȭ"׉[%;%Lꤝ0TwC PyL[ K>[aizEcs,|d-?J/x| gdܞ2[M~}n>E$`iVEHhO\Z,Q)Q::GmzTZ[vIv5<%Rpm *orϔppuw[CnM7=7ȭɹ:2 hQ{ꀀ(XXzDu|jDm7.3WvGK.uu! f霞Ќ2}yB+A'ӝ3 @jFF}q*2** rτ +Xj+ɮ>'5כzh?fצO\LvUp0xΩࢵNx&㑘^J؟K#ueA;ˮj _oH@jsslx׿PΟī%` c~HsRگia=~QBȧrxq`( ~J@j\`3@~ M@ >|煆d_Z{ LGA(K7>/qw~CfI=. /"}hN?N>+GbG34P Rfī7L<nIMt((.$ً`0=6.B2f 3s*tO|5(Pɯr˩\:u[s\vtGZ—gp424g|$ B|Y~sY> R(P Lc?yurp^1=,^(ϥӴ5v!ݱ0=zY:0*<뛘fiY&3&=97|3?6 )X14:=rZ:)pl%6w= d /󳦳hnxWZhfG4m%MP7JDR H8:+mdbqz揝\ܒH)>dp|A;a z"t#6flc 2 bBXIUz8cg .^趻;}t:.^'x*l*͢)t&0 JfL"0&=`$Qv}(@Kg)R.JIq @1C_xPy$:DzvRCe, µF>4V^'B76R&j1%ʢ!ކc;dm(nfH)%p(ҳgj/ٕ),-V>>|m5\aяWc ½tFz{mQ KJ"פtQ+?s{NA7[jzV^nCq3'6 "tw^-Zd*a@W*.25%WFgmQ >LFn7h^#MfP/Et0BOc'z;vJfwHnn=NO͊w8Qs^#t;hW S+FۃtEz bbuM l}-&@)rKW"7Iu]nm$|xВňI ^DIlq6IF.x.{toj^Y՜b᎚'O> \\''F^%7̀IER&TpDGS?N޶1زZ4|K2~p,0 @x^@ 2+Qd{ ![ ;(ePd)R[|#}Ew9t! `lEoMB 4a`( s[9@)J)P $IkCs{ ?@_im"_@Z45@-`P 8+1Vn,ɱ@17ƀP YF̃-c3 P >PI!t M4R)!  KyV&`R*2)~ߝF}/fHĿ> L%T^ڈ1Lpt M7t $MChiam R=s 6&if:>ŵxCĎ!S99 `Q @ME }aMu=iMhh8o>. DZϱ, L)xQ-}d_ Ul gWSs\|ASb<6L 0 GR,yk9ڨ6x5L.M""I0Aʜz)XddK>|*Ppf) X\#ce0dsKgP ]-K3'1HGH'9%QR!wlzW[ ϭ#MX x44@9ɔ"[m~"dΌϥ3]0l1o{d,Baxr?_OcsLp40L,k&qM&9c53Y^9SQ4M 8HA=q"ΦFGc$qbQz;9 {}چ)\0ɡjD##1iwLn8\vUa[;I'StuͬeZYKobyMߤb2C ⭃(*)@ˁoEFyq|ae*Fw:~忘71PNwzjsT"E"gTq2օ `juKYU1EM,*kod.M4lv*V-Ć=u`x =d}ۖY@;jk0} ˆ)MQ1&hM Asq=OAz \]TNf֢y($=!ºEhyrof'wH+X 62|:^K$e8c,9K98'y\g69p:j=ЃJ{tCULX\HM̶8DžKtݲlytM;BWLu_!2teN`E+G7N/|;spW ^-sΜMD?\d1PˉG]䇐(GJF%3lgIPhV ښP儜NdZ͉p5+24D qؾeLy}gxooersфF, tTꚧ1NeF|Y,Vn5We42ϮMЖ +r km~ MP-bjoy-D[Y~LXKGYײuLH鳌F$c jif1f(%税9r AYJH'L*C %<3@x4h(G{x99++8T 'PtzD>rt˥M{zĆOo\xE!HƓF˛Ar*G)@B>&wXux*Vbu5a&NhQ^R-fZpba&)v +WtB ^kע ˶4ae}ZM56@^+&( `LXtkl)[`lqkqG:Χ9T6l`ݺu/P'4%/!х/jJ@lܔ~w@K 1BJ9̹p`(I'B.4Ws6;72؝O͟?,J)9|0r uuDx΢iWK:'Ҫ2@4FHi` 9#\& ³5W3, aӼNrJ(].Ia Vbb}-G rGѠg%\:y;JDZTTT8X.4<o_Yt#E/mynBuxA.[oo63?mAz//)g6Mi^k&T k8S#Rʕ0XX̵Md"e}d "H 3@ƍy #6<X4~*=&Oem(+ɍ:$d&7I&2JXPyOo¾߽δ9̞5H'eK'S4GZ1@|6eΝo{M DZKOYF*% )Aɻ%9ս6AtȖpBsFS("}݂RYLlHWw%Alڴo||lٲ|gPJ gmrrN)TNp@pXMBHP<4{-@+}2ɪ<<d2㦛*QZ]NkL!y S@@2T1X+QζuijM͉;H\4V@)rHP@{iZB߁N| ˧/=x3`Rc%Fv7*bH"0&JȤ1BjZNjp_;U<ӷWM(%YyZK[D$J$- '(JAEM,4.@!˯@c$n'' p `PdNu9}grװn>{OP/yTMaVhGs׮R- "3b.ՑuB|%=][cN.Y+<"4AFf^9-'H% ZCYݑC*m ?`՗O1}Bv:fNXҤrҥZRֳڼH k:=ad. Bd=Z93=Ljœٳ@{ȵ` 9;9:VVerTx6E 9=X1mq8hwcUVUH5]+lM3Iv07X@ݧXy%ԖV0+"Y>0UWN25\tNP18#\"0/T@ْ%m P乒%=M|Ú s@i+>Mi2 2,ZoR*RJ\J2aeIgUߠg3Ox~;/]I:3s%`)$Y3,Tp<TiVE`iW-,8|DsUz؇&楾frjJBȜ `zSlvb ^2g6>۾íd,#]GgL.;kp޺r pdֵRlyDQqk~Cl?b* (JП 5|~!Cl֏ΛDb%KmNvRvJ%7[T!sIYT2_V'PYY%9 eV;i%D&E"BOt 8J|K$|a?qqC C #sc ¹TkgTsi?7~ *}LP[=+ Zos8-K1v@`\QA6" >%)d[<JN"%ANyЍ}HfRε{X zR % Whl{[G Hx|J CېTȜddo]?k;5jBOVJvgݡIkl@A,"&+i=p!WZ֗*eQS#okqx]RJT6GNk[Yq=] &OhI-FkɰI{&nS t]"""Ht?UtpKJYs  ,NzhN5Vי]L=0`lt@3t :hWtV*qY%u1.A0gxgxj/gzcF0G[2Gk5Z*KEnZ= Uq펟p /ڏlC|"@yuXAuք| kh>g8wEH5M :wx[2f]!UV/vէ)A`!/Ք^2 ď0Lp&0|Gƙ//Dş)EUPqϝRo=k)a^?t`;?5-`^PCU!W:_[c9H6r"=`ᮩ'7;W8NO/:ND{[̘nP*[>}ďM9}_ߋ_*>mK.Zff9 *4  i3V 3tcO ?O9)(eLsqŘs@. o1oS@@ȒFnq/Y+|2-w.Q0`~j F&w$ge[+,|_ L*[KX%}bJeIENDB`caronc-apprise-dfec414/apprise/assets/themes/default/apprise-warning-128x128.ico000066400000000000000000002040761526720371000275430ustar00rootroot00000000000000 (( !8KVdpwwpdVK8! GG  JJ =qq=,,D  )&1,81?4C6E4C1?,9&1 )  D B2AOf(g/w37:>?ACCCB@>;74/w(gOf2AB R/<'g9>@ADDDEEEEEEEEEEEEEDDEB@>9)h/<RN )6*n@CCDDDEEEEEEEEEEEEEEEEEEEEEEEDCCA,p-: N )4 Tk5=AEEEEEEEEEEEFEFFFFFFFFFFEEEEEEEEEEDC<%`{/< ]G[,r9<>?@EEEEFEFFGGHHHHHHIIIIHHHHGHGFEEEEEEEEDB4!Sk]* Si59<=>>??CEFGHHIIIIIIIIIIIIIIIIIIIIIIIGGGGEEEEEEC>&a| *e ?O59:<==>>?@CHIIIIIIIIIIIIIIIIIIIIIIIIIIIIIHHGGFEEEEED@K` e 3@.u89;<<==?@BBDHIIIIIIIIIJIJJJJJJJJJIIIIIIIIIIIIIIHFEEEEED:?Q  #+(e68::;<<>@ABCCDGIIIIJJKKKLKLLLLLLLLLKKKKKJIIIIIIIIIIHGEEEEEC2,9.L^4799:;;=?@ABBCDDFHKKLLLLLLLLLLLLLLLLLLLLLLLLLKJJIIIIIIIHGEEEEEA(e.H+o67899:<>?@AABBCDEGKLLLLLLLLLLLLLLLMLLLLLLLLLLLLLLKJIIIIIIIHFEEEED6 #HG0;0y57889:=>??@AABCEFFGJOPLLLMMNNNNONNNNNNNNNNMLMLLLLLLLLKIIIIIIIHFEEEE>=NG8L^2~57788;<>>?@@ABDEFFGftNOOOOOOOOOOOOOOOOOONONMLMLLLLLLKJJIIIIHGFEEEC)f8F &c{456779:==>>?@BCDEEFG|hOPOOOPPOPPPPPOOOOOOOOONNMLLLLLLKJIIIIIHGEEED2}FE(e3~46678:<==>?@ACCDEEG@OV"%q[QRRRRRRRRRQQRPPPOOOOOOOOMMLLLLLKIIIIIIHEEEE6E, (g~3}45678;<<==?@ABCCDFFnCSZ.:?x}\SSSSSSTSSSSSSRQQPOOOOOONNMLLLLLJIIIIIGFEEE9 "+, #+k2}3~5568:;<<=>@AABCDFGQ6CIiUUUUUUUTTTTTSSSRQQQPOOOOOMLLLLLKJIIIIHFEEE<+7  ,o2|4}4568::;<<>@@ABCEFGHs"%]VVVVVVUVUUUTTTTTSSRQPOOOOOMLLLLKJIIIIIFEEE< !+(e|1y2|4~4689:;;=>?@@BCDFFGQ^t} vWWWWWWWVWWVVUUTTTTSRRQPOOOONLLLLLKJIIIIGEEE9[ "Ym1x2z3|4~579::;<>>?@ACDEFFI cyYWWWWWWWWWWWVVVUUTTTSSRQPOOOOMLLLLKIIIIHFEEE5 Z#Re0w1y3{3|5789::;=>?@ACDDEGHbBQXSfo[XXXXXWXXXWWWWWWWVUUTTTSRQOOOONMLLLKIIIIIFEEE1z#HY/u1x2z3{3}6889:;==>?@CCDFGIK l]ZZZZZZZYYXXWWWWWWWVUUTTTSRQOOONMLLLKJIIIIGEED'b~e-6-r0v2x2z4|6~7899;<=>>ABCCEGHKv;GM\ZZZZZZZZZZZZYXWWWWWWVUTTTSRQOOONMLLLLJIIIIFEEB9IM)f|/t1w2x2z5|7~789;<<=>@ABCDGHJV{zy[[[[[[[[[ZZZZZZZYXWWWWVUUTTSRRPOONMLLLKJIIIHFEE= !Qd/s1v1w2y4{6}7~889;<<=@AABEFHIJ{6BH^[\[[[[[[ZZ[[[[ZZZZYXWWWWVUTTTSQPOOOMLLLLJIIIHFEE4A0<-r/t1v1w3z6{6}7~89:;<<@@ABDEHIIUQbiw\\\\\\\\\\[[[ZZ[[ZZZYYXWWWWVUTTSRPOONMLLLKIIIIGEEE$[u= -q/s0t1v1x5z6{6}78:;;<>@@ADEHHIK Xjt\\\\\\\\\\\\\\[[[[[[[ZZZXWWWWUUTTSRPOONMLLLJIIIIGEEB#-q!Uh.q0s0u1v4y5z6|6}79:;;>?@@CEGHIKa7CH"f]]]]]]]]]]\\\\\\\[[[[[ZZZYWWWWVUTTSRPOONLLLKJIIIIFEE0xE+5,n/r0s0u2w5y5z6|7~99DXcffcUEFGHJLau^_________^^^^]]]\\\\[Z[[ZZYXWWWWUTTSRPOONLLLKJIIIGFEC8Hh #Wi.p/r0t2v4w5y5{6|7fXHJKL_Wjr d````````````__^^]]\\\\[Z[[ZZZXWWWWUTTSRPOONLLLKIIIIFEE6 0+3,n/p0r0t2v4x5y9}\~Yjq8DH&.1")+*26DQWKJKLMw8DJ |aaabbbbbbaaa```__^^]]\\\[[Z[ZZZYWWWWUTTRQPOOMLLLJIIIHFEE''0-m.p/q1t1u4wT &(fzrJeTShw wcdddddddddddddccbbb``__^]\\\\[Z[ZZXWWWUUTTRQOOOLLLKIIIIFEE Pg9&au-n.p/q1t2uL%'QJtXjqpTWmWjr dydddddddddccdddddddccba``_^^]\\\[[ZZZXWWWVTTSRPOONLLLJIIIGEE= %-,l.n/p/r2t<{pI~(03r_WYufddddddeeeeedddddddddcbba``^^]\\\Z[ZZZXWWWVTTSQOONLLLKIIIHFECFYq#Wi-l.o/p0s3tf%,.HU[IZk/8BpmHj(04:FK{lghiijjjjjjjjjjjjjiigfffeedddccb``^^]\\Z[ZZYWWWVTTRQOOMLLLJIIHGEE %4?,k-m.n/p2ri"(+/8C$''/3Ykt^]\\[[[ZYWWWUTSRPONLLLKIIIGEEK`BP,k-l.m/p2q2s~ &(WgmrFfDQV  "'.2:EJO^e_pxltzzzunas|Q`g@LS)04"% KZad^\\\[[ZZYWWVUTRPOOMLLKIIIHEE2}%^r,k-l.n/p2r3so09=KI***^^\\[ZZZYWWWUTTPOONLLLJIIIGE>Q,j,k-l/o0p2r3sTSbhveFl$'333lllJJJ _^\\\Z[ZZXWWUTSROOOLLLJIIIGEA #Q ,j-k-l/o2q2r3s5w 7AEHMbu| `^]\\[[ZZXWWVTTRPOOMLLKIIIGEB8H/9,k-k-m/o2q2r3t4vwERW \E$&L\c~`_]\\\[[ZYWWWUTRPOOMLLKIIIHEC!RiBO,k-k-m/o2q2r3t5vBXhoCb]nu;;;***GGG444&&&h`_]\\[[[ZYWWWUTSROOMLLLIIIIEE*h"Sd,k-k/n0o2q2s3t5w8zs'.1EF jjjqqq ``` h}ba_^]\\[[ZYWWWUTSRPONLLKJIIHFE/v&]q,k-l.n0p2q2s3u5w6yEiBg:EI777888'/3kca`_]\\[[ZZXWWVTSROOOMLLJIIHFE3 (au-k-l.n1p2q3s3v5w6y6zWDEz!!! ,,,dcb`_]\\[[[ZYWWVTTSPOOLLLJIIHFE79 (dx-k-l.o1p2r3s3v5w6y6{9}IwpHArlllAAA+++ 555N^eddcba_]\\[[[ZYWWVTTRPOOMLLJIIIFE9 Q+)dx-k-l/o0p2r3t3v5x6y7{9~:;=?As yyy oddcba_^\\[[[ZYWWVTTSPOOMLLKIIIGE< &d9)dy-k-m/o2q2r3t3v5x6y7{9~:;>AA|7AFTTTVgoedddba_^]\[[[ZYWWVUTRQOOMLLKIIIGE= "+rE )ey-k-m/o2q2r3t4v5x6z7{9~:<>AAnx```kedddba_^]\[Z[ZYWWWUTRQOOMLLKIIIGE?%/zJ *ey-k-m/o2q2r3t4w5x6z7{9~:<>ABCXTdj@@@RRRxfedddba_^]]ZWWWUTSQOOMLLKIIIFE?&0vH)ey-l.m/p2q2s3t4w5x6z7|9~:;?ABDEFr4>C iii-6:kfedddca_^ihWVUTSQOONLLKIIIHE>#-k>)dy-l.m/p2q2s3t4w6y6z8|:;<>ABDEFGRx.8< !!!111AAA888gfedddba_^)27 #&xbVTTSQOOMLLKIIIGE= (Y1 )dx-l.m/p2r3s3u4w6y6z7|:;<>ABCFFGJK`uEEEXiqhffedddba_u9EK YUTRQOONLLJIIIGE: !F$(bv-l.n/p2r3s3u4w6y6{7|:;;?ABCFFGJKLOdDQWuuueee "ohg{ba_,5:TTRPOOMLLKIIIFE8$'_r-l.n/p2r3t3u4x6y7{7|:;<>@BCEFGJKLMOPpCCC///iii^pxjoa_N_hAOWgTRPOOMLLJIIIGE5 $Xj-m.n.q2r3t3u4x6z7{7}:;<>@BCFGGJKMMOPQa.7; !#lj2<@=JP_i%-1URPOOMLLKIIIFE1zIX,m.n/q2r3t4v4w6z7{7}:;<>@BCEGGJKMMOPRSUu;GLJJJ___jmi};HNs]6BG^ROOOMLLIIIIFE,n7B,m.o0q1s3t4v4w6z7{7}:;<>@BCEGGIKMMNPRSUWd?LQ ABCEGGILMNNPRSTWY[KZ`lll---@@@III jim&/2n\o$,/WktROONLLLIIIHFCCUf -m.o/q1s3u4v4x5z7|8}8;<>@BCEGHILLNNPQSTVYZ]Qah---III`qyjjiho|\\n"%rOONLLKIIIHFB(3f2+i.o/q0s2u4v4x5z7|8~9;<>@BCEGHHKLNNOQSTVXZ\`CQWqqqOOO$&njigfz5@EIY`a[d"OOMLLKIIIGE@ 2O_.o/q0s2u4w4x5y7|8~8;<=?ACDGHIKLNOOQRTUXZ\^_'/2uuugzjjhffez#&zZ[7DJayONLLLKIIIGE91;-p/q1t2u4w5x5z7|8~8;<=>BCDFHIJMMOOQRTUXZ\]_` %(ljigffeiZZq]r|6BH`NLLLJIIHFE&`z-p/q0s1u4w5x5z7|8~9:<=>ACDEHIIMMOPQRSUWY[\_`baaakkkjigffedd&.1[ZZ nNLLKJIIHEE,8>'`u/q0s1u3w5y5z6}8~99<=?ABDEHIJLNNPPRSUVXZ]^`amv444 KY`kigffeddd+48[ZZ yMLLJIIIGECFBP/r0s0v4w5y5z6|8~99;=>@BDEGIJKNNPPRSTVXZ\^_abwCPV!!!WWW xifffedddd&.1[ZX ~LLLJIIIFE.q &./r0s1u2w5y5z6|89:;=>?BCFFIJKMOOPQSTUWY[^_abci}igfffedddcZYW LLLIIIIFE2@ s(cx0t1u2x5y5{6|79::=>?ACEFHJKKOOQQSTUWX[\__bcc&&&#)-igfffedddciw '+ZXW ~LLJIIIGF? > N_0t1u2x4y6{6|7~9::<>?@CDFGJKKNOPRRTUVWY\]_acdkL\c***HHHvvvqfffeddddcb/:?N_huZXW }LLJIIIGE)f>,6/q1v1w3z6{6}7~8::;>??CDFGIKKLPPRRSUVWX[]__bdd!!!SSS%,0iffeddddcboZXWW yLKIIIHFD5D*h1v1w3z6{6}7~8:;;=?@BCFGHKKLNPQSSUVWXZ\^_acdelyfeefeeeef+49ZWWWcz)48oLJIIIGF8:AO1v1w2y4|6}789;;MTQeobKIIIIFD&_y: 0u1x2y4|7}789;;<>?@BDGHIKLMOPRSTTWXXZ\^_`bbcdyodPai"%HX_YWWW'*PJIIIHEB $YDS2x2y3{6}7889;<>?@ADEHHKLMNORSTUVWXY[]^_`bbcpdt} /9>mWWW\vLJIIIGE/tY 0v2y3{5~7889;<=>AACEGHJKMNOQSTUVVYYZ[^^_``bau*37dd '*5AGWWWW5BGDU]vJIIIGEE ^DS2z3{3}6899:<=>?ABDFIIKLNOPRTUVWWYZ[\^^__`e yydd  XkuXWWWf|yRIIIIGE*h_ -n3|4}5899:<=>>ABCEGIJKMOPPSUUWXXZ[\\]^^__^r|2<@cbb?MSIYaXWWWV&05JIIIHE@jGW2{4}5899:;=>>ABCDFHJKLOPQQTVVXYYZ\\\\]^^qsaa`K[c 0:?lwXWWWU)38iZIIIIGE"Tkj .q4~4699:;=>>?BCDEHHKLMOQQRTVWXZZ[\\\]]]^BPW[ox```__bXWWWUK]e$.2LIIIGE9 u1>4~457::;;=>?@BDDFHJLMOPQRSTWXYZ[[[\\\\]~z#&h__^^^fjYWWWWcSgp aIIIHFDJ^u#Wk4579:;;?@ABDEFIJLMNPQSTTUWZZZZ[[[[\\7CI.8<\\\\\\\\\[Z[[[ZZZYWWWZ\s~QIIIGED4-84668;;<=>@AACEFGHKLNOQRTUUVXXZZZ[[[[[r_s}}k\\\\\\\\ZZ`|offr;IOEW__IIIIFE7F !Qe667:<<==@AABDFGGIKMOPQSUUVWWXZZZ[[[[Z @NU]\[[[[[[[[t_u1>?BBCDDGHIJLNOQRSTWWWWWWXXZZZ`[Z[ZZZZZZZ%/3pIIIIHEA # "688:<>>??BCDDEHIJJMOPRSSUUWWWWWWXXZYhZZZZZZZZZXX azdIIIIHED.;"1=689;>>??ABDDEFHJJKMNPRSTTTVWWWWWWWXWXwdYYYYYXXXWWWW!), 1=Cc{SIIIIHFC@Q"?>N89:<=?@@ADEEFFHJKLMNQQSTTTTUVVWWWWWWWWWWWWWWWWWWWWWWWq@OU%)ARYmgKIIIIHEDLa?aDV9::<>@@AADEFFGIJLMMNQRRSTTTTUUVUWWWWWWWWWWWWWWWWWWVVYaNJIIIIHEE$YraCT::;=?@ABBCFGGHJJLMNOOPRRSTTTTTUUVVVVWWVVWVVWVVUVUUTT`]LJJIIIIGED&`z@BBCDDGGIIJKLMOOOOOOPQRRSSTSSTTTTTTTTTTTSSSSSQQPPPOOOONMLLLLLKIIIIIIGE@9I 6<=>@ACDDEEHIJKKLLNNOOOOOOPPQQRRRRRSRRSRRRRRQRPPOOOOOOOMMLLLLLLJIIIIIHFE? "+ ,o=>>ACDDEEFHIKKLLLMMNOOOOOOOOPPPQQQQQQPQPQPOOOOOOOOOMMLLLLLLJJIIIIIHFE6  Qf;>?@CDEEFGGIJLLLLLMMMNNOOOOOOOOOOOOOOOOOOOOOOONNMLLLLLLLJIIIIIIHGEB%\uU)42|??ABEFFGGHIJKKLLLLLLLMMNNONOOOOOOOONOONNNNMMLLLLLLLKJIIIIIIHGFE9/<U1 Rg@@ABDFGHHIIIJJKLLLLLLLLLLMLMMMMMMMMMLLLLLLLLLLLKKJIIIIIIIGGEE$Zr 1 $-5?ABDEHHIIIIIIJJLLLLLLLLLLLLLLLLLLLLLLLLLLLLKJJIIIIIIIHGEC8$.|DW5BCCEFIIIIIIIIIJJKKKLLLLLLLLLLLLLLLLLKKJJJIIIIIIIIGGEE7J_|5@Q6CDDFGHHIIIIIIIIIIJJJJKKKKKKKKKJJJJIIIIIIIIIHHGFEE8CU5c3@7DEEFFGHHIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIHGFEE96E c+73~ACEEFFGHIIIIIIIIIIIIIIIIIIIIIIIIIIIHGFEC@2}+7H  Pf1z=EEEEEGGHHHHIIIIIIIIIIIIHIHHGGFFFE=2| Pf  HK (a pHYs   IDATxyUǿg23d; I@} Sq}@T'(nPvNX&:YfMf޻g&1A|4ds9p}>\K\`P 3@H  lVDLBbZ)VY}L|H׀]C< ualzezָNχ2{g^ ?ch 16Ȱr?^"^AUJzi:zNg;םk@?;;@χ ggaG(FWʂi̙X^O_L:qGw7vnVm须/M* 0K} c0"̟VɸI@ `+\8 Hi?eg?olluWTZ~ PG=pؐd4_:gU;z_wEA(![̡ba̿Le1#}6-\Ÿ2/KFië+;ѳ?TWFxc3A/ʜI'OE(JoWUP9GO _6/CN,Jɪ-=\g0ہK ڨ26ȭWa0a8x)QVI (b8 %/iIbCf9C!8}D1nD ?>IP1sGj+Ww+弙y艱&^pc1_q8jV߻h*%!/B*]( tGΞs>qE P8߆18(*||a:)AB^qAI kgsk _jQ~L]oO1`@5Ժ@:=u9p!)S9~~t|0С:`_ B hZ:F6C&N6iEhYnvKnDyΒ>y(fl]@Uu_1VI5"OxC5 @hA8)[LF(O.aR" ;בMt rLi{uwot؟W|PLg;ǖ4='mEUQL_o:֨@v4=]=s!BPxP F:%Ow_[Һk]Q4M( ԙHQ=(O`d=h%B dr|Vw:9`޿Z,FOkoyL=:}TQCN*Bѵ:#(JmVyb\pJcSs+?~^yct59Ǐdq,?iG3HLo'դZMjܤ̢izo=ϧU ҧuEE({/'MGV\ 'p޲QxպInGK~DJtM!T7$2VۺXxY3'Q QbT6^GK\PF]|$۱TNWM s?|W  fT%^tłB՜*Æ+XA>+h]EX,t tR& x״ڷ9b9@R9?!oB'L0U+(%T̒0 >R#Vf[XƦւdwsƉGy*Ivo̒MtE:l -Cj)d6%Kk 5TF>zڱ?l ϿDٛ4 9|D$6!SqZYOffeG0>l!bׯ>0B8n|>5P G(v4PRYp|lo;]}7ղ>e,7&&lZ++*Pe(CJ )f8*$o'ѹ7~"ęlʘ/1alBxzBe,{J`kV;fN5'Yf,^)h3(S(b0%޷xj,@h#yu--%^2BO_H|%#_6 _|T9Z&ڑLTt'pH3+8#(Aߋ&u~b6vU~FsM^{c U3PPϮb,_X<}.@(H(W+'\753Ȋ7k tt{YpBm l xõ(t:P(oo `%X;BU̦Hnŋ㝕vg/ʍ|c'ѐ!շÒsfICu:fV} RE) o͓#sЅI;Łẹz)43hRrPPUxU?ݎ *[_1_B[{_ίT?aS>Bh}g}*wjŋg-eùG"h X8wJ5Z{8T_#5XTb$neFZqB 8K5  G1 F>@Q <65M./_Ͽ2ʵsG BM]LVo{K2loÓϾɯ~ ڻbXMBQ^lzw 3N}X|G(Ǣx|Wje[p2zƸW泗dR'l 5!ٳ,/dd$g9Qu鷿 qgطt0K2)WO|M]J(NJrL!-5JʷRE*w=t@oѧ_GJ F8ᛗ}HEQxT;c\yZr0'X+8]=&1ao8zAb[I$hNM imc3(9-'5:a{XBJ}BXWL/=4lBuM9~v׮o TNFR$syX~'#~w4}?^,&z_k+W߬?5rn9&Y:iTAaN(5|gX㨙UCnMrp4DZ*{U> ́FT[>[B0Q(Jfkov0IG:lL|!Ⱥ¾JG N\z49¡ _cG0e(< }l¬ͦ k+ֲvcRB;t@LU ΍&腤-òS=,/Ba!ӠXSbFD7R0g<lz3۩Jp ,VI]}/A!`Y k#(N\ZJlxÛĺ$w_Ip=]}x}C&1c8쳩p=W܀0';rhDiF%޾osq.sIl`EN@XS}+#$:6y4>ؚuL[ H`bccK?}X!`RTUm̧^)H[3(-c<$_xk WTWW3uTN>do?+W"o\~aպ-Ǒ%#@obgdw3͜%,>rt^zt:ELM&lƆZ<]YOqXCB=!xN5^93:(( xO}M]]A97f7jEf's&̑Sh"9FjC׹خsײfqz.f̘aܷ-&NqցuY!߱$ux=N.8K$L"AH(4-x}8g%Ug28' n\u5*&Ro"@Zݴ<}Ŕ@d|kk߹FJKK;w)QU;(=Bf d6E:n׼k6l3qWYz,fv6zϧa*1@H'GvkjiId|Va^s+ b j`t\umܽt)aرC:(;O_^_VL٬UwRS]AMu4xI]C~,:kp[sЛmӬ\&4FLGIajd +f#XQ΍=rQ}a"u@(gyQ*jjjpWtßmll jF ϋ-8g,ٛP O^[To8À~lɼ9160KetK\:GUY9D3Ijҟ3y[+am\}CU~5yd>OO+A7\'TcJh ֐L]׽&Tö=d2v^[v~3_ίyN/>g6?I0(ȓ:tH{o7fyotQµ$Ri>khk/ދ#/x<\r%EWIME%P9ɰE@*C{{aݬfSQIxB`fRi;̜6xToċBGB-p` 0c)Jڽ}]s}sE\ڰ_Ivֲg@Λ7={ܿ;eʔZ`Vnz+UM-j8n$>,K gFY8jfo,-`=GΨr~t@ pӣG(;<B D2Ai -oR( KldK 4mԦϙ3ݳ_.w:W-dѪCsɭΪ7T|=o5!$߼V TL4%NӲgd|>/w ;ɦzEÏLj{"$qGFUUkxRJ:zV.~zvL7_~0 h t*}/1gsUt D۾ SHqb@Xl*O •&;ZJIQ.!jY~qѣ)//w=VWWOS{Ŝy,[ثo/-缳 9qԴtM'\9Z Il{$;?XŪwguZ6')ZQ$wcawGLq8o~v7;I ( /}g}B/4Djwh(Mȏ]. K ~ R𱇣I˯7q5p?>dWU%KtRcm]V*Y⯘PrPފ /v0d LNҋ>7k#PksopŷSϽ\P &$6mbu]|[ߢ~Jn&!)%?.X5*$CKEХ//H[ifS$Y <,K} \F]L${֣e'oC<)Vpx&V^MSSk֬~F$Iy|Ms >G\zv~">p|Zs%Ԡ02/'SY9NQl7A޿z\ac: s;Wn65=?_]wH`̘1455QRRRpl֭̚5 FEQx8묳jyzj/>r+G, ۚדR3Bcr N䎛Rq$5ͽ\t{u&qtai5J.Mآᗀ?TƘ(t8{|8uд, gq GR6l+^yPJAO4b5\S_u ?D'n ۨ'2 c[2ȶ6!텠VM$B}L265o֝:5j1E{V=ƥ$:d 0wygCͼ'? >hQ{i6j<*|,ݣ | /q|UXju%a䒥F?1zUE_G{G7O.~LTEecٱYZV2j.{ Cꀢ|0k;^) rښJUF xRc |O OwC`-H F;Zwɛy{;@EXv߳N<wXjsڵ<䓬X76$tvrBooxX9#Ǣjl+hj6e3ⶔ3BP;r-;x䉗CXo!٠lxښr>ѥ.#ayނ0J{?Vqe{'-PCE٬d뮂V9lhe= m,;_=+vmso+p좹Tr$ٹ>uީlؼ=3gg6mĞ={صk7ok׺y?VGW/m]L7ŽEҔ~Y)P,lj)`71.h- Y5붠i#* sEwOkYyA{[neɒ%A6僰K#@.q]EBA±d]//hng I0TFGg7n?E%TNcjvǔiKGrIgg砟SUH8H8$S^*˩(+!LIKI{M{> 7J, KOrÙ6y Z&A 1aEu| +]C,L~sk ;zc xG5̡TKOh4V$<8e鑌UOvlsѮVz<ꪬ(eƔqL?F0nH43`nZ6'odVVEi-evf۸]mDA[t}\X*CKbe<2ȿ;΃,QlI2LAujc?ҋQ9Xz};eӹpwt|^:8i7RS]NeE ANkKe܃u'5̎d>M9P'Oo_?>Jݰ*lIluZeaHh/dQ|g$Kd8ٔ1GLOj9dvE/C 3 =Aka v?[^dVcKK70 w$Ea:(^vo~ yI]g8naIldwcqa:&իUؼ@3]JtHt-?A S} &z(ZF:x[h<ECa\b+93ӗf2"!e0beXDXm1}Y( XRCލ=ԌJYi 8/Z8)]MϞwHGwE(Cf*ґ !GKu r5 8w8XwBԵ,t؊X_[﹙9A^ݏ k^1{m |m{%Ҙ6Zxʚ`./nQ`̭ ͧ/H&eټZvigXu??ƴcоe9ɾn#DQ$S)|*K)Fwnp1'Qu`V;O'~ϩt8ҥ]w*v}ʉ | ΛVnFoMv0nlfϜ+5J~wF>~Ή(Bvnƙ2q|#L8^wJ@#F@X"ɍ7ǧ/!ya>g>&YDU Pv'eE=@Zm[Wak5oNro֒>3_hQ'g: JƈE;0i:gtuMevt0SI'$$̞#BK׾&{Gj?sh?/?w ϼ. |)- J21kRB\*$VI羀#Rmn5MV }ق>/P$LSJ$1nz;[>|{&pXlLxr<}ί"hu1_ l2D.ssdݨQrHfe٭(ԹFD $ky1qk? &'Vc'~Χ(ߡ rVm])zkLJ6FLM*ÓƔc\r3 ַ]ڳX.bw߳hG3;Wo;hMuS kMy깷?ci( Z&Cb(4.?ܑva!~&od}? K2@5'ص/0> ssn2$c;H۶AB ѰRǏ~qk AeWJvlcQ^%݌̦]rã8%[HΟC '{ڹθ?m8zFSk#*0ןh5HWFaikـaQd_ _J5o LPw #(t;FT͸G+K7n TL2]@pO6cؒ M҈'LOV e1]LT1cBc$7e!+]@LkFP!2nT~C~/yN5WO:Z! ;;?ݏlv;/:mrb` %h Q]7EXm9Bx4is~\ 6>'4BN:dM>2ޜWOz{B|W)/[ ُ>2?Kc7hen- }3iK,ɨRC,[_fܩfla ^2kf.HMI=K_jf%ߑB홼q٠K[?<ӥE3`PgK1I{{ȩ_8`ET뿛 ,xiu^Z ic ZK [5K[6Xfm Ѵr e^7h_ E4iHd~&)F (j,сRA4 qT_mگ-D$$־l{/Dn. = n(,+G4ޥ׭ 7?=vZO `Yv1kb^;@)+sH=y9,CY9v)s7*,{LH&F}5 ė=%9.%e'qUl wP@Lp4[w3eT jj$o9os " T`pfϜƟ=;>N8v.&OI:Nl``|,_d%W\Ka@+ Zû]=WOR~2@^IlMqG#Ô}PVw dd̄YŪu[]/j3⛗]@ȯw&{\:<~=c, VHZrXR0޶]Q.b\؋5Mu戊 k{45M@vm`Qd H: 5ttf6B&mW^t3#ٳhs;m`g P~! n-s~l>{l*ܝ$?K4_'o0m Ur8ƍ,[)U@(0A%UUlcN[ZV]q#=h~wF +\b* SQ\Rv"޴×N:: D٘@i#9>3hDoP'-ޟP} !P|Ha|%5EA˦IG[Ivm<+uOhf<޽DJ+Fcjv~yٕ)xr5(UQM41:3A(T^YG`Eb莳Ul‚i8'ɏ_*G 8$z`d=q^Ō%&/,(E?`T!yU!lƤVW Dw$k\GTnN;ix}u9;ljl9\7ih>@ G@{]s=BpȗͶˁGkD2KaWer(nC=O2`<0yicRS§~|~$W*68PQ8PĭU}UQN{z}u,3P}syЋ>g s+P?Έ`q7q6}ҰDŽ[{GyrhQ߱'Ưm7ۈƋI.c7ȭ/ĘZ\ʒ5|┑F2趿$uj}@Ab'3-]dzNףvW<5UE1F#8n0A^jhKd@iȃϣXƨ i 椹EFO4cT~}bI8pUY#j9|Z9G 9**: >#p_ -Z)uzyx~{:->ɼDW2@n{2Ca#,VαskP{3%r<#ۑ7»ngo* [corL (_a?a8',f'v0Vdwx"K:;$y}e iHkѬ N^8S+)/(x=ָ@¬t&K:JktY_M{ 8=Ac ρź*?SFE02Lc]r?HP%؁jiTF#;|[*IDATH$DYziu'ٱ'Φ(GwV<*XR;\ ~1zTAIC$ z>HBI,,} }C=;0@nMG~9#+>eqwXA~N [UC8.ZYCŸV 3oZsZ{Z`p 18cp 18cp 18Q ?q7I}@7?g}@35hG%p 0 |4g_a|&-{w XiCQdˀ j@TcG?ULC x xx $T} U}!< ea-l1,1>c!GM:ȿnCl^4óSap|\)]v0Oxۍgre Xsʌg88]j43O@G?)+S )/ )}>ϧtZ#ЛH՛'EGW$=):Svc-x xpǠoljÀi!dDBC 0!Ƹ">EȥH R !5Xz5g4LF?ӗ7MgwM=ڭ]lm%2soK{ڠ؟?@O' ~I,g㆕0}lƖQU$_/ͮo[X՛:MHeH54m]=!j7>ʁ?WB PaP}Ua+ ,JC1hk-N뻸-4􀁃&]" _~IjʃLUʜ|x- Ց~&JOn 6\ eZ b0-b¦-mŷZxoC-}{sKOV1 Aw`'8d\'QI#ǟW}v" zM7\]MysKї{sn NA69 US3qd)ѐӧ W E~Z sSFo"ûk۹k&.1KoG /g0hPX@]?Z1Q Թ*XyZ^º]z-I{wL/ `P|LD8mq>sꣀ@,\}&~_ B=ܷh ,ʍb 蕉A׀{%|ġ5!a-..i+m^}VdWMkq5)SNqԬ).އ)~ցfXIBs]=n]e8e 0qaMA5A` sgU3{!,u-`#, a -XIb\4e*}`P@˸^'3vq=ego/sPNYԨ( ġ'}BUƤוk& EO`n(M˨u ,Uæ>rFnx`w?=41&xp?zNQ2ja L{VBt'g }rBؖlAM/xVBД( *-l`;ݖ^/YT(~S8eNgȔ1io54@HS XL  fqQB0w6&z~[N.B''iTޘ \^_Ԩ /Љ2g'0](%<(bwf tOrx\TWWnkwN4=#T8"6ύ"YoQ ʟ \uD^Cd'>Wݏ 1~}jxn+]=Eg <~ >~;@I12i5RYؚ2W/ Ta x[8L@G>~ (h5_\4il[}vXĀ(wφ_ <7A|f2-6ZPm8r& `(zs/#9eN=%~O )B볹N - '@ȅ!2/<RRZ]#TE3F Tk+?u)3/bv7jꦽM|"cQn@V{_/\~8GinJCsS$-)\Zs׼ⱁ׍Aя#Yc+ >CkYc( sv͚ Y\GXI!}`@C2V&$=3?]bk >/>yt肅ASi# Ud4}/gw2`Ϛ`Io.O[Xg]Qzv~>{b#&RN]KmE;, F+8#/Rc;}l)?՛:ٶ |Boq *g\ 8qv ?xöbfoN մw@ZsJ% o=3&fp|za\W> B  (꼖diro˒Ǒ5!>}̐ga. =Tx=$# g7>;FOqwo5}RjnU'm"c5Me^ A?Vz;0| bE؏V';Xϫ+'M^:>{}8ЎA}hw7{U֌ o~(+*J HW{i_SzE}nq9M]Z#ȩ|؁F*?!+gXmW` z;p(rwlrї2sbK3M}WˆX{ afPXpe"l<{}3w܏q H2q: ր0.IH6w׵sO&PT7/>ƺw7_Ux-y UY2f &t;bE 7Dr"Z'!,@8<0'ͮe6)t4g  ŘF JOO+iԷ6k=2 ,U⻛& \g6?vh43 m>2@_n y3kxoCND&o8BϏ.:ُe%",o6ħZ.CQH\7o@HЄ@5; kM돦RX3s ӧC2ҏ/¯X-E& CK'ѳv2hZڕ)H $.M+xʋ_T!6B;~f&)* .s@t_r4Y#_Y3ƕy魖BSu z[@mbgorг" o,6j %W}Cn2DwJd/P0X(~yTV2X,2gIh*,ѭ&"*Hp2. XE>)9޾4oN&.9 y~ՙhs撧*>/~(]߈'ngS}؂w B T(XlTO%Z;{yp:ή:zhimgOk-{:h袯/I2B A0 ^ J1b0((HAWIv4*R"+L!u+Xŭl(Ƨ:ˈ *8 xz1sp~0OZw X|}I=i>#qHs( gfMXMb|zW X]|g"rʆ -KIUE)kPL #8"NoJ[R=6P,.1Ax?{NT昈81"NsU/U^/4B اtdJdٖB)yxfZZ/MJ}^ jy0R=h!~%Ōp(HyY!uU7g|DF nIozwЁ" ?pݫns=z^ˊAU89&(ᲯM6ܼ@@-R1}Ft*Jo?\.M^CLhn s66 {0b?'Eʅiy@$ RZOUV[?Fzc9f \`To+[^$\;ր wvo M`Q ^O, #J?l`er>8=Wø*xB`g jPIy mkA⳥Z6_A@߅M~z]a(j9fyxBXjY}IR}N~;ظyLJ67/r}*DI,@T.REB:$sV{hG'ߏa>{wX]|a,lZ+l=RdyӼB!|vKϪXhC%CL%R=H$•U!T: ѓcWϣB$jf!˜{nᖿ=FGg>ٺ{y7ylR6oI]M95*?RMt8T7D{"5Ucw#τށGp&{\ |q I>L?F[f"lϤIGa>0È8([`^g]z&ei?CwO/S&  +@lɮd]hTCdZc=n D'I kvwh gߨZ)D6̇Jtk~`e.VZZ!\(ŕAi"R)7Wڮ 'R=U}Y~{=\}pг<ضc7F4/֒܊6|f:oЋiV>=Sc܆?R/X{Ѽ*6m4dTS=MTˆk%o%0kB9wjcgOK0a䉞_KeYȳQv{* 8?7`|B3ICsJĽ* +OyovuZْ'TH%SuG' F>KmBW@M- K%DFCQwq=OIk.葍4xI= v{O;lbH4KE;d[0E疗mYY Jd2× ЩŖ F:ba={,UHv>i't!F@ÍBY&ǀY̧/BM%;ֲO /}a!uU0WzI+9𩹿7йuqaC.iYʏ~K-mj頚d.eY AG ƇE";V|kXjÀ}}I{#}}~}Vo`Ρ$//EIs[+i i8h?PB`' ]FKÎ%6psqz2WA[Vuikc XRǠM~omJgGlYw~|--0yW+H#ZZWka&>4[2m]N"|?jsEsI#Y~v/V3fP&3*R=H˘<7Weg^8 I|Yc BI_a~f7]Ssҗ;:Ƈһ{qŀgtxCMY\/(=QCcy wOp8czIu*{ У 5*, &$%\9NFet@(ݎTn[DkїHYxg G̰͞ƚ\ Ѷ dQ?O/[1 i5qdO34WN?f&_6Ia Z[a䖕_X؄!9 F#]轨e FPݹk \&:qCB$:60P A ނ`JKGG]ݽR)Bs-{y,t&9i"R`~6aDW;CϩY?AwAgd2CаgrOZbfKck eIh]a[rOzdU؋%FzRl⬯^[P˒B$ʉaǖHvlrٝVGl;v俖sKyoFlLFK)|3j(NqGNC',( -Gηtr|Ycf'V+[;8 SsR_3hHr Y/zS'g\Hv_-{Q^g/#U~9+iy9e!#,S8]RsZL/DXsX'j\i%M0+5}e7i"0)ӻg'>pѧ^}VodWK LNd2R4]=lܼů.kIAI,J4M bCHvl![R_huk}@_$, L?']FGil޶?yi#wIvUA/Nƪ|%LF OKQD>p\vZN"gڪ9%OZ˃ ,$}Z7,/znm \5@67zٯnf$bz3*+4؃l\9O~QSZƗ.Ҁi굛yxٶc7 Cj!bƓIvkbr b&dUW[ɰ|Ţo{s cʄ焖!ѾBqTx]ttE^f +0kO[ϤeZV f]XK/v_2fk.~ΊTg EW65fr5k?DDnN9a>>U|2N=yE,,]ݽ\rōn>. Yofc' ć"}A];Lw3*MqL=nZ]*vzj,]L)TuY{ysu[>Y!\* pĴ\+k˳Q=Ξhj;i_aw)є.8lcܑPHd |~O>^z\dpDd vn16s*WpC6XIvеݗ\4]Xd _\tJ|o*v8ZaވU(0h] BM0,5!(t]N34Weltr4uMJܚu[xeϷ=bbCl=u'Aw_ˮ1 x#[\o%F.,o{'TvŲ̷ps&‚]jxm 1etB7ON5TOj4&M-мzڜRZFX_|j3tiV\sR9k,z~<ʇ+]pQ`x~Q>xVm8B]k/̷ݳ RʦC&ul^Sܑ``U |TbGxSƖSUtVtw0[PYWHr]sL7gB(KzCS _6(u~Y|g63*syYpw>(wt1+ǺS tn}IRYQ8J? ݿUTxin\Q.WbGphǑS+jL!G(j5*E5zv\4'B €ku ogމ "Ju}O쓴~ܻZ(O)V;f [ qUe}Ys/:Fjod/;_Vzl9(꫊SBob6/?RMp WGPwK\U?˷T<͝,&eo{_V_;]UǦ*}`~ N݊ߞ$Z7CyIo_Zٴe+lwg5{=jj_z62 >XnmwK;:T0C\y5Me][R:Ȓd{;Uom'g66ٛ:c3gj*(/SVZBUE)k2q9O84gE#!(`ϩ'-m=.T*KXJo|8;jFcx3VY 9 `0u>~m) D=ԧ9~)\ aPFSVP;]]mOD?t?@No4j]ӱ=]Vcڤ{_ƙ'xђ/$ ѱA -G #Rx)̩#ՠ!*py&SS6U5!EoM49Am.5DԤk5.Wؾɟ&T>ڰ{a@7*r G*lOk_pQV3VZtocwh_GTnR=ͤIvnm{Vۺd6ҽ{Һ {~ƔL8X!yMۙ>yLmBizX#J.mqa|]6n)\{1ILItl6ڰK攖_h'_@) 1먭 1!bZb긥bsLdr[ ӌ4_aDr`Hxe-'^d\zĨ[tD&ZW۲=k[Gk;62R;k]Ketl7[^ ;seD#d2;6AR=͊ 9mLQ[؊ޝOYOUY^tC6?pP qDC[jm0ӵ~wMȱgmY7ZΩ~Zyn֒T$p!43>::c “.QBmY*lHzt}^[;rǏ7^mE-"B# G]Tn> YxWH⊸ ) oHE$䉆l~ '2=_DyҎK{j4W֏h#_B}•KC=w̱SZ/8{z0% N`\TF+ƺaH'ڕIX[SN(X8_wT&֭}N;;}nRL684( 2)0Wx@ٺz9)@i6jE ufSFftYBhHD/=m溿܋xqwne(]]u-oN,V^ʼnw+5}̚Pϳ ACV?j>yWc%>BgvA eMq0,&}ZN+'*'Ͻ:wq_埏K,V7, *\ޏ HR25OS:߲;[h* :yEWڗT PܙՄSӼoj- f$o0SnVЙ' T45w491{9!~~Kd Qˁ\NL.׷}$AZ!H%YE-F]Daƌ, +ˋ+K^n4PWzzҮ8yܩGH^|FV.3u'%H^O@~0/cjtDmq^֌*{~͚=VV0}H$e*G޲WpeYnR\AB+Orr5vv(zΞJ1dG(,рM% C(د'XU,iT\` ryeWJ=mVndn&ZfO%2ݬebjN#T>hD޵?:}=^4/d4a gY6$"^Թ >jeNniwЏ cy#nO 7(Cv84qq-_1 g.](Lܢ46C/H$/+oq0 {KB#[s蔄BY?*mքƺ ۊX,bhs"oPw8;1aʘIvY+`fmZrR x4IhˆVR m+f׆Y&ߵ*DKpRyK xdB9 LmK)re}ypiUG<}u~=yRkO4jTcM/#FB -hv X#6)m<0ſyd2na#.r*˂V0UX8nQ%VPL;J ̕d2ɫE =sf=@XԤϘna^ֆK;_T(F`[rE5Ec n\ZŠ_|"2B*V 7^w.pҁ8N$ᵷVcnBe#,wг}23EEא*UZs$XmX5V;6)ъ}E! Kf-GD&і•䳀 _TGXsQ1ϻnV.7wO<%\n[M:+@]ERkaESUvZOI( юa3)!LLۜ^B. -~`̰n 2>\5#5s g*bm~M,\R~X~ʇI R6~tuXs97x)% .`˶{}#nnwP VGJOUL?RRY IDATC B颞ìZ2N4H|ۜ]F{,A)^>AUE&D"Xz6ۄ ukb M8EOe.Lx [~'T8[JG{̚5wy;３Jo1n8^x>7/,~|+E(!6D H_dQ)`Qsl. |Ků./5cL#ճKUtL v+j%~(^j+Cҁ~[+ƛѼW&zk2M3:nh=-r©1p3 .g^9h1k,-[Fee%ӟ;v,]w1?.owiĆAdg|;r ɮ0V&Mw>Z5F43qlzE~Ő٫VHQzmceɵFwZd<TPM3?z!9rK=|ㇿُ1jkky97IKKqW㦻V>N@|,ioSyoGs5|v(ܻ[0zGy,sM׷p8Fgg'{,,^K~llKp8+@- 4ɹ޾DQ\Q; LG$|Di,};zP 7wG6N Wh^VpkA=eXUhZX;f p>_# :T~r 7op?R+ٳ9c<3g6mbĉ9+>KG(9_KB+=~s͕2ѹtC1B9LYdVgWpƧQ,]+<&L86 $,S3)/(kl񍔀|C]5WKT jǜD0RW>>Kwbرos=38{ｗgyRկ B(b֬Ys=KA8nOmuBcB'Hw"]w1e 4Z*?0Jas1PSeVy&w)bo&As|T%;p@@DXPP"Ңz_VԐVXϧy]>`aIݸO }jfwK*}V'M-¢E={6]wwx'sz饗J8393g7p˖-SN/稣[M_m5l<7d*;[+QJ oEyEvJ(sem\SvTg[+bWg Yvw[\iJ/L(dSfn!44$= Ed /eR"|j'RV?nCff.o?qDnM_ε^K[[ɤ3kqٲeq\y,_38X,W_~;mF:LѽE|9ia9AsBf;WҒ(~qp rZuҵ%R3Ei\1N~WTz1CPN%"=Uuy+b)/0l $d4Hktk52NT]evM(YԎ<~K^]ߺP(%\´iӸ ~Ʈ]\nff͚ŗ%-[ѣ ټygO3ݹg)^[EymL<~t+ L_zIdȺx^yKEE:KY=z[VA&Y;@(PSy,[xҫR|!,"?N>>7?= -[Л9̻_ R>'*s|_XNkjjr>%Kp-u/$;v`]cWğDjLq{no*+J-`m/+`g#s~S5t}$:\g/uml @h,pjS`$, 4*ir,jG(;uw;?ȳoaUwĈ477}T*GZ[[?qǦS ~ɤItnS8g͘m]tn}9]#5jlŪ +Fc}5_W_(ٻ6@ O!|AbeèhB0Zx 6mw;>4RH$O?\GMSSWvG}43f N/rl2q`׿:^+  rff ~z 2DFS_ mk gG1e(x9֬ߊcƔuƉF^}mYEc*U_Qϝ6)G&\&CϮwI7|)j ͫZ1x$_MG rwzΚ5k3g==='oW^s𗖖RQQϧYv-G䪫#GsE1zhٸq#+V`͚5d2fϞ͍7Ȟ={/ =bp8̱?… I$\|466HH|Ww/?˒<\6 _0Sɮmtn]\YlҒ1~=_"d'=޶MRU>Yp1+Rg/8*hϴcUsQGqw+vZ***R̛o} 7W_g͛ǨQX|9?gر%W⪫BW^Ʌ^c=׵2q&1 i|J-"Ih[ mIk2N/RK9 ! Jӏzw[WԳdI.үݾiIKG`KS w>LRu㤄cum "YXy#ՍS'w.{_֬Y7aDjr9y饗hjjf{,X*bL.Z[[s0[ncܹ|+_n HJ())?)wu6䷚F6 @u ?u7AoZKqyP%XsRLd.[ei(s%=\~NMw*z\2444 <ӏzD>K:zxm]O ,{m}8Ds4i6}1ǥki7q9nrV._o_q<[oeҥ̝;|1cF9H&1/x\77n]wE2SO޽7yf:?:UOzYd pE1d⊂zn_&"t_ ӽ})]Ow{PSYj&2# qùG?HѳmlhPdTy3tv@F>C؟XxyVE Zއԣ[]G0l+nTo!nۣr@ hkkge8ʳ9SvvW=511%&D^"! Ho.{^qΜ6Ͳ̙3gyv}W_Ç#O?ܹs,8 L:UK/rnf3\CCB|G__|1#R|W!K :OJخRՊTBD ]+AOўv{w,M߁Twը.AzV s&#I+K!*X2NI ~(| dw4@Y/Te|t8SO=]WZի9o .^3gN3)))BSxO>-[z;ka*`KGSu Q&~.EfF*)vV8R4n>]O%_C"! :EB&ՀnG);4j, 7))-je7hYrp+5Twf_~ 5>#O >!~РA;w.f͚Áe˖߆nǂ b8(m6~ￏk"==rOk-\]v>,Z~kb^:98^~SM|x(p _<V,}aq5Tu׸#eMQ_bD 1.]X|@X=U=r1Rc RLFIdYH+? ?h81ӱuV:t}VXf̞=ݍSO=gVެ4鮻˲;w.&L`m- rrrp 77p-[n >_UBF"Q^{`shZ@jHw B]v,L{(d @Vަ{9zZ ^z^KW< ': zbhH$_\M= J Cf`0{v|ט=6<ʿQWbx9s&nӝhƏŋc۷/֮]+WiiiX|9/=p:jnۍ뮻ǖ-[ /?oߎw}SOף hii믿n,X^x!z7u^ɓO8 %+C6lAH{=ؾݵAوJ5E\{*N.% QR^ nqPIsK>fI/CN1Zg,Ceunݟ@m})ew Gn?.SN/m۶aƌxqꩧb̙={6.Rر /`ʕD~`W6{lxefؼy3/^oY0^~ebҤIQVVUVa޽?<~_bx'w& aIlYZE^ (_F4Ə!]%7mǓ}J-j!HV#j}b>Z+/Jo"3BA#[Q BP+1qҲ{+BLiڢOMmSɓe]G0,X1c ?zՊ_^{-1zha梻݈F8[s(>|Ϡ 9@ID677ЅXhltwT=nSRʬ]E%|ioy;֪u;W d4,MlIWfSuBP4d DKp˟3/oJ '`ƍ8."[L"/^ns9no͆1cCkk+q>@FF~^Ǝ 6 >8;h< < q7#M/}Ad*DܚvċaO5B]w׀xuu3nqO]o6Lc,Ri؏w&>'(D^hUtqٵw.j4{ｨ9S0i$|g;vQo<{xgrJ꫸ w w22ԛ4yێ:,\ 7x<<Ø5k:lţ>r˸koZڢK(}au;U&'.RtFң&]Ļ "mÈ!Z@^ϗBחB '0:J=(pHq`Гot>ĉxef3<Ç~. 7p|I,X&LСC1~x\yp8x1g" ᫯#އ{}[̛7C A4իUÇg!##cǎf7|z {Ad?v?3gL@|^, aoCA C!#DI0Ou=5eAATK5~gwVԠ3e(3<>Ѣܢ&~T/E<a/1X߯6M=p+--ￏo9]qشi^z%dggc=z4Ə+P\\> `2d,COk֬ղ|>a8筷*VEEnVL6 ^x!n/"$`K-͕/Fd-9oHX+4#/ӦCD(S" NR3 k&H G;4<655۷o{ｇoǰabpea͚5X,㏣'|2Ν QQQ˗/\ ї/_k"%%>5lڴǿX{BW- IjOMv&H(4(~]Ӡy "cu'qd2B!.Gܰ^x *1iW~ ڀm6yw}a|y^ru;w믿JyweYL86M[o;wŋpmCHAݍ{@ôip"W Xp5!G|4ѧGOB@@Cwt@R@($QH"REBd!Hq WZi@uײs%!Ж'-[`Ϟ= wj뮻B(Œ3pUWnƲ2< >ov܉ >wy'f̘!W/sC4.\}*~Y=c9v-wcY#q&Vj=>DT/ )zYdQ͎JY}((: #ȩW`/qOz  IDAT@׎Ζ p`佀h4hzqW\7tP={'1訡pLGAGG^x, Պŋ ZK߈M# 3g'R76F1nU<'D!A/JEQp8Xmbz/53F~xeΑ"4B4"z8 ouҏ?Ğ={0gg̘˗ 9/Æ _ܹs1h [N,Y"tY~ZjJJJywx[KdCAmB&9%A"o|| ߗ(n\ ,I{PapE0j^^jd`t)  ? A[t2R\yZ%;~pg%cs|۷ӦM33˖-äIޫ>73|MTVV⮻mo OǬY !RX'Z|=m!%pb7 g(*!0yɶ6֔g=ХCQ0n+a3WjUuBPP@Rٍmڎ v&u#[ZZ4nkkkqYgaʕ,--J 磏>޽{qZyfX6lySSS1sLDQR81rH̙3 /Rµ^=:=^Bp1xpխ]Vt 3zU. I! JN:U5; za.5Æ7[[[ڪPaZV\~Xx322#{Qt/\հZXbf̘/B|W/Y)))o^];,cÕ?M@f\w*dRhVHV ¨ZuCMYSOb&F+ѡ3OY{Eb*Z>+j"_+;GNL\3\LwttS[bAqqEKK/ X,<x֞<#rɓ'{V‚ z+!=/%EPA'˾qg.zŚ[ow߭k#}]aƫ7"''7x[w9眃ݻw㧺V}6IA GV&O568TxٚS@S{QttG@UO@ 4Gj& F?vGŰ,$ÇFbsân/>|L\&@K ggg#++K=eѧOS s!CeYs=kƍxyxOʅ՝kJ%L ǿy&uH_CŖ(ìj-p2ohkGTO]^Qe+6e/Ýxn5kGGaH밆47]7chhhtU9jc|చ8%ˌ-V, cCJz`icZUy*5yU ~Db 󲜴1Hkg~5CSX !^,_1Np2[ 9}pƪ`c tusз 1TVVj_dgg#;vݘ1cn݊EizF{ĉpBaʔ)+n랇_23F3Ir%yZ61m b,'@?яTxøb{ǮCؽO6 gKn8{6Aod5;+军L9KJJp7ud =]9JKK3YMVl޶O i AZ`RlJIX _4yX>`2lFhV4!gEhBkTsTE"Q|y ZVn^?tx>S'a C=>.rSw55!tG_s=>ϒw &3jzZj=-#6h./`/QBn˾o=*,q"hL\'#WJW-Ѐ.U k7njr)MDK.Ř1cfTUU,Ih4bzJjQ}sY?W_ BKGG2lFz#fj,Q@Y ;W^؊fjKen[~qz4y3OĒ=eF8pj=ZP i&L>]tяfxRhqQNO k64 qQD# ^QUmpd،֍=j} RH?Ѽq?_}gYO?[#b@~񲾃22'C ٵm6q0a0`CY\~Xxzjx㍘6mZby%R]6I؈3E?C;tFV\ڮ(j(`Kݑ˰P=sFdsD~#u24ɓjVDzpsXB;^@;:ː[2/6*? ŅgI8S45nvsdH+P^%1\C)c=zݦVY{897yHKEZ i.trbWMP e  # C{]hi@M}3*ԣ=>_kΗZHߩ#D7Rk1JudlD)v{dbU{3Lʽ!·R1$!yh m]=P{U."+(}/C?Qܸ$vq'1p/FcİA ˁ 6vg'ڂ0 \.\N3.X HpPm]<Ҁc}ز} \4[ #٬8vnB\pT'C`u9Te$fM5!?H]n2 +)߈(j;Lz#;$ZNS&ő؝7-5߁E} 4X@5bK`jp' t_Q cYS0dP?s$+aW=FȤlQy @s{|8 ? XXHm\7cGؑCqC8ۋTY/~EaOYw0MD0pI+kջب=@0 êRn'Xq }DSK;^}k +uo4<="!/Zjv d Gc/" "ysulR^tj>) BƆ KŋpH!ƣ7YK.8**h$=M `R? Ww`jD Ǵ\0ƍ.^3gLP݂DB][ r;KS5 tkWꆄ A dܛ8- Am]CO$6g'_#W`l֪f86;yB*S4V~o8&@=}#-ls֕o[[ S|ta(--{**]E {/?  m oFx6!в_(6a!˓I=S1}^HM'R=-ᇪQkt*u>,=UA TEiWY ˂J$D,&QLkc!|x;tYb MdS']]Xt) x^(;׭>~ ~&zX^xV[aO5ѕN4h$I4_-7~ӊ e%Њ{jBuu'*uߵ!? x-X@uر0./9|p S/O)-V; MeT O"zsp9ؽ{7ࢋ.:f?FbʗݿFA^X,H%0"tm3:F 4 " ۊIKo! WUbwA0?( Sͺ"6 ?Q[u1yyY5,I<(`9W0&ʆ|\ i!Ƿ8)ؼmZZ;zeBa̘6a >n?"1PH*QVQ*_7uҐW㩇 EBtB`#^l;!aOȅU f$c)BU$5; ?jj&~zXvI_xX(hp,2Ӭ(s-W C\A0AɐIⱄAǛ@q4&FnNV]mGL@jV1v b4} =Yy9Ypߝ7S˄߲ }xkAc!rʏHE$BO$Zr6cz¦sTq%y/ J{Ok|eGX)rhP O.I ?>J"nM;OGN=e3Oqf iF$]eb_>[ջ@߼ij=驢2~޺\:F{bH, -J.uv>1'jVTq^V6Zz&ӡ0R"cOU<XVC5` uG{%7Zo r|IYZBT:?ƍ9W?AYyD,) b 4] tʮ0ur Gcw`Ѐ"|xO4Ўk!I0J@;-'1,Ƅn3鱉Ԕ]@IҤKitAG i cͶfo*5Kܓ`- ttw5ULY\6,.m"eb_>trJ?^-_Ŕ#${<@rb(X\ %@ YuVԅZ0Hy T(RxF?SxP^~UDs_Y&fo7g"yzeQ: )6@D$@ r9C׶05uM8Xv@k['3Ԭb7b D_foהi?7]7Xܵp:{<YTJ L@-"LnddJ^3r>blѮ0HOsvG:'bщՔ&xaGm&0 IXz(Kj c R} ݆"8ݙ[6b΃0a0-ᮍa`;V@4+Tg!sdy `Xi ho>tTP^ cQipd !V ~4tq#!Oh,"^%إRߟTjPRd5SO<:ɇagU}zx%à,Oq ,B$yM9^  Wx™b"n'# Evס`x 'D}C W8`t}jF6F֧?Oi<X/W_> &\6LX-Y4삧a;B ސ#?2NO)k$*"¦ر / \>ƌ>B&"]Mי@5\b~4}=1١n߀h@Fe-z*l?ة'/+RmT'a60idFyb !@,AׁRX݆GW:& H4‛3]-ef!@9\TC8\U_Lg\6L]u:MqF IDAT^jr J bs!t Ş&|Nzo֬ߎ% wDk3rz?R\ ҭ{&?f{WcO9`%rl+\Yج `*DcG!cYL4RIRt4 ]cư`#sa[KDC]qdzYipeGϿ;y Mb1 8T<cp3z79KfI9qV@P 1̢);>ۯ٩j~pvij-x(z G] })Ѫ.B崠%})HnF ]m5HMυ/&Pu=&OV< ŕOa"v!d]{^-Gq~Z!'!=,6$ Ͻ1}5۴ZQ C ao=(Rps%ԩǴAO^S>v5Ԅ?&{Yzt~o} ͣy^;5 *PɃR "FB MI)Te8L=e=fXf8ɂt7I҂,MpgbsHAӀ86->,VrLGF߱;2 Gǫq` k׾r\yBV06P^&j 4>MB¯~5T E$ 'l57Q?OBGؿ} `0բy?>8DrZRt4WXY A ]K/<h˪kfU~Eyw3 oGpH]M y!݈mj NYQPzlJUW ]ޤ`l>yaM)y>޼J-'j*DWS{ԇr/5x{VQv> 1h ,D(@Ŵ䘮|p`OqPsӁSʹ ?laba:ct`QX,B5`wG:6!mF,=I9%?aNTNjo.m}Gv.& L@JaLҘŷ}RP&/bh}P D!KPQh5~=|nQ=0Ii>ӵlf % 0RA煌$B #ste x!"O54mhhjEW^1C8vP C£MT_]Zw ܙ DZ {{᪺^ƌ?MlV5|PWA>NJ *t> 4!^6S)EJqN'nDCe B!7I*W#~ <>eШ X bN-qE,Rj`ߢ~?1=d , lV`p>zX 2K4;%.qBJOO>WD=*p  3wݵu$E/ m*LYDBGtB 58N+O5 ?Zi?ى m˾n/k$c 5rT}R/UtV8cDi=ݰpi,iffՆZq:kV+Tϟ@3E׷w?>Z: O Mm8ps{0D| QRC<мЫDiXX}wA;}~{M=-x; ׽,'^N*IC*pDLȔ͵ x@cQP6X"= dA;vUYJ?I3`KI@Cs;|3qۙVK['r2PB &ƫ:%DyK 새{j2Π \XڏR]TQ2IHc[wϨrUEbpk \6 "h:# nC3B #6D pn.E  zAiDUı %0x5Xmrxτ"kefb'Oc`I_O< _V]Z[պj >UEWGtzJ+ͰoF <*Uw-k _-1؏0GKFECJ)1jkVQqSBM@hw(PpɜC ,!@mCq~G^ǿ^[x͞92B H" p!/DÂR{z#I0+~H)/[c<`Y|pT7UO ]2jiimlbJ ?̂PVR껳OuͼY_\c-]k'S4-֢:[Y|/ tjҢi\ҡiT':֟Pyj0$/[,`/ P;AF 򝒲Xr2\I7a`(X 16VA2ENĿJK;%&&7FzPt,X~8k͂9v6F4jВ= i)yv^_N_>>(58O`Ŧ&Ԁi>10]K=V0aD&vHH?p5<1VO aybnR2eȆ6G:R\@XTm;{ L4RY{j@q rxk?NEu&{e&iԭ>+znNa/1=4:V{3X<-1 _Q `Y)#2eqB>%WWbؠ zQ'B ې3 1\)XvKJ:jhNj N";O ^؈ &rқ6ij i9R¯~L ScݦZޛ'j4x\ @ E(D,UpďST6DP:1Q$^:v@UMqWHOscڤcKE 6GkN,z1ubSt VnnƳ0sTb9@cnQSkCJRɛ--Q =D-D$PQ&q^j@(QA@,+P->.YNţY*EĔkaD X~ocő4P! V.*_@~5WlG{U ~NúաoxXq؏_ f0bT"RW"SCH7{ 4ዉba2!';h{@4ÑF̛s ֔LD-Q8ݜI"Bi&H#T z)u<#vYw 4+`~J)~T5VDW~M+-Cpχ@ e'aZU6vc#"E#o;?vpahiW|/ Hɹ{&\Noch t֢v0W7igGi<xBu7&})]ޅ')D.qcx#h R*.ѪW=\* n)k=Qv!.>Ǟt5n("}/(*u{5JJMy x?[ 3ʫ}ΰ8!n"@&2BPb?SQ=(-M^bIYd% Y) 蓝_l9&7s/Fa;!O{רqr=*^17~bBIjՋnر&fNH\1@U7dQˏc|Pa bHb/d/@Z+ cv,*.g`I!:ޣz+?r<- oFD2{67 \4<#2KkRe= $)ҁײzADb~ \/~Vk4XbwvVW6lTG%S~M܃+u.A2:(i'C͆t|[D"G5YiYxq)P|w"~8<>3qPO'ѝ' kTzV~ӄ^9Ȱp}?+8{ʻnE# .@{ag!H (-xkz|̞W\rrC"Bc=eS(dU hI6EҩމDW[_ނ=ی&l?D  Ǽ\UX/MDܺ$ @ IzEC]pfjOlV F</[`(M*)óQ7 #NK,"FxEWoj'P=D28ȞxY4KC/AT˚|,Ňp?M=UvQ~ >0@3J/(FN\ A P GeH BlzhA\׳20j lf7>㡯YUSQ'Lp#V׸ 4r3I$0"&TIGOFcB}/9 y_DY;.D=iZFl$)f>(}|)O~ q j < 0_Cq͹()tF:IX%W"b鿙 T66Dr| !{"¤dL8%d uװQs/l=|^$&S#w@SJqH7^p75'PYN ; 201&Vb$`# ~ϲ?Ujs0|).&AVZwWl{X]TPdO(3Wec.A>k//EE)vm1V72((kJCC+)| >y( (қ4B a_#!99oQ3M߲_]yBSͪX(&'>q4 ^XV{_ُ.Gx" ^pOygi|.,`T)0qf*i(Ƭ583A)BDBRwBkOB≬O{ͺ8{<,`]pE>MNT aq؀T̛YD ?F"1z`b|BKjx/!  D"ZB`Fڨ/%4.}, R|4@ɿzc R><:S~Gv" ЉlxY\z"{{P!+9u@ 2IDATZ_d$>BS#r>?8hFޅT/t^<3;?c7_Uo6pOǴÆX+#Պ?\9%n DkP/'fDng l4&ޞB u=$lb9#5aہN~ԵeMُAh~&f=#8(3ӿ6kgS\Dҕ0W+imw_~2U>eeob0sNg:NWXQ BK/&(>A%Ĥ.QYZllKW`trtzgk;C[J{N'|翝Oj/o -~2EN2C_nq:6ʆ%5_ki[^c7ݜ:Dڂ\񿕯Qt/ēVfVp9ۍy㐍N =X7[*0b.eY&C?ߋ}xwOCc*vvTOH{ lr^goOM942C|0xdMx\0;90I*􋆁/XP|\[Pbho*vvP5D0;rxN.nj=eԗxBG9H&æFTL@13sA~<5Ů۳eB4Z΃_AݡQ^d#5L#.YGĮ9ަ]-8ibnZ)sæ+hf:N?nFX; H$A`B{C@Ƣls;mu5vH#-Vq9d<Ȭb`e@fP.>W=HD shNjqQwPC]LxzUlZm~6{ ɔ%PsԵ!n`&}ƹԨUP_]BkmM^4R1$SS&w~wbIno;$g ̿anN0x#ʭBg$"1D%f!FRh@5 ݁өEkUun4y˪z,'4OEɲݤiK@$o8BW_0CCĈ',IdҺS?>baD`$У"7uDiBqéQWUBmJAנEϠ)u]N QLpaVw64/hь\\n1]&n&M309X( 5ggXqէ C8<ڀϭtsk@FWϿ$D5\.Cwa&n 4af]v)C$f4sg3iX3uǻ֗TSpx.řۯi^k: %tA耎+!oTS#^y oB$xLM/ţ1l{u9'poMϯo)bx-Kt@לAa̾*@ R: %4(`v3M~M@)2>5u4eSK?l&her^:76ps(t ['9`d Hv4t]Ör&7]\\wl}Kcs,OtGo'jGbHr{|dxKS]i$Jnz1R'pqoնX22gEvQ2F/p2MBQK"D?ԜƑ߅6D / uBd_B& '!U<8(pq}><8A~Ҏ&B8dPX+&OBёCkq{%rv4 b1 9Ll$F %73ׅB?y>r)A"-!;An]IkҪwZ>RrfL-[治E^NqBv:DL7Z62z )-9$(ޯm#hֈMwsL+PtLnZ<`1 2b(BJ+Bq,P2>敢6zYEN;b3dzx{Xx5N.;5m<{jOgn7,>DijNPq٠;M5q赣'@WMb+.n{8dppF (i{eBI%mCF//l}; ^Se% CHxwt&.9+%:GT}M~RԽ^"oUڞ>B2uI %c,Dxߪnf冦t JVHݺYejt,HszqBaIƊ'nh`vnSrBIrw3YyDzU)¤|(*Q pFf֢l:i0hp!^Xg(E87V*~m[yp$ jbEES3p3[ } ɴI$0 [,NvmeMm8vf_)FܸCˀ;&&M2zDAN8|j6/:PG,p4bqLO&5#tt[Mg;;ʺunwQW@-mH{y1`DO& IENDB`caronc-apprise-dfec414/apprise/assets/themes/default/apprise-warning-72x72.png000066400000000000000000000173511526720371000274070ustar00rootroot00000000000000PNG  IHDRHHUG pHYs  IDATxy|ՕV*X%˲UB8!l&!K0 yla%1m,Hd[t%&yO]]uO9{n!N E@<@H ҁ`4Cl|G@lV;gU'_6CJ(.R`L$6' S=ohV/ۯ|X NeY5A*K * PV0 hhR`D ޕPg$MLwˀdꁫ ?3:LmEʲAq( "28x8[za7k@G%uOvt 91Z8I## QRc ZM-ule+wynnGxa` SEg%EhAɿ}.}_Gı^^)ʇL)d*˛-|bkg-"f&AHi4l&\Qn急gB&ݱzCh%u$p },>!?)й=i(~BJ 4M"́#!d\.e_%Y4wHlL,%c^FF]h>OJ4M =%]M 8 yͷ ,~kQ˺vDٱ'u;T < ̞Te猠,O4..i&5&q:0m3 zhW>Di1R]L&4Wݹ?owN8hHX0YOY$`D#-t.5t@ @YnHvc j@[ e&&nB)ÍvTso8?Z | 4z 8e|+#(- ӥm9z,Hk]5ifʦc@ H=d7r҇V[=X<JVrq,>x&$ٱtl( Xoi忕|KIIIH!t YIai:HM% TM#P\Ox8I6yQK=?^wcoAVϽ+og9_A B[Q~)"4k0'h?KhVtR"4+Ҥ IB+JlϾ.71f(db(#W̠5<;d  Vq+Uf-:ݲhfIAjAtC)'`'b640>Oאv+R[insqupT~r+<+|e3T3 &BC ;ҶݤRHI[XH_ѝquՌkc=$.@LaF6Lo+A ?)…_;;w'LўV4dHc`:liA)rρ 3)MZ [9<#mqI¼?iㅗVM$RzpŃHGJ!_XCa\ $\>p$"L#F6NX'tuh݂Rs~2(3ɣ"Xxu`<AEi*lKѤD: I\p4)4=ɚ!\?Q\{si>w}mT2m$@M#0z,Y.zc-+Wof=CaXnL!% M:!sgMd20=( l>L&|_h]NWfVZ˵pNJ\ nu$ ?2{#Ā<|Y$P2#~om珯撫nǖ+&T5o&W flؼv(L^@Z[6ٓ P), qY.[VdّMJʃ.{;zyk#:ZTJN9igD.<~7d-[OCNt>#YMIQaϟ8T^T׭VxkC;,h 0`~**RU$TR J#`WATXOA$x~<~% o&KFWLfư(sނ"^yNƓ1 Pd@TS)`-Kc#8/:s:m +:CŠ5ᩩ(˥BSH* 'B!^(ƪxu > /o_|۷sxWزm0PL#Ɛ&n1Gp0?'@)WP&k  PRs)/;X|#*UWHI?_IGa@ dKB#J4_L/iAKO;ŋihh/v/T`D |L.o `e ^}sm%%(Hǧ}e^P(ejn*Q)f&BxhBJuy߹RQ JJ r0DN.V)!-NSin~u?s˔)Sۉ\Տ+aÆY]Q}#T14!z;\YTR )NoJ'&6[nu\"L0$ǧ!py5sM^8Gj Q+lܒ_,O2ōXarϚ538M\jW; GH`~5ΝI`첀?itL/f&FXg" +2: 5AI/ȕB ~' {B!I*sMzsshժUi瞱TL3rT"m(p `@0[~3}N# ~zzցǏGR-[m6.]SYYUW]N~2@ јf]ͮquRHf6U~ǖRS]!kF`$C+C޿xAT}x`˞³Jȷ@󅨨CE\\;,pDyy4O?4vr⋙9skEO< M(W]8Z"&X6qʘ?ؾUJefI_B Ώ  *vơ}d@drT^Kj5cmz/54gʹi7n3f[3gK,G/??G,Y喣L/?2m;s0Rns$)U,\tYQ| 3tZ6o˽>[ lƍ%C/r':#p7OdhS/Τ# ԓX1n#KZXzB/H T㭤 AaiͭLO^c/ޕUw%\wL׻)P0~8n_] 7 jf|J:5ltOf6-"GrKIO? asQi=0'ʼUVq=pe1o<\}դR|>.F @O=]HBil0 ‘%ܶÎd E*m#fư󨟰O"NpڂyÇϋ`{졼yq饗rwjSz477ۅh.R/W|-X&-ߊ:jS41W/=k3&T5{yX*>lr $=mNIc'PXʶ}$ͷ׳vVΟNw[#Uf3O[?B3<ã>J&! RT2J-Pa:x$ uXJ7էaM[YeMw8jzJΞ4]JnYʬ2r6/ŏh! gL9S>y$)lMTLe7:H Gl5[ \{Յ$7Mtq/I]l T.+o]~ߝk] %2dh}r<s)@W|4irfN٧/ ǓO&֊I]`HyeJ7L.nrIH_{%ley|bY٧Cs3Hx:;ԑ`Tw0jX޻9:tu|4 8uUv |k'1Rj$g?75?,NQ8f6f<ܣO*ﵵmn0դ4%ڛTt2FMEA}¡/o}PTG&|W w[D!?d~s?OBE}+U'9TI+c@prXʳ:7F?waph_ƲQuEEhRP0Q*}dd}-'L kgpdgs_⤅3gəӨwb$ j*jNl%״<}9 0MFyuI*^J|Χwy[N`nT#Kti3a4M<C)-DK{}+O\y|˳C WS48Vƭߧ=EњyV&+QnKsM?d@kL?Ҷ+FQIa 3%5vm!Ճi8wΩ'et5h*TMk7=KE3vdF:W5V[̳B }Y)\ζ6vw4_NʒBu5VRt'LD0 @O0̬iPv=͈tPjqI3d2YwœN݇;Il59̼GxV" _?!{F<{;} i7ʲ (ati1ww񯿸h!4ٟj0m dfc\X`Yڎ==\Nk Ts3YUJLAI 4$bmz1ӽV'%R\*}o;: *Hu"[%K 0=g9 [x,ϱQ'_ q{nmKʚ Uv n{yŒ&QF/'dkx`,Ca@q7rslPjBvgENfoU#gy!˹.笓Ǔj[Eq [6AےQ"Ur$kWߵۨg[? S fjG1i Y[d. @*T`0miDon'Vڊ.l`x˅ fdDa|~[-q"'P8 8Թ9u{IBP0%յjfr:X@]Њ<(_ \,D \I`oLvEV薋9V$(#NlC$Y兑e9b΀:W2t%R4q<ը:q'Ixt 76%ë. r@ai_yLJ1ίȹʿ*~Vpc;Yjm2ѿu0HXcb?aCy(t\sU>bGcnzh>{w܇}ZV 4J }zw qK-mI{yb û+I}ǹ^,䙕Xv<[Yބ׷[W{kd> ڼ033s|)GEQS@AHws(U0M0LP& 5[~GKD7cd&Y߁ d`R01xP҈O&Ag4)qcsge;PlOu3^X/g5 # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Used for testing from ..manager_attachment import AttachmentManager from .base import AttachBase # Initalize our Attachment Manager Singleton A_MGR = AttachmentManager() __all__ = [ # Reference "AttachBase", "AttachmentManager", ] caronc-apprise-dfec414/apprise/attachment/base.py000066400000000000000000000412241526720371000222010ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. import base64 import contextlib import mimetypes import os import time from .. import exception from ..common import ContentLocation from ..exception import AppriseImproperlyConfigured from ..locale import gettext_lazy as _ from ..url import URLBase from ..utils.parse import parse_bool class AttachBase(URLBase): """This is the base class for all supported attachment types.""" # For attachment type detection; this amount of data is read into memory # 128KB (131072B) max_detect_buffer_size = 131072 # Unknown mimetype unknown_mimetype = "application/octet-stream" # Our filename when we can't otherwise determine one unknown_filename = "apprise-attachment" # Our filename extension when we can't otherwise determine one unknown_filename_extension = ".obj" # The strict argument is a flag specifying whether the list of known MIME # types is limited to only the official types registered with IANA. When # strict is True, only the IANA types are supported; when strict is False # (the default), some additional non-standard but commonly used MIME types # are also recognized. strict = False # The maximum file-size we will accept for an attachment size. If this is # set to zero (0), then no check is performed # 1 MB = 1048576 bytes # 5 MB = 5242880 bytes # 1 GB = 1048576000 bytes max_file_size = 1048576000 # By default all attachments types are inaccessible. # Developers of items identified in the attachment plugin directory # are requried to set a location location = ContentLocation.INACCESSIBLE # Here is where we define all of the arguments we accept on the url # such as: schema://whatever/?overflow=upstream&format=text # These act the same way as tokens except they are optional and/or # have default values set if mandatory. This rule must be followed template_args = { "cache": { "name": _("Cache Age"), "type": "int", # We default to (600) which means we cache for 10 minutes "default": 600, }, "mime": { "name": _("Forced Mime Type"), "type": "string", }, "name": { "name": _("Forced File Name"), "type": "string", }, "verify": { "name": _("Verify SSL"), # SSL Certificate Authority Verification "type": "bool", # Provide a default "default": True, }, } def __init__(self, name=None, mimetype=None, cache=None, **kwargs): """Initialize some general logging and common server arguments that will keep things consistent when working with the configurations that inherit this class. Optionally provide a filename to over-ride name associated with the actual file retrieved (from where-ever). The mime-type is automatically detected, but you can over-ride this by explicitly stating what it should be. By default we cache our responses so that subsiquent calls does not cause the content to be retrieved again. For local file references this makes no difference at all. But for remote content, this does mean more then one call can be made to retrieve the (same) data. This method can be somewhat inefficient if disabled. Only disable caching if you understand the consequences. You can alternatively set the cache value to an int identifying the number of seconds the previously retrieved can exist for before it should be considered expired. """ super().__init__(**kwargs) if not mimetypes.inited: # Ensure mimetypes has been initialized mimetypes.init() # Attach Filename (does not have to be the same as path) self._name = name # The mime type of the attached content. This is detected if not # otherwise specified. self._mimetype = mimetype # The detected_mimetype, this is only used as a fallback if the # mimetype wasn't forced by the user self.detected_mimetype = None # The detected filename by calling child class. A detected filename # is always used if no force naming was specified. self.detected_name = None # Absolute path to attachment self.download_path = None # Track open file pointers self.__pointers = set() # Set our cache flag; it can be True, False, None, or a (positive) # integer... nothing else if cache is not None: try: self.cache = cache if isinstance(cache, bool) else int(cache) except (TypeError, ValueError): err = f"An invalid cache value ({cache}) was specified." self.logger.warning(err) raise AppriseImproperlyConfigured(err) from None # Some simple error checking if self.cache < 0: err = f"A negative cache value ({cache}) was specified." self.logger.warning(err) raise AppriseImproperlyConfigured(err) else: self.cache = None # Validate mimetype if specified if self._mimetype and ( next( ( t for t in mimetypes.types_map.values() if self._mimetype == t ), None, ) is None ): err = f"An invalid mime-type ({mimetype}) was specified." self.logger.warning(err) raise AppriseImproperlyConfigured(err) return @property def path(self): """Returns the absolute path to the filename. If this is not known or is know but has been considered expired (due to cache setting), then content is re-retrieved prior to returning. """ if not self.exists(): # we could not obtain our path return None return self.download_path @property def name(self): """Returns the filename.""" if self._name: # return our fixed content return self._name if not self.exists(): # we could not obtain our name return None if not self.detected_name: # If we get here, our download was successful but we don't have a # filename based on our content. ext = mimetypes.guess_extension(self.mimetype) self.detected_name = ( f"{self.unknown_filename}" f"{ext if ext else self.unknown_filename_extension}" ) return self.detected_name @property def mimetype(self): """Returns mime type (if one is present). Content is cached once determied to prevent overhead of future calls. """ if not self.exists(): # we could not obtain our attachment return None if self._mimetype: # return our pre-calculated cached content return self._mimetype if not self.detected_mimetype: # guess_type() returns: (type, encoding) and sets type to None # if it can't otherwise determine it. with contextlib.suppress(TypeError): # Directly reference _name and detected_name to prevent # recursion loop (as self.name calls this function) self.detected_mimetype, _ = mimetypes.guess_type( self._name if self._name else self.detected_name, strict=self.strict, ) # Return our mime type return ( self.detected_mimetype if self.detected_mimetype else self.unknown_mimetype ) def exists(self, retrieve_if_missing=True): """Simply returns true if the object has downloaded and stored the attachment AND the attachment has not expired.""" if self.location == ContentLocation.INACCESSIBLE: # our content is inaccessible return False cache = ( self.template_args["cache"]["default"] if self.cache is None else self.cache ) try: if ( self.download_path and os.path.isfile(self.download_path) and cache ): # We have enough reason to look further into our cached content # and verify it has not expired. if cache is True: # return our fixed content as is; we will always cache it return True # Verify our cache time to determine whether we will get our # content again. age_in_sec = time.time() - os.stat(self.download_path).st_mtime if age_in_sec <= cache: return True except OSError: # The file is not present pass return False if not retrieve_if_missing else self.download() def base64(self, encoding="ascii"): """Returns the attachment object as a base64 string otherwise None is returned if an error occurs. If encoding is set to None, then it is not encoded when returned """ if not self: # We could not access the attachment self.logger.error( f"Could not access attachment {self.url(privacy=True)}." ) raise exception.AppriseFileNotFound("Attachment Missing") try: with self.open() as f: # Prepare our Attachment in Base64 return ( base64.b64encode(f.read()).decode(encoding) if encoding else base64.b64encode(f.read()) ) except FileNotFoundError: # We no longer have a path to open raise exception.AppriseFileNotFound("Attachment Missing") from None except (TypeError, OSError) as e: self.logger.warning( "An I/O error occurred while reading {}.".format( self.name if self else "attachment" ) ) self.logger.debug(f"I/O Exception: {e!s}") raise exception.AppriseDiskIOError( "Attachment Access Error" ) from e def invalidate(self): """Release any temporary data that may be open by child classes. Externally fetched content should be automatically cleaned up when this function is called. This function should also reset the following entries to None: - detected_name : Should identify a human readable filename - download_path: Must contain a absolute path to content - detected_mimetype: Should identify mimetype of content """ # Close every tracked pointer without letting cleanup errors escape # from invalidate() or __del__(). while self.__pointers: with contextlib.suppress(OSError): self.__pointers.pop().close() self.detected_name = None self.download_path = None self.detected_mimetype = None return def download(self): """This function must be over-ridden by inheriting classes. Inherited classes MUST populate: - detected_name: Should identify a human readable filename - download_path: Must contain a absolute path to content - detected_mimetype: Should identify mimetype of content If a download fails, you should ensure these values are set to None. """ raise NotImplementedError( "download() is implimented by the child class." ) def open(self, mode="rb"): """Return our file pointer and track it (we'll auto close later)""" pointer = open(self.path, mode=mode) # noqa: SIM115 self.__pointers.add(pointer) return pointer def chunk(self, size=5242880): """A Generator that yield chunks of a file with the specified size. By default the chunk size is set to 5MB (5242880 bytes) """ with self.open() as file: while True: chunk = file.read(size) if not chunk: break yield chunk def __enter__(self): """Support with keyword.""" return self.open() def __exit__(self, value_type, value, traceback): """Stub to do nothing; but support exit of with statement gracefully.""" return @staticmethod def parse_url(url, verify_host=True, mimetype_db=None, sanitize=True): """Parses the URL and returns it broken apart into a dictionary. This is very specific and customized for Apprise. Args: url (str): The URL you want to fully parse. verify_host (:obj:`bool`, optional): a flag kept with the parsed URL which some child classes will later use to verify SSL keys (if SSL transactions take place). Unless under very specific circumstances, it is strongly recomended that you leave this default value set to True. Returns: A dictionary is returned containing the URL fully parsed if successful, otherwise None is returned. """ results = URLBase.parse_url( url, verify_host=verify_host, sanitize=sanitize ) if not results: # We're done; we failed to parse our url return results # Allow overriding the default config mime type if "mime" in results["qsd"]: results["mimetype"] = ( results["qsd"].get("mime", "").strip().lower() ) # Allow overriding the default file name if "name" in results["qsd"]: # Strip any directory components to prevent path traversal # (e.g. ?name=/etc/passwd yields "passwd"). If the result is # empty after stripping, treat it as though ?name= was not # specified so the caller falls through to the next name source. _fname = os.path.basename(results["qsd"].get("name", "")).strip() if _fname: results["name"] = _fname # Our cache value if "cache" in results["qsd"]: # First try to get it's integer value try: results["cache"] = int(results["qsd"]["cache"]) except (ValueError, TypeError): # No problem, it just isn't an integer; now treat it as a bool # instead: results["cache"] = parse_bool(results["qsd"]["cache"]) return results def __len__(self): """Returns the filesize of the attachment.""" if not self: return 0 try: return os.path.getsize(self.path) if self.path else 0 except OSError: # OSError can occur if the file is inaccessible return 0 def __bool__(self): """Allows the Apprise object to be wrapped in an based 'if statement'. True is returned if our content was downloaded correctly. """ return bool(self.path) def __del__(self): """Perform any house cleaning.""" self.invalidate() caronc-apprise-dfec414/apprise/attachment/file.py000066400000000000000000000115301526720371000222030ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. import os import re from ..common import ContentLocation from ..locale import gettext_lazy as _ from ..utils.disk import path_decode from .base import AttachBase class AttachFile(AttachBase): """A wrapper for File based attachment sources.""" # The default descriptive name associated with the service service_name = _("Local File") # The default protocol protocol = "file" # Content is local to the same location as the apprise instance # being called (server-side) location = ContentLocation.LOCAL def __init__(self, path, **kwargs): """Initialize Local File Attachment Object.""" super().__init__(**kwargs) # Store path but mark it dirty since we have not performed any # verification at this point. self.dirty_path = path_decode(path) # Track our file as it was saved self.__original_path = os.path.normpath(path) return def url(self, privacy=False, *args, **kwargs): """Returns the URL built dynamically based on specified arguments.""" # Define any URL parameters params = {} if self._mimetype: # A mime-type was enforced params["mime"] = self._mimetype if self._name: # A name was enforced params["name"] = self._name return "file://{path}{params}".format( path=self.quote(self.__original_path), params=( "?{}".format(self.urlencode(params, safe="/")) if params else "" ), ) def download(self, **kwargs): """Perform retrieval of our data. For file base attachments, our data already exists, so we only need to validate it. """ if self.location == ContentLocation.INACCESSIBLE: # our content is inaccessible return False # Ensure any existing content set has been invalidated self.invalidate() try: if not os.path.isfile(self.dirty_path): return False except OSError: return False if ( self.max_file_size > 0 and os.path.getsize(self.dirty_path) > self.max_file_size ): # The content to attach is to large self.logger.error( "Content exceeds allowable maximum file length" f" ({int(self.max_file_size / 1024)}KB):" f" {self.url(privacy=True)}" ) # Return False (signifying a failure) return False # We're good to go if we get here. Set our minimum requirements of # a call do download() before returning a success self.download_path = self.dirty_path self.detected_name = os.path.basename(self.download_path) # We don't need to set our self.detected_mimetype as it can be # pulled at the time it's needed based on the detected_name return True @staticmethod def parse_url(url): """Parses the URL so that we can handle all different file paths and return it as our path object.""" results = AttachBase.parse_url(url, verify_host=False) if not results: # We're done early; it's not a good URL return results match = re.match(r"file://(?P[^?]+)(\?.*)?", url, re.I) if not match: return None results["path"] = AttachFile.unquote(match.group("path")) return results caronc-apprise-dfec414/apprise/attachment/http.py000066400000000000000000000350401526720371000222450ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from __future__ import annotations import contextlib import os import re from tempfile import NamedTemporaryFile import threading from typing import Any, Optional import requests from ..common import ContentLocation from ..locale import gettext_lazy as _ from ..url import PrivacyMode from ..utils.parse import URL_ENCODED_PATH_SAFE_CHARS from .base import AttachBase class AttachHTTP(AttachBase): """A wrapper for HTTP based attachment sources.""" # The default descriptive name associated with the service service_name = _("Web Based") # The default protocol protocol = "http" # The default secure protocol secure_protocol = "https" # The number of bytes in memory to read from the remote source at a time chunk_size = 8192 # Web based requests are remote/external to our current location location = ContentLocation.HOSTED # thread safe loading _lock = threading.Lock() def __init__( self, headers: Optional[dict[str, str]] = None, http_session: Optional[requests.Session] = None, download_dir: Optional[str] = None, **kwargs: Any, ) -> None: """Initialize an HTTP attachment. ``headers`` adds request headers. ``download_dir`` selects the temporary-file directory and defaults to the system location. """ super().__init__(**kwargs) self.schema = "https" if self.secure else "http" self.fullpath = kwargs.get("fullpath") if not isinstance(self.fullpath, str): self.fullpath = "/" self.headers = {} if headers: # Store our extra headers self.headers.update(headers) # Applications may provide a policy-aware Requests session. self.http_session = http_session # Applications may store downloads outside the system temp directory. self.download_dir = download_dir # Where our content is written to upon a call to download. self._temp_file = None # Preserve storage failures for callers that need a detailed error. self.download_error = None # Our Query String Dictionary; we use this to track arguments # specified that aren't otherwise part of this class self.qsd = { k: v for k, v in kwargs.get("qsd", {}).items() if k not in self.template_args } return def download(self, **kwargs: Any) -> bool: """Perform retrieval of the configuration based on the specified request.""" self.download_error = None if self.location == ContentLocation.INACCESSIBLE: # our content is inaccessible return False # prepare header headers = { "User-Agent": self.app_id, } # Apply any/all header over-rides defined headers.update(self.headers) auth = None if self.user: auth = (self.user, self.password) url = f"{self.schema}://{self.host}" if isinstance(self.port, int): url += f":{self.port}" url += self.fullpath # Where our request object will temporarily live. r = None # Always call throttle before any remote server i/o is made self.throttle() with self._lock: if self.exists(retrieve_if_missing=False): # Due to locking; it's possible a concurrent thread already # handled the retrieval in which case we can safely move on self.logger.trace( "HTTP Attachment %s already retrieved", self._temp_file.name, ) return True # Ensure any existing content set has been invalidated self.invalidate() self.logger.debug( "HTTP Attachment Fetch URL:" f" {url} (cert_verify={self.verify_certificate!r})" ) try: # Use the caller's transport when it needs destination policy. http_get = ( self.http_session.get if self.http_session is not None else requests.get ) with http_get( url, headers=headers, auth=auth, params=self.qsd, verify=self.verify_certificate, timeout=self.request_timeout, allow_redirects=self.redirects, stream=True, ) as r: # Handle Errors r.raise_for_status() # Reject every 3xx response when redirects are disabled, # including responses without a Location header. if not self.redirects and 300 <= r.status_code < 400: self.logger.error( "HTTP redirect encountered but redirect " "following is disabled:" f" {self.url(privacy=True)}" ) return False # Get our file-size (if known) try: file_size = int(r.headers.get("Content-Length", "0")) except (TypeError, ValueError): # Handle edge case where Content-Length is a bad value file_size = 0 # Perform a little Q/A on file limitations and restrictions if ( self.max_file_size > 0 and file_size > self.max_file_size ): # The content is too large. self.logger.error( "HTTP response exceeds allowable maximum file" f" length ({int(self.max_file_size / 1024)}KB):" f" {self.url(privacy=True)}" ) # Return False (signifying a failure) return False # Detect config format based on mime if the format isn't # already enforced self.detected_mimetype = r.headers.get("Content-Type") d = r.headers.get("Content-Disposition", "") result = re.search( r"filename=['\"]?(?P[^'\"]+)['\"]?", d, re.I ) if result: self.detected_name = result.group("name").strip() # Keep the file on Windows; __del__ cleans it up. self._temp_file = NamedTemporaryFile( # noqa: SIM115 delete=False, dir=self.download_dir, ) # Get our chunk size chunk_size = self.chunk_size # Track all bytes written to disk bytes_written = 0 # If we get here, we can now safely write our content to # disk for chunk in r.iter_content(chunk_size=chunk_size): # filter out keep-alive chunks if chunk: # Enforce the limit while streaming because the # server may omit or misreport Content-Length. if ( self.max_file_size > 0 and bytes_written + len(chunk) > self.max_file_size ): # The downloaded content is too large. self.logger.error( "HTTP response exceeds allowable" " maximum file length" f" ({int(self.max_file_size / 1024)}" f"KB): {self.url(privacy=True)}" ) # Invalidate any variables previously set self.invalidate() # Return False (signifying a failure) return False self._temp_file.write(chunk) bytes_written = self._temp_file.tell() # Ensure our content is flushed to disk for post-processing self._temp_file.flush() # Set our minimum requirements for a successful download() # call self.download_path = self._temp_file.name if not self.detected_name: self.detected_name = os.path.basename(self.fullpath) except requests.RequestException as e: self.logger.error( "A Connection error occurred retrieving HTTP " f"configuration from {self.host}." ) self.logger.debug(f"Socket Exception: {e!s}") # Invalidate any variables previously set self.invalidate() # Return False (signifying a failure) return False except OSError as e: # IOError remains for compatibility; modern Python raises # OSError here. self.download_error = e # Could not open and/or write the temporary file self.logger.error( "Could not write attachment to disk:" f" {self.url(privacy=True)}" ) # Invalidate any variables previously set self.invalidate() # Return False (signifying a failure) return False # Return our success return True def invalidate(self): """Close our temporary file.""" if self._temp_file: self.logger.trace("Attachment cleanup of %s", self._temp_file.name) # Do not let temporary-file cleanup errors escape from __del__(). with contextlib.suppress(OSError): self._temp_file.close() with contextlib.suppress(OSError): # Ensure our file is removed (if it exists) os.unlink(self._temp_file.name) # Reset our temporary file to prevent from entering # this block again self._temp_file = None super().invalidate() def __del__(self): """Tidy memory if open.""" self.invalidate() def url(self, privacy=False, *args, **kwargs): """Returns the URL built dynamically based on specified arguments.""" # Our URL parameters params = self.url_parameters(privacy=privacy, *args, **kwargs) # Prepare our cache value if self.cache is not None: if isinstance(self.cache, bool) or not self.cache: cache = "yes" if self.cache else "no" else: cache = int(self.cache) # Set our cache value params["cache"] = cache if self._mimetype: # A format was enforced params["mime"] = self._mimetype if self._name: # A name was enforced params["name"] = self._name # Append our headers into our parameters params.update({f"+{k}": v for k, v in self.headers.items()}) # Apply any remaining entries to our URL params.update(self.qsd) # Determine Authentication auth = "" if self.user and self.password: auth = "{user}:{password}@".format( user=self.quote(self.user, safe=""), password=self.pprint( self.password, privacy, mode=PrivacyMode.Secret, safe="" ), ) elif self.user: auth = "{user}@".format( user=self.quote(self.user, safe=""), ) default_port = 443 if self.secure else 80 return "{schema}://{auth}{hostname}{port}{fullpath}?{params}".format( schema=self.secure_protocol if self.secure else self.protocol, auth=auth, hostname=self.quote(self.host, safe=""), port=( "" if self.port is None or self.port == default_port else f":{self.port}" ), fullpath=self.quote( self.fullpath, safe=URL_ENCODED_PATH_SAFE_CHARS ), params=self.urlencode(params, safe="/"), ) @staticmethod def parse_url(url): """Parses the URL and returns enough arguments that can allow us to re- instantiate this object.""" results = AttachBase.parse_url(url, sanitize=False) if not results: # We're done early as we couldn't load the results return results # Add our headers that the user can potentially over-ride if they wish # to to our returned result set results["headers"] = results["qsd-"] results["headers"].update(results["qsd+"]) return results caronc-apprise-dfec414/apprise/attachment/memory.py000066400000000000000000000157061526720371000226050ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. import base64 import io import os import re from typing import Any import uuid from .. import exception from ..common import ContentLocation from ..exception import AppriseImproperlyConfigured from ..locale import gettext_lazy as _ from .base import AttachBase class AttachMemory(AttachBase): """A wrapper for Memory based attachment sources.""" # The default descriptive name associated with the service service_name = _("Memory") # The default protocol protocol = "memory" # Content is local to the same location as the apprise instance # being called (server-side) location = ContentLocation.LOCAL def __init__( self, content=None, name=None, mimetype=None, encoding="utf-8", **kwargs, ): """Initialize Memory Based Attachment Object.""" # Create our BytesIO object self._data = io.BytesIO() if content is None: # Empty; do nothing pass elif isinstance(content, str): content = content.encode(encoding) if mimetype is None: mimetype = "text/plain" if not name: # Generate a unique filename name = str(uuid.uuid4()) + ".txt" elif not isinstance(content, bytes): raise AppriseImproperlyConfigured( "Provided content for memory attachment is invalid" ) # Store our content if content: self._data.write(content) if mimetype is None: # Default mimetype mimetype = "application/octet-stream" if not name: # Generate a unique filename name = str(uuid.uuid4()) + ".dat" # Initialize our base object super().__init__(name=name, mimetype=mimetype, **kwargs) return def url(self, privacy=False, *args, **kwargs): """Returns the URL built dynamically based on specified arguments.""" # Define any URL parameters params = { "mime": self._mimetype, } return "memory://{name}?{params}".format( name=self.quote(self._name), params=self.urlencode(params, safe="/"), ) def open(self, *args: Any, **kwargs: Any) -> io.BytesIO: """Return an independent handle to our memory object.""" self._data.seek(0, 0) # Return a new handle that callers can safely close. return io.BytesIO(self._data.getvalue()) def __enter__(self): """Support with clause.""" # Return our object self._data.seek(0, 0) return self._data def download(self, **kwargs): """Handle memory download() call.""" if self.location == ContentLocation.INACCESSIBLE: # our content is inaccessible return False if self.max_file_size > 0 and len(self) > self.max_file_size: # The content to attach is to large self.logger.error( "Content exceeds allowable maximum memory size" f" ({int(self.max_file_size / 1024)}KB):" f" {self.url(privacy=True)}" ) # Return False (signifying a failure) return False return True def base64(self, encoding="ascii"): """We need to over-ride this since the base64 sub-library seems to close our file descriptor making it no longer referencable.""" if not self: # We could not access the attachment self.logger.error( f"Could not access attachment {self.url(privacy=True)}." ) raise exception.AppriseFileNotFound("Attachment Missing") self._data.seek(0, 0) return ( base64.b64encode(self._data.read()).decode(encoding) if encoding else base64.b64encode(self._data.read()) ) def invalidate(self): """Removes data.""" if not self._data.closed: self._data.truncate(0) return def exists(self): """Over-ride exists() call.""" size = len(self) return bool( self.location != ContentLocation.INACCESSIBLE and size > 0 and ( self.max_file_size <= 0 or (self.max_file_size > 0 and size <= self.max_file_size) ) ) @staticmethod def parse_url(url): """Parses the URL so that we can handle all different file paths and return it as our path object.""" results = AttachBase.parse_url(url, verify_host=False) if not results: # We're done early; it's not a good URL return results if "name" not in results: # Allow fall-back to be from URL match = re.match(r"memory://(?P[^?]+)(\?.*)?", url, re.I) if match: # Store our filename only (ignore any defined paths) results["name"] = os.path.basename( AttachMemory.unquote(match.group("path")) ) return results @property def path(self): """Return the filename.""" if not self.exists(): # we could not obtain our path return None return self._name def __len__(self): """Returns the size of he memory attachment.""" return self._data.getbuffer().nbytes def __bool__(self): """Allows the Apprise object to be wrapped in an based 'if statement'. True is returned if our content was downloaded correctly. """ return self.exists() caronc-apprise-dfec414/apprise/cli.py000066400000000000000000001507551526720371000177200ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. import contextlib import logging import os from os.path import exists, isfile import platform import re import shutil import sys import textwrap import time import click from . import ( Apprise, AppriseAsset, AppriseConfig, AppriseResultStatus, NotificationManager, NotifyTemplate, PersistentStore, __copyright__, __license__, __title__, __version__, ) from .apprise import ( abandoned_call_descriptions, any_abandoned_calls_still_running, ) from .common import ( NOTIFY_FORMATS, NOTIFY_TYPES, PERSISTENT_STORE_MODES, ContentLocation, NotifyFormat, NotifyType, PersistentStoreMode, PersistentStoreState, ) from .logger import logger from .utils.disk import bytes_to_str, dir_size, path_decode from .utils.parse import GET_SCHEMA_RE, parse_list from .utils.template import TEMPLATE_NAME_RE, normalize_name # By default we allow looking 1 level down recursively in Apprise configuration # files. DEFAULT_RECURSION_DEPTH = 1 # Defines the environment variable to parse if defined. This is ONLY # Referenced if: # - No Configuration Files were found/loaded/specified # - No URLs were provided directly into the CLI Call DEFAULT_ENV_APPRISE_URLS = "APPRISE_URLS" # Defines the override path for the configuration files read DEFAULT_ENV_APPRISE_CONFIG_PATH = "APPRISE_CONFIG_PATH" # Defines the override path for the plugins to load DEFAULT_ENV_APPRISE_PLUGIN_PATH = "APPRISE_PLUGIN_PATH" # Defines the override path for the persistent storage DEFAULT_ENV_APPRISE_STORAGE_PATH = "APPRISE_STORAGE_PATH" # Environment variable controlling the storage retention period DEFAULT_ENV_APPRISE_STORAGE_PRUNE_DAYS = "APPRISE_STORAGE_PRUNE_DAYS" # Environment variable controlling generated storage URL ID length DEFAULT_ENV_APPRISE_STORAGE_UID_LENGTH = "APPRISE_STORAGE_UID_LENGTH" # Environment variables holding a value that is not a valid number, as # (name, value). main() reports them and exits instead of guessing. INVALID_ENV: list[tuple[str, str]] = [] def _env_int(name: str, default: int) -> int: """Return environment variable ``name`` as an int, else ``default``.""" # An unset or empty variable quietly uses the default value = os.environ.get(name, "").strip() if not value: return default try: return int(value) except ValueError: # Let the module load so main() can explain the problem clearly INVALID_ENV.append((name, value)) return default # Default number of days to prune persistent storage DEFAULT_STORAGE_PRUNE_DAYS = _env_int( DEFAULT_ENV_APPRISE_STORAGE_PRUNE_DAYS, 30 ) # The default URL ID Length DEFAULT_STORAGE_UID_LENGTH = _env_int( DEFAULT_ENV_APPRISE_STORAGE_UID_LENGTH, 8 ) # Grace period for abandoned service calls to finish before forced exit. # Normal interpreter shutdown would otherwise wait on those threads. CLI_TIMEOUT_EXIT_GRACE_SECONDS = 5.0 # Poll interval while waiting for abandoned service calls to finish. CLI_TIMEOUT_EXIT_POLL_INTERVAL = 0.25 # Defines our click context settings adding -h to the additional options that # can be specified to get the help menu to come up CONTEXT_SETTINGS = {"help_option_names": ["-h", "--help"]} # Define our default configuration we use if nothing is otherwise specified DEFAULT_CONFIG_PATHS = ( # Legacy Path Support "~/.apprise", "~/.apprise.conf", "~/.apprise.yml", "~/.apprise.yaml", "~/.config/apprise", "~/.config/apprise.conf", "~/.config/apprise.yml", "~/.config/apprise.yaml", # Plugin Support Extended Directory Search Paths "~/.apprise/apprise", "~/.apprise/apprise.conf", "~/.apprise/apprise.yml", "~/.apprise/apprise.yaml", "~/.config/apprise/apprise", "~/.config/apprise/apprise.conf", "~/.config/apprise/apprise.yml", "~/.config/apprise/apprise.yaml", # Global Configuration File Support "/etc/apprise", "/etc/apprise.yml", "/etc/apprise.yaml", "/etc/apprise/apprise", "/etc/apprise/apprise.conf", "/etc/apprise/apprise.yml", "/etc/apprise/apprise.yaml", ) # Define our paths to search for plugins DEFAULT_PLUGIN_PATHS = ( "~/.apprise/plugins", "~/.config/apprise/plugins", # Global Plugin Support "/var/lib/apprise/plugins", ) # # General Options and Defaults # DEFAULT_NOTIFY_TYPE = NotifyType.INFO NOTIFY_TYPE_CHOICES: tuple[NotifyType, ...] = ( NotifyType.INFO, NotifyType.SUCCESS, NotifyType.WARNING, NotifyType.FAILURE, ) DEFAULT_NOTIFY_FORMAT = NotifyFormat.TEXT NOTIFY_FORMAT_CHOICES: tuple[NotifyFormat, ...] = ( NotifyFormat.TEXT, NotifyFormat.MARKDOWN, NotifyFormat.HTML, ) # # Persistent Storage # DEFAULT_STORAGE_PATH = "~/.local/share/apprise/cache" # Storage Mode DEFAULT_STORAGE_MODE = PersistentStoreMode.AUTO # Create an ordered list of options (first is default) PERSISTENT_STORE_MODE_CHOICES: tuple[PersistentStoreMode, ...] = ( PersistentStoreMode.AUTO, PersistentStoreMode.FLUSH, PersistentStoreMode.MEMORY, ) # Detect Windows if platform.system() == "Windows": # Default Config Search Path for Windows Users DEFAULT_CONFIG_PATHS = ( "%APPDATA%\\Apprise\\apprise", "%APPDATA%\\Apprise\\apprise.conf", "%APPDATA%\\Apprise\\apprise.yml", "%APPDATA%\\Apprise\\apprise.yaml", "%LOCALAPPDATA%\\Apprise\\apprise", "%LOCALAPPDATA%\\Apprise\\apprise.conf", "%LOCALAPPDATA%\\Apprise\\apprise.yml", "%LOCALAPPDATA%\\Apprise\\apprise.yaml", # # Global Support # # C:\ProgramData\Apprise "%ALLUSERSPROFILE%\\Apprise\\apprise", "%ALLUSERSPROFILE%\\Apprise\\apprise.conf", "%ALLUSERSPROFILE%\\Apprise\\apprise.yml", "%ALLUSERSPROFILE%\\Apprise\\apprise.yaml", # C:\Program Files\Apprise "%PROGRAMFILES%\\Apprise\\apprise", "%PROGRAMFILES%\\Apprise\\apprise.conf", "%PROGRAMFILES%\\Apprise\\apprise.yml", "%PROGRAMFILES%\\Apprise\\apprise.yaml", # C:\Program Files\Common Files "%COMMONPROGRAMFILES%\\Apprise\\apprise", "%COMMONPROGRAMFILES%\\Apprise\\apprise.conf", "%COMMONPROGRAMFILES%\\Apprise\\apprise.yml", "%COMMONPROGRAMFILES%\\Apprise\\apprise.yaml", ) # Default Plugin Search Path for Windows Users DEFAULT_PLUGIN_PATHS = ( "%APPDATA%\\Apprise\\plugins", "%LOCALAPPDATA%\\Apprise\\plugins", # # Global Support # # C:\ProgramData\Apprise\plugins "%ALLUSERSPROFILE%\\Apprise\\plugins", # C:\Program Files\Apprise\plugins "%PROGRAMFILES%\\Apprise\\plugins", # C:\Program Files\Common Files "%COMMONPROGRAMFILES%\\Apprise\\plugins", ) # # Persistent Storage # DEFAULT_STORAGE_PATH = "%APPDATA%/Apprise/cache" class PersistentStorageMode: """Persistent Storage Modes.""" # List all detected configuration loaded LIST = "list" # Prune persistent storage based on age PRUNE = "prune" # Reset all (regardless of age) CLEAR = "clear" # Define the types in a list for validation purposes PERSISTENT_STORAGE_MODES = ( PersistentStorageMode.LIST, PersistentStorageMode.PRUNE, PersistentStorageMode.CLEAR, ) if os.environ.get(DEFAULT_ENV_APPRISE_STORAGE_PATH, "").strip(): # Override Default Storage Path DEFAULT_STORAGE_PATH = os.environ.get(DEFAULT_ENV_APPRISE_STORAGE_PATH) def _log_runtime_env(): """Log Python, OS, encoding, and optional-dependency versions. Only runs when the logger is at DEBUG level or below. """ # Skip all work when DEBUG output is not enabled if not logger.isEnabledFor(logging.DEBUG): return import contextlib import locale # One-line environment summary logger.debug("Apprise: %s", __version__) logger.debug("Python: %s", platform.python_version()) logger.debug("Platform: %s", platform.platform()) logger.debug("Encoding: %s", locale.getpreferredencoding(False)) # Collect unique runtime-dep import names from all enabled plugins dep_names = set() for module in NotificationManager(): for plugin in module.get("plugin", ()): # Skip disabled plugins if not getattr(plugin, "enabled", True): continue fn = getattr(plugin, "runtime_deps", None) if not callable(fn): continue with contextlib.suppress(Exception): dep_names.update(fn()) # Nothing to report if not dep_names: return # packages_distributions() was added in Python 3.11; on older # Python we skip the dep listing but the env summary above is # still emitted. try: from importlib.metadata import ( PackageNotFoundError, packages_distributions, version as pkg_version, ) except ImportError: return # Resolve import names -> pip distribution names, then fetch # versions. packages_distributions() returns: # {import_name: [dist_name, ...]} try: dist_map = packages_distributions() except Exception: return # Build a sorted list of "name=version" pairs for resolved packages resolved = [] for name in sorted(dep_names): dist_names = dist_map.get(name, []) if not dist_names: # Import name not mapped to any installed distribution continue try: ver = pkg_version(dist_names[0]) except (PackageNotFoundError, Exception): # Package listed but not actually installed; skip silently continue resolved.append("{}={}".format(dist_names[0], ver)) if resolved: logger.debug("Runtime deps: %s", ", ".join(resolved)) def print_version_msg(): """Prints version message when -V or --version is specified.""" result = [] result.append(f"{__title__} v{__version__}") result.append(__copyright__) result.append(f"This code is licensed under the {__license__} License.") click.echo("\n".join(result)) class CustomHelpCommand(click.Command): def format_help(self, ctx, formatter): formatter.write_text("Usage:") formatter.write_text( " apprise [OPTIONS] [APPRISE_URL [APPRISE_URL2 [APPRISE_URL3]]]" ) formatter.write_text( " apprise storage [OPTIONS] [ACTION] [UID1 [UID2 [UID3]]]" ) # Custom help message formatter.write_text("") content = ( ("Send a notification to the services identified by their URLs"), ( "the content provided within the title, body and " "notification-type." ), "", ( "For a list of all of the supported services and information" " on how to use " ), "them, check out https://github.com/caronc/apprise", ) for line in content: formatter.write_text(line) # Display options and arguments in the default format self.format_options(ctx, formatter) self.format_epilog(ctx, formatter) # Custom 'Actions:' section after the 'Options:' formatter.write_text("") formatter.write_text("Actions:") actions = [ ( "storage", "Access the persistent storage disk administration", [ ( "list", ( "List all URL IDs associated with detected" " URL(s). This is also the default action" " run if nothing is provided" ), ), ( "prune", ( "Eliminates stale entries found based on " "--storage-prune-days (-SPD)" ), ), ( "clean", "Removes any persistent data created by Apprise", ), ], ) ] # # Some variables # # actions are indented this many spaces # sub actions double this value action_indent = 2 # label padding (for alignment) action_label_width = 10 space = " " space_re = re.compile(r"\r*\n") cols = 80 indent = 10 # Format each action and its subactions for action, description, sub_actions in actions: # Our action indent ai = " " * action_indent # Format the main action description formatted_description = space_re.split( textwrap.fill( description, width=(cols - indent - action_indent), initial_indent=space * indent, subsequent_indent=space * indent, ) ) for no, line in enumerate(formatted_description): if not no: formatter.write_text( f"{ai}{action:<{action_label_width}}{line}" ) else: # pragma: no cover # Note: no branch is set intentionally since this is not # tested since in 2025.08.13 when this was set up # it never entered this area of the code. But we # know it works because we repeat this process with # our sub-options below formatter.write_text( f"{ai}{space:<{action_label_width}}{line}" ) # Format each subaction ai = " " * (action_indent * 2) for action, description in sub_actions: formatted_description = space_re.split( textwrap.fill( description, width=(cols - indent - (action_indent * 3)), initial_indent=space * (indent - action_indent), subsequent_indent=space * (indent - action_indent), ) ) for no, line in enumerate(formatted_description): if not no: formatter.write_text( f"{ai}{action:<{action_label_width}}{line}" ) else: formatter.write_text( f"{ai}{space:<{action_label_width}}{line}" ) # Include any epilog or additional text self.format_epilog(ctx, formatter) def _wait_for_abandoned_calls(timeout: float) -> bool: """Wait up to ``timeout`` for abandoned service calls to finish. Return ``True`` once no tracked calls remain. """ # Log descriptions with private URL details hidden. Background work owned # entirely by a plugin is not tracked here. descriptions = abandoned_call_descriptions() logger.debug( "One or more services timed out. Waiting up to %.1fs more for " "these services to finish: %s", timeout, ", ".join(descriptions) if descriptions else "(no services are still running)", ) # Count our short waits so the CLI never exceeds the grace period. elapsed = 0.0 while elapsed < timeout: # Stop early as soon as every background call is done. if not any_abandoned_calls_still_running(): logger.debug( "Timed-out service calls finished after %.2fs.", elapsed, ) return True # The final sleep may be shorter than the normal polling interval. sleep_for = min(CLI_TIMEOUT_EXIT_POLL_INTERVAL, timeout - elapsed) time.sleep(sleep_for) elapsed += sleep_for # Check once more in case the final call ended during the last sleep. still_running = any_abandoned_calls_still_running() if still_running: logger.debug( "%.1fs elapsed and some timed-out services are still running; " "exiting now.", timeout, ) # Tell the caller whether normal shutdown is now safe. return not still_running def _force_exit(apobj: Apprise, status: AppriseResultStatus) -> None: """Unconditionally end the process, skipping Python's normal shutdown sequence entirely. """ # os._exit() skips normal object cleanup, so flush every store first. # A failed flush must not stop the remaining services from trying. for service in apobj: try: logger.trace( "Flushing persistent store for service: %s", service.url(privacy=True), ) service.flush_store() except Exception as e: logger.warning( "Could not save one service's persistent data before " "exiting; continuing with the remaining services." ) logger.debug("Persistent store save error: %s", e) # os._exit() skips atexit hooks, so flush logging and stdio manually. # Each flush is independent; one failure should not block the others. with contextlib.suppress(Exception): logging.shutdown() with contextlib.suppress(Exception): sys.stdout.flush() with contextlib.suppress(Exception): sys.stderr.flush() # Hard-exit last so abandoned worker threads cannot keep the CLI alive. os._exit(status) @click.command(context_settings=CONTEXT_SETTINGS, cls=CustomHelpCommand) @click.option( "--body", "-b", default=None, type=str, help=( "Specify the message body. If no body is specified then " "content is read from ." ), ) @click.option( "--title", "-t", default=None, type=str, help="Specify the message title. This field is completely optional.", ) @click.option( "--plugin-path", "-P", default=None, type=str, multiple=True, metavar="PATH", help="Specify one or more plugin paths to scan.", ) @click.option( "--storage-path", "-S", default=DEFAULT_STORAGE_PATH, type=str, metavar="PATH", help=( "Specify the path to the persistent storage location " f"(default={DEFAULT_STORAGE_PATH})." ), ) @click.option( "--storage-prune-days", "-SPD", default=DEFAULT_STORAGE_PRUNE_DAYS, type=int, help=( "Define the number of days the storage prune should run using." " Setting this to zero (0) will eliminate all accumulated content. By" f" default this value is {DEFAULT_STORAGE_PRUNE_DAYS} days." ), ) @click.option( "--storage-uid-length", "-SUL", default=DEFAULT_STORAGE_UID_LENGTH, type=int, help=( "Define the number of unique characters to store persistent cache in." f" By default this value is {DEFAULT_STORAGE_UID_LENGTH} characters." ), ) @click.option( "--storage-mode", "-SM", default=DEFAULT_STORAGE_MODE.value, type=str, metavar="MODE", help=( "Specify the persistent storage operational mode " f"(default={DEFAULT_STORAGE_MODE.value}). " 'Possible values are: "{}".'.format( '", "'.join(mode.value for mode in PERSISTENT_STORE_MODE_CHOICES) ) ), ) @click.option( "--config", "-c", default=None, type=str, multiple=True, metavar="CONFIG_URL", help="Specify one or more configuration locations.", ) @click.option( "--attach", "-a", default=None, type=str, multiple=True, metavar="ATTACHMENT_URL", help="Specify one or more attachments.", ) @click.option( "--notification-type", "-n", default=DEFAULT_NOTIFY_TYPE.value, type=str, metavar="TYPE", help=( f"Specify the message type (default={DEFAULT_NOTIFY_TYPE.value}). " 'Possible values are: "{}".'.format( '", "'.join(nt.value for nt in NOTIFY_TYPE_CHOICES) ) ), ) @click.option( "--input-format", "-i", default=DEFAULT_NOTIFY_FORMAT.value, type=str, metavar="FORMAT", help=( f"Specify the message input format " f"(default={DEFAULT_NOTIFY_FORMAT.value}). " 'Possible values are: "{}".'.format( '", "'.join(fmt.value for fmt in NOTIFY_FORMAT_CHOICES) ) ), ) @click.option( "--theme", "-T", default="default", type=str, metavar="THEME", help="Specify the default theme.", ) @click.option( "--template-var", "-tv", "template_var", default=None, type=str, multiple=True, metavar="NAME=VALUE", help=( "Supply a value used by a YAML configuration written with " "${NAME}. Use multiple --template-var (-tv) entries for more " "than one. A value not given here is looked for in the " "configuration's own default and then in " "APPRISE_TEMPLATE_." ), ) @click.option( "--tag", "-g", default=None, type=str, multiple=True, metavar="TAG", help=( "Specify one or more tags to filter which services to notify. Use " "multiple --tag (-g) entries to match ANY tag. Use comma separators " "to require ALL tags (strict match). Omit to notify untagged services " 'only, or use "all" to notify everything.' ), ) @click.option( "--limit", "-L", default=0, type=float, metavar="SECONDS", help=( "Give up on the whole run if it's taking too long, in seconds " "(whole number or decimal, e.g. 2.5). By default (0) there is " "no limit -- see --service-limit to cap each service on its own " "instead." ), ) @click.option( "--service-limit", "-SL", default=None, type=float, metavar="SECONDS", help=( "Give up on any single service if it's taking too long, in " "seconds (whole number or decimal, e.g. 2.5), or 0 to turn this " "off entirely. Leave unset to use Apprise's own default of " f"{AppriseAsset._service_timeout:g} seconds." ), ) @click.option( "--disable-async", "-Da", is_flag=True, help="Send all notifications sequentially", ) @click.option( "--dry-run", "-d", is_flag=True, help=( "Perform a trial run but only prints the notification " "services to-be triggered to stdout. Notifications are never " "sent using this mode." ), ) @click.option( "--details", "-l", is_flag=True, help="Prints details about the current services supported by Apprise.", ) @click.option( "--recursion-depth", "-R", default=DEFAULT_RECURSION_DEPTH, type=int, help=( "The number of recursive import entries that can be " "loaded from within Apprise configuration. By default " f"this is set to {DEFAULT_RECURSION_DEPTH}." ), ) @click.option( "--verbose", "-v", count=True, help=( "Makes the operation more talkative. Use multiple v to " "increase the verbosity. I.e.: -vvvv" ), ) @click.option( "--interpret-escapes", "-e", is_flag=True, help="Enable interpretation of backslash escapes", ) @click.option( "--interpret-emojis", "-j", is_flag=True, help="Enable interpretation of :emoji: definitions", ) @click.option("--debug", "-D", is_flag=True, help="Debug mode") @click.option( "--version", "-V", is_flag=True, help="Display the apprise version and exit.", ) @click.argument( "urls", nargs=-1, metavar="SERVICE_URL [SERVICE_URL2 [SERVICE_URL3]]", ) @click.pass_context def main( ctx, body, title, config, attach, urls, notification_type, theme, template_var, tag, input_format, dry_run, limit, service_limit, recursion_depth, verbose, disable_async, details, interpret_escapes, interpret_emojis, plugin_path, storage_path, storage_mode, storage_prune_days, storage_uid_length, debug, version, ): """Send the supplied title, body, and notification type to the services identified by the given URLs or configuration sources. For a list of all of the supported services and information on how to use them, check out https://github.com/caronc/apprise """ # Note: Click ignores the return values of functions it wraps, If you # want to return a specific error code, you must call ctx.exit() # as you will see below. debug = bool(debug) if debug: # Verbosity must be a minimum of 3 verbose = 3 if verbose < 3 else verbose # Logging ch = logging.StreamHandler(sys.stdout) if verbose > 3: # -vvvv: Most Verbose Debug Logging logger.setLevel(logging.TRACE) elif verbose > 2: # -vvv: Debug Logging logger.setLevel(logging.DEBUG) elif verbose > 1: # -vv: INFO Messages logger.setLevel(logging.INFO) elif verbose > 0: # -v: WARNING Messages logger.setLevel(logging.WARNING) else: # No verbosity means we display ERRORS only AND any deprecation # warnings logger.setLevel(logging.ERROR) # Format our logger formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s") ch.setFormatter(formatter) logger.addHandler(ch) # Update our asyncio logger asyncio_logger = logging.getLogger("asyncio") for handler in logger.handlers: asyncio_logger.addHandler(handler) asyncio_logger.setLevel(logger.level) # Log environment and runtime-dependency versions when debugging _log_runtime_env() if version: print_version_msg() ctx.exit(0) # Simple Error Checking notification_type = notification_type.strip().lower() if notification_type not in NOTIFY_TYPES: click.echo( f"The --notification-type (-n) value of {notification_type} is not" " supported." ) click.echo("Try 'apprise --help' for more information.") # 2 is the same exit code returned by Click if there is a parameter # issue. For consistency, we also return a 2 ctx.exit(2) input_format = input_format.strip().lower() if input_format not in NOTIFY_FORMATS: click.echo( f"The --input-format (-i) value of {input_format} is not" " supported." ) click.echo("Try 'apprise --help' for more information.") # 2 is the same exit code returned by Click if there is a parameter # issue. For consistency, we also return a 2 ctx.exit(2) storage_mode = storage_mode.strip().lower() if storage_mode not in PERSISTENT_STORE_MODES: click.echo( f"The --storage-mode (-SM) value of {storage_mode} is not" " supported." ) click.echo("Try 'apprise --help' for more information.") # 2 is the same exit code returned by Click if there is a parameter # issue. For consistency, we also return a 2 ctx.exit(2) # # Apply Environment Overrides if defined # config_paths = DEFAULT_CONFIG_PATHS if DEFAULT_ENV_APPRISE_CONFIG_PATH in os.environ: logger.debug( f"Loading provided {DEFAULT_ENV_APPRISE_CONFIG_PATH} " "environment variable" ) config_paths = re.split( r"[\r\n;]+", os.environ.get(DEFAULT_ENV_APPRISE_CONFIG_PATH).strip(), ) elif "APPRISE_CONFIG" in os.environ: logger.deprecate( "The APPRISE_CONFIG environment variable has been renamed to " f"{DEFAULT_ENV_APPRISE_CONFIG_PATH}" ) config_paths = re.split( r"[\r\n;]+", os.environ.get("APPRISE_CONFIG").strip(), ) plugin_paths_ = DEFAULT_PLUGIN_PATHS if DEFAULT_ENV_APPRISE_PLUGIN_PATH in os.environ: logger.debug( f"Loading provided {DEFAULT_ENV_APPRISE_PLUGIN_PATH} environment " "variable" ) plugin_paths_ = re.split( r"[\r\n;]+", os.environ.get(DEFAULT_ENV_APPRISE_PLUGIN_PATH).strip(), ) if DEFAULT_ENV_APPRISE_STORAGE_PATH in os.environ: logger.debug( f"Loading provided {DEFAULT_ENV_APPRISE_STORAGE_PATH} environment " "variable" ) storage_path = os.environ.get(DEFAULT_ENV_APPRISE_STORAGE_PATH).strip() # # Continue with initialization process # # Prepare a default set of plugin paths to scan; anything specified # on the CLI always trumps plugin_paths = ( plugin_path if plugin_path else [path for path in plugin_paths_ if exists(path_decode(path))] ) if INVALID_ENV: for name, value in INVALID_ENV: click.echo( f"The {name} environment variable value of {value!r} is not" " a valid number." ) click.echo("Try 'apprise --help' for more information.") # 2 is the same exit code returned by Click if there is a # parameter issue. For consistency, we also return a 2 ctx.exit(2) if storage_uid_length < 2: click.echo( "The --storage-uid-length (-SUL) value can not be lower " "than two (2)." ) click.echo("Try 'apprise --help' for more information.") # 2 is the same exit code returned by Click if there is a # parameter issue. For consistency, we also return a 2 ctx.exit(2) # Prepare our asset asset = AppriseAsset( # Our body format body_format=input_format, # Interpret Escapes interpret_escapes=interpret_escapes, # Interpret Emojis interpret_emojis=None if not interpret_emojis else True, # Set the theme theme=theme, # Async mode allows a user to send all of their notifications # asynchronously. This was made an option incase there are problems # in the future where it is better that everything runs sequentially/ # synchronously instead. async_mode=disable_async is not True, # Load our plugins plugin_paths=plugin_paths, # Load our persistent storage path storage_path=path_decode(storage_path), # Our storage URL ID Length storage_idlen=storage_uid_length, # Define if we flush to disk as soon as possible or not when required storage_mode=storage_mode, # Apply the optional per-service delivery budget to every plugin. service_timeout=service_limit, ) # Create our Apprise object a = Apprise(asset=asset, debug=debug, location=ContentLocation.LOCAL) # Track if we are performing a storage action storage_action = bool(urls and "storage".startswith(urls[0])) # Save the original state; the storage block below always needs these. _in_storage_mode = storage_action _raw_urls = urls if storage_action: # Scan storage args for URL-filter entries. If any are found, # remap urls to only those entries and flip storage_action so the # priority chain (rule #1 below) loads them into 'a' (our Apprise # instance). This mirrors the sending notification process. _sfp = list(urls[1:]) if _sfp and any( m.startswith(_sfp[0]) for m in PERSISTENT_STORAGE_MODES ): # Skip the action word ("list", "prune", "clear") _sfp = _sfp[1:] _url_filters = [_f for _f in _sfp if GET_SCHEMA_RE.match(_f)] if _url_filters: # Hand off to rule #1 by replacing urls and clearing the flag. urls = _url_filters storage_action = False if details: # Print details and exit results = a.details(show_requirements=True, show_disabled=True) # Sort our results: plugins = sorted( results["schemas"], key=lambda i: str(i["service_name"]) ) for entry in plugins: protocols = ( [] if not entry["protocols"] else [p for p in entry["protocols"] if isinstance(p, str)] ) protocols.extend( [] if not entry["secure_protocols"] else [ p for p in entry["secure_protocols"] if isinstance(p, str) ] ) if len(protocols) == 1: # Simplify view by swapping {schema} with the single # protocol value # Convert tuple to list entry["details"]["templates"] = list( entry["details"]["templates"] ) for x in range(len(entry["details"]["templates"])): entry["details"]["templates"][x] = re.sub( r"^[^}]+}://", f"{protocols[0]}://", entry["details"]["templates"][x], ) fg = "green" if entry["enabled"] else "red" if entry["category"] == "custom": # Identify these differently fg = "cyan" # Flip the enable switch so it forces the requirements # to be displayed entry["enabled"] = False click.echo( click.style( "{} {:<30} ".format( "+" if entry["enabled"] else "-", str(entry["service_name"]), ), fg=fg, bold=True, ), nl=(not entry["enabled"] or len(protocols) == 1), ) if not entry["enabled"]: if entry["requirements"]["details"]: click.echo(" " + str(entry["requirements"]["details"])) if entry["requirements"]["packages_required"]: click.echo(" Python Packages Required:") for req in entry["requirements"]["packages_required"]: click.echo(" - " + req) if entry["requirements"]["packages_recommended"]: click.echo(" Python Packages Recommended:") for req in entry["requirements"]["packages_recommended"]: click.echo(" - " + req) # new line padding between entries if entry["category"] == "native": click.echo() continue if len(protocols) > 1: click.echo( "| Schema(s): {}".format( ", ".join(protocols), ) ) prefix = " - " click.echo( "{}{}".format( prefix, f"\n{prefix}".join(entry["details"]["templates"]) ) ) # new line padding between entries click.echo() ctx.exit(0) # end if details() # The priorities of what is accepted are parsed in order below: # 1. URLs by command line # 2. Configuration by command line # 3. URLs by environment variable: APPRISE_URLS # 4. Default Configuration File(s) # elif urls and not storage_action: if tag: # Ignore any tags specified logger.warning( "--tag (-g) entries are ignored when using specified URLs" ) tag = None # Load our URLs (if any defined) for url in urls: a.add(url) if config: # Provide a warning to the end user if they specified both logger.warning( "You defined both URLs and a --config (-c) entry; " "Only the URLs will be referenced." ) elif config: # We load our configuration file(s) now only if no URLs were specified # Specified config entries trump all a.add( AppriseConfig(paths=config, asset=asset, recursion=recursion_depth) ) elif os.environ.get(DEFAULT_ENV_APPRISE_URLS, "").strip(): logger.debug( f"Loading provided {DEFAULT_ENV_APPRISE_URLS} environment variable" ) if tag: # Ignore any tags specified logger.warning( "--tag (-g) entries are ignored when using specified URLs" ) tag = None # Attempt to use our APPRISE_URLS environment variable (if populated) a.add(os.environ[DEFAULT_ENV_APPRISE_URLS].strip()) else: # Load default configuration a.add( AppriseConfig( paths=[f for f in config_paths if isfile(path_decode(f))], asset=asset, recursion=recursion_depth, ) ) # Restore storage_action in case it was flipped above to allow URL- # filter entries to be loaded via rule #1. storage_action = _in_storage_mode if not dry_run and not (a or storage_action): click.echo( "You must specify at least one service URL or populated " "configuration file." ) click.echo("Try 'apprise --help' for more information.") ctx.exit(1) # Each --tag value is a comma-separated AND group; values are ORed. tags = None if not tag else [parse_list(t) for t in tag] # Split once so equals signs remain valid inside the value. template_vars = {} # Names are matched without regard to case, so track what we have seen. template_seen = set() for entry in template_var: name, sep, value = entry.partition("=") name = name.strip() if not sep or not TEMPLATE_NAME_RE.match(name): # Only the name is echoed; the rest of the entry may be a # secret and must not reach the screen or a captured log. click.echo( "The --template-var (-tv) name '{}' is not in the" " expected NAME=VALUE format.".format(name) ) click.echo("Try 'apprise --help' for more information.") # Match Click's exit code for invalid parameters. ctx.exit(2) if normalize_name(name) in template_seen: click.echo( "The --template-var (-tv) name '{}' was provided more than" " once.".format(name) ) click.echo("Try 'apprise --help' for more information.") # Match Click's exit code for invalid parameters. ctx.exit(2) template_seen.add(normalize_name(name)) template_vars[name] = value # Determine if we're dealing with URLs or url_ids based on the first # entry provided. if storage_action: # # Storage Mode # - urls are now to be interpreted as best matching namespaces # if storage_prune_days < 0: click.echo( "The --storage-prune-days (-SPD) value can not be lower " "than zero (0)." ) click.echo("Try 'apprise --help' for more information.") # 2 is the same exit code returned by Click if there is a # parameter issue. For consistency, we also return a 2 ctx.exit(2) # Number of columns to assume in the terminal. In future, maybe this # can be detected and made dynamic. The actual column count is 80, but # 5 characters are already reserved for the counter on the left (columns, _) = shutil.get_terminal_size(fallback=(80, 24)) # Pop 'storage' off of the head of the original url list. # _raw_urls always holds the unmodified list even when urls was # remapped to URL-filter entries for the priority chain above. filter_uids = _raw_urls[1:] action = PERSISTENT_STORAGE_MODES[0] if filter_uids: action_ = next( # pragma: no branch ( a for a in PERSISTENT_STORAGE_MODES if a.startswith(filter_uids[0]) ), None, ) if action_: # pop 'action' off the head of our list filter_uids = filter_uids[1:] action = action_ # True when URL-filter entries were present in the storage args; # detected by whether urls was remapped to a new list object above. _had_url_filters = _raw_urls is not urls # Build the uid-prefix filter list from non-URL entries only. # URL-filter entries were already loaded into 'a' by rule #1. uid_filter_list = [ _f.lower() for _f in filter_uids if not GET_SCHEMA_RE.match(_f) ] # Single pass: collect plugin uids, applying the uid-prefix filter uids = {} for plugin in a if not tags else a.find(tag=tags): id_ = plugin.url_id() if not id_: # No persistent storage uid; skip this plugin continue if uid_filter_list and not next( (u for u in uid_filter_list if id_.startswith(u)), None ): # Plugin uid does not match any uid-prefix filter logger.trace( "Storage: plugin uid '%s' excluded by filter %s", id_, uid_filter_list, ) continue if id_ not in uids: uids[id_] = { "plugins": [plugin], "state": PersistentStoreState.UNUSED.value, "size": 0, } else: # It's possible to have more than one URL point to the same # location (thus match against the same url id more than once uids[id_]["plugins"].append(plugin) if action == PersistentStorageMode.LIST: # Scope disk_scan based on what filters were provided: # - URL filters: scope to resolved plugin uids plus any # plain uid-prefix strings; skip scan if none resolved # - Plain-string or no filter: namespace=uid_filter_list # (empty list means return all on-disk directories) if _had_url_filters: # Derive namespace from the plugins resolved by URL filters _disk_ns = list(uids.keys()) + uid_filter_list if not _disk_ns: # URL filters yielded no plugins; skip the disk scan detected_uid = {} else: detected_uid = PersistentStore.disk_scan( # Use our asset path as already properly parsed path=asset.storage_path, namespace=_disk_ns, ) else: detected_uid = PersistentStore.disk_scan( # Use our asset path as it has already been properly # parsed path=asset.storage_path, # Provide filter if specified; empty = all directories namespace=uid_filter_list, ) for id_ in detected_uid: size, _ = dir_size(os.path.join(asset.storage_path, id_)) if id_ in uids: uids[id_]["state"] = PersistentStoreState.ACTIVE.value uids[id_]["size"] = size elif not tags: uids[id_] = { "plugins": [], # No cross reference (wasted space?) "state": PersistentStoreState.STALE.value, # Acquire disk space "size": size, } for idx, (uid, meta) in enumerate(uids.items()): fg = ( "green" if meta["state"] == PersistentStoreState.ACTIVE.value else ( "red" if meta["state"] == PersistentStoreState.STALE.value else "white" ) ) if idx > 0: # New line click.echo() click.echo(f"{idx + 1: 4d}. ", nl=False) click.echo( click.style( "{:<52} {:<8} {}".format( uid, bytes_to_str(meta["size"]), meta["state"] ), fg=fg, bold=True, ) ) for entry in meta["plugins"]: url = entry.url(privacy=True) click.echo( "{:>7} {}".format( "-", ( url if len(url) <= (columns - 8) else f"{url[: columns - 11]}..." ), ) ) if entry.tags: click.echo( "{:>10}: {}".format( "tags", ", ".join(sorted(str(t) for t in entry.tags)), ) ) else: # PersistentStorageMode.PRUNE or PersistentStorageMode.CLEAR if action == PersistentStorageMode.CLEAR: storage_prune_days = 0 # Match disk-scan filtering when choosing prune namespaces: # - URL and tag filters use resolved UIDs plus explicit prefixes. # - An empty filtered result prunes nothing. # - Otherwise, pass explicit prefixes or no filter through. if _had_url_filters or tags: # Exit when filters resolve nothing because None prunes all. _prune_ns = list(uids.keys()) + uid_filter_list if not _prune_ns: ctx.exit(0) else: _prune_ns = uid_filter_list or None # clean up storage results = PersistentStore.disk_prune( # Use our asset path as it has already been properly parsed path=asset.storage_path, # Provide our namespaces if they exist namespace=_prune_ns, # Convert expiry from days to seconds expires=storage_prune_days * 60 * 60 * 24, action=not dry_run, ) ctx.exit(0) # end if disk_prune() ctx.exit(0) # end if storage() if not dry_run: if body is None: logger.trace("No --body (-b) specified; reading from stdin") # if no body was specified, then read from STDIN body = click.get_text_stream("stdin").read() # Send the notification. AppriseResult.status maps directly to the # process exit values handled after the dry-run branch. notify_start = time.monotonic() result = a.notify( body=body, title=title, notify_type=notification_type, tag=tags, attach=attach, template=template_vars, timeout=limit, ) status = result.status # Status report logger.debug( "Finished in %.2fs. %d service(s) tried (%s): %d sent / " "%d failed / %d timed out.", time.monotonic() - notify_start, len(result), status.name, result.success_count, result.failed_count, result.timeout_count, ) else: # Number of columns to assume in the terminal. In future, maybe this # can be detected and made dynamic. The actual column count is 80, but # 5 characters are already reserved for the counter on the left (columns, _) = shutil.get_terminal_size(fallback=(80, 24)) # Initialize our URL response; This is populated within the for/loop # below; but plays a factor at the end when we need to determine if # we iterated at least once in the loop. url = None # Count matching entries that a real run would skip. unresolved = 0 # Show pending entries and the values they still need. for idx, service in enumerate(a.find(tag=tags, resolve=False)): entry = service if isinstance(service, NotifyTemplate): # Resolve supplied values or display the pending entry. built = Apprise._resolve_template(service, template_vars) if built is not None: service = built url = service.url(privacy=True) click.echo( "{: 4d}. {}".format( idx + 1, ( url if len(url) <= (columns - 8) else f"{url[: columns - 9]}..." ), ) ) # Share our URL ID if service.url_id(): uid = service.url_id() elif isinstance(service, NotifyTemplate): # Explain why this pending entry has no identifier. uid = "- template; unresolved, would not send -" unresolved += 1 else: uid = "- n/a -" click.echo("{:>10}: {}".format("uid", uid)) if service.tags: click.echo( "{:>10}: {}".format( "tags", ", ".join(sorted(str(t) for t in service.tags)), ) ) names = getattr(entry, "template_names", ()) if names: required = set(getattr(entry, "template_required", ())) click.echo( "{:>10}: {}".format( "template", ", ".join( "{} ({})".format( name, "required" if name in required else "has default", ) for name in names ), ) ) if unresolved: click.echo() click.echo( "{} of {} matched entries could not be resolved and would" " not be sent. Check the log for the reason.".format( unresolved, idx + 1 ) ) # Dry-run has no AppriseResult, so map its outcome to the same enum. # A missing value maps to the same outcome a real run would give. if url is None: status = AppriseResultStatus.NOMATCH elif not unresolved: status = AppriseResultStatus.SUCCESS elif unresolved == idx + 1: status = AppriseResultStatus.FAILURE else: status = AppriseResultStatus.PARTIAL if status == AppriseResultStatus.TIMEOUT and not _wait_for_abandoned_calls( CLI_TIMEOUT_EXIT_GRACE_SECONDS ): _force_exit(a, status) # AppriseResultStatus values map directly to CLI exit codes. # Exit code 2 is left to Click for bad command-line parameters. ctx.exit(status) caronc-apprise-dfec414/apprise/common.py000066400000000000000000000166261526720371000204370ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from enum import Enum # isoformat is spelled out for compatibility with Python v3.6 AWARE_DATE_ISO_FORMAT = "%Y-%m-%dT%H:%M:%S.%f%z" NAIVE_DATE_ISO_FORMAT = "%Y-%m-%dT%H:%M:%S.%f" # Compact separators (no space after "," or ":"). JSON_COMPACT_SEPARATORS = (",", ":") class NotifyType(str, Enum): """A simple mapping of notification types most commonly used with all types of logging and notification services.""" INFO = "info" SUCCESS = "success" WARNING = "warning" FAILURE = "failure" # Define our types so we can verify if we need to NOTIFY_TYPES: frozenset[str] = frozenset(e.value for e in NotifyType) class NotifyImageSize(str, Enum): """A list of pre-defined image sizes to make it easier to work with defined plugins.""" XY_32 = "32x32" XY_72 = "72x72" XY_128 = "128x128" XY_256 = "256x256" # Define our image sizes so we can verify if we need to NOTIFY_IMAGE_SIZES: frozenset[str] = frozenset( e.value for e in NotifyImageSize ) class NotifyFormat(str, Enum): """A list of pre-defined text message formats that can be passed via the apprise library.""" TEXT = "text" HTML = "html" MARKDOWN = "markdown" # Define our formats so we can verify if we need to NOTIFY_FORMATS: frozenset[str] = frozenset(e.value for e in NotifyFormat) class OverflowMode(str, Enum): """A list of pre-defined modes of how to handle the text when it exceeds the defined maximum message size.""" # Send the data as is; untouched. Let the upstream server decide how the # content is handled. Some upstream services might gracefully handle this # with expected intentions; others might not. UPSTREAM = "upstream" # Always truncate the text when it exceeds the maximum message size and # send it anyway TRUNCATE = "truncate" # Split the message into multiple smaller messages that fit within the # limits of what is expected. The smaller messages are sent SPLIT = "split" # Define our modes so we can verify if we need to OVERFLOW_MODES: frozenset[str] = frozenset(e.value for e in OverflowMode) class ConfigFormat(str, Enum): """A list of pre-defined config formats that can be passed via the apprise library.""" # A text based configuration. This consists of a list of URLs delimited by # a new line. pound/hashtag (#) or semi-colon (;) can be used as comment # characters. TEXT = "text" # YAML files allow a more rich of an experience when settig up your # apprise configuration files. YAML = "yaml" # Define our configuration formats mostly used for verification CONFIG_FORMATS: frozenset[str] = frozenset(e.value for e in ConfigFormat) class ContentIncludeMode(str, Enum): """The different Content inclusion modes. All content based plugins will have one of these associated with it. """ # - Content inclusion of same type only; hence a file:// can include # a file:// # - Cross file inclusion is not allowed unless insecure_includes (a flag) # is set to True. In these cases STRICT acts as type ALWAYS STRICT = "strict" # This content type can never be included NEVER = "never" # This content can always be included ALWAYS = "always" # Define our file inclusion types so we can verify if we need to CONTENT_INCLUDE_MODES: frozenset[str] = frozenset( e.value for e in ContentIncludeMode ) class ContentLocation(str, Enum): """This is primarily used for handling file attachments. The idea is to track the source of the attachment itself. We don't want remote calls to a server to access local attachments for example. By knowing the attachment type and cross-associating it with how we plan on accessing the content, we can make a judgement call (for security reasons) if we will allow it. Obviously local uses of apprise can access both local and remote type files. """ # Content is located locally (on the same server as apprise) LOCAL = "local" # Content is located in a remote location HOSTED = "hosted" # Content is inaccessible INACCESSIBLE = "n/a" # Define our location types so we can verify if we need to CONTENT_LOCATIONS: frozenset[str] = frozenset(e.value for e in ContentLocation) class PersistentStoreMode(str, Enum): # Allow persistent storage; write on demand AUTO = "auto" # Always flush every change to disk after it's saved. This has higher i/o # but enforces disk reflects what was set immediately FLUSH = "flush" # memory based store only MEMORY = "memory" # Define our persistent storage modes so we can verify if we need to PERSISTENT_STORE_MODES: frozenset[str] = frozenset( e.value for e in PersistentStoreMode ) class PersistentStoreState(str, Enum): """Defines the persistent states describing what has been cached.""" # Persistent Directory is actively cross-referenced against a matching URL ACTIVE = "active" # Persistent Directory is no longer being used or has no cross-reference STALE = "stale" # Persistent Directory is not utilizing any disk space at all, however # it potentially could if the plugin it successfully cross-references # is utilized UNUSED = "unused" # Define our persistent storage states so we can verify if we need to PERSISTENT_STORE_STATES: frozenset[str] = frozenset( e.value for e in PersistentStoreState ) # This is a reserved tag that is automatically assigned to every # Notification Plugin MATCH_ALL_TAG = "all" # Will cause notification to trigger under any circumstance even if an # exclusive tagging was provided. MATCH_ALWAYS_TAG = "always" # Maximum number of retries a service may attempt after an initial failure. # This cap prevents runaway retry loops; the effective value is clamped to # [0, APPRISE_MAX_SERVICE_RETRY] everywhere it is consumed. APPRISE_MAX_SERVICE_RETRY = 10 # Maximum inter-retry wait (in seconds). Prevents accidental multi-hour # sleeps from a misconfigured wait= value; clamped to # [0.0, APPRISE_MAX_SERVICE_WAIT] everywhere it is consumed. APPRISE_MAX_SERVICE_WAIT = 20.0 caronc-apprise-dfec414/apprise/compat/000077500000000000000000000000001526720371000200455ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/compat/__init__.py000066400000000000000000000030461526720371000221610ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. """Compatibility helpers for supported older platforms and libraries. Modules can be removed with their tests once their target versions are no longer supported. """ caronc-apprise-dfec414/apprise/compat/markdown33.py000066400000000000000000000047571526720371000224240ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Support Python-Markdown 3.3 as shipped with Rocky Linux 9. from html import escape import re from markdown import Markdown from markdown.postprocessors import Postprocessor from markdown.util import ETX, STX # A backslash-escaped character that Python-Markdown left as a placeholder _ESCAPED_PLACEHOLDER_RE = re.compile(f"{STX}([0-9]+){ETX}") class _UnescapePostprocessor(Postprocessor): """Restore backslash-escaped characters as valid HTML.""" def run(self, text: str) -> str: """Replace each escape placeholder with its HTML-safe character.""" # Python-Markdown 3.3 restores these after the HTML is built, so # "\&" or "\<" came back raw. Newer releases leave nothing to # replace here. return _ESCAPED_PLACEHOLDER_RE.sub( lambda m: escape(chr(int(m.group(1))), quote=False), text ) def escape_placeholders_as_html(md: Markdown) -> None: """Make ``md`` write backslash-escaped characters as valid HTML.""" # This replaces Python-Markdown 3.3's own step of the same name. md.postprocessors.register(_UnescapePostprocessor(md), "unescape", 10) caronc-apprise-dfec414/apprise/compat/py39.py000066400000000000000000000040041526720371000212210ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Support Python 3.9 as shipped with Rocky Linux 9. from dataclasses import dataclass as _dataclass import sys from typing import Any, Callable, TypeVar _T = TypeVar("_T") # dataclass(slots=...) was added in Python 3.10 _HAS_SLOTS = sys.version_info >= (3, 10) def dataclass_compat(*dargs: Any, **dkwargs: Any) -> Callable[[_T], _T]: """dataclass() wrapper that drops ``slots=`` on Python 3.9.""" if not _HAS_SLOTS: # Python 3.9 rejects slots=, so the class is built without them dkwargs.pop("slots", None) # Any other error, on any Python, reaches the caller unchanged return _dataclass(*dargs, **dkwargs) caronc-apprise-dfec414/apprise/config/000077500000000000000000000000001526720371000200275ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/config/__init__.py000066400000000000000000000031671526720371000221470ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Used for testing from ..manager_config import ConfigurationManager from .base import ConfigBase # Initalize our Config Manager Singleton C_MGR = ConfigurationManager() __all__ = [ # Reference "ConfigBase", "ConfigurationManager", ] caronc-apprise-dfec414/apprise/config/base.py000066400000000000000000002252461526720371000213260ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from __future__ import annotations from collections import deque import os import re import time from .. import common, plugins from ..asset import AppriseAsset from ..exception import AppriseImproperlyConfigured, AppriseTemplateError from ..locale import AppriseLocale from ..logger import logging from ..manager_config import ConfigurationManager from ..manager_plugins import NotificationManager from ..tag import AppriseTag from ..template import NotifyTemplate from ..url import URL_TOKEN_ALIASES, URLBase from ..utils.cwe312 import cwe312_loggable from ..utils.parse import ( GET_SCHEMA_RE, QSD_FULL_MODE_KEYS, parse_bool, parse_list, parse_urls, ) from ..utils.template import ( TemplatePlaceholderMap, TemplateSchema, ) from ..utils.time import zoneinfo from ..utils.yaml import ( YAML_REAPPLY_SKIP, dropped_template, template_in_schema, template_references, templated_tag, ) # Test whether token is valid or not VALID_TOKEN = re.compile(r"(?P[a-z0-9][a-z0-9_]+)", re.I) # Grant access to our Notification Manager Singleton N_MGR = NotificationManager() # Grant access to our Configuration Manager Singleton C_MGR = ConfigurationManager() class ConfigBase(URLBase): """This is the base class for all supported configuration sources.""" # The Default Encoding to use if not otherwise detected encoding = "utf-8" # The default expected configuration format unless otherwise # detected by the sub-modules default_config_format = common.ConfigFormat.TEXT # This is only set if the user overrides the config format on the URL # this should always initialize itself as None config_format = None # Don't read any more of this amount of data into memory as there is no # reason we should be reading in more. This is more of a safe guard then # anything else. 128KB (131072B) max_buffer_size = 131072 # By default all configuration is not includable using the 'include' # line found in configuration files. allow_cross_includes = common.ContentIncludeMode.NEVER # the config path manages the handling of relative include config_path = os.getcwd() def __init__( self, cache: bool | int = True, recursion: int = 0, insecure_includes: bool = False, **kwargs: object, ) -> None: """Initialize behavior shared by all configuration plugins. ``cache=True`` retains parsed services after the first read. ``cache=False`` reads and parses the source whenever :meth:`services` is called, and a non-negative integer retains results for that many seconds. Reloading is especially significant for an ``http://`` or ``https://`` source because it performs another network request. ``recursion`` controls how many levels of ``include`` entries are followed. Zero ignores all includes; one reads sources included by this source; two also follows includes found in those child sources, and so on. A low limit protects against unexpectedly large or circular trees. Each configuration plugin declares an :class:`~apprise.common.ContentIncludeMode`. ``ALWAYS`` sources may be included normally, ``NEVER`` sources cannot be included, and ``STRICT`` sources may only be included by a compatible source type. For example, a local ``file://`` configuration can include another local file, but an ``http://`` configuration cannot include a local file. ``insecure_includes=True`` relaxes the ``STRICT`` compatibility check, effectively treating strict sources as always includable; it never overrides ``NEVER``. This is useful when trusted in-memory content must include a local file, but it should not be enabled for untrusted input. Additional keyword arguments are handled by :class:`URLBase`. The optional ``encoding`` and ``format`` values select the source encoding and force ``text`` or ``yaml`` parsing respectively. """ super().__init__(**kwargs) # Tracks the time the content was last retrieved on. This place a role # for cases where we are not caching our response and are required to # re-retrieve our settings. self._cached_time = None # Tracks previously loaded content for speed self._cached_services = None # Initialize our recursion value self.recursion = recursion # Initialize our insecure_includes flag self.insecure_includes = insecure_includes if "encoding" in kwargs: # Store the encoding self.encoding = kwargs.get("encoding") fmt = kwargs.get("format") if fmt: try: self.config_format = ( fmt if isinstance(fmt, common.ConfigFormat) else common.ConfigFormat(fmt.lower()) ) except (AttributeError, ValueError): err = f"An invalid config format ({fmt}) was specified." self.logger.warning(err) raise AppriseImproperlyConfigured(err) from None # Set our cache flag; it can be True or a (positive) integer try: self.cache = cache if isinstance(cache, bool) else int(cache) if self.cache < 0: err = f"A negative cache value ({cache}) was specified." self.logger.warning(err) raise AppriseImproperlyConfigured(err) except (ValueError, TypeError): err = f"An invalid cache value ({cache}) was specified." self.logger.warning(err) raise AppriseImproperlyConfigured(err) from None return def services( self, asset: AppriseAsset | None = None, **kwargs: object, ) -> list[plugins.NotifyBase]: """Read, parse, and return all services defined by this source. A valid cache is returned immediately. Otherwise :meth:`read` obtains the raw text, the selected text or YAML parser creates service plugins, and any permitted ``include`` entries are loaded recursively. Included services are appended to the direct services in the returned list. ``asset`` overrides the source's asset for newly parsed services and is propagated to included sources. A read failure or source with no usable content returns an empty list. The result becomes this object's mutable cache; methods such as ``len()``, iteration, indexing, and :meth:`pop` all operate on that same list. """ if not self.expired(): # We already have cached results to return; use them return self._cached_services # Our cached response object self._cached_services = [] # read() causes the child class to do whatever it takes for the # config plugin to load the data source and return unparsed content # None is returned if there was an error or simply no data content = self.read(**kwargs) if not isinstance(content, str): # Set the time our content was cached at self._cached_time = time.time() # Nothing more to do; return our empty cache list return self._cached_services # Our Configuration format uses a default if one wasn't one detected # or enfored. config_format = ( self.default_config_format if self.config_format is None else self.config_format ) # Dynamically load our parse_ function based on our config format fn = getattr(ConfigBase, f"config_parse_{config_format.value}") # Initialize our asset object asset = asset if isinstance(asset, AppriseAsset) else self.asset # Execute our config parse function which always returns a tuple # of our services and our configuration services, configs = fn(content=content, asset=asset) # Free memory del content # Add entry to our service list self._cached_services.extend(services) # Configuration files were detected; recursively populate them # If we have been configured to do so for url in configs: if self.recursion > 0: # Attempt to acquire the schema at the very least to allow # our configuration based urls. schema = GET_SCHEMA_RE.match(url) if schema is None: # Plan B is to assume we're dealing with a file schema = "file" if not os.path.isabs(url): # We're dealing with a relative path; prepend # our current config path url = os.path.join(self.config_path, url) url = f"{schema}://{URLBase.quote(url)}" else: # Ensure our schema is always in lower case schema = schema.group("schema").lower() # Some basic validation if schema not in C_MGR: ConfigBase.logger.error( f"Unsupported include schema {schema}." ) continue # CWE-312 (Secure Logging) Handling loggable_url = cwe312_loggable(url, asset.secure_logging) # Parse the included configuration URL into constructor args. results = C_MGR[schema].parse_url(url) if not results: # The included configuration URL could not be parsed. self.logger.error( f"Unparseable include URL {loggable_url}" ) continue # Handle cross inclusion based on allow_cross_includes rules if ( C_MGR[schema].allow_cross_includes == common.ContentIncludeMode.STRICT and schema not in self.schemas() and not self.insecure_includes ) or C_MGR[ schema ].allow_cross_includes == common.ContentIncludeMode.NEVER: # Prevent the loading if insecure base protocols ConfigBase.logger.warning( f"Including {schema}:// based configuration is" f" prohibited. Ignoring URL {loggable_url}" ) continue # Prepare our Asset Object results["asset"] = asset # No cache is required because we're just lumping this in # and associating it with the cache value we've already # declared (prior to our recursion) results["cache"] = False # Recursion can never be parsed from the URL; we decrement # it one level results["recursion"] = self.recursion - 1 # Insecure Includes flag can never be parsed from the URL results["insecure_includes"] = self.insecure_includes try: # Attempt to create an instance of our plugin using the # parsed URL information cfg_plugin = C_MGR[results["schema"]](**results) except Exception as e: # the arguments are invalid or can not be used. self.logger.error( f"Could not load include URL: {loggable_url}" ) self.logger.debug(f"Loading Exception: {e!s}") continue # Add services found in the included configuration. self._cached_services.extend(cfg_plugin.services(asset=asset)) else: # CWE-312 (Secure Logging) Handling loggable_url = cwe312_loggable(url, asset.secure_logging) self.logger.debug( "Recursion limit reached; ignoring Include URL: %s", loggable_url, ) if self._cached_services: self.logger.debug( f"Loaded {len(self._cached_services)} entries from" f" {self.url(privacy=asset.secure_logging)}" ) else: self.logger.warning( "Failed to load Apprise configuration from" f" {self.url(privacy=asset.secure_logging)}" ) # Set the time our content was cached at self._cached_time = time.time() return self._cached_services def read(self) -> str | None: """This object should be implimented by the child classes.""" return None def expired(self) -> bool: """Simply returns True if the configuration should be considered as expired or False if content should be retrieved.""" if isinstance(self._cached_services, list) and self.cache: # We have enough reason to look further into our cached content # and verify it has not expired. if self.cache is True: # we have not expired, return False return False # Verify our cache time to determine whether we will get our # content again. age_in_sec = time.time() - self._cached_time if age_in_sec <= self.cache: # We have not expired; return False return False # If we reach here our configuration should be considered # missing and/or expired. return True @staticmethod def __normalize_tag_groups(group_tags: dict[str, set[str]]) -> None: """ Used to normalize a tag assign map which looks like: { 'group': set('{tag1}', '{group1}', '{tag2}'), 'group1': set('{tag2}','{tag3}'), } Then normalized it (merging groups); with respect to the above, the output would be: { 'group': set('{tag1}', '{tag2}', '{tag3}), 'group1': set('{tag2}','{tag3}'), } """ # Prepare a key set list we can use tag_groups = {str(x) for x in group_tags} def _expand(tags, ignore=None): """Expands based on tag provided and returns a set. this also updates the group_tags while it goes """ # Prepare ourselves a return set results = set() ignore = set() if ignore is None else ignore # track groups groups = set() for tag in tags: if tag in ignore: continue # Track our groups groups.add(tag) # Store what we know is worth keeping if tag not in group_tags: # pragma: no cover # handle cases where the tag doesn't exist group_tags[tag] = set() results |= group_tags[tag] - tag_groups # Get simple tag assignments found = group_tags[tag] & tag_groups if not found: continue for gtag in found: if gtag in ignore: continue # Go deeper (recursion) ignore.add(tag) group_tags[gtag] = _expand({gtag}, ignore=ignore) results |= group_tags[gtag] # Pop ignore ignore.remove(tag) return results for tag in tag_groups: # Get our tags group_tags[tag] |= _expand({tag}) if not group_tags[tag]: ConfigBase.logger.warning( f"The group {tag} has no tags assigned to it" ) del group_tags[tag] @staticmethod def parse_url( url: str, verify_host: bool = True, ) -> dict[str, object] | None: """Parses the URL and returns it broken apart into a dictionary. This is very specific and customized for Apprise. Args: url (str): The URL you want to fully parse. verify_host (:obj:`bool`, optional): a flag kept with the parsed URL which some child classes will later use to verify SSL keys (if SSL transactions take place). Unless under very specific circumstances, it is strongly recomended that you leave this default value set to True. Returns: A dictionary is returned containing the URL fully parsed if successful, otherwise None is returned. """ results = URLBase.parse_url(url, verify_host=verify_host) if not results: # We're done; we failed to parse our url return results # Allow overriding the default config format if "format" in results["qsd"]: results["format"] = results["qsd"].get("format") if results["format"] not in common.CONFIG_FORMATS: URLBase.logger.warning( "Unsupported format specified {}".format(results["format"]) ) del results["format"] # Defines the encoding of the payload if "encoding" in results["qsd"]: results["encoding"] = results["qsd"].get("encoding") # Our cache value if "cache" in results["qsd"]: # First try to get it's integer value try: results["cache"] = int(results["qsd"]["cache"]) except (ValueError, TypeError): # No problem, it just isn't an integer; now treat it as a bool # instead: results["cache"] = parse_bool(results["qsd"]["cache"]) return results @staticmethod def detect_config_format( content: str, **kwargs: object, ) -> common.ConfigFormat | None: """Takes the specified content and attempts to detect the format type. The function returns the actual format type if detected, otherwise it returns None """ # Detect Format Logic: # - A pound/hashtag (#) is alawys a comment character so we skip over # lines matched here. # - Detection begins on the first non-comment and non blank line # matched. # - If we find a string followed by a colon, we know we're dealing # with a YAML file. # - If we find a string that starts with a URL, or our tag # definitions (accepting commas) followed by an equal sign we know # we're dealing with a TEXT format. # Define what a valid line should look like. # The tag group allows an optional "N:" priority prefix so that # "2:endpoint=ntfy://..." is recognised as TEXT format. # A tag group assignment such as "family=me,wife" carries tags instead # of a URL on the right hand side; it is TEXT format as well. valid_line_re = re.compile( r"^\s*(?P([;#]+(?P.*))|" r"(?P((?P[ \t,a-z0-9_:-]+)=)?[a-z0-9]+://.*)|" r"((?P[a-z0-9]+):.*)|" r"(?P[ \t,a-z0-9_:-]+=[a-z0-9, \t_-]+))?$", re.I, ) try: # split our content up to read line by line content = re.split(r"\r*\n", content) except TypeError: # content was not expected string type ConfigBase.logger.error("Invalid Apprise configuration specified.") return None # By default set our return value to None since we don't know # what the format is yet config_format = None # iterate over each line of the file to attempt to detect it # stop the moment a the type has been determined for line, entry in enumerate(content, start=1): result = valid_line_re.match(entry) if not result: # Invalid syntax ConfigBase.logger.error( "Undetectable Apprise configuration found " f"based on line {line}." ) # Take an early exit return None # Attempt to detect configuration if result.group("yaml"): config_format = common.ConfigFormat.YAML ConfigBase.logger.debug( f"Detected YAML configuration based on line {line}." ) break elif result.group("text") or result.group("assign"): config_format = common.ConfigFormat.TEXT ConfigBase.logger.debug( f"Detected TEXT configuration based on line {line}." ) break # If we reach here, we have a comment entry # Adjust default format to TEXT config_format = common.ConfigFormat.TEXT return config_format @staticmethod def config_parse( content: str, asset: AppriseAsset | None = None, config_format: str | common.ConfigFormat | None = None, **kwargs: object, ) -> tuple[list[object], list[str]]: """Takes the specified config content and loads it based on the specified config_format. If a format isn't specified, then it is auto detected. """ if config_format is None: # Detect the format config_format = ConfigBase.detect_config_format(content) if not config_format: # We couldn't detect configuration ConfigBase.logger.error("Could not detect configuration") return ([], []) try: config_format = ( config_format if isinstance(config_format, common.ConfigFormat) else common.ConfigFormat(config_format.lower()) ) except (AttributeError, ValueError): ConfigBase.logger.error( f"An invalid configuration format ({config_format}) was" " specified" ) return ([], []) # Dynamically load our parse_ function based on our config format fn = getattr(ConfigBase, f"config_parse_{config_format.value}") # Execute our config parse function which always returns a list return fn(content=content, asset=asset) @staticmethod def config_parse_text( content: str, asset: AppriseAsset | None = None, ) -> tuple[list[object], list[str]]: """Parse the specified content as though it were a simple text file only containing a list of URLs. Return a tuple that looks like (services, configs) where: - services contains a list of loaded notification plugins - configs contains a list of additional configuration files referenced. You may also optionally associate an asset with the notification. The file syntax is: # # pound/hashtag allow for line comments # # One or more tags can be idenified using comma's (,) to separate # them. = # Or you can use this format (no tags associated) # you can also use the keyword 'include' and identify a # configuration location (like this file) which will be included # as additional configuration entries when loaded. include # Assign tag contents to a group identifier = """ # A list of loaded Notification Services services = [] # A list of additional configuration files referenced using # the include keyword configs = [] # Track all of the tags we want to assign later on group_tags = {} # Track our entries to preload preloaded = [] # Prepare our Asset Object asset = asset if isinstance(asset, AppriseAsset) else AppriseAsset() # Define what a valid line should look like. # The tags group allows an optional leading "N:" priority prefix so # that entries like "2:endpoint=ntfy://..." are parsed correctly. valid_line_re = re.compile( r"^\s*(?P([;#]+(?P.*))|" r"(\s*(?P[a-z0-9, \t_:-]+)\s*=|=)?\s*" r"((?P[a-z0-9]{1,32}://.*)|(?P[a-z0-9, \t_-]+))|" r"include\s+(?P.+))?\s*$", re.I, ) try: # split our content up to read line by line content = re.split(r"\r*\n", content) except TypeError: # content was not expected string type ConfigBase.logger.error( "Invalid Apprise TEXT based configuration specified." ) return ([], []) for line, entry in enumerate(content, start=1): result = valid_line_re.match(entry) if not result: # Invalid syntax ConfigBase.logger.error( "Invalid Apprise TEXT configuration format found " f"{entry} on line {line}." ) # Assume this is a file we shouldn't be parsing. It's owner # can read the error printed to screen and take action # otherwise. return ([], []) # Retrieve our line url, assign, config = ( result.group("url"), result.group("assign"), result.group("config"), ) if not (url or config or assign): # Comment/empty line; do nothing continue if config: # CWE-312 (Secure Logging) Handling loggable_url = cwe312_loggable(config, asset.secure_logging) ConfigBase.logger.debug(f"Include URL: {loggable_url}") # Store our include line configs.append(config.strip()) continue # CWE-312 (Secure Logging) Handling loggable_url = cwe312_loggable(url, asset.secure_logging) if assign: groups = set(parse_list(result.group("tags"), cast=str)) if not groups: # no tags were assigned ConfigBase.logger.warning( "Unparseable tag assignment - no group(s) " f"on line {line}" ) continue # Get our tags tags = set(parse_list(assign, cast=str)) if not tags: # no tags were assigned ConfigBase.logger.warning( "Unparseable tag assignment - no tag(s) to assign " f"on line {line}" ) continue # Update our tag group map for tag_group in groups: if tag_group not in group_tags: group_tags[tag_group] = set() # ensure our tag group is never included in the assignment group_tags[tag_group] |= tags - {tag_group} continue # Acquire our url tokens results = plugins.url_to_dict( url, secure_logging=asset.secure_logging ) if results is None: # url_to_dict() already logged an error with the URL; # repeat at debug level with line number for context. ConfigBase.logger.debug( f"Unparseable URL {loggable_url} on line {line}." ) continue # Build a list of tags to associate with the newly added # notifications if any were set results["tag"] = set(parse_list(result.group("tags"), cast=str)) # A retry count on a service tag (e.g. "alerts:3=slack://...") is # not valid here: per-service retry belongs on the URL (?retry=N) # and call-time retry overrides belong on the notify() filter. if any( AppriseTag.parse(t).retry is not None for t in results["tag"] ): ConfigBase.logger.warning( "You can not specify a retry count as part of a service" f" tag on line {line}; use ?retry=N in the URL instead." ) continue # Set our Asset Object results["asset"] = asset # Store our preloaded entries preloaded.append( { "results": results, "line": line, "loggable_url": loggable_url, } ) # # Normalize Tag Groups # - Expand Groups of Groups so that they don't exist # ConfigBase.__normalize_tag_groups(group_tags) # # URL Processing # for entry in preloaded: # Point to our results entry for easier reference below results = entry["results"] # # Apply our tag groups if they're defined # for group, tags in group_tags.items(): # Detect if anything assigned to this tag also maps back to a # group. If so we want to add the group to our list if next( (True for tag in results["tag"] if tag in tags), False ): results["tag"].add(group) try: # Attempt to create an instance of our plugin using the # parsed URL information plugin = N_MGR[results["schema"]](**results) # Create log entry of loaded URL ConfigBase.logger.debug( "Loaded URL: %s", plugin.url(privacy=results["asset"].secure_logging), ) except Exception as e: # the arguments are invalid or can not be used. ConfigBase.logger.error( "Could not load URL {} on line {}.".format( entry["loggable_url"], entry["line"] ) ) ConfigBase.logger.debug(f"Loading Exception: {e!s}") continue # if we reach here, we successfully loaded our data services.append(plugin) # Return what was loaded return (services, configs) @staticmethod def config_parse_yaml( content: str, asset: AppriseAsset | None = None, ) -> tuple[list[object], list[str]]: """Parse the specified content as though it were a yaml file specifically formatted for Apprise. Return a tuple that looks like (services, configs) where: - services contains a list of loaded notification plugins - configs contains a list of additional configuration files referenced. You may optionally associate an asset with the notification. """ try: # PyYAML is only loaded once a YAML configuration is parsed. import yaml except ImportError: # Only possible when PyYAML was removed from the install. ConfigBase.logger.error( "YAML configuration requires the PyYAML package." ) return ([], []) # A list of loaded Notification Services services = [] # A list of additional configuration files referenced using # the include keyword configs = [] # Group Assignments group_tags = {} # Track our entries to preload preloaded = [] try: # Load our data safely. PyYAML keeps the last value when a mapping # repeats a key, matching Apprise's long-standing behavior. result = yaml.load(content, Loader=yaml.SafeLoader) except ( AttributeError, yaml.parser.ParserError, yaml.error.MarkedYAMLError, ) as e: # Invalid content ConfigBase.logger.error("Invalid Apprise YAML data specified.") ConfigBase.logger.debug(f"YAML Exception:{os.linesep}{e}") return ([], []) # The host decides whether this configuration may use templates. asset = asset if isinstance(asset, AppriseAsset) else AppriseAsset() ConfigBase.logger.debug( "Apprise YAML template variables are {}.".format( "enabled" if asset.allow_templates else "disabled" ) ) if not isinstance(result, dict): # Invalid content ConfigBase.logger.error( "Invalid Apprise YAML based configuration specified." ) return ([], []) # YAML Version version = result.get("version", 1) if version != 1: # Invalid syntax ConfigBase.logger.error( f"Invalid Apprise YAML version specified {version}." ) return ([], []) # # global asset object # # # template root directive # # Only declared variables are replaced; other ${...} text is literal. # template_schema = TemplateSchema() placeholders = None entries = None if asset.allow_templates: # Disabled templates leave the section and markers untouched. entries = result.get("template", None) if entries is not None: try: template_schema = TemplateSchema.parse(entries) except AppriseTemplateError as e: ConfigBase.logger.error( f"Invalid Apprise YAML template section. {e}" ) return ([], []) if template_schema: try: placeholders = TemplatePlaceholderMap( template_schema, content ) except AppriseTemplateError as e: ConfigBase.logger.error(str(e)) return ([], []) # Prepare our default timezone default_timezone = asset.tzinfo # Acquire our asset tokens tokens = result.get("asset", None) if tokens and isinstance(tokens, dict): raw_tz = tokens.get("timezone", tokens.get("tz")) if isinstance(raw_tz, str): default_timezone = zoneinfo(re.sub(r"[^\w/-]+", "", raw_tz)) if not default_timezone: ConfigBase.logger.warning( 'Ignored invalid timezone "%s"', raw_tz ) default_timezone = asset.tzinfo else: asset._tzinfo = default_timezone elif raw_tz is not None: ConfigBase.logger.warning( 'Ignored invalid timezone "%r"', raw_tz ) # A missing value leaves the language of the asset we were # given alone; it is not reset here. raw_lang = tokens.get("language", tokens.get("lang")) if isinstance(raw_lang, str) and raw_lang.strip(): language = AppriseLocale.normalize_language(raw_lang) if not language: ConfigBase.logger.warning( 'Ignored invalid language "%s"', raw_lang ) else: asset._language = language elif raw_lang is not None: # %r quotes a string on its own, so no quotes are added # around it here. ConfigBase.logger.warning( "Ignored invalid language %r", raw_lang ) # Iterate over remaining tokens for k, v in tokens.items(): if k in ("lang", "language", "timezone", "tz"): # These validated settings were already applied above. continue if k.startswith("_") or k.endswith("_"): # Entries are considered reserved if they start or end # with an underscore ConfigBase.logger.warning(f'Ignored asset key "{k}".') continue if not ( hasattr(asset, k) and isinstance(getattr(asset, k), (bool, str)) ): # We can't set a function or non-string set value ConfigBase.logger.warning(f'Invalid asset key "{k}".') continue if v is None: # Convert to an empty string v = "" if isinstance(v, (bool, str)) and isinstance( getattr(asset, k), bool ): # If the object in the Asset is a boolean, then # we want to convert the specified string to # match that. setattr(asset, k, parse_bool(v)) elif isinstance(v, str): # Set our asset object with the new value setattr(asset, k, v.strip()) else: # we must set strings with a string ConfigBase.logger.warning(f'Invalid asset value to "{k}".') continue # # global tag root directive # global_tags = set() tags = result.get("tag", result.get("tags", None)) if tags and isinstance(tags, (list, tuple, str)): # Store any preset tags global_tags = set(parse_list(tags, cast=str)) # # groups root directive # groups = result.get("groups", None) if isinstance(groups, dict): # # Dictionary # for groups_, tags in groups.items(): for group in parse_list(groups_, cast=str): if isinstance(tags, (list, tuple)): tags_ = set() for e in tags: if isinstance(e, dict): tags_ |= set(e.keys()) else: tags_ |= set(parse_list(e, cast=str)) # Final assignment tags = tags_ else: tags = set(parse_list(tags, cast=str)) if group not in group_tags: group_tags[group] = tags else: group_tags[group] |= tags elif isinstance(groups, (list, tuple)): # # List of Dictionaries # # Iterate over each group defined and store it for no, entry in enumerate(groups): if not isinstance(entry, dict): ConfigBase.logger.warning( f"No assignment for group {entry}, entry #{no + 1}" ) continue for groups_, tags in entry.items(): for group in parse_list(groups_, cast=str): if isinstance(tags, (list, tuple)): tags_ = set() for e in tags: if isinstance(e, dict): tags_ |= set(e.keys()) else: tags_ |= set(parse_list(e, cast=str)) # Final assignment tags = tags_ else: tags = set(parse_list(tags, cast=str)) if group not in group_tags: group_tags[group] = tags else: group_tags[group] |= tags # include root directive # includes = result.get("include", None) if isinstance(includes, str): # Support a single inline string or multiple ones separated by a # comma and/or space includes = parse_urls(includes) elif not isinstance(includes, (list, tuple)): # Not a problem; we simply have no includes includes = [] # Iterate over each config URL for _no, url in enumerate(includes): if isinstance(url, str): # Support a single inline string or multiple ones separated by # a comma and/or space configs.extend(parse_urls(url)) elif isinstance(url, dict): # Store the url and ignore arguments associated configs.extend(u for u in url) # # urls root directive # urls = result.get("urls", None) if not isinstance(urls, (list, tuple)): # Not a problem; we simply have no urls urls = [] # Explaining declaration mistakes requires walking every URL value. # Keep that optional work behind DEBUG even though an unused # declaration is emitted as a warning within a debugging session. explain = asset.allow_templates and ConfigBase.logger.isEnabledFor( logging.DEBUG ) if explain: # This is guidance only: undeclared ${NAME} text remains literal, # and unused declarations are valid. Inspect the already-parsed # URL values so helpful diagnostics do not require a custom YAML # loader or a second parse solely to recover source locations. referenced = template_references(urls) declared = set(template_schema.names) for name in sorted(referenced - declared): ConfigBase.logger.debug( "Template entry '{}' is not defined in the template" " section; it is kept as written.".format(name) ) for name in sorted(declared - referenced): ConfigBase.logger.warning( "Template entry '{}' is defined but not referenced by a" " service entry.".format(name) ) # Iterate over each URL for no, url in enumerate(urls): # Our results object is what we use to instantiate our object if # we can. Reset it to None on each iteration results = [] # CWE-312 (Secure Logging) Handling loggable_url = cwe312_loggable(url, asset.secure_logging) if isinstance(url, str): # We're just a simple URL string... if placeholders and template_in_schema( url, template_schema.names ): # The schema selects the temporary plugin parser before a # template value exists. Allowing it to vary would make the # same configuration change type at notification time. ConfigBase.logger.error( "Template variables are not permitted in URL schemas" " (YAML entry #{})".format(no + 1) ) continue if placeholders: url = placeholders.encode_url(url) schema = GET_SCHEMA_RE.match(url) if schema is None: # Log invalid entries so that maintainer of config # config file at least has something to take action # with. ConfigBase.logger.warning( f"Invalid URL {loggable_url}, entry #{no + 1}" ) continue # We found a valid schema worthy of tracking; store it's # details: results_ = plugins.url_to_dict( url, secure_logging=asset.secure_logging ) if results_ is None: if placeholders and placeholders.used(url): # Some services must validate this field while parsing. ConfigBase.logger.error( "A template variable can not be used at this" " position for {}://, entry #{}".format( schema.group("schema").lower(), no + 1 ) ) continue # url_to_dict() already logged an error with the URL; # repeat at debug level with entry number for context. ConfigBase.logger.debug( f"Unparseable URL {loggable_url}, entry #{no + 1}" ) continue # Parsing can succeed while silently dropping a marker. offender = dropped_template(url, results_, placeholders) if offender: # Do not keep a partially parsed template entry. ConfigBase.logger.error( "Template variable '{}' can not be used at this" " position for {}://, entry #{}".format( offender, schema.group("schema").lower(), no + 1 ) ) continue # A plain URL string has no settings written under it. results.append((results_, {}, {})) elif isinstance(url, dict): # We are a url string with additional unescaped options. In # this case we want to iterate over all of our options so we # can at least tell the end user what entries were ignored # due to errors it = iter(url.items()) # Track the URL to-load url_ = None # Keep the original key for matching sibling YAML settings. url_key = None # Track last acquired schema schema = None # Distinguish a forbidden variable schema from an ordinary # mapping that simply contains no recognizable URL key. invalid_schema = False for key, tokens_ in it: if ( placeholders and isinstance(key, str) and "://" in key and template_in_schema(key, template_schema.names) ): # Mapping-style URL keys obey the same fixed-schema # rule as plain URL strings. The quick separator check # only distinguishes URL-shaped keys from literal YAML # setting names. template_in_schema() locates the first # separator itself and rejects a declared marker only # when that marker occurs before it, so a later :// in # the path cannot bypass this check. ConfigBase.logger.error( "Template variables are not permitted in URL" " schemas (YAML entry #{})".format(no + 1) ) invalid_schema = True break encoded = ( placeholders.encode_url(key) if placeholders else key ) if not isinstance(encoded, str): # Non-text sibling settings cannot identify a URL. continue # Test our schema schema_ = GET_SCHEMA_RE.match(encoded) if schema_ is None: # Non-schema key -- may be a sibling token sitting # before the URL key in the YAML mapping. Sibling # tokens are collected later via url.items(), so # nothing is "ignored" here. Skip silently. continue # Store our schema schema = schema_.group("schema").lower() # Store our URL and Schema Regex url_ = encoded url_key = key # Update our token assignment tokens = tokens_ # We're done break if invalid_schema: continue if url_ is None: # the loop above failed to match anything ConfigBase.logger.warning( f"Unsupported URL, entry #{no + 1}" ) continue # Read sibling settings from the whole mapping, not just the # items that follow the URL key. YAML mapping order must not # affect the result. # # Settings are applied from highest to lowest priority: # 1. Child settings nested below the URL # 2. Sibling settings beside the URL # 3. Values parsed from the URL and its query string # # This lets both of the following YAML forms work: # # # sibling form (same indentation) # - mailtos://_: # smtp: smtp.example.com # from: no-reply@example.com # # # child form (indented one level deeper) # - mailtos://_: # smtp: smtp.example.com # from: no-reply@example.com sibling_tokens = { k: v for k, v in url.items() if k not in (url_key, "schema") } if placeholders: # Template YAML values, but keep setting names literal. try: sibling_tokens = placeholders.encode_obj( sibling_tokens ) tokens = placeholders.encode_obj(tokens) except AppriseTemplateError as e: ConfigBase.logger.error( "Could not prepare template values for entry" " #{}. {}".format(no + 1, e) ) continue results_ = plugins.url_to_dict( url_, secure_logging=asset.secure_logging ) if results_ is None: if placeholders and placeholders.used(url_): # Report placeholders rejected during URL parsing. ConfigBase.logger.error( "A template variable can not be used at this" " position for {}://, entry #{}".format( schema, no + 1 ) ) continue # Setup dictionary results_ = { # Minimum requirements "schema": schema, } else: # Check the parsed URL before applying YAML settings. offender = dropped_template(url_, results_, placeholders) if offender: # Settings underneath cannot repair a lost URL marker. ConfigBase.logger.error( "Template variable '{}' can not be used at this" " position for {}://, entry #{}".format( offender, schema, no + 1 ) ) continue if isinstance(tokens, (list, tuple, set)): # Keep YAML names before aliases are mapped (smtp to # smtp_host). Name and from can both feed from_addr, # so a listing must show which name was written. written_ = dict(sibling_tokens) if sibling_tokens else {} # Normalize shared sibling settings once before expanding # the list. Each entry then starts with the same mapped # values, such as smtp becoming smtp_host. if sibling_tokens and schema in N_MGR: sibling_tokens = ConfigBase._special_token_handler( schema, sibling_tokens ) # populate and/or override any results populated # by parse_url() for entries in tokens: # Copy ourselves a template of our parsed URL # as a base to work with r = results_.copy() # Apply sibling tokens as a shared base before # per-entry tokens (sibling < per-entry) if sibling_tokens: r.update(sibling_tokens) # We are a url string with additional options if isinstance(entries, dict): # Tags you just can't over-ride if "schema" in entries: del entries["schema"] # Add this entry's written names over shared ones. written_entry = dict(written_) written_entry.update(entries) # support our special tokens if schema in N_MGR: entries = ConfigBase._special_token_handler( schema, entries ) # Extend our dictionary with our new entries r.update(entries) # Keep every YAML contribution together so later # URL post-processing cannot overwrite it. Child # values are added last and therefore keep priority # over sibling values. yaml_ = {} if sibling_tokens: yaml_.update(sibling_tokens) yaml_.update(entries) # add our results to our global set results.append((r, yaml_, written_entry)) elif isinstance(tokens, dict): # The URL key selects the schema. A child setting must not # replace it, matching the list-expansion path above. tokens.pop("schema", None) # Record the names as written before any mapping. written_ = dict(sibling_tokens) if sibling_tokens else {} written_.update(tokens) # Normalize siblings and children separately before they # are merged. Otherwise a sibling alias such as smtp could # map onto smtp_host and replace an explicit child value. if schema in N_MGR: if sibling_tokens: sibling_tokens = ConfigBase._special_token_handler( schema, sibling_tokens ) tokens = ConfigBase._special_token_handler( schema, tokens ) # Merge from lowest to highest YAML priority: siblings # first, then the settings nested below the URL. if sibling_tokens: merged = sibling_tokens.copy() merged.update(tokens) tokens = merged # Copy ourselves a template of our parsed URL as # a base to work with r = results_.copy() # add our result set r.update(tokens) # add our results to our global set results.append((r, dict(tokens), written_)) elif sibling_tokens: # A URL with a null child can still receive settings from # sibling keys. Preserve their written names before aliases # and plugin-specific names are normalized. written_ = dict(sibling_tokens) if schema in N_MGR: sibling_tokens = ConfigBase._special_token_handler( schema, sibling_tokens ) # Copy ourselves a template of our parsed URL as # a base to work with r = results_.copy() # Apply the sibling token overrides r.update(sibling_tokens) # add our results to our global set results.append((r, dict(sibling_tokens), written_)) else: # add our results to our global set results.append((results_, {}, {})) else: # Unsupported ConfigBase.logger.warning( f"Unsupported Apprise YAML entry #{no + 1}" ) continue # Track our entries entry = 0 # Prepare our results for post-processing results = deque(results) while len(results): # Increment our entry count entry += 1 # Grab our first item results_, yaml_tokens_, written_tokens_ = results.popleft() if results_["schema"] not in N_MGR: # the arguments are invalid or can not be used. ConfigBase.logger.warning( "An invalid Apprise schema ({}) in YAML configuration " "entry #{}, item #{}".format( results_["schema"], no + 1, entry ) ) continue # tag is a special keyword that is managed by Apprise object. # The below ensures our tags are set correctly. # # Only a tags key written in the YAML is an alias of tag. A # ?tags= found on the URL belongs to the plugin that read it. yaml_tags = "tags" in yaml_tokens_ if "tag" in results_: # Tidy our list up results_["tag"] = ( set(parse_list(results_["tag"], cast=str)) | global_tags ) if yaml_tags: ConfigBase.logger.warning( ( "URL #{}: {} contains both 'tag' and 'tags' " "keyword" ).format(no + 1, url) ) del results_["tags"] elif yaml_tags: # Tidy our list up results_["tag"] = ( set(parse_list(results_["tags"], cast=str)) | global_tags ) # Should not carry forward del results_["tags"] else: # Just use the global settings results_["tag"] = global_tags if templated_tag(results_, placeholders): # Template values must not choose notification recipients. ConfigBase.logger.error( "Template variables are not permitted in tag/tags" " (YAML entry #{}, item #{})".format(no + 1, entry) ) continue # A retry count on a service tag is not valid here: per-service # retry belongs on the URL (retry: key) and call-time retry # overrides belong on the notify() filter. _retry_tags = [ t for t in results_["tag"] if AppriseTag.parse(t).retry is not None ] if _retry_tags: ConfigBase.logger.warning( "You can not specify a retry count as part of a" " service tag (YAML entry #{}, item #{}); use the" " 'retry:' key instead.".format(no + 1, entry) ) continue for key in list(results_.keys()): # Strip out any tokens we know that we can't accept and # warn the user match = ( VALID_TOKEN.match(key) if isinstance(key, str) else None ) if not match: ConfigBase.logger.warning( f"Ignoring invalid token ({key}) found in YAML " f"configuration entry #{no + 1}, item #{entry}" ) del results_[key] yaml_tokens_.pop(key, None) written_tokens_.pop(key, None) if ConfigBase.logger.isEnabledFor(logging.TRACE): ConfigBase.logger.trace( "URL #%d: %s unpacked as:%s%s", no + 1, url, os.linesep, os.linesep.join( [f'{k}="{a}"' for k, a in results_.items()] ), ) # Prepare our Asset Object results_["asset"] = asset # Full URL parsers have already applied the query string. Hide # qsd during their second normalization pass so those lower- # priority values cannot overwrite YAML settings. Minimal # @notify results keep qsd because they still need that pass. orig_qsd = results_.get("qsd") if all( k in results_ for k in QSD_FULL_MODE_KEYS ) and isinstance(orig_qsd, dict): # These extra fields reliably identify a full parse result. del results_["qsd"] # Handle post processing of result set results_ = URLBase.post_process_parse_url_results(results_) # Restore YAML's priority after either normalization path. # Special keys were already assembled and stay untouched. if yaml_tokens_: results_.update( { k: v for k, v in yaml_tokens_.items() if k not in YAML_REAPPLY_SKIP } ) # Keep the original query mapping available downstream. if orig_qsd is not None: results_["qsd"] = orig_qsd # Store our preloaded entries preloaded.append( { "results": results_, "settings": written_tokens_, "entry": no + 1, "item": entry, } ) # # Normalize Tag Groups # - Expand Groups of Groups so that they don't exist # ConfigBase.__normalize_tag_groups(group_tags) # # URL Processing # for entry in preloaded: # Point to our results entry for easier reference below results = entry["results"] # # Apply our tag groups if they're defined # for group, tags in group_tags.items(): # Detect if anything assigned to this tag also maps back to a # group. If so we want to add the group to our list if next( (True for tag in results["tag"] if tag in tags), False ): results["tag"].add(group) if placeholders: needed = placeholders.used(results) if not needed: # Restore any escaped but undeclared ${NAME} text. results = placeholders.substitute(results, {}) else: # Keep the entry pending until its values are available. services.append( NotifyTemplate( results=results, placeholders=placeholders, schema=template_schema, names=needed, settings=entry["settings"], asset=results.get("asset"), entry=entry["entry"], item=entry["item"], ) ) continue # Now we generate our plugin try: # Attempt to create an instance of our plugin using the # parsed URL information plugin = N_MGR[results["schema"]](**results) # Create log entry of loaded URL ConfigBase.logger.debug( "Loaded URL: %s", plugin.url(privacy=results["asset"].secure_logging), ) except Exception as e: # the arguments are invalid or can not be used. ConfigBase.logger.error( "Could not load Apprise YAML configuration " "entry #{}, item #{}".format(entry["entry"], entry["item"]) ) ConfigBase.logger.debug(f"Loading Exception: {e!s}") continue # if we reach here, we successfully loaded our data services.append(plugin) preloaded.clear() return (services, configs) def pop(self, index: int = -1) -> object: """Removes an indexed Notification Service from the stack and returns it. By default, the last element of the list is removed. """ if not isinstance(self._cached_services, list): # Generate ourselves a list of content we can pull from self.services() # Pop the element off of the stack return self._cached_services.pop(index) def clear_cache(self) -> None: """Cleans cache""" self._cached_services = None self._cached_time = None @staticmethod def _special_token_handler( schema: str, tokens: dict[str, object], ) -> dict[str, object]: """Normalize YAML keys before constructing a notification plugin. Applies common aliases, collects prefixed template values, and maps plugin argument or URL-token names to constructor arguments. """ # Create a copy of our dictionary tokens = tokens.copy() # Normalize common aliases such as `pass` before plugin-specific keys. # YAML input does not pass through the equivalent URL parsing step. for alias, canonical in URL_TOKEN_ALIASES.items(): if alias in tokens and ( canonical not in tokens or tokens[canonical] is None ): # Use the alias when the standard key is absent or null. tokens[canonical] = tokens.pop(alias) elif alias in tokens: # Keep the explicitly set standard key instead of its alias. del tokens[alias] for kw, meta in N_MGR[schema].template_kwargs.items(): # Determine our prefix: prefix = meta.get("prefix", "+") # Detect any matches matches = { k[1:]: str(v) for k, v in tokens.items() if isinstance(k, str) and k.startswith(prefix) } if not matches: # we're done with this entry continue if not isinstance(tokens.get(kw), dict): # Invalid; correct it tokens[kw] = {} # strip out processed tokens tokens = { k: v for k, v in tokens.items() if not isinstance(k, str) or not k.startswith(prefix) } # Update our entries tokens[kw].update(matches) # Map YAML keys through the templates defined by each service. For # example, an email recipient can be supplied as a YAML sub-key: # # urls: # - mailto://user:pass@domain: # - to: user1@hotmail.com # - to: user2@hotmail.com # # The email template maps `to` to the constructor's `targets` value. class_templates = plugins.details(N_MGR[schema]) for key in list(tokens.keys()): # Keys may match query arguments or named URL parts. Arguments # take priority when both templates define the same name. if key in class_templates["args"]: entry = class_templates["args"][key] elif key in class_templates["tokens"]: entry = class_templates["tokens"][key] else: # No need to handle non-arg entries continue # Prefer an alias, then fall back to a constructor mapping. map_to = entry.get("alias_of", entry.get("map_to", "")) if map_to == key: # We're already good as we are now continue if not isinstance(map_to, str): # Some URL shortcuts represent several values. Only the # plugin's URL parser can split them safely. ConfigBase.logger.warning( f"The {schema}:// {key} keyword can only be defined" " from within a URL; ignoring it." ) del tokens[key] continue # Use the destination's type details when available. meta = class_templates["tokens"].get( map_to, class_templates["args"].get(map_to) ) if not isinstance(meta, dict) or "type" not in meta: meta = entry # Untyped aliases pass their value through as a string. arg_type = meta.get("type", "string") # Remove the original key before adding its mapped value. value = tokens[key] del tokens[key] # Follow one additional mapping to the constructor argument. abs_map = meta.get("map_to", map_to) # List destinations collect repeated YAML values. is_list = re.search(r"^list:.*", arg_type, re.IGNORECASE) if abs_map not in tokens: tokens[abs_map] = [] if is_list else meta.get("default") elif is_list and not isinstance(tokens.get(abs_map), list): # Preserve an existing scalar before appending another value. tokens[abs_map] = [tokens[abs_map]] # Convert string fields supplied with another YAML scalar type. if re.search( r"^(choice:)?string", arg_type, re.IGNORECASE ) and not isinstance(value, str): value = str(value) # Store the value under its constructor argument name. if isinstance(tokens.get(abs_map), list): tokens[abs_map].append(value) else: tokens[abs_map] = value # Return our tokens return tokens def __getitem__(self, index: int) -> object: """Return the cached service at ``index``, loading it if necessary.""" if not isinstance(self._cached_services, list): # Generate ourselves a list of content we can pull from self.services() return self._cached_services[index] def __iter__(self) -> object: """Iterate over cached services, loading the source if necessary.""" if not isinstance(self._cached_services, list): # Generate ourselves a list of content we can pull from self.services() return iter(self._cached_services) def __len__(self) -> int: """Return the number of parsed services, loading when necessary. The configuration source itself is not counted. Services obtained from permitted nested includes are included in the total. """ if not isinstance(self._cached_services, list): # Generate ourselves a list of content we can pull from self.services() return len(self._cached_services) def __bool__(self) -> bool: """Allows the Apprise object to be wrapped in an 'if statement'. True is returned if our content was downloaded correctly. """ if not isinstance(self._cached_services, list): # Generate ourselves a list of content we can pull from self.services() return bool(self._cached_services) caronc-apprise-dfec414/apprise/config/file.py000066400000000000000000000137451526720371000213320ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. import os import re from ..common import ConfigFormat, ContentIncludeMode from ..locale import gettext_lazy as _ from ..utils.disk import path_decode from .base import ConfigBase class ConfigFile(ConfigBase): """A wrapper for File based configuration sources.""" # The default descriptive name associated with the service service_name = _("Local File") # The default protocol protocol = "file" # Configuration file inclusion can only be of the same type allow_cross_includes = ContentIncludeMode.STRICT def __init__(self, path, **kwargs): """Initialize File Object. headers can be a dictionary of key/value pairs that you want to additionally include as part of the server headers to post with """ super().__init__(**kwargs) # Store our file path as it was set self.path = path_decode(path) # Track the file as it was saved self.__original_path = os.path.normpath(path) # Update the config path to be relative to our file we just loaded self.config_path = os.path.dirname(self.path) return def url(self, privacy=False, *args, **kwargs): """Returns the URL built dynamically based on specified arguments.""" # Prepare our cache value if isinstance(self.cache, bool) or not self.cache: cache = "yes" if self.cache else "no" else: cache = int(self.cache) # Define any URL parameters params = { "encoding": self.encoding, "cache": cache, } if self.config_format: # A format was enforced; make sure it's passed back with the url params["format"] = self.config_format return "file://{path}{params}".format( path=self.quote(self.__original_path), params=f"?{self.urlencode(params)}" if params else "", ) def read(self, **kwargs): """Perform retrieval of the configuration based on the specified request.""" response = None try: if ( self.max_buffer_size > 0 and os.path.getsize(self.path) > self.max_buffer_size ): # Content exceeds maximum buffer size self.logger.error( "File size exceeds maximum allowable buffer length" f" ({int(self.max_buffer_size / 1024)}KB)." ) return None except OSError: # getsize() can throw this acception if the file is missing # and or simply isn't accessible self.logger.error(f"File is not accessible: {self.path}") return None # Always call throttle before any server i/o is made self.throttle() try: with open(self.path, encoding=self.encoding) as f: # Store our content for parsing response = f.read() except (ValueError, UnicodeDecodeError): # A result of our strict encoding check; if we receive this # then the file we're opening is not something we can # understand the encoding of.. self.logger.error( f"File not using expected encoding ({self.encoding}) :" f" {self.path}" ) return None except OSError: # IOError is present for backwards compatibility with Python # versions older then 3.3. >= 3.3 throw OSError now. # Could not open and/or read the file; this is not a problem since # we scan a lot of default paths. self.logger.error(f"File can not be opened for read: {self.path}") return None # Detect config format based on file extension if it isn't already # enforced if ( self.config_format is None and re.match(r"^.*\.ya?ml\s*$", self.path, re.I) is not None ): # YAML Filename Detected self.default_config_format = ConfigFormat.YAML # Return our response object return response @staticmethod def parse_url(url): """Parses the URL so that we can handle all different file paths and return it as our path object.""" results = ConfigBase.parse_url(url, verify_host=False) if not results: # We're done early; it's not a good URL return results match = re.match(r"[a-z0-9]+://(?P[^?]+)(\?.*)?", url, re.I) if not match: return None results["path"] = ConfigFile.unquote(match.group("path")) return results caronc-apprise-dfec414/apprise/config/http.py000066400000000000000000000242131526720371000213620ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. import re import requests from ..common import ConfigFormat, ContentIncludeMode from ..locale import gettext_lazy as _ from ..url import PrivacyMode from ..utils.parse import URL_ENCODED_PATH_SAFE_CHARS from .base import ConfigBase # Support YAML formats # text/yaml # text/x-yaml # application/yaml # application/x-yaml MIME_IS_YAML = re.compile(r"(text|application)/(x-)?yaml", re.I) # Support TEXT formats # text/plain # text/html MIME_IS_TEXT = re.compile(r"text/(plain|html)", re.I) class ConfigHTTP(ConfigBase): """A wrapper for HTTP based configuration sources.""" # The default descriptive name associated with the service service_name = _("Web Based") # The default protocol protocol = "http" # The default secure protocol secure_protocol = "https" # If an HTTP error occurs, define the number of characters you still want # to read back. This is useful for debugging purposes, but nothing else. # The idea behind enforcing this kind of restriction is to prevent abuse # from queries to services that may be untrusted. max_error_buffer_size = 2048 # Configuration file inclusion can always include this type allow_cross_includes = ContentIncludeMode.ALWAYS def __init__(self, headers=None, **kwargs): """Initialize HTTP Object. headers can be a dictionary of key/value pairs that you want to additionally include as part of the server headers to post with """ super().__init__(**kwargs) self.schema = "https" if self.secure else "http" self.fullpath = kwargs.get("fullpath") if not isinstance(self.fullpath, str): self.fullpath = "/" self.headers = {} if headers: # Store our extra headers self.headers.update(headers) return def url(self, privacy=False, *args, **kwargs): """Returns the URL built dynamically based on specified arguments.""" # Prepare our cache value if isinstance(self.cache, bool) or not self.cache: cache = "yes" if self.cache else "no" else: cache = int(self.cache) # Define any arguments set params = { "encoding": self.encoding, "cache": cache, } # Extend our parameters params.update(self.url_parameters(privacy=privacy, *args, **kwargs)) if self.config_format: # A format was enforced; make sure it's passed back with the url params["format"] = self.config_format # Append our headers into our args params.update({f"+{k}": v for k, v in self.headers.items()}) # Determine Authentication auth = "" if self.password: auth = "{user}:{password}@".format( user=self.quote(self.user or "", safe=""), password=self.pprint( self.password, privacy, mode=PrivacyMode.Secret, safe="" ), ) elif self.user: auth = "{user}@".format( user=self.quote(self.user, safe=""), ) default_port = 443 if self.secure else 80 return "{schema}://{auth}{hostname}{port}{fullpath}/?{params}".format( schema=self.secure_protocol if self.secure else self.protocol, auth=auth, hostname=self.quote(self.host, safe=""), port=( "" if self.port is None or self.port == default_port else f":{self.port}" ), fullpath=self.quote( self.fullpath, safe=URL_ENCODED_PATH_SAFE_CHARS ), params=self.urlencode(params), ) def read(self, **kwargs): """Perform retrieval of the configuration based on the specified request.""" # prepare XML Object headers = { "User-Agent": self.app_id, } # Apply any/all header over-rides defined headers.update(self.headers) auth = None if self.user or self.password: # Basic Auth also permits a password with an empty username. auth = (self.user or "", self.password) url = f"{self.schema}://{self.host}" if isinstance(self.port, int): url += f":{self.port}" url += self.fullpath self.logger.debug( f"HTTP POST URL: {url} (cert_verify={self.verify_certificate!r})" ) # Prepare our response object response = None # Where our request object will temporarily live. r = None # Always call throttle before any remote server i/o is made self.throttle() try: # Make our request with requests.post( url, headers=headers, auth=auth, verify=self.verify_certificate, timeout=self.request_timeout, allow_redirects=self.redirects, stream=True, ) as r: # Handle Errors r.raise_for_status() # raise_for_status() only covers 4xx/5xx; when redirect # following is disabled any 3xx must be treated as a failure # so we do not silently return a redirect stub as config. # Using a status-code range rather than r.is_redirect # catches 3xx responses that lack a Location header. if not self.redirects and 300 <= r.status_code < 400: self.logger.error( "HTTP redirect encountered but redirect " "following is disabled:" f" {self.url(privacy=True)}" ) return None # Get our file-size (if known) try: file_size = int(r.headers.get("Content-Length", "0")) except (TypeError, ValueError): # Handle edge case where Content-Length is a bad value file_size = 0 # Store our response if ( self.max_buffer_size > 0 and file_size > self.max_buffer_size ): # Provide warning of data truncation self.logger.error( "HTTP config response exceeds maximum buffer length " f"({int(self.max_buffer_size / 1024)}KB);" ) # Return None - buffer execeeded return None # Store our result (but no more than our buffer length) response = r.text[: self.max_buffer_size + 1] # Verify that our content did not exceed the buffer size: if len(response) > self.max_buffer_size: # Provide warning of data truncation self.logger.error( "HTTP config response exceeds maximum buffer length " f"({int(self.max_buffer_size / 1024)}KB);" ) # Return None - buffer execeeded return None # Detect config format based on mime if the format isn't # already enforced content_type = r.headers.get( "Content-Type", "application/octet-stream" ) if self.config_format is None and content_type: if MIME_IS_YAML.match(content_type) is not None: # YAML data detected based on header content self.default_config_format = ConfigFormat.YAML elif MIME_IS_TEXT.match(content_type) is not None: # TEXT data detected based on header content self.default_config_format = ConfigFormat.TEXT except requests.RequestException as e: self.logger.error( "A Connection error occurred retrieving HTTP " f"configuration from {self.host}." ) self.logger.debug(f"Socket Exception: {e!s}") # Return None (signifying a failure) return None # Return our response object return response @staticmethod def parse_url(url): """Parses the URL and returns enough arguments that can allow us to re- instantiate this object.""" results = ConfigBase.parse_url(url) if not results: # We're done early as we couldn't load the results return results # Add our headers that the user can potentially over-ride if they wish # to to our returned result set results["headers"] = results["qsd-"] results["headers"].update(results["qsd+"]) return results caronc-apprise-dfec414/apprise/config/memory.py000066400000000000000000000052551526720371000217200ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from ..locale import gettext_lazy as _ from .base import ConfigBase class ConfigMemory(ConfigBase): """For information that was loaded from memory and does not persist anywhere.""" # The default descriptive name associated with the service service_name = _("Memory") # The default protocol protocol = "memory" def __init__(self, content, **kwargs): """Initialize Memory Object. Memory objects just store the raw configuration in memory. There is no external reference point. It's always considered cached. """ super().__init__(**kwargs) # Store our raw config into memory self.content = content if self.config_format is None: # Detect our format if possible self.config_format = ConfigMemory.detect_config_format( self.content ) return def url(self, privacy=False, *args, **kwargs): """Returns the URL built dynamically based on specified arguments.""" return "memory://" def read(self, **kwargs): """Simply return content stored into memory.""" return self.content @staticmethod def parse_url(url): """Memory objects have no parseable URL.""" # These URLs can not be parsed return None caronc-apprise-dfec414/apprise/conversion/000077500000000000000000000000001526720371000207475ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/conversion/__init__.py000066400000000000000000000075141526720371000230670ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Conversion is split by format, HTML, CommonMark repair, and dialect fitting. # Supported helpers are re-exported from ``apprise.conversion``. from .commonmark import ( commonmark_can_close_emphasis, commonmark_can_open_emphasis, commonmark_decode_backslash_escapes, commonmark_emphasis_run, commonmark_escape_link_url, commonmark_find_backtick_run, commonmark_headings_to_bold, commonmark_index_backtick_runs, commonmark_lookahead_closer_widths, commonmark_match_emphasis, commonmark_materialize_repair, commonmark_new_scan_budget, commonmark_pick_emphasis_sentinel, commonmark_render_emphasis_events, commonmark_render_emphasis_markers, commonmark_repair_chunk, commonmark_scan_angle_dest, commonmark_scan_autolink_dest, commonmark_scan_closer_runs, commonmark_scan_delimiter_run, commonmark_scan_paren_dest, commonmark_scan_repair_region, commonmark_sections, ) from .dialect import split_dialect_chunk, truncate_dialect_chunk from .format import ( convert_between, html_to_markdown, html_to_text, markdown_to_html, text_to_html, text_to_markdown, ) from .html import ( BLOCKQUOTE_DEPTH_MAX, LIST_DEPTH_MAX, MAX_FRAME_DEPTH, HTMLConverter, HTMLMarkdownConverter, HTMLTagReducer, ) __all__ = [ "BLOCKQUOTE_DEPTH_MAX", "LIST_DEPTH_MAX", "MAX_FRAME_DEPTH", "HTMLConverter", "HTMLMarkdownConverter", "HTMLTagReducer", "commonmark_can_close_emphasis", "commonmark_can_open_emphasis", "commonmark_decode_backslash_escapes", "commonmark_emphasis_run", "commonmark_escape_link_url", "commonmark_find_backtick_run", "commonmark_headings_to_bold", "commonmark_index_backtick_runs", "commonmark_lookahead_closer_widths", "commonmark_match_emphasis", "commonmark_materialize_repair", "commonmark_new_scan_budget", "commonmark_pick_emphasis_sentinel", "commonmark_render_emphasis_events", "commonmark_render_emphasis_markers", "commonmark_repair_chunk", "commonmark_scan_angle_dest", "commonmark_scan_autolink_dest", "commonmark_scan_closer_runs", "commonmark_scan_delimiter_run", "commonmark_scan_paren_dest", "commonmark_scan_repair_region", "commonmark_sections", "convert_between", "html_to_markdown", "html_to_text", "markdown_to_html", "split_dialect_chunk", "text_to_html", "text_to_markdown", "truncate_dialect_chunk", ] caronc-apprise-dfec414/apprise/conversion/commonmark.py000066400000000000000000003014331526720371000234700ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Scan and repair CommonMark before plugins translate it to service dialects. from bisect import bisect_left, bisect_right from functools import lru_cache import re import unicodedata from ..common import NotifyFormat from ..utils.format import smart_split # Keep related constants together and define dependent patterns afterward. # CommonMark ASCII punctuation; Unicode categories cover other characters. _CM_ASCII_PUNCTUATION = "!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~" # CommonMark expands tabs to the next four-column stop in block indentation. _TAB_SIZE = 4 # Preserve list and blockquote markers from Apprise's HTML converter. # Quote spacing applies only when followed by ">". _QUOTE_UNIT = r"(?: {0,3}>[ \t]?)" # Match a list marker and its leading indentation; padding is measured later. _LIST_MARKER_CHAR_RE = re.compile(r"^ {0,3}(?:[-*+]|[0-9]{1,9}[.)])") # Match a fence of at least three backticks or tildes and its info string. # Backtick fence info cannot contain another backtick. _FENCE_SHAPE_RE = re.compile(r"^(?:(`{3,})[^\n`]*|(~{3,})[^\n]*)$") # Match a heading with up to three leading spaces and one to six "#". # A heading marker must be followed by whitespace or the end of the line. _ATX_HEADING_START_RE = re.compile(r"^ {0,3}#{1,6}(?:[ \t]|$)") # Match a blockquote using the shared quote-prefix pattern. _QUOTE_START_RE = re.compile(r"^" + _QUOTE_UNIT) # A thematic break: three or more of the same character among -, _, *, # optionally separated by spaces or tabs, with 0-3 leading spaces. _THEMATIC_BREAK_RE = re.compile( r"^ {0,3}(?:-[ \t]*){3,}$" r"|^ {0,3}(?:_[ \t]*){3,}$" r"|^ {0,3}(?:\*[ \t]*){3,}$" ) # A setext underline turns the open paragraph above it into a heading. _SETEXT_UNDERLINE_RE = re.compile(r"^ {0,3}(?:=+|-+)[ \t]*$") # These HTML block tags interrupt a CommonMark paragraph. _HTML_BLOCK_TAGS = ( "address|article|aside|base|basefont|blockquote|body|caption|" "center|col|colgroup|dd|details|dialog|dir|div|dl|dt|fieldset|" "figcaption|figure|footer|form|frame|frameset|h[1-6]|head|header|" "hr|html|iframe|legend|li|link|main|menu|menuitem|nav|noframes|" "ol|optgroup|option|p|param|pre|script|section|source|style|" "summary|table|tbody|td|textarea|tfoot|th|thead|title|tr|track|ul" ) # Raw HTML blocks close at a matching raw-tag end rather than a blank line. _HTML_RAW_TAGS = frozenset(("script", "pre", "style", "textarea")) # Any complete raw-tag closer ends the block, even if its name differs from # the opener. Partial closing tags do not count. _HTML_RAW_TAG_CLOSE_RE = re.compile( r"", re.IGNORECASE ) # Named groups identify each HTML block's closing rule. _HTML_BLOCK_START_RE = re.compile( r"^ {0,3}(?:" r"(?P", search_from, limit) elif m.group("pi"): terminator = text.find("?>", search_from, limit) elif m.group("decl"): terminator = text.find(">", search_from, limit) elif m.group("cdata"): terminator = text.find("]]>", search_from, limit) else: # Per spec, any of the four raw tags' exact closing form ends # the block -- not only the one that opened it -- while a # partial form such as " 3: pos = line_end + 1 continue slack_end_pos = prefix_end_pos + _chars_for_width( line[prefix_end_pos:], slack_width, prefix_end_col ) rest = line[slack_end_pos:] rest_col = prefix_end_col + slack_width fence_open = _match_fence_open(rest, rest_col) if fence_open: fence_char, fence_len = fence_open start = pos # Find the closer or the boundary of an unfinished nested fence. end = _find_fence_end( text, line_end + 1, quote_depth, list_width, fence_char, fence_len, ) spans.append((start, end, "fence")) paragraph_open = False pos = end continue html_m = _match_html_block_start(rest) if html_m: start = pos end = _commonmark_html_block_end( text, pos + slack_end_pos, line_end, html_m, quote_depth, list_width, ) spans.append((start, end, "html")) paragraph_open = False pos = end continue if not paragraph_open and _HTML_CUSTOM_TAG_RE.match(rest): # Type 7 closes at the next blank line, the same as type 6 -- # and cannot outlive its own quote/list container either. start = pos end = _blank_line_end(text, line_end + 1, quote_depth, list_width) spans.append((start, end, "html")) paragraph_open = False pos = end continue if paragraph_open and _SETEXT_UNDERLINE_RE.match(rest): # The underline turns the open paragraph into a heading. paragraph_open = False elif paragraph_open: # The list marker was removed from ``rest``; a non-empty marker # or another block start interrupts the open paragraph. has_nonempty_marker = bool(marker_width) and bool(rest.strip()) paragraph_open = not ( has_nonempty_marker or _looks_like_new_block(rest) ) else: # Ordinary non-empty text starts a paragraph. A bare list or # quote marker does not. paragraph_open = bool(rest) and not _looks_like_new_block(rest) pos = line_end + 1 return spans def _commonmark_fenced_code_spans(text): """Find backtick and tilde fenced code blocks as ``(start, end)`` offsets. A thin filter over ``_commonmark_leaf_block_spans()`` -- see that function for why fences and HTML blocks must be resolved together in one pass rather than independently. """ return [ (start, end) for start, end, kind in _commonmark_leaf_block_spans(text) if kind == "fence" ] def _commonmark_html_block_spans(text): """Find CommonMark HTML block ranges as ``(start, end)`` offsets. This filters types 1-7 from the shared fence and HTML scan. """ return [ (start, end) for start, end, kind in _commonmark_leaf_block_spans(text) if kind == "html" ] def commonmark_headings_to_bold(body): """Turn ``# Heading`` lines into bold text. - For services that have bold but no headings. - Code blocks, code spans, and HTML are left alone. - List and quote prefixes such as ``> `` are kept. Example: ``"# Alert"`` becomes ``"**Alert**"``. """ # Find fenced code and HTML blocks together to avoid a duplicate scan. protected = sorted( _commonmark_code_spans(body) + [ (start, end) for start, end, _ in _commonmark_leaf_block_spans(body) ] ) # Both inputs are ordered, so one forward cursor avoids rescanning. span_idx = 0 # Create the scanner only when the first ambiguous heading needs it. container_scanner = None out = [] pos = 0 n = len(body) while pos < n: line_end = body.find("\n", pos) line_end = line_end if line_end != -1 else n raw_line = body[pos:line_end] line = _strip_cr(raw_line) # Skip past any protected region that ends at or before this line. while span_idx < len(protected) and protected[span_idx][1] <= pos: span_idx += 1 in_protected = ( span_idx < len(protected) and protected[span_idx][0] <= pos ) replacement = None if not in_protected: ( quote_depth, quote_end_col, marker_width, prefix_end_pos, prefix_end_col, ) = _scan_opening_prefix(line) slack_width = _leading_width(line[prefix_end_pos:], prefix_end_col) ( _, _, extra_slack, container_scanner, ) = _resolve_prefix_widths( body, pos, quote_depth, quote_end_col, marker_width, slack_width, container_scanner, ) # More than three columns after a list or quote is indented # code, not a heading. if extra_slack <= 3: slack_end_pos = prefix_end_pos + _chars_for_width( line[prefix_end_pos:], slack_width, prefix_end_col ) heading_m = _ATX_HEADING_SHAPE_RE.match(line[slack_end_pos:]) if heading_m: heading = heading_m.group("content") or "" # Strip a trailing closing sequence like " ##" before # trimming ordinary whitespace, so "## Alert ##" # becomes "Alert", not "Alert ##". heading = _ATX_CLOSING_SEQUENCE_RE.sub("", heading).strip() prefix = line[:slack_end_pos] replacement = ( f"{prefix}**{heading}**" if heading else prefix ) # A trailing "\r" (if any) is not restored on a converted heading, # matching CommonMark's own line-ending-agnostic ATX heading rule. out.append(replacement if replacement is not None else raw_line) if line_end < n: out.append("\n") pos = line_end + 1 return "".join(out) def commonmark_decode_backslash_escapes(text): r"""Remove the backslash from escaped punctuation. - Use it on text that is not Markdown, such as a link URL or label. - Only punctuation that CommonMark allows to be escaped is changed, so Windows paths keep their backslashes. Example: ``r"a\_b"`` becomes ``"a_b"``, but ``r"C:\Users"`` stays the same. """ out = [] # Scan the text without allocating intermediate match objects. i = 0 n = len(text) while i < n: ch = text[i] if ch == "\\" and i + 1 < n and text[i + 1] in _CM_ASCII_PUNCTUATION: # Discard the backslash and keep only the escaped character. out.append(text[i + 1]) i += 2 continue out.append(ch) i += 1 return "".join(out) def commonmark_escape_link_url(url): r"""Make a Markdown link URL safe inside a ```` style link. - Removes Markdown backslash escapes. - ``&``, ``<`` and ``>`` become HTML entities. - ``|`` becomes ``%7C`` so it is not read as the label separator. Example: ``r"a\|b&c"`` becomes ``"a%7Cb&c"``. """ # Step 1: strip CommonMark backslash escapes so we recover the raw URL # characters before re-applying any encoding the target dialect needs. url = commonmark_decode_backslash_escapes(url) # Step 2: re-encode the characters that the delimiter syntax # would mis-parse if left bare in the URL string. # "&" must come first to avoid double-encoding the entities below. url = url.replace("&", "&").replace("<", "<") url = url.replace(">", ">") # "|" is the separator between the URL and label inside ; # percent-encode it so it cannot be mistaken for the delimiter. return url.replace("|", "%7C") def commonmark_new_scan_budget(body): """Create a work limit shared by the link scanners for one message. - Pass the result as ``budget`` to ``commonmark_scan_angle_dest()`` and ``commonmark_scan_paren_dest()``. - Each scan uses up some of it. Once it is gone, scans only look a short distance ahead, so a message full of broken links cannot make scanning slow. Example: ``commonmark_new_scan_budget("abc")`` returns ``[12]``. """ return [len(body) * SCAN_BUDGET_MULTIPLIER] def commonmark_scan_angle_dest(body, i, n, budget=None): r"""Find where a ``]()`` link ends. - ``i`` is the index of the ``]``. - Returns the index of the closing ``>``, or ``None`` if not found. - Escaped characters such as ``\>`` are skipped. - ``budget`` is optional (see ``commonmark_new_scan_budget()``). Example: in ``"[x]()"``, ``i=2`` returns ``14``. """ # Start immediately after the opening ``](<`` sequence. start = i + 3 k = start # After the shared budget is spent, allow a small local scan. Include room # for ``>)`` so a URL at the fallback length can still close. limit = ( n if budget is None or budget[0] > 0 else min(n, start + MIN_SCAN_ALLOWANCE + 2) ) # Scan until a complete two-character terminator can no longer fit. while k < limit - 1: if body[k] == "\\" and k + 1 < n: # Skip escape sequences -- they cannot be the terminator. k += 2 continue if body[k] == ">" and body[k + 1] == ")": if budget is not None: budget[0] -= k - start return k k += 1 if budget is not None: budget[0] -= k - start return None def commonmark_scan_paren_dest(text, i, n, budget=None): """Find where a ``](url)`` link ends. - ``i`` is the index of the ``(``. - Returns the index of the matching ``)``, or ``None`` if the URL is not valid (for example, it contains a space or ``<``). - Balanced brackets inside the URL are allowed. - ``budget`` is optional (see ``commonmark_new_scan_budget()``). Example: in ``"[x](a_(b))"``, ``i=3`` returns ``9``. """ depth = 1 start = i + 1 k = start # After the budget is spent, leave room for a nearby closing ``)``. limit = ( n if budget is None or budget[0] > 0 else min(n, start + MIN_SCAN_ALLOWANCE + 1) ) while k < limit: ch = text[k] if ch == "\\" and k + 1 < n: k += 2 continue if ch == "(": depth += 1 elif ch == ")": depth -= 1 if depth == 0: if budget is not None: budget[0] -= k - start return k else: is_control = ord(ch) < 0x20 or ord(ch) == 0x7F if ch == "<" or is_control or _cm_is_whitespace(ch): if budget is not None: budget[0] -= k - start return None k += 1 if budget is not None: budget[0] -= k - start return None def commonmark_scan_autolink_dest(text, i, n): """Check whether ```` at ``i`` is an autolink. - ``i`` is the index of the ``<``. - Returns ``(end, still_valid)``: - ``end`` is the index of the closing ``>``, or ``None``. - ``still_valid`` is ``False`` once a space or other character that is not allowed is seen. It stays ``True`` if the text simply ends first. Examples: - ``""`` returns ``(12, True)``. - ``""`` returns ``(None, False)``. """ match = _AUTOLINK_SCHEME_RE.match(text, i + 1) if not match: return None, False k = match.end() while k < n: ch = text[k] if ch == ">": return k, True # A nested "<", a control character, or whitespace rules out a # genuine autolink -- CommonMark allows none of these in its # destination. is_control = ord(ch) < 0x20 or ord(ch) == 0x7F if ch == "<" or is_control or _cm_is_whitespace(ch): return None, False k += 1 # Ran out of text before finding a terminator or a disqualifier. return None, True # Unicode's Private Use areas, where placeholder characters are taken from _PRIVATE_USE_RANGES = ( (0xE000, 0xF8FF), (0xF0000, 0xFFFFD), (0x100000, 0x10FFFD), ) # The total number of Private Use characters _PRIVATE_USE_TOTAL = sum(end - start + 1 for start, end in _PRIVATE_USE_RANGES) # One Private Use character, in any of the areas above _PRIVATE_USE_CLASS = "".join( f"{chr(start)}-{chr(end)}" for start, end in _PRIVATE_USE_RANGES ) _PRIVATE_USE_RE = re.compile(f"[{_PRIVATE_USE_CLASS}]") # A run of anything that is not a Private Use character _NON_PRIVATE_USE_RE = re.compile(f"[^{_PRIVATE_USE_CLASS}]+") def _private_use_chars(): """Yield every Private Use character, in slot order.""" for start, end in _PRIVATE_USE_RANGES: yield from map(chr, range(start, end + 1)) def commonmark_pick_emphasis_sentinel(body): r"""Pick a marker character that does not appear anywhere in ``body``. - Converters temporarily swap ``*`` and ``_`` runs for numbered placeholders like ``S0S``, ``S1S`` (``S`` is the marker). Once they know which runs pair up, the placeholders are replaced with the service's bold or italic syntax. - The marker must not already be in the message, or user text could be mistaken for a placeholder. - It is taken from Unicode's Private Use area, which normal text almost never uses. Usually this is ``"\ue000"``. - If the message already uses every Private Use character, a two-character marker is returned instead. Examples: - ``commonmark_pick_emphasis_sentinel("hi *there*")`` returns ``"\ue000"``. - ``commonmark_pick_emphasis_sentinel("x\ue000")`` returns ``"\ue001"``. """ if not _PRIVATE_USE_RE.search(body): # Most messages use no Private Use characters at all return chr(_PRIVATE_USE_RANGES[0][0]) # Keep only the Private Use characters; a bounded set of them is all # that is needed to see which are in use private = _NON_PRIVATE_USE_RE.sub("", body) present = set(private) for char in _private_use_chars(): if char not in present: # The first Private Use character the message does not use return char # Every one is taken, so pair one with a character that never follows # it. A character used k times has at most k different followers, so # one used fewer times than there are Private Use characters always # has a free partner; only a few need counting to find one. first = next( char for char in _private_use_chars() if private.count(char) < _PRIVATE_USE_TOTAL - 1 ) follows = re.compile(re.escape(first) + f"(?=([{_PRIVATE_USE_CLASS}]))") taken = {match.group(1) for match in follows.finditer(body)} # A pair is always two different characters taken.add(first) return first + next( char for char in _private_use_chars() if char not in taken ) def _commonmark_emphasis_marker_pattern(sentinel): """Match sentinel-wrapped indexes in the accompanying delimiter list.""" escaped = re.escape(sentinel) return re.compile(escaped + r"(\d+)" + escaped) def commonmark_emphasis_run(body, i, n, delimiters, out, sentinel): """Swap the ``*`` or ``_`` run at ``i`` for a numbered placeholder. - Adds a description of the run to ``delimiters`` (its character, length, and whether it can open or close emphasis). - Appends ``sentinel + index + sentinel`` to ``out``. - Returns the index just past the run. - Call ``commonmark_render_emphasis_markers()`` when done. Example: for ``"**bold**"`` at ``i=0`` with ``sentinel="S"``, ``out`` gets ``"S0S"`` and ``2`` is returned. """ ch = body[i] # Measure the full delimiter run starting at i. j = i while j < n and body[j] == ch: j += 1 prev_ch = body[i - 1] if i > 0 else None next_ch = body[j] if j < n else None delimiters.append( { "char": ch, "numdelims": j - i, "origdelims": j - i, "can_open": commonmark_can_open_emphasis(ch, prev_ch, next_ch), "can_close": commonmark_can_close_emphasis(ch, prev_ch, next_ch), "events": [], } ) index = len(delimiters) - 1 out.append(f"{sentinel}{index}{sentinel}") # Return the position right after the full delimiter run. return j def commonmark_render_emphasis_events(events, strong_markers, regular_markers): """Build the markers to output for one ``*`` or ``_`` run. - ``events`` is the run's list of ``("open" | "close", is_strong)``. - Returns ``(close_part, open_part)``. Closing markers come first. Example: ``[("open", True)]`` with strong markers ``("", "")`` returns ``("", "")``. """ close_part = "".join( (strong_markers[1] if is_strong else regular_markers[1]) for kind, is_strong in events if kind == "close" ) # Open markers nest around content collected after them, so the # outermost open (the first one recorded) must render last. open_part = "".join( (strong_markers[0] if is_strong else regular_markers[0]) for kind, is_strong in reversed(events) if kind == "open" ) return close_part, open_part def commonmark_render_emphasis_markers( text, delimiters, strong_markers, regular_markers, sentinel ): """Replace the placeholders with the service's bold and italic markers. - ``text`` and ``delimiters`` come from ``commonmark_emphasis_run()``. - ``strong_markers`` and ``regular_markers`` are ``(open, close)`` pairs. - A run with no partner is put back as its original ``*`` or ``_``. Example: ``"**hi** and *x*"`` becomes ``"S0ShiS1S and S2SxS3S"``, and with ``("", "")`` and ``("", "")`` this returns ``"hi and x"``. """ commonmark_match_emphasis(delimiters) def _substitute(match): descriptor = delimiters[int(match.group(1))] leftover = descriptor["char"] * descriptor["numdelims"] close_part, open_part = commonmark_render_emphasis_events( descriptor["events"], strong_markers, regular_markers ) return close_part + leftover + open_part marker_re = _commonmark_emphasis_marker_pattern(sentinel) return marker_re.sub(_substitute, text) def _commonmark_escape_literal(text): """Escape syntax characters in fragments known to be literal text.""" return "".join( f"\\{ch}" if ch in _COMMONMARK_LITERAL_CHARS else ch for ch in text ) def _scan_angle_terminator(text, start, n): """Find ``>)`` or report a trailing ``>`` split from the next chunk.""" k = start while k < n: if text[k] == "\\" and k + 1 < n: # Skip escape sequences -- they cannot be the terminator. k += 2 continue if text[k] == ">": if k + 1 < n and text[k + 1] == ")": return k, False if k + 1 == n: # Unescaped ">" is the last character of this chunk. return None, True k += 1 return None, False # These checks depend only on their arguments, so their results are safe to # cache. Repeated characters can then reuse earlier Unicode lookups. @lru_cache(maxsize=8192) def _cm_is_whitespace(ch): """Return whether ``ch`` is CommonMark whitespace or a boundary.""" if ch is None: return True if ch in " \t\n\r\f\v": return True return unicodedata.category(ch) == "Zs" @lru_cache(maxsize=8192) def _cm_is_punctuation(ch): """Return whether ``ch`` is CommonMark punctuation or a symbol.""" if ch is None: # Callers classify a missing boundary as whitespace first, so this # fallback is defensive only. return False if ch in _CM_ASCII_PUNCTUATION: return True return unicodedata.category(ch)[0] in ("P", "S") @lru_cache(maxsize=8192) def _cm_flanking(prev_ch, next_ch): """Return a delimiter run's left- and right-flanking flags.""" left_flanking = not _cm_is_whitespace(next_ch) and ( not _cm_is_punctuation(next_ch) or _cm_is_whitespace(prev_ch) or _cm_is_punctuation(prev_ch) ) right_flanking = not _cm_is_whitespace(prev_ch) and ( not _cm_is_punctuation(prev_ch) or _cm_is_whitespace(next_ch) or _cm_is_punctuation(next_ch) ) return left_flanking, right_flanking @lru_cache(maxsize=8192) def commonmark_can_open_emphasis(delim_char, prev_ch, next_ch): """Return whether a ``*`` or ``_`` run can start emphasis. - ``prev_ch`` and ``next_ch`` are the characters around the run (``None`` at the start or end of the text). - Follows the CommonMark rules: a run followed by a space cannot open. Example: ``commonmark_can_open_emphasis("*", " ", "x")`` is ``True``. """ left_flanking, right_flanking = _cm_flanking(prev_ch, next_ch) if not left_flanking: return False if delim_char != "_": return True # Prevent right-flanking intraword underscores from opening emphasis. return not right_flanking or _cm_is_punctuation(prev_ch) @lru_cache(maxsize=8192) def commonmark_can_close_emphasis(delim_char, prev_ch, next_ch): """Return whether a ``*`` or ``_`` run can end emphasis. - ``prev_ch`` and ``next_ch`` are the characters around the run (``None`` at the start or end of the text). - Follows the CommonMark rules: a run after a space cannot close. Example: ``commonmark_can_close_emphasis("*", "x", " ")`` is ``True``. """ left_flanking, right_flanking = _cm_flanking(prev_ch, next_ch) if not right_flanking: return False if delim_char != "_": return True # Prevent left-flanking intraword underscores from closing emphasis. return not left_flanking or _cm_is_punctuation(next_ch) def commonmark_scan_delimiter_run( text, i, boundary_prev_ch=None, boundary_next_ch=None ): """Measure the ``*`` or ``_`` run at ``i``. - Returns ``(end, prev_ch, next_ch)``: the index after the run and the characters on either side (``None`` at an edge). - ``boundary_prev_ch`` and ``boundary_next_ch`` give the neighbours when ``text`` is only part of a longer message. Example: ``commonmark_scan_delimiter_run("**word", 0)`` returns ``(2, None, "w")``. """ ch = text[i] n = len(text) j = i while j < n and text[j] == ch: j += 1 prev_ch = text[i - 1] if i > 0 else boundary_prev_ch next_ch = text[j] if j < n else boundary_next_ch return j, prev_ch, next_ch def commonmark_lookahead_closer_widths( next_chunk, boundary_prev_ch=None, boundary_next_ch=None ): """Find which emphasis runs could be closed by text that follows. - ``next_chunk`` is the start of the next piece of the message. - Returns ``{char: width}`` for each ``*`` or ``_`` closer found. - Markers inside code or links do not count. Examples: - ``commonmark_lookahead_closer_widths("tail** end")`` returns ``{"*": 2}``. - ``commonmark_lookahead_closer_widths("`**` x")`` returns ``{}``. """ if not next_chunk: return {} # Scan once for all pending openers. widths = {} i = 0 n = len(next_chunk) # Index backticks so ``*`` and ``_`` inside code are not treated as markup. backtick_runs = commonmark_index_backtick_runs(next_chunk) while i < n: ch = next_chunk[i] # Skip escape pairs -- an escaped delimiter can never close a span. if ch == "\\" and i + 1 < n: i += 2 continue if ch == "`": j = i while j < n and next_chunk[j] == ch: j += 1 run = j - i close = commonmark_find_backtick_run(backtick_runs, j, run) if close is not None: # Complete code span -- its contents are not delimiters. i = close + run continue # Ignore the rest because it is still part of the unfinished code. break # Both destination forms below start with "]", so check that # cheap single-character condition first instead of paying for # a startswith() call at every position regardless of ch. if ch == "]" and next_chunk.startswith("](<", i): close = commonmark_scan_angle_dest(next_chunk, i, n) if close is not None: # Skip this URL so markup characters inside it stay text. i = close + 2 continue # Ignore the rest because it is still part of the unfinished URL. break if ch == "]" and next_chunk.startswith("](", i): close = commonmark_scan_paren_dest(next_chunk, i + 1, n) if close is not None: # Skip this URL so markup characters inside it stay text. i = close + 1 continue # Same reasoning as an unterminated code span above. break if ch == "<": close, still_valid = commonmark_scan_autolink_dest( next_chunk, i, n ) if close is not None: # Skip this autolink; its markup-like characters are text. i = close + 1 continue if still_valid: # Same reasoning as an unterminated code span above. break # Not an autolink -- fall through and scan it as ordinary text. if ch in "*_": j, prev_ch, next_ch = commonmark_scan_delimiter_run( next_chunk, i, boundary_prev_ch=boundary_prev_ch, boundary_next_ch=boundary_next_ch, ) run = j - i if commonmark_can_close_emphasis(ch, prev_ch, next_ch): width = min(run, 3) if width > widths.get(ch, 0): widths[ch] = width i = j continue i += 1 return widths def commonmark_match_emphasis(delimiters): """Pair up opening and closing ``*`` and ``_`` runs. - ``delimiters`` comes from ``commonmark_emphasis_run()``. - Follows the CommonMark pairing rules. - Adds ``("open" | "close", is_strong)`` entries to each run's ``"events"`` list. Returns the same list. Example: for ``"*text*"`` the first run gets ``[("open", False)]`` and the second gets ``[("close", False)]``. """ total = len(delimiters) # Link surviving markup positions in both directions. Matching can then # skip removed entries instead of repeatedly walking over them. prev_active = list(range(-1, total - 1)) next_active = list(range(1, total + 1)) # Use a mutable cell because removing the first entry changes the head. head = [0 if total else total] def _unlink(index): # Remove one entry by linking its neighbors directly together. before = prev_active[index] after = next_active[index] if before == -1: head[0] = after else: next_active[before] = after if after != total: prev_active[after] = before # Remember failed searches so later closers skip known-impossible ranges. search_bound = {} closer_index = head[0] while closer_index < total: closer = delimiters[closer_index] if not closer["can_close"]: closer_index = next_active[closer_index] continue bucket = (closer["char"], closer["can_open"], closer["origdelims"] % 3) bound = search_bound.get(bucket, -1) opener_index = prev_active[closer_index] found = -1 while opener_index > bound: opener = delimiters[opener_index] if opener["char"] == closer["char"] and opener["can_open"]: # Apply the multiple-of-three ambiguity rule. ambiguous = ( (closer["can_open"] or opener["can_close"]) and closer["origdelims"] % 3 != 0 and (opener["origdelims"] + closer["origdelims"]) % 3 == 0 ) if not ambiguous: found = opener_index break opener_index = prev_active[opener_index] if found == -1: # Cache the failed range for later closers in this bucket. search_bound[bucket] = closer_index - 1 if not closer["can_open"]: # This run cannot participate in a later match. next_pos = next_active[closer_index] _unlink(closer_index) closer_index = next_pos else: closer_index = next_active[closer_index] continue opener = delimiters[found] # Strong emphasis (2 delimiters) is preferred whenever both # sides have enough width left for it. use_delims = ( 2 if closer["numdelims"] >= 2 and opener["numdelims"] >= 2 else 1 ) opener["numdelims"] -= use_delims closer["numdelims"] -= use_delims opener["events"].append(("open", use_delims == 2)) closer["events"].append(("close", use_delims == 2)) # Markup inside this match cannot pair with text outside it. Link the # opener and closer directly so the enclosed entries are skipped. if found + 1 != closer_index: next_active[found] = closer_index prev_active[closer_index] = found if opener["numdelims"] == 0: _unlink(found) if closer["numdelims"] == 0: next_pos = next_active[closer_index] _unlink(closer_index) closer_index = next_pos # Retry a partially consumed closer on the next pass. # Anything still reachable was not fully consumed by a match. still_active = [False] * total pos = head[0] while pos < total: still_active[pos] = True pos = next_active[pos] for index, descriptor in enumerate(delimiters): descriptor["extendable"] = still_active[index] return delimiters def commonmark_repair_chunk( text, pending, next_chunk=None, next_chunk_boundary_ch=None, record_atoms=None, ): """Fix one piece of a split Markdown message so it displays correctly. - When a long message is split, bold or italic text can be cut in half. This closes it at the end of the piece. - ``pending`` tracks styles still open from earlier pieces. Start with ``{}`` and pass the returned state to the next call. - ``next_chunk`` is the text that comes next, used to check that a style really does close later. - Returns ``(fixed_text, pending)``. Example: ``commonmark_repair_chunk("**hello", {}, " world**")`` returns ``("**hello**", {"**": 1})``. ``record_atoms`` (optional) is a list that collects ``(start, end, kind, payload)`` entries. Each ``kind`` is one of: - ``"plain"``: ordinary text, safe to cut anywhere. - ``"literal"``: one escape, code span, or link that must stay whole. - ``"delimiter"``: a ``*`` or ``_`` run. - ``"consumed"``: markup already closed by an earlier piece. - ``"resume"``: text plus the updated ``pending`` state. """ def _record(start, end, kind, payload): """Record one parsed section when the caller requests reusable data.""" if record_atoms is not None: record_atoms.append((start, end, kind, payload)) # Collect fragments for one final join. out = [] # Collect source-ordered delimiter runs for one matching pass. delimiters = [] # Preserve the caller's state dictionary. pending = dict(pending) # Track possible link-label openings in this chunk. link_stack = [] # Track labels so delayed records can be restored to source order. had_link_label = False # Initialize the single-pass scanner. i = 0 n = len(text) # Index backtick runs for efficient matching. backtick_runs = commonmark_index_backtick_runs(text) # Pick a placeholder character proven not to collide with this # chunk's own real content before recording any delimiter runs. sentinel = commonmark_pick_emphasis_sentinel(text) # Resume code, links, or escapes started in the previous chunk. # Keep these fragments together and save the resulting state so a later # prefix query can replay this section without rebuilding it. _resume_start = len(out) in_code_width = pending.pop("in_code", None) if in_code_width: # Search this chunk for the carried code span's closing fence. close = commonmark_find_backtick_run(backtick_runs, 0, in_code_width) if close is not None: # Carried content plus the leftover fence are plain text now. out.append(_commonmark_escape_literal(text[:close])) i = close + in_code_width else: # Still doesn't close in this chunk either; carry it onward. out.append(_commonmark_escape_literal(text)) pending["in_code"] = in_code_width i = n _record( 0, i, "resume", {"text": "".join(out[_resume_start:]), "pending": dict(pending)}, ) elif pending.pop("in_link_dest", False): # Complete a terminator split between the previous and current chunk. if pending.pop("dest_gt", False) and n and text[0] == ")": out.append("\\)") i = 1 else: # Find the end of a destination already treated as literal text. close, trailing_gt = _scan_angle_terminator(text, 0, n) if close is not None: # Escape the remaining destination and its closing marker. out.append(_commonmark_escape_literal(text[:close])) out.append("\\>\\)") i = close + 2 else: # Carry the destination and any split closing marker forward. out.append(_commonmark_escape_literal(text)) pending["in_link_dest"] = True if trailing_gt: pending["dest_gt"] = True i = n _record( 0, i, "resume", {"text": "".join(out[_resume_start:]), "pending": dict(pending)}, ) elif pending.pop("in_autolink", False): # Complete a still-forming autolink split from the previous chunk. close = text.find(">") if text else -1 if close != -1: # Escape the remaining destination and its closing marker. out.append(_commonmark_escape_literal(text[:close])) out.append("\\>") i = close + 1 else: # Still doesn't close in this chunk either; carry it onward. out.append(_commonmark_escape_literal(text)) pending["in_autolink"] = True i = n _record( 0, i, "resume", {"text": "".join(out[_resume_start:]), "pending": dict(pending)}, ) elif pending.pop("in_escape", False): # The prior backslash already escapes this chunk's first character. if text: out.append(text[0]) i = 1 _record( 0, i, "resume", { "text": "".join(out[_resume_start:]), "pending": dict(pending), }, ) else: # Still nothing to consume; keep waiting for a real chunk. pending["in_escape"] = True # Scan the remainder of this chunk. while i < n: # Remember where this parsed section begins so it can be reused later. start = i ch = text[i] # Preserve escapes already present in the CommonMark source. if ch == "\\": if i + 1 < n: out.append(text[i : i + 2]) i += 2 _record(start, i, "literal", out[-1]) continue # Carry a trailing backslash's escape state into the next chunk. out.append(ch) pending["in_escape"] = True i = n # Save the state because this escape continues in the next chunk. _record( start, i, "resume", {"text": out[-1], "pending": dict(pending)} ) continue # Preserve complete code spans or carry split spans forward. if ch == "`": j = i # Measure the opening backtick run. while j < n and text[j] == "`": j += 1 run = j - i # Look for the matching close run in the pre-built index. close = commonmark_find_backtick_run(backtick_runs, j, run) if close is not None: # Complete span in this chunk: copy verbatim. out.append(text[i : close + run]) i = close + run _record(start, i, "literal", out[-1]) continue # Drop a split fence and carry its width. Some targets decode # escapes before rendering, so escaping the fence is unsafe. pending["in_code"] = run out.append(_commonmark_escape_literal(text[j:])) i = n # Save the new state because this code span continues later. _record( start, i, "resume", {"text": out[-1], "pending": dict(pending)} ) continue # Preserve a complete standalone autolink or carry a split one # forward. Its interior must never be scanned for emphasis # delimiters -- a "*" or "_" inside a URL is literal, not markup. if ch == "<": close, still_valid = commonmark_scan_autolink_dest(text, i, n) if close is not None: # Complete autolink in this chunk: copy verbatim. out.append(text[i : close + 1]) i = close + 1 _record(start, i, "literal", out[-1]) continue if still_valid: # Carry the still-forming autolink onward, rendered as # escaped literal text in the meantime. out.append(_commonmark_escape_literal(text[i:])) pending["in_autolink"] = True i = n # This sets pending too -- same reasoning as above. _record( start, i, "resume", {"text": out[-1], "pending": dict(pending)}, ) continue # Not an autolink -- fall through and preserve it literally. # Classify delimiters from source text, not unresolved placeholders. if ch in "*_": j, prev_ch, next_ch = commonmark_scan_delimiter_run( text, i, boundary_next_ch=(next_chunk[0] if next_chunk else None), ) run = j - i # Consume closers already rendered in the previous chunk. # Save consumed markers so reused scans update state too. consumed_markers = [] while run > 0: marker = ch * 2 if run >= 2 else ch if pending.get(marker, 0) > 0: pending[marker] -= 1 run -= len(marker) consumed_markers.append(marker) else: break if run > 0: # Record remaining width for the chunk-wide matching pass. descriptor = { "char": ch, "numdelims": run, "origdelims": run, "can_open": commonmark_can_open_emphasis( ch, prev_ch, next_ch ), "can_close": commonmark_can_close_emphasis( ch, prev_ch, next_ch ), "events": [], } delimiters.append(descriptor) index = len(delimiters) - 1 out.append(f"{sentinel}{index}{sentinel}") # Save a description before matching changes the live copy. # Each reused prefix must begin with the same original values. _record( start, j, "delimiter", { "char": descriptor["char"], "numdelims": descriptor["numdelims"], "origdelims": descriptor["origdelims"], "can_open": descriptor["can_open"], "can_close": descriptor["can_close"], "events": [], "consumed_markers": consumed_markers, }, ) else: # The previous chunk consumed this run. Record that state # change even though this section produces no output. _record( start, j, "consumed", {"consumed_markers": consumed_markers}, ) i = j continue # Track link labels for carry-over across chunk boundaries. if ch == "[": # Keep output and source positions until the link completes. link_stack.append((len(out), i)) out.append(ch) i += 1 # Add the label record after its outcome is known. had_link_label = True continue if text.startswith("](<", i): # We are at the "](<" that may close a pending link label. close = commonmark_scan_angle_dest(text, i, n) if close is not None and link_stack: # Record the opener separately from the completed link ending. open_index, open_start = link_stack.pop() _record(open_start, open_start + 1, "literal", out[open_index]) out.append(text[i : close + 2]) _record(start, close + 2, "literal", text[i : close + 2]) i = close + 2 continue # Keep an incomplete link as escaped literal text. if link_stack: open_index, open_start = link_stack.pop() _record(open_start, open_start + 1, "literal", out[open_index]) # The shared scanner stops at a real ``[``, so reaching this point # without a label is safe to record as literal or continued text. _dest_start = len(out) if close is not None: out.append("\\]\\(") out.append(_commonmark_escape_literal(text[i + 3 : close])) out.append("\\>\\)") i = close + 2 _record(start, i, "literal", "".join(out[_dest_start:])) else: out.append("\\]\\(") out.append(_commonmark_escape_literal(text[i + 3 :])) pending["in_link_dest"] = True # Record a trailing ">" that may close in the next chunk. _, trailing_gt = _scan_angle_terminator(text, i + 3, n) if trailing_gt: pending["dest_gt"] = True i = n _record( start, i, "resume", { "text": "".join(out[_dest_start:]), "pending": dict(pending), }, ) continue if text.startswith("](", i): # A bare "](" (the angle-bracket form above already handled # "](<") that may close a pending link label with an # unbracketed destination. close = commonmark_scan_paren_dest(text, i + 1, n) if close is not None and link_stack: # Record the opener separately from the completed link ending. open_index, open_start = link_stack.pop() _record(open_start, open_start + 1, "literal", out[open_index]) out.append(text[i : close + 1]) _record(start, close + 1, "literal", text[i : close + 1]) i = close + 1 continue # This failed label now has its final literal value. if link_stack: open_index, open_start = link_stack.pop() _record(open_start, open_start + 1, "literal", out[open_index]) if close is not None: # Without a matching ``[``, escape this URL as literal text so # any ``*`` or ``_`` inside it cannot become markup. _dest_start = len(out) out.append("\\]\\(") out.append(_commonmark_escape_literal(text[i + 2 : close])) out.append("\\)") i = close + 1 _record(start, i, "literal", "".join(out[_dest_start:])) continue # Leave the unfinished URL untouched and do not inspect its markup. # Only angle-style URLs carry state because Apprise creates them. out.append(text[i:]) i = n # No cross-chunk state changed, so record this as literal text. _record(start, i, "literal", out[-1]) continue # Group ordinary characters to reduce repeated append calls. # An unhandled markup-like character stands alone so the # following character is checked normally on the next pass. if ch in "\\`<*_[]": i += 1 else: while i < n and text[i] not in "\\`<*_[]": i += 1 out.append(text[start:i]) # Plain text can be safely shortened when rebuilding a smaller prefix. _record(start, i, "plain", out[-1]) # Escape labels that did not complete within this chunk. for open_index, open_start in link_stack: out[open_index] = "\\" + out[open_index] _record(open_start, open_start + 1, "literal", out[open_index]) if record_atoms is not None and had_link_label: # Restore source order after adding delayed label records. record_atoms.sort(key=lambda atom: atom[0]) return _commonmark_resolve_emphasis( out, delimiters, sentinel, text_len=n, last_char=(text[-1] if text else None), pending=pending, next_chunk=next_chunk, next_chunk_boundary_ch=next_chunk_boundary_ch, ) def _commonmark_resolve_emphasis( out, delimiters, sentinel, text_len, last_char, pending, next_chunk, next_chunk_boundary_ch, closer_widths=None, ): """Resolve ``*`` and ``_`` runs and return ``(text, new_pending)``. ``text_len`` and ``last_char`` describe the requested prefix. ``closer_widths`` may supply precomputed closing-marker widths so the function does not need to scan ``next_chunk`` again. """ # Resolve emphasis after every run in the chunk is known. commonmark_match_emphasis(delimiters) # Force eligible unmatched openers closed for this chunk and carry their # state forward. Runs already ruled out by CommonMark stay literal. new_pending = dict(pending) # Treat a final single marker as literal and a final empty pair as noise. last_index = len(delimiters) - 1 trailing_empty = ( bool(delimiters) and bool(out) and out[-1] == f"{sentinel}{last_index}{sentinel}" ) # Classify edge runs using the characters around the lookahead slice, # unless a caller already worked this out from a shared index. if closer_widths is None: lookahead_closer_widths = commonmark_lookahead_closer_widths( next_chunk, boundary_prev_ch=last_char, boundary_next_ch=next_chunk_boundary_ch, ) else: lookahead_closer_widths = closer_widths # Track forced opens so the tail can close them in reverse order. forced_open_groups = [] for index, descriptor in enumerate(delimiters): # Carry an opener only when lookahead contains a possible closer. available_width = lookahead_closer_widths.get(descriptor["char"], 0) if ( not descriptor["can_open"] or not descriptor["extendable"] or descriptor["numdelims"] <= 0 or not available_width ): continue # Drop empty trailing runs unless that would empty the whole chunk. whole_chunk_is_this_run = text_len == descriptor["origdelims"] if ( trailing_empty and index == last_index and not whole_chunk_is_this_run ): # Drop leftover pairs and preserve at most one literal marker. descriptor["numdelims"] %= 2 continue # Record at most one strong and one regular verified expectation. char = descriptor["char"] opened = [] to_allocate = descriptor["numdelims"] if available_width >= 2 and to_allocate >= 2: opened.append(char * 2) to_allocate -= 2 if available_width != 2 and to_allocate >= 1: opened.append(char) to_allocate -= 1 # Escape unallocated width so dialect adapters keep it literal. excess = _commonmark_escape_literal(char * to_allocate) descriptor["numdelims"] = 0 # Emit literal excess before the portion closed for this chunk. real_close_part, _ = commonmark_render_emphasis_events( descriptor["events"], (char * 2, char * 2), (char, char) ) descriptor["_forced_text"] = real_close_part + excess + "".join(opened) for marker in opened: new_pending[marker] = new_pending.get(marker, 0) + 1 forced_open_groups.append(opened) # Close forced-open runs from innermost to outermost. for opened in reversed(forced_open_groups): out.extend(opened) def _substitute(match): descriptor = delimiters[int(match.group(1))] if "_forced_text" in descriptor: return descriptor["_forced_text"] char = descriptor["char"] # Escape unmatched width that cannot become emphasis. leftover = _commonmark_escape_literal(char * descriptor["numdelims"]) close_part, open_part = commonmark_render_emphasis_events( descriptor["events"], (char * 2, char * 2), (char, char) ) return close_part + leftover + open_part marker_re = _commonmark_emphasis_marker_pattern(sentinel) resolved_text = marker_re.sub(_substitute, "".join(out)) return resolved_text, new_pending # --------------------------------------------------------------------------- # Shared repair scans the source once, then rebuilds many shorter prefixes from # recorded sections. Links fall back to a direct repair because their meaning # can change at each cut. Closing ``*`` and ``_`` runs use a shared lookup too. def _cm_build_range_max_table(values): """Precompute range maximums for quick repeated lookups. Each row covers larger power-of-two windows. ``_cm_range_max()`` combines two of those windows to find the largest value in any requested range. """ n = len(values) table = [list(values)] width = 1 while width * 2 <= n: prev_row = table[-1] table.append( [ max(prev_row[k], prev_row[k + width]) for k in range(n - width * 2 + 1) ] ) width *= 2 return table def _cm_range_max(table, lo, hi): """Return ``max(values[lo:hi])`` using a table built by ``_cm_build_range_max_table()``. Requires ``hi > lo``. """ length = hi - lo level = length.bit_length() - 1 row = table[level] width = 1 << level # Cover the requested range from both ends; overlap does not affect max(). return max(row[lo], row[hi - width]) class _CmCloserRunIndex: """Find the widest closing-marker run in a requested text range. ``commonmark_scan_closer_runs()`` builds one index for ``*`` and one for ``_`` so repeated prefix checks do not scan the same text again. """ __slots__ = ("_ends", "_starts", "_table") def __init__(self, starts, ends, widths): # Runs arrive in source order, so no sorting is needed. Keep every run # for boundary checks; a zero width means it cannot close markup. self._starts = starts self._ends = ends self._table = _cm_build_range_max_table(widths) def widest_in_window(self, window_start, window_end): """Return the widest closing run visible in this range, up to 3. Partly visible runs are shortened to the visible width. Call ``straddles()`` first and use a direct scan when a boundary cuts a run. """ starts = self._starts ends = self._ends n = len(starts) if n == 0 or window_start >= window_end: return 0 # The first table row stores usable widths; zero means ignore the run. run_widths = self._table[0] # At most one non-overlapping run can cross the window's left edge. idx = bisect_right(starts, window_start) - 1 best = 0 if idx >= 0 and ends[idx] > window_start: visible = min(ends[idx], window_end) - window_start best = min(visible, run_widths[idx]) idx += 1 else: idx += 1 stop = bisect_left(starts, window_end) if stop > idx: # These runs are inside the window, so one lookup covers them. best = max(best, _cm_range_max(self._table, idx, stop)) return best def straddles(self, position): """Return whether ``position`` falls inside a recorded marker run. A boundary inside a run changes which neighboring characters are visible, so callers must directly rescan that range for a safe result. """ starts = self._starts idx = bisect_right(starts, position) - 1 return idx >= 0 and starts[idx] < position < self._ends[idx] def commonmark_scan_closer_runs(text, boundary_next_ch=None): """Index the ``*`` and ``_`` runs in ``text`` that could close emphasis. - Built once so the same text can be checked many times quickly. - Stops at the first escape, code span, or link, because those can change the meaning of text after them. - Returns ``(index_by_char, covered_end)``: - ``index_by_char`` has one index for ``*`` and one for ``_``. - ``covered_end`` is how far into ``text`` the index can be used. Example: ``commonmark_scan_closer_runs("a** b_ `c*`")`` gives a ``covered_end`` of ``7``, where the code span starts. """ starts = {"*": [], "_": []} ends = {"*": [], "_": []} widths = {"*": [], "_": []} i = 0 n = len(text) while i < n: ch = text[i] if ch in "\\`<]": # Stop here because ranges beginning later may interpret this # escape, code span, or link differently. break if ch in "*_": j, prev_ch, next_ch = commonmark_scan_delimiter_run( text, i, boundary_next_ch=boundary_next_ch ) # Record every run so boundaries that split an unusable run are # detected too. Store zero when it cannot close markup. starts[ch].append(i) ends[ch].append(j) widths[ch].append( min(j - i, 3) if commonmark_can_close_emphasis(ch, prev_ch, next_ch) else 0 ) i = j continue i += 1 index_by_char = { ch: _CmCloserRunIndex(starts[ch], ends[ch], widths[ch]) for ch in ("*", "_") } return index_by_char, i def commonmark_scan_repair_region(text, pending, lookahead_span): """Scan text once so many shorter cuts of it can be repaired quickly. - Used when searching for the longest piece that fits a length limit. - Pass the results to ``commonmark_materialize_repair()``, with the same ``pending`` and ``lookahead_span``. - Returns ``(recorded_sections, covered_end, sentinel)``: - ``recorded_sections``: ``(start, end, kind, payload)`` entries (see ``commonmark_repair_chunk()``). - ``covered_end``: how far the sections can be reused. - ``sentinel``: the marker from ``commonmark_pick_emphasis_sentinel()``. Example: ``"**hello world**"`` records a ``"delimiter"``, a ``"plain"`` section ``"hello world"``, and another ``"delimiter"``. """ bracket_pos = text.find("[") covered_end = len(text) if bracket_pos == -1 else bracket_pos region = text[:covered_end] # Start lookahead at the reusable region's end, which may be shortened by a # link opening. Read it from the supplied text so it need not be predicted. lookahead_end = covered_end + lookahead_span lookahead = text[covered_end:lookahead_end] lookahead_boundary_ch = text[lookahead_end : lookahead_end + 1] or None atoms = [] commonmark_repair_chunk( region, pending, next_chunk=(lookahead or None), next_chunk_boundary_ch=lookahead_boundary_ch, record_atoms=atoms, ) # An unfinished ``<`` may become an autolink when more text is available. # Keep only the recorded sections before it, whose meaning cannot change. for atom_index, (atom_start, _end, kind, payload) in enumerate(atoms): if kind == "plain" and payload == "<": covered_end = atom_start region = text[:covered_end] atoms = atoms[:atom_index] break # One unique placeholder is safe for every shorter prefix of this region. sentinel = commonmark_pick_emphasis_sentinel(region) return atoms, covered_end, sentinel def commonmark_materialize_repair( body, offset, cut, pending, scan_atoms, covered_end, sentinel, lookahead_span, closer_index=None, closer_covered_end=None, ): """Repair the first ``cut`` characters of ``body`` from ``offset``, reusing a scan from ``commonmark_scan_repair_region()``. - Gives the same result as ``commonmark_repair_chunk()`` with ``next_chunk`` set to the next ``lookahead_span`` characters. - Pass the values from ``commonmark_scan_repair_region()`` with the same ``pending`` state. - ``closer_index`` and ``closer_covered_end`` (from ``commonmark_scan_closer_runs()``) are optional but save a rescan. Example: after scanning ``"**hello world**"``, a ``cut`` of ``7`` returns ``("**hello**", {"**": 1})``. """ def _fallback(): """Repair directly when the shared scan cannot be reused.""" abs_cut = offset + cut lookahead_end = abs_cut + lookahead_span lookahead = body[abs_cut:lookahead_end] boundary_next_ch = body[lookahead_end : lookahead_end + 1] or None return commonmark_repair_chunk( body[offset:abs_cut], pending, next_chunk=lookahead or None, next_chunk_boundary_ch=boundary_next_ch, ) if cut <= 0: # Even empty input can update carried state, so use the normal repair. return _fallback() if cut > covered_end: # The shared scan stopped before this cut, usually at a link opening. return _fallback() # Recorded sections cover the reusable text in order with no gaps. ends = [atom[1] for atom in scan_atoms] split = bisect_left(ends, cut) tail_text = None if ends[split] == cut: # This recorded section ends at the cut, so include it in full. included = scan_atoms[: split + 1] else: # The cut lands inside this recorded section. atom_start, _atom_end, kind, payload = scan_atoms[split] if kind != "plain": # Escapes, code spans, links, and markup runs must remain whole. # Repair directly rather than guessing how part of one behaves. return _fallback() # A run of ordinary characters carries no escaping ambiguity, so # any prefix of it is trivially valid on its own. included = scan_atoms[:split] tail_text = payload[: cut - atom_start] # Rebuild the prefix from recorded sections. Use a private state copy so # each query replays carried-marker changes independently. out = [] delimiters = [] working_pending = dict(pending) for _start, _end, kind, payload in included: if kind == "resume": # Replace working state with the snapshot saved for this section. out.append(payload["text"]) working_pending = dict(payload["pending"]) elif kind == "delimiter": # Copy mutable markup data so independent queries cannot change it. delimiters.append( { "char": payload["char"], "numdelims": payload["numdelims"], "origdelims": payload["origdelims"], "can_open": payload["can_open"], "can_close": payload["can_close"], "events": [], } ) out.append(f"{sentinel}{len(delimiters) - 1}{sentinel}") for marker in payload["consumed_markers"]: working_pending[marker] = working_pending.get(marker, 0) - 1 elif kind == "consumed": # This run produced no text, but its state change still applies. for marker in payload["consumed_markers"]: working_pending[marker] = working_pending.get(marker, 0) - 1 else: out.append(payload) if tail_text is not None: out.append(tail_text) abs_cut = offset + cut lookahead_end = abs_cut + lookahead_span last_char = body[abs_cut - 1] if cut else None # Express this prefix's lookahead range relative to the shared scan. rel_start = cut rel_end = cut + lookahead_span closer_widths = None if closer_index is not None and rel_end <= closer_covered_end: straddling = any( index.straddles(rel_start) or index.straddles(rel_end) for index in closer_index.values() ) if not straddling: # A boundary inside a marker run requires the direct scan below. closer_widths = {} for ch, index in closer_index.items(): width = index.widest_in_window(rel_start, rel_end) if width: closer_widths[ch] = width if closer_widths is not None: return _commonmark_resolve_emphasis( out, delimiters, sentinel, text_len=cut, last_char=last_char, pending=working_pending, next_chunk=None, next_chunk_boundary_ch=None, closer_widths=closer_widths, ) lookahead = body[abs_cut:lookahead_end] boundary_next_ch = body[lookahead_end : lookahead_end + 1] or None return _commonmark_resolve_emphasis( out, delimiters, sentinel, text_len=cut, last_char=last_char, pending=working_pending, next_chunk=(lookahead or None), next_chunk_boundary_ch=boundary_next_ch, ) def _section_text_end(text: str, start: int, tail: int) -> int: """Return the end of intro or section text starting near ``start``. Text ends at trailing whitespace or before the next heading line. """ # Check each "#" before the trailing whitespace hash_idx = text.find("#", start, tail) while hash_idx != -1: # Walk back over the whitespace just before this "#" ws_idx = hash_idx while ws_idx > start and text[ws_idx - 1].isspace(): ws_idx -= 1 # The text ends at the first line break in that whitespace for idx in range(ws_idx, hash_idx): if text[idx] in "\r\n": return idx # This "#" is not at the start of a line; try the next one hash_idx = text.find("#", hash_idx + 1, tail) # Otherwise the text runs up to the trailing whitespace return max(start, tail) def commonmark_sections( markdown: str, name_maxlen: int, value_maxlen: int ) -> tuple[str, list[tuple[str, str]]]: r"""Split Markdown into intro text and ``(heading, text)`` sections. - Used for services that show messages as titled fields. - Headings are cut to ``name_maxlen``. - Section text longer than ``value_maxlen`` continues in extra sections with the same heading. - A heading with no text under it gets ``""``. Example: ``"Intro\n# A\nsome text\n# B"`` returns ``("Intro", [("A", "some text"), ("B", "")])``. """ # Text before the first heading becomes the description description = "" # Skip the leading whitespace n = len(markdown) idx = 0 while idx < n and markdown[idx].isspace(): idx += 1 if idx < n and markdown[idx] != "#": # The description runs until the first heading line tail = len(markdown.rstrip()) end = _section_text_end(markdown, idx + 1, tail) description = markdown[idx:end].strip() if description: # Strip description from our string since it has been handled # now. markdown = markdown.replace(description, "", 1) # Where the trailing whitespace begins n = len(markdown) tail = len(markdown.rstrip()) # Find each heading and the text written below it. sections: list[tuple[str, str]] = [] pos = 0 while True: # Every "#" may open a heading hash_idx = markdown.find("#", pos) if hash_idx == -1: break # The heading runs to the end of its line line_end = markdown.find("\n", hash_idx) if line_end == -1: line_end = n # Skip the "#", space, tab and vertical tab characters after it idx = hash_idx + 1 while idx < line_end and markdown[idx] in "# \t\v": idx += 1 if idx == line_end: if idx == hash_idx + 1: # A lone "#" at the end of a line is not a heading pos = hash_idx + 1 continue # Keep at least the last character as the heading name idx -= 1 # Section names have a length limit of their own name = markdown[idx:line_end].strip("#`* \r\n\t\v")[:name_maxlen] # Skip the line break and any whitespace after the heading idx = min(line_end + 1, n) while idx < n and markdown[idx].isspace(): idx += 1 # Section text needs two or more characters and no leading "#" text = "" pos = idx if idx + 1 < n and markdown[idx] != "#": pos = _section_text_end(markdown, idx + 2, tail) text = markdown[idx:pos].strip() if not text: # A heading with nothing written below it sections.append((name, "")) continue # Continue long sections in sections with the same name. sections.extend( (name, part) for part in smart_split(text, value_maxlen, NotifyFormat.TEXT) ) return description, sections caronc-apprise-dfec414/apprise/conversion/dialect.py000066400000000000000000000316361526720371000227370ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Fit plugin dialect conversions to service limits after CommonMark repair. # Plugins may also reuse these helpers for custom dialect output. from bisect import bisect_right from collections.abc import Sequence import re from typing import Callable, Optional from ..common import NotifyFormat from ..utils.format import HTML_ENTITY_MAXLEN, html_tag_end from .commonmark import ( commonmark_materialize_repair, commonmark_repair_chunk, commonmark_scan_closer_runs, commonmark_scan_repair_region, ) # Only CommonMark markup can make a longer converted prefix fit again. # Use it to avoid unnecessary per-position checks for plain text. _COMMONMARK_MARKUP_RE = re.compile(r"[\\`*_\[\]()<>]") # Limit repeat checks so results do not depend on CPU speed. Most repaired # prefixes that fit appear just above the best result, so check more there and # reserve a few checks for longer prefixes near the other end of the range. _VERIFY_SCAN_UPWARD_PROBES = 24 _VERIFY_SCAN_DOWNWARD_PROBES = 8 def _longest_fitting_prefix(body, offset, limit, dialect_convert, pending): """Return the longest fitting conversion, consumed length, and state. Search from ``offset`` while using the remaining body as repair lookahead. The consumed length is relative to ``offset`` for easy cursor advancement. """ n = len(body) - offset # Cap lookahead because every fitting probe scans it again. Preserve the # next character separately so an edge run still sees its true neighbor. lookahead_span = min(max(1, limit * 8), 2048) def _repair(mid): abs_mid = offset + mid lookahead_end = abs_mid + lookahead_span lookahead = body[abs_mid:lookahead_end] boundary_next_ch = body[lookahead_end : lookahead_end + 1] or None return commonmark_repair_chunk( body[offset:abs_mid], pending, next_chunk=lookahead or None, next_chunk_boundary_ch=boundary_next_ch, ) def _fits(mid): candidate, candidate_pending = _repair(mid) candidate = dialect_convert(candidate) return len(candidate) <= limit, candidate, candidate_pending best_converted, best_len, best_pending = "", 0, pending # Grow geometrically so both expanding and shrinking conversions find a # useful search boundary without starting at the full remaining body. probe = min(n, max(1, limit)) hi = None while True: fits, candidate, candidate_pending = _fits(probe) if not fits: hi = probe break best_converted, best_len, best_pending = ( candidate, probe, candidate_pending, ) if probe >= n: # The entire remaining body fits -- nothing more to search. return best_converted, best_len, best_pending probe = min(n, probe * 2) # The first failed probe bounds the later verification window. first_fail = hi # Later checks only need a short range beyond the first failed length. verify_end = min(n, first_fail + min(lookahead_span, 24)) # Scan once so every tested prefix can reuse the parsed sections. shared_span = verify_end shared_text = body[offset : offset + shared_span + lookahead_span] scan_atoms, covered_end, sentinel = commonmark_scan_repair_region( shared_text, pending, lookahead_span ) # Index closing ``*`` and ``_`` runs once for the same repeated checks. closer_index, closer_covered_end = commonmark_scan_closer_runs(shared_text) def _repair_shared(mid): # Directly repair prefixes that cannot reuse the shared scan. return commonmark_materialize_repair( body, offset, mid, pending, scan_atoms, covered_end, sentinel, lookahead_span, closer_index=closer_index, closer_covered_end=closer_covered_end, ) def _fits_shared(mid): candidate, candidate_pending = _repair_shared(mid) candidate = dialect_convert(candidate) return len(candidate) <= limit, candidate, candidate_pending # Bisect between the largest fit and first overflow. Dialect repair can # occasionally make a longer prefix shorter, so verify that case below. lo, hi = best_len + 1, hi - 1 while lo <= hi: mid = (lo + hi) // 2 fits, candidate, candidate_pending = _fits_shared(mid) if fits: # This prefix fits. Try a longer one. best_converted, best_len, best_pending = ( candidate, mid, candidate_pending, ) lo = mid + 1 else: # Too long. Try a shorter prefix. hi = mid - 1 # A longer repaired prefix can become shorter anywhere bisection skipped. # Verify back to the best known fit instead of assuming a local boundary. # Plain text cannot create a later repaired fit, so skip its scan. verify_region = body[offset + best_len : offset + verify_end] if _COMMONMARK_MARKUP_RE.search(verify_region): # Check above the best result and keep the longest prefix that fits. upward_end = min(verify_end, best_len + _VERIFY_SCAN_UPWARD_PROBES) best_upward = None for mid in range(best_len + 1, upward_end + 1): fits, candidate, candidate_pending = _fits_shared(mid) if fits: best_upward = (candidate, mid, candidate_pending) # Check downward; the first fit is the longest in this range. for probes, mid in enumerate( range(verify_end, upward_end, -1), start=1 ): fits, candidate, candidate_pending = _fits_shared(mid) if fits: return candidate, mid, candidate_pending if probes >= _VERIFY_SCAN_DOWNWARD_PROBES: break if best_upward is not None: return best_upward if best_len == 0: # Not even a single character fits. Force progress anyway. best_converted, best_pending = _repair_shared(1) best_converted = dialect_convert(best_converted) best_len = 1 return best_converted, best_len, best_pending def _html_safe_cuts(body: str) -> list[int]: """Return cut positions outside HTML tags and entities. The end of ``body`` is always included. """ cuts = [] # Track where the current entity ends entity_end = -1 idx = 0 n = len(body) while idx < n: # A cut here would fall just before this character if idx > entity_end: cuts.append(idx) ch = body[idx] if ch == "<": # Jump over the whole tag, quoted attribute values included idx = html_tag_end(body, idx) if idx == -1: # An unclosed tag runs to the end, so no later cut is safe break elif ch == "&": # Protect an entity up to and including its ``;`` semi = body.find(";", idx, idx + HTML_ENTITY_MAXLEN) if semi != -1 and not any(c.isspace() for c in body[idx:semi]): entity_end = semi idx += 1 # The whole body is always a valid cut cuts.append(len(body)) return cuts def _longest_fitting_cut( body: str, offset: int, limit: int, dialect_convert: Callable[[str], str], cuts: Sequence[int], ) -> tuple[str, int, Sequence[int]]: """Return the longest converted prefix ending at one of ``cuts``. Nothing is repaired. The shortest prefix is returned when none fit, ensuring the caller always makes progress. """ # Only cuts past the current offset are candidates first = bisect_right(cuts, offset) lo, hi = first, len(cuts) - 1 best = None # Grow quickly to find the range that may contain the best cut. span = max(1, limit) while lo <= hi: # Use the last cut within the probed length (at least one cut) probe = max(lo, bisect_right(cuts, offset + span, lo) - 1) candidate = dialect_convert(body[offset : cuts[probe]]) if len(candidate) > limit: # Too long; the answer lies below this cut hi = probe - 1 break # This prefix fits; keep growing best = (candidate, cuts[probe] - offset, cuts) lo = probe + 1 span *= 2 # Find the longest safe prefix in the remaining range. while lo <= hi: mid = (lo + hi) // 2 candidate = dialect_convert(body[offset : cuts[mid]]) if len(candidate) <= limit: # This prefix fits. Try a longer one. best = (candidate, cuts[mid] - offset, cuts) lo = mid + 1 else: # Too long. Try a shorter prefix. hi = mid - 1 if best is None: # Not even the shortest safe prefix fits. Force progress anyway. best = ( dialect_convert(body[offset : cuts[first]]), cuts[first] - offset, cuts, ) return best def split_dialect_chunk( body: str, limit: int, dialect_convert: Callable[[str], str], body_format: Optional[NotifyFormat] = None, ) -> list[str]: """Split converted content into pieces within ``limit``. The converter must be deterministic and generally preserve input order. CommonMark is repaired around cuts; HTML keeps tags and entities whole; plain text is cut as it is. """ if not body: return [dialect_convert(body)] converted = dialect_convert(body) if len(converted) <= limit: return [converted] if body_format == NotifyFormat.HTML: # Split HTML only at positions that keep tags and entities whole fit, state = _longest_fitting_cut, _html_safe_cuts(body) elif body_format == NotifyFormat.TEXT: # Plain text may be cut anywhere and is never repaired as markup fit, state = _longest_fitting_cut, range(len(body) + 1) else: # Carry repair state so later pieces consume real closing markers. fit, state = _longest_fitting_prefix, {} pieces = [] # Advance a cursor to avoid copying the full remaining body per piece. n = len(body) offset = 0 while offset < n: piece, consumed, state = fit( body, offset, limit, dialect_convert, state ) # Skip redundant empty closers, but always return at least one piece. if piece or not pieces: pieces.append(piece) offset += consumed return pieces def truncate_dialect_chunk( body: str, limit: int, dialect_convert: Callable[[str], str], body_format: Optional[NotifyFormat] = None, ) -> str: """Return the longest converted prefix within ``limit``. HTML cuts keep tags and entities whole. Plain text is not repaired as markup, and all content after the cut is discarded. """ if not body: return dialect_convert(body) converted = dialect_convert(body) if len(converted) <= limit: return converted if body_format == NotifyFormat.HTML: # Keep tags and entities whole; no CommonMark repair for HTML piece, _, _ = _longest_fitting_cut( body, 0, limit, dialect_convert, _html_safe_cuts(body) ) return piece if body_format == NotifyFormat.TEXT: # Plain text is cut as it is, with no markup repair piece, _, _ = _longest_fitting_cut( body, 0, limit, dialect_convert, range(len(body) + 1) ) return piece # Truncate mode has no prior or subsequent repair state. piece, _, _ = _longest_fitting_prefix(body, 0, limit, dialect_convert, {}) return piece caronc-apprise-dfec414/apprise/conversion/format.py000066400000000000000000000117651526720371000226230ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Convert Apprise's TEXT, HTML, and MARKDOWN formats. Service dialects are # handled separately by ``conversion/dialect.py`` and plugin hooks. from collections.abc import Sequence import re from string import punctuation from typing import Optional from markdown import Markdown from ..common import NotifyFormat from ..compat.markdown33 import escape_placeholders_as_html from ..url import URLBase from .html import HTMLConverter, HTMLMarkdownConverter # CommonMark syntax characters, including backslash itself. # Plain text has no escape state, so escape every occurrence. An "&" is # only escaped when it would otherwise read as an entity such as "&". _COMMONMARK_ESCAPABLE_RE = re.compile( r"([\\_*\[\]()~`>#+=|{}.!-]|&(?=#?[0-9A-Za-z]{1,32};))" ) def convert_between(from_format, to_format, content): """Convert content between supported Apprise formats. The original content is returned when no converter exists for the pair. """ # Fetch the converter registered for this format pair. convert = CONVERTERS.get((from_format, to_format)) # Preserve the original content when no conversion is available return convert(content) if convert else content # Notification-friendly line-break and table extensions. _MARKDOWN_EXTENSIONS = ( "markdown.extensions.nl2br", "markdown.extensions.tables", ) def markdown_to_html( content: str, extensions: Optional[Sequence[str]] = None ) -> str: """Convert Markdown content to HTML. ``extensions`` replaces the default Python-Markdown extensions. """ # Use the notification defaults unless the caller picks its own. md = Markdown( extensions=list( _MARKDOWN_EXTENSIONS if extensions is None else extensions ), ) # Match CommonMark by allowing all ASCII punctuation to be escaped. md.ESCAPED_CHARS = sorted(set(md.ESCAPED_CHARS) | set(punctuation)) # Keep escaped characters valid HTML on every Python-Markdown release. escape_placeholders_as_html(md) return md.convert(content) def text_to_html(content): """Convert plain text content to HTML.""" # First eliminate any carriage returns return URLBase.escape_html(content, convert_new_lines=True) def text_to_markdown(content): """Converts specified content from plain text to CommonMark. Escapes CommonMark-significant characters, including backslashes, so plain text renders literally in Markdown destinations. """ # Prefix each Markdown control character so it stays ordinary text. return _COMMONMARK_ESCAPABLE_RE.sub(r"\\\1", content) def html_to_text(content): """Convert HTML content to plain text.""" # Initialize the plain-text parser. parser = HTMLConverter() # Feed and finalize the HTML document parser.feed(content) parser.close() # Return the finalized parser output. return parser.converted def html_to_markdown(content): """Convert HTML content to CommonMark.""" # Initialize the Markdown parser. parser = HTMLMarkdownConverter() # Feed and finalize the HTML document parser.feed(content) parser.close() # Return the finalized parser output. return parser.converted # Map each supported format pair to the function that converts it. CONVERTERS = { # Each key describes the input format followed by the requested output. (NotifyFormat.MARKDOWN, NotifyFormat.HTML): markdown_to_html, (NotifyFormat.TEXT, NotifyFormat.HTML): text_to_html, (NotifyFormat.HTML, NotifyFormat.TEXT): html_to_text, (NotifyFormat.HTML, NotifyFormat.MARKDOWN): html_to_markdown, (NotifyFormat.TEXT, NotifyFormat.MARKDOWN): text_to_markdown, } caronc-apprise-dfec414/apprise/conversion/html.py000066400000000000000000002121331526720371000222670ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Generic HTML parsers for plain text, CommonMark, and reduced tag sets. # Service-specific markup belongs in plugins. from collections import Counter import contextlib from html import escape from html.parser import HTMLParser import re from typing import Optional from .commonmark import ( commonmark_find_backtick_run, commonmark_index_backtick_runs, ) # Cap list indentation so deeply nested input stays linear. LIST_DEPTH_MAX = 4 # Apply the same depth cap to blockquote prefixes. BLOCKQUOTE_DEPTH_MAX = 4 # Bound the context-stack depth so adversarially nested HTML cannot # exhaust memory. Frames beyond this limit are silently dropped. MAX_FRAME_DEPTH = 200 # Collapse source line breaks and nearby whitespace as HTML does. Starting # at the first space keeps long runs efficient. HTML_NEWLINE_RE = re.compile(r"(?:(? elements so text inside keeps its line breaks. self._pre_depth = 0 # Initialize internal result list self._result = [] # Initialize public result field (not populated until close() is # called) self.converted = "" def close(self): """Finalize the converted content.""" # Flush trailing text that resembles an unfinished entity, such as # the end of "q&a". HTMLParser.close(self) # Combine buffered fragments into one string. string = "".join(self._finalize(self._result)) # Publish the normalized result. self.converted = string.strip() def _finalize(self, result): """Join text fragments and collapse repeated block endings. For example, ``[{be}, " Hello ", {be}, {be}, " World!"]`` becomes ``"\nHello\nWorld!"``. """ # None means the last visited item was a block end. accum = None for item in result: if item == self.BLOCK_END: # Multiple consecutive block ends; do nothing. if accum is None: continue # First block end; yield the current string, plus a newline. yield accum.strip() + "\n" accum = None # Multiple consecutive strings; combine them. elif accum is not None: accum += item # First consecutive string; store it. else: accum = item # Yield the last string if we have not already done so. if accum is not None: yield accum.strip() def handle_data(self, data, *args, **kwargs): """Store our data if it is not on the ignore list.""" # Ignore data while an ignored container is active. if self._do_store: # Collapse whitespace before buffering visible text. Text # inside

"). n = 20000 html = "
" * n + "" * n start = default_timer() out = to_md(html) elapsed = default_timer() - start assert len(out) < 20 * n # Generous bound: this must catch a real return to quadratic # behavior, not just run fast on a quiet dev machine -- shared or # emulated build infrastructure (e.g. a busy Koji builder) can be # many times slower. assert elapsed < 15.0 # Blockquote depth is capped at BLOCKQUOTE_DEPTH_MAX assert BLOCKQUOTE_DEPTH_MAX == 4 # Each level is its own

, so every line of real content is followed by a # blank (but still "> "-prefixed) separator line. one_per_level = "

x

" * 10 + "
" * 10 out = to_md(one_per_level) lines = out.split("\n") assert len(lines) == 19 content_lines = lines[0::2] separator_lines = lines[1::2] assert len(content_lines) == 10 assert content_lines[0] == "> x" assert content_lines[1] == "> > x" assert content_lines[2] == "> > > x" assert content_lines[3] == "> > > > x" for line in content_lines[4:]: assert line == "> > > > x" # Each separator matches its preceding content line, minus the "x" for content, separator in zip(content_lines, separator_lines): assert separator == content[: -len("x")].rstrip() n = 20000 deep = "

x

" * n + "
" * n start = default_timer() out = to_md(deep) elapsed = default_timer() - start assert len(out) < 20 * n # Generous bound: this must catch a real return to quadratic # behavior, not just run fast on a quiet dev machine -- shared or # emulated build infrastructure (e.g. a busy Koji builder) can be # many times slower. assert elapsed < 15.0 # When emphasis or anchor tags are nested past MAX_FRAME_DEPTH, _push_frame # returns False and the opening delimiter must NOT be emitted. depth = MAX_FRAME_DEPTH + 1 em_open = "" * depth em_close = "" * depth out_em = to_md(f"{em_open}text{em_close}") # The text must appear; no unmatched bare asterisk may leak through. assert "text" in out_em assert out_em.replace("*", "").strip() == "text" # Same guard for -- no unmatched "[" in the output. a_open = '' * depth a_close = "" * depth out_a = to_md(f"{a_open}text{a_close}") assert "text" in out_a # Count "[" and "](" -- every "[" must have a matching "](". assert out_a.count("[") == out_a.count("](") # At MAX_FRAME_DEPTH the
frame is discarded and _push_frame # returns False. bq_open = "
" * depth bq_close = "
" * depth out_bq = to_md(f"{bq_open}text{bq_close}") assert "text" in out_bq # Every ">" line-prefix must correspond to a real nested blockquote level. first_line = out_bq.splitlines()[0] if out_bq else "" gt_count = len(first_line) - len(first_line.lstrip("> ")) assert gt_count <= BLOCKQUOTE_DEPTH_MAX * 2 # ">" + " " per level # At MAX_FRAME_DEPTH the
  • frame is discarded and _push_frame returns # False. No _ListMarker must be appended without a backing frame. li_open = "
      " + "
    • " * depth li_close = "
      • " * depth + "
    " out_li = to_md(f"{li_open}text{li_close}") assert "text" in out_li def test_conversion_headings_to_bold(): """Convert supported ATX headings for chat dialects without headings.""" # Convert the common heading forms generated from HTML. assert commonmark_headings_to_bold("# Alert") == "**Alert**" assert commonmark_headings_to_bold("###### Alert") == "**Alert**" # An optional closing sequence of "#" is stripped, not kept as text. assert commonmark_headings_to_bold("## foo ##") == "**foo**" assert commonmark_headings_to_bold("# foo #####") == "**foo**" # A hash without preceding whitespace remains part of the heading text. assert commonmark_headings_to_bold("# foo#") == "**foo#**" # Preserve up to three spaces allowed before a heading. assert commonmark_headings_to_bold(" # one space") == " **one space**" assert commonmark_headings_to_bold(" # three spaces") == ( " **three spaces**" ) # Four leading spaces make an indented code block, not a heading. four_spaces = " # four spaces" assert commonmark_headings_to_bold(four_spaces) == four_spaces # Empty headings do not produce empty bold markers. assert commonmark_headings_to_bold("###") == "" assert commonmark_headings_to_bold("### ") == "" # Heading text requires whitespace after its opening hashes. literal = "#nospace" assert commonmark_headings_to_bold(literal) == literal # Inline code spans are never touched. assert commonmark_headings_to_bold("`# inline code`") == ( "`# inline code`" ) # Backtick and tilde fences protect heading-like code. fenced_backtick = "```\n# not a heading\n```" assert commonmark_headings_to_bold(fenced_backtick) == fenced_backtick fenced_tilde = "~~~\n# not a heading either\n~~~" assert commonmark_headings_to_bold(fenced_tilde) == fenced_tilde # An unfinished fence protects the remaining text. unterminated = "```\n# still not a heading\nmore text" assert commonmark_headings_to_bold(unterminated) == unterminated # A real heading before and after a fenced block is still converted. mixed = "# Before\n```\n# inside\n```\n# After" assert commonmark_headings_to_bold(mixed) == ( "**Before**\n```\n# inside\n```\n**After**" ) # Preserve blockquote markers emitted by HTML-to-CommonMark conversion. assert commonmark_headings_to_bold("> # Alert") == "> **Alert**" assert commonmark_headings_to_bold("> > # Alert") == "> > **Alert**" assert commonmark_headings_to_bold("> > > # Alert") == ("> > > **Alert**") # Preserve unordered and ordered list markers. assert commonmark_headings_to_bold("- # Alert") == "- **Alert**" assert commonmark_headings_to_bold("* # Alert") == "* **Alert**" assert commonmark_headings_to_bold("+ # Alert") == "+ **Alert**" assert commonmark_headings_to_bold("1. # Alert") == "1. **Alert**" assert commonmark_headings_to_bold("2) # Alert") == "2) **Alert**" # Preserve combined blockquote and list markers. assert commonmark_headings_to_bold("> - # Alert") == "> - **Alert**" # Keep the blockquote marker for an empty heading. assert commonmark_headings_to_bold("> ###") == "> " # Recognize CRLF fences without protecting later headings. crlf_fence = "```\r\ncode\r\n```\r\n# Real Heading" assert commonmark_headings_to_bold(crlf_fence) == ( "```\r\ncode\r\n```\r\n**Real Heading**" ) # Invalid backtick fence labels do not protect later headings. invalid_opener = ( "Some `inline` text\n" "```code`with`backtick info string\n" "more text\n" "# Real Heading" ) assert commonmark_headings_to_bold(invalid_opener) == ( "Some `inline` text\n" "```code`with`backtick info string\n" "more text\n" "**Real Heading**" ) # Tilde fence labels may contain backticks. tilde_with_backtick = "~~~code`ok\nreal code\n~~~" assert ( commonmark_headings_to_bold(tilde_with_backtick) == tilde_with_backtick ) # Preserve heading-like text inside a quoted tilde fence. quoted_tilde_fence = "> ~~~\n> # literal code\n> ~~~" assert ( commonmark_headings_to_bold(quoted_tilde_fence) == quoted_tilde_fence ) # Repeating ``"- "`` starts a sibling list item, so these are three # separate items. The middle heading remains real Markdown and converts. three_sibling_items = "- ~~~\n- # literal code\n- ~~~~" assert commonmark_headings_to_bold(three_sibling_items) == ( "- ~~~\n- **literal code**\n- ~~~~" ) # A backtick closer wider than its opener still closes the fence, even # when both are nested inside a blockquote. quoted_wider_closer = "> ```\n> # literal code\n> ````" assert ( commonmark_headings_to_bold(quoted_wider_closer) == quoted_wider_closer ) # Nested blockquotes around a fence are recognized at every level. nested_quoted_fence = "> > ~~~\n> > # literal code\n> > ~~~" assert ( commonmark_headings_to_bold(nested_quoted_fence) == nested_quoted_fence ) # Quote markers may have up to three leading spaces. assert commonmark_headings_to_bold(" > # Alert") == " > **Alert**" indented_quoted_fence = " > ~~~\n > # literal code\n > ~~~" assert ( commonmark_headings_to_bold(indented_quoted_fence) == indented_quoted_fence ) # Four leading spaces create indented code, not a top-level fence. # The following real heading must therefore still be converted. four_space_fence_then_heading = ( " ~~~\n not a real fence\n ~~~\n# Real Heading" ) assert commonmark_headings_to_bold(four_space_fence_then_heading) == ( " ~~~\n not a real fence\n ~~~\n**Real Heading**" ) # An ordered-list marker can be wider than three characters ("123. " # is five), so its continuation lines need more than three leading # spaces too. A real heading after the fence must still convert. wide_ordered_fence = "123. ~~~\n # literal\n ~~~\n\n# real" assert commonmark_headings_to_bold(wide_ordered_fence) == ( "123. ~~~\n # literal\n ~~~\n\n**real**" ) # A list containing a quote puts the list marker first, while continuation # lines replace it with spaces. Both prefix orders belong to one container. list_then_quote_fence = "- > ~~~\n > # literal\n > ~~~\n\n# real" assert commonmark_headings_to_bold(list_then_quote_fence) == ( "- > ~~~\n > # literal\n > ~~~\n\n**real**" ) # Up to three leading spaces may belong to a top-level fence rather than # a list. Its heading-like content must remain protected. lightly_indented_fence = " ~~~\n# literal\n ~~~\n# real" assert commonmark_headings_to_bold(lightly_indented_fence) == ( " ~~~\n# literal\n ~~~\n**real**" ) # Opening and closing fences have independent indentation allowances. mismatched_indent_fence = "~~~\n# literal\n ~~~\n# real" assert commonmark_headings_to_bold(mismatched_indent_fence) == ( "~~~\n# literal\n ~~~\n**real**" ) # The same closer slack applies inside a blockquote. quoted_mismatched_indent_fence = "> ~~~\n> # literal\n> ~~~\n> # real" assert commonmark_headings_to_bold(quoted_mismatched_indent_fence) == ( "> ~~~\n> # literal\n> ~~~\n> **real**" ) # A lightly indented fence can continue a list item without repeating # its marker. An unfinished fence stops when that list item ends. unclosed_narrow_list_fence = "- intro\n ~~~\n # literal\n\n# real" assert commonmark_headings_to_bold(unclosed_narrow_list_fence) == ( "- intro\n ~~~\n # literal\n\n**real**" ) # A later top-level fence cannot close the list's unfinished fence. unclosed_narrow_list_fence_with_later_fence = ( "- intro\n ~~~\n # literal\n\n# real\n\n~~~\nunrelated\n~~~" ) assert commonmark_headings_to_bold( unclosed_narrow_list_fence_with_later_fence ) == ("- intro\n ~~~\n # literal\n\n**real**\n\n~~~\nunrelated\n~~~") # Blank lines before the fence may remain within the list item. unclosed_narrow_list_fence_with_blank = ( "- intro\n\n ~~~\n # literal\n\n# real" ) assert commonmark_headings_to_bold( unclosed_narrow_list_fence_with_blank ) == ("- intro\n\n ~~~\n # literal\n\n**real**") # Light indentation without an earlier list marker is top-level. unmarked_indent_no_list_behind_it = ( "Some intro text\n ~~~\n# literal\n ~~~\n# real" ) assert commonmark_headings_to_bold(unmarked_indent_no_list_behind_it) == ( "Some intro text\n ~~~\n# literal\n ~~~\n**real**" ) # The paragraph lazily continues the list, but one-space fence indentation # is still insufficient for the two-space item. list_ended_by_unindented_paragraph = ( "- intro\nunindented paragraph\n ~~~\n# literal\n ~~~\n# real" ) assert commonmark_headings_to_bold(list_ended_by_unindented_paragraph) == ( "- intro\nunindented paragraph\n ~~~\n# literal\n ~~~\n**real**" ) # Indented list text may appear between the marker and fence. unclosed_narrow_list_fence_with_paragraph = ( "- intro\n more text in the same item\n ~~~\n # literal\n\n# real" ) assert commonmark_headings_to_bold( unclosed_narrow_list_fence_with_paragraph ) == ( "- intro\n more text in the same item\n ~~~\n # literal\n\n**real**" ) # The HTML converter replaces a list marker with equal-width spaces on # continuation lines. Test that real output as well as synthetic input. list_only_fence_html = ( "
    • # literal\nmore
    " "

    Real Heading

    " ) list_only_fence_body = html_to_markdown(list_only_fence_html) assert list_only_fence_body == ( "- ```\n # literal\n more\n ```\n\n# Real Heading" ) converted = commonmark_headings_to_bold(list_only_fence_body) # The heading-like line inside the fence stays literal code. assert " # literal\n" in converted # A real heading placed after the fenced block still converts. assert converted.endswith("\n**Real Heading**") # Also cover a preceding paragraph and the wider numbered-list marker. text_then_fence_html = ( "
    • intro
      # literal\nmore
    " "

    Real Heading

    " ) text_then_fence_body = html_to_markdown(text_then_fence_html) assert text_then_fence_body == ( "- intro\n ```\n # literal\n more\n ```\n\n# Real Heading" ) converted = commonmark_headings_to_bold(text_then_fence_body) assert " # literal\n" in converted assert converted.endswith("\n**Real Heading**") ordered_fence_html = ( "
    1. # literal\nmore
    " "

    Real Heading

    " ) ordered_fence_body = html_to_markdown(ordered_fence_html) assert ordered_fence_body == ( "1. ```\n # literal\n more\n ```\n\n# Real Heading" ) converted = commonmark_headings_to_bold(ordered_fence_body) assert " # literal\n" in converted assert converted.endswith("\n**Real Heading**") # List continuation spacing moves before the quote marker on later lines. quoted_list_fence_html = ( "
    • intro" "
      # literal\nmore
    " "

    Real Heading

    " ) quoted_list_fence_body = html_to_markdown(quoted_list_fence_html) assert quoted_list_fence_body == ( "> - intro\n > ```\n > # literal\n > more\n > ```" "\n\n# Real Heading" ) converted = commonmark_headings_to_bold(quoted_list_fence_body) assert " > # literal\n" in converted assert converted.endswith("\n**Real Heading**") # Leading list indentation contributes to the continuation width, whether # the fence begins the item or follows its introductory text. indented_marker_then_fence = " - ~~~\n # literal\n ~~~\n# real" assert commonmark_headings_to_bold(indented_marker_then_fence) == ( " - ~~~\n # literal\n ~~~\n**real**" ) indented_marker_with_intro = " - intro\n ~~~\n # literal\n\n# real" assert commonmark_headings_to_bold(indented_marker_with_intro) == ( " - intro\n ~~~\n # literal\n\n**real**" ) # A literal "- " inside a closed fence must not create list state for the # unfinished top-level fence that follows it. marker_like_text_inside_closed_fence = ( "~~~\n- literal\n ~~~\n ~~~\n# still code" ) assert commonmark_headings_to_bold( marker_like_text_inside_closed_fence ) == ("~~~\n- literal\n ~~~\n ~~~\n# still code") # Ending an inner list restores the still-open outer list width. nested_list_falls_back_to_outer = ( "- outer\n - inner\n text\n ~~~\n # literal\n\n# real" ) assert commonmark_headings_to_bold(nested_list_falls_back_to_outer) == ( "- outer\n - inner\n text\n ~~~\n # literal\n\n**real**" ) # An unindented paragraph may lazily continue an open list item. lazy_continuation_keeps_list_open = ( "- intro\nlazy continuation\n ~~~\n # literal\n\n# real" ) assert commonmark_headings_to_bold(lazy_continuation_keeps_list_open) == ( "- intro\nlazy continuation\n ~~~\n # literal\n\n**real**" ) # A new list marker ends lazy paragraph continuation. new_marker_ends_lazy_continuation = ( "- intro\nordinary text\n- newitem\n ~~~\n # literal\n\n# real" ) assert commonmark_headings_to_bold(new_marker_ends_lazy_continuation) == ( "- intro\nordinary text\n- newitem\n ~~~\n # literal\n\n**real**" ) # A list fence closer may add only three columns of indentation. # Greater indentation leaves it open until the list ends. wildly_overindented_list_closer = ( "- intro\n ```\n code\n ```\n# real" ) assert commonmark_headings_to_bold(wildly_overindented_list_closer) == ( "- intro\n ```\n code\n ```\n**real**" ) # The same three-column closer limit applies outside lists. wildly_overindented_top_level_closer = "```\ncode\n ```\n# after" assert commonmark_headings_to_bold( wildly_overindented_top_level_closer ) == ("```\ncode\n ```\n# after") # ``-\t`` reaches column four. Two spaces cannot continue that list, so # the following unfinished fence is top-level and protects the remainder. tab_expanded_marker_width = "-\tintro\n ```\n # literal\n\n# real" assert commonmark_headings_to_bold(tab_expanded_marker_width) == ( tab_expanded_marker_width ) # A tab reaches the same column as ``-\t``, keeping the fence in the list. tab_expanded_continuation_width = "-\tintro\n\t```\n\t# literal\n\n# real" assert commonmark_headings_to_bold(tab_expanded_continuation_width) == ( "-\tintro\n\t```\n\t# literal\n\n**real**" ) # Accept quote-first continuation lines as well as Apprise's list-first # output when a fenced block is nested in both containers. quote_then_list_continuation = "- > ~~~\n> # literal\n> ~~~\n\n# real" assert commonmark_headings_to_bold(quote_then_list_continuation) == ( "- > ~~~\n> # literal\n> ~~~\n\n**real**" ) # A quote-first closer still needs the list's full indentation. quote_then_list_insufficient_width = ( "- > ~~~\n> # literal\n> ~~~\n> ~~~\n\n# real" ) assert commonmark_headings_to_bold(quote_then_list_insufficient_width) == ( "- > ~~~\n> # literal\n> ~~~\n> ~~~\n\n**real**" ) # List indentation without the required quote marker ends the container. list_width_met_but_no_quote_at_all = ( "- > ~~~\n text without quote\n> ~~~\n\n# real" ) assert commonmark_headings_to_bold(list_width_met_but_no_quote_at_all) == ( "- > ~~~\n text without quote\n> ~~~\n\n**real**" ) # A bare quote marker still satisfies its quote depth. bare_quote_marker_line_in_combo = "- > ~~~\n>\n> ~~~\n\n# real" assert commonmark_headings_to_bold(bare_quote_marker_line_in_combo) == ( "- > ~~~\n>\n> ~~~\n\n**real**" ) # A heading ends the list, making the following unfinished fence top-level. heading_ends_list_before_fence = ( "- intro\n# outside\n ~~~\n # literal\n# still code" ) assert commonmark_headings_to_bold(heading_ends_list_before_fence) == ( "- intro\n**outside**\n ~~~\n # literal\n# still code" ) # A heading inside a list marker cannot gain a lazy continuation. marker_content_is_heading = ( "- # heading\noutside\n ~~~\n # literal\n# still code" ) assert commonmark_headings_to_bold(marker_content_is_heading) == ( "- **heading**\noutside\n ~~~\n # literal\n# still code" ) # Blockquotes and thematic breaks also end lazy list continuation. blockquote_ends_list_before_fence = ( "- intro\n> outside\n ~~~\n # literal\n# still code" ) assert commonmark_headings_to_bold(blockquote_ends_list_before_fence) == ( "- intro\n> outside\n ~~~\n # literal\n# still code" ) thematic_break_ends_list_before_fence = ( "- intro\n---\n ~~~\n # literal\n# still code" ) assert commonmark_headings_to_bold( thematic_break_ends_list_before_fence ) == ("- intro\n---\n ~~~\n # literal\n# still code") # CRLF input follows the same thematic-break boundary rule. thematic_break_ends_list_crlf = ( "- intro\r\n---\r\n ~~~\r\n # literal\r\n# still code" ) assert commonmark_headings_to_bold(thematic_break_ends_list_crlf) == ( "- intro\r\n---\r\n ~~~\r\n # literal\r\n# still code" ) # A tab at column zero reaches column four, creating indented code. tab_at_column_zero_is_not_slack = "\t# literal" assert ( commonmark_headings_to_bold(tab_at_column_zero_is_not_slack) == tab_at_column_zero_is_not_slack ) tab_at_column_zero_fence_is_not_slack = "\t~~~\ncode\n\t~~~\n# real" assert commonmark_headings_to_bold( tab_at_column_zero_fence_is_not_slack ) == ("\t~~~\ncode\n\t~~~\n**real**") # A tab after a quote can remain within the three-column allowance. tab_after_quote_is_slack = ">\t# literal" assert commonmark_headings_to_bold(tab_after_quote_is_slack) == ( ">\t**literal**" ) # Tabs between nested quote markers use one column of marker padding. tab_separated_nested_quote_fence = ( ">\t>\t~~~\n>\t>\t# literal\n>\t>\t~~~\n>\t>\t# real" ) assert commonmark_headings_to_bold(tab_separated_nested_quote_fence) == ( ">\t>\t~~~\n>\t>\t# literal\n>\t>\t~~~\n>\t>\t**real**" ) # Nested quote markers also work without separating spaces. unspaced_nested_quote_fence = ">>~~~\n>>literal\n>>~~~\n>># real" assert commonmark_headings_to_bold(unspaced_nested_quote_fence) == ( ">>~~~\n>>literal\n>>~~~\n>>**real**" ) # Tab-separated quote/list content uses indentation on continuation lines. tab_separated_quote_list_fence = ( ">\t-\tintro\n>\t ~~~\n>\t # literal\n>\t ~~~\n>\t# real" ) assert commonmark_headings_to_bold(tab_separated_quote_list_fence) == ( ">\t-\tintro\n>\t ~~~\n>\t # literal\n>\t ~~~\n>\t**real**" ) # HTML blocks end lazy list paragraphs, making the next fence top-level. html_block_ends_list_before_fence = ( "- intro\n
    \nhtml\n
    \n\n ~~~\n # literal\n# still code" ) assert commonmark_headings_to_bold(html_block_ends_list_before_fence) == ( "- intro\n
    \nhtml\n
    \n\n ~~~\n # literal\n# still code" ) html_comment_ends_list_before_fence = ( "- intro\n\n ~~~\n # literal\n# still code" ) assert commonmark_headings_to_bold( html_comment_ends_list_before_fence ) == ("- intro\n\n ~~~\n # literal\n# still code") # A backtick in a backtick fence's info string makes the opener invalid. invalid_backtick_info_string_not_a_fence = ( "- intro\n ```bad`info\nlazy\n ~~~\n # literal\n# real" ) assert commonmark_headings_to_bold( invalid_backtick_info_string_not_a_fence ) == ("- intro\n ```bad`info\nlazy\n ~~~\n # literal\n**real**") # Four extra columns inside a two-column list create indented code. six_space_indent_not_a_fence = ( "- intro\n ```\nlazy\n ~~~\n # literal\n# real" ) assert commonmark_headings_to_bold(six_space_indent_not_a_fence) == ( "- intro\n ```\nlazy\n ~~~\n # literal\n**real**" ) # A blank line ends a blockquote fence but may remain in a plain list. blank_line_ends_blockquote_fence = "> ~~~\n> code\n\n> # real" assert commonmark_headings_to_bold(blank_line_ends_blockquote_fence) == ( "> ~~~\n> code\n\n> **real**" ) # A fence may use up to three extra columns inside an active list. fence_with_extra_slack_stays_in_list = ( "1. item\n ~~~\n # literal\n ~~~\n# real" ) assert commonmark_headings_to_bold( fence_with_extra_slack_stays_in_list ) == ("1. item\n ~~~\n # literal\n ~~~\n**real**") # Active-list indentation can identify a heading without another marker. assert commonmark_headings_to_bold("- item\n # nested") == ( "- item\n **nested**" ) assert commonmark_headings_to_bold("- item\n\t# nested") == ( "- item\n\t**nested**" ) # Content inside an HTML block passes through unchanged. heading_inside_html_block_untouched = "
    \n# literal\n
    " assert ( commonmark_headings_to_bold(heading_inside_html_block_untouched) == heading_inside_html_block_untouched ) # Fence-looking text inside HTML must not consume the following document. fence_look_alike_inside_html_block = "
    \n~~~\n
    \n\n# real" assert ( commonmark_headings_to_bold(fence_look_alike_inside_html_block) == "
    \n~~~\n
    \n\n**real**" ) # A lowercase CDATA look-alike is ordinary text. lowercase_cdata_is_not_html_block = ( "- intro\n " * 9 + "# real" assert commonmark_headings_to_bold(heading_past_old_depth_cap) == ( "> " * 9 + "**real**" ) # An HTML block is recognized even after an active blockquote prefix, # not just at the very start of a line. html_block_inside_blockquote = ">
    \n> # literal\n>
    " assert ( commonmark_headings_to_bold(html_block_inside_blockquote) == html_block_inside_blockquote ) # A tag-looking line inside a real fence is literal fenced content, # not an HTML block start -- it must not swallow what follows the # fence's own close. html_look_alike_inside_fence = "~~~\n\ncontent\n\nafter\n" "\n# real" ) assert commonmark_headings_to_bold(raw_tag_requires_exact_close) == ( "\nafter\n" "\n**real**" ) # A heading between two same-length backtick runs must not look like # a code span spanning across it -- block structure is resolved # before inline code-span pairing. backtick_run_does_not_cross_heading = "before ``\n# real\nafter ``" assert commonmark_headings_to_bold( backtick_run_does_not_cross_heading ) == ("before ``\n**real**\nafter ``") # Type 7: a complete tag for any other name, alone on its own line, # starts an HTML block too -- but only when not interrupting an # already-open paragraph. custom_tag_at_document_start_protects_content = ( "\n# literal\n" ) assert ( commonmark_headings_to_bold( custom_tag_at_document_start_protects_content ) == custom_tag_at_document_start_protects_content ) custom_tag_cannot_interrupt_paragraph = "some text\n\n# real" assert commonmark_headings_to_bold( custom_tag_cannot_interrupt_paragraph ) == ("some text\n\n**real**") # A space before the self-closing slash makes this an invalid tag. malformed_self_close_not_a_tag = "\n# real" assert commonmark_headings_to_bold(malformed_self_close_not_a_tag) == ( "\n**real**" ) # A ">" inside a quoted attribute does not end the tag early. quoted_attribute_value_with_gt = '\n# literal' assert ( commonmark_headings_to_bold(quoted_attribute_value_with_gt) == quoted_attribute_value_with_gt ) # Any raw-tag closer ends a type-1 block, even if its name differs. raw_tag_close_need_not_match_open = "\nafter" close = text.index("") + len("") assert commonmark_module._commonmark_html_block_spans(text) == [ (0, close + 1) ] # A comment closes at its own terminator, wherever it appears. text = "\nafter" close = text.index("-->") + len("-->") assert commonmark_module._commonmark_html_block_spans(text) == [ (0, close + 1) ] # An unterminated comment runs to the end of the text. text = "\nafter" spans = commonmark_module._commonmark_leaf_block_spans(text) assert spans == [(0, len("> \n"), "html")] # When the quote holds all the way through and no terminator ever # appears, the block runs to the end of the text. text = "> \nHi", "\nHi", ), ( '\nHi', '\nHi', ), (" ", " "), ("<3 all good", "<3 all good"), ], ) @mock.patch("requests.post") def test_plugin_twilio_call_twiml_detection(mock_post, body, twiml): """A body starting with "<" is relayed as TwiML; text is spoken.""" response = mock.Mock() response.content = b"{}" response.status_code = requests.codes.created mock_post.return_value = response aobj = Apprise() assert aobj.add( "twilio://AC{}:{}@15551233456/15559876543?method=call".format( "a" * 32, "b" * 32 ) ) assert aobj.notify(body=body) assert mock_post.call_args[1]["data"]["Twiml"] == twiml @mock.patch("requests.post") def test_plugin_twilio_sms_title_joins_body(mock_post): """An SMS still carries the title at the top of its body.""" response = mock.Mock() response.content = b"{}" response.status_code = requests.codes.created mock_post.return_value = response aobj = Apprise() assert aobj.add( "twilio://AC{}:{}@15551233456/15559876543".format("a" * 32, "b" * 32) ) assert aobj.notify(body="body", title="title") assert mock_post.call_args[1]["data"]["Body"] == "title\r\nbody" @mock.patch("requests.post") def test_plugin_twilio_call_say_injection(mock_post): """Text cannot close the Say element early.""" response = mock.Mock() response.content = b"{}" response.status_code = requests.codes.created mock_post.return_value = response aobj = Apprise() assert aobj.add( "twilio://AC{}:{}@15551233456/15559876543?method=call".format( "a" * 32, "b" * 32 ) ) expected = ( "t</Say><Hangup/>" "b</Say><Play>x</Play>" ) # Both a declared text body and undeclared content are escaped for body_format in ("text", None): assert aobj.notify( body="bx", title="t", body_format=body_format, ) assert mock_post.call_args[1]["data"]["Twiml"] == expected @pytest.mark.parametrize("overflow", ["split", "truncate"]) @mock.patch("requests.post") def test_plugin_twilio_call_twiml_not_split(mock_post, overflow): """Valid TwiML within Twilio's limit is sent whole as one call.""" response = mock.Mock() response.content = b"{}" response.status_code = requests.codes.created mock_post.return_value = response aobj = Apprise() assert aobj.add( "twilio://AC{}:{}@15551233456/15559876543?method=call" "&overflow={}".format("a" * 32, "b" * 32, overflow) ) # A 3900 character TwiML document, with a long title that is ignored twiml = "{}".format("x" * 3868) assert len(twiml) == 3900 assert aobj.notify(body=twiml, title="t" * 250, body_format="text") assert mock_post.call_count == 1 assert mock_post.call_args[1]["data"]["Twiml"] == twiml caronc-apprise-dfec414/tests/test_plugin_twist.py000066400000000000000000000452761526720371000224400ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from json import dumps # Disable logging for a cleaner testing output import logging from unittest import mock from helpers import AppriseURLTester import pytest import requests from apprise import Apprise, NotifyFormat from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.twist import NotifyTwist logging.disable(logging.CRITICAL) # Our Testing URLs apprise_url_tests = ( ( "twist://", { # Missing Email and Login "instance": None, }, ), ( "twist://:@/", { "instance": None, }, ), ( "twist://user@example.com/", { # No password "instance": None, }, ), ( "twist://user@example.com/password", { # Password acceptable as first entry in path "instance": NotifyTwist, # Expected notify() response is False because internally we would # have failed to login "notify_response": False, }, ), ( "twist://password:user1@example.com", { # password:login acceptable "instance": NotifyTwist, # Expected notify() response is False because internally we would # have failed to login "notify_response": False, # Our expected url(privacy=True) startswith() response: "privacy_url": "twist://****:user1@example.com", }, ), ( "twist://password:user2@example.com", { # password:login acceptable "instance": NotifyTwist, # Expected notify() response is False because internally we would # have logged in, but we would have failed to look up the #General # channel and workspace. "requests_response_text": { # Login expected response "id": 1234, "default_workspace": 9876, }, "notify_response": False, }, ), ( "twist://password:user2@example.com", { "instance": NotifyTwist, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( "twist://password:user2@example.com", { "instance": NotifyTwist, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), ) def test_plugin_twist_urls(): """NotifyTwist() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() def test_plugin_twist_init(): """NotifyTwist() init()""" with pytest.raises(AppriseImproperlyConfigured): NotifyTwist(email="invalid", targets=None) with pytest.raises(AppriseImproperlyConfigured): NotifyTwist(email="user@domain", targets=None) # Simple object initialization result = NotifyTwist( password="abc123", email="user@domain.com", targets=None ) assert result.user == "user" assert result.host == "domain.com" assert result.password == "abc123" # Channel Instantiation by name obj = Apprise.instantiate("twist://password:user@example.com/#Channel") assert isinstance(obj, NotifyTwist) # Channel Instantiation by id (faster if you know the translation) obj = Apprise.instantiate("twist://password:user@example.com/12345") assert isinstance(obj, NotifyTwist) # Invalid Channel - (max characters is 64), the below drops it obj = Apprise.instantiate( "twist://password:user@example.com/{}".format("a" * 65) ) assert isinstance(obj, NotifyTwist) # No User detect result = NotifyTwist.parse_url("twist://example.com") assert result is None # test usage of to= result = NotifyTwist.parse_url( "twist://password:user@example.com?to=#channel" ) assert isinstance(result, dict) assert "user" in result assert result["user"] == "user" assert "host" in result assert result["host"] == "example.com" assert "password" in result assert result["password"] == "password" assert "targets" in result assert isinstance(result["targets"], list) is True assert len(result["targets"]) == 1 assert "#channel" in result["targets"] @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_twist_auth(mock_post, mock_get): """NotifyTwist() login/logout()""" # Prepare Mock mock_get.return_value = requests.Request() mock_post.return_value = requests.Request() mock_post.return_value.status_code = requests.codes.ok mock_get.return_value.status_code = requests.codes.ok mock_post.return_value.content = dumps( { "token": "2e82c1e4e8b0091fdaa34ff3972351821406f796", "default_workspace": 12345, } ) mock_get.return_value.content = mock_post.return_value.content # Instantiate an object obj = Apprise.instantiate("twist://password:user@example.com/#Channel") assert isinstance(obj, NotifyTwist) # not logged in yet obj.logout() assert obj.login() is True # Clear our channel listing obj.channels.clear() # No channels mean there is no internal migration/lookups required assert obj._channel_migration() is True # Workspace Success mock_post.return_value.content = dumps( [ { "name": "TesT", "id": 1, }, { "name": "tESt2", "id": 2, }, ] ) mock_get.return_value.content = mock_post.return_value.content results = obj.get_workspaces() assert len(results) == 2 assert "test" in results assert results["test"] == 1 assert "test2" in results assert results["test2"] == 2 mock_post.return_value.content = dumps( [ { "name": "ChaNNEL1", "id": 1, }, { "name": "chaNNel2", "id": 2, }, ] ) mock_get.return_value.content = mock_post.return_value.content results = obj.get_channels(wid=1) assert len(results) == 2 assert "channel1" in results assert results["channel1"] == 1 assert "channel2" in results assert results["channel2"] == 2 # Test result failure response mock_post.return_value.status_code = 403 mock_get.return_value.status_code = 403 assert obj.get_workspaces() == {} # Return things how they were mock_post.return_value.status_code = requests.codes.ok mock_get.return_value.status_code = requests.codes.ok # Forces call to logout: del obj # # Authentication failures # mock_post.return_value.status_code = 403 mock_get.return_value.status_code = 403 # Instantiate an object obj = Apprise.instantiate("twist://password:user@example.com/#Channel") assert isinstance(obj, NotifyTwist) # Authentication failed assert obj.get_workspaces() == {} assert obj.get_channels(wid=1) == {} assert obj._channel_migration() is False assert obj.send("body", "title") is False obj = Apprise.instantiate("twist://password:user@example.com/#Channel") assert isinstance(obj, NotifyTwist) # Calling logout on an object already logged out obj.logout() @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_twist_cache(mock_post, mock_get): """NotifyTwist() Cache Handling.""" def _response(url, *args, **kwargs): # Default configuration request = mock.Mock() request.status_code = requests.codes.ok request.content = "{}" if url.endswith("/login"): # Simulate a successful login request.content = dumps( { "token": "2e82c1e4e8b0091fdaa34ff3972351821406f796", "default_workspace": 1, } ) elif url.endswith("workspaces/get"): request.content = dumps( [ { "name": "TeamA", "id": 1, }, { "name": "TeamB", "id": 2, }, ] ) elif url.endswith("channels/get"): request.content = dumps( [ { "name": "ChanA", "id": 1, }, { "name": "ChanB", "id": 2, }, ] ) return request mock_get.side_effect = _response mock_post.side_effect = _response # Instantiate an object obj = Apprise.instantiate( "twist://password:user@example.com/" "#ChanB/1:1/TeamA:ChanA/Ignore:Chan/3:1" ) assert isinstance(obj, NotifyTwist) # Will detect channels except Ignore:Chan assert obj._channel_migration() is False # Add another channel obj.channels.add("ChanB") assert obj._channel_migration() is True # Nothing more to detect the second time around assert obj._channel_migration() is True # Send a notification assert obj.send("body", "title") is True def _can_not_send_response(url, *args, **kwargs): """Simulate a case where we can't send a notification.""" # Force a failure request = mock.Mock() request.status_code = 403 request.content = "{}" return request mock_get.side_effect = _can_not_send_response mock_post.side_effect = _can_not_send_response # Send a notification and fail at it assert obj.send("body", "title") is False @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_twist_fetch(mock_post, mock_get): """NotifyTwist() fetch() fetch() is a wrapper that handles all kinds of edge cases and even attempts to re-authenticate to the Twist server if our token happens to expire. This tests these edge cases """ # Track our iteration; by tracing within an object, we can re-reference # it within a function scope. cache = { "first_time": True, } def _reauth_response(url, *args, **kwargs): """Tests re-authentication process and then a successful retry.""" # Default configuration request = mock.Mock() request.status_code = requests.codes.ok # Simulate a successful login request.content = dumps( { "token": "2e82c1e4e8b0091fdaa34ff3972351821406f796", "default_workspace": 12345, } ) if url.endswith("threads/add") and cache["first_time"] is True: # First time iteration; act as if we failed; our second iteration # will not enter this and be successful. This is done by simply # toggling the first_time flag: cache["first_time"] = False # otherwise, we set our first-time failure settings request.status_code = 403 request.content = dumps( { "error_code": 200, "error_string": "Invalid token", } ) return request mock_get.side_effect = _reauth_response mock_post.side_effect = _reauth_response # Instantiate an object obj = Apprise.instantiate("twist://password:user@example.com/#Channel/34") assert isinstance(obj, NotifyTwist) # Simulate a re-authentication postokay, response = obj._fetch("threads/add") ########################################################################## cache = { "first_time": True, } def _reauth_exception_response(url, *args, **kwargs): """Tests exception thrown after re-authentication process.""" # Default configuration request = mock.Mock() request.status_code = requests.codes.ok # Simulate a successful login request.content = dumps( { "token": "2e82c1e4e8b0091fdaa34ff3972351821406f796", "default_workspace": 12345, } ) if url.endswith("threads/add") and cache["first_time"] is True: # First time iteration; act as if we failed; our second iteration # will not enter this and be successful. This is done by simply # toggling the first_time flag: cache["first_time"] = False # otherwise, we set our first-time failure settings request.status_code = 403 request.content = dumps( { "error_code": 200, "error_string": "Invalid token", } ) elif url.endswith("threads/add") and cache["first_time"] is False: # unparseable response throws the exception request.status_code = 200 request.content = "{" return request mock_get.side_effect = _reauth_exception_response mock_post.side_effect = _reauth_exception_response # Instantiate an object obj = Apprise.instantiate("twist://password:user@example.com/#Channel/34") assert isinstance(obj, NotifyTwist) # Simulate a re-authentication postokay, response = obj._fetch("threads/add") ########################################################################## cache = { "first_time": True, } def _reauth_failed_response(url, *args, **kwargs): """Tests re-authentication process and have it not succeed.""" # Default configuration request = mock.Mock() request.status_code = requests.codes.ok # Simulate a successful login request.content = dumps( { "token": "2e82c1e4e8b0091fdaa34ff3972351821406f796", "default_workspace": 12345, } ) if url.endswith("threads/add") and cache["first_time"] is True: # First time iteration; act as if we failed; our second iteration # will not enter this and be successful. This is done by simply # toggling the first_time flag: cache["first_time"] = False # otherwise, we set our first-time failure settings request.status_code = 403 request.content = dumps( { "error_code": 200, "error_string": "Invalid token", } ) elif url.endswith("/login") and cache["first_time"] is False: # Fail to login request.status_code = 403 request.content = "{}" return request mock_get.side_effect = _reauth_failed_response mock_post.side_effect = _reauth_failed_response # Instantiate an object obj = Apprise.instantiate("twist://password:user@example.com/#Channel/34") assert isinstance(obj, NotifyTwist) # Simulate a re-authentication postokay, response = obj._fetch("threads/add") def _unparseable_json_response(url, *args, **kwargs): # Default configuration request = mock.Mock() request.status_code = requests.codes.ok request.content = "{" return request mock_get.side_effect = _unparseable_json_response mock_post.side_effect = _unparseable_json_response # Instantiate our object obj = Apprise.instantiate("twist://password:user@example.com/#Channel/34") assert isinstance(obj, NotifyTwist) # Simulate a re-authentication postokay, response = obj._fetch("threads/add") assert postokay is True # When we can't parse the content, we still default to an empty # dictionary assert response == {} @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_twist_html_to_markdown_format(mock_post, mock_get): """NotifyTwist(): HTML body is converted to Markdown.""" def _response(url, *args, **kwargs): # Default configuration request = mock.Mock() request.status_code = requests.codes.ok if url.endswith("/login"): # Simulate a successful login request.content = dumps( { "token": "2e82c1e4e8b0091fdaa34ff3972351821406f796", "default_workspace": 1, } ) else: # All other endpoints return an empty JSON object request.content = "{}" return request mock_get.side_effect = _response mock_post.side_effect = _response # Twist has class-level notify_format = MARKDOWN, so no ?format= # is needed; incoming HTML bodies are converted before dispatch aobj = Apprise() assert aobj.add("twist://password:user@example.com/1:1") # Notify with an HTML body; the framework converts it to Markdown # before dispatching to the Twist plugin assert ( bool( aobj.notify( body="hello world", body_format=NotifyFormat.HTML, ) ) is True ) # Two POST calls are expected: login then threads/add assert mock_post.call_count == 2 # The body must arrive as Markdown in the threads/add payload data = mock_post.call_args_list[1][1]["data"] assert data["content"] == "**hello** *world*" caronc-apprise-dfec414/tests/test_plugin_twitter.py000066400000000000000000001341671526720371000227660ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from datetime import datetime, timezone import json import logging import os from unittest.mock import Mock, patch from helpers import AppriseURLTester import pytest import requests from apprise import Apprise, AppriseAttachment, NotifyType from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.base import _delivery_tracker from apprise.plugins.twitter import NotifyTwitter # Disable logging for a cleaner testing output logging.disable(logging.CRITICAL) # Attachment Directory TEST_VAR_DIR = os.path.join(os.path.dirname(__file__), "var") TWITTER_SCREEN_NAME = "apprise" # Our Testing URLs apprise_url_tests = ( ################################## # NotifyTwitter ################################## ( "twitter://", { # Missing Consumer API Key "instance": AppriseImproperlyConfigured, }, ), ( "twitter://:@/", { "instance": AppriseImproperlyConfigured, }, ), ( "twitter://consumer_key", { # Missing Keys "instance": AppriseImproperlyConfigured, }, ), ( "twitter://consumer_key/consumer_secret/", { # Missing Keys "instance": AppriseImproperlyConfigured, }, ), ( "twitter://consumer_key/consumer_secret/atoken1/", { # Missing Access Secret "instance": AppriseImproperlyConfigured, }, ), ( "twitter://consumer_key/consumer_secret/atoken2/access_secret", { # No user mean's we message ourselves "instance": NotifyTwitter, # Expected notify() response False (because we won't be able # to detect our user); default mock has no v2 data key "notify_response": False, # Our expected url(privacy=True) startswith() response: "privacy_url": "x://c...y/****/a...2/****", }, ), ( ( "twitter://consumer_key/consumer_secret/atoken3/access_secret" "?cache=no" ), { # No user mean's we message ourselves "instance": NotifyTwitter, # v2 whoami format: {"data": {"id": "...", "username": "..."}} "requests_response_text": { "data": {"id": "12345", "username": "test"}, "media_id": 123, }, }, ), ( "twitter://consumer_key/consumer_secret/atoken4/access_secret", { # No user mean's we message ourselves "instance": NotifyTwitter, # v2 whoami format "requests_response_text": { "data": {"id": "12345", "username": "test"}, "media_id": 123, }, }, ), # A duplicate of the entry above, this will cause cache to be referenced ( "twitter://consumer_key/consumer_secret/atoken5/access_secret", { # No user mean's we message ourselves "instance": NotifyTwitter, # v2 whoami format "requests_response_text": { "data": {"id": "12345", "username": "test"}, "media_id": 123, }, }, ), # handle cases where the screen_name is missing from the response causing # an exception during parsing ( "twitter://consumer_key/consumer_secret2/atoken6/access_secret", { # No user mean's we message ourselves "instance": NotifyTwitter, # v1.1-format response (missing "data" key) causes _whoami to fail "requests_response_text": { "id": 12345, "media_id": 123, }, # due to a mangled response_text we'll fail "notify_response": False, }, ), ( "twitter://user@consumer_key/csecret2/atoken7/access_secret/-/%/", { # One Invalid User "instance": NotifyTwitter, # Expected notify() response False (because we won't be able # to detect our user) "notify_response": False, }, ), ( ( "twitter://user@consumer_key/csecret/atoken8/access_secret" "?cache=No&batch=No" ), { # No Cache & No Batch "instance": NotifyTwitter, # v2 user lookup format "requests_response_text": { "data": [{"id": "12345", "username": "user"}] }, }, ), ( "twitter://user@consumer_key/csecret/atoken9/access_secret", { # We're good! "instance": NotifyTwitter, # v2 user lookup format "requests_response_text": { "data": [{"id": "12345", "username": "user"}] }, }, ), ( "twitter://user@consumer_key/csecret/atoken11/access_secret", { # We're identifying the same user we already sent to "instance": NotifyTwitter, "notify_response": False, }, ), ( "tweet://ckey/csecret/atoken12/access_secret", { # A Public Tweet "instance": NotifyTwitter, }, ), ( "twitter://user@ckey/csecret/atoken13/access_secret?mode=invalid", { # An invalid mode "instance": AppriseImproperlyConfigured, }, ), ( ( "twitter://usera@consumer_key/consumer_secret/atoken14/" "access_secret/user/?to=userb" ), { # We're good! "instance": NotifyTwitter, # v2 user lookup format with multiple entries and a garbage entry # to test exception handling "requests_response_text": { "data": [ {"id": "12345", "username": "usera"}, {"id": "12346", "username": "userb"}, { # A garbage entry we can test exception handling on }, ] }, }, ), ( "twitter://ckey/csecret/atoken15/access_secret", { "instance": NotifyTwitter, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( "twitter://ckey/csecret/atoken16/access_secret", { "instance": NotifyTwitter, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), ( "twitter://ckey/csecret/atoken17/access_secret?mode=tweet", { "instance": NotifyTwitter, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), ) def good_response(data): """Prepare a good response.""" response = Mock() response.content = json.dumps(data) response.status_code = requests.codes.ok return response def bad_response(data): """Prepare a bad response.""" response = Mock() response.content = json.dumps(data) response.status_code = requests.codes.internal_server_error return response @pytest.fixture def twitter_url(): ckey = "ckey" csecret = "csecret" akey = "akey" asecret = "asecret" url = f"twitter://{ckey}/{csecret}/{akey}/{asecret}" return url @pytest.fixture def good_message_response(): """Prepare a good v2 whoami response.""" # v2 /users/me format: {"data": {"id": "...", "username": "..."}} response = good_response( { "data": { "id": "9876", "username": TWITTER_SCREEN_NAME, } } ) return response @pytest.fixture def bad_message_response(): """Prepare a bad message response.""" response = bad_response( { "errors": [ { "code": 999, "message": "Something failed", } ] } ) return response @pytest.fixture def good_media_response(): """Prepare a good v2 media upload response.""" # v2 /2/media/upload format: {"data": {"id": "...", ...}} response = Mock() response.content = json.dumps( { "data": { "id": "710511363345354753", "media_key": "3_710511363345354753", "expires_after_secs": 86400, "size": 11065, } } ) response.status_code = requests.codes.ok return response @pytest.fixture def bad_media_response(): """Prepare a bad media response.""" response = bad_response( { "errors": [ { "code": 93, "message": ( "This application is not allowed to access or " "delete your direct messages." ), } ] } ) return response @pytest.fixture(autouse=True) def ensure_whoami_is_mocked(mocker, good_message_response): """ Make sure requests to https://api.twitter.com/2/users/me do not escape the test harness, for all test case functions. """ mock_get = mocker.patch("requests.get") mock_get.return_value = good_message_response def test_plugin_twitter_urls(): """NotifyTwitter() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() def test_plugin_twitter_general(mocker): """NotifyTwitter() General Tests.""" mock_get = mocker.patch("requests.get") mock_post = mocker.patch("requests.post") ckey = "ckey" csecret = "csecret" akey = "akey" asecret = "asecret" # v2 user lookup response: {"data": [{"id": "...", "username": "..."}]} user_lookup_obj = { "data": [ { "username": TWITTER_SCREEN_NAME, "id": "9876", } ] } # Epoch time: epoch = datetime.fromtimestamp(0, timezone.utc) request = Mock() request.content = json.dumps(user_lookup_obj) request.status_code = requests.codes.ok request.headers = { "x-rate-limit-reset": ( (datetime.now(timezone.utc) - epoch).total_seconds() ), "x-rate-limit-remaining": 1, } # Prepare Mock mock_get.return_value = request mock_post.return_value = request # Variation Initializations obj = NotifyTwitter( ckey=ckey, csecret=csecret, akey=akey, asecret=asecret, targets=TWITTER_SCREEN_NAME, ) assert isinstance(obj, NotifyTwitter) is True assert isinstance(obj.url(), str) is True # apprise room was found assert obj.send(body="test") is True # Change our status code and try again request.status_code = 403 assert obj.send(body="test") is False assert obj.ratelimit_remaining == 1 # Return the status request.status_code = requests.codes.ok # Force a reset request.headers["x-rate-limit-remaining"] = 0 # behind the scenes, it should cause us to update our rate limit assert obj.send(body="test") is True assert obj.ratelimit_remaining == 0 # This should cause us to block request.headers["x-rate-limit-remaining"] = 10 assert obj.send(body="test") is True assert obj.ratelimit_remaining == 10 # Handle cases where we simply couldn't get this field del request.headers["x-rate-limit-remaining"] assert obj.send(body="test") is True # It remains set to the last value assert obj.ratelimit_remaining == 10 # Reset our variable back to 1 request.headers["x-rate-limit-remaining"] = 1 # Handle cases where our epoch time is wrong del request.headers["x-rate-limit-reset"] assert obj.send(body="test") is True # Return our object, but place it in the future forcing us to block request.headers["x-rate-limit-reset"] = ( datetime.now(timezone.utc) - epoch ).total_seconds() + 1 request.headers["x-rate-limit-remaining"] = 0 obj.ratelimit_remaining = 0 assert obj.send(body="test") is True # Return our object, but place it in the future forcing us to block request.headers["x-rate-limit-reset"] = ( datetime.now(timezone.utc) - epoch ).total_seconds() - 1 request.headers["x-rate-limit-remaining"] = 0 obj.ratelimit_remaining = 0 assert obj.send(body="test") is True # Return our limits to always work request.headers["x-rate-limit-reset"] = ( datetime.now(timezone.utc) - epoch ).total_seconds() request.headers["x-rate-limit-remaining"] = 1 obj.ratelimit_remaining = 1 # Alter pending targets obj.targets.append("usera") # Response still in v2 user_lookup format from above request.content = json.dumps(user_lookup_obj) assert obj.send(body="test") is True # Flush our cache forcing it is re-creating obj._user_cache = {} assert obj.send(body="test") is True # Cause content response to be None request.content = None assert obj.send(body="test") is True # Invalid JSON request.content = "{" assert obj.send(body="test") is True # Return it to a parseable string request.content = "{}" results = NotifyTwitter.parse_url( f"twitter://{ckey}/{csecret}/{akey}/{asecret}?to={TWITTER_SCREEN_NAME}" ) assert isinstance(results, dict) is True assert TWITTER_SCREEN_NAME in results["targets"] # Valid JSON response; send succeeds assert obj.send(body="test") is True # Set ourselves up to handle whoami calls # Flush out our cache obj._user_cache = {} # v2 whoami response: {"data": {"id": "...", "username": "..."}} whoami_obj = { "data": { "username": TWITTER_SCREEN_NAME, "id": "9876", } } request.content = json.dumps(whoami_obj) obj = NotifyTwitter(ckey=ckey, csecret=csecret, akey=akey, asecret=asecret) assert obj.send(body="test") is True # Alter the key forcing us to look up a new value of ourselves again obj._user_cache = {} obj._whoami_cache = None obj.ckey = "different.then.it.was" assert obj.send(body="test") is True obj._whoami_cache = None obj.ckey = "different.again" assert obj.send(body="test") is True def test_plugin_twitter_garbage_responses(mocker): """Verify garbage/invalid server responses are handled gracefully.""" mock_get = mocker.patch("requests.get") mock_post = mocker.patch("requests.post") ckey = "ckey" csecret = "csecret" akey = "akey" asecret = "asecret" # Base request mock returning HTTP 200 request = Mock() request.status_code = requests.codes.ok request.headers = {} mock_get.return_value = request mock_post.return_value = request # No targets -> _send_dm calls _whoami obj = NotifyTwitter(ckey=ckey, csecret=csecret, akey=akey, asecret=asecret) # _whoami: None content -> TypeError in loads() -> content = {} # -> no "data" key in {} -> KeyError caught -> _whoami returns {} request.content = None assert obj.send(body="test") is False # _whoami: malformed JSON -> ValueError in loads() -> content = {} # -> same path as above obj._whoami_cache = None request.content = "{" assert obj.send(body="test") is False # _whoami: valid JSON but v1.1-style response (missing "data" key) # -> KeyError in _whoami -> caught -> returns {} obj._whoami_cache = None request.content = json.dumps({"screen_name": "apprise", "id": 9876}) assert obj.send(body="test") is False # Has targets -> _send_dm calls _user_lookup obj2 = NotifyTwitter( ckey=ckey, csecret=csecret, akey=akey, asecret=asecret, targets=TWITTER_SCREEN_NAME, ) # _user_lookup: response is a list, not a dict # -> isinstance(response, dict) is False -> continue -> no results request.content = json.dumps( [{"id": "9876", "username": TWITTER_SCREEN_NAME}] ) assert obj2.send(body="test") is False # _fetch: json=False with a non-None payload -> raw body path request.content = json.dumps({}) postokay, _ = obj._fetch( "https://api.twitter.com/2/tweets", payload="raw=data", json=False, ) assert postokay is True # _fetch: HTTP 201 Created is treated as success (v2 POST endpoints) request.status_code = requests.codes.created request.content = json.dumps({"data": {"id": "1"}}) postokay, _response = obj._fetch( "https://api.twitter.com/2/tweets", payload={"text": "hi"}, ) assert postokay is True def test_plugin_twitter_edge_cases(): """NotifyTwitter() Edge Cases.""" with pytest.raises(AppriseImproperlyConfigured): NotifyTwitter(ckey=None, csecret=None, akey=None, asecret=None) with pytest.raises(AppriseImproperlyConfigured): NotifyTwitter(ckey="value", csecret=None, akey=None, asecret=None) with pytest.raises(AppriseImproperlyConfigured): NotifyTwitter(ckey="value", csecret="value", akey=None, asecret=None) with pytest.raises(AppriseImproperlyConfigured): NotifyTwitter( ckey="value", csecret="value", akey="value", asecret=None ) assert isinstance( NotifyTwitter( ckey="value", csecret="value", akey="value", asecret="value" ), NotifyTwitter, ) assert isinstance( NotifyTwitter( ckey="value", csecret="value", akey="value", asecret="value", user="l2gnux", ), NotifyTwitter, ) # Invalid Target User obj = NotifyTwitter( ckey="value", csecret="value", akey="value", asecret="value", targets="%G@rB@g3", ) assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is False ) def test_plugin_twitter_dm_caching( mocker, twitter_url, good_message_response, good_media_response ): """Verify that the `NotifyTwitter.{_user_cache,_whoami_cache}` caches work as intended.""" # This is the request to `https://api.twitter.com/2/users/me`. # Explicitly mock it here so the calls to it can be evaluated. mock_get = mocker.patch("requests.get") mock_get.return_value = good_message_response # This test case submits two notifications, so make sure to provide two # mocked responses. mock_post = mocker.patch("requests.post") mock_post.side_effect = [good_message_response, good_message_response] # Make sure to start with empty caches. if hasattr(NotifyTwitter, "_user_cache"): NotifyTwitter._user_cache = {} if hasattr(NotifyTwitter, "_whoami_cache"): NotifyTwitter._whoami_cache = {} # Create application objects. obj = Apprise.instantiate(twitter_url) # Send the first notification. assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is True ) # Test call counts. assert mock_get.call_count == 1 assert ( # v2 current-user endpoint replaced v1.1 verify_credentials mock_get.call_args_list[0][0][0] == "https://api.twitter.com/2/users/me" ) assert mock_post.call_count == 1 # v2 DM endpoint; user id "9876" comes from good_message_response assert ( mock_post.call_args_list[0][0][0] == "https://api.twitter.com/2/dm_conversations/with/9876/messages" ) # Reset the mocks to start counting calls from scratch. mock_get.reset_mock() mock_post.reset_mock() # Send another notification. assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is True ) # Calls to `users/me` will get cached by `NotifyTwitter`. # So, the `GET` request to `users/me` should only have been # issued once. assert mock_get.call_count == 0 assert mock_post.call_count == 1 def test_plugin_twitter_dm_attachments_basic( mocker, twitter_url, good_message_response, good_media_response ): """ NotifyTwitter() DM Attachment Checks - Basic """ mock_get = mocker.patch("requests.get") mock_post = mocker.patch("requests.post") # Epoch time: epoch = datetime.fromtimestamp(0, timezone.utc) mock_get.return_value = good_message_response mock_post.return_value.headers = { "x-rate-limit-reset": ( (datetime.now(timezone.utc) - epoch).total_seconds() ), "x-rate-limit-remaining": 1, } # The first response is for uploading the attachment, # the second one for posting the actual message. mock_post.side_effect = [good_media_response, good_message_response] # Create application objects. obj = Apprise.instantiate(twitter_url) attach = AppriseAttachment(os.path.join(TEST_VAR_DIR, "apprise-test.gif")) # Send our notification. tracker_token = _delivery_tracker.set(set()) try: assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is True ) finally: _delivery_tracker.reset(tracker_token) # Test call counts. assert mock_get.call_count == 1 assert ( # v2 whoami endpoint mock_get.call_args_list[0][0][0] == "https://api.twitter.com/2/users/me" ) assert mock_post.call_count == 2 assert ( # v2 media upload endpoint (available on all access tiers) mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( # v2 DM endpoint; user id "9876" comes from good_message_response mock_post.call_args_list[1][0][0] == "https://api.twitter.com/2/dm_conversations/with/9876/messages" ) def test_plugin_twitter_dm_attachments_message_fails( mocker, twitter_url, good_media_response, bad_message_response ): """Test case with a bad media response.""" mock_post = mocker.patch("requests.post") mock_post.side_effect = [good_media_response, bad_message_response] # Create application objects. obj = Apprise.instantiate(twitter_url) attach = AppriseAttachment(os.path.join(TEST_VAR_DIR, "apprise-test.gif")) # Send our notification; it will fail because of the message response. assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is False ) assert mock_post.call_count == 2 assert ( # v2 media upload endpoint (available on all access tiers) mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( # v2 DM endpoint; user id "9876" comes from good_message_response mock_post.call_args_list[1][0][0] == "https://api.twitter.com/2/dm_conversations/with/9876/messages" ) def test_plugin_twitter_dm_attachments_upload_fails( mocker, twitter_url, good_message_response, bad_media_response ): """Test case where upload fails.""" mock_post = mocker.patch("requests.post") mock_post.side_effect = [bad_media_response, good_message_response] # Create application objects. obj = Apprise.instantiate(twitter_url) attach = AppriseAttachment(os.path.join(TEST_VAR_DIR, "apprise-test.gif")) # Send our notification; it will fail because of the media response. assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is False ) # Test call counts. assert mock_post.call_count == 1 assert ( mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) def test_plugin_twitter_dm_attachments_invalid_attachment( mocker, twitter_url, good_message_response ): """Test case with an invalid attachment.""" mock_post: Mock = mocker.patch("requests.post") mock_post.side_effect = [good_media_response, good_message_response] # Create application objects. # An invalid attachment will cause a failure. obj = Apprise.instantiate(twitter_url) attach = AppriseAttachment( os.path.join(TEST_VAR_DIR, "/invalid/path/to/an/invalid/file.jpg") ) assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is False ) # Verify no post requests have been issued, because attachment is not good. assert mock_post.mock_calls == [] def test_plugin_twitter_dm_attachments_multiple( mocker, twitter_url, good_message_response, good_media_response ): """Verify multiple attachments are included with a direct message.""" mock_post = mocker.patch("requests.post") mock_post.side_effect = [ good_media_response, good_media_response, good_media_response, good_media_response, good_message_response, good_message_response, good_message_response, good_message_response, ] # 4 images are produced attach = [ os.path.join(TEST_VAR_DIR, "apprise-test.gif"), os.path.join(TEST_VAR_DIR, "apprise-test.gif"), os.path.join(TEST_VAR_DIR, "apprise-test.jpeg"), os.path.join(TEST_VAR_DIR, "apprise-test.png"), # This one is not supported, so it's ignored gracefully os.path.join(TEST_VAR_DIR, "apprise-test.mp4"), ] # Create application objects. obj = Apprise.instantiate(twitter_url) tracker_token = _delivery_tracker.set(set()) try: assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is True ) finally: _delivery_tracker.reset(tracker_token) assert mock_post.call_count == 8 # First 4 calls are v2 media uploads assert ( mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[1][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[2][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[3][0][0] == "https://api.x.com/2/media/upload" ) # Last 4 calls are DM sends via v2 endpoint; user id "9876" from # good_message_response assert ( mock_post.call_args_list[4][0][0] == "https://api.twitter.com/2/dm_conversations/with/9876/messages" ) assert ( mock_post.call_args_list[5][0][0] == "https://api.twitter.com/2/dm_conversations/with/9876/messages" ) assert ( mock_post.call_args_list[6][0][0] == "https://api.twitter.com/2/dm_conversations/with/9876/messages" ) assert ( mock_post.call_args_list[7][0][0] == "https://api.twitter.com/2/dm_conversations/with/9876/messages" ) def test_plugin_twitter_dm_attachments_multiple_oserror( mocker, twitter_url, good_message_response, good_media_response ): """Verify a file error during multi-attachment DM delivery is handled.""" # Inject an `OSError` into the middle of the operation. mock_post = mocker.patch("requests.post") mock_post.side_effect = [good_media_response, OSError()] # 2 images are produced attach = [ os.path.join(TEST_VAR_DIR, "apprise-test.gif"), os.path.join(TEST_VAR_DIR, "apprise-test.png"), # This one is not supported, so it's ignored gracefully os.path.join(TEST_VAR_DIR, "apprise-test.mp4"), ] # Create application objects. obj = Apprise.instantiate(twitter_url) # We'll fail to send this time assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is False ) assert mock_post.call_count == 2 assert ( mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[1][0][0] == "https://api.x.com/2/media/upload" ) @patch("requests.post") def test_plugin_twitter_tweet_attachments_basic( mock_post, twitter_url, good_message_response, good_media_response ): """ NotifyTwitter() Tweet Attachment Checks - Basic """ mock_post.side_effect = [good_media_response, good_message_response] # Create application objects. twitter_url += "?mode=tweet" obj = Apprise.instantiate(twitter_url) attach = AppriseAttachment(os.path.join(TEST_VAR_DIR, "apprise-test.gif")) # Send our notification assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is True ) # Verify API calls. assert mock_post.call_count == 2 assert ( # v2 media upload endpoint (available on all access tiers) mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( # v2 tweet endpoint mock_post.call_args_list[1][0][0] == "https://api.twitter.com/2/tweets" ) @patch("requests.post") def test_plugin_twitter_tweet_attachments_more_logging( mock_post, twitter_url, good_media_response ): """ NotifyTwitter() Tweet Attachment Checks - More logging """ # v2 tweet response: {"data": {"id": "...", "text": "..."}} good_tweet_response = good_response( { "data": { "id": "12345", "text": "body", }, } ) mock_post.side_effect = [good_media_response, good_tweet_response] # Create application objects. twitter_url += "?mode=tweet" obj = Apprise.instantiate(twitter_url) attach = AppriseAttachment(os.path.join(TEST_VAR_DIR, "apprise-test.gif")) # Send our notification assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is True ) # Verify API calls. assert mock_post.call_count == 2 assert ( mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[1][0][0] == "https://api.twitter.com/2/tweets" ) @patch("requests.post") def test_plugin_twitter_tweet_attachments_bad_message_response( mock_post, twitter_url, good_media_response, bad_message_response ): """Verify a failed tweet response fails attachment delivery.""" mock_post.side_effect = [good_media_response, bad_message_response] # Create application objects. twitter_url += "?mode=tweet" obj = Apprise.instantiate(twitter_url) attach = AppriseAttachment(os.path.join(TEST_VAR_DIR, "apprise-test.gif")) # Our notification will fail now since our tweet will error out. assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is False ) # Verify API calls. assert mock_post.call_count == 2 assert ( mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[1][0][0] == "https://api.twitter.com/2/tweets" ) @patch("requests.post") def test_plugin_twitter_unparseable_attachment_error( mock_post, twitter_url, good_media_response ): """Verify an unparseable tweet failure response is handled.""" bad_message_response = bad_response("") mock_post.side_effect = [good_media_response, bad_message_response] # Create application objects. twitter_url += "?mode=tweet" obj = Apprise.instantiate(twitter_url) attach = AppriseAttachment(os.path.join(TEST_VAR_DIR, "apprise-test.gif")) # The notification will fail now since the tweet will error out. # This is the same test as above, except that the error response is not # parseable. assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is False ) # Verify API calls. assert mock_post.call_count == 2 assert ( mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[1][0][0] == "https://api.twitter.com/2/tweets" ) @patch("requests.post") def test_plugin_twitter_tweet_attachments_upload_fails( mock_post, twitter_url, good_media_response ): """Verify a failed media upload prevents tweet delivery.""" # Prepare a bad tweet response. bad_tweet_response = bad_response({}) # Test case where upload fails. mock_post.side_effect = [good_media_response, bad_tweet_response] # Create application objects. twitter_url += "?mode=tweet" obj = Apprise.instantiate(twitter_url) attach = AppriseAttachment(os.path.join(TEST_VAR_DIR, "apprise-test.gif")) # Send our notification; it will fail because of the message response. assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is False ) # Verify API calls. assert mock_post.call_count == 2 assert ( mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[1][0][0] == "https://api.twitter.com/2/tweets" ) @patch("requests.post") def test_plugin_twitter_tweet_attachments_invalid_attachment( mock_post, twitter_url, good_message_response, good_media_response ): """Verify an invalid tweet attachment is rejected cleanly.""" mock_post.side_effect = [good_media_response, good_message_response] # Create application objects. twitter_url += "?mode=tweet" obj = Apprise.instantiate(twitter_url) attach = AppriseAttachment( os.path.join(TEST_VAR_DIR, "/invalid/path/to/an/invalid/file.jpg") ) # An invalid attachment will cause a failure. assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is False ) # No post request as attachment is not good. assert mock_post.call_count == 0 @patch("requests.post") def test_plugin_twitter_tweet_attachments_multiple_batch( mock_post, twitter_url, good_message_response, good_media_response ): """Verify multiple tweet attachments are sent in batch mode.""" mock_post.side_effect = [ good_media_response, good_media_response, good_media_response, good_media_response, good_message_response, good_message_response, good_message_response, good_message_response, ] # instantiate our object obj = Apprise.instantiate(twitter_url + "?mode=tweet") # 4 images are produced attach = [ os.path.join(TEST_VAR_DIR, "apprise-test.gif"), os.path.join(TEST_VAR_DIR, "apprise-test.gif"), os.path.join(TEST_VAR_DIR, "apprise-test.jpeg"), os.path.join(TEST_VAR_DIR, "apprise-test.png"), # This one is not supported, so it's ignored gracefully os.path.join(TEST_VAR_DIR, "apprise-test.mp4"), ] assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is True ) assert mock_post.call_count == 7 assert ( mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[1][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[2][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[3][0][0] == "https://api.x.com/2/media/upload" ) # v2 tweet endpoint assert ( mock_post.call_args_list[4][0][0] == "https://api.twitter.com/2/tweets" ) assert ( mock_post.call_args_list[5][0][0] == "https://api.twitter.com/2/tweets" ) # The 2 images are grouped together (batch mode) assert ( mock_post.call_args_list[6][0][0] == "https://api.twitter.com/2/tweets" ) @patch("requests.post") def test_plugin_twitter_tweet_attachments_multiple_nobatch( mock_post, twitter_url, good_message_response, good_media_response ): """Verify multiple tweet attachments are sent without batch mode.""" mock_post.side_effect = [ good_media_response, good_media_response, good_media_response, good_media_response, good_message_response, good_message_response, good_message_response, good_message_response, ] # instantiate our object (without a batch mode) obj = Apprise.instantiate(twitter_url + "?mode=tweet&batch=no") # 4 images are produced attach = [ os.path.join(TEST_VAR_DIR, "apprise-test.gif"), os.path.join(TEST_VAR_DIR, "apprise-test.gif"), os.path.join(TEST_VAR_DIR, "apprise-test.jpeg"), os.path.join(TEST_VAR_DIR, "apprise-test.png"), # This one is not supported, so it's ignored gracefully os.path.join(TEST_VAR_DIR, "apprise-test.mp4"), ] assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is True ) assert mock_post.call_count == 8 assert ( mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[1][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[2][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[3][0][0] == "https://api.x.com/2/media/upload" ) # v2 tweet endpoint (one per image, no batching) assert ( mock_post.call_args_list[4][0][0] == "https://api.twitter.com/2/tweets" ) assert ( mock_post.call_args_list[5][0][0] == "https://api.twitter.com/2/tweets" ) assert ( mock_post.call_args_list[6][0][0] == "https://api.twitter.com/2/tweets" ) assert ( mock_post.call_args_list[7][0][0] == "https://api.twitter.com/2/tweets" ) @patch("requests.post") def test_plugin_twitter_tweet_attachments_multiple_oserror( mock_post, twitter_url, good_media_response ): """Verify file errors during multi-attachment tweets are handled.""" # We have an OSError thrown in the middle of our preparation mock_post.side_effect = [good_media_response, OSError()] # 2 images are produced attach = [ os.path.join(TEST_VAR_DIR, "apprise-test.gif"), os.path.join(TEST_VAR_DIR, "apprise-test.png"), # This one is not supported, so it's ignored gracefully os.path.join(TEST_VAR_DIR, "apprise-test.mp4"), ] # We'll fail to send this time obj = Apprise.instantiate(twitter_url + "?mode=tweet") assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is False ) assert mock_post.call_count == 2 assert ( mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[1][0][0] == "https://api.x.com/2/media/upload" ) @patch("requests.post") def test_plugin_twitter_tweet_attachments_jpeg_before_gif( mock_post, twitter_url, good_media_response ): """ Verify that when PNG/JPEG attachments precede a GIF in batch mode, the accumulated PNG/JPEG batch is flushed first, then the GIF is emitted alone. This exercises the ``if batch:`` flush branch inside the non-batchable (GIF) path of _send_tweet. """ # v2 tweet response good_tweet_response = good_response( {"data": {"id": "12345", "text": "body"}} ) # 3 uploads (jpeg, png, gif) + 2 tweet sends = 5 post calls mock_post.side_effect = [ good_media_response, good_media_response, good_media_response, good_tweet_response, good_tweet_response, ] # instantiate in tweet + batch mode obj = Apprise.instantiate(twitter_url + "?mode=tweet") # jpeg and png come first, then gif -- the gif triggers a flush of # the pending jpeg/png batch before being emitted in its own tweet attach = [ os.path.join(TEST_VAR_DIR, "apprise-test.jpeg"), os.path.join(TEST_VAR_DIR, "apprise-test.png"), os.path.join(TEST_VAR_DIR, "apprise-test.gif"), ] assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO, attach=attach, ) ) is True ) # 3 media uploads + 2 tweet sends assert mock_post.call_count == 5 # First 3 are v2 media uploads assert ( mock_post.call_args_list[0][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[1][0][0] == "https://api.x.com/2/media/upload" ) assert ( mock_post.call_args_list[2][0][0] == "https://api.x.com/2/media/upload" ) # jpeg + png batched into one tweet assert ( mock_post.call_args_list[3][0][0] == "https://api.twitter.com/2/tweets" ) # gif emitted alone in its own tweet assert ( mock_post.call_args_list[4][0][0] == "https://api.twitter.com/2/tweets" ) @patch("apprise.plugins.base.time.sleep") @patch("requests.post") def test_plugin_twitter_tweet_retry( mock_post, mock_sleep, twitter_url, good_message_response, bad_message_response, good_media_response, ): """A retry only re-posts the tweet that failed.""" # Tweet 1 posts, tweet 2 fails, then the retry posts tweet 2 alone tweets = [ good_message_response, bad_message_response, good_message_response, ] def _post(url, *args, **kwargs): return ( good_media_response if url == "https://api.x.com/2/media/upload" else tweets.pop(0) ) mock_post.side_effect = _post aobj = Apprise() assert aobj.add(twitter_url + "?mode=tweet&batch=no&retry=2&wait=0") # Each gif is its own tweet attach = [ os.path.join(TEST_VAR_DIR, "apprise-test.gif"), os.path.join(TEST_VAR_DIR, "apprise-test.gif"), ] assert bool(aobj.notify(body="body", attach=attach)) is True texts = [ json.loads(call[1]["data"])["text"] for call in mock_post.call_args_list if call[0][0] == "https://api.twitter.com/2/tweets" ] # The first tweet was never repeated assert texts == ["body", "02/02", "02/02"] assert not tweets @patch("apprise.plugins.base.time.sleep") @patch("requests.post") def test_plugin_twitter_dm_retry( mock_post, mock_sleep, twitter_url, good_message_response, bad_message_response, good_media_response, ): """A retry only re-sends the direct message that failed.""" # DM 1 is sent, DM 2 fails, then the retry sends DM 2 alone messages = [ good_message_response, bad_message_response, good_message_response, ] def _post(url, *args, **kwargs): return ( good_media_response if url == "https://api.x.com/2/media/upload" else messages.pop(0) ) mock_post.side_effect = _post aobj = Apprise() assert aobj.add(twitter_url + "?mode=dm&retry=2&wait=0") attach = [ os.path.join(TEST_VAR_DIR, "apprise-test.gif"), os.path.join(TEST_VAR_DIR, "apprise-test.png"), ] assert bool(aobj.notify(body="body", attach=attach)) is True texts = [ json.loads(call[1]["data"])["text"] for call in mock_post.call_args_list if call[0][0].endswith("/messages") ] # The first message was never repeated assert texts == ["body", "02/02", "02/02"] assert not messages caronc-apprise-dfec414/tests/test_plugin_vapid.py000066400000000000000000002047261526720371000223660ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. import base64 import json # Disable logging for a cleaner testing output import logging import os import stat import sys from unittest import mock from helpers import AppriseURLTester import pytest import requests from apprise import Apprise, asset, exception, url from apprise.common import PersistentStoreMode from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.vapid import VAPID_API_LOOKUP, NotifyVapid from apprise.plugins.vapid.subscription import ( WebPushSubscription, WebPushSubscriptionManager, webpush_origin, ) from apprise.utils.cwe312 import cwe312_loggable from apprise.utils.pem import ApprisePEMController logging.disable(logging.CRITICAL) # Attachment Directory TEST_VAR_DIR = os.path.join(os.path.dirname(__file__), "var") # a test UUID we can use SUBSCRIBER = "user@example.com" PLUGIN_ID = "vapid" # Windows has no POSIX file modes, so tests that check them are skipped # there. IS_WINDOWS = sys.platform == "win32" # Root ignores file permissions entirely, so a read-only file still tests # as writable. RPM builds run their test suite as root. IS_ROOT = hasattr(os, "geteuid") and os.geteuid() == 0 # Our Testing URLs apprise_url_tests = ( ( "vapid://", { "instance": AppriseImproperlyConfigured, }, ), ( "vapid://:@/", { "instance": AppriseImproperlyConfigured, }, ), ( "vapid://invalid-subscriber", { # An invalid Subscriber "instance": AppriseImproperlyConfigured, }, ), ( "vapid://user@example.com", { # bare bone requirements met, but we don't have our subscription # file or our private key (pem) "instance": NotifyVapid, # We'll fail to respond because we would not have found any # configuration to load "notify_response": False, }, ), ( "vapid://user@example.com?keyfile=invalid&subfile=invalid", { # Test passing keyfile and subfile on our path (even if invalid) "instance": NotifyVapid, # We'll fail to respond because we would not have found any # configuration to load "notify_response": False, }, ), ( "vapid://user@example.com/newuser@example.com", { # we don't have our subscription file or private key "instance": NotifyVapid, "notify_response": False, }, ), ( "vapid://user@example.ca/newuser@example.ca", { "instance": NotifyVapid, # force a failure "response": False, "requests_response_code": requests.codes.internal_server_error, }, ), ( "vapid://user@example.uk/newuser@example.uk", { "instance": NotifyVapid, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( "vapid://user@example.au/newuser@example.au", { "instance": NotifyVapid, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), ) @pytest.fixture def patch_persistent_store_namespace(tmpdir): """Force an easy to test environment.""" with ( mock.patch.object(url.URLBase, "url_id", return_value=PLUGIN_ID), mock.patch.object( asset.AppriseAsset, "storage_mode", PersistentStoreMode.AUTO ), mock.patch.object(asset.AppriseAsset, "storage_path", str(tmpdir)), ): tmp_dir = tmpdir.mkdir(PLUGIN_ID) # Return the directory name yield str(tmp_dir) @pytest.fixture def subscription_reference(): return { "user@example.com": { "endpoint": "https://fcm.googleapis.com/fcm/send/default", "keys": { "p256dh": ( "BI2RNIK2PkeCVoEfgVQNjievBi4gWvZxMiuCpOx6K6qCO" "5caru5QCPuc-nEaLplbbFkHxTrR9YzE8ZkTjie5Fq0" ), "auth": "k9Xzm43nBGo=", }, }, "user1": { "endpoint": "https://fcm.googleapis.com/fcm/send/abc123", "keys": { "p256dh": ( "BI2RNIK2PkeCVoEfgVQNjievBi4gWvZxMiuCpOx6K6qCO" "5caru5QCPuc-nEaLplbbFkHxTrR9YzE8ZkTjie5Fq0" ), "auth": "k9Xzm43nBGo=", }, }, "user2": { "endpoint": "https://fcm.googleapis.com/fcm/send/def456", "keys": { "p256dh": ( "BI2RNIK2PkeCVoEfgVQNjievBi4gWvZxMiuCpOx6K6qCO" "5caru5QCPuc-nEaLplbbFkHxTrR9YzE8ZkTjie5Fq0" ), "auth": "k9Xzm43nBGo=", }, }, } @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_urls(): """ NotifyVapid() Apprise URLs - No Config """ # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_urls_with_required_assets( patch_persistent_store_namespace, subscription_reference ): """NotifyVapid() Apprise URLs With Config.""" # Determine our store pc = ApprisePEMController(path=patch_persistent_store_namespace) assert pc.keygen() is True # Write our subscriptions file to disk subscription_file = os.path.join( patch_persistent_store_namespace, WebPushSubscriptionManager.default_filename, ) with open(subscription_file, "w") as f: f.write(json.dumps(subscription_reference)) tests = ( ( "vapid://user@example.com", { # user@example.com loaded (also used as subscriber id) "instance": NotifyVapid, }, ), ( "vapid://user@example.com/newuser@example.com", { # no newuser@example.com key entry "instance": NotifyVapid, "notify_response": False, }, ), ( "vapid://user@example.com/user1?to=user2", { # We'll succesfully notify 2 users "instance": NotifyVapid, }, ), ( "vapid://user1?to=user2&from=user@example.com", { # We'll succesfully notify 2 users "instance": NotifyVapid, }, ), ( "vapid://?to=user2&from=user@example.com", { # No host provided "instance": NotifyVapid, }, ), ( "vapid://user@example.com?to=user2&from=user@example.com", { # We'll succesfully notify 2 users "instance": NotifyVapid, }, ), ( "vapid://user@example.com/user1?to=user2&ttl=15", { # test ttl "instance": NotifyVapid, }, ), ( "vapid://user@example.com/user1?to=user2&ttl=", { # test ttl "instance": NotifyVapid, }, ), ( "vapid://user@example.com/user1?to=user2&ttl=invalid", { # test ttl "instance": NotifyVapid, }, ), ( "vapid://user@example.com/user1?to=user2&ttl=-4000", { # bad ttl "instance": AppriseImproperlyConfigured, }, ), ( "vapid://user@example.com/user1?to=user2&mode=edge", { # test mode "instance": NotifyVapid, }, ), ( "vapid://user@example.com/user1?to=user2&mode=", { # test mode "instance": AppriseImproperlyConfigured, }, ), ( "vapid://user@example.com/user1?to=user2&mode=invalid", { # test mode more "instance": AppriseImproperlyConfigured, }, ), ( "vapid://user@example.com/user1", { "instance": NotifyVapid, # force a failure "response": False, "requests_response_code": requests.codes.internal_server_error, }, ), ( "vapid://user@example.com/user1", { "instance": NotifyVapid, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( "vapid://user@example.com/user1", { "instance": NotifyVapid, # Throws a series of connection and transfer exceptions # when this flag is set and tests that we gracefully handle # them "test_requests_exceptions": True, }, ), ) AppriseURLTester(tests=tests).run_all() @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_subscriptions(tmpdir): """NotifyVapid() Subscriptions.""" # Temporary directory tmpdir0 = tmpdir.mkdir("tmp00") with pytest.raises(exception.AppriseInvalidData): # Integer not supported WebPushSubscription(42) with pytest.raises(exception.AppriseInvalidData): # Not the correct format WebPushSubscription("bad-content") with pytest.raises(exception.AppriseInvalidData): # Invalid JSON WebPushSubscription("{") with pytest.raises(exception.AppriseInvalidData): # Empty Dictionary WebPushSubscription({}) with pytest.raises(exception.AppriseInvalidData): WebPushSubscription( { "endpoint": "https://fcm.googleapis.com/fcm/send/abc123", "keys": { "p256dh": "BNcW4oA7zq5H9TKIrA3XfKclN2fX9P_7NR=", "auth": 42, }, } ) with pytest.raises(exception.AppriseInvalidData): WebPushSubscription( { "endpoint": "https://fcm.googleapis.com/fcm/send/abc123", "keys": { "p256dh": 42, "auth": "k9Xzm43nBGo=", }, } ) with pytest.raises(exception.AppriseInvalidData): WebPushSubscription( { "endpoint": "https://fcm.googleapis.com/fcm/send/abc123", } ) with pytest.raises(exception.AppriseInvalidData): WebPushSubscription( { "endpoint": "https://fcm.googleapis.com/fcm/send/abc123", "keys": {}, } ) with pytest.raises(exception.AppriseInvalidData): # Invalid p256dh public key provided wps = WebPushSubscription( { "endpoint": "https://fcm.googleapis.com/fcm/send/abc123", "keys": { "p256dh": "BNcW4oA7zq5H9TKIrA3XfKclN2fX9P_7NR=", "auth": "k9Xzm43nBGo=", }, } ) # An empty object wps = WebPushSubscription() assert bool(wps) is False assert isinstance(wps.json(), str) assert json.loads(wps.json()) assert str(wps) == "" assert wps.auth is None assert wps.endpoint is None assert wps.p256dh is None assert wps.public_key is None # We can't write anything as there is nothing loaded assert wps.write(os.path.join(str(tmpdir0), "subscriptions.json")) is False # A valid key wps = WebPushSubscription( { "endpoint": "https://fcm.googleapis.com/fcm/send/abc123", "keys": { "p256dh": ( "BI2RNIK2PkeCVoEfgVQNjievBi4gWvZxMiuCpOx6K6qCO" "5caru5QCPuc-nEaLplbbFkHxTrR9YzE8ZkTjie5Fq0" ), "auth": "k9Xzm43nBGo=", }, } ) assert bool(wps) is True assert isinstance(wps.json(), str) assert json.loads(wps.json()) assert str(wps) == "abc123" assert wps.auth == "k9Xzm43nBGo=" assert wps.endpoint == "https://fcm.googleapis.com/fcm/send/abc123" assert ( wps.p256dh == "BI2RNIK2PkeCVoEfgVQNjievBi4gWvZxMiuCpOx6K6qCO" "5caru5QCPuc-nEaLplbbFkHxTrR9YzE8ZkTjie5Fq0" ) assert wps.public_key is not None # Currently no files here assert os.listdir(str(tmpdir0)) == [] # Bad content assert wps.write(object) is False assert wps.write(None) is False # Can't write to a name already taken by as a directory assert wps.write(str(tmpdir0)) is False # Can't write to a name already taken by as a directory assert wps.write(os.path.join(str(tmpdir0), "subscriptions.json")) is True assert os.listdir(str(tmpdir0)) == ["subscriptions.json"] @pytest.mark.skipif( "cryptography" in sys.modules, reason="Requires that cryptography NOT be installed", ) def test_plugin_vapid_subscriptions_without_c(): """NotifyVapid() Subscriptions (no Cryptography)""" with pytest.raises(exception.AppriseInvalidData): # A valid key that can't be loaded because crytography is missing WebPushSubscription( { "endpoint": "https://fcm.googleapis.com/fcm/send/abc123", "keys": { "p256dh": ( "BI2RNIK2PkeCVoEfgVQNjievBi4gWvZxMiuCpOx6K6qCO" "5caru5QCPuc-nEaLplbbFkHxTrR9YzE8ZkTjie5Fq0" ), "auth": "k9Xzm43nBGo=", }, } ) @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_subscription_manager(tmpdir): """NotifyVapid() Subscription Manager.""" # Temporary directory tmpdir0 = tmpdir.mkdir("tmp00") with pytest.raises(exception.AppriseInvalidData): # An invalid object smgr = WebPushSubscriptionManager() smgr["abc"] = "invalid" with pytest.raises(exception.AppriseInvalidData): # An invalid object smgr = WebPushSubscriptionManager() smgr += "invalid" smgr = WebPushSubscriptionManager() assert bool(smgr) is False assert len(smgr) == 0 sub = { "endpoint": "https://fcm.googleapis.com/fcm/send/abc123", "keys": { "p256dh": ( "BI2RNIK2PkeCVoEfgVQNjievBi4gWvZxMiuCpOx6K6qCO" "5caru5QCPuc-nEaLplbbFkHxTrR9YzE8ZkTjie5Fq0" ), "auth": "k9Xzm43nBGo=", }, } assert smgr.add(sub) is True assert bool(smgr) is True assert len(smgr) == 1 # Same sub (overwrites same slot) smgr += sub assert bool(smgr) is True assert len(smgr) == 1 # This makes a copy smgr["abc"] = smgr["abc123"] assert bool(smgr) is True assert len(smgr) == 2 assert isinstance(smgr["abc123"], WebPushSubscription) # Currently no files here assert os.listdir(str(tmpdir0)) == [] # Write our content assert smgr.write(os.path.join(str(tmpdir0), "subscriptions.json")) is True assert os.listdir(str(tmpdir0)) == ["subscriptions.json"] # Reset our object smgr.clear() assert bool(smgr) is False assert len(smgr) == 0 # Load our content back assert smgr.load(os.path.join(str(tmpdir0), "subscriptions.json")) is True assert bool(smgr) is True assert len(smgr) == 2 # Write over our file using the standard Subscription format assert ( smgr["abc123"].write(os.path.join(str(tmpdir0), "subscriptions.json")) is True ) # We can still open this type as well assert smgr.load(os.path.join(str(tmpdir0), "subscriptions.json")) is True assert bool(smgr) is True assert len(smgr) == 1 smgr.clear() bad_entry = { "endpoint": "https://fcm.googleapis.com/fcm/send/abc123", "keys": { "p256dh": "invalid", "auth": "garbage", }, } subscriptions = os.path.join(str(tmpdir0), "subscriptions.json") with open(subscriptions, "w", encoding="utf-8") as f: # A bad JSON file f.write("{") assert smgr.load(subscriptions) is False with open(subscriptions, "w", encoding="utf-8") as f: # not expected dictionary f.write("null") assert smgr.load(subscriptions) is False subscriptions = os.path.join(str(tmpdir0), "subscriptions.json") with open(subscriptions, "w", encoding="utf-8") as f: json.dump(bad_entry, f) assert smgr.load(subscriptions) is False # Create bad data bad_data = { "bad1": bad_entry, "bad2": bad_entry, "bad3": bad_entry, "bad4": bad_entry, } subscriptions = os.path.join(str(tmpdir0), "subscriptions.json") with open(subscriptions, "w", encoding="utf-8") as f: json.dump(bad_data, f) assert smgr.load(subscriptions) is False assert smgr.load("invalid-file") is False @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @mock.patch("requests.post") def test_plugin_vapid_initializations(mock_post, tmpdir): """NotifyVapid() Initializations.""" # Assign our mock object our return value okay_response = requests.Request() okay_response.status_code = requests.codes.ok okay_response.content = "" mock_post.return_value = okay_response # Temporary directory tmpdir0 = tmpdir.mkdir("tmp00") # Write our subfile smgr = WebPushSubscriptionManager() sub = { "endpoint": "https://fcm.googleapis.com/fcm/send/abc123", "keys": { "p256dh": ( "BI2RNIK2PkeCVoEfgVQNjievBi4gWvZxMiuCpOx6K6qCO" "5caru5QCPuc-nEaLplbbFkHxTrR9YzE8ZkTjie5Fq0" ), "auth": "k9Xzm43nBGo=", }, } subfile = os.path.join(str(tmpdir0), "subscriptions.json") assert smgr.add(sub) is True assert smgr.add(smgr["abc123"]) is True assert os.listdir(str(tmpdir0)) == [] with mock.patch("json.dump", side_effect=OSError): # We will fial to write assert smgr.write(subfile) is False assert smgr.write(subfile) is True assert os.listdir(str(tmpdir0)) == ["subscriptions.json"] assert isinstance(smgr.json(), str) asset_ = asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir0), # Auto-gen our private/public key pair pem_autogen=True, ) # Auto-Key Generation obj = NotifyVapid( "user@example.ca", targets=[ "abc123", ], subfile=subfile, asset=asset_, ) assert isinstance(obj, NotifyVapid) # Our subscription directory + our # persistent store where our keys were generated assert len(os.listdir(str(tmpdir0))) == 2 # Second call re-references keys previously generated obj = NotifyVapid( "user@example.ca", targets=[ "abc123", ], subfile=subfile, asset=asset_, ) assert isinstance(obj, NotifyVapid) assert isinstance(obj.url(), str) assert obj.send("test") is True # A second message makes no difference; what is loaded into memory is used assert obj.send("test") is True obj = NotifyVapid( "user@example.ca", targets=[ "abc123", ], subfile="/a/bad/path", asset=asset_, ) assert isinstance(obj, NotifyVapid) assert isinstance(obj.url(), str) assert obj.send("test") is False # A second message makes no difference; what is loaded into memory is used assert obj.send("test") is False # Detect our keyfile cache_dir = next( x for x in os.listdir(str(tmpdir0)) if not x.endswith("subscriptions.json") ) # Test fixed assignment to our keyfile keyfile = os.path.join(str(tmpdir0), cache_dir, "private_key.pem") assert os.path.exists(keyfile) obj = NotifyVapid( "user@example.ca", targets=[ "abc123", ], keyfile=keyfile, subfile=subfile, asset=asset_, ) assert isinstance(obj, NotifyVapid) assert isinstance(obj.url(), str) assert obj.send("test") is True # A second message makes no difference; what is loaded into memory is used assert obj.send("test") is True # Invalid Keyfile obj = NotifyVapid( "user@example.ca", targets=[ "abc123", ], keyfile=subfile, subfile=subfile, asset=asset_, ) assert isinstance(obj, NotifyVapid) assert isinstance(obj.url(), str) assert obj.send("test") is False # A second message makes no difference; what is loaded into memory is used assert obj.send("test") is False # AutoGen Temporary directory tmpdir1 = tmpdir.mkdir("tmp01") asset2 = asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir1), # Auto-gen our private/public key pair pem_autogen=True, ) assert os.listdir(str(tmpdir1)) == [] obj = NotifyVapid( "user@example.ca", targets=[ "abc123", ], keyfile=keyfile, asset=asset2, ) assert isinstance(obj, NotifyVapid) assert isinstance(obj.url(), str) # We have a temporary subscription file we can use assert os.listdir(str(tmpdir1)) == ["00088ad3"] # We will have a dud configuration file, but at least it's something # to help the user with assert obj.send("test") is False # Second instance fails as well assert obj.send("test") is False # AutoGen Temporary directory tmpdir2 = tmpdir.mkdir("tmp02") asset3 = asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir2), # Auto-gen our private/public key pair pem_autogen=True, ) # Test invalid keyfile assert os.path.exists(keyfile) obj = NotifyVapid( "user@example.ca", targets=[ "abc123", ], keyfile="invalid-file", subfile=subfile, asset=asset3, ) assert isinstance(obj, NotifyVapid) assert isinstance(obj.url(), str) assert obj.send("test") is False # A second message makes no difference; what is loaded into memory is used assert obj.send("test") is False @pytest.mark.skipif( "cryptography" in sys.modules, reason="Requires that cryptography NOT be installed", ) def test_plugin_vapid_initializations_without_c(tmpdir): """NotifyVapid() Initializations without cryptography.""" # Temporary directory tmpdir0 = tmpdir.mkdir("tmp00") # Write our subfile smgr = WebPushSubscriptionManager() sub = { "endpoint": "https://fcm.googleapis.com/fcm/send/abc123", "keys": { "p256dh": ( "BI2RNIK2PkeCVoEfgVQNjievBi4gWvZxMiuCpOx6K6qCO" "5caru5QCPuc-nEaLplbbFkHxTrR9YzE8ZkTjie5Fq0" ), "auth": "k9Xzm43nBGo=", }, } subfile = os.path.join(str(tmpdir0), "subscriptions.json") assert smgr.add(sub) is False asset_ = asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir0), # Auto-gen our private/public key pair pem_autogen=True, ) # Auto-Key Generation obj = NotifyVapid( "user@example.ca", targets=[ "abc123", ], subfile=subfile, asset=asset_, ) assert isinstance(obj, NotifyVapid) def _jwt_audience(authorization): """Returns the VAPID JWT audience from an Authorization header.""" token = authorization.split("t=", 1)[1].split(",", 1)[0] payload = token.split(".")[1] # JWT segments use base64url without padding. payload += "=" * (-len(payload) % 4) return json.loads(base64.urlsafe_b64decode(payload))["aud"] # Valid P-256 public key shared by the test subscriptions. TEST_P256DH = ( "BI2RNIK2PkeCVoEfgVQNjievBi4gWvZxMiuCpOx6K6qCO" "5caru5QCPuc-nEaLplbbFkHxTrR9YzE8ZkTjie5Fq0" ) # Valid authentication secret shared by the test subscriptions. TEST_AUTH = "k9Xzm43nBGo=" def _mk_resp(code=requests.codes.ok): """Builds a mocked push service response carrying the code given.""" response = requests.Request() response.status_code = code response.content = "" return response def _subscription(endpoint): """Builds a single subscription dictionary for the endpoint given.""" return { "endpoint": endpoint, "keys": {"p256dh": TEST_P256DH, "auth": TEST_AUTH}, } def _write_subscriptions(path, endpoints): """Builds a subscriptions.json containing the endpoints provided. ``endpoints`` accepts: - a list of endpoints, each named after its own last path segment - a dictionary of name to endpoint pairs """ if isinstance(endpoints, dict): with open(path, "w") as f: json.dump( { name: _subscription(endpoint) for name, endpoint in endpoints.items() }, f, ) return smgr = WebPushSubscriptionManager() for endpoint in endpoints: assert smgr.add(_subscription(endpoint)) is True assert smgr.write(path) is True def _mk_notifier(tmpdir, endpoints, targets, name="vapid"): """Builds a NotifyVapid() backed by a subscriptions file on disk. Returns the notifier along with the path of the file that was written. """ tmpdir0 = tmpdir.mkdir(name) subfile = os.path.join(str(tmpdir0), "subscriptions.json") _write_subscriptions(subfile, endpoints) obj = NotifyVapid( "user@example.ca", targets=targets, subfile=subfile, asset=asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir0), pem_autogen=True, ), ) return obj, subfile @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @mock.patch("requests.post") def test_plugin_vapid_subscription_endpoint(mock_post, tmpdir): """NotifyVapid() delivers to the endpoint of the subscription itself.""" mock_post.return_value = _mk_resp() endpoint = "https://fcm.googleapis.com/fcm/send/abc123" obj, _ = _mk_notifier(tmpdir, [endpoint], ["abc123"], name="tmp10") assert obj.send("test") is True # Use the browser-issued endpoint instead of the mode's base URL. assert mock_post.call_args[0][0] == endpoint assert mock_post.call_args[0][0] != VAPID_API_LOOKUP[obj.mode] # Use the endpoint's origin as the JWT audience. headers = mock_post.call_args[1]["headers"] assert _jwt_audience(headers["Authorization"]) == ( "https://fcm.googleapis.com" ) @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @mock.patch("requests.post") def test_plugin_vapid_multiple_endpoints(mock_post, tmpdir): """NotifyVapid() handles subscriptions hosted by different services.""" mock_post.return_value = _mk_resp() endpoints = { "abc123": "https://fcm.googleapis.com/fcm/send/abc123", "xyz789": "https://web.push.apple.com/xyz789", } obj, _ = _mk_notifier( tmpdir, list(endpoints.values()), list(endpoints), name="tmp11" ) assert obj.send("test") is True assert mock_post.call_count == len(endpoints) # Give each service its own endpoint and JWT audience. delivered = {} for call in mock_post.call_args_list: url = call[0][0] delivered[url] = _jwt_audience(call[1]["headers"]["Authorization"]) assert set(delivered) == set(endpoints.values()) assert delivered["https://fcm.googleapis.com/fcm/send/abc123"] == ( "https://fcm.googleapis.com" ) assert delivered["https://web.push.apple.com/xyz789"] == ( "https://web.push.apple.com" ) @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @pytest.mark.parametrize( "status_code", ( requests.codes.ok, requests.codes.created, requests.codes.accepted, requests.codes.no_content, ), ) @mock.patch("requests.post") def test_plugin_vapid_success_codes(mock_post, tmpdir, status_code): """NotifyVapid() accepts its supported success responses.""" mock_post.return_value = _mk_resp(status_code) obj, _ = _mk_notifier( tmpdir, ["https://fcm.googleapis.com/fcm/send/abc123"], ["abc123"], name=f"ok{status_code}", ) # Supported services may acknowledge queued messages with 201 or 202. assert obj.send("test") is True @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @mock.patch("requests.post") def test_plugin_vapid_prunes_expired_subscriptions(mock_post, tmpdir): """A 404 or a 410 from the push service removes that subscription.""" def respond(url, *args, **kwargs): # Endpoint names select the expired response returned by this mock. return _mk_resp( requests.codes.gone if url.endswith("GONE") else ( requests.codes.not_found if url.endswith("MISSING") else requests.codes.created ) ) mock_post.side_effect = respond obj, subfile = _mk_notifier( tmpdir, { "live": "https://web.push.apple.com/LIVE", "gone": "https://web.push.apple.com/GONE", "missing": "https://web.push.apple.com/MISSING", }, ["live", "gone", "missing"], name="prune", ) # An expired endpoint is reported honestly as a failure, even though # another target was accepted. assert obj.send("test") is False # Remove only the expired subscriptions from disk. with open(subfile) as f: remaining = json.load(f) assert set(remaining) == {"live"} assert "gone" not in obj.subscriptions assert "missing" not in obj.subscriptions @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @mock.patch("requests.post") def test_plugin_vapid_prune_write_failure(mock_post, tmpdir): """A subscription file that cannot be updated does not break sending.""" mock_post.return_value = _mk_resp(requests.codes.gone) obj, subfile = _mk_notifier( tmpdir, ["https://web.push.apple.com/DEAD"], ["dead"], name="writefail", ) with mock.patch.object( WebPushSubscriptionManager, "prune", return_value=False ): assert obj.send("test") is False # Remove the expired subscription from memory despite the write failure. assert "dead" not in obj.subscriptions # The unchanged file still contains the expired subscription. with open(subfile) as f: assert "dead" in json.load(f) @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @mock.patch("requests.post") def test_plugin_vapid_expired_after_subfile_clear(mock_post, tmpdir): """An expired subscription is dropped after clearing ``subfile``.""" mock_post.return_value = _mk_resp(requests.codes.gone) obj, subfile = _mk_notifier( tmpdir, ["https://web.push.apple.com/DEAD"], ["dead"], name="nosubfile", ) # Load subscriptions, then clear the notifier's file reference assert obj.subscriptions.load(subfile) is True obj.subfile = None assert obj.send("test") is False # The expired subscription is still dropped from memory. assert "dead" not in obj.subscriptions @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_subscription_remove(): """WebPushSubscriptionManager() reports whether it removed anything.""" smgr = WebPushSubscriptionManager() # Nothing can be removed from an empty manager. assert smgr.remove("missing") is False assert smgr.add(_subscription("https://web.push.apple.com/abc123")) is True assert len(smgr) == 1 # Match subscription names without regard to case. assert smgr.remove("ABC123") is True assert len(smgr) == 0 assert smgr.remove("abc123") is False @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @pytest.mark.parametrize( ("endpoint", "origin"), ( # A standard endpoint keeps its origin. ( "https://fcm.googleapis.com/fcm/send/abc123", "https://fcm.googleapis.com", ), # Lowercase the scheme and host, and omit port 443. ( "HTTPS://FCM.GoogleAPIs.COM:443/fcm/send/abc123", "https://fcm.googleapis.com", ), # Ignore surrounding whitespace. ( " https://fcm.googleapis.com/fcm/send/abc123 ", "https://fcm.googleapis.com", ), # Keep a non-default port in the origin. ( "https://push.example.com:8443/wpush/v1/abc123", "https://push.example.com:8443", ), # Keep brackets around an IPv6 host. ("https://[2001:db8::1]/wpush/v1/abc", "https://[2001:db8::1]"), ( "https://[2001:db8::1]:8443/wpush/v1/abc", "https://[2001:db8::1]:8443", ), # Allow a self-hosted service on a private address. ("https://192.168.0.10:8443/push/abc", "https://192.168.0.10:8443"), ), ) def test_plugin_vapid_endpoint_origins(endpoint, origin): """A valid endpoint is accepted and reduced to its origin.""" assert webpush_origin(endpoint) == origin sub = WebPushSubscription(_subscription(endpoint)) assert sub.origin == origin assert sub.endpoint == endpoint.strip() @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @pytest.mark.parametrize( "endpoint", ( # Web Push requires HTTPS. "http://fcm.googleapis.com/fcm/send/abc123", "ftp://fcm.googleapis.com/fcm/send/abc123", "fcm.googleapis.com/fcm/send/abc123", # Reject embedded credentials, even empty ones. "https://user@fcm.googleapis.com/fcm/send/abc123", "https://user:pass@fcm.googleapis.com/fcm/send/abc123", "https://@fcm.googleapis.com/fcm/send/abc123", "https://:@fcm.googleapis.com/fcm/send/abc123", "https://:pass@fcm.googleapis.com/fcm/send/abc123", # Reject endpoints without a host. "https://", "https:///fcm/send/abc123", "://", "", "not a url", # Reject malformed IPv6 without raising. "https://[2001:db8::1/fcm/send/abc123", # Reject an out-of-range port without raising. "https://fcm.googleapis.com:99999/fcm/send/abc123", # Reject a host holding characters that are not legal in one. "https://fcm google apis.com/fcm/send/abc123", "https://fcm%20googleapis.com/fcm/send/abc123", "https://-fcm.googleapis.com/fcm/send/abc123", "https://.fcm.googleapis.com/fcm/send/abc123", f"https://{'a' * 254}.com/fcm/send/abc123", # Reject an IPv6 literal that is not an address at all. "https://[2001:db8::1::2]/fcm/send/abc123", "https://[not:an:address]/fcm/send/abc123", # Reject non-string values. None, 42, ["https://fcm.googleapis.com/fcm/send/abc123"], ), ) def test_plugin_vapid_bad_endpoints(endpoint): """An endpoint that cannot be used safely is rejected.""" assert webpush_origin(endpoint) is None # A subscription containing an invalid endpoint cannot be loaded. with pytest.raises(exception.AppriseInvalidData): WebPushSubscription(_subscription(endpoint)) sub = WebPushSubscription() assert sub.load(_subscription(endpoint)) is False assert sub.origin is None assert sub.endpoint is None assert bool(sub) is False # The manager also refuses the subscription. smgr = WebPushSubscriptionManager() assert smgr.add(_subscription(endpoint)) is False assert len(smgr) == 0 @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_subscription_atomic_write(tmpdir): """A failed write leaves whatever was already on disk alone.""" tmpdir0 = tmpdir.mkdir("atomic") path = os.path.join(str(tmpdir0), "subscriptions.json") smgr = WebPushSubscriptionManager() assert smgr.add(_subscription("https://web.push.apple.com/abc123")) is True assert smgr.write(path) is True with open(path) as f: original = json.load(f) assert set(original) == {"abc123"} # A partial write must not replace the existing file. smgr.clear() assert smgr.add(_subscription("https://web.push.apple.com/xyz789")) is True with mock.patch("json.dump", side_effect=OSError): assert smgr.write(path) is False with open(path) as f: assert json.load(f) == original # Do not leave temporary files behind. assert os.listdir(str(tmpdir0)) == ["subscriptions.json"] # Treat a missing destination directory as a failed write. assert smgr.write(os.path.join(str(tmpdir0), "missing", "s.json")) is False @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @pytest.mark.skipif(IS_WINDOWS, reason="Requires POSIX file modes") def test_plugin_vapid_write_keeps_permissions(tmpdir): """An existing subscription file keeps the permissions it had.""" tmpdir0 = tmpdir.mkdir("perms") path = os.path.join(str(tmpdir0), "subscriptions.json") smgr = WebPushSubscriptionManager() assert smgr.add(_subscription("https://web.push.apple.com/abc123")) is True assert smgr.write(path) is True # A brand new file is kept to ourselves; it lists where we deliver assert stat.S_IMODE(os.stat(path).st_mode) == 0o600 # Hand the file a mode of its own and rewrite it os.chmod(path, 0o640) assert smgr.add(_subscription("https://web.push.apple.com/xyz789")) is True assert smgr.write(path) is True assert stat.S_IMODE(os.stat(path).st_mode) == 0o640 # Confirm the new entry was written. with open(path) as f: assert set(json.load(f)) == {"abc123", "xyz789"} @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_write_follows_symlink(tmpdir): """A symlinked subscription file is written through, not replaced.""" tmpdir0 = tmpdir.mkdir("symlink") target = os.path.join(str(tmpdir0), "real.json") link = os.path.join(str(tmpdir0), "subscriptions.json") smgr = WebPushSubscriptionManager() assert smgr.add(_subscription("https://web.push.apple.com/abc123")) is True assert smgr.write(target) is True os.symlink(target, link) # Write by way of the link assert smgr.add(_subscription("https://web.push.apple.com/xyz789")) is True assert smgr.write(link) is True # Our link survived and the file it points at was the one updated assert os.path.islink(link) is True assert os.path.realpath(link) == target with open(target) as f: assert set(json.load(f)) == {"abc123", "xyz789"} # No temporary files are left beside either path assert sorted(os.listdir(str(tmpdir0))) == [ "real.json", "subscriptions.json", ] @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_bad_subfile_source(tmpdir): """An unavailable or invalid subscription source is refused.""" smgr = WebPushSubscriptionManager() # A remote source that cannot be fetched. The download is mocked so the # test does not depend on anything outside this machine. with mock.patch("requests.get") as mock_get: mock_get.return_value.status_code = ( requests.codes.internal_server_error ) mock_get.return_value.headers = {} mock_get.return_value.raise_for_status.side_effect = ( requests.RequestException ) mock_get.return_value.__enter__ = lambda s: s mock_get.return_value.__exit__ = lambda s, *a, **kw: None assert smgr.load("https://example.com/subscriptions.json") is False assert len(smgr) == 0 # Reject an empty path as well. assert smgr.load("") is False assert len(smgr) == 0 # A valid local file still loads normally. tmpdir0 = tmpdir.mkdir("local") path = os.path.join(str(tmpdir0), "subscriptions.json") _write_subscriptions(path, ["https://web.push.apple.com/abc123"]) assert smgr.load(path) is True assert len(smgr) == 1 @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_subfile_not_in_url(tmpdir): """A subscription path we worked out ourselves stays out of the URL.""" tmpdir0 = tmpdir.mkdir("portable") asset_ = asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir0), pem_autogen=True, ) obj = Apprise.instantiate("vapid://user@example.ca/abc123", asset=asset_) # The file lives in this URL's own storage directory assert obj.subfile.startswith(obj.store.path) assert obj.subfile_specified is False # The URL omits local details so it can move to another installation. assert "subfile" not in obj.url() assert str(tmpdir0) not in obj.url() @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_subfile_in_url_when_asked(tmpdir): """A subscription path given to us is kept in the URL.""" tmpdir0 = tmpdir.mkdir("explicit") subfile = os.path.join(str(tmpdir0), "subscriptions.json") _write_subscriptions(subfile, ["https://web.push.apple.com/abc123"]) obj = Apprise.instantiate( f"vapid://user@example.ca/abc123?subfile={subfile}", asset=asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir0), pem_autogen=True, ), ) assert obj.subfile == subfile assert obj.subfile_specified is True # It round-trips, so a path someone chose is not lost assert "subfile" in obj.url() reloaded = Apprise.instantiate(obj.url()) assert reloaded.subfile == subfile @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_url_moves_between_servers(tmpdir): """The same URL resolves to each machine's own storage directory.""" rootA = tmpdir.mkdir("serverA") rootB = tmpdir.mkdir("serverB") def _server(root): return Apprise.instantiate( "vapid://user@example.ca/abc123", asset=asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(root), pem_autogen=True, ), ) objA = _server(rootA) objB = Apprise.instantiate( objA.url(), asset=asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(rootB), pem_autogen=True, ), ) # Both land on the same storage id, since it is worked out from the URL # and not from anything local to one machine assert objA.url_id() == objB.url_id() # Each instance reads from its own storage directory. assert objA.subfile.startswith(str(rootA)) assert objB.subfile.startswith(str(rootB)) @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_prune_keeps_other_entries(tmpdir): """Pruning removes only what it was asked to.""" tmpdir0 = tmpdir.mkdir("keep") path = os.path.join(str(tmpdir0), "subscriptions.json") # Mix valid entries with a typo and an entry missing its keys. original = { "good": _subscription("https://fcm.googleapis.com/fcm/send/GOOD"), "dead": _subscription("https://fcm.googleapis.com/fcm/send/DEAD"), "httponly": _subscription("http://legacy.example.com/push/OLD"), "typo": _subscription("https://fcm.googleapis.com /fcm/send/X"), "handedit": {"endpoint": "https://fcm.googleapis.com/fcm/send/Y"}, } with open(path, "w") as f: json.dump(original, f) smgr = WebPushSubscriptionManager() assert smgr.load(path) is True # Only the two usable entries were loaded assert set(smgr.dict) == {"good", "dead"} assert smgr.writable is True assert smgr.prune(["dead"]) is True with open(path) as f: remaining = json.load(f) # The expired entry is gone and nothing else was touched, so somebody's # typo is still theirs to fix rather than quietly deleted assert set(remaining) == {"good", "httponly", "typo", "handedit"} assert remaining["typo"] == original["typo"] assert remaining["handedit"] == original["handedit"] @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_prune_reloads_file(tmpdir): """Each prune uses the latest file instead of stale loaded state.""" tmpdir0 = tmpdir.mkdir("concurrent") path = os.path.join(str(tmpdir0), "subscriptions.json") _write_subscriptions( path, { n: f"https://fcm.googleapis.com/fcm/send/{n}" for n in ("a", "b", "c", "d") }, ) # Both instances begin with the same snapshot. first = WebPushSubscriptionManager() second = WebPushSubscriptionManager() assert first.load(path) is True assert second.load(path) is True assert first.prune(["a"]) is True assert second.prune(["c"]) is True with open(path) as f: remaining = json.load(f) # The second prune reloads the first one's change before writing. assert set(remaining) == {"b", "d"} @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @pytest.mark.skipif(IS_ROOT, reason="Root can write read-only files") def test_plugin_vapid_readonly_file_respected(tmpdir): """A read-only subscription file is left alone.""" tmpdir0 = tmpdir.mkdir("readonly") path = os.path.join(str(tmpdir0), "subscriptions.json") _write_subscriptions(path, ["https://fcm.googleapis.com/fcm/send/X"]) os.chmod(path, 0o444) smgr = WebPushSubscriptionManager() assert smgr.load(path) is True assert smgr.local_file == path # We can read it, but it is not ours to change assert smgr.writable is False # Swapping a file into place only needs permission on the directory, so # prune() has to refuse on its own rather than rely on the caller assert smgr.prune(["x"]) is False with open(path) as f: assert set(json.load(f)) == {"x"} @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @pytest.mark.skipif(IS_ROOT, reason="Root can write read-only files") @mock.patch("requests.post") def test_plugin_vapid_retires_when_not_writable(mock_post, tmpdir): """An expired endpoint is tracked when its file cannot be updated.""" mock_post.return_value = _mk_resp(requests.codes.gone) tmpdir0 = tmpdir.mkdir("retire") subfile = os.path.join(str(tmpdir0), "subscriptions.json") _write_subscriptions(subfile, ["https://web.push.apple.com/DEAD"]) os.chmod(subfile, 0o444) asset_ = asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir0), pem_autogen=True, ) obj = NotifyVapid( "user@example.ca", targets=["dead"], subfile=subfile, asset=asset_, ) assert obj.send("test") is False # The file still holds it, because it was not ours to rewrite with open(subfile) as f: assert set(json.load(f)) == {"dead"} # Remember the endpoint in persistent storage instead. assert obj.store.get(obj.vapid_retired_key) == [ "https://web.push.apple.com/DEAD" ] # A fresh instance skips it and does not report a false success. mock_post.reset_mock() obj2 = NotifyVapid( "user@example.ca", targets=["dead"], subfile=subfile, asset=asset_, ) assert obj2.send("test") is False assert mock_post.call_count == 0 @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_prune_edge_cases(tmpdir): """Pruning declines anything it cannot safely rewrite.""" tmpdir0 = tmpdir.mkdir("edges") # Nothing was loaded, so there is no file to update smgr = WebPushSubscriptionManager() assert smgr.local_file is None assert smgr.writable is False assert smgr.prune(["anything"]) is False # A single entry file carries no names, so there is nothing to take out single = os.path.join(str(tmpdir0), "single.json") with open(single, "w") as f: json.dump( _subscription("https://fcm.googleapis.com/fcm/send/abc123"), f ) smgr = WebPushSubscriptionManager() assert smgr.load(single) is True assert smgr.prune(["abc123"]) is False # A name we do not hold leaves the file exactly as it was many = os.path.join(str(tmpdir0), "many.json") _write_subscriptions(many, ["https://fcm.googleapis.com/fcm/send/abc123"]) smgr = WebPushSubscriptionManager() assert smgr.load(many) is True assert smgr.prune(["nothing-like-this"]) is True with open(many) as f: assert set(json.load(f)) == {"abc123"} # Content that is no longer valid JSON is left for its owner to fix with open(many, "w") as f: f.write("{ this is not json") assert smgr.prune(["abc123"]) is False with open(many) as f: assert f.read() == "{ this is not json" # Also reject a file that does not contain an object. with open(many, "w") as f: json.dump(["not", "an", "object"], f) assert smgr.prune(["abc123"]) is False # A write that fails part way leaves the file as it was _write_subscriptions(many, ["https://fcm.googleapis.com/fcm/send/abc123"]) assert smgr.load(many) is True with mock.patch("json.dump", side_effect=OSError): assert smgr.prune(["abc123"]) is False with open(many) as f: assert set(json.load(f)) == {"abc123"} @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_remote_subfile(tmpdir): """A remotely hosted subscription file loads as read-only.""" tmpdir0 = tmpdir.mkdir("remote") local = os.path.join(str(tmpdir0), "subscriptions.json") _write_subscriptions(local, ["https://fcm.googleapis.com/fcm/send/abc123"]) with open(local, "rb") as f: payload = f.read() smgr = WebPushSubscriptionManager() # Stand in for the download an AppriseAttachment would perform with mock.patch("requests.get") as mock_get: mock_get.return_value.status_code = requests.codes.ok mock_get.return_value.headers = {"Content-Length": len(payload)} mock_get.return_value.iter_content.return_value = iter([payload]) mock_get.return_value.raise_for_status.return_value = None mock_get.return_value.__enter__ = lambda s: s mock_get.return_value.__exit__ = lambda s, *a, **kw: None assert smgr.load("https://example.com/subscriptions.json") is True # The subscription came through assert set(smgr.dict) == {"abc123"} # With no local source file, it cannot be rewritten. assert smgr.local_file is None assert smgr.writable is False assert smgr.prune(["abc123"]) is False @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @mock.patch("requests.post") def test_plugin_vapid_retires_when_prune_fails(mock_post, tmpdir): """A pruning failure still stops the endpoint being tried again.""" mock_post.return_value = _mk_resp(requests.codes.gone) tmpdir0 = tmpdir.mkdir("prunefail") subfile = os.path.join(str(tmpdir0), "subscriptions.json") _write_subscriptions(subfile, ["https://web.push.apple.com/DEAD"]) asset_ = asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir0), pem_autogen=True, ) obj = NotifyVapid( "user@example.ca", targets=["dead"], subfile=subfile, asset=asset_, ) # The file is writable, but rewriting it does not work out with mock.patch.object( WebPushSubscriptionManager, "prune", return_value=False ): assert obj.send("test") is False # The file still lists it, since the rewrite failed with open(subfile) as f: assert set(json.load(f)) == {"dead"} # ...so the endpoint was remembered instead and is not asked for again assert obj.store.get(obj.vapid_retired_key) == [ "https://web.push.apple.com/DEAD" ] mock_post.reset_mock() obj2 = NotifyVapid( "user@example.ca", targets=["dead"], subfile=subfile, asset=asset_, ) assert obj2.send("test") is False assert mock_post.call_count == 0 @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_load_forgets_previous_path(tmpdir): """A later load does not leave an earlier file behind to be pruned.""" tmpdir0 = tmpdir.mkdir("stale") first = os.path.join(str(tmpdir0), "first.json") _write_subscriptions(first, ["https://fcm.googleapis.com/fcm/send/abc123"]) smgr = WebPushSubscriptionManager() assert smgr.load(first) is True assert smgr.local_file == first # A load that fails must not leave the previous file remembered, # otherwise a prune would rewrite a file we are no longer using assert smgr.load(os.path.join(str(tmpdir0), "missing.json")) is False assert smgr.local_file is None assert smgr.writable is False assert smgr.prune(["abc123"]) is False # The first file is untouched with open(first) as f: assert set(json.load(f)) == {"abc123"} @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_logging_masks_secrets(tmpdir): """Endpoints and remote credentials do not reach the logs intact.""" secret = "cH1s-Is-A-SeCr3t-RegIstratIon-Id" # An endpoint token is sensitive and must not appear in logs. masked = cwe312_loggable(f"https://fcm.googleapis.com/fcm/send/{secret}") assert secret not in masked # A missing value is reported rather than blowing up assert cwe312_loggable(None) == "(none)" assert cwe312_loggable("") == "(none)" # Keep local paths readable for troubleshooting. assert ( cwe312_loggable("/etc/apprise/subscriptions.json") == "/etc/apprise/subscriptions.json" ) smgr = WebPushSubscriptionManager() # A remote subscription file can carry a password loggable = smgr.loggable_path( "https://user:pass123@example.com/subscriptions.json" ) assert "pass123" not in loggable assert smgr.loggable_path(None) == "(none)" # Somebody who turns masking off gets the value through untouched smgr_plain = WebPushSubscriptionManager( asset=asset.AppriseAsset(secure_logging=False) ) url = "https://user:pass123@example.com/subscriptions.json" assert smgr_plain.loggable_path(url) == url @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_load_read_errors(tmpdir): """Loading tells a missing file, bad JSON and a disk problem apart.""" tmpdir0 = tmpdir.mkdir("loaderrs") path = os.path.join(str(tmpdir0), "subscriptions.json") _write_subscriptions(path, ["https://fcm.googleapis.com/fcm/send/abc123"]) smgr = WebPushSubscriptionManager() # The file goes away between being resolved and being opened with mock.patch("builtins.open", side_effect=FileNotFoundError): assert smgr.load(path) is False # It is there, but it does not hold JSON with mock.patch( "json.load", side_effect=json.decoder.JSONDecodeError("bad", "", 0) ): assert smgr.load(path) is False # It is there and we are not allowed to read it with mock.patch("builtins.open", side_effect=OSError): assert smgr.load(path) is False # ...and it still loads when nothing is wrong assert smgr.load(path) is True @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_prune_read_errors(tmpdir): """Pruning tells a missing file, bad JSON and a disk problem apart.""" tmpdir0 = tmpdir.mkdir("pruneerrs") path = os.path.join(str(tmpdir0), "subscriptions.json") _write_subscriptions(path, ["https://fcm.googleapis.com/fcm/send/abc123"]) smgr = WebPushSubscriptionManager() assert smgr.load(path) is True # The file goes away before we can rewrite it with mock.patch("builtins.open", side_effect=FileNotFoundError): assert smgr.prune(["abc123"]) is False # Leave newly invalid content untouched rather than overwriting it. with mock.patch( "json.load", side_effect=json.decoder.JSONDecodeError("bad", "", 0) ): assert smgr.prune(["abc123"]) is False # We are no longer allowed to read it with mock.patch("builtins.open", side_effect=OSError): assert smgr.prune(["abc123"]) is False # The file is untouched throughout with open(path) as f: assert set(json.load(f)) == {"abc123"} @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_write_errors(tmpdir): """Writing tells a content problem apart from a disk problem.""" tmpdir0 = tmpdir.mkdir("writeerrs") path = os.path.join(str(tmpdir0), "subscriptions.json") smgr = WebPushSubscriptionManager() assert smgr.add(_subscription("https://web.push.apple.com/abc123")) is True # Content that will not turn into JSON with mock.patch("json.dump", side_effect=TypeError): assert smgr.write(path) is False # A circular reference raises ValueError rather than TypeError with mock.patch("json.dump", side_effect=ValueError): assert smgr.write(path) is False # ...and a disk problem is reported as one with mock.patch("json.dump", side_effect=OSError): assert smgr.write(path) is False # Nothing was left behind by any of those assert os.listdir(str(tmpdir0)) == [] assert smgr.write(path) is True @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_write_unreadable_mode(tmpdir): """A file whose mode cannot be read is still replaced.""" tmpdir0 = tmpdir.mkdir("modeerr") path = os.path.join(str(tmpdir0), "subscriptions.json") smgr = WebPushSubscriptionManager() assert smgr.add(_subscription("https://web.push.apple.com/abc123")) is True assert smgr.write(path) is True # We cannot stat what is already there, so our own mode is kept rather # than guessing at one assert smgr.add(_subscription("https://web.push.apple.com/xyz789")) is True with mock.patch("os.stat", side_effect=PermissionError): assert smgr.write(path) is True with open(path) as f: assert set(json.load(f)) == {"abc123", "xyz789"} @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @mock.patch("requests.post") def test_plugin_vapid_expired_is_reported(mock_post, tmpdir): """An expired subscription is reported as a failure.""" def respond(url, *args, **kwargs): # One device is gone, the other is fine return _mk_resp( requests.codes.gone if url.endswith("DEAD") else requests.codes.created ) mock_post.side_effect = respond obj, _ = _mk_notifier( tmpdir, { "live": "https://web.push.apple.com/LIVE", "dead": "https://web.push.apple.com/DEAD", }, ["live", "dead"], name="expreport", ) # The expired endpoint is a real failure; it is pruned below so no # retry will reach for it again. assert obj.send("test") is False assert "dead" not in obj.subscriptions @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) @mock.patch("requests.post") def test_plugin_vapid_all_expired_still_fails(mock_post, tmpdir): """Nothing reaching anybody is a failure however we got there.""" mock_post.return_value = _mk_resp(requests.codes.gone) obj, _ = _mk_notifier( tmpdir, ["https://web.push.apple.com/DEAD"], ["dead"], name="allexp", ) # Every target expired, so the message went nowhere. assert obj.send("test") is False @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_image_url(tmpdir): """The image flag survives a round trip through the URL.""" tmpdir0 = tmpdir.mkdir("imgurl") asset_ = asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir0), pem_autogen=True, ) # Images are included by default obj = Apprise.instantiate("vapid://user@example.ca/abc123", asset=asset_) assert obj.include_image is True assert "image=yes" in obj.url() # Turning them off is remembered rather than quietly lost when the URL # is rebuilt off = Apprise.instantiate( "vapid://user@example.ca/abc123?image=no", asset=asset_ ) assert off.include_image is False assert "image=no" in off.url() assert Apprise.instantiate(off.url()).include_image is False assert Apprise.instantiate(obj.url()).include_image is True @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_autogen(tmpdir): """Create and manage the default subscription file.""" tmpdir0 = tmpdir.mkdir("autogen") # With nothing to work with there is no file and nothing to load smgr = WebPushSubscriptionManager() assert smgr.subscription_file is None assert smgr.loaded is False assert smgr.autogen() is False assert smgr.load() is False assert smgr.loaded is True # A directory gives us a file of our own to create smgr = WebPushSubscriptionManager(str(tmpdir0)) assert smgr.subscription_file == os.path.join( str(tmpdir0), WebPushSubscriptionManager.default_filename ) assert smgr.autogen() is True # The file shows what a subscription is supposed to look like with open(smgr.subscription_file) as f: assert json.load(f) == smgr.template # We do not overwrite what is already there assert smgr.autogen() is False # The placeholder is not a working subscription, so loading it leaves us # with nothing to notify assert smgr.load() is True assert len(smgr) == 0 # A file we were pointed at belongs to our user, not to us subfile = os.path.join(str(tmpdir0), "mine.json") smgr = WebPushSubscriptionManager(str(tmpdir0), subfile=subfile) assert smgr.subscription_file == subfile assert smgr.autogen() is False assert not os.path.exists(subfile) # A file we cannot write does not cause an exception tmpdir1 = tmpdir.mkdir("autogen-fail") smgr = WebPushSubscriptionManager(str(tmpdir1)) with mock.patch("json.dump", side_effect=OSError): assert smgr.autogen() is False @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_autogen_disabled(tmpdir): """No starter file is left behind when auto-generation is turned off.""" tmpdir0 = tmpdir.mkdir("noautogen") asset_ = asset.AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir0), pem_autogen=False, ) obj = Apprise.instantiate("vapid://user@example.ca/abc123", asset=asset_) assert obj.subfile is not None assert not os.path.exists(obj.subfile) # There is nothing for us to notify with assert obj.send("test") is False @pytest.mark.skipif( "cryptography" not in sys.modules, reason="Requires cryptography" ) def test_plugin_vapid_rejects_malformed_subscription(tmpdir): """Reject malformed subscription data without raising exceptions.""" smgr = WebPushSubscriptionManager() # The keys entry is not an object we can read for keys in (None, "nope", [1, 2], 42): assert ( smgr.add( {"endpoint": "https://web.push.apple.com/X", "keys": keys}, name="junk", ) is False ) # The keys are there, but they are not base64 assert ( smgr.add( { "endpoint": "https://web.push.apple.com/X", "keys": {"p256dh": "!!", "auth": "!!"}, }, name="junk", ) is False ) assert len(smgr) == 0 # Reject nesting deep enough to exhaust the JSON parser tmpdir0 = tmpdir.mkdir("junk") path = os.path.join(str(tmpdir0), "subscriptions.json") with open(path, "w") as f: f.write("[" * 200000 + "]" * 200000) assert smgr.load(path) is False # Reject the same nesting when supplied as a string assert WebPushSubscription().load("[" * 200000 + "]" * 200000) is False caronc-apprise-dfec414/tests/test_plugin_viber.py000066400000000000000000000135631526720371000223670ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from json import dumps import logging from helpers import AppriseURLTester import requests from apprise import Apprise from apprise.plugins.viber import NotifyViber logging.disable(logging.CRITICAL) VIBER_GOOD_RESPONSE = dumps({"status": 0, "status_message": "ok"}) VIBER_BAD_RESPONSE = dumps( {"status": 12, "status_message": "Too many requests"} ) # Our Testing URLs apprise_url_tests = ( ("viber://", False), ("viber:///", False), ("viber://tokena", {"instance": NotifyViber, "notify_response": False}), ( "viber://?token=tokenb", {"instance": NotifyViber, "notify_response": False}, ), ( "viber://token/targetx", { "instance": NotifyViber, # Our response expected server response "requests_response_text": VIBER_GOOD_RESPONSE, }, ), ( "viber://token/t1/t2?from=Viber%20Bot", { "instance": NotifyViber, "requests_response_text": VIBER_GOOD_RESPONSE, }, ), ( "viber://t1/t2?token=token", { "instance": NotifyViber, "requests_response_text": VIBER_GOOD_RESPONSE, }, ), ( "viber://?token=token&to=t5", { "instance": NotifyViber, "requests_response_text": VIBER_GOOD_RESPONSE, }, ), ( "viber://token/t3?avatar=value", { "instance": NotifyViber, "requests_response_text": VIBER_GOOD_RESPONSE, }, ), ( "viber://token/?to=abc,def", { "instance": NotifyViber, "requests_response_text": VIBER_GOOD_RESPONSE, }, ), ( "viber://token/m12/?from={}".format( "a" * (NotifyViber.viber_sender_name_limit + 1) ), { "instance": NotifyViber, "requests_response_text": VIBER_GOOD_RESPONSE, }, ), ( "viber://token/m12/?from={}".format( "b" * (NotifyViber.viber_sender_name_limit) ), { "instance": NotifyViber, "requests_response_text": VIBER_GOOD_RESPONSE, }, ), ( "viber://?token=token&to=hij,klm", { "instance": NotifyViber, "requests_response_text": VIBER_GOOD_RESPONSE, }, ), ( "viber://?token=token&to=nop,qrs", { "instance": NotifyViber, "requests_response_text": VIBER_BAD_RESPONSE, "notify_response": False, }, ), ( "viber://?token=token&to=tuv,wxy", { "instance": NotifyViber, # Bad JSON "requests_response_text": "{", "notify_response": False, }, ), # Privacy redaction of token ( "viber://token/t10", { "instance": NotifyViber, "requests_response_text": VIBER_GOOD_RESPONSE, "privacy_url": "viber://****/t10", }, ), ( "viber://token/targetZ", { "instance": NotifyViber, # throw a bizarre code forcing us to fail to look it up "requests_response_text": VIBER_GOOD_RESPONSE, "response": False, "requests_response_code": 999, }, ), ( "viber://token/targetZ", { "instance": NotifyViber, # force a failure "response": False, "requests_response_text": VIBER_BAD_RESPONSE, "requests_response_code": requests.codes.internal_server_error, }, ), ( "viber://token/targetY", { "instance": NotifyViber, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "requests_response_text": VIBER_GOOD_RESPONSE, "test_requests_exceptions": True, }, ), ) def test_plugin_viber_urls(): """Verify URL parsing, privacy, and basic validation.""" AppriseURLTester(tests=apprise_url_tests).run_all() def test_plugin_viber_http_error_and_exception(mocker): """Verify HTTP error and requests exception paths.""" post = mocker.patch("requests.post") post.return_value.status_code = 400 a = Apprise() assert a.add("viber://token/target2") is True assert bool(a.notify("test")) is False post.side_effect = requests.RequestException("boom") a = Apprise() assert a.add("viber://token/target2") is True assert bool(a.notify("test")) is False caronc-apprise-dfec414/tests/test_plugin_voipms.py000066400000000000000000000204111526720371000225630ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from json import dumps # Disable logging for a cleaner testing output import logging from unittest import mock from helpers import AppriseURLTester import pytest import requests from apprise import Apprise from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.voipms import NotifyVoipms logging.disable(logging.CRITICAL) # Our Testing URLs apprise_url_tests = ( ( "voipms://", { # No email/password specified "instance": AppriseImproperlyConfigured, }, ), ( "voipms://@:", { # Invalid url "instance": AppriseImproperlyConfigured, }, ), ( "voipms://{}/{}".format("user@example.com", "1" * 11), { # No password specified "instance": AppriseImproperlyConfigured, }, ), ( "voipms://:{}".format("password"), { # No email specified "instance": AppriseImproperlyConfigured, }, ), ( "voipms://{}:{}/{}".format("user@", "pass", "1" * 11), { # Check valid email "instance": AppriseImproperlyConfigured, }, ), ( "voipms://{password}:{email}".format( email="user@example.com", password="password" ), { # No from_phone specified "instance": AppriseImproperlyConfigured, }, ), # Invalid phone number test ( "voipms://{password}:{email}/1613".format( email="user@example.com", password="password" ), { # Invalid phone number "instance": AppriseImproperlyConfigured, }, ), # Invalid country code phone number test ( "voipms://{password}:{email}/01133122446688".format( email="user@example.com", password="password" ), { # Non North American phone number "instance": AppriseImproperlyConfigured, }, ), ( "voipms://{password}:{email}/{from_phone}/{targets}/".format( email="user@example.com", password="password", from_phone="16134448888", targets="/".join(["26134442222"]), ), { # Invalid target phone number "instance": NotifyVoipms, "response": False, "requests_response_code": 999, }, ), ( "voipms://{password}:{email}/{from_phone}".format( email="user@example.com", password="password", from_phone="16138884444", ), { "instance": NotifyVoipms, # No targets specified "response": False, "requests_response_code": 999, }, ), ( "voipms://{password}:{email}/?from={from_phone}".format( email="user@example.com", password="password", from_phone="16138884444", ), { "instance": NotifyVoipms, # No targets specified "response": False, "requests_response_code": 999, }, ), ( "voipms://{password}:{email}/{from_phone}/{targets}/".format( email="user@example.com", password="password", from_phone="16138884444", targets="/".join(["16134442222"]), ), { # Valid "instance": NotifyVoipms, "response": True, "privacy_url": "voipms://p...d:user@example.com/16...4", }, ), ( "voipms://{password}:{email}/{from_phone}/{targets}/".format( email="user@example.com", password="password", from_phone="16138884444", targets="/".join(["16134442222", "16134443333"]), ), { # Valid multiple targets "instance": NotifyVoipms, "response": True, "privacy_url": "voipms://p...d:user@example.com/16...4", }, ), ( "voipms://{password}:{email}/?from={from_phone}&to={targets}".format( email="user@example.com", password="password", from_phone="16138884444", targets="16134448888", ), { # Valid "instance": NotifyVoipms, }, ), ( "voipms://{password}:{email}/{from_phone}/{targets}/".format( email="user@example.com", password="password", from_phone="16138884444", targets="16134442222", ), { "instance": NotifyVoipms, # Throws a series of errors "test_requests_exceptions": True, }, ), ) def test_plugin_voipms(): """NotifyVoipms() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() @mock.patch("requests.get") def test_plugin_voipms_edge_cases(mock_get): """NotifyVoipms() Edge Cases.""" # Prepare our response response = requests.Request() response.status_code = requests.codes.ok # Prepare Mock mock_get.return_value = response # Initialize some generic (but valid) tokens email = "user@example.com" password = "password" source = "+1 (555) 123-3456" targets = "+1 (555) 123-9876" # No email specified with pytest.raises(AppriseImproperlyConfigured): NotifyVoipms(email=None, source=source) # a error response is returned response.status_code = 400 response.content = dumps( { "code": 21211, "message": "Unable to process your request.", } ) mock_get.return_value = response # Initialize our object obj = Apprise.instantiate( f"voipms://{password}:{email}/{source}/{targets}" ) assert isinstance(obj, NotifyVoipms) # We will fail with the above error code assert bool(obj.notify("title", "body", "info")) is False @mock.patch("requests.get") def test_plugin_voipms_non_success_status(mock_get): """NotifyVoipms() Non Success Status.""" # Prepare our response response = requests.Request() response.status_code = requests.codes.ok # Prepare Mock mock_get.return_value = response # A 200 response is returned but non-success message response.status_code = 200 response.content = dumps( { "status": "invalid_credentials", "message": "Username or Password is incorrect", } ) obj = Apprise.instantiate( "voipms://{password}:{email}/{source}/{targets}".format( email="user@example.com", password="badpassword", source="16134448888", targets="16134442222", ) ) assert isinstance(obj, NotifyVoipms) # We will fail with the above error code assert bool(obj.notify("title", "body", "info")) is False response.content = "{" assert obj.send("title", "body") is False caronc-apprise-dfec414/tests/test_plugin_vonage.py000066400000000000000000000221171526720371000225320ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from json import dumps # Disable logging for a cleaner testing output import logging from unittest import mock from helpers import AppriseURLTester import pytest import requests from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.vonage import NotifyVonage logging.disable(logging.CRITICAL) # Our Testing URLs apprise_url_tests = ( ( "vonage://", { # No API Key specified "instance": AppriseImproperlyConfigured, }, ), ( "vonage://:@/", { # invalid Auth key "instance": AppriseImproperlyConfigured, }, ), ( "vonage://AC{}@12345678".format("a" * 8), { # Just a key provided "instance": AppriseImproperlyConfigured, }, ), ( "vonage://AC{}:{}@{}".format("a" * 8, "b" * 16, "3" * 9), { # key and secret provided and from but invalid from no "instance": AppriseImproperlyConfigured, }, ), ( "vonage://AC{}:{}@{}/?ttl=0".format("b" * 8, "c" * 16, "3" * 11), { # Invalid ttl defined "instance": AppriseImproperlyConfigured, }, ), ( "vonage://AC{}:{}@{}".format("d" * 8, "e" * 16, "a" * 11), { # Invalid source number "instance": AppriseImproperlyConfigured, }, ), ( "vonage://AC{}:{}@{}/123/{}/abcd/".format( "f" * 8, "g" * 16, "3" * 11, "9" * 15 ), { # valid everything but target numbers "instance": NotifyVonage, # Our expected url(privacy=True) startswith() response: "privacy_url": "vonage://A...f:****@", }, ), ( "vonage://AC{}:{}@{}".format("h" * 8, "i" * 16, "5" * 11), { # using phone no with no target - we text ourselves in # this case "instance": NotifyVonage, }, ), ( "vonage://_?key=AC{}&secret={}&from={}".format( "a" * 8, "b" * 16, "5" * 11 ), { # use get args to acomplish the same thing "instance": NotifyVonage, }, ), ( "vonage://_?key=AC{}&secret={}&source={}".format( "a" * 8, "b" * 16, "5" * 11 ), { # use get args to acomplish the same thing (use source instead # of from) "instance": NotifyVonage, }, ), ( "vonage://_?key=AC{}&secret={}&from={}&to={}".format( "a" * 8, "b" * 16, "5" * 11, "7" * 13 ), { # use to= "instance": NotifyVonage, }, ), ( "vonage://AC{}:{}@{}".format("a" * 8, "b" * 16, "6" * 11), { "instance": NotifyVonage, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( "vonage://AC{}:{}@{}".format("a" * 8, "b" * 16, "6" * 11), { "instance": NotifyVonage, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), # Nexmo Backwards Support ( "nexmo://", { # No API Key specified "instance": AppriseImproperlyConfigured, }, ), ( "nexmo://:@/", { # invalid Auth key "instance": AppriseImproperlyConfigured, }, ), ( "nexmo://AC{}@12345678".format("a" * 8), { # Just a key provided "instance": AppriseImproperlyConfigured, }, ), ( "nexmo://AC{}:{}@{}".format("a" * 8, "b" * 16, "3" * 9), { # key and secret provided and from but invalid from no "instance": AppriseImproperlyConfigured, }, ), ( "nexmo://AC{}:{}@{}/?ttl=0".format("b" * 8, "c" * 16, "3" * 11), { # Invalid ttl defined "instance": AppriseImproperlyConfigured, }, ), ( "nexmo://AC{}:{}@{}".format("d" * 8, "e" * 16, "a" * 11), { # Invalid source number "instance": AppriseImproperlyConfigured, }, ), ( "nexmo://AC{}:{}@{}/123/{}/abcd/".format( "f" * 8, "g" * 16, "3" * 11, "9" * 15 ), { # valid everything but target numbers "instance": NotifyVonage, # Our expected url(privacy=True) startswith() response: "privacy_url": "vonage://A...f:****@", }, ), ( "nexmo://AC{}:{}@{}".format("h" * 8, "i" * 16, "5" * 11), { # using phone no with no target - we text ourselves in # this case "instance": NotifyVonage, }, ), ( "nexmo://_?key=AC{}&secret={}&from={}".format( "a" * 8, "b" * 16, "5" * 11 ), { # use get args to acomplish the same thing "instance": NotifyVonage, }, ), ( "nexmo://_?key=AC{}&secret={}&source={}".format( "a" * 8, "b" * 16, "5" * 11 ), { # use get args to acomplish the same thing (use source instead of # from) "instance": NotifyVonage, }, ), ( "nexmo://_?key=AC{}&secret={}&from={}&to={}".format( "a" * 8, "b" * 16, "5" * 11, "7" * 13 ), { # use to= "instance": NotifyVonage, }, ), ( "nexmo://AC{}:{}@{}".format("a" * 8, "b" * 16, "6" * 11), { "instance": NotifyVonage, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( "nexmo://AC{}:{}@{}".format("a" * 8, "b" * 16, "6" * 11), { "instance": NotifyVonage, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), ) def test_plugin_vonage_urls(): """NotifyVonage() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() @mock.patch("requests.post") def test_plugin_vonage_edge_cases(mock_post): """NotifyVonage() Edge Cases.""" # Prepare our response response = requests.Request() response.status_code = requests.codes.ok # Prepare Mock mock_post.return_value = response # Initialize some generic (but valid) tokens apikey = "AC{}".format("b" * 8) secret = "{}".format("b" * 16) source = "+1 (555) 123-3456" # No apikey specified with pytest.raises(AppriseImproperlyConfigured): NotifyVonage(apikey=None, secret=secret, source=source) with pytest.raises(AppriseImproperlyConfigured): NotifyVonage(apikey=" ", secret=secret, source=source) # No secret specified with pytest.raises(AppriseImproperlyConfigured): NotifyVonage(apikey=apikey, secret=None, source=source) with pytest.raises(AppriseImproperlyConfigured): NotifyVonage(apikey=apikey, secret=" ", source=source) # a error response response.status_code = 400 response.content = dumps( { "code": 21211, "message": "The 'To' number +1234567 is not a valid phone number.", } ) mock_post.return_value = response # Initialize our object obj = NotifyVonage(apikey=apikey, secret=secret, source=source) # We will fail with the above error code assert bool(obj.notify("title", "body", "info")) is False caronc-apprise-dfec414/tests/test_plugin_webex_teams.py000066400000000000000000000624641526720371000235670ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Disable logging for a cleaner testing output from json import loads import logging import os from unittest import mock from helpers import AppriseURLTester import pytest import requests from apprise import Apprise, AppriseAttachment, NotifyFormat, NotifyType from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.webexteams import ( NotifyWebexTeams, WebexTeamsMode, ) logging.disable(logging.CRITICAL) # Attachment Directory TEST_VAR_DIR = os.path.join(os.path.dirname(__file__), "var") # A valid webhook token (80 lowercase alphanumeric chars) WEBHOOK_TOKEN = "a" * 80 # A valid bot access token (longer than 160 chars, contains hyphen) # Must be > 160 chars or contain non-alphanumeric chars to bypass # the webhook-token regex (which only allows [a-z0-9], 80-160 chars). # Using 200 chars ending in '0' so the privacy URL ends in '0'. BOT_TOKEN = "Bc10" * 50 # 200 chars, ends in '0' # A valid Webex room ID (base64url-like, 50 chars) ROOM_ID = "Y2lzY29zcGFyazovL3VzL1JPTU9NLzEyMzQ1Njc4OTAxMjM0" ROOM_ID2 = "Y2lzY29zcGFyazovL3VzL1JPTU9NL2FiY2RlZjEyMzQ1Njc4" # Our Testing URLs apprise_url_tests = ( ( "wxteams://", { # Token missing "instance": AppriseImproperlyConfigured, }, ), ( "wxteams://:@/", { # We don't have strict host checking on for wxteams, so this # URL actually becomes parseable and :@ becomes a hostname. # The below errors because a second token wasn't found "instance": AppriseImproperlyConfigured, }, ), ( "wxteams://{}".format("a" * 80), { # webhook token provided - we're good "instance": NotifyWebexTeams, # Our expected url(privacy=True) startswith() response: "privacy_url": "wxteams://a...a/", }, ), ( "wxteams://?token={}".format("a" * 80), { # token as query param - we're good "instance": NotifyWebexTeams, # Our expected url(privacy=True) startswith() response: "privacy_url": "wxteams://a...a/", }, ), ( "webex://{}".format("a" * 140), { # token provided via 'webex' schema - we're good "instance": NotifyWebexTeams, # Our expected url(privacy=True) startswith() response: "privacy_url": "wxteams://a...a/", }, ), # Support Native Webhook URLs ( "https://api.ciscospark.com/v1/webhooks/incoming/{}".format("a" * 80), { # token provided - we're good "instance": NotifyWebexTeams, }, ), # Support New Native Webhook URLs ( "https://webexapis.com/v1/webhooks/incoming/{}".format("a" * 100), { # token provided - we're good "instance": NotifyWebexTeams, }, ), # Support Native Webhook URLs with arguments ( "https://api.ciscospark.com/v1/webhooks/incoming/{}" "?format=text".format("a" * 80), { # token provided - we're good "instance": NotifyWebexTeams, }, ), # Bot mode: access_token + room ID ( "wxteams://{}/{}".format(BOT_TOKEN, ROOM_ID), { "instance": NotifyWebexTeams, "privacy_url": "wxteams://B...0/", }, ), # Bot mode: explicit mode=bot with no room IDs - loads but fails to send ( "wxteams://{}?mode=bot".format("a" * 80), { "instance": NotifyWebexTeams, # notify() returns False with no targets (no HTTP call needed) "notify_response": False, }, ), # Explicit mode=webhook with a valid webhook token ( "wxteams://{}?mode=webhook".format("a" * 80), { "instance": NotifyWebexTeams, "privacy_url": "wxteams://a...a/", }, ), # Invalid mode ( "wxteams://{}?mode=invalid".format("a" * 80), { "instance": AppriseImproperlyConfigured, }, ), # Webhook mode: HTTP 500 response ( "wxteams://{}".format("a" * 80), { "instance": NotifyWebexTeams, "response": False, "requests_response_code": (requests.codes.internal_server_error), }, ), # Webhook mode: unusual HTTP response code ( "wxteams://{}".format("a" * 80), { "instance": NotifyWebexTeams, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), # Webhook mode: request exception ( "wxteams://{}".format("a" * 80), { "instance": NotifyWebexTeams, # Throws a series of i/o exceptions with this flag set and # tests that we gracefully handle them "test_requests_exceptions": True, }, ), # Bot mode: HTTP 500 response ( "wxteams://{}/{}".format(BOT_TOKEN, ROOM_ID), { "instance": NotifyWebexTeams, "response": False, "requests_response_code": (requests.codes.internal_server_error), }, ), # Bot mode: unusual HTTP response code ( "wxteams://{}/{}".format(BOT_TOKEN, ROOM_ID), { "instance": NotifyWebexTeams, "response": False, "requests_response_code": 999, }, ), # Bot mode: request exception ( "wxteams://{}/{}".format(BOT_TOKEN, ROOM_ID), { "instance": NotifyWebexTeams, "test_requests_exceptions": True, }, ), ) def test_plugin_webex_teams_urls(): """NotifyWebexTeams() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() def test_plugin_webex_teams_webhook_mode(): """NotifyWebexTeams() Webhook mode direct tests.""" # Valid webhook token token = "b" * 80 obj = NotifyWebexTeams(token=token) assert isinstance(obj, NotifyWebexTeams) assert obj.mode == WebexTeamsMode.WEBHOOK # url() round-trip url = obj.url() assert "wxteams://" in url assert "mode=webhook" in url # parse_url round-trip result = NotifyWebexTeams.parse_url(url) assert result is not None obj2 = NotifyWebexTeams(**result) assert obj2.mode == WebexTeamsMode.WEBHOOK assert obj2.token == token # privacy URL priv = obj.url(privacy=True) assert obj.token not in priv # url_identifier assert obj.url_identifier == ( NotifyWebexTeams.secure_protocol[0], token, ) # 80-char token (minimum) assert NotifyWebexTeams(token="c" * 80) # 160-char token (maximum) assert NotifyWebexTeams(token="c" * 160) # Too short for webhook -> falls to bot mode (no targets), loads but # send() returns False obj_short = NotifyWebexTeams(token="c" * 79) assert obj_short.mode == WebexTeamsMode.BOT assert obj_short.send(body="test") is False # Too long for webhook -> bot mode, same behaviour obj_long = NotifyWebexTeams(token="c" * 161) assert obj_long.mode == WebexTeamsMode.BOT assert obj_long.send(body="test") is False # No token candidate is invalid. with pytest.raises(AppriseImproperlyConfigured): NotifyWebexTeams(token=None) # An empty token is invalid. with pytest.raises(AppriseImproperlyConfigured): NotifyWebexTeams(token="") # Non-alphanumeric chars -> falls to bot mode (no targets) obj_hyph = NotifyWebexTeams(token="a-b-" * 20) assert obj_hyph.mode == WebexTeamsMode.BOT assert obj_hyph.send(body="test") is False def test_plugin_webex_teams_bot_mode(): """NotifyWebexTeams() Bot mode direct tests.""" obj = NotifyWebexTeams(access_token=BOT_TOKEN, targets=[ROOM_ID]) assert isinstance(obj, NotifyWebexTeams) assert obj.mode == WebexTeamsMode.BOT assert obj.access_token == BOT_TOKEN assert ROOM_ID in obj.targets # url() round-trip url = obj.url() assert "wxteams://" in url assert "mode=bot" in url result = NotifyWebexTeams.parse_url(url) assert result is not None obj2 = NotifyWebexTeams(**result) assert obj2.mode == WebexTeamsMode.BOT assert obj2.access_token == BOT_TOKEN assert ROOM_ID in obj2.targets # privacy URL masks the token priv = obj.url(privacy=True) assert BOT_TOKEN not in priv # url_identifier assert obj.url_identifier == ( NotifyWebexTeams.secure_protocol[0], BOT_TOKEN, ) # Multiple rooms obj3 = NotifyWebexTeams( access_token=BOT_TOKEN, targets=[ROOM_ID, ROOM_ID2] ) assert len(obj3.targets) == 2 assert len(obj3) == 2 # No room IDs -> loads fine, but send() returns False obj_no_rooms = NotifyWebexTeams(access_token=BOT_TOKEN, targets=[]) assert len(obj_no_rooms) == 1 assert isinstance(obj_no_rooms, NotifyWebexTeams) assert obj_no_rooms.send(body="test") is False # An access token is required. with pytest.raises(AppriseImproperlyConfigured): NotifyWebexTeams(access_token=None, targets=[ROOM_ID]) # Bot mode requires a token or access token. with pytest.raises(AppriseImproperlyConfigured): NotifyWebexTeams(mode="bot", targets=[ROOM_ID]) # Explicit mode=bot on a short (webhook-style) token obj4 = NotifyWebexTeams(token="a" * 80, mode="bot", targets=[ROOM_ID]) assert obj4.mode == WebexTeamsMode.BOT # The 'token' argument is used as access_token in bot mode assert obj4.access_token == "a" * 80 # Invalid mode with pytest.raises(AppriseImproperlyConfigured): NotifyWebexTeams( access_token=BOT_TOKEN, targets=[ROOM_ID], mode="invalid", ) def test_plugin_webex_teams_body_maxlen(): """NotifyWebexTeams() body_maxlen varies by mode.""" # Webhook mode: 1000 chars obj = NotifyWebexTeams(token=WEBHOOK_TOKEN) assert obj.body_maxlen == 1000 # Bot mode: 7439 chars obj = NotifyWebexTeams(access_token=BOT_TOKEN, targets=[ROOM_ID]) assert obj.body_maxlen == 7439 def test_plugin_webex_teams_mode_detection(): """NotifyWebexTeams() auto-detects mode from token format.""" # 80-char lowercase alphanumeric -> WEBHOOK obj = NotifyWebexTeams(token="a" * 80) assert obj.mode == WebexTeamsMode.WEBHOOK # 80-char uppercase alphanumeric also matches webhook regex # (regex uses 'i' flag); no targets means webhook mode obj = NotifyWebexTeams(token="A" * 80) assert obj.mode == WebexTeamsMode.WEBHOOK # Token longer than 160 chars -> fails webhook regex -> BOT obj = NotifyWebexTeams(token="a" * 200, targets=[ROOM_ID]) assert obj.mode == WebexTeamsMode.BOT # Token with hyphens (non-alphanumeric) -> fails webhook regex -> BOT obj = NotifyWebexTeams(access_token=BOT_TOKEN, targets=[ROOM_ID]) assert obj.mode == WebexTeamsMode.BOT def test_plugin_webex_teams_url_parsing(): """NotifyWebexTeams() URL parsing edge cases.""" # Webhook via ?token= param result = NotifyWebexTeams.parse_url("wxteams://?token={}".format("a" * 80)) assert result is not None obj = NotifyWebexTeams(**result) assert obj.mode == WebexTeamsMode.WEBHOOK assert obj.token == "a" * 80 # Bot mode: access_token in host, room ID in path result = NotifyWebexTeams.parse_url( "wxteams://{}/{}".format(BOT_TOKEN, ROOM_ID) ) assert result is not None obj = NotifyWebexTeams(**result) assert obj.mode == WebexTeamsMode.BOT assert ROOM_ID in obj.targets # Bot mode: multiple room IDs in path result = NotifyWebexTeams.parse_url( "wxteams://{}/{}/{}".format(BOT_TOKEN, ROOM_ID, ROOM_ID2) ) assert result is not None obj = NotifyWebexTeams(**result) assert obj.mode == WebexTeamsMode.BOT assert len(obj.targets) == 2 # Bot mode: room IDs via ?to= param result = NotifyWebexTeams.parse_url( "wxteams://{}?to={}&mode=bot".format(BOT_TOKEN, ROOM_ID) ) assert result is not None obj = NotifyWebexTeams(**result) assert obj.mode == WebexTeamsMode.BOT assert ROOM_ID in obj.targets # Native webhook URL result = NotifyWebexTeams.parse_native_url( "https://api.ciscospark.com/v1/webhooks/incoming/{}".format("a" * 80) ) assert result is not None obj = NotifyWebexTeams(**result) assert obj.mode == WebexTeamsMode.WEBHOOK # New native webhook URL result = NotifyWebexTeams.parse_native_url( "https://webexapis.com/v1/webhooks/incoming/{}".format("a" * 100) ) assert result is not None obj = NotifyWebexTeams(**result) assert obj.mode == WebexTeamsMode.WEBHOOK # parse_native_url returns None for non-matching URLs assert ( NotifyWebexTeams.parse_native_url( "https://example.com/not/a/webex/url" ) is None ) # Webhook mode forced with ?mode=webhook even with path entries result = NotifyWebexTeams.parse_url( "wxteams://{}?mode=webhook".format("a" * 80) ) assert result is not None obj = NotifyWebexTeams(**result) assert obj.mode == WebexTeamsMode.WEBHOOK @mock.patch("requests.post") def test_plugin_webex_teams_webhook_send(mock_post): """NotifyWebexTeams() Webhook send() coverage.""" # Prepare a good response response = mock.Mock() response.status_code = requests.codes.ok response.content = b"" mock_post.return_value = response obj = NotifyWebexTeams(token=WEBHOOK_TOKEN) # Successful send assert obj.send(body="test message") is True assert mock_post.call_count == 1 call_url = mock_post.call_args[0][0] assert "webhooks/incoming" in call_url assert WEBHOOK_TOKEN in call_url # Verify correct Content-Type header headers = mock_post.call_args[1]["headers"] assert headers["Content-Type"] == "application/json" mock_post.reset_mock() # 204 No Content is also acceptable response.status_code = requests.codes.no_content assert obj.send(body="test") is True mock_post.reset_mock() # HTTP error response.status_code = requests.codes.internal_server_error assert obj.send(body="test") is False mock_post.reset_mock() # Unknown HTTP error code response.status_code = 999 assert obj.send(body="test") is False mock_post.reset_mock() # Connection error mock_post.side_effect = requests.RequestException() assert obj.send(body="test") is False mock_post.side_effect = None mock_post.return_value = response response.status_code = requests.codes.ok # Webhook warns about attachments (but still proceeds) mock_post.reset_mock() path = os.path.join(TEST_VAR_DIR, "apprise-test.gif") attach = AppriseAttachment(path) assert obj.send(body="test", attach=attach) is True # Only one POST call: text-only webhook assert mock_post.call_count == 1 @mock.patch("requests.post") def test_plugin_webex_teams_bot_send(mock_post): """NotifyWebexTeams() Bot send() text-only coverage.""" response = mock.Mock() response.status_code = requests.codes.ok response.content = b"" mock_post.return_value = response obj = NotifyWebexTeams(access_token=BOT_TOKEN, targets=[ROOM_ID]) # Successful text send assert obj.send(body="hello from bot") is True assert mock_post.call_count == 1 call_url = mock_post.call_args[0][0] assert call_url == "https://webexapis.com/v1/messages" # Verify Bearer authorization headers = mock_post.call_args[1]["headers"] assert headers["Authorization"] == f"Bearer {BOT_TOKEN}" assert headers["Content-Type"] == "application/json" mock_post.reset_mock() # Two rooms -> two calls obj2 = NotifyWebexTeams( access_token=BOT_TOKEN, targets=[ROOM_ID, ROOM_ID2] ) assert obj2.send(body="broadcast") is True assert mock_post.call_count == 2 mock_post.reset_mock() # HTTP error for bot mode response.status_code = requests.codes.internal_server_error assert obj.send(body="test") is False mock_post.reset_mock() response.status_code = 999 assert obj.send(body="test") is False mock_post.reset_mock() # Connection error for bot mode mock_post.side_effect = requests.RequestException() assert obj.send(body="test") is False mock_post.side_effect = None response.status_code = requests.codes.ok mock_post.return_value = response # Two rooms: second fails -> overall failure reported mock_post.reset_mock() fail_response = mock.Mock() fail_response.status_code = requests.codes.internal_server_error fail_response.content = b"" mock_post.side_effect = [response, fail_response] obj2 = NotifyWebexTeams( access_token=BOT_TOKEN, targets=[ROOM_ID, ROOM_ID2] ) assert obj2.send(body="test") is False @mock.patch("requests.post") def test_plugin_webex_teams_bot_attachments(mock_post): """NotifyWebexTeams() Bot mode attachment coverage.""" response = mock.Mock() response.status_code = requests.codes.ok response.content = b"" mock_post.return_value = response obj = NotifyWebexTeams(access_token=BOT_TOKEN, targets=[ROOM_ID]) path = os.path.join(TEST_VAR_DIR, "apprise-test.gif") attach = AppriseAttachment(path) # Successful single attachment mock_post.reset_mock() assert ( bool( obj.notify( body="see attached", title="", notify_type=NotifyType.INFO, attach=attach, ) ) is True ) # One POST call for the single attachment assert mock_post.call_count == 1 call_url = mock_post.call_args[0][0] assert call_url == "https://webexapis.com/v1/messages" # No Content-Type header set (multipart sets its own) headers = mock_post.call_args[1]["headers"] assert "Content-Type" not in headers # files kwarg was provided assert mock_post.call_args[1].get("files") is not None # Multiple attachments -> one POST per attachment mock_post.reset_mock() path2 = os.path.join(TEST_VAR_DIR, "apprise-test.png") attach2 = AppriseAttachment([path, path2]) assert obj.send(body="two files", attach=attach2) is True assert mock_post.call_count == 2 # Two rooms, one attachment -> 2 POST calls mock_post.reset_mock() obj2 = NotifyWebexTeams( access_token=BOT_TOKEN, targets=[ROOM_ID, ROOM_ID2] ) assert obj2.send(body="room broadcast", attach=attach) is True assert mock_post.call_count == 2 # Connection error on attachment POST mock_post.reset_mock() mock_post.side_effect = requests.RequestException() assert obj.send(body="test", attach=attach) is False mock_post.side_effect = None mock_post.return_value = response # OSError reading attachment mock_post.reset_mock() mock_post.side_effect = OSError() assert obj.send(body="test", attach=attach) is False mock_post.side_effect = None mock_post.return_value = response # HTTP error on attachment upload mock_post.reset_mock() bad_response = mock.Mock() bad_response.status_code = requests.codes.internal_server_error bad_response.content = b"" mock_post.return_value = bad_response assert obj.send(body="test", attach=attach) is False mock_post.return_value = response # OSError raised by attachment.open() (before the file handle is used) mock_post.reset_mock() mock_post.side_effect = None with mock.patch( "apprise.attachment.file.AttachFile.open", side_effect=OSError("open failed"), ): assert obj.send(body="test", attach=attach) is False mock_post.side_effect = None mock_post.return_value = response # Invalid/inaccessible attachment mock_post.reset_mock() invalid_path = os.path.join(TEST_VAR_DIR, "/invalid/path/to/file.jpg") bad_attach = AppriseAttachment(invalid_path) assert ( bool( obj.notify( body="test", notify_type=NotifyType.INFO, attach=bad_attach, ) ) is False ) # No POST should have been made assert mock_post.call_count == 0 @mock.patch("requests.post") def test_plugin_webex_teams_apprise_integration(mock_post): """NotifyWebexTeams() Apprise.notify() integration.""" response = mock.Mock() response.status_code = requests.codes.ok response.content = b"" mock_post.return_value = response # Webhook mode via Apprise app = Apprise() assert app.add("wxteams://{}".format(WEBHOOK_TOKEN)) assert bool(app.notify(body="webhook test")) is True mock_post.reset_mock() # Bot mode via Apprise app2 = Apprise() assert app2.add("wxteams://{}/{}".format(BOT_TOKEN, ROOM_ID)) assert bool(app2.notify(body="bot test")) is True @mock.patch("requests.post") def test_plugin_webex_teams_html_to_markdown_format(mock_post): """NotifyWebexTeams(): HTML body is converted to Markdown.""" # Prepare Mock mock_post.return_value = requests.Request() mock_post.return_value.status_code = requests.codes.ok # Use a webhook URL (80-char token, webhook mode) aobj = Apprise() assert aobj.add("wxteams://{}".format("a" * 80)) # Notify with an HTML body; the framework should convert it # to Markdown before dispatching to Webex Teams assert ( bool( aobj.notify( body="hello world", body_format=NotifyFormat.HTML, ) ) is True ) assert mock_post.call_count == 1 # The body must arrive as Markdown (not plain text) in the # "markdown" key, since notify_format is MARKDOWN by default payload = loads(mock_post.call_args_list[0][1]["data"]) assert payload["markdown"] == "**hello** *world*" @mock.patch("apprise.plugins.base.time.sleep") @mock.patch("requests.post") def test_plugin_webex_teams_bot_attach_retry(mock_post, mock_sleep): """A retry re-sends only the attachment post that failed.""" good = mock.Mock() good.status_code = requests.codes.ok good.content = b"" bad = mock.Mock() bad.status_code = requests.codes.internal_server_error bad.content = b"" # Attachment 1 (with the body) posts, attachment 2 fails, then the # retry only needs to post attachment 2 mock_post.side_effect = [good, bad, good] aobj = Apprise() assert aobj.add( f"wxteams://{BOT_TOKEN}/{ROOM_ID}/?mode=bot&retry=2&wait=0" ) attach = AppriseAttachment( [ os.path.join(TEST_VAR_DIR, "apprise-test.gif"), os.path.join(TEST_VAR_DIR, "apprise-test.png"), ] ) assert bool(aobj.notify(body="body", attach=attach)) is True # The body and first file went out once; the second file was retried assert mock_post.call_count == 3 names = [call[1]["files"]["files"][0] for call in mock_post.call_args_list] assert names == [ "apprise-test.gif", "apprise-test.png", "apprise-test.png", ] # Only the first post carried the message body assert "markdown" in mock_post.call_args_list[0][1]["data"] assert "markdown" not in mock_post.call_args_list[2][1]["data"] @mock.patch("apprise.plugins.base.time.sleep") @mock.patch("requests.post") def test_plugin_webex_teams_bot_room_retry(mock_post, mock_sleep): """A retry only re-posts to the room that failed.""" good = mock.Mock() good.status_code = requests.codes.ok good.content = b"" bad = mock.Mock() bad.status_code = requests.codes.internal_server_error bad.content = b"" # The first room accepts; the second fails once and then accepts mock_post.side_effect = [good, bad, good] aobj = Apprise() assert aobj.add( f"wxteams://{BOT_TOKEN}/{ROOM_ID}/{ROOM_ID2}/?retry=2&wait=0" ) assert bool(aobj.notify(body="body")) is True rooms = [ loads(call[1]["data"])["roomId"] for call in mock_post.call_args_list ] # The first room was notified once; the second one was retried first, second = aobj[0].targets assert rooms == [first, second, second] caronc-apprise-dfec414/tests/test_plugin_wechat.py000066400000000000000000000727611526720371000225400ustar00rootroot00000000000000# # BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions # are met: # # 1. Redistributions of source code must retain the above copyright # notice, this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in # the documentation and/or other materials provided with the # distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS # FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE # COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, # INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, # BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER # CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN # ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Disable logging for a cleaner testing output from json import dumps import logging from unittest import mock from helpers import AppriseURLTester import pytest import requests from apprise import Apprise from apprise.common import NotifyFormat from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.wechat import ( WECHAT_ERROR_CODES, WECHAT_TOKEN_ERROR_CODES, NotifyWeChat, ) logging.disable(logging.CRITICAL) # Fixed test credentials CORPID = "wwcorpid1234567890" CORPSECRET = "abcSecret9" AGENTID = "1000002" # A successful response serves double-duty: the token GET needs # access_token and expires_in; the message POST needs errcode == 0. GOOD_RESPONSE = dumps( { "errcode": 0, "errmsg": "ok", "access_token": "TOKEN12345678", "expires_in": 7200, } ) # pprint(CORPSECRET, privacy=True) -> first + "..." + last char # "abcSecret9" -> "a...9" PRIVACY_SECRET = "a...9" # Our Testing URLs apprise_url_tests = ( # ---------------------------------------------------------------- # Invalid / missing credential cases # ---------------------------------------------------------------- ( "wechat://", { # No credentials at all "instance": AppriseImproperlyConfigured, }, ), ( # Missing corpsecret and agentid "wechat://{}".format(CORPID), { "instance": AppriseImproperlyConfigured, }, ), ( # Missing agentid (non-numeric host provided as port only) "wechat://{}:{}@".format(CORPID, CORPSECRET), { "instance": AppriseImproperlyConfigured, }, ), ( # Non-numeric agentid "wechat://{}:{}@notanumber".format(CORPID, CORPSECRET), { "instance": AppriseImproperlyConfigured, }, ), # ---------------------------------------------------------------- # No targets -- plugin loads but send() returns False early # ---------------------------------------------------------------- ( "wechat://{}:{}@{}".format(CORPID, CORPSECRET, AGENTID), { "instance": NotifyWeChat, "notify_response": False, "privacy_url": "wechat://{}:{}@{}/".format( CORPID, PRIVACY_SECRET, AGENTID ), }, ), # ---------------------------------------------------------------- # @all broadcast -- sends to entire organisation # ---------------------------------------------------------------- ( "wechat://{}:{}@{}/@all".format(CORPID, CORPSECRET, AGENTID), { "instance": NotifyWeChat, "requests_response_text": GOOD_RESPONSE, "privacy_url": "wechat://{}:{}@{}/@all/".format( CORPID, PRIVACY_SECRET, AGENTID ), }, ), # ---------------------------------------------------------------- # Single user target (bare form -- no @ prefix) # ---------------------------------------------------------------- ( "wechat://{}:{}@{}/johndoe".format(CORPID, CORPSECRET, AGENTID), { "instance": NotifyWeChat, "requests_response_text": GOOD_RESPONSE, }, ), # ---------------------------------------------------------------- # Single user target (@ prefixed form) # ---------------------------------------------------------------- ( "wechat://{}:{}@{}/@johndoe".format(CORPID, CORPSECRET, AGENTID), { "instance": NotifyWeChat, "requests_response_text": GOOD_RESPONSE, }, ), # ---------------------------------------------------------------- # Multiple user targets # ---------------------------------------------------------------- ( "wechat://{}:{}@{}/user1/user2/user3".format( CORPID, CORPSECRET, AGENTID ), { "instance": NotifyWeChat, "requests_response_text": GOOD_RESPONSE, }, ), # ---------------------------------------------------------------- # Department target (%23 decodes to # prefix) # ---------------------------------------------------------------- ( "wechat://{}:{}@{}/%23100".format(CORPID, CORPSECRET, AGENTID), { "instance": NotifyWeChat, "requests_response_text": GOOD_RESPONSE, }, ), # ---------------------------------------------------------------- # Tag target (+ prefix) # ---------------------------------------------------------------- ( "wechat://{}:{}@{}/+7".format(CORPID, CORPSECRET, AGENTID), { "instance": NotifyWeChat, "requests_response_text": GOOD_RESPONSE, }, ), # ---------------------------------------------------------------- # Mixed recipients (user + department + tag) # ---------------------------------------------------------------- ( "wechat://{}:{}@{}/john/%23200/+3".format(CORPID, CORPSECRET, AGENTID), { "instance": NotifyWeChat, "requests_response_text": GOOD_RESPONSE, }, ), # ---------------------------------------------------------------- # Targets supplied via ?to= query parameter # ---------------------------------------------------------------- ( "wechat://{}:{}@{}?to=@all".format(CORPID, CORPSECRET, AGENTID), { "instance": NotifyWeChat, "requests_response_text": GOOD_RESPONSE, }, ), # ---------------------------------------------------------------- # Markdown format # ---------------------------------------------------------------- ( "wechat://{}:{}@{}/@all?format=markdown".format( CORPID, CORPSECRET, AGENTID ), { "instance": NotifyWeChat, "requests_response_text": GOOD_RESPONSE, }, ), # ---------------------------------------------------------------- # HTTP error responses -- token GET fails -> overall send fails # ---------------------------------------------------------------- ( "wechat://{}:{}@{}/@all".format(CORPID, CORPSECRET, AGENTID), { "instance": NotifyWeChat, "response": False, "requests_response_code": requests.codes.internal_server_error, }, ), ( "wechat://{}:{}@{}/@all".format(CORPID, CORPSECRET, AGENTID), { "instance": NotifyWeChat, "response": False, "requests_response_code": 999, }, ), # ---------------------------------------------------------------- # Network exception on all requests # ---------------------------------------------------------------- ( "wechat://{}:{}@{}/@all".format(CORPID, CORPSECRET, AGENTID), { "instance": NotifyWeChat, "test_requests_exceptions": True, }, ), ) def test_plugin_wechat_urls(): """Run the standard Apprise URL tester for all wechat:// entries.""" AppriseURLTester(tests=apprise_url_tests).run_all() def test_plugin_wechat_init(): """Verify __init__ validation for required fields.""" # Valid construction obj = NotifyWeChat(corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID) assert isinstance(obj, NotifyWeChat) # corpid is required with ( mock.patch("apprise.plugins.wechat.validate_regex", return_value=None), mock.patch.object(NotifyWeChat, "logger"), pytest.raises(AppriseImproperlyConfigured), ): NotifyWeChat(corpid="", corpsecret=CORPSECRET, agentid=AGENTID) # corpsecret is required with pytest.raises(AppriseImproperlyConfigured): NotifyWeChat(corpid=CORPID, corpsecret="", agentid=AGENTID) # agentid must be numeric with pytest.raises(AppriseImproperlyConfigured): NotifyWeChat(corpid=CORPID, corpsecret=CORPSECRET, agentid="notnum") # agentid=None must be rejected with pytest.raises(AppriseImproperlyConfigured): NotifyWeChat(corpid=CORPID, corpsecret=CORPSECRET, agentid=None) # Invalid targets are silently dropped; valid ones are kept obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["validuser", "!!invalid!!", "#42", "+7"], ) assert "validuser" in obj.users assert "42" in obj.departments assert "7" in obj.tag_ids assert "!!invalid!!" in obj.invalid_targets # The @ prefix on user IDs is optional on input; it is stripped # by the regex before storing so the API payload stays prefix-free. # The bare keyword "all" is normalised to "@all" (WeCom API form). obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@johndoe", "@all", "all"], ) assert "johndoe" in obj.users # Both "@all" and bare "all" must normalise to "@all" assert obj.users.count("@all") == 2 def test_plugin_wechat_url_round_trip(): """Verify that url() and parse_url() form a lossless round-trip.""" obj1 = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["alice", "#10", "+2", "@all"], ) url = obj1.url() result = NotifyWeChat.parse_url(url) assert result is not None obj2 = NotifyWeChat(**result) # Connection identity must be preserved assert obj1.url_identifier == obj2.url_identifier # Target counts must match assert len(obj1) == len(obj2) def test_plugin_wechat_url(): """Verify url() output for various target combinations.""" # No targets obj = NotifyWeChat(corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID) url = obj.url() assert CORPID in url assert CORPSECRET in url assert AGENTID in url # Privacy URL masks the corpsecret privacy = obj.url(privacy=True) assert CORPSECRET not in privacy assert PRIVACY_SECRET in privacy assert CORPID in privacy # Department gets encoded as %23 obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["#5"], ) assert "%235" in obj.url() # Tag gets + prefix obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["+3"], ) assert "+3" in obj.url() # @all is kept as-is obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert "@all" in obj.url() # Regular user IDs are always emitted with @ prefix in the URL obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["alice"], ) assert "@alice" in obj.url() # Invalid targets survive the round-trip obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["!!bad!!"], ) assert obj.invalid_targets # url() must include the invalid target so it round-trips assert obj.url() != "" def test_plugin_wechat_url_identifier(): """url_identifier must differ when credentials differ.""" obj1 = NotifyWeChat(corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID) obj2 = NotifyWeChat( corpid="other_corp", corpsecret=CORPSECRET, agentid=AGENTID ) obj3 = NotifyWeChat( corpid=CORPID, corpsecret="other_secret", agentid=AGENTID ) obj4 = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid="9999999" ) assert obj1.url_identifier != obj2.url_identifier assert obj1.url_identifier != obj3.url_identifier assert obj1.url_identifier != obj4.url_identifier @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_send_ok(mock_post, mock_get): """Successful end-to-end send: token GET + message POST both succeed.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r # Token GET -> success + message POST -> success mock_get.return_value = _mk_resp( { "errcode": 0, "errmsg": "ok", "access_token": "MYTOKEN", "expires_in": 7200, } ) mock_post.return_value = _mk_resp({"errcode": 0, "errmsg": "ok"}) obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is True assert mock_get.call_count == 1 assert mock_post.call_count == 1 @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_send_cached_token(mock_post, mock_get): """Second send reuses the cached token without a new GET request.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r mock_get.return_value = _mk_resp( { "errcode": 0, "errmsg": "ok", "access_token": "CACHED_TOKEN", "expires_in": 7200, } ) mock_post.return_value = _mk_resp({"errcode": 0, "errmsg": "ok"}) obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) # First send fetches the token assert obj.send(body="First") is True assert mock_get.call_count == 1 # Second send reuses the cached token assert obj.send(body="Second") is True assert mock_get.call_count == 1 # still 1 -- no second GET @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_send_all_targets(mock_post, mock_get): """A single send delivers to users, departments, and tags in one POST.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r mock_get.return_value = _mk_resp( { "errcode": 0, "errmsg": "ok", "access_token": "TOKEN", "expires_in": 7200, } ) mock_post.return_value = _mk_resp({"errcode": 0, "errmsg": "ok"}) obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["alice", "bob", "#10", "#20", "+3", "+5"], ) assert obj.send(body="Hello") is True assert mock_post.call_count == 1 # Verify payload recipients import json call_kwargs = mock_post.call_args payload = json.loads(call_kwargs[1]["data"]) assert set(payload["touser"].split("|")) == {"alice", "bob"} assert set(payload["toparty"].split("|")) == {"10", "20"} assert set(payload["totag"].split("|")) == {"3", "5"} @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_send_markdown(mock_post, mock_get): """Markdown format produces msgtype=markdown in the payload.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r mock_get.return_value = _mk_resp( { "errcode": 0, "errmsg": "ok", "access_token": "TOKEN", "expires_in": 7200, } ) mock_post.return_value = _mk_resp({"errcode": 0, "errmsg": "ok"}) obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], format=NotifyFormat.MARKDOWN, ) assert obj.send(body="# Hello") is True import json payload = json.loads(mock_post.call_args[1]["data"]) assert payload["msgtype"] == "markdown" assert "markdown" in payload @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_send_no_targets(mock_post, mock_get): """send() returns False immediately when no valid targets are present.""" obj = NotifyWeChat(corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID) # No targets -> early return False, no network calls assert obj.send(body="Hello") is False assert mock_get.call_count == 0 assert mock_post.call_count == 0 @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_token_fetch_http_error(mock_post, mock_get): """Token GET returning HTTP 500 causes send() to fail.""" r = mock.Mock() r.status_code = requests.codes.internal_server_error r.content = b"" mock_get.return_value = r obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is False assert mock_get.call_count == 1 assert mock_post.call_count == 0 @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_token_fetch_api_error(mock_post, mock_get): """Token GET returning errcode != 0 causes send() to fail.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r # errcode 40001 -- invalid credential mock_get.return_value = _mk_resp( {"errcode": 40001, "errmsg": "invalid credential"} ) obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is False assert mock_post.call_count == 0 @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_token_fetch_no_token_field(mock_post, mock_get): """Token GET returning errcode 0 but no access_token causes failure.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r # errcode 0 but access_token is absent mock_get.return_value = _mk_resp({"errcode": 0, "errmsg": "ok"}) obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is False @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_token_fetch_bad_json(mock_post, mock_get): """Token GET returning unparsable JSON is handled gracefully.""" r = mock.Mock() r.status_code = requests.codes.ok r.content = b"{bad json" mock_get.return_value = r obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is False @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_token_fetch_request_exception(mock_post, mock_get): """RequestException during token GET causes send() to fail.""" mock_get.side_effect = requests.RequestException("connection error") obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is False @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_send_http_error(mock_post, mock_get): """Message POST returning HTTP 500 causes send() to fail.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r mock_get.return_value = _mk_resp( { "errcode": 0, "errmsg": "ok", "access_token": "TOKEN", "expires_in": 7200, } ) mock_post.return_value = _mk_resp( {}, code=requests.codes.internal_server_error ) mock_post.return_value.content = b"" obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is False @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_send_api_error(mock_post, mock_get): """Message POST returning errcode != 0 causes send() to fail.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r mock_get.return_value = _mk_resp( { "errcode": 0, "errmsg": "ok", "access_token": "TOKEN", "expires_in": 7200, } ) # 81013 -- all recipients invalid mock_post.return_value = _mk_resp( {"errcode": 81013, "errmsg": "All recipients invalid"} ) obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is False @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_send_token_expiry_evicts_cache(mock_post, mock_get): """A token-expired errcode from the POST evicts the cached token.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r mock_get.return_value = _mk_resp( { "errcode": 0, "errmsg": "ok", "access_token": "TOKEN", "expires_in": 7200, } ) # POST returns 42001 -- token expired mock_post.return_value = _mk_resp( {"errcode": 42001, "errmsg": "access_token expired"} ) obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is False # Verify the store no longer holds the token assert obj.store.get("access_token") is None @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_send_token_expiry_all_codes(mock_post, mock_get): """All WECHAT_TOKEN_ERROR_CODES cause the cached token to be evicted.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r for errcode in WECHAT_TOKEN_ERROR_CODES: mock_get.reset_mock() mock_post.reset_mock() mock_get.return_value = _mk_resp( { "errcode": 0, "errmsg": "ok", "access_token": "TOKEN", "expires_in": 7200, } ) mock_post.return_value = _mk_resp( {"errcode": errcode, "errmsg": "token error"} ) obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is False assert obj.store.get("access_token") is None @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_send_bad_json(mock_post, mock_get): """Message POST returning unparsable JSON is handled gracefully.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r mock_get.return_value = _mk_resp( { "errcode": 0, "errmsg": "ok", "access_token": "TOKEN", "expires_in": 7200, } ) # POST returns unparsable body post_r = mock.Mock() post_r.status_code = requests.codes.ok post_r.content = b"{bad json" mock_post.return_value = post_r obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) # Bad JSON -> content = {} -> errcode = -1 -> failure assert obj.send(body="Hello") is False @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_send_request_exception(mock_post, mock_get): """RequestException during message POST causes send() to fail.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r mock_get.return_value = _mk_resp( { "errcode": 0, "errmsg": "ok", "access_token": "TOKEN", "expires_in": 7200, } ) mock_post.side_effect = requests.RequestException("network error") obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is False def test_plugin_wechat_parse_url(): """Verify parse_url() handles all supported URL forms.""" # Standard form: corpid:corpsecret@agentid/targets url = "wechat://{}:{}@{}/alice".format(CORPID, CORPSECRET, AGENTID) result = NotifyWeChat.parse_url(url) assert result is not None assert result["corpid"] == CORPID assert result["corpsecret"] == CORPSECRET assert result["agentid"] == AGENTID assert "alice" in result["targets"] # Department target (%23 decodes to #) url = "wechat://{}:{}@{}/%23999".format(CORPID, CORPSECRET, AGENTID) result = NotifyWeChat.parse_url(url) assert "#999" in result["targets"] # Tag target url = "wechat://{}:{}@{}/+42".format(CORPID, CORPSECRET, AGENTID) result = NotifyWeChat.parse_url(url) assert "+42" in result["targets"] # ?to= adds targets url = "wechat://{}:{}@{}?to=@all".format(CORPID, CORPSECRET, AGENTID) result = NotifyWeChat.parse_url(url) assert "@all" in result["targets"] # None and non-string inputs return None assert NotifyWeChat.parse_url(None) is None def test_plugin_wechat_parse_native_url(): """parse_native_url() always returns None -- no native URL form.""" assert ( NotifyWeChat.parse_native_url("https://qyapi.weixin.qq.com/any/url") is None ) def test_plugin_wechat_error_codes(): """Verify the error code constants are populated correctly.""" assert 0 in WECHAT_ERROR_CODES assert 40001 in WECHAT_TOKEN_ERROR_CODES assert 40014 in WECHAT_TOKEN_ERROR_CODES assert 42001 in WECHAT_TOKEN_ERROR_CODES @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_apprise_integration(mock_post, mock_get): """End-to-end Apprise().notify() integration test.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r mock_get.return_value = _mk_resp( { "errcode": 0, "errmsg": "ok", "access_token": "TOKEN", "expires_in": 7200, } ) mock_post.return_value = _mk_resp({"errcode": 0, "errmsg": "ok"}) app = Apprise() url = "wechat://{}:{}@{}/@all".format(CORPID, CORPSECRET, AGENTID) assert app.add(url) is True assert bool(app.notify(title="T", body="B")) is True @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_send_unknown_api_error(mock_post, mock_get): """An unknown errcode falls back to the errmsg field in the response.""" def _mk_resp(data, code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = dumps(data).encode("utf-8") return r mock_get.return_value = _mk_resp( { "errcode": 0, "errmsg": "ok", "access_token": "TOKEN", "expires_in": 7200, } ) # Use an error code not in WECHAT_ERROR_CODES mock_post.return_value = _mk_resp( {"errcode": 99999, "errmsg": "custom error message"} ) obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is False @mock.patch("requests.get") @mock.patch("requests.post") def test_plugin_wechat_token_unknown_api_error(mock_post, mock_get): """Unknown errcode from token GET falls back to errmsg field.""" r = mock.Mock() r.status_code = requests.codes.ok r.content = dumps( {"errcode": 99999, "errmsg": "custom token error"} ).encode("utf-8") mock_get.return_value = r obj = NotifyWeChat( corpid=CORPID, corpsecret=CORPSECRET, agentid=AGENTID, targets=["@all"], ) assert obj.send(body="Hello") is False caronc-apprise-dfec414/tests/test_plugin_wecombot.py000066400000000000000000000067121526720371000230750ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Disable logging for a cleaner testing output import logging from helpers import AppriseURLTester import requests from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.wecombot import NotifyWeComBot logging.disable(logging.CRITICAL) # Our Testing URLs apprise_url_tests = ( ( "wecombot://", { "instance": AppriseImproperlyConfigured, }, ), ( "wecombot://:@/", { "instance": AppriseImproperlyConfigured, }, ), ( "wecombot://botkey", { # Minimum requirements met "instance": NotifyWeComBot, }, ), ( "wecombot://?key=botkey", { # Test ?key= "instance": NotifyWeComBot, }, ), # Support Native URLs ( "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=BOTKEY", { "instance": NotifyWeComBot, }, ), ( "https://qyapi.weixin.qq.com/cgi-bin/webhook/send/?key=BOTKEY&data=123", { # another variation (more parameters don't obstruct our key) "instance": NotifyWeComBot, }, ), ( "wecombot://botkey", { "instance": NotifyWeComBot, # force a failure "response": False, "requests_response_code": requests.codes.internal_server_error, }, ), ( "wecombot://botkey", { "instance": NotifyWeComBot, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( "wecombot://botkey", { "instance": NotifyWeComBot, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), ) def test_plugin_wecombot_urls(): """NotifyWeComBot() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() caronc-apprise-dfec414/tests/test_plugin_whatsapp.py000066400000000000000000000443611526720371000231070ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from json import dumps, loads # Disable logging for a cleaner testing output import logging from unittest import mock from helpers import AppriseURLTester import pytest import requests from apprise import Apprise, NotifyType from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.whatsapp import IS_GROUP_ID, NotifyWhatsApp logging.disable(logging.CRITICAL) # Our Testing URLs apprise_url_tests = ( ( "whatsapp://", { # Not enough details "instance": AppriseImproperlyConfigured, }, ), ( "whatsapp://:@/", { # invalid Access Token "instance": AppriseImproperlyConfigured, }, ), ( "whatsapp://{}@_".format("a" * 32), { # token provided but invalid from "instance": AppriseImproperlyConfigured, }, ), ( "whatsapp://%20:{}@12345/{}".format("e" * 32, "4" * 11), { # Invalid template "instance": AppriseImproperlyConfigured, }, ), ( "whatsapp://{}@{}".format("b" * 32, 10**9), { # token provided and from but no target no "instance": NotifyWhatsApp, # Response will fail due to no targets defined "notify_response": False, }, ), ( "whatsapp://{}:{}@{}/123/{}/abcd/".format( "a" * 32, "b" * 32, "3" * 11, "9" * 15 ), { # valid everything but target numbers "instance": NotifyWhatsApp, # Response will fail due to target not being loaded "notify_response": False, }, ), ( "whatsapp://{}@12345/{}".format("e" * 32, "4" * 11), { # simple message "instance": NotifyWhatsApp, # Our expected url(privacy=True) startswith() response: "privacy_url": "whatsapp://e...e@1...5/%2B44444444444/", }, ), ( "whatsapp://template:{}@12345/{}".format("e" * 32, "4" * 11), { # template "instance": NotifyWhatsApp, # Our expected url(privacy=True) startswith() response: "privacy_url": "whatsapp://template:e...e@1...5/%2B44444444444/", }, ), ( "whatsapp://template:{}@12345/{}?lang=fr_CA".format( "e" * 32, "4" * 11 ), { # template with language over-ride "instance": NotifyWhatsApp, # Our expected url(privacy=True) startswith() response: "privacy_url": "whatsapp://template:e...e@1...5/%2B44444444444/", }, ), ( "whatsapp://{}@12345/{}?template=template&lang=fr_CA".format( "e" * 32, "4" * 11 ), { # template specified as kwarg with language over-ride "instance": NotifyWhatsApp, # Our expected url(privacy=True) startswith() response: "privacy_url": "whatsapp://template:e...e@1...5/%2B44444444444/", }, ), ( "whatsapp://template:{}@12345/{}?lang=1234".format("e" * 32, "4" * 11), { # template with invalid language over-ride "instance": AppriseImproperlyConfigured, }, ), ( "whatsapp://template:{}@12345/{}?:1=test&:body=3&:type=2".format( "e" * 32, "4" * 11 ), { # template with kwarg assignments # {{1}} assigned test # {{2}} assigned Apprise Message type (special keyword) # {{3}} assigned Apprise Message body (special keyword) "instance": NotifyWhatsApp, # Our expected url(privacy=True) startswith() response: "privacy_url": "whatsapp://template:e...e@1...5/%2B44444444444/", }, ), ( "whatsapp://template:{}@12345/{}?:invalid=23".format( "e" * 32, "4" * 11 ), { # template with kwarg assignments # Invalid keyword specified; cna only be a digit OR `body' # or 'type' "instance": AppriseImproperlyConfigured, }, ), ( "whatsapp://template:{}@12345/{}?:body=".format("e" * 32, "4" * 11), { # template with kwarg assignments # No Body Assigment "instance": AppriseImproperlyConfigured, }, ), ( "whatsapp://template:{}@12345/{}?:1=Test&:body=1".format( "e" * 32, "4" * 11 ), { # template with kwarg assignments # Ambiguious assignment {{1}} assigned twice "instance": AppriseImproperlyConfigured, }, ), ( "whatsapp://{}:{}@123456/{}".format("a" * 32, "b" * 32, "4" * 11), { # using short-code (6 characters) "instance": NotifyWhatsApp, }, ), ( "whatsapp://_?token={}&from={}&to={}".format( "d" * 32, "5" * 11, "6" * 11 ), { # use get args to acomplish the same thing "instance": NotifyWhatsApp, }, ), ( "whatsapp://_?token={}&source={}&to={}".format( "d" * 32, "5" * 11, "6" * 11 ), { # use get args to acomplish the same thing (use source instead # of from) "instance": NotifyWhatsApp, }, ), ( "whatsapp://{}@12345/{}".format("e" * 32, "4" * 11), { "instance": NotifyWhatsApp, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( "whatsapp://{}@12345/{}".format("e" * 32, "4" * 11), { "instance": NotifyWhatsApp, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), # Group target tests ( # Group ID via '#' prefix "whatsapp://{}@12345/%23120363043968066561".format("e" * 32), { "instance": NotifyWhatsApp, "privacy_url": "whatsapp://e...e@1...5/%23120363043968066561/", }, ), ( # Mix of phone number and group ID "whatsapp://{}@12345/{}/%23120363043968066561".format( "e" * 32, "4" * 11 ), { "instance": NotifyWhatsApp, }, ), ( # Group target with HTTP 500 "whatsapp://{}@12345/%23120363043968066561".format("e" * 32), { "instance": NotifyWhatsApp, "response": False, "requests_response_code": requests.codes.internal_server_error, }, ), ( # Group target with request exception "whatsapp://{}@12345/%23120363043968066561".format("e" * 32), { "instance": NotifyWhatsApp, "test_requests_exceptions": True, }, ), ) def test_plugin_whatsapp_urls(): """NotifyWhatsApp() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() def test_plugin_whatsapp_url_language(): """NotifyWhatsApp() url() writes the template language as language=.""" obj = Apprise.instantiate( "whatsapp://template:{}@12345/{}?lang=fr_CA".format("e" * 32, "4" * 11) ) assert isinstance(obj, NotifyWhatsApp) # lang= is an alias, so url() writes the value back as language= url = obj.url() assert "language=fr_CA" in url assert "lang=" not in url # Reloading our URL keeps the language obj2 = Apprise.instantiate(url) assert isinstance(obj2, NotifyWhatsApp) assert obj2.language == "fr_CA" assert obj2.url() == url @mock.patch("requests.post") def test_plugin_whatsapp_auth(mock_post): """NotifyWhatsApp() Auth. - account-wide auth token - API key and its own auth token """ response = mock.Mock() response.content = "" response.status_code = requests.codes.ok # Prepare Mock mock_post.return_value = response # Initialize some generic (but valid) tokens token = "{}".format("b" * 32) from_phone_id = "123456787654321" target = "+1 (555) 987-6543" message_contents = "test" # Variation of initialization without API key obj = Apprise.instantiate(f"whatsapp://{token}@{from_phone_id}/{target}") assert isinstance(obj, NotifyWhatsApp) is True assert isinstance(obj.url(), str) is True # Send Notification assert obj.send(body=message_contents) is True # Validate expected call parameters assert mock_post.call_count == 1 first_call = mock_post.call_args_list[0] # URL and message parameters are the same for both calls assert first_call[0][0] == ( "https://graph.facebook.com/" f"{NotifyWhatsApp.fb_graph_version}/{from_phone_id}/messages" ) response = loads(first_call[1]["data"]) assert response["text"]["body"] == message_contents assert response["to"] == "+15559876543" assert response["recipient_type"] == "individual" @mock.patch("requests.post") def test_plugin_whatsapp_edge_cases(mock_post): """NotifyWhatsApp() Edge Cases.""" # Prepare our response response = requests.Request() response.status_code = requests.codes.ok # Prepare Mock mock_post.return_value = response # Initialize some generic (but valid) tokens token = "b" * 32 from_phone_id = "123456787654321" targets = ("+1 (555) 123-3456",) # No token specified with pytest.raises(AppriseImproperlyConfigured): NotifyWhatsApp( token=None, from_phone_id=from_phone_id, targets=targets ) # No from_phone_id specified with pytest.raises(AppriseImproperlyConfigured): NotifyWhatsApp(token=token, from_phone_id=None, targets=targets) # a error response response.status_code = 400 response.content = dumps( { "error": { "code": 21211, "message": ( "The 'To' number +1234567 is not a valid phone number." ), }, } ) mock_post.return_value = response # Initialize our object obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=targets ) # We will fail with the above error code assert bool(obj.notify("title", "body", "info")) is False @mock.patch("requests.post") def test_plugin_whatsapp_template_notify_type_value(mock_post): response = mock.Mock() response.content = "" response.status_code = requests.codes.ok mock_post.return_value = response token = "b" * 32 from_phone_id = "12345" target = "+1 (555) 987-6543" # Map notify_type -> {{2}}, body -> {{3}} obj = Apprise.instantiate( f"whatsapp://template:{token}@{from_phone_id}/{target}?:type=2&:body=3" ) assert isinstance(obj, NotifyWhatsApp) assert ( obj.send(body="test", title="t", notify_type=NotifyType.INFO) is True ) call = mock_post.call_args_list[0] assert "NotifyType." not in call[1]["data"] payload = loads(call[1]["data"]) params = payload["template"]["components"][0]["parameters"] # Ensure values are injected, not literal strings assert params[0]["text"] == NotifyType.INFO.value assert params[1]["text"] == "test" @mock.patch("requests.post") def test_plugin_whatsapp_groups(mock_post): """NotifyWhatsApp() group target support.""" def _mk_resp(code=requests.codes.ok): r = mock.Mock() r.content = "" r.status_code = code return r mock_post.return_value = _mk_resp() token = "e" * 32 from_phone_id = "123456787654321" # A realistic-looking numeric group ID group_id = "120363043968066561" # IS_GROUP_ID only matches the numeric portion (no prefix/suffix) assert IS_GROUP_ID.match(group_id) assert not IS_GROUP_ID.match(f"#{group_id}") assert not IS_GROUP_ID.match(f"{group_id}@g.us") assert not IS_GROUP_ID.match("abc123") # __init__ target classification # '#' prefix → group obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=[f"#{group_id}"], ) assert obj.targets == [f"#{group_id}"] # '@g.us' suffix (native API format) → normalised to '#' prefix obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=[f"{group_id}@g.us"], ) assert obj.targets == [f"#{group_id}"] # '#' prefix + '@g.us' suffix (both present) → normalised obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=[f"#{group_id}@g.us"], ) assert obj.targets == [f"#{group_id}"] # Invalid group ID (non-numeric) is dropped with a warning obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=["#badgroupid", f"#{group_id}"], ) assert obj.targets == [f"#{group_id}"] # Mixed: phone number + group ID obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=["+14155552671", f"#{group_id}"], ) assert len(obj.targets) == 2 assert "+14155552671" in obj.targets assert f"#{group_id}" in obj.targets # send() payload verification mock_post.reset_mock() obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=[f"#{group_id}"], ) assert obj.send(body="hello group") is True assert mock_post.call_count == 1 # Group payload must carry recipient_type='group' and 'to'=id@g.us sent = loads(mock_post.call_args_list[0][1]["data"]) assert sent["recipient_type"] == "group" assert sent["to"] == f"{group_id}@g.us" # send() for individual phone preserves recipient_type='individual' mock_post.reset_mock() obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=["+14155552671"], ) assert obj.send(body="hello individual") is True sent = loads(mock_post.call_args_list[0][1]["data"]) assert sent["recipient_type"] == "individual" assert sent["to"] == "+14155552671" # mixed send: one phone + one group makes two POST calls mock_post.reset_mock() obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=["+14155552671", f"#{group_id}"], ) assert obj.send(body="mixed") is True assert mock_post.call_count == 2 payloads = [loads(c[1]["data"]) for c in mock_post.call_args_list] types = {p["recipient_type"] for p in payloads} assert types == {"individual", "group"} # HTTP error on group target returns False mock_post.return_value = _mk_resp(requests.codes.internal_server_error) obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=[f"#{group_id}"], ) assert obj.send(body="should fail") is False # partial failure: phone succeeds, group errors → overall False mock_post.side_effect = [ _mk_resp(requests.codes.ok), _mk_resp(requests.codes.internal_server_error), ] obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=["+14155552671", f"#{group_id}"], ) assert obj.send(body="partial") is False # URL round-trip: group ID survives url() -> parse_url() mock_post.side_effect = None mock_post.return_value = _mk_resp() obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=[f"#{group_id}"], ) rebuilt = NotifyWhatsApp(**NotifyWhatsApp.parse_url(obj.url())) assert rebuilt.targets == obj.targets assert rebuilt.url_identifier == obj.url_identifier # Round-trip with mixed targets obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=["+14155552671", f"#{group_id}"], ) rebuilt = NotifyWhatsApp(**NotifyWhatsApp.parse_url(obj.url())) assert sorted(rebuilt.targets) == sorted(obj.targets) # targets as a plain string (comma-separated, not a list) obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=f"#{group_id}", ) assert obj.targets == [f"#{group_id}"] # whitespace-only list entry is silently skipped obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=[" ", f"#{group_id}"], ) assert obj.targets == [f"#{group_id}"] # ?to= query parameter accepts group IDs url = f"whatsapp://_?token={token}&from={from_phone_id}&to=%23{group_id}" obj = Apprise.instantiate(url) assert isinstance(obj, NotifyWhatsApp) assert f"#{group_id}" in obj.targets # privacy_url masks group targets correctly obj = NotifyWhatsApp( token=token, from_phone_id=from_phone_id, targets=[f"#{group_id}"], ) priv = obj.url(privacy=True) # The token should be masked; the group ID should still be present assert token not in priv assert group_id in priv caronc-apprise-dfec414/tests/test_plugin_windows.py000066400000000000000000000325301526720371000227450ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from importlib import reload # Disable logging for a cleaner testing output import logging import sys import types from unittest import mock import pytest import apprise logging.disable(logging.CRITICAL) @pytest.fixture def mocked_win32_environment(): """Inject fake win32 modules, reload apprise, and fully restore sys.modules on teardown. Previously the setup lived inside test_plugin_windows_mocked itself, with no cleanup. That permanently abandoned all apprise.* module objects, causing order-dependent failures in every test that runs afterwards and holds a module-level `from apprise.plugins.X import` reference. A fixture with a yield guarantees cleanup even on failure. """ # Build fake win32api win32api = types.ModuleType("win32api") win32api.GetModuleHandle = mock.Mock(name="win32api.GetModuleHandle") win32api.PostQuitMessage = mock.Mock(name="win32api.PostQuitMessage") # Build fake win32con win32con = types.ModuleType("win32con") win32con.CW_USEDEFAULT = mock.Mock(name="win32con.CW_USEDEFAULT") win32con.IDI_APPLICATION = mock.Mock(name="win32con.IDI_APPLICATION") win32con.IMAGE_ICON = mock.Mock(name="win32con.IMAGE_ICON") win32con.LR_DEFAULTSIZE = 1 win32con.LR_LOADFROMFILE = 2 win32con.WM_DESTROY = mock.Mock(name="win32con.WM_DESTROY") win32con.WM_USER = 0 win32con.WS_OVERLAPPED = 1 win32con.WS_SYSMENU = 2 # Build fake win32gui win32gui = types.ModuleType("win32gui") win32gui.CreateWindow = mock.Mock(name="win32gui.CreateWindow") win32gui.DestroyWindow = mock.Mock(name="win32gui.DestroyWindow") win32gui.LoadIcon = mock.Mock(name="win32gui.LoadIcon") win32gui.LoadImage = mock.Mock(name="win32gui.LoadImage") win32gui.NIF_ICON = 1 win32gui.NIF_INFO = mock.Mock(name="win32gui.NIF_INFO") win32gui.NIF_MESSAGE = 2 win32gui.NIF_TIP = 4 win32gui.NIM_ADD = mock.Mock(name="win32gui.NIM_ADD") win32gui.NIM_DELETE = mock.Mock(name="win32gui.NIM_DELETE") win32gui.NIM_MODIFY = mock.Mock(name="win32gui.NIM_MODIFY") win32gui.RegisterClass = mock.Mock(name="win32gui.RegisterClass") win32gui.UnregisterClass = mock.Mock(name="win32gui.UnregisterClass") win32gui.Shell_NotifyIcon = mock.Mock(name="win32gui.Shell_NotifyIcon") win32gui.UpdateWindow = mock.Mock(name="win32gui.UpdateWindow") win32gui.WNDCLASS = mock.Mock(name="win32gui.WNDCLASS") # Save all apprise.* module references before wiping them. # These are the same module objects whose __dict__ entries are # pointed to by module-level imports in other test files; restoring # them keeps those references valid after the test completes. saved_apprise = { k: v for k, v in sys.modules.items() if k.startswith("apprise.") } # Inject win32 stubs so the plugin's top-level import succeeds, # then wipe apprise.* and reload so it picks them up. sys.modules["win32api"] = win32api sys.modules["win32con"] = win32con sys.modules["win32gui"] = win32gui for mod in list(saved_apprise): del sys.modules[mod] reload(apprise) # Yield win32gui -- the test uses it to configure side-effects yield win32gui # --- Teardown --- # Remove all apprise.* entries created during this test for mod in [k for k in sys.modules if k.startswith("apprise.")]: del sys.modules[mod] # Remove the injected win32 stubs for stub in ("win32api", "win32con", "win32gui"): sys.modules.pop(stub, None) # Restore the original apprise.* module objects so that any # module-level `from apprise.plugins.X import NotifyX` in other # test files continues to point at live (non-abandoned) module dicts. sys.modules.update(saved_apprise) # sys.modules.update() above only fixes the dict *keys* -- Python's # import machinery separately sets each submodule as an ATTRIBUTE on # its parent package too (e.g. sys.modules["apprise"].apprise), and # that binding is untouched by the update. Left stale, any later # `import apprise.apprise as x` anywhere else in the test session -- # resolved via getattr(sys.modules["apprise"], "apprise"), not a # sys.modules lookup -- would silently get the module object this # fixture created and already discarded above, rather than the real, # restored one. for name, mod in saved_apprise.items(): parent_name, _, attr = name.rpartition(".") parent = sys.modules.get(parent_name) if parent is not None: setattr(parent, attr, mod) @pytest.mark.skipif( ( "win32api" in sys.modules or "win32con" in sys.modules or "win32gui" in sys.modules ), reason="Requires non-windows platform", ) def test_plugin_windows_mocked(mocked_win32_environment): """NotifyWindows() General Checks (via non-Windows platform)""" # Retrieve the win32gui mock that the fixture set up win32gui = mocked_win32_environment # Create our instance obj = apprise.Apprise.instantiate("windows://", suppress_exceptions=False) obj.duration = 0 # Test URL functionality assert isinstance(obj.url(), str) # Verify that a URL ID can not be generated assert obj.url_id() is None # Check that it found our mocked environments assert obj.enabled is True # _on_destroy check obj._on_destroy(0, "", 0, 0) # test notifications assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is True ) obj = apprise.Apprise.instantiate( "windows://_/?image=True", suppress_exceptions=False ) obj.duration = 0 assert isinstance(obj.url(), str) assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is True ) obj = apprise.Apprise.instantiate( "windows://_/?image=False", suppress_exceptions=False ) obj.duration = 0 assert isinstance(obj.url(), str) assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is True ) obj = apprise.Apprise.instantiate( "windows://_/?duration=1", suppress_exceptions=False ) assert isinstance(obj.url(), str) # loads okay assert obj.duration == 1 assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is True ) obj = apprise.Apprise.instantiate( "windows://_/?duration=invalid", suppress_exceptions=False ) # Falls back to default assert obj.duration == obj.default_popup_duration_sec obj = apprise.Apprise.instantiate( "windows://_/?duration=-1", suppress_exceptions=False ) # Falls back to default assert obj.duration == obj.default_popup_duration_sec obj = apprise.Apprise.instantiate( "windows://_/?duration=0", suppress_exceptions=False ) # Falls back to default assert obj.duration == obj.default_popup_duration_sec # To avoid slowdowns (for testing), turn it to zero for now obj.duration = 0 # Test our loading of our icon exception; it will still allow the # notification to be sent win32gui.LoadImage.side_effect = AttributeError assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is True ) # Undo our change win32gui.LoadImage.side_effect = None # Test our global exception handling win32gui.UpdateWindow.side_effect = AttributeError assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is False ) # Undo our change win32gui.UpdateWindow.side_effect = None # Toggle our testing for when we can't send notifications because the # package has been made unavailable to us obj.enabled = False assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is False ) @pytest.mark.skipif( "win32api" not in sys.modules and "win32con" not in sys.modules and "win32gui" not in sys.modules, reason="Requires win32api, win32con, and win32gui", ) @mock.patch("win32gui.UpdateWindow") @mock.patch("win32gui.Shell_NotifyIcon") @mock.patch("win32gui.LoadImage") def test_plugin_windows_native( mock_loadimage, mock_notify, mock_update_window ): """NotifyWindows() General Checks (via Windows platform)""" # Create our instance obj = apprise.Apprise.instantiate("windows://", suppress_exceptions=False) obj.duration = 0 # Test URL functionality assert isinstance(obj.url(), str) # Check that it found our mocked environments assert obj.enabled is True # _on_destroy check obj._on_destroy(0, "", 0, 0) # test notifications assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is True ) obj = apprise.Apprise.instantiate( "windows://_/?image=True", suppress_exceptions=False ) obj.duration = 0 assert isinstance(obj.url(), str) assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is True ) obj = apprise.Apprise.instantiate( "windows://_/?image=False", suppress_exceptions=False ) obj.duration = 0 assert isinstance(obj.url(), str) assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is True ) obj = apprise.Apprise.instantiate( "windows://_/?duration=1", suppress_exceptions=False ) assert isinstance(obj.url(), str) assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is True ) # loads okay assert obj.duration == 1 obj = apprise.Apprise.instantiate( "windows://_/?duration=invalid", suppress_exceptions=False ) # Falls back to default assert obj.duration == obj.default_popup_duration_sec obj = apprise.Apprise.instantiate( "windows://_/?duration=-1", suppress_exceptions=False ) # Falls back to default assert obj.duration == obj.default_popup_duration_sec obj = apprise.Apprise.instantiate( "windows://_/?duration=0", suppress_exceptions=False ) # Falls back to default assert obj.duration == obj.default_popup_duration_sec # To avoid slowdowns (for testing), turn it to zero for now obj = apprise.Apprise.instantiate("windows://", suppress_exceptions=False) obj.duration = 0 # Test our loading of our icon exception; it will still allow the # notification to be sent mock_loadimage.side_effect = AttributeError assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is True ) # Undo our change mock_loadimage.side_effect = None # Test our global exception handling mock_update_window.side_effect = AttributeError assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is False ) # Undo our change mock_update_window.side_effect = None # Toggle our testing for when we can't send notifications because the # package has been made unavailable to us obj.enabled = False assert ( bool( obj.notify( title="title", body="body", notify_type=apprise.NotifyType.INFO ) ) is False ) caronc-apprise-dfec414/tests/test_plugin_workflows.py000066400000000000000000001144311526720371000233110ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from inspect import cleandoc import json # Disable logging for a cleaner testing output import logging import sys from unittest import mock from helpers import AppriseURLTester import pytest import requests from apprise import Apprise, AppriseConfig, NotifyFormat, NotifyType from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.workflows import NotifyWorkflows logging.disable(logging.CRITICAL) # Our Testing URLs apprise_url_tests = ( ################################## # NotifyWorkflows ################################## ( "workflow://", { # invalid host details (parsing fails very early) "instance": None, }, ), ( "workflow://:@/", { # invalid host details (parsing fails very early) "instance": None, }, ), ( "workflow://host/workflow", { # workflow provided only, no signature "instance": AppriseImproperlyConfigured, }, ), ( "workflow://host:443/^(/signature", { # invalid workflow provided "instance": AppriseImproperlyConfigured, }, ), ( "workflow://host:443/workflow1a/signature/?image=no", { # All tokens provided - we're good # Tests case without image defined "instance": NotifyWorkflows, }, ), ( "workflows://host:443/workflow1b/signature/", { # support workflows (s added to end) "instance": NotifyWorkflows, }, ), ( "workflows://host:443/signature/?id=workflow1c", { # id= to store workflow id "instance": NotifyWorkflows, }, ), ( "workflows://host:443/signature/?workflow=workflow1d&wrap=yes", { # workflow= to store workflow id "instance": NotifyWorkflows, }, ), ( "workflows://host:443/signature/?workflow=workflow1d&wrap=no", { # workflow= to store workflow id "instance": NotifyWorkflows, }, ), ( "workflows://host:443/workflow1e/signature/?api-version=2024-01-01", { # support api-version which is extracted from webhook "instance": NotifyWorkflows, # Our expected url(privacy=True) startswith() response "privacy_url": "workflow://host:443/w...e/s...e/", }, ), ( "workflows://host:443/workflow1b/signature/?ver=2016-06-01", { # Support ver= (api-version alias) "instance": NotifyWorkflows, }, ), ( "workflows://host:443/?id=workflow1b&signature=signature", { # Support signature= (sig= alias) "instance": NotifyWorkflows, # Our expected url(privacy=True) startswith() response "privacy_url": "workflow://host:443/w...b/s...e/", }, ), ( "workflows://host:443/workflow1e/signature/?powerautomate=yes", { # support power_automate flag "instance": NotifyWorkflows, }, ), ( "workflows://host:443/workflow1e/signature/?pa=yes&ver=1995-01-01", { # support power_automate flag with ver flag "instance": NotifyWorkflows, }, ), ( "workflows://host:443/workflow1e/signature/?pa=yes", { # support power_automate flag "instance": NotifyWorkflows, }, ), # Support native URLs ( ( "https://server.azure.com:443/workflows/643e69f83c8944/" "triggers/manual/paths/invoke?" "api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&" "sv=1.0&sig=KODuebWbDGYFr0z0eu" ), { # All tokens provided - we're good "instance": NotifyWorkflows, # Our expected url(privacy=True) startswith() response "privacy_url": "workflow://server.azure.com:443/6...4/K...u/", }, ), ( ( "https://server.azure.com:443/" "powerautomate/automations/direct/" "workflows/643e69f83c8944/" "triggers/manual/paths/invoke?" "api-version=2022-03-01-preview&sp=%2Ftriggers%2Fmanual%2Frun&" "sv=1.0&sig=KODuebWbDGYFr0z0eu" ), { # Power-Automate alternative URL - All tokens provided - we're good "instance": NotifyWorkflows, }, ), ( "workflow://host:443/workflow2/signature/", { "instance": NotifyWorkflows, # force a failure "response": False, "requests_response_code": requests.codes.internal_server_error, }, ), ( "workflow://host:443/workflow3/signature/", { "instance": NotifyWorkflows, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( "workflow://host:443/workflow4/signature/", { "instance": NotifyWorkflows, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), ) def test_plugin_workflows_urls(): """NotifyWorkflows() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() @pytest.fixture def workflows_url(): return "workflow://host:443/workflow/signature" @pytest.fixture def request_mock(mocker): """Prepare requests mock.""" mock_post = mocker.patch("requests.post") mock_post.return_value = requests.Request() mock_post.return_value.status_code = requests.codes.ok return mock_post @pytest.fixture def simple_template(tmpdir): template = tmpdir.join("simple.json") template.write( cleandoc(""" { "type": "message", "attachments": [{ "contentType": "application/vnd.microsoft.card.adaptive", "contentUrl": null, "content": { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.4", "msteams": { "width": "full" }, "body": [ { "type": "TextBlock", "text": "**Test**", "style": "heading" } ] } }] } """) ) return template def test_plugin_workflows_simple_test( request_mock, workflows_url, ): """ NotifyWorkflows() simple testing """ # Instantiate our URL obj = Apprise.instantiate(workflows_url) assert isinstance(obj, NotifyWorkflows) assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is True ) assert request_mock.called is True assert request_mock.call_args_list[0][0][0].startswith( "https://host:443/workflows/workflow/triggers/manual/paths/invoke" ) payload = json.loads(request_mock.call_args_list[0][1]["data"]) assert "NotifyType." not in request_mock.call_args_list[0][1]["data"] assert payload == { "type": "message", "attachments": [ { "contentType": "application/vnd.microsoft.card.adaptive", "contentUrl": None, "content": { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.4", "body": [ { "type": "Image", "url": "https://github.com/caronc/apprise/raw/" "master/apprise/assets/themes/default/" "apprise-info-32x32.png", "height": "32px", "altText": NotifyType.INFO.value, }, { "type": "TextBlock", # Verify our Title is set "text": "title", "style": "heading", "weight": "Bolder", "size": "Large", "id": "title", }, { "type": "TextBlock", # Verify our Body is set "text": "body", "style": "default", "wrap": True, "id": "body", }, ], "msteams": {"width": "full"}, }, }, ], } request_mock.reset_mock() # Instantiate our URL obj = Apprise.instantiate(f"{workflows_url}?pa=yes") assert isinstance(obj, NotifyWorkflows) assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is True ) assert request_mock.called is True assert request_mock.call_args_list[0][0][0].startswith( "https://host:443/powerautomate/automations/direct/" "workflows/workflow/triggers/manual/paths/invoke" ) payload = json.loads(request_mock.call_args_list[0][1]["data"]) assert "NotifyType." not in request_mock.call_args_list[0][1]["data"] assert payload == { "type": "message", "attachments": [ { "contentType": "application/vnd.microsoft.card.adaptive", "contentUrl": None, "content": { "$schema": "http://adaptivecards.io/schemas/" "adaptive-card.json", "type": "AdaptiveCard", "version": "1.4", "body": [ { "type": "Image", "url": "https://github.com/caronc/apprise/raw/" "master/apprise/assets/themes/default/" "apprise-info-32x32.png", "height": "32px", "altText": "info", }, { "type": "TextBlock", # Verify our Title is set "text": "title", "style": "heading", "weight": "Bolder", "size": "Large", "id": "title", }, { "type": "TextBlock", # Verify our Body is set "text": "body", "style": "default", "wrap": True, "id": "body", }, ], "msteams": { "width": "full", }, }, }, ], } def test_plugin_workflows_templating_basic_success( request_mock, workflows_url, tmpdir ): """ NotifyWorkflows() Templating - success. Test cases where URL and JSON is valid. """ template = tmpdir.join("simple.json") template.write( cleandoc(""" { "type": "message", "attachments": [{ "contentType": "application/vnd.microsoft.card.adaptive", "contentUrl": null, "content": { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.4", "body": [ {"type": "TextBlock", "id": "app_id", "text": "{{app_id}}"}, {"type": "TextBlock", "id": "color", "text": "{{app_color}}"}, {"type": "TextBlock", "id": "title", "text": "{{app_title}}"}, {"type": "TextBlock", "id": "body", "text": "{{app_body}}"} ] } }] } """) ) # Instantiate our URL obj = Apprise.instantiate( "{url}/?template={template}&{kwargs}".format( url=workflows_url, template=str(template), kwargs=":key1=token&:key2=token", ) ) assert isinstance(obj, NotifyWorkflows) assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is True ) assert request_mock.called is True assert request_mock.call_args_list[0][0][0].startswith( "https://host:443/workflows/workflow/triggers/manual/paths/invoke" ) # Our Posted JSON Object posted_json = json.loads(request_mock.call_args_list[0][1]["data"]) assert "NotifyType." not in request_mock.call_args_list[0][1]["data"] # Verify the Adaptive Card envelope assert posted_json["type"] == "message" content = posted_json["attachments"][0]["content"] # Index body blocks by their id for easy lookup blocks = {b["id"]: b["text"] for b in content["body"] if "id" in b} assert blocks["app_id"] == "Apprise" assert blocks["color"] == "#3AA3E3" assert blocks["title"] == "title" assert blocks["body"] == "body" def test_plugin_workflows_templating_invalid_json( request_mock, workflows_url, tmpdir ): """ NotifyWorkflows() Templating - invalid JSON. """ template = tmpdir.join("invalid.json") template.write("}") # Instantiate our URL obj = Apprise.instantiate( "{url}/?template={template}&{kwargs}".format( url=workflows_url, template=str(template), kwargs=":key1=token&:key2=token", ) ) assert isinstance(obj, NotifyWorkflows) # We will fail to preform our notifcation because the JSON is bad assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is False ) def test_plugin_workflows_templating_load_json_failure( request_mock, workflows_url, tmpdir ): """ NotifyWorkflows() Templating - template loading failure. Test a case where we can not access the file. """ template = tmpdir.join("empty.json") template.write("") obj = Apprise.instantiate(f"{workflows_url}/?template={template!s}") with mock.patch("json.loads", side_effect=OSError): # we fail, but this time it's because we couldn't # access the cached file contents for reading assert ( bool( obj.notify( body="body", title="title", notify_type=NotifyType.INFO ) ) is False ) def test_plugin_workflows_templating_target_success( request_mock, workflows_url, tmpdir ): """ NotifyWorkflows() Templating - success with target. A more complicated example; uses a custom token. """ template = tmpdir.join("more_complicated_example.json") template.write( cleandoc(""" { "type": "message", "attachments": [{ "contentType": "application/vnd.microsoft.card.adaptive", "contentUrl": null, "content": { "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", "type": "AdaptiveCard", "version": "1.4", "body": [ {"type": "TextBlock", "id": "desc", "text": "{{app_desc}}"}, {"type": "TextBlock", "id": "color", "text": "{{app_color}}"}, {"type": "TextBlock", "id": "title", "text": "{{app_title}}"}, {"type": "TextBlock", "id": "body", "text": "{{app_body}}"} ], "actions": [ { "type": "Action.OpenUrl", "title": "Open", "url": "{{ target }}" } ] } }] } """) ) # Instantiate our URL obj = Apprise.instantiate( "{url}/?template={template}&{kwargs}".format( url=workflows_url, template=str(template), kwargs=":key1=token&:key2=token&:target=http://localhost", ) ) assert isinstance(obj, NotifyWorkflows) assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is True ) assert request_mock.called is True assert request_mock.call_args_list[0][0][0].startswith( "https://host:443/workflows/workflow/triggers/manual/paths/invoke" ) # Our Posted JSON Object posted_json = json.loads(request_mock.call_args_list[0][1]["data"]) assert "NotifyType." not in request_mock.call_args_list[0][1]["data"] # Verify the Adaptive Card envelope assert posted_json["type"] == "message" content = posted_json["attachments"][0]["content"] # Index body blocks by their id for easy lookup blocks = {b["id"]: b["text"] for b in content["body"] if "id" in b} assert blocks["desc"] == "Apprise Notifications" assert blocks["color"] == "#3AA3E3" assert blocks["title"] == "title" assert blocks["body"] == "body" # The custom :target token must be substituted into the action URL assert content["actions"][0]["url"] == "http://localhost" def test_plugin_workflows_templating_invalid_type( request_mock, workflows_url, tmpdir ): """NotifyWorkflows() Templating - root 'type' != 'message' is rejected.""" template = tmpdir.join("bad_type.json") template.write( cleandoc(""" { "type": "wrongtype", "attachments": [{ "contentType": "application/vnd.microsoft.card.adaptive", "contentUrl": null, "content": {} }] } """) ) obj = Apprise.instantiate(f"{workflows_url}/?template={template!s}") assert isinstance(obj, NotifyWorkflows) # Validation rejects incorrect 'type' value assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is False ) assert request_mock.called is False def test_plugin_workflows_templating_missing_attachments( request_mock, workflows_url, tmpdir ): """NotifyWorkflows() Templating - absent or empty attachments fails.""" template = tmpdir.join("no_attachments.json") # Missing 'attachments' key entirely template.write('{"type": "message"}') obj = Apprise.instantiate(f"{workflows_url}/?template={template!s}") assert isinstance(obj, NotifyWorkflows) assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is False ) assert request_mock.called is False # Empty list is also rejected template.write('{"type": "message", "attachments": []}') obj2 = Apprise.instantiate(f"{workflows_url}/?template={template!s}") assert isinstance(obj2, NotifyWorkflows) assert ( bool( obj2.notify( body="body", title="title", notify_type=NotifyType.INFO ) ) is False ) assert request_mock.called is False def test_plugin_workflows_templating_invalid_contenttype( request_mock, workflows_url, tmpdir ): """NotifyWorkflows() Templating - attachment missing contentType fails.""" template = tmpdir.join("no_contenttype.json") template.write('{"type": "message", "attachments": [{"content": {}}]}') obj = Apprise.instantiate(f"{workflows_url}/?template={template!s}") assert isinstance(obj, NotifyWorkflows) # An attachment without a 'contentType' string is rejected assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is False ) assert request_mock.called is False @pytest.mark.skipif( sys.version_info < (3, 10), reason="Python <3.10: see test_plugin_workflows_template_add_failure_py39", ) def test_plugin_workflows_template_add_failure(): """NotifyWorkflows() rejects an attachment it cannot add.""" # Simulate add() silently failing (len stays 0); no HTTP call needed with mock.patch("apprise.plugins.workflows.AppriseAttachment") as mock_cls: inst = mock.MagicMock() inst.__len__ = mock.Mock(return_value=0) mock_cls.return_value = inst with pytest.raises(AppriseImproperlyConfigured): NotifyWorkflows( workflow="T00000000001", signature="AbCdEfGhIjKlMnOpQrStUvWx", template="file:///some/template.json", ) # --- Python v3.9 Support --- # On Python 3.9, mock.patch() resolves a dotted target ("a.b.c.Name") by # walking getattr(pkg, "sub") chains rather than going straight to # sys.modules (that was fixed in Python 3.10+). # Delete this test once Python 3.9 reaches end-of-life. @pytest.mark.skipif( sys.version_info >= (3, 10), reason="Python 3.10+ mock.patch resolves via sys.modules directly", ) def test_plugin_workflows_template_add_failure_py39_compat(): """The attachment rejection remains compatible with Python 3.9.""" import importlib # Resolve the live module so patch.object and the class share the same # module dict regardless of any sys.modules manipulation by earlier tests. wf_mod = importlib.import_module("apprise.plugins.workflows") _NotifyWorkflows = wf_mod.NotifyWorkflows # Simulate add() silently failing (len stays 0); no HTTP call needed with mock.patch.object(wf_mod, "AppriseAttachment") as mock_cls: inst = mock.MagicMock() inst.__len__ = mock.Mock(return_value=0) mock_cls.return_value = inst with pytest.raises(AppriseImproperlyConfigured): _NotifyWorkflows( workflow="T00000000001", signature="AbCdEfGhIjKlMnOpQrStUvWx", template="file:///some/template.json", ) # --- End Python v3.9 Compat --- def test_plugin_workflows_templating_content_not_dict( request_mock, workflows_url, tmpdir ): """NotifyWorkflows() Templating - template that parses to a JSON array is rejected cleanly.""" # Valid JSON but a list rather than an object; no HTTP call is made template = tmpdir.join("array.json") template.write('[{"type": "message"}]') obj = Apprise.instantiate(f"{workflows_url}/?template={template!s}") assert isinstance(obj, NotifyWorkflows) assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is False ) assert request_mock.called is False def test_plugin_workflows_templating_attachment_not_dict( request_mock, workflows_url, tmpdir ): """NotifyWorkflows() Templating - non-dict in attachments rejected.""" # attachments list contains a string rather than a dict; no HTTP call made template = tmpdir.join("bad_attach.json") template.write('{"type": "message", "attachments": ["not-a-dict"]}') obj = Apprise.instantiate(f"{workflows_url}/?template={template!s}") assert isinstance(obj, NotifyWorkflows) assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is False ) assert request_mock.called is False def test_plugin_workflows_templating_none_token_value( request_mock, workflows_url, tmpdir ): """NotifyWorkflows() Templating - None token value (e.g. app_image_url) is coerced to empty string before JSON-escaping.""" # Template references app_image_url which will be None when # include_image=False; old code produced corrupted JSON ("ul" from None) template = tmpdir.join("img_ref.json") template.write( '{"type": "message", "attachments": [{' '"contentType": "application/vnd.microsoft.card.adaptive",' '"content": {"body": [{"type": "TextBlock",' '"text": "{{app_body}} img={{app_image_url}}"}]}}]}' ) # image=no forces app_image_url to None, exercising the None->"" # coercion in safe_tokens obj = Apprise.instantiate( f"{workflows_url}/?image=no&template={template!s}" ) assert isinstance(obj, NotifyWorkflows) # Must succeed -- None coerced to "" keeps the JSON valid assert ( bool(obj.notify(body="hello", title="t", notify_type=NotifyType.INFO)) is True ) assert request_mock.called is True posted_data = json.loads(request_mock.call_args_list[0][1]["data"]) body_text = posted_data["attachments"][0]["content"]["body"][0]["text"] # app_image_url should expand to "" not "ul" assert "img=" in body_text assert "ul" not in body_text def test_workflows_yaml_config_missing_template_filename( request_mock, workflows_url, simple_template, tmpdir ): """ NotifyWorkflows() YAML Configuration Entries - Missing template reference. """ config = tmpdir.join("workflow01.yml") config.write( cleandoc(f""" urls: - {workflows_url}: - tag: 'workflow' template: {simple_template!s}.missing :name: 'Template.Missing' :body: 'test body' :title: 'test title' """) ) # Config still loads okay cfg = AppriseConfig() cfg.add(str(config)) assert len(cfg) == 1 assert len(cfg[0]) == 1 obj = cfg[0][0] assert isinstance(obj, NotifyWorkflows) # However we can't send notification since the template couldn't be loaded assert ( bool( obj.notify(body="body", title="title", notify_type=NotifyType.INFO) ) is False ) assert request_mock.called is False def test_plugin_workflows_edge_cases(): """NotifyWorkflows() Edge Cases.""" # Initializes the plugin with an invalid token with pytest.raises(AppriseImproperlyConfigured): NotifyWorkflows(workflow="@", signature="@") with pytest.raises(AppriseImproperlyConfigured): NotifyWorkflows(workflow="", signature="abcd") with pytest.raises(AppriseImproperlyConfigured): NotifyWorkflows(workflow=None, signature="abcd") # Whitespace also acts as an invalid token value with pytest.raises(AppriseImproperlyConfigured): NotifyWorkflows(workflow=" ", signature="abcd") with pytest.raises(AppriseImproperlyConfigured): NotifyWorkflows(workflow="abcd", signature=None) # Whitespace also acts as an invalid token value with pytest.raises(AppriseImproperlyConfigured): NotifyWorkflows(workflow="abcd", signature=" ") # test case where invalid tokens are specified with pytest.raises(AppriseImproperlyConfigured): NotifyWorkflows( workflow="workflow", signature="signature", tokens="not-a-dict" ) # test case where no tokens are specified obj = NotifyWorkflows(workflow="workflow", signature="signature") assert isinstance(obj, NotifyWorkflows) def test_plugin_workflows_azure_webhooks(request_mock): """NotifyWorkflows() Azure Webhooks.""" url = ( "https://prod-15.uksouth.logic.azure.com:443" "/workflows/3XXX5/triggers/manual/paths/invoke" "?api-version=2016-06-01&" "sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=iXXXU" ) # # Initialize # obj = Apprise.instantiate(url) assert isinstance(obj, NotifyWorkflows) assert obj.workflow == "3XXX5" assert obj.signature == "iXXXU" assert obj.api_version == "2016-06-01" @pytest.mark.parametrize("routing_id", (123456789, 987654321)) def test_plugin_workflows_power_automate_cu_webhooks(request_mock, routing_id): """NotifyWorkflows() preserves Power Automate CU routing IDs.""" url = ( "https://default.environment.api.powerplatform.com:443" f"/powerautomate/automations/direct/cu/{routing_id}" "/workflows/3XXX5/triggers/manual/paths/invoke" "?api-version=2022-03-01-preview&" "sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=iXXXU" ) obj = Apprise.instantiate(url) assert isinstance(obj, NotifyWorkflows) assert obj.notify(body="body", title="title") is True assert request_mock.call_args.args[0] == ( "https://default.environment.api.powerplatform.com:443" f"/powerautomate/automations/direct/cu/{routing_id}" "/workflows/3XXX5/triggers/manual/paths/invoke" ) # Our routing ID is tracked and advertised in the Apprise URL assert obj.routing_id == str(routing_id) assert f"route={routing_id}" in obj.url() @pytest.mark.parametrize("key", ("route", "routeid")) def test_plugin_workflows_routing_id_parse_url(key): """NotifyWorkflows() parses the routing ID from an Apprise URL.""" results = NotifyWorkflows.parse_url( f"workflow://host/3XXX5/iXXXU/?pa=yes&{key}=123456789" ) assert isinstance(results, dict) assert results["routing_id"] == "123456789" obj = Apprise.instantiate( f"workflow://host/3XXX5/iXXXU/?pa=yes&{key}=123456789" ) assert isinstance(obj, NotifyWorkflows) assert obj.routing_id == "123456789" # No routing ID provided; nothing is set and nothing is advertised obj = Apprise.instantiate("workflow://host/3XXX5/iXXXU/?pa=yes") assert isinstance(obj, NotifyWorkflows) assert obj.routing_id is None assert "route=" not in obj.url() def test_plugin_workflows_routing_id_invalid(): """NotifyWorkflows() rejects a non-numeric routing ID.""" with pytest.raises(AppriseImproperlyConfigured): NotifyWorkflows( workflow="3XXX5", signature="iXXXU", routing_id="1/../evil" ) # Confirmed unusable (and therefore never reflected) via a full URL too assert ( Apprise.instantiate( "workflow://host/3XXX5/iXXXU/?pa=yes&route=1/../evil" ) is None ) def test_plugin_workflows_routing_id_round_trip(request_mock): """NotifyWorkflows() round-trips the routing ID through url().""" obj = Apprise.instantiate( "https://default.environment.api.powerplatform.com:443" "/powerautomate/automations/direct/cu/123456789" "/workflows/3XXX5/triggers/manual/paths/invoke" "?api-version=2022-03-01-preview&" "sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=iXXXU" ) assert isinstance(obj, NotifyWorkflows) assert obj.routing_id == "123456789" # Re-instantiate ourselves from our own generated URL obj_copy = Apprise.instantiate(obj.url()) assert isinstance(obj_copy, NotifyWorkflows) assert obj_copy.routing_id == obj.routing_id assert obj_copy.url() == obj.url() # The routed endpoint survives the round trip assert obj_copy.notify(body="body", title="title") is True assert request_mock.call_args.args[0] == ( "https://default.environment.api.powerplatform.com:443" "/powerautomate/automations/direct/cu/123456789" "/workflows/3XXX5/triggers/manual/paths/invoke" ) @mock.patch("requests.post") def test_plugin_workflows_html_to_markdown_format(mock_post): """NotifyWorkflows(): HTML body is converted to Markdown.""" # Prepare Mock mock_post.return_value = requests.Request() mock_post.return_value.status_code = requests.codes.ok # Workflows' notify_format is MARKDOWN by default aobj = Apprise() assert aobj.add("workflow://hostname/workflow1/signature1/?image=no") # Notify with an HTML body; the framework should convert it # to Markdown before dispatching to Workflows assert ( bool( aobj.notify( body="hello world", body_format=NotifyFormat.HTML, ) ) is True ) assert mock_post.call_count == 1 # The body must arrive as Markdown inside the adaptive card body block, # not as stripped plain text payload = json.loads(mock_post.call_args_list[0][1]["data"]) body_blocks = payload["attachments"][0]["content"]["body"] body_text = next(b["text"] for b in body_blocks if b.get("id") == "body") assert body_text == "**hello** *world*" @mock.patch("requests.post") def test_plugin_workflows_mention_entities(mock_post): """Teams mention tags populate unique ``msteams.entities`` entries.""" # Prepare a successful mocked HTTP response. mock_post.return_value = requests.Request() mock_post.return_value.status_code = requests.codes.ok aobj = Apprise() assert aobj.add("workflow://hostname/workflow1/signature1/?image=no") # Keep Teams metadata minimal when the body contains no mentions. assert bool(aobj.notify(body="Hello world", title="T")) is True payload = json.loads(mock_post.call_args_list[0][1]["data"]) msteams = payload["attachments"][0]["content"]["msteams"] assert msteams == {"width": "full"} mock_post.reset_mock() # Add one entity for a single mention. assert ( bool( aobj.notify( body="Hello foo@example.com!", title="T", ) ) is True ) payload = json.loads(mock_post.call_args_list[0][1]["data"]) msteams = payload["attachments"][0]["content"]["msteams"] assert msteams == { "width": "full", "entities": [ { "type": "mention", "text": "foo@example.com", "mentioned": { "id": "foo@example.com", "name": "foo@example.com", }, } ], } mock_post.reset_mock() # Preserve source order for distinct mentions. assert ( bool( aobj.notify( body=( "Hi alice@example.com and" " bob@example.com!" ), title="T", ) ) is True ) payload = json.loads(mock_post.call_args_list[0][1]["data"]) entities = payload["attachments"][0]["content"]["msteams"]["entities"] assert len(entities) == 2 assert entities[0]["mentioned"]["id"] == "alice@example.com" assert entities[1]["mentioned"]["id"] == "bob@example.com" mock_post.reset_mock() # Deduplicate repeated mention IDs. assert ( bool( aobj.notify( body=( "dup@example.com and" " dup@example.com again" ), title="T", ) ) is True ) payload = json.loads(mock_post.call_args_list[0][1]["data"]) entities = payload["attachments"][0]["content"]["msteams"]["entities"] assert len(entities) == 1 assert entities[0]["mentioned"]["id"] == "dup@example.com" mock_post.reset_mock() # Recover the valid inner tag from a nested opening sequence. assert ( bool( aobj.notify( body="Hi user@example.com!", title="T", ) ) is True ) payload = json.loads(mock_post.call_args_list[0][1]["data"]) entities = payload["attachments"][0]["content"]["msteams"]["entities"] assert len(entities) == 1 assert entities[0]["mentioned"]["id"] == "user@example.com" mock_post.reset_mock() # Recover an inner mention when text invalidates the outer tag. assert ( bool( aobj.notify( body="garbageinner@example.com", title="T", ) ) is True ) payload = json.loads(mock_post.call_args_list[0][1]["data"]) entities = payload["attachments"][0]["content"]["msteams"]["entities"] assert len(entities) == 1 assert entities[0]["mentioned"]["id"] == "inner@example.com" mock_post.reset_mock() # Ignore empty, whitespace-only, and unclosed mention tags. for bad_body in ("", " ", "unclosed"): assert bool(aobj.notify(body=bad_body, title="T")) is True payload = json.loads(mock_post.call_args_list[-1][1]["data"]) msteams = payload["attachments"][0]["content"]["msteams"] assert msteams == {"width": "full"}, ( f"expected no entities for {bad_body!r}" ) mock_post.reset_mock() # Preserve mixed-case entity text for Teams' verbatim body match. assert ( bool( aobj.notify( body="Hi user@example.com!", title="T", ) ) is True ) payload = json.loads(mock_post.call_args_list[0][1]["data"]) entity = payload["attachments"][0]["content"]["msteams"]["entities"][0] assert entity["text"] == "user@example.com" assert entity["mentioned"]["id"] == "user@example.com" mock_post.reset_mock() # Preserve tag padding while trimming the ID used for user resolution. assert ( bool( aobj.notify( body="Hi padded@example.com !", title="T", ) ) is True ) payload = json.loads(mock_post.call_args_list[0][1]["data"]) entity = payload["attachments"][0]["content"]["msteams"]["entities"][0] assert entity["text"] == " padded@example.com " assert entity["mentioned"]["id"] == "padded@example.com" caronc-apprise-dfec414/tests/test_plugin_wpush.py000066400000000000000000000401341526720371000224200ustar00rootroot00000000000000# # BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Disable logging for a cleaner testing output from json import dumps, loads import logging from unittest import mock from helpers import AppriseURLTester import pytest import requests from apprise import Apprise from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.wpush import ( WPUSH_CHANNEL_DEFAULT, NotifyWPush, WPushChannel, ) logging.disable(logging.CRITICAL) # WPUSH + exactly 27 more alphanumeric characters (32 total) GOOD_KEY = "WPUSH" + ("a" * 27) GOOD_RESPONSE = dumps( {"code": 0, "message": "success", "data": "1126950958891274240"} ) BAD_RESPONSE = dumps({"code": 401, "message": "API Key error"}) apprise_url_tests = ( ( "wpush://", {"instance": AppriseImproperlyConfigured}, ), ( "wpush://short", {"instance": AppriseImproperlyConfigured}, ), ( "wpush://{}".format(GOOD_KEY), { "instance": NotifyWPush, "privacy_url": "wpush://****/", "requests_response_text": GOOD_RESPONSE, }, ), ( "wpush://?apikey={}".format(GOOD_KEY), { "instance": NotifyWPush, "privacy_url": "wpush://****/", "requests_response_text": GOOD_RESPONSE, }, ), ( "wpush://{}?channel=feishu".format(GOOD_KEY), { "instance": NotifyWPush, "requests_response_text": GOOD_RESPONSE, }, ), ( "wpush://{}?channel=feishu,dingtalk,qqbot".format(GOOD_KEY), { "instance": NotifyWPush, "requests_response_text": GOOD_RESPONSE, }, ), ( "wpush://{}/topic1/topic2".format(GOOD_KEY), { "instance": NotifyWPush, "requests_response_text": GOOD_RESPONSE, }, ), ( "wpush://{}?to=topic1,topic2".format(GOOD_KEY), { "instance": NotifyWPush, "requests_response_text": GOOD_RESPONSE, }, ), ( "wpush://{}?topic_code=mytopic".format(GOOD_KEY), { "instance": NotifyWPush, "requests_response_text": GOOD_RESPONSE, }, ), ( "wpush://{}?topic=mytopic".format(GOOD_KEY), { "instance": NotifyWPush, "requests_response_text": GOOD_RESPONSE, }, ), ( "wpush://{}?channel=qqbot&group=123456".format(GOOD_KEY), { "instance": NotifyWPush, "requests_response_text": GOOD_RESPONSE, }, ), ( "wpush://{}?channel=qqbot&option=123456".format(GOOD_KEY), { "instance": NotifyWPush, "requests_response_text": GOOD_RESPONSE, }, ), ( "wpush://{}?url=https://example.com/".format(GOOD_KEY), { "instance": NotifyWPush, "requests_response_text": GOOD_RESPONSE, }, ), ( "wpush://{}?channel=nope".format(GOOD_KEY), {"instance": AppriseImproperlyConfigured}, ), ( "wpush://{}?group=123456&topic_code=mytopic".format(GOOD_KEY), {"instance": AppriseImproperlyConfigured}, ), ( "https://api.wpush.cn/api/v1/send?apikey={}".format(GOOD_KEY), { "instance": NotifyWPush, "requests_response_text": GOOD_RESPONSE, }, ), ( "wpush://{}".format(GOOD_KEY), { "instance": NotifyWPush, "response": False, "requests_response_text": BAD_RESPONSE, }, ), ( "wpush://{}".format(GOOD_KEY), { "instance": NotifyWPush, "response": False, "requests_response_code": requests.codes.internal_server_error, }, ), ( "wpush://{}".format(GOOD_KEY), { "instance": NotifyWPush, "test_requests_exceptions": True, }, ), ) def test_plugin_wpush_urls(): """NotifyWPush() Apprise URL test suite.""" AppriseURLTester(tests=apprise_url_tests).run_all() def test_plugin_wpush_init(): """NotifyWPush() object initialization.""" obj = NotifyWPush(apikey=GOOD_KEY) assert obj.apikey == GOOD_KEY assert obj.channels == [WPUSH_CHANNEL_DEFAULT] assert obj.topics == [] assert obj.group is None assert obj.click_url is None assert len(obj) == 1 obj = NotifyWPush(apikey=GOOD_KEY, channel="mail") assert obj.channels == [WPushChannel.MAIL] # Channels are stored once in alphabetical order obj = NotifyWPush(apikey=GOOD_KEY, channel="feishu,dingtalk,qqbot") assert obj.channels == [ WPushChannel.DINGTALK, WPushChannel.FEISHU, WPushChannel.QQBOT, ] obj = NotifyWPush(apikey=GOOD_KEY, targets=["topic1", "topic2"]) assert obj.topics == ["topic1", "topic2"] assert len(obj) == 2 obj = NotifyWPush(apikey=GOOD_KEY, channel="qqbot", group="123456") assert obj.group == "123456" # Channel matching ignores case and duplicates obj = NotifyWPush(apikey=GOOD_KEY, channel="Feishu,dingtalk,feishu") assert obj.channels == [WPushChannel.DINGTALK, WPushChannel.FEISHU] obj = NotifyWPush(apikey=GOOD_KEY, click_url="https://example.com/") assert obj.click_url == "https://example.com/" with pytest.raises(AppriseImproperlyConfigured): NotifyWPush(apikey=GOOD_KEY, channel="nope") with pytest.raises(AppriseImproperlyConfigured): NotifyWPush(apikey=GOOD_KEY, channel="feishu,nope") with pytest.raises(AppriseImproperlyConfigured): NotifyWPush(apikey="bad") with pytest.raises(AppriseImproperlyConfigured): # Group and topic targets cannot be combined NotifyWPush(apikey=GOOD_KEY, group="123456", targets=["topic1"]) def test_plugin_wpush_url_round_trip(): """NotifyWPush() url() round trip through parse_url().""" obj = NotifyWPush( apikey=GOOD_KEY, channel="feishu,dingtalk", targets=["topic1", "topic2"], click_url="https://example.com/", ) results = NotifyWPush.parse_url(obj.url()) obj2 = NotifyWPush(**results) assert obj.url_identifier == obj2.url_identifier assert obj.topics == obj2.topics # Channels are stored once in alphabetical order assert obj2.channels == [WPushChannel.DINGTALK, WPushChannel.FEISHU] assert obj2.click_url == "https://example.com/" # Round trip a QQ Robot group without a topic obj3 = NotifyWPush(apikey=GOOD_KEY, channel="qqbot", group="123456") results3 = NotifyWPush.parse_url(obj3.url()) obj4 = NotifyWPush(**results3) assert obj4.group == "123456" assert obj4.channels == [WPushChannel.QQBOT] @mock.patch("requests.post") def test_plugin_wpush_send_ok(mock_post): """Send once when no topic is set.""" response = mock.Mock() response.status_code = requests.codes.ok response.content = GOOD_RESPONSE.encode("utf-8") mock_post.return_value = response obj = NotifyWPush(apikey=GOOD_KEY) assert obj.send(body="hello", title="title") is True assert mock_post.call_count == 1 assert mock_post.call_args[0][0] == "https://api.wpush.cn/api/v1/send" assert mock_post.call_args[1]["headers"]["X-API-Key"] == GOOD_KEY assert "X-Idempotency-Key" in mock_post.call_args[1]["headers"] payload = loads(mock_post.call_args[1]["data"]) assert payload["apikey"] == GOOD_KEY assert payload["title"] == "title" assert payload["content"] == "hello" assert payload["channel"] == WPUSH_CHANNEL_DEFAULT assert "topic_code" not in payload assert "option" not in payload assert "url" not in payload mock_post.reset_mock() assert obj.send(body="only body") is True payload = loads(mock_post.call_args[1]["data"]) assert payload["title"] == "only body" @mock.patch("requests.post") def test_plugin_wpush_send_multi_channel(mock_post): """Send to several channels in one request.""" response = mock.Mock() response.status_code = requests.codes.ok response.content = GOOD_RESPONSE.encode("utf-8") mock_post.return_value = response # The payload keeps the stored alphabetical order obj = NotifyWPush(apikey=GOOD_KEY, channel="feishu,dingtalk,qqbot") assert obj.send(body="msg", title="t") is True assert mock_post.call_count == 1 payload = loads(mock_post.call_args[1]["data"]) assert payload["channel"] == "dingtalk,feishu,qqbot" @mock.patch("requests.post") def test_plugin_wpush_send_topic_and_channel(mock_post): """Send to one topic through a selected channel.""" response = mock.Mock() response.status_code = requests.codes.ok response.content = GOOD_RESPONSE.encode("utf-8") mock_post.return_value = response obj = NotifyWPush(apikey=GOOD_KEY, channel="feishu", targets="abc123") assert obj.send(body="msg", title="t") is True payload = loads(mock_post.call_args[1]["data"]) assert payload["channel"] == "feishu" assert payload["topic_code"] == "abc123" @mock.patch("requests.post") def test_plugin_wpush_send_qqbot_group(mock_post): """NotifyWPush() includes API option whenever group/option is set.""" response = mock.Mock() response.status_code = requests.codes.ok response.content = GOOD_RESPONSE.encode("utf-8") mock_post.return_value = response # Send the group code for QQ Robot obj = NotifyWPush(apikey=GOOD_KEY, channel="qqbot", group="123456") assert obj.send(body="msg") is True payload = loads(mock_post.call_args[1]["data"]) assert payload["option"] == "123456" # Other supported channels use option to select a bound instance mock_post.reset_mock() obj = NotifyWPush(apikey=GOOD_KEY, channel="mail", group="123456") assert obj.send(body="msg") is True payload = loads(mock_post.call_args[1]["data"]) assert payload["option"] == "123456" @mock.patch("requests.post") def test_plugin_wpush_send_click_url(mock_post): """Include an optional click-through URL.""" response = mock.Mock() response.status_code = requests.codes.ok response.content = GOOD_RESPONSE.encode("utf-8") mock_post.return_value = response obj = NotifyWPush(apikey=GOOD_KEY, click_url="https://example.com/") assert obj.send(body="msg") is True payload = loads(mock_post.call_args[1]["data"]) assert payload["url"] == "https://example.com/" @mock.patch("requests.post") def test_plugin_wpush_send_multiple_topics(mock_post): """NotifyWPush() sends once per topic and reports partial failure.""" ok_response = mock.Mock() ok_response.status_code = requests.codes.ok ok_response.content = GOOD_RESPONSE.encode("utf-8") bad_response = mock.Mock() bad_response.status_code = requests.codes.ok bad_response.content = BAD_RESPONSE.encode("utf-8") # Capture each key while the shared headers dictionary changes seen_keys = [] responses = [ok_response, bad_response] def _side_effect(*args, **kwargs): seen_keys.append(kwargs["headers"]["X-Idempotency-Key"]) return responses[len(seen_keys) - 1] mock_post.side_effect = _side_effect obj = NotifyWPush(apikey=GOOD_KEY, targets=["topic1", "topic2"]) assert obj.send(body="msg") is False assert mock_post.call_count == 2 # Each request must use a different key assert seen_keys[0] != seen_keys[1] @mock.patch("requests.post") def test_plugin_wpush_send_api_error(mock_post): """Handle a WPUSH error returned with HTTP 200.""" response = mock.Mock() response.status_code = requests.codes.ok response.content = BAD_RESPONSE.encode("utf-8") mock_post.return_value = response obj = NotifyWPush(apikey=GOOD_KEY) assert obj.send(body="msg") is False @mock.patch("requests.post") def test_plugin_wpush_bad_json(mock_post): """Handle a response that is not JSON.""" response = mock.Mock() response.status_code = requests.codes.ok response.content = b"not-json" mock_post.return_value = response obj = NotifyWPush(apikey=GOOD_KEY) assert obj.send(body="msg") is False @mock.patch("requests.post") def test_plugin_wpush_apprise_integration(mock_post): """Send through Apprise.""" response = mock.Mock() response.status_code = requests.codes.ok response.content = GOOD_RESPONSE.encode("utf-8") mock_post.return_value = response aobj = Apprise() assert aobj.add("wpush://{}".format(GOOD_KEY)) assert bool(aobj.notify(title="T", body="B")) is True assert mock_post.call_count == 1 def test_plugin_wpush_instance_options(): """Send instance codes through the option field.""" from json import loads for channel in ("feishu", "dingtalk", "webhook", "wechat_work"): obj = Apprise.instantiate( "wpush://{}?channel={}&option=ops".format(GOOD_KEY, channel) ) assert isinstance(obj, NotifyWPush) assert obj.group == "ops" with mock.patch("requests.post") as mock_post: mock_post.return_value = mock.Mock( status_code=200, content=GOOD_RESPONSE.encode("utf-8"), ) assert obj.notify(title="t", body="b") is True assert mock_post.called payload = loads(mock_post.call_args[1]["data"].decode("utf-8")) assert payload.get("option") == "ops" assert payload.get("channel") == channel def test_plugin_wpush_parse_native_url(): """Parse supported and invalid native URLs.""" # Parse the API Key result = NotifyWPush.parse_native_url( "https://api.wpush.cn/api/v1/send?apikey={}".format(GOOD_KEY) ) assert result is not None obj = NotifyWPush(**result) assert obj.apikey == GOOD_KEY # Preserve the channel parameter result = NotifyWPush.parse_native_url( "https://api.wpush.cn/api/v1/send?apikey={}&channel=mail".format( GOOD_KEY ) ) assert result is not None obj = NotifyWPush(**result) assert obj.channels == [WPushChannel.MAIL] # Reject a URL without an API Key assert ( NotifyWPush.parse_native_url( "https://api.wpush.cn/api/v1/send?channel=mail" ) is None ) # Reject other domains assert ( NotifyWPush.parse_native_url( "https://other.example.com/api/v1/send?apikey={}".format(GOOD_KEY) ) is None ) # Reject a URL without query parameters assert ( NotifyWPush.parse_native_url("https://api.wpush.cn/api/v1/send") is None ) def test_plugin_wpush_rejects_boolean_code(): """Reject Boolean codes even though False equals zero in Python.""" obj = Apprise.instantiate("wpush://{}".format(GOOD_KEY)) with mock.patch("requests.post") as mock_post: mock_post.return_value = mock.Mock( status_code=200, content=dumps({"code": False, "message": "nope"}).encode("utf-8"), ) assert obj.notify(title="t", body="b") is False caronc-apprise-dfec414/tests/test_plugin_wxpusher.py000066400000000000000000000306001526720371000231340ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from json import dumps, loads # Disable logging for a cleaner testing output import logging import os from unittest import mock from helpers import AppriseURLTester import requests from apprise import Apprise from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.wxpusher import NotifyWxPusher logging.disable(logging.CRITICAL) WXPUSHER_GOOD_RESPONSE = dumps({"code": 1000}) WXPUSHER_BAD_RESPONSE = dumps({"code": 99}) # Attachment Directory TEST_VAR_DIR = os.path.join(os.path.dirname(__file__), "var") # Our Testing URLs apprise_url_tests = ( ( "wxpusher://", { # No token specified "instance": AppriseImproperlyConfigured, }, ), ( "wxpusher://:@/", { # invalid url "instance": AppriseImproperlyConfigured, }, ), ( "wxpusher://invalid", { # invalid app token "instance": AppriseImproperlyConfigured, }, ), ( "wxpusher://AT_appid/123/", { # invalid 'to' phone number "instance": NotifyWxPusher, # Notify will fail because it couldn't send to anyone "response": False, # Our expected url(privacy=True) startswith() response: "privacy_url": "wxpusher://****/123/", # Our response expected server response "requests_response_text": WXPUSHER_GOOD_RESPONSE, }, ), ( "wxpusher://AT_appid/%20/%20/", { # invalid 'to' phone number "instance": NotifyWxPusher, # Notify will fail because it couldn't send to anyone "response": False, # Our expected url(privacy=True) startswith() response: "privacy_url": "wxpusher://****/", # Our response expected server response "requests_response_text": WXPUSHER_GOOD_RESPONSE, }, ), ( "wxpusher://AT_appid/123/", { # one phone number will notify ourselves "instance": NotifyWxPusher, # Our response expected server response "requests_response_text": WXPUSHER_GOOD_RESPONSE, }, ), ( "wxpusher://123?token=AT_abc1234", { # pass our token in as an argument and our host actually becomes a # target "instance": NotifyWxPusher, # Our response expected server response "requests_response_text": WXPUSHER_GOOD_RESPONSE, }, ), ( "wxpusher://?token=AT_abc1234", { # slightly different then test above; a token is defined, but # there are no targets "instance": NotifyWxPusher, # Notify will fail because it couldn't send to anyone "response": False, # Our response expected server response "requests_response_text": WXPUSHER_GOOD_RESPONSE, }, ), ( "wxpusher://?token=AT_abc1234&to=UID_abc", { # all kwargs to load url with "instance": NotifyWxPusher, # Our response expected server response "requests_response_text": WXPUSHER_GOOD_RESPONSE, }, ), ( "wxpusher://AT_appid/UID_abcd/", { # a valid contact "instance": NotifyWxPusher, # Our expected url(privacy=True) startswith() response: "privacy_url": "wxpusher://****/UID_abcd", # Our response expected server response "requests_response_text": WXPUSHER_GOOD_RESPONSE, }, ), ( "wxpusher://AT_appid/@/#/,/", { # Test case where we provide bad data "instance": NotifyWxPusher, # Our failed response "requests_response_text": WXPUSHER_GOOD_RESPONSE, # as a result, we expect a failed notification "response": False, }, ), ( "wxpusher://AT_appid/123/", { # Test case where we get a bad response "instance": NotifyWxPusher, # Our expected url(privacy=True) startswith() response: "privacy_url": "wxpusher://****/123", # Our failed response "requests_response_text": WXPUSHER_BAD_RESPONSE, # as a result, we expect a failed notification "response": False, }, ), ( "wxpusher://AT_appid/UID_345/", { # Test case where we get a bad response "instance": NotifyWxPusher, # Our expected url(privacy=True) startswith() response: "privacy_url": "wxpusher://****/UID_345", # Our failed response "requests_response_text": None, # as a result, we expect a failed notification "response": False, }, ), ( "wxpusher://AT_appid/UID_345/", { # Test case where we get a bad response "instance": NotifyWxPusher, # Our expected url(privacy=True) startswith() response: "privacy_url": "wxpusher://****/UID_345", # Our failed response (bad json) "requests_response_text": "{", # as a result, we expect a failed notification "response": False, }, ), ( "wxpusher://AT_appid/?to={},{}".format("2" * 11, "3" * 11), { # use get args to acomplish the same thing "instance": NotifyWxPusher, # Our response expected server response "requests_response_text": WXPUSHER_GOOD_RESPONSE, }, ), ( "wxpusher://AT_appid/?to={},{},{}".format("2" * 11, "3" * 11, "5" * 3), { # 2 good targets and one invalid one "instance": NotifyWxPusher, # Our response expected server response "requests_response_text": WXPUSHER_GOOD_RESPONSE, }, ), ( "wxpusher://AT_appid/{}/{}/".format("2" * 11, "3" * 11), { # If we have from= specified, then all elements take on the # to= value "instance": NotifyWxPusher, # Our response expected server response "requests_response_text": WXPUSHER_GOOD_RESPONSE, }, ), ( "wxpusher://AT_appid/{}".format("3" * 11), { # use get args to acomplish the same thing (use source instead # of from) "instance": NotifyWxPusher, # Our response expected server response "requests_response_text": WXPUSHER_GOOD_RESPONSE, }, ), ( "wxpusher://AT_appid/{}".format("4" * 11), { "instance": NotifyWxPusher, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, # Our response expected server response "requests_response_text": WXPUSHER_GOOD_RESPONSE, }, ), ( "wxpusher://AT_appid/{}".format("4" * 11), { "instance": NotifyWxPusher, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), ) def test_plugin_wxpusher_urls(): """NotifyWxPusher() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() @mock.patch("requests.post") def test_plugin_wxpusher_edge_cases(mock_post): """NotifyWxPusher() Edge Cases.""" # Prepare our response response = requests.Request() response.status_code = requests.codes.ok response.content = WXPUSHER_GOOD_RESPONSE # Prepare Mock mock_post.return_value = response # Initialize some generic (but valid) tokens target = "UID_abcd" body = "test body" title = "My Title" aobj = Apprise() assert aobj.add(f"wxpusher://AT_appid/{target}") assert len(aobj) == 1 assert aobj.notify(title=title, body=body) assert mock_post.call_count == 1 details = mock_post.call_args_list[0] assert details[0][0] == "https://wxpusher.zjiecode.com/api/send/message" payload = loads(details[1]["data"]) assert payload == { "appToken": "AT_appid", "content": "test body", "summary": "My Title", "contentType": 1, "topicIds": [], "uids": ["UID_abcd"], "url": None, } # Reset our mock object mock_post.reset_mock() @mock.patch("requests.post") def test_plugin_wxpusher_result_set(mock_post): """NotifyWxPusher() Result Sets.""" # Prepare our response response = requests.Request() response.status_code = requests.codes.ok response.content = WXPUSHER_GOOD_RESPONSE # Prepare Mock mock_post.return_value = response body = "test body" title = "My Title" aobj = Apprise() aobj.add("wxpusher://AT_appid/123/abc/UID_456") # One bad entry and 2 good assert len(aobj[0]) == 1 assert aobj.notify(title=title, body=body) # 2 posts made assert mock_post.call_count == 1 details = mock_post.call_args_list[0] assert details[0][0] == "https://wxpusher.zjiecode.com/api/send/message" payload = loads(details[1]["data"]) assert payload == { "appToken": "AT_appid", "content": "test body", "summary": "My Title", "contentType": 1, "topicIds": [123], "uids": ["UID_456"], "url": None, } # Validate our information is also placed back into the assembled URL assert "/123" in aobj[0].url() assert "/UID_456" in aobj[0].url() assert "/abc" in aobj[0].url() mock_post.reset_mock() aobj = Apprise() aobj.add("wxpusher://AT_appid//UID_123/UID_abc/123456789") assert len(aobj[0]) == 1 assert aobj.notify(title=title, body=body) # If batch is off then there is a post per entry assert mock_post.call_count == 1 details = mock_post.call_args_list[0] assert details[0][0] == "https://wxpusher.zjiecode.com/api/send/message" payload = loads(details[1]["data"]) assert payload == { "appToken": "AT_appid", "content": "test body", "summary": "My Title", "contentType": 1, "topicIds": [123456789], "uids": ["UID_123", "UID_abc"], "url": None, } assert "/123456789" in aobj[0].url() assert "/UID_123" in aobj[0].url() assert "/UID_abc" in aobj[0].url() @mock.patch("requests.post") def test_notify_wxpusher_plugin_result_list(mock_post): """NotifyWxPusher() Result List Response.""" okay_response = requests.Request() okay_response.status_code = requests.codes.ok # We want to test the case where the `result` set returned is a list # Invalid JSON response okay_response.content = "{" # Assign our mock object our return value mock_post.return_value = okay_response obj = Apprise.instantiate("wxpusher://AT_apptoken/UID_abcd/") assert isinstance(obj, NotifyWxPusher) # We should now fail assert bool(obj.notify("test")) is False caronc-apprise-dfec414/tests/test_plugin_xbmc_kodi.py000066400000000000000000000170201526720371000232070ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Disable logging for a cleaner testing output import logging from helpers import AppriseURLTester import requests from apprise import NotifyType from apprise.plugins.kodi import NotifyXBMC logging.disable(logging.CRITICAL) # Our Testing URLs apprise_url_tests = ( ( "kodi://", { "instance": None, }, ), ( "kodis://", { "instance": None, }, ), ( "kodi://localhost", { "instance": NotifyXBMC, }, ), ( "kodi://192.168.4.1", { # Support IPv4 Addresses "instance": NotifyXBMC, }, ), ( "kodi://[2001:db8:002a:3256:adfe:05c0:0003:0006]", { # Support IPv6 Addresses "instance": NotifyXBMC, # Privacy URL "privacy_url": "kodi://[2001:db8:002a:3256:adfe:05c0:0003:0006]", }, ), ( "kodi://[2001:db8:002a:3256:adfe:05c0:0003:0006]:8282", { # Support IPv6 Addresses with port "instance": NotifyXBMC, # Privacy URL "privacy_url": ( "kodi://[2001:db8:002a:3256:adfe:05c0:0003:0006]:8282" ), }, ), ( "kodi://user:pass@localhost", { "instance": NotifyXBMC, # Our expected url(privacy=True) startswith() response: "privacy_url": "kodi://user:****@localhost", }, ), ( "kodi://localhost:8080", { "instance": NotifyXBMC, }, ), ( "kodi://user:pass@localhost:8080", { "instance": NotifyXBMC, }, ), ( "kodis://localhost", { "instance": NotifyXBMC, }, ), ( "kodis://user:pass@localhost", { "instance": NotifyXBMC, }, ), ( "kodis://localhost:8080/path/", { "instance": NotifyXBMC, }, ), ( "kodis://user:password@localhost:8080", { "instance": NotifyXBMC, # Our expected url(privacy=True) startswith() response: "privacy_url": "kodis://user:****@localhost:8080", }, ), ( "kodi://localhost", { "instance": NotifyXBMC, # Experement with different notification types "notify_type": NotifyType.WARNING, }, ), ( "kodi://localhost", { "instance": NotifyXBMC, # Experement with different notification types "notify_type": NotifyType.FAILURE, }, ), ( "kodis://localhost:443", { "instance": NotifyXBMC, # don't include an image by default "include_image": False, }, ), ( "kodi://:@/", { "instance": None, }, ), ( "kodi://user:pass@localhost:8081", { "instance": NotifyXBMC, # force a failure "response": False, "requests_response_code": requests.codes.internal_server_error, }, ), ( "kodi://user:pass@localhost:8082", { "instance": NotifyXBMC, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( "kodi://user:pass@localhost:8083", { "instance": NotifyXBMC, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), # # XMBC (Legacy Platform) Shares this same KODI Plugin # ( "xbmc://", { "instance": None, }, ), ( "xbmc://localhost", { "instance": NotifyXBMC, }, ), ( "xbmc://localhost?duration=14", { "instance": NotifyXBMC, }, ), ( "xbmc://localhost?duration=invalid", { "instance": NotifyXBMC, }, ), ( "xbmc://localhost?duration=-1", { "instance": NotifyXBMC, }, ), ( "xbmc://user:pass@localhost", { "instance": NotifyXBMC, }, ), ( "xbmc://localhost:8080", { "instance": NotifyXBMC, }, ), ( "xbmc://user:pass@localhost:8080", { "instance": NotifyXBMC, }, ), ( "xbmc://user@localhost", { "instance": NotifyXBMC, # don't include an image by default "include_image": False, }, ), ( "xbmc://localhost", { "instance": NotifyXBMC, # Experement with different notification types "notify_type": NotifyType.WARNING, }, ), ( "xbmc://localhost", { "instance": NotifyXBMC, # Experement with different notification types "notify_type": NotifyType.FAILURE, }, ), ( "xbmc://:@/", { "instance": None, }, ), ( "xbmc://user:pass@localhost:8081", { "instance": NotifyXBMC, # force a failure "response": False, "requests_response_code": requests.codes.internal_server_error, }, ), ( "xbmc://user:pass@localhost:8082", { "instance": NotifyXBMC, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( "xbmc://user:pass@localhost:8083", { "instance": NotifyXBMC, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), ) def test_plugin_xbmc_kodi_urls(): """NotifyXBMC() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() caronc-apprise-dfec414/tests/test_plugin_xmpp.py000066400000000000000000005112001526720371000222330ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. """ Unit Tests for the XMPP plugin. """ from __future__ import annotations import asyncio from collections.abc import Iterator import contextlib import gc import logging import ssl import threading import time from types import SimpleNamespace from typing import Any, Optional import pytest from apprise import LOGGER_NAME, Apprise, NotifyType from apprise.exception import AppriseException, AppriseImproperlyConfigured from apprise.plugins.xmpp import adapter as xmpp_adapter, base as xmpp_base from apprise.plugins.xmpp.base import NotifyXMPP def test_plugin_xmpp_channel_binding_exception() -> None: """Channel-binding failures use the common Apprise exception.""" exc = xmpp_adapter.XMPPChannelBindingError() assert isinstance(exc, AppriseException) assert str(exc) == "SASL SCRAM-PLUS channel-binding authentication failed." def run_on_loop(loop: asyncio.AbstractEventLoop, coro: Any) -> Any: """Run a coroutine on a specific event loop.""" asyncio.set_event_loop(loop) return loop.run_until_complete(coro) # --------------------------------------------------------------------------- # Slixmpp Availability Handling # --------------------------------------------------------------------------- try: # Enforce slixmpp >= Minimum Supported Version SLIXMPP_AVAILABLE = xmpp_adapter.SlixmppAdapter.supported_version() except Exception: SLIXMPP_AVAILABLE = False # Seconds to sleep before forcing the timeout branch in _FakeDoneEvent.wait(). # This gives the worker thread enough time to progress to a known checkpoint # (e.g. event loop created, client instantiated) without relying on a longer # wall-clock timeout that would slow tests down. WORKER_THREAD_STARTUP_DELAY: float = 0.02 # --------------------------------------------------------------------------- # Fake Slixmpp Client # --------------------------------------------------------------------------- class FakeClientXMPP: def __init__(self, jid: str, password: str) -> None: self.jid = jid self.password = password # Loop is assigned by adapter via `client.loop = loop`, but we default # to the current event loop for safety in tests. self.loop: Optional[asyncio.AbstractEventLoop] = None self.handlers: dict[str, Any] = {} self.auto_reconnect = True # Slixmpp >= 1.16.0: adapter waits on this Future self.disconnected: Optional[asyncio.Future[bool]] = None # Slixmpp toggles used by adapter self.enable_plaintext = True self.enable_starttls = True self.enable_direct_tls = False self.ssl_context = None # Track plugins registered by the adapter (keepalive path) self.registered_plugins: dict[str, Any] = {} def add_event_handler(self, name: str, handler: Any) -> None: self.handlers[name] = handler def send_presence(self) -> None: return None async def get_roster(self) -> None: return None def send_message(self, **kwargs: Any) -> None: return None def register_plugin(self, name: str, config: Optional[Any] = None) -> None: self.registered_plugins[name] = config return None def disconnect(self) -> None: # Complete the disconnected Future if it is not already done. if self.disconnected is not None and not self.disconnected.done(): self.disconnected.set_result(True) def connect(self, **kwargs: Any) -> asyncio.Future[bool]: """ Slixmpp >= 1.16.0 connect() returns a Future. Our adapter awaits it. This fake schedules session_start on the assigned loop so the adapter's loop.run_until_complete() drives it, and ensures disconnected resolves. """ loop = self.loop or asyncio.get_running_loop() # Ensure disconnected future exists on the correct loop if self.disconnected is None: self.disconnected = loop.create_future() fut: asyncio.Future[bool] = loop.create_future() fut.set_result(True) handler = self.handlers.get("session_start") if handler: def _fire_session_start() -> None: rv = handler() if asyncio.iscoroutine(rv): task = loop.create_task(rv) # Ensure we always disconnect after session_start task.add_done_callback(lambda _: self.disconnect()) else: # sync handler, just disconnect self.disconnect() # Schedule for when the adapter starts running the loop loop.call_soon(_fire_session_start) return fut # --------------------------------------------------------------------------- # Helpers # --------------------------------------------------------------------------- @pytest.fixture(autouse=True) def join_xmpp_threads() -> Iterator[None]: """Wait for any XMPP worker thread a test started to finish.""" # Threads already running belong to someone else. before = set(threading.enumerate()) yield # A worker left running would call into the next test's patches. for thread in set(threading.enumerate()) - before: if thread.name.startswith("apprise-xmpp"): thread.join(timeout=10.0) def install_fake_slixmpp(monkeypatch: pytest.MonkeyPatch) -> None: monkeypatch.setattr(xmpp_adapter, "asyncio", asyncio, raising=False) monkeypatch.setattr( xmpp_adapter, "slixmpp", SimpleNamespace(ClientXMPP=FakeClientXMPP), raising=False, ) monkeypatch.setattr( xmpp_adapter, "SLIXMPP_SUPPORT_AVAILABLE", True, raising=False ) monkeypatch.setattr( xmpp_adapter.SlixmppAdapter, "_enabled", True, raising=False, ) def _patch_threading( monkeypatch: pytest.MonkeyPatch, *, done_event_cls: type ) -> None: """Patch adapter threading to use a custom done-event class.""" import threading as _real_threading class _ThreadingProxy: Event = done_event_cls Thread = _real_threading.Thread def __getattr__(self, name: str) -> Any: return getattr(_real_threading, name) monkeypatch.setattr( xmpp_adapter, "threading", _ThreadingProxy(), raising=True ) # --------------------------------------------------------------------------- # NotifyXMPP Tests # --------------------------------------------------------------------------- def _make_fake_done_event_cls( signal_evt: Optional[threading.Event] = None, ) -> type: """Return a deterministic threading.Event replacement for timeout tests. The adapter under test uses ``threading.Event()`` for *done*, then calls ``done.wait(timeout=...)`` and later ``done.set()`` from the worker thread. These tests want ``wait()`` to return ``False`` deterministically (forcing the timeout branch), while still giving the worker thread a chance to reach a known checkpoint first (e.g. event loop created, client created). Capturing *signal_evt* in a closure rather than as a class-level attribute ensures that each test's event class is fully independent — parallel test runs cannot interfere with one another through shared mutable class state. Parameters ---------- signal_evt: Optional ``threading.Event`` that the worker thread sets when it reaches a stable checkpoint. If provided, ``wait()`` pauses until that event is set before forcing the timeout branch. """ class _FakeDoneEvent: def __init__(self) -> None: self._set = False self._wait_calls = 0 def is_set(self) -> bool: return self._set def set(self) -> None: self._set = True def clear(self) -> None: self._set = False def wait(self, timeout: Optional[float] = None) -> bool: self._wait_calls += 1 if self._wait_calls == 1: if signal_evt is not None: # The specific timeout value isn't important; we just # don't want this to hang if the checkpoint is never # reached. signal_evt.wait(timeout=1.0) # Give the worker thread a brief chance to run before we # force the timeout condition in the code under test. time.sleep(WORKER_THREAD_STARTUP_DELAY) return False return self._set return _FakeDoneEvent @pytest.mark.skipif(SLIXMPP_AVAILABLE, reason="Requires slixmpp NOT installed") def test_slixmpp_unavailable() -> None: obj = NotifyXMPP(host="example.com", user="me@example.com", password="x") assert obj.send("will fail") is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_invalid_jid() -> None: with pytest.raises(AppriseImproperlyConfigured): NotifyXMPP(host="example.com", user="bad jid", password="x") @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_targets_filtered() -> None: n = NotifyXMPP( host="example.com", user="me@example.com", password="x", targets=["ok@example.com", " user1 user2 ", "", "also@example.net"], ) # parse_list() tokenises on whitespace, so "bad jid" becomes two targets. # Empty values are dropped before they reach the validation loop, so no # warning is guaranteed for the empty string. assert sorted(n.targets) == [ ("chat", "also@example.net"), ("chat", "ok@example.com"), ("chat", "user1@example.com"), ("chat", "user2@example.com"), ] @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_len() -> None: n1 = NotifyXMPP(host="example.com", user="me@example.com", password="x") assert len(n1) == 1 n2 = NotifyXMPP( host="example.com", user="me@example.com", password="x", targets=["a@example.com", "b@example.com"], ) # still just one upstream message assert len(n2) == 1 @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_url_privacy() -> None: n = NotifyXMPP( host="example.com", user="me@example.com", password="secret", targets=["a@example.com"], verify=False, ) u = n.url(privacy=True) assert "secret" not in u assert "verify=" in u @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_parse_url() -> None: r = NotifyXMPP.parse_url( "xmpps://me:pass@example.com/a@example.com?verify=no" ) assert r["verify"] is False assert r["targets"] == ["a@example.com"] @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_parse_url_to() -> None: r = NotifyXMPP.parse_url( "xmpp://me:pass@example.com?to=a@example.com,b@example.net" ) assert sorted(r["targets"]) == ["a@example.com", "b@example.net"] @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_invalid_targets_logged( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture ) -> None: """Invalid XMPP targets are dropped with a warning.""" # Some test modules disable logging globally at import time # This ensures we're correctly configured for this test. logging.disable(logging.NOTSET) caplog.set_level(logging.WARNING, logger=LOGGER_NAME) caplog.set_level(logging.WARNING, logger=xmpp_base.__name__) try: # parse_list() tokenises on whitespace, so it is difficult to # naturally feed a whitespace-containing value through. Patch # parse_list() to return a value that will fail IS_JID validation. monkeypatch.setattr( xmpp_base, "parse_list", lambda _v: ["bad jid", "ok@example.com"], raising=True, ) n = NotifyXMPP( host="example.com", user="me@example.com", password="x", targets=["ignored"], ) assert n.targets == [("chat", "ok@example.com")] assert "Dropped invalid XMPP target" in caplog.text finally: logging.disable(logging.CRITICAL) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_url_identifier_is_accessible() -> None: """url_identifier property should be accessible and stable.""" n = NotifyXMPP( host="example.com", user="me@example.com", password="secret" ) schema, host, xmpp_host, user, password, port = n.url_identifier assert schema == "xmpp" assert host == "example.com" assert xmpp_host == "" assert user == "me@example.com" assert password == "secret" assert port is None @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_server_override_parse_url() -> None: """?xmpp= is extracted into xmpp_host by parse_url().""" r = NotifyXMPP.parse_url( "xmpps://user@example.com/joe?xmpp=xmpp.example.com" ) assert r is not None assert r["xmpp_host"] == "xmpp.example.com" # host stays as the JID domain assert r["host"] == "example.com" @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_server_override_constructor_and_url() -> None: """xmpp_host is stored and round-trips through url().""" n = NotifyXMPP( host="example.com", user="user", password="pass", xmpp_host="xmpp.example.com", ) # Stored correctly assert n.xmpp_host == "xmpp.example.com" # JIDs are built from host, not xmpp_host assert n.jid == "user@example.com" # url() emits xmpp= when it differs from host u = n.url(privacy=False) assert "xmpp=xmpp.example.com" in u assert "example.com" in u # url() omits xmpp= when xmpp_host matches host (redundant) n2 = NotifyXMPP( host="example.com", user="user", password="pass", xmpp_host="example.com", ) u2 = n2.url(privacy=False) assert "xmpp=" not in u2 # url() omits xmpp= when xmpp_host is empty n3 = NotifyXMPP( host="example.com", user="user", password="pass", ) u3 = n3.url(privacy=False) assert "xmpp=" not in u3 @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_server_override_target_jids_use_host() -> None: """Target JIDs are built from host, not xmpp_host.""" n = NotifyXMPP( host="example.com", user="user", password="pass", targets=["joe"], xmpp_host="xmpp.example.com", ) # Target 'joe' gets host domain appended, not xmpp_host assert n.targets == [("chat", "joe@example.com")] @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_server_override_url_identifier() -> None: """url_identifier carries xmpp_host so deduplication is xmpp_host-aware.""" n = NotifyXMPP( host="example.com", user="user", password="pass", xmpp_host="xmpp.example.com", ) _schema, host, xmpp_host, _user, _password, _port = n.url_identifier assert host == "example.com" assert xmpp_host == "xmpp.example.com" @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_server_override_config_host( monkeypatch: pytest.MonkeyPatch, ) -> None: """send() passes xmpp_host (not host) to XMPPConfig when set.""" captured: dict = {} class _Adapter: def __init__(self, config: Any, **kwargs: Any) -> None: captured["config_host"] = config.host def process(self) -> bool: return True monkeypatch.setattr(xmpp_base, "SlixmppAdapter", _Adapter, raising=True) apobj = Apprise() apobj.add("xmpps://user@example.com/joe?xmpp=xmpp.example.com") apobj.notify("hello") assert captured["config_host"] == "xmpp.example.com" @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_server_override_config_host_defaults_to_host( monkeypatch: pytest.MonkeyPatch, ) -> None: """send() passes host to XMPPConfig when xmpp_host is not set.""" captured: dict = {} class _Adapter: def __init__(self, config: Any, **kwargs: Any) -> None: captured["config_host"] = config.host def process(self) -> bool: return True monkeypatch.setattr(xmpp_base, "SlixmppAdapter", _Adapter, raising=True) apobj = Apprise() apobj.add("xmpps://user@example.com/joe") apobj.notify("hello") assert captured["config_host"] == "example.com" @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_url_handling() -> None: """url() must not append a path when there are no targets.""" apobj = Apprise() assert apobj.add("xmpp://me:secret@example.com?verify=no") is True assert len(apobj) == 1 plugin = apobj[0] u = plugin.url(privacy=False) assert "example.com/?" in u assert "mode=none" in u apobj = Apprise() assert apobj.add("xmpps://me:secret@example.com?mode=tls") is True assert len(apobj) == 1 plugin = apobj[0] u = plugin.url(privacy=False) assert "mode=tls" in u # invalid Mode apobj = Apprise() assert apobj.add("xmpps://me:secret@example.com?mode=invalid") is False # Ambiguous secure=true (xmpps://) and mode = none apobj = Apprise() assert apobj.add("xmpps://me:secret@example.com?mode=none") is True assert len(apobj) == 1 plugin = apobj[0] u = plugin.url(privacy=False) # starttls (upgraded from none - most secure path) assert "mode=starttls" in u # Ambiguous secure=False (xmpp://) and mode != none apobj = Apprise() assert apobj.add("xmpp://me:secret@example.com?mode=tls") is True assert len(apobj) == 1 plugin = apobj[0] u = plugin.url(privacy=False) # most secure path prevails assert "mode=tls" in u apobj = Apprise() assert ( apobj.add("xmpp://me:secret@example.com?subject=yes&roster=yes") is True ) assert len(apobj) == 1 plugin = apobj[0] u = plugin.url(privacy=False) # most secure path prevails assert "mode=none" in u assert "roster=yes" in u assert "subject=yes" in u @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_parse_url_returns_none(monkeypatch: pytest.MonkeyPatch) -> None: """parse_url() returns None when NotifyBase.parse_url() fails.""" monkeypatch.setattr( xmpp_base.NotifyBase, "parse_url", lambda *_args, **_kwargs: None, raising=True, ) assert NotifyXMPP.parse_url("xmpp://bad") is None @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_finalize_loop_when_already_closed_does_not_close_again() -> None: loop = asyncio.new_event_loop() loop.close() # If _finalize_loop tried to close again, this would still be harmless, # but this test specifically forces the "if not loop.is_closed()" branch # to be False for coverage. xmpp_adapter.SlixmppAdapter._finalize_loop(loop) assert loop.is_closed() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_apprise_notify_invokes_adapter( monkeypatch: pytest.MonkeyPatch, ) -> None: """Exercise the Apprise.notify() workflow while mocking network I/O.""" captured: dict[str, Any] = {} class _Adapter: def __init__( self, config: xmpp_adapter.XMPPConfig, targets: list[str], subject: str, body: str, timeout: float = 0.0, roster: bool = False, before_message: Any = None, logger: Optional[logging.Logger] = None, **kwargs: Any, ) -> None: captured["targets"] = targets captured["body"] = body captured["subject"] = subject captured["roster"] = roster def process(self) -> bool: return True monkeypatch.setattr(xmpp_base, "SlixmppAdapter", _Adapter, raising=True) apobj = Apprise() apobj.add("xmpp://me:secret@example.com/a@example.com") assert ( bool( apobj.notify("hello", title="subject", notify_type=NotifyType.INFO) ) is True ) assert captured["targets"] == [("chat", "a@example.com")] assert captured["subject"] == "" assert "subject\r\nhello" in captured["body"] apobj = Apprise() apobj.add("xmpp://me:secret@example.com/a@example.com?subject=yes") assert ( bool( apobj.notify("hello", title="subject", notify_type=NotifyType.INFO) ) is True ) assert captured["targets"] == [("chat", "a@example.com")] assert captured["subject"] == "subject" assert "hello" in captured["body"] # --------------------------------------------------------------------------- # Adapter Tests # --------------------------------------------------------------------------- @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_ssl_context() -> None: ctx = xmpp_adapter.SlixmppAdapter._ssl_context(True) assert ctx.verify_mode != ssl.CERT_NONE ctx2 = xmpp_adapter.SlixmppAdapter._ssl_context(False) assert ctx2.verify_mode == ssl.CERT_NONE assert ctx2.check_hostname is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_cancel_pending_empty(monkeypatch: pytest.MonkeyPatch) -> None: loop = asyncio.new_event_loop() try: monkeypatch.setattr( asyncio, "all_tasks", lambda _: set(), raising=True ) xmpp_adapter.SlixmppAdapter._finalize_loop(loop) finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_cancel_pending_tasks(monkeypatch: pytest.MonkeyPatch) -> None: loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) async def _noop() -> None: await asyncio.sleep(0) t1 = loop.create_task(_noop()) t2 = loop.create_task(_noop()) monkeypatch.setattr( asyncio, "all_tasks", lambda _: {t1, t2}, raising=True ) xmpp_adapter.SlixmppAdapter._finalize_loop(loop) assert t1.cancelled() assert t2.cancelled() finally: # Avoid asyncio.get_event_loop() here to prevent DeprecationWarning on # newer Python versions. Setting to None is sufficient for isolation. with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_process_disabled(monkeypatch: pytest.MonkeyPatch) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5223, secure=xmpp_adapter.SecureXMPPMode.TLS, verify_certificate=True, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", timeout=1, ) monkeypatch.setattr(a, "_enabled", False, raising=True) assert a.process() is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_process_fail( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture ) -> None: install_fake_slixmpp(monkeypatch) caplog.set_level(logging.WARNING) def bad_connect(self: FakeClientXMPP, **kw: Any) -> asyncio.Future[bool]: fut: asyncio.Future[bool] = self.loop.create_future() fut.set_result(False) return fut monkeypatch.setattr(FakeClientXMPP, "connect", bad_connect, raising=True) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5223, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=True, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=1, ) assert a.process() is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_process_success(monkeypatch: pytest.MonkeyPatch) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5223, secure=xmpp_adapter.SecureXMPPMode.TLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=1.0, ) assert a.process() is True # Test with roster=True a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=1.0, roster=True, ) assert a.process() is True @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_process_default_target(monkeypatch: pytest.MonkeyPatch) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5223, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", timeout=1.0, ) assert a.process() is True @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_process_exception( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture ) -> None: install_fake_slixmpp(monkeypatch) caplog.set_level(logging.DEBUG) def explode(self: FakeClientXMPP, **kw: Any) -> bool: raise RuntimeError("boom") monkeypatch.setattr(FakeClientXMPP, "connect", explode, raising=True) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5223, secure=xmpp_adapter.SecureXMPPMode.TLS, verify_certificate=True, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=1, ) assert a.process() is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_process_before_message(monkeypatch: pytest.MonkeyPatch) -> None: """Ensure before_message callback is invoked for each target.""" install_fake_slixmpp(monkeypatch) called: list[int] = [] def before_message() -> None: called.append(1) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5223, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com"), ("chat", "b@example.com")], subject="s", body="b", timeout=1, before_message=before_message, ) assert a.process() is True assert len(called) == 2 @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_process_failed_auth_disconnect( monkeypatch: pytest.MonkeyPatch, ) -> None: """Authentication failure path must still call disconnect().""" install_fake_slixmpp(monkeypatch) # Force the connect() path to trigger the failed_auth handler. def connect_failed_auth( self: FakeClientXMPP, **kw: Any ) -> asyncio.Future[bool]: loop = self.loop or asyncio.get_running_loop() if self.disconnected is None: self.disconnected = loop.create_future() fut: asyncio.Future[bool] = loop.create_future() fut.set_result(True) handler = self.handlers.get("failed_auth") if handler: loop.call_soon(handler) loop.call_soon(self.disconnect) return fut monkeypatch.setattr( FakeClientXMPP, "connect", connect_failed_auth, raising=True ) disconnected = {"called": False} def disconnect(self: FakeClientXMPP) -> None: disconnected["called"] = True if not self.disconnected.done(): self.disconnected.set_result(True) monkeypatch.setattr(FakeClientXMPP, "disconnect", disconnect, raising=True) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5223, secure=xmpp_adapter.SecureXMPPMode.TLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=1, ) assert a.process() is False assert disconnected["called"] is True @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_normalize_jid() -> None: """Tests normalize_jid()""" assert NotifyXMPP.normalize_jid("user", "example.ca") == ( "user@example.ca", False, ) assert NotifyXMPP.normalize_jid("user/resource", "example.ca") == ( "user@example.ca/resource", False, ) assert NotifyXMPP.normalize_jid( "user/resource/extra/crap", "example.ca" ) == ("user@example.ca/resource", False) assert NotifyXMPP.normalize_jid("user@example.com/r1", "example.ca") == ( "user@example.com/r1", False, ) assert NotifyXMPP.normalize_jid( "#room@conference.example.ca", "example.ca" ) == ("room@conference.example.ca", True) with pytest.raises(AppriseImproperlyConfigured): # Bad entry NotifyXMPP.normalize_jid("", "example.ca") @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_bridge_logging_safe_lock( monkeypatch: pytest.MonkeyPatch, ) -> None: """tests bridge logging on multiple attempts""" # Reset module globals monkeypatch.setattr(xmpp_adapter, "_LOG_BRIDGED", False, raising=True) # Acquire the lock so the worker blocks inside bridge_slixmpp_logging() xmpp_adapter._LOG_BRIDGE_LOCK.acquire() done = {"ok": False} def worker() -> None: xmpp_adapter.bridge_slixmpp_logging() done["ok"] = True t = threading.Thread(target=worker, daemon=True) t.start() # Allow enough time for the worker to reach the lock, even on busy hosts. time.sleep(0.1) # Now flip the flag while the lock is still held; when released, worker # will acquire the lock and hit the *inner* early-return. monkeypatch.setattr(xmpp_adapter, "_LOG_BRIDGED", True, raising=True) xmpp_adapter._LOG_BRIDGE_LOCK.release() t.join(timeout=1.0) assert done["ok"] is True @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_multi_logging_bridge_handling( monkeypatch: pytest.MonkeyPatch, ) -> None: """Handles multiple logging attempts made by multiple xmpp instances""" # Reset module globals monkeypatch.setattr(xmpp_adapter, "_LOG_BRIDGED", False, raising=True) apprise_logger = logging.getLogger("apprise") slix_logger = logging.getLogger("slixmpp") # Preserve existing handlers old_apprise = list(apprise_logger.handlers) old_slix = list(slix_logger.handlers) try: handler = logging.NullHandler() # Arrange for slix to already have the handler apprise_logger.handlers = [handler] slix_logger.handlers = [handler] xmpp_adapter.bridge_slixmpp_logging() # Handler should not be duplicated assert slix_logger.handlers.count(handler) == 1 finally: apprise_logger.handlers = old_apprise slix_logger.handlers = old_slix @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_process_failure_cleanup(monkeypatch: pytest.MonkeyPatch) -> None: """Tests edge cases for failures that require cleanup""" install_fake_slixmpp(monkeypatch) # Ensure adapter is enabled monkeypatch.setattr( xmpp_adapter.SlixmppAdapter, "_enabled", True, raising=True ) # Make new_event_loop fail before shared['loop'] is assigned def raise_new_event_loop() -> Any: raise RuntimeError("poof") monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", raise_new_event_loop, raising=True, ) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5223, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=5.0, ) # Should return False assert a.process() is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_timeout_cleanup_disconnect_exception_suppressed( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover timeout cleanup: loop_obj != None""" install_fake_slixmpp(monkeypatch) # Ensure adapter is enabled monkeypatch.setattr( xmpp_adapter.SlixmppAdapter, "_enabled", True, raising=True ) client_created = threading.Event() # Let us know when _Client() has been constructed (super().__init__ call) orig_init = FakeClientXMPP.__init__ def init_signal( self: FakeClientXMPP, jid: str, password: str, *args: Any, **kwargs: Any, ) -> None: orig_init(self, jid, password, *args, **kwargs) client_created.set() monkeypatch.setattr(FakeClientXMPP, "__init__", init_signal, raising=True) # Block connect so runner cannot complete before the timeout branch. def connect_blocks( self: FakeClientXMPP, **kw: Any ) -> asyncio.Future[bool]: fut: asyncio.Future[bool] = self.loop.create_future() # Never resolve. return fut monkeypatch.setattr( FakeClientXMPP, "connect", connect_blocks, raising=True ) # Make done.wait deterministic without touching real threading.Event used # by Thread internals _patch_threading( monkeypatch, done_event_cls=_make_fake_done_event_cls(client_created), ) # Capture and control loop.call_soon_threadsafe behaviour import asyncio as _real_asyncio orig_new_event_loop = _real_asyncio.new_event_loop calls: list[str] = [] def new_event_loop_wrapped() -> _real_asyncio.AbstractEventLoop: loop = orig_new_event_loop() orig_csts = loop.call_soon_threadsafe def csts(cb: Any, *a: Any) -> Any: # Identify which callback is being scheduled name = getattr(cb, "__name__", repr(cb)) calls.append(name) # Raise only for disconnect callback to hit try/except if name == "disconnect": raise RuntimeError("boom") return orig_csts(cb, *a) monkeypatch.setattr(loop, "call_soon_threadsafe", csts, raising=True) return loop monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", new_event_loop_wrapped, raising=True, ) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5223, secure=xmpp_adapter.SecureXMPPMode.TLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=5.0, ) assert a.process() is False # We should have attempted both disconnect and loop.stop scheduling assert "disconnect" in calls assert "stop" in calls @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_timeout_cleanup_no_client_stop_exception_suppressed( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover timeout cleanup: loop_obj != None""" install_fake_slixmpp(monkeypatch) monkeypatch.setattr( xmpp_adapter.SlixmppAdapter, "_enabled", True, raising=True ) loop_created = threading.Event() allow_client_create = threading.Event() # Block FakeClientXMPP.__init__ so shared['client'] never gets set before # timeout orig_init = FakeClientXMPP.__init__ def init_block( self: FakeClientXMPP, jid: str, password: str, *args: Any, **kwargs: Any, ) -> None: # Wait until main thread has already taken the timeout path allow_client_create.wait(timeout=1.0) orig_init(self, jid, password, *args, **kwargs) monkeypatch.setattr(FakeClientXMPP, "__init__", init_block, raising=True) # Deterministic done.wait: wait until loop exists, then force timeout _patch_threading( monkeypatch, done_event_cls=_make_fake_done_event_cls(loop_created), ) # Wrap new_event_loop so we can (a) signal loop exists and (b) make stop # raise import asyncio as _real_asyncio orig_new_event_loop = _real_asyncio.new_event_loop calls: list[str] = [] def new_event_loop_wrapped() -> _real_asyncio.AbstractEventLoop: loop = orig_new_event_loop() loop_created.set() def csts(cb: Any, *a: Any) -> Any: name = getattr(cb, "__name__", repr(cb)) calls.append(name) if name == "stop": raise RuntimeError("boom-stop") return None monkeypatch.setattr(loop, "call_soon_threadsafe", csts, raising=True) return loop monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", new_event_loop_wrapped, raising=True, ) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5223, secure=xmpp_adapter.SecureXMPPMode.NONE, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=5.0, ) try: assert a.process() is False # client_obj is None, so no disconnect scheduling attempt should occur assert "disconnect" not in calls # stop scheduling attempted and exception suppressed assert "stop" in calls finally: # Unblock the runner thread so it does not linger allow_client_create.set() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_timeout_cleanup_loop_none_skips_disconnect_and_stop( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture ) -> None: """Cover timeout clean-up branch where shared['loop'] is still None.""" install_fake_slixmpp(monkeypatch) # Some test modules disable logging globally at import time (see # "Disable logging for a cleaner testing output" elsewhere in the # suite). caplog.set_level() only relies on newer pytest versions to # un-suppress that global disable -- older pytest releases (as # packaged for some RPM builds) do not, leaving caplog.text empty # regardless of the level requested. Force logging on explicitly so # this assertion holds under any pytest version or collection order. logging.disable(logging.NOTSET) caplog.set_level(logging.WARNING, logger="apprise.xmpp") # Ensure adapter is enabled monkeypatch.setattr( xmpp_adapter.SlixmppAdapter, "_enabled", True, raising=True ) # Gate used to block runner before it can assign shared["loop"]. gate = threading.Event() # Raised by new_event_loop_blocking as soon as the worker enters it -- # before any loop object is created and before shared["loop"] is set. # This lets done.wait() synchronize on this checkpoint so we have a # deterministic guarantee that shared["loop"] is still None when the # main-thread timeout cleanup runs. worker_entered_gate = threading.Event() # Patch asyncio.new_event_loop to block until we allow it, so # shared["loop"] remains None when the timeout clean-up executes. import asyncio as _real_asyncio orig_new_event_loop = _real_asyncio.new_event_loop def new_event_loop_blocking() -> _real_asyncio.AbstractEventLoop: # Signal the main thread: we are inside new_event_loop_blocking and # shared["loop"] has not been set yet. worker_entered_gate.set() gate.wait(timeout=2.0) return orig_new_event_loop() monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", new_event_loop_blocking, raising=True, ) # Make done.wait deterministic: wait until the worker has entered # new_event_loop_blocking (guaranteeing shared["loop"] is still None) # before forcing the timeout branch. _patch_threading( monkeypatch, done_event_cls=_make_fake_done_event_cls(worker_entered_gate), ) # Track whether any loop clean-up scheduling occurs. # It must NOT when loop_obj is None. called = {"disconnect": 0, "stop": 0} # Block connect so runner cannot complete before the timeout branch. def connect_blocks( self: FakeClientXMPP, **kw: Any ) -> asyncio.Future[bool]: fut: asyncio.Future[bool] = self.loop.create_future() # Never resolve. return fut monkeypatch.setattr( FakeClientXMPP, "connect", connect_blocks, raising=True ) # As an extra guard, if loop.call_soon_threadsafe were somehow reached, # we'd see it via this patch. Since loop_obj is None, it must not. def fake_disconnect(self: FakeClientXMPP) -> None: called["disconnect"] += 1 monkeypatch.setattr( FakeClientXMPP, "disconnect", fake_disconnect, raising=True ) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5223, secure=xmpp_adapter.SecureXMPPMode.TLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=5.0, ) try: # done.wait blocks until the worker signals worker_entered_gate # (guaranteeing shared["loop"] is None), then returns False # immediately, so the timeout clean-up sees loop_obj=None. assert a.process() is False assert "XMPP send timed out" in caplog.text # No disconnect should have been scheduled because loop_obj was None. assert called["disconnect"] == 0 finally: # Let the runner proceed and exit gate.set() logging.disable(logging.CRITICAL) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_process_unsupported_secure_mode( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture ) -> None: """The process runner handles an unsupported secure mode.""" install_fake_slixmpp(monkeypatch) # See test_xmpp_invalid_targets_logged for why this is needed: older # pytest releases don't un-suppress a prior logging.disable(CRITICAL) # left by another test module's import-time call. logging.disable(logging.NOTSET) caplog.set_level(logging.WARNING, logger="apprise.xmpp") try: config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure="invalid", verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=5.0, ) assert a.process() is False assert "XMPP send failed" in caplog.text finally: logging.disable(logging.CRITICAL) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_process_connect_timeout( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture ) -> None: """Cover connect timeout branch (asyncio.TimeoutError).""" install_fake_slixmpp(monkeypatch) # See test_xmpp_invalid_targets_logged for why this is needed: older # pytest releases don't un-suppress a prior logging.disable(CRITICAL) # left by another test module's import-time call. logging.disable(logging.NOTSET) caplog.set_level(logging.WARNING, logger="apprise.xmpp") try: # Return a Future that never resolves. connect_future: dict[str, Any] = {"fut": None} def connect_never( self: FakeClientXMPP, **kw: Any ) -> asyncio.Future[bool]: fut: asyncio.Future[bool] = self.loop.create_future() connect_future["fut"] = fut return fut monkeypatch.setattr( FakeClientXMPP, "connect", connect_never, raising=True ) # Force wait_for() to raise TimeoutError immediately for this # connect future. real_wait_for = xmpp_adapter.asyncio.wait_for async def wait_for_patched( aw: Any, timeout: Optional[float] = None ) -> Any: if aw is connect_future["fut"]: raise asyncio.TimeoutError() return await real_wait_for(aw, timeout=timeout) monkeypatch.setattr( xmpp_adapter.asyncio, "wait_for", wait_for_patched, raising=True ) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=5.0, ) assert a.process() is False assert "XMPP connect timed out" in caplog.text finally: logging.disable(logging.CRITICAL) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_process_session_timeout( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture ) -> None: """Cover session timeout branch when waiting on client.disconnected.""" install_fake_slixmpp(monkeypatch) # See test_xmpp_invalid_targets_logged for why this is needed: older # pytest releases don't un-suppress a prior logging.disable(CRITICAL) # left by another test module's import-time call. logging.disable(logging.NOTSET) caplog.set_level(logging.WARNING, logger="apprise.xmpp") try: # Ensure disconnect does not complete the disconnected Future. def disconnect_no_complete(self: FakeClientXMPP) -> None: return None monkeypatch.setattr( FakeClientXMPP, "disconnect", disconnect_no_complete, raising=True ) # Capture the disconnected future once connect() creates it. It # does not exist yet at __init__ time (see FakeClientXMPP.__init__), # so it must be captured here instead. real_connect = FakeClientXMPP.connect disconnected_future: dict[str, Any] = {"fut": None} def connect_capture(self: FakeClientXMPP, **kwargs: Any) -> Any: fut = real_connect(self, **kwargs) disconnected_future["fut"] = self.disconnected return fut monkeypatch.setattr( FakeClientXMPP, "connect", connect_capture, raising=True ) # Force wait_for() to raise TimeoutError immediately, but only for # the disconnected future -- matching by identity rather than call # order keeps this deterministic even if session_start's own # concurrently-scheduled task (MUC join, etc.) happens to call # wait_for() of its own accord first. real_wait_for = xmpp_adapter.asyncio.wait_for def wait_for_patched(aw: Any, timeout: Optional[float] = None) -> Any: if aw is disconnected_future["fut"]: # If aw is a coroutine, close it to avoid warnings with contextlib.suppress(Exception): if hasattr(aw, "close"): aw.close() raise asyncio.TimeoutError() return real_wait_for(aw, timeout=timeout) monkeypatch.setattr( xmpp_adapter.asyncio, "wait_for", wait_for_patched, raising=True ) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=5.0, ) assert a.process() is False assert "XMPP session timed out" in caplog.text finally: logging.disable(logging.CRITICAL) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_slixmpp_versioning(monkeypatch: pytest.MonkeyPatch) -> None: """ Simple checks to verify versioning works correctly """ # Garbage in... garbage out assert xmpp_adapter.SlixmppAdapter.supported_version("garbage") is False # These versions are too old assert xmpp_adapter.SlixmppAdapter.supported_version("1.0.0") is False assert xmpp_adapter.SlixmppAdapter.supported_version("1.10.0") is False assert xmpp_adapter.SlixmppAdapter.supported_version("1.14.1") is False assert xmpp_adapter.SlixmppAdapter.supported_version("1.15.0") is False assert xmpp_adapter.SlixmppAdapter.supported_version("1.15.1") is False # Good version checks assert xmpp_adapter.SlixmppAdapter.supported_version("1.16.0") is True assert xmpp_adapter.SlixmppAdapter.supported_version("1.16") is True assert xmpp_adapter.SlixmppAdapter.supported_version("1.16.1") is True assert xmpp_adapter.SlixmppAdapter.supported_version("1.16.100") is True assert xmpp_adapter.SlixmppAdapter.supported_version("1.17.0") is True # This version is too old assert xmpp_adapter.SlixmppAdapter.supported_version("1") is False # This version is good assert xmpp_adapter.SlixmppAdapter.supported_version("3") is True assert xmpp_adapter.SlixmppAdapter.supported_version("3.2") is True monkeypatch.setattr( xmpp_adapter, "SLIXMPP_SUPPORT_AVAILABLE", False, raising=False ) monkeypatch.setattr( xmpp_adapter.SlixmppAdapter, "_enabled", False, raising=False, ) assert xmpp_adapter.SlixmppAdapter.supported_version("3.2") is False # --------------------------------------------------------------------------- # Keepalive Tests # --------------------------------------------------------------------------- @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_keepalive_url_and_parse() -> None: n = NotifyXMPP( host="example.com", user="me@example.com", password="x", targets=["a@example.com"], keepalive=True, ) u = n.url(privacy=False) assert "keepalive=yes" in u r = NotifyXMPP.parse_url( "xmpp://me:pass@example.com/a@example.com?keepalive=yes" ) assert r["keepalive"] is True @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_keepalive_reuses_adapter_instance( monkeypatch: pytest.MonkeyPatch, ) -> None: created = {"count": 0} calls = {"send_message": 0, "process": 0} class _Adapter: def __init__(self, *args: Any, **kwargs: Any) -> None: created["count"] += 1 self.keepalive = kwargs.get("keepalive", False) def process(self) -> bool: calls["process"] += 1 return True def send_message(self, **kwargs: Any) -> bool: calls["send_message"] += 1 return True def close(self) -> None: return None monkeypatch.setattr(xmpp_base, "SlixmppAdapter", _Adapter, raising=True) # keepalive=yes should create adapter once, then reuse it n = NotifyXMPP( host="example.com", user="me@example.com", password="x", targets=["a@example.com"], keepalive=True, ) assert n.send("body1", title="t1") is True assert n.send("body2", title="t2") is True assert created["count"] == 1 assert calls["send_message"] == 2 assert calls["process"] == 0 # keepalive=no should not reuse adapter, it uses process() one-shot created["count"] = 0 calls["send_message"] = 0 calls["process"] = 0 n = NotifyXMPP( host="example.com", user="me@example.com", password="x", targets=["a@example.com"], keepalive=False, ) assert n.send("body", title="t") is True assert created["count"] == 1 assert calls["process"] == 1 assert calls["send_message"] == 0 @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_send_message_keepalive_false_calls_process( monkeypatch: pytest.MonkeyPatch, ) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.NONE, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=5.0, keepalive=False, ) called = {"process": 0} def process() -> bool: called["process"] += 1 return True monkeypatch.setattr(a, "process", process, raising=True) assert a.send_message(targets=["x"], subject="y", body="z") is True assert called["process"] == 1 assert a.targets == ["x"] assert a.subject == "y" assert a.body == "z" @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_ensure_keepalive_worker_edge_cases( monkeypatch: pytest.MonkeyPatch, ) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) # keepalive False => False a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", keepalive=False, ) assert a._ensure_keepalive_worker() is False # keepalive True but closing => False a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", keepalive=True, ) a._closing = True assert a._ensure_keepalive_worker() is False # keepalive True but disabled => False a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", keepalive=True, ) monkeypatch.setattr(a, "_enabled", False, raising=True) assert a._ensure_keepalive_worker() is False # thread already alive => True a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", keepalive=True, ) class _AliveThread: def is_alive(self) -> bool: return True a._thread = _AliveThread() assert a._ensure_keepalive_worker() is True @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_ensure_keepalive_worker_wait_timeout( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture ) -> None: install_fake_slixmpp(monkeypatch) # See test_xmpp_invalid_targets_logged for why this is needed: older # pytest releases don't un-suppress a prior logging.disable(CRITICAL) # left by another test module's import-time call. logging.disable(logging.NOTSET) caplog.set_level(logging.WARNING, logger="apprise.xmpp") try: config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", timeout=0.1, keepalive=True, ) # Prevent starting a real loop thread monkeypatch.setattr(a, "_keepalive_runner", lambda: None, raising=True) # Force wait() to fail monkeypatch.setattr( a._loop_ready, "wait", lambda timeout=None: False, raising=True ) assert a._ensure_keepalive_worker() is False assert "keepalive worker failed to start" in caplog.text finally: logging.disable(logging.CRITICAL) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_connect_if_required_early_returns( monkeypatch: pytest.MonkeyPatch, ) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", keepalive=True ) assert asyncio.run(a._connect_if_required()) is False loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) a._loop = loop assert run_on_loop(loop, a._connect_if_required()) is False a._client = SimpleNamespace() assert run_on_loop(loop, a._connect_if_required()) is False a._connect_lock = asyncio.Lock() assert run_on_loop(loop, a._connect_if_required()) is False a._session_started = asyncio.Event() assert run_on_loop(loop, a._connect_if_required()) is False finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_connect_if_required_already_connected( monkeypatch: pytest.MonkeyPatch, ) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", keepalive=True ) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) a._loop = loop a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() a._session_started.set() called = {"connect": 0} class _Client: def connect(self, **kwargs: Any) -> Any: called["connect"] += 1 fut = loop.create_future() fut.set_result(True) return fut a._client = _Client() assert run_on_loop(loop, a._connect_if_required()) is True assert called["connect"] == 0 finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_connect_if_required_connect_timeout( monkeypatch: pytest.MonkeyPatch, ) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", timeout=5.0, keepalive=True, ) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) a._loop = loop a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() fut = loop.create_future() class _Client: def connect(self, **kwargs: Any) -> Any: return fut a._client = _Client() real_wait_for = xmpp_adapter.asyncio.wait_for def wait_for_patched(aw: Any, timeout: Optional[float] = None) -> Any: if aw is fut: raise asyncio.TimeoutError() return real_wait_for(aw, timeout=timeout) monkeypatch.setattr( xmpp_adapter.asyncio, "wait_for", wait_for_patched, raising=True ) assert run_on_loop(loop, a._connect_if_required()) is False finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_connect_if_required_connect_exception( monkeypatch: pytest.MonkeyPatch, ) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", keepalive=True ) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) a._loop = loop a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() class _Client: def connect(self, **kwargs: Any) -> Any: raise RuntimeError("boom") a._client = _Client() assert run_on_loop(loop, a._connect_if_required()) is False finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_connect_if_required_session_start_timeout( monkeypatch: pytest.MonkeyPatch, ) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", timeout=5.0, keepalive=True, ) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) a._loop = loop a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() fut = loop.create_future() fut.set_result(True) class _Client: def connect(self, **kwargs: Any) -> Any: return fut a._client = _Client() # First wait_for succeeds (connect), second one raises # (session start wait) real_wait_for = xmpp_adapter.asyncio.wait_for calls = {"n": 0} async def wait_for_patched( aw: Any, timeout: Optional[float] = None ) -> Any: calls["n"] += 1 if calls["n"] == 2: # Prevent "coroutine Event.wait was never awaited" with contextlib.suppress(Exception): if hasattr(aw, "close"): aw.close() raise asyncio.TimeoutError() return await real_wait_for(aw, timeout=timeout) monkeypatch.setattr( xmpp_adapter.asyncio, "wait_for", wait_for_patched, raising=True ) assert run_on_loop(loop, a._connect_if_required()) is False finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_send_keepalive_async_default_target_and_send_error( monkeypatch: pytest.MonkeyPatch, ) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", keepalive=True ) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) a._loop = loop a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() a._session_started.set() sent: list[str] = [] class _Client: def send_message(self, **kwargs: Any) -> None: sent.append(kwargs.get("mto")) a._client = _Client() async def ok_connect() -> bool: return True monkeypatch.setattr( a, "_connect_if_required", ok_connect, raising=True ) assert ( run_on_loop( loop, a._send_keepalive_async(targets=[], subject="s", body="b"), ) is True ) assert sent == ["me@example.com"] # Now force send_message to raise and ensure session_started clears def boom_send_message(self: _Client, **kwargs: Any) -> None: raise RuntimeError("boom-send") monkeypatch.setattr( _Client, "send_message", boom_send_message, raising=True ) assert a._session_started.is_set() is True assert ( run_on_loop( loop, a._send_keepalive_async(targets=[], subject="s", body="b"), ) is False ) assert a._session_started.is_set() is False finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_send_message_keepalive_timeout_and_exception( monkeypatch: pytest.MonkeyPatch, ) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", timeout=5.0, keepalive=True, ) # Ensure worker exists without spinning a real thread monkeypatch.setattr( a, "_ensure_keepalive_worker", lambda: True, raising=True ) calls: list[str] = [] class _Loop: def call_soon_threadsafe(self, cb: Any, *args: Any) -> None: calls.append(getattr(cb, "__name__", "cb")) cb(*args) a._loop = _Loop() cleared = {"n": 0} class _Evt: def clear(self) -> None: cleared["n"] += 1 a._session_started = _Evt() # Timeout path class _FutureTimeout: def result(self, timeout: Optional[float] = None) -> Any: raise xmpp_adapter.FuturesTimeoutError() def run_coroutine_threadsafe_timeout(coro: Any, loop: Any) -> Any: # Prevent "never awaited" warnings with contextlib.suppress(Exception): coro.close() return _FutureTimeout() monkeypatch.setattr( xmpp_adapter.asyncio, "run_coroutine_threadsafe", run_coroutine_threadsafe_timeout, raising=True, ) assert a.send_message(targets=[], subject="s", body="b") is False assert cleared["n"] == 1 # Exception path class _FutureError: def result(self, timeout: Optional[float] = None) -> Any: raise RuntimeError("boom") monkeypatch.setattr( xmpp_adapter.asyncio, "run_coroutine_threadsafe", run_coroutine_threadsafe_timeout, raising=True, ) assert a.send_message(targets=[], subject="s", body="b") is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_del_suppresses_close_exception( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Cover SlixmppAdapter.__del__() exception suppression """ install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) def boom_close() -> None: raise RuntimeError("boom-close") monkeypatch.setattr(a, "close", boom_close, raising=True) # Ensure __del__ runs and does not raise del a gc.collect() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_close_shutdown_paths_and_state_reset( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Cover close(): _shutdown() branches and loop.call_soon_threadsafe exception suppression, plus state reset """ install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) class _Client: def disconnect(self) -> None: raise RuntimeError("disconnect boom") class _Loop: def __init__(self) -> None: self.called: list[str] = [] def stop(self) -> None: self.called.append("stop") raise RuntimeError("stop boom") def call_soon_threadsafe(self, cb: Any, *args: Any) -> None: self.called.append("call_soon_threadsafe") # Execute immediately so _shutdown() runs in this test cb(*args) class _Thread: def join(self, timeout: Optional[float] = None) -> None: return None # Populate internals so close() takes the full path loop = _Loop() a._loop = loop a._client = _Client() a._thread = _Thread() # Also set asyncio primitives to ensure they are nulled out a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() a.close() # State must be cleared assert a._thread is None assert a._loop is None assert a._client is None assert a._connect_lock is None assert a._session_started is None # Ensure call_soon_threadsafe ran (and stop attempted inside _shutdown) assert "call_soon_threadsafe" in loop.called assert "stop" in loop.called @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_close_call_soon_threadsafe_raises_still_resets( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Cover close(): loop.call_soon_threadsafe(_shutdown) raising and being suppressed, while still joining and clearing state. """ install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) class _Loop: def call_soon_threadsafe(self, cb: Any, *args: Any) -> None: raise RuntimeError("csts boom") def stop(self) -> None: return None class _Thread: def join(self, timeout: Optional[float] = None) -> None: return None a._loop = _Loop() a._client = SimpleNamespace(disconnect=lambda: None) a._thread = _Thread() a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() a.close() assert a._thread is None assert a._loop is None assert a._client is None assert a._connect_lock is None assert a._session_started is None @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_ensure_keepalive_worker_returns_true_at_end( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Hit _ensure_keepalive_worker() bottom return True """ install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", timeout=5.0, keepalive=True, ) # Make the runner set loop_ready quickly and exit, using a real thread. def runner() -> None: a._loop_ready.set() return None monkeypatch.setattr(a, "_keepalive_runner", runner, raising=True) assert a._ensure_keepalive_worker() is True @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_keepalive_runner_executes_and_register_plugin_suppressed( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Execute _keepalive_runner() including: - secure mode config - register_plugin() suppression - loop.run_forever() exit - finally: loop.stop/close """ install_fake_slixmpp(monkeypatch) # Force register_plugin to raise so the suppress(Exception) is exercised def boom_register_plugin( self: FakeClientXMPP, name: str, config: Optional[Any] = None ) -> None: raise RuntimeError("boom-plugin") monkeypatch.setattr( FakeClientXMPP, "register_plugin", boom_register_plugin, raising=True ) # Wrap new_event_loop so we can make run_forever return immediately, and # make stop/close callable. real_new_event_loop = xmpp_adapter.asyncio.new_event_loop def new_event_loop_wrapped() -> asyncio.AbstractEventLoop: loop = real_new_event_loop() # Exit immediately instead of blocking forever monkeypatch.setattr(loop, "run_forever", lambda: None, raising=True) # Ensure stop/close are callable (real loop has them already) return loop monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", new_event_loop_wrapped, raising=True, ) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) # Run synchronously. Since run_forever() is patched to return, this # should exit quickly. a._keepalive_runner() # Worker should have published these before entering run_forever() assert a._loop is not None assert a._client is not None assert a._connect_lock is not None assert a._session_started is not None @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_connect_if_required_hits_bottom_return_true( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Cover _connect_if_required() success path reaching the final return True, not the early already-connected return. """ install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", timeout=5.0, keepalive=True, ) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) a._loop = loop a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() fut = loop.create_future() fut.set_result(True) class _Client: def connect(self, **kwargs: Any) -> Any: return fut a._client = _Client() # Patch wait_for so the second wait_for (session_started.wait()) sets # the event just in time, forcing the bottom return True. real_wait_for = xmpp_adapter.asyncio.wait_for calls = {"n": 0} async def wait_for_patched( aw: Any, timeout: Optional[float] = None ) -> Any: calls["n"] += 1 if calls["n"] == 2: assert a._session_started is not None a._session_started.set() return await real_wait_for(aw, timeout=timeout) monkeypatch.setattr( xmpp_adapter.asyncio, "wait_for", wait_for_patched, raising=True ) assert run_on_loop(loop, a._connect_if_required()) is True finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_send_keepalive_async_connect_fail_branch( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Cover _send_keepalive_async(): if not ok: return False """ install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) # Must not be None, or it returns False earlier a._client = SimpleNamespace(send_message=lambda **kw: None) async def fail_connect() -> bool: return False monkeypatch.setattr(a, "_connect_if_required", fail_connect, raising=True) assert ( asyncio.run( a._send_keepalive_async(targets=["x"], subject="s", body="b") ) is False ) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_send_keepalive_async_exception_when_session_started_none( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Cover _send_keepalive_async() exception path where _session_started is None so clear() is skipped """ install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) async def ok_connect() -> bool: return True monkeypatch.setattr(a, "_connect_if_required", ok_connect, raising=True) class _Client: def send_message(self, **kwargs: Any) -> None: raise RuntimeError("boom-send") a._client = _Client() # Key detail: explicitly set to None to take the "skip clear()" branch a._session_started = None assert ( asyncio.run( a._send_keepalive_async(targets=["x"], subject="s", body="b") ) is False ) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_close_shutdown_client_none_branch( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Cover close(): _shutdown() path where client is None. """ install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) class _Loop: def __init__(self) -> None: self.stopped = False self.called = False def stop(self) -> None: self.stopped = True def call_soon_threadsafe(self, cb: Any, *args: Any) -> None: self.called = True cb(*args) class _Thread: def join(self, timeout: Optional[float] = None) -> None: return None loop = _Loop() a._loop = loop a._thread = _Thread() # Key: ensure client is None so if client is not None is False a._client = None a.close() assert loop.called is True assert loop.stopped is True assert a._loop is None assert a._thread is None assert a._client is None @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_close_thread_alive_returns_without_clearing_state( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover close() branch where worker thread is still alive.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) class _Client: def disconnect(self) -> None: return None class _Loop: def __init__(self) -> None: self.called: list[str] = [] def stop(self) -> None: self.called.append("stop") def call_soon_threadsafe(self, cb: Any, *args: Any) -> None: self.called.append("call_soon_threadsafe") cb(*args) class _Thread: def join(self, timeout: Optional[float] = None) -> None: return None def is_alive(self) -> bool: return True loop = _Loop() thread = _Thread() a._loop = loop a._client = _Client() a._thread = thread a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() a.close() assert a._loop is loop assert a._thread is thread assert loop.called[0] == "call_soon_threadsafe" @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_keepalive_runner_returns_if_closing_before_publish( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover _keepalive_runner() state-lock early return when closing.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) def _closing_register_plugin( self: FakeClientXMPP, name: str, config: Optional[Any] = None ) -> None: a._closing = True return None monkeypatch.setattr( FakeClientXMPP, "register_plugin", _closing_register_plugin, raising=True, ) real_new_event_loop = xmpp_adapter.asyncio.new_event_loop def _new_event_loop() -> asyncio.AbstractEventLoop: loop = real_new_event_loop() monkeypatch.setattr( loop, "run_forever", lambda: (_ for _ in ()).throw(AssertionError("run_forever")), raising=True, ) return loop monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", _new_event_loop, raising=True, ) a._loop_ready.clear() a._keepalive_runner() assert a._loop_ready.is_set() is False assert a._loop is None assert a._client is None @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_keepalive_runner_finally_clears_state_when_closing( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover _keepalive_runner() finally state-clear when closing.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) real_new_event_loop = xmpp_adapter.asyncio.new_event_loop created: list[asyncio.AbstractEventLoop] = [] def _new_event_loop() -> asyncio.AbstractEventLoop: loop = real_new_event_loop() created.append(loop) def _run_forever() -> None: a._closing = True return None monkeypatch.setattr(loop, "run_forever", _run_forever, raising=True) return loop monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", _new_event_loop, raising=True, ) a._loop_ready.clear() a._keepalive_runner() assert a._loop_ready.is_set() is True assert a._loop is None assert a._client is None assert a._connect_lock is None assert a._session_started is None assert created assert created[0].is_closed() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_keepalive_session_start_signals_on_error( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover keepalive _Client._session_start() exception handling.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="ex.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True, roster=True, timeout=5.0, ) loop = asyncio.new_event_loop() # Detach from policy initially asyncio.set_event_loop(None) try: def run_forever_hook() -> None: client = a._client started = a._session_started monkeypatch.setattr( client, "send_presence", lambda: (_ for _ in ()).throw(RuntimeError("fail")), raising=True, ) client._on_session_start() async def wait_for_event(): while not started.is_set(): await asyncio.sleep(0.01) # Assign to variable so we can explicitly close it if needed coro = wait_for_event() try: wf = asyncio.wait_for(coro, timeout=1.0) try: loop.run_until_complete(wf) finally: with contextlib.suppress(Exception): wf.close() finally: # Prevent "coroutine was never awaited" warnings with contextlib.suppress(Exception): coro.close() assert started.is_set() is True return None monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", lambda: loop, ) monkeypatch.setattr(loop, "run_forever", run_forever_hook) a._keepalive_runner() finally: if not loop.is_closed(): # Cancel all tasks, including those from internal asyncio # machinery for task in asyncio.all_tasks(loop): task.cancel() with contextlib.suppress(Exception): loop.run_until_complete(asyncio.sleep(0)) loop.close() # Clean up global policies asyncio.set_event_loop(None) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_client_session_start_roster_timeout_closes_awaitable( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover roster timeout close path in _session_start().""" install_fake_slixmpp(monkeypatch) client_cls = xmpp_adapter._get_client_subclass(FakeClientXMPP) called: list[object] = [] orig_close = xmpp_adapter._close_awaitable def _spy_close(obj: object) -> None: called.append(obj) orig_close(obj) monkeypatch.setattr( xmpp_adapter, "_close_awaitable", _spy_close, raising=True ) async def _raise_timeout(*args: object, **kwargs: object) -> None: raise asyncio.TimeoutError() monkeypatch.setattr( xmpp_adapter.asyncio, "wait_for", _raise_timeout, raising=True ) loop = asyncio.new_event_loop() asyncio.set_event_loop(loop) try: evt = asyncio.Event() client = client_cls( jid="user@example.com", password="pass", oneshot=False, want_roster=True, roster_timeout=1.0, session_started_evt=evt, ) loop.run_until_complete(client._session_start()) assert len(called) == 1 finally: asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_client_session_start_keepalive_sets_ready_event( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover non-oneshot path in _session_start().""" install_fake_slixmpp(monkeypatch) client_cls = xmpp_adapter._get_client_subclass(FakeClientXMPP) loop = asyncio.new_event_loop() asyncio.set_event_loop(loop) try: evt = asyncio.Event() client = client_cls( jid="user@example.com", password="pass", oneshot=False, targets=["a", "b"], subject="s", body="b", before_message=lambda: None, want_roster=False, roster_timeout=0.0, session_started_evt=evt, ) monkeypatch.setattr( client, "send_message", lambda **k: (_ for _ in ()).throw(AssertionError()), raising=True, ) monkeypatch.setattr( client, "disconnect", lambda: (_ for _ in ()).throw(AssertionError()), raising=True, ) loop.run_until_complete(client._session_start()) assert evt.is_set() is True finally: asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_client_session_start_oneshot_sends_and_disconnects( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover oneshot path in _session_start() and finally disconnect.""" install_fake_slixmpp(monkeypatch) client_cls = xmpp_adapter._get_client_subclass(FakeClientXMPP) sent: list[dict[str, Any]] = [] before: list[int] = [] disconnected: list[bool] = [] def _before() -> None: before.append(1) def _send_message(**kwargs: Any) -> None: sent.append(kwargs) def _disconnect() -> None: disconnected.append(True) loop = asyncio.new_event_loop() asyncio.set_event_loop(loop) try: client = client_cls( jid="user@example.com", password="pass", oneshot=True, targets=[("chat", "a@example.com"), ("chat", "b@example.com")], subject="sub", body="body", before_message=_before, want_roster=False, roster_timeout=0.0, session_started_evt=None, ) monkeypatch.setattr( client, "send_message", _send_message, raising=True ) monkeypatch.setattr(client, "disconnect", _disconnect, raising=True) loop.run_until_complete(client._session_start()) assert len(before) == 2 assert len(sent) == 2 assert all(msg.get("mtype") == "chat" for msg in sent) assert disconnected == [True] finally: asyncio.set_event_loop(None) loop.close() def test_adapter_keepalive_runner_failed_handlers( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Cover keepalive _Client._failed_auth() and _disconnected(). """ install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True, roster=False, ) real_new_event_loop = xmpp_adapter.asyncio.new_event_loop def new_event_loop_wrapped() -> asyncio.AbstractEventLoop: loop = real_new_event_loop() def run_forever_hook() -> None: client = a._client started = a._session_started assert client is not None assert started is not None disconnected = {"called": 0} def disconnect_spy() -> None: disconnected["called"] += 1 monkeypatch.setattr( client, "disconnect", disconnect_spy, raising=True ) # Mark started True, then failed_auth must clear + disconnect started.set() client._failed_auth() assert started.is_set() is False assert disconnected["called"] == 1 # Mark started True again, disconnected must clear, no disconnect # call started.set() client._disconnected() assert started.is_set() is False assert disconnected["called"] == 1 return None monkeypatch.setattr( loop, "run_forever", run_forever_hook, raising=True ) return loop monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", new_event_loop_wrapped, raising=True, ) a._keepalive_runner() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_keepalive_runner_rejects_secure_mode( monkeypatch: pytest.MonkeyPatch, ) -> None: """The keepalive runner handles an unsupported secure mode.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure="definitely-not-supported", verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) # Ensure clean initial state a._loop_ready.clear() # Patch run_forever to be safe if it ever reaches it (it should not) real_new_event_loop = xmpp_adapter.asyncio.new_event_loop def new_event_loop_wrapped() -> asyncio.AbstractEventLoop: loop = real_new_event_loop() monkeypatch.setattr(loop, "run_forever", lambda: None, raising=True) return loop monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", new_event_loop_wrapped, raising=True, ) a._keepalive_runner() # Since secure mode invalid, it should not publish loop/client state assert a._loop_ready.is_set() is False assert a._loop is None assert a._client is None assert a._connect_lock is None assert a._session_started is None @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_keepalive_session_start_try_finally_and_roster( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Cover _session_start() try/finally and roster handling: - try/finally always sets _session_started_evt - roster path is taken and roster errors are suppressed - send_presence exception still leads to finally:set() """ install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True, roster=True, timeout=5.0, ) real_new_event_loop = xmpp_adapter.asyncio.new_event_loop def new_event_loop_wrapped() -> asyncio.AbstractEventLoop: loop = real_new_event_loop() def run_forever_hook() -> None: client = a._client evt = a._session_started assert client is not None assert evt is not None # Case 1: roster enabled, get_roster raises but suppressed def send_presence_ok() -> None: return None async def get_roster_boom() -> None: raise RuntimeError("boom-roster") monkeypatch.setattr( client, "send_presence", send_presence_ok, raising=True ) monkeypatch.setattr( client, "get_roster", get_roster_boom, raising=True ) evt.clear() client._on_session_start() # Drive the loop without creating extra coroutine objects for _ in range(10): fut = loop.create_future() loop.call_soon(fut.set_result, None) loop.run_until_complete(fut) if evt.is_set(): break xmpp_adapter.SlixmppAdapter._finalize_loop(loop) assert evt.is_set() is True # Case 2: send_presence raises, finally must still set def send_presence_boom() -> None: raise RuntimeError("boom-presence") monkeypatch.setattr( client, "send_presence", send_presence_boom, raising=True ) evt.clear() client._on_session_start() # Drive the loop without creating extra coroutine objects for _ in range(10): fut = loop.create_future() loop.call_soon(fut.set_result, None) loop.run_until_complete(fut) if evt.is_set(): break xmpp_adapter.SlixmppAdapter._finalize_loop(loop) assert evt.is_set() is True return None monkeypatch.setattr( loop, "run_forever", run_forever_hook, raising=True ) return loop monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", new_event_loop_wrapped, raising=True, ) a._keepalive_runner() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_keepalive_runner_plaintext_mode_skips_ssl_context( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Cover adapter.py - ensuring enable_plaintext=True, so 'if not client.enable_plaintext' is False and ssl_context is not set. """ install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.NONE, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True, timeout=5.0, ) real_new_event_loop = xmpp_adapter.asyncio.new_event_loop def new_event_loop_wrapped() -> asyncio.AbstractEventLoop: loop = real_new_event_loop() def run_forever_hook() -> None: # At this point the client has been created and configured. assert a._client is not None # In plaintext mode we expect ssl_context not to be forced by # adapter. assert getattr(a._client, "enable_plaintext", None) is True assert getattr(a._client, "ssl_context", None) is None return None monkeypatch.setattr( loop, "run_forever", run_forever_hook, raising=True ) return loop monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", new_event_loop_wrapped, raising=True, ) a._keepalive_runner() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_keepalive_runner_finally_loop_none( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Cover adapter.py when loop is None (new_event_loop fails), so both 'if loop is not None' conditions are False. """ install_fake_slixmpp(monkeypatch) monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", lambda: (_ for _ in ()).throw(RuntimeError("boom")), raising=True, ) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) # Should not raise, finally must handle loop=None a._keepalive_runner() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_runner_suppresses_cleanup_errors( monkeypatch: pytest.MonkeyPatch, ) -> None: """Ensure event-loop cleanup errors do not escape the runner.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="ex.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True, roster=True, timeout=5.0, ) real_new_event_loop = xmpp_adapter.asyncio.new_event_loop def new_event_loop_wrapped() -> asyncio.AbstractEventLoop: loop = real_new_event_loop() # Force finally path with a raised exception from run_forever def run_forever_boom() -> None: raise RuntimeError("boom-forever") monkeypatch.setattr( loop, "run_forever", run_forever_boom, raising=True ) # Raise after real cleanup so the event loop does not leak resources. real_stop = loop.stop real_close = loop.close def stop_boom() -> None: real_stop() raise RuntimeError("boom-stop") def close_boom() -> None: real_close() raise RuntimeError("boom-close") monkeypatch.setattr(loop, "stop", stop_boom, raising=True) monkeypatch.setattr(loop, "close", close_boom, raising=True) return loop monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", new_event_loop_wrapped, raising=True, ) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) # Should not raise, stop/close exceptions must be suppressed a._keepalive_runner() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_send_keepalive_async_returns_false_when_client_none( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover adapter.py _client is None -> return False.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True, ) a._client = None loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) result = loop.run_until_complete( a._send_keepalive_async(["t"], "s", "b") ) assert result is False finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) # Safe shutdown of asyncgens if not loop.is_closed(): with contextlib.suppress(Exception): ag_coro = loop.shutdown_asyncgens() try: loop.run_until_complete(ag_coro) except Exception: # Reuse the helper from the adapter module if available, # or do a manual close if hasattr(ag_coro, "close"): ag_coro.close() # Ensure close() is called even if the block above had issues with contextlib.suppress(Exception): loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_keepalive_error_suppresses_close_failure( monkeypatch: pytest.MonkeyPatch, ) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[], subject="s", body="b", timeout=5.0, keepalive=True, ) monkeypatch.setattr( a, "_ensure_keepalive_worker", lambda: True, raising=True ) class _Loop: def call_soon_threadsafe(self, cb: Any, *args: Any) -> None: cb(*args) a._loop = _Loop() class _BadCoro: def close(self) -> None: raise RuntimeError("close-failed") monkeypatch.setattr( a, "_send_keepalive_async", lambda **kwargs: _BadCoro(), raising=True ) def run_coroutine_threadsafe_raises(coro: Any, loop: Any) -> Any: raise RuntimeError("schedule-failed") monkeypatch.setattr( xmpp_adapter.asyncio, "run_coroutine_threadsafe", run_coroutine_threadsafe_raises, raising=True, ) assert a.send_message(targets=[], subject="s", body="b") is False def test_adapter_keepalive_failure_keeps_default_params( monkeypatch: pytest.MonkeyPatch, ) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.NONE, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "orig@example.com")], subject="orig-subj", body="orig-body", keepalive=False, ) called = {"process": 0} def process() -> bool: called["process"] += 1 return True monkeypatch.setattr(a, "process", process, raising=True) assert a.send_message() is True assert called["process"] == 1 assert a.targets == [("chat", "orig@example.com")] assert a.subject == "orig-subj" assert a.body == "orig-body" @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_send_message_keepalive_worker_failure_returns_false( monkeypatch: pytest.MonkeyPatch, ) -> None: install_fake_slixmpp(monkeypatch) config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", keepalive=True, ) monkeypatch.setattr( a, "_ensure_keepalive_worker", lambda: False, raising=True ) assert a.send_message() is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_keepalive_timeout_without_session_event( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture, ) -> None: install_fake_slixmpp(monkeypatch) # See test_xmpp_invalid_targets_logged for why this is needed: older # pytest releases don't un-suppress a prior logging.disable(CRITICAL) # left by another test module's import-time call. logging.disable(logging.NOTSET) caplog.set_level(logging.WARNING, logger="apprise.xmpp") try: config = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=config, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=5.0, keepalive=True, ) monkeypatch.setattr( a, "_ensure_keepalive_worker", lambda: True, raising=True ) class _Loop: def call_soon_threadsafe(self, cb: Any, *args: Any) -> None: raise AssertionError( "should not be called when _session_started is None" ) a._loop = _Loop() a._session_started = None # key for branch coverage class _FutureTimeout: def result(self, timeout: Optional[float] = None) -> Any: raise xmpp_adapter.FuturesTimeoutError() def run_coroutine_threadsafe_timeout(coro: Any, loop: Any) -> Any: # Close coroutine to avoid RuntimeWarning with contextlib.suppress(Exception): coro.close() return _FutureTimeout() monkeypatch.setattr( xmpp_adapter.asyncio, "run_coroutine_threadsafe", run_coroutine_threadsafe_timeout, raising=True, ) assert a.send_message() is False assert "XMPP keepalive send timed out" in caplog.text finally: logging.disable(logging.CRITICAL) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_client_session_start_keepalive_evt_none_no_set( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover _session_start() when session event is None.""" install_fake_slixmpp(monkeypatch) client_cls = xmpp_adapter._get_client_subclass(FakeClientXMPP) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) client = client_cls( jid="user@example.com", password="pass", oneshot=False, targets=[], subject="s", body="b", before_message=None, want_roster=False, roster_timeout=0.0, session_started_evt=None, ) loop.run_until_complete(client._session_start()) finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_general_function( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture, ) -> None: install_fake_slixmpp(monkeypatch) def _close(): raise Exception("boom") arg = {"close": _close} # does nothing xmpp_adapter._close_awaitable(None) xmpp_adapter._close_awaitable(arg) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_client_on_session_start_create_task_failure_closes_coro( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover loop.create_task() failure that closes the awaitable.""" install_fake_slixmpp(monkeypatch) client_cls = xmpp_adapter._get_client_subclass(FakeClientXMPP) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) client = client_cls( jid="user@example.com", password="pass", oneshot=False, targets=[], subject="s", body="b", before_message=None, want_roster=False, roster_timeout=0.0, session_started_evt=asyncio.Event(), ) class _FakeCoro: def __init__(self) -> None: self.closed = False def close(self) -> None: self.closed = True fake_coro = _FakeCoro() def _session_start(*args: object, **kwargs: object) -> _FakeCoro: return fake_coro monkeypatch.setattr( client, "_session_start", _session_start, raising=True ) class _FakeLoop: def is_running(self) -> bool: return True def create_task(self, coro: object) -> object: raise RuntimeError("boom") client.loop = _FakeLoop() # type: ignore[assignment] client._on_session_start() assert fake_coro.closed is True finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_client_disconnected_evt_none_no_clear( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover _disconnected() branch where session event is None.""" install_fake_slixmpp(monkeypatch) client_cls = xmpp_adapter._get_client_subclass(FakeClientXMPP) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) client = client_cls( jid="user@example.com", password="pass", oneshot=False, targets=[], subject="s", body="b", before_message=None, want_roster=False, roster_timeout=0.0, session_started_evt=None, ) client._disconnected() finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_send_message_keepalive_loop_none_returns_false( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover send_message(): loop is None -> return False.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[("chat", "t@example.com")], subject="s", body="b", keepalive=True, ) monkeypatch.setattr( a, "_ensure_keepalive_worker", lambda: True, raising=True ) a._loop = None assert a.send_message() is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_send_message_keepalive_exception_returns_false( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover send_message(): exception path returns False.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[("chat", "t@example.com")], subject="s", body="b", timeout=5.0, keepalive=True, ) monkeypatch.setattr( a, "_ensure_keepalive_worker", lambda: True, raising=True ) class _Loop: pass a._loop = _Loop() def run_coroutine_threadsafe_boom(coro: Any, loop: Any) -> Any: with contextlib.suppress(Exception): coro.close() raise RuntimeError("boom") monkeypatch.setattr( xmpp_adapter.asyncio, "run_coroutine_threadsafe", run_coroutine_threadsafe_boom, raising=True, ) assert a.send_message() is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_send_keepalive_async_auth_failed_returns_false( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover _send_keepalive_async(): auth_failed -> return False.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True, ) class _Client: _auth_failed = True def send_message(self, **kwargs: Any) -> None: raise AssertionError("send must not occur") a._client = _Client() async def ok_connect() -> bool: return True monkeypatch.setattr(a, "_connect_if_required", ok_connect, raising=True) assert ( asyncio.run(a._send_keepalive_async(["t@example.com"], "s", "b")) is False ) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_connect_if_required_auth_failed_returns_false( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover _connect_if_required(): auth_failed -> return False.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) a._loop = loop a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() class _Client: _auth_failed = True a._client = _Client() assert run_on_loop(loop, a._connect_if_required()) is False finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_connect_if_required_connect_ok_false_disconnects( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture, ) -> None: """Cover _connect_if_required(): connect_ok False path.""" install_fake_slixmpp(monkeypatch) # See test_xmpp_invalid_targets_logged for why this is needed: older # pytest releases don't un-suppress a prior logging.disable(CRITICAL) # left by another test module's import-time call. logging.disable(logging.NOTSET) caplog.set_level(logging.WARNING, logger="apprise.xmpp") cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) a._loop = loop a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() disconnected = {"n": 0} class _Client: def connect(self, **kwargs: Any) -> Any: fut = loop.create_future() fut.set_result(False) return fut def disconnect(self) -> None: disconnected["n"] += 1 a._client = _Client() assert run_on_loop(loop, a._connect_if_required()) is False assert disconnected["n"] == 1 assert "XMPP connect failed" in caplog.text finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() logging.disable(logging.CRITICAL) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_connect_if_required_session_wait_exception_closes( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover _connect_if_required(): session_wait Exception path.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) a._loop = loop a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() fut = loop.create_future() fut.set_result(True) class _Client: def connect(self, **kwargs: Any) -> Any: return fut a._client = _Client() called: list[object] = [] real_close = xmpp_adapter._close_awaitable def close_spy(obj: object) -> None: called.append(obj) real_close(obj) monkeypatch.setattr( xmpp_adapter, "_close_awaitable", close_spy, raising=True ) real_wait_for = xmpp_adapter.asyncio.wait_for calls = {"n": 0} async def wait_for_patched( aw: Any, timeout: Optional[float] = None ) -> Any: calls["n"] += 1 if calls["n"] == 2: raise RuntimeError("boom") return await real_wait_for(aw, timeout=timeout) monkeypatch.setattr( xmpp_adapter.asyncio, "wait_for", wait_for_patched, raising=True ) assert run_on_loop(loop, a._connect_if_required()) is False assert len(called) == 1 finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_client_on_session_start_add_done_callback_executes( monkeypatch: pytest.MonkeyPatch, ) -> None: """ Cover adapter.py _on_session_start() keepalive path where we create a task and attach a done callback that calls t.exception() when not cancelled. This test avoids patching asyncio.Task (immutable on newer Pythons) by using a fake loop and fake task object. """ install_fake_slixmpp(monkeypatch) client_cls = xmpp_adapter._get_client_subclass(FakeClientXMPP) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) evt = asyncio.Event() client = client_cls( jid="me@example.com", password="x", oneshot=False, targets=[], subject="s", body="b", before_message=None, want_roster=False, roster_timeout=0.0, session_started_evt=evt, ) class _FakeTask: def __init__(self) -> None: self.exception_called = False self.callback_called = False def add_done_callback(self, cb: Any) -> None: self.callback_called = True cb(self) def cancelled(self) -> bool: return False def exception(self) -> None: self.exception_called = True return None class _FakeLoop: def __init__(self) -> None: self.task = _FakeTask() self.create_task_called = False def is_running(self) -> bool: return True def create_task(self, coro: Any) -> _FakeTask: self.create_task_called = True return self.task fake_loop = _FakeLoop() client.loop = fake_loop # type: ignore[assignment] class _FakeCoro: def close(self) -> None: return None def _session_start(*args: object, **kwargs: object) -> _FakeCoro: return _FakeCoro() monkeypatch.setattr( client, "_session_start", _session_start, raising=True ) client._on_session_start() assert fake_loop.create_task_called is True assert fake_loop.task.callback_called is True assert fake_loop.task.exception_called is True finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) with contextlib.suppress(Exception): loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_client_on_session_start_done_callback_cancelled_returns( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover _log_task() early return when task is cancelled.""" install_fake_slixmpp(monkeypatch) client_cls = xmpp_adapter._get_client_subclass(FakeClientXMPP) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) evt = asyncio.Event() client = client_cls( jid="me@example.com", password="x", oneshot=False, targets=[], subject="s", body="b", before_message=None, want_roster=False, roster_timeout=0.0, session_started_evt=evt, ) errors: list[str] = [] class _Logger: def error(self, msg: str, *args: Any) -> None: errors.append(msg % args if args else msg) client.logger = _Logger() # type: ignore[assignment] class _FakeTask: def __init__(self) -> None: self.exception_called = False def add_done_callback(self, cb: Any) -> None: cb(self) def cancelled(self) -> bool: return True def exception(self) -> None: self.exception_called = True return RuntimeError("should-not-be-read") class _FakeLoop: def is_running(self) -> bool: return True def create_task(self, coro: Any) -> _FakeTask: return _FakeTask() client.loop = _FakeLoop() # type: ignore[assignment] class _FakeCoro: def close(self) -> None: return None monkeypatch.setattr( client, "_session_start", lambda *_a, **_k: _FakeCoro(), raising=True, ) client._on_session_start() assert errors == [] finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) with contextlib.suppress(Exception): loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_client_on_session_start_done_callback_logs_exception( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover _log_task() error log when task.exception() is not None.""" install_fake_slixmpp(monkeypatch) client_cls = xmpp_adapter._get_client_subclass(FakeClientXMPP) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) evt = asyncio.Event() client = client_cls( jid="me@example.com", password="x", oneshot=False, targets=[], subject="s", body="b", before_message=None, want_roster=False, roster_timeout=0.0, session_started_evt=evt, ) errors: list[str] = [] class _Logger: def error(self, msg: str, *args: Any) -> None: errors.append(msg % args if args else msg) client.logger = _Logger() # type: ignore[assignment] class _FakeTask: def add_done_callback(self, cb: Any) -> None: cb(self) def cancelled(self) -> bool: return False def exception(self) -> Exception: return RuntimeError("boom-task") class _FakeLoop: def is_running(self) -> bool: return True def create_task(self, coro: Any) -> _FakeTask: return _FakeTask() client.loop = _FakeLoop() # type: ignore[assignment] class _FakeCoro: def close(self) -> None: return None monkeypatch.setattr( client, "_session_start", lambda *_a, **_k: _FakeCoro(), raising=True, ) client._on_session_start() assert len(errors) == 1 assert "XMPP task failed" in errors[0] finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) with contextlib.suppress(Exception): loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_muc_url_parsing_and_reconstruction() -> None: """MUC targets parse from '#room@conf.host' and round-trip via url().""" n = NotifyXMPP( host="example.com", user="me", password="secret", targets=["#room@conference.example.com", "user@example.com"], ) # MUC target becomes groupchat, regular becomes chat assert ("groupchat", "room@conference.example.com") in n.targets assert ("chat", "user@example.com") in n.targets assert n.want_muc is True # url() encodes MUC '#' as %23 to avoid URL fragment misparse u = n.url() assert "%23room%40conference.example.com" in u # Verify round-trip: parse_url -> NotifyXMPP reconstructs same targets results = NotifyXMPP.parse_url(u) assert results is not None n2 = NotifyXMPP(**results) assert ("groupchat", "room@conference.example.com") in n2.targets assert ("chat", "user@example.com") in n2.targets assert n2.want_muc is True @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_name_parameter() -> None: """name= is stored, emitted in url(), and round-trips via parse_url().""" # Valid name: stored as-is and emitted in the URL n = NotifyXMPP( host="example.com", user="me", password="secret", name="my_bot", ) assert n.name == "my_bot" u = n.url() assert "name=my_bot" in u # Round-trip through parse_url results = NotifyXMPP.parse_url(u) assert results is not None assert results.get("name") == "my_bot" n2 = NotifyXMPP(**results) assert n2.name == "my_bot" # Invalid name falls back to user (then app_id if no user) n3 = NotifyXMPP( host="example.com", user="me", password="secret", name="bad name!", ) assert n3.name == n3.user # No name provided -> defaults to user (then app_id if no user); # not emitted in URL n4 = NotifyXMPP( host="example.com", user="me", password="secret", ) assert n4.name == n4.user assert "name=" not in n4.url() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_muc_only_no_regular_targets() -> None: """NotifyXMPP with only MUC targets sets want_muc=True.""" n = NotifyXMPP( host="example.com", user="me", password="secret", targets=["#general@conference.example.com"], ) assert n.want_muc is True assert len(n.targets) == 1 assert n.targets[0] == ("groupchat", "general@conference.example.com") @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_client_session_start_oneshot_muc_join( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover join_muc() in _session_start() for oneshot groupchat target.""" install_fake_slixmpp(monkeypatch) client_cls = xmpp_adapter._get_client_subclass(FakeClientXMPP) sent: list[dict[str, Any]] = [] join_calls: list[tuple[str, str]] = [] async def fake_join_muc(room: str, nick: str) -> None: join_calls.append((room, nick)) class FakeMucPlugin: def join_muc(self, room: str, nick: str, **kw: Any) -> Any: return fake_join_muc(room, nick) loop = asyncio.new_event_loop() asyncio.set_event_loop(loop) try: client = client_cls( jid="me@example.com", password="pass", oneshot=True, targets=[("groupchat", "room@conference.example.com")], subject="s", body="b", want_muc=True, want_roster=False, roster_timeout=0.0, session_started_evt=None, ) # Inject fake xep_0045 plugin and boundjid (not on FakeClientXMPP) class _BoundJID: user = "me" monkeypatch.setattr(client, "boundjid", _BoundJID(), raising=False) monkeypatch.setattr( client, "plugin", {"xep_0045": FakeMucPlugin()}, raising=False ) monkeypatch.setattr( client, "send_message", lambda **kw: sent.append(kw), raising=True ) monkeypatch.setattr(client, "disconnect", lambda: None, raising=True) loop.run_until_complete(client._session_start()) assert len(join_calls) == 1 assert join_calls[0][0] == "room@conference.example.com" assert join_calls[0][1] == "me" assert len(sent) == 1 assert sent[0]["mtype"] == "groupchat" finally: asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_client_session_start_oneshot_muc_join_error( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover join_muc() error path: exception is caught, send still happens.""" install_fake_slixmpp(monkeypatch) client_cls = xmpp_adapter._get_client_subclass(FakeClientXMPP) sent: list[dict[str, Any]] = [] async def join_muc_fail(room: str, nick: str) -> None: raise asyncio.TimeoutError() # simulate timeout class FakeMucPlugin: def join_muc(self, room: str, nick: str, **kw: Any) -> Any: return join_muc_fail(room, nick) loop = asyncio.new_event_loop() asyncio.set_event_loop(loop) try: client = client_cls( jid="me@example.com", password="pass", oneshot=True, targets=[("groupchat", "room@conference.example.com")], subject="s", body="b", want_muc=True, want_roster=False, roster_timeout=0.0, session_started_evt=None, ) class _BoundJID: user = "me" monkeypatch.setattr(client, "boundjid", _BoundJID(), raising=False) monkeypatch.setattr( client, "plugin", {"xep_0045": FakeMucPlugin()}, raising=False ) monkeypatch.setattr( client, "send_message", lambda **kw: sent.append(kw), raising=True ) monkeypatch.setattr(client, "disconnect", lambda: None, raising=True) loop.run_until_complete(client._session_start()) # Message is still sent even when MUC join errors assert len(sent) == 1 assert sent[0]["mtype"] == "groupchat" finally: asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_send_keepalive_async_muc_join( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover join_muc() in _send_keepalive_async() for groupchat target.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[("groupchat", "room@conference.example.com")], subject="s", body="b", keepalive=True, want_muc=True, ) join_calls: list[tuple[str, str]] = [] sent: list[dict[str, Any]] = [] async def fake_join_muc(room: str, nick: str) -> None: join_calls.append((room, nick)) class FakeBoundJID: user = "me" class FakeMucPlugin: def join_muc(self, room: str, nick: str, **kw: Any) -> Any: return fake_join_muc(room, nick) class _Client: _auth_failed = False boundjid = FakeBoundJID() plugin = {"xep_0045": FakeMucPlugin()} def send_message(self, **kwargs: Any) -> None: sent.append(kwargs) a._client = _Client() async def ok_connect() -> bool: return True monkeypatch.setattr(a, "_connect_if_required", ok_connect, raising=True) result = asyncio.run( a._send_keepalive_async( targets=[("groupchat", "room@conference.example.com")], subject="s", body="b", ) ) assert result is True assert len(join_calls) == 1 assert join_calls[0][0] == "room@conference.example.com" # boundjid.user == "me" -> nick must be taken from boundjid, not nickname assert join_calls[0][1] == "me" assert len(sent) == 1 assert sent[0]["mtype"] == "groupchat" @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_send_keepalive_async_muc_join_nick_fallback( monkeypatch: pytest.MonkeyPatch, ) -> None: """When boundjid.user is empty, nick falls back to adapter nickname.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[("groupchat", "room@conference.example.com")], subject="s", body="b", keepalive=True, want_muc=True, default_nickname="mybot", ) join_calls: list[tuple[str, str]] = [] sent: list[dict[str, Any]] = [] async def fake_join_muc(room: str, nick: str) -> None: join_calls.append((room, nick)) class FakeBoundJID: user = "" # empty -> should fall back to nickname class FakeMucPlugin: def join_muc(self, room: str, nick: str, **kw: Any) -> Any: return fake_join_muc(room, nick) class _Client: _auth_failed = False boundjid = FakeBoundJID() plugin = {"xep_0045": FakeMucPlugin()} def send_message(self, **kwargs: Any) -> None: sent.append(kwargs) a._client = _Client() async def ok_connect() -> bool: return True monkeypatch.setattr(a, "_connect_if_required", ok_connect, raising=True) result = asyncio.run( a._send_keepalive_async( targets=[("groupchat", "room@conference.example.com")], subject="s", body="b", ) ) assert result is True assert len(join_calls) == 1 assert join_calls[0][0] == "room@conference.example.com" # boundjid.user is empty -> nick must fall back to adapter's nickname assert join_calls[0][1] == "mybot" assert len(sent) == 1 assert sent[0]["mtype"] == "groupchat" @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_adapter_keepalive_runner_registers_xep_0045_when_want_muc( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover _keepalive_runner(): register_plugin('xep_0045') for want_muc.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[("groupchat", "room@conference.example.com")], subject="s", body="b", keepalive=True, want_muc=True, ) registered: list[str] = [] real_new_event_loop = xmpp_adapter.asyncio.new_event_loop def new_event_loop_wrapped() -> asyncio.AbstractEventLoop: loop = real_new_event_loop() def run_forever_hook() -> None: client = a._client assert client is not None # Capture what was registered and then stop registered.extend(client.registered_plugins.keys()) monkeypatch.setattr( loop, "run_forever", run_forever_hook, raising=True ) return loop monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", new_event_loop_wrapped, raising=True, ) a._keepalive_runner() assert "xep_0045" in registered @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_send_keepalive_async_muc_join_error( monkeypatch: pytest.MonkeyPatch, ) -> None: """Cover join_muc() exception path in _send_keepalive_async().""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[("groupchat", "room@conference.example.com")], subject="s", body="b", keepalive=True, want_muc=True, ) sent: list[dict[str, Any]] = [] async def join_muc_fail(room: str, nick: str) -> None: raise asyncio.TimeoutError() # simulate timeout -> exception path class FakeBoundJID: user = "me" class FakeMucPlugin: def join_muc(self, room: str, nick: str, **kw: Any) -> Any: return join_muc_fail(room, nick) class _Client: _auth_failed = False boundjid = FakeBoundJID() plugin = {"xep_0045": FakeMucPlugin()} def send_message(self, **kwargs: Any) -> None: sent.append(kwargs) a._client = _Client() async def ok_connect() -> bool: return True monkeypatch.setattr(a, "_connect_if_required", ok_connect, raising=True) result = asyncio.run( a._send_keepalive_async( targets=[("groupchat", "room@conference.example.com")], subject="s", body="b", ) ) # Exception from join_muc is caught; message is still sent assert result is True assert len(sent) == 1 assert sent[0]["mtype"] == "groupchat" @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_client_logger_presence_regression(monkeypatch): """ Regression test: Verify that the internal _Client class automatically receives a 'logger' attribute so _log_task does not AttributeError. """ install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="ex.com", port=5222 ) # Test standard adapter initialization adapter = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b" ) # Use the same factory the adapter uses to create a client client = xmpp_adapter._build_client( jid="me@example.com", password="x", oneshot=True, logger=adapter.logger ) # This was the point of failure: self.logger must exist assert hasattr(client, "logger") assert client.logger == adapter.logger @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_log_task_crash_regression(monkeypatch): """ Regression test: Verify that _log_task can handle an exception without crashing on a missing logger attribute. """ install_fake_slixmpp(monkeypatch) # Create a client using the production factory client_cls = xmpp_adapter._get_client_subclass(FakeClientXMPP) client = client_cls( jid="user@example.com", password="pass", oneshot=False, # Provide Logger logger=logging.getLogger("apprise"), ) # Simulate a task failure class MockTask: def cancelled(self): return False def exception(self): return RuntimeError("Simulated XMPP Failure") # Manually trigger the callback logic client.handlers.get("session_start") # Triggers _log_task client._on_session_start() # --------------------------------------------------------------------------- # SCRAM-PLUS / Channel Binding Tests # --------------------------------------------------------------------------- @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_scramplus_default_true() -> None: """scramplus defaults to True (SCRAM-PLUS enabled).""" n = NotifyXMPP(host="example.com", user="me@example.com", password="x") assert n.scramplus is True @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_scramplus_explicit_false() -> None: """scramplus=False is stored and reflected in url().""" n = NotifyXMPP( host="example.com", user="me@example.com", password="x", scramplus=False, ) assert n.scramplus is False u = n.url() assert "scramplus=no" in u @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_scramplus_url_round_trip() -> None: """scramplus round-trips through url() and parse_url().""" n = NotifyXMPP( host="example.com", user="me@example.com", password="secret", scramplus=False, ) u = n.url() r = NotifyXMPP.parse_url(u) assert r is not None assert r["scramplus"] is False n2 = NotifyXMPP(**r) assert n2.scramplus is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_scramplus_parse_url_no() -> None: """?scramplus=no is parsed and stored correctly.""" r = NotifyXMPP.parse_url( "xmpps://me:pass@example.com/a@example.com?scramplus=no" ) assert r is not None assert r["scramplus"] is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_scramplus_parse_url_yes() -> None: """?scramplus=yes is parsed and stored correctly.""" r = NotifyXMPP.parse_url( "xmpps://me:pass@example.com/a@example.com?scramplus=yes" ) assert r is not None assert r["scramplus"] is True @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_scramplus_passes_to_config( monkeypatch: pytest.MonkeyPatch, ) -> None: """scramplus=False propagates use_channel_binding=False to XMPPConfig.""" captured: dict = {} class _Adapter: def __init__(self, config: Any, **kwargs: Any) -> None: captured["use_channel_binding"] = config.use_channel_binding def process(self) -> bool: return True monkeypatch.setattr(xmpp_base, "SlixmppAdapter", _Adapter, raising=True) apobj = Apprise() apobj.add("xmpps://user:pass@example.com/joe?scramplus=no") apobj.notify("hello") assert captured["use_channel_binding"] is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_scramplus_true_passes_to_config( monkeypatch: pytest.MonkeyPatch, ) -> None: """Default scramplus=True propagates use_channel_binding=True.""" captured: dict = {} class _Adapter: def __init__(self, config: Any, **kwargs: Any) -> None: captured["use_channel_binding"] = config.use_channel_binding def process(self) -> bool: return True monkeypatch.setattr(xmpp_base, "SlixmppAdapter", _Adapter, raising=True) apobj = Apprise() apobj.add("xmpps://user:pass@example.com/joe") apobj.notify("hello") assert captured["use_channel_binding"] is True @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_disable_channel_binding_filters_plus_mechs() -> None: """_disable_channel_binding patches _send_auth to strip -PLUS mechs.""" from types import SimpleNamespace captured: list[set] = [] plugin = SimpleNamespace( mech_list={"SCRAM-SHA-256-PLUS", "SCRAM-SHA-256", "SCRAM-SHA-1"}, ) def orig_send_auth() -> None: captured.append(set(plugin.mech_list)) plugin._send_auth = orig_send_auth class _Client: def __getitem__(self, key: str) -> Any: if key == "feature_mechanisms": return plugin raise KeyError(key) xmpp_adapter._disable_channel_binding(_Client()) # Trigger the patched _send_auth plugin._send_auth() assert len(captured) == 1 assert "SCRAM-SHA-256-PLUS" not in captured[0] assert "SCRAM-SHA-256" in captured[0] assert "SCRAM-SHA-1" in captured[0] @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_disable_channel_binding_safe_when_no_plugin() -> None: """_disable_channel_binding no-ops when feature_mechanisms is absent.""" class _BadClient: def __getitem__(self, key: str) -> Any: raise KeyError(key) # Must not raise xmpp_adapter._disable_channel_binding(_BadClient()) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_scramplus_disabled_process( monkeypatch: pytest.MonkeyPatch, ) -> None: """process() calls _disable_channel_binding when binding disabled.""" install_fake_slixmpp(monkeypatch) patched: list[bool] = [] orig_disable = xmpp_adapter._disable_channel_binding def spy_disable(client: Any) -> None: patched.append(True) orig_disable(client) monkeypatch.setattr( xmpp_adapter, "_disable_channel_binding", spy_disable, raising=True ) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, use_channel_binding=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=1.0, ) assert a.process() is True assert len(patched) == 1 @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_scramplus_enabled_no_patch( monkeypatch: pytest.MonkeyPatch, ) -> None: """process() skips _disable_channel_binding when binding enabled.""" install_fake_slixmpp(monkeypatch) patched: list[bool] = [] orig_disable = xmpp_adapter._disable_channel_binding def spy_disable(client: Any) -> None: patched.append(True) orig_disable(client) monkeypatch.setattr( xmpp_adapter, "_disable_channel_binding", spy_disable, raising=True ) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, use_channel_binding=True, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=1.0, ) assert a.process() is True # No patching when SCRAM-PLUS is enabled assert len(patched) == 0 @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_scramplus_disabled_keepalive_runner( monkeypatch: pytest.MonkeyPatch, ) -> None: """_keepalive_runner calls _disable_channel_binding when disabled.""" install_fake_slixmpp(monkeypatch) patched: list[bool] = [] orig_disable = xmpp_adapter._disable_channel_binding def spy_disable(client: Any) -> None: patched.append(True) orig_disable(client) monkeypatch.setattr( xmpp_adapter, "_disable_channel_binding", spy_disable, raising=True ) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, use_channel_binding=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[("chat", "a@example.com")], subject="s", body="b", timeout=1.0, keepalive=True, ) real_new_event_loop = xmpp_adapter.asyncio.new_event_loop def new_event_loop_wrapped() -> asyncio.AbstractEventLoop: loop = real_new_event_loop() def run_forever_hook() -> None: pass monkeypatch.setattr( loop, "run_forever", run_forever_hook, raising=True ) return loop monkeypatch.setattr( xmpp_adapter.asyncio, "new_event_loop", new_event_loop_wrapped, raising=True, ) a._keepalive_runner() assert len(patched) == 1 @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_failed_auth_stanza_sets_channel_binding_flag( monkeypatch: pytest.MonkeyPatch, ) -> None: """_failed_auth sets _channel_binding_failed when phrase detected.""" install_fake_slixmpp(monkeypatch) # Clear the subclass cache so we pick up the patched FakeClientXMPP. xmpp_adapter._CLIENT_SUBCLASS_CACHE.clear() # Build a _Client instance directly using the fake base class. _ClientCls = xmpp_adapter._get_client_subclass(FakeClientXMPP) client = _ClientCls( jid="me@example.com", password="x", oneshot=True, logger=logging.getLogger("test"), ) # Verify initial state. assert client._auth_failed is False assert client._channel_binding_failed is False # Simulate a failed_auth stanza containing the channel binding phrase. fake_stanza = ( "" "Invalid channel binding" ) client._failed_auth(fake_stanza) assert client._auth_failed is True assert client._channel_binding_failed is True @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_failed_auth_plain_does_not_set_channel_binding_flag( monkeypatch: pytest.MonkeyPatch, ) -> None: """_failed_auth skips _channel_binding_failed for plain auth failures.""" install_fake_slixmpp(monkeypatch) xmpp_adapter._CLIENT_SUBCLASS_CACHE.clear() _ClientCls = xmpp_adapter._get_client_subclass(FakeClientXMPP) client = _ClientCls( jid="me@example.com", password="x", oneshot=True, logger=logging.getLogger("test"), ) # Stanza does not mention channel binding. fake_stanza = "" client._failed_auth(fake_stanza) assert client._auth_failed is True assert client._channel_binding_failed is False @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_process_raises_channel_binding_error( monkeypatch: pytest.MonkeyPatch, ) -> None: """process() raises XMPPChannelBindingError when channel binding fails.""" install_fake_slixmpp(monkeypatch) xmpp_adapter._CLIENT_SUBCLASS_CACHE.clear() # Patch FakeClientXMPP.connect to fire failed_auth with a channel # binding stanza so the adapter detects the failure. orig_connect = FakeClientXMPP.connect def connect_cb_fail(self, **kwargs: Any) -> asyncio.Future[bool]: loop = self.loop or asyncio.get_running_loop() if self.disconnected is None: self.disconnected = loop.create_future() fut: asyncio.Future[bool] = loop.create_future() fut.set_result(True) def _fire_failed_auth() -> None: # Simulate slixmpp firing failed_auth with a channel binding # stanza before setting up session_start. failed_handler = self.handlers.get("failed_auth") if failed_handler: fake_stanza = ( "" "Invalid channel binding" ) failed_handler(fake_stanza) # Complete disconnect so the adapter loop unblocks. if self.disconnected is not None and not self.disconnected.done(): self.disconnected.set_result(True) loop.call_soon(_fire_failed_auth) return fut monkeypatch.setattr(FakeClientXMPP, "connect", connect_cb_fail) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[("chat", "joe@example.com")], subject="s", body="b", timeout=5.0, ) with pytest.raises(xmpp_adapter.XMPPChannelBindingError): a.process() monkeypatch.setattr(FakeClientXMPP, "connect", orig_connect) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_send_catches_channel_binding_error_and_logs( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture, ) -> None: """base.py send() catches XMPPChannelBindingError and logs the hint.""" class _RaisingAdapter: def __init__(self, **kwargs: Any) -> None: pass def process(self) -> bool: raise xmpp_adapter.XMPPChannelBindingError() monkeypatch.setattr(xmpp_base, "SlixmppAdapter", _RaisingAdapter) monkeypatch.setattr( xmpp_base, "SLIXMPP_SUPPORT_AVAILABLE", True, raising=False ) monkeypatch.setattr(xmpp_base.NotifyXMPP, "enabled", True, raising=False) n = NotifyXMPP(host="example.com", user="me", password="x") # See test_xmpp_invalid_targets_logged for why this is needed: older # pytest releases don't un-suppress a prior logging.disable(CRITICAL) # left by another test module's import-time call. logging.disable(logging.NOTSET) try: with caplog.at_level(logging.WARNING, logger="apprise"): result = n.send(body="hi") assert result is False assert "scramplus=no" in caplog.text finally: logging.disable(logging.CRITICAL) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_xmpp_send_channel_binding_error_scramplus_already_disabled( monkeypatch: pytest.MonkeyPatch, caplog: pytest.LogCaptureFixture, ) -> None: """No ?scramplus=no hint when scramplus is already False.""" class _RaisingAdapter: def __init__(self, **kwargs: Any) -> None: pass def process(self) -> bool: raise xmpp_adapter.XMPPChannelBindingError() monkeypatch.setattr(xmpp_base, "SlixmppAdapter", _RaisingAdapter) monkeypatch.setattr( xmpp_base, "SLIXMPP_SUPPORT_AVAILABLE", True, raising=False ) monkeypatch.setattr(xmpp_base.NotifyXMPP, "enabled", True, raising=False) # scramplus explicitly disabled -- the hint must NOT repeat the advice n = NotifyXMPP( host="example.com", user="me", password="x", scramplus=False ) # See test_xmpp_invalid_targets_logged for why this is needed: older # pytest releases don't un-suppress a prior logging.disable(CRITICAL) # left by another test module's import-time call. logging.disable(logging.NOTSET) try: with caplog.at_level(logging.WARNING, logger="apprise"): result = n.send(body="hi") assert result is False # The "Add ?scramplus=no" suggestion must not appear when already # set assert "Add ?scramplus=no" not in caplog.text # A compatibility-oriented message must appear instead assert "compatibility" in caplog.text finally: logging.disable(logging.CRITICAL) @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_connect_if_required_channel_binding_early_raises( monkeypatch: pytest.MonkeyPatch, ) -> None: """_connect_if_required() raises early when _channel_binding_failed.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) a._loop = loop # Client with channel binding already flagged before connect. a._client = SimpleNamespace( _channel_binding_failed=True, _auth_failed=False ) a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() with pytest.raises(xmpp_adapter.XMPPChannelBindingError): run_on_loop(loop, a._connect_if_required()) finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_connect_if_required_channel_binding_bottom_raises( monkeypatch: pytest.MonkeyPatch, ) -> None: """_connect_if_required() raises XMPPChannelBindingError check.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[], subject="s", body="b", keepalive=True ) loop = asyncio.new_event_loop() try: asyncio.set_event_loop(loop) a._loop = loop a._connect_lock = asyncio.Lock() a._session_started = asyncio.Event() fut = loop.create_future() fut.set_result(True) class _Client: def __init__(self) -> None: self._channel_binding_failed = False self._auth_failed = False def connect(self, **kwargs: Any) -> Any: return fut a._client = _Client() # Patch wait_for to set channel-binding flag after session wait. real_wait_for = xmpp_adapter.asyncio.wait_for calls: dict[str, int] = {"n": 0} async def wait_for_patched( aw: Any, timeout: Optional[float] = None ) -> Any: calls["n"] += 1 if calls["n"] == 2: assert a._session_started is not None a._session_started.set() assert isinstance(a._client, _Client) a._client._channel_binding_failed = True return await real_wait_for(aw, timeout=timeout) monkeypatch.setattr( xmpp_adapter.asyncio, "wait_for", wait_for_patched, raising=True ) with pytest.raises(xmpp_adapter.XMPPChannelBindingError): run_on_loop(loop, a._connect_if_required()) finally: with contextlib.suppress(Exception): asyncio.set_event_loop(None) loop.close() @pytest.mark.skipif(not SLIXMPP_AVAILABLE, reason="Requires slixmpp") def test_send_message_keepalive_reraises_channel_binding_error( monkeypatch: pytest.MonkeyPatch, ) -> None: """send_message() keepalive path re-raises XMPPChannelBindingError.""" install_fake_slixmpp(monkeypatch) cfg = xmpp_adapter.XMPPConfig( jid="me@example.com", password="x", host="example.com", port=5222, secure=xmpp_adapter.SecureXMPPMode.STARTTLS, verify_certificate=False, ) a = xmpp_adapter.SlixmppAdapter( config=cfg, targets=[("chat", "t@example.com")], subject="s", body="b", timeout=5.0, keepalive=True, ) monkeypatch.setattr( a, "_ensure_keepalive_worker", lambda: True, raising=True ) class _Loop: pass a._loop = _Loop() def run_coroutine_threadsafe_cb_fail(coro: Any, loop: Any) -> Any: # Close the coroutine to avoid RuntimeWarning about it not being run. with contextlib.suppress(Exception): coro.close() class _Fut: def result(self, timeout: Optional[float] = None) -> bool: raise xmpp_adapter.XMPPChannelBindingError() return _Fut() monkeypatch.setattr( xmpp_adapter.asyncio, "run_coroutine_threadsafe", run_coroutine_threadsafe_cb_fail, raising=True, ) with pytest.raises(xmpp_adapter.XMPPChannelBindingError): a.send_message() caronc-apprise-dfec414/tests/test_plugin_youlmk.py000066400000000000000000000431721526720371000225770ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from json import loads # Disable logging for a cleaner testing output import logging from unittest import mock from helpers import AppriseURLTester import pytest import requests from apprise import Apprise, AppriseAsset, NotifyType from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.youlmk import NotifyYouLMK, youlmk_priority logging.disable(logging.CRITICAL) # The handoff's placeholder key and a token of the same shape; neither is real TOKEN = "ylk_" + "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6" KEY = "k_7hq2nk3f9qd8w4" # Our Testing URLs apprise_url_tests = ( ( "youlmk://", { # No token specified "instance": AppriseImproperlyConfigured, }, ), ( "youlmk://invalid", { # Neither a ylk_ token nor a k_ key "instance": AppriseImproperlyConfigured, }, ), ( "youlmk://ylk_tooshort", { # The token's shape is ylk_ and 32 characters "instance": AppriseImproperlyConfigured, }, ), ( f"youlmk://{TOKEN}", { # A valid bearer token "instance": NotifyYouLMK, # Our expected url(privacy=True) startswith() response: "privacy_url": "youlmk://y...6/", }, ), ( f"youlmk://{KEY}", { # A valid URL key "instance": NotifyYouLMK, "privacy_url": "youlmk://k...4/", }, ), ( f"youlmk://?token={TOKEN}", { # The token provided as a query argument "instance": NotifyYouLMK, "privacy_url": "youlmk://y...6/", }, ), ( f"youlmk://{TOKEN}?priority=critical", { # A forced priority "instance": NotifyYouLMK, }, ), ( f"youlmk://{TOKEN}?priority=bogus", { # An unknown priority "instance": AppriseImproperlyConfigured, }, ), ( f"youlmk://{TOKEN}?failure=critical&info=low", { # Per-type priorities "instance": NotifyYouLMK, }, ), ( f"youlmk://{TOKEN}?warning=bogus", { # An unknown per-type priority "instance": AppriseImproperlyConfigured, }, ), ( f"youlmk://{TOKEN}?url=https://example.com/runs/1&group=deploys", { # A link and a group "instance": NotifyYouLMK, }, ), ( f"youlmk://{TOKEN}?url=https://example.com&url_label=View%20run", { # A link with its own wording "instance": NotifyYouLMK, }, ), ( f"youlmk://{TOKEN}?image=yes", { # The notification-type image rides along "instance": NotifyYouLMK, }, ), ( f"https://youlmk.com/k/{KEY}", { # The key door pasted in as-is "instance": NotifyYouLMK, "privacy_url": "youlmk://k...4/", }, ), ( f"youlmk://{TOKEN}", { "instance": NotifyYouLMK, # Throw an exception on the send "test_requests_exceptions": True, }, ), ( f"youlmk://{TOKEN}", { "instance": NotifyYouLMK, # An unknown key "response": False, "requests_response_code": 401, }, ), ( f"youlmk://{TOKEN}", { "instance": NotifyYouLMK, # The trial's notifications are used "response": False, "requests_response_code": 402, }, ), ( f"youlmk://{TOKEN}", { "instance": NotifyYouLMK, # A code the map does not name "response": False, "requests_response_code": 999, }, ), ) def test_plugin_youlmk_urls(): """NotifyYouLMK() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() def test_plugin_youlmk_edge_cases(): """NotifyYouLMK() Edge Cases.""" # No token with pytest.raises(AppriseImproperlyConfigured): NotifyYouLMK(token=None) # An empty token with pytest.raises(AppriseImproperlyConfigured): NotifyYouLMK(token=" ") # The wrong shape with pytest.raises(AppriseImproperlyConfigured): NotifyYouLMK(token="ylk_" + "x" * 31) # A bad forced priority with pytest.raises(AppriseImproperlyConfigured): NotifyYouLMK(token=TOKEN, priority="bogus") # A bad per-type priority with pytest.raises(AppriseImproperlyConfigured): NotifyYouLMK(token=TOKEN, failure="bogus") # Both shapes are accepted, and the case of the token is kept obj = NotifyYouLMK(token=TOKEN.upper()) assert obj.token == TOKEN.upper() assert obj.is_token is True obj = NotifyYouLMK(token=KEY) assert obj.is_token is False @mock.patch("requests.post") def test_plugin_youlmk_send_token(mock_post): """NotifyYouLMK() Send with the bearer token.""" response = mock.Mock() response.status_code = requests.codes.ok mock_post.return_value = response obj = Apprise.instantiate(f"youlmk://{TOKEN}") assert isinstance(obj, NotifyYouLMK) assert obj.notify(title="backup finished", body="4.2 GB") is True assert mock_post.call_count == 1 # The bearer door, with the token in the header assert mock_post.call_args[0][0] == "https://youlmk.com/v1/notify" headers = mock_post.call_args[1]["headers"] assert headers["Authorization"] == f"Bearer {TOKEN}" assert headers["Content-Type"] == "application/json; charset=utf-8" payload = loads(mock_post.call_args[1]["data"]) assert payload["title"] == "backup finished" assert payload["body"] == "4.2 GB" # INFO maps to normal by default assert payload["priority"] == "normal" assert "url" not in payload assert "group" not in payload @mock.patch("requests.post") def test_plugin_youlmk_send_key(mock_post): """NotifyYouLMK() Send with the URL key.""" response = mock.Mock() response.status_code = requests.codes.ok mock_post.return_value = response obj = Apprise.instantiate(f"youlmk://{KEY}") assert isinstance(obj, NotifyYouLMK) assert obj.notify(title="deployed", body="v2.4.1") is True assert mock_post.call_count == 1 # The key door, with the key in the address and no bearer header assert mock_post.call_args[0][0] == f"https://youlmk.com/k/{KEY}" assert "Authorization" not in mock_post.call_args[1]["headers"] payload = loads(mock_post.call_args[1]["data"]) assert payload["title"] == "deployed" assert payload["priority"] == "normal" @mock.patch("requests.post") def test_plugin_youlmk_notify_type_mapping(mock_post): """NotifyYouLMK() Priority derived from the notification type.""" response = mock.Mock() response.status_code = requests.codes.ok mock_post.return_value = response obj = Apprise.instantiate(f"youlmk://{TOKEN}") expected = { NotifyType.INFO: "normal", NotifyType.SUCCESS: "normal", NotifyType.WARNING: "high", NotifyType.FAILURE: "high", } for notify_type, priority in expected.items(): mock_post.reset_mock() assert obj.notify(title="t", body="b", notify_type=notify_type) is True payload = loads(mock_post.call_args[1]["data"]) assert payload["priority"] == priority @mock.patch("requests.post") def test_plugin_youlmk_priority_override(mock_post): """NotifyYouLMK() A forced priority wins over the type.""" response = mock.Mock() response.status_code = requests.codes.ok mock_post.return_value = response obj = Apprise.instantiate(f"youlmk://{TOKEN}?priority=crit") assert obj.priority == "critical" assert obj.notify(title="t", body="b", notify_type=NotifyType.INFO) is True payload = loads(mock_post.call_args[1]["data"]) assert payload["priority"] == "critical" @mock.patch("requests.post") def test_plugin_youlmk_per_type_priorities(mock_post): """NotifyYouLMK() Per-type priorities from the URL.""" response = mock.Mock() response.status_code = requests.codes.ok mock_post.return_value = response obj = Apprise.instantiate( f"youlmk://{TOKEN}?info=low&success=l&warning=n&failure=critical" ) assert obj.priority is None assert obj.priority_map[NotifyType.INFO] == "low" assert obj.priority_map[NotifyType.SUCCESS] == "low" assert obj.priority_map[NotifyType.WARNING] == "normal" assert obj.priority_map[NotifyType.FAILURE] == "critical" assert ( obj.notify(title="t", body="b", notify_type=NotifyType.FAILURE) is True ) payload = loads(mock_post.call_args[1]["data"]) assert payload["priority"] == "critical" # Every changed mapping is carried by the URL url = obj.url() assert "info=low" in url assert "success=low" in url assert "warning=normal" in url assert "failure=critical" in url @mock.patch("requests.post") def test_plugin_youlmk_link_and_group(mock_post): """NotifyYouLMK() A link and a group travel with the payload.""" response = mock.Mock() response.status_code = requests.codes.ok mock_post.return_value = response obj = Apprise.instantiate( f"youlmk://{TOKEN}?url=https://example.com/runs/1&group=deploys" ) assert obj.link == "https://example.com/runs/1" assert obj.group == "deploys" assert obj.notify(title="deployed", body="v2.4.1") is True payload = loads(mock_post.call_args[1]["data"]) assert payload["url"] == "https://example.com/runs/1" assert payload["group"] == "deploys" # And come back out of the URL url = obj.url() assert "url=https%3A%2F%2Fexample.com%2Fruns%2F1" in url assert "group=deploys" in url @mock.patch("requests.post") def test_plugin_youlmk_empty_title(mock_post): """NotifyYouLMK() A title is always sent.""" response = mock.Mock() response.status_code = requests.codes.ok mock_post.return_value = response # The application description stands in for a missing title asset = AppriseAsset(app_desc="My App") obj = Apprise.instantiate(f"youlmk://{TOKEN}", asset=asset) assert obj.notify(body="b", title="") is True payload = loads(mock_post.call_args[1]["data"]) assert payload["title"] == "My App" # And the application id when there is no description either mock_post.reset_mock() asset = AppriseAsset(app_desc="", app_id="apprise") obj = Apprise.instantiate(f"youlmk://{TOKEN}", asset=asset) assert obj.notify(body="b", title="") is True payload = loads(mock_post.call_args[1]["data"]) assert payload["title"] == "apprise" @mock.patch("requests.post") def test_plugin_youlmk_failures(mock_post): """NotifyYouLMK() The door's own codes read as failures.""" for code in (400, 401, 402, 410, 413, 422, 429, 503): response = mock.Mock() response.status_code = code response.content = b'{"error":"code"}' mock_post.return_value = response obj = Apprise.instantiate(f"youlmk://{TOKEN}") assert obj.notify(title="t", body="b") is False # A connection error mock_post.side_effect = requests.RequestException("down") obj = Apprise.instantiate(f"youlmk://{TOKEN}") assert obj.notify(title="t", body="b") is False @mock.patch("requests.post") def test_plugin_youlmk_url_roundtrip(mock_post): """NotifyYouLMK() A URL survives a round trip.""" response = mock.Mock() response.status_code = requests.codes.ok mock_post.return_value = response source = f"youlmk://{TOKEN}?priority=high&failure=critical&group=g" obj = Apprise.instantiate(source) url = obj.url() assert url.startswith(f"youlmk://{TOKEN}/?") assert "priority=high" in url assert "failure=critical" in url assert "group=g" in url again = Apprise.instantiate(url) assert isinstance(again, NotifyYouLMK) assert again.token == TOKEN assert again.priority == "high" assert again.priority_map[NotifyType.FAILURE] == "critical" assert again.group == "g" assert again.url_identifier == obj.url_identifier # Two credentials are two identifiers other = Apprise.instantiate(f"youlmk://{KEY}") assert other.url_identifier != obj.url_identifier def test_plugin_youlmk_parse_url(): """NotifyYouLMK() parse_url().""" # An unparseable (non-string) URL returns None assert NotifyYouLMK.parse_url(None) is None results = NotifyYouLMK.parse_url(f"youlmk://{TOKEN}") assert results["token"] == TOKEN assert "priority" not in results assert "link" not in results results = NotifyYouLMK.parse_url( f"youlmk://ignored?token={TOKEN}&priority=low&info=high" "&url=https://example.com&group=g" ) assert results["token"] == TOKEN assert results["priority"] == "low" assert results["info"] == "high" assert results["link"] == "https://example.com" assert results["group"] == "g" @mock.patch("requests.post") def test_plugin_youlmk_url_label(mock_post): """NotifyYouLMK() The primary button carries its own wording.""" response = mock.Mock() response.status_code = requests.codes.ok mock_post.return_value = response obj = Apprise.instantiate( f"youlmk://{TOKEN}?url=https://example.com&url_label=View%20run" ) assert obj.url_label == "View run" assert obj.notify(title="t", body="b") is True payload = loads(mock_post.call_args[1]["data"]) assert payload["url_label"] == "View run" # And it comes back out of the URL assert "url_label=View%20run" in obj.url() # Anything over the payload's limit is trimmed obj = NotifyYouLMK( token=TOKEN, link="https://example.com", url_label="x" * 40 ) assert obj.url_label == "x" * 24 # A label with no address to sit on is left out of the payload mock_post.reset_mock() obj = NotifyYouLMK(token=TOKEN, url_label="View run") assert obj.notify(title="t", body="b") is True payload = loads(mock_post.call_args[1]["data"]) assert "url" not in payload assert "url_label" not in payload @mock.patch("requests.post") def test_plugin_youlmk_image(mock_post): """NotifyYouLMK() The notification-type image is opt-in.""" response = mock.Mock() response.status_code = requests.codes.ok mock_post.return_value = response # Off by default obj = Apprise.instantiate(f"youlmk://{TOKEN}") assert obj.include_image is False assert obj.notify(title="t", body="b") is True assert "image" not in loads(mock_post.call_args[1]["data"]) assert "image=no" in obj.url() # On when asked for mock_post.reset_mock() obj = Apprise.instantiate(f"youlmk://{TOKEN}?image=yes") assert obj.include_image is True assert obj.notify(title="t", body="b") is True assert loads(mock_post.call_args[1]["data"])["image"].startswith("http") assert "image=yes" in obj.url() # An asset with no imagery leaves the field out mock_post.reset_mock() asset = AppriseAsset(image_url_mask=None, image_path_mask=None) obj = Apprise.instantiate(f"youlmk://{TOKEN}?image=yes", asset=asset) assert obj.notify(title="t", body="b") is True assert "image" not in loads(mock_post.call_args[1]["data"]) def test_plugin_youlmk_parse_native_url(): """NotifyYouLMK() parse_native_url().""" # The key door pasted straight from the source's Key screen results = NotifyYouLMK.parse_native_url(f"https://youlmk.com/k/{KEY}") assert results["token"] == KEY # A www. prefix, a trailing slash and query arguments all travel results = NotifyYouLMK.parse_native_url( f"https://www.youlmk.com/k/{KEY}/?priority=low" ) assert results["token"] == KEY assert results["priority"] == "low" # The bearer door is not a key door assert ( NotifyYouLMK.parse_native_url("https://youlmk.com/v1/notify") is None ) def test_plugin_youlmk_priority_resolution(): """youlmk_priority() resolves short forms and refuses the rest.""" assert youlmk_priority("low") == "low" assert youlmk_priority("l") == "low" assert youlmk_priority("NORMAL") == "normal" assert youlmk_priority("hi") == "high" assert youlmk_priority("crit") == "critical" assert youlmk_priority("") is None assert youlmk_priority(" ") is None assert youlmk_priority("bogus") is None caronc-apprise-dfec414/tests/test_plugin_zalo.py000066400000000000000000000243421526720371000222220ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Disable logging for a cleaner testing output import json import logging from unittest import mock from urllib.parse import urlparse from helpers import AppriseURLTester import pytest import requests from apprise import Apprise, NotifyFormat from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.zalo import NotifyZalo logging.disable(logging.CRITICAL) # A realistic Bot Token TOKEN = "123456789:abcdefghijKLMNOPqrst" # A successful Zalo response OK_RESPONSE = json.dumps( {"ok": True, "result": {"message_id": "82599fa32f", "date": 1749632637}} ).encode("utf-8") # Our Testing URLs apprise_url_tests = ( ( "zalo://", { # No token specified "instance": TypeError, }, ), ( "zalo://123456789", { # Only half of a token "instance": AppriseImproperlyConfigured, }, ), ( "zalo://abc:def/chat1", { # The bot id must be numeric "instance": TypeError, }, ), ( f"zalo://{TOKEN}", { # No Chat IDs; we load but have nothing to notify "instance": NotifyZalo, "notify_response": False, }, ), ( f"zalo://{TOKEN}/chat1", { "instance": NotifyZalo, "requests_response_text": OK_RESPONSE, # Our expected url(privacy=True) startswith() response "privacy_url": "zalo://1...t/chat1", }, ), ( "zalo://123456789%3Aabcdefghij/chat1/chat.2/", { # An encoded colon is accepted too "instance": NotifyZalo, }, ), ( "zalo://123456789/abcdefghij/chat1/", { # A slash in place of the colon is accepted too "instance": NotifyZalo, }, ), ( f"zalo://chat1/?token={TOKEN}&to=chat2,chat3", { # Token and Chat IDs given as arguments "instance": NotifyZalo, "privacy_url": "zalo://1...t/chat1/chat2/chat3", }, ), ( f"zalo://?token={TOKEN}&to=chat1", { # No host at all "instance": NotifyZalo, }, ), ( f"zalo://{TOKEN}/chat1/invalid!id", { # One bad Chat ID is dropped; the good one still works "instance": NotifyZalo, }, ), ( f"zalo://{TOKEN}/invalid!id", { # Nothing valid to notify "instance": NotifyZalo, "notify_response": False, }, ), ( f"zalo://{TOKEN}/chat1", { # Zalo refused the message "instance": NotifyZalo, "requests_response_text": { "ok": False, "error_code": 400, "description": "Bad Request", }, "response": False, }, ), ( f"zalo://{TOKEN}/chat1", { "instance": NotifyZalo, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( f"zalo://{TOKEN}/chat1", { "instance": NotifyZalo, "response": False, "requests_response_code": requests.codes.internal_server_error, }, ), ( f"zalo://{TOKEN}/chat1", { "instance": NotifyZalo, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), ) def _mk_resp(content=OK_RESPONSE, code=requests.codes.ok): """Build a mock Zalo response.""" r = mock.Mock() r.status_code = code r.content = content return r def test_plugin_zalo_urls(): """NotifyZalo() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() def test_plugin_zalo_init(): """NotifyZalo() validates its token and Chat IDs.""" # Bad tokens are refused for token in (None, "", "123456789", "abc:def", "123:bad token"): with pytest.raises(AppriseImproperlyConfigured): NotifyZalo(token=token, targets="chat1") # Good and bad Chat IDs are kept apart obj = NotifyZalo(token=TOKEN, targets=["chat1", "a.b-c_d", "bad!id"]) assert obj.targets == ["a.b-c_d", "chat1"] assert obj.invalid_targets == ["bad!id"] assert len(obj) == 2 # No targets still counts as one notification assert len(NotifyZalo(token=TOKEN)) == 1 def test_plugin_zalo_round_trip(): """NotifyZalo() url() reloads into the same object.""" obj = NotifyZalo( token=TOKEN, targets=["chat1", "bad!id"], format=NotifyFormat.TEXT ) url = obj.url() assert url.startswith(f"zalo://{TOKEN}/chat1/bad%21id?") assert "format=text" in url result = NotifyZalo.parse_url(url) assert result["token"] == TOKEN obj2 = NotifyZalo(**result) assert obj2.url_identifier == obj.url_identifier assert obj2.targets == obj.targets assert obj2.invalid_targets == obj.invalid_targets assert obj2.url() == url # Different targets are still the same bot assert ( NotifyZalo(token=TOKEN, targets="other").url_identifier == obj.url_identifier ) # Nothing to parse assert NotifyZalo.parse_url(None) is None @mock.patch("requests.post") def test_plugin_zalo_payload(mock_post): """NotifyZalo() posts one message to each Chat ID.""" mock_post.return_value = _mk_resp() obj = NotifyZalo(token=TOKEN, targets=["chat1", "chat2"]) assert obj.notify(body="body", title="title") assert mock_post.call_count == 2 # The Bot Token is part of the API path url = mock_post.call_args_list[0][0][0] assert urlparse(url).hostname == "bot-api.zaloplatforms.com" assert urlparse(url).path == f"/bot{TOKEN}/sendMessage" # Each Chat ID gets its own copy first = json.loads(mock_post.call_args_list[0][1]["data"]) second = json.loads(mock_post.call_args_list[1][1]["data"]) assert first["chat_id"] == "chat1" assert second["chat_id"] == "chat2" # Undeclared content takes the Markdown path, title on its own line assert first["text"] == "title\r\nbody" assert first["parse_mode"] == "markdown" @mock.patch("requests.post") def test_plugin_zalo_partial_failure(mock_post): """NotifyZalo() reports a failure when one Chat ID is refused.""" mock_post.side_effect = ( _mk_resp(), _mk_resp(b"", requests.codes.unauthorized), ) obj = NotifyZalo(token=TOKEN, targets=["chat1", "chat2"]) assert not obj.notify(body="body") assert mock_post.call_count == 2 # An empty body with a 200 is still a success mock_post.side_effect = None mock_post.return_value = _mk_resp(None) assert obj.notify(body="body") @mock.patch("requests.post") def test_plugin_zalo_formats(mock_post): """NotifyZalo() asks Zalo to style Markdown and leaves text alone.""" mock_post.return_value = _mk_resp() obj = NotifyZalo(token=TOKEN, targets="chat1") # Markdown keeps its markup and turns on parse_mode assert obj.notify( body="**bold** _it_ \\*", title="T & ", body_format=NotifyFormat.MARKDOWN, ) payload = json.loads(mock_post.call_args[1]["data"]) assert payload["parse_mode"] == "markdown" assert payload["text"].endswith("**bold** _it_ \\*") assert payload["text"].startswith("# T") # HTML is converted to Markdown assert obj.notify( body="bold it", body_format=NotifyFormat.HTML ) payload = json.loads(mock_post.call_args[1]["data"]) assert payload["parse_mode"] == "markdown" assert payload["text"] == "**bold** *it*" # Plain text reaches Zalo exactly as it was typed assert obj.notify( body="5 * 3 = a_b # x", body_format=NotifyFormat.TEXT ) payload = json.loads(mock_post.call_args[1]["data"]) assert payload["text"] == "5 * 3 = a_b # x" assert "parse_mode" not in payload # Content with no declared format is not touched assert obj.notify(body="**raw** \\*") payload = json.loads(mock_post.call_args[1]["data"]) assert payload["text"] == "**raw** \\*" assert payload["parse_mode"] == "markdown" # ?format=text sends passthrough content as plain text obj = NotifyZalo(token=TOKEN, targets="chat1", format="text") assert obj.notify(body="**raw**") payload = json.loads(mock_post.call_args[1]["data"]) assert payload["text"] == "**raw**" assert "parse_mode" not in payload @mock.patch("requests.post") def test_plugin_zalo_apprise_integration(mock_post): """Apprise() loads and notifies a zalo:// URL.""" mock_post.return_value = _mk_resp() apobj = Apprise() assert apobj.add(f"zalo://{TOKEN}/chat1") assert apobj.notify(body="hello") assert mock_post.call_count == 1 caronc-apprise-dfec414/tests/test_plugin_zoom.py000066400000000000000000000333421526720371000222410ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in the # documentation and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Disable logging for a cleaner testing output import logging from unittest import mock from helpers import AppriseURLTester import pytest import requests from apprise import Apprise, NotifyType from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.zoom import ( ZOOM_MODE_DEFAULT, NotifyZoom, ZoomMode, ) logging.disable(logging.CRITICAL) # Reusable test credentials WEBHOOK_ID = "abcHook123" TOKEN = "xyzVerify456" # Our Testing URLs apprise_url_tests = ( # Missing everything ( "zoom://", { "instance": AppriseImproperlyConfigured, }, ), # Empty user/host segment ( "zoom://:@/", { "instance": AppriseImproperlyConfigured, }, ), # Missing token (webhook_id present but no path segment) ( "zoom://{}".format(WEBHOOK_ID), { "instance": AppriseImproperlyConfigured, }, ), # Valid full-mode (default) ( "zoom://{}/{}".format(WEBHOOK_ID, TOKEN), { "instance": NotifyZoom, "privacy_url": "zoom://a...3/x...6/", }, ), # Explicit mode=full ( "zoom://{}/{}?mode=full".format(WEBHOOK_ID, TOKEN), { "instance": NotifyZoom, "privacy_url": "zoom://a...3/x...6/", }, ), # Explicit mode=simple ( "zoom://{}/{}?mode=simple".format(WEBHOOK_ID, TOKEN), { "instance": NotifyZoom, "privacy_url": "zoom://a...3/x...6/", }, ), # Invalid mode ( "zoom://{}/{}?mode=invalid".format(WEBHOOK_ID, TOKEN), { "instance": AppriseImproperlyConfigured, }, ), # Native URL with ?token= query param ( "https://inbots.zoom.us/incoming/hook/{}?token={}".format( WEBHOOK_ID, TOKEN ), { "instance": NotifyZoom, }, ), # Full mode: HTTP 500 ( "zoom://{}/{}".format(WEBHOOK_ID, TOKEN), { "instance": NotifyZoom, "response": False, "requests_response_code": (requests.codes.internal_server_error), }, ), # Full mode: unusual status code ( "zoom://{}/{}".format(WEBHOOK_ID, TOKEN), { "instance": NotifyZoom, "response": False, "requests_response_code": 999, }, ), # Full mode: request exception ( "zoom://{}/{}".format(WEBHOOK_ID, TOKEN), { "instance": NotifyZoom, "test_requests_exceptions": True, }, ), # Simple mode: HTTP 500 ( "zoom://{}/{}?mode=simple".format(WEBHOOK_ID, TOKEN), { "instance": NotifyZoom, "response": False, "requests_response_code": (requests.codes.internal_server_error), }, ), # Simple mode: unusual status code ( "zoom://{}/{}?mode=simple".format(WEBHOOK_ID, TOKEN), { "instance": NotifyZoom, "response": False, "requests_response_code": 999, }, ), # Simple mode: request exception ( "zoom://{}/{}?mode=simple".format(WEBHOOK_ID, TOKEN), { "instance": NotifyZoom, "test_requests_exceptions": True, }, ), ) def test_plugin_zoom_urls(): """NotifyZoom() Apprise URLs.""" AppriseURLTester(tests=apprise_url_tests).run_all() def test_plugin_zoom_init(): """Test NotifyZoom initialization and validation.""" # Missing webhook_id with pytest.raises(AppriseImproperlyConfigured): NotifyZoom(webhook_id=None, token=TOKEN) # Empty webhook_id with pytest.raises(AppriseImproperlyConfigured): NotifyZoom(webhook_id="", token=TOKEN) # Webhook ID with invalid characters (slash) with pytest.raises(AppriseImproperlyConfigured): NotifyZoom(webhook_id="bad/id", token=TOKEN) # Missing token with pytest.raises(AppriseImproperlyConfigured): NotifyZoom(webhook_id=WEBHOOK_ID, token=None) # Empty token with pytest.raises(AppriseImproperlyConfigured): NotifyZoom(webhook_id=WEBHOOK_ID, token="") # Invalid mode with pytest.raises(AppriseImproperlyConfigured): NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN, mode="bogus") # Empty string mode is also invalid (must not silently resolve to simple) with pytest.raises(AppriseImproperlyConfigured): NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN, mode="") # Whitespace-only mode is also invalid with pytest.raises(AppriseImproperlyConfigured): NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN, mode=" ") # Valid: default mode obj = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN) assert obj.mode == ZOOM_MODE_DEFAULT # Valid: explicit full mode obj = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN, mode="full") assert obj.mode == ZoomMode.FULL # Valid: explicit simple mode obj = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN, mode="simple") assert obj.mode == ZoomMode.SIMPLE # Partial prefix matching: "sim" -> "simple" obj = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN, mode="sim") assert obj.mode == ZoomMode.SIMPLE # Partial prefix matching: "f" -> "full" obj = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN, mode="f") assert obj.mode == ZoomMode.FULL def test_plugin_zoom_url_round_trip(): """Verify that url() -> parse_url() -> __init__ is lossless.""" # Full mode round-trip obj1 = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN, mode="full") result = NotifyZoom.parse_url(obj1.url()) obj2 = NotifyZoom(**result) assert obj1.url_identifier == obj2.url_identifier assert obj1.mode == obj2.mode # Simple mode round-trip obj1 = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN, mode="simple") result = NotifyZoom.parse_url(obj1.url()) obj2 = NotifyZoom(**result) assert obj1.url_identifier == obj2.url_identifier assert obj1.mode == obj2.mode def test_plugin_zoom_url_privacy(): """Verify url(privacy=True) masks webhook_id and token.""" obj = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN) priv = obj.url(privacy=True) assert WEBHOOK_ID not in priv assert TOKEN not in priv # Schema is still present assert priv.startswith("zoom://") def test_plugin_zoom_url_identifier(): """Verify url_identifier contains webhook_id, token, and mode.""" obj = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN) uid = obj.url_identifier assert "zoom" in uid assert WEBHOOK_ID in uid assert TOKEN in uid # Two instances with different tokens are distinct obj2 = NotifyZoom(webhook_id=WEBHOOK_ID, token="other") assert obj.url_identifier != obj2.url_identifier # Same credentials but different modes produce different identifiers obj_full = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN, mode="full") obj_simple = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN, mode="simple") assert obj_full.url_identifier != obj_simple.url_identifier # mode is the 4th element (index 3) of the identifier tuple assert obj_full.url_identifier[3] == ZoomMode.FULL assert obj_simple.url_identifier[3] == ZoomMode.SIMPLE @mock.patch("requests.post") def test_plugin_zoom_full_send(mock_post): """Test _send_full() success and failure paths.""" def _mk_resp(code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = b"" return r mock_post.return_value = _mk_resp() # Success: with title obj = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN) assert obj.notify( body="body text", title="My Title", notify_type=NotifyType.INFO, ) assert mock_post.call_count == 1 # Verify ?format=full in URL call_url = mock_post.call_args[0][0] assert "format=full" in call_url mock_post.reset_mock() # Success: without title (no head section) assert obj.notify( body="body only", title="", notify_type=NotifyType.INFO, ) assert mock_post.call_count == 1 mock_post.reset_mock() # HTTP 204 is also a success mock_post.return_value = _mk_resp(requests.codes.no_content) assert obj.notify(body="test", notify_type=NotifyType.INFO) mock_post.reset_mock() # HTTP 500 -> failure mock_post.return_value = _mk_resp(requests.codes.internal_server_error) assert not obj.notify(body="test", notify_type=NotifyType.INFO) mock_post.reset_mock() # Unknown status code -> failure mock_post.return_value = _mk_resp(999) assert not obj.notify(body="test", notify_type=NotifyType.INFO) mock_post.reset_mock() # RequestException -> failure mock_post.side_effect = requests.RequestException("boom") assert not obj.notify(body="test", notify_type=NotifyType.INFO) @mock.patch("requests.post") def test_plugin_zoom_simple_send(mock_post): """Test _send_simple() success and failure paths.""" def _mk_resp(code=requests.codes.ok): r = mock.Mock() r.status_code = code r.content = b"" return r mock_post.return_value = _mk_resp() # Create a simple-mode instance obj = NotifyZoom(webhook_id=WEBHOOK_ID, token=TOKEN, mode="simple") # Success: with title (title prepended to body) assert obj.notify( body="msg body", title="Alert", notify_type=NotifyType.INFO, ) assert mock_post.call_count == 1 # Verify no ?format= in simple mode URL call_url = mock_post.call_args[0][0] assert "format" not in call_url mock_post.reset_mock() # Success: without title assert obj.notify( body="no title", title="", notify_type=NotifyType.INFO, ) mock_post.reset_mock() # HTTP 204 is also a success mock_post.return_value = _mk_resp(requests.codes.no_content) assert obj.notify(body="test", notify_type=NotifyType.INFO) mock_post.reset_mock() # HTTP 500 -> failure mock_post.return_value = _mk_resp(requests.codes.internal_server_error) assert not obj.notify(body="test", notify_type=NotifyType.INFO) mock_post.reset_mock() # Unknown status code -> failure mock_post.return_value = _mk_resp(999) assert not obj.notify(body="test", notify_type=NotifyType.INFO) mock_post.reset_mock() # RequestException -> failure mock_post.side_effect = requests.RequestException("err") assert not obj.notify(body="test", notify_type=NotifyType.INFO) def test_plugin_zoom_parse_url(): """Exercise parse_url() edge cases.""" # Basic: webhook_id in host, token in path result = NotifyZoom.parse_url("zoom://myhookid/mytoken/") assert result["webhook_id"] == "myhookid" assert result["token"] == "mytoken" # ?token= override result = NotifyZoom.parse_url("zoom://myhookid/?token=override123") assert result["webhook_id"] == "myhookid" assert result["token"] == "override123" # ?mode= parameter result = NotifyZoom.parse_url("zoom://myhookid/mytoken/?mode=simple") assert result["mode"] == "simple" # A URL that fails base parsing returns None result = NotifyZoom.parse_url(None) assert result is None def test_plugin_zoom_parse_native_url(): """Exercise parse_native_url().""" # Native URL with ?token= appended result = NotifyZoom.parse_native_url( "https://inbots.zoom.us/incoming/hook/{}?token={}".format( WEBHOOK_ID, TOKEN ) ) assert result is not None assert result["webhook_id"] == WEBHOOK_ID assert result["token"] == TOKEN # Native URL without token -> parse succeeds but # token will be None/missing (instantiation would fail) result = NotifyZoom.parse_native_url( "https://inbots.zoom.us/incoming/hook/{}".format(WEBHOOK_ID) ) assert result is not None assert result["webhook_id"] == WEBHOOK_ID # Non-matching URL -> None assert ( NotifyZoom.parse_native_url("https://example.com/not/a/zoom/url") is None ) @mock.patch("requests.post") def test_plugin_zoom_apprise_integration(mock_post): """Test end-to-end via Apprise.add() and Apprise.notify().""" r = mock.Mock() r.status_code = requests.codes.ok r.content = b"" mock_post.return_value = r app = Apprise() assert app.add("zoom://{}/{}".format(WEBHOOK_ID, TOKEN)) assert app.notify(title="Hello", body="World") assert mock_post.call_count == 1 caronc-apprise-dfec414/tests/test_plugin_zulip.py000066400000000000000000000127311526720371000224170ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Disable logging for a cleaner testing output import logging from helpers import AppriseURLTester import pytest import requests from apprise.exception import AppriseImproperlyConfigured from apprise.plugins.zulip import NotifyZulip logging.disable(logging.CRITICAL) # Our Testing URLs apprise_url_tests = ( ( "zulip://", { "instance": AppriseImproperlyConfigured, }, ), ( "zulip://:@/", { "instance": AppriseImproperlyConfigured, }, ), ( "zulip://apprise", { # Just org provided (no token or botname) "instance": AppriseImproperlyConfigured, }, ), ( "zulip://botname@apprise", { # Just org and botname provided (no token) "instance": AppriseImproperlyConfigured, }, ), # invalid token ( "zulip://botname@apprise/{}".format("a" * 24), { "instance": AppriseImproperlyConfigured, }, ), # invalid botname ( "zulip://....@apprise/{}".format("a" * 32), { "instance": AppriseImproperlyConfigured, }, ), # Valid everything - botname with a dash ( "zulip://bot-name@apprise/{}".format("a" * 32), { "instance": NotifyZulip, "privacy_url": "zulip://bot-name@apprise/a...a/", }, ), # Valid everything - no target so default is used ( "zulip://botname@apprise/{}".format("a" * 32), { "instance": NotifyZulip, # Our expected url(privacy=True) startswith() response: "privacy_url": "zulip://botname@apprise/a...a/", }, ), # Valid everything - organization as hostname ( "zulip://botname@apprise.zulipchat.com/{}".format("a" * 32), { "instance": NotifyZulip, }, ), # Valid everything - 2 streams specified ( "zulip://botname@apprise/{}/channel1/channel2".format("a" * 32), { "instance": NotifyZulip, }, ), # Valid everything - 2 streams specified (using to=) ( "zulip://botname@apprise/{}/?to=channel1/channel2".format("a" * 32), { "instance": NotifyZulip, }, ), # Test token= ( "zulip://botname@apprise/?token={}&to=channel1".format("a" * 32), { "instance": NotifyZulip, }, ), # Valid everything - 2 emails specified ( "zulip://botname@apprise/{}/user@example.com/user2@example.com".format( "a" * 32 ), { "instance": NotifyZulip, }, ), ( "zulip://botname@apprise/{}".format("a" * 32), { "instance": NotifyZulip, # don't include an image by default "include_image": False, }, ), ( "zulip://botname@apprise/{}".format("a" * 32), { "instance": NotifyZulip, # force a failure "response": False, "requests_response_code": requests.codes.internal_server_error, }, ), ( "zulip://botname@apprise/{}".format("a" * 32), { "instance": NotifyZulip, # throw a bizarre code forcing us to fail to look it up "response": False, "requests_response_code": 999, }, ), ( "zulip://botname@apprise/{}".format("a" * 32), { "instance": NotifyZulip, # Throws a series of i/o exceptions with this flag # is set and tests that we gracefully handle them "test_requests_exceptions": True, }, ), ) def test_plugin_zulip_urls(): """NotifyZulip() Apprise URLs.""" # Run our general tests AppriseURLTester(tests=apprise_url_tests).run_all() def test_plugin_zulip_edge_cases(): """NotifyZulip() Edge Cases.""" # must be 32 characters long token = "a" * 32 # Invalid organization with pytest.raises(AppriseImproperlyConfigured): NotifyZulip(botname="test", organization="#", token=token) caronc-apprise-dfec414/tests/test_result.py000066400000000000000000000724671526720371000212300ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Disable logging for a cleaner testing output from datetime import datetime, timezone from io import StringIO from json import loads import logging from apprise.common import AWARE_DATE_ISO_FORMAT from apprise.logger import NotifyLogEntry from apprise.result import ( AppriseResult, AppriseResultStatus, NotifyAttempt, NotifyResult, ) logging.disable(logging.CRITICAL) def _json_data(value): """Decode one result object's bounded JSON iterator for assertions.""" return loads("".join(value.iter_json())) def test_notify_log_entry(): """NotifyLogEntry: attributes, asdict(), json(), __str__/__repr__.""" entry = NotifyLogEntry(level="WARNING", message="HTTP 403 Forbidden") assert entry.level == "WARNING" assert entry.message == "HTTP 403 Forbidden" assert entry.time.tzinfo is not None assert entry.asdict() == { "level": "WARNING", "message": "HTTP 403 Forbidden", "time": entry.time.strftime(AWARE_DATE_ISO_FORMAT), } assert loads(entry.json()) == entry.asdict() # __str__ mirrors Python logging's own default format: # "%(asctime)s - %(levelname)s - %(message)s". expected_asctime = "{},{:03d}".format( entry.time.strftime("%Y-%m-%d %H:%M:%S"), entry.time.microsecond // 1000, ) assert str(entry) == (f"{expected_asctime} - WARNING - HTTP 403 Forbidden") assert "WARNING" in repr(entry) assert "HTTP 403 Forbidden" in repr(entry) def test_notify_log_entry_time_defaults_to_now(): """NotifyLogEntry.time defaults to now() when constructed directly (e.g. in tests) without an explicit time= from a real LogRecord.""" before = datetime.now(timezone.utc) entry = NotifyLogEntry(level="WARNING", message="test") after = datetime.now(timezone.utc) assert before <= entry.time <= after def test_notify_log_entry_explicit_time(): """NotifyLogEntry accepts an explicit time=, as _ServiceLogCapture.emit() does from the underlying LogRecord's own timestamp.""" when = datetime(2026, 1, 1, tzinfo=timezone.utc) entry = NotifyLogEntry(level="ERROR", message="test", time=when) assert entry.time == when def test_notify_attempt_defaults(): """NotifyAttempt: default construction requires only status.""" attempt = NotifyAttempt(status=AppriseResultStatus.SUCCESS) assert attempt.status == AppriseResultStatus.SUCCESS assert attempt.elapsed == 0.0 assert attempt.logs == [] assert bool(attempt) is True def test_notify_attempt_bool_matches_status(): """NotifyAttempt.__bool__ is True only for status=SUCCESS -- raw, never adjusted for optional=.""" success = NotifyAttempt(status=AppriseResultStatus.SUCCESS) failure = NotifyAttempt(status=AppriseResultStatus.FAILURE) timeout = NotifyAttempt(status=AppriseResultStatus.TIMEOUT) assert bool(success) is True assert bool(failure) is False assert bool(timeout) is False def test_notify_attempt_start_end_time_match_elapsed(): """start_time/end_time are always populated and their difference is exactly elapsed -- by construction, not by measurement, so there is no separate clock to drift out of sync.""" before = datetime.now(timezone.utc) attempt = NotifyAttempt(status=AppriseResultStatus.SUCCESS, elapsed=3.5) after = datetime.now(timezone.utc) assert attempt.start_time.tzinfo is not None assert attempt.end_time.tzinfo is not None assert (attempt.end_time - attempt.start_time).total_seconds() == 3.5 assert before <= attempt.end_time <= after parsed = datetime.strptime( _json_data(attempt)["start_time"], AWARE_DATE_ISO_FORMAT ) assert parsed == attempt.start_time def test_notify_attempt_iterates_logs(): """NotifyAttempt iterates directly over its own captured log entries.""" logs = [ NotifyLogEntry(level="WARNING", message="rate limited"), NotifyLogEntry(level="ERROR", message="invalid token"), ] attempt = NotifyAttempt( status=AppriseResultStatus.FAILURE, elapsed=0.2, logs=logs ) assert list(attempt) == logs messages = [str(entry) for entry in attempt] assert " - WARNING - rate limited" in messages[0] assert " - ERROR - invalid token" in messages[1] def test_notify_attempt_iter_json_and_write_json(): """Attempt JSON streams every field and can write to a text stream.""" logs = [NotifyLogEntry(level="WARNING", message="HTTP 429")] attempt = NotifyAttempt( status=AppriseResultStatus.FAILURE, elapsed=0.5, logs=logs ) expected = { "status": "FAILURE", "elapsed": 0.5, "start_time": attempt.start_time.strftime(AWARE_DATE_ISO_FORMAT), "end_time": attempt.end_time.strftime(AWARE_DATE_ISO_FORMAT), "logs": [logs[0].asdict()], } output = "".join(attempt.iter_json()) assert loads(output) == expected assert ", " not in output assert ": " not in output # write_json consumes the same bounded chunks without joining them first. stream = StringIO() attempt.write_json(stream) assert stream.getvalue() == output def test_notify_attempt_json_reads_disk_logs_lazily(): """Creating and starting JSON output does not preload disk-backed logs.""" from apprise.logger import _LogCaptureBudget, _NotifyLogStore budget = _LogCaptureBudget(memory_size=0, disk_size=4096) logs = _NotifyLogStore(budget) logs.append(NotifyLogEntry(level="WARNING", message="from disk")) reads = 0 original_read = budget.read def tracked_read(offset): """Count actual disk reads while preserving normal behavior.""" nonlocal reads reads += 1 return original_read(offset) budget.read = tracked_read attempt = NotifyAttempt(AppriseResultStatus.FAILURE, logs=logs) chunks = attempt.iter_json() # Fixed fields are emitted before iteration reaches the disk log array. first_chunk = next(chunks) assert first_chunk.startswith('{"status":') assert reads == 0 output = first_chunk + "".join(chunks) assert loads(output)["logs"][0]["message"] == "from disk" assert reads == 1 logs.close() def test_notify_attempt_repr(): """NotifyAttempt.__repr__ is a compact, informative one-liner.""" attempt = NotifyAttempt(status=AppriseResultStatus.TIMEOUT, elapsed=1.2) text = repr(attempt) assert "TIMEOUT" in text assert "1.2" in text def test_notify_result_defaults(): """NotifyResult: default construction requires only name/url, and with no attempts given reports FAILURE (nothing ever succeeded).""" result = NotifyResult(name="Slack", url="slack://t/ch") assert result.name == "Slack" assert result.url == "slack://t/ch" assert result.url_id is None assert result.tag == () assert result.status == AppriseResultStatus.FAILURE assert bool(result) is False assert result.optional is False assert result.weight == 1 assert result.max_attempts == 1 assert result.attempts == () assert len(result) == 0 assert result.elapsed == 0.0 assert list(result.logs()) == [] def test_notify_result_status_reflects_any_success(): """.status is SUCCESS if any attempt succeeded, regardless of earlier failed attempts.""" result = NotifyResult( name="Slack", url="slack://t/ch", max_attempts=3, attempts=[ NotifyAttempt(status=AppriseResultStatus.FAILURE), NotifyAttempt(status=AppriseResultStatus.SUCCESS), ], ) assert result.status == AppriseResultStatus.SUCCESS assert bool(result) is True assert len(result) == 2 def test_notify_result_status_pure_timeout_no_failure(): """.status is TIMEOUT when Apprise gave up waiting without ever seeing a confirmed failure from this service -- e.g. the deadline had already passed before any attempt could even start, or the one attempt made was abandoned mid-flight rather than completing.""" result = NotifyResult( name="Slack", url="slack://t/ch", attempts=[NotifyAttempt(status=AppriseResultStatus.TIMEOUT)], ) assert result.status == AppriseResultStatus.TIMEOUT assert bool(result) is False def test_notify_result_status_failure_trumps_timeout(): """.status is FAILURE, not TIMEOUT, when at least one attempt confirmed a real failure before Apprise later gave up waiting on a further retry -- a confirmed failure is more informative than "ran out of time" and takes priority over it.""" result = NotifyResult( name="Slack", url="slack://t/ch", attempts=[ NotifyAttempt(status=AppriseResultStatus.FAILURE), NotifyAttempt(status=AppriseResultStatus.TIMEOUT), ], ) assert result.status == AppriseResultStatus.FAILURE assert bool(result) is False def test_notify_result_status_failure_trumps_timeout_multiple_retries(): """The same FAILURE-over-TIMEOUT priority holds regardless of how many failed retries preceded the eventual TIMEOUT.""" result = NotifyResult( name="Slack", url="slack://t/ch", attempts=[ NotifyAttempt(status=AppriseResultStatus.FAILURE), NotifyAttempt(status=AppriseResultStatus.FAILURE), NotifyAttempt(status=AppriseResultStatus.FAILURE), NotifyAttempt(status=AppriseResultStatus.TIMEOUT), ], ) assert result.status == AppriseResultStatus.FAILURE def test_notify_result_optional_absorbs_failure_trumping_timeout(): """optional=True still absorbs a FAILURE-trumps-TIMEOUT outcome into SUCCESS, same as it would a plain FAILURE or a plain TIMEOUT.""" result = NotifyResult( name="Slack", url="slack://t/ch", optional=True, attempts=[ NotifyAttempt(status=AppriseResultStatus.FAILURE), NotifyAttempt(status=AppriseResultStatus.TIMEOUT), ], ) assert result.status == AppriseResultStatus.SUCCESS def test_notify_result_status_failure_when_no_timeout_no_success(): """.status is FAILURE when every attempt failed outright (no TIMEOUT, no SUCCESS, no optional).""" result = NotifyResult( name="Slack", url="slack://t/ch", attempts=[NotifyAttempt(status=AppriseResultStatus.FAILURE)], ) assert result.status == AppriseResultStatus.FAILURE def test_notify_result_optional_absorbs_failure(): """optional=True remaps a failed outcome's reflective .status to SUCCESS, even though the underlying NotifyAttempt stays raw.""" result = NotifyResult( name="Slack", url="slack://t/ch", optional=True, attempts=[NotifyAttempt(status=AppriseResultStatus.FAILURE)], ) assert result.status == AppriseResultStatus.SUCCESS assert bool(result) is True # The raw attempt itself is untouched by optional=. assert next(iter(result)).status == AppriseResultStatus.FAILURE def test_notify_result_optional_absorbs_timeout(): """optional=True also absorbs a TIMEOUT outcome the same way it absorbs a plain FAILURE.""" result = NotifyResult( name="Slack", url="slack://t/ch", optional=True, attempts=[NotifyAttempt(status=AppriseResultStatus.TIMEOUT)], ) assert result.status == AppriseResultStatus.SUCCESS assert next(iter(result)).status == AppriseResultStatus.TIMEOUT def test_notify_result_optional_does_not_mask_success(): """optional=True on an already-successful result is a no-op -- .status is still simply SUCCESS.""" result = NotifyResult( name="Slack", url="slack://t/ch", optional=True, attempts=[NotifyAttempt(status=AppriseResultStatus.SUCCESS)], ) assert result.status == AppriseResultStatus.SUCCESS def test_notify_result_weight(): """.weight defaults to 1 and stores whatever value is given (e.g. a plugin's own target count via len(service)).""" default = NotifyResult(name="Slack", url="slack://t/ch") fanned_out = NotifyResult(name="Twilio", url="twilio://x", weight=50) assert default.weight == 1 assert fanned_out.weight == 50 def test_notify_result_max_attempts_ratio(): """max_attempts is the configured ceiling; len(result)/.attempts show how many were actually used -- e.g. 1/3 means the first try succeeded.""" result = NotifyResult( name="Telegram", url="tgram://bot/chat", url_id="abc123", max_attempts=3, attempts=[NotifyAttempt(status=AppriseResultStatus.SUCCESS)], ) assert result.url_id == "abc123" assert result.max_attempts == 3 assert len(result) == 1 assert len(result.attempts) == 1 def test_notify_result_start_end_time_span_all_attempts(): """start_time is the first attempt's start, end_time is the last attempt's end, and elapsed is the difference between them -- not the sum of each attempt's own elapsed.""" first = NotifyAttempt(status=AppriseResultStatus.FAILURE, elapsed=1.0) second = NotifyAttempt(status=AppriseResultStatus.SUCCESS, elapsed=1.0) result = NotifyResult( name="Slack", url="slack://t/ch", attempts=[first, second] ) assert result.start_time == first.start_time assert result.end_time == second.end_time assert result.elapsed == ( (second.end_time - first.start_time).total_seconds() ) def test_notify_result_start_end_time_default_when_no_attempts(): """With no attempts at all, start_time/end_time still coincide -- never left unset.""" result = NotifyResult(name="Slack", url="slack://t/ch") assert result.start_time == result.end_time def test_notify_result_iterates_attempts(): """NotifyResult iterates over its NotifyAttempt entries, not log lines directly -- use .logs() for a flattened log view.""" a1 = NotifyAttempt(status=AppriseResultStatus.FAILURE) a2 = NotifyAttempt(status=AppriseResultStatus.SUCCESS) result = NotifyResult( name="Telegram", url="tgram://bot/chat", attempts=[a1, a2] ) assert list(result) == [a1, a2] assert result.attempts == (a1, a2) def test_notify_result_logs_flattens_every_attempt_in_order(): """NotifyResult.logs() yields every log entry across every attempt, in call order.""" logs1 = [NotifyLogEntry(level="WARNING", message="rate limited")] logs2 = [NotifyLogEntry(level="ERROR", message="invalid token")] result = NotifyResult( name="Telegram", url="tgram://bot/chat", attempts=[ NotifyAttempt(status=AppriseResultStatus.FAILURE, logs=logs1), NotifyAttempt(status=AppriseResultStatus.SUCCESS, logs=logs2), ], ) assert list(result.logs()) == logs1 + logs2 def test_notify_result_optional_and_tag(): """NotifyResult carries the tag tuple and optional flag through.""" result = NotifyResult( name="Discord", url="discord://w/t", tag=("devops", "alerts"), optional=True, attempts=[NotifyAttempt(status=AppriseResultStatus.FAILURE)], ) assert result.tag == ("devops", "alerts") assert result.optional is True # Absorbed by optional=True. assert bool(result) is True def test_notify_result_iter_json_and_write_json(): """Service JSON streams every field and its nested attempts.""" logs = [NotifyLogEntry(level="WARNING", message="HTTP 429")] attempt = NotifyAttempt( status=AppriseResultStatus.FAILURE, elapsed=0.5, logs=logs ) result = NotifyResult( name="Telegram", url="tgram://bot/chat", url_id="abc123", tag=("alerts",), optional=False, weight=3, max_attempts=3, attempts=[attempt], ) expected = { "name": "Telegram", "url": "tgram://bot/chat", "url_id": "abc123", "tag": ["alerts"], "status": "FAILURE", "optional": False, "weight": 3, "max_attempts": 3, "elapsed": result.elapsed, "start_time": result.start_time.strftime(AWARE_DATE_ISO_FORMAT), "end_time": result.end_time.strftime(AWARE_DATE_ISO_FORMAT), "attempts": [_json_data(attempt)], } output = "".join(result.iter_json()) assert loads(output) == expected assert ", " not in output assert ": " not in output stream = StringIO() result.write_json(stream) assert stream.getvalue() == output def test_notify_result_repr(): """NotifyResult.__repr__ is a compact, informative one-liner.""" result = NotifyResult( name="Slack", url="slack://t/ch", attempts=[NotifyAttempt(status=AppriseResultStatus.SUCCESS)], ) text = repr(result) assert "Slack" in text assert "slack://t/ch" in text assert "SUCCESS" in text def test_apprise_result_defaults(): """AppriseResult: default construction is an empty NOMATCH result.""" result = AppriseResult() assert result.status == AppriseResultStatus.NOMATCH assert len(result) == 0 assert list(result) == [] assert result.results == () assert result.success_count == 0 assert result.failed_count == 0 assert result.timeout_count == 0 assert result.elapsed == 0.0 assert bool(result) is False assert list(result.call_logs()) == [] def test_apprise_result_elapsed_custom(): """AppriseResult.elapsed stores the caller-supplied wall-clock time.""" result = AppriseResult(status=AppriseResultStatus.SUCCESS, elapsed=2.5) assert result.elapsed == 2.5 def test_apprise_result_start_end_time_match_elapsed(): """Same start_time/end_time-derived-from-elapsed guarantee as NotifyResult, at the whole-call level.""" result = AppriseResult(status=AppriseResultStatus.SUCCESS, elapsed=4.0) assert result.start_time.tzinfo is not None assert result.end_time.tzinfo is not None assert (result.end_time - result.start_time).total_seconds() == 4.0 parsed = datetime.strptime( _json_data(result)["end_time"], AWARE_DATE_ISO_FORMAT ) assert parsed == result.end_time def test_apprise_result_bool_success(): """AppriseResult.__bool__ is True only for SUCCESS.""" result = AppriseResult(status=AppriseResultStatus.SUCCESS) assert bool(result) is True def test_apprise_result_bool_failure(): """AppriseResult.__bool__ is False for FAILURE.""" result = AppriseResult(status=AppriseResultStatus.FAILURE) assert bool(result) is False def test_apprise_result_bool_nomatch(): """AppriseResult.__bool__ is False for NOMATCH.""" result = AppriseResult(status=AppriseResultStatus.NOMATCH) assert bool(result) is False def test_apprise_result_bool_timeout(): """AppriseResult.__bool__ is False for TIMEOUT.""" result = AppriseResult(status=AppriseResultStatus.TIMEOUT) assert bool(result) is False def test_apprise_result_status_exit_code_alignment(): """AppriseResultStatus values equal the CLI's historical exit codes.""" assert int(AppriseResultStatus.SUCCESS) == 0 assert int(AppriseResultStatus.FAILURE) == 1 assert int(AppriseResultStatus.NOMATCH) == 3 assert int(AppriseResultStatus.PARTIAL) == 4 def test_apprise_result_timeout_status_value(): """TIMEOUT is the highest-numbered status value (5).""" assert int(AppriseResultStatus.TIMEOUT) == 5 def _notify_result(name, url, status): """Test helper: build a one-attempt NotifyResult with the given reflective status (SUCCESS/FAILURE/TIMEOUT), for tests that only care about the aggregate outcome, not attempt-level detail.""" return NotifyResult(name=name, url=url, attempts=[NotifyAttempt(status)]) def test_apprise_result_len_and_iter(): """AppriseResult.__len__/__iter__ walk the collected NotifyResults.""" r1 = _notify_result("Slack", "slack://t/ch", AppriseResultStatus.SUCCESS) r2 = _notify_result( "Discord", "discord://w/t", AppriseResultStatus.FAILURE ) result = AppriseResult( status=AppriseResultStatus.FAILURE, results=[r1, r2] ) assert len(result) == 2 assert list(result) == [r1, r2] assert result.results == (r1, r2) def test_apprise_result_success_and_failed_counts(): """success_count/failed_count are derived from each NotifyResult's reflective .status, and timeout_count narrows failed_count down to just TIMEOUT entries.""" results = [ _notify_result("Slack", "slack://t/ch", AppriseResultStatus.SUCCESS), _notify_result( "Discord", "discord://w/t", AppriseResultStatus.FAILURE ), _notify_result("Telegram", "tgram://b/c", AppriseResultStatus.SUCCESS), _notify_result("Twilio", "twilio://x", AppriseResultStatus.TIMEOUT), ] result = AppriseResult(status=AppriseResultStatus.FAILURE, results=results) assert result.success_count == 2 assert result.failed_count == 2 assert result.timeout_count == 1 def test_apprise_result_logs_merges_and_sorts_across_services(): """AppriseResult.logs() combines every service's log entries into one chronological timeline -- not simply service by service, since services dispatched concurrently can log in any relative order to each other regardless of which NotifyResult they end up attached to.""" early = datetime(2026, 1, 1, 12, 0, 0, tzinfo=timezone.utc) middle = datetime(2026, 1, 1, 12, 0, 1, tzinfo=timezone.utc) late = datetime(2026, 1, 1, 12, 0, 2, tzinfo=timezone.utc) # Discord's own NotifyResult is built first, but its one log entry # actually happened AFTER Slack's -- e.g. two services notified # concurrently, with Discord simply finishing (and being appended # to the batch) first. discord = NotifyResult( name="Discord", url="discord://w/t", attempts=[ NotifyAttempt( status=AppriseResultStatus.SUCCESS, logs=[ NotifyLogEntry( level="WARNING", message="from discord", time=late ) ], ) ], ) slack = NotifyResult( name="Slack", url="slack://t/ch", attempts=[ NotifyAttempt( status=AppriseResultStatus.SUCCESS, logs=[ NotifyLogEntry( level="WARNING", message="from slack", time=early ), NotifyLogEntry( level="ERROR", message="from slack, later", time=middle ), ], ) ], ) result = AppriseResult( status=AppriseResultStatus.SUCCESS, results=[discord, slack] ) messages = [entry.message for entry in result.logs()] assert messages == ["from slack", "from slack, later", "from discord"] def test_apprise_result_call_logs(): """Call logs expose a read-only snapshot of orchestration entries.""" t = datetime(2026, 1, 1, 12, 0, 0, tzinfo=timezone.utc) entries = [ NotifyLogEntry( level="WARNING", message="no services to notify", time=t ) ] result = AppriseResult( status=AppriseResultStatus.NOMATCH, call_logs=entries ) assert list(result.call_logs()) == entries # Mutating the input list afterwards must not affect the snapshot. entries.append( NotifyLogEntry(level="WARNING", message="late addition", time=t) ) assert len(list(result.call_logs())) == 1 def test_result_logs_merge_call_logs(): """Combined logs merge call and service entries by time.""" early = datetime(2026, 1, 1, 12, 0, 0, tzinfo=timezone.utc) middle = datetime(2026, 1, 1, 12, 0, 1, tzinfo=timezone.utc) late = datetime(2026, 1, 1, 12, 0, 2, tzinfo=timezone.utc) slack = NotifyResult( name="Slack", url="slack://t/ch", attempts=[ NotifyAttempt( status=AppriseResultStatus.SUCCESS, logs=[ NotifyLogEntry( level="WARNING", message="from slack", time=middle ) ], ) ], ) call_logs = [ NotifyLogEntry( level="TRACE", message="starting attempt 1/1", time=early ), NotifyLogEntry(level="TRACE", message="attempt finished", time=late), ] result = AppriseResult( status=AppriseResultStatus.SUCCESS, results=[slack], call_logs=call_logs, ) messages = [entry.message for entry in result.logs()] assert messages == [ "starting attempt 1/1", "from slack", "attempt finished", ] def test_apprise_result_iter_json_and_write_json(): """Overall JSON streams summary fields and every service result.""" results = [ _notify_result("Slack", "slack://t/ch", AppriseResultStatus.SUCCESS), _notify_result( "Discord", "discord://w/t", AppriseResultStatus.FAILURE ), ] result = AppriseResult( status=AppriseResultStatus.FAILURE, results=results, elapsed=0.75 ) expected = { "status": "FAILURE", "success_count": 1, "failed_count": 1, "elapsed": 0.75, "start_time": result.start_time.strftime(AWARE_DATE_ISO_FORMAT), "end_time": result.end_time.strftime(AWARE_DATE_ISO_FORMAT), "results": [_json_data(item) for item in results], "call_logs": [], } output = "".join(result.iter_json()) assert loads(output) == expected assert ", " not in output assert ": " not in output stream = StringIO() result.write_json(stream) assert stream.getvalue() == output def test_result_json_includes_call_logs(): """Bounded result JSON includes call-level logs.""" t = datetime(2026, 1, 1, 12, 0, 0, tzinfo=timezone.utc) entries = [NotifyLogEntry(level="WARNING", message="no services", time=t)] result = AppriseResult( status=AppriseResultStatus.NOMATCH, call_logs=entries ) assert _json_data(result)["call_logs"] == [e.asdict() for e in entries] def test_apprise_result_repr(): """AppriseResult.__repr__ reports status and entry count.""" result = AppriseResult( status=AppriseResultStatus.SUCCESS, results=[ _notify_result( "Slack", "slack://t/ch", AppriseResultStatus.SUCCESS ) ], ) text = repr(result) assert "SUCCESS" in text assert "1" in text def test_apprise_result_results_is_read_only_view(): """.results is a snapshot tuple; mutating the input list afterwards does not affect it.""" source = [ _notify_result("Slack", "slack://t/ch", AppriseResultStatus.SUCCESS) ] result = AppriseResult(status=AppriseResultStatus.SUCCESS, results=source) source.append( _notify_result("Discord", "discord://w/t", AppriseResultStatus.FAILURE) ) assert len(result) == 1 assert len(result.results) == 1 def test_apprise_result_closes_disk_backed_logs(): """Closing a result releases temporary files held by its log stores.""" from apprise.logger import _LogCaptureBudget, _NotifyLogStore call_logs = _NotifyLogStore( _LogCaptureBudget(memory_size=0, disk_size=4096) ) attempt_logs = _NotifyLogStore( _LogCaptureBudget(memory_size=0, disk_size=4096) ) call_logs.append(NotifyLogEntry("WARNING", "call")) attempt_logs.append(NotifyLogEntry("WARNING", "attempt")) service = NotifyResult( name="Slack", url="slack://t/ch", attempts=[ NotifyAttempt( status=AppriseResultStatus.SUCCESS, logs=attempt_logs ) ], ) with AppriseResult( status=AppriseResultStatus.SUCCESS, results=[service], call_logs=call_logs, ) as result: assert [entry.message for entry in result.logs()] == [ "call", "attempt", ] assert call_logs._budget._disk is None assert attempt_logs._budget._disk is None # Closing ordinary list-backed results is also a safe no-op. AppriseResult( results=[ NotifyResult( name="Slack", url="slack://t/ch", attempts=[NotifyAttempt(AppriseResultStatus.SUCCESS)], ) ] ).close() caronc-apprise-dfec414/tests/test_retry_wait.py000066400000000000000000005631221526720371000220740ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. import asyncio from contextlib import contextmanager import logging import threading import time from unittest import mock import pytest from apprise import LOGGER_NAME, Apprise, AppriseAsset, AppriseResultStatus from apprise.common import ( APPRISE_MAX_SERVICE_RETRY, APPRISE_MAX_SERVICE_WAIT, MATCH_ALL_TAG, ) from apprise.config.base import ConfigBase from apprise.exception import AppriseImproperlyConfigured from apprise.manager_plugins import NotificationManager from apprise.plugins import NotifyBase from apprise.tag import AppriseTag logging.disable(logging.CRITICAL) N_MGR = NotificationManager() @contextmanager def apprise_logs_enabled(level=logging.TRACE): """Re-enable apprise logging so a test can inspect captured entries.""" # This module silences logging outright, which would keep every record # away from the captures a result is built from. apprise_logger = logging.getLogger(LOGGER_NAME) restore_level = apprise_logger.level apprise_logger.setLevel(level) logging.disable(logging.NOTSET) try: yield finally: # Put the module back the way the rest of the file expects it. logging.disable(logging.CRITICAL) apprise_logger.setLevel(restore_level) def wait_until(condition, timeout=5.0): """Check ``condition`` until it is true or ``timeout`` seconds pass.""" # Poll because background work finishes asynchronously. deadline = time.monotonic() + timeout while not condition() and time.monotonic() < deadline: time.sleep(0.02) class _TestNotify(NotifyBase): """Test notification plugin -- controlled pass/fail via side_effect.""" app_id = "TestApp" app_desc = "Test" notify_url = "test://" title_maxlen = 250 body_maxlen = 32768 # Override so NotifyBase doesn't reject the URL def url(self, privacy=False, *args, **kwargs): return "test://localhost" def send(self, **kwargs): return True @staticmethod def parse_url(url): results = NotifyBase.parse_url(url, verify_host=False) return results class TestWaitValidation: """Tests for the wait= parameter accepted by NotifyBase.""" def _make(self, **kwargs): return _TestNotify(host="localhost", **kwargs) @pytest.mark.parametrize( "value,expected", [ (0, 0.0), (0.0, 0.0), (0.5, 0.5), (1, 1.0), (1.0, 1.0), ("0.5", 0.5), ("1", 1.0), ("1.4", 1.4), ("20", 20.0), (APPRISE_MAX_SERVICE_WAIT, APPRISE_MAX_SERVICE_WAIT), ], ) def test_valid_wait(self, value, expected): nb = self._make(wait=value) assert nb.wait == pytest.approx(expected) def test_wait_clamped_to_max(self): # Values above the cap are clamped, not rejected nb = self._make(wait=APPRISE_MAX_SERVICE_WAIT + 9999) assert nb.wait == pytest.approx(APPRISE_MAX_SERVICE_WAIT) @pytest.mark.parametrize( "bad_value", [ "-3", "-0.1", "1.3.3.", "abc", "inf", "-inf", "nan", None, # None means "use asset default" -- tested separately ], ) def test_invalid_wait_uses_asset_default(self, bad_value): if bad_value is None: # Not passing wait= at all should use asset default asset = AppriseAsset(default_service_wait=1.25) nb = _TestNotify(host="localhost", asset=asset) assert nb.wait == pytest.approx(1.25) return asset = AppriseAsset(default_service_wait=0.75) nb = self._make(wait=bad_value, asset=asset) # Falls back to asset default on invalid input assert nb.wait == pytest.approx(0.75) def test_negative_wait_falls_back(self): asset = AppriseAsset(default_service_wait=2.0) nb = self._make(wait=-1.0, asset=asset) assert nb.wait == pytest.approx(2.0) def test_asset_default_zero(self): asset = AppriseAsset(default_service_wait=0.0) nb = _TestNotify(host="localhost", asset=asset) assert nb.wait == pytest.approx(0.0) def test_asset_default_clamped_to_max(self): asset = AppriseAsset(default_service_wait=APPRISE_MAX_SERVICE_WAIT + 1) nb = _TestNotify(host="localhost", asset=asset) assert nb.wait == pytest.approx(APPRISE_MAX_SERVICE_WAIT) class TestRetryValidation: """Sanity checks for the retry= parameter.""" def _make(self, **kwargs): return _TestNotify(host="localhost", **kwargs) @pytest.mark.parametrize( "value,expected", [ (0, 0), (1, 1), ("3", 3), (APPRISE_MAX_SERVICE_RETRY, APPRISE_MAX_SERVICE_RETRY), ], ) def test_valid_retry(self, value, expected): nb = self._make(retry=value) assert nb.retry == expected def test_retry_clamped_to_max(self): nb = self._make(retry=APPRISE_MAX_SERVICE_RETRY + 999) assert nb.retry == APPRISE_MAX_SERVICE_RETRY @pytest.mark.parametrize("bad", ["-1", "abc", "1.3.3."]) def test_invalid_retry_uses_asset_default(self, bad): asset = AppriseAsset(default_service_retry=2) nb = self._make(retry=bad, asset=asset) assert nb.retry == 2 class TestUrlRoundTrip: def test_wait_in_url_parameters(self): nb = _TestNotify(host="localhost", wait=1.5, retry=2) params = nb.url_parameters() assert "wait" in params assert params["wait"] == "1.5" assert "retry" in params assert params["retry"] == "2" def test_wait_zero_always_in_url_parameters(self): """retry= and wait= are always present, even at their zero defaults.""" nb = _TestNotify(host="localhost", wait=0.0, retry=0) params = nb.url_parameters() assert "wait" in params assert params["wait"] == "0.0" assert "retry" in params assert params["retry"] == "0" def test_parse_url_extracts_wait(self): results = _TestNotify.parse_url("test://localhost?wait=2.5&retry=3") assert results is not None assert results.get("wait") == "2.5" assert results.get("retry") == "3" def test_parse_url_no_wait_key_absent(self): results = _TestNotify.parse_url("test://localhost") assert results is not None assert "wait" not in results class _FailThenSucceedNotify(NotifyBase): """Fails the first N calls, then succeeds.""" app_id = "FailThenSucceed" app_desc = "Test" notify_url = "failpass://" title_maxlen = 250 body_maxlen = 32768 def __init__(self, fail_times=1, **kwargs): super().__init__(**kwargs) self._fail_times = fail_times self._calls = 0 def url(self, *args, **kwargs): return "failpass://localhost" def send(self, **kwargs): self._calls += 1 return not self._calls <= self._fail_times async def async_notify(self, **kwargs): return self.send(**kwargs) @staticmethod def parse_url(url): return NotifyBase.parse_url(url, verify_host=False) class TestSequentialSleep: """time.sleep is called between retries in sequential dispatch.""" def test_sleep_called_on_retry(self): """A failed attempt waits once before its successful retry.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) a = Apprise(asset=asset) service = _FailThenSucceedNotify( host="localhost", asset=asset, retry=2, wait=0.3, ) a.add(service) with mock.patch("apprise.apprise.time.sleep") as mock_sleep: result = a.notify(body="test") assert bool(result) is True # Failed once -> sleep once before retry mock_sleep.assert_called_once_with(pytest.approx(0.3)) finally: N_MGR.unload_modules() def test_sleep_not_called_when_wait_zero(self): """A zero wait setting retries without calling sleep.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) a = Apprise(asset=asset) service = _FailThenSucceedNotify( host="localhost", asset=asset, retry=2, wait=0.0, ) a.add(service) with mock.patch("apprise.apprise.time.sleep") as mock_sleep: result = a.notify(body="test") assert bool(result) is True mock_sleep.assert_not_called() finally: N_MGR.unload_modules() def test_sleep_not_called_when_no_retry(self): """A service without retries never sleeps after failure.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) a = Apprise(asset=asset) # retry=0 means only one attempt; with wait=1.0 sleep should # never fire since there are no retries service = _FailThenSucceedNotify( host="localhost", asset=asset, retry=0, wait=1.0, fail_times=0, # always succeeds ) a.add(service) with mock.patch("apprise.apprise.time.sleep") as mock_sleep: result = a.notify(body="test") assert bool(result) is True mock_sleep.assert_not_called() finally: N_MGR.unload_modules() def test_sleep_called_multiple_times(self): """Fails twice, succeeds on third attempt -> sleep called twice.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) a = Apprise(asset=asset) service = _FailThenSucceedNotify( host="localhost", asset=asset, retry=3, wait=0.5, fail_times=2, ) a.add(service) with mock.patch("apprise.apprise.time.sleep") as mock_sleep: result = a.notify(body="test") assert bool(result) is True assert mock_sleep.call_count == 2 for call in mock_sleep.call_args_list: assert call == mock.call(pytest.approx(0.5)) finally: N_MGR.unload_modules() class TestThreadPoolSleep: """time.sleep is called between retries in threadpool dispatch.""" def test_sleep_called_in_threadpool(self): """A thread-pool retry honors the configured wait interval.""" N_MGR["failpass"] = _FailThenSucceedNotify try: # async_mode=True -> uses threadpool when > 1 service; # but with a single service it falls through to sequential. # Use two services so we actually hit the threadpool path. asset = AppriseAsset(async_mode=True) # Two separate service objects so a threadpool is used s1 = _FailThenSucceedNotify( host="localhost", asset=asset, retry=2, wait=0.2, fail_times=1, ) s2 = _FailThenSucceedNotify( host="localhost2", asset=asset, retry=0, wait=0.0, fail_times=0, ) a = Apprise(asset=asset) a.add(s1) a.add(s2) with mock.patch("apprise.apprise.time.sleep") as mock_sleep: result = a.notify(body="test") assert bool(result) is True # s1 fails once -> sleep once mock_sleep.assert_called_once_with(pytest.approx(0.2)) finally: N_MGR.unload_modules() def test_sleep_not_called_in_threadpool_when_wait_zero(self): """A zero thread-pool wait retries without calling sleep.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=True) s1 = _FailThenSucceedNotify( host="localhost", asset=asset, retry=2, wait=0.0, fail_times=1, ) s2 = _FailThenSucceedNotify( host="localhost2", asset=asset, retry=0, wait=0.0, fail_times=0, ) a = Apprise(asset=asset) a.add(s1) a.add(s2) with mock.patch("apprise.apprise.time.sleep") as mock_sleep: result = a.notify(body="test") assert bool(result) is True mock_sleep.assert_not_called() finally: N_MGR.unload_modules() class TestAsyncioSleep: """asyncio.sleep is called between retries in async dispatch.""" def test_asyncio_sleep_called(self): """An asynchronous retry honors the configured wait interval.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset() service = _FailThenSucceedNotify( host="localhost", asset=asset, retry=2, wait=0.4, fail_times=1, ) a = Apprise(asset=asset) a.add(service) async def run(): """Dispatch while capturing the asynchronous retry sleep.""" with mock.patch("apprise.apprise.asyncio.sleep") as mock_sleep: mock_sleep.return_value = None result = await a.async_notify(body="test") return result, mock_sleep result, mock_sleep = asyncio.run(run()) assert bool(result) is True mock_sleep.assert_called_once_with(pytest.approx(0.4)) finally: N_MGR.unload_modules() def test_asyncio_sleep_not_called_when_wait_zero(self): """A zero asynchronous wait retries without calling sleep.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset() service = _FailThenSucceedNotify( host="localhost", asset=asset, retry=2, wait=0.0, fail_times=1, ) a = Apprise(asset=asset) a.add(service) async def run(): """Dispatch while checking that asyncio.sleep is unused.""" with mock.patch("apprise.apprise.asyncio.sleep") as mock_sleep: mock_sleep.return_value = None result = await a.async_notify(body="test") return result, mock_sleep result, mock_sleep = asyncio.run(run()) assert bool(result) is True mock_sleep.assert_not_called() finally: N_MGR.unload_modules() class TestAssetDefault: def test_asset_wait_default_used(self): asset = AppriseAsset(default_service_wait=1.5) nb = _TestNotify(host="localhost", asset=asset) assert nb.wait == pytest.approx(1.5) def test_explicit_wait_overrides_asset(self): asset = AppriseAsset(default_service_wait=1.5) nb = _TestNotify(host="localhost", asset=asset, wait=0.2) assert nb.wait == pytest.approx(0.2) def test_asset_retry_default_used(self): asset = AppriseAsset(default_service_retry=3) nb = _TestNotify(host="localhost", asset=asset) assert nb.retry == 3 def test_explicit_retry_overrides_asset(self): asset = AppriseAsset(default_service_retry=3) nb = _TestNotify(host="localhost", asset=asset, retry=1) assert nb.retry == 1 class _RaisingNotify(NotifyBase): """Plugin that raises a bare Exception from notify().""" app_id = "RaisingApp" app_desc = "Test" notify_url = "raise://" title_maxlen = 250 body_maxlen = 32768 def url(self, *args, **kwargs): """Return the stable URL for this raising test plugin.""" return "raise://localhost" def send(self, **kwargs): """Raise a delivery error for synchronous exception tests.""" raise RuntimeError("plugin exploded") async def async_notify(self, **kwargs): """Raise a delivery error for asynchronous exception tests.""" raise RuntimeError("plugin exploded async") @staticmethod def parse_url(url): """Parse the synthetic URL without requiring a real host.""" return NotifyBase.parse_url(url, verify_host=False) class _BadFormatNotify(NotifyBase): """Plugin that raises while its content is prepared. The failure lands before any service is dispatched. ``error`` picks what resolve_format() raises, so a test can show the guard is not limited to TypeError. """ app_id = "BadFormatApp" app_desc = "Test" service_name = "BadFormat" notify_url = "badformat://" title_maxlen = 250 body_maxlen = 32768 def __init__(self, error=None, **kwargs): """Initialize with the exception preparation should raise.""" super().__init__(**kwargs) self._error = error or TypeError("bad format resolution") def resolve_format(self, body_format=None): """Fail the way a buggy plugin would, before anything is sent.""" raise self._error def url(self, *args, **kwargs): """Return the stable URL for this misbehaving test plugin.""" return "badformat://localhost" def send(self, **kwargs): """Never reached; preparation fails before delivery starts.""" return True @staticmethod def parse_url(url): """Parse the synthetic URL without requiring a real host.""" return NotifyBase.parse_url(url, verify_host=False) class _SlowNotify(NotifyBase): """Plugin whose send() blocks for a configurable delay before reporting success -- used to exercise AppriseAsset._service_timeout and notify(timeout=...) enforcement with real wall-clock timing.""" app_id = "SlowApp" app_desc = "Test" notify_url = "slow://" title_maxlen = 250 body_maxlen = 32768 def __init__(self, delay=0.0, **kwargs): """Initialize the test plugin with its artificial delay.""" super().__init__(**kwargs) self._delay = delay self.calls = 0 def url(self, *args, **kwargs): """Return a stable URL containing the test host.""" return "slow://{}".format(self.host) def send(self, **kwargs): """Simulate blocking delivery before reporting success.""" self.calls += 1 time.sleep(self._delay) return True async def async_notify(self, **kwargs): """Simulate asynchronous delivery before reporting success.""" self.calls += 1 await asyncio.sleep(self._delay) return True @staticmethod def parse_url(url): """Parse the synthetic URL without requiring a real host.""" return NotifyBase.parse_url(url, verify_host=False) class TestAppriseTag: """Full branch coverage for AppriseTag.""" def test_parse_returns_same_instance(self): """parse() short-circuits when the input is already an AppriseTag.""" t = AppriseTag("alerts", priority=2) # Must return the exact same object, not a copy assert AppriseTag.parse(t) is t def test_parse_fallback_for_unrecognised_input(self): """parse() falls back to a raw-name tag when the regex has no match.""" # Input starting with '@' does not match _RE_TAG; the fallback branch # stores the whole input as the name. t = AppriseTag.parse("@invalid") assert str(t) == "@invalid" assert t.priority == 0 assert t.retry is None # --- __repr__ --- def test_repr_plain(self): """repr() with default priority and no retry is minimal.""" assert repr(AppriseTag("simple")) == "AppriseTag('simple')" def test_repr_with_priority(self): """repr() includes priority= when the priority is non-zero.""" r = repr(AppriseTag("test", priority=3)) assert "priority=3" in r def test_repr_with_retry(self): """repr() includes retry= when a retry count is set.""" r = repr(AppriseTag("test", retry=5)) assert "retry=5" in r def test_repr_with_priority_and_retry(self): """repr() includes both fields when both are non-default.""" r = repr(AppriseTag("test", priority=2, retry=3)) assert "priority=2" in r assert "retry=3" in r # --- __eq__ --- def test_eq_two_apprisetags_same_name(self): """Two AppriseTag objects are equal when their names match, regardless of priority or retry.""" assert AppriseTag("abc") == AppriseTag("abc", priority=5) assert AppriseTag("ABC") == AppriseTag("abc") def test_eq_with_string(self): """An AppriseTag equals a plain str by name.""" assert AppriseTag("hello") == "hello" assert AppriseTag("HELLO") == "hello" def test_eq_not_equal_different_name(self): assert AppriseTag("abc") != AppriseTag("xyz") assert AppriseTag("abc") != "xyz" def test_eq_returns_notimplemented_for_other_types(self): """Comparing to a non-str/AppriseTag returns NotImplemented""" result = AppriseTag("abc").__eq__(42) assert result is NotImplemented # --- __lt__ --- def test_lt_two_apprisetags(self): """__lt__ sorts two AppriseTag objects by tag name.""" assert AppriseTag("abc") < AppriseTag("def") assert not (AppriseTag("def") < AppriseTag("abc")) def test_lt_with_string(self): """AppriseTag can be ordered against a plain string.""" assert AppriseTag("abc") < "def" assert not (AppriseTag("zzz") < "aaa") def test_lt_returns_notimplemented_for_other_types(self): """__lt__ with non-str/AppriseTag returns NotImplemented""" result = AppriseTag("abc").__lt__(42) assert result is NotImplemented # --- __bool__ --- def test_bool_empty_tag_is_false(self): """An AppriseTag with an empty name is falsy""" assert not AppriseTag("") assert bool(AppriseTag("")) is False def test_bool_nonempty_tag_is_true(self): assert bool(AppriseTag("something")) is True # --- set / dict integration --- def test_apprisetag_in_set_with_plain_string(self): """AppriseTag in a set is found by plain string membership test.""" s = {AppriseTag("endpoint")} assert "endpoint" in s def test_plain_string_in_set_with_apprisetag(self): """A plain string is found in a set containing AppriseTag.""" s = {"endpoint"} assert AppriseTag("endpoint") in s class TestStaticHelpers: """Cover priority helpers not reached by integration tests.""" def test_set_filter_tokens_are_ordered(self): """A set filter yields the same token order every run. Sorting prevents Python's changing set order from selecting a different retry value in another process. """ tokens = Apprise._parse_filter_tokens({"b:2", "a:1", "c:3"}) assert [str(t) for t in tokens] == ["a", "b", "c"] # The same filter written as a list keeps the caller's own order. tokens = Apprise._parse_filter_tokens(["b:2", "a:1", "c:3"]) assert [str(t) for t in tokens] == ["b", "a", "c"] def test_set_filter_chains_are_ordered(self): """A set filter puts a service in the same chain every run. A service with several matching tags must not move between chains when the process restarts. """ class _MultiTagged: """Service carrying both tags the filter names.""" tags = {"alpha", "beta"} chains = Apprise._build_tag_chains( [(_MultiTagged(), {})], {"beta", "alpha"} ) assert sorted(chains) == ["alpha"] def test_service_priority_for_tag_name_absent(self): """Returns 0 when no tag in service.tags matches tag_name.""" service = mock.Mock() service.tags = {AppriseTag("alerts", priority=3, has_priority=True)} assert Apprise._service_priority_for_tag_name(service, "backup") == 0 def test_match_service_retry_plain_string_tag(self): """Plain string in service.tags matched by a priority-prefixed token. Covers the string fallback when a matching service tag is not an AppriseTag instance. """ service = mock.Mock() service.tags = {"alerts"} # plain string, not an AppriseTag # "3:alerts:2" carries priority=3 + retry=2; plain "alerts" matches retry_tokens = Apprise._parse_retry_filter_tokens("3:alerts:2") result = Apprise._match_service_retry(service, retry_tokens) assert result == 2 def test_match_service_retry_plain_string_tag_no_match(self): """Plain string in service.tags that does not match returns None.""" service = mock.Mock() service.tags = {"other"} # plain string -- does not match "alerts" retry_tokens = Apprise._parse_retry_filter_tokens("3:alerts:2") result = Apprise._match_service_retry(service, retry_tokens) assert result is None def test_inject_per_service_retries_mixed_matches(self): """Only matching services receive the retry override.""" matching = mock.Mock() matching.tags = {"alerts"} other = mock.Mock() other.tags = {"other"} all_calls = [(matching, {}), (other, {})] result = Apprise._inject_per_service_retries(all_calls, "3:alerts:2") matching_kwargs = next(k for s, k in result if s is matching) other_kwargs = next(k for s, k in result if s is other) assert matching_kwargs["_retry_override"] == 2 assert "_retry_override" not in other_kwargs def test_inject_per_service_retries_no_retry_tokens(self): """A tag filter with no retry suffix leaves every call unchanged.""" service = mock.Mock() service.tags = {"alerts"} all_calls = [(service, {})] result = Apprise._inject_per_service_retries(all_calls, "alerts") assert result == all_calls def test_resolve_retry_count_clamps_override(self): """Clamp tag retry overrides to the same limit as plugin URLs.""" from apprise.common import APPRISE_MAX_SERVICE_RETRY from apprise.dispatch import resolve_retry_count service = mock.Mock() service.retry = 0 # A huge override is clamped down to the documented ceiling. kwargs = {"_retry_override": 1000000000} assert ( resolve_retry_count(service, kwargs) == APPRISE_MAX_SERVICE_RETRY ) # The override key is always consumed, even when clamped. assert "_retry_override" not in kwargs # A negative override is clamped up to zero, not left negative. assert resolve_retry_count(service, {"_retry_override": -5}) == 0 # A within-range override passes through unchanged. assert resolve_retry_count(service, {"_retry_override": 3}) == 3 # No override at all falls back to the plugin's own (already # clamped) retry attribute. service.retry = 4 assert resolve_retry_count(service, {}) == 4 # Invalid overrides fall back to the service's retry value. service.retry = 2 assert resolve_retry_count(service, {"_retry_override": "x"}) == 2 def test_configured_max_attempts_preserves_override(self): """Read timeout metadata without consuming the worker's override.""" from apprise.dispatch import configured_max_attempts service = mock.Mock() service.retry = 1 # The timeout result and worker must see the same retry limit. kwargs = {"_retry_override": 3} assert configured_max_attempts(service, kwargs) == 4 assert kwargs == {"_retry_override": 3} def test_configured_max_attempts_handles_bad_metadata(self): """Leave invalid plugin metadata for the worker safety net.""" from apprise.dispatch import configured_max_attempts class BrokenRetry: @property def retry(self): # A plugin property may fail before its worker starts. raise RuntimeError("bad retry metadata") assert configured_max_attempts(BrokenRetry(), {}) == 1 def test_retry_override_end_to_end_is_bounded(self): """Prevent a huge tag retry suffix from creating an unbounded loop.""" from apprise.common import APPRISE_MAX_SERVICE_RETRY N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False, service_timeout=0) # fail_times higher than the clamp so every attempt fails and # the loop runs out its full (clamped) retry budget. service = _FailThenSucceedNotify( host="x", asset=asset, fail_times=10**9 ) service.tags = {"alerts"} a = Apprise(asset=asset) a.add(service) result = a.notify(body="test", tag="alerts:1000000000") assert bool(result) is False assert service._calls == APPRISE_MAX_SERVICE_RETRY + 1 assert ( result.results[0].max_attempts == APPRISE_MAX_SERVICE_RETRY + 1 ) finally: N_MGR.unload_modules() def test_apprise_tag_parse_rejects_absurd_digit_runs(self): """Ignore numeric tag fields that exceed Python's conversion limit.""" huge_digits = "9" * 5000 # An absurd retry suffix falls back to retry=None instead of # raising ValueError out of parse(). parsed = AppriseTag.parse(f"alerts:{huge_digits}") assert str(parsed) == "alerts" assert parsed.retry is None # An unusable priority is absent and must not select flat dispatch. parsed = AppriseTag.parse(f"{huge_digits}:alerts") assert str(parsed) == "alerts" assert parsed.priority == 0 assert parsed.has_priority is False assert ( Apprise._filter_has_explicit_priority([f"{huge_digits}:alerts"]) is False ) # A normal, reasonably-sized value is unaffected by the guard. parsed = AppriseTag.parse("3:alerts:5") assert parsed.priority == 3 assert parsed.retry == 5 assert parsed.has_priority is True assert Apprise._filter_has_explicit_priority(["3:alerts:5"]) is True def test_service_metadata_survives_bad_tag_str(self): """Fall back safely when a custom tag cannot convert to text.""" from apprise.dispatch import service_metadata class _BadTag: def __str__(self): raise RuntimeError("boom") service = mock.Mock() service.service_name = "Test" service.url.return_value = "test://" service.url_id.return_value = "abc" service.__len__ = mock.Mock(return_value=1) service.tags = {_BadTag()} name, url, url_id, tag, weight = service_metadata(service) assert name == "Test" assert url == "test://" assert url_id == "abc" assert tag == () assert weight == 1 def test_notify_succeeds_despite_bad_tag_str(self): """Keep a successful result when custom tag conversion fails.""" class _BadTag: def __str__(self): raise RuntimeError("boom") class _AlwaysSucceed(NotifyBase): def send(self, body, title="", notify_type=None, **kwargs): return True service = _AlwaysSucceed(host="x", asset=AppriseAsset()) service.tags = {_BadTag()} a = Apprise() a.add(service) result = a.notify(body="test") assert bool(result) is True assert result.results[0].tag == () def test_has_priority_nested_list(self): """A priority prefix is found inside a nested list.""" assert Apprise._filter_has_explicit_priority([["2:alerts"]]) def test_has_priority_list_of_strings(self): """A priority prefix is found in a plain-string list.""" assert Apprise._filter_has_explicit_priority(["2:alerts"]) def test_has_priority_false_no_prefix(self): """Filters without a prefix do not carry explicit priority.""" assert not Apprise._filter_has_explicit_priority("alerts") assert not Apprise._filter_has_explicit_priority(["alerts"]) def test_has_priority_false_for_match_all(self): """Match-all filters do not carry an explicit priority.""" assert not Apprise._filter_has_explicit_priority(MATCH_ALL_TAG) assert not Apprise._filter_has_explicit_priority(None) # _notify_parallel_threadpool / _notify_parallel_asyncio zero-length ----- def test_threadpool_zero_services_returns_true(self): """Empty service list returns (True, []) immediately.""" ok, results = Apprise._notify_parallel_threadpool() assert ok is True assert results == [] def test_asyncio_zero_services_returns_true(self): """Empty service list returns (True, []) immediately.""" ok, results = asyncio.run(Apprise._notify_parallel_asyncio()) assert ok is True assert results == [] class TestDispatchIntegration: """End-to-end notify() tests covering the new priority/retry dispatch.""" def _make_service(self, host, priority, asset, fail_times=0): """Create a _FailThenSucceedNotify with an AppriseTag in its tags.""" s = _FailThenSucceedNotify( host=host, asset=asset, fail_times=fail_times ) # Assign a fresh instance-level set rather than mutating the # class-level tags set. URLBase.tags is a class attribute (set()); # .add() would mutate it and share state across all instances. # Assignment shadows the class attribute and gives each service its # own set with the correct priority stored in the AppriseTag object. s.tags = {AppriseTag("alerts", priority=priority, has_priority=True)} return s def test_filter_retry_override_via_tag_suffix(self): """tag suffix ':N' overrides per-service retry for this call only.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) # Service's own retry=0; tag suffix of 2 should allow 3 attempts service = _FailThenSucceedNotify( host="localhost", asset=asset, retry=0, wait=0.0, fail_times=2, ) # Tag the service so the filter "failpass:2" (tag name "failpass", # retry override 2) can match it via is_exclusive_match. service.tags = {"failpass"} a = Apprise(asset=asset) a.add(service) # "failpass:2" -> retry override of 2 (3 total attempts) result = a.notify(body="test", tag="failpass:2") assert bool(result) is True assert service._calls == 3 finally: N_MGR.unload_modules() def test_exclusive_priority_dispatch_skips_other_priorities(self): """An explicit priority dispatches only matching-priority services.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s1 = self._make_service("host1", priority=1, asset=asset) s2 = self._make_service("host2", priority=2, asset=asset) a = Apprise(asset=asset) a.add(s1) a.add(s2) # "2:alerts" -> only priority-2 service fires result = a.notify(body="test", tag="2:alerts") assert bool(result) is True assert s1._calls == 0 # priority-1, not contacted assert s2._calls == 1 # priority-2, contacted once finally: N_MGR.unload_modules() def test_escalation_stops_after_priority_success(self): """If priority-1 group all succeed, priority-2 group is not run.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s1 = self._make_service("host1", priority=1, asset=asset) s2 = self._make_service("host2", priority=2, asset=asset) a = Apprise(asset=asset) a.add(s1) a.add(s2) result = a.notify(body="test", tag="alerts") assert bool(result) is True assert s1._calls == 1 # priority 1 succeeded assert s2._calls == 0 # never escalated to finally: N_MGR.unload_modules() def test_escalation_triggers_on_priority_group_failure(self): """Priority-1 group failure escalates to priority-2 group.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) # priority-1 always fails s1 = self._make_service( "host1", priority=1, asset=asset, fail_times=999 ) # priority-2 always succeeds s2 = self._make_service("host2", priority=2, asset=asset) a = Apprise(asset=asset) a.add(s1) a.add(s2) result = a.notify(body="test", tag="alerts") assert bool(result) is True assert s1._calls == 1 assert s2._calls == 1 finally: N_MGR.unload_modules() def test_async_notify_filter_retry_and_explicit_priority(self): """async_notify() supports escalation and exclusive priority paths.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset() s1 = self._make_service("host1", priority=1, asset=asset) s2 = self._make_service("host2", priority=2, asset=asset) a = Apprise(asset=asset) a.add(s1) a.add(s2) async def run_exclusive(): """Dispatch only the explicitly selected priority.""" return await a.async_notify(body="test", tag="2:alerts") async def run_escalation(): """Dispatch the first successful escalation group.""" return await a.async_notify(body="test", tag="alerts") # exclusive: only priority-2 fires r = asyncio.run(run_exclusive()) assert bool(r) is True assert s1._calls == 0 assert s2._calls == 1 # escalation: priority-1 succeeds, priority-2 skipped s1._calls = 0 s2._calls = 0 r = asyncio.run(run_escalation()) assert bool(r) is True assert s1._calls == 1 assert s2._calls == 0 finally: N_MGR.unload_modules() def test_plain_and_zero_prefix_are_equivalent(self): """'family' and '0:family' are identical at priority 0. A filter of '0:family' must match services tagged with plain 'family', and both forms must land in the same escalation group.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) # s1: tagged with plain "family" (priority=0, has_priority=False) s1 = _FailThenSucceedNotify( host="host1", asset=asset, fail_times=0 ) s1.tags = {AppriseTag.parse("family")} # s2: tagged with explicit "0:family" (priority=0, # has_priority=True) s2 = _FailThenSucceedNotify( host="host2", asset=asset, fail_times=0 ) s2.tags = {AppriseTag.parse("0:family")} # s3: lower-urgency fallback -- should never fire when p-0 succeeds s3 = _FailThenSucceedNotify( host="host3", asset=asset, fail_times=0 ) s3.tags = {AppriseTag.parse("1:family")} a = Apprise(asset=asset) a.add(s1) a.add(s2) a.add(s3) # Exclusive "0:family": plain "family" and "0:family" services # are both priority 0 and must both fire; priority-1 service is # skipped. result = a.notify(body="test", tag="0:family") assert bool(result) is True assert s1._calls == 1 # plain "family" matched by "0:family" assert s2._calls == 1 # explicit "0:family" matched assert s3._calls == 0 # priority 1, not priority 0 -- skipped # Escalation "family": s1 and s2 are both in the priority-0 # group. Both succeed, so s3 (priority 1) is never escalated to. s1._calls = s2._calls = s3._calls = 0 result = a.notify(body="test", tag="family") assert bool(result) is True assert s1._calls == 1 # priority-0 group assert s2._calls == 1 # same priority-0 group assert s3._calls == 0 # not escalated to finally: N_MGR.unload_modules() class TestRetryWarningMessage: """Retry warnings show total attempts in sync and async dispatch.""" def test_sync_attempt_denominator_counts_total_attempts(self, caplog): """Sequential dispatch: one retry means two total attempts.""" N_MGR["failpass"] = _FailThenSucceedNotify try: # Older pytest releases (e.g. the one shipped with EL9) do # not un-disable logging on our behalf when # caplog.set_level() is called, so a prior module-level # logging.disable(logging.CRITICAL) call would otherwise # silently swallow this warning. Clear it explicitly. logging.disable(logging.NOTSET) caplog.set_level(logging.WARNING, logger=LOGGER_NAME) asset = AppriseAsset(async_mode=False) # Fail once, then succeed on the only retry. service = _FailThenSucceedNotify( host="localhost", asset=asset, retry=1, wait=0.0, fail_times=1, ) a = Apprise(asset=asset) a.add(service) result = a.notify(body="test") assert bool(result) is True assert service._calls == 2 # The denominator must be retry + 1 (2), not retry (1). assert "Attempt 1/2" in caplog.text assert "Attempt 1/1" not in caplog.text finally: logging.disable(logging.CRITICAL) N_MGR.unload_modules() def test_async_attempt_denominator_counts_total_attempts(self, caplog): """Asyncio dispatch: one retry means two total attempts.""" N_MGR["failpass"] = _FailThenSucceedNotify try: # See the sync test above for why this reset is needed. logging.disable(logging.NOTSET) caplog.set_level(logging.WARNING, logger=LOGGER_NAME) asset = AppriseAsset(async_mode=True) service = _FailThenSucceedNotify( host="localhost", asset=asset, retry=1, wait=0.0, fail_times=1, ) a = Apprise(asset=asset) a.add(service) result = asyncio.run(a.async_notify(body="test")) assert bool(result) is True assert service._calls == 2 # The denominator must be retry + 1 (2), not retry (1). assert "Attempt 1/2" in caplog.text assert "Attempt 1/1" not in caplog.text finally: logging.disable(logging.CRITICAL) N_MGR.unload_modules() class TestDispatchSafetyNets: """Dispatch crashes are reported as failures, never raised at callers.""" class _ExplodingAsset(AppriseAsset): """Asset whose mode lookup fails inside batch dispatch.""" @property def async_mode(self): """Raise the injected failure when dispatch reads mode.""" raise RuntimeError("injected async_mode access") def _tagged_service(self): """Build one tagged service whose dispatch will raise.""" # Reading async_mode later will trigger the test failure. service = _FailThenSucceedNotify( host="solo", asset=self._ExplodingAsset(), fail_times=0 ) service.tags = {"alerts"} # Return the public object used by both sync and async tests. a = Apprise() a.add(service) return a def test_flat_dispatch_exception(self): """A crash during flat dispatch becomes a failed result. An explicit priority skips the escalation chain, so this batch has no later group to fall back on. """ N_MGR["failpass"] = _FailThenSucceedNotify try: # An exact priority uses flat dispatch instead of escalation. result = self._tagged_service().notify(body="test", tag="0:alerts") # The caller receives a normal failed result, not an exception. assert bool(result) is False finally: N_MGR.unload_modules() def test_async_flat_dispatch_exception(self): """The asynchronous flat dispatch contains a crash the same way.""" N_MGR["failpass"] = _FailThenSucceedNotify try: # The asynchronous public API must provide the same safe result. result = asyncio.run( self._tagged_service().async_notify( body="test", tag="0:alerts" ) ) # The caller receives a normal failed result, not an exception. assert bool(result) is False finally: N_MGR.unload_modules() def test_async_base_exception_result(self): """A BaseException from one service still produces its result. asyncio.gather() hands back BaseException subclasses, and CancelledError is the one seen in practice. These are not Exception subclasses, so they must not reach tuple unpacking. """ N_MGR["failpass"] = _FailThenSucceedNotify try: class _Fatal(BaseException): """Stands in for CancelledError, which is not Exception.""" class _FatalNotify(_FailThenSucceedNotify): """Plugin whose asynchronous send raises a BaseException.""" async def async_notify(self, **kwargs): """Fail in a way ordinary handlers do not catch.""" raise _Fatal("plugin cancelled") # Use asynchronous mode so gather() receives the raised object. service = _FatalNotify( host="solo", asset=AppriseAsset(async_mode=True), fail_times=0, ) # Exercise the batch helper directly to inspect its result list. ok, results = asyncio.run( Apprise._notify_parallel_asyncio((service, {"body": "test"})) ) # The crash is recorded rather than losing the service entirely. assert ok is False assert len(results) == 1 finally: N_MGR.unload_modules() def test_bad_metadata_fallbacks(self): """Result building tolerates a plugin whose metadata raises. These helpers exist to describe an already-misbehaving plugin, so they must not raise a second time while doing it. """ from apprise.dispatch import ( RetryRunner, finalize_service_result, resolve_retry_count, service_crashed, service_metadata, timeout_result, ) from apprise.result import NotifyAttempt class _Hostile: """Stand-in whose every plugin-supplied detail raises.""" @property def service_name(self): """Raise instead of naming the service.""" raise RuntimeError("no name") @property def optional(self): """Raise instead of reporting optional status.""" raise RuntimeError("no optional") @property def retry(self): """Raise instead of reporting a retry count.""" raise RuntimeError("no retry") @property def wait(self): """Raise instead of reporting a retry wait.""" raise RuntimeError("no wait") @property def tags(self): """Raise instead of listing tags.""" raise RuntimeError("no tags") def url(self, **kwargs): """Raise instead of returning a URL.""" raise RuntimeError("no url") def url_id(self): """Raise instead of returning a URL identifier.""" raise RuntimeError("no url_id") def __len__(self): """Raise instead of reporting a target count.""" raise RuntimeError("no length") # Every result helper below receives the same broken plugin. service = _Hostile() failed = [NotifyAttempt(status=AppriseResultStatus.FAILURE)] # The metadata helper supplies its documented safe values. assert service_metadata(service) == ( "Unknown", "unknown://", None, (), 1, ) # Error results remain required failures when optional cannot be read. assert bool(service_crashed(service, ValueError("boom"))) is False # The timeout and completed-attempt paths fall back the same way. assert timeout_result(service, 1.0, 1).optional is False ok, result = finalize_service_result(service, 0, failed) assert ok is False assert result.optional is False # A broken retry property must not throw away a valid override. assert resolve_retry_count(service, {"_retry_override": 3}) == 3 assert resolve_retry_count(service, {}) == 0 assert resolve_retry_count(service, {"_retry_override": "x"}) == 0 class _BadRetryValue: """Plugin whose retry is readable but not a usable number.""" retry = "bad" # A non-numeric retry is treated as none rather than reaching the # comparison that clamps it. bad = _BadRetryValue() assert resolve_retry_count(bad, {}) == 0 assert resolve_retry_count(bad, {"_retry_override": "x"}) == 0 assert resolve_retry_count(bad, {"_retry_override": 2}) == 2 class _InfiniteRetry: """Plugin whose retry has no whole-number form.""" retry = float("inf") # Infinity and NaN have no integer form, so they clamp to none too. infinite = _InfiniteRetry() assert resolve_retry_count(infinite, {}) == 0 assert ( resolve_retry_count(infinite, {"_retry_override": float("inf")}) == 0 ) assert ( resolve_retry_count(infinite, {"_retry_override": float("nan")}) == 0 ) # The runner reads the name once, so its log lines stay usable. assert RetryRunner(service, {}, None).name == "Unknown" class TestExceptionHandling: """Verify that plugin exceptions are caught and retried, not propagated.""" def test_sequential_exception_treated_as_failure(self): """A plugin raising Exception is caught; delivery is marked failed.""" N_MGR["raise"] = _RaisingNotify try: asset = AppriseAsset(async_mode=False) service = _RaisingNotify(host="localhost", asset=asset, retry=0) a = Apprise(asset=asset) a.add(service) result = a.notify(body="test") assert bool(result) is False finally: N_MGR.unload_modules() def test_sequential_exception_retried(self): """Exception on first attempt is retried; later success counts.""" N_MGR["failpass"] = _FailThenSucceedNotify N_MGR["raise"] = _RaisingNotify try: asset = AppriseAsset(async_mode=False) # Use a plugin that raises on the first attempt then succeeds service = _FailThenSucceedNotify( host="localhost", asset=asset, retry=1, wait=0.0, fail_times=1 ) # Patch notify to raise on the first call then succeed call_count = [0] def raising_then_ok(**kwargs): call_count[0] += 1 if call_count[0] == 1: raise RuntimeError("transient error") return True service.send = raising_then_ok a = Apprise(asset=asset) a.add(service) result = a.notify(body="test") assert bool(result) is True assert call_count[0] == 2 finally: N_MGR.unload_modules() def test_threadpool_future_exception_caught(self): """An exception escaping a thread future is caught gracefully.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=True) # Need 2 services to trigger the thread pool path s1 = _FailThenSucceedNotify( host="host1", asset=asset, fail_times=0 ) s2 = _FailThenSucceedNotify( host="host2", asset=asset, fail_times=0 ) a = Apprise(asset=asset) a.add(s1) a.add(s2) # Inject one failed future so the outer safety net is exercised. import concurrent.futures as cf real_executor_cls = cf.ThreadPoolExecutor class _PatchedExecutor: """Delegate to a real executor while injecting one failure.""" def __init__(self, *args, **kwargs): """Create the wrapped executor with the same arguments.""" self._real = real_executor_cls(*args, **kwargs) def __enter__(self): """Return this wrapper when entering the context.""" return self def __exit__(self, *exc): """Forward context cleanup to the wrapped executor.""" return self._real.__exit__(*exc) def submit( self, context_run, fn, service, kwargs, call_deadline ): """Return a failed future for ``s1`` and submit others.""" if service is s1: fut = cf.Future() fut.set_exception(RuntimeError("future boom")) return fut return self._real.submit( context_run, fn, service, kwargs, call_deadline ) def shutdown(self, *args, **kwargs): """Forward shutdown behavior to the wrapped executor.""" return self._real.shutdown(*args, **kwargs) # Reset the shared executor so the patched class is used here. import apprise.apprise as apprise_module with ( mock.patch("apprise.apprise._shared_executor", None), mock.patch( "apprise.apprise.cf.ThreadPoolExecutor", _PatchedExecutor ), ): result = a.notify(body="test") # Clean up the real executor wrapped by _PatchedExecutor. apprise_module._shared_executor._real.shutdown(wait=True) # One future raised -> overall result is False assert bool(result) is False finally: N_MGR.unload_modules() def test_sequential_future_exception_caught(self): """An exception escaping a sequential dispatch's thread future is caught by the outer safety net, same as the thread-pool path.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False, service_timeout=0.05) service = _SlowNotify(host="x", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(service) import concurrent.futures as cf real_executor_cls = cf.ThreadPoolExecutor class _PatchedExecutor: """Delegate to a real executor while always failing.""" def __init__(self, *args, **kwargs): """Create the wrapped executor with the same args.""" self._real = real_executor_cls(*args, **kwargs) def __enter__(self): """Return this wrapper when entering the context.""" return self def __exit__(self, *exc): """Forward context cleanup to the wrapped executor.""" return self._real.__exit__(*exc) def submit( self, context_run, fn, service, kwargs, call_deadline ): """Return a future that raises instead of running.""" fut = cf.Future() fut.set_exception(RuntimeError("future boom")) return fut def shutdown(self, *args, **kwargs): """Forward shutdown behavior to the wrapped executor.""" return self._real.shutdown(*args, **kwargs) # Reset the shared executor so the patched class is used here. import apprise.apprise as apprise_module with ( mock.patch("apprise.apprise._shared_executor", None), mock.patch( "apprise.apprise.cf.ThreadPoolExecutor", _PatchedExecutor ), ): result = a.notify(body="test") # Clean up the real executor wrapped by _PatchedExecutor. apprise_module._shared_executor._real.shutdown(wait=True) assert bool(result) is False finally: N_MGR.unload_modules() def test_asyncio_exception_in_do_call_treated_as_failure(self): """An exception inside do_call marks the service as failed.""" N_MGR["raise"] = _RaisingNotify try: asset = AppriseAsset() service = _RaisingNotify(host="localhost", asset=asset, retry=0) a = Apprise(asset=asset) a.add(service) async def run(): """Execute async notification with the patched gather.""" return await a.async_notify(body="test") result = asyncio.run(run()) assert bool(result) is False finally: N_MGR.unload_modules() def test_asyncio_gather_unhandled_exception(self): """An Exception escaping the outer gather() round is caught as a safety net and treated as a batch failure.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset() service = _FailThenSucceedNotify( host="localhost", asset=asset, fail_times=0 ) a = Apprise(asset=asset) a.add(service) # Mock asyncio.gather to return an escaped exception object. # Close any unawaited coroutines passed to the mock to avoid # "coroutine was never awaited" RuntimeWarnings. async def fake_gather(*args, **kw): """Return an escaped error while closing input coroutines.""" for arg in args: if asyncio.iscoroutine(arg): arg.close() return [RuntimeError("escaped")] async def run(): """Dispatch while gather returns an escaped exception.""" with mock.patch("apprise.apprise.asyncio.gather", fake_gather): return await a.async_notify(body="test") result = asyncio.run(run()) assert bool(result) is False finally: N_MGR.unload_modules() def test_asyncio_gather_type_error(self): """A TypeError in gather results is caught and returns False.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset() service = _FailThenSucceedNotify( host="localhost", asset=asset, fail_times=0 ) a = Apprise(asset=asset) a.add(service) async def fake_gather(*args, **kw): """Return a validation error as a gathered result.""" for arg in args: if asyncio.iscoroutine(arg): arg.close() return [TypeError("validation")] async def run(): """Dispatch while gather returns a validation error.""" with mock.patch("apprise.apprise.asyncio.gather", fake_gather): return await a.async_notify(body="test") result = asyncio.run(run()) assert bool(result) is False finally: N_MGR.unload_modules() def test_sequential_raise_does_not_block_other_services(self): """A raising service is marked failed but every other service in the same sequential batch is still attempted and reported.""" N_MGR["raise"] = _RaisingNotify N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) bad = _RaisingNotify(host="bad", asset=asset) good1 = _FailThenSucceedNotify( host="good1", asset=asset, fail_times=0 ) good2 = _FailThenSucceedNotify( host="good2", asset=asset, fail_times=0 ) a = Apprise(asset=asset) a.add(good1) a.add(bad) a.add(good2) result = a.notify(body="test") assert bool(result) is False assert len(result) == 3 # Order matches add() order: good1, bad, good2. results = list(result) assert bool(results[0]) is True assert bool(results[1]) is False assert bool(results[2]) is True # good2 was still attempted despite bad raising before it assert good2._calls == 1 finally: N_MGR.unload_modules() def test_threadpool_raise_does_not_block_other_services(self): """Same guarantee as above, but across the thread-pool dispatch path (async_mode=True, >1 service).""" N_MGR["raise"] = _RaisingNotify N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=True) bad = _RaisingNotify(host="bad", asset=asset) good1 = _FailThenSucceedNotify( host="good1", asset=asset, fail_times=0 ) good2 = _FailThenSucceedNotify( host="good2", asset=asset, fail_times=0 ) a = Apprise(asset=asset) a.add(good1) a.add(bad) a.add(good2) result = a.notify(body="test") assert bool(result) is False assert len(result) == 3 # Threadpool dispatch preserves original submission order. results = list(result) assert bool(results[0]) is True assert bool(results[1]) is False assert bool(results[2]) is True assert good2._calls == 1 finally: N_MGR.unload_modules() def test_asyncio_raise_does_not_block_other_services(self): """Same guarantee as above, but across the asyncio dispatch path.""" N_MGR["raise"] = _RaisingNotify N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=True) bad = _RaisingNotify(host="bad", asset=asset) good1 = _FailThenSucceedNotify( host="good1", asset=asset, fail_times=0 ) good2 = _FailThenSucceedNotify( host="good2", asset=asset, fail_times=0 ) a = Apprise(asset=asset) a.add(good1) a.add(bad) a.add(good2) result = asyncio.run(a.async_notify(body="test")) assert bool(result) is False assert len(result) == 3 # asyncio dispatch preserves original submission order too. results = list(result) assert bool(results[0]) is True assert bool(results[1]) is False assert bool(results[2]) is True assert good2._calls == 1 finally: N_MGR.unload_modules() def test_notify_preparation_typeerror(self): """A TypeError raised while preparing content explains itself.""" N_MGR["badformat"] = _BadFormatNotify try: asset = AppriseAsset(async_mode=False) a = Apprise(asset=asset) a.add(_BadFormatNotify(host="localhost", asset=asset)) with apprise_logs_enabled(): result = a.notify(body="test") finally: N_MGR.unload_modules() assert result.status == AppriseResultStatus.FAILURE # The service that broke reports itself rather than vanishing. assert [(r.name, r.status) for r in result.results] == [ ("BadFormat", AppriseResultStatus.FAILURE) ] # The reason has to reach the caller; a silent FAILURE here used # to leave nothing at all behind to diagnose. assert any( "raised an exception" in e.message for e in result.call_logs() ) def test_async_notify_preparation_typeerror(self): """The asynchronous path explains a preparation TypeError too.""" N_MGR["badformat"] = _BadFormatNotify try: asset = AppriseAsset(async_mode=True) a = Apprise(asset=asset) a.add(_BadFormatNotify(host="localhost", asset=asset)) with apprise_logs_enabled(): result = asyncio.run(a.async_notify(body="test")) finally: N_MGR.unload_modules() assert result.status == AppriseResultStatus.FAILURE assert [(r.name, r.status) for r in result.results] == [ ("BadFormat", AppriseResultStatus.FAILURE) ] assert any( "raised an exception" in e.message for e in result.call_logs() ) def test_async_notify_unknown_argument(self): """async_notify() names the argument it could not accept.""" N_MGR["test"] = _TestNotify try: asset = AppriseAsset(async_mode=True) a = Apprise(asset=asset) a.add(_TestNotify(host="localhost", asset=asset)) with apprise_logs_enabled(): result = asyncio.run(a.async_notify(body="test", bogus=1)) finally: N_MGR.unload_modules() assert result.status == AppriseResultStatus.FAILURE assert len(result.results) == 0 assert any("bogus" in e.message for e in result.call_logs()) def test_notify_preparation_crash(self): """A plugin crashing during preparation fails the call, not the caller.""" N_MGR["badformat"] = _BadFormatNotify try: asset = AppriseAsset(async_mode=False) a = Apprise(asset=asset) a.add( _BadFormatNotify( host="localhost", asset=asset, error=RuntimeError("plugin blew up"), ) ) with apprise_logs_enabled(): result = a.notify(body="test", log_level=logging.DEBUG) finally: N_MGR.unload_modules() # Anything raised while preparing content belongs in the result, # not thrown at whoever called notify(). assert result.status == AppriseResultStatus.FAILURE assert [(r.name, r.status) for r in result.results] == [ ("BadFormat", AppriseResultStatus.FAILURE) ] # DEBUG carries the original text behind the summary warning. assert any("plugin blew up" in e.message for e in result.call_logs()) def test_async_notify_preparation_crash(self): """The asynchronous path contains a preparation crash too.""" N_MGR["badformat"] = _BadFormatNotify try: asset = AppriseAsset(async_mode=True) a = Apprise(asset=asset) a.add( _BadFormatNotify( host="localhost", asset=asset, error=RuntimeError("plugin blew up"), ) ) with apprise_logs_enabled(): result = asyncio.run( a.async_notify(body="test", log_level=logging.DEBUG) ) finally: N_MGR.unload_modules() assert result.status == AppriseResultStatus.FAILURE assert [(r.name, r.status) for r in result.results] == [ ("BadFormat", AppriseResultStatus.FAILURE) ] assert any("plugin blew up" in e.message for e in result.call_logs()) def test_delivery_typeerror_reported(self): """A TypeError raised while delivering is reported like any crash.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) service = _SlowNotify(host="x", asset=asset, delay=0.0) def _raise_type_error(**kwargs): """Fail the way a plugin with a signature bug would.""" raise TypeError("delivery-time type error") service.send = _raise_type_error a = Apprise(asset=asset) a.add(service) with apprise_logs_enabled(): result = a.notify(body="test") finally: N_MGR.unload_modules() assert result.status == AppriseResultStatus.FAILURE # A failed result with no logs at all cannot be diagnosed. messages = [e.message for r in result.results for e in r.logs()] assert any("raised an exception" in m for m in messages) def test_async_delivery_typeerror_reported(self): """Native async delivery reports a TypeError the same way.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True) service = _SlowNotify(host="x", asset=asset, delay=0.0) async def _raise_type_error(**kwargs): """Fail the way a plugin with a signature bug would.""" raise TypeError("delivery-time type error") service.async_notify = _raise_type_error a = Apprise(asset=asset) a.add(service) with apprise_logs_enabled(): result = asyncio.run(a.async_notify(body="test")) finally: N_MGR.unload_modules() assert result.status == AppriseResultStatus.FAILURE messages = [e.message for r in result.results for e in r.logs()] assert any("raised an exception" in m for m in messages) def test_preparation_crash_isolated(self): """One plugin failing preparation does not silence the others.""" N_MGR["badformat"] = _BadFormatNotify N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) healthy = _SlowNotify(host="a", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(healthy) a.add( _BadFormatNotify( host="localhost", asset=asset, error=RuntimeError("plugin blew up"), ) ) result = a.notify(body="test") finally: N_MGR.unload_modules() # The healthy service was still contacted. assert healthy.calls == 1 # Mixed outcome: one real delivery, one service that never ran. assert result.status == AppriseResultStatus.PARTIAL statuses = {r.name: r.status for r in result.results} assert statuses["BadFormat"] == AppriseResultStatus.FAILURE assert len(result.results) == 2 def test_async_preparation_crash_isolated(self): """The asynchronous path isolates a preparation crash too.""" N_MGR["badformat"] = _BadFormatNotify N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True) healthy = _SlowNotify(host="a", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(healthy) a.add( _BadFormatNotify( host="localhost", asset=asset, error=RuntimeError("plugin blew up"), ) ) result = asyncio.run(a.async_notify(body="test")) finally: N_MGR.unload_modules() assert healthy.calls == 1 assert result.status == AppriseResultStatus.PARTIAL assert len(result.results) == 2 def test_flat_dispatch_preparation_crash(self): """An explicit priority filter isolates a crash the same way.""" N_MGR["badformat"] = _BadFormatNotify N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) healthy = _SlowNotify(host="a", asset=asset, delay=0.0, tag="ops") a = Apprise(asset=asset) a.add(healthy) a.add( _BadFormatNotify( host="localhost", asset=asset, tag="ops", error=RuntimeError("plugin blew up"), ) ) # A priority prefix sends one flat batch, skipping escalation. result = a.notify(body="test", tag="0:ops") finally: N_MGR.unload_modules() assert healthy.calls == 1 # The batch itself succeeded, but a broken service still counts. assert result.status == AppriseResultStatus.PARTIAL assert len(result.results) == 2 def test_every_service_broken(self): """A call where nothing could be prepared is a failure, not a no-match.""" N_MGR["badformat"] = _BadFormatNotify try: asset = AppriseAsset(async_mode=False) a = Apprise(asset=asset) for _ in range(2): a.add( _BadFormatNotify( host="localhost", asset=asset, error=RuntimeError("plugin blew up"), ) ) result = a.notify(body="test") finally: N_MGR.unload_modules() # Nothing was dispatched, but services did match, so NOMATCH would # be misleading here. assert result.status == AppriseResultStatus.FAILURE assert len(result.results) == 2 def test_bad_content_still_stops_everything(self): """Content Apprise cannot use is the caller's error, not a service's.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) healthy = _SlowNotify(host="a", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(healthy) # A list cannot be escaped; that is a mistake in the call, so # no service is blamed and none is contacted. result = a.notify( body=["not", "a", "string"], interpret_escapes=True ) finally: N_MGR.unload_modules() assert result.status == AppriseResultStatus.FAILURE assert len(result.results) == 0 assert healthy.calls == 0 def test_unreached_fallback_not_blamed(self): """A broken fallback escalation never reaches is never reported.""" N_MGR["badformat"] = _BadFormatNotify N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) primary = _SlowNotify( host="a", asset=asset, delay=0.0, tag="1:ops" ) a = Apprise(asset=asset) a.add(primary) # Only ever tried if the priority-1 group fails. a.add( _BadFormatNotify( host="localhost", asset=asset, tag="9:ops", error=RuntimeError("plugin blew up"), ) ) result = a.notify(body="test", tag="ops") finally: N_MGR.unload_modules() assert primary.calls == 1 # The chain stopped at the group that worked, so the broken # fallback is neither dispatched nor counted against the call. assert result.status == AppriseResultStatus.SUCCESS assert len(result.results) == 1 assert "BadFormat" not in [r.name for r in result.results] def test_optional_service_preparation_crash(self): """A broken optional service stays optional.""" N_MGR["badformat"] = _BadFormatNotify N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) required = _SlowNotify(host="a", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(required) a.add( _BadFormatNotify( host="localhost", asset=asset, optional=True, error=RuntimeError("plugin blew up"), ) ) result = a.notify(body="test") # Alone, it must not drag the call down either. b = Apprise(asset=asset) b.add( _BadFormatNotify( host="localhost", asset=asset, optional=True, error=RuntimeError("plugin blew up"), ) ) alone = b.notify(body="test") finally: N_MGR.unload_modules() assert required.calls == 1 # An optional service that fails is allowed to, so the overall # status must agree with the entry's own SUCCESS. assert result.status == AppriseResultStatus.SUCCESS assert all(bool(r) for r in result.results) assert alone.status == AppriseResultStatus.SUCCESS def test_preparation_crash_keeps_position(self): """A broken service stays where it was added, not first.""" N_MGR["badformat"] = _BadFormatNotify N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) a = Apprise(asset=asset) a.add(_SlowNotify(host="first", asset=asset, delay=0.0)) a.add( _BadFormatNotify( host="localhost", asset=asset, error=RuntimeError("plugin blew up"), ) ) a.add(_SlowNotify(host="third", asset=asset, delay=0.0)) result = a.notify(body="test") finally: N_MGR.unload_modules() # Results follow dispatch order, so the broken one is in the # middle where it was added. assert [r.status for r in result.results] == [ AppriseResultStatus.SUCCESS, AppriseResultStatus.FAILURE, AppriseResultStatus.SUCCESS, ] class TestConfigTagRetry: """Config parsers must reject a retry suffix in service tag definitions. A tag like 'alerts:3' is only valid at call-time (notify() filter / CLI). Putting it in a config file creates ambiguity with the URL ?retry= param and the YAML retry: key, so both parsers must warn and skip the entry. """ def test_text_rejects_retry_suffix(self): """'alerts:3=json://...' is rejected; no service loaded.""" services, _ = ConfigBase.config_parse_text("alerts:3=json://localhost") assert services == [] def test_text_rejects_priority_and_retry_in_tag(self): """'1:alerts:3=json://...' is rejected (priority + retry suffix).""" services, _ = ConfigBase.config_parse_text( "1:alerts:3=json://localhost" ) assert services == [] def test_text_accepts_priority_tag_without_retry(self): """'1:alerts=json://...' loads normally (priority prefix, no retry).""" services, _ = ConfigBase.config_parse_text("1:alerts=json://localhost") assert len(services) == 1 def test_text_accepts_plain_tag(self): """'alerts=json://...' loads normally (no prefix, no retry).""" services, _ = ConfigBase.config_parse_text("alerts=json://localhost") assert len(services) == 1 def test_yaml_rejects_retry_suffix(self): """YAML 'tag: alerts:3' is rejected; no service loaded.""" services, _ = ConfigBase.config_parse_yaml( "version: 1\nurls:\n - json://localhost:\n tag: alerts:3\n" ) assert services == [] def test_yaml_rejects_priority_and_retry_in_tag(self): """YAML 'tag: 1:alerts:3' is rejected (priority + retry suffix).""" services, _ = ConfigBase.config_parse_yaml( "version: 1\nurls:\n - json://localhost:\n tag: 1:alerts:3\n" ) assert services == [] def test_yaml_accepts_priority_tag_without_retry(self): """YAML 'tag: 1:alerts' loads normally (priority prefix, no retry).""" services, _ = ConfigBase.config_parse_yaml( "version: 1\nurls:\n - json://localhost:\n tag: 1:alerts\n" ) assert len(services) == 1 def test_yaml_accepts_plain_tag(self): """YAML 'tag: alerts' loads normally (no prefix, no retry).""" services, _ = ConfigBase.config_parse_yaml( "version: 1\nurls:\n - json://localhost:\n tag: alerts\n" ) assert len(services) == 1 def test_text_valid_entry_after_rejected_one_still_loads(self): """A valid entry that follows a rejected one is still loaded.""" services, _ = ConfigBase.config_parse_text( "alerts:3=json://localhost\nalerts=json://localhost\n" ) assert len(services) == 1 def test_yaml_valid_entry_after_rejected_one_still_loads(self): """A valid entry that follows a rejected one is still loaded.""" services, _ = ConfigBase.config_parse_yaml( "version: 1\n" "urls:\n" " - json://localhost:\n" " tag: alerts:3\n" " - json://localhost:\n" " tag: alerts\n" ) assert len(services) == 1 class TestMultiTagDispatch: """Exercise independent escalation chains in multi-tag OR filters. Each service receives the retry count from the filter token it matched. """ def _make_tagged(self, tag_str, asset, fail_times=0): """Create a _FailThenSucceedNotify tagged with a single AppriseTag.""" s = _FailThenSucceedNotify( host=tag_str, asset=asset, fail_times=fail_times ) # Assign instance-level set to avoid class-level mutation. s.tags = {AppriseTag.parse(tag_str)} return s def _make_priority_tagged(self, tag_str, asset, fail_times=0): """Create a service whose tag is an explicit-priority AppriseTag.""" ft = AppriseTag.parse(tag_str) s = _FailThenSucceedNotify( host=str(ft), asset=asset, fail_times=fail_times ) s.tags = {ft} return s # ------------------------------------------------------------------ # Per-service retry via space-separated string # ------------------------------------------------------------------ def test_per_service_retry_space_separated_string(self): """'devops:3 management:2' applies retry=3 to devops services and retry=2 to management services independently.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) # devops service: fails 3 times; needs retry=3 to succeed s_devops = _FailThenSucceedNotify( host="devops", asset=asset, fail_times=3 ) s_devops.tags = {"devops"} # management service: fails 2 times; needs retry=2 to succeed s_mgmt = _FailThenSucceedNotify( host="mgmt", asset=asset, fail_times=2 ) s_mgmt.tags = {"management"} a = Apprise(asset=asset) a.add(s_devops) a.add(s_mgmt) result = a.notify(body="test", tag="devops:3 management:2") assert bool(result) is True # devops: 1 initial + 3 retries = 4 total calls assert s_devops._calls == 4 # management: 1 initial + 2 retries = 3 total calls assert s_mgmt._calls == 3 finally: N_MGR.unload_modules() def test_per_service_retry_list_of_tokens(self): """['devops:3', 'management:2'] gives the same per-service retry result as a space-separated string.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s_devops = _FailThenSucceedNotify( host="devops", asset=asset, fail_times=3 ) s_devops.tags = {"devops"} s_mgmt = _FailThenSucceedNotify( host="mgmt", asset=asset, fail_times=2 ) s_mgmt.tags = {"management"} a = Apprise(asset=asset) a.add(s_devops) a.add(s_mgmt) result = a.notify(body="test", tag=["devops:3", "management:2"]) assert bool(result) is True assert s_devops._calls == 4 assert s_mgmt._calls == 3 finally: N_MGR.unload_modules() # ------------------------------------------------------------------ # Independent escalation chains # ------------------------------------------------------------------ def test_independent_chains_do_not_skip(self): """When devops chain succeeds at priority-1, management chain still dispatches independently -- its priority-1 failure escalates to its priority-2 service.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) # devops chain: priority-1 succeeds; priority-2 must not fire s_devops_p1 = _FailThenSucceedNotify( host="d1", asset=asset, fail_times=0 ) s_devops_p1.tags = { AppriseTag("devops", priority=1, has_priority=True) } s_devops_p2 = _FailThenSucceedNotify( host="d2", asset=asset, fail_times=0 ) s_devops_p2.tags = { AppriseTag("devops", priority=2, has_priority=True) } # management chain: priority-1 always fails; must escalate to # priority-2 s_mgmt_p1 = _FailThenSucceedNotify( host="m1", asset=asset, fail_times=999 ) s_mgmt_p1.tags = { AppriseTag("management", priority=1, has_priority=True) } s_mgmt_p2 = _FailThenSucceedNotify( host="m2", asset=asset, fail_times=0 ) s_mgmt_p2.tags = { AppriseTag("management", priority=2, has_priority=True) } a = Apprise(asset=asset) a.add(s_devops_p1) a.add(s_devops_p2) a.add(s_mgmt_p1) a.add(s_mgmt_p2) result = a.notify(body="test", tag="devops management") assert bool(result) is True assert s_devops_p1._calls == 1 # devops chain: p1 succeeded assert s_devops_p2._calls == 0 # never escalated to assert s_mgmt_p1._calls == 1 # management chain: p1 failed assert s_mgmt_p2._calls == 1 # escalated to p2, succeeded finally: N_MGR.unload_modules() def test_both_chains_must_succeed_for_true(self): """notify() returns False when one chain exhausts all priority groups without any group fully succeeding.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) # devops chain: always succeeds s_devops = _FailThenSucceedNotify( host="d", asset=asset, fail_times=0 ) s_devops.tags = {"devops"} # management chain: always fails s_mgmt = _FailThenSucceedNotify( host="m", asset=asset, fail_times=999 ) s_mgmt.tags = {"management"} a = Apprise(asset=asset) a.add(s_devops) a.add(s_mgmt) result = a.notify(body="test", tag="devops management") assert bool(result) is False assert s_devops._calls == 1 # its chain succeeded assert s_mgmt._calls == 1 # its chain failed finally: N_MGR.unload_modules() # ------------------------------------------------------------------ # Explicit-priority list with per-service retry (flat dispatch) # ------------------------------------------------------------------ def test_explicit_priority_list_per_service_retry(self): """['1:tag:2', '2:tag:0'] flat-dispatches both services; each gets its own retry: the priority-1 service gets retry=2 and the priority-2 service gets retry=0 (one attempt only).""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) # priority-1 service: fails twice; needs retry=2 to succeed s1 = _FailThenSucceedNotify(host="h1", asset=asset, fail_times=2) s1.tags = {AppriseTag("tag", priority=1, has_priority=True)} # priority-2 service: always succeeds; retry=0 means one attempt s2 = _FailThenSucceedNotify(host="h2", asset=asset, fail_times=0) s2.tags = {AppriseTag("tag", priority=2, has_priority=True)} a = Apprise(asset=asset) a.add(s1) a.add(s2) result = a.notify(body="test", tag=["1:tag:2", "2:tag:0"]) assert bool(result) is True # s1: 1 initial + 2 retries = 3 total assert s1._calls == 3 # s2: retry=0 -> exactly 1 attempt assert s2._calls == 1 finally: N_MGR.unload_modules() # ------------------------------------------------------------------ # CLI OR format (list of single-element lists) # ------------------------------------------------------------------ def test_cli_or_format_independent_chains(self): """CLI --tag 'devops:3' --tag 'management:2' generates [['devops:3'], ['management:2']] -- single-element inner lists that must be treated as independent OR chains, not AND groups.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s_devops = _FailThenSucceedNotify( host="devops", asset=asset, fail_times=3 ) s_devops.tags = {"devops"} s_mgmt = _FailThenSucceedNotify( host="mgmt", asset=asset, fail_times=2 ) s_mgmt.tags = {"management"} a = Apprise(asset=asset) a.add(s_devops) a.add(s_mgmt) # Simulate CLI: --tag "devops:3" --tag "management:2" cli_tag = [["devops:3"], ["management:2"]] result = a.notify(body="test", tag=cli_tag) assert bool(result) is True assert s_devops._calls == 4 # 1 initial + 3 retries assert s_mgmt._calls == 3 # 1 initial + 2 retries finally: N_MGR.unload_modules() def test_cli_and_format_shared_chain(self): """CLI --tag 'devops, management' generates [['devops', 'management']] -- a multi-element inner list that is an AND condition and uses a single shared escalation chain.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) # Service must carry BOTH tags to match s_both = _FailThenSucceedNotify( host="both", asset=asset, fail_times=0 ) s_both.tags = {"devops", "management"} # Service with only "devops" -- must NOT match AND filter s_devonly = _FailThenSucceedNotify( host="devonly", asset=asset, fail_times=0 ) s_devonly.tags = {"devops"} a = Apprise(asset=asset) a.add(s_both) a.add(s_devonly) # Simulate CLI: --tag "devops, management" (AND condition) cli_tag = [["devops", "management"]] result = a.notify(body="test", tag=cli_tag) assert bool(result) is True assert s_both._calls == 1 # has both tags -- matched assert s_devonly._calls == 0 # missing "management" -- not matched finally: N_MGR.unload_modules() # ------------------------------------------------------------------ # Edge cases: explicit priority + AND, 3-chain OR, chain exhaustion # ------------------------------------------------------------------ def test_and_filter_explicit_priority_no_match_returns_none(self): """AND filter with an explicit priority that no service satisfies returns AppriseResultStatus.NOMATCH (no services dispatched at all).""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) # Service is tagged 'alerts' at priority 2 s = _FailThenSucceedNotify(host="s", asset=asset, fail_times=0) s.tags = {AppriseTag("alerts", priority=2, has_priority=True)} a = Apprise(asset=asset) a.add(s) # Request 'alerts' at priority 1 AND 'backup' -- service has # 'alerts' but at priority 2, not 1; nothing matches. result = a.notify(body="test", tag=[["1:alerts", "backup"]]) assert result.status == AppriseResultStatus.NOMATCH assert len(result) == 0 assert s._calls == 0 finally: N_MGR.unload_modules() def test_three_or_chains_all_succeed(self): """Three independent OR chains each succeed at their first priority group; notify() returns True and each service is called once.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s_a = _FailThenSucceedNotify(host="a", asset=asset, fail_times=0) s_a.tags = {"alpha"} s_b = _FailThenSucceedNotify(host="b", asset=asset, fail_times=0) s_b.tags = {"beta"} s_c = _FailThenSucceedNotify(host="c", asset=asset, fail_times=0) s_c.tags = {"gamma"} a = Apprise(asset=asset) a.add(s_a) a.add(s_b) a.add(s_c) result = a.notify(body="test", tag=["alpha", "beta", "gamma"]) assert bool(result) is True assert s_a._calls == 1 assert s_b._calls == 1 assert s_c._calls == 1 finally: N_MGR.unload_modules() def test_three_or_chains_one_fails_overall_false(self): """Three OR chains: two succeed, one exhausts all priority groups. notify() returns False even though the other chains succeeded.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s_a = _FailThenSucceedNotify(host="a", asset=asset, fail_times=0) s_a.tags = {"alpha"} # beta always fails (fail_times > any possible retry) s_b = _FailThenSucceedNotify(host="b", asset=asset, fail_times=99) s_b.tags = {"beta"} s_c = _FailThenSucceedNotify(host="c", asset=asset, fail_times=0) s_c.tags = {"gamma"} a = Apprise(asset=asset) a.add(s_a) a.add(s_b) a.add(s_c) result = a.notify(body="test", tag=["alpha", "beta", "gamma"]) assert bool(result) is False assert s_a._calls == 1 # alpha succeeded assert s_c._calls == 1 # gamma succeeded finally: N_MGR.unload_modules() def test_chain_escalation_to_second_priority_group(self): """A chain whose priority-0 group fails escalates to the priority-1 group; the second group succeeds so notify() returns True.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) # priority-0 service: always fails (no retry configured) s_p0 = _FailThenSucceedNotify( host="p0", asset=asset, fail_times=99 ) s_p0.tags = {AppriseTag("alerts", priority=0, has_priority=False)} # priority-1 service: succeeds on first attempt s_p1 = _FailThenSucceedNotify(host="p1", asset=asset, fail_times=0) s_p1.tags = {AppriseTag("alerts", priority=1, has_priority=True)} a = Apprise(asset=asset) a.add(s_p0) a.add(s_p1) result = a.notify(body="test", tag="alerts") assert bool(result) is True # priority-0 group was attempted once and failed assert s_p0._calls == 1 # priority-1 group was then tried as fallback assert s_p1._calls == 1 finally: N_MGR.unload_modules() def test_all_priority_groups_exhausted_returns_false(self): """When every priority group in a chain fails, notify() returns False and all groups were attempted in order.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) # priority-0 service: always fails s_p0 = _FailThenSucceedNotify( host="p0", asset=asset, fail_times=99 ) s_p0.tags = {AppriseTag("alerts", priority=0, has_priority=False)} # priority-1 service: also always fails s_p1 = _FailThenSucceedNotify( host="p1", asset=asset, fail_times=99 ) s_p1.tags = {AppriseTag("alerts", priority=1, has_priority=True)} a = Apprise(asset=asset) a.add(s_p0) a.add(s_p1) result = a.notify(body="test", tag="alerts") assert bool(result) is False # Both groups were attempted assert s_p0._calls == 1 assert s_p1._calls == 1 finally: N_MGR.unload_modules() def test_chain_dispatch_future_exception_treated_as_failure(self): """Treat an exception from a concurrent tag chain as failure. Multiple chains force the executor path. An asset that raises during dispatch reaches its fallback without cross-thread method patching. """ N_MGR["failpass"] = _FailThenSucceedNotify try: # _ExplodingAsset.async_mode raises RuntimeError. _run_batch # reads s.asset.async_mode to split seq/par, so a batch with # one of these services raises and the future captures it. class _ExplodingAsset(AppriseAsset): """Asset whose mode lookup fails inside chain dispatch.""" @property def async_mode(self): """Raise the injected failure when dispatch reads mode.""" raise RuntimeError("injected async_mode access") # Two services with distinct tags -> two independent chains so # the ThreadPoolExecutor path (len(active) > 1) is taken. s_a = _FailThenSucceedNotify( host="a", asset=_ExplodingAsset(), fail_times=0 ) s_a.tags = {"alpha"} s_b = _FailThenSucceedNotify( host="b", asset=_ExplodingAsset(), fail_times=0 ) s_b.tags = {"beta"} a = Apprise() a.add(s_a) a.add(s_b) result = a.notify(body="test", tag=["alpha", "beta"]) # Both chains raised instead of returning True -- overall False. assert bool(result) is False finally: N_MGR.unload_modules() def test_single_chain_exception(self): """Treat a direct-dispatch chain exception as a failure.""" N_MGR["failpass"] = _FailThenSucceedNotify try: class _ExplodingAsset(AppriseAsset): """Asset whose mode lookup fails inside chain dispatch.""" @property def async_mode(self): """Raise the injected failure when dispatch reads mode.""" raise RuntimeError("injected async_mode access") # One untagged chain dispatches without the coordinator pool. service = _FailThenSucceedNotify( host="solo", asset=_ExplodingAsset(), fail_times=0 ) a = Apprise() a.add(service) result = a.notify(body="test") # The chain raised instead of returning True -- overall False. assert bool(result) is False finally: N_MGR.unload_modules() def test_async_chain_base_exception(self): """Treat a BaseException returned by gather() as a chain failure.""" N_MGR["failpass"] = _FailThenSucceedNotify try: class _FatalDispatch(BaseException): """Stands in for CancelledError, which is not Exception.""" class _CancellingAsset(AppriseAsset): """Asset whose mode lookup fails inside chain dispatch.""" @property def async_mode(self): """Raise the injected failure when dispatch reads mode.""" raise _FatalDispatch("injected chain cancellation") service = _FailThenSucceedNotify( host="solo", asset=_CancellingAsset(), fail_times=0 ) a = Apprise() a.add(service) result = asyncio.run(a.async_notify(body="test")) # The chain escalated instead of the result being unpacked. assert bool(result) is False finally: N_MGR.unload_modules() class TestAbortOnChainFailure: """Exercise optional early exit when one tag chain is exhausted. By default all chains finish. Enabling the setting stops later escalation rounds after a chain fails. """ def _make_tagged(self, tag_str, asset, fail_times=0): s = _FailThenSucceedNotify( host=tag_str, asset=asset, fail_times=fail_times ) s.tags = {tag_str} return s def test_default_false_all_chains_complete(self): """With abort_on_chain_failure=False (default), all chains run to completion even if one chain has already failed.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) # alpha always succeeds s_a = self._make_tagged("alpha", asset, fail_times=0) # beta always fails (exhausts its only group immediately) s_b = self._make_tagged("beta", asset, fail_times=99) # gamma always succeeds s_c = self._make_tagged("gamma", asset, fail_times=0) a = Apprise(asset=asset) a.add(s_a) a.add(s_b) a.add(s_c) result = a.notify(body="test", tag=["alpha", "beta", "gamma"]) assert bool(result) is False # alpha and gamma were still dispatched despite beta failing assert s_a._calls == 1 assert s_b._calls == 1 assert s_c._calls == 1 finally: N_MGR.unload_modules() def test_abort_on_chain_failure_true_stops_early(self): """With abort_on_chain_failure=True, once beta exhausts all priority groups without success, further escalation rounds for other chains are skipped.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False, abort_on_chain_failure=True) # alpha: two priority levels; priority-0 always fails s_a_p0 = _FailThenSucceedNotify( host="a0", asset=asset, fail_times=99 ) s_a_p0.tags = {AppriseTag("alpha", priority=0, has_priority=False)} s_a_p1 = _FailThenSucceedNotify( host="a1", asset=asset, fail_times=0 ) s_a_p1.tags = {AppriseTag("alpha", priority=1, has_priority=True)} # beta: one priority level; always fails s_b = _FailThenSucceedNotify(host="b", asset=asset, fail_times=99) s_b.tags = {"beta"} a = Apprise(asset=asset) a.add(s_a_p0) a.add(s_a_p1) a.add(s_b) result = a.notify(body="test", tag=["alpha", "beta"]) assert bool(result) is False # beta failed in round 1 and was exhausted -- abort triggered. # alpha's p1 (escalation) should NOT have been attempted. assert s_b._calls == 1 assert s_a_p0._calls == 1 assert s_a_p1._calls == 0 # skipped due to early abort finally: N_MGR.unload_modules() def test_abort_on_chain_failure_true_async(self): """abort_on_chain_failure=True triggers the same early-abort in async_notify()""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=True, abort_on_chain_failure=True) # alpha has two priority levels; priority-0 always fails s_a_p0 = _FailThenSucceedNotify( host="a0", asset=asset, fail_times=99 ) s_a_p0.tags = {AppriseTag("alpha", priority=0, has_priority=False)} s_a_p1 = _FailThenSucceedNotify( host="a1", asset=asset, fail_times=0 ) s_a_p1.tags = {AppriseTag("alpha", priority=1, has_priority=True)} # beta has one priority level; always fails s_b = _FailThenSucceedNotify(host="b", asset=asset, fail_times=99) s_b.tags = {"beta"} a = Apprise(asset=asset) a.add(s_a_p0) a.add(s_a_p1) a.add(s_b) result = asyncio.run( a.async_notify(body="test", tag=["alpha", "beta"]) ) assert bool(result) is False # beta was exhausted in round 1 -- abort fires before alpha's p1 assert s_b._calls == 1 assert s_a_p0._calls == 1 assert s_a_p1._calls == 0 finally: N_MGR.unload_modules() class TestOptionalService: """optional=True silently absorbs per-service delivery failures. The overall notify()/async_notify() result evaluates truthy even when an optional service cannot be reached, so callers are not penalised for "nice to have" endpoints (e.g. home screens, debug logging). """ def test_optional_default_false(self): """optional defaults to False on a freshly constructed plugin.""" nb = _TestNotify(host="localhost") assert nb.optional is False def test_optional_url_includes_flag(self): """url_parameters() always emits optional=yes or optional=no.""" nb = _TestNotify(host="localhost") params = nb.url_parameters() assert "optional" in params assert params["optional"] == "no" nb_opt = _TestNotify(host="localhost", optional=True) params_opt = nb_opt.url_parameters() assert params_opt["optional"] == "yes" def test_optional_parse_url_yes(self): """parse_url propagates optional=yes into the results dict.""" results = _TestNotify.parse_url("test://localhost?optional=yes") assert results is not None assert results.get("optional") is True def test_optional_parse_url_no(self): """parse_url propagates optional=no into the results dict.""" results = _TestNotify.parse_url("test://localhost?optional=no") assert results is not None assert results.get("optional") is False def test_optional_kwarg_sets_attribute(self): """Passing optional=True/False to __init__ sets .optional.""" nb_yes = _TestNotify(host="localhost", optional=True) assert nb_yes.optional is True nb_no = _TestNotify(host="localhost", optional=False) assert nb_no.optional is False def test_optional_sequential_failure_absorbed(self): """Sequential dispatch: failed optional service -> overall True.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s = _FailThenSucceedNotify(host="s1", asset=asset, fail_times=99) s.optional = True a = Apprise(asset=asset) a.add(s) result = a.notify(body="test") assert bool(result) is True assert s._calls == 1 finally: N_MGR.unload_modules() def test_optional_threadpool_failure_absorbed(self): """Thread-pool dispatch: failed optional services -> overall True. Two async_mode=True services ensure _notify_parallel_threadpool uses the actual thread pool (n_calls==1 falls back to sequential). """ N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=True) s1 = _FailThenSucceedNotify(host="s1", asset=asset, fail_times=99) s1.optional = True s2 = _FailThenSucceedNotify(host="s2", asset=asset, fail_times=99) s2.optional = True a = Apprise(asset=asset) a.add(s1) a.add(s2) result = a.notify(body="test") assert bool(result) is True finally: N_MGR.unload_modules() def test_optional_asyncio_failure_absorbed(self): """Asyncio dispatch: failed optional service -> overall True.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=True) s = _FailThenSucceedNotify(host="s1", asset=asset, fail_times=99) s.optional = True a = Apprise(asset=asset) a.add(s) result = asyncio.run(a.async_notify(body="test")) assert bool(result) is True finally: N_MGR.unload_modules() def test_optional_all_fail_all_optional_returns_true(self): """When every service is optional and every service fails -> True.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) a = Apprise(asset=asset) for i in range(3): s = _FailThenSucceedNotify( host=f"s{i}", asset=asset, fail_times=99 ) s.optional = True a.add(s) result = a.notify(body="test") assert bool(result) is True finally: N_MGR.unload_modules() def test_optional_mixed_required_fails_returns_false(self): """Required service failure taints result even with optional peers.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s_opt = _FailThenSucceedNotify( host="opt", asset=asset, fail_times=99 ) s_opt.optional = True s_req = _FailThenSucceedNotify( host="req", asset=asset, fail_times=99 ) # s_req.optional is False (default) a = Apprise(asset=asset) a.add(s_opt) a.add(s_req) result = a.notify(body="test") assert bool(result) is False finally: N_MGR.unload_modules() def test_optional_success_unaffected(self): """An optional service that succeeds is still counted as True.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s = _FailThenSucceedNotify(host="s1", asset=asset, fail_times=0) s.optional = True a = Apprise(asset=asset) a.add(s) result = a.notify(body="test") assert bool(result) is True assert s._calls == 1 finally: N_MGR.unload_modules() class TestPartialStatus: """AppriseResultStatus.PARTIAL: a batch where at least one service genuinely delivered and at least one did not, in the same call.""" def test_mixed_success_and_failure_is_partial(self): """One service succeeds, one fails outright -> PARTIAL, not FAILURE.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s_ok = _FailThenSucceedNotify(host="ok", asset=asset, fail_times=0) s_fail = _FailThenSucceedNotify( host="fail", asset=asset, fail_times=99 ) a = Apprise(asset=asset) a.add(s_ok) a.add(s_fail) result = a.notify(body="test") assert result.status == AppriseResultStatus.PARTIAL # PARTIAL is not the truthy SUCCESS value. assert bool(result) is False finally: N_MGR.unload_modules() def test_all_succeed_is_success_not_partial(self): """Every service succeeding stays SUCCESS -- PARTIAL requires at least one non-delivery in the same batch.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s1 = _FailThenSucceedNotify(host="s1", asset=asset, fail_times=0) s2 = _FailThenSucceedNotify(host="s2", asset=asset, fail_times=0) a = Apprise(asset=asset) a.add(s1) a.add(s2) result = a.notify(body="test") assert result.status == AppriseResultStatus.SUCCESS finally: N_MGR.unload_modules() def test_all_fail_is_failure_not_partial(self): """Every service failing outright stays FAILURE -- there is no genuine success in the batch to make it PARTIAL.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s1 = _FailThenSucceedNotify(host="s1", asset=asset, fail_times=99) s2 = _FailThenSucceedNotify(host="s2", asset=asset, fail_times=99) a = Apprise(asset=asset) a.add(s1) a.add(s2) result = a.notify(body="test") assert result.status == AppriseResultStatus.FAILURE finally: N_MGR.unload_modules() def test_optional_absorbed_failure_does_not_count_as_partial(self): """A forgiven optional=yes failure does not count as a 'genuine' success -- an optional service that never actually delivered, paired with a required service that also failed, is still a clean FAILURE, not PARTIAL.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=False) s_opt = _FailThenSucceedNotify( host="opt", asset=asset, fail_times=99 ) s_opt.optional = True s_req = _FailThenSucceedNotify( host="req", asset=asset, fail_times=99 ) a = Apprise(asset=asset) a.add(s_opt) a.add(s_req) result = a.notify(body="test") assert result.status == AppriseResultStatus.FAILURE finally: N_MGR.unload_modules() def test_success_plus_timeout_is_partial(self): """Report PARTIAL when one parallel service succeeds and one times out. Two asynchronous services force bounded parallel dispatch, which can stop waiting for an in-flight call; sequential dispatch cannot. """ N_MGR["failpass"] = _FailThenSucceedNotify N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True, service_timeout=0.05) s_ok = _FailThenSucceedNotify(host="ok", asset=asset, fail_times=0) s_slow = _SlowNotify(host="slow", asset=asset, delay=0.3) a = Apprise(asset=asset) a.add(s_ok) a.add(s_slow) result = a.notify(body="test") assert result.status == AppriseResultStatus.PARTIAL finally: N_MGR.unload_modules() def test_async_notify_mixed_outcome_is_partial(self): """The asyncio dispatch path reports PARTIAL the same way as the synchronous paths.""" N_MGR["failpass"] = _FailThenSucceedNotify try: asset = AppriseAsset(async_mode=True) s_ok = _FailThenSucceedNotify(host="ok", asset=asset, fail_times=0) s_fail = _FailThenSucceedNotify( host="fail", asset=asset, fail_times=99 ) a = Apprise(asset=asset) a.add(s_ok) a.add(s_fail) result = asyncio.run(a.async_notify(body="test")) assert result.status == AppriseResultStatus.PARTIAL finally: N_MGR.unload_modules() class TestCreateNotifyCalls: """Cover Apprise._create_notify_calls() which splits services into sequential and parallel buckets based on their asset.async_mode flag.""" def test_splits_sequential_and_parallel(self): """Sequential and parallel services are split into separate lists.""" N_MGR["failpass"] = _FailThenSucceedNotify try: # With async_mode=False all loaded services go to the sequential # bucket; the parallel bucket remains empty. asset_seq = AppriseAsset(async_mode=False) s_seq = _FailThenSucceedNotify( host="s1", asset=asset_seq, fail_times=0 ) a = Apprise(asset=asset_seq) a.add(s_seq) seq, par = a._create_notify_calls(body="test") assert len(seq) == 1 assert len(par) == 0 # With async_mode=True the same service is placed in the parallel # bucket instead. asset_par = AppriseAsset(async_mode=True) s_par = _FailThenSucceedNotify( host="s2", asset=asset_par, fail_times=0 ) b = Apprise(asset=asset_par) b.add(s_par) seq2, par2 = b._create_notify_calls(body="test") assert len(seq2) == 0 assert len(par2) == 1 finally: N_MGR.unload_modules() class TestAsyncioSafetyNet: """Cover async safety nets for exceptions that escape do_call.""" def test_exception_outside_try_block_triggers_safety_net(self): """An escaped property failure is reported beside a good service.""" class _RaisingLoggerService: """Service whose logger fails before delivery starts.""" service_name = "raiser" asset = AppriseAsset(async_mode=True) optional = False @property def logger(self): """Raise while the attempt's log capture is being built. Result-building reads are guarded, so this uses one that is not: the capture reads the service's own logger before any per-attempt handling exists to catch it. """ # This escapes do_call and is captured by asyncio.gather. raise RuntimeError("injected: property raised outside try") async def async_notify(self, **kwargs): """Represent delivery that must not be reached in this test.""" return True # pragma: no cover -- never reached class _GoodService: """Minimal well-behaved service that succeeds immediately.""" service_name = "good" asset = AppriseAsset(async_mode=True) optional = False tags = set() def url(self, privacy=False): """Return the stable URL used to identify this service.""" return "good://localhost" def url_id(self): """Return a stable identifier for result assertions.""" return "good-id" def __len__(self): """Report the single target represented by this service.""" return 1 async def async_notify(self, **kwargs): """Report immediate successful asynchronous delivery.""" return True raiser = _RaisingLoggerService() good = _GoodService() # Exercise both the escaped-exception and successful-result branches. ok, results = asyncio.run( Apprise._notify_parallel_asyncio((raiser, {}), (good, {})) ) assert ok is False assert len(results) == 2 class TestServiceTimeout: """AppriseAsset._service_timeout / notify(timeout=...) enforcement. Real sleeps are intentional here: these tests protect threaded/async deadline behaviour. Margins stay generous so slower CI hosts fail only for real regressions, not ordinary timing jitter. """ def test_sequential_between_attempts_timeout(self): """A real failure before timeout remains a FAILURE.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False, service_timeout=0.5) # First attempt costs 0.1s and fails, leaving ~0.4s of the # 0.5s budget. retry=5 with wait=5.0 would normally sleep # five seconds between attempts, but that must be capped to # the remaining budget, and no second attempt may start. service = _SlowNotify( host="x", asset=asset, delay=0.0, retry=5, wait=5.0 ) service.send = lambda **kw: (time.sleep(0.1), False)[1] a = Apprise(asset=asset) a.add(service) t0 = time.monotonic() result = a.notify(body="test") wall = time.monotonic() - t0 finally: N_MGR.unload_modules() r0 = next(iter(result)) # The worker and outer wait share a deadline, so accept either attempt # sequence when slower hosts change which one finishes first. assert len(r0.attempts) in (1, 2) assert r0.attempts[-1].status == AppriseResultStatus.TIMEOUT assert r0.max_attempts == 6 if len(r0.attempts) == 2: assert r0.attempts[0].status == AppriseResultStatus.FAILURE # A real failure takes priority over the synthetic timeout. assert r0.status == AppriseResultStatus.FAILURE else: # The outer wait finished first, leaving only its timeout. assert r0.status == AppriseResultStatus.TIMEOUT assert result.status == r0.status # The retry sleep uses the remaining budget instead of the full 5s. assert wall < 3.0 def test_threadpool_between_attempts_timeout_and_sleep_cap(self): """Thread-pool retry sleep is capped by the worker deadline.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True, service_timeout=2.0) # The failed first attempt leaves enough budget for the worker to # cap wait=5.0 itself before the outer bounded wait races it. slow = _SlowNotify( host="slow", asset=asset, delay=0.0, retry=3, wait=5.0 ) slow.send = lambda **kw: (time.sleep(0.3), False)[1] fast = _SlowNotify(host="fast", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(slow) a.add(fast) t0 = time.monotonic() result = a.notify(body="test") wall = time.monotonic() - t0 finally: N_MGR.unload_modules() by_host = {r.url: r for r in result} slow_result = by_host["slow://slow"] # The worker and outer wait share a deadline, so accept either attempt # sequence when slower hosts change which one finishes first. assert len(slow_result.attempts) in (1, 2) assert slow_result.attempts[-1].status == AppriseResultStatus.TIMEOUT assert slow_result.max_attempts == 4 if len(slow_result.attempts) == 2: assert ( slow_result.attempts[0].status == AppriseResultStatus.FAILURE ) # A real failure takes priority over the synthetic timeout. assert slow_result.status == AppriseResultStatus.FAILURE else: # The outer wait finished first, leaving only its timeout. assert slow_result.status == AppriseResultStatus.TIMEOUT assert by_host["slow://fast"].status == AppriseResultStatus.SUCCESS # The retry sleep uses the remaining budget instead of the full 5s. assert wall < 5.0 def test_asyncio_between_attempts_timeout_and_sleep_cap(self): """Same guarantee as the thread-pool test above, for the asyncio do_call() coroutine's own between-attempts deadline check.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True, service_timeout=2.0) slow = _SlowNotify( host="slow", asset=asset, delay=0.0, retry=3, wait=5.0 ) async def _fail_slowly(**kw): """Delay briefly, then fail so retry waiting consumes time.""" await asyncio.sleep(0.3) return False slow.async_notify = _fail_slowly fast = _SlowNotify(host="fast", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(slow) a.add(fast) t0 = time.monotonic() result = asyncio.run(a.async_notify(body="test")) wall = time.monotonic() - t0 finally: N_MGR.unload_modules() by_host = {r.url: r for r in result} slow_result = by_host["slow://slow"] # As above, accept either attempt sequence at the shared deadline. assert len(slow_result.attempts) in (1, 2) assert slow_result.attempts[-1].status == AppriseResultStatus.TIMEOUT assert slow_result.max_attempts == 4 if len(slow_result.attempts) == 2: assert ( slow_result.attempts[0].status == AppriseResultStatus.FAILURE ) # A real failure takes priority over the synthetic timeout. assert slow_result.status == AppriseResultStatus.FAILURE else: # The outer wait finished first, leaving only its timeout. assert slow_result.status == AppriseResultStatus.TIMEOUT assert by_host["slow://fast"].status == AppriseResultStatus.SUCCESS assert wall < 5.0 def test_sequential_service_timeout_disabled(self): """service_timeout=0 disables the cap -- a slow service still completes normally.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False, service_timeout=0) service = _SlowNotify(host="x", asset=asset, delay=0.05) a = Apprise(asset=asset) a.add(service) result = a.notify(body="test") finally: N_MGR.unload_modules() r0 = next(iter(result)) assert r0.status == AppriseResultStatus.SUCCESS assert service.calls == 1 def test_sequential_timeout_disabled_retry_wait(self): """With service_timeout=0 (no deadline at all), the retry/wait loop keeps its normal uncapped wait behaviour.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False, service_timeout=0) service = _SlowNotify( host="x", asset=asset, delay=0.0, retry=1, wait=0.01 ) call_count = {"n": 0} def _fail_then_succeed(**kw): """Fail once, then succeed to exercise an uncapped retry.""" call_count["n"] += 1 return call_count["n"] >= 2 service.send = _fail_then_succeed a = Apprise(asset=asset) a.add(service) result = a.notify(body="test") finally: N_MGR.unload_modules() r0 = next(iter(result)) assert r0.status == AppriseResultStatus.SUCCESS assert len(r0.attempts) == 2 def test_threadpool_outer_bound_abandons_slow_service(self): """A service stuck past its deadline is abandoned by the outer bounded wait; the batch returns promptly and the other service is unaffected.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True, service_timeout=0.5) slow = _SlowNotify(host="slow", asset=asset, delay=2.0) fast = _SlowNotify(host="fast", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(slow) a.add(fast) t0 = time.monotonic() result = a.notify(body="test") wall = time.monotonic() - t0 finally: N_MGR.unload_modules() # The whole call returned promptly -- nowhere near the slow # service's 2.0s delay -- even though that thread is still # running in the background because Python cannot stop the worker. assert wall < 3.0 by_host = {r.url: r for r in result} assert by_host["slow://slow"].status == (AppriseResultStatus.TIMEOUT) assert by_host["slow://fast"].status == (AppriseResultStatus.SUCCESS) def test_asyncio_outer_bound_abandons_slow_service(self): """Same guarantee as the thread-pool test, for async_notify().""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True, service_timeout=0.5) slow = _SlowNotify(host="slow", asset=asset, delay=2.0) fast = _SlowNotify(host="fast", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(slow) a.add(fast) t0 = time.monotonic() result = asyncio.run(a.async_notify(body="test")) wall = time.monotonic() - t0 finally: N_MGR.unload_modules() assert wall < 3.0 by_host = {r.url: r for r in result} assert by_host["slow://slow"].status == (AppriseResultStatus.TIMEOUT) assert by_host["slow://fast"].status == (AppriseResultStatus.SUCCESS) def test_threadpool_timeout_disabled_retry_wait(self): """With service_timeout=0, the thread-pool worker's retry/wait loop keeps its normal uncapped wait behaviour.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True, service_timeout=0) call_count = {"n": 0} def _fail_then_succeed(**kw): """Fail once, then succeed in the thread-pool retry loop.""" call_count["n"] += 1 return call_count["n"] >= 2 flaky = _SlowNotify( host="flaky", asset=asset, delay=0.0, retry=1, wait=0.01 ) flaky.send = _fail_then_succeed other = _SlowNotify(host="other", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(flaky) a.add(other) result = a.notify(body="test") finally: N_MGR.unload_modules() by_host = {r.url: r for r in result} assert by_host["slow://flaky"].status == AppriseResultStatus.SUCCESS assert len(by_host["slow://flaky"].attempts) == 2 assert by_host["slow://other"].status == AppriseResultStatus.SUCCESS def test_asyncio_timeout_disabled_retry_wait(self): """Same guarantee as the thread-pool test above, for the asyncio do_call() coroutine's retry/wait loop.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True, service_timeout=0) call_count = {"n": 0} async def _fail_then_succeed(**kw): """Fail once, then succeed in the asyncio retry loop.""" call_count["n"] += 1 return call_count["n"] >= 2 flaky = _SlowNotify( host="flaky", asset=asset, delay=0.0, retry=1, wait=0.01 ) flaky.async_notify = _fail_then_succeed other = _SlowNotify(host="other", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(flaky) a.add(other) result = asyncio.run(a.async_notify(body="test")) finally: N_MGR.unload_modules() by_host = {r.url: r for r in result} assert by_host["slow://flaky"].status == AppriseResultStatus.SUCCESS assert len(by_host["slow://flaky"].attempts) == 2 assert by_host["slow://other"].status == AppriseResultStatus.SUCCESS def test_notify_timeout_overrides_longer_asset_default(self): """notify(timeout=...) can cut a call short even when the asset default would have allowed more time.""" N_MGR["slow"] = _SlowNotify try: # Asset default is generous (10s); the call-level override # of 0.5s must win since it is the sooner of the two. asset = AppriseAsset(async_mode=True, service_timeout=10) slow1 = _SlowNotify(host="one", asset=asset, delay=2.0) slow2 = _SlowNotify(host="two", asset=asset, delay=2.0) a = Apprise(asset=asset) a.add(slow1) a.add(slow2) t0 = time.monotonic() result = a.notify(body="test", timeout=0.5) wall = time.monotonic() - t0 finally: N_MGR.unload_modules() assert wall < 3.0 assert all(r.status == AppriseResultStatus.TIMEOUT for r in result) def test_notify_timeout_keeps_stricter_asset_default(self): """The reverse also holds: a short asset default still applies even when notify(timeout=...) allows much more time.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True, service_timeout=0.5) slow1 = _SlowNotify(host="one", asset=asset, delay=2.0) slow2 = _SlowNotify(host="two", asset=asset, delay=2.0) a = Apprise(asset=asset) a.add(slow1) a.add(slow2) t0 = time.monotonic() result = a.notify(body="test", timeout=60) wall = time.monotonic() - t0 finally: N_MGR.unload_modules() assert wall < 3.0 assert all(r.status == AppriseResultStatus.TIMEOUT for r in result) def test_notify_negative_timeout_raises(self): """notify(timeout=-1) is a caller error, not a silent no-op.""" a = Apprise() a.add("json://localhost") with pytest.raises(ValueError): a.notify(body="test", timeout=-1) def test_async_notify_negative_timeout_raises(self): """async_notify(timeout=-1) is a caller error, not a silent no-op.""" a = Apprise() a.add("json://localhost") with pytest.raises(ValueError): asyncio.run(a.async_notify(body="test", timeout=-1)) def test_notify_infinite_timeout_raises(self): """notify(timeout=inf) is rejected; 0 is the unbounded spelling.""" a = Apprise() a.add("json://localhost") with pytest.raises(ValueError): a.notify(body="test", timeout=float("inf")) def test_notify_nan_timeout_raises(self): """notify(timeout=nan) is rejected instead of disabling the timeout.""" a = Apprise() a.add("json://localhost") with pytest.raises(ValueError): a.notify(body="test", timeout=float("nan")) def test_async_notify_infinite_timeout_raises(self): """async_notify(timeout=inf) is rejected for the same reason as notify(timeout=inf).""" a = Apprise() a.add("json://localhost") with pytest.raises(ValueError): asyncio.run(a.async_notify(body="test", timeout=float("inf"))) def test_notify_rejects_non_numeric_timeout(self): """notify() rejects a non-numeric timeout.""" a = Apprise() a.add("json://localhost") with pytest.raises(AppriseImproperlyConfigured): a.notify(body="test", timeout="abc") def test_notify_rejects_bool_timeout(self): """A bool timeout is rejected even though bool is an int subclass.""" a = Apprise() a.add("json://localhost") with pytest.raises(AppriseImproperlyConfigured): a.notify(body="test", timeout=True) def test_async_notify_rejects_non_numeric_timeout(self): """async_notify() rejects a non-numeric timeout.""" a = Apprise() a.add("json://localhost") with pytest.raises(AppriseImproperlyConfigured): asyncio.run(a.async_notify(body="test", timeout="abc")) def test_notify_timeout_defaults_to_zero(self): """timeout defaults to 0 (no call-level override) -- only AppriseAsset._service_timeout controls the default behaviour.""" import inspect signature = inspect.signature(Apprise.notify) assert signature.parameters["timeout"].default == 0 def test_timeout_logs_include_error_entry(self): """A TIMEOUT attempt includes a matching ERROR log entry. Each attempt takes one second, so the 1.5-second deadline expires during the retry wait or the second attempt. The grace period is widened so a slow test host cannot stop the wait before the worker reports its own attempts. """ N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False, service_timeout=1.5) service = _SlowNotify(host="x", asset=asset, retry=2) service.send = lambda **kw: (time.sleep(1.0), False)[1] a = Apprise(asset=asset) a.add(service) # Wait long enough for the worker to return its attempts. with mock.patch("apprise.apprise._ABANDON_GRACE_SECONDS", 5.0): result = a.notify(body="test") finally: N_MGR.unload_modules() r0 = next(iter(result)) # The earlier real failures still outrank the later timeout. assert r0.status == AppriseResultStatus.FAILURE assert r0.attempts[-1].status == AppriseResultStatus.TIMEOUT error_logs = [entry for entry in r0.logs() if entry.level == "ERROR"] assert len(error_logs) == 1 assert "did not finish" in error_logs[0].message assert r0.name in error_logs[0].message def test_timeout_result_json_includes_start_end_time(self): """A TIMEOUT NotifyResult still has start_time/end_time populated.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True, service_timeout=0.5) slow = _SlowNotify(host="slow", asset=asset, delay=3.0) fast = _SlowNotify(host="fast", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(slow) a.add(fast) result = a.notify(body="test") finally: N_MGR.unload_modules() by_host = {r.url: r for r in result} r0 = by_host["slow://slow"] assert r0.status == AppriseResultStatus.TIMEOUT assert r0.start_time is not None assert r0.end_time is not None # Datetime arithmetic can differ from float elapsed by tiny rounding. assert (r0.end_time - r0.start_time).total_seconds() == pytest.approx( r0.elapsed, abs=1e-5 ) def test_weight_reflects_service_len(self): """NotifyResult.weight mirrors len(service) (the plugin's own target count).""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) service = _SlowNotify(host="x", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(service) result = a.notify(body="test") finally: N_MGR.unload_modules() # _SlowNotify has no targets/list -- NotifyBase.__len__ always # reports at least 1. assert next(iter(result)).weight == len(service) == 1 def test_log_capture_records_warning_message(self): """A service WARNING is captured in NotifyResult.logs().""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) service = _SlowNotify(host="x", asset=asset, delay=0.0) def _fail_with_warning(**kw): """Emit a warning before reporting a delivery failure.""" service.logger.warning("HTTP 429 Too Many Requests") return False service.send = _fail_with_warning a = Apprise(asset=asset) a.add(service) logging.disable(logging.NOTSET) try: result = a.notify(body="test") finally: logging.disable(logging.CRITICAL) finally: N_MGR.unload_modules() r0 = next(iter(result)) assert r0.status == AppriseResultStatus.FAILURE logs = list(r0.logs()) assert len(logs) == 1 assert logs[0].level == "WARNING" assert "429" in logs[0].message assert "429" in str(logs[0]) def test_log_capture_preserves_preexisting_instance_logger(self): """_ServiceLogCapture does not replace a service's logger.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) service = _SlowNotify(host="x", asset=asset, delay=0.0) custom_logger = logging.getLogger("apprise.test.custom") service.logger = custom_logger a = Apprise(asset=asset) a.add(service) a.notify(body="test") finally: N_MGR.unload_modules() assert "logger" in service.__dict__ assert service.__dict__["logger"] is custom_logger def test_notify_log_callback_default_from_apprise_instance(self): """A log_callback given to Apprise() applies to every notify() call made with that instance, firing live with (entry, service) for each captured entry.""" N_MGR["slow"] = _SlowNotify received = [] def _cb(entry, service): """Collect the instance-level callback's service/message pair.""" received.append((service.service_name, entry.message)) try: asset = AppriseAsset(async_mode=False) service = _SlowNotify(host="x", asset=asset, delay=0.0) def _fail_with_warning(**kw): """Emit a warning and report a failed delivery attempt.""" service.logger.warning("HTTP 429 Too Many Requests") return False service.send = _fail_with_warning a = Apprise(asset=asset, log_callback=_cb) a.add(service) logging.disable(logging.NOTSET) try: a.notify(body="test") finally: logging.disable(logging.CRITICAL) finally: N_MGR.unload_modules() assert received == [ (service.service_name, "HTTP 429 Too Many Requests") ] def test_notify_log_callback_call_override(self): """log_callback passed directly to notify() takes priority over the Apprise instance's own default for that one call only.""" N_MGR["slow"] = _SlowNotify default_received = [] override_received = [] def _default_cb(entry, service): """Collect entries delivered to the instance default callback.""" default_received.append(entry.message) def _override_cb(entry, service): """Collect entries delivered to the per-call override callback.""" override_received.append(entry.message) try: asset = AppriseAsset(async_mode=False) service = _SlowNotify(host="x", asset=asset, delay=0.0) def _fail_with_warning(**kw): """Emit a warning and report a failed delivery attempt.""" service.logger.warning("overridden call") return False service.send = _fail_with_warning a = Apprise(asset=asset, log_callback=_default_cb) a.add(service) logging.disable(logging.NOTSET) try: a.notify(body="test", log_callback=_override_cb) finally: logging.disable(logging.CRITICAL) finally: N_MGR.unload_modules() assert default_received == [] assert override_received == ["overridden call"] def test_notify_log_level_default_is_warning(self): """Without an explicit log_level, captured entries still stop at WARNING -- INFO chatter from the service is not recorded.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) service = _SlowNotify(host="x", asset=asset, delay=0.0) def _info_then_warn(**kw): """Log at both INFO and WARNING, then report failure.""" service.logger.info("delivery attempt starting") service.logger.warning("HTTP 429 Too Many Requests") return False service.send = _info_then_warn a = Apprise(asset=asset) a.add(service) logging.disable(logging.NOTSET) try: result = a.notify(body="test") finally: logging.disable(logging.CRITICAL) finally: N_MGR.unload_modules() service_result = next(iter(result)) messages = [e.message for e in service_result.logs()] assert messages == ["HTTP 429 Too Many Requests"] def test_notify_callback_defaults_to_info(self): """A callback raises the default capture level to INFO.""" N_MGR["slow"] = _SlowNotify received = [] def _cb(entry, service): """Collect every entry the callback actually receives.""" received.append(entry.message) try: asset = AppriseAsset(async_mode=False) service = _SlowNotify(host="x", asset=asset, delay=0.0) def _info_then_warn(**kw): """Log at both INFO and WARNING, then report failure.""" service.logger.info("delivery attempt starting") service.logger.warning("HTTP 429 Too Many Requests") return False service.send = _info_then_warn a = Apprise(asset=asset, log_callback=_cb) a.add(service) apprise_logger = logging.getLogger("apprise") restore_level = apprise_logger.level apprise_logger.setLevel(logging.INFO) logging.disable(logging.NOTSET) try: result = a.notify(body="test") finally: logging.disable(logging.CRITICAL) apprise_logger.setLevel(restore_level) finally: N_MGR.unload_modules() service_result = next(iter(result)) messages = [e.message for e in service_result.logs()] assert messages == [ "delivery attempt starting", "HTTP 429 Too Many Requests", ] assert received == [ "delivery attempt starting", "HTTP 429 Too Many Requests", ] def test_notify_explicit_log_level_wins(self): """An explicit log level overrides the callback default.""" N_MGR["slow"] = _SlowNotify received = [] def _cb(entry, service): """Collect every entry the callback actually receives.""" received.append(entry.message) try: asset = AppriseAsset(async_mode=False) service = _SlowNotify(host="x", asset=asset, delay=0.0) def _info_then_warn(**kw): """Log at both INFO and WARNING, then report failure.""" service.logger.info("delivery attempt starting") service.logger.warning("HTTP 429 Too Many Requests") return False service.send = _info_then_warn a = Apprise(asset=asset, log_callback=_cb) a.add(service) logging.disable(logging.NOTSET) try: result = a.notify(body="test", log_level=logging.WARNING) finally: logging.disable(logging.CRITICAL) finally: N_MGR.unload_modules() service_result = next(iter(result)) messages = [e.message for e in service_result.logs()] assert messages == ["HTTP 429 Too Many Requests"] assert received == ["HTTP 429 Too Many Requests"] def test_notify_log_level_call_override(self): """log_level passed directly to notify() captures finer entries for that one call, overriding the Apprise instance's default.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) service = _SlowNotify(host="x", asset=asset, delay=0.0) def _info_then_warn(**kw): """Log at both INFO and WARNING, then report failure.""" service.logger.info("delivery attempt starting") service.logger.warning("HTTP 429 Too Many Requests") return False service.send = _info_then_warn a = Apprise(asset=asset) a.add(service) # log_level only widens what the capture handler keeps; the # 'apprise' logger's own effective level must independently # permit INFO records through before any handler sees them. apprise_logger = logging.getLogger("apprise") restore_level = apprise_logger.level apprise_logger.setLevel(logging.INFO) logging.disable(logging.NOTSET) try: result = a.notify(body="test", log_level=logging.INFO) finally: logging.disable(logging.CRITICAL) apprise_logger.setLevel(restore_level) finally: N_MGR.unload_modules() service_result = next(iter(result)) messages = [e.message for e in service_result.logs()] assert messages == [ "delivery attempt starting", "HTTP 429 Too Many Requests", ] def test_notify_log_level_default_from_apprise_instance(self): """A log_level given to Apprise() applies to every notify() call made with that instance, the same way log_callback does.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) service = _SlowNotify(host="x", asset=asset, delay=0.0) def _info_then_warn(**kw): """Log at both INFO and WARNING, then report failure.""" service.logger.info("delivery attempt starting") service.logger.warning("HTTP 429 Too Many Requests") return False service.send = _info_then_warn a = Apprise(asset=asset, log_level=logging.INFO) a.add(service) apprise_logger = logging.getLogger("apprise") restore_level = apprise_logger.level apprise_logger.setLevel(logging.INFO) logging.disable(logging.NOTSET) try: result = a.notify(body="test") finally: logging.disable(logging.CRITICAL) apprise_logger.setLevel(restore_level) finally: N_MGR.unload_modules() service_result = next(iter(result)) messages = [e.message for e in service_result.logs()] assert messages == [ "delivery attempt starting", "HTTP 429 Too Many Requests", ] def test_async_notify_log_level(self): """log_level works for a plugin's native async_notify() path.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True) service = _SlowNotify(host="x", asset=asset, delay=0.0) async def _info_then_warn(**kw): """Log at both INFO and WARNING, then report failure.""" service.logger.info("async attempt starting") service.logger.warning("async 429") return False service.async_notify = _info_then_warn a = Apprise(asset=asset) a.add(service) apprise_logger = logging.getLogger("apprise") restore_level = apprise_logger.level apprise_logger.setLevel(logging.INFO) logging.disable(logging.NOTSET) try: result = asyncio.run( a.async_notify(body="test", log_level=logging.INFO) ) finally: logging.disable(logging.CRITICAL) apprise_logger.setLevel(restore_level) finally: N_MGR.unload_modules() service_result = next(iter(result)) messages = [e.message for e in service_result.logs()] assert messages == ["async attempt starting", "async 429"] def test_async_notify_callback_defaults_to_info(self): """Async callbacks also default to INFO capture.""" N_MGR["slow"] = _SlowNotify received = [] def _cb(entry, service): """Collect service entries and ignore orchestration logs.""" if service is not None: received.append(entry.message) try: asset = AppriseAsset(async_mode=True) service = _SlowNotify(host="x", asset=asset, delay=0.0) async def _info_then_warn(**kw): """Log at both INFO and WARNING, then report failure.""" service.logger.info("async attempt starting") service.logger.warning("async 429") return False service.async_notify = _info_then_warn a = Apprise(asset=asset, log_callback=_cb) a.add(service) apprise_logger = logging.getLogger("apprise") restore_level = apprise_logger.level apprise_logger.setLevel(logging.INFO) logging.disable(logging.NOTSET) try: result = asyncio.run(a.async_notify(body="test")) finally: logging.disable(logging.CRITICAL) apprise_logger.setLevel(restore_level) finally: N_MGR.unload_modules() service_result = next(iter(result)) messages = [e.message for e in service_result.logs()] assert messages == ["async attempt starting", "async 429"] assert received == ["async attempt starting", "async 429"] def test_notify_call_logs_no_services(self): """Call logs include the warning when no services are loaded.""" a = Apprise() logging.disable(logging.NOTSET) try: result = a.notify(body="test") finally: logging.disable(logging.CRITICAL) assert result.status == AppriseResultStatus.NOMATCH assert any( "no service" in e.message.lower() for e in result.call_logs() ) # Merged into the combined timeline too. assert any("no service" in e.message.lower() for e in result.logs()) def test_notify_empty_content_returns_failure(self): """Invalid empty content returns a failure result without dispatch.""" a = Apprise() a.add(_TestNotify(host="localhost")) result = a.notify(body="") assert result.status == AppriseResultStatus.FAILURE assert len(result) == 0 def test_async_notify_validation_results(self): """Async validation distinguishes invalid content from no services.""" a = Apprise() a.add(_TestNotify(host="localhost")) invalid = asyncio.run(a.async_notify(body="")) no_services = asyncio.run(Apprise().async_notify(body="test")) assert invalid.status == AppriseResultStatus.FAILURE assert no_services.status == AppriseResultStatus.NOMATCH def test_notify_call_logs_retry_trace(self): """Call logs include retry details at TRACE level.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) service = _SlowNotify(host="x", asset=asset, delay=0.0, retry=1) def _always_fail(**kw): """Report failure on every attempt.""" return False service.send = _always_fail a = Apprise(asset=asset) a.add(service) apprise_logger = logging.getLogger("apprise") restore_level = apprise_logger.level apprise_logger.setLevel(logging.TRACE) logging.disable(logging.NOTSET) try: result = a.notify(body="test", log_level=logging.TRACE) finally: logging.disable(logging.CRITICAL) apprise_logger.setLevel(restore_level) finally: N_MGR.unload_modules() call_messages = [e.message for e in result.call_logs()] assert any("Starting attempt" in m for m in call_messages) assert any("trying again" in m for m in call_messages) def test_async_notify_call_logs(self): """Async notifications also collect call-level logs.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=True) service = _SlowNotify(host="x", asset=asset, delay=0.0) async def _fail(**kw): """Report failure without logging anything itself.""" return False service.async_notify = _fail a = Apprise(asset=asset) a.add(service) apprise_logger = logging.getLogger("apprise") restore_level = apprise_logger.level apprise_logger.setLevel(logging.TRACE) logging.disable(logging.NOTSET) try: result = asyncio.run( a.async_notify(body="test", log_level=logging.TRACE) ) finally: logging.disable(logging.CRITICAL) apprise_logger.setLevel(restore_level) finally: N_MGR.unload_modules() call_messages = [e.message for e in result.call_logs()] assert any("Starting attempt" in m for m in call_messages) def test_async_notify_log_callback(self): """log_callback works for a plugin's native async_notify().""" N_MGR["slow"] = _SlowNotify received = [] def _cb(entry, service): """Collect callback entries produced by async_notify().""" received.append((service.service_name, entry.message)) try: asset = AppriseAsset(async_mode=True) service = _SlowNotify(host="x", asset=asset, delay=0.0) async def _fail_with_warning(**kw): """Emit a warning from the native async_notify override.""" service.logger.warning("async 429") return False service.async_notify = _fail_with_warning a = Apprise(asset=asset, log_callback=_cb) a.add(service) logging.disable(logging.NOTSET) try: asyncio.run(a.async_notify(body="test")) finally: logging.disable(logging.CRITICAL) finally: N_MGR.unload_modules() assert received == [(service.service_name, "async 429")] def test_notify_log_callback_thread_attribution(self): """Concurrent log callbacks are attributed to the right service.""" N_MGR["slow"] = _SlowNotify received = [] lock = threading.Lock() def _cb(entry, service): """Append callback data under a lock.""" with lock: received.append((service.host, entry.message)) def _make_send(service): """Build a send() replacement bound to one service instance.""" def _send(**kw): """Emit a host-specific warning from the bound service.""" service.logger.warning("warning from %s", service.host) return True return _send try: asset = AppriseAsset(async_mode=True) a = Apprise(asset=asset, log_callback=_cb) services = [] for i in range(6): service = _SlowNotify(host=f"host{i}", asset=asset, delay=0.02) service.send = _make_send(service) services.append(service) a.add(service) logging.disable(logging.NOTSET) try: a.notify(body="test") finally: logging.disable(logging.CRITICAL) finally: N_MGR.unload_modules() assert sorted(received) == sorted( (s.host, f"warning from {s.host}") for s in services ) def test_timeout_result_defensive_on_malformed_service(self): """Timeout metadata falls back when service helpers are missing.""" class _MalformedSlowService: """A service missing url()/url_id()/__len__ that never finishes in time, exercising timeout_result's defensive except paths. """ service_name = "malformed" asset = AppriseAsset(async_mode=True, service_timeout=0.1) optional = False tags: set = set() retry = 0 wait = 0.0 async def async_notify(self, **kwargs): """Remain active long enough to exceed the test deadline.""" await asyncio.sleep(1.0) return True # pragma: no cover -- never reached in time good = _SlowNotify( host="good", asset=AppriseAsset(async_mode=True), delay=0.0 ) malformed = _MalformedSlowService() ok, results = asyncio.run( Apprise._notify_parallel_asyncio( (malformed, {}), (good, {}), ) ) assert ok is False by_url = {r.url: r for r in results} # No url()/url_id()/__len__ on the malformed service -- defensive # fallbacks kick in rather than raising. assert by_url["unknown://"].status == AppriseResultStatus.TIMEOUT assert by_url["unknown://"].url_id is None assert by_url["unknown://"].weight == 1 assert by_url["slow://good"].status == AppriseResultStatus.SUCCESS def test_notify_result_tag_is_sorted(self): """NotifyResult.tag is sorted for stable output.""" N_MGR["slow"] = _SlowNotify try: service = _SlowNotify( host="x", asset=AppriseAsset(async_mode=False), delay=0.0, tag=["zeta", "alpha", "middle", "beta"], ) a = Apprise() a.add(service) result = a.notify(body="test") finally: N_MGR.unload_modules() r0 = next(iter(result)) assert r0.tag == ("alpha", "beta", "middle", "zeta") def test_threadpool_queued_futures_cancelled(self): """A service still queued behind other work in a size-limited thread pool must not execute later after timeout.""" N_MGR["slow"] = _SlowNotify # More services than the default ThreadPoolExecutor can run at once, # so some work is guaranteed to still be queued at the deadline. n_services = 40 started: list[int] = [] finished: list[int] = [] lock = threading.Lock() def _slow_send(idx): """Build a send() replacement that records start and finish.""" def _send(**kwargs): """Simulate slow work so queued futures can be cancelled.""" with lock: started.append(idx) time.sleep(0.3) with lock: finished.append(idx) return True return _send try: asset = AppriseAsset(async_mode=True, service_timeout=0.05) a = Apprise(asset=asset) services = [] for i in range(n_services): service = _SlowNotify(host=f"host{i}", asset=asset, delay=0.0) service.send = _slow_send(i) services.append(service) a.add(service) result = a.notify(body="test") assert result.status == AppriseResultStatus.TIMEOUT with lock: started_at_return = len(started) # Give uncancelled queued work enough time to reveal itself. time.sleep(1.0) with lock: started_later = len(started) finished_later = len(finished) finally: N_MGR.unload_modules() # Some work stayed queued because the pool is size-limited. assert 0 < started_at_return < n_services # And none of the ones that hadn't started yet ever did. assert started_later == started_at_return assert finished_later == started_at_return def test_sequential_queued_future_cancelled(self): """A sequential service whose future never got a chance to start (still queued behind other work in a size-limited pool) is cancelled outright at the deadline -- nothing is left running, so it is never tracked as abandoned.""" N_MGR["slow"] = _SlowNotify try: import concurrent.futures as cf import apprise.apprise as apprise_module release = threading.Event() with mock.patch( "apprise.apprise._shared_executor", cf.ThreadPoolExecutor(max_workers=1), ): executor = apprise_module._shared_executor # Occupy the pool's only worker so the service's own # future stays queued until its deadline has passed. blocker = executor.submit(release.wait, 2.0) asset = AppriseAsset(async_mode=False, service_timeout=0.05) service = _SlowNotify(host="x", asset=asset, delay=0.0) a = Apprise(asset=asset) a.add(service) result = a.notify(body="test") release.set() blocker.result(timeout=2.0) executor.shutdown(wait=True) finally: N_MGR.unload_modules() assert result.status == AppriseResultStatus.TIMEOUT # Still queued when abandoned -- it never actually got to run. assert service.calls == 0 def test_threadpool_shared_across_notify_calls(self): """Separate notify() calls reuse the shared executor.""" N_MGR["slow"] = _SlowNotify try: import apprise.apprise as apprise_module # Force this test to observe executor construction. with mock.patch("apprise.apprise._shared_executor", None): executors_seen = set() for i in range(3): asset = AppriseAsset(async_mode=True, service_timeout=0.05) a = Apprise(asset=asset) service = _SlowNotify( host=f"host{i}", asset=asset, delay=1.0 ) a.add(service) result = a.notify(body="test") assert result.status == AppriseResultStatus.TIMEOUT executors_seen.add(id(apprise_module._shared_executor)) # All three notify() calls reused the same executor. assert len(executors_seen) == 1 # Clean up the temporary executor before mock.patch restores. apprise_module._shared_executor.shutdown(wait=False) finally: N_MGR.unload_modules() def test_abandoned_calls_reflect_running_state(self): """Tracked abandoned calls clear once their background work ends.""" import apprise.apprise as apprise_module N_MGR["slow"] = _SlowNotify try: # A call still queued when the timeout hits is cancelled rather # than abandoned, so give a busy machine plenty of time to start # it, and keep it running well past the timeout. asset = AppriseAsset(async_mode=True, service_timeout=0.5) a = Apprise(asset=asset) service = _SlowNotify(host="host", asset=asset, delay=2.0) a.add(service) result = a.notify(body="test") assert result.status == AppriseResultStatus.TIMEOUT # The 2s send() is still running in the background -- # notify() only gave up waiting on it, it did not stop it. assert apprise_module.any_abandoned_calls_still_running() is True # Give it a generous window to actually finish. wait_until( lambda: not apprise_module.any_abandoned_calls_still_running() ) assert apprise_module.any_abandoned_calls_still_running() is False finally: N_MGR.unload_modules() def test_abandoned_call_descriptions_clear(self): """Abandoned-call descriptions clear once the service finishes.""" import apprise.apprise as apprise_module N_MGR["slow"] = _SlowNotify try: # A call still queued when the timeout hits is cancelled rather # than abandoned, so give a busy machine plenty of time to start # it, and keep it running well past the timeout. asset = AppriseAsset(async_mode=True, service_timeout=0.5) a = Apprise(asset=asset) service = _SlowNotify( host="descriptionhost", asset=asset, delay=2.0 ) a.add(service) result = a.notify(body="test") assert result.status == AppriseResultStatus.TIMEOUT descriptions = apprise_module.abandoned_call_descriptions() assert len(descriptions) == 1 assert "slow://descriptionhost" in descriptions[0] # Once the service finishes, its abandoned-call description clears. wait_until( lambda: not apprise_module.abandoned_call_descriptions() ) assert apprise_module.abandoned_call_descriptions() == [] finally: N_MGR.unload_modules() def test_abandoned_calls_false_when_only_queued(self): """Cancelled queued work does not count as still running.""" import apprise.apprise as apprise_module N_MGR["slow"] = _SlowNotify n_services = 40 try: asset = AppriseAsset(async_mode=True, service_timeout=0.05) a = Apprise(asset=asset) for i in range(n_services): service = _SlowNotify(host=f"host{i}", asset=asset, delay=0.3) a.add(service) result = a.notify(body="test") assert result.status == AppriseResultStatus.TIMEOUT # Queued futures are cancelled before they ever touch the tracked # abandoned-call list; any running work should settle quickly. wait_until( lambda: not apprise_module.any_abandoned_calls_still_running() ) assert apprise_module.any_abandoned_calls_still_running() is False finally: N_MGR.unload_modules() def test_timeout_logged_once(self): """A service timeout is reported once, not once per capture.""" N_MGR["slow"] = _SlowNotify try: asset = AppriseAsset(async_mode=False) # The delay is well past the limit so the wait always wins. service = _SlowNotify(host="x", asset=asset, delay=2.0) a = Apprise(asset=asset) a.add(service) with apprise_logs_enabled(): result = a.notify(body="test", timeout=0.25) finally: N_MGR.unload_modules() assert result.status == AppriseResultStatus.TIMEOUT timeouts = [ e.message for e in result.logs() if "did not finish within" in e.message ] assert len(timeouts) == 1 # The entry belongs to the service attempt. Capturing the logged # copy as well would list the same timeout twice above. assert not [ e for e in result.call_logs() if "did not finish within" in e.message ] def test_timeout_reaches_log_callback(self): """A live callback still sees the timeout the result stores once.""" N_MGR["slow"] = _SlowNotify received = [] try: asset = AppriseAsset(async_mode=False) # The delay is well past the limit so the wait always wins. service = _SlowNotify(host="x", asset=asset, delay=2.0) a = Apprise(asset=asset) a.add(service) with apprise_logs_enabled(): result = a.notify( body="test", timeout=0.25, log_callback=lambda entry, svc: received.append( entry.message ), ) finally: N_MGR.unload_modules() assert result.status == AppriseResultStatus.TIMEOUT # Delivered live exactly once, and kept exactly once. Suppressing # the stored copy must not cost the callback its notice. stored = [ e for e in result.logs() if "did not finish within" in e.message ] delivered = [m for m in received if "did not finish within" in m] assert len(stored) == 1 assert len(delivered) == 1 class _SlowFailNotify(NotifyBase): """Fails after a configurable delay so deadlines can pass mid-attempt.""" app_id = "SlowFailApp" app_desc = "Test" notify_url = "slowfail://" title_maxlen = 250 body_maxlen = 32768 def __init__(self, delay=0.0, **kwargs): """Initialize the test plugin with its artificial delay.""" super().__init__(**kwargs) self._delay = delay self.calls = 0 def url(self, *args, **kwargs): """Return a stable URL containing the test host.""" return "slowfail://{}".format(self.host) def send(self, **kwargs): """Block for the configured delay, then report failure.""" self.calls += 1 time.sleep(self._delay) return False async def async_notify(self, **kwargs): """Block for the configured delay, then report failure.""" self.calls += 1 await asyncio.sleep(self._delay) return False @staticmethod def parse_url(url): """Parse the synthetic URL without requiring a real host.""" return NotifyBase.parse_url(url, verify_host=False) class TestDeadlineExpiresDuringAttempt: """Deadline-expired retries should stop without sleeping first.""" def test_sequential_abandons_service_that_blocks_past_deadline(self): """A blocking sync service is abandoned once its deadline passes.""" N_MGR["slowfail"] = _SlowFailNotify try: asset = AppriseAsset(async_mode=False, service_timeout=0.05) service = _SlowFailNotify( host="x", asset=asset, retry=1, wait=1.0, delay=1.0 ) a = Apprise(asset=asset) a.add(service) t0 = time.monotonic() result = a.notify(body="test") wall = time.monotonic() - t0 # The result returns nowhere near the full blocking send() # delay -- generous slack here for loaded CI runners, since # only the *relative* gap to the 1.0s delay matters. assert wall < 0.6 assert result.status == AppriseResultStatus.TIMEOUT # The first attempt started, but no retry was launched. assert service.calls == 1 finally: N_MGR.unload_modules() def test_asyncio_skips_wait_when_deadline_already_passed(self): """Async retry skips its wait once the deadline has passed.""" N_MGR["slowfail"] = _SlowFailNotify try: asset = AppriseAsset(async_mode=True, service_timeout=0.05) service = _SlowFailNotify( host="x", asset=asset, retry=1, wait=1.0, delay=0.08 ) a = Apprise(asset=asset) a.add(service) # Keep the delay just above service_timeout so do_call() reaches # its retry check before the outer abandon window takes over. result = asyncio.run(a.async_notify(body="test")) assert result.status == AppriseResultStatus.FAILURE assert service.calls == 1 finally: N_MGR.unload_modules() class _SlowThreadedNotify(NotifyBase): """Test the default async wrapper around a synchronous send.""" app_id = "SlowThreadedApp" app_desc = "Test" notify_url = "slowthreaded://" title_maxlen = 250 body_maxlen = 32768 def __init__(self, delay=0.0, **kwargs): """Initialize the test plugin with its artificial delay.""" super().__init__(**kwargs) self._delay = delay self.calls = 0 def url(self, *args, **kwargs): """Return a stable URL containing the test host.""" return "slowthreaded://{}".format(self.host) def send(self, **kwargs): """Block the calling (executor) thread for the configured delay.""" self.calls += 1 time.sleep(self._delay) return True @staticmethod def parse_url(url): """Parse the synthetic URL without requiring a real host.""" return NotifyBase.parse_url(url, verify_host=False) class TestAsyncAbandonedCallTracking: """Track timed-out sends while their worker threads are still running.""" def test_abandoned_async_call_is_tracked_until_it_finishes(self): """A timed-out send stays tracked until its worker finishes.""" import apprise.apprise as apprise_module N_MGR["slowthreaded"] = _SlowThreadedNotify try: # A call still queued when the timeout hits is cancelled rather # than abandoned, so give a busy machine plenty of time to start # it, and keep it running well past the timeout. asset = AppriseAsset(async_mode=True, service_timeout=0.5) service = _SlowThreadedNotify(host="x", asset=asset, delay=2.0) a = Apprise(asset=asset) a.add(service) result = asyncio.run(a.async_notify(body="test")) assert result.status == AppriseResultStatus.TIMEOUT # The sleeping worker remains visible after the timeout. assert apprise_module.any_abandoned_calls_still_running() is True descriptions = apprise_module.abandoned_call_descriptions() assert any("x" in d or "slowthreaded" in d for d in descriptions) # Once the real delay elapses, it drops out of the list. wait_until( lambda: not apprise_module.any_abandoned_calls_still_running() ) assert apprise_module.any_abandoned_calls_still_running() is False assert service.calls == 1 finally: N_MGR.unload_modules() def test_queued_call_not_yet_running_is_not_tracked(self): """A cancelled send that never started is not tracked.""" import concurrent.futures as cf import apprise.apprise as apprise_module N_MGR["slowthreaded"] = _SlowThreadedNotify busy_executor = cf.ThreadPoolExecutor(max_workers=1) block_event = threading.Event() filler = busy_executor.submit(block_event.wait, 5) try: with mock.patch( "apprise.apprise.get_shared_executor", return_value=busy_executor, ): asset = AppriseAsset(async_mode=True, service_timeout=0.05) service = _SlowThreadedNotify(host="x", asset=asset) a = Apprise(asset=asset) a.add(service) result = asyncio.run(a.async_notify(body="test")) assert result.status == AppriseResultStatus.TIMEOUT # The queued call never started, so it is not abandoned work. assert apprise_module.any_abandoned_calls_still_running() is False assert service.calls == 0 finally: block_event.set() filler.result(timeout=5) busy_executor.shutdown(wait=True) N_MGR.unload_modules() class TestSharedExecutorRace: """get_shared_executor() must reuse an executor created during locking.""" def test_inner_check_skips_creation_if_already_set(self): """The inner lock check returns the executor another thread created.""" import apprise.apprise as apprise_module sentinel = mock.Mock(name="already-created-executor") class _RaceLock: """Simulate another thread creating the executor first.""" def __enter__(self): apprise_module._shared_executor = sentinel return self def __exit__(self, *exc): return False with ( mock.patch("apprise.apprise._shared_executor", None), mock.patch("apprise.apprise._shared_executor_lock", _RaceLock()), mock.patch("apprise.apprise.cf.ThreadPoolExecutor") as mock_pool, ): result = apprise_module.get_shared_executor() assert result is sentinel mock_pool.assert_not_called() def test_coordinator_inner_check_skips_creation_if_already_set(self): """Same race-safety guarantee for the coordinator pool.""" import apprise.apprise as apprise_module sentinel = mock.Mock(name="already-created-coordinator-executor") class _RaceLock: """Simulate another thread creating the executor first.""" def __enter__(self): apprise_module._coordinator_executor = sentinel return self def __exit__(self, *exc): return False with ( mock.patch("apprise.apprise._coordinator_executor", None), mock.patch( "apprise.apprise._coordinator_executor_lock", _RaceLock() ), mock.patch("apprise.apprise.cf.ThreadPoolExecutor") as mock_pool, ): result = apprise_module.get_coordinator_executor() assert result is sentinel mock_pool.assert_not_called() class TestCoordinatorLeafPoolSeparation: """Keep coordinators separate from the service calls they await. Single-worker pools make starvation failures deterministic. """ def test_multiple_chains_do_not_starve_their_own_leaf_calls(self): """Multiple tag chains succeed with one worker in each pool.""" import concurrent.futures as cf import apprise.apprise as apprise_module N_MGR["failpass"] = _FailThenSucceedNotify try: # A finite deadline turns starvation into a test failure. asset = AppriseAsset(async_mode=False, service_timeout=5) s_devops = _FailThenSucceedNotify( host="devops", asset=asset, fail_times=0 ) s_devops.tags = {"devops"} s_mgmt = _FailThenSucceedNotify( host="mgmt", asset=asset, fail_times=0 ) s_mgmt.tags = {"management"} a = Apprise(asset=asset) a.add(s_devops) a.add(s_mgmt) with ( mock.patch( "apprise.apprise._shared_executor", cf.ThreadPoolExecutor(max_workers=1), ), mock.patch( "apprise.apprise._coordinator_executor", cf.ThreadPoolExecutor(max_workers=1), ), ): # Distinct OR tags exercise the multiple-chain path. result = a.notify(body="test", tag="devops management") assert bool(result) is True assert s_devops._calls == 1 assert s_mgmt._calls == 1 finally: N_MGR.unload_modules() apprise_module._shared_executor = None apprise_module._coordinator_executor = None def test_async_sequential_batch_does_not_starve_itself(self): """Async dispatch can still run its blocking service batch.""" import concurrent.futures as cf import apprise.apprise as apprise_module # A synchronous service exercises the coordinator-backed blocking path. asset = AppriseAsset(async_mode=False, service_timeout=5) service = _FailThenSucceedNotify( host="solo", asset=asset, fail_times=0 ) async def run(): return await Apprise._split_and_dispatch_async( [(service, {"body": "test"})] ) with ( mock.patch( "apprise.apprise._shared_executor", cf.ThreadPoolExecutor(max_workers=1), ), mock.patch( "apprise.apprise._coordinator_executor", cf.ThreadPoolExecutor(max_workers=1), ), ): ok, _results = asyncio.run(run()) assert ok is True assert service._calls == 1 apprise_module._shared_executor = None apprise_module._coordinator_executor = None caronc-apprise-dfec414/tests/test_secure_logging.py000066400000000000000000000174301526720371000226730ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. """Verify that logging masks credentials in file-like URL inputs. See CWE-312 for the related cleartext-storage weakness. """ import logging import os from unittest import mock from urllib.parse import urlparse import pytest import requests from apprise import ( LOGGER_NAME, AppriseAsset, AppriseAttachment, AppriseConfig, utils, ) from apprise.attachment import AttachBase from apprise.common import ContentLocation from apprise.utils.pgp import ApprisePGPController # A password that must never turn up in a log line SECRET = "pass123" # URLs shaped like supported key and attachment inputs. SECRET_KEY_URL = f"https://user:{SECRET}@example.com/private_key.pem" SECRET_ATTACH_URL = f"https://user:{SECRET}@example.com/image.png" @pytest.fixture def logs(caplog): """Capture Apprise logs, undoing logging disabled by other test modules.""" disabled = logging.root.manager.disable logging.disable(logging.NOTSET) caplog.set_level(1, logger=LOGGER_NAME) yield caplog logging.disable(disabled) @pytest.fixture def unreachable(): """Makes any attempt to fetch a remote file fail.""" with mock.patch( "requests.get", side_effect=requests.RequestException("nope") ): yield def test_pem_private_keyfile_credentials(logs, unreachable, tmpdir): """A PEM private key url does not put its password in the log.""" pem = utils.pem.ApprisePEMController(path=str(tmpdir)) assert pem.load_private_key(SECRET_KEY_URL) is False # The failure is reported without the password. assert "Could not access PEM Private Key" in logs.text assert SECRET not in logs.text # Parse logged URLs before checking which host was retained. urls_in_logs = [token for token in logs.text.split() if "://" in token] assert any( urlparse(token).hostname == "example.com" for token in urls_in_logs ) # The masked form is what was written. assert "user:p...3@example.com" in logs.text def test_pem_public_keyfile_credentials(logs, unreachable, tmpdir): """A PEM public key url does not put its password in the log.""" pem = utils.pem.ApprisePEMController(path=str(tmpdir)) assert pem.load_public_key(SECRET_KEY_URL) is False assert "Could not access PEM Public Key" in logs.text assert SECRET not in logs.text def test_attachment_url_credentials(logs, unreachable): """Adding a remote attachment does not log its password.""" attach = AppriseAttachment() assert attach.add(SECRET_ATTACH_URL) is True assert "Loading attachment" in logs.text assert SECRET not in logs.text def test_attachment_disabled_credentials(logs): """Refusing an attachment does not log its password either.""" attach = AppriseAttachment(location=ContentLocation.INACCESSIBLE) assert attach.add(SECRET_ATTACH_URL) is False assert "Attachments are disabled" in logs.text assert SECRET not in logs.text def test_attachment_parse_failure_credentials(logs): """Mask credentials when an attachment URL cannot be parsed.""" url = f"https://user:{SECRET}@example.com:bad/image.png" assert AppriseAttachment().add(url) is False assert "Unparseable URL" in logs.text assert SECRET not in logs.text def test_attachment_load_failure_credentials(logs): """Mask credentials when attachment construction raises an exception.""" class BadAttach(AttachBase): def __init__(self, **kwargs): super().__init__(**kwargs) raise TypeError() manager = AppriseAttachment.instantiate.__globals__["A_MGR"] manager["securebad"] = BadAttach try: url = f"securebad://user:{SECRET}@localhost/file" assert AppriseAttachment.instantiate(url) is None finally: del manager["securebad"] assert "Could not load URL" in logs.text assert SECRET not in logs.text def test_secure_logging_disabled(logs, unreachable, tmpdir): """Disabling secure logging exposes the full value for debugging.""" asset = AppriseAsset(secure_logging=False) pem = utils.pem.ApprisePEMController(path=str(tmpdir), asset=asset) assert pem.load_private_key(SECRET_KEY_URL) is False # With masking off, the full URL and password appear. assert SECRET in logs.text assert SECRET_KEY_URL in logs.text def test_pem_keyfile_read_errors(logs, tmpdir): """Keep a failed local key path readable so users can identify it.""" keyfile = os.path.join(str(tmpdir), "private_key.pem") with open(keyfile, "w") as f: f.write("not a real key") pem = utils.pem.ApprisePEMController(path=str(tmpdir)) # Simulate a file disappearing before it is opened. with mock.patch("builtins.open", side_effect=FileNotFoundError): assert pem.load_private_key(keyfile) is False assert "PEM Private Key file not found" in logs.text assert keyfile in logs.text # Simulate a file that cannot be read. logs.clear() with mock.patch("builtins.open", side_effect=OSError): assert pem.load_private_key(keyfile) is False assert "Error accessing PEM Private Key file" in logs.text assert keyfile in logs.text # Public keys handle the same failures. logs.clear() with mock.patch("builtins.open", side_effect=FileNotFoundError): assert pem.load_public_key(keyfile) is False assert "PEM Public Key file not found" in logs.text assert keyfile in logs.text logs.clear() with mock.patch("builtins.open", side_effect=OSError): assert pem.load_public_key(keyfile) is False assert "Error accessing PEM Public Key file" in logs.text assert keyfile in logs.text @pytest.mark.parametrize("method", ("private_key", "public_key")) def test_pgp_key_credentials(logs, tmpdir, method): """Mask credentials in PGP key read failures.""" pgp = ApprisePGPController(path=str(tmpdir)) keyfile_method = f"{method}file" error = OSError("disk error") with ( mock.patch.object(pgp, keyfile_method, return_value=SECRET_KEY_URL), mock.patch("builtins.open", side_effect=error), ): assert getattr(pgp, method)() is None assert "disk error" in logs.text assert SECRET not in logs.text def test_config_parse_failure_credentials(logs): """Mask credentials when a configuration URL cannot be parsed.""" url = f"https://user:{SECRET}@example.com:bad/config.yml" assert AppriseConfig().add(url) is False assert "Unparseable URL" in logs.text assert SECRET not in logs.text caronc-apprise-dfec414/tests/test_template.py000066400000000000000000000601021526720371000215040ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. """Tests for the template variable helpers.""" import time from unittest import mock import pytest from apprise.exception import AppriseTemplateError from apprise.utils.template import ( MAX_TEMPLATE_VALUE_LEN, TemplatePlaceholderMap, TemplateSchema, normalize_name, resolve_values, validate_value, ) def schema_of(*entries): """Build a schema from the entries given.""" return TemplateSchema.parse(list(entries)) def test_declaration_accepts_a_list(): """A list may mix bare names with names that carry a default.""" schema = schema_of("target", {"smtp_host": "smtp.example.com"}) assert sorted(schema.names) == ["smtp_host", "target"] assert schema.required == ("target",) assert schema.variables["smtp_host"].default == "smtp.example.com" def test_declaration_accepts_a_mapping(): """A mapping means the same thing as the list form. - a value present is the default - no value at all makes the variable mandatory """ schema = TemplateSchema.parse( { "smtp_host": "smtp.example.com", "target": None, } ) assert sorted(schema.names) == ["smtp_host", "target"] assert schema.required == ("target",) def test_template_empty_default_is_required(): """``- name:`` reads the same as a bare ``- name``.""" assert schema_of({"target": None}).required == ("target",) def test_template_name_case_insensitive(): """TARGET, Target and target all name the same variable.""" schema = schema_of("TaRgEt") assert schema.names == ("target",) assert "TARGET" in schema assert normalize_name("TARGET") == "target" def test_template_rejects_duplicate_name(): """The same name twice is refused, even in a different case.""" with pytest.raises(AppriseTemplateError): schema_of("target", "TARGET") @pytest.mark.parametrize( "name", ["", "a b", "has-dash", "x" * 33, "with.dot", "sym$"], ) def test_template_rejects_invalid_name(name): """Only letters, digits and underscores are allowed.""" with pytest.raises(AppriseTemplateError): schema_of(name) def test_template_many_declarations(): """There is no cap on how many variables are declared.""" schema = schema_of(*[f"v{i}" for i in range(500)]) assert len(schema.names) == 500 @pytest.mark.parametrize("entries", ["a string", 42, None]) def test_template_rejects_invalid_section(entries): """The section has to be a list or a mapping.""" with pytest.raises(AppriseTemplateError): TemplateSchema.parse(entries) def test_template_replaces_declared_names_only(): """An undeclared ${...} is left exactly as it was written. This is what keeps a password holding ``${`` intact. """ placeholders = TemplatePlaceholderMap(schema_of("target"), "") text = "json://user:${NOT_DECLARED}@host/${TARGET}" encoded = placeholders.encode(text) assert "${NOT_DECLARED}" in encoded assert "${TARGET}" not in encoded @pytest.mark.parametrize( ("text", "expected"), [ # A "$" in front is ordinary text kept beside the value ("$${A}", "$real"), # ...as is any other text either side of the marker ("x-$${A}-y", "x-$real-y"), # Two of them are simply two ("$$${A}", "$$real"), ], ) def test_template_dollar_is_literal(text, expected): """There is no escape syntax; a "$" is just a "$".""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") encoded = placeholders.encode(text) assert placeholders.used(encoded) == {"a"} assert placeholders.substitute(encoded, {"a": "real"}) == expected def test_template_marker_value_is_not_expanded(): """A value is dropped in as it is, markers and all. Only the original text is scanned, so a value that happens to contain ${NAME} is never looked at a second time. """ placeholders = TemplatePlaceholderMap(schema_of("a", "b"), "") encoded = placeholders.encode("${A}") # The value for 'a' mentions 'b', and stays exactly that text result = placeholders.substitute(encoded, {"a": "${B}", "b": "34"}) assert result == "${B}" def test_template_default_marker_is_literal(): """One declaration never builds on another.""" schema = TemplateSchema.parse([{"value": "34"}, {"key": "${value}"}]) assert schema.variables["key"].default == "${value}" assert resolve_values(schema, None, {}) == { "value": "34", "key": "${value}", } @pytest.mark.parametrize( "secret", ["p${a}ss", "$${x}", "${}", "${toolong" + "g" * 40 + "}", "$", "${"], ids=["inline", "double-dollar", "empty", "over-long", "bare", "unclosed"], ) def test_template_preserves_literal_markers(secret): """Nothing is declared, so nothing may be replaced.""" placeholders = TemplatePlaceholderMap(TemplateSchema(), "") assert placeholders.encode(secret) == secret def test_template_replaces_repeated_name(): """Writing one more than once fills the same value in each time.""" placeholders = TemplatePlaceholderMap(schema_of("target"), "") encoded = placeholders.encode("${TARGET}/a/${TARGET}?x=${TARGET}") result = placeholders.substitute(encoded, {"target": "VALUE"}) assert result == "VALUE/a/VALUE?x=VALUE" def test_template_single_pass_substitution(): """A value that looks like a placeholder is left as data.""" placeholders = TemplatePlaceholderMap(schema_of("a", "b"), "") encoded = placeholders.encode("${A}-${B}") # Feed one variable the text of the other's placeholder other = placeholders.encode("${B}") result = placeholders.substitute(encoded, {"a": other, "b": "second"}) assert result == f"{other}-second" def test_template_display_restores_names(): """A placeholder reads as ${NAME} again for display.""" placeholders = TemplatePlaceholderMap(schema_of("target"), "") encoded = placeholders.encode("json://host/${TARGET}/${TARGET}") assert placeholders.display(encoded) == "json://host/${TARGET}/${TARGET}" def test_template_used_names(): """Only declared names count.""" placeholders = TemplatePlaceholderMap(schema_of("a", "b"), "") encoded = placeholders.encode("${A} ${UNDECLARED}") assert placeholders.used(encoded) == {"a"} def test_template_preserves_setting_names(): """A variable fills in a value; it never names a setting.""" placeholders = TemplatePlaceholderMap(schema_of("target"), "") encoded = placeholders.encode_obj({"${TARGET}": "${TARGET}"}) key, value = next(iter(encoded.items())) assert key == "${TARGET}" assert value != "${TARGET}" def test_template_fills_mapping_name(): """A placeholder sitting in a name is filled in like any other text.""" placeholders = TemplatePlaceholderMap(schema_of("target"), "") # A parsed URL keeps its query names under "qsd", not at the top entry = {"qsd": {placeholders.encode("${TARGET}"): 1}} assert placeholders.used(entry) == {"target"} assert placeholders.substitute(entry, {"target": "real"}) == { "qsd": {"real": 1} } def test_template_rejects_loop(): """A branch pointing back at itself is not followed.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") loop = {} loop["self"] = loop with pytest.raises(AppriseTemplateError): placeholders.encode_obj(loop) def test_template_avoids_placeholder_collision(): """A placeholder cannot collide with the configuration.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") assert f"a{placeholders.nonce}" not in "some configuration body" def test_template_call_value_precedence(): """The caller beats the environment and the default.""" schema = schema_of({"target": "from-config"}) env = {"APPRISE_TEMPLATE_TARGET": "from-env"} values = resolve_values(schema, {"target": "from-call"}, env) assert values == {"target": "from-call"} def test_template_config_default_beats_the_environment(): """A default in the configuration wins over the server's own value. The author picked that default for this configuration in particular, so it is used ahead of anything the deployment set. """ schema = schema_of({"target": "from-config"}) env = {"APPRISE_TEMPLATE_TARGET": "from-env"} assert resolve_values(schema, None, env) == {"target": "from-config"} def test_template_environment_fills_a_name_with_no_default(): """The environment is what a required name falls back to.""" schema = schema_of("target") env = {"APPRISE_TEMPLATE_TARGET": "from-env"} assert resolve_values(schema, None, env) == {"target": "from-env"} def test_template_blank_value_reads_as_nothing_supplied(): """Whitespace is not a value, so the next source is used.""" schema = schema_of({"target": "from-config"}) for blank in ("", " ", "\t"): assert resolve_values(schema, {"target": blank}) == { "target": "from-config" } def test_template_value_is_trimmed(): """Surrounding whitespace never reaches the URL.""" schema = schema_of("target") assert resolve_values(schema, {"target": " spaced "}) == { "target": "spaced" } def test_template_blank_environment_value_is_ignored(): """A blank environment value leaves the name unresolved.""" schema = schema_of("target") with pytest.raises(AppriseTemplateError): resolve_values(schema, None, {"APPRISE_TEMPLATE_TARGET": " "}) def test_template_default_fallback(): """Nothing supplied anywhere falls back to the config.""" schema = schema_of({"target": "from-config"}) assert resolve_values(schema, None, {}) == {"target": "from-config"} def test_template_required_value(): """A mandatory variable with no value is an error.""" with pytest.raises(AppriseTemplateError) as exc: resolve_values(schema_of("target"), None, {}) assert exc.value.variable == "target" def test_template_supplied_name_case_insensitive(): """Callers may use any casing they like.""" schema = schema_of("target") assert resolve_values(schema, {"TaRgEt": "x"}, {}) == {"target": "x"} def test_template_converts_number_to_text(): """Convert a numeric input to text.""" schema = schema_of("target") assert resolve_values(schema, {"target": 42}, {}) == {"target": "42"} def test_template_ignores_unrelated_name(): """Each configuration ignores names that it does not use.""" schema = schema_of({"target": "a-default"}) values = resolve_values(schema, {"target": "x", "elsewhere": "y"}, {}) assert values == {"target": "x"} def test_template_checks_the_name_even_when_unused(): """Garbage is still refused, whichever configuration it was for.""" with pytest.raises(AppriseTemplateError): resolve_values(schema_of({"target": "a"}), {"not a name": "x"}, {}) def test_template_resolves_requested_names_only(): """An entry does not pay for variables it never uses.""" schema = schema_of("needed", {"other": "default"}) values = resolve_values(schema, {"needed": "x"}, {}, names={"needed"}) assert values == {"needed": "x"} @pytest.mark.parametrize( "value", ["line\nbreak", "carriage\rreturn", "null\x00byte", "bell\x07"], ) def test_template_rejects_control_character(value): """These could break out of a log line or a header.""" with pytest.raises(AppriseTemplateError): validate_value("target", value) def test_template_value_length_limit(): """Cap values so a caller cannot flood the parser.""" with pytest.raises(AppriseTemplateError): validate_value("target", "x" * (MAX_TEMPLATE_VALUE_LEN + 1)) @pytest.mark.parametrize("value", [["a"], {"a": 1}, object()]) def test_template_rejects_complex_value(value): """Only simple values may be supplied.""" with pytest.raises(AppriseTemplateError): validate_value("target", value) @pytest.mark.parametrize( ("value", "expected"), [(42, "42"), (1.5, "1.5"), (True, "yes"), (False, "no")], ) def test_template_converts_scalar_value(value, expected): """Numbers and yes/no values are converted rather than refused.""" assert validate_value("target", value) == expected @pytest.mark.parametrize( "payload", [ # Short ids keep the node name readable. Without them the payload # itself becomes the test id, and a single reported failure prints # hundreds of kilobytes, which truncates the CI log it belongs to. pytest.param("${" * 50000, id="open-markers"), pytest.param("$" * 200000, id="bare-dollars"), pytest.param("${A" * 20000, id="partial-names"), pytest.param("${" * 10000 + "}" * 10000, id="unbalanced"), pytest.param("${A}" * 100000, id="many-real-markers"), pytest.param("${" + "A" * 100000 + "}", id="over-long-name"), pytest.param("${" * 1000 + "A" + "}" * 1000, id="wrapped-braces"), pytest.param("json://h/?" + "x=${A}&" * 50000, id="long-url-tail"), pytest.param( ("a" + "0" * 16 + "t" + "9" * 5000 + "z") * 20, id="placeholder-lookalikes", ), ], ) def test_template_regex_performance(payload): """Bound every scan so input cannot make one hang. Each pattern uses bounded quantifiers with nothing that can backtrack, so an unhelpful configuration costs time in proportion to its size and no more. """ placeholders = TemplatePlaceholderMap(schema_of("a"), "") for scan in ( placeholders.encode, placeholders.encode_url, placeholders.pattern.findall, ): start = time.monotonic() scan(payload) assert time.monotonic() - start < 2 def test_template_rejects_invalid_declaration(): """A list entry has to be a name or a name with a default.""" with pytest.raises(AppriseTemplateError): TemplateSchema.parse([["not", "valid"]]) def test_template_variable_repr(): """Useful when looking at one in a debugger.""" variable = schema_of("target").variables["target"] assert "target" in repr(variable) assert variable.required is True def test_template_placeholder_collision_retry(): """A prefix that clashes with the configuration is re-rolled.""" taken = "0" * 16 free = "1" * 16 with mock.patch( "apprise.utils.template.secrets.token_hex", side_effect=[taken, free], ): placeholders = TemplatePlaceholderMap( schema_of("a"), f"a{taken} appears here" ) assert placeholders.nonce == free def test_template_placeholder_retry_limit(): """We never fall back to a prefix we know is unsafe.""" taken = "0" * 16 with ( mock.patch( "apprise.utils.template.secrets.token_hex", return_value=taken ), pytest.raises(AppriseTemplateError), ): TemplatePlaceholderMap(schema_of("a"), f"a{taken}") def test_template_shared_branch(): """A YAML anchor used twice gives the same result both times.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") shared = {"to": "${A}"} encoded = placeholders.encode_obj({"first": shared, "second": shared}) assert encoded["first"] == encoded["second"] assert encoded["first"] is encoded["second"] def test_template_nested_setting_name(): """A placeholder in a name is found however deeply it sits.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") nested = [{placeholders.encode("${A}"): 1}] assert placeholders.used(nested) == {"a"} assert placeholders.used([{"fine": 1}]) == set() @pytest.mark.parametrize("value", [42, None, True]) def test_template_preserves_non_text_config(value): """Numbers and flags are left exactly as they are.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") assert placeholders.encode(value) == value assert placeholders.display(value) == value assert placeholders.substitute(value, {}) == value def test_template_rejects_non_text_name(): """Names have to be text before they can be looked up.""" with pytest.raises(AppriseTemplateError): resolve_values(schema_of("a"), {42: "value"}, {}) def test_template_shared_setting_branch(): """The same mapping seen twice is not walked twice.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") shared = {"fine": 1} assert placeholders.used([shared, shared]) == set() def test_template_setting_loop(): """A loop is refused rather than followed forever.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") loop = {"fine": 1} loop["self"] = [loop] with pytest.raises(AppriseTemplateError): placeholders.used(loop) def test_template_missing_host(): """Not every URL has a host to check.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") parsed = {"host": None, "password": placeholders.encode("${A}")} result = placeholders.substitute(parsed, {"a": "value"}) assert result["password"] == "value" def test_template_preserves_address_separators(): """URL fields keep the punctuation deliberately supplied to them.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") parsed = {"fullpath": placeholders.encode("/${A}/x")} result = placeholders.substitute(parsed, {"a": "seg/ment?x=1&y=2#z"}) assert result["fullpath"] == "/seg/ment?x=1&y=2#z/x" def test_template_defers_service_validation(): """Whatever else a value holds is passed straight through.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") parsed = {"host": placeholders.encode("${A}")} for value in ("evil.com", "not a host at all", "??", "a@b"): # None of these raise; the service is left to make sense of it assert placeholders.substitute(parsed, {"a": value})["host"] def test_template_keeps_credentials_unchanged(): """Parsed credential fields safely accept ordinary delimiters.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") parsed = {"password": placeholders.encode("${A}")} result = placeholders.substitute(parsed, {"a": "user:pass@host/a&b"}) assert result["password"] == "user:pass@host/a&b" def test_template_preserves_an_embedded_host_value(): """A partial hostname keeps all author-supplied punctuation.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") parsed = {"host": placeholders.encode("trusted-${A}")} result = placeholders.substitute( parsed, {"a": "name@evil.test:80/path?x=1#part"} ) assert result["host"] == "trusted-name@evil.test:80/path?x=1#part" def test_template_keeps_host_beside_fixed_credentials(): """A host value does not replace separately parsed credentials.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") parsed = { "user": "fixed", "password": None, "host": placeholders.encode("${A}"), } result = placeholders.substitute(parsed, {"a": "name@evil.test:80"}) assert result["user"] == "fixed" assert result["host"] == "name@evil.test:80" def test_template_allows_a_complete_email_host(): """A whole authority field may intentionally carry an email value.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") parsed = { "user": None, "password": None, "host": placeholders.encode("${A}"), } result = placeholders.substitute(parsed, {"a": "user@example.com"}) assert result["user"] == "user" assert result["host"] == "example.com" def test_template_allows_full_authority_credentials(): """A whole authority may carry user:pass@host.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") parsed = { "user": None, "password": None, "host": placeholders.encode("${A}"), } result = placeholders.substitute(parsed, {"a": "user:pass@example.com"}) assert result["user"] == "user" assert result["password"] == "pass" assert result["host"] == "example.com" @pytest.mark.parametrize("authority", ("@example.com", "user@")) def test_template_contains_a_malformed_authority(authority): """An incomplete authority stays in the field as supplied.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") parsed = { "user": None, "password": None, "host": placeholders.encode("${A}"), } result = placeholders.substitute(parsed, {"a": authority}) assert result["user"] is None assert result["host"] == authority def test_template_allows_combined_credentials(): """A whole user field may carry user:pass credentials.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") parsed = { "user": placeholders.encode("${A}"), "password": None, "host": "example.com", } result = placeholders.substitute(parsed, {"a": "user:pass"}) assert result["user"] == "user" assert result["password"] == "pass" def test_template_leaves_a_setting_value_alone(): """A setting written under the URL already says what it is for.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") parsed = {"bcc": placeholders.encode("${A}")} result = placeholders.substitute(parsed, {"a": "b64/secret@host&x"}) assert result["bcc"] == "b64/secret@host&x" def test_template_ignores_non_text_setting_keys(): """YAML allows a number as a key; there is nothing to look at.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") entry = {1: "x", 2.5: "y"} assert placeholders.used(entry) == set() assert placeholders.substitute(entry, {}) == {1: "x", 2.5: "y"} def test_template_fills_name_beside_text(): """A name mixing a marker with fixed text keeps the fixed part.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") entry = {"qsd": {"x-" + placeholders.encode("${A}"): 1}} assert placeholders.substitute(entry, {"a": "real"}) == { "qsd": {"x-real": 1} } def test_template_preserves_yaml_names(): """A marker written as a YAML setting name stays plain text.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") encoded = placeholders.encode_obj({"${A}": "${A}"}) # The name is untouched while the value became a placeholder assert list(encoded) == ["${A}"] assert placeholders.used(encoded) == {"a"} @pytest.mark.parametrize( ("url", "expected_names"), [ # Everything after :// is fair game ("json://${A}/path?x=${A}", {"a"}), # ...and nothing before it is ("${A}://host/", set()), # A URL with no separator at all has nothing to read ("${A}user:pass@host/", set()), ], ) def test_template_encode_url_preserves_schema(url, expected_names): """Only the text past :// is ever replaced.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") assert placeholders.used(placeholders.encode_url(url)) == expected_names def test_template_encode_url_passes_non_text_through(): """There is no URL to read inside a number.""" placeholders = TemplatePlaceholderMap(schema_of("a"), "") assert placeholders.encode_url(42) == 42 caronc-apprise-dfec414/tests/test_url_response_lookup.py000066400000000000000000000043271526720371000240110ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from apprise.url import HTML_LOOKUP, URLBase def test_response_code_lookup_mask(): """A plugin's response mask never changes the shared lookup table.""" # Remember what the shared table says before any mask is used original = HTML_LOOKUP.get(401) # The mask wins for the code it defines mask = {401: "Plugin specific text.", 999: "Custom code."} assert URLBase.http_response_code_lookup(401, mask) == ( "Plugin specific text." ) assert URLBase.http_response_code_lookup(999, mask) == "Custom code." # Codes the mask does not define still use the shared table assert URLBase.http_response_code_lookup(404, mask) == HTML_LOOKUP[404] # Later lookups without the mask are unaffected assert URLBase.http_response_code_lookup(401) == original assert URLBase.http_response_code_lookup(999) == "" caronc-apprise-dfec414/tests/test_utils_format.py000066400000000000000000000562511526720371000224130ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. from timeit import default_timer from apprise import NotifyFormat from apprise.utils.format import ( html_adjust, html_tag_adjust, markdown_adjust, smart_split, ) def test_smart_split_prefers_newlines_over_spaces_and_punctuation(): """ Newlines should win even if there are spaces and punctuation before the limit. """ text = "line1\nline2 line3. line4" # Long enough to include the newline and some of the next line limit = 12 chunks = smart_split(text, limit, body_format=NotifyFormat.TEXT) # First chunk should end immediately after the newline assert chunks[0] == "line1\n" # Nothing lost assert "".join(chunks) == text def test_smart_split_leading_whitespace(): """A boundary in the whitespace that opens a window is skipped.""" # The first window ends between the CR and LF of a line break, so the # second window opens with the LF text = "a" * 9 + "\r\n" + "b" * 15 chunks = smart_split(text, 10, body_format=NotifyFormat.TEXT) assert chunks == ["a" * 9 + "\r", "\n" + "b" * 9, "b" * 6] assert "".join(chunks) == text # A word that fills the window exactly, followed by a space text = "a" * 10 + " " + "b" * 15 chunks = smart_split(text, 10, body_format=NotifyFormat.TEXT) assert chunks == ["a" * 10, " " + "b" * 9, "b" * 6] assert "".join(chunks) == text def test_smart_split_prefers_spaces_over_hard_split(): """ When there are no newlines, split on the last space/tab before falling back to a hard character-limit split. """ text = "word1 word2 word3" # Force a split between word2 and word3 limit = 12 # "word1 word2 " is 12 characters chunks = smart_split(text, limit, body_format=NotifyFormat.TEXT) assert chunks == ["word1 word2 ", "word3"] assert "".join(chunks) == text def test_smart_split_can_split_after_punctuation_plus_whitespace(): """ Exercise the punctuation+whitespace pattern. In practice this collapses to the same split point as the last space, but we verify the behaviour. """ text = "Hello world. Again" # Force the split around ". " # "Hello world. " is 13 characters limit = 13 chunks = smart_split(text, limit, body_format=NotifyFormat.TEXT) # First chunk should end at the space after the period assert chunks[0] == "Hello world. " assert chunks[1] == "Again" assert "".join(chunks) == text def test_smart_split_avoids_splitting_inside_html_entity() -> None: """ In HTML mode we must not end a chunk in the middle of '&...;'. We do NOT assert exact chunk values. Instead we assert: - TEXT mode can split inside the entity. - HTML mode never has a chunk that contains '&' without a matching ';' after it in the same chunk. """ text = "1234 5678" limit = 8 # without adjustment, we would cut inside ' ' # Plain text mode: allowed to split anywhere chunks_text = smart_split(text, limit, body_format=NotifyFormat.TEXT) assert "".join(chunks_text) == text # Sanity: in TEXT mode we *do* split inside the entity assert any( "&" in chunk and ";" not in chunk[chunk.find("&") :] for chunk in chunks_text ) # HTML mode: entity-aware chunks_html = smart_split(text, limit, body_format=NotifyFormat.HTML) assert "".join(chunks_html) == text # If a chunk contains '&', it must also contain the terminating ';' # for that entity within the same chunk. for chunk in chunks_html: idx = chunk.find("&") if idx == -1: continue semi = chunk.find(";", idx + 1) assert semi != -1, f"Chunk ends inside HTML entity: {chunk!r}" def test_smart_split_avoids_splitting_inside_markdown_link() -> None: """ In MARKDOWN mode, do not split inside [text](url). We only require that the full [link](...) lies in a single chunk and that any '[' appearing in a chunk has a matching ')' in that same chunk. """ link = "[link](https://example.com)" text = "AAAA" + link limit = len(link) chunks = smart_split(text, limit, body_format=NotifyFormat.MARKDOWN) assert "".join(chunks) == text # Entire link must be contained in one chunk assert any(link in chunk for chunk in chunks) # If a chunk has '[', it must also contain its closing ')' for chunk in chunks: idx = chunk.find("[") if idx == -1: continue semi = chunk.find(")", idx + 1) assert semi != -1, f"Markdown link was split inside chunk: {chunk!r}" def test_smart_split_avoids_splitting_inside_markdown_image() -> None: """ In MARKDOWN mode, do not split inside the [alt](url) of an image. The implementation currently splits "AAAA![alt](...)" as: - "AAAA!" - "[alt](...)" which is acceptable, as the [alt](url) part is kept intact. """ image = "![alt](https://example.com/image.png)" text = "AAAA" + image limit = len(image) chunks = smart_split(text, limit, body_format=NotifyFormat.MARKDOWN) assert "".join(chunks) == text inner = "[alt](https://example.com/image.png)" # The [alt](...) portion must appear fully within a single chunk assert any(inner in chunk for chunk in chunks) # As with links, any '[' in a chunk must have its matching ')' within # the same chunk so we never split inside the [alt](url) part. for chunk in chunks: idx = chunk.find("[") if idx == -1: continue semi = chunk.find(")", idx + 1) assert semi != -1, f"Markdown image was split inside chunk: {chunk!r}" def test_smart_split_empty_and_none_input() -> None: """ Empty / None input should be returned as a single-element list unchanged. """ assert smart_split("", 10, body_format=NotifyFormat.TEXT) == [""] assert smart_split("", 0, body_format=NotifyFormat.TEXT) == [""] assert smart_split("content", 0, body_format=NotifyFormat.TEXT) == [""] # None short-circuits before len() is called assert smart_split(None, 10, body_format=NotifyFormat.TEXT) == [""] def test_smart_split_html_entity_exact_boundary() -> None: """ Splitting exactly at an HTML entity boundary should not shift the split point (no need to "fix up" a perfectly aligned boundary). """ text = "AAAA BBBB" limit = len("AAAA ") # split exactly after the entity chunks = smart_split(text, limit, body_format=NotifyFormat.HTML) # We expect the entity to remain whole in the first chunk assert chunks == ["AAAA ", "BBBB"] assert "".join(chunks) == text def test_smart_split_markdown_link_exact_boundary() -> None: """ Splitting exactly after a Markdown link should not cause any adjustment. """ link = "[link](https://example.com)" tail = " TAIL" text = link + tail limit = len(link) # split immediately after ')' chunks = smart_split(text, limit, body_format=NotifyFormat.MARKDOWN) # First chunk is exactly the link, second is the remainder assert chunks[0] == link assert "".join(chunks) == text # Sanity: the link itself is not split across chunks assert any(link in chunk for chunk in chunks) def test_smart_split_whitespace_priority_with_tabs_and_newlines() -> None: """ Exercise newline vs space/tab priority with a mix of whitespace. """ text = "word1\tword2\nword3" # Case 1: window ends just before the newline, so only tab is visible. limit_without_newline = text.index("\n") # position of '\n' chunks_no_nl = smart_split( text, limit_without_newline, body_format=NotifyFormat.TEXT ) # First chunk should end after the tab, since that is the last space/tab assert chunks_no_nl[0] == "word1\t" assert "".join(chunks_no_nl) == text # Case 2: window includes the newline; newline should win over tab. limit_with_newline = text.index("\n") + 1 chunks_with_nl = smart_split( text, limit_with_newline, body_format=NotifyFormat.TEXT ) # First chunk should now end after the newline assert chunks_with_nl[0] == "word1\tword2\n" assert "".join(chunks_with_nl) == text def test_smart_split_very_short_limit() -> None: """ Very small limits should still split deterministically without loss. """ text = "ABC" chunks = smart_split(text, 1, body_format=NotifyFormat.TEXT) # One character per chunk assert chunks == ["A", "B", "C"] assert "".join(chunks) == text def test_smart_split_very_long_limit() -> None: """ Very large limits (>= len(text)) should return a single chunk. """ text = "A short message for testing" chunks = smart_split(text, 10_000, body_format=NotifyFormat.TEXT) assert chunks == [text] assert "".join(chunks) == text def test_html_adjust_guard_paths_and_no_entity() -> None: """ Cover the early-return guard in html_adjust and the path where there is no '&' at all in the search window. """ text = "abcdef" # split_at <= window_start -> early-return unchanged assert html_adjust(text, window_start=2, split_at=2) == 2 # split_at beyond the end of the text -> early-return unchanged assert ( html_adjust(text, window_start=0, split_at=len(text) + 5) == len(text) + 5 ) # No '&' in window, nothing to adjust assert html_adjust(text, window_start=0, split_at=3) == 3 def test_html_adjust_inside_and_at_boundary_of_entity() -> None: """ Exercise the path where html_adjust moves the split back to '&' when the split falls inside an entity, and the path where the split is exactly at the entity boundary and should not move. """ text = "1234 5678" # indexes: 0..3 '1234', 4 '&', 5 'n', 6 'b', 7 's', 8 'p', 9 ';', 10 '5'... # Split inside ' ' (at index 8) -> move back to '&' (index 4) assert html_adjust(text, window_start=0, split_at=8) == 4 # Split exactly after the ';' (index 10) -> already outside entity assert html_adjust(text, window_start=0, split_at=10) == 10 def test_markdown_adjust_guard_and_no_construct() -> None: """ Cover the guard in markdown_adjust and the case where there is no '[' or '!' in the window. """ text = "plain text" # split_at <= window_start -> early-return unchanged assert markdown_adjust(text, window_start=4, split_at=4) == 4 # split_at past the end -> early-return unchanged assert ( markdown_adjust(text, window_start=0, split_at=len(text) + 3) == len(text) + 3 ) # No markdown constructs -> nothing to adjust assert markdown_adjust(text, window_start=0, split_at=5) == 5 def test_markdown_adjust_inside_construct_moves_to_start() -> None: """ Exercise the positive path in markdown_adjust where the split lands inside a [text](url) construct and the function moves the split back to the start of the construct. The forward scan is capped at split_at + (split_at - window_start) + 1 to prevent O(n^2) work on adversarial input (see test_markdown_adjust_dos_cap). This means split_at must be at least half the link length so the cap reaches the closing ')'. Realistic splits from smart_split() always satisfy this because the following applies for any link that fits in a single chunk: split_at - window_start >= limit >= link_length // 2 """ link = "[link](https://example.com)" # Choose a split point in the latter half of the link so the symmetric # forward-scan cap (split_at + window_size) reaches the closing ')'. split_at = len(link) // 2 # index 13, inside "ps://example.com" adjusted = markdown_adjust(link, window_start=0, split_at=split_at) # Should move back to the '[' at index 0 assert adjusted == 0 def test_markdown_adjust_inside_angle_bracket_construct() -> None: """Exercise the angle-bracket path in markdown_adjust. When a split point lands ANYWHERE inside a '' construct (as used by Slack mrkdwn and Google Chat), the function must move it back to the opening '<'. This covers three sub-cases: (a) Split in the label portion (after the pipe). (b) Split exactly on the pipe character. (c) Split in the URL portion (before the pipe) -- previously the pipe search stopped at split_at so no pipe was found; the fix extends the search to forward_end so this case is now also protected. """ # A Slack/Google Chat anchor -- '<' at 0, '|' at 21, '>' at 31. text = "" pipe_pos = text.index("|") # == 20 # (a) Split a few characters after the pipe, inside the label portion. split_at = pipe_pos + 3 adjusted = markdown_adjust(text, window_start=0, split_at=split_at) # Should move back to the '<' at index 0. assert adjusted == 0 # Split right at the closing '>' -- still inside the construct. split_at2 = text.index(">") adjusted2 = markdown_adjust(text, window_start=0, split_at=split_at2) # Also moves back to '<'. assert adjusted2 == 0 # (b) Split exactly ON the '|' separator. split_on_pipe = pipe_pos assert markdown_adjust(text, 0, split_on_pipe) == 0 # (c) Split inside the URL portion (before '|'). # The pipe search now extends to forward_end, not just to split_at. # forward_end = min(32, 17 + 17 + 1) = 32, which covers '>' at 31. # Both pipe (20) and '>' (31) are within range; the construct is detected # and the split moves to '<' at 0. split_in_url = pipe_pos - 3 # index 17, inside "example.com" assert markdown_adjust(text, 0, split_in_url) == 0 # Same scenario with a preamble before '<' so the move is actually # useful -- '<' is no longer at window_start so smart_split would # keep the adjusted position (not reset it). # "<" at 4, "|" at 24, ">" at 35 in the prefixed string. prefixed = "pre " + text split_in_url2 = 20 # index 20, inside "example.com", before '|' at 24 # forward_end = min(36, 20+20+1) = 36 > 35 ('>'). assert markdown_adjust(prefixed, 0, split_in_url2) == 4 # '<' position # When split_at is so small that forward_end doesn't reach the pipe, # the construct is undetectable and the split falls through unchanged. # forward_end = min(32, 5 + 5 + 1) = 11 < pipe_pos(20), so no pipe found. # Even if we detected the '<' at 0, moving the split there would equal # window_start so smart_split() would reset it anyway -- no net change. split_too_small = 5 assert markdown_adjust(text, 0, split_too_small) == split_too_small # '<' and '|' are both found, but split_at is past the closing '>' # so the condition angle_start_idx < split_at <= angle_end_idx is # False -- the function returns the split point unchanged. split_past_end = len(text) assert markdown_adjust(text, 0, split_past_end) == split_past_end def test_markdown_adjust_dos_cap() -> None: """markdown_adjust forward scan is capped to O(window_size). An adversarial body of repeated unterminated '[' openers must not cause O(n^2) work. We verify the cap by checking that a large body produces the same split position as a small one (the cap does not change the output for well-formed constructs within the window). """ from timeit import default_timer # 1 MB of repeated '[broken ' with no closing ')'. body = "[broken " * 128_000 limit = 80 start = default_timer() chunks = smart_split(body, limit, body_format=NotifyFormat.MARKDOWN) elapsed = default_timer() - start # Must complete well under 1 second (the DoS took ~14 s before the cap). assert elapsed < 1.0 # All chunks must be non-empty and re-join to the original. assert all(chunks) assert "".join(chunks) == body def test_smart_split_markdown_guard_split_at_start_is_reset() -> None: """Cover smart_split guard 'if split_at <= start: split_at = orig_split'. We force markdown_adjust to move the split back to the window start (link_start_idx == start == 0), then verify smart_split resets to the original split so progress is still made and chunks join back to the original text. The link "[link](url)" is 11 chars. With limit=7 the first hard split lands at index 7 (inside the URL). The forward-scan cap is 7 + (7 - 0) + 1 = 15, which is > 10 (position of ")"), so markdown_adjust finds the closer and moves split to link_start_idx=0. Since 0 == start, smart_split resets to orig_split=7 and emits the next chunk from there. """ text = "[link](url)" # 12 chars; ")" at index 11 limit = 7 # hard split at 7 (inside url); cap = 15 > 11 so ")" is found chunks = smart_split(text, limit, body_format=NotifyFormat.MARKDOWN) # We should never get stuck; all chunks must be non-empty. assert len(chunks) >= 2 assert all(chunks) # Re-joining all chunks must restore the original text. assert "".join(chunks) == text def test_markdown_adjust_image_bang_opener_path() -> None: """Cover the '!' opener path in markdown_adjust.""" # Bang found, but no '[' after it, so the fallback path is taken. text = "AAAAAA![b](c)" assert markdown_adjust(text, window_start=0, split_at=7) == 6 # Stray '!' not followed by '[' -- bang found but condition is False; # no link construct detected, split point returned unchanged. text2 = "hello!world" assert markdown_adjust(text2, window_start=0, split_at=6) == 6 def test_smart_split_uses_punctuation_branch_on_rare_whitespace() -> None: """ When punctuation is followed by rare whitespace (vertical tab / form feed) and there are no spaces/tabs/newlines, we should use the punctuation + whitespace split branch. """ vt = "\x0b" # vertical tab text = f"Hello.{vt}World" # Window includes 'Hello.' and the VT limit = len("Hello.") + 1 chunks = smart_split(text, limit, body_format=NotifyFormat.TEXT) assert "".join(chunks) == text # We expect the first chunk to end after the rare whitespace assert chunks[0] == f"Hello.{vt}" assert chunks[1] == "World" def test_smart_split_keeps_markdown_escape() -> None: """A hard split never strands an escaping backslash.""" # The hard split would land between "\" and ">"; it moves back one. text = "x" * 19 + "\\>quoted" chunks = smart_split(text, 20, body_format=NotifyFormat.MARKDOWN) assert chunks == ["x" * 19, "\\>quoted"] # An escaped backslash ("\\") is a complete pair, so it may end a chunk. text = "x" * 18 + "\\\\" + "y" * 5 chunks = smart_split(text, 20, body_format=NotifyFormat.MARKDOWN) assert chunks == ["x" * 18 + "\\\\", "y" * 5] # Three backslashes leave the last one unpaired, so it moves on. text = "x" * 17 + "\\\\\\" + ">yy" chunks = smart_split(text, 20, body_format=NotifyFormat.MARKDOWN) assert chunks == ["x" * 17 + "\\\\", "\\>yy"] # When the pair cannot fit at all, splitting still makes progress. chunks = smart_split("\\>\\>", 1, body_format=NotifyFormat.MARKDOWN) assert "".join(chunks) == "\\>\\>" # Plain text has no escapes, so the hard split is left alone. text = "x" * 19 + "\\>quoted" chunks = smart_split(text, 20, body_format=NotifyFormat.TEXT) assert chunks[0] == "x" * 19 + "\\" def test_smart_split_never_cuts_inside_html_tag() -> None: """A split landing inside an HTML tag moves before its "<".""" text = "x" * 10 + ' link' chunks = smart_split(text, 25, body_format=NotifyFormat.HTML) assert "".join(chunks) == text assert chunks[0] == "x" * 10 + " " assert chunks[1].startswith('') # A closed tag before the split is left alone. assert html_tag_adjust("x yy", 0, 9) == 9 # A tag opening the chunk ends the chunk right after its ">". assert html_tag_adjust('x', 0, 10, 16) == 15 # When that tag does not fit, the split is left where it was. assert html_tag_adjust('x', 0, 10, 12) == 10 assert html_tag_adjust(' None: """A ">" inside a quoted attribute value does not end the tag.""" for tag in ('', ""): text = "hello " + tag + "link world" start = text.index(tag) end = start + len(tag) for limit in range(len(tag), len(text) + 1): chunks = smart_split(text, limit, body_format=NotifyFormat.HTML) assert "".join(chunks) == text # No piece may end inside the tag pos = 0 for chunk in chunks: pos += len(chunk) assert not start < pos < end # A split inside the tag moves before it, even past a quoted ">" assert html_tag_adjust('ab x', 0, 16) == 3 # A tag opening the chunk ends after its real ">" assert html_tag_adjust('x', 0, 12) == 17 # An unclosed quote or tag never ends assert html_tag_adjust(' None: """Unbalanced attribute quotes keep HTML splitting linear.""" for body in (' # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. import logging import os from unittest import mock import pytest from apprise import AppriseAsset, PersistentStoreMode, utils from apprise.utils.pem import PEM_SUPPORT # Disable logging for a cleaner testing output logging.disable(logging.CRITICAL) # Attachment Directory TEST_VAR_DIR = os.path.join(os.path.dirname(__file__), "var") @pytest.mark.skipif(not PEM_SUPPORT, reason="Requires cryptography") def test_utils_pem_general(tmpdir): """Utils:PEM.""" # string to manipulate/work with unencrypted_str = "message" tmpdir0 = tmpdir.mkdir("tmp00") # Currently no files here assert os.listdir(str(tmpdir0)) == [] asset = AppriseAsset( storage_mode=PersistentStoreMode.MEMORY, storage_path=str(tmpdir0), pem_autogen=False, ) # Create a PEM Controller pem_c = utils.pem.ApprisePEMController(path=None, asset=asset) # Nothing to lookup assert pem_c.public_keyfile() is None assert pem_c.public_key() is None assert pem_c.x962_str == "" assert pem_c.decrypt(b"data") is None assert pem_c.encrypt(unencrypted_str) is None # Keys can not be generated in memory mode assert pem_c.keygen() is False assert pem_c.sign(b"data") is None asset = AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir0), pem_autogen=False, ) # No new files assert os.listdir(str(tmpdir0)) == [] # Our asset is now write mode, so we will be able to generate a key pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) # Nothing to lookup assert pem_c.public_keyfile() is None assert pem_c.public_key() is None assert pem_c.x962_str == "" assert pem_c.encrypt(unencrypted_str) is None # Generate our keys assert bool(pem_c) is False assert pem_c.keygen() is True assert bool(pem_c) is True # We have 2 new key files generated pub_keyfile = os.path.join(str(tmpdir0), "public_key.pem") prv_keyfile = os.path.join(str(tmpdir0), "private_key.pem") assert os.path.isfile(pub_keyfile) assert os.path.isfile(prv_keyfile) assert pem_c.public_keyfile() is not None assert pem_c.decrypt("garbage") is None assert pem_c.public_key() is not None # Keys used later on as ref pubkey_ref = pem_c.public_key() prvkey_ref = pem_c.private_key() assert isinstance(pem_c.x962_str, str) assert len(pem_c.x962_str) > 20 content = pem_c.encrypt(unencrypted_str) assert pem_c.decrypt( pem_c.encrypt(unencrypted_str.encode("utf-8")) ) == pem_c.decrypt(pem_c.encrypt(unencrypted_str)) assert pem_c.decrypt( pem_c.encrypt(unencrypted_str, public_key=pem_c.public_key()) ) == pem_c.decrypt(pem_c.encrypt(unencrypted_str)) assert pem_c.decrypt(content) == unencrypted_str assert isinstance(content, str) assert pem_c.decrypt(content) == unencrypted_str # support str as well assert pem_c.decrypt(content) == unencrypted_str assert pem_c.decrypt(content.encode("utf-8")) == unencrypted_str # Sign test assert isinstance(pem_c.sign(content.encode("utf-8")), bytes) # Web Push handling webpush_content = pem_c.encrypt_webpush( unencrypted_str, public_key=pem_c.public_key(), auth_secret=b"secret" ) assert isinstance(webpush_content, bytes) webpush_content = pem_c.encrypt_webpush( unencrypted_str.encode("utf-8"), public_key=pem_c.public_key(), auth_secret=b"secret", ) assert isinstance(webpush_content, bytes) # Non Bytes (garbage basically) with pytest.raises(TypeError): assert pem_c.decrypt(None) is None with pytest.raises(TypeError): assert pem_c.decrypt(5) is None with pytest.raises(TypeError): assert pem_c.decrypt(False) is None with pytest.raises(TypeError): assert pem_c.decrypt(object) is None # Test our initialization pem_c = utils.pem.ApprisePEMController( path=None, prv_keyfile="invalid", asset=asset ) assert pem_c.private_keyfile() is False assert pem_c.public_keyfile() is None assert pem_c.prv_keyfile is False assert pem_c.pub_keyfile is None assert pem_c.private_key() is None assert pem_c.public_key() is None assert pem_c.decrypt(content) is None pem_c = utils.pem.ApprisePEMController( path=None, pub_keyfile="invalid", asset=asset ) assert pem_c.private_keyfile() is None assert pem_c.public_keyfile() is False assert pem_c.prv_keyfile is None assert pem_c.pub_keyfile is False assert pem_c.private_key() is None assert pem_c.public_key() is None assert pem_c.decrypt(content) is None pem_c = utils.pem.ApprisePEMController( path=None, prv_keyfile=prv_keyfile, asset=asset ) assert pem_c.private_keyfile() == prv_keyfile assert pem_c.public_keyfile() is None assert pem_c.private_key() is not None assert pem_c.prv_keyfile == prv_keyfile assert pem_c.pub_keyfile is None assert pem_c.public_key() is not None assert pem_c.decrypt(content) == unencrypted_str pem_c = utils.pem.ApprisePEMController( path=None, pub_keyfile=pub_keyfile, asset=asset ) assert pem_c.private_keyfile() is None assert pem_c.public_keyfile() == pub_keyfile assert pem_c.prv_keyfile is None assert pem_c.pub_keyfile == pub_keyfile assert pem_c.private_key() is None assert pem_c.public_key() is not None assert pem_c.decrypt(content) is None # Test our path references pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) assert pem_c.load_private_key(path=None) is True assert pem_c.private_keyfile() == prv_keyfile assert pem_c.prv_keyfile is None assert pem_c.pub_keyfile is None assert pem_c.decrypt(content) == unencrypted_str # Generate a new key referencing another location pem_c = utils.pem.ApprisePEMController( name="keygen-tests", path=str(tmpdir0), asset=asset ) # generate ourselves some keys assert pem_c.keygen() is True keygen_prv_file = pem_c.prv_keyfile keygen_pub_file = pem_c.pub_keyfile # Remove 1 (but not both) os.unlink(keygen_pub_file) pem_c = utils.pem.ApprisePEMController( name="keygen-tests", path=str(tmpdir0), asset=asset ) # Private key was found, so this does not work assert pem_c.keygen() is False os.unlink(keygen_prv_file) pem_c = utils.pem.ApprisePEMController( name="keygen-tests", path=str(tmpdir0), asset=asset ) # It works now assert pem_c.keygen() is True # Tests public_key generation failure only with mock.patch("builtins.open", side_effect=OSError()): assert pem_c.keygen(force=True) is False with mock.patch("os.unlink", side_effect=OSError()): assert pem_c.keygen(force=True) is False with mock.patch("os.unlink", return_value=True): assert pem_c.keygen(force=True) is False # Tests private key generation side_effect = [mock.mock_open(read_data="file contents").return_value] + [ OSError() for _ in range(10) ] with mock.patch("builtins.open", side_effect=side_effect): assert pem_c.keygen(force=True) is False with ( mock.patch("builtins.open", side_effect=side_effect), mock.patch("os.unlink", side_effect=OSError()), ): assert pem_c.keygen(force=True) is False with ( mock.patch("builtins.open", side_effect=side_effect), mock.patch("os.unlink", return_value=True), ): assert pem_c.keygen(force=True) is False # Generate a new key referencing another location pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) # We can't re-generate keys if ones already exist assert pem_c.keygen() is False # the keygen is the big difference here assert pem_c.keygen(name="test") is True # under the hood, a key is not regenerated (as one already exists) assert pem_c.keygen(name="test") is False # Generate it a second time by force assert pem_c.keygen(name="test", force=True) is True assert pem_c.private_keyfile() == os.path.join( str(tmpdir0), "test-private_key.pem" ) assert pem_c.public_keyfile() == os.path.join( str(tmpdir0), "test-public_key.pem" ) assert pem_c.private_key() is not None assert pem_c.public_key() is not None assert pem_c.prv_keyfile == os.path.join( str(tmpdir0), "test-private_key.pem" ) assert pem_c.pub_keyfile == os.path.join( str(tmpdir0), "test-public_key.pem" ) # 'content' was generated using a different key and can not be # decrypted assert pem_c.decrypt(content) is None # Test Decryption files pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) # Calling decrypt triggers underlining code to auto-load assert pem_c.decrypt(content) == unencrypted_str # Using a private key by path assert ( pem_c.decrypt(content, private_key=pem_c.private_key()) == unencrypted_str ) # Test different edge cases of load_private_key() pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) assert pem_c.load_private_key() is True pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) assert pem_c.load_private_key(path=prv_keyfile) is True pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) with mock.patch("builtins.open", side_effect=TypeError()): assert pem_c.load_private_key(path=prv_keyfile) is False with mock.patch("builtins.open", side_effect=OSError()): assert pem_c.load_private_key(path=prv_keyfile) is False with mock.patch("builtins.open", side_effect=FileNotFoundError()): assert pem_c.load_private_key(path=prv_keyfile) is False # Test different edge cases of load_public_key() pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) assert pem_c.load_public_key() is True pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) assert pem_c.load_public_key(path=pub_keyfile) is True pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) with mock.patch("builtins.open", side_effect=TypeError()): assert pem_c.load_public_key(path=pub_keyfile) is False with mock.patch("builtins.open", side_effect=OSError()): assert pem_c.load_public_key(path=pub_keyfile) is False with mock.patch("builtins.open", side_effect=FileNotFoundError()): assert pem_c.load_public_key(path=pub_keyfile) is False pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) assert pem_c.public_keyfile("test1", "test2") == pub_keyfile assert pem_c.private_keyfile("test1", "test2") == prv_keyfile pem_c = utils.pem.ApprisePEMController( path=str(tmpdir0), name="pub1", asset=asset ) assert pem_c.public_key(autogen=True) pem_c = utils.pem.ApprisePEMController( path=str(tmpdir0), name="pub2", asset=asset ) assert pem_c.private_key(autogen=True) # # Auto key generation turned on # asset = AppriseAsset( storage_mode=PersistentStoreMode.MEMORY, storage_path=str(tmpdir0), pem_autogen=True, ) pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) assert pem_c.load_public_key(path=pub_keyfile) is True pem_c = utils.pem.ApprisePEMController(path=None, asset=asset) assert pem_c.load_public_key(path=pub_keyfile) is True tmpdir1 = tmpdir.mkdir("tmp01") # Currently no files here assert os.listdir(str(tmpdir1)) == [] asset = AppriseAsset( storage_mode=PersistentStoreMode.MEMORY, storage_path=str(tmpdir1), pem_autogen=False, ) # Auto-Gen is turned off, so weare not successful here pem_c = utils.pem.ApprisePEMController(path=None, asset=asset) assert pem_c.public_key() is None assert pem_c.private_key() is None pem_c = utils.pem.ApprisePEMController(path=str(tmpdir1), asset=asset) assert pem_c.public_key() is None assert pem_c.private_key() is None asset = AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir1), pem_autogen=True, ) pem_c = utils.pem.ApprisePEMController(path=str(tmpdir1), asset=asset) # Generate ourselves a private key assert pem_c.public_key() is not None assert pem_c.private_key() is not None pub_keyfile = os.path.join(str(tmpdir1), "public_key.pem") prv_keyfile = os.path.join(str(tmpdir1), "private_key.pem") assert os.path.isfile(pub_keyfile) assert os.path.isfile(prv_keyfile) with open(pub_keyfile, "w") as f: f.write("garbage") pem_c = utils.pem.ApprisePEMController(path=str(tmpdir1), asset=asset) # we can still load our data as the public key is generated # from the private assert pem_c.public_key() is not None assert pem_c.private_key() is not None tmpdir2 = tmpdir.mkdir("tmp02") pem_c = utils.pem.ApprisePEMController(path=str(tmpdir2), asset=asset) pub_keyfile = os.path.join(str(tmpdir2), "public_key.pem") prv_keyfile = os.path.join(str(tmpdir2), "private_key.pem") assert not os.path.isfile(pub_keyfile) assert not os.path.isfile(prv_keyfile) # # Public Key Edge Case Tests # with ( mock.patch.object( pem_c, "public_keyfile", side_effect=[None, pub_keyfile] ) as mock_keyfile, mock.patch.object( pem_c, "keygen", side_effect=lambda *_, **__: ( setattr(pem_c, "_ApprisePEMController__public_key", pubkey_ref) or True ), ) as mock_keygen, mock.patch.object(pem_c, "load_public_key", return_value=True), ): result = pem_c.public_key() assert result is pubkey_ref assert mock_keyfile.call_count == 2 mock_keygen.assert_called_once() # - First call: None -> triggers keygen # - Second call (recursive): None -> causes fallback public_keyfile_side_effect = [None, None] with ( mock.patch.object( pem_c, "public_keyfile", side_effect=public_keyfile_side_effect ) as mock_keyfile, mock.patch.object(pem_c, "keygen", return_value=True) as mock_keygen, mock.patch.object( pem_c, "load_public_key", return_value=False ) as mock_load, ): # Ensure no key is preset initially pem_c._ApprisePEMController__public_key = None result = pem_c.public_key() assert result is None # Once in outer call, once in recursive assert mock_keyfile.call_count == 2 mock_keygen.assert_called_once() mock_load.assert_not_called() # # Private Key Edge Case Tests # with ( mock.patch.object( pem_c, "private_keyfile", side_effect=[None, prv_keyfile] ) as mock_keyfile, mock.patch.object( pem_c, "keygen", side_effect=lambda *_, **__: ( setattr( pem_c, "_ApprisePEMController__private_key", prvkey_ref ) or True ), ) as mock_keygen, mock.patch.object(pem_c, "load_private_key", return_value=True), ): result = pem_c.private_key() assert result is prvkey_ref assert mock_keyfile.call_count == 2 mock_keygen.assert_called_once() # - First call: None -> triggers keygen # - Second call (recursive): None -> causes fallback private_keyfile_side_effect = [None, None] with ( mock.patch.object( pem_c, "private_keyfile", side_effect=private_keyfile_side_effect ) as mock_keyfile, mock.patch.object(pem_c, "keygen", return_value=True) as mock_keygen, mock.patch.object( pem_c, "load_private_key", return_value=False ) as mock_load, ): # Ensure no key is preset initially pem_c._ApprisePEMController__private_key = None result = pem_c.private_key() assert result is None # Once in outer call, once in recursive assert mock_keyfile.call_count == 2 mock_keygen.assert_called_once() mock_load.assert_not_called() @pytest.mark.skipif( PEM_SUPPORT, reason="Requires that cryptography NOT be installed", ) def test_utils_pem_without_cryptography(tmpdir): """Verify PEM operations fail cleanly without cryptography.""" tmpdir0 = tmpdir.mkdir("tmp00") # Currently no files here assert os.listdir(str(tmpdir0)) == [] asset = AppriseAsset( storage_mode=PersistentStoreMode.MEMORY, storage_path=str(tmpdir0), pem_autogen=False, ) # Create a PEM Controller pem_c = utils.pem.ApprisePEMController(path=None, asset=asset) # PEM operations require the cryptography library with pytest.raises(utils.pem.ApprisePEMException): pem_c.public_keyfile() with pytest.raises(utils.pem.ApprisePEMException): pem_c.public_key() with pytest.raises(utils.pem.ApprisePEMException): _ = pem_c.x962_str with pytest.raises(utils.pem.ApprisePEMException): pem_c.encrypt("message") with pytest.raises(utils.pem.ApprisePEMException): pem_c.keygen() asset = AppriseAsset( storage_mode=PersistentStoreMode.FLUSH, storage_path=str(tmpdir0), pem_autogen=False, ) # No new files assert os.listdir(str(tmpdir0)) == [] # Our asset is now write mode, so we will be able to generate a key pem_c = utils.pem.ApprisePEMController(path=str(tmpdir0), asset=asset) # Nothing to lookup with pytest.raises(utils.pem.ApprisePEMException): pem_c.private_keyfile() with pytest.raises(utils.pem.ApprisePEMException): pem_c.private_key() with pytest.raises(utils.pem.ApprisePEMException): _ = pem_c.x962_str with pytest.raises(utils.pem.ApprisePEMException): pem_c.encrypt("message") # Keys can not be generated in memory mode with pytest.raises(utils.pem.ApprisePEMException): pem_c.keygen() # No files loaded assert os.listdir(str(tmpdir0)) == [] with pytest.raises(utils.pem.ApprisePEMException): pem_c.public_keyfile() with pytest.raises(utils.pem.ApprisePEMException): pem_c.public_key() with pytest.raises(utils.pem.ApprisePEMException): _ = pem_c.x962_str with pytest.raises(utils.pem.ApprisePEMException): pem_c.encrypt("message") with pytest.raises(utils.pem.ApprisePEMException): pem_c.decrypt("abcd==") caronc-apprise-dfec414/tests/test_utils_pgp.py000066400000000000000000001636221526720371000217120ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Disable logging for a cleaner testing output import base64 import logging import os import shutil import sys from unittest import mock import pytest from apprise import AppriseAsset from apprise.utils import pgp as pgp_module from apprise.utils.pgp import ApprisePGPController, _ensure_imghdr_shim logging.disable(logging.CRITICAL) # Path to the pre-generated key fixtures used by signing/autocrypt tests _VAR_DIR = os.path.join(os.path.dirname(__file__), "var", "pgp") _VALID_PRV_ASC = os.path.join(_VAR_DIR, "valid-prv.asc") _VALID_PUB_ASC = os.path.join(_VAR_DIR, "valid-pub.asc") # imghdr shim def test_imghdr_shim_when_present(): """_ensure_imghdr_shim() leaves sys.modules intact when imghdr imports.""" # Guarantee imghdr is importable for this test real_imghdr = sys.modules.get("imghdr") try: import imghdr as _real # If we got here, imghdr is available on this Python version _ensure_imghdr_shim() # sys.modules entry must not have been replaced by our shim assert sys.modules.get("imghdr") is _real except ImportError: # Python 3.13 and newer removed imghdr. pytest.skip("imghdr not present on this Python version") finally: # Restore whatever was there before if real_imghdr is None: sys.modules.pop("imghdr", None) else: sys.modules["imghdr"] = real_imghdr def test_imghdr_shim_when_absent(): """_ensure_imghdr_shim() installs a working shim when imghdr is missing.""" # Remove any real imghdr from sys.modules and make import fail saved = sys.modules.pop("imghdr", None) try: # Setting the key to None causes 'import imghdr' to raise ImportError sys.modules["imghdr"] = None _ensure_imghdr_shim() shim = sys.modules.get("imghdr") assert shim is not None assert callable(shim.what) # The shim must return None (safe fallback for all inputs) assert shim.what() is None assert shim.what(file=None, h=b"\xff\xd8\xff") is None assert shim.what(None, h=b"some data") is None finally: # Restore original state if saved is None: sys.modules.pop("imghdr", None) else: sys.modules["imghdr"] = saved # ApprisePGPController WKD integration def test_pgp_controller_wkd_none_by_default(tmpdir): """ApprisePGPController has wkd=None unless explicitly provided.""" ctrl = ApprisePGPController(path=str(tmpdir)) assert ctrl.wkd is None def test_pgp_controller_accepts_wkd(tmpdir): """ApprisePGPController stores the WKD controller it is given.""" mock_wkd = mock.Mock() ctrl = ApprisePGPController(path=str(tmpdir), wkd=mock_wkd) assert ctrl.wkd is mock_wkd def test_fetch_wkd_key_no_controller(tmpdir): """_fetch_wkd_key() returns None when no WKD controller is set.""" ctrl = ApprisePGPController(path=str(tmpdir)) result = ctrl._fetch_wkd_key("user@example.com") assert result is None def test_fetch_wkd_key_empty_emails(tmpdir): """_fetch_wkd_key() returns None when no email candidates exist.""" mock_wkd = mock.Mock() ctrl = ApprisePGPController(path=str(tmpdir), wkd=mock_wkd) # No self.email set and no positional emails result = ctrl._fetch_wkd_key() assert result is None mock_wkd.fetch.assert_not_called() def test_fetch_wkd_key_skips_none_in_candidate_list(tmpdir): """_fetch_wkd_key() skips None/empty entries in the email candidates.""" mock_wkd = mock.Mock() mock_wkd.fetch.return_value = None ctrl = ApprisePGPController(path=str(tmpdir), wkd=mock_wkd) # None is a valid positional argument; it must be skipped, not crash result = ctrl._fetch_wkd_key(None, "user@example.com") assert result is None # fetch must only be called for the valid address, not for None mock_wkd.fetch.assert_called_once_with("user@example.com") def test_fetch_wkd_key_wkd_returns_none(tmpdir): """_fetch_wkd_key() returns None when WKD fetch yields nothing.""" mock_wkd = mock.Mock() mock_wkd.fetch.return_value = None ctrl = ApprisePGPController(path=str(tmpdir), wkd=mock_wkd) result = ctrl._fetch_wkd_key("user@example.com") assert result is None @pytest.mark.skipif("pgpy" not in sys.modules, reason="Requires PGPy") def test_fetch_wkd_key_success(tmpdir): """_fetch_wkd_key() parses and caches a key returned by WKD.""" import pgpy # Generate a fresh key pair to use as our fake WKD payload key = pgpy.PGPKey.new( pgpy.constants.PubKeyAlgorithm.RSAEncryptOrSign, 2048 ) uid = pgpy.PGPUID.new("Test", email="user@example.com") key.add_uid( uid, usage={ pgpy.constants.KeyFlags.Sign, pgpy.constants.KeyFlags.EncryptCommunications, }, hashes=[pgpy.constants.HashAlgorithm.SHA256], ciphers=[pgpy.constants.SymmetricKeyAlgorithm.AES256], compression=[pgpy.constants.CompressionAlgorithm.ZLIB], ) pub_bytes = str(key.pubkey).encode() mock_wkd = mock.Mock() mock_wkd.fetch.return_value = pub_bytes ctrl = ApprisePGPController(path=str(tmpdir), wkd=mock_wkd) result = ctrl._fetch_wkd_key("user@example.com") assert result is not None assert isinstance(result, pgpy.PGPKey) mock_wkd.fetch.assert_called_once_with("user@example.com") # The second call must use the parsed-key cache. mock_wkd.fetch.reset_mock() result2 = ctrl._fetch_wkd_key("user@example.com") assert result2 is not None mock_wkd.fetch.assert_not_called() @pytest.mark.skipif("pgpy" not in sys.modules, reason="Requires PGPy") def test_fetch_wkd_key_expired_cache_refetches(tmpdir): """_fetch_wkd_key() drops an expired parsed-key cache entry and re-fetches from WKD rather than returning the stale key.""" from datetime import datetime, timedelta, timezone import hashlib import pgpy # Generate a key to serve as the fresh WKD result key = pgpy.PGPKey.new( pgpy.constants.PubKeyAlgorithm.RSAEncryptOrSign, 2048 ) uid = pgpy.PGPUID.new("Fresh", email="user@example.com") key.add_uid( uid, usage={ pgpy.constants.KeyFlags.Sign, pgpy.constants.KeyFlags.EncryptCommunications, }, hashes=[pgpy.constants.HashAlgorithm.SHA256], ciphers=[pgpy.constants.SymmetricKeyAlgorithm.AES256], compression=[pgpy.constants.CompressionAlgorithm.ZLIB], ) pub_bytes = str(key.pubkey).encode() mock_wkd = mock.Mock() mock_wkd.fetch.return_value = pub_bytes ctrl = ApprisePGPController(path=str(tmpdir), wkd=mock_wkd) # Seed the parsed-key cache with an already-expired entry cache_key = hashlib.sha1(b"wkd:user@example.com").hexdigest() # Use the private name-mangled attribute ctrl._ApprisePGPController__key_lookup[cache_key] = { "public_key": None, "expires": datetime.now(timezone.utc) - timedelta(seconds=1), } # The expired entry is discarded; WKD is fetched and result returned result = ctrl._fetch_wkd_key("user@example.com") assert result is not None mock_wkd.fetch.assert_called_once_with("user@example.com") @pytest.mark.skipif("pgpy" not in sys.modules, reason="Requires PGPy") def test_fetch_wkd_key_prefers_recipient_over_sender(tmpdir): """_fetch_wkd_key() tries recipient emails before self.email so that the recipient's public key (not the sender's) is used for encryption.""" import pgpy # Generate a key to represent the recipient's WKD result key = pgpy.PGPKey.new( pgpy.constants.PubKeyAlgorithm.RSAEncryptOrSign, 2048 ) uid = pgpy.PGPUID.new("Recipient", email="recipient@example.com") key.add_uid( uid, usage={ pgpy.constants.KeyFlags.Sign, pgpy.constants.KeyFlags.EncryptCommunications, }, hashes=[pgpy.constants.HashAlgorithm.SHA256], ciphers=[pgpy.constants.SymmetricKeyAlgorithm.AES256], compression=[pgpy.constants.CompressionAlgorithm.ZLIB], ) pub_bytes = str(key.pubkey).encode() # WKD returns a key only for the recipient address def fake_fetch(email): if email == "recipient@example.com": return pub_bytes return None mock_wkd = mock.Mock(side_effect=fake_fetch) mock_wkd.fetch.side_effect = fake_fetch ctrl = ApprisePGPController( path=str(tmpdir), email="sender@example.com", wkd=mock_wkd, ) # The recipient's email is passed as a positional argument result = ctrl._fetch_wkd_key("recipient@example.com") assert result is not None # sender@example.com must NOT have been tried before the recipient hit calls = [call.args[0] for call in mock_wkd.fetch.call_args_list] assert calls[0] == "recipient@example.com" assert "sender@example.com" not in calls @pytest.mark.skipif( pgp_module.PGP_SUPPORT, reason="Tests behavior when pgpy is absent" ) def test_fetch_wkd_key_pgpy_not_installed(tmpdir): """_fetch_wkd_key() skips silently when pgpy raises NameError.""" mock_wkd = mock.Mock() mock_wkd.fetch.return_value = b"fake-key-bytes" ctrl = ApprisePGPController(path=str(tmpdir), wkd=mock_wkd) # In a minimal env pgpy is not installed, so pgpy.PGPKey.from_blob # raises NameError naturally, so no mock is needed. result = ctrl._fetch_wkd_key("user@example.com") assert result is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_fetch_wkd_key_corrupt_data(tmpdir): """_fetch_wkd_key() skips and tries next candidate on parse failure.""" mock_wkd = mock.Mock() mock_wkd.fetch.return_value = b"this-is-not-a-pgp-key" ctrl = ApprisePGPController(path=str(tmpdir), wkd=mock_wkd) # Patch the canonical pgpy module directly (not the pgp module's copy) # so the mock works whether pgpy was imported by name or attribute. with mock.patch( "pgpy.PGPKey.from_blob", side_effect=Exception("bad key"), ): result = ctrl._fetch_wkd_key("user@example.com") assert result is None def test_fetch_wkd_key_uses_self_email_as_candidate(tmpdir): """_fetch_wkd_key() includes self.email in the candidate list.""" mock_wkd = mock.Mock() mock_wkd.fetch.return_value = None ctrl = ApprisePGPController( path=str(tmpdir), email="sender@example.com", wkd=mock_wkd ) ctrl._fetch_wkd_key() # self.email must have been tried mock_wkd.fetch.assert_called_with("sender@example.com") @pytest.mark.skipif("pgpy" not in sys.modules, reason="Requires PGPy") def test_public_key_falls_through_to_wkd(tmpdir): """public_key() uses WKD when no local key file exists.""" import pgpy # Generate a minimal key for the mock WKD response key = pgpy.PGPKey.new( pgpy.constants.PubKeyAlgorithm.RSAEncryptOrSign, 2048 ) uid = pgpy.PGPUID.new("WKD User", email="wkd@example.com") key.add_uid( uid, usage={ pgpy.constants.KeyFlags.Sign, pgpy.constants.KeyFlags.EncryptCommunications, }, hashes=[pgpy.constants.HashAlgorithm.SHA256], ciphers=[pgpy.constants.SymmetricKeyAlgorithm.AES256], compression=[pgpy.constants.CompressionAlgorithm.ZLIB], ) pub_bytes = str(key.pubkey).encode() mock_wkd = mock.Mock() mock_wkd.fetch.return_value = pub_bytes ctrl = ApprisePGPController(path=str(tmpdir), wkd=mock_wkd) # No local key file exists, so WKD must be tried result = ctrl.public_key("wkd@example.com", autogen=False) assert result is not None mock_wkd.fetch.assert_called() @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_public_key_wkd_fails_falls_through_to_autogen(tmpdir): """public_key() falls through to autogen when WKD also returns None.""" mock_wkd = mock.Mock() mock_wkd.fetch.return_value = None ctrl = ApprisePGPController(path=str(tmpdir), wkd=mock_wkd) # No local key file exists; WKD fails; autogen=False => None returned result = ctrl.public_key("nobody@example.com", autogen=False) assert result is None mock_wkd.fetch.assert_called() @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_public_key_malformed_local_file_returns_none(tmpdir): """public_key() returns None gracefully when the local .asc file is not valid PGP data (pgpy raises during parse).""" # Write a file with non-PGP content under a name that public_keyfile() # will discover automatically bad_key_path = tmpdir.join("pub.asc") bad_key_path.write("this is not a pgp key\n") ctrl = ApprisePGPController(path=str(tmpdir)) # No autogen so the only candidate is the malformed file above result = ctrl.public_key(autogen=False) assert result is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") @pytest.mark.parametrize("use_keyfile", (False, True)) def test_keygen_checks_eligibility_before_rsa(tmpdir, use_keyfile): """Disabled key generation does not perform expensive RSA work.""" ctrl = ApprisePGPController( path=str(tmpdir) if use_keyfile else None, pub_keyfile=_VALID_PUB_ASC if use_keyfile else None, email="test@example.com", ) with mock.patch.object(pgp_module.pgpy.PGPKey, "new") as mock_new: assert ctrl.keygen() is False mock_new.assert_not_called() # autocrypt_header() @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_no_sender_key(tmpdir): """Autocrypt is omitted when no sender key is available.""" asset = AppriseAsset(pgp_autogen=False) ctrl = ApprisePGPController( path=str(tmpdir), email="test@example.com", asset=asset ) assert ctrl.autocrypt_header() is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") @pytest.mark.parametrize("missing_email", (None, "")) def test_autocrypt_header_none_without_email(tmpdir, missing_email): """Autocrypt requires an address even when a sender key exists.""" ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC, email=missing_email, ) # Only the address is missing. assert ctrl.private_key() is not None assert ctrl.autocrypt_header() is None def _fingerprint_of(path): """Loads a key fixture from disk and returns its fingerprint string.""" import pgpy with open(path) as key_file: key, _ = pgpy.PGPKey.from_blob(key_file.read()) return str(key.fingerprint) def _keydata_fingerprint(header): """Decodes an Autocrypt header's keydata= and returns its fingerprint.""" import pgpy keydata = header.split("keydata=", 1)[1] key, _ = pgpy.PGPKey.from_blob(base64.b64decode(keydata)) return str(key.fingerprint) @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_valid_key(tmpdir): """Autocrypt advertises the public half of a generated sender key.""" ctrl = ApprisePGPController(path=str(tmpdir), email="test@example.com") assert ctrl.keygen() is True header = ctrl.autocrypt_header() assert header is not None assert header.startswith( "addr=test@example.com; prefer-encrypt=mutual; keydata=" ) # Compare fingerprints so an unrelated but valid key cannot pass. assert _keydata_fingerprint(header) == str(ctrl.private_key().fingerprint) @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_ignores_recipient_pgppub(tmpdir): """Autocrypt uses our signing key instead of recipient pgppub=.""" # Generate the sender key before configuring a recipient override. keygen_ctrl = ApprisePGPController( path=str(tmpdir), email="test@example.com" ) assert keygen_ctrl.keygen() is True own_fingerprint = str(keygen_ctrl.private_key().fingerprint) # The fixture represents an unrelated recipient's key assert own_fingerprint != _fingerprint_of(_VALID_PUB_ASC) # The sender key remains discoverable beside the recipient override. ctrl = ApprisePGPController( path=str(tmpdir), pub_keyfile=_VALID_PUB_ASC, email="test@example.com", ) header = ctrl.autocrypt_header() assert header is not None assert _keydata_fingerprint(header) == own_fingerprint @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_ignores_recipient_only_key(tmpdir): """Autocrypt omits a recipient pgppub= when no sender key exists.""" asset = AppriseAsset(pgp_autogen=False) ctrl = ApprisePGPController( path=str(tmpdir), pub_keyfile=_VALID_PUB_ASC, email="test@example.com", asset=asset, ) assert ctrl.autocrypt_header() is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") @pytest.mark.parametrize( "filename", ( # Sender-specific names still require a matching private key. "sender@example.com-pub.asc", "sender-pub.asc", "pgp-public.asc", "pgp-pub.asc", "public.asc", "pub.asc", ), ) def test_autocrypt_header_ignores_public_only_local_files(tmpdir, filename): """Autocrypt ignores local public keys without a matching private key.""" shutil.copy(_VALID_PUB_ASC, str(tmpdir.join(filename))) asset = AppriseAsset(pgp_autogen=False) ctrl = ApprisePGPController( path=str(tmpdir), email="sender@example.com", asset=asset ) assert ctrl.autocrypt_header() is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_autogen_generates_own_key(tmpdir): """Autocrypt may generate and advertise a sender-owned key pair.""" asset = AppriseAsset(pgp_autogen=True) ctrl = ApprisePGPController( path=str(tmpdir), email="sender@example.com", asset=asset ) assert ctrl.private_key() is None header = ctrl.autocrypt_header() assert header is not None assert header.startswith("addr=sender@example.com;") # A private key must now exist, and it must be the one advertised private_key = ctrl.private_key() assert private_key is not None assert _keydata_fingerprint(header) == str(private_key.fingerprint) @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_respects_autogen_disabled(tmpdir): """Autocrypt respects disabled key generation.""" asset = AppriseAsset(pgp_autogen=False) ctrl = ApprisePGPController( path=str(tmpdir), email="sender@example.com", asset=asset ) assert ctrl.autocrypt_header() is None assert ctrl.private_key() is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_enforces_size_limit(tmpdir): """Autocrypt rejects headers over its 10 KiB limit.""" ctrl = ApprisePGPController(path=str(tmpdir), email="test@example.com") assert ctrl.keygen() is True # Sanity: the real key comfortably fits within the real limit assert ctrl.autocrypt_header() is not None # Force the limit far below anything a real key could satisfy ctrl.max_autocrypt_header_size = 10 assert ctrl.autocrypt_header() is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_rejects_key_without_encryption_subkey(tmpdir): """Autocrypt rejects a private key without an encryption subkey.""" ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC, email="test@example.com", ) private_key = ctrl.private_key() assert private_key is not None assert not ApprisePGPController._has_encryption_subkey(private_key) assert ctrl.autocrypt_header() is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_accepts_key_with_encryption_subkey(tmpdir): """_has_encryption_subkey() recognizes a properly structured key.""" ctrl = ApprisePGPController(path=str(tmpdir), email="test@example.com") assert ctrl.keygen() is True private_key = ctrl.private_key() assert ApprisePGPController._has_encryption_subkey(private_key) @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_rejects_key_with_extra_userid(tmpdir): """Autocrypt rejects an otherwise valid key with multiple UIDs.""" import pgpy from pgpy.constants import ( CompressionAlgorithm, HashAlgorithm, KeyFlags, PubKeyAlgorithm, SymmetricKeyAlgorithm, ) primary = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) for name, email in ( ("Test", "test@example.com"), ("Test (work)", "test@work.example.com"), ): primary.add_uid( pgpy.PGPUID.new(name, email=email), usage={KeyFlags.Sign, KeyFlags.Certify}, hashes=[HashAlgorithm.SHA256], ciphers=[SymmetricKeyAlgorithm.AES256], compression=[CompressionAlgorithm.ZLIB], ) subkey = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) primary.add_subkey( subkey, usage={KeyFlags.EncryptCommunications, KeyFlags.EncryptStorage}, ) prv_path = str(tmpdir.join("multi-uid-prv.asc")) with open(prv_path, "w") as f: f.write(str(primary)) ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile=prv_path, email="test@example.com" ) private_key = ctrl.private_key() assert private_key is not None assert not ApprisePGPController._has_encryption_subkey(private_key) assert ctrl.autocrypt_header() is None def _mock_uid_with_one_selfsig(): """A mock UID with exactly the one self-signature a compliant key is expected to have, so tests can focus on the subkey side.""" uid = mock.Mock() selfsig = mock.Mock() uid.selfsig = selfsig uid._signatures = [selfsig] return uid def test_has_encryption_subkey_skips_subkey_without_selfsig(): """A lone subkey with no self-signature at all is not usable.""" no_selfsig_subkey = mock.Mock() no_selfsig_subkey.revocation_signatures = [] no_selfsig_subkey.self_signatures = iter(()) key = mock.Mock() key.userattributes = [] key.revocation_signatures = [] key.userids = [_mock_uid_with_one_selfsig()] key.subkeys = {"a": no_selfsig_subkey} assert ApprisePGPController._has_encryption_subkey(key) is False @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_has_encryption_subkey_skips_subkey_with_wrong_flags(): """A signed subkey without encryption usage is not usable.""" wrong_flags_subkey = mock.Mock() wrong_flags_subkey.revocation_signatures = [] wrong_flags_subkey.self_signatures = iter( [mock.Mock(key_flags={pgp_module.pgpy.constants.KeyFlags.Sign})] ) key = mock.Mock() key.userattributes = [] key.revocation_signatures = [] key.userids = [_mock_uid_with_one_selfsig()] key.subkeys = {"a": wrong_flags_subkey} assert ApprisePGPController._has_encryption_subkey(key) is False @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_has_encryption_subkey_rejects_multiple_userids(): """Autocrypt rejects keys with multiple identities.""" good_subkey = mock.Mock() good_subkey.self_signatures = iter( [ mock.Mock( key_flags={ pgp_module.pgpy.constants.KeyFlags.EncryptCommunications } ) ] ) key = mock.Mock() key.userattributes = [] key.revocation_signatures = [] key.userids = ["user@example.com", "user@work.example.com"] key.subkeys = {"a": good_subkey} assert ApprisePGPController._has_encryption_subkey(key) is False @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_has_encryption_subkey_rejects_multiple_subkeys(): """Autocrypt Level 1 requires exactly one subkey.""" def make_subkey(): subkey = mock.Mock() subkey.self_signatures = iter( [ mock.Mock( key_flags={ pgp_module.pgpy.constants.KeyFlags.EncryptCommunications } ) ] ) return subkey key = mock.Mock() key.userattributes = [] key.revocation_signatures = [] key.userids = ["user@example.com"] key.subkeys = {"a": make_subkey(), "b": make_subkey()} assert ApprisePGPController._has_encryption_subkey(key) is False @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_has_encryption_subkey_rejects_extra_uid_selfsig(): """Autocrypt rejects a UID with an extra self-signature.""" uid = mock.Mock() uid._signatures = [mock.Mock(), mock.Mock()] subkey = mock.Mock() subkey.self_signatures = iter( [ mock.Mock( key_flags={ pgp_module.pgpy.constants.KeyFlags.EncryptCommunications } ) ] ) key = mock.Mock() key.userattributes = [] key.revocation_signatures = [] key.userids = [uid] key.subkeys = {"a": subkey} assert ApprisePGPController._has_encryption_subkey(key) is False @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_has_encryption_subkey_rejects_extra_subkey_binding_sig(): """Autocrypt rejects a subkey with an extra binding signature.""" uid = mock.Mock() uid._signatures = [mock.Mock()] subkey = mock.Mock() subkey.revocation_signatures = [] subkey.self_signatures = iter( [ mock.Mock( key_flags={ pgp_module.pgpy.constants.KeyFlags.EncryptCommunications } ), mock.Mock( key_flags={ pgp_module.pgpy.constants.KeyFlags.EncryptCommunications } ), ] ) key = mock.Mock() key.userattributes = [] key.revocation_signatures = [] key.userids = [uid] key.subkeys = {"a": subkey} assert ApprisePGPController._has_encryption_subkey(key) is False @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_has_encryption_subkey_rejects_uid_without_selfsig(): """Reject a UID whose only signature is from a third party.""" uid = mock.Mock() uid.selfsig = None uid._signatures = [mock.Mock()] subkey = mock.Mock() subkey.self_signatures = iter( [ mock.Mock( key_flags={ pgp_module.pgpy.constants.KeyFlags.EncryptCommunications } ) ] ) key = mock.Mock() key.userattributes = [] key.revocation_signatures = [] key.userids = [uid] key.subkeys = {"a": subkey} assert ApprisePGPController._has_encryption_subkey(key) is False def test_has_encryption_subkey_rejects_missing_signature_list(): """Reject the key if PGPy's private signature collection is absent.""" uid = mock.Mock(spec=["selfsig"]) uid.selfsig = mock.Mock() key = mock.Mock() key.userattributes = [] key.revocation_signatures = [] key.userids = [uid] key.subkeys = {"a": mock.Mock()} assert ApprisePGPController._has_encryption_subkey(key) is False @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_rejects_third_party_only_uid(tmpdir): """Reject a serialized key with only a third-party UID signature.""" import pgpy from pgpy.constants import ( CompressionAlgorithm, HashAlgorithm, KeyFlags, PubKeyAlgorithm, SymmetricKeyAlgorithm, ) victim = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) uid = pgpy.PGPUID.new("Victim", email="victim@example.com") victim.add_uid( uid, usage={KeyFlags.Sign, KeyFlags.Certify}, hashes=[HashAlgorithm.SHA256], ciphers=[SymmetricKeyAlgorithm.AES256], compression=[CompressionAlgorithm.ZLIB], ) subkey = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) victim.add_subkey( subkey, usage={KeyFlags.EncryptCommunications, KeyFlags.EncryptStorage}, ) # A third party certifies the UID instead of the primary itself thirdparty = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) tp_uid = pgpy.PGPUID.new("ThirdParty", email="tp@example.com") thirdparty.add_uid( tp_uid, usage={KeyFlags.Sign, KeyFlags.Certify}, hashes=[HashAlgorithm.SHA256], ciphers=[SymmetricKeyAlgorithm.AES256], compression=[CompressionAlgorithm.ZLIB], ) cert_sig = thirdparty.certify(uid) # Replace the genuine self-signature with the third-party one, so # the UID's only signature is not from its own primary key uid._signatures.clear() uid._signatures.append(cert_sig) prv_path = str(tmpdir.join("thirdparty-only-prv.asc")) with open(prv_path, "w") as f: f.write(str(victim)) ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile=prv_path, email="victim@example.com" ) private_key = ctrl.private_key() assert private_key is not None assert private_key.userids[0].selfsig is None assert not ApprisePGPController._has_encryption_subkey(private_key) assert ctrl.autocrypt_header() is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_rejects_key_with_extra_uid_signature(tmpdir): """Autocrypt rejects an extra UID signature after serialization.""" import pgpy from pgpy.constants import ( CompressionAlgorithm, HashAlgorithm, KeyFlags, PubKeyAlgorithm, SymmetricKeyAlgorithm, ) primary = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) uid = pgpy.PGPUID.new("Test", email="test@example.com") primary.add_uid( uid, usage={KeyFlags.Sign, KeyFlags.Certify}, hashes=[HashAlgorithm.SHA256], ciphers=[SymmetricKeyAlgorithm.AES256], compression=[CompressionAlgorithm.ZLIB], ) subkey = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) primary.add_subkey( subkey, usage={KeyFlags.EncryptCommunications, KeyFlags.EncryptStorage}, ) # Add another genuine self-certification to the same UID. extra_sig = primary.certify(uid, expires=None) uid._signatures.insert(0, extra_sig) prv_path = str(tmpdir.join("extra-sig-prv.asc")) with open(prv_path, "w") as f: f.write(str(primary)) ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile=prv_path, email="test@example.com" ) private_key = ctrl.private_key() assert private_key is not None assert len(private_key.userids[0]._signatures) == 2 assert not ApprisePGPController._has_encryption_subkey(private_key) assert ctrl.autocrypt_header() is None def test_has_encryption_subkey_rejects_user_attribute(): """Reject user attributes because they add packets to the key.""" key = mock.Mock() key.userattributes = [mock.Mock()] assert ApprisePGPController._has_encryption_subkey(key) is False @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_rejects_photo_attribute(tmpdir): """Reject a serialized key containing a photo attribute.""" import pgpy from pgpy.constants import ( CompressionAlgorithm, HashAlgorithm, KeyFlags, PubKeyAlgorithm, SymmetricKeyAlgorithm, ) primary = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) uid = pgpy.PGPUID.new("Test", email="test@example.com") primary.add_uid( uid, usage={KeyFlags.Sign, KeyFlags.Certify}, hashes=[HashAlgorithm.SHA256], ciphers=[SymmetricKeyAlgorithm.AES256], compression=[CompressionAlgorithm.ZLIB], ) subkey = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) primary.add_subkey( subkey, usage={KeyFlags.EncryptCommunications, KeyFlags.EncryptStorage}, ) # A minimal (fake, but structurally-tagged) JPEG photo attribute photo_bytes = bytearray(b"\xff\xd8\xff\xe0" + b"\x00" * 100 + b"\xff\xd9") photo_uid = pgpy.PGPUID.new(photo_bytes) primary.add_uid(photo_uid) prv_path = str(tmpdir.join("photo-prv.asc")) with open(prv_path, "w") as f: f.write(str(primary)) ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile=prv_path, email="test@example.com" ) private_key = ctrl.private_key() assert private_key is not None assert len(private_key.userattributes) == 1 assert not ApprisePGPController._has_encryption_subkey(private_key) assert ctrl.autocrypt_header() is None def test_has_encryption_subkey_rejects_revoked_primary_key(): """Reject a revoked primary key despite its valid UID and subkey.""" key = mock.Mock() key.userattributes = [] key.revocation_signatures = [mock.Mock()] assert ApprisePGPController._has_encryption_subkey(key) is False def test_has_encryption_subkey_rejects_revoked_subkey(): """Reject an encryption subkey carrying a revocation signature.""" subkey = mock.Mock() subkey.revocation_signatures = [mock.Mock()] key = mock.Mock() key.userattributes = [] key.revocation_signatures = [] key.userids = [_mock_uid_with_one_selfsig()] key.subkeys = {"a": subkey} assert ApprisePGPController._has_encryption_subkey(key) is False @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_rejects_revoked_primary_key(tmpdir): """Reject a serialized key with a revoked primary key.""" import pgpy from pgpy.constants import ( CompressionAlgorithm, HashAlgorithm, KeyFlags, PubKeyAlgorithm, SymmetricKeyAlgorithm, ) primary = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) uid = pgpy.PGPUID.new("Test", email="test@example.com") primary.add_uid( uid, usage={KeyFlags.Sign, KeyFlags.Certify}, hashes=[HashAlgorithm.SHA256], ciphers=[SymmetricKeyAlgorithm.AES256], compression=[CompressionAlgorithm.ZLIB], ) subkey = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) primary.add_subkey( subkey, usage={KeyFlags.EncryptCommunications, KeyFlags.EncryptStorage}, ) # Revoke the primary key itself revoke_sig = primary.revoke(primary) primary |= revoke_sig prv_path = str(tmpdir.join("revoked-primary-prv.asc")) with open(prv_path, "w") as f: f.write(str(primary)) ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile=prv_path, email="test@example.com" ) private_key = ctrl.private_key() assert private_key is not None assert len(list(private_key.revocation_signatures)) == 1 assert not ApprisePGPController._has_encryption_subkey(private_key) assert ctrl.autocrypt_header() is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_rejects_revoked_subkey(tmpdir): """Reject a serialized key with a revoked encryption subkey.""" import pgpy from pgpy.constants import ( CompressionAlgorithm, HashAlgorithm, KeyFlags, PubKeyAlgorithm, SymmetricKeyAlgorithm, ) primary = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) uid = pgpy.PGPUID.new("Test", email="test@example.com") primary.add_uid( uid, usage={KeyFlags.Sign, KeyFlags.Certify}, hashes=[HashAlgorithm.SHA256], ciphers=[SymmetricKeyAlgorithm.AES256], compression=[CompressionAlgorithm.ZLIB], ) subkey = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) primary.add_subkey( subkey, usage={KeyFlags.EncryptCommunications, KeyFlags.EncryptStorage}, ) # Revoke only the subkey, not the primary revoke_sig = primary.revoke(subkey) subkey |= revoke_sig prv_path = str(tmpdir.join("revoked-subkey-prv.asc")) with open(prv_path, "w") as f: f.write(str(primary)) ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile=prv_path, email="test@example.com" ) private_key = ctrl.private_key() assert private_key is not None assert not list(private_key.revocation_signatures) # primary is fine reparsed_subkey = next(iter(private_key.subkeys.values())) assert len(list(reparsed_subkey.revocation_signatures)) == 1 assert not ApprisePGPController._has_encryption_subkey(private_key) assert ctrl.autocrypt_header() is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_preserves_exported_fingerprint(tmpdir): """The advertised key retains the exported key's fingerprint.""" import pgpy ctrl = ApprisePGPController(path=str(tmpdir), email="test@example.com") assert ctrl.keygen() is True private_key = ctrl.private_key() exported = bytes(private_key.pubkey) reparsed, _ = pgpy.PGPKey.from_blob(exported) header = ctrl.autocrypt_header() assert header is not None # The advertised key must retain the exported primary-key identity. assert _keydata_fingerprint(header) == str(reparsed.fingerprint) @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_accepts_nonexportable_signature(tmpdir): """Validate the exported form of a key. PGPy drops the extra non-exportable signature, leaving one valid UID signature in the advertised key. """ import pgpy from pgpy.constants import ( CompressionAlgorithm, HashAlgorithm, KeyFlags, PubKeyAlgorithm, SymmetricKeyAlgorithm, ) primary = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) uid = pgpy.PGPUID.new("Test", email="test@example.com") primary.add_uid( uid, usage={KeyFlags.Sign, KeyFlags.Certify}, hashes=[HashAlgorithm.SHA256], ciphers=[SymmetricKeyAlgorithm.AES256], compression=[CompressionAlgorithm.ZLIB], ) subkey = pgpy.PGPKey.new(PubKeyAlgorithm.RSAEncryptOrSign, 2048) primary.add_subkey( subkey, usage={KeyFlags.EncryptCommunications, KeyFlags.EncryptStorage}, ) # A second, non-exportable certification over the same UID extra_sig = primary.certify(uid, exportable=False) uid._signatures.insert(0, extra_sig) # The live in-memory object has two signatures and fails validation assert len(uid._signatures) == 2 assert not ApprisePGPController._has_encryption_subkey(primary) # PGPy omits the extra signature from the exported key. exported = bytes(primary.pubkey) reparsed, _ = pgpy.PGPKey.from_blob(exported) assert len(reparsed.userids[0]._signatures) == 1 assert ApprisePGPController._has_encryption_subkey(reparsed) prv_path = str(tmpdir.join("nonexportable-extra-prv.asc")) with open(prv_path, "w") as f: f.write(str(primary)) ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile=prv_path, email="test@example.com" ) # The header validates the exported key rather than the live object. header = ctrl.autocrypt_header() assert header is not None assert _keydata_fingerprint(header) == str(reparsed.fingerprint) @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_handles_reparse_failure(tmpdir): """Omit the header when the exported key cannot be parsed.""" ctrl = ApprisePGPController(path=str(tmpdir), email="test@example.com") assert ctrl.keygen() is True # Warm the cache so the mock affects only the exported-key reparse. assert ctrl.private_key() is not None with mock.patch.object( pgp_module.pgpy.PGPKey, "from_blob", side_effect=ValueError("corrupt export"), ): assert ctrl.autocrypt_header() is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_autocrypt_header_folds_long_keydata(tmpdir): """Folded keydata stays within line limits and remains decodable.""" ctrl = ApprisePGPController(path=str(tmpdir), email="test@example.com") assert ctrl.keygen() is True header = ctrl.autocrypt_header() assert header is not None # Keep every physical header line within RFC 5322's hard limit. rendered = f"Autocrypt: {header}" for line in rendered.split("\r\n"): assert len(line) <= 998 # Folding must have actually happened for a real 2048-bit RSA key assert "\r\n " in header # addr= and prefer-encrypt= must stay intact and unfolded assert header.startswith( "addr=test@example.com; prefer-encrypt=mutual; keydata=" ) # Folding must not alter the advertised key. assert _keydata_fingerprint(header) == str(ctrl.private_key().fingerprint) # prune() WKD delegation def test_prune_delegates_to_wkd(tmpdir): """prune() calls prune() on the WKD controller when one is set.""" mock_wkd = mock.Mock() ctrl = ApprisePGPController(path=str(tmpdir), wkd=mock_wkd) ctrl.prune() mock_wkd.prune.assert_called_once() def test_prune_without_wkd(tmpdir): """prune() runs without error when no WKD controller is set.""" ctrl = ApprisePGPController(path=str(tmpdir)) ctrl.prune() # must not raise # PGP_SUPPORT consistency def test_pgp_support_flag_present(): """PGP_SUPPORT is a boolean exported from the pgp module.""" assert isinstance(pgp_module.PGP_SUPPORT, bool) # private_keyfile() path resolution def test_private_keyfile_no_path(): """private_keyfile() returns None when neither path nor prv_keyfile set.""" ctrl = ApprisePGPController(path=None) assert ctrl.private_keyfile() is None def test_private_keyfile_explicit_valid(tmpdir): """private_keyfile() returns a path for a valid explicit prv_keyfile.""" ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC) result = ctrl.private_keyfile() # Should be an existing file path assert result and os.path.isfile(result) def test_private_keyfile_explicit_invalid(tmpdir): """private_keyfile() returns False when an explicit file is unreachable.""" ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile="/nonexistent/path/key.asc", ) # The attachment itself is invalid, so the property returns False result = ctrl.private_keyfile() assert result is False def test_private_keyfile_auto_discover_by_email(tmpdir): """private_keyfile() finds an auto-generated key named by email prefix.""" # Place a fake private key named after the email prefix key_path = str(tmpdir.join("user-prv.asc")) with open(key_path, "w") as f: f.write("dummy") ctrl = ApprisePGPController(path=str(tmpdir), email="user@example.com") result = ctrl.private_keyfile() assert result == key_path def test_private_keyfile_fallback_generic_name(tmpdir): """private_keyfile() falls back to pgp-prv.asc when no email-named key.""" key_path = str(tmpdir.join("pgp-prv.asc")) with open(key_path, "w") as f: f.write("dummy") ctrl = ApprisePGPController(path=str(tmpdir)) result = ctrl.private_keyfile() assert result == key_path def test_private_keyfile_not_found(tmpdir): """private_keyfile() returns None when no private key exists on disk.""" ctrl = ApprisePGPController(path=str(tmpdir)) assert ctrl.private_keyfile() is None def test_prv_keyfile_property_none_when_not_set(tmpdir): """prv_keyfile property returns None when no explicit key was provided.""" ctrl = ApprisePGPController(path=str(tmpdir)) assert ctrl.prv_keyfile is None def test_prv_keyfile_property_path_when_valid(tmpdir): """prv_keyfile property returns the resolved path for a valid key.""" ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC) # Property accesses the attachment; it may return None before loading # because the attachment is resolved lazily. It must not be False. assert ctrl.prv_keyfile is not False def test_prv_keyfile_property_false_when_invalid(tmpdir): """prv_keyfile property returns False for an unreachable explicit file.""" ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile="/no/such/file.asc", ) assert ctrl.prv_keyfile is False # Loading private PGP keys @pytest.mark.skipif("pgpy" not in sys.modules, reason="Requires PGPy") def test_private_key_loads_valid_fixture(tmpdir): """private_key() returns a PGPKey object from a valid private key file.""" import pgpy ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC) key = ctrl.private_key() assert key is not None assert isinstance(key, pgpy.PGPKey) @pytest.mark.skipif("pgpy" not in sys.modules, reason="Requires PGPy") def test_private_key_cached_on_second_call(tmpdir): """private_key() returns the same object on repeated calls (cached).""" ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC) first = ctrl.private_key() second = ctrl.private_key() assert first is not None assert first is second def test_private_key_returns_none_when_not_found(tmpdir): """private_key() returns None when no private key file exists.""" ctrl = ApprisePGPController(path=str(tmpdir)) assert ctrl.private_key() is None @pytest.mark.skipif("pgpy" not in sys.modules, reason="Requires PGPy") def test_private_key_expired_cache_reloads(tmpdir): """private_key() drops an expired cache entry and reloads from disk.""" from datetime import datetime, timedelta, timezone import hashlib ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC) # Load the key once to prime the cache first = ctrl.private_key() assert first is not None # Artificially expire the cached entry by back-dating its expiry time cache_key = hashlib.sha1( ("prv:" + os.path.abspath(_VALID_PRV_ASC)).encode("utf-8") ).hexdigest() ctrl._ApprisePGPController__key_lookup[cache_key]["expires"] = ( datetime.now(timezone.utc) - timedelta(seconds=1) ) # Second call must detect the expiry and re-load from disk second = ctrl.private_key() assert second is not None def test_private_key_returns_none_when_pgpy_missing(tmpdir): """private_key() returns None gracefully when PGPy is not installed.""" import contextlib ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC) with contextlib.ExitStack() as stack: # Force PGP_SUPPORT=True so the key-loading branch is reached stack.enter_context(mock.patch.object(pgp_module, "PGP_SUPPORT", True)) # Supply any readable content for the open() call stack.enter_context( mock.patch("builtins.open", mock.mock_open(read_data="data")) ) if "pgpy" in sys.modules: # When pgpy IS installed, simulate its absence by making # from_blob raise NameError (same as if the name were undefined) stack.enter_context( mock.patch("pgpy.PGPKey.from_blob", side_effect=NameError) ) # Without pgpy installed the NameError arises naturally at the # 'pgpy.PGPKey.from_blob(...)' call in private_key(); either way # private_key() must swallow the error and return None result = ctrl.private_key() assert result is None def test_private_key_returns_none_when_keyfile_inaccessible(tmpdir): """private_key() returns None when private_keyfile() returns False.""" # Provide an invalid path so the attachment reports the file as unreachable ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile="/no/such/file.asc" ) # private_keyfile() will return False; private_key() must not raise result = ctrl.private_key() assert result is None def test_private_key_returns_none_on_io_error(tmpdir): """private_key() returns None when the file cannot be read.""" ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC) with mock.patch("builtins.open", side_effect=OSError("disk error")): result = ctrl.private_key() assert result is None def test_private_key_returns_none_on_malformed_key(tmpdir): """private_key() returns None when the file contains non-PGP data.""" bad_key = str(tmpdir.join("bad-prv.asc")) with open(bad_key, "w") as f: f.write("this is not a pgp key") ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=bad_key) result = ctrl.private_key() assert result is None def test_private_key_returns_none_when_file_disappears(tmpdir): """private_key() handles a key file that vanishes between stat and open.""" ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC) with mock.patch("builtins.open", side_effect=FileNotFoundError("gone")): result = ctrl.private_key() assert result is None @pytest.mark.skipif("pgpy" not in sys.modules, reason="Requires PGPy") def test_private_key_rejects_passphrase_protected(tmpdir): """private_key() returns None for a passphrase-protected key.""" import pgpy # Generate a fresh key and protect it with a passphrase key = pgpy.PGPKey.new( pgpy.constants.PubKeyAlgorithm.RSAEncryptOrSign, 2048 ) uid = pgpy.PGPUID.new("Locked", email="locked@example.com") key.add_uid( uid, usage={pgpy.constants.KeyFlags.Sign}, hashes=[pgpy.constants.HashAlgorithm.SHA256], ciphers=[pgpy.constants.SymmetricKeyAlgorithm.AES256], compression=[pgpy.constants.CompressionAlgorithm.ZLIB], ) key.protect( "s3cr3t", pgpy.constants.SymmetricKeyAlgorithm.AES256, pgpy.constants.HashAlgorithm.SHA256, ) locked_path = str(tmpdir.join("locked-prv.asc")) with open(locked_path, "w") as f: f.write(str(key)) ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=locked_path) result = ctrl.private_key() assert result is None @pytest.mark.skipif(not pgp_module.PGP_SUPPORT, reason="Requires PGPy") def test_private_key_rejects_public_only_file(tmpdir): """private_key() rejects public-only files supplied by pgpprv=.""" ctrl = ApprisePGPController( path=str(tmpdir), prv_keyfile=_VALID_PUB_ASC, email="test@example.com" ) result = ctrl.private_key() assert result is None # autocrypt_header() must not advertise it either assert ctrl.autocrypt_header() is None # Detached PGP signatures @pytest.mark.skipif("pgpy" not in sys.modules, reason="Requires PGPy") def test_sign_returns_signature_and_micalg(tmpdir): """sign() returns a (sig_str, micalg) tuple for valid message + key.""" ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC) result = ctrl.sign("Hello, World!") assert result is not None sig_str, micalg = result # The signature must be a non-empty armored block assert "BEGIN PGP SIGNATURE" in sig_str # The micalg must start with 'pgp-' assert micalg.startswith("pgp-") def test_sign_returns_none_when_no_private_key(tmpdir): """sign() returns None when no private key is available.""" ctrl = ApprisePGPController(path=str(tmpdir)) assert ctrl.sign("test message") is None @pytest.mark.skipif("pgpy" not in sys.modules, reason="Requires PGPy") def test_sign_returns_none_on_pgp_error(tmpdir): """sign() returns None when pgpy raises PGPError during signing.""" import pgpy ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC) with mock.patch.object( ctrl.private_key().__class__, "sign", side_effect=pgpy.errors.PGPError("fail"), ): result = ctrl.sign("test") assert result is None def test_sign_returns_none_when_pgpy_missing(tmpdir): """sign() returns None gracefully when PGPy is not installed.""" ctrl = ApprisePGPController(path=str(tmpdir), prv_keyfile=_VALID_PRV_ASC) # Patch private_key() to return a mock that raises NameError on sign() mock_key = mock.Mock() mock_key.sign.side_effect = NameError("pgpy not installed") with mock.patch.object(ctrl, "private_key", return_value=mock_key): result = ctrl.sign("test") assert result is None # Public-key candidate order def test_pub_key_candidates_no_email(tmpdir): """_pub_key_candidates() returns the four generic fallbacks when no email is known and no extra addresses are supplied.""" ctrl = ApprisePGPController(path=str(tmpdir)) # No self.email and no caller-supplied email candidates = ctrl._pub_key_candidates() # Only the four generic names should appear assert candidates == [ "pgp-public.asc", "pgp-pub.asc", "public.asc", "pub.asc", ] def test_pub_key_candidates_with_email(tmpdir): """_pub_key_candidates() prepends email-specific names ahead of generics, highest priority first (full-email before localpart).""" ctrl = ApprisePGPController(path=str(tmpdir), email="Chris@Example.com") candidates = ctrl._pub_key_candidates() # Full lowercase email is highest priority (index 0) assert candidates[0] == "chris@example.com-pub.asc" # Localpart shorthand is next assert candidates[1] == "chris-pub.asc" # Generic fallbacks follow assert "pgp-pub.asc" in candidates def test_pub_key_candidates_extra_email(tmpdir): """Recipient lookups never fall back to the sender's key.""" ctrl = ApprisePGPController(path=str(tmpdir), email="sender@example.com") # Simulate a lookup for a recipient address candidates = ctrl._pub_key_candidates("recipient@example.com") assert candidates[0] == "recipient@example.com-pub.asc" assert candidates[1] == "recipient-pub.asc" # Sender entries must not appear in a recipient lookup. assert "sender@example.com-pub.asc" not in candidates assert "sender-pub.asc" not in candidates # Private-key candidate order def test_prv_key_candidates_no_email(tmpdir): """_prv_key_candidates() returns the four generic fallbacks when no sender email is configured.""" ctrl = ApprisePGPController(path=str(tmpdir)) candidates = ctrl._prv_key_candidates() assert candidates == [ "pgp-private.asc", "pgp-prv.asc", "private.asc", "prv.asc", ] def test_prv_key_candidates_with_email(tmpdir): """_prv_key_candidates() prepends email-specific names ahead of generics, highest priority first (full-email before localpart).""" ctrl = ApprisePGPController(path=str(tmpdir), email="Sender@Nuxref.com") candidates = ctrl._prv_key_candidates() # Full lowercase email is highest priority assert candidates[0] == "sender@nuxref.com-prv.asc" # Localpart shorthand is next assert candidates[1] == "sender-prv.asc" # Generic fallbacks follow assert "pgp-prv.asc" in candidates # Missing public-key diagnostics def test_public_key_no_key_emits_path_debug(tmpdir): """public_key() emits a DEBUG message listing relative cache paths when no public key is found and autogen is disabled. The message is debug- level so the caller's warning remains the only user-visible line.""" ctrl = ApprisePGPController(path=str(tmpdir), email="user@example.com") logging.disable(logging.NOTSET) try: with mock.patch.object(pgp_module, "PGP_SUPPORT", True): result = ctrl.public_key("user@example.com", autogen=False) finally: logging.disable(logging.CRITICAL) # Key not found; result must be None assert result is None def test_public_key_no_key_no_path_emits_generic_debug(): """public_key() emits a generic 'No PGP public key found' debug message in memory-only mode (no path to search, so no filenames to list).""" ctrl = ApprisePGPController(path=None) logging.disable(logging.NOTSET) try: with mock.patch.object(pgp_module, "PGP_SUPPORT", True): result = ctrl.public_key("user@example.com", autogen=False) finally: logging.disable(logging.CRITICAL) assert result is None # Missing private-key diagnostics def test_private_key_not_found_emits_path_debug(tmpdir): """private_key() emits a DEBUG message listing searched relative paths when no private key file exists on disk. The message is debug-level so the caller's warning remains the only user-visible line.""" ctrl = ApprisePGPController(path=str(tmpdir), email="sender@example.com") logging.disable(logging.NOTSET) try: result = ctrl.private_key() finally: logging.disable(logging.CRITICAL) assert result is None def test_private_key_not_found_no_path_emits_generic_debug(): """private_key() emits a generic 'No PGP private key found' debug message in memory-only mode (no storage path, nothing to search).""" ctrl = ApprisePGPController(path=None) logging.disable(logging.NOTSET) try: result = ctrl.private_key() finally: logging.disable(logging.CRITICAL) assert result is None caronc-apprise-dfec414/tests/test_utils_sanitize.py000066400000000000000000000172411526720371000227450ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. """Unit tests for :mod:`apprise.utils.sanitize`.""" from __future__ import annotations from hashlib import sha256 import logging import sys import pytest from apprise.utils.sanitize import SanitizeOptions, sanitize_payload # Disable logging for a cleaner testing output logging.disable(logging.CRITICAL) sys.dont_write_bytecode = True class _ReprOnly: """Helper type that only supports repr(), used to cover fallback paths.""" def __repr__(self) -> str: return "" def test_sanitize_payload_passthrough_primitives() -> None: """Primitives should pass through with minimal transformation.""" assert sanitize_payload(None) is None assert sanitize_payload(True) is True assert sanitize_payload(False) is False assert sanitize_payload(123) == 123 assert sanitize_payload(3.14) == pytest.approx(3.14) def test_sanitize_payload_small_string_passthrough() -> None: """Small strings are not altered, preserving debugging usefulness.""" s = "hello world" assert sanitize_payload(s) == s def test_sanitize_payload_large_string_is_summarized() -> None: """Strings beyond max_str_len are summarized with head/tail previews.""" opts = SanitizeOptions(max_str_len=64, preview=8) s = "x" * 200 out = sanitize_payload(s, options=opts) assert isinstance(out, str) assert out.startswith(" None: """Bytes keys become readable string markers rather than raw bytes.""" opts = SanitizeOptions(hash_sample_size=16) bkey = b"abc" payload = { bkey: "value1", "k": "v", } out = sanitize_payload(payload, options=opts) assert isinstance(out, dict) expected_b_digest = sha256(bkey[: opts.hash_sample_size]).hexdigest()[:12] bkey_s = f"" assert bkey_s in out assert out[bkey_s] == "value1" assert out["k"] == "v" def test_sanitize_payload_sequence_types() -> None: """Lists, tuples, sets, and frozensets are walked safely.""" payload = [1, "x" * 200, b"xyz"] opts = SanitizeOptions(max_str_len=64, preview=8) out = sanitize_payload(payload, options=opts) assert isinstance(out, list) assert out[0] == 1 assert isinstance(out[1], str) and out[1].startswith(" None: """Self-referential objects should not trigger infinite recursion.""" payload: dict[str, object] = {} payload["self"] = payload out = sanitize_payload(payload) assert isinstance(out, dict) assert out["self"] == "" def test_sanitize_payload_max_depth_truncation() -> None: """Depth limits protect against overly deep nested structures.""" opts = SanitizeOptions(max_depth=2) payload = {"a": {"b": {"c": "d"}}} out = sanitize_payload(payload, options=opts) assert isinstance(out, dict) assert isinstance(out["a"], dict) assert isinstance(out["a"]["b"], dict) assert out["a"]["b"]["c"] == "" def test_sanitize_payload_max_items_truncation_in_list_branch() -> None: """Item limits protect against very large sequences.""" opts = SanitizeOptions(max_items=2) payload = [1, 2, 3, 4] out = sanitize_payload(payload, options=opts) assert isinstance(out, list) assert out[-1] == "" def test_sanitize_payload_global_item_limit_guard_message() -> None: """The global max_items guard stops work consistently.""" opts = SanitizeOptions(max_items=1) payload = {"a": "x", "b": "y"} out = sanitize_payload(payload, options=opts) assert isinstance(out, dict) assert any( v == "" or v == "..." for v in out.values() ) def test_sanitize_payload_falls_back_to_repr_for_unknown_objects() -> None: """Unknown objects are converted with repr() for logging.""" assert sanitize_payload(_ReprOnly()) == "" def test_sanitize_payload_blob_key_enables_blob_mode_and_summarizes() -> None: """Blob-like keys enable blob_mode and trigger .""" opts = SanitizeOptions( aggressive_blob_keys=True, # ensure normal summarization would NOT trigger max_str_len=999999, preview=8, ) payload = { # small string, but blob_mode forces summary "base64_attachments": "ABCDEF", } out = sanitize_payload(payload, options=opts) assert isinstance(out, dict) assert "base64_attachments" in out assert isinstance(out["base64_attachments"], str) assert out["base64_attachments"].startswith(" None: """ Verify non-string, non-bytes dictionary keys are preserved unchanged. This exercises the fallback path in _summarize_key(), ensuring unexpected key types (such as integers) are passed through safely during sanitisation. """ payload = { # int key triggers the "return k" branch 42: "value", # keep a normal key too "k": "v", } out = sanitize_payload(payload) assert isinstance(out, dict) assert 42 in out assert out[42] == "value" assert out["k"] == "v" caronc-apprise-dfec414/tests/test_utils_socket.py000066400000000000000000001024571526720371000224130ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. import logging import ssl from unittest import mock import pytest from apprise.exception import AppriseException, AppriseInvalidData from apprise.utils.socket import AppriseSocketError, SocketTransport # Disable logging for a cleaner testing output logging.disable(logging.CRITICAL) class _DummyFile: def __init__(self) -> None: self.flushed = 0 self.closed = 0 def flush(self) -> None: self.flushed += 1 def close(self) -> None: self.closed += 1 class _DummySocket: """ Minimal fake socket object, supports the subset used by SocketTransport. """ def __init__(self) -> None: self.blocking = True self.timeout = None self.closed = False self.shutdown_called = 0 self._recv_side_effect = None self._send_side_effect = None def setsockopt(self, *_args, **_kwargs) -> None: return None def bind(self, *_args, **_kwargs) -> None: return None def fileno(self) -> int: return 1 def settimeout(self, value): self.timeout = value def setblocking(self, value): self.blocking = bool(value) def connect(self, *_args, **_kwargs) -> None: return None def shutdown(self, *_args, **_kwargs) -> None: self.shutdown_called += 1 def close(self) -> None: self.closed = True def getsockname(self): return ("127.0.0.1", 12345) def getpeername(self): return ("203.0.113.10", 6667) def makefile(self, *_args, **_kwargs): return _DummyFile() def recv(self, *_args, **_kwargs): if self._recv_side_effect is not None: raise self._recv_side_effect return b"data" def send(self, *_args, **_kwargs): if self._send_side_effect is not None: raise self._send_side_effect return 4 def test_utils_socket_timeout_coerce(): """SocketTransport() Timeout Coercion.""" # None => None, None s = SocketTransport("example.com", 1, timeout=None) assert s._connect_timeout is None assert s._read_timeout is None # float => both s = SocketTransport("example.com", 1, timeout=2.5) assert s._connect_timeout == pytest.approx(2.5) assert s._read_timeout == pytest.approx(2.5) # tuple => (connect, read) s = SocketTransport("example.com", 1, timeout=(1.0, 3.0)) assert s._connect_timeout == pytest.approx(1.0) assert s._read_timeout == pytest.approx(3.0) # tuple with None is allowed s = SocketTransport("example.com", 1, timeout=(None, 3.0)) assert s._connect_timeout is None assert s._read_timeout == pytest.approx(3.0) # invalid types with pytest.raises(AppriseInvalidData): SocketTransport("example.com", 1, timeout="bad") with pytest.raises(AppriseInvalidData): SocketTransport("example.com", 1, timeout=(1.0, 2.0, 3.0)) with pytest.raises(AppriseInvalidData): SocketTransport("example.com", 1, timeout=-1.0) def test_utils_socket_properties_and_close_paths(): """SocketTransport() Properties And Close Paths.""" s = SocketTransport("example.com", 1) assert s.connected is False assert s.is_tls is False # Seed with dummy socket + wrappers s._sock = _DummySocket() s._rfile = _DummyFile() s._wfile = _DummyFile() s._is_tls = True s.local_addr = ("1.1.1.1", 1) s.remote_addr = ("2.2.2.2", 2) s.close() assert s._sock is None assert s._rfile is None assert s._wfile is None assert s._is_tls is False assert s.local_addr is None assert s.remote_addr is None def test_utils_socket_read_write_no_socket(): """SocketTransport() Can Read/Write - No Socket.""" s = SocketTransport("example.com", 1) assert s.can_read() is None assert s.can_write() is None def test_utils_socket_can_read_write_select_error(): """SocketTransport() Can Read/Write - select() Error.""" s = SocketTransport("example.com", 1) s._sock = _DummySocket() with mock.patch("select.select", side_effect=OSError()): assert s.can_read() is None assert s._sock is None s._sock = _DummySocket() with mock.patch("select.select", side_effect=OSError()): assert s.can_write() is None assert s._sock is None def test_utils_socket_can_read_write_socket_close(): """SocketTransport() Can Read/Write - Socket Close.""" s = SocketTransport("example.com", 1) s._sock = _DummySocket() # Exceptional socket list returned triggers close() with mock.patch("select.select", return_value=([], [], [s._sock])): assert s.can_read() is None assert s._sock is None s._sock = _DummySocket() with mock.patch("select.select", return_value=([], [], [s._sock])): assert s.can_write() is None assert s._sock is None def test_utils_socket_server_hostname_for_tls(): """SocketTransport() Server Hostname For TLS.""" s = SocketTransport("irc.example.com", 1, verify=True) assert s._server_hostname_for_tls() == "irc.example.com" s = SocketTransport("irc.example.com", 1, verify=False) assert s._server_hostname_for_tls() == "irc.example.com" def test_utils_socket_server_hostname_for_tls_ip_reverse(): """SocketTransport() Server Hostname For TLS IP Reverse DNS""" s = SocketTransport("203.0.113.10", 1, verify=True) with mock.patch( "socket.gethostbyaddr", return_value=("irc.example.com.", [], []) ): assert s._server_hostname_for_tls() == "irc.example.com" with mock.patch("socket.gethostbyaddr", side_effect=OSError()): assert s._server_hostname_for_tls() == "203.0.113.10" # verify=False => no lookup s = SocketTransport("203.0.113.10", 1, verify=False) with mock.patch("socket.gethostbyaddr") as m: assert s._server_hostname_for_tls() == "203.0.113.10" m.assert_not_called() def test_utils_socket_build_ssl_context(): """SocketTransport() Build SSL Context.""" class _DummySSLContext: def __init__(self, *, raise_on_minimum: bool) -> None: self.raise_on_minimum = raise_on_minimum self.options = 0 self.check_hostname = None self.verify_mode = None self._minimum_version = None @property def minimum_version(self): return self._minimum_version @minimum_version.setter def minimum_version(self, value): if self.raise_on_minimum: raise RuntimeError("minimum_version not supported") self._minimum_version = value # verify=True path with minimum_version support s = SocketTransport("example.com", 1, verify=True) ctx = _DummySSLContext(raise_on_minimum=False) with ( mock.patch("certifi.where", return_value="/tmp/ca.pem"), mock.patch("ssl.create_default_context", return_value=ctx) as m, ): result = s._build_ssl_context() assert result is ctx m.assert_called_once() assert ctx.check_hostname is True assert ctx.verify_mode == ssl.CERT_REQUIRED # TLS 1.2+ preferred path assert ctx.minimum_version == ssl.TLSVersion.TLSv1_2 # Compression disabled when supported if hasattr(ssl, "OP_NO_COMPRESSION"): assert (ctx.options & ssl.OP_NO_COMPRESSION) != 0 # verify=False path still enforces TLS 1.2+ s = SocketTransport("example.com", 1, verify=False) ctx = _DummySSLContext(raise_on_minimum=False) with mock.patch("ssl.create_default_context", return_value=ctx): result = s._build_ssl_context() assert result is ctx assert ctx.check_hostname is False assert ctx.verify_mode == ssl.CERT_NONE assert ctx.minimum_version == ssl.TLSVersion.TLSv1_2 # Fallback path: minimum_version setter fails, options are used instead s = SocketTransport("example.com", 1, verify=True) ctx = _DummySSLContext(raise_on_minimum=True) with ( mock.patch("certifi.where", return_value="/tmp/ca.pem"), mock.patch("ssl.create_default_context", return_value=ctx), ): result = s._build_ssl_context() assert result is ctx # minimum_version was not set assert ctx.minimum_version is None # Fallback disables older protocols when options are present if hasattr(ssl, "OP_NO_TLSv1"): assert (ctx.options & ssl.OP_NO_TLSv1) != 0 if hasattr(ssl, "OP_NO_TLSv1_1"): assert (ctx.options & ssl.OP_NO_TLSv1_1) != 0 def test_utils_socket_start_tls_no_socket_raises(): """SocketTransport() Start TLS No Socket Raises.""" s = SocketTransport("example.com", 1, secure=True) with pytest.raises(AppriseSocketError): s.start_tls() def test_utils_socket_start_tls_already_tls_noop(): """SocketTransport() Start TLS Already TLS Noop.""" s = SocketTransport("example.com", 1, secure=True) s._sock = _DummySocket() s._is_tls = True s.start_tls() assert s._sock is not None assert s._is_tls is True def test_utils_socket_tls_ssl_init_errors(): """SocketTransport() Start TLS/SSL Initialization Errors.""" s = SocketTransport("example.com", 1, secure=True) s._sock = _DummySocket() with mock.patch.object(s, "_build_ssl_context") as mctx: ctx = mock.Mock() ctx.wrap_socket.side_effect = ssl.SSLError("boom") mctx.return_value = ctx with pytest.raises(AppriseSocketError): s.start_tls() assert s._sock is None s._sock = _DummySocket() with mock.patch.object(s, "_build_ssl_context") as mctx: ctx = mock.Mock() ctx.wrap_socket.side_effect = OSError("boom") mctx.return_value = ctx with pytest.raises(AppriseSocketError): s.start_tls() assert s._sock is None def test_utils_socket_tls_tests(): """SocketTransport() TLS Coverage""" s = SocketTransport("example.com", 1, secure=True) base_sock = _DummySocket() s._sock = base_sock tls_sock = _DummySocket() ctx = mock.Mock() ctx.wrap_socket.return_value = tls_sock with ( mock.patch.object(s, "_build_ssl_context", return_value=ctx), mock.patch.object( s, "_server_hostname_for_tls", return_value="example.com" ), ): s.start_tls() assert s._sock is tls_sock assert s.is_tls is True assert s.local_addr == ("127.0.0.1", 12345) assert s.remote_addr == ("203.0.113.10", 6667) assert s._rfile is not None assert s._wfile is not None def test_utils_socket_connect(): """SocketTransport() Connect() Coverage.""" s = SocketTransport("example.com", 6667, secure=False, timeout=(1.0, 2.0)) dummy = _DummySocket() with mock.patch("socket.socket", return_value=dummy): s.connect() assert s.connected is True assert s.is_tls is False assert s.local_addr == ("127.0.0.1", 12345) assert s.remote_addr == ("203.0.113.10", 6667) # Failure path: connect raises s = SocketTransport("example.com", 6667, secure=False, timeout=(1.0, 2.0)) dummy = _DummySocket() dummy.connect = mock.Mock(side_effect=OSError("fail")) with mock.patch("socket.socket", return_value=dummy): with pytest.raises(AppriseSocketError): s.connect() assert s.connected is False def test_utils_socket_read_nonblocking(): """SocketTransport() Read Nonblocking.""" s = SocketTransport("example.com", 1) sock = _DummySocket() s._sock = sock # Non-blocking success assert s.read(blocking=False) == b"data" # Non-blocking no data sock._recv_side_effect = BlockingIOError() assert s.read(blocking=False) == b"" # Non-blocking OSError -> close + raise sock._recv_side_effect = OSError("boom") with pytest.raises(AppriseSocketError): s.read(blocking=False) assert s._sock is None def test_utils_socket_read_blocking_timeout(): """SocketTransport() Read Blocking Timeout.""" s = SocketTransport("example.com", 1, timeout=(1.0, 0.1)) sock = _DummySocket() s._sock = sock # Timeout path: can_read returns False => b"" with mock.patch.object(s, "can_read", return_value=False): assert s.read(blocking=True) == b"" # Indefinite path: wait_timeout=None, loop until can_read True s = SocketTransport("example.com", 1, timeout=None) sock = _DummySocket() s._sock = sock side_effect = [False, False, True] with mock.patch.object(s, "can_read", side_effect=side_effect): assert s.read(blocking=True) == b"data" def test_utils_socket_read_blocking_edge_cases() -> None: """SocketTransport() Read Blocking Edge Cases""" s = SocketTransport("example.com", 1, timeout=None) bad_sock = _DummySocket() good_sock = _DummySocket() good_sock.recv = mock.Mock(return_value=b"data") s._sock = bad_sock s._had_io = True def _close_side_effect() -> None: # emulate closing the socket if s._sock is not None: s._sock = None s._rfile = None s._wfile = None s._is_tls = False s.local_addr = None s.remote_addr = None def _connect_side_effect() -> None: s._sock = good_sock s._refresh_wrappers() with ( mock.patch.object(s, "close", side_effect=_close_side_effect), mock.patch.object(s, "connect", side_effect=_connect_side_effect), mock.patch.object(s, "can_read", return_value=None), ): # can_read(None) triggers reconnect branch, then recv() on new socket assert s.read(blocking=True, retries=1) == b"data" def test_utils_socket_write_with_no_socket(): """SocketTransport() write() - No Socket.""" s = SocketTransport("example.com", 1) with pytest.raises(AppriseSocketError): s.write(b"hi") s._sock = _DummySocket() with pytest.raises(AppriseInvalidData): s.write("hi") # type: ignore[arg-type] def test_utils_socket_write_flush(): """SocketTransport() write() - Flush.""" s = SocketTransport("example.com", 1, timeout=(1.0, 0.2)) sock = _DummySocket() s._sock = sock s._wfile = _DummyFile() # Normal send, flush=True with mock.patch.object(s, "can_write", return_value=True): assert s.write(b"test", flush=True) == 4 assert s._wfile.flushed >= 1 # send returning 0 triggers connection lost sock = _DummySocket() sock.send = mock.Mock(return_value=0) s._sock = sock with pytest.raises(AppriseSocketError): s.write(b"test", timeout=0.1) # Timeout path: can_write returns False sock = _DummySocket() s._sock = sock with ( mock.patch.object(s, "can_write", return_value=False), pytest.raises(AppriseSocketError), ): s.write(b"test", timeout=0.1) # OSError triggers close sock = _DummySocket() sock._send_side_effect = OSError("boom") s._sock = sock with pytest.raises(AppriseSocketError): s.write(b"test", timeout=0.1) assert s._sock is None def test_utils_socket_read_timeouts(): """SocketTransport() Read Timeouts""" # Negative connect timeout with pytest.raises(AppriseInvalidData): SocketTransport("example.com", 1, timeout=(-0.1, 1.0)) # Negative read timeout with pytest.raises(AppriseInvalidData): SocketTransport("example.com", 1, timeout=(1.0, -0.1)) # Force the read_t is None branch s = SocketTransport("example.com", 1, timeout=(1.0, None)) assert s._connect_timeout == pytest.approx(1.0) assert s._read_timeout is None def test_utils_socket_exceptions(): """SocketTransport() Exception Testing.""" assert issubclass(AppriseSocketError, AppriseException) def test_utils_socket_close_exceptions(): """SocketTransport() Close Exceptions.""" class _BadShutdownSocket(_DummySocket): def shutdown(self, *_args, **_kwargs) -> None: raise Exception("shutdown fail") class _BadFile(_DummyFile): def flush(self) -> None: raise Exception("flush fail") def close(self) -> None: raise Exception("close fail") s = SocketTransport("example.com", 1) s._sock = _BadShutdownSocket() s._wfile = _BadFile() s._rfile = _BadFile() # Should not raise, despite flush/close/shutdown throwing s.close() assert s._sock is None assert s._wfile is None assert s._rfile is None def test_utils_socket_refresh(): """SocketTransport() Refresh.""" s = SocketTransport("example.com", 1) s._sock = None s._rfile = _DummyFile() s._wfile = _DummyFile() s._refresh_wrappers() assert s._rfile is None assert s._wfile is None def test_utils_socket_can_read_returns_bool(): """SocketTransport() Can Read Returns Bool.""" s = SocketTransport("example.com", 1) s._sock = _DummySocket() with mock.patch("select.select", return_value=([s._sock], [], [])): assert s.can_read(0.01) is True with mock.patch("select.select", return_value=([], [], [])): assert s.can_read(0.01) is False def test_utils_socket_connect_bind(): """SocketTransport() bind() tests""" s = SocketTransport( "example.com", 6667, bind_addr="127.0.0.1", bind_port=0 ) dummy = _DummySocket() dummy.bind = mock.Mock() with mock.patch("socket.socket", return_value=dummy): s.connect() dummy.bind.assert_called_once() def test_utils_socket_connect_settimeout_handling(): """SocketTransport() Connect settimeout() handling.""" s = SocketTransport("example.com", 6667, timeout=None) dummy = _DummySocket() dummy.settimeout = mock.Mock() with mock.patch("socket.socket", return_value=dummy): s.connect() # called once with None after connect() (sock.settimeout(None)) # but NOT called with a float connect timeout prior to connect. assert dummy.settimeout.call_args_list == [mock.call(None)] def test_utils_socket_secure_connect(): """SocketTransport() Secure connect().""" s = SocketTransport("example.com", 6667, secure=True) dummy = _DummySocket() with ( mock.patch("socket.socket", return_value=dummy), mock.patch.object(s, "start_tls", autospec=True) as m, ): s.connect() m.assert_called_once() def test_utils_socket_connect_exceptions(): """SocketTransport() Connect Exceptions.""" class _BadCloseSocket(_DummySocket): def connect(self, *_args, **_kwargs) -> None: raise OSError("connect fail") def close(self) -> None: raise Exception("close fail") s = SocketTransport("example.com", 6667, secure=False) dummy = _BadCloseSocket() with ( mock.patch("socket.socket", return_value=dummy), pytest.raises(AppriseSocketError), ): s.connect() # transport should not keep the socket assert s.connected is False def test_utils_socket_write_deadline(): """SocketTransport() Write Deadline.""" s = SocketTransport("example.com", 1, timeout=(1.0, 0.2)) sock = _DummySocket() s._sock = sock with mock.patch.object(s, "can_write", return_value=True) as m_can_write: written = s.write(b"test", timeout=0.1, flush=False) assert written == 4 assert m_can_write.called def test_utils_socket_write_timeout(): """SocketTransport() write() timeout.""" s = SocketTransport("example.com", 1, timeout=(1.0, 0.2)) s._sock = _DummySocket() # First monotonic call sets deadline, second call makes remaining <= 0 with mock.patch("time.monotonic", side_effect=[1000.0, 1000.5]): with pytest.raises(AppriseSocketError) as e: s.write(b"test", timeout=0.1, flush=False) assert "Timed out during write" in str(e.value) s = SocketTransport("example.com", 1, timeout=None) sock = _DummySocket() s._sock = sock s._wfile = _DummyFile() # If deadline is None, can_write should never be called with mock.patch.object(s, "can_write") as m_can_write: result = s.write(b"test", flush=True, timeout=None) assert result == 4 m_can_write.assert_not_called() def test_utils_socket_write_flush_edge_cases(): """SocketTransport() write() flush() edge cases.""" s = SocketTransport("example.com", 1, timeout=(1.0, 0.2)) s._sock = _DummySocket() s._wfile = _DummyFile() with mock.patch.object(s._wfile, "flush") as m: with mock.patch.object(s, "can_write", return_value=True): written = s.write(b"test", flush=False, timeout=0.1) assert written == 4 m.assert_not_called() s = SocketTransport("example.com", 1, timeout=(1.0, 0.2)) s._sock = _DummySocket() s._wfile = None # Should succeed and simply skip flush with mock.patch.object(s, "can_write", return_value=True): assert s.write(b"test", flush=True, timeout=0.1) == 4 def test_utils_socket_recv_error(): """SocketTransport() recv() errors Covers blocking read() OSError handling after readiness check. """ s = SocketTransport("example.com", 1, timeout=(1.0, 0.5)) sock = _DummySocket() sock._recv_side_effect = OSError("recv failed") s._sock = sock with ( mock.patch.object(s, "can_read", return_value=True), pytest.raises(AppriseSocketError) as e, ): s.read(blocking=True) assert "recv failed" in str(e.value) assert s._sock is None def test_utils_socket_write_empty_payload_does_not_set_had_io() -> None: """SocketTransport() Write Empty Payload Does Not Set Had Io. Covers the branch where total_sent == 0, so _had_io is not updated. """ s = SocketTransport("example.com", 1, timeout=None) s._sock = _DummySocket() s._wfile = _DummyFile() # Empty payload performs no send() calls sent = s.write(b"", flush=False, timeout=None) assert sent == 0 assert s._had_io is False def test_utils_socket_write_handling() -> None: """SocketTransport() Write handling""" s = SocketTransport("example.com", 1, timeout=None) s._sock = _DummySocket() # Mark prior I/O so reconnect is considered eligible in real logic, but we # patch _attempt_reconnect to force the continue path deterministically. s._had_io = True # Force the send to fail with an AppriseSocketError s._sock.send = mock.Mock(side_effect=AppriseSocketError("boom")) # retries=0 => attempts == 1; we force _attempt_reconnect to return True, # which triggers `continue` and immediately exhausts the loop. with ( mock.patch.object(s, "_attempt_reconnect", return_value=True), pytest.raises(AppriseSocketError) as e, ): s.write(b"test", timeout=None, retries=0) assert "Socket write failed" in str(e.value) def test_utils_socket_write_reconnect_continue_path_is_reached() -> None: """SocketTransport() Write Reconnect Continue Path Is Reached. Covers the `continue` path in write() when _attempt_reconnect returns True. Trigger AppriseSocketError (not OSError) so we do not reset _had_io via. close() before reconnect eligibility is checked. """ s = SocketTransport("example.com", 1, timeout=None) bad_sock = _DummySocket() # send returning 0 triggers "Connection lost during write" bad_sock.send = mock.Mock(return_value=0) good_sock = _DummySocket() good_sock.send = mock.Mock(return_value=4) s._sock = bad_sock s._had_io = True def _connect_side_effect() -> None: s._sock = good_sock s._refresh_wrappers() with mock.patch.object(s, "connect", side_effect=_connect_side_effect): assert s.write(b"test", timeout=None, retries=1, flush=False) == 4 def test_utils_socket_read_reconnect_continue_path_is_reached() -> None: """SocketTransport() Read Reconnect Continue Path Is Reached. Covers the `continue` path in read() when _attempt_reconnect returns True. Trigger AppriseSocketError (not OSError) so we do not reset _had_io via. close() before reconnect eligibility is checked. """ s = SocketTransport("example.com", 1, timeout=None) bad_sock = _DummySocket() # recv returning b"" triggers "Connection lost during read" bad_sock.recv = mock.Mock(return_value=b"") good_sock = _DummySocket() good_sock.recv = mock.Mock(return_value=b"data") s._sock = bad_sock s._had_io = True def _connect_side_effect() -> None: s._sock = good_sock s._refresh_wrappers() with mock.patch.object(s, "connect", side_effect=_connect_side_effect): assert s.read(blocking=False, retries=1) == b"data" def test_utils_socket_attempt_reconnect_retries_zero_returns_false() -> None: """SocketTransport() Attempt Reconnect Retries Zero Returns False. Covers _attempt_reconnect() early return when retries <= 0. """ s = SocketTransport("example.com", 1, timeout=None) s._had_io = True assert ( s._attempt_reconnect( retries=0, action="read", exc=Exception("boom"), ) is False ) def test_utils_socket_read_blocking_connection() -> None: """SocketTransport() Read Blocking Connection.""" s = SocketTransport("example.com", 1, timeout=(1.0, 0.5)) sock = _DummySocket() sock.recv = mock.Mock(return_value=b"") s._sock = sock # Mark prior I/O, but retries=0 means reconnect is not allowed anyway s._had_io = True with ( mock.patch.object(s, "can_read", return_value=True), pytest.raises(AppriseSocketError) as e, ): s.read(blocking=True, retries=0) assert "Connection lost during read" in str(e.value) def test_utils_socket_read_blocking() -> None: """SocketTransport() Read Blocking""" s = SocketTransport("example.com", 1, timeout=(1.0, 0.5)) bad_sock = _DummySocket() bad_sock.recv = mock.Mock(return_value=b"") good_sock = _DummySocket() good_sock.recv = mock.Mock(return_value=b"data") s._sock = bad_sock s._had_io = True def _connect_side_effect() -> None: s._sock = good_sock s._refresh_wrappers() with ( mock.patch.object(s, "can_read", return_value=True), mock.patch.object(s, "connect", side_effect=_connect_side_effect), ): assert s.read(blocking=True, retries=1) == b"data" s = SocketTransport("example.com", 1, timeout=(1.0, 0.5)) sock = _DummySocket() s._sock = sock with mock.patch.object(s, "can_read", return_value=True): assert s.read(blocking=True) == b"data" s = SocketTransport("example.com", 1, timeout=None) s._sock = _DummySocket() with mock.patch.object(s, "can_read", return_value=None): with pytest.raises(AppriseSocketError) as e: s.read(blocking=True) assert "Socket closed" in str(e.value) s = SocketTransport("example.com", 1, timeout=(1.0, 0.5)) s._sock = _DummySocket() with mock.patch.object(s, "can_read", return_value=False): assert s.read(blocking=True) == b"" def test_utils_socket_read_edge_cases(): """SocketTransport() read() edge case tests.""" s = SocketTransport("example.com", 1) s._sock = None assert s.read() == b"" s = SocketTransport("example.com", 1, timeout=None) sock = _DummySocket() sock.recv = mock.Mock(return_value=b"") # triggers AppriseSocketError path s._sock = sock s._had_io = True with ( mock.patch.object(s, "_attempt_reconnect", return_value=True), pytest.raises(AppriseSocketError) as e, ): # retries=0 => attempts starts at 1, decremented to 0 in-loop s.read(blocking=False, retries=0) assert "Socket read failed" in str(e.value) def test_utils_socket_attempt_reconnect_no_io() -> None: """SocketTransport() _attempt_reconnect() returns False""" s = SocketTransport("example.com", 1, timeout=None) # Explicitly not eligible for reconnect s._had_io = False with ( mock.patch.object(s, "close") as m_close, mock.patch.object(s, "connect") as m_connect, ): assert ( s._attempt_reconnect( retries=1, action="read", exc=Exception("boom"), ) is False ) # Should not attempt any reconnect work m_close.assert_not_called() m_connect.assert_not_called() def test_utils_socket_attempt_reconnect_connect_exception() -> None: """SocketTransport() _attempt_reconnect() handles exception.""" s = SocketTransport("example.com", 1, timeout=None) # Eligible for reconnect s._had_io = True with ( mock.patch.object(s, "close") as m_close, mock.patch.object( s, "connect", side_effect=Exception("nope") ) as m_connect, ): assert ( s._attempt_reconnect( retries=1, action="write", exc=Exception("boom"), ) is False ) m_close.assert_called_once() m_connect.assert_called_once() def test_utils_socket_ssl_read_blocking() -> None: """SocketTransport() read() blocking""" s = SocketTransport("example.com", 1, timeout=None) sock = _DummySocket() # First recv indicates TLS wants more reads, second returns data sock.recv = mock.Mock(side_effect=[ssl.SSLWantReadError(), b"data"]) s._sock = sock # Indefinite blocking, so we must reach recv() and then loop on WANT_READ with mock.patch.object(s, "can_read", return_value=True): assert s.read(blocking=True, timeout=None) == b"data" # Coverage for read blocking, WANT_WRITE s = SocketTransport("example.com", 1, timeout=(1.0, 0.5)) sock = _DummySocket() # Trigger the WANT_WRITE/BlockingIOError handling inside the recv loop sock.recv = mock.Mock(side_effect=ssl.SSLWantWriteError()) s._sock = sock # 1) initial readiness check returns True (enter recv loop) # 2) inner loop calls can_read(min(...)) and gets False, returning b"" with mock.patch.object(s, "can_read", side_effect=[True, False]): assert s.read(blocking=True, timeout=0.5) == b"" s = SocketTransport("example.com", 1, timeout=(1.0, 0.5)) sock = _DummySocket() # WANT_WRITE first, then a successful read sock.recv = mock.Mock(side_effect=[ssl.SSLWantWriteError(), b"data"]) s._sock = sock # can_read used twice: # - readiness check (True) # - busy-loop avoidance check (True) with mock.patch.object(s, "can_read", side_effect=[True, True]): assert s.read(blocking=True, timeout=0.5) == b"data" s = SocketTransport("example.com", 1, timeout=None) bad_sock = _DummySocket() # In blocking read, b"" triggers "Connection lost during read" bad_sock.recv = mock.Mock(return_value=b"") good_sock = _DummySocket() # This targets the post-reconnect immediate recv path and forces b"" there good_sock.recv = mock.Mock(return_value=b"") s._sock = bad_sock s._had_io = True def _connect_side_effect() -> None: s._sock = good_sock s._refresh_wrappers() # Ensure we enter the blocking path and do the initial recv that fails, # then reconnect, then attempt immediate recv on the new socket. with ( mock.patch.object(s, "can_read", return_value=True), mock.patch.object(s, "connect", side_effect=_connect_side_effect), ): with pytest.raises(AppriseSocketError) as e: s.read(blocking=True, retries=1) assert "Connection lost during read" in str(e.value) s = SocketTransport("example.com", 1, timeout=None) bad_sock = _DummySocket() bad_sock.recv = mock.Mock(return_value=b"") s._sock = bad_sock s._had_io = True good_sock = _DummySocket() # - First call is the post-reconnect immediate recv: it raises # BlockingIOError # - Second call occurs in the next loop iteration after can_read says True good_sock.recv = mock.Mock(side_effect=[BlockingIOError(), b"data"]) def _connect_side_effect() -> None: s._sock = good_sock s._refresh_wrappers() # can_read must return True so we get to recv() on the next iteration with ( mock.patch.object(s, "can_read", return_value=True), mock.patch.object(s, "connect", side_effect=_connect_side_effect), ): assert s.read(blocking=True, retries=1) == b"data" caronc-apprise-dfec414/tests/test_utils_wkd.py000066400000000000000000000671701526720371000217120ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # Disable logging for a cleaner testing output from datetime import datetime, timedelta, timezone import logging from unittest import mock from urllib.parse import urlparse import pytest import requests from apprise.utils.wkd import AppriseWKDController, AppriseWKDException logging.disable(logging.CRITICAL) # --------------------------------------------------------------------------- # AppriseWKDException # --------------------------------------------------------------------------- def test_wkd_exception_default_error_code(): """AppriseWKDException uses error_code 610 by default.""" exc = AppriseWKDException("something went wrong") assert exc.error_code == 610 # --------------------------------------------------------------------------- # zb32_encode # --------------------------------------------------------------------------- def test_zb32_encode_all_zeros(): """20 zero bytes encode to 32 'y' characters (index 0 of the alphabet).""" result = AppriseWKDController.zb32_encode(b"\x00" * 20) assert result == "y" * 32 def test_zb32_encode_all_ones(): """20 0xFF bytes encode to 32 '9' characters (index 31 of the alphabet).""" result = AppriseWKDController.zb32_encode(b"\xff" * 20) assert result == "9" * 32 def test_zb32_encode_sha1_length(): """SHA-1 digest (20 bytes) always produces exactly 32 z-base32 chars.""" import hashlib digest = hashlib.sha1(b"test@example.com").digest() result = AppriseWKDController.zb32_encode(digest) assert len(result) == 32 # All characters must belong to the z-base32 alphabet assert all(c in AppriseWKDController._ZB32 for c in result) def test_zb32_encode_empty(): """Empty input produces an empty string.""" assert AppriseWKDController.zb32_encode(b"") == "" def test_zb32_encode_single_byte(): """Single byte (5 bits + 3 leftover bits) produces 2 characters.""" # 0x00 = 00000 000 -> 'y' then 0x00 << 2 = 00000 -> 'y' result = AppriseWKDController.zb32_encode(b"\x00") assert len(result) == 2 assert result[0] == "y" def test_zb32_encode_known_vector(): """Verify z-base32 encoding against independently computed single-byte reference values. These expected strings are derived from first principles: each 5-bit group maps directly to _ZB32[value], and leftover bits are left-aligned. They do NOT call zb32_encode() to generate the expected string, so a regression in the alphabet or bit-shifting logic will cause at least one assertion to fail. 0xf8 = 11111000: group1 (bits 0-4): 11111 = 31 -> '9' leftover (bits 5-7) << 2: 00000 = 0 -> 'y' 0xa8 = 10101000: group1 (bits 0-4): 10101 = 21 -> 'i' leftover (bits 5-7) << 2: 00000 = 0 -> 'y' 0x08 = 00001000: group1 (bits 0-4): 00001 = 1 -> 'b' leftover (bits 5-7) << 2: 00000 = 0 -> 'y' """ assert AppriseWKDController.zb32_encode(b"\xf8") == "9y" assert AppriseWKDController.zb32_encode(b"\xa8") == "iy" assert AppriseWKDController.zb32_encode(b"\x08") == "by" # --------------------------------------------------------------------------- # wkd_urls # --------------------------------------------------------------------------- def test_wkd_urls_structure(): """wkd_urls() returns properly formed subdomain and direct URLs.""" sub, direct = AppriseWKDController.wkd_urls("user@example.com") assert sub.startswith("https://openpgpkey.example.com/") assert "/.well-known/openpgpkey/example.com/hu/" in sub assert "?l=user" in sub assert direct.startswith("https://example.com/") assert "/.well-known/openpgpkey/hu/" in direct assert "?l=user" in direct def test_wkd_urls_case_normalised(): """wkd_urls() produces the same hash and domain for differently-cased inputs, but preserves the original local-part case in ?l= (RFC 9080). The hash component uses the lower-cased local part (spec requirement), the domain is always lower-cased (URL canonicalisation), and the ?l= query parameter carries the unchanged original local part -- so two addresses that differ only in local-part capitalisation will share the same hash/path but differ in their ?l= value. """ sub_upper, dir_upper = AppriseWKDController.wkd_urls("User@Example.COM") sub_lower, dir_lower = AppriseWKDController.wkd_urls("user@example.com") # Hash and domain parts must be identical assert sub_upper.split("?")[0] == sub_lower.split("?")[0] assert dir_upper.split("?")[0] == dir_lower.split("?")[0] # ?l= must carry the original (unchanged) local part assert "?l=User" in sub_upper assert "?l=user" in sub_lower # Domain is always lower-cased regardless of input assert urlparse(sub_lower).hostname == "openpgpkey.example.com" def test_wkd_urls_l_param_preserves_original_case(): """?l= carries the unchanged local-part per RFC 9080. The spec example: Joe.Doe@Example.ORG -> ?l=Joe.Doe (original case, not lowercased) The hash is computed from the lowercased local part; only ?l= keeps the original capitalisation. """ sub, direct = AppriseWKDController.wkd_urls("Joe.Doe@Example.ORG") assert "?l=Joe.Doe" in sub assert "?l=Joe.Doe" in direct # Domain part is always lowercased in the URL host assert urlparse(sub).hostname == "openpgpkey.example.org" assert urlparse(direct).hostname == "example.org" def test_wkd_urls_local_part_encoded(): """wkd_urls() percent-encodes special characters in the local part.""" sub, direct = AppriseWKDController.wkd_urls("first+last@example.com") assert "first%2Blast" in sub assert "first%2Blast" in direct def test_wkd_urls_no_at_sign(): """wkd_urls() returns (None, None) for an address without '@'.""" sub, direct = AppriseWKDController.wkd_urls("notanemail") assert sub is None assert direct is None def test_wkd_urls_empty_string(): """wkd_urls() returns (None, None) for an empty string.""" sub, direct = AppriseWKDController.wkd_urls("") assert sub is None assert direct is None def test_wkd_urls_empty_local(): """wkd_urls() returns (None, None) when the local part is empty.""" sub, direct = AppriseWKDController.wkd_urls("@example.com") assert sub is None assert direct is None def test_wkd_urls_empty_domain(): """wkd_urls() returns (None, None) when the domain is empty.""" sub, direct = AppriseWKDController.wkd_urls("user@") assert sub is None assert direct is None def test_wkd_urls_none_input(): """wkd_urls() returns (None, None) for None input.""" sub, direct = AppriseWKDController.wkd_urls(None) assert sub is None assert direct is None def test_wkd_urls_non_string_input(): """wkd_urls() returns (None, None) for non-string truthy inputs. Without the isinstance guard, ``"@" not in 123`` raises TypeError before the try/except block can handle it. """ for bad in (123, 12.5, object(), ["user@example.com"]): sub, direct = AppriseWKDController.wkd_urls(bad) assert sub is None assert direct is None def test_wkd_urls_ipv4_domain_rejected(): """wkd_urls() returns (None, None) for emails with an IPv4 domain. WKD is defined for DNS hostnames only (RFC 9080). Allowing IP literals as the domain creates an SSRF vector because WKD discovery turns recipient domains into outbound HTTPS requests. """ for addr in ( "user@127.0.0.1", "user@192.168.1.1", "user@10.0.0.1", ): sub, direct = AppriseWKDController.wkd_urls(addr) assert sub is None, f"Expected None for IP domain: {addr}" assert direct is None, f"Expected None for IP domain: {addr}" def test_wkd_urls_lower_raises_attribute_error(): """wkd_urls() returns (None, None) when email.split() raises. Covers the defensive except branch for string-like objects that pass the '@' membership check but fail during splitting. (After the RFC 9080 case-preservation fix, split() is called before lower(), so breaking split() is what exercises this path.) """ class BrokenStr(str): def split(self, *args, **kwargs): raise AttributeError("broken split") sub, direct = AppriseWKDController.wkd_urls(BrokenStr("user@example.com")) assert sub is None assert direct is None def test_wkd_urls_domain_injection_rejected(): """wkd_urls() returns (None, None) for emails whose domain contains characters that would rewrite the URL host. user@legit.com@attacker.test splits to domain='legit.com@attacker.test' which, when embedded in an HTTPS URL, sends the request to attacker.test with legit.com as URL credentials. The is_hostname() guard rejects it. """ for bad_email in ( "user@example.com@attacker.test", "user@example.com/path", "user@example.com:8080", "user@example.com space", ): sub, direct = AppriseWKDController.wkd_urls(bad_email) assert sub is None, f"Expected None for domain injection: {bad_email}" assert direct is None, ( f"Expected None for domain injection: {bad_email}" ) # --------------------------------------------------------------------------- # AppriseWKDController.fetch -- happy path # --------------------------------------------------------------------------- def _make_resp(status_code, chunks=None, url=None): """Build a context-manager-compatible requests.Response mock. ``chunks`` is a list of byte strings that iter_content() will yield. Pass an empty list for an empty body. Leave as None when the status code is non-200 and the body will never be consumed. ``url`` sets r.url (the final URL after any redirects). When omitted the attribute is a MagicMock, which passes the HTTPS check because MagicMock().lower().startswith() is truthy. """ resp = mock.MagicMock(status_code=status_code) resp.__enter__ = mock.Mock(return_value=resp) resp.__exit__ = mock.Mock(return_value=False) # Default to an empty headers dict so r.headers.get("Content-Length") # returns None; tests that need a specific header override this resp.headers = {} if url is not None: resp.url = url if chunks is not None: resp.iter_content.return_value = iter(chunks) return resp @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_fetch_subdomain_success(mock_get): """fetch() returns key bytes when the subdomain URL responds with 200.""" # 0x99 is a valid old-format OpenPGP packet header byte (bit 7 set) key_bytes = b"\x99fake-openpgp-key-data" # Subdomain call succeeds; iter_content yields the key in one chunk mock_get.return_value = _make_resp(requests.codes.ok, chunks=[key_bytes]) ctrl = AppriseWKDController() result = ctrl.fetch("user@example.com") assert result == key_bytes assert mock_get.call_count == 1 @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_fetch_direct_fallback(mock_get): """fetch() tries the direct URL when the subdomain URL fails.""" key_bytes = b"\x99another-fake-key" # Subdomain -> 404 (body never consumed), direct -> 200 with key bytes mock_get.side_effect = [ _make_resp(404), _make_resp(requests.codes.ok, chunks=[key_bytes]), ] ctrl = AppriseWKDController() result = ctrl.fetch("user@example.com") assert result == key_bytes assert mock_get.call_count == 2 @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_fetch_both_fail(mock_get): """fetch() returns None when both WKD URLs fail.""" mock_get.return_value = _make_resp(404) ctrl = AppriseWKDController() result = ctrl.fetch("user@example.com") assert result is None assert mock_get.call_count == 2 # --------------------------------------------------------------------------- # fetch -- cache behaviour # --------------------------------------------------------------------------- @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_fetch_caches_result(mock_get): """A successful fetch is cached; subsequent calls skip the network.""" key_bytes = b"\x99cached-key" mock_get.return_value = _make_resp(requests.codes.ok, chunks=[key_bytes]) ctrl = AppriseWKDController() result1 = ctrl.fetch("user@example.com") result2 = ctrl.fetch("user@example.com") assert result1 == key_bytes assert result2 == key_bytes # Network only hit once assert mock_get.call_count == 1 @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_fetch_cache_case_insensitive(mock_get): """Cache lookup normalises the email address.""" key_bytes = b"\x99normalised-key" mock_get.return_value = _make_resp(requests.codes.ok, chunks=[key_bytes]) ctrl = AppriseWKDController() ctrl.fetch("User@Example.COM") result = ctrl.fetch("user@example.com") assert result == key_bytes assert mock_get.call_count == 1 @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_fetch_expired_cache_refetches(mock_get): """An expired cache entry triggers a new network request.""" key_bytes = b"\x99refreshed-key" mock_get.return_value = _make_resp(requests.codes.ok, chunks=[key_bytes]) ctrl = AppriseWKDController() # Seed the cache with an already-expired entry ctrl._cache["user@example.com"] = { "data": b"stale-key", "expires": datetime.now(timezone.utc) - timedelta(seconds=1), } result = ctrl.fetch("user@example.com") assert result == key_bytes assert mock_get.call_count == 1 # --------------------------------------------------------------------------- # fetch -- invalid input # --------------------------------------------------------------------------- def test_fetch_no_at_sign(): """fetch() returns None for an address without '@'.""" ctrl = AppriseWKDController() assert ctrl.fetch("notanemail") is None def test_fetch_empty_string(): """fetch() returns None for an empty string.""" ctrl = AppriseWKDController() assert ctrl.fetch("") is None def test_fetch_none(): """fetch() returns None when called with None.""" ctrl = AppriseWKDController() assert ctrl.fetch(None) is None def test_fetch_non_string_input(): """fetch() returns None for non-string truthy inputs. Without the isinstance guard, ``"@" not in 123`` raises TypeError before the method can return None for invalid input. """ ctrl = AppriseWKDController() for bad in (123, 12.5, object(), ["user@example.com"]): assert ctrl.fetch(bad) is None def test_fetch_at_only(): """fetch() returns None for '@' (empty local and empty domain). '@' passes the '@' membership check but wkd_urls() returns (None, None) because both local and domain parts are empty -- covers the guard at the second validation point inside fetch(). """ ctrl = AppriseWKDController() assert ctrl.fetch("@") is None # --------------------------------------------------------------------------- # _get -- response validation # --------------------------------------------------------------------------- @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_non_200_returns_none(mock_get): """_get() returns None for any non-200 HTTP status.""" for code in (301, 400, 403, 404, 500): mock_get.return_value = _make_resp(code) ctrl = AppriseWKDController() assert ctrl._get("https://example.com/key") is None @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_empty_body_returns_none(mock_get): """_get() returns None when the response body is empty.""" mock_get.return_value = _make_resp(requests.codes.ok, chunks=[]) ctrl = AppriseWKDController() assert ctrl._get("https://example.com/key") is None @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_empty_chunk_is_skipped(mock_get): """_get() skips empty bytestrings yielded by iter_content(). Some HTTP adapters yield b"" sentinel chunks between real chunks; the in-loop ``if not chunk: continue`` guard must skip them so they do not corrupt the accumulated content or trigger a false empty-body result. """ # Interleave an empty sentinel before a valid PGP binary chunk key_bytes = b"\x99" + b"\x00" * 8 mock_get.return_value = _make_resp( requests.codes.ok, chunks=[b"", key_bytes] ) ctrl = AppriseWKDController() result = ctrl._get("https://example.com/key") assert result == key_bytes @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_oversized_via_content_length_returns_none(mock_get): """_get() rejects early when Content-Length already exceeds the limit. iter_content() must not be called at all -- we detect the oversize from the header before reading any bytes. """ ctrl = AppriseWKDController() resp = _make_resp(requests.codes.ok) resp.headers = {"Content-Length": str(ctrl.max_response_size + 1)} mock_get.return_value = resp assert ctrl._get("https://example.com/key") is None resp.iter_content.assert_not_called() @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_valid_content_length_within_limit_proceeds(mock_get): """_get() proceeds to read chunks when Content-Length is within the limit. This exercises the branch where content_length is not None and the parsed value does not exceed max_response_size. """ key_bytes = b"\x99valid-key" resp = _make_resp(requests.codes.ok, chunks=[key_bytes]) resp.headers = {"Content-Length": str(len(key_bytes))} mock_get.return_value = resp ctrl = AppriseWKDController() assert ctrl._get("https://example.com/key") == key_bytes @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_malformed_content_length_proceeds(mock_get): """_get() ignores a malformed Content-Length and reads chunks normally.""" key_bytes = b"\x99valid-key" resp = _make_resp(requests.codes.ok, chunks=[key_bytes]) resp.headers = {"Content-Length": "not-a-number"} mock_get.return_value = resp ctrl = AppriseWKDController() assert ctrl._get("https://example.com/key") == key_bytes @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_oversized_body_returns_none(mock_get): """_get() returns None when accumulated chunks exceed max_response_size.""" ctrl = AppriseWKDController() # Single chunk one byte over the limit triggers the in-loop guard oversized = b"\x99" + b"x" * ctrl.max_response_size mock_get.return_value = _make_resp(requests.codes.ok, chunks=[oversized]) assert ctrl._get("https://example.com/key") is None @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_non_pgp_body_returns_none(mock_get): """_get() returns None when the response body is not PGP data. A subdomain endpoint that is a parked domain or CDN may return HTTP 200 with HTML content. Without this guard, fetch() would cache the HTML bytes and never try the direct-method fallback URL. """ for non_pgp in ( b"Not a key", b"", b"{}", b"Not PGP data", ): mock_get.return_value = _make_resp(requests.codes.ok, chunks=[non_pgp]) ctrl = AppriseWKDController() assert ctrl._get("https://example.com/key") is None, ( f"Expected None for non-PGP content: {non_pgp[:20]}" ) @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_binary_pgp_packet_accepted(mock_get): """_get() accepts a response whose first byte has bit 7 set (OpenPGP binary packet format).""" # 0x99 is the old-format public-key packet header pgp_binary = b"\x99\x01\xd6" + b"\x00" * 100 mock_get.return_value = _make_resp(requests.codes.ok, chunks=[pgp_binary]) ctrl = AppriseWKDController() assert ctrl._get("https://example.com/key") == pgp_binary @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_ascii_armoured_key_accepted(mock_get): """_get() accepts ASCII-armoured PGP key material (starts with '-----').""" armoured = b"-----BEGIN PGP PUBLIC KEY BLOCK-----\n..." mock_get.return_value = _make_resp(requests.codes.ok, chunks=[armoured]) ctrl = AppriseWKDController() assert ctrl._get("https://example.com/key") == armoured @mock.patch( "apprise.utils.http.HTTPPolicySession.get", side_effect=requests.RequestException("timeout"), ) def test_get_request_exception_returns_none(mock_get): """_get() returns None when requests raises any RequestException.""" ctrl = AppriseWKDController() assert ctrl._get("https://example.com/key") is None @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_stream_oserror_returns_none(mock_get): """_get() returns None when iter_content() raises OSError mid-stream. Covers disk-full, connection-reset, and other IO-level failures that surface after the HTTP headers have been received successfully. """ resp = _make_resp(requests.codes.ok) resp.iter_content.side_effect = OSError("connection reset by peer") mock_get.return_value = resp ctrl = AppriseWKDController() assert ctrl._get("https://example.com/key") is None @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_stream_generic_exception_returns_none(mock_get): """_get() returns None when iter_content() raises an unexpected exception. Covers urllib3 IncompleteRead, read-timeout mid-stream, and any other exception not otherwise categorised. """ resp = _make_resp(requests.codes.ok) resp.iter_content.side_effect = Exception("unexpected streaming error") mock_get.return_value = resp ctrl = AppriseWKDController() assert ctrl._get("https://example.com/key") is None @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_http_redirect_rejected(mock_get): """_get() returns None when a redirect lands on a non-HTTPS URL. A redirect from HTTPS to HTTP would expose key material to interception and break the WKD trust model. """ resp = _make_resp( requests.codes.ok, chunks=[b"\x99key"], url="http://attacker.example.com/hu/abc", ) mock_get.return_value = resp ctrl = AppriseWKDController() assert ctrl._get("https://example.com/key") is None @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_success_returns_bytes(mock_get): """_get() returns the response bytes on HTTP 200 with content.""" payload = b"\x99\xaa\xbb\xcc" mock_get.return_value = _make_resp(requests.codes.ok, chunks=[payload]) ctrl = AppriseWKDController() assert ctrl._get("https://example.com/key") == payload # --------------------------------------------------------------------------- # prune # --------------------------------------------------------------------------- def test_prune_removes_expired_entries(): """prune() discards entries whose expiry has passed.""" ctrl = AppriseWKDController() now = datetime.now(timezone.utc) ctrl._cache["expired@example.com"] = { "data": b"old", "expires": now - timedelta(seconds=1), } ctrl._cache["fresh@example.com"] = { "data": b"new", "expires": now + timedelta(seconds=3600), } ctrl.prune() assert "expired@example.com" not in ctrl._cache assert "fresh@example.com" in ctrl._cache def test_prune_empty_cache(): """prune() does not raise when the cache is empty.""" ctrl = AppriseWKDController() ctrl.prune() # must not raise assert ctrl._cache == {} # --------------------------------------------------------------------------- # Constructor defaults # --------------------------------------------------------------------------- def test_defaults(): """AppriseWKDController initialises with expected default values.""" ctrl = AppriseWKDController() assert ctrl.verify_certificate is True assert ctrl.request_timeout == (4, 4) assert ctrl.allow_redirects is True assert ctrl._cache == {} def test_custom_timeout_and_verify(): """Constructor stores custom timeout and verify_certificate values.""" ctrl = AppriseWKDController( verify_certificate=False, request_timeout=(2, 10) ) assert ctrl.verify_certificate is False assert ctrl.request_timeout == (2, 10) def test_custom_allow_redirects(): """Constructor stores a custom allow_redirects value.""" ctrl = AppriseWKDController(allow_redirects=False) assert ctrl.allow_redirects is False def test_close_releases_session_once(): """Explicit cleanup closes and clears the owned HTTP session once.""" ctrl = AppriseWKDController() session = mock.Mock() ctrl.http_session = session ctrl.close() ctrl.close() session.close.assert_called_once_with() assert ctrl.http_session is None def test_close_clears_session_when_close_raises(): """A failed explicit close still leaves later cleanup harmless.""" ctrl = AppriseWKDController() session = mock.Mock() session.close.side_effect = RuntimeError("close failed") ctrl.http_session = session with pytest.raises(RuntimeError, match="close failed"): ctrl.close() assert ctrl.http_session is None def test_context_manager_closes_session(): """The context-manager lifecycle closes its session on exit.""" ctrl = AppriseWKDController() session = mock.Mock() ctrl.http_session = session with ctrl as entered: assert entered is ctrl session.close.assert_called_once_with() assert ctrl.http_session is None def test_destructor_suppresses_close_failure(): """Fallback cleanup cannot leak a session close exception.""" ctrl = object.__new__(AppriseWKDController) ctrl.http_session = mock.Mock() ctrl.http_session.close.side_effect = RuntimeError("close failed") ctrl.__del__() assert ctrl.http_session is None @mock.patch("apprise.utils.http.HTTPPolicySession.get") def test_get_passes_verify_and_timeout(mock_get): """_get() forwards verify_certificate, request_timeout, allow_redirects, and stream=True to requests.""" mock_get.return_value = _make_resp(requests.codes.ok, chunks=[b"\x99key"]) ctrl = AppriseWKDController( verify_certificate=False, request_timeout=(1, 5), allow_redirects=False ) ctrl._get("https://example.com/key") _, kwargs = mock_get.call_args assert kwargs["verify"] is False assert kwargs["timeout"] == (1, 5) assert kwargs["allow_redirects"] is False assert kwargs["stream"] is True caronc-apprise-dfec414/tests/test_utils_xml.py000066400000000000000000000156001526720371000217140ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. import sys from apprise.utils.xml import flatten_xml_response KEEP_MAP = { "RequestId": "request_id", "MessageId": "message_id", } def test_flatten_xml_response_extracts_mapped_tags(): """Tags listed in keep_map are pulled out under their mapped key.""" response = flatten_xml_response( """ abc-123 req-456 """, KEEP_MAP, ) assert response["type"] == "PublishResponse" assert response["message_id"] == "abc-123" assert response["request_id"] == "req-456" def test_flatten_xml_response_repeated_tag_keeps_last_value(): """Repeated mapped tags retain the last value in document order.""" response = flatten_xml_response( "" "first" "last" "", KEEP_MAP, ) assert response["request_id"] == "last" def test_flatten_xml_response_strips_root_namespace(): """A namespace on the root tag doesn't stop tags from being matched.""" response = flatten_xml_response( '' "req-456" "", KEEP_MAP, ) assert response["type"] == "PublishResponse" assert response["request_id"] == "req-456" def test_flatten_xml_response_empty_known_tag_is_blank_not_a_crash(): """A self-closed or empty known tag yields "" instead of raising. has no .text at all (it's None), and the old implementation called .strip() on that None directly. """ response = flatten_xml_response( "", {"Message": "error_message"}, ) assert response["type"] == "ErrorResponse" assert response["error_message"] == "" def test_flatten_xml_response_whitespace_only_tag_is_blank(): """A tag containing only whitespace is trimmed down to an empty string, same as an empty tag.""" response = flatten_xml_response( " ", {"Message": "error_message"}, ) assert response["error_message"] == "" def test_flatten_xml_response_survives_deeply_nested_xml(): """A response nested far past Python's default recursion limit still parses instead of raising a RecursionError. The old implementation walked the tree with a recursive helper, so one recursive call was made per level of nesting. """ depth = sys.getrecursionlimit() + 1000 xml = ("" * depth) + "leaf-value" + ("" * depth) response = flatten_xml_response(xml, {"a": "value"}) assert response["type"] == "a" assert response["value"] == "leaf-value" def test_flatten_xml_response_invalid_xml_returns_defaults(): """Malformed XML falls back to the defaults instead of raising.""" response = flatten_xml_response( "", KEEP_MAP, defaults={"request_id": None} ) assert response["type"] is None assert response["request_id"] is None def test_flatten_xml_response_non_string_input_returns_defaults(): """A non-string response (e.g. None, after a connection failure) falls back to the defaults instead of raising.""" response = flatten_xml_response( None, KEEP_MAP, defaults={"request_id": None} ) assert response["type"] is None assert response["request_id"] is None def test_flatten_xml_response_defaults_not_mutated(): """The defaults dictionary passed in is never modified in place.""" defaults = {"request_id": None} response = flatten_xml_response( "req-456", KEEP_MAP, defaults=defaults, ) assert defaults == {"request_id": None} assert response["request_id"] == "req-456" def test_flatten_xml_response_unmapped_tags_are_ignored(): """Tags that aren't listed in keep_map are left out of the result.""" response = flatten_xml_response( "ignored", KEEP_MAP, ) assert "Extra" not in response assert "extra" not in response def test_flatten_xml_response_rejects_a_dtd(): """A response carrying a DTD is refused before entities expand.""" response = flatten_xml_response( """ ]> &e;""", KEEP_MAP, defaults={"message_id": None}, ) assert response["type"] is None assert response["message_id"] is None def test_flatten_xml_response_truncated_xml_returns_defaults(): """A response that ends early contributes nothing, not a partial read.""" response = flatten_xml_response( "req-456", KEEP_MAP, defaults={"request_id": None}, ) assert response["type"] is None assert response["request_id"] is None caronc-apprise-dfec414/tests/test_utils_yaml.py000066400000000000000000000110261526720371000220540ustar00rootroot00000000000000# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2026, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. """Tests for the small YAML/template inspection boundary.""" import pytest from apprise.utils.parse import QSD_FULL_MODE_KEYS from apprise.utils.template import TemplatePlaceholderMap, TemplateSchema from apprise.utils.yaml import ( dropped_template, template_in_schema, template_references, templated_tag, ) def placeholders(*names): """Create the same placeholder map used while parsing YAML URLs.""" return TemplatePlaceholderMap(TemplateSchema.parse(list(names)), "") def test_yaml_template_references_walks_values_and_url_keys_once(): """Scan supported containers without treating names as values.""" loop = [] loop.append(loop) shared = ("${TUPLE}",) value = [ None, 7, "${PLAIN} and malformed ${NO-DASH}", { "json://${HOST}/": { "+${LITERAL_KEY}": "${VALUE}", "nested": shared, }, "ordinary": shared, }, {"${SET}"}, loop, ] assert template_references(value) == { "plain", "host", "value", "tuple", "set", } @pytest.mark.parametrize( ("url", "declared", "expected"), [ (None, {"t"}, None), ("json://host/${T}", {"t"}, None), ("${OTHER}://host/", {"t"}, None), ("${T}://host/", {"t"}, "t"), ("json${T}://host/", ("t",), "t"), ("${T}user:pass@host/", {"t"}, "t"), ("${T}/path://later", {"t"}, "t"), ("${T}localhost/?url=http://bad.actor.com", {"t"}, "t"), (r"abc${T}s\://localhost", {"t"}, "t"), ("json://host/${T}://later", {"t"}, None), ], ) def test_yaml_template_schema_boundary(url, declared, expected): """Only declared markers at or before the schema boundary are refused.""" assert template_in_schema(url, declared) == expected def test_yaml_dropped_template_reports_stable_missing_name(): """Parser loss is detected without considering the saved source URL.""" mapping = placeholders("a", "b") url = mapping.encode_url("json://user:${B}@host/${A}") assert dropped_template(url, {}, None) is None assert dropped_template(url, {"path": url}, mapping) is None assert ( dropped_template( url, { "url": url, "password": mapping.encode("${B}"), }, mapping, ) == "a" ) @pytest.mark.parametrize("bucket", ("qsd", *QSD_FULL_MODE_KEYS)) def test_yaml_templated_tag_ignores_url_values(bucket): """A tag in the URL query belongs to the plugin and is allowed.""" mapping = placeholders("t") assert not templated_tag( {bucket: {"tag": mapping.encode("${T}")}}, mapping ) def test_yaml_templated_tag_handles_encoded_and_global_values(): """Per-service placeholders and raw global tags are both detected.""" mapping = placeholders("t") assert templated_tag({"tag": {mapping.encode("${T}")}}, mapping) assert templated_tag({"tag": {"${T}"}}, mapping) assert not templated_tag({"qsd": None, "tag": {"${OTHER}"}}, mapping) assert not templated_tag([], mapping) assert not templated_tag({"tag": set()}, None) caronc-apprise-dfec414/tests/var/000077500000000000000000000000001526720371000170515ustar00rootroot00000000000000caronc-apprise-dfec414/tests/var/01_test_example.html000066400000000000000000000036401526720371000227340ustar00rootroot00000000000000 Bootstrap 101 Template

    My Title

    Heading 1

    • Bullet 1
    • Bullet 2
    • Bullet 3
    1. Bullet 1
    2. Bullet 2
    3. Bullet 3

    Heading 2

    A div entry

    A div entry 

    print('hello')

    Heading 3

    Heading 4

    Heading 5
    Heading 6

    A set of text
    Another line after the set of text

    More text 

    •  keeps its line breaks and indentation, and only
            # its line break style is normalized.
            content = (
                data.replace("\r\n", "\n").replace("\r", "\n")
                if self._pre_depth
                else self.WS_TRIM.sub(" ", data)
            )

            # Preserve the normalized fragment for final assembly.
            self._result.append(content)

    def handle_starttag(self, tag, attrs):
        """Process our starting HTML Tag."""

        # Toggle storage according to the newly opened container.
        self._do_store = tag not in self.IGNORE_TAGS

        # Track entry into preformatted text.
        if tag == "pre":
            self._pre_depth += 1

        # Start block elements on a fresh output line.
        if tag in self.BLOCK_TAGS:
            self._result.append(self.BLOCK_END)

        # Prefix each list item with a plain-text bullet.
        if tag == "li":
            self._result.append("- ")

        # Preserve explicit HTML line breaks.
        elif tag == "br":
            self._result.append("\n")

        # Render horizontal rules on their own line.
        elif tag == "hr":
            # Remove spacing that would precede the rule.
            if self._result and isinstance(self._result[-1], str):
                self._result[-1] = self._result[-1].rstrip(" ")

            self._result.append("\n---\n")

        # Mark the start of quoted plain text.
        elif tag == "blockquote":
            self._result.append(" >")

    def handle_endtag(self, tag):
        """Edge case handling of open/close tags."""

        # Resume storage after leaving an ignored container.
        self._do_store = True

        # Track the exit from preformatted text.
        if tag == "pre" and self._pre_depth:
            self._pre_depth -= 1

        # Close block elements with a line boundary.
        if tag in self.BLOCK_TAGS:
            self._result.append(self.BLOCK_END)


class HTMLMarkdownConverter(HTMLConverter):
    """Convert HTML to notification-friendly CommonMark.

    Plugins may adapt this output to their own Markdown dialects.
    """

    # Define tags that create Markdown block boundaries.
    BLOCK_TAGS = frozenset(
        {
            "p",
            "h1",
            "h2",
            "h3",
            "h4",
            "h5",
            "h6",
            "div",
            "td",
            "th",
            "pre",
            "samp",
            "label",
            "li",
        }
    )

    # Paragraph-like blocks need blank-line separation in CommonMark.
    _PARA_LIKE_TAGS = frozenset({"p", "div", "td", "th", "label"})

    # Reuse a plain paragraph boundary outside blockquotes.
    PARA_BREAK = _ParaBreak()

    # Escape characters that could become inline Markdown.
    MARKDOWN_ESCAPE = re.compile(
        r"([\\`*_~#\[\]()!<>])", re.DOTALL | re.MULTILINE
    )

    # Block syntax only needs escaping at the start of a line.
    _ORDERED_MARKER_RE = re.compile(r"^\d+\.(?=[ \t]|$)")

    # Match bullet markers at the start of a line.
    _BULLET_MARKER_RE = re.compile(r"^[-+](?=[ \t]|$)")

    # Match thematic breaks and setext heading underlines.
    # Uses separate alternates (no backreference) to avoid ReDoS on
    # inputs like "- - - - - - - - ... -x".
    _THEMATIC_BREAK_RE = re.compile(r"^(?:-[ \t]*){3,}$|^(?:=[ \t]*){3,}$")

    # Collapse ASCII whitespace when flattening table cells.
    _CELL_WHITESPACE_RUN = re.compile(r"[ \t\r\f\v]+")

    # Escape angle-bracket link destinations.
    HREF_ESCAPE = re.compile(r"([\\<>])")

    # Remove ASCII controls, Unicode format/zero-width characters, and
    # BiDi override/embedding controls that browsers silently discard during
    # URL parsing.  These characters can be prepended to a dangerous scheme
    # (e.g. U+200B before "javascript:") or used to visually reverse a URL
    # (e.g. U+202E before "javascript:") so they appear safe on screen while
    # containing an exploitable scheme once the override is decoded.
    _HREF_CONTROL_CHARS = re.compile(
        "[\x00-\x1f\x7f\u00ad\u200b-\u200f\u2028-\u202e\u2066-\u2069\ufeff]"
    )

    # Detect URI schemes before sanitizing links.
    _HREF_SCHEME = re.compile(r"^([a-zA-Z][a-zA-Z0-9+.-]*):")

    # Block executable and local URI schemes while allowing app links.
    # "blob" is included because blob: URLs can carry arbitrary payloads.
    _UNSAFE_HREF_SCHEMES = frozenset(
        {"javascript", "vbscript", "data", "file", "blob"}
    )

    # Trim ASCII whitespace without removing deliberate non-breaking spaces.
    _ASCII_WHITESPACE = " \t\n\r\x0b\x0c"

    def __init__(self, **kwargs):
        """Initialize the HTML-to-Markdown converter."""

        # Initialize the base converter
        super().__init__(**kwargs)

        # Cache indentation by list depth.
        self._indent_cache = [""]

        # Cache prefixes by blockquote depth.
        self._quote_prefix_cache = [""]

        # Track open tags for constant-time unmatched-close checks.
        self._tag_open_counts = {}

        # Track whether the current frame emitted real content.
        self._content_seq = 0

        # Context stack.  The sentinel root frame at index 0 is never
        # popped and represents top-level content outside every tag.
        # Each frame is a dict with these keys:
        #   tag         -- str|None  tag that opened this frame
        #   do_store    -- bool      store text nodes encountered here?
        #   preserve_cr -- bool      keep whitespace literally (pre/code)?
        #   list_type   -- str|None  'ul', 'ol', or None
        #   depth       -- int       list nesting depth (1 = outermost),
        #                            clamped to LIST_DEPTH_MAX
        #   counter     -- int|None  next item number for 'ol' lists
        #   list_do_store -- bool    do_store of the list's own parent
        #                            (the nearest non-ul/ol/li ancestor),
        #                            saved here when the ul/ol is pushed
        #                            so 
  •  can read it directly instead
        #                            of walking back up the stack
        #   quote_depth -- int       blockquote nesting depth (1 = outermost),
        #                            clamped to BLOCKQUOTE_DEPTH_MAX; 0
        #                            means "not inside a blockquote"
        #   list_indent -- str       spaces a continuation line needs to
        #                            stay part of the current 
  •  --
        #                            "" outside any list. Combined with
        #                            quote_depth's "> " (in whichever
        #                            order they were actually nested)
        #                            by _write_boundary() for any line
        #                            that needs to restate it.
        #   list_indent_base -- str  list_indent from *outside* the
        #                            entire list-nesting chain (e.g.
        #                            from an enclosing 
    ) --
        #                            captured once where that chain
        #                            starts (depth 0 -> 1) and inherited
        #                            unchanged by every level nested
        #                            inside it after that. 
  •  adds
        #                            only its own marker's width on top
        #                            of *this*, not the immediately
        #                            enclosing list's full list_indent,
        #                            since that would double-count: a
        #                            nested marker's own leading spaces
        #                            (from _indent(depth)) already cover
        #                            every outer list level's width.
        #   href        -- str|None  href of an enclosing  tag; set
        #                            only on frames pushed by 
        #   buffer      -- list[str] raw text accumulated inside a
        #                            code/pre/samp frame; only present
        #                            on frames pushed by those tags --
        #                            the matching close tag needs the
        #                            full text up front to size a
        #                            delimiter that cannot collide with
        #                            backticks already in the content
        # The root frame gives every child a complete set of settings.
        self._stack = [default_frame()]

    def _make_frame(self, tag, **overrides):
        """Create a frame from the current context."""

        # Use defaults only if a caller cleared the normal root frame.
        parent = self._stack[-1] if self._stack else default_frame()
        # Build the new frame by inheriting all context keys from the parent.
        # Callers pass **overrides to replace only the keys they need changed.
        frame = {
            "tag": tag,
            "do_store": parent["do_store"],
            "preserve_cr": parent["preserve_cr"],
            "list_type": parent["list_type"],
            "depth": parent["depth"],
            "counter": parent["counter"],
            "list_do_store": parent["list_do_store"],
            "quote_depth": parent["quote_depth"],
            "list_indent": parent["list_indent"],
            "list_indent_base": parent["list_indent_base"],
        }

        # Apply caller-supplied overrides on top of the inherited defaults.
        frame.update(overrides)
        return frame

    def _indent(self, depth):
        """Return cached indentation for a list depth."""

        # Depth 1 is the outermost level and needs no indentation,
        # so shift by one: depth 1 -> index 0 (empty string).
        idx = max(depth - 1, 0)

        # Work against the shared per-instance indentation cache.
        cache = self._indent_cache

        # Extend the cache on demand -- each level adds two spaces.
        while len(cache) <= idx:
            cache.append(cache[-1] + "  ")

        return cache[idx]

    def _quote_prefix(self, depth):
        """Return the prefix for a quote depth."""

        # Clamp negative depths to zero (should not occur in practice).
        idx = max(depth, 0)

        # Work against the shared per-instance quote-prefix cache.
        cache = self._quote_prefix_cache

        # Extend the cache on demand -- each nesting level prepends "> ".
        while len(cache) <= idx:
            cache.append(_QuoteMarker(cache[-1] + "> "))

        return cache[idx]

    def _continuation_prefix(self, ctx):
        """Return the prefix that any continuation line must carry."""

        # Start with whatever list indentation this context inherited.
        prefix = ctx["list_indent"]

        # If we are inside a blockquote, append its ">" leader as well.
        if ctx["quote_depth"]:
            prefix += self._quote_prefix(ctx["quote_depth"])

        return prefix

    def _write_boundary(self, ctx, strong=False):
        """Append a line break or a nesting-aware paragraph break."""

        # Compute the prefix that any following line must carry.
        prefix = self._continuation_prefix(ctx)

        if not strong:
            # Weak boundary -- a single line break in the output.
            self._result.append(self.BLOCK_END)

            # Restate any active quote or list prefix so the next
            # content line opens inside the correct nesting context.
            if prefix:
                self._result.append(
                    _QuoteMarker(prefix)
                    if ctx["quote_depth"]
                    else _ListIndent(prefix)
                )

            # The ordinary boundary is complete; nothing more to do.
            return

        # Strong boundary -- blank-line paragraph separation.
        if prefix:
            # Carry nesting context into the paragraph break so _finalize()
            # can restate it on the first line of the next paragraph.
            self._result.append(
                _ParaBreak(prefix, in_quote=bool(ctx["quote_depth"]))
            )

        else:
            # No active nesting -- use the cached bare paragraph break.
            self._result.append(self.PARA_BREAK)

    def _open_line_boundary(self, ctx, strong=False):
        """Start a block unless a structural marker owns the line."""

        if self._result and isinstance(self._result[-1], _Marker):
            # A structural marker is already on the line -- suppress the
            # boundary so the block content follows it directly.
            return

        self._write_boundary(ctx, strong=strong)

    def _emit(self, text):
        """Append content and advance the empty-span sequence counter."""

        self._result.append(text)

        # Each emission is a unique sequence point; comparing the counter
        # value at open-time vs. close-time reveals whether the frame was
        # empty without scanning the result buffer.
        self._content_seq += 1

    def _push_frame(self, frame):
        """Push a frame, returning whether the depth limit accepted it.

        ``True`` means the frame and tag counter were stored. ``False`` means
        the depth cap rejected it. Delimiter-producing callers must emit only
        after a successful push or their Markdown would remain unmatched.
        """

        # Reject excessive nesting without emitting unmatched delimiters.
        if len(self._stack) >= MAX_FRAME_DEPTH:
            return False

        # Add the frame to the context stack.
        self._stack.append(frame)

        # Maintain a per-tag count of currently open frames so that
        # _pop_to() can reject unmatched closing tags in O(1).
        tag = frame["tag"]
        self._tag_open_counts[tag] = self._tag_open_counts.get(tag, 0) + 1

        return True

    def _pop_to(self, tag):
        """Pop through the nearest match and report whether one existed."""

        # Reject unmatched closing tags without scanning the stack
        if not self._tag_open_counts.get(tag):
            return False

        # Search backward for the nearest matching frame
        for i in range(len(self._stack) - 1, 0, -1):
            if self._stack[i]["tag"] == tag:
                # Keep tag counts synchronized with removed frames.
                for frame in self._stack[i:]:
                    self._tag_open_counts[frame["tag"]] -= 1

                del self._stack[i:]
                return True

        return False

    def _close_emphasis_frame(self, frame):
        """Close an emphasis frame, dropping it if it collected no content."""

        # Compare the global emission counter now vs. when the frame opened;
        # any difference means at least one _emit() was called inside the span.
        has_content = self._content_seq != frame.get(
            "content_seq_at_open", self._content_seq
        )

        if not has_content:
            # The span opened but collected nothing -- erase from the opening
            # delimiter onward so we do not emit an empty ** or * pair.
            del self._result[frame["emphasis_result_start"] :]
            return

        # CommonMark requires that the closing delimiter not be preceded by
        # whitespace.  Relocate any trailing whitespace to after the delimiter.
        trailing = ""
        while self._result and type(self._result[-1]) is str:
            last = self._result[-1]
            rstripped = last.rstrip(self._ASCII_WHITESPACE)

            # This fragment has no trailing whitespace -- stop scanning.
            if rstripped == last:
                break

            # Accumulate trailing whitespace in front-to-back order.
            trailing = last[len(rstripped) :] + trailing

            if rstripped:
                # Replace the fragment with its trimmed version and stop.
                self._result[-1] = rstripped
                break

            # The entire fragment was whitespace -- remove it and keep going.
            self._result.pop()

        # Emit the closing delimiter (e.g. "**" or "*").
        self._emit(frame["emphasis_delim"])

        # Re-append any whitespace that was after the span content so it
        # falls outside the closed delimiter.
        if trailing:
            self._result.append(trailing)

    @staticmethod
    def _escape_cell_pipes(text):
        """Escape cell delimiters outside CommonMark code spans."""

        # Accumulate escaped fragments without rebuilding the output string.
        out = []

        # Initialize the single-pass scanner.
        i = 0
        n = len(text)

        # Index code delimiters before inspecting table separators.
        backtick_runs = commonmark_index_backtick_runs(text)

        while i < n:
            ch = text[i]

            # Keep escape pairs intact so a backslash-escaped "|" does not
            # trigger an extra escape on the next pass.
            if ch == "\\" and i + 1 < n:
                out.append(text[i : i + 2])
                i += 2
                continue

            if ch == "`":
                j = i
                # Measure the backtick run length.
                while j < n and text[j] == "`":
                    j += 1
                run = j - i

                # Find the matching closing run of the same length.
                close = commonmark_find_backtick_run(backtick_runs, j, run)
                if close is not None:
                    # Inside a code span, "|" is a literal character --
                    # copy the entire span verbatim without escaping.
                    out.append(text[i : close + run])
                    i = close + run
                    continue

                # No matching close -- not a code span; preserve the
                # raw backticks and let the outer Markdown renderer see them.
                out.append(text[i:j])
                i = j
                continue

            if ch == "|":
                # Outside code spans, "|" is a Markdown table delimiter --
                # escape it so it does not break the table structure.
                out.append("\\|")
                i += 1
                continue

            # All other characters are safe to pass through unchanged.
            out.append(ch)
            i += 1

        # Publish the escaped cell content.
        return "".join(out)

    def _close_cell_frame(self, frame):
        """Capture a completed table cell and store its text."""

        # Splice out all result tokens written since this cell was opened.
        start = frame["cell_result_start"]
        chunk = self._result[start:]
        del self._result[start:]

        if not frame["do_store"]:
            # This cell belongs to a suppressed or nested table -- discard it
            # so we do not emit empty cells or corrupt the outer table.
            return

        # Finalize the buffered tokens into a plain string and strip edges.
        text = "".join(self._finalize(chunk)).strip(self._ASCII_WHITESPACE)

        # CommonMark table cells must live on a single source line.
        # Collapse embedded newlines to spaces and then normalize runs.
        if "\n" in text:
            text = " ".join(text.split("\n"))
            text = self._CELL_WHITESPACE_RUN.sub(" ", text).strip(
                self._ASCII_WHITESPACE
            )

        # Escape cell delimiters except where code spans make them literal.
        if "|" in text:
            text = self._escape_cell_pipes(text)

        # Add the completed value to its enclosing row.
        self._stack[-1]["cells"].append(text)

    def _close_pre_frame(self, ctx, tag):
        """Render a completed code/pre/samp frame's buffered content."""

        # Join the buffered literal content
        content = "".join(ctx.get("buffer", ()))

        # Size the delimiter beyond any embedded backtick run
        run = self._longest_backtick_run(content)

        if tag == "code":
            # Inline code uses a delimiter wider than its content.
            # CommonMark requires padding around edge backticks.
            delim = "`" * (run + 1)
            pad = (
                " "
                if not content or content[0] == "`" or content[-1] == "`"
                else ""
            )

            self._emit(delim + pad + content + pad + delim)
            return

        # Fenced block -- widen the fence past the longest run of
        # backticks already present in the content
        fence = "`" * max(3, run + 1)

        # Restate list and quote prefixes on every fenced-block line.
        prefix = self._continuation_prefix(ctx)

        # Prefix every fenced line inside a list or quote
        if prefix:
            marker = (
                _QuoteMarker(prefix)
                if ctx["quote_depth"]
                else _ListIndent(prefix)
            )
            content = ("\n" + prefix).join(content.split("\n"))

        # Emit the opening fence and terminate its line.
        self._emit(fence)
        self._result.append(self.BLOCK_END)

        # Restate nesting before the code content
        if prefix:
            self._result.append(marker)

        # Emit the literal code body and terminate its final line.
        self._emit(content)
        self._result.append(self.BLOCK_END)

        # Restate nesting before the closing fence
        if prefix:
            self._result.append(marker)

        # Emit the closing fence and restore a block boundary.
        self._emit(fence)
        self._result.append(self.BLOCK_END)

    def _close_row_frame(self, frame):
        """Render a completed table row as a Markdown pipe-table line."""

        # Retrieve the cells collected while the row was open.
        cells = frame["cells"]

        if not cells:
            # An entirely empty row (no cells at all) is not useful -- drop it.
            return

        # Retrieve the enclosing table frame, if one exists.
        table = frame.get("table_frame")

        # The first row of a table is treated as the header row; CommonMark
        # requires a separator line of dashes ("---") immediately after it.
        is_header = table is None or table["table_rows"] == 0

        if table is not None:
            # Count this row so that subsequent rows know they are not headers.
            table["table_rows"] += 1

        # Use the restored parent context for row boundaries and prefixes.
        ctx = self._stack[-1]
        # Ensure the row starts on its own line within any active nesting.
        self._open_line_boundary(ctx, strong=False)
        # Emit the pipe-delimited cell values.
        self._emit("| " + " | ".join(cells) + " |")

        if is_header:
            # Emit the mandatory separator line beneath the header row.
            # Restate list or quote prefixes so it stays inside any nesting.
            self._write_boundary(ctx, strong=False)
            self._emit("| " + " | ".join(["---"] * len(cells)) + " |")

        if table is None:
            # A standalone row has no enclosing table to supply the trailing
            # paragraph boundary, so we must emit it here.
            self._write_boundary(ctx, strong=True)

    def _close_table_frame(self, table_frame=None):
        """Emit the paragraph boundary that follows a completed table."""

        parent = self._stack[-1]

        # Empty visible tables already received their only needed boundary.
        # Suppressed nested tables still need spacing inside their cell.
        if (
            table_frame is not None
            and not table_frame.get("table_rows")
            and table_frame.get("table_do_store")
        ):
            return

        if parent["do_store"]:
            # Separate the table from any following content with a blank line.
            self._write_boundary(parent, strong=True)

    def _close_stale_cell(self):
        """Close a stale cell hidden beneath malformed inline frames."""

        # Walk backward until a cell or its structural boundary is found.
        for i in range(len(self._stack) - 1, 0, -1):
            frame = self._stack[i]
            tag = frame["tag"]
            # A row or table boundary means no stale cell exists here.
            if tag in ("tr", "table"):
                return
            if tag in ("td", "th"):
                # Silently drop any interleaved inline frames above the cell.
                while len(self._stack) > i + 1:
                    # Remove the nearest orphaned inline frame.
                    orphan = self._stack[-1]

                    # Keep its open-tag counter synchronized.
                    self._tag_open_counts[orphan["tag"]] = max(
                        0,
                        self._tag_open_counts.get(orphan["tag"], 0) - 1,
                    )
                    self._stack.pop()
                # Finalize the cell before its sibling begins.
                self._pop_to(tag)
                self._close_cell_frame(frame)
                return

    def _close_stale_row(self):
        """Finalize an unterminated row before its table advances."""

        # A stale row always has a stale cell inside it -- close that first.
        self._close_stale_cell()

        # Inspect the frame exposed after closing any stale cell.
        top = self._stack[-1]

        # If the top of the stack is now a row frame, close it too.
        if top["tag"] == "tr":
            self._pop_to("tr")
            self._close_row_frame(top)

    def close(self):
        """Recover any frames left open at end-of-document, then finalize."""

        # Flush trailing text before closing frames so it stays inside them.
        HTMLParser.close(self)

        # HTML does not require all tags to be closed, so we walk the stack
        # top-down and synthesize the missing close events for each open frame.
        # Only frames that emit Markdown structure need explicit finalization;
        # list and blockquote frames just restore context silently via _pop_to.
        while len(self._stack) > 1:
            top = self._stack[-1]
            tag = top["tag"]

            # Remove the frame from the stack (and update open-tag counts).
            self._pop_to(tag)

            if top.get("emphasis_delim"):
                # Emphasis frame -- emit or drop the closing delimiter.
                self._close_emphasis_frame(top)

            elif tag in ("td", "th"):
                # Cell frame -- finalize and store its content.
                self._close_cell_frame(top)

            elif tag == "tr":
                # Row frame -- emit the pipe-table line.
                self._close_row_frame(top)

            elif tag == "table":
                # Table frame -- emit the trailing paragraph boundary.
                self._close_table_frame(top)

            elif tag in ("code", "pre", "samp") and top["do_store"]:
                # Preformatted frame -- emit the fenced code block.
                self._close_pre_frame(top, tag)

        # Hand off to the base converter to assemble the final output string.
        super().close()

    @staticmethod
    def _longest_backtick_run(text):
        """Return the longest consecutive backtick run."""

        # Track both the active run and the maximum observed width.
        longest = current = 0

        # Scan the content one character at a time
        for ch in text:
            if ch == "`":
                current += 1
                longest = max(longest, current)

            # Reset the active run on non-backtick content
            else:
                current = 0

        # Use the maximum to size a collision-free delimiter.
        return longest

    def _finalize(self, result):
        """Combine tokens into normalized Markdown lines."""

        # Track whether a line is waiting after a boundary.
        accum = None

        # Whether accum, so far, is composed only of marker fragments
        accum_is_marker = False

        # True when a marker absorbed a boundary without content.
        marker_boundary_passed = False

        # True when a complete line is waiting to be flushed.
        terminated = False

        # Set when a plain (no prefix at all) _ParaBreak has been seen since
        # accum was last extended with real content
        para_break_seen = False

        # Active list or quote prefix for the next paragraph line.
        para_break_prefix = None

        # Whether the active paragraph prefix belongs to a quote.
        para_break_in_quote = False

        # Set when a boundary arrives *after* the line was already terminated
        # -- i.e. anything beyond the single boundary that did the terminating.
        boundary_after_terminate = False

        for item in result:
            # Boundaries update state but do not immediately emit text.
            # Collect boundary state before flushing the current line
            if item == self.BLOCK_END or isinstance(item, _ParaBreak):
                if isinstance(item, _ParaBreak):
                    # The latest break carries the current nesting context.
                    if item.prefix:
                        para_break_prefix = item.prefix
                        para_break_in_quote = item.in_quote

                    else:
                        para_break_seen = True
                        para_break_prefix = None
                        para_break_in_quote = False

                # Absorb boundaries until real content arrives.
                if accum is None:
                    continue

                # Keep an unused structural marker pending
                if accum_is_marker:
                    marker_boundary_passed = True
                    continue

                # Remember boundaries beyond the one ending this line
                if terminated:
                    boundary_after_terminate = True

                terminated = True
                continue

            # Flush the previous line before adding new content.
            if terminated:
                if para_break_prefix is not None:
                    # Keep blank lines inside an active quote
                    if para_break_in_quote:
                        blank = para_break_prefix.rstrip(
                            self._ASCII_WHITESPACE
                        )
                        sep = "\n" + blank + "\n"

                    # Lists use an ordinary blank paragraph line
                    else:
                        sep = "\n\n"

                elif para_break_seen:
                    sep = "\n\n"

                # Fall back to a single line break
                else:
                    sep = "\n"

                # Emit the completed line with its chosen separator.
                yield accum.rstrip(self._ASCII_WHITESPACE) + sep

                # Seed the next line with any active list or quote prefix.
                if para_break_prefix is not None:
                    accum = (
                        _QuoteMarker(para_break_prefix)
                        if para_break_in_quote
                        else _ListIndent(para_break_prefix)
                    )
                    accum_is_marker = True
                    marker_boundary_passed = boundary_after_terminate

                else:
                    accum = None
                    accum_is_marker = False
                    marker_boundary_passed = False

                # Reset state gathered for the completed line
                terminated = False
                para_break_seen = False
                para_break_prefix = None
                para_break_in_quote = False
                boundary_after_terminate = False

            if accum is not None:
                # Determine whether this token is generated structure.
                item_is_marker = isinstance(item, _Marker)
                if (
                    marker_boundary_passed
                    and accum_is_marker
                    and item_is_marker
                ):
                    # A new marker after the old one sat through a boundary
                    # unused -- start over with this one
                    accum = item
                    accum_is_marker = True

                else:
                    # Append ordinary content to the pending line.
                    accum += item
                    accum_is_marker = accum_is_marker and item_is_marker

                marker_boundary_passed = False

            else:
                # Seed a new line with this token
                accum = item
                accum_is_marker = isinstance(item, _Marker)
                para_break_seen = False
                para_break_prefix = None
                para_break_in_quote = False

        # Flush the final content line without adding another newline.
        if accum is not None and not accum_is_marker:
            yield accum.rstrip(self._ASCII_WHITESPACE)

    def _escape_line_start(self, content):
        """Escape text that could become block syntax."""

        # Look for an ordered-list marker
        ordered = self._ORDERED_MARKER_RE.match(content)
        if ordered:
            # Escape just the '.', not the digits themselves
            dot = ordered.end() - 1
            return content[:dot] + "\\" + content[dot:]

        # Escape an unordered-list marker
        if self._BULLET_MARKER_RE.match(content):
            return "\\" + content

        # Ignore surrounding whitespace while checking the full line
        trimmed = content.strip(self._ASCII_WHITESPACE)

        # Escape thematic breaks and setext underlines
        if trimmed and self._THEMATIC_BREAK_RE.match(trimmed):
            idx = content.index(trimmed[0])
            return content[:idx] + "\\" + content[idx:]

        # Leave ordinary line starts unchanged.
        return content

    def handle_data(self, data, *args, **kwargs):
        """Store escaped text for the current context."""

        # Read all text-handling flags from the active frame.
        ctx = self._stack[-1]

        # Ignore text inside suppressed containers.
        if not ctx["do_store"]:
            return

        # Preserve literal whitespace inside code blocks
        if ctx["preserve_cr"]:
            # Buffer raw text so the closing delimiter can be sized safely.
            ctx["buffer"].append(data)
            return

        # Preserve deliberate non-breaking spaces even at block boundaries.
        if not data.strip() and "\xa0" in data:
            self._emit("\xa0")
            return

        # Collapse ordinary whitespace outside preformatted content.
        content = self.WS_TRIM.sub(" ", data)

        # Drop indentation-only text around block boundaries.
        if not content.strip() and (
            not self._result
            or self._result[-1] == self.BLOCK_END
            or isinstance(self._result[-1], (_Marker, _ParaBreak))
        ):
            return

        # Detect text that begins a fresh Markdown source line.
        is_line_start = (
            not self._result
            or self._result[-1] == self.BLOCK_END
            or isinstance(self._result[-1], (_Marker, _ParaBreak))
            or (
                type(self._result[-1]) is str
                and self._result[-1].endswith("\n")
            )
        )

        # Escape Markdown punctuation in ordinary text.
        content = self.MARKDOWN_ESCAPE.sub(r"\\\1", content)

        if is_line_start:
            # Prevent plain text from becoming a Markdown block
            content = self._escape_line_start(content)

        # Keep leading whitespace outside an emphasis delimiter.
        if ctx.get("emphasis_delim") and not ctx["emphasis_started"]:
            stripped = content.lstrip(self._ASCII_WHITESPACE)

            # Move leading whitespace before the opening delimiter
            if stripped != content:
                leading = content[: len(content) - len(stripped)]
                delim = self._result.pop()
                self._result.append(leading)
                self._result.append(delim)
                content = stripped

            if not content:
                # The close handler removes an empty span.
                return

            # Mark the emphasis span as started
            ctx["emphasis_started"] = True

        # Append the final escaped fragment to the output stream.
        self._emit(content)

    def handle_starttag(self, tag, attrs):
        """Handle an opening HTML tag."""

        # Capture the parent context before opening another frame.
        ctx = self._stack[-1]

        # Treat nested tags inside preformatted content as literal text.
        if ctx["preserve_cr"]:
            return

        # Track list type, depth, and numbering.

        if tag in ("ul", "ol"):
            # CommonMark ordered lists default to one.
            counter = 1

            if tag == "ol":
                # Read an optional starting number from ordered lists.
                start_attr = next((v for k, v in attrs if k == "start"), None)
                if start_attr is not None:
                    with contextlib.suppress(TypeError, ValueError):
                        # Markdown list markers cannot represent negative
                        # values.
                        counter = max(0, int(start_attr))

            # Prepare the list-specific state inherited by its items.
            overrides = {
                "do_store": False,
                "list_type": tag,
                "depth": min(ctx["depth"] + 1, LIST_DEPTH_MAX),
                "counter": (counter if tag == "ol" else None),
            }

            # Only refresh list_do_store when this is the outermost list (its
            # parent isn't itself a ul/ol).
            if ctx["tag"] not in ("ul", "ol"):
                overrides["list_do_store"] = ctx["do_store"]

            # Capture indentation once at the start of a nested list chain.
            if ctx["depth"] == 0:
                overrides["list_indent_base"] = ctx["list_indent"]

            # A direct child list continues its parent item without a break.
            if ctx["do_store"] and ctx["tag"] != "li":
                self._open_line_boundary(ctx, strong=True)

            # Open the list frame and suppress whitespace-only text nodes.
            self._push_frame(self._make_frame(tag, **overrides))
            return

        # Emit a list marker and enable item content.

        if tag == "li":
            # An item value resets numbering for it and following siblings.
            if ctx["list_type"] == "ol" and ctx["counter"] is not None:
                # Read an optional per-item numbering override.
                value_attr = next((v for k, v in attrs if k == "value"), None)
                if value_attr is not None:
                    with contextlib.suppress(TypeError, ValueError):
                        # Match the non-negative 
       constraint.
                        ctx["counter"] = max(0, int(value_attr))

            # Indent scales with nesting depth (depth 1 = no indent), capped at
            # LIST_DEPTH_MAX
            indent = self._indent(ctx["depth"])

            if ctx["list_type"] == "ol" and ctx["counter"] is not None:
                # Render the current ordered-list number.
                marker_text = "{}{}. ".format(indent, ctx["counter"])

            else:
                # Render a bullet for unordered or malformed list items.
                marker_text = "{}- ".format(indent)

            # Tag the marker as converter-generated structure
            marker = _ListMarker(marker_text)

            # Re-enable storage, unless something outside the list itself (e.g.
            # ) is suppressing content
            do_store = ctx["list_do_store"]

            # Snapshot content state for constant-time empty-item detection.
            # Gate marker emission on the return value: at MAX_FRAME_DEPTH
            # the frame is discarded and we must not append the marker,
            # otherwise there is nothing to pop it on .
            if not self._push_frame(
                self._make_frame(
                    tag,
                    do_store=do_store,
                    content_seq_at_open=self._content_seq,
                    list_indent=(
                        ctx["list_indent_base"] + " " * len(marker_text)
                    ),
                )
            ):
                return

            if do_store:
                # Reuse a pending quote or list marker on this line.
                if not (
                    self._result and isinstance(self._result[-1], _Marker)
                ):
                    self._result.append(self.BLOCK_END)

                    # Restate an enclosing quote prefix
                    if ctx["quote_depth"]:
                        self._result.append(
                            self._quote_prefix(ctx["quote_depth"])
                        )

                self._result.append(marker)
            return

        # Extend a pending quote/list marker, or begin a fresh quoted line.

        if tag == "blockquote":
            # Clamp quote depth to keep generated prefixes bounded
            depth = min(ctx["quote_depth"] + 1, BLOCKQUOTE_DEPTH_MAX)

            # Open a frame carrying the increased quote depth.
            # Gate marker emission on the return value: at MAX_FRAME_DEPTH
            # the frame is discarded and we must not append a _QuoteMarker,
            # otherwise there is nothing to pop it on 
    • .
            new_frame = self._make_frame(tag, quote_depth=depth)
            if not self._push_frame(new_frame):
                return

            if ctx["do_store"]:
                last = self._result[-1] if self._result else None

                # Extend an existing quote prefix
                if isinstance(last, _QuoteMarker) or (
                    isinstance(last, _ParaBreak) and last.in_quote
                ):
                    if depth > ctx["quote_depth"]:
                        self._result.append(_QuoteMarker("> "))

                elif isinstance(last, _Marker):
                    self._result.append(self._quote_prefix(depth))

                # Separate a quote from preceding text.
                elif isinstance(last, str):
                    self._write_boundary(ctx, strong=True)

                    if depth > ctx["quote_depth"]:
                        self._result.append(_QuoteMarker("> "))

                # Emit the prefix directly at the start of a context.
                else:
                    self._result.append(
                        _QuoteMarker(
                            ctx["list_indent"] + self._quote_prefix(depth)
                        )
                    )
            return

        # Table section tags are transparent.

        if tag == "table":
            # Markdown cannot represent a table nested inside a cell.
            nested_in_cell = bool(
                self._tag_open_counts.get("td")
                or self._tag_open_counts.get("th")
            )

            # Separate a representable table from preceding content.
            if ctx["do_store"] and not nested_in_cell:
                self._open_line_boundary(ctx, strong=True)

            self._push_frame(
                self._make_frame(
                    tag,
                    do_store=False,
                    # Nested table cells remain suppressed.
                    table_do_store=(
                        False if nested_in_cell else ctx["do_store"]
                    ),
                    table_rows=0,
                )
            )
            return

        if tag == "tr":
            # Finalize a malformed, unterminated previous row first.
            self._close_stale_row()

            # Capture the table or container that owns the new row.
            row_ctx = self._stack[-1]

            # Remember whether this row belongs to a real table frame.
            is_table = row_ctx["tag"] == "table"

            self._push_frame(
                self._make_frame(
                    tag,
                    do_store=False,
                    cells=[],
                    # A stray row becomes a standalone one-row table.
                    table_frame=(row_ctx if is_table else None),
                    table_do_store=(
                        row_ctx["table_do_store"]
                        if is_table
                        else row_ctx["do_store"]
                    ),
                )
            )
            return

        if tag in ("td", "th"):
            # Finalize an unterminated previous cell first.
            self._close_stale_cell()

            # Capture the row expected to own the new cell.
            cell_ctx = self._stack[-1]

            if cell_ctx["tag"] == "tr":
                # Record where this cell's buffered output begins.
                self._push_frame(
                    self._make_frame(
                        tag,
                        do_store=cell_ctx["table_do_store"],
                        cell_result_start=len(self._result),
                    )
                )
                return
            # No enclosing  -- this isn't really a table cell (e.g. a stray
            #  with no surrounding table structure at all).

        # Buffer preformatted content until its closing tag.

        if tag in ("code", "pre", "samp"):
            # Preserve raw whitespace until the matching closing tag.
            self._push_frame(
                self._make_frame(tag, preserve_cr=True, buffer=[])
            )

        # Resume text capture inside the document body.

        elif tag == "body":
            # The document body always resumes visible text capture.
            self._push_frame(self._make_frame(tag, do_store=True))

        # Suppress content inside ignored containers.

        elif tag in self.IGNORE_TAGS:
            # Ignored containers inherit context but disable text storage.
            self._push_frame(self._make_frame(tag, do_store=False))

        # Do not emit Markdown markers for suppressed content.

        if not ctx["do_store"]:
            return

        # Start block-level content on the correct boundary.
        if tag in self.BLOCK_TAGS:
            self._open_line_boundary(ctx, strong=tag in self._PARA_LIKE_TAGS)

        # Emit Markdown syntax for the current tag.

        if tag == "br":
            # CommonMark needs two trailing spaces for a visible hard break.
            self._emit("  \n" + self._continuation_prefix(ctx))

        elif tag == "hr":
            # A void 
     supplies its own boundaries; the leading blank line
            # prevents it from becoming a setext heading.
            self._open_line_boundary(ctx, strong=True)
            self._emit("---")
            self._result.append(self.BLOCK_END)

        elif tag == "h1":
            # Render a level-one ATX heading marker.
            self._emit("# ")

        elif tag == "h2":
            # Render a level-two ATX heading marker.
            self._emit("## ")

        elif tag == "h3":
            # Render a level-three ATX heading marker.
            self._emit("### ")

        elif tag == "h4":
            # Render a level-four ATX heading marker.
            self._emit("#### ")

        elif tag == "h5":
            # Render a level-five ATX heading marker.
            self._emit("##### ")

        elif tag == "h6":
            # Render a level-six ATX heading marker.
            self._emit("###### ")

        # Open an emphasis frame for bold or italic content
        elif tag in ("strong", "b", "em", "i"):
            # A frame validates closing tags and relocates edge whitespace.
            delim = "**" if tag in ("strong", "b") else "*"

            # Emit a delimiter only when its frame passed the depth limit.
            if self._push_frame(
                self._make_frame(
                    tag,
                    emphasis_delim=delim,
                    emphasis_started=False,
                    content_seq_at_open=self._content_seq,
                    # Exact delimiter index used when removing an empty span.
                    emphasis_result_start=len(self._result),
                )
            ):
                # Buffer the opening delimiter for the matching close tag.
                self._result.append(delim)

        # Open a Markdown link when an href is available
        elif tag == "a":
            # Keep the target on a frame so nested label markup is included.
            href = next(
                (v for k, v in attrs if k == "href"),
                None,
            )

            # Sanitize the destination before emitting Markdown
            if href is not None:
                # Remove controls that browsers ignore during URL parsing.
                href = self._HREF_CONTROL_CHARS.sub("", href)

                # Strip all leading/trailing whitespace, including Unicode
                # space characters that would otherwise bypass scheme checks.
                href = href.strip()

                # Extract an explicit URI scheme when one is present.
                scheme = self._HREF_SCHEME.match(href)

                # Neutralize schemes that can execute or expose local content
                if (
                    scheme
                    and scheme.group(1).lower() in self._UNSAFE_HREF_SCHEMES
                ):
                    # Preserve link shape while neutralizing unsafe targets.
                    href = "#"

            if href is not None:
                # Angle destinations safely contain parentheses.
                safe_href = self.HREF_ESCAPE.sub(r"\\\1", href)
                target = "<{}>".format(safe_href)

                # Store the target only when its frame passes the depth limit.
                if self._push_frame(self._make_frame(tag, href=target)):
                    # Frame accepted: begin the CommonMark link label.
                    self._emit("[")

    def handle_endtag(self, tag):
        """Handle a closing HTML tag."""

        # Capture context before any pop so do_store and any buffered code/pre
        # content can still be read for this closing tag
        ctx = self._stack[-1]

        if tag == "a":
            # Find the href stored in the nearest      frame
            href = None

            # Search backward for the matching anchor
            for frame in reversed(self._stack):
                if frame["tag"] == "a":
                    href = frame.get("href")
                    break

            self._pop_to(tag)

            # Bare or suppressed anchors do not create link frames.
            if href is not None:
                # Complete the Markdown link
                self._emit("](" + href + ")")

            return

        # Track list type, depth, and numbering.

        if tag in ("ul", "ol"):
            # Ignore a list closer that has no corresponding open frame.
            if not self._pop_to(tag):
                return

            # Continue rendering in the restored parent context.
            parent = self._stack[-1]

            if parent["do_store"]:
                self._write_boundary(parent, strong=parent["tag"] != "li")
            return

        # Emit a list marker and enable item content.

        if tag == "li":
            # A stray closing tag with no open 
  •  anywhere on the stack is
            # a no-op -- nothing below should run against an unrelated frame.
            if not self._tag_open_counts.get(tag):
                return

            # Locate the actual li frame -- the top frame may be an unclosed
            # child (e.g.  inside 
  • textbold
    • ).
            li_frame = next(
                (f for f in reversed(self._stack) if f["tag"] == "li"),
                ctx,
            )

            # Empty items are dropped and do not advance ordered-list
            # numbering.
            has_content = li_frame[
                "do_store"
            ] and self._content_seq != li_frame.get(
                "content_seq_at_open", self._content_seq
            )

            # Block boundary closes the item content -- only if the item
            # actually emitted a marker when it opened.
            if li_frame["do_store"]:
                self._result.append(self.BLOCK_END)

            # Pop the li frame (and any unclosed children above it).
            self._pop_to(tag)

            # The enclosing list is exposed after the item frame is removed.
            parent = self._stack[-1]

            # Increment numbering only for items that emitted content
            if parent["list_type"] == "ol" and has_content:
                parent["counter"] += 1

            return

        # Track blockquote depth and emit its prefix.
        if tag == "blockquote":
            # Restore the quote's parent context -- a stray closing tag with
            # no open 
     anywhere on the stack is a no-op.
            if not self._pop_to(tag):
                return
            # Continue rendering in the restored outer context.
            parent = self._stack[-1]

            if parent["do_store"]:
                self._write_boundary(parent, strong=True)
            return

        # Close only matching table frames; ignore stray closing tags.

        if tag in ("td", "th"):
            # Ignore stray cell closers instead of emitting a block boundary.
            if ctx["tag"] == tag:
                # Remove the frame before storing its value on the row.
                self._pop_to(tag)
                self._close_cell_frame(ctx)
            return

        elif tag == "tr":
            # Recover any cell left open by malformed HTML
            self._close_stale_cell()
            row_ctx = self._stack[-1]

            if row_ctx["tag"] == "tr":
                # Remove the row before rendering it in the parent context.
                self._pop_to(tag)
                self._close_row_frame(row_ctx)
            return

        elif tag == "table":
            # Recover any row left open by malformed HTML
            self._close_stale_row()
            table_ctx = self._stack[-1]

            if table_ctx["tag"] == "table":
                # Remove the table before emitting its trailing boundary.
                self._pop_to(tag)
                self._close_table_frame(table_ctx)
            return

        # Buffer preformatted content until its closing tag.

        if tag in ("code", "pre", "samp"):
            # Render only the matching preformatted frame
            if ctx["do_store"] and ctx["tag"] == tag:
                self._close_pre_frame(ctx, tag)

            # Restore the context that preceded the preformatted element.
            self._pop_to(tag)
            return

        # Do not emit Markdown markers for suppressed content.

        if not ctx["do_store"] or ctx["preserve_cr"]:
            if tag == "body" or tag in self.IGNORE_TAGS:
                self._pop_to(tag)
            return

        # Paragraph-like tags strongly separate following bare text.
        if tag in self.BLOCK_TAGS:
            self._write_boundary(ctx, strong=tag in self._PARA_LIKE_TAGS)

        if tag in ("strong", "b", "em", "i"):
            # Only a matching emphasis frame emits a closing delimiter.
            if ctx["tag"] == tag and ctx.get("emphasis_delim"):
                self._pop_to(tag)
                self._close_emphasis_frame(ctx)
            return

        # Pop frames created by container tags.

        if tag == "body" or tag in self.IGNORE_TAGS:
            # Restore storage flags inherited from the enclosing frame.
            self._pop_to(tag)


class HTMLTagReducer(HTMLParser):
    """Rewrite HTML so it only uses a small set of tags.

    This holds the parts every reducer shares. A subclass sets the class
    attributes below and handles its own extra tags in ``_start()``,
    ``_end()`` and ``_text()``, passing anything else back up here.

    - Tags in ``INLINE_MAP`` are written as the tag they map to.
    - Headings become bold text on their own line.
    - List items become "- " (or "1. ") lines and table rows become
      lines with cells split by " | ".
    - Images are replaced by their alt text.
    - Anything inside a ``SKIP_TAGS`` tag is hidden.
    - Any other tag is dropped and only its text is kept.
    - Every opened tag is closed, so the result is always balanced.
    """

    # Source tag -> the tag written in its place
    INLINE_MAP: dict[str, str] = {}

    # Tags written as bold text on a line of their own
    HEADINGS: tuple[str, ...] = ("h1", "h2", "h3", "h4", "h5", "h6")

    # Tags whose content is never shown
    SKIP_TAGS: tuple[str, ...] = ("script", "style")

    # What a line break looks like in the output
    LINE_BREAK = "\n"

    # Characters swapped in text before it is escaped (str.translate)
    TEXT_MAP: dict[int, str] = {}

    def __init__(self) -> None:
        super().__init__(convert_charrefs=True)

    def reset(self) -> None:
        """Clear the parser and every piece of reducer state."""
        # HTMLParser calls this from __init__, and reduce() calls it again
        # so an instance can be reused.
        super().reset()

        # The rewritten message, one piece at a time
        self.out: list[str] = []

        # Open output tags as (source tag, written tag) pairs
        self.open_tags: list[tuple[str, str]] = []

        # Open counts allow quick membership checks.
        self.open_count: Counter[str] = Counter()

        # One entry per open list; a number for numbered lists, else None
        self.lists: list[Optional[int]] = []

        # Depth of tags whose content is hidden
        self.skip = 0

        # Number of cells written on the current table row
        self.cells = 0

    def _line(self) -> None:
        """Start a new line unless we are already on an empty one."""
        if self.out and self.out[-1] != self.LINE_BREAK:
            self.out.append(self.LINE_BREAK)

    def _open(self, source: str, tag: str, attrs: str = "") -> None:
        """Write a supported tag and remember it so it gets closed."""
        self.out.append(f"<{tag}{attrs}>")
        self.open_tags.append((source, tag))
        self.open_count[source] += 1

    def _close(self, source: str) -> None:
        """Close ``source`` and anything opened after it."""
        # Ignore a closing tag that was never opened
        if not self.open_count[source]:
            return

        while True:
            opened, tag = self.open_tags.pop()
            self.open_count[opened] -= 1
            self.out.append(f"")
            if opened == source:
                break

    def handle_starttag(
        self, tag: str, attrs: list[tuple[str, Optional[str]]]
    ) -> None:
        """Hide skipped tags; hand every other tag to ``_start()``."""
        if tag in self.SKIP_TAGS:
            # Hide everything until this tag closes
            self.skip += 1
            return

        self._start(tag, dict(attrs))

    def _start(self, tag: str, values: dict[str, Optional[str]]) -> None:
        """Write the markup for an opening tag.

        - ``values`` holds the tag's attributes by name.
        """
        if tag in self.INLINE_MAP:
            self._open(tag, self.INLINE_MAP[tag])

        elif tag in self.HEADINGS:
            # Headings are bold text on their own line
            self._line()
            self._open(tag, "b")

        elif tag in ("ul", "ol"):
            # Lists always begin on a new line
            self._line()
            self.lists.append(1 if tag == "ol" else None)

        elif tag == "li":
            # Each list item is its own line with a bullet or number
            self._line()
            number = self.lists[-1] if self.lists else None

            # Indent by nesting depth, capped so very deep nesting can
            # not make the output grow out of control
            depth = min(len(self.lists), LIST_DEPTH_MAX)
            indent = "  " * max(0, depth - 1)
            if number is None:
                self.out.append(f"{indent}- ")

            else:
                self.out.append(f"{indent}{number}. ")
                self.lists[-1] = number + 1

        elif tag == "tr":
            # Each table row is its own line
            self._line()
            self.cells = 0

        elif tag in ("td", "th"):
            # Separate the cells of a row
            if self.cells:
                self.out.append(" | ")

            self.cells += 1

        elif tag == "img" and values.get("alt"):
            # Images cannot be shown; keep their description
            self.out.append(escape(values["alt"], quote=False))

    def handle_startendtag(
        self, tag: str, attrs: list[tuple[str, Optional[str]]]
    ) -> None:
        """Treat ``
    `` style tags like their opening tag."""
        if tag in ("br", "hr", "img"):
            self.handle_starttag(tag, attrs)

    def handle_endtag(self, tag: str) -> None:
        """Show content again after a skipped tag; else call ``_end()``."""
        if tag in self.SKIP_TAGS:
            # Show content again once the hidden tag closes
            self.skip = max(0, self.skip - 1)
            return

        self._end(tag)

    def _end(self, tag: str) -> None:
        """Close a tag and end its line when it needs one."""
        # Close any supported tag this one opened
        self._close(tag)

        if tag in ("ul", "ol") and self.lists:
            # Leave this list
            self.lists.pop()

        if tag in self.HEADINGS or tag in ("ul", "ol", "li", "tr"):
            # These end their line
            self._line()

    def handle_data(self, data: str) -> None:
        """Write text unless it sits inside a skipped tag."""
        if not self.skip:
            self._text(data)

    def _text(self, data: str) -> None:
        """Write text, keeping the line breaks written inside it."""
        if not data.strip():
            # Whitespace between tags only lays out the HTML source
            self._write(HTML_NEWLINE_RE.sub(" ", data))
            return

        pos = 0
        for match in HTML_NEWLINE_RE.finditer(data):
            self._write(data[pos : match.start()])
            pos = match.end()

            # Count the line breaks, with "\r\n" counting once
            breaks = (
                match.group().replace("\r\n", "\n").replace("\r", "\n")
            ).count("\n")
            if not self.out or self.out[-1] == self.LINE_BREAK:
                # A tag already ended this line, or nothing is written yet
                breaks -= 1

            self.out.extend([self.LINE_BREAK] * max(0, breaks))

        self._write(data[pos:])

    def _write(self, data: str) -> None:
        """Write one stretch of text with its special characters escaped."""
        if not self.out or self.out[-1] == self.LINE_BREAK:
            # Do not start a new line with a space
            data = data.lstrip()

        if data:
            self.out.append(escape(data.translate(self.TEXT_MAP), quote=False))

    def reduce(self, html: str) -> str:
        """Return ``html`` rewritten with only the supported tags."""
        # Start clean so nothing from an earlier call leaks in
        self.reset()
        self.feed(html)
        self.close()

        # Drop line breaks and spaces left at the very end
        while self.out and (
            self.out[-1] == self.LINE_BREAK or not self.out[-1].strip()
        ):
            self.out.pop()

        # Close any tag still open so the message stays balanced
        while self.open_tags:
            self.out.append(f"")

        return "".join(self.out)
caronc-apprise-dfec414/apprise/decorators/000077500000000000000000000000001526720371000207275ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/decorators/__init__.py000066400000000000000000000026601526720371000230440ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from .notify import notify

__all__ = ["notify"]
caronc-apprise-dfec414/apprise/decorators/base.py000066400000000000000000000221671526720371000222230ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import inspect
from typing import Any, Optional

from .. import common
from ..logger import logger
from ..manager_plugins import NotificationManager
from ..plugins.base import NotifyBase
from ..utils.logic import dict_full_update
from ..utils.parse import URL_DETAILS_RE, parse_url, url_assembly

# Grant access to our Notification Manager Singleton
N_MGR = NotificationManager()


class CustomNotifyPlugin(NotifyBase):
    """Apprise Custom Plugin Hook.

    This gets initialized based on @notify decorator definitions
    """

    # Our Custom notification; identify the URL users can go to learn
    # more about the service this wrapper supports:
    service_url = "https://appriseit.com/library/extending/decorator/"

    # Over-ride our category since this inheritance of the NotifyBase class
    # should be treated differently.
    category = "custom"

    # Support Attachments
    attachment_support = True

    # Allow persistent storage support
    storage_mode = common.PersistentStoreMode.AUTO

    # Define object templates
    templates = ("{schema}://",)

    @staticmethod
    def parse_url(url: str) -> Optional[dict[str, Any]]:
        """Parses the URL and returns arguments retrieved."""
        results = parse_url(url, verify_host=False, simple=True)
        if not results:
            # The URL could not be parsed at all
            return results

        # Apply the same query string handling every other plugin gets, so
        # options such as ?verify=, ?user= and ?pass= behave the same.
        results = NotifyBase.post_process_parse_url_results(results)

        # Options such as ?format=, ?retry= and ?optional= work here too
        return NotifyBase.parse_url_options(results)

    def url(self, privacy=False, *args, **kwargs):
        """General URL assembly."""
        return f"{self.secure_protocol}://"

    @staticmethod
    def instantiate_plugin(url, send_func, name=None, body_format=None):
        """The function used to add a new notification plugin based on the
        schema parsed from the provided URL into our supported matrix
        structure.

        ``body_format`` declares the destination format(s) this wrapper
        accepts. When omitted, the wrapper passes every format through.
        """

        if not isinstance(url, str):
            msg = (
                f"An invalid custom notify url/schema ({url}) provided in "
                f"function {send_func.__name__}."
            )
            logger.warning(msg)
            return None

        # Validate that our schema is okay
        re_match = URL_DETAILS_RE.match(url)
        if not re_match:
            msg = (
                f"An invalid custom notify url/schema ({url}) provided in "
                f"function {send_func.__name__}."
            )
            logger.warning(msg)
            return None

        # Acquire our schema
        schema = re_match.group("schema").lower()

        if not re_match.group("base"):
            url = f"{schema}://"

        # Keep a default set of arguments to apply to all called references
        base_args = parse_url(
            url, default_schema=schema, verify_host=False, simple=True
        )

        if schema in N_MGR:
            # we're already handling this object
            msg = (
                f"The schema ({url}) is already defined and could not be "
                f"loaded from custom notify function {send_func.__name__}."
            )
            logger.warning(msg)
            return None

        # We define our own custom wrapper class so that we can initialize
        # some key default configuration values allowing calls to our
        # `Apprise.details()` to correctly differentiate one custom plugin
        # that was loaded from another
        class CustomNotifyPluginWrapper(CustomNotifyPlugin):
            # Our Service Name
            service_name = (
                name
                if isinstance(name, str) and name
                else f"Custom - {schema}"
            )

            # Store our matched schema
            secure_protocol = schema

            # Explicit body_format= declares this wrapper's destination.
            # Without one, accept every format as pass-through input.
            notify_format = (
                body_format
                if body_format is not None
                else (
                    common.NotifyFormat.TEXT,
                    common.NotifyFormat.HTML,
                    common.NotifyFormat.MARKDOWN,
                )
            )

            requirements = {
                # Define our required packaging in order to work
                "details": f"Source: {inspect.getfile(send_func)}"
            }

            # Assign our send() function
            __send = staticmethod(send_func)

            # Update our default arguments
            _base_args = base_args

            def __init__(self, **kwargs):
                """Our initialization."""
                #  init parent
                super().__init__(**kwargs)

                self._default_args = {}

                # Some variables do not need to be set
                kwargs.pop("secure", None)

                # Apply our updates based on what was parsed
                dict_full_update(self._default_args, self._base_args)
                dict_full_update(self._default_args, kwargs)

                # Update our arguments (applying them to what we originally)
                # initialized as
                self._default_args["url"] = url_assembly(**self._default_args)

            def send(
                self,
                body,
                title="",
                notify_type=common.NotifyType.INFO,
                *args,
                **kwargs,
            ):
                """Our send() call which triggers our hook."""

                # The decorator does not support split/truncate overflow, so
                # every delivery is index 0 of 1. Drop them rather than pass
                # along values that never carry any real meaning here.
                kwargs.pop("index", None)
                kwargs.pop("total", None)

                response = False
                try:
                    # Enforce a boolean response
                    result = self.__send(
                        body,
                        title,
                        notify_type.value,
                        *args,
                        meta=self._default_args,
                        **kwargs,
                    )

                    # None and True are both considered successful
                    # False however is passed along further upstream
                    response = True if result is None else bool(result)

                except Exception as e:
                    # Unhandled Exception
                    self.logger.warning(
                        "An exception occured sending a %s notification.",
                        N_MGR[self.secure_protocol].service_name,
                    )
                    self.logger.debug(
                        "%s Exception: %s", N_MGR[self.secure_protocol], e
                    )
                    return False

                if response:
                    self.logger.info(
                        "Sent %s notification.",
                        N_MGR[self.secure_protocol].service_name,
                    )
                else:
                    self.logger.warning(
                        "Failed to send %s notification.",
                        N_MGR[self.secure_protocol].service_name,
                    )
                return response

        # Store our plugin into our core map file
        return N_MGR.add(
            plugin=CustomNotifyPluginWrapper,
            schemas=schema,
            send_func=send_func,
            url=url,
        )
caronc-apprise-dfec414/apprise/decorators/notify.py000066400000000000000000000117321526720371000226150ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from .base import CustomNotifyPlugin


def notify(on, name=None, body_format=None):
    """Register a function as an Apprise notification plugin.

    ``on`` identifies the URL protocol that triggers the function.

        @notify(on="foobar")
        def your_declaration(body, title, notify_type, meta, *args, **kwargs):
            ...

    ``name`` optionally sets the plugin name exposed through the API.

        @notify(on="foobar", name="My Foobar Process")
        def your_action(body, title, notify_type, meta, *args, **kwargs):
            ...

    ``body_format`` declares accepted prepared formats. Without it, message
    content passes through without conversion.

        @notify(on="foobar", body_format=NotifyFormat.MARKDOWN)
        def your_action(body, title, notify_type, meta, *args, **kwargs):
            ...

    ``meta`` contains parsed URL and configuration values for the call.

        @notify(on="foobar", name="My Foobar Process")
        def your_action(body, title, notify_type, body_format, meta, attach,
                        *args, **kwargs):
            ...

    Arguments break down as follows:
      body:        The message body associated with the notification
      title:       The message title associated with the notification
      notify_type: The message type (info, success, warning, and failure)
      body_format: The resolved format delivered to your function.
      body_passthrough:
                   True if the caller left the source format
                   undeclared, so automatic format conversion was
                   skipped.
      meta:        Combines the URL arguments specified on the `on` call
                   with the ones loaded from a users configuration. This
                   is a dictionary that presents itself like this:
                    {
                      'schema': 'http',
                      'url': 'http://hostname',
                      'host': 'hostname',

                      'user': 'john',
                      'password': 'doe',
                      'port': 80,
                      'path': '/',
                      'fullpath': '/test.php',
                      'query': 'test.php',

                      'qsd': {'key': 'value', 'key2': 'value2'},
                      'verify': True,

                      'asset': ,
                      'tag': set(),
                    }

                    Entries appear only when available. A simple
                    ``foobar://`` URL produces:
                    {
                      'schema': 'foobar',
                      'url': 'foobar://',
                      'verify': True,

                      'asset': ,
                      'tag': set(),
                    }

      attach:      An array AppriseAttachment objects (if any were provided)

      @notify body_format:
                   Declares the prepared body format(s) your wrapper
                   accepts; omitted means pass-through for every format.


    Functions that do not need every parameter may use:

        @notify(on="foobar", name="My Foobar Process")
        def your_action(body, title, *args, **kwargs)

    End the function signature with ``*args`` and ``**kwargs`` for forward
    compatibility.

    Return ``True`` for success or ``False`` for failure. A missing return
    value is treated as success.
    """

    def wrapper(func):
        """Instantiate our custom (notification) plugin."""

        # Generate
        CustomNotifyPlugin.instantiate_plugin(
            url=on, send_func=func, name=name, body_format=body_format
        )

        return func

    return wrapper
caronc-apprise-dfec414/apprise/dispatch.py000066400000000000000000001003731526720371000207370ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

"""Run notification attempts and build their results.

This module handles retries, priority groups, time limits, and failures.
"""

from __future__ import annotations

from collections.abc import Iterator
import logging
import math
import time
from typing import TYPE_CHECKING, Any, Callable, Optional, Union

from .asset import AppriseAsset
from .common import APPRISE_MAX_SERVICE_RETRY
from .exception import AppriseImproperlyConfigured
from .logger import NotifyLogEntry, _ServiceLogCapture, logger
from .plugins.base import (
    NotifyBase,
    _delivery_memo,
    _delivery_tracker,
)
from .result import (
    AppriseResult,
    AppriseResultStatus,
    NotifyAttempt,
    NotifyResult,
)

if TYPE_CHECKING:
    # Import Apprise only for static analysis. CallState reaches it through
    # the instance it is given, so importing it here at runtime would only
    # create a cycle back through this module.
    from .apprise import Apprise

# One (service, notify()-kwargs) pair as produced by _create_notify_gen()
# and threaded through every dispatch primitive below.
ServiceCall = tuple[NotifyBase, dict[str, Any]]

# What dispatching one batch produced: its (ok, results), or the exception
# that stopped it.
BatchOutcome = Union[tuple[bool, list[NotifyResult]], BaseException]


def safe_attr(service: NotifyBase, name: str, default: Any) -> Any:
    """Read a plugin attribute, returning ``default`` if it raises.

    This also protects callers when a plugin property fails while being read.
    """
    try:
        return getattr(service, name, default)

    except Exception:
        # Use the backup value instead of hiding the original plugin failure.
        return default


def service_metadata(
    service: NotifyBase,
) -> tuple[str, str, Optional[str], tuple[str, ...], int]:
    """Return ``(name, url, url_id, tags, weight)`` with safe defaults.

    A plugin may fail while providing these details, so each value has a
    simple backup.
    """
    # Each of these is plugin-supplied, so read it defensively.
    name = safe_attr(service, "service_name", "Unknown")

    try:
        # Hide private URL values before placing the URL in a result.
        url = service.url(privacy=True)

    except Exception:
        # A result still needs a usable URL-shaped value.
        url = "unknown://"

    try:
        # The short ID helps callers match this result to a service.
        url_id = service.url_id()

    except Exception:
        # Not every malformed or custom service can create an ID.
        url_id = None

    try:
        # Weight normally says how many targets the service represents.
        weight = len(service)

    except Exception:
        # Count an unknown service as one target.
        weight = 1

    try:
        # Sort tags for stable output; custom tags may fail to become text.
        tag = tuple(sorted(str(t) for t in safe_attr(service, "tags", ())))

    except Exception:
        # Bad custom tags should not stop the result from being returned.
        tag = ()

    # Always return the same five fields, even when some use backups.
    return name, url, url_id, tag, weight


def service_crashed(service: NotifyBase, e: BaseException) -> NotifyResult:
    """Log an unexpected dispatch error and return a failed result.

    Service details use safe defaults so a broken plugin cannot hide the
    original failure or stop the rest of the batch.
    """
    # Gather as many safe service details as the plugin can provide.
    name, url, url_id, tag, weight = service_metadata(service)

    # Report the failure using the safe name rather than re-reading it.
    logger.warning("Notification service '%s' raised an exception.", name)
    logger.debug("Notification Exception: %s", str(e))

    # Keep the usual result shape even though no normal attempt completed.
    return NotifyResult(
        name=name,
        url=url,
        url_id=url_id,
        tag=tag,
        # A raising optional property is treated as "not optional".
        optional=safe_attr(service, "optional", False),
        weight=weight,
        max_attempts=1,
        # Add one failure because no normal attempt details are available.
        attempts=[NotifyAttempt(status=AppriseResultStatus.FAILURE)],
    )


def dispatch_crashed(e: BaseException) -> None:
    """Log a batch failure that escaped normal service handling.

    With no later priority group to try, the caller receives a failed result
    instead of the exception.
    """
    # Keep the normal message short and place details at debug level.
    logger.warning("Notification dispatch raised an exception.")
    logger.debug("Notification Exception: %s", str(e))


def compute_deadline(
    service: NotifyBase, call_deadline: Optional[float]
) -> Optional[float]:
    """Return the time when Apprise must stop waiting for one service.

    The earlier of these limits wins:

    - The service's ``service_timeout`` setting.
    - The shared deadline created by ``notify(timeout=...)`` for the call.

    The worker receives the same deadline, so time spent in a queue still
    counts. ``None`` means that neither limit is enabled.
    """
    # Read the service limit, using the normal asset default if needed.
    service_timeout = getattr(
        service.asset,
        "_service_timeout",
        AppriseAsset._service_timeout,
    )
    # Turn the number of seconds into one fixed end time.
    deadline = time.monotonic() + service_timeout if service_timeout else None
    if call_deadline is not None:
        # The first limit reached always wins.
        deadline = (
            call_deadline if deadline is None else min(deadline, call_deadline)
        )

    # TRACE keeps large batches from spamming normal DEBUG output.
    logger.trace(
        "Deadline for '%s': %s",
        safe_attr(service, "service_name", "Unknown"),
        "none"
        if deadline is None
        else "{:.3f}s from now".format(deadline - time.monotonic()),
    )
    return deadline


def timeout_result(
    service: NotifyBase,
    elapsed: float,
    max_attempts: int,
) -> NotifyResult:
    """Build a timeout result after Apprise stops waiting for a service.

    The worker may still be running. ``NotifyResult`` handles optional
    services.
    """
    # Preserve normal service details in the timeout response.
    name, url, url_id, tag, weight = service_metadata(service)

    # Record the timeout as the only attempt known to this caller.
    return NotifyResult(
        name=name,
        url=url,
        url_id=url_id,
        tag=tag,
        optional=safe_attr(service, "optional", False),
        weight=weight,
        # Preserve the configured retry count even when the outer wait wins.
        max_attempts=max_attempts,
        attempts=[
            NotifyAttempt(
                status=AppriseResultStatus.TIMEOUT,
                elapsed=elapsed,
                logs=[timeout_log_entry(name, elapsed)],
            )
        ],
    )


def timeout_log_entry(name: str, elapsed: float) -> NotifyLogEntry:
    """Log and return a consistent error entry for a service timeout."""
    # Use the same readable message in application logs and the result.
    message = f"Service '{name}' did not finish within {elapsed:.3f}s."

    # A live log_callback still sees this, but the capture does not keep a
    # copy: the caller stores the entry below on the attempt itself, and
    # keeping both would list the same timeout twice in the merged logs.
    logger.error(message, extra={"apprise_store": False})

    # Store the level as text because NotifyLogEntry is public result data.
    return NotifyLogEntry(level="ERROR", message=message)


def validate_timeout(value: Union[int, float]) -> float:
    """Validate a timeout value shared by notify()/async_notify()."""
    # Booleans are numbers in Python, but are not useful time limits.
    if not isinstance(value, (int, float)) or isinstance(value, bool):
        raise AppriseImproperlyConfigured("timeout must be an int or float.")

    # Reject negative or infinite values; zero means no call-wide limit.
    if not math.isfinite(value) or value < 0:
        raise AppriseImproperlyConfigured("timeout must be >= 0 and finite.")

    return float(value)


def aggregate_status(
    ok: bool, results: list[NotifyResult]
) -> AppriseResultStatus:
    """Combine service results into SUCCESS, PARTIAL, FAILURE, or TIMEOUT.

    A real success makes a mixed batch PARTIAL; otherwise FAILURE beats
    TIMEOUT.
    """
    if ok:
        # The dispatcher confirmed that every required service succeeded.
        return AppriseResultStatus.SUCCESS

    # Count actual deliveries, not optional services that were allowed to fail.
    if any(
        attempt.status == AppriseResultStatus.SUCCESS
        for result in results
        for attempt in result.attempts
    ):
        # At least one real delivery worked, so the batch partly succeeded.
        return AppriseResultStatus.PARTIAL

    if any(r.status == AppriseResultStatus.FAILURE for r in results):
        # A normal failure is more useful to report than a timeout.
        return AppriseResultStatus.FAILURE

    if any(r.status == AppriseResultStatus.TIMEOUT for r in results):
        # Nothing succeeded normally, but at least one service timed out.
        return AppriseResultStatus.TIMEOUT

    # Use failure when no more specific result explains the call.
    return AppriseResultStatus.FAILURE


def template_status(
    status: AppriseResultStatus,
    skipped: list,
) -> AppriseResultStatus:
    """Prevent skipped template entries from reporting a clean success."""
    if not skipped:
        # Nothing was skipped, so the original status is complete.
        return status

    if status == AppriseResultStatus.SUCCESS:
        # Delivered entries succeeded, but the full request was incomplete.
        return AppriseResultStatus.PARTIAL

    if status == AppriseResultStatus.NOMATCH:
        # Every matching template entry was skipped before dispatch.
        return AppriseResultStatus.FAILURE

    return status


def resolve_retry_count(service: NotifyBase, kwargs: dict[str, Any]) -> int:
    """Consume a retry override and clamp it to the plugin URL limit."""
    # Pop first so a valid override does not read a broken plugin property.
    retry = kwargs.pop("_retry_override", None)
    if retry is None:
        # No override, so fall back to the service's normal retry count.
        retry = safe_attr(service, "retry", 0)

    try:
        # Accept numeric text. Infinity raises OverflowError during conversion.
        retry = int(retry)

    except (TypeError, ValueError, OverflowError):
        # If the override is invalid, try the service's configured value.
        try:
            retry = int(safe_attr(service, "retry", 0))

        except (TypeError, ValueError, OverflowError):
            # Neither value is a number; fall back to no retries at all.
            retry = 0
    # Never allow a negative or unexpectedly large retry loop.
    return max(0, min(retry, APPRISE_MAX_SERVICE_RETRY))


def configured_max_attempts(
    service: NotifyBase, kwargs: dict[str, Any]
) -> int:
    """Return the attempt limit without consuming the worker's override."""
    # Resolve a copy so the worker receives the original private override.
    return resolve_retry_count(service, dict(kwargs)) + 1


def finalize_service_result(
    service: NotifyBase,
    retry: int,
    attempts: list[NotifyAttempt],
) -> tuple[bool, NotifyResult]:
    """Build one service result from its completed delivery attempts."""
    # Optional services can fail quietly, but keep a log breadcrumb.
    optional = safe_attr(service, "optional", False)
    succeeded = any(a.status == AppriseResultStatus.SUCCESS for a in attempts)

    # Read plugin details only after every attempt has finished.
    name, url, url_id, tag, weight = service_metadata(service)

    if not succeeded and optional:
        logger.info(
            "Optional service '%s' did not send successfully; continuing.",
            name,
        )

    # Combine service details with the ordered list of attempts.
    notify_result = NotifyResult(
        name=name,
        url=url,
        url_id=url_id,
        tag=tag,
        optional=optional,
        weight=weight,
        max_attempts=retry + 1,
        attempts=attempts,
    )

    # Return both the convenient boolean and the detailed result.
    return bool(notify_result), notify_result


class CallState:
    """Everything one notify() or async_notify() call shares.

    Both entry points settle their options, take the same early exits,
    escalate the same way, and build their results the same way. Only the
    dispatch of a batch differs, so that is all each one keeps for itself.

    This is the outermost of three tiers: one whole call here, one
    priority chain in ``TagChain``, one service's attempts in
    ``RetryRunner``. Tag filtering stays with the ``Apprise`` instance,
    so the few helpers needed for it are reached through ``apprise``.
    """

    __slots__ = (
        "apprise",
        "capture",
        "chains",
        "deadline",
        "log_callback",
        "log_level",
        "results",
        "skipped",
        "start",
        "tag",
    )

    def __init__(
        self,
        apprise: Apprise,
        tag: Any,
        timeout: Union[int, float],
        log_callback: Optional[
            Callable[[NotifyLogEntry, Optional[NotifyBase]], None]
        ],
        log_level: Optional[int],
    ) -> None:
        """Settle every per-call option the two entry points share."""
        # Reject an unusable time limit before any work begins.
        timeout = validate_timeout(timeout)

        # The instance being notified, and the filter it was given.
        self.apprise = apprise
        self.tag = tag

        # A value passed to this call wins over the instance default.
        self.log_callback = (
            log_callback if log_callback is not None else apprise._log_callback
        )
        self.log_level = apprise._resolve_call_level(
            log_level if log_level is not None else apprise._log_level,
            self.log_callback,
        )

        # Entries held back because a template value was never supplied.
        self.skipped: list[NotifyBase] = []

        # Every NotifyResult dispatched across every chain and priority
        # group, in the order each batch was run.
        self.results: list[NotifyResult] = []

        # The escalation chains; escalate() fills this in.
        self.chains: list[TagChain] = []

        # Wall-clock start for AppriseResult.elapsed -- covers the entire
        # call, including argument validation, not just service dispatch.
        self.start = time.monotonic()

        # Apply the call timeout without replacing each service's own limit.
        self.deadline: Optional[float] = (
            self.start + timeout if timeout else None
        )

        # Capture orchestration logs not owned by a service attempt.
        # The capture reads its limits from the asset already held by Apprise.
        self.capture = _ServiceLogCapture(
            service=None,
            log_callback=self.log_callback,
            level=self.log_level,
            memory_size=apprise.asset.result_log_memory_size,
            disk_size=apprise.asset.result_log_disk_size,
        )

    def __enter__(self) -> CallState:
        """Begin capturing this call's orchestration logs."""
        # The capture stays attached for the whole call, early exits included.
        self.capture.__enter__()
        return self

    def __exit__(self, *args: object) -> None:
        """Stop capturing once the call is over."""
        self.capture.__exit__(*args)

    def result(self, status: AppriseResultStatus) -> AppriseResult:
        """Build this call's result, timed from when the call started."""
        # A skipped template entry keeps a clean success from being reported.
        return AppriseResult(
            status=template_status(status, self.skipped),
            results=self.results,
            elapsed=time.monotonic() - self.start,
            call_logs=self.capture.entries,
        )

    def prepare(self, all_calls: list[ServiceCall]) -> list[ServiceCall]:
        """Apply the per-call overrides every service call carries."""
        # The first retry suffix its tag filter matches wins per service.
        all_calls = self.apprise._inject_per_service_retries(
            all_calls, self.tag
        )

        # Every service is told the capture level, and the callback when
        # one is active.  Build the pair once, outside the rebuild below.
        internal: dict[str, Any] = {"_log_level": self.log_level}
        if self.log_callback is not None:
            internal["_log_callback"] = self.log_callback

        # One pass rebuilds each service's kwargs with both keys added.
        return [
            (service, dict(kwargs, **internal))
            for service, kwargs in all_calls
        ]

    def escalate(self, all_calls: list[ServiceCall]) -> None:
        """Turn the matched services into independent escalation chains."""
        # Each OR tag becomes its own chain, starting at its top priority.
        chains = self.apprise._build_tag_chains(all_calls, self.tag)
        self.chains = [TagChain(key, groups) for key, groups in chains.items()]

    def rounds(self) -> Iterator[list[TagChain]]:
        """Yield each round of chains that still have a group to try.

        The caller dispatches the chains it is handed and reports each one
        back through ``settle()``, then builds its result with ``finish()``.
        """
        while True:
            if self.apprise.asset.abort_on_chain_failure and any(
                not chain.succeeded and chain.exhausted
                for chain in self.chains
            ):
                # Stop as soon as one chain is out of priority groups.  The
                # default instead lets every chain run to completion, so
                # every defined URL gets an attempt.
                return

            active = [chain for chain in self.chains if chain.pending]
            if not active:
                # Every chain has either succeeded or been exhausted.
                return

            yield active

    def settle(self, chain: TagChain, outcome: BatchOutcome) -> None:
        """Record one chain's batch, whether it ran or crashed.

        ``outcome`` is the ``(ok, results)`` the dispatch returned, or the
        exception it raised.
        """
        if isinstance(outcome, BaseException):
            # Safety net; a crash escalates like a failure.
            chain.crashed(outcome)
            return

        ok, batch_results = outcome
        self.results.extend(batch_results)
        chain.settle(ok)

    def unprepared(self, e: Exception) -> AppriseResult:
        """Explain a call that never reached a service, and fail it.

        This is for a problem with the call itself: a bad argument, or a
        message Apprise cannot use. A single service that fails is
        reported against that service instead and never comes here.
        """
        # Say what went wrong; a silent FAILURE is impossible to diagnose.
        logger.warning("Could not prepare the notification: %s", e)
        logger.debug("Notification Exception: %r", e)
        return self.result(AppriseResultStatus.FAILURE)

    def flat(self, outcome: BatchOutcome) -> AppriseResult:
        """Build the result for one batch sent without escalation."""
        if isinstance(outcome, BaseException):
            # Safety net; report the crash instead of raising it.
            dispatch_crashed(outcome)
            outcome = (False, [])

        ok, results = outcome
        self.results.extend(results)
        return self.result(aggregate_status(ok, self.results))

    def finish(self) -> AppriseResult:
        """Build the result once the chains have nothing left to run."""
        # A chain that never succeeded leaves the whole call unsuccessful.
        success = all(chain.succeeded for chain in self.chains)
        return self.result(aggregate_status(success, self.results))


class TagChain:
    """Track service groups as they move through a priority chain.

    The chain stops after its first successful group.
    """

    __slots__ = ("groups", "index", "key", "priorities", "succeeded")

    def __init__(self, key: str, groups: dict[int, list]) -> None:
        """Prepare one chain from its priority groups."""
        # The OR tag this chain covers. "" represents the catch-all chain.
        self.key = key

        # Its service groups, and those group priorities in order.
        self.groups = groups
        self.priorities = sorted(groups)

        # Where the chain sits now, and whether it is finished.
        self.index = 0
        self.succeeded = False

    @property
    def exhausted(self) -> bool:
        """True once every priority group has been tried."""
        # The index moves forward once for every failed group.
        return self.index >= len(self.priorities)

    @property
    def pending(self) -> bool:
        """True while this chain still has a group left to try."""
        # A successful or exhausted chain has no more work.
        return not self.succeeded and not self.exhausted

    @property
    def priority(self) -> int:
        """Priority of the group this chain will try next."""
        # Priorities were sorted when the chain was created.
        return self.priorities[self.index]

    @property
    def batch(self) -> list:
        """Services in the group this chain will try next."""
        # Look up the group selected by the current priority.
        return self.groups[self.priority]

    def settle(self, ok: bool) -> None:
        """Record how the current group did.

        A success finishes the chain.  A failure moves it on to the next,
        less urgent, priority group.
        """
        if ok:
            # A successful group completes this chain immediately.
            logger.trace(
                "Chain '%s' priority group %s succeeded.",
                self.key,
                self.priority,
            )
            self.succeeded = True
            return

        # A failed group allows the next, less urgent group to run.
        logger.trace(
            "Chain '%s' priority group %s failed; escalating.",
            self.key,
            self.priority,
        )
        self.index += 1

    def crashed(self, e: BaseException) -> None:
        """Record a group that raised, and move the chain along."""
        # Treat an unexpected error like a failed priority group.
        logger.warning(
            "Notification chain '%s' priority group %s raised an exception.",
            self.key,
            self.priority,
        )
        logger.debug("Notification Exception: %s", str(e))
        self.index += 1


class RetryRunner:
    """Track one service's attempts for both delivery modes.

    The caller runs the service and waits between attempts.
    """

    def __init__(
        self,
        service: NotifyBase,
        kwargs: dict[str, Any],
        deadline: Optional[float],
    ) -> None:
        """Prepare the retry options for one service call."""
        # The service being notified, and the caller's absolute time limit.
        self.service = service
        self.deadline = deadline

        # Read the name once so a failing plugin property cannot break later
        # log messages.
        self.name = safe_attr(service, "service_name", "Unknown")

        # How many extra tries are allowed, and the pause between them.
        self.retry = resolve_retry_count(service, kwargs)
        self.wait = safe_attr(service, "wait", 0.0)

        # Pop the per-call overrides so they stay internal.
        self.log_callback = kwargs.pop("_log_callback", None)
        self.log_level = kwargs.pop("_log_level", None)

        # Every call actually made, in order.
        self.attempts: list[NotifyAttempt] = []

        # Remember successful targets only while retries are active.
        self._token = _delivery_tracker.set(set()) if self.retry else None

        # Somewhere for a plugin to park work its own retries can reuse.
        self._memo_token = _delivery_memo.set({}) if self.retry else None

    @property
    def total(self) -> int:
        """Total attempts allowed, counting the first one."""
        # retry counts only extra tries, so include the original call.
        return self.retry + 1

    def begin(self, attempt: int) -> Optional[float]:
        """Start an attempt, or record TIMEOUT and return ``None`` if late."""
        # Do not start new delivery work after the caller's time limit.
        if self.deadline is not None and time.monotonic() >= self.deadline:
            logger.trace(
                "Deadline already passed for '%s'; skipping attempt %d/%d.",
                self.name,
                attempt + 1,
                self.total,
            )
            # No call began, so there is no delivery time to record.
            self.attempts.append(
                NotifyAttempt(
                    status=AppriseResultStatus.TIMEOUT,
                    logs=[timeout_log_entry(self.name, 0.0)],
                )
            )
            return None

        # Save a start time so the result can report the attempt's duration.
        logger.trace(
            "Starting attempt %d/%d for '%s'.",
            attempt + 1,
            self.total,
            self.name,
        )
        return time.monotonic()

    def capture(self) -> _ServiceLogCapture:
        """Build the log capture that wraps a single attempt."""
        # Use WARNING unless the caller requested another capture level.
        return _ServiceLogCapture(
            self.service,
            log_callback=self.log_callback,
            level=(
                self.log_level
                if self.log_level is not None
                else logging.WARNING
            ),
        )

    def crashed(self, e: Exception) -> None:
        """Log a plugin that raised, so it counts as a failed attempt."""
        # Keep the main message short and the exception detail at DEBUG.
        logger.warning(
            "Notification service '%s' raised an exception.",
            self.name,
        )
        logger.debug("Notification Exception: %s", str(e))

    def record(
        self,
        attempt: int,
        result: bool,
        started: float,
        capture: _ServiceLogCapture,
    ) -> bool:
        """Store an attempt and return whether the caller can stop early."""
        # Measure the service call without including the earlier retry wait.
        elapsed = time.monotonic() - started
        logger.trace(
            "Attempt %d/%d for '%s' finished in %.3fs: %s.",
            attempt + 1,
            self.total,
            self.name,
            elapsed,
            "success" if result else "failure",
        )
        # Keep the outcome and any logs captured while this attempt ran.
        self.attempts.append(
            NotifyAttempt(
                # Convert the plugin's True/False answer to a result status.
                status=(
                    AppriseResultStatus.SUCCESS
                    if result
                    else AppriseResultStatus.FAILURE
                ),
                elapsed=elapsed,
                logs=capture.entries,
            )
        )

        # True tells the retry loop that no more attempts are needed.
        return bool(result)

    def delay(self, attempt: int) -> float:
        """Return the retry delay without waiting past the deadline.

        Zero means no wait, including after the final attempt.
        """
        if attempt >= self.retry:
            # That was the last try, so there is nothing to announce.
            return 0.0

        logger.warning(
            "Attempt %d/%d for '%s' failed; trying again.",
            attempt + 1,
            self.total,
            self.name,
        )

        if self.wait <= 0:
            # A zero wait starts the next attempt immediately.
            return 0.0

        if self.deadline is None:
            # With no time limit, use the full configured wait.
            return self.wait

        # Shorten the wait when the deadline will arrive first.
        return min(self.wait, max(0.0, self.deadline - time.monotonic()))

    def close(self) -> None:
        """Drop the delivery tracker so it cannot outlive this call."""
        if self._token is not None:
            # Restore the previous tracking state for this thread or task.
            _delivery_tracker.reset(self._token)

        if self._memo_token is not None:
            # The notification is over; its working state goes with it.
            _delivery_memo.reset(self._memo_token)

    def result(self) -> tuple[bool, NotifyResult]:
        """Return the finished (success, NotifyResult) pair."""
        # All attempts are now complete and ready for the public result.
        return finalize_service_result(self.service, self.retry, self.attempts)


def prepared_failure(
    service: NotifyBase, kwargs: dict[str, Any]
) -> Optional[tuple[bool, NotifyResult]]:
    """Return a failed result for a service that never became callable.

    ``None`` means the service is ready and should be delivered normally.
    """
    # The error rides along with the call rather than being reported when
    # it happened, so a fallback an escalation never reaches is never
    # blamed for it.
    error = kwargs.pop("_prepare_error", None)
    if error is None:
        return None

    # Report it exactly like a plugin that raised while being called, so
    # an optional service stays optional and a chain still escalates.
    notify_result = service_crashed(service, error)
    return bool(notify_result), notify_result


def call_with_retry(
    service: NotifyBase,
    kwargs: dict[str, Any],
    deadline: Optional[float],
) -> tuple[bool, NotifyResult]:
    """Run one service with retries, logging, and a fixed end time.

    Ordered and worker-thread delivery share this path.
    """
    # A service that could not be prepared is never called at all.
    failed = prepared_failure(service, kwargs)
    if failed is not None:
        return failed

    # Keep shared retry state in one small helper object.
    runner = RetryRunner(service, kwargs, deadline)
    try:
        # The first pass is normal delivery; later passes are retries.
        for attempt in range(runner.total):
            started = runner.begin(attempt)
            if started is None:
                break

            # Treat validation errors and plugin crashes alike: report
            # them, then let the next attempt still get a turn.
            with runner.capture() as capture:
                try:
                    result = service.notify(**kwargs)

                except Exception as e:
                    runner.crashed(e)
                    result = False

            if runner.record(attempt, result, started, capture):
                # A successful delivery ends the retry loop.
                break

            # Wait only when another attempt remains and time allows it.
            delay = runner.delay(attempt)
            if delay > 0:
                time.sleep(delay)

    finally:
        # Always clean up tracking, even after an unexpected exception.
        runner.close()

    # Build the public result from every attempt made above.
    return runner.result()
caronc-apprise-dfec414/apprise/emojis.py000066400000000000000000002544461526720371000204410ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import re
import time

from .logger import logger

# All Emoji's are wrapped in this character
DELIM = ":"

# the map simply contains the emoji that should be mapped to the regular
# expression it should be swapped on.
# This list was based on: https://github.com/ikatyang/emoji-cheat-sheet
EMOJI_MAP = {
    #
    # Face Smiling
    #
    DELIM + r"grinning" + DELIM: "😄",
    DELIM + r"smile" + DELIM: "😄",
    DELIM + r"(laughing|satisfied)" + DELIM: "😆",
    DELIM + r"rofl" + DELIM: "🤣",
    DELIM + r"slightly_smiling_face" + DELIM: "🙂",
    DELIM + r"wink" + DELIM: "😉",
    DELIM + r"innocent" + DELIM: "😇",
    DELIM + r"smiley" + DELIM: "😃",
    DELIM + r"grin" + DELIM: "😃",
    DELIM + r"sweat_smile" + DELIM: "😅",
    DELIM + r"joy" + DELIM: "😂",
    DELIM + r"upside_down_face" + DELIM: "🙃",
    DELIM + r"blush" + DELIM: "😊",
    #
    # Face Affection
    #
    DELIM + r"smiling_face_with_three_hearts" + DELIM: "🥰",
    DELIM + r"star_struck" + DELIM: "🤩",
    DELIM + r"kissing" + DELIM: "😗",
    DELIM + r"kissing_closed_eyes" + DELIM: "😚",
    DELIM + r"smiling_face_with_tear" + DELIM: "🥲",
    DELIM + r"heart_eyes" + DELIM: "😍",
    DELIM + r"kissing_heart" + DELIM: "😘",
    DELIM + r"relaxed" + DELIM: "☺️",
    DELIM + r"kissing_smiling_eyes" + DELIM: "😙",
    #
    # Face Tongue
    #
    DELIM + r"yum" + DELIM: "😋",
    DELIM + r"stuck_out_tongue_winking_eye" + DELIM: "😜",
    DELIM + r"stuck_out_tongue_closed_eyes" + DELIM: "😝",
    DELIM + r"stuck_out_tongue" + DELIM: "😛",
    DELIM + r"zany_face" + DELIM: "🤪",
    DELIM + r"money_mouth_face" + DELIM: "🤑",
    #
    # Face Hand
    #
    DELIM + r"hugs" + DELIM: "🤗",
    DELIM + r"shushing_face" + DELIM: "🤫",
    DELIM + r"hand_over_mouth" + DELIM: "🤭",
    DELIM + r"thinking" + DELIM: "🤔",
    #
    # Face Neutral Skeptical
    #
    DELIM + r"zipper_mouth_face" + DELIM: "🤐",
    DELIM + r"neutral_face" + DELIM: "😐",
    DELIM + r"no_mouth" + DELIM: "😶",
    DELIM + r"smirk" + DELIM: "😏",
    DELIM + r"roll_eyes" + DELIM: "🙄",
    DELIM + r"face_exhaling" + DELIM: "😮‍💨",
    DELIM + r"raised_eyebrow" + DELIM: "🤨",
    DELIM + r"expressionless" + DELIM: "😑",
    DELIM + r"face_in_clouds" + DELIM: "😶‍🌫️",
    DELIM + r"unamused" + DELIM: "😒",
    DELIM + r"grimacing" + DELIM: "😬",
    DELIM + r"lying_face" + DELIM: "🤥",
    #
    # Face Sleepy
    #
    DELIM + r"relieved" + DELIM: "😌",
    DELIM + r"sleepy" + DELIM: "😪",
    DELIM + r"sleeping" + DELIM: "😴",
    DELIM + r"pensive" + DELIM: "😔",
    DELIM + r"drooling_face" + DELIM: "🤤",
    #
    # Face Unwell
    #
    DELIM + r"mask" + DELIM: "😷",
    DELIM + r"face_with_head_bandage" + DELIM: "🤕",
    DELIM + r"vomiting_face" + DELIM: "🤮",
    DELIM + r"hot_face" + DELIM: "🥵",
    DELIM + r"woozy_face" + DELIM: "🥴",
    DELIM + r"face_with_spiral_eyes" + DELIM: "😵‍💫",
    DELIM + r"face_with_thermometer" + DELIM: "🤒",
    DELIM + r"nauseated_face" + DELIM: "🤢",
    DELIM + r"sneezing_face" + DELIM: "🤧",
    DELIM + r"cold_face" + DELIM: "🥶",
    DELIM + r"dizzy_face" + DELIM: "😵",
    DELIM + r"exploding_head" + DELIM: "🤯",
    #
    # Face Hat
    #
    DELIM + r"cowboy_hat_face" + DELIM: "🤠",
    DELIM + r"disguised_face" + DELIM: "🥸",
    DELIM + r"partying_face" + DELIM: "🥳",
    #
    # Face Glasses
    #
    DELIM + r"sunglasses" + DELIM: "😎",
    DELIM + r"monocle_face" + DELIM: "🧐",
    DELIM + r"nerd_face" + DELIM: "🤓",
    #
    # Face Concerned
    #
    DELIM + r"confused" + DELIM: "😕",
    DELIM + r"slightly_frowning_face" + DELIM: "🙁",
    DELIM + r"open_mouth" + DELIM: "😮",
    DELIM + r"astonished" + DELIM: "😲",
    DELIM + r"pleading_face" + DELIM: "🥺",
    DELIM + r"anguished" + DELIM: "😧",
    DELIM + r"cold_sweat" + DELIM: "😰",
    DELIM + r"cry" + DELIM: "😢",
    DELIM + r"scream" + DELIM: "😱",
    DELIM + r"persevere" + DELIM: "😣",
    DELIM + r"sweat" + DELIM: "😓",
    DELIM + r"tired_face" + DELIM: "😫",
    DELIM + r"worried" + DELIM: "😟",
    DELIM + r"frowning_face" + DELIM: "☹️",
    DELIM + r"hushed" + DELIM: "😯",
    DELIM + r"flushed" + DELIM: "😳",
    DELIM + r"frowning" + DELIM: "😦",
    DELIM + r"fearful" + DELIM: "😨",
    DELIM + r"disappointed_relieved" + DELIM: "😥",
    DELIM + r"sob" + DELIM: "😭",
    DELIM + r"confounded" + DELIM: "😖",
    DELIM + r"disappointed" + DELIM: "😞",
    DELIM + r"weary" + DELIM: "😩",
    DELIM + r"yawning_face" + DELIM: "🥱",
    #
    # Face Negative
    #
    DELIM + r"triumph" + DELIM: "😤",
    DELIM + r"angry" + DELIM: "😠",
    DELIM + r"smiling_imp" + DELIM: "😈",
    DELIM + r"skull" + DELIM: "💀",
    DELIM + r"(pout|rage)" + DELIM: "😡",
    DELIM + r"cursing_face" + DELIM: "🤬",
    DELIM + r"imp" + DELIM: "👿",
    DELIM + r"skull_and_crossbones" + DELIM: "☠️",
    #
    # Face Costume
    #
    DELIM + r"(hankey|poop|shit)" + DELIM: "💩",
    DELIM + r"japanese_ogre" + DELIM: "👹",
    DELIM + r"ghost" + DELIM: "👻",
    DELIM + r"space_invader" + DELIM: "👾",
    DELIM + r"clown_face" + DELIM: "🤡",
    DELIM + r"japanese_goblin" + DELIM: "👺",
    DELIM + r"alien" + DELIM: "👽",
    DELIM + r"robot" + DELIM: "🤖",
    #
    # Cat Face
    #
    DELIM + r"smiley_cat" + DELIM: "😺",
    DELIM + r"joy_cat" + DELIM: "😹",
    DELIM + r"smirk_cat" + DELIM: "😼",
    DELIM + r"scream_cat" + DELIM: "🙀",
    DELIM + r"pouting_cat" + DELIM: "😾",
    DELIM + r"smile_cat" + DELIM: "😸",
    DELIM + r"heart_eyes_cat" + DELIM: "😻",
    DELIM + r"kissing_cat" + DELIM: "😽",
    DELIM + r"crying_cat_face" + DELIM: "😿",
    #
    # Monkey Face
    #
    DELIM + r"see_no_evil" + DELIM: "🙈",
    DELIM + r"speak_no_evil" + DELIM: "🙊",
    DELIM + r"hear_no_evil" + DELIM: "🙉",
    #
    # Heart
    #
    DELIM + r"love_letter" + DELIM: "💌",
    DELIM + r"gift_heart" + DELIM: "💝",
    DELIM + r"heartpulse" + DELIM: "💗",
    DELIM + r"revolving_hearts" + DELIM: "💞",
    DELIM + r"heart_decoration" + DELIM: "💟",
    DELIM + r"broken_heart" + DELIM: "💔",
    DELIM + r"mending_heart" + DELIM: "❤️‍🩹",
    DELIM + r"orange_heart" + DELIM: "🧡",
    DELIM + r"green_heart" + DELIM: "💚",
    DELIM + r"purple_heart" + DELIM: "💜",
    DELIM + r"black_heart" + DELIM: "🖤",
    DELIM + r"cupid" + DELIM: "💘",
    DELIM + r"sparkling_heart" + DELIM: "💖",
    DELIM + r"heartbeat" + DELIM: "💓",
    DELIM + r"two_hearts" + DELIM: "💕",
    DELIM + r"heavy_heart_exclamation" + DELIM: "❣️",
    DELIM + r"heart_on_fire" + DELIM: "❤️‍🔥",
    DELIM + r"heart" + DELIM: "❤️",
    DELIM + r"yellow_heart" + DELIM: "💛",
    DELIM + r"blue_heart" + DELIM: "💙",
    DELIM + r"brown_heart" + DELIM: "🤎",
    DELIM + r"white_heart" + DELIM: "🤍",
    #
    # Emotion
    #
    DELIM + r"kiss" + DELIM: "💋",
    DELIM + r"anger" + DELIM: "💢",
    DELIM + r"dizzy" + DELIM: "💫",
    DELIM + r"dash" + DELIM: "💨",
    DELIM + r"speech_balloon" + DELIM: "💬",
    DELIM + r"left_speech_bubble" + DELIM: "🗨️",
    DELIM + r"thought_balloon" + DELIM: "💭",
    DELIM + r"100" + DELIM: "💯",
    DELIM + r"(boom|collision)" + DELIM: "💥",
    DELIM + r"sweat_drops" + DELIM: "💦",
    DELIM + r"hole" + DELIM: "🕳️",
    DELIM + r"eye_speech_bubble" + DELIM: "👁️‍🗨️",
    DELIM + r"right_anger_bubble" + DELIM: "🗯️",
    DELIM + r"zzz" + DELIM: "💤",
    #
    # Hand Fingers Open
    #
    DELIM + r"wave" + DELIM: "👋",
    DELIM + r"raised_hand_with_fingers_splayed" + DELIM: "🖐️",
    DELIM + r"vulcan_salute" + DELIM: "🖖",
    DELIM + r"raised_back_of_hand" + DELIM: "🤚",
    DELIM + r"(raised_)?hand" + DELIM: "✋",
    #
    # Hand Fingers Partial
    #
    DELIM + r"ok_hand" + DELIM: "👌",
    DELIM + r"pinched_fingers" + DELIM: "🤌",
    DELIM + r"pinching_hand" + DELIM: "🤏",
    DELIM + r"v" + DELIM: "✌️",
    DELIM + r"crossed_fingers" + DELIM: "🤞",
    DELIM + r"love_you_gesture" + DELIM: "🤟",
    DELIM + r"metal" + DELIM: "🤘",
    DELIM + r"call_me_hand" + DELIM: "🤙",
    #
    # Hand Single Finger
    #
    DELIM + r"point_left" + DELIM: "👈",
    DELIM + r"point_right" + DELIM: "👉",
    DELIM + r"point_up_2" + DELIM: "👆",
    DELIM + r"(fu|middle_finger)" + DELIM: "🖕",
    DELIM + r"point_down" + DELIM: "👇",
    DELIM + r"point_up" + DELIM: "☝️",
    #
    # Hand Fingers Closed
    #
    DELIM + r"(\+1|thumbsup)" + DELIM: "👍",
    DELIM + r"(-1|thumbsdown)" + DELIM: "👎",
    DELIM + r"fist" + DELIM: "✊",
    DELIM + r"(fist_(raised|oncoming)|(face)?punch)" + DELIM: "👊",
    DELIM + r"fist_left" + DELIM: "🤛",
    DELIM + r"fist_right" + DELIM: "🤜",
    #
    # Hands
    #
    DELIM + r"clap" + DELIM: "👏",
    DELIM + r"raised_hands" + DELIM: "🙌",
    DELIM + r"open_hands" + DELIM: "👐",
    DELIM + r"palms_up_together" + DELIM: "🤲",
    DELIM + r"handshake" + DELIM: "🤝",
    DELIM + r"pray" + DELIM: "🙏",
    #
    # Hand Prop
    #
    DELIM + r"writing_hand" + DELIM: "✍️",
    DELIM + r"nail_care" + DELIM: "💅",
    DELIM + r"selfie" + DELIM: "🤳",
    #
    # Body Parts
    #
    DELIM + r"muscle" + DELIM: "💪",
    DELIM + r"mechanical_arm" + DELIM: "🦾",
    DELIM + r"mechanical_leg" + DELIM: "🦿",
    DELIM + r"leg" + DELIM: "🦵",
    DELIM + r"foot" + DELIM: "🦶",
    DELIM + r"ear" + DELIM: "👂",
    DELIM + r"ear_with_hearing_aid" + DELIM: "🦻",
    DELIM + r"nose" + DELIM: "👃",
    DELIM + r"brain" + DELIM: "🧠",
    DELIM + r"anatomical_heart" + DELIM: "🫀",
    DELIM + r"lungs" + DELIM: "🫁",
    DELIM + r"tooth" + DELIM: "🦷",
    DELIM + r"bone" + DELIM: "🦴",
    DELIM + r"eyes" + DELIM: "👀",
    DELIM + r"eye" + DELIM: "👁️",
    DELIM + r"tongue" + DELIM: "👅",
    DELIM + r"lips" + DELIM: "👄",
    #
    # Person
    #
    DELIM + r"baby" + DELIM: "👶",
    DELIM + r"child" + DELIM: "🧒",
    DELIM + r"boy" + DELIM: "👦",
    DELIM + r"girl" + DELIM: "👧",
    DELIM + r"adult" + DELIM: "🧑",
    DELIM + r"blond_haired_person" + DELIM: "👱",
    DELIM + r"man" + DELIM: "👨",
    DELIM + r"bearded_person" + DELIM: "🧔",
    DELIM + r"man_beard" + DELIM: "🧔‍♂️",
    DELIM + r"woman_beard" + DELIM: "🧔‍♀️",
    DELIM + r"red_haired_man" + DELIM: "👨‍🦰",
    DELIM + r"curly_haired_man" + DELIM: "👨‍🦱",
    DELIM + r"white_haired_man" + DELIM: "👨‍🦳",
    DELIM + r"bald_man" + DELIM: "👨‍🦲",
    DELIM + r"woman" + DELIM: "👩",
    DELIM + r"red_haired_woman" + DELIM: "👩‍🦰",
    DELIM + r"person_red_hair" + DELIM: "🧑‍🦰",
    DELIM + r"curly_haired_woman" + DELIM: "👩‍🦱",
    DELIM + r"person_curly_hair" + DELIM: "🧑‍🦱",
    DELIM + r"white_haired_woman" + DELIM: "👩‍🦳",
    DELIM + r"person_white_hair" + DELIM: "🧑‍🦳",
    DELIM + r"bald_woman" + DELIM: "👩‍🦲",
    DELIM + r"person_bald" + DELIM: "🧑‍🦲",
    DELIM + r"blond_(haired_)?woman" + DELIM: "👱‍♀️",
    DELIM + r"blond_haired_man" + DELIM: "👱‍♂️",
    DELIM + r"older_adult" + DELIM: "🧓",
    DELIM + r"older_man" + DELIM: "👴",
    DELIM + r"older_woman" + DELIM: "👵",
    #
    # Person Gesture
    #
    DELIM + r"frowning_person" + DELIM: "🙍",
    DELIM + r"frowning_man" + DELIM: "🙍‍♂️",
    DELIM + r"frowning_woman" + DELIM: "🙍‍♀️",
    DELIM + r"pouting_face" + DELIM: "🙎",
    DELIM + r"pouting_man" + DELIM: "🙎‍♂️",
    DELIM + r"pouting_woman" + DELIM: "🙎‍♀️",
    DELIM + r"no_good" + DELIM: "🙅",
    DELIM + r"(ng|no_good)_man" + DELIM: "🙅‍♂️",
    DELIM + r"(ng_woman|no_good_woman)" + DELIM: "🙅‍♀️",
    DELIM + r"ok_person" + DELIM: "🙆",
    DELIM + r"ok_man" + DELIM: "🙆‍♂️",
    DELIM + r"ok_woman" + DELIM: "🙆‍♀️",
    DELIM + r"(information_desk|tipping_hand_)person" + DELIM: "💁",
    DELIM + r"(sassy_man|tipping_hand_man)" + DELIM: "💁‍♂️",
    DELIM + r"(sassy_woman|tipping_hand_woman)" + DELIM: "💁‍♀️",
    DELIM + r"raising_hand" + DELIM: "🙋",
    DELIM + r"raising_hand_man" + DELIM: "🙋‍♂️",
    DELIM + r"raising_hand_woman" + DELIM: "🙋‍♀️",
    DELIM + r"deaf_person" + DELIM: "🧏",
    DELIM + r"deaf_man" + DELIM: "🧏‍♂️",
    DELIM + r"deaf_woman" + DELIM: "🧏‍♀️",
    DELIM + r"bow" + DELIM: "🙇",
    DELIM + r"bowing_man" + DELIM: "🙇‍♂️",
    DELIM + r"bowing_woman" + DELIM: "🙇‍♀️",
    DELIM + r"facepalm" + DELIM: "🤦",
    DELIM + r"man_facepalming" + DELIM: "🤦‍♂️",
    DELIM + r"woman_facepalming" + DELIM: "🤦‍♀️",
    DELIM + r"shrug" + DELIM: "🤷",
    DELIM + r"man_shrugging" + DELIM: "🤷‍♂️",
    DELIM + r"woman_shrugging" + DELIM: "🤷‍♀️",
    #
    # Person Role
    #
    DELIM + r"health_worker" + DELIM: "🧑‍⚕️",
    DELIM + r"man_health_worker" + DELIM: "👨‍⚕️",
    DELIM + r"woman_health_worker" + DELIM: "👩‍⚕️",
    DELIM + r"student" + DELIM: "🧑‍🎓",
    DELIM + r"man_student" + DELIM: "👨‍🎓",
    DELIM + r"woman_student" + DELIM: "👩‍🎓",
    DELIM + r"teacher" + DELIM: "🧑‍🏫",
    DELIM + r"man_teacher" + DELIM: "👨‍🏫",
    DELIM + r"woman_teacher" + DELIM: "👩‍🏫",
    DELIM + r"judge" + DELIM: "🧑‍⚖️",
    DELIM + r"man_judge" + DELIM: "👨‍⚖️",
    DELIM + r"woman_judge" + DELIM: "👩‍⚖️",
    DELIM + r"farmer" + DELIM: "🧑‍🌾",
    DELIM + r"man_farmer" + DELIM: "👨‍🌾",
    DELIM + r"woman_farmer" + DELIM: "👩‍🌾",
    DELIM + r"cook" + DELIM: "🧑‍🍳",
    DELIM + r"man_cook" + DELIM: "👨‍🍳",
    DELIM + r"woman_cook" + DELIM: "👩‍🍳",
    DELIM + r"mechanic" + DELIM: "🧑‍🔧",
    DELIM + r"man_mechanic" + DELIM: "👨‍🔧",
    DELIM + r"woman_mechanic" + DELIM: "👩‍🔧",
    DELIM + r"factory_worker" + DELIM: "🧑‍🏭",
    DELIM + r"man_factory_worker" + DELIM: "👨‍🏭",
    DELIM + r"woman_factory_worker" + DELIM: "👩‍🏭",
    DELIM + r"office_worker" + DELIM: "🧑‍💼",
    DELIM + r"man_office_worker" + DELIM: "👨‍💼",
    DELIM + r"woman_office_worker" + DELIM: "👩‍💼",
    DELIM + r"scientist" + DELIM: "🧑‍🔬",
    DELIM + r"man_scientist" + DELIM: "👨‍🔬",
    DELIM + r"woman_scientist" + DELIM: "👩‍🔬",
    DELIM + r"technologist" + DELIM: "🧑‍💻",
    DELIM + r"man_technologist" + DELIM: "👨‍💻",
    DELIM + r"woman_technologist" + DELIM: "👩‍💻",
    DELIM + r"singer" + DELIM: "🧑‍🎤",
    DELIM + r"man_singer" + DELIM: "👨‍🎤",
    DELIM + r"woman_singer" + DELIM: "👩‍🎤",
    DELIM + r"artist" + DELIM: "🧑‍🎨",
    DELIM + r"man_artist" + DELIM: "👨‍🎨",
    DELIM + r"woman_artist" + DELIM: "👩‍🎨",
    DELIM + r"pilot" + DELIM: "🧑‍✈️",
    DELIM + r"man_pilot" + DELIM: "👨‍✈️",
    DELIM + r"woman_pilot" + DELIM: "👩‍✈️",
    DELIM + r"astronaut" + DELIM: "🧑‍🚀",
    DELIM + r"man_astronaut" + DELIM: "👨‍🚀",
    DELIM + r"woman_astronaut" + DELIM: "👩‍🚀",
    DELIM + r"firefighter" + DELIM: "🧑‍🚒",
    DELIM + r"man_firefighter" + DELIM: "👨‍🚒",
    DELIM + r"woman_firefighter" + DELIM: "👩‍🚒",
    DELIM + r"cop" + DELIM: "👮",
    DELIM + r"police(_officer|man)" + DELIM: "👮‍♂️",
    DELIM + r"policewoman" + DELIM: "👮‍♀️",
    DELIM + r"detective" + DELIM: "🕵️",
    DELIM + r"male_detective" + DELIM: "🕵️‍♂️",
    DELIM + r"female_detective" + DELIM: "🕵️‍♀️",
    DELIM + r"guard" + DELIM: "💂",
    DELIM + r"guardsman" + DELIM: "💂‍♂️",
    DELIM + r"guardswoman" + DELIM: "💂‍♀️",
    DELIM + r"ninja" + DELIM: "🥷",
    DELIM + r"construction_worker" + DELIM: "👷",
    DELIM + r"construction_worker_man" + DELIM: "👷‍♂️",
    DELIM + r"construction_worker_woman" + DELIM: "👷‍♀️",
    DELIM + r"prince" + DELIM: "🤴",
    DELIM + r"princess" + DELIM: "👸",
    DELIM + r"person_with_turban" + DELIM: "👳",
    DELIM + r"man_with_turban" + DELIM: "👳‍♂️",
    DELIM + r"woman_with_turban" + DELIM: "👳‍♀️",
    DELIM + r"man_with_gua_pi_mao" + DELIM: "👲",
    DELIM + r"woman_with_headscarf" + DELIM: "🧕",
    DELIM + r"person_in_tuxedo" + DELIM: "🤵",
    DELIM + r"man_in_tuxedo" + DELIM: "🤵‍♂️",
    DELIM + r"woman_in_tuxedo" + DELIM: "🤵‍♀️",
    DELIM + r"person_with_veil" + DELIM: "👰",
    DELIM + r"man_with_veil" + DELIM: "👰‍♂️",
    DELIM + r"(bride|woman)_with_veil" + DELIM: "👰‍♀️",
    DELIM + r"pregnant_woman" + DELIM: "🤰",
    DELIM + r"breast_feeding" + DELIM: "🤱",
    DELIM + r"woman_feeding_baby" + DELIM: "👩‍🍼",
    DELIM + r"man_feeding_baby" + DELIM: "👨‍🍼",
    DELIM + r"person_feeding_baby" + DELIM: "🧑‍🍼",
    #
    # Person Fantasy
    #
    DELIM + r"angel" + DELIM: "👼",
    DELIM + r"santa" + DELIM: "🎅",
    DELIM + r"mrs_claus" + DELIM: "🤶",
    DELIM + r"mx_claus" + DELIM: "🧑‍🎄",
    DELIM + r"superhero" + DELIM: "🦸",
    DELIM + r"superhero_man" + DELIM: "🦸‍♂️",
    DELIM + r"superhero_woman" + DELIM: "🦸‍♀️",
    DELIM + r"supervillain" + DELIM: "🦹",
    DELIM + r"supervillain_man" + DELIM: "🦹‍♂️",
    DELIM + r"supervillain_woman" + DELIM: "🦹‍♀️",
    DELIM + r"mage" + DELIM: "🧙",
    DELIM + r"mage_man" + DELIM: "🧙‍♂️",
    DELIM + r"mage_woman" + DELIM: "🧙‍♀️",
    DELIM + r"fairy" + DELIM: "🧚",
    DELIM + r"fairy_man" + DELIM: "🧚‍♂️",
    DELIM + r"fairy_woman" + DELIM: "🧚‍♀️",
    DELIM + r"vampire" + DELIM: "🧛",
    DELIM + r"vampire_man" + DELIM: "🧛‍♂️",
    DELIM + r"vampire_woman" + DELIM: "🧛‍♀️",
    DELIM + r"merperson" + DELIM: "🧜",
    DELIM + r"merman" + DELIM: "🧜‍♂️",
    DELIM + r"mermaid" + DELIM: "🧜‍♀️",
    DELIM + r"elf" + DELIM: "🧝",
    DELIM + r"elf_man" + DELIM: "🧝‍♂️",
    DELIM + r"elf_woman" + DELIM: "🧝‍♀️",
    DELIM + r"genie" + DELIM: "🧞",
    DELIM + r"genie_man" + DELIM: "🧞‍♂️",
    DELIM + r"genie_woman" + DELIM: "🧞‍♀️",
    DELIM + r"zombie" + DELIM: "🧟",
    DELIM + r"zombie_man" + DELIM: "🧟‍♂️",
    DELIM + r"zombie_woman" + DELIM: "🧟‍♀️",
    #
    # Person Activity
    #
    DELIM + r"massage" + DELIM: "💆",
    DELIM + r"massage_man" + DELIM: "💆‍♂️",
    DELIM + r"massage_woman" + DELIM: "💆‍♀️",
    DELIM + r"haircut" + DELIM: "💇",
    DELIM + r"haircut_man" + DELIM: "💇‍♂️",
    DELIM + r"haircut_woman" + DELIM: "💇‍♀️",
    DELIM + r"walking" + DELIM: "🚶",
    DELIM + r"walking_man" + DELIM: "🚶‍♂️",
    DELIM + r"walking_woman" + DELIM: "🚶‍♀️",
    DELIM + r"standing_person" + DELIM: "🧍",
    DELIM + r"standing_man" + DELIM: "🧍‍♂️",
    DELIM + r"standing_woman" + DELIM: "🧍‍♀️",
    DELIM + r"kneeling_person" + DELIM: "🧎",
    DELIM + r"kneeling_man" + DELIM: "🧎‍♂️",
    DELIM + r"kneeling_woman" + DELIM: "🧎‍♀️",
    DELIM + r"person_with_probing_cane" + DELIM: "🧑‍🦯",
    DELIM + r"man_with_probing_cane" + DELIM: "👨‍🦯",
    DELIM + r"woman_with_probing_cane" + DELIM: "👩‍🦯",
    DELIM + r"person_in_motorized_wheelchair" + DELIM: "🧑‍🦼",
    DELIM + r"man_in_motorized_wheelchair" + DELIM: "👨‍🦼",
    DELIM + r"woman_in_motorized_wheelchair" + DELIM: "👩‍🦼",
    DELIM + r"person_in_manual_wheelchair" + DELIM: "🧑‍🦽",
    DELIM + r"man_in_manual_wheelchair" + DELIM: "👨‍🦽",
    DELIM + r"woman_in_manual_wheelchair" + DELIM: "👩‍🦽",
    DELIM + r"runn(er|ing)" + DELIM: "🏃",
    DELIM + r"running_man" + DELIM: "🏃‍♂️",
    DELIM + r"running_woman" + DELIM: "🏃‍♀️",
    DELIM + r"(dancer|woman_dancing)" + DELIM: "💃",
    DELIM + r"man_dancing" + DELIM: "🕺",
    DELIM + r"business_suit_levitating" + DELIM: "🕴️",
    DELIM + r"dancers" + DELIM: "👯",
    DELIM + r"dancing_men" + DELIM: "👯‍♂️",
    DELIM + r"dancing_women" + DELIM: "👯‍♀️",
    DELIM + r"sauna_person" + DELIM: "🧖",
    DELIM + r"sauna_man" + DELIM: "🧖‍♂️",
    DELIM + r"sauna_woman" + DELIM: "🧖‍♀️",
    DELIM + r"climbing" + DELIM: "🧗",
    DELIM + r"climbing_man" + DELIM: "🧗‍♂️",
    DELIM + r"climbing_woman" + DELIM: "🧗‍♀️",
    #
    # Person Sport
    #
    DELIM + r"person_fencing" + DELIM: "🤺",
    DELIM + r"horse_racing" + DELIM: "🏇",
    DELIM + r"skier" + DELIM: "⛷️",
    DELIM + r"snowboarder" + DELIM: "🏂",
    DELIM + r"golfing" + DELIM: "🏌️",
    DELIM + r"golfing_man" + DELIM: "🏌️‍♂️",
    DELIM + r"golfing_woman" + DELIM: "🏌️‍♀️",
    DELIM + r"surfer" + DELIM: "🏄",
    DELIM + r"surfing_man" + DELIM: "🏄‍♂️",
    DELIM + r"surfing_woman" + DELIM: "🏄‍♀️",
    DELIM + r"rowboat" + DELIM: "🚣",
    DELIM + r"rowing_man" + DELIM: "🚣‍♂️",
    DELIM + r"rowing_woman" + DELIM: "🚣‍♀️",
    DELIM + r"swimmer" + DELIM: "🏊",
    DELIM + r"swimming_man" + DELIM: "🏊‍♂️",
    DELIM + r"swimming_woman" + DELIM: "🏊‍♀️",
    DELIM + r"bouncing_ball_person" + DELIM: "⛹️",
    DELIM + r"(basketball|bouncing_ball)_man" + DELIM: "⛹️‍♂️",
    DELIM + r"(basketball|bouncing_ball)_woman" + DELIM: "⛹️‍♀️",
    DELIM + r"weight_lifting" + DELIM: "🏋️",
    DELIM + r"weight_lifting_man" + DELIM: "🏋️‍♂️",
    DELIM + r"weight_lifting_woman" + DELIM: "🏋️‍♀️",
    DELIM + r"bicyclist" + DELIM: "🚴",
    DELIM + r"biking_man" + DELIM: "🚴‍♂️",
    DELIM + r"biking_woman" + DELIM: "🚴‍♀️",
    DELIM + r"mountain_bicyclist" + DELIM: "🚵",
    DELIM + r"mountain_biking_man" + DELIM: "🚵‍♂️",
    DELIM + r"mountain_biking_woman" + DELIM: "🚵‍♀️",
    DELIM + r"cartwheeling" + DELIM: "🤸",
    DELIM + r"man_cartwheeling" + DELIM: "🤸‍♂️",
    DELIM + r"woman_cartwheeling" + DELIM: "🤸‍♀️",
    DELIM + r"wrestling" + DELIM: "🤼",
    DELIM + r"men_wrestling" + DELIM: "🤼‍♂️",
    DELIM + r"women_wrestling" + DELIM: "🤼‍♀️",
    DELIM + r"water_polo" + DELIM: "🤽",
    DELIM + r"man_playing_water_polo" + DELIM: "🤽‍♂️",
    DELIM + r"woman_playing_water_polo" + DELIM: "🤽‍♀️",
    DELIM + r"handball_person" + DELIM: "🤾",
    DELIM + r"man_playing_handball" + DELIM: "🤾‍♂️",
    DELIM + r"woman_playing_handball" + DELIM: "🤾‍♀️",
    DELIM + r"juggling_person" + DELIM: "🤹",
    DELIM + r"man_juggling" + DELIM: "🤹‍♂️",
    DELIM + r"woman_juggling" + DELIM: "🤹‍♀️",
    #
    # Person Resting
    #
    DELIM + r"lotus_position" + DELIM: "🧘",
    DELIM + r"lotus_position_man" + DELIM: "🧘‍♂️",
    DELIM + r"lotus_position_woman" + DELIM: "🧘‍♀️",
    DELIM + r"bath" + DELIM: "🛀",
    DELIM + r"sleeping_bed" + DELIM: "🛌",
    #
    # Family
    #
    DELIM + r"people_holding_hands" + DELIM: "🧑‍🤝‍🧑",
    DELIM + r"two_women_holding_hands" + DELIM: "👭",
    DELIM + r"couple" + DELIM: "👫",
    DELIM + r"two_men_holding_hands" + DELIM: "👬",
    DELIM + r"couplekiss" + DELIM: "💏",
    DELIM + r"couplekiss_man_woman" + DELIM: "👩‍❤️‍💋‍👨",
    DELIM + r"couplekiss_man_man" + DELIM: "👨‍❤️‍💋‍👨",
    DELIM + r"couplekiss_woman_woman" + DELIM: "👩‍❤️‍💋‍👩",
    DELIM + r"couple_with_heart" + DELIM: "💑",
    DELIM + r"couple_with_heart_woman_man" + DELIM: "👩‍❤️‍👨",
    DELIM + r"couple_with_heart_man_man" + DELIM: "👨‍❤️‍👨",
    DELIM + r"couple_with_heart_woman_woman" + DELIM: "👩‍❤️‍👩",
    DELIM + r"family_man_woman_boy" + DELIM: "👨‍👩‍👦",
    DELIM + r"family_man_woman_girl" + DELIM: "👨‍👩‍👧",
    DELIM + r"family_man_woman_girl_boy" + DELIM: "👨‍👩‍👧‍👦",
    DELIM + r"family_man_woman_boy_boy" + DELIM: "👨‍👩‍👦‍👦",
    DELIM + r"family_man_woman_girl_girl" + DELIM: "👨‍👩‍👧‍👧",
    DELIM + r"family_man_man_boy" + DELIM: "👨‍👨‍👦",
    DELIM + r"family_man_man_girl" + DELIM: "👨‍👨‍👧",
    DELIM + r"family_man_man_girl_boy" + DELIM: "👨‍👨‍👧‍👦",
    DELIM + r"family_man_man_boy_boy" + DELIM: "👨‍👨‍👦‍👦",
    DELIM + r"family_man_man_girl_girl" + DELIM: "👨‍👨‍👧‍👧",
    DELIM + r"family_woman_woman_boy" + DELIM: "👩‍👩‍👦",
    DELIM + r"family_woman_woman_girl" + DELIM: "👩‍👩‍👧",
    DELIM + r"family_woman_woman_girl_boy" + DELIM: "👩‍👩‍👧‍👦",
    DELIM + r"family_woman_woman_boy_boy" + DELIM: "👩‍👩‍👦‍👦",
    DELIM + r"family_woman_woman_girl_girl" + DELIM: "👩‍👩‍👧‍👧",
    DELIM + r"family_man_boy" + DELIM: "👨‍👦",
    DELIM + r"family_man_boy_boy" + DELIM: "👨‍👦‍👦",
    DELIM + r"family_man_girl" + DELIM: "👨‍👧",
    DELIM + r"family_man_girl_boy" + DELIM: "👨‍👧‍👦",
    DELIM + r"family_man_girl_girl" + DELIM: "👨‍👧‍👧",
    DELIM + r"family_woman_boy" + DELIM: "👩‍👦",
    DELIM + r"family_woman_boy_boy" + DELIM: "👩‍👦‍👦",
    DELIM + r"family_woman_girl" + DELIM: "👩‍👧",
    DELIM + r"family_woman_girl_boy" + DELIM: "👩‍👧‍👦",
    DELIM + r"family_woman_girl_girl" + DELIM: "👩‍👧‍👧",
    #
    # Person Symbol
    #
    DELIM + r"speaking_head" + DELIM: "🗣️",
    DELIM + r"bust_in_silhouette" + DELIM: "👤",
    DELIM + r"busts_in_silhouette" + DELIM: "👥",
    DELIM + r"people_hugging" + DELIM: "🫂",
    DELIM + r"family" + DELIM: "👪",
    DELIM + r"footprints" + DELIM: "👣",
    #
    # Animal Mammal
    #
    DELIM + r"monkey_face" + DELIM: "🐵",
    DELIM + r"monkey" + DELIM: "🐒",
    DELIM + r"gorilla" + DELIM: "🦍",
    DELIM + r"orangutan" + DELIM: "🦧",
    DELIM + r"dog" + DELIM: "🐶",
    DELIM + r"dog2" + DELIM: "🐕",
    DELIM + r"guide_dog" + DELIM: "🦮",
    DELIM + r"service_dog" + DELIM: "🐕‍🦺",
    DELIM + r"poodle" + DELIM: "🐩",
    DELIM + r"wolf" + DELIM: "🐺",
    DELIM + r"fox_face" + DELIM: "🦊",
    DELIM + r"raccoon" + DELIM: "🦝",
    DELIM + r"cat" + DELIM: "🐱",
    DELIM + r"cat2" + DELIM: "🐈",
    DELIM + r"black_cat" + DELIM: "🐈‍⬛",
    DELIM + r"lion" + DELIM: "🦁",
    DELIM + r"tiger" + DELIM: "🐯",
    DELIM + r"tiger2" + DELIM: "🐅",
    DELIM + r"leopard" + DELIM: "🐆",
    DELIM + r"horse" + DELIM: "🐴",
    DELIM + r"racehorse" + DELIM: "🐎",
    DELIM + r"unicorn" + DELIM: "🦄",
    DELIM + r"zebra" + DELIM: "🦓",
    DELIM + r"deer" + DELIM: "🦌",
    DELIM + r"bison" + DELIM: "🦬",
    DELIM + r"cow" + DELIM: "🐮",
    DELIM + r"ox" + DELIM: "🐂",
    DELIM + r"water_buffalo" + DELIM: "🐃",
    DELIM + r"cow2" + DELIM: "🐄",
    DELIM + r"pig" + DELIM: "🐷",
    DELIM + r"pig2" + DELIM: "🐖",
    DELIM + r"boar" + DELIM: "🐗",
    DELIM + r"pig_nose" + DELIM: "🐽",
    DELIM + r"ram" + DELIM: "🐏",
    DELIM + r"sheep" + DELIM: "🐑",
    DELIM + r"goat" + DELIM: "🐐",
    DELIM + r"dromedary_camel" + DELIM: "🐪",
    DELIM + r"camel" + DELIM: "🐫",
    DELIM + r"llama" + DELIM: "🦙",
    DELIM + r"giraffe" + DELIM: "🦒",
    DELIM + r"elephant" + DELIM: "🐘",
    DELIM + r"mammoth" + DELIM: "🦣",
    DELIM + r"rhinoceros" + DELIM: "🦏",
    DELIM + r"hippopotamus" + DELIM: "🦛",
    DELIM + r"mouse" + DELIM: "🐭",
    DELIM + r"mouse2" + DELIM: "🐁",
    DELIM + r"rat" + DELIM: "🐀",
    DELIM + r"hamster" + DELIM: "🐹",
    DELIM + r"rabbit" + DELIM: "🐰",
    DELIM + r"rabbit2" + DELIM: "🐇",
    DELIM + r"chipmunk" + DELIM: "🐿️",
    DELIM + r"beaver" + DELIM: "🦫",
    DELIM + r"hedgehog" + DELIM: "🦔",
    DELIM + r"bat" + DELIM: "🦇",
    DELIM + r"bear" + DELIM: "🐻",
    DELIM + r"polar_bear" + DELIM: "🐻‍❄️",
    DELIM + r"koala" + DELIM: "🐨",
    DELIM + r"panda_face" + DELIM: "🐼",
    DELIM + r"sloth" + DELIM: "🦥",
    DELIM + r"otter" + DELIM: "🦦",
    DELIM + r"skunk" + DELIM: "🦨",
    DELIM + r"kangaroo" + DELIM: "🦘",
    DELIM + r"badger" + DELIM: "🦡",
    DELIM + r"(feet|paw_prints)" + DELIM: "🐾",
    #
    # Animal Bird
    #
    DELIM + r"turkey" + DELIM: "🦃",
    DELIM + r"chicken" + DELIM: "🐔",
    DELIM + r"rooster" + DELIM: "🐓",
    DELIM + r"hatching_chick" + DELIM: "🐣",
    DELIM + r"baby_chick" + DELIM: "🐤",
    DELIM + r"hatched_chick" + DELIM: "🐥",
    DELIM + r"bird" + DELIM: "🐦",
    DELIM + r"penguin" + DELIM: "🐧",
    DELIM + r"dove" + DELIM: "🕊️",
    DELIM + r"eagle" + DELIM: "🦅",
    DELIM + r"duck" + DELIM: "🦆",
    DELIM + r"swan" + DELIM: "🦢",
    DELIM + r"owl" + DELIM: "🦉",
    DELIM + r"dodo" + DELIM: "🦤",
    DELIM + r"feather" + DELIM: "🪶",
    DELIM + r"flamingo" + DELIM: "🦩",
    DELIM + r"peacock" + DELIM: "🦚",
    DELIM + r"parrot" + DELIM: "🦜",
    #
    # Animal Amphibian
    #
    DELIM + r"frog" + DELIM: "🐸",
    #
    # Animal Reptile
    #
    DELIM + r"crocodile" + DELIM: "🐊",
    DELIM + r"turtle" + DELIM: "🐢",
    DELIM + r"lizard" + DELIM: "🦎",
    DELIM + r"snake" + DELIM: "🐍",
    DELIM + r"dragon_face" + DELIM: "🐲",
    DELIM + r"dragon" + DELIM: "🐉",
    DELIM + r"sauropod" + DELIM: "🦕",
    DELIM + r"t-rex" + DELIM: "🦖",
    #
    # Animal Marine
    #
    DELIM + r"whale" + DELIM: "🐳",
    DELIM + r"whale2" + DELIM: "🐋",
    DELIM + r"dolphin" + DELIM: "🐬",
    DELIM + r"(seal|flipper)" + DELIM: "🦭",
    DELIM + r"fish" + DELIM: "🐟",
    DELIM + r"tropical_fish" + DELIM: "🐠",
    DELIM + r"blowfish" + DELIM: "🐡",
    DELIM + r"shark" + DELIM: "🦈",
    DELIM + r"octopus" + DELIM: "🐙",
    DELIM + r"shell" + DELIM: "🐚",
    #
    # Animal Bug
    #
    DELIM + r"snail" + DELIM: "🐌",
    DELIM + r"butterfly" + DELIM: "🦋",
    DELIM + r"bug" + DELIM: "🐛",
    DELIM + r"ant" + DELIM: "🐜",
    DELIM + r"bee" + DELIM: "🐝",
    DELIM + r"honeybee" + DELIM: "🪲",
    DELIM + r"(lady_)?beetle" + DELIM: "🐞",
    DELIM + r"cricket" + DELIM: "🦗",
    DELIM + r"cockroach" + DELIM: "🪳",
    DELIM + r"spider" + DELIM: "🕷️",
    DELIM + r"spider_web" + DELIM: "🕸️",
    DELIM + r"scorpion" + DELIM: "🦂",
    DELIM + r"mosquito" + DELIM: "🦟",
    DELIM + r"fly" + DELIM: "🪰",
    DELIM + r"worm" + DELIM: "🪱",
    DELIM + r"microbe" + DELIM: "🦠",
    #
    # Plant Flower
    #
    DELIM + r"bouquet" + DELIM: "💐",
    DELIM + r"cherry_blossom" + DELIM: "🌸",
    DELIM + r"white_flower" + DELIM: "💮",
    DELIM + r"rosette" + DELIM: "🏵️",
    DELIM + r"rose" + DELIM: "🌹",
    DELIM + r"wilted_flower" + DELIM: "🥀",
    DELIM + r"hibiscus" + DELIM: "🌺",
    DELIM + r"sunflower" + DELIM: "🌻",
    DELIM + r"blossom" + DELIM: "🌼",
    DELIM + r"tulip" + DELIM: "🌷",
    #
    # Plant Other
    #
    DELIM + r"seedling" + DELIM: "🌱",
    DELIM + r"potted_plant" + DELIM: "🪴",
    DELIM + r"evergreen_tree" + DELIM: "🌲",
    DELIM + r"deciduous_tree" + DELIM: "🌳",
    DELIM + r"palm_tree" + DELIM: "🌴",
    DELIM + r"cactus" + DELIM: "🌵",
    DELIM + r"ear_of_rice" + DELIM: "🌾",
    DELIM + r"herb" + DELIM: "🌿",
    DELIM + r"shamrock" + DELIM: "☘️",
    DELIM + r"four_leaf_clover" + DELIM: "🍀",
    DELIM + r"maple_leaf" + DELIM: "🍁",
    DELIM + r"fallen_leaf" + DELIM: "🍂",
    DELIM + r"leaves" + DELIM: "🍃",
    DELIM + r"mushroom" + DELIM: "🍄",
    #
    # Food Fruit
    #
    DELIM + r"grapes" + DELIM: "🍇",
    DELIM + r"melon" + DELIM: "🍈",
    DELIM + r"watermelon" + DELIM: "🍉",
    DELIM + r"(orange|mandarin|tangerine)" + DELIM: "🍊",
    DELIM + r"lemon" + DELIM: "🍋",
    DELIM + r"banana" + DELIM: "🍌",
    DELIM + r"pineapple" + DELIM: "🍍",
    DELIM + r"mango" + DELIM: "🥭",
    DELIM + r"apple" + DELIM: "🍎",
    DELIM + r"green_apple" + DELIM: "🍏",
    DELIM + r"pear" + DELIM: "🍐",
    DELIM + r"peach" + DELIM: "🍑",
    DELIM + r"cherries" + DELIM: "🍒",
    DELIM + r"strawberry" + DELIM: "🍓",
    DELIM + r"blueberries" + DELIM: "🫐",
    DELIM + r"kiwi_fruit" + DELIM: "🥝",
    DELIM + r"tomato" + DELIM: "🍅",
    DELIM + r"olive" + DELIM: "🫒",
    DELIM + r"coconut" + DELIM: "🥥",
    #
    # Food Vegetable
    #
    DELIM + r"avocado" + DELIM: "🥑",
    DELIM + r"eggplant" + DELIM: "🍆",
    DELIM + r"potato" + DELIM: "🥔",
    DELIM + r"carrot" + DELIM: "🥕",
    DELIM + r"corn" + DELIM: "🌽",
    DELIM + r"hot_pepper" + DELIM: "🌶️",
    DELIM + r"bell_pepper" + DELIM: "🫑",
    DELIM + r"cucumber" + DELIM: "🥒",
    DELIM + r"leafy_green" + DELIM: "🥬",
    DELIM + r"broccoli" + DELIM: "🥦",
    DELIM + r"garlic" + DELIM: "🧄",
    DELIM + r"onion" + DELIM: "🧅",
    DELIM + r"peanuts" + DELIM: "🥜",
    DELIM + r"chestnut" + DELIM: "🌰",
    #
    # Food Prepared
    #
    DELIM + r"bread" + DELIM: "🍞",
    DELIM + r"croissant" + DELIM: "🥐",
    DELIM + r"baguette_bread" + DELIM: "🥖",
    DELIM + r"flatbread" + DELIM: "🫓",
    DELIM + r"pretzel" + DELIM: "🥨",
    DELIM + r"bagel" + DELIM: "🥯",
    DELIM + r"pancakes" + DELIM: "🥞",
    DELIM + r"waffle" + DELIM: "🧇",
    DELIM + r"cheese" + DELIM: "🧀",
    DELIM + r"meat_on_bone" + DELIM: "🍖",
    DELIM + r"poultry_leg" + DELIM: "🍗",
    DELIM + r"cut_of_meat" + DELIM: "🥩",
    DELIM + r"bacon" + DELIM: "🥓",
    DELIM + r"hamburger" + DELIM: "🍔",
    DELIM + r"fries" + DELIM: "🍟",
    DELIM + r"pizza" + DELIM: "🍕",
    DELIM + r"hotdog" + DELIM: "🌭",
    DELIM + r"sandwich" + DELIM: "🥪",
    DELIM + r"taco" + DELIM: "🌮",
    DELIM + r"burrito" + DELIM: "🌯",
    DELIM + r"tamale" + DELIM: "🫔",
    DELIM + r"stuffed_flatbread" + DELIM: "🥙",
    DELIM + r"falafel" + DELIM: "🧆",
    DELIM + r"egg" + DELIM: "🥚",
    DELIM + r"fried_egg" + DELIM: "🍳",
    DELIM + r"shallow_pan_of_food" + DELIM: "🥘",
    DELIM + r"stew" + DELIM: "🍲",
    DELIM + r"fondue" + DELIM: "🫕",
    DELIM + r"bowl_with_spoon" + DELIM: "🥣",
    DELIM + r"green_salad" + DELIM: "🥗",
    DELIM + r"popcorn" + DELIM: "🍿",
    DELIM + r"butter" + DELIM: "🧈",
    DELIM + r"salt" + DELIM: "🧂",
    DELIM + r"canned_food" + DELIM: "🥫",
    #
    # Food Asian
    #
    DELIM + r"bento" + DELIM: "🍱",
    DELIM + r"rice_cracker" + DELIM: "🍘",
    DELIM + r"rice_ball" + DELIM: "🍙",
    DELIM + r"rice" + DELIM: "🍚",
    DELIM + r"curry" + DELIM: "🍛",
    DELIM + r"ramen" + DELIM: "🍜",
    DELIM + r"spaghetti" + DELIM: "🍝",
    DELIM + r"sweet_potato" + DELIM: "🍠",
    DELIM + r"oden" + DELIM: "🍢",
    DELIM + r"sushi" + DELIM: "🍣",
    DELIM + r"fried_shrimp" + DELIM: "🍤",
    DELIM + r"fish_cake" + DELIM: "🍥",
    DELIM + r"moon_cake" + DELIM: "🥮",
    DELIM + r"dango" + DELIM: "🍡",
    DELIM + r"dumpling" + DELIM: "🥟",
    DELIM + r"fortune_cookie" + DELIM: "🥠",
    DELIM + r"takeout_box" + DELIM: "🥡",
    #
    # Food Marine
    #
    DELIM + r"crab" + DELIM: "🦀",
    DELIM + r"lobster" + DELIM: "🦞",
    DELIM + r"shrimp" + DELIM: "🦐",
    DELIM + r"squid" + DELIM: "🦑",
    DELIM + r"oyster" + DELIM: "🦪",
    #
    # Food Sweet
    #
    DELIM + r"icecream" + DELIM: "🍦",
    DELIM + r"shaved_ice" + DELIM: "🍧",
    DELIM + r"ice_cream" + DELIM: "🍨",
    DELIM + r"doughnut" + DELIM: "🍩",
    DELIM + r"cookie" + DELIM: "🍪",
    DELIM + r"birthday" + DELIM: "🎂",
    DELIM + r"cake" + DELIM: "🍰",
    DELIM + r"cupcake" + DELIM: "🧁",
    DELIM + r"pie" + DELIM: "🥧",
    DELIM + r"chocolate_bar" + DELIM: "🍫",
    DELIM + r"candy" + DELIM: "🍬",
    DELIM + r"lollipop" + DELIM: "🍭",
    DELIM + r"custard" + DELIM: "🍮",
    DELIM + r"honey_pot" + DELIM: "🍯",
    #
    # Drink
    #
    DELIM + r"baby_bottle" + DELIM: "🍼",
    DELIM + r"milk_glass" + DELIM: "🥛",
    DELIM + r"coffee" + DELIM: "☕",
    DELIM + r"teapot" + DELIM: "🫖",
    DELIM + r"tea" + DELIM: "🍵",
    DELIM + r"sake" + DELIM: "🍶",
    DELIM + r"champagne" + DELIM: "🍾",
    DELIM + r"wine_glass" + DELIM: "🍷",
    DELIM + r"cocktail" + DELIM: "🍸",
    DELIM + r"tropical_drink" + DELIM: "🍹",
    DELIM + r"beer" + DELIM: "🍺",
    DELIM + r"beers" + DELIM: "🍻",
    DELIM + r"clinking_glasses" + DELIM: "🥂",
    DELIM + r"tumbler_glass" + DELIM: "🥃",
    DELIM + r"cup_with_straw" + DELIM: "🥤",
    DELIM + r"bubble_tea" + DELIM: "🧋",
    DELIM + r"beverage_box" + DELIM: "🧃",
    DELIM + r"mate" + DELIM: "🧉",
    DELIM + r"ice_cube" + DELIM: "🧊",
    #
    # Dishware
    #
    DELIM + r"chopsticks" + DELIM: "🥢",
    DELIM + r"plate_with_cutlery" + DELIM: "🍽️",
    DELIM + r"fork_and_knife" + DELIM: "🍴",
    DELIM + r"spoon" + DELIM: "🥄",
    DELIM + r"(hocho|knife)" + DELIM: "🔪",
    DELIM + r"amphora" + DELIM: "🏺",
    #
    # Place Map
    #
    DELIM + r"earth_africa" + DELIM: "🌍",
    DELIM + r"earth_americas" + DELIM: "🌎",
    DELIM + r"earth_asia" + DELIM: "🌏",
    DELIM + r"globe_with_meridians" + DELIM: "🌐",
    DELIM + r"world_map" + DELIM: "🗺️",
    DELIM + r"japan" + DELIM: "🗾",
    DELIM + r"compass" + DELIM: "🧭",
    #
    # Place Geographic
    #
    DELIM + r"mountain_snow" + DELIM: "🏔️",
    DELIM + r"mountain" + DELIM: "⛰️",
    DELIM + r"volcano" + DELIM: "🌋",
    DELIM + r"mount_fuji" + DELIM: "🗻",
    DELIM + r"camping" + DELIM: "🏕️",
    DELIM + r"beach_umbrella" + DELIM: "🏖️",
    DELIM + r"desert" + DELIM: "🏜️",
    DELIM + r"desert_island" + DELIM: "🏝️",
    DELIM + r"national_park" + DELIM: "🏞️",
    #
    # Place Building
    #
    DELIM + r"stadium" + DELIM: "🏟️",
    DELIM + r"classical_building" + DELIM: "🏛️",
    DELIM + r"building_construction" + DELIM: "🏗️",
    DELIM + r"bricks" + DELIM: "🧱",
    DELIM + r"rock" + DELIM: "🪨",
    DELIM + r"wood" + DELIM: "🪵",
    DELIM + r"hut" + DELIM: "🛖",
    DELIM + r"houses" + DELIM: "🏘️",
    DELIM + r"derelict_house" + DELIM: "🏚️",
    DELIM + r"house" + DELIM: "🏠",
    DELIM + r"house_with_garden" + DELIM: "🏡",
    DELIM + r"office" + DELIM: "🏢",
    DELIM + r"post_office" + DELIM: "🏣",
    DELIM + r"european_post_office" + DELIM: "🏤",
    DELIM + r"hospital" + DELIM: "🏥",
    DELIM + r"bank" + DELIM: "🏦",
    DELIM + r"hotel" + DELIM: "🏨",
    DELIM + r"love_hotel" + DELIM: "🏩",
    DELIM + r"convenience_store" + DELIM: "🏪",
    DELIM + r"school" + DELIM: "🏫",
    DELIM + r"department_store" + DELIM: "🏬",
    DELIM + r"factory" + DELIM: "🏭",
    DELIM + r"japanese_castle" + DELIM: "🏯",
    DELIM + r"european_castle" + DELIM: "🏰",
    DELIM + r"wedding" + DELIM: "💒",
    DELIM + r"tokyo_tower" + DELIM: "🗼",
    DELIM + r"statue_of_liberty" + DELIM: "🗽",
    #
    # Place Religious
    #
    DELIM + r"church" + DELIM: "⛪",
    DELIM + r"mosque" + DELIM: "🕌",
    DELIM + r"hindu_temple" + DELIM: "🛕",
    DELIM + r"synagogue" + DELIM: "🕍",
    DELIM + r"shinto_shrine" + DELIM: "⛩️",
    DELIM + r"kaaba" + DELIM: "🕋",
    #
    # Place Other
    #
    DELIM + r"fountain" + DELIM: "⛲",
    DELIM + r"tent" + DELIM: "⛺",
    DELIM + r"foggy" + DELIM: "🌁",
    DELIM + r"night_with_stars" + DELIM: "🌃",
    DELIM + r"cityscape" + DELIM: "🏙️",
    DELIM + r"sunrise_over_mountains" + DELIM: "🌄",
    DELIM + r"sunrise" + DELIM: "🌅",
    DELIM + r"city_sunset" + DELIM: "🌆",
    DELIM + r"city_sunrise" + DELIM: "🌇",
    DELIM + r"bridge_at_night" + DELIM: "🌉",
    DELIM + r"hotsprings" + DELIM: "♨️",
    DELIM + r"carousel_horse" + DELIM: "🎠",
    DELIM + r"ferris_wheel" + DELIM: "🎡",
    DELIM + r"roller_coaster" + DELIM: "🎢",
    DELIM + r"barber" + DELIM: "💈",
    DELIM + r"circus_tent" + DELIM: "🎪",
    #
    # Transport Ground
    #
    DELIM + r"steam_locomotive" + DELIM: "🚂",
    DELIM + r"railway_car" + DELIM: "🚃",
    DELIM + r"bullettrain_side" + DELIM: "🚄",
    DELIM + r"bullettrain_front" + DELIM: "🚅",
    DELIM + r"train2" + DELIM: "🚆",
    DELIM + r"metro" + DELIM: "🚇",
    DELIM + r"light_rail" + DELIM: "🚈",
    DELIM + r"station" + DELIM: "🚉",
    DELIM + r"tram" + DELIM: "🚊",
    DELIM + r"monorail" + DELIM: "🚝",
    DELIM + r"mountain_railway" + DELIM: "🚞",
    DELIM + r"train" + DELIM: "🚋",
    DELIM + r"bus" + DELIM: "🚌",
    DELIM + r"oncoming_bus" + DELIM: "🚍",
    DELIM + r"trolleybus" + DELIM: "🚎",
    DELIM + r"minibus" + DELIM: "🚐",
    DELIM + r"ambulance" + DELIM: "🚑",
    DELIM + r"fire_engine" + DELIM: "🚒",
    DELIM + r"police_car" + DELIM: "🚓",
    DELIM + r"oncoming_police_car" + DELIM: "🚔",
    DELIM + r"taxi" + DELIM: "🚕",
    DELIM + r"oncoming_taxi" + DELIM: "🚖",
    DELIM + r"car" + DELIM: "🚗",
    DELIM + r"(red_car|oncoming_automobile)" + DELIM: "🚘",
    DELIM + r"blue_car" + DELIM: "🚙",
    DELIM + r"pickup_truck" + DELIM: "🛻",
    DELIM + r"truck" + DELIM: "🚚",
    DELIM + r"articulated_lorry" + DELIM: "🚛",
    DELIM + r"tractor" + DELIM: "🚜",
    DELIM + r"racing_car" + DELIM: "🏎️",
    DELIM + r"motorcycle" + DELIM: "🏍️",
    DELIM + r"motor_scooter" + DELIM: "🛵",
    DELIM + r"manual_wheelchair" + DELIM: "🦽",
    DELIM + r"motorized_wheelchair" + DELIM: "🦼",
    DELIM + r"auto_rickshaw" + DELIM: "🛺",
    DELIM + r"bike" + DELIM: "🚲",
    DELIM + r"kick_scooter" + DELIM: "🛴",
    DELIM + r"skateboard" + DELIM: "🛹",
    DELIM + r"roller_skate" + DELIM: "🛼",
    DELIM + r"busstop" + DELIM: "🚏",
    DELIM + r"motorway" + DELIM: "🛣️",
    DELIM + r"railway_track" + DELIM: "🛤️",
    DELIM + r"oil_drum" + DELIM: "🛢️",
    DELIM + r"fuelpump" + DELIM: "⛽",
    DELIM + r"rotating_light" + DELIM: "🚨",
    DELIM + r"traffic_light" + DELIM: "🚥",
    DELIM + r"vertical_traffic_light" + DELIM: "🚦",
    DELIM + r"stop_sign" + DELIM: "🛑",
    DELIM + r"construction" + DELIM: "🚧",
    #
    # Transport Water
    #
    DELIM + r"anchor" + DELIM: "⚓",
    DELIM + r"(sailboat|boat)" + DELIM: "⛵",
    DELIM + r"canoe" + DELIM: "🛶",
    DELIM + r"speedboat" + DELIM: "🚤",
    DELIM + r"passenger_ship" + DELIM: "🛳️",
    DELIM + r"ferry" + DELIM: "⛴️",
    DELIM + r"motor_boat" + DELIM: "🛥️",
    DELIM + r"ship" + DELIM: "🚢",
    #
    # Transport Air
    #
    DELIM + r"airplane" + DELIM: "✈️",
    DELIM + r"small_airplane" + DELIM: "🛩️",
    DELIM + r"flight_departure" + DELIM: "🛫",
    DELIM + r"flight_arrival" + DELIM: "🛬",
    DELIM + r"parachute" + DELIM: "🪂",
    DELIM + r"seat" + DELIM: "💺",
    DELIM + r"helicopter" + DELIM: "🚁",
    DELIM + r"suspension_railway" + DELIM: "🚟",
    DELIM + r"mountain_cableway" + DELIM: "🚠",
    DELIM + r"aerial_tramway" + DELIM: "🚡",
    DELIM + r"artificial_satellite" + DELIM: "🛰️",
    DELIM + r"rocket" + DELIM: "🚀",
    DELIM + r"flying_saucer" + DELIM: "🛸",
    #
    # Hotel
    #
    DELIM + r"bellhop_bell" + DELIM: "🛎️",
    DELIM + r"luggage" + DELIM: "🧳",
    #
    # Time
    #
    DELIM + r"hourglass" + DELIM: "⌛",
    DELIM + r"hourglass_flowing_sand" + DELIM: "⏳",
    DELIM + r"watch" + DELIM: "⌚",
    DELIM + r"alarm_clock" + DELIM: "⏰",
    DELIM + r"stopwatch" + DELIM: "⏱️",
    DELIM + r"timer_clock" + DELIM: "⏲️",
    DELIM + r"mantelpiece_clock" + DELIM: "🕰️",
    DELIM + r"clock12" + DELIM: "🕛",
    DELIM + r"clock1230" + DELIM: "🕧",
    DELIM + r"clock1" + DELIM: "🕐",
    DELIM + r"clock130" + DELIM: "🕜",
    DELIM + r"clock2" + DELIM: "🕑",
    DELIM + r"clock230" + DELIM: "🕝",
    DELIM + r"clock3" + DELIM: "🕒",
    DELIM + r"clock330" + DELIM: "🕞",
    DELIM + r"clock4" + DELIM: "🕓",
    DELIM + r"clock430" + DELIM: "🕟",
    DELIM + r"clock5" + DELIM: "🕔",
    DELIM + r"clock530" + DELIM: "🕠",
    DELIM + r"clock6" + DELIM: "🕕",
    DELIM + r"clock630" + DELIM: "🕡",
    DELIM + r"clock7" + DELIM: "🕖",
    DELIM + r"clock730" + DELIM: "🕢",
    DELIM + r"clock8" + DELIM: "🕗",
    DELIM + r"clock830" + DELIM: "🕣",
    DELIM + r"clock9" + DELIM: "🕘",
    DELIM + r"clock930" + DELIM: "🕤",
    DELIM + r"clock10" + DELIM: "🕙",
    DELIM + r"clock1030" + DELIM: "🕥",
    DELIM + r"clock11" + DELIM: "🕚",
    DELIM + r"clock1130" + DELIM: "🕦",
    # Sky & Weather
    DELIM + r"new_moon" + DELIM: "🌑",
    DELIM + r"waxing_crescent_moon" + DELIM: "🌒",
    DELIM + r"first_quarter_moon" + DELIM: "🌓",
    DELIM + r"moon" + DELIM: "🌔",
    DELIM + r"(waxing_gibbous_moon|full_moon)" + DELIM: "🌕",
    DELIM + r"waning_gibbous_moon" + DELIM: "🌖",
    DELIM + r"last_quarter_moon" + DELIM: "🌗",
    DELIM + r"waning_crescent_moon" + DELIM: "🌘",
    DELIM + r"crescent_moon" + DELIM: "🌙",
    DELIM + r"new_moon_with_face" + DELIM: "🌚",
    DELIM + r"first_quarter_moon_with_face" + DELIM: "🌛",
    DELIM + r"last_quarter_moon_with_face" + DELIM: "🌜",
    DELIM + r"thermometer" + DELIM: "🌡️",
    DELIM + r"sunny" + DELIM: "☀️",
    DELIM + r"full_moon_with_face" + DELIM: "🌝",
    DELIM + r"sun_with_face" + DELIM: "🌞",
    DELIM + r"ringed_planet" + DELIM: "🪐",
    DELIM + r"star" + DELIM: "⭐",
    DELIM + r"star2" + DELIM: "🌟",
    DELIM + r"stars" + DELIM: "🌠",
    DELIM + r"milky_way" + DELIM: "🌌",
    DELIM + r"cloud" + DELIM: "☁️",
    DELIM + r"partly_sunny" + DELIM: "⛅",
    DELIM + r"cloud_with_lightning_and_rain" + DELIM: "⛈️",
    DELIM + r"sun_behind_small_cloud" + DELIM: "🌤️",
    DELIM + r"sun_behind_large_cloud" + DELIM: "🌥️",
    DELIM + r"sun_behind_rain_cloud" + DELIM: "🌦️",
    DELIM + r"cloud_with_rain" + DELIM: "🌧️",
    DELIM + r"cloud_with_snow" + DELIM: "🌨️",
    DELIM + r"cloud_with_lightning" + DELIM: "🌩️",
    DELIM + r"tornado" + DELIM: "🌪️",
    DELIM + r"fog" + DELIM: "🌫️",
    DELIM + r"wind_face" + DELIM: "🌬️",
    DELIM + r"cyclone" + DELIM: "🌀",
    DELIM + r"rainbow" + DELIM: "🌈",
    DELIM + r"closed_umbrella" + DELIM: "🌂",
    DELIM + r"open_umbrella" + DELIM: "☂️",
    DELIM + r"umbrella" + DELIM: "☔",
    DELIM + r"parasol_on_ground" + DELIM: "⛱️",
    DELIM + r"zap" + DELIM: "⚡",
    DELIM + r"snowflake" + DELIM: "❄️",
    DELIM + r"snowman_with_snow" + DELIM: "☃️",
    DELIM + r"snowman" + DELIM: "⛄",
    DELIM + r"comet" + DELIM: "☄️",
    DELIM + r"fire" + DELIM: "🔥",
    DELIM + r"droplet" + DELIM: "💧",
    DELIM + r"ocean" + DELIM: "🌊",
    #
    # Event
    #
    DELIM + r"jack_o_lantern" + DELIM: "🎃",
    DELIM + r"christmas_tree" + DELIM: "🎄",
    DELIM + r"fireworks" + DELIM: "🎆",
    DELIM + r"sparkler" + DELIM: "🎇",
    DELIM + r"firecracker" + DELIM: "🧨",
    DELIM + r"sparkles" + DELIM: "✨",
    DELIM + r"balloon" + DELIM: "🎈",
    DELIM + r"tada" + DELIM: "🎉",
    DELIM + r"confetti_ball" + DELIM: "🎊",
    DELIM + r"tanabata_tree" + DELIM: "🎋",
    DELIM + r"bamboo" + DELIM: "🎍",
    DELIM + r"dolls" + DELIM: "🎎",
    DELIM + r"flags" + DELIM: "🎏",
    DELIM + r"wind_chime" + DELIM: "🎐",
    DELIM + r"rice_scene" + DELIM: "🎑",
    DELIM + r"red_envelope" + DELIM: "🧧",
    DELIM + r"ribbon" + DELIM: "🎀",
    DELIM + r"gift" + DELIM: "🎁",
    DELIM + r"reminder_ribbon" + DELIM: "🎗️",
    DELIM + r"tickets" + DELIM: "🎟️",
    DELIM + r"ticket" + DELIM: "🎫",
    #
    # Award Medal
    #
    DELIM + r"medal_military" + DELIM: "🎖️",
    DELIM + r"trophy" + DELIM: "🏆",
    DELIM + r"medal_sports" + DELIM: "🏅",
    DELIM + r"1st_place_medal" + DELIM: "🥇",
    DELIM + r"2nd_place_medal" + DELIM: "🥈",
    DELIM + r"3rd_place_medal" + DELIM: "🥉",
    #
    # Sport
    #
    DELIM + r"soccer" + DELIM: "⚽",
    DELIM + r"baseball" + DELIM: "⚾",
    DELIM + r"softball" + DELIM: "🥎",
    DELIM + r"basketball" + DELIM: "🏀",
    DELIM + r"volleyball" + DELIM: "🏐",
    DELIM + r"football" + DELIM: "🏈",
    DELIM + r"rugby_football" + DELIM: "🏉",
    DELIM + r"tennis" + DELIM: "🎾",
    DELIM + r"flying_disc" + DELIM: "🥏",
    DELIM + r"bowling" + DELIM: "🎳",
    DELIM + r"cricket_game" + DELIM: "🏏",
    DELIM + r"field_hockey" + DELIM: "🏑",
    DELIM + r"ice_hockey" + DELIM: "🏒",
    DELIM + r"lacrosse" + DELIM: "🥍",
    DELIM + r"ping_pong" + DELIM: "🏓",
    DELIM + r"badminton" + DELIM: "🏸",
    DELIM + r"boxing_glove" + DELIM: "🥊",
    DELIM + r"martial_arts_uniform" + DELIM: "🥋",
    DELIM + r"goal_net" + DELIM: "🥅",
    DELIM + r"golf" + DELIM: "⛳",
    DELIM + r"ice_skate" + DELIM: "⛸️",
    DELIM + r"fishing_pole_and_fish" + DELIM: "🎣",
    DELIM + r"diving_mask" + DELIM: "🤿",
    DELIM + r"running_shirt_with_sash" + DELIM: "🎽",
    DELIM + r"ski" + DELIM: "🎿",
    DELIM + r"sled" + DELIM: "🛷",
    DELIM + r"curling_stone" + DELIM: "🥌",
    #
    # Game
    #
    DELIM + r"dart" + DELIM: "🎯",
    DELIM + r"yo_yo" + DELIM: "🪀",
    DELIM + r"kite" + DELIM: "🪁",
    DELIM + r"gun" + DELIM: "🔫",
    DELIM + r"8ball" + DELIM: "🎱",
    DELIM + r"crystal_ball" + DELIM: "🔮",
    DELIM + r"magic_wand" + DELIM: "🪄",
    DELIM + r"video_game" + DELIM: "🎮",
    DELIM + r"joystick" + DELIM: "🕹️",
    DELIM + r"slot_machine" + DELIM: "🎰",
    DELIM + r"game_die" + DELIM: "🎲",
    DELIM + r"jigsaw" + DELIM: "🧩",
    DELIM + r"teddy_bear" + DELIM: "🧸",
    DELIM + r"pinata" + DELIM: "🪅",
    DELIM + r"nesting_dolls" + DELIM: "🪆",
    DELIM + r"spades" + DELIM: "♠️",
    DELIM + r"hearts" + DELIM: "♥️",
    DELIM + r"diamonds" + DELIM: "♦️",
    DELIM + r"clubs" + DELIM: "♣️",
    DELIM + r"chess_pawn" + DELIM: "♟️",
    DELIM + r"black_joker" + DELIM: "🃏",
    DELIM + r"mahjong" + DELIM: "🀄",
    DELIM + r"flower_playing_cards" + DELIM: "🎴",
    #
    # Arts & Crafts
    #
    DELIM + r"performing_arts" + DELIM: "🎭",
    DELIM + r"framed_picture" + DELIM: "🖼️",
    DELIM + r"art" + DELIM: "🎨",
    DELIM + r"thread" + DELIM: "🧵",
    DELIM + r"sewing_needle" + DELIM: "🪡",
    DELIM + r"yarn" + DELIM: "🧶",
    DELIM + r"knot" + DELIM: "🪢",
    #
    # Clothing
    #
    DELIM + r"eyeglasses" + DELIM: "👓",
    DELIM + r"dark_sunglasses" + DELIM: "🕶️",
    DELIM + r"goggles" + DELIM: "🥽",
    DELIM + r"lab_coat" + DELIM: "🥼",
    DELIM + r"safety_vest" + DELIM: "🦺",
    DELIM + r"necktie" + DELIM: "👔",
    DELIM + r"t?shirt" + DELIM: "👕",
    DELIM + r"jeans" + DELIM: "👖",
    DELIM + r"scarf" + DELIM: "🧣",
    DELIM + r"gloves" + DELIM: "🧤",
    DELIM + r"coat" + DELIM: "🧥",
    DELIM + r"socks" + DELIM: "🧦",
    DELIM + r"dress" + DELIM: "👗",
    DELIM + r"kimono" + DELIM: "👘",
    DELIM + r"sari" + DELIM: "🥻",
    DELIM + r"one_piece_swimsuit" + DELIM: "🩱",
    DELIM + r"swim_brief" + DELIM: "🩲",
    DELIM + r"shorts" + DELIM: "🩳",
    DELIM + r"bikini" + DELIM: "👙",
    DELIM + r"womans_clothes" + DELIM: "👚",
    DELIM + r"purse" + DELIM: "👛",
    DELIM + r"handbag" + DELIM: "👜",
    DELIM + r"pouch" + DELIM: "👝",
    DELIM + r"shopping" + DELIM: "🛍️",
    DELIM + r"school_satchel" + DELIM: "🎒",
    DELIM + r"thong_sandal" + DELIM: "🩴",
    DELIM + r"(mans_)?shoe" + DELIM: "👞",
    DELIM + r"athletic_shoe" + DELIM: "👟",
    DELIM + r"hiking_boot" + DELIM: "🥾",
    DELIM + r"flat_shoe" + DELIM: "🥿",
    DELIM + r"high_heel" + DELIM: "👠",
    DELIM + r"sandal" + DELIM: "👡",
    DELIM + r"ballet_shoes" + DELIM: "🩰",
    DELIM + r"boot" + DELIM: "👢",
    DELIM + r"crown" + DELIM: "👑",
    DELIM + r"womans_hat" + DELIM: "👒",
    DELIM + r"tophat" + DELIM: "🎩",
    DELIM + r"mortar_board" + DELIM: "🎓",
    DELIM + r"billed_cap" + DELIM: "🧢",
    DELIM + r"military_helmet" + DELIM: "🪖",
    DELIM + r"rescue_worker_helmet" + DELIM: "⛑️",
    DELIM + r"prayer_beads" + DELIM: "📿",
    DELIM + r"lipstick" + DELIM: "💄",
    DELIM + r"ring" + DELIM: "💍",
    DELIM + r"gem" + DELIM: "💎",
    #
    # Sound
    #
    DELIM + r"mute" + DELIM: "🔇",
    DELIM + r"speaker" + DELIM: "🔈",
    DELIM + r"sound" + DELIM: "🔉",
    DELIM + r"loud_sound" + DELIM: "🔊",
    DELIM + r"loudspeaker" + DELIM: "📢",
    DELIM + r"mega" + DELIM: "📣",
    DELIM + r"postal_horn" + DELIM: "📯",
    DELIM + r"bell" + DELIM: "🔔",
    DELIM + r"no_bell" + DELIM: "🔕",
    #
    # Music
    #
    DELIM + r"musical_score" + DELIM: "🎼",
    DELIM + r"musical_note" + DELIM: "🎵",
    DELIM + r"notes" + DELIM: "🎶",
    DELIM + r"studio_microphone" + DELIM: "🎙️",
    DELIM + r"level_slider" + DELIM: "🎚️",
    DELIM + r"control_knobs" + DELIM: "🎛️",
    DELIM + r"microphone" + DELIM: "🎤",
    DELIM + r"headphones" + DELIM: "🎧",
    DELIM + r"radio" + DELIM: "📻",
    #
    # Musical Instrument
    #
    DELIM + r"saxophone" + DELIM: "🎷",
    DELIM + r"accordion" + DELIM: "🪗",
    DELIM + r"guitar" + DELIM: "🎸",
    DELIM + r"musical_keyboard" + DELIM: "🎹",
    DELIM + r"trumpet" + DELIM: "🎺",
    DELIM + r"violin" + DELIM: "🎻",
    DELIM + r"banjo" + DELIM: "🪕",
    DELIM + r"drum" + DELIM: "🥁",
    DELIM + r"long_drum" + DELIM: "🪘",
    #
    # Phone
    #
    DELIM + r"iphone" + DELIM: "📱",
    DELIM + r"calling" + DELIM: "📲",
    DELIM + r"phone" + DELIM: "☎️",
    DELIM + r"telephone(_receiver)?" + DELIM: "📞",
    DELIM + r"pager" + DELIM: "📟",
    DELIM + r"fax" + DELIM: "📠",
    #
    # Computer
    #
    DELIM + r"battery" + DELIM: "🔋",
    DELIM + r"electric_plug" + DELIM: "🔌",
    DELIM + r"computer" + DELIM: "💻",
    DELIM + r"desktop_computer" + DELIM: "🖥️",
    DELIM + r"printer" + DELIM: "🖨️",
    DELIM + r"keyboard" + DELIM: "⌨️",
    DELIM + r"computer_mouse" + DELIM: "🖱️",
    DELIM + r"trackball" + DELIM: "🖲️",
    DELIM + r"minidisc" + DELIM: "💽",
    DELIM + r"floppy_disk" + DELIM: "💾",
    DELIM + r"cd" + DELIM: "💿",
    DELIM + r"dvd" + DELIM: "📀",
    DELIM + r"abacus" + DELIM: "🧮",
    #
    # Light & Video
    #
    DELIM + r"movie_camera" + DELIM: "🎥",
    DELIM + r"film_strip" + DELIM: "🎞️",
    DELIM + r"film_projector" + DELIM: "📽️",
    DELIM + r"clapper" + DELIM: "🎬",
    DELIM + r"tv" + DELIM: "📺",
    DELIM + r"camera" + DELIM: "📷",
    DELIM + r"camera_flash" + DELIM: "📸",
    DELIM + r"video_camera" + DELIM: "📹",
    DELIM + r"vhs" + DELIM: "📼",
    DELIM + r"mag" + DELIM: "🔍",
    DELIM + r"mag_right" + DELIM: "🔎",
    DELIM + r"candle" + DELIM: "🕯️",
    DELIM + r"bulb" + DELIM: "💡",
    DELIM + r"flashlight" + DELIM: "🔦",
    DELIM + r"(izakaya_)?lantern" + DELIM: "🏮",
    DELIM + r"diya_lamp" + DELIM: "🪔",
    #
    # Book Paper
    #
    DELIM + r"notebook_with_decorative_cover" + DELIM: "📔",
    DELIM + r"closed_book" + DELIM: "📕",
    DELIM + r"(open_)?book" + DELIM: "📖",
    DELIM + r"green_book" + DELIM: "📗",
    DELIM + r"blue_book" + DELIM: "📘",
    DELIM + r"orange_book" + DELIM: "📙",
    DELIM + r"books" + DELIM: "📚",
    DELIM + r"notebook" + DELIM: "📓",
    DELIM + r"ledger" + DELIM: "📒",
    DELIM + r"page_with_curl" + DELIM: "📃",
    DELIM + r"scroll" + DELIM: "📜",
    DELIM + r"page_facing_up" + DELIM: "📄",
    DELIM + r"newspaper" + DELIM: "📰",
    DELIM + r"newspaper_roll" + DELIM: "🗞️",
    DELIM + r"bookmark_tabs" + DELIM: "📑",
    DELIM + r"bookmark" + DELIM: "🔖",
    DELIM + r"label" + DELIM: "🏷️",
    #
    # Money
    #
    DELIM + r"moneybag" + DELIM: "💰",
    DELIM + r"coin" + DELIM: "🪙",
    DELIM + r"yen" + DELIM: "💴",
    DELIM + r"dollar" + DELIM: "💵",
    DELIM + r"euro" + DELIM: "💶",
    DELIM + r"pound" + DELIM: "💷",
    DELIM + r"money_with_wings" + DELIM: "💸",
    DELIM + r"credit_card" + DELIM: "💳",
    DELIM + r"receipt" + DELIM: "🧾",
    DELIM + r"chart" + DELIM: "💹",
    #
    # Mail
    #
    DELIM + r"envelope" + DELIM: "✉️",
    DELIM + r"e-?mail" + DELIM: "📧",
    DELIM + r"incoming_envelope" + DELIM: "📨",
    DELIM + r"envelope_with_arrow" + DELIM: "📩",
    DELIM + r"outbox_tray" + DELIM: "📤",
    DELIM + r"inbox_tray" + DELIM: "📥",
    DELIM + r"package" + DELIM: "📦",
    DELIM + r"mailbox" + DELIM: "📫",
    DELIM + r"mailbox_closed" + DELIM: "📪",
    DELIM + r"mailbox_with_mail" + DELIM: "📬",
    DELIM + r"mailbox_with_no_mail" + DELIM: "📭",
    DELIM + r"postbox" + DELIM: "📮",
    DELIM + r"ballot_box" + DELIM: "🗳️",
    #
    # Writing
    #
    DELIM + r"pencil2" + DELIM: "✏️",
    DELIM + r"black_nib" + DELIM: "✒️",
    DELIM + r"fountain_pen" + DELIM: "🖋️",
    DELIM + r"pen" + DELIM: "🖊️",
    DELIM + r"paintbrush" + DELIM: "🖌️",
    DELIM + r"crayon" + DELIM: "🖍️",
    DELIM + r"(memo|pencil)" + DELIM: "📝",
    #
    # Office
    #
    DELIM + r"briefcase" + DELIM: "💼",
    DELIM + r"file_folder" + DELIM: "📁",
    DELIM + r"open_file_folder" + DELIM: "📂",
    DELIM + r"card_index_dividers" + DELIM: "🗂️",
    DELIM + r"date" + DELIM: "📅",
    DELIM + r"calendar" + DELIM: "📆",
    DELIM + r"spiral_notepad" + DELIM: "🗒️",
    DELIM + r"spiral_calendar" + DELIM: "🗓️",
    DELIM + r"card_index" + DELIM: "📇",
    DELIM + r"chart_with_upwards_trend" + DELIM: "📈",
    DELIM + r"chart_with_downwards_trend" + DELIM: "📉",
    DELIM + r"bar_chart" + DELIM: "📊",
    DELIM + r"clipboard" + DELIM: "📋",
    DELIM + r"pushpin" + DELIM: "📌",
    DELIM + r"round_pushpin" + DELIM: "📍",
    DELIM + r"paperclip" + DELIM: "📎",
    DELIM + r"paperclips" + DELIM: "🖇️",
    DELIM + r"straight_ruler" + DELIM: "📏",
    DELIM + r"triangular_ruler" + DELIM: "📐",
    DELIM + r"scissors" + DELIM: "✂️",
    DELIM + r"card_file_box" + DELIM: "🗃️",
    DELIM + r"file_cabinet" + DELIM: "🗄️",
    DELIM + r"wastebasket" + DELIM: "🗑️",
    #
    # Lock
    #
    DELIM + r"lock" + DELIM: "🔒",
    DELIM + r"unlock" + DELIM: "🔓",
    DELIM + r"lock_with_ink_pen" + DELIM: "🔏",
    DELIM + r"closed_lock_with_key" + DELIM: "🔐",
    DELIM + r"key" + DELIM: "🔑",
    DELIM + r"old_key" + DELIM: "🗝️",
    #
    # Tool
    #
    DELIM + r"hammer" + DELIM: "🔨",
    DELIM + r"axe" + DELIM: "🪓",
    DELIM + r"pick" + DELIM: "⛏️",
    DELIM + r"hammer_and_pick" + DELIM: "⚒️",
    DELIM + r"hammer_and_wrench" + DELIM: "🛠️",
    DELIM + r"dagger" + DELIM: "🗡️",
    DELIM + r"crossed_swords" + DELIM: "⚔️",
    DELIM + r"bomb" + DELIM: "💣",
    DELIM + r"boomerang" + DELIM: "🪃",
    DELIM + r"bow_and_arrow" + DELIM: "🏹",
    DELIM + r"shield" + DELIM: "🛡️",
    DELIM + r"carpentry_saw" + DELIM: "🪚",
    DELIM + r"wrench" + DELIM: "🔧",
    DELIM + r"screwdriver" + DELIM: "🪛",
    DELIM + r"nut_and_bolt" + DELIM: "🔩",
    DELIM + r"gear" + DELIM: "⚙️",
    DELIM + r"clamp" + DELIM: "🗜️",
    DELIM + r"balance_scale" + DELIM: "⚖️",
    DELIM + r"probing_cane" + DELIM: "🦯",
    DELIM + r"link" + DELIM: "🔗",
    DELIM + r"chains" + DELIM: "⛓️",
    DELIM + r"hook" + DELIM: "🪝",
    DELIM + r"toolbox" + DELIM: "🧰",
    DELIM + r"magnet" + DELIM: "🧲",
    DELIM + r"ladder" + DELIM: "🪜",
    #
    # Science
    #
    DELIM + r"alembic" + DELIM: "⚗️",
    DELIM + r"test_tube" + DELIM: "🧪",
    DELIM + r"petri_dish" + DELIM: "🧫",
    DELIM + r"dna" + DELIM: "🧬",
    DELIM + r"microscope" + DELIM: "🔬",
    DELIM + r"telescope" + DELIM: "🔭",
    DELIM + r"satellite" + DELIM: "📡",
    #
    # Medical
    #
    DELIM + r"syringe" + DELIM: "💉",
    DELIM + r"drop_of_blood" + DELIM: "🩸",
    DELIM + r"pill" + DELIM: "💊",
    DELIM + r"adhesive_bandage" + DELIM: "🩹",
    DELIM + r"stethoscope" + DELIM: "🩺",
    #
    # Household
    #
    DELIM + r"door" + DELIM: "🚪",
    DELIM + r"elevator" + DELIM: "🛗",
    DELIM + r"mirror" + DELIM: "🪞",
    DELIM + r"window" + DELIM: "🪟",
    DELIM + r"bed" + DELIM: "🛏️",
    DELIM + r"couch_and_lamp" + DELIM: "🛋️",
    DELIM + r"chair" + DELIM: "🪑",
    DELIM + r"toilet" + DELIM: "🚽",
    DELIM + r"plunger" + DELIM: "🪠",
    DELIM + r"shower" + DELIM: "🚿",
    DELIM + r"bathtub" + DELIM: "🛁",
    DELIM + r"mouse_trap" + DELIM: "🪤",
    DELIM + r"razor" + DELIM: "🪒",
    DELIM + r"lotion_bottle" + DELIM: "🧴",
    DELIM + r"safety_pin" + DELIM: "🧷",
    DELIM + r"broom" + DELIM: "🧹",
    DELIM + r"basket" + DELIM: "🧺",
    DELIM + r"roll_of_paper" + DELIM: "🧻",
    DELIM + r"bucket" + DELIM: "🪣",
    DELIM + r"soap" + DELIM: "🧼",
    DELIM + r"toothbrush" + DELIM: "🪥",
    DELIM + r"sponge" + DELIM: "🧽",
    DELIM + r"fire_extinguisher" + DELIM: "🧯",
    DELIM + r"shopping_cart" + DELIM: "🛒",
    #
    # Other Object
    #
    DELIM + r"smoking" + DELIM: "🚬",
    DELIM + r"coffin" + DELIM: "⚰️",
    DELIM + r"headstone" + DELIM: "🪦",
    DELIM + r"funeral_urn" + DELIM: "⚱️",
    DELIM + r"nazar_amulet" + DELIM: "🧿",
    DELIM + r"moyai" + DELIM: "🗿",
    DELIM + r"placard" + DELIM: "🪧",
    #
    # Transport Sign
    #
    DELIM + r"atm" + DELIM: "🏧",
    DELIM + r"put_litter_in_its_place" + DELIM: "🚮",
    DELIM + r"potable_water" + DELIM: "🚰",
    DELIM + r"wheelchair" + DELIM: "♿",
    DELIM + r"mens" + DELIM: "🚹",
    DELIM + r"womens" + DELIM: "🚺",
    DELIM + r"restroom" + DELIM: "🚻",
    DELIM + r"baby_symbol" + DELIM: "🚼",
    DELIM + r"wc" + DELIM: "🚾",
    DELIM + r"passport_control" + DELIM: "🛂",
    DELIM + r"customs" + DELIM: "🛃",
    DELIM + r"baggage_claim" + DELIM: "🛄",
    DELIM + r"left_luggage" + DELIM: "🛅",
    #
    # Warning
    #
    DELIM + r"warning" + DELIM: "⚠️",
    DELIM + r"children_crossing" + DELIM: "🚸",
    DELIM + r"no_entry" + DELIM: "⛔",
    DELIM + r"no_entry_sign" + DELIM: "🚫",
    DELIM + r"no_bicycles" + DELIM: "🚳",
    DELIM + r"no_smoking" + DELIM: "🚭",
    DELIM + r"do_not_litter" + DELIM: "🚯",
    DELIM + r"non-potable_water" + DELIM: "🚱",
    DELIM + r"no_pedestrians" + DELIM: "🚷",
    DELIM + r"no_mobile_phones" + DELIM: "📵",
    DELIM + r"underage" + DELIM: "🔞",
    DELIM + r"radioactive" + DELIM: "☢️",
    DELIM + r"biohazard" + DELIM: "☣️",
    #
    # Arrow
    #
    DELIM + r"arrow_up" + DELIM: "⬆️",
    DELIM + r"arrow_upper_right" + DELIM: "↗️",
    DELIM + r"arrow_right" + DELIM: "➡️",
    DELIM + r"arrow_lower_right" + DELIM: "↘️",
    DELIM + r"arrow_down" + DELIM: "⬇️",
    DELIM + r"arrow_lower_left" + DELIM: "↙️",
    DELIM + r"arrow_left" + DELIM: "⬅️",
    DELIM + r"arrow_upper_left" + DELIM: "↖️",
    DELIM + r"arrow_up_down" + DELIM: "↕️",
    DELIM + r"left_right_arrow" + DELIM: "↔️",
    DELIM + r"leftwards_arrow_with_hook" + DELIM: "↩️",
    DELIM + r"arrow_right_hook" + DELIM: "↪️",
    DELIM + r"arrow_heading_up" + DELIM: "⤴️",
    DELIM + r"arrow_heading_down" + DELIM: "⤵️",
    DELIM + r"arrows_clockwise" + DELIM: "🔃",
    DELIM + r"arrows_counterclockwise" + DELIM: "🔄",
    DELIM + r"back" + DELIM: "🔙",
    DELIM + r"end" + DELIM: "🔚",
    DELIM + r"on" + DELIM: "🔛",
    DELIM + r"soon" + DELIM: "🔜",
    DELIM + r"top" + DELIM: "🔝",
    #
    # Religion
    #
    DELIM + r"place_of_worship" + DELIM: "🛐",
    DELIM + r"atom_symbol" + DELIM: "⚛️",
    DELIM + r"om" + DELIM: "🕉️",
    DELIM + r"star_of_david" + DELIM: "✡️",
    DELIM + r"wheel_of_dharma" + DELIM: "☸️",
    DELIM + r"yin_yang" + DELIM: "☯️",
    DELIM + r"latin_cross" + DELIM: "✝️",
    DELIM + r"orthodox_cross" + DELIM: "☦️",
    DELIM + r"star_and_crescent" + DELIM: "☪️",
    DELIM + r"peace_symbol" + DELIM: "☮️",
    DELIM + r"menorah" + DELIM: "🕎",
    DELIM + r"six_pointed_star" + DELIM: "🔯",
    #
    # Zodiac
    #
    DELIM + r"aries" + DELIM: "♈",
    DELIM + r"taurus" + DELIM: "♉",
    DELIM + r"gemini" + DELIM: "♊",
    DELIM + r"cancer" + DELIM: "♋",
    DELIM + r"leo" + DELIM: "♌",
    DELIM + r"virgo" + DELIM: "♍",
    DELIM + r"libra" + DELIM: "♎",
    DELIM + r"scorpius" + DELIM: "♏",
    DELIM + r"sagittarius" + DELIM: "♐",
    DELIM + r"capricorn" + DELIM: "♑",
    DELIM + r"aquarius" + DELIM: "♒",
    DELIM + r"pisces" + DELIM: "♓",
    DELIM + r"ophiuchus" + DELIM: "⛎",
    #
    # Av Symbol
    #
    DELIM + r"twisted_rightwards_arrows" + DELIM: "🔀",
    DELIM + r"repeat" + DELIM: "🔁",
    DELIM + r"repeat_one" + DELIM: "🔂",
    DELIM + r"arrow_forward" + DELIM: "▶️",
    DELIM + r"fast_forward" + DELIM: "⏩",
    DELIM + r"next_track_button" + DELIM: "⏭️",
    DELIM + r"play_or_pause_button" + DELIM: "⏯️",
    DELIM + r"arrow_backward" + DELIM: "◀️",
    DELIM + r"rewind" + DELIM: "⏪",
    DELIM + r"previous_track_button" + DELIM: "⏮️",
    DELIM + r"arrow_up_small" + DELIM: "🔼",
    DELIM + r"arrow_double_up" + DELIM: "⏫",
    DELIM + r"arrow_down_small" + DELIM: "🔽",
    DELIM + r"arrow_double_down" + DELIM: "⏬",
    DELIM + r"pause_button" + DELIM: "⏸️",
    DELIM + r"stop_button" + DELIM: "⏹️",
    DELIM + r"record_button" + DELIM: "⏺️",
    DELIM + r"eject_button" + DELIM: "⏏️",
    DELIM + r"cinema" + DELIM: "🎦",
    DELIM + r"low_brightness" + DELIM: "🔅",
    DELIM + r"high_brightness" + DELIM: "🔆",
    DELIM + r"signal_strength" + DELIM: "📶",
    DELIM + r"vibration_mode" + DELIM: "📳",
    DELIM + r"mobile_phone_off" + DELIM: "📴",
    #
    # Gender
    #
    DELIM + r"female_sign" + DELIM: "♀️",
    DELIM + r"male_sign" + DELIM: "♂️",
    DELIM + r"transgender_symbol" + DELIM: "⚧️",
    #
    # Math
    #
    DELIM + r"heavy_multiplication_x" + DELIM: "✖️",
    DELIM + r"heavy_plus_sign" + DELIM: "➕",  # noqa: RUF001
    DELIM + r"heavy_minus_sign" + DELIM: "➖",  # noqa: RUF001
    DELIM + r"heavy_division_sign" + DELIM: "➗",
    DELIM + r"infinity" + DELIM: "♾️",
    #
    # Punctuation
    #
    DELIM + r"bangbang" + DELIM: "‼️",
    DELIM + r"interrobang" + DELIM: "⁉️",
    DELIM + r"question" + DELIM: "❓",
    DELIM + r"grey_question" + DELIM: "❔",
    DELIM + r"grey_exclamation" + DELIM: "❕",
    DELIM + r"(heavy_exclamation_mark|exclamation)" + DELIM: "❗",
    DELIM + r"wavy_dash" + DELIM: "〰️",
    #
    # Currency
    #
    DELIM + r"currency_exchange" + DELIM: "💱",
    DELIM + r"heavy_dollar_sign" + DELIM: "💲",
    #
    # Other Symbol
    #
    DELIM + r"medical_symbol" + DELIM: "⚕️",
    DELIM + r"recycle" + DELIM: "♻️",
    DELIM + r"fleur_de_lis" + DELIM: "⚜️",
    DELIM + r"trident" + DELIM: "🔱",
    DELIM + r"name_badge" + DELIM: "📛",
    DELIM + r"beginner" + DELIM: "🔰",
    DELIM + r"o" + DELIM: "⭕",
    DELIM + r"white_check_mark" + DELIM: "✅",
    DELIM + r"ballot_box_with_check" + DELIM: "☑️",
    DELIM + r"heavy_check_mark" + DELIM: "✔️",
    DELIM + r"x" + DELIM: "❌",
    DELIM + r"negative_squared_cross_mark" + DELIM: "❎",
    DELIM + r"curly_loop" + DELIM: "➰",
    DELIM + r"loop" + DELIM: "➿",
    DELIM + r"part_alternation_mark" + DELIM: "〽️",
    DELIM + r"eight_spoked_asterisk" + DELIM: "✳️",
    DELIM + r"eight_pointed_black_star" + DELIM: "✴️",
    DELIM + r"sparkle" + DELIM: "❇️",
    DELIM + r"copyright" + DELIM: "©️",
    DELIM + r"registered" + DELIM: "®️",
    DELIM + r"tm" + DELIM: "™️",
    #
    # Keycap
    #
    DELIM + r"hash" + DELIM: "#️⃣",
    DELIM + r"asterisk" + DELIM: "*️⃣",
    DELIM + r"zero" + DELIM: "0️⃣",
    DELIM + r"one" + DELIM: "1️⃣",
    DELIM + r"two" + DELIM: "2️⃣",
    DELIM + r"three" + DELIM: "3️⃣",
    DELIM + r"four" + DELIM: "4️⃣",
    DELIM + r"five" + DELIM: "5️⃣",
    DELIM + r"six" + DELIM: "6️⃣",
    DELIM + r"seven" + DELIM: "7️⃣",
    DELIM + r"eight" + DELIM: "8️⃣",
    DELIM + r"nine" + DELIM: "9️⃣",
    DELIM + r"keycap_ten" + DELIM: "🔟",
    #
    # Alphanum
    #
    DELIM + r"capital_abcd" + DELIM: "🔠",
    DELIM + r"abcd" + DELIM: "🔡",
    DELIM + r"1234" + DELIM: "🔢",
    DELIM + r"symbols" + DELIM: "🔣",
    DELIM + r"abc" + DELIM: "🔤",
    DELIM + r"a" + DELIM: "🅰️",
    DELIM + r"ab" + DELIM: "🆎",
    DELIM + r"b" + DELIM: "🅱️",
    DELIM + r"cl" + DELIM: "🆑",
    DELIM + r"cool" + DELIM: "🆒",
    DELIM + r"free" + DELIM: "🆓",
    DELIM + r"information_source" + DELIM: "ℹ️",  # noqa: RUF001
    DELIM + r"id" + DELIM: "🆔",
    DELIM + r"m" + DELIM: "Ⓜ️",
    DELIM + r"new" + DELIM: "🆕",
    DELIM + r"ng" + DELIM: "🆖",
    DELIM + r"o2" + DELIM: "🅾️",
    DELIM + r"ok" + DELIM: "🆗",
    DELIM + r"parking" + DELIM: "🅿️",
    DELIM + r"sos" + DELIM: "🆘",
    DELIM + r"up" + DELIM: "🆙",
    DELIM + r"vs" + DELIM: "🆚",
    DELIM + r"koko" + DELIM: "🈁",
    DELIM + r"sa" + DELIM: "🈂️",
    DELIM + r"u6708" + DELIM: "🈷️",
    DELIM + r"u6709" + DELIM: "🈶",
    DELIM + r"u6307" + DELIM: "🈯",
    DELIM + r"ideograph_advantage" + DELIM: "🉐",
    DELIM + r"u5272" + DELIM: "🈹",
    DELIM + r"u7121" + DELIM: "🈚",
    DELIM + r"u7981" + DELIM: "🈲",
    DELIM + r"accept" + DELIM: "🉑",
    DELIM + r"u7533" + DELIM: "🈸",
    DELIM + r"u5408" + DELIM: "🈴",
    DELIM + r"u7a7a" + DELIM: "🈳",
    DELIM + r"congratulations" + DELIM: "㊗️",
    DELIM + r"secret" + DELIM: "㊙️",
    DELIM + r"u55b6" + DELIM: "🈺",
    DELIM + r"u6e80" + DELIM: "🈵",
    #
    # Geometric
    #
    DELIM + r"red_circle" + DELIM: "🔴",
    DELIM + r"orange_circle" + DELIM: "🟠",
    DELIM + r"yellow_circle" + DELIM: "🟡",
    DELIM + r"green_circle" + DELIM: "🟢",
    DELIM + r"large_blue_circle" + DELIM: "🔵",
    DELIM + r"purple_circle" + DELIM: "🟣",
    DELIM + r"brown_circle" + DELIM: "🟤",
    DELIM + r"black_circle" + DELIM: "⚫",
    DELIM + r"white_circle" + DELIM: "⚪",
    DELIM + r"red_square" + DELIM: "🟥",
    DELIM + r"orange_square" + DELIM: "🟧",
    DELIM + r"yellow_square" + DELIM: "🟨",
    DELIM + r"green_square" + DELIM: "🟩",
    DELIM + r"blue_square" + DELIM: "🟦",
    DELIM + r"purple_square" + DELIM: "🟪",
    DELIM + r"brown_square" + DELIM: "🟫",
    DELIM + r"black_large_square" + DELIM: "⬛",
    DELIM + r"white_large_square" + DELIM: "⬜",
    DELIM + r"black_medium_square" + DELIM: "◼️",
    DELIM + r"white_medium_square" + DELIM: "◻️",
    DELIM + r"black_medium_small_square" + DELIM: "◾",
    DELIM + r"white_medium_small_square" + DELIM: "◽",
    DELIM + r"black_small_square" + DELIM: "▪️",
    DELIM + r"white_small_square" + DELIM: "▫️",
    DELIM + r"large_orange_diamond" + DELIM: "🔶",
    DELIM + r"large_blue_diamond" + DELIM: "🔷",
    DELIM + r"small_orange_diamond" + DELIM: "🔸",
    DELIM + r"small_blue_diamond" + DELIM: "🔹",
    DELIM + r"small_red_triangle" + DELIM: "🔺",
    DELIM + r"small_red_triangle_down" + DELIM: "🔻",
    DELIM + r"diamond_shape_with_a_dot_inside" + DELIM: "💠",
    DELIM + r"radio_button" + DELIM: "🔘",
    DELIM + r"white_square_button" + DELIM: "🔳",
    DELIM + r"black_square_button" + DELIM: "🔲",
    #
    # Flag
    #
    DELIM + r"checkered_flag" + DELIM: "🏁",
    DELIM + r"triangular_flag_on_post" + DELIM: "🚩",
    DELIM + r"crossed_flags" + DELIM: "🎌",
    DELIM + r"black_flag" + DELIM: "🏴",
    DELIM + r"white_flag" + DELIM: "🏳️",
    DELIM + r"rainbow_flag" + DELIM: "🏳️‍🌈",
    DELIM + r"transgender_flag" + DELIM: "🏳️‍⚧️",
    DELIM + r"pirate_flag" + DELIM: "🏴‍☠️",
    #
    # Country Flag
    #
    DELIM + r"ascension_island" + DELIM: "🇦🇨",
    DELIM + r"andorra" + DELIM: "🇦🇩",
    DELIM + r"united_arab_emirates" + DELIM: "🇦🇪",
    DELIM + r"afghanistan" + DELIM: "🇦🇫",
    DELIM + r"antigua_barbuda" + DELIM: "🇦🇬",
    DELIM + r"anguilla" + DELIM: "🇦🇮",
    DELIM + r"albania" + DELIM: "🇦🇱",
    DELIM + r"armenia" + DELIM: "🇦🇲",
    DELIM + r"angola" + DELIM: "🇦🇴",
    DELIM + r"antarctica" + DELIM: "🇦🇶",
    DELIM + r"argentina" + DELIM: "🇦🇷",
    DELIM + r"american_samoa" + DELIM: "🇦🇸",
    DELIM + r"austria" + DELIM: "🇦🇹",
    DELIM + r"australia" + DELIM: "🇦🇺",
    DELIM + r"aruba" + DELIM: "🇦🇼",
    DELIM + r"aland_islands" + DELIM: "🇦🇽",
    DELIM + r"azerbaijan" + DELIM: "🇦🇿",
    DELIM + r"bosnia_herzegovina" + DELIM: "🇧🇦",
    DELIM + r"barbados" + DELIM: "🇧🇧",
    DELIM + r"bangladesh" + DELIM: "🇧🇩",
    DELIM + r"belgium" + DELIM: "🇧🇪",
    DELIM + r"burkina_faso" + DELIM: "🇧🇫",
    DELIM + r"bulgaria" + DELIM: "🇧🇬",
    DELIM + r"bahrain" + DELIM: "🇧🇭",
    DELIM + r"burundi" + DELIM: "🇧🇮",
    DELIM + r"benin" + DELIM: "🇧🇯",
    DELIM + r"st_barthelemy" + DELIM: "🇧🇱",
    DELIM + r"bermuda" + DELIM: "🇧🇲",
    DELIM + r"brunei" + DELIM: "🇧🇳",
    DELIM + r"bolivia" + DELIM: "🇧🇴",
    DELIM + r"caribbean_netherlands" + DELIM: "🇧🇶",
    DELIM + r"brazil" + DELIM: "🇧🇷",
    DELIM + r"bahamas" + DELIM: "🇧🇸",
    DELIM + r"bhutan" + DELIM: "🇧🇹",
    DELIM + r"bouvet_island" + DELIM: "🇧🇻",
    DELIM + r"botswana" + DELIM: "🇧🇼",
    DELIM + r"belarus" + DELIM: "🇧🇾",
    DELIM + r"belize" + DELIM: "🇧🇿",
    DELIM + r"canada" + DELIM: "🇨🇦",
    DELIM + r"cocos_islands" + DELIM: "🇨🇨",
    DELIM + r"congo_kinshasa" + DELIM: "🇨🇩",
    DELIM + r"central_african_republic" + DELIM: "🇨🇫",
    DELIM + r"congo_brazzaville" + DELIM: "🇨🇬",
    DELIM + r"switzerland" + DELIM: "🇨🇭",
    DELIM + r"cote_divoire" + DELIM: "🇨🇮",
    DELIM + r"cook_islands" + DELIM: "🇨🇰",
    DELIM + r"chile" + DELIM: "🇨🇱",
    DELIM + r"cameroon" + DELIM: "🇨🇲",
    DELIM + r"cn" + DELIM: "🇨🇳",
    DELIM + r"colombia" + DELIM: "🇨🇴",
    DELIM + r"clipperton_island" + DELIM: "🇨🇵",
    DELIM + r"costa_rica" + DELIM: "🇨🇷",
    DELIM + r"cuba" + DELIM: "🇨🇺",
    DELIM + r"cape_verde" + DELIM: "🇨🇻",
    DELIM + r"curacao" + DELIM: "🇨🇼",
    DELIM + r"christmas_island" + DELIM: "🇨🇽",
    DELIM + r"cyprus" + DELIM: "🇨🇾",
    DELIM + r"czech_republic" + DELIM: "🇨🇿",
    DELIM + r"de" + DELIM: "🇩🇪",
    DELIM + r"diego_garcia" + DELIM: "🇩🇬",
    DELIM + r"djibouti" + DELIM: "🇩🇯",
    DELIM + r"denmark" + DELIM: "🇩🇰",
    DELIM + r"dominica" + DELIM: "🇩🇲",
    DELIM + r"dominican_republic" + DELIM: "🇩🇴",
    DELIM + r"algeria" + DELIM: "🇩🇿",
    DELIM + r"ceuta_melilla" + DELIM: "🇪🇦",
    DELIM + r"ecuador" + DELIM: "🇪🇨",
    DELIM + r"estonia" + DELIM: "🇪🇪",
    DELIM + r"egypt" + DELIM: "🇪🇬",
    DELIM + r"western_sahara" + DELIM: "🇪🇭",
    DELIM + r"eritrea" + DELIM: "🇪🇷",
    DELIM + r"es" + DELIM: "🇪🇸",
    DELIM + r"ethiopia" + DELIM: "🇪🇹",
    DELIM + r"(eu|european_union)" + DELIM: "🇪🇺",
    DELIM + r"finland" + DELIM: "🇫🇮",
    DELIM + r"fiji" + DELIM: "🇫🇯",
    DELIM + r"falkland_islands" + DELIM: "🇫🇰",
    DELIM + r"micronesia" + DELIM: "🇫🇲",
    DELIM + r"faroe_islands" + DELIM: "🇫🇴",
    DELIM + r"fr" + DELIM: "🇫🇷",
    DELIM + r"gabon" + DELIM: "🇬🇦",
    DELIM + r"(uk|gb)" + DELIM: "🇬🇧",
    DELIM + r"grenada" + DELIM: "🇬🇩",
    DELIM + r"georgia" + DELIM: "🇬🇪",
    DELIM + r"french_guiana" + DELIM: "🇬🇫",
    DELIM + r"guernsey" + DELIM: "🇬🇬",
    DELIM + r"ghana" + DELIM: "🇬🇭",
    DELIM + r"gibraltar" + DELIM: "🇬🇮",
    DELIM + r"greenland" + DELIM: "🇬🇱",
    DELIM + r"gambia" + DELIM: "🇬🇲",
    DELIM + r"guinea" + DELIM: "🇬🇳",
    DELIM + r"guadeloupe" + DELIM: "🇬🇵",
    DELIM + r"equatorial_guinea" + DELIM: "🇬🇶",
    DELIM + r"greece" + DELIM: "🇬🇷",
    DELIM + r"south_georgia_south_sandwich_islands" + DELIM: "🇬🇸",
    DELIM + r"guatemala" + DELIM: "🇬🇹",
    DELIM + r"guam" + DELIM: "🇬🇺",
    DELIM + r"guinea_bissau" + DELIM: "🇬🇼",
    DELIM + r"guyana" + DELIM: "🇬🇾",
    DELIM + r"hong_kong" + DELIM: "🇭🇰",
    DELIM + r"heard_mcdonald_islands" + DELIM: "🇭🇲",
    DELIM + r"honduras" + DELIM: "🇭🇳",
    DELIM + r"croatia" + DELIM: "🇭🇷",
    DELIM + r"haiti" + DELIM: "🇭🇹",
    DELIM + r"hungary" + DELIM: "🇭🇺",
    DELIM + r"canary_islands" + DELIM: "🇮🇨",
    DELIM + r"indonesia" + DELIM: "🇮🇩",
    DELIM + r"ireland" + DELIM: "🇮🇪",
    DELIM + r"israel" + DELIM: "🇮🇱",
    DELIM + r"isle_of_man" + DELIM: "🇮🇲",
    DELIM + r"india" + DELIM: "🇮🇳",
    DELIM + r"british_indian_ocean_territory" + DELIM: "🇮🇴",
    DELIM + r"iraq" + DELIM: "🇮🇶",
    DELIM + r"iran" + DELIM: "🇮🇷",
    DELIM + r"iceland" + DELIM: "🇮🇸",
    DELIM + r"it" + DELIM: "🇮🇹",
    DELIM + r"jersey" + DELIM: "🇯🇪",
    DELIM + r"jamaica" + DELIM: "🇯🇲",
    DELIM + r"jordan" + DELIM: "🇯🇴",
    DELIM + r"jp" + DELIM: "🇯🇵",
    DELIM + r"kenya" + DELIM: "🇰🇪",
    DELIM + r"kyrgyzstan" + DELIM: "🇰🇬",
    DELIM + r"cambodia" + DELIM: "🇰🇭",
    DELIM + r"kiribati" + DELIM: "🇰🇮",
    DELIM + r"comoros" + DELIM: "🇰🇲",
    DELIM + r"st_kitts_nevis" + DELIM: "🇰🇳",
    DELIM + r"north_korea" + DELIM: "🇰🇵",
    DELIM + r"kr" + DELIM: "🇰🇷",
    DELIM + r"kuwait" + DELIM: "🇰🇼",
    DELIM + r"cayman_islands" + DELIM: "🇰🇾",
    DELIM + r"kazakhstan" + DELIM: "🇰🇿",
    DELIM + r"laos" + DELIM: "🇱🇦",
    DELIM + r"lebanon" + DELIM: "🇱🇧",
    DELIM + r"st_lucia" + DELIM: "🇱🇨",
    DELIM + r"liechtenstein" + DELIM: "🇱🇮",
    DELIM + r"sri_lanka" + DELIM: "🇱🇰",
    DELIM + r"liberia" + DELIM: "🇱🇷",
    DELIM + r"lesotho" + DELIM: "🇱🇸",
    DELIM + r"lithuania" + DELIM: "🇱🇹",
    DELIM + r"luxembourg" + DELIM: "🇱🇺",
    DELIM + r"latvia" + DELIM: "🇱🇻",
    DELIM + r"libya" + DELIM: "🇱🇾",
    DELIM + r"morocco" + DELIM: "🇲🇦",
    DELIM + r"monaco" + DELIM: "🇲🇨",
    DELIM + r"moldova" + DELIM: "🇲🇩",
    DELIM + r"montenegro" + DELIM: "🇲🇪",
    DELIM + r"st_martin" + DELIM: "🇲🇫",
    DELIM + r"madagascar" + DELIM: "🇲🇬",
    DELIM + r"marshall_islands" + DELIM: "🇲🇭",
    DELIM + r"macedonia" + DELIM: "🇲🇰",
    DELIM + r"mali" + DELIM: "🇲🇱",
    DELIM + r"myanmar" + DELIM: "🇲🇲",
    DELIM + r"mongolia" + DELIM: "🇲🇳",
    DELIM + r"macau" + DELIM: "🇲🇴",
    DELIM + r"northern_mariana_islands" + DELIM: "🇲🇵",
    DELIM + r"martinique" + DELIM: "🇲🇶",
    DELIM + r"mauritania" + DELIM: "🇲🇷",
    DELIM + r"montserrat" + DELIM: "🇲🇸",
    DELIM + r"malta" + DELIM: "🇲🇹",
    DELIM + r"mauritius" + DELIM: "🇲🇺",
    DELIM + r"maldives" + DELIM: "🇲🇻",
    DELIM + r"malawi" + DELIM: "🇲🇼",
    DELIM + r"mexico" + DELIM: "🇲🇽",
    DELIM + r"malaysia" + DELIM: "🇲🇾",
    DELIM + r"mozambique" + DELIM: "🇲🇿",
    DELIM + r"namibia" + DELIM: "🇳🇦",
    DELIM + r"new_caledonia" + DELIM: "🇳🇨",
    DELIM + r"niger" + DELIM: "🇳🇪",
    DELIM + r"norfolk_island" + DELIM: "🇳🇫",
    DELIM + r"nigeria" + DELIM: "🇳🇬",
    DELIM + r"nicaragua" + DELIM: "🇳🇮",
    DELIM + r"netherlands" + DELIM: "🇳🇱",
    DELIM + r"norway" + DELIM: "🇳🇴",
    DELIM + r"nepal" + DELIM: "🇳🇵",
    DELIM + r"nauru" + DELIM: "🇳🇷",
    DELIM + r"niue" + DELIM: "🇳🇺",
    DELIM + r"new_zealand" + DELIM: "🇳🇿",
    DELIM + r"oman" + DELIM: "🇴🇲",
    DELIM + r"panama" + DELIM: "🇵🇦",
    DELIM + r"peru" + DELIM: "🇵🇪",
    DELIM + r"french_polynesia" + DELIM: "🇵🇫",
    DELIM + r"papua_new_guinea" + DELIM: "🇵🇬",
    DELIM + r"philippines" + DELIM: "🇵🇭",
    DELIM + r"pakistan" + DELIM: "🇵🇰",
    DELIM + r"poland" + DELIM: "🇵🇱",
    DELIM + r"st_pierre_miquelon" + DELIM: "🇵🇲",
    DELIM + r"pitcairn_islands" + DELIM: "🇵🇳",
    DELIM + r"puerto_rico" + DELIM: "🇵🇷",
    DELIM + r"palestinian_territories" + DELIM: "🇵🇸",
    DELIM + r"portugal" + DELIM: "🇵🇹",
    DELIM + r"palau" + DELIM: "🇵🇼",
    DELIM + r"paraguay" + DELIM: "🇵🇾",
    DELIM + r"qatar" + DELIM: "🇶🇦",
    DELIM + r"reunion" + DELIM: "🇷🇪",
    DELIM + r"romania" + DELIM: "🇷🇴",
    DELIM + r"serbia" + DELIM: "🇷🇸",
    DELIM + r"ru" + DELIM: "🇷🇺",
    DELIM + r"rwanda" + DELIM: "🇷🇼",
    DELIM + r"saudi_arabia" + DELIM: "🇸🇦",
    DELIM + r"solomon_islands" + DELIM: "🇸🇧",
    DELIM + r"seychelles" + DELIM: "🇸🇨",
    DELIM + r"sudan" + DELIM: "🇸🇩",
    DELIM + r"sweden" + DELIM: "🇸🇪",
    DELIM + r"singapore" + DELIM: "🇸🇬",
    DELIM + r"st_helena" + DELIM: "🇸🇭",
    DELIM + r"slovenia" + DELIM: "🇸🇮",
    DELIM + r"svalbard_jan_mayen" + DELIM: "🇸🇯",
    DELIM + r"slovakia" + DELIM: "🇸🇰",
    DELIM + r"sierra_leone" + DELIM: "🇸🇱",
    DELIM + r"san_marino" + DELIM: "🇸🇲",
    DELIM + r"senegal" + DELIM: "🇸🇳",
    DELIM + r"somalia" + DELIM: "🇸🇴",
    DELIM + r"suriname" + DELIM: "🇸🇷",
    DELIM + r"south_sudan" + DELIM: "🇸🇸",
    DELIM + r"sao_tome_principe" + DELIM: "🇸🇹",
    DELIM + r"el_salvador" + DELIM: "🇸🇻",
    DELIM + r"sint_maarten" + DELIM: "🇸🇽",
    DELIM + r"syria" + DELIM: "🇸🇾",
    DELIM + r"swaziland" + DELIM: "🇸🇿",
    DELIM + r"tristan_da_cunha" + DELIM: "🇹🇦",
    DELIM + r"turks_caicos_islands" + DELIM: "🇹🇨",
    DELIM + r"chad" + DELIM: "🇹🇩",
    DELIM + r"french_southern_territories" + DELIM: "🇹🇫",
    DELIM + r"togo" + DELIM: "🇹🇬",
    DELIM + r"thailand" + DELIM: "🇹🇭",
    DELIM + r"tajikistan" + DELIM: "🇹🇯",
    DELIM + r"tokelau" + DELIM: "🇹🇰",
    DELIM + r"timor_leste" + DELIM: "🇹🇱",
    DELIM + r"turkmenistan" + DELIM: "🇹🇲",
    DELIM + r"tunisia" + DELIM: "🇹🇳",
    DELIM + r"tonga" + DELIM: "🇹🇴",
    DELIM + r"tr" + DELIM: "🇹🇷",
    DELIM + r"trinidad_tobago" + DELIM: "🇹🇹",
    DELIM + r"tuvalu" + DELIM: "🇹🇻",
    DELIM + r"taiwan" + DELIM: "🇹🇼",
    DELIM + r"tanzania" + DELIM: "🇹🇿",
    DELIM + r"ukraine" + DELIM: "🇺🇦",
    DELIM + r"uganda" + DELIM: "🇺🇬",
    DELIM + r"us_outlying_islands" + DELIM: "🇺🇲",
    DELIM + r"united_nations" + DELIM: "🇺🇳",
    DELIM + r"us" + DELIM: "🇺🇸",
    DELIM + r"uruguay" + DELIM: "🇺🇾",
    DELIM + r"uzbekistan" + DELIM: "🇺🇿",
    DELIM + r"vatican_city" + DELIM: "🇻🇦",
    DELIM + r"st_vincent_grenadines" + DELIM: "🇻🇨",
    DELIM + r"venezuela" + DELIM: "🇻🇪",
    DELIM + r"british_virgin_islands" + DELIM: "🇻🇬",
    DELIM + r"us_virgin_islands" + DELIM: "🇻🇮",
    DELIM + r"vietnam" + DELIM: "🇻🇳",
    DELIM + r"vanuatu" + DELIM: "🇻🇺",
    DELIM + r"wallis_futuna" + DELIM: "🇼🇫",
    DELIM + r"samoa" + DELIM: "🇼🇸",
    DELIM + r"kosovo" + DELIM: "🇽🇰",
    DELIM + r"yemen" + DELIM: "🇾🇪",
    DELIM + r"mayotte" + DELIM: "🇾🇹",
    DELIM + r"south_africa" + DELIM: "🇿🇦",
    DELIM + r"zambia" + DELIM: "🇿🇲",
    DELIM + r"zimbabwe" + DELIM: "🇿🇼",
    #
    # Subdivision Flag
    #
    DELIM + r"england" + DELIM: "🏴󠁧󠁢󠁥󠁮󠁧󠁿",
    DELIM + r"scotland" + DELIM: "🏴󠁧󠁢󠁳󠁣󠁴󠁿",
    DELIM + r"wales" + DELIM: "🏴󠁧󠁢󠁷󠁬󠁳󠁿",
}

# Define our singletons
EMOJI_COMPILED_MAP = None
# List of (compiled_fullmatch_pattern, emoji) for resolving alternation keys
_EMOJI_PATTERN_LIST = None


def apply_emojis(content):
    """Takes the content and swaps any matched emoji's found with their utf-8
    encoded mapping."""

    global EMOJI_COMPILED_MAP, _EMOJI_PATTERN_LIST

    if EMOJI_COMPILED_MAP is None:
        t_start = time.time()
        # Perform our compilation
        EMOJI_COMPILED_MAP = re.compile(
            r"(" + "|".join(EMOJI_MAP.keys()) + r")", re.IGNORECASE
        )

        # - EMOJI_MAP keys are regex patterns (e.g. ":(\+1|thumbsup):")
        # - x.group() from a match cannot be used as a dict key directly.
        #
        # Build a per-entry compiled pattern for fullmatch lookups so
        # alternation/optional-group keys resolve correctly.
        _EMOJI_PATTERN_LIST = [
            (re.compile(r"(?:" + pat + r")", re.IGNORECASE), emoji)
            for pat, emoji in EMOJI_MAP.items()
        ]
        logger.trace(f"Emoji engine loaded in {time.time() - t_start:.4f}s")

    def _lookup(m):
        text = m.group()
        for pat, emoji in _EMOJI_PATTERN_LIST:
            if pat.fullmatch(text):
                return emoji
        return text

    try:
        return EMOJI_COMPILED_MAP.sub(_lookup, content)

    except TypeError:
        # No change; but force string return
        return ""
caronc-apprise-dfec414/apprise/exception.py000066400000000000000000000072331526720371000211370ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
import errno


class AppriseException(Exception):
    """Base class for exceptions raised by Apprise."""

    def __init__(self, message, error_code=0):
        super().__init__(message)
        self.error_code = error_code


class ApprisePluginException(AppriseException):
    """Raised when a notification plugin cannot complete an operation."""

    def __init__(self, message, error_code=600):
        super().__init__(message, error_code=error_code)


class AppriseImproperlyConfigured(
    AppriseException, TypeError, ValueError, AttributeError
):
    """Raised when Apprise receives missing, invalid, or conflicting settings.

    It remains compatible with code that catches the built-in exceptions
    historically raised for these errors: ``TypeError``, ``ValueError``, and
    ``AttributeError``.
    """

    def __init__(self, message, error_code=errno.EINVAL):
        super().__init__(message, error_code=error_code)


class AppriseTemplateError(AppriseImproperlyConfigured):
    """Raised for undeclared, missing, or invalid template values.

    ``variable`` is for local logs only because it may reveal configuration
    details.
    """

    def __init__(self, message, variable=None, error_code=errno.EINVAL):
        super().__init__(message, error_code=error_code)
        self.variable = variable


class AppriseDiskIOError(AppriseException, OSError):
    """Raised when a disk I/O operation fails."""

    def __init__(self, message, error_code=errno.EIO):
        super().__init__(message, error_code=error_code)
        # Expose the standard I/O error code and message for compatibility
        # with code that catches the built-in OSError.
        self.errno = error_code
        self.strerror = message

    def __str__(self):
        """Return the original message while exposing standard I/O details."""
        return str(self.args[0])


class AppriseInvalidData(AppriseException):
    """Raised when Apprise cannot safely use supplied or stored data."""

    def __init__(self, message, error_code=errno.EINVAL):
        super().__init__(message, error_code=error_code)


class AppriseFileNotFound(AppriseDiskIOError, FileNotFoundError):
    """Raised when an attachment or stored file cannot be found."""

    def __init__(self, message):
        super().__init__(message, error_code=errno.ENOENT)
caronc-apprise-dfec414/apprise/i18n/000077500000000000000000000000001526720371000173415ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/__init__.py000066400000000000000000000000001526720371000214400ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/ar/000077500000000000000000000000001526720371000177435ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/ar/LC_MESSAGES/000077500000000000000000000000001526720371000215305ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/ar/LC_MESSAGES/apprise.po000066400000000000000000002133651526720371000235450ustar00rootroot00000000000000# Arabic translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: ar\n"
"Language-Team: ar \n"
"Plural-Forms: nplurals=6; plural=(n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 "
"&& n%100<=10 ? 3 : n%100>=11 ? 4 : 5);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "التحقق من SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "تتبع إعادة التوجيه"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "مهلة القراءة من المقبس"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "مهلة الاتصال بالمقبس"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "عمر التخزين المؤقت"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "نوع MIME المفروض"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "اسم الملف المفروض"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "ملف محلي"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "على الويب"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "الذاكرة"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "المخطط"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "لا توجد متطلبات."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "يلزم تثبيت حزم لكي يعمل."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "يُنصح بتثبيت حزم لتحسين الأداء."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "اسم مستخدم التطبيق"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "مفتاح API"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "الهاتف المستهدف"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "الأهداف"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "المرسل"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "وضع الرسائل القصيرة"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "وضع الدفعات"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "اسم المضيف"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "المنفذ"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "اسم المستخدم"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "كلمة المرور"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "الرمز"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "الوسوم"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "طريقة الاستعلام"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "إصدار واجهة Apprise"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "ترويسة HTTP"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "اسم المستخدم"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "رمز النداء المستهدف"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "تأخير إعادة الإرسال"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "الإعدادات المحلية"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "الجهاز المستهدف"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "الصوت"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "المستوى"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "مستوى الصوت"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "النقر"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "الشارة"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "الفئة"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "المجموعة"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "تضمين الصورة"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "رابط الأيقونة"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "المكالمة"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "مفتاح التشفير"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "وضع التجاوز"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "تنسيق الإشعار"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "تفسير الرموز التعبيرية"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "تخزين دائم"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "المنطقة الزمنية"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "محاولات إعادة الخدمة"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "الانتظار بين المحاولات"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "خدمة اختيارية"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "بريد المرسل"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "الفريق المستهدف"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "سياسة التصعيد"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "طرق التنبيه"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "مهلة انتظار الفريق"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "الرقم التسلسلي"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "المدة (مللي ثانية)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "مدة التلاشي (مللي ثانية)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "رقم مصباح LED"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "البريد الإلكتروني المصدر"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "البريد الإلكتروني المستهدف"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "بريد الرد"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "نسخة"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "نسخة مخفية"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "السر"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "رقم الهاتف المستهدف"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "المجموعة المستهدفة"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "رقم هاتف المرسل"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "مجموعة التوجيه"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "محارف يونيكود"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "سر API"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "معرّف المرسل"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "البلد"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "الصلاحية"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "رمز API"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "رمز الويب هوك"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "اسم البوت"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "القناة المستهدفة"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "البوت المستهدف"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "المنطقة"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "معرّف الشركة"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "بث"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "طريقة الجلب"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "إرفاق الملف باسم"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "إضافات الحمولة"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "معاملات GET"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "رمز الوصول إلى API"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "عنوان المصدر"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "الأولوية"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "مجموعات الإرسال"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "يجب تثبيت libdbus-1.so.x."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "إشعار DBus"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "مدى الإلحاح"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "المحور X"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "المحور Y"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "معرّف الويب هوك"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "تحويل النص إلى كلام"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "صورة الأفاتار"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "رابط الأفاتار"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "معرّف المحادثة"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "إظهار التذييل"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "شعار التذييل"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "استخدام الحقول"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "أعلام Discord"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "الإشارة إلى المستخدمين أو الأدوار"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "مسار القالب"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "تجميع المرفقات"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "رموز القالب"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "الرقم التسلسلي للجهاز"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "وضع API"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "التحديث الآن"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "توقيع النص"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "أيقونة بترميز Base64 (واجهة النص)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "صورة بترميز Base64 (واجهة الصور)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "الرابط"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "الإطار"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "نوع التنقيط"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "نواة التنقيط"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "مفتاح المهمة"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "نافذة منبثقة"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "المسار"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "مهلة الخادم"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "اسم النسخة"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "معرّف SID للحساب"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "رقم هاتف المرسل أو معرّف المرسل"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "اسم المنطقة"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "مفتاح الوصول"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "إلى معرّف المستخدم"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "إلى معرّف القناة"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "مسار الويب هوك"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "الوضع"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "اسم المحادثة"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "اسم مستخدم API"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "كلمة مرور API"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "رمز الوصول"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "المالك"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "المستودع"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "النوع"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "الرقم"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "التسميات"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "المكلَّفون"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "يجب تثبيت libdbus-1.so.x أو libdbus-2.so.x."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "إشعار GLib"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "يلزم وجود بيئة Gnome محلية."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "إشعار Gnome"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "مفاتيح التكامل"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "الإجراء"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "مفتاح إزالة التكرار"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "البيانات الوصفية"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "مساحة العمل"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "مفتاح الويب هوك"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "مفتاح المحادثة"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "المنصة"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "الموضوع"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "مدخلات البيانات"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "معرّف البوت"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "الإصدار"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "مثبّت"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "رمز وصول طويل الأمد"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "معرّف الإشعار"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "بادئة المسار"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "الرمز أو اسم المستخدم"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "الأحداث"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "إضافة رموز"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "إزالة رموز"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "مفتاح التكامل"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "المسار"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "معرّف مصدر التنبيه"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "مستوى التصعيد المستهدف"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "الجدول المستهدف"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "المستخدم المستهدف"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "الأهداف "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "الكيان"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "الاسم البديل"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "التفاصيل"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "تعيين الإجراءات"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "معرّف الجهاز"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "اسم الجهاز"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "رقم الهاتف المصدر"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "المدة"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "مفتاح الخادم"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "مفتاح API للجهاز"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "معرّف التطبيق"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "إصدار التطبيق"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "رمز وصول التطبيق"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "أيقونة مخصصة"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "نوع الأيقونة"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "الدورات"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "رمز البوت"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "رابط النقر"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "اللون"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"يعمل فقط مع Mac OS X 10.8 والإصدارات الأحدث. كما يتطلب إمكانية الوصول محلياً "
"إلى /usr/local/bin/terminal-notifier."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "إشعار MacOSX"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "رابط الفتح أو النقر"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "إصدار Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "المرسل"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "الرد إلى"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "النطاق"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "اسم المرسل"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "ترويسة البريد"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "الظهور"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "نص مخفي"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "رمز اللغة"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "تخزين النتائج مؤقتاً"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "مرفقات حساسة"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "الإشارة إلى المستخدمين أو الوسوم"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "المستخدم"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "معرّف القناة المستهدفة"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "أقصى عدد لأجزاء الرسالة"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "مرجع مخصص"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "الطابور المستهدف"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "معرّف العميل"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "استخدام جلسة"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "الاحتفاظ بالرسائل"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "معرّف القالب"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "مفتاح المصادقة"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "رابط قصير"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "تعيين القالب"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "بادئة الرابط"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "معرّف الغرفة"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "إشعار صامت"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "معرّف حدث Discord"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "المصدر"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "معرّف المشروع"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "خطاف الرسائل"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "ألوان IRC"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "البادئة"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "اسم الحملة"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "اسم القالب"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "مرجع العميل"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "جودة عالية"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "ترويسة الفاكس"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "المرفق"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "اسم ملف المرفق"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "التأخير"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "البريد الإلكتروني"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "الإجراءات"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "نوع المصادقة"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "اسم دخول API"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "قبول الردود"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "الغرض"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "نطاق المستأجر"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "بريد الحساب أو معرّف الكائن"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "سر العميل"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "الحفظ في العناصر المرسلة"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "القالب"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "معرّف المشغّل المستهدف"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "تضمين الشريحة"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "العنوان الفرعي"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "اللغة"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "تمكين المحتوى"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "فك ترميز معاملات القالب"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "بيانات مخصصة"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "بيانات الاستجابة"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "معرّف المستخدم المستهدف"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "معرّف المجموعة المستهدفة"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "المكوّن"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "الفئة البرمجية"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "درجة الخطورة"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "تفاصيل مخصصة"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "معرّف التكامل"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "معرّف طرف ثالث"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "إضافات Meta"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "المفتاح الرئيسي"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "الجهاز"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "فضاء الأسماء"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "الشارات"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "نوع الرسالة"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "المعرّف المستهدف"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "الرسالة القصيرة المستهدفة"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "القنوات"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "معرّف المصادقة"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "رمز المصادقة"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "مفتاح المزوّد"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "مفتاح الإشعارات"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "مفتاح التطبيق"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "سر التطبيق"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "المفتاح السري"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "إظهار الحالة"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "مفتاح المستخدم"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "عنوان الرابط"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "الفاصل الزمني لإعادة المحاولة الطارئة"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "انتهاء الصلاحية"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "رمز المستخدم"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "مواضيع المجموعة"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "القناة"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "اسم الويب هوك"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "المفتاح الخاص"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "الاهتزاز"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "مستوى المعلومات"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "مستوى النجاح"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "مستوى التحذير"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "مستوى الفشل"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "مفتاح API السري"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "الموضوع المستهدف"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "معرّف التطبيق"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "منتدى Reddit الفرعي المستهدف"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "النوعية"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "معرّف الوسم"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "نص الوسم"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "هل هذا إعلان؟"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "إرسال الردود"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "يحتوي على حرق للأحداث"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "علامة إعادة الإرسال"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "عنوان المرسل"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "معرّف القناة"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "رابط مضمّن"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "الرمز أو كلمة المرور"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "البيئة"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "وضع المصادقة"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "ويب هوك"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "معرّف الغرفة المستهدفة"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "وضع الويب هوك"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "استخدام الأفاتار"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "المرفق النظامي"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "تسجيل معرّف العملية"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "المؤسسة"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "بيانات القالب"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "اسم المرسل"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "رمز الجلسة"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "معرّف مفتاح الوصول"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "مفتاح الوصول السري"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "عناوين البريد المستهدفة"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "الوميض"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "التسمية"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "معرّف الخدمة"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "كلمة مرور الخدمة"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "معرّف المساحة"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "رقم هاتف المستلم"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "نوع الوسائط"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "المهلة"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "صوت النطق"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "مفتاح العميل"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "إشعار حرج"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "الخدمة"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "الموقع"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "سيناريو التنبيه"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "التصفية"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "معرّف خارجي"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "الحالة"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "العضو المستهدف"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "مشترك"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "وسم"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "الرمز القصير المستهدف"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "رمز وصول OAuth"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "الرمز A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "الرمز B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "الرمز C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "المعرّف المشفّر المستهدف"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "مسار سير العمل"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "تضمين التذييل"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "استخدام الكتل"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "تضمين الطابع الزمني"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "وضع الرسالة"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "المضيف"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "اسم الدخول"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "النقل الحرفي"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "جهة الاتصال المستهدفة"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "للاختبار فقط"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "البوابة"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "المفتاح العام"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "القيمة الابتدائية"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "الغرف"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "مفتاح التوجيه المستهدف"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "معرّف الكيان"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "نوع التنبيه"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "رابط الصورة"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "رابط الصوت"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "لون نص خاص"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "المبلغ"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "العملة"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "الاسم"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "المعرّف"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "الرفع"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "التسجيل في STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "معرّف الدردشة المستهدفة"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "الكشف عن مالك البوت"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "معاينة صفحة الويب"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "تجميع مرفقات الصور/الفيديو"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "معرّف محادثة الموضوع"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "إصدار Markdown"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "موضع المحتوى"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "مسار قالب الرسالة المنسقة"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "معرّف ملف المراسلة"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "معرّف البوابة"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "معرّف Threema المستهدف"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "اسم مضيف API"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "رابط الصورة"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "نوع الحدث"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "الأولوية (توافق Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "طريقة الإشعار: رسالة قصيرة أو مكالمة"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "مفتاح المستهلك"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "سر المستهلك"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "سر الوصول"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "رمز المصادقة"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "معرّفات المستلمين"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "رابط أفاتار البوت"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "بريد المستخدم"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "رمز وصول البوت"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "معرّفات الغرف"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "معرّف الشركة"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "سر التطبيق"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "معرّف الوكيل"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "القسم المستهدف"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "الوسم المستهدف"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "مفتاح ويب هوك البوت"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "معرّف هاتف المرسل"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "يلزم وجود بيئة Microsoft Windows محلية."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "معرّف سير العمل"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "التوقيع"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "استخدام رابط Power Automate"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "معرّف توجيه Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "التفاف النص"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "إصدار API"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "المواضيع"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "رمز المجموعة أو الخيار"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "رمز التطبيق"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "الرمز أو المفتاح"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "أولوية المعلومات"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "أولوية النجاح"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "أولوية التحذير"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "أولوية الفشل"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "تسمية الرابط"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "رمز التحقق"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "التدفق المستهدف"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr "ثبّت pika لـ AMQP 0.9.1، أو python-qpid-proton لـ AMQP 1.0، أو كليهما."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "المُبادِل"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "المضيف الافتراضي"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "دائم"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "إلزامي"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "مدة الصلاحية (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "ترويسات الرسالة"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "خادم SMTP"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "الوضع الآمن"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "وضع أمان PGP"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "مسار مفتاح PGP العام"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "مسار مفتاح PGP الخاص"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "دليل مفاتيح الويب"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "مرفقات مضمّنة"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "بريد المستلم"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "ملف مفتاح OAuth2"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "رابط صورة مخصص"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "لون الإشعار"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "الاسم الحقيقي"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "الاسم المستعار"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "الانضمام إلى القنوات"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "وضع المصادقة"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "الاسم البديل للغرفة المستهدفة"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "استكشاف الخادم"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "فرض الخادم الأصلي على معرّفات الغرف"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "إصدار واجهة Matrix"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "التشفير من الطرف إلى الطرف"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "التحقق التلقائي من الجهاز"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "ملف مفتاح خاص بتنسيق PEM"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "ملف الاشتراك"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "خادم XMPP"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "جلب قائمة جهات الاتصال"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "استخدام الموضوع"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "الحفاظ على الاتصال"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "الاسم المستعار في MUC"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "ربط قناة SCRAM-PLUS"
caronc-apprise-dfec414/apprise/i18n/de/000077500000000000000000000000001526720371000177315ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/de/LC_MESSAGES/000077500000000000000000000000001526720371000215165ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/de/LC_MESSAGES/apprise.po000066400000000000000000002026331526720371000235270ustar00rootroot00000000000000# German translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: de\n"
"Language-Team: de \n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "SSL überprüfen"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Weiterleitungen folgen"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Socket-Lesezeitlimit"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Socket-Verbindungszeitlimit"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Cache-Alter"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Erzwungener MIME-Typ"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Erzwungener Dateiname"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Lokale Datei"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Webbasiert"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Speicher"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Schema"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Keine Abhängigkeiten."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "Pakete sind zum Betrieb erforderlich."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "Pakete werden empfohlen, um die Funktionalität zu verbessern."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "App-Benutzername"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "API-Schlüssel"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Ziel-Telefon"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Ziele"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Absender"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "SMS-Modus"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Stapelmodus"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Hostname"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Port"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Benutzername"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Passwort"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Token"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Schlagwörter"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Abfragemethode"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Apprise-API-Version"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "HTTP-Kopfzeile"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Benutzername"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Ziel-Rufzeichen"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Verzögerung beim erneuten Senden"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Gebietsschema"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Zielgerät"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Ton"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Stufe"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Lautstärke"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Klick"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Abzeichen"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Kategorie"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Gruppe"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Bild einschließen"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "Symbol-URL"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Anruf"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Verschlüsselungsschlüssel"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Überlaufmodus"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Benachrichtigungsformat"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Emojis interpretieren"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Dauerhafter Speicher"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Zeitzone"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Dienst-Wiederholungen"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Wartezeit zwischen Versuchen"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Optionaler Dienst"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "Absender-E-Mail"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Zielteam"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Eskalationsrichtlinie"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Alarmierungsarten"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Team-Wartezeit"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Seriennummer"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Dauer (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Überblendzeit (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "LED-Nummer"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Quell-E-Mail"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Ziel-E-Mail"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "Antwort-E-Mail"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Kopie"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Blindkopie"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Geheimnis"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Ziel-Telefonnummer"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Zielgruppe"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Absender-Telefonnummer"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Routing-Gruppe"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Unicode-Zeichen"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "API-Geheimnis"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "Absenderkennung"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "Land"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "Gültigkeit"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "API-Token"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Webhook-Token"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Bot-Name"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Zielkanal"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Ziel-Bot"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Region"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "Firmen-ID"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "An alle senden"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Abrufmethode"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Datei anhängen als"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Zusätzliche Nutzdaten"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "GET-Parameter"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "API-Zugriffstoken"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Ursprungsadresse"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Priorität"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Sendergruppen"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "libdbus-1.so.x muss installiert sein."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "DBus-Benachrichtigung"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Dringlichkeit"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "X-Achse"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Y-Achse"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "Webhook-Kennung"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Sprachausgabe"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Avatar-Bild"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "Avatar-URL"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "Thread-Kennung"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Fußzeile anzeigen"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Logo der Fußzeile"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Felder verwenden"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Discord-Flags"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Benutzer oder Rollen erwähnen"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Vorlagenpfad"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Anhänge zusammenfassen"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Vorlagen-Token"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Geräteseriennummer"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "API-Modus"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Jetzt aktualisieren"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Textsignatur"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Symbol als Base64 (Text-API)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Bild als Base64 (Bild-API)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Link"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Rahmen"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Dithering-Typ"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Dithering-Kern"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Aufgabenschlüssel"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Modal"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Pfad"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Server-Zeitlimit"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Instanzname"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "Konto-SID"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Absender-Telefonnummer oder Absenderkennung"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Regionsname"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Zugriffsschlüssel"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "An Benutzerkennung"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "An Kanalkennung"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Webhook-Pfad"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Modus"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Thread-Name"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "API-Benutzername"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "API-Passwort"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Zugriffstoken"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Eigentümer"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Repository"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Typ"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Nummer"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Bezeichnungen"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Zuständige"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "libdbus-1.so.x oder libdbus-2.so.x muss installiert sein."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "GLib-Benachrichtigung"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "Eine lokale Gnome-Umgebung ist erforderlich."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Gnome-Benachrichtigung"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Integrationsschlüssel"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Aktion"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Deduplizierungsschlüssel"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Metadaten"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Arbeitsbereich"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Webhook-Schlüssel"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Thread-Schlüssel"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Plattform"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Thema"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Dateneinträge"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "Bot-Kennung"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Version"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Angeheftet"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Langlebiges Zugriffstoken"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "Benachrichtigungskennung"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Pfadpräfix"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Token oder Benutzername"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Ereignisse"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Token hinzufügen"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Token entfernen"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Integrationsschlüssel"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Route"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "Alarmquellen-ID"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Ziel-Eskalation"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Ziel-Zeitplan"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Zielbenutzer"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Ziele "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Entität"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Alias"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Details"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Aktionszuordnung"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "Gerätekennung"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Gerätename"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Quell-Telefonnummer"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Dauer"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Serverschlüssel"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Geräte-API-Schlüssel"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "App-Kennung"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "App-Version"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "App-Zugriffstoken"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Eigenes Symbol"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Symboltyp"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Zyklen"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Bot-Token"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "Klick-URL"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Farbe"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Funktioniert nur mit Mac OS X 10.8 und neuer. Zusätzlich muss /usr/local/bin/"
"terminal-notifier lokal verfügbar sein."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "MacOSX-Benachrichtigung"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "URL zum Öffnen oder Klicken"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Terminal-Notifier-Version"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Absender"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Antwort an"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Domäne"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Absendername"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "E-Mail-Kopfzeile"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Sichtbarkeit"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Spoiler-Text"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Sprachcode"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Ergebnisse zwischenspeichern"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Vertrauliche Anhänge"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Benutzer oder Schlagwörter erwähnen"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "Benutzer"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "Kennung des Zielkanals"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Maximale Anzahl Nachrichtenteile"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Eigene Referenz"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Ziel-Warteschlange"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "Client-Kennung"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Sitzung verwenden"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Nachrichten aufbewahren"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "Vorlagenkennung"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Authentifizierungsschlüssel"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "Kurz-URL"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Vorlagenzuordnung"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "URL-Präfix"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "Raumkennung"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Stille Benachrichtigung"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Discord-Ereigniskennung"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Quelle"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "Projektkennung"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Nachrichten-Hook"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "IRC-Farben"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Präfix"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Kampagnenname"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Vorlagenname"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Client-Referenz"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Hohe Qualität"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Fax-Kopfzeile"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Anhang"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Dateiname des Anhangs"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Verzögerung"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "E-Mail"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Aktionen"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Authentifizierungstyp"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "API-Anmeldename"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Antworten annehmen"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Zweck"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Mandantendomäne"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "Konto-E-Mail oder Objektkennung"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Client-Geheimnis"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "In gesendeten Elementen speichern"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Vorlage"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "Ziel-Spielerkennung"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Segment einschließen"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Untertitel"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Sprache"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Inhalte aktivieren"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Vorlagenargumente dekodieren"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Eigene Daten"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Rückmeldedaten"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "Kennung des Zielbenutzers"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "Kennung der Zielgruppe"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Komponente"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Klasse"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Schweregrad"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Eigene Details"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "Integrationskennung"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "Kennung von Drittanbietern"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Meta-Extras"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Hauptschlüssel"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Gerät"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Namensraum"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Abzeichen"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Nachrichtentyp"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "Zielkennung"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "Ziel-SMS"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Kanäle"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "Authentifizierungskennung"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Authentifizierungstoken"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Anbieterschlüssel"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Push-Schlüssel"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Anwendungsschlüssel"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Anwendungsgeheimnis"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Geheimer Schlüssel"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Status anzeigen"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Benutzerschlüssel"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "URL-Titel"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Notfall-Wiederholungsintervall"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Ablauf"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Benutzertoken"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Gruppenthemen"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Kanal"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Webhook-Name"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Privater Schlüssel"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Vibration"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Info-Stufe"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Erfolgsstufe"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Warnstufe"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Fehlerstufe"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Geheimer API-Schlüssel"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Zielthema"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "Anwendungskennung"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Ziel-Subreddit"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Art"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "Flair-Kennung"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Flair-Text"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "Ist Werbung?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Antworten senden"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "Ist ein Spoiler"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Kennzeichen für erneutes Senden"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Absenderadresse"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "Kanalkennung"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "Eingebettete URL"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Token oder Passwort"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Umgebung"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Authentifizierungsmodus"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "Kennung des Zielraums"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Webhook-Modus"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Avatar verwenden"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Einrichtung"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "PID protokollieren"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Organisation"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Vorlagendaten"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Absendername"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Sitzungstoken"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "Kennung des Zugriffsschlüssels"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Geheimer Zugriffsschlüssel"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Ziel-E-Mails"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Blitz"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Bezeichnung"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "Dienstkennung"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Dienstpasswort"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "Bereichskennung"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Telefonnummer des Empfängers"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Medientyp"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Zeitlimit"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Sprachausgabestimme"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Client-Schlüssel"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Kritische Benachrichtigung"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Dienst"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Standort"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Alarmszenario"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Filterung"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "Externe Kennung"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Status"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Zielmitglied"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Geteilt"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Tag"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Ziel-Kurzwahl"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "OAuth-Zugriffstoken"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Token A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Token B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Token C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "Codierte Zielkennung"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Arbeitsablaufpfad"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Fußzeile einschließen"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Blöcke verwenden"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Zeitstempel einschließen"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Nachrichtenmodus"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Host"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Anmeldename"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Transliterieren"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Zielkontakt"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Nur Test"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Gateway"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Öffentlicher Schlüssel"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Startwert"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Räume"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Ziel-Routingschlüssel"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "Entitätskennung"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Alarmtyp"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Bildlink"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Tonlink"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Besondere Textfarbe"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Betrag"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Währung"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Name"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Kennung"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Hochladen"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Auf STDERR protokollieren"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "Kennung des Ziel-Chats"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Bot-Eigentümer erkennen"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Vorschau der Webseite"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Foto-/Video-Anhänge gruppieren"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "Thread-Kennung des Themas"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Markdown-Version"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Platzierung des Inhalts"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Pfad der Vorlage für formatierte Nachrichten"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "Kennung des Nachrichtenprofils"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "Gateway-Kennung"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "Ziel-Threema-Kennung"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "API-Hostname"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "Bild-URL"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Ereignistyp"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Priorität (Pushover-Kompatibilität)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Benachrichtigungsmethode: SMS oder Anruf"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Consumer-Schlüssel"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Consumer-Geheimnis"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Zugriffsgeheimnis"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Authentifizierungstoken"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "Empfängerkennungen"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "Avatar-URL des Bots"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "Benutzer-E-Mail"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Bot-Zugriffstoken"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "Raumkennungen"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "Unternehmenskennung"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "App-Geheimnis"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "Agentenkennung"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Zielabteilung"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Ziel-Schlagwort"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Webhook-Schlüssel des Bots"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "Kennung des Absender-Telefons"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "Eine lokale Microsoft-Windows-Umgebung ist erforderlich."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "Arbeitsablaufkennung"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Signatur"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Power-Automate-URL verwenden"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Power-Automate-Routingkennung"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Text umbrechen"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "API-Version"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Themen"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Gruppen- oder Optionscode"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "App-Token"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Token oder Schlüssel"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Priorität für Informationen"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Priorität für Erfolge"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Priorität für Warnungen"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Priorität für Fehler"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Beschriftung des Links"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Bestätigungstoken"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Ziel-Stream"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"Installieren Sie pika für AMQP 0.9.1, python-qpid-proton für AMQP 1.0 oder "
"beides."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Exchange"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Virtueller Host"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Persistent"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Verpflichtend"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Lebensdauer (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Nachrichten-Header"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "SMTP-Server"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Sicherer Modus"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "PGP-Sicherheitsmodus"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "Pfad des öffentlichen PGP-Schlüssels"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "Pfad des privaten PGP-Schlüssels"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Web-Schlüsselverzeichnis"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Eingebettete Anhänge"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "Empfänger-E-Mail"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "OAuth2-Schlüsseldatei"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "Eigene Bild-URL"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Farbe der Benachrichtigung"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Echter Name"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Spitzname"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Kanäle betreten"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Authentifizierungsmodus"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Alias des Zielraums"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Servererkennung"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Heimserver bei Raumkennungen erzwingen"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Matrix-API-Version"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "Ende-zu-Ende-Verschlüsselung"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Automatische Geräteprüfung"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "PEM-Datei mit privatem Schlüssel"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "Abonnementdatei"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "XMPP-Server"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Kontaktliste abrufen"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Betreff verwenden"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Verbindung aufrechterhalten"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "MUC-Spitzname"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "SCRAM-PLUS-Kanalbindung"
caronc-apprise-dfec414/apprise/i18n/en/000077500000000000000000000000001526720371000177435ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/en/LC_MESSAGES/000077500000000000000000000000001526720371000215305ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/en/LC_MESSAGES/apprise.po000066400000000000000000001776501526720371000235530ustar00rootroot00000000000000# English translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: en\n"
"Language-Team: en \n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "Verify SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Follow Redirects"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Socket Read Timeout"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Socket Connect Timeout"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Cache Age"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Forced Mime Type"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Forced File Name"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Local File"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Web Based"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Memory"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Schema"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "No dependencies."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "Packages are required to function."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "Packages are recommended to improve functionality."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "App User Name"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "API Key"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Target Phone"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Targets"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "From"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "SMS Mode"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Batch Mode"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Hostname"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Port"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Username"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Password"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Token"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Tags"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Query Method"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Apprise API Version"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "HTTP Header"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "User Name"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Target Callsign"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Resend Delay"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Locale"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Target Device"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Sound"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Level"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Volume"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Click"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Badge"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Category"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Group"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Include Image"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "Icon URL"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Call"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Encryption Key"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Overflow Mode"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Notify Format"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Interpret Emojis"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Persistent Storage"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Timezone"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Service Retry"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Inter-Retry Wait"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Optional Service"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "From Email"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Target Team"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Escalation Policy"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Alert Methods"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Team Wait"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Serial Number"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Duration (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Fade Time (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "LED Number"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Source Email"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Target Email"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "Reply To Email"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Carbon Copy"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Blind Carbon Copy"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Secret"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Target Phone No"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Target Group"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "From Phone No"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Route Group"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Unicode Characters"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "API Secret"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "Sender ID"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "Country"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "validity"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "API Token"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Webhook Token"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Bot Name"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Target Channel"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Target Bot"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Region"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "Company ID"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "Broadcast"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Fetch Method"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Attach File As"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Payload Extras"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "GET Params"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "API Access Token"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Originating Address"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Priority"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Transmitter Groups"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "libdbus-1.so.x must be installed."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "DBus Notification"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Urgency"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "X-Axis"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Y-Axis"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "Webhook ID"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Text To Speech"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Avatar Image"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "Avatar URL"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "Thread ID"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Display Footer"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Footer Logo"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Use Fields"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Discord Flags"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Ping Users/Roles"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Template Path"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Batch Attachments"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Template Tokens"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Device Serial Number"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "API Mode"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Refresh Now"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Text Signature"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Icon Base64 (Text API)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Image Base64 (Image API)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Link"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Border"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Dither Type"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Dither Kernel"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Task Key"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Modal"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Path"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Server Timeout"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Instance Name"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "Account SID"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "From Phone No / Sender ID"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Region Name"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Access Key"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "To User ID"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "To Channel ID"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Webhook Path"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Mode"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Thread Name"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "API Username"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "API Password"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Access Token"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Owner"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Repository"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Type"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Number"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Labels"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Assignees"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "libdbus-1.so.x or libdbus-2.so.x must be installed."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "GLib Notification"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "A local Gnome environment is required."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Gnome Notification"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Integration Keys"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Action"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Deduplication Key"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Metadata"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Workspace"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Webhook Key"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Thread Key"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Platform"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Topic"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Data Entries"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "Bot ID"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Version"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Sticky"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Long-Lived Access Token"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "Notification ID"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Path Prefix"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Token or Username"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Events"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Add Tokens"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Remove Tokens"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Integration Key"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Route"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "Alert Source ID"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Target Escalation"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Target Schedule"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Target User"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Targets "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Entity"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Alias"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Details"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Action Mapping"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "Device ID"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Device Name"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Source Phone No"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Duration"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Server Key"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Device API Key"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "App ID"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "App Version"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "App Access Token"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Custom Icon"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Icon Type"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Cycles"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Bot Token"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "Click URL"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Color"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "MacOSX Notification"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "Open/Click URL"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Terminal-Notifier Version"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Sender"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Reply To"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Domain"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "From Name"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "Email Header"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Visibility"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Spoiler Text"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Language Code"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Cache Results"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Sensitive Attachments"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Ping Users/Tags"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "User"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "Target Channel ID"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Max Message Parts"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Custom Reference"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Target Queue"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "Client ID"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Use Session"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Retain Messages"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "Template ID"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Authentication Key"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "Short URL"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Template Mapping"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "URL Prefix"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "Room ID"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Silent Notification"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Discord Event ID"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Source"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "Project ID"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Message Hook"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "IRC Colors"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Prefix"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Campaign Name"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Template Name"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Client Reference"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "High Quality"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Fax Header"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Attach"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Attach Filename"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Delay"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "Email"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Actions"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Authentication Type"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "API Login"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Accept Replies"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Purpose"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Tenant Domain"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "Account Email or Object ID"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Client Secret"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Save to Sent Items"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Template"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "Target Player ID"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Include Segment"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Subtitle"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Language"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Enable Contents"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Decode Template Args"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Custom Data"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Postback Data"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "Target User ID"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "Target Group ID"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Component"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Class"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Severity"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Custom Details"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "Integration ID"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "Third Party ID"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Meta Extras"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Master Key"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Device"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Namespace"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Badges"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Message Type"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "Target ID"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "Target SMS"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Channels"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "Auth ID"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Auth Token"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Provider Key"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Pushkey"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Application Key"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Application Secret"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Secret Key"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Show Status"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "User Key"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "URL Title"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Emergency Retry Interval"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Expire"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "User Token"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Group Topics"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Channel"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Webhook Name"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Private Key"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Vibration"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Info Level"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Success Level"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Warning Level"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Failure Level"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Secret API Key"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Target Topic"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "Application ID"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Target Subreddit"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Kind"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "Flair ID"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Flair Text"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "Is Ad?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Send Replies"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "Is Spoiler"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Resubmit Flag"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "From Address"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "Channel ID"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "Embed URL"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Token / Password"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Environment"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Authentication Mode"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "Target Room ID"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Webhook Mode"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Use Avatar"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Facility"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "Log PID"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Organization"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Template Data"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Sender Name"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Session Token"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "Access Key ID"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Secret Access Key"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Target Emails"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Flash"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Label"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "Service ID"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Service Password"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "Space ID"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Recipient Phone Number"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Media Type"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Timeout"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "TTS Voice"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Client Key"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Critical Notification"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Service"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Location"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Alerting Scenario"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Filtering"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "External ID"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Status"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Target Member"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Shared"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Tag"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Target Short Code"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "OAuth Access Token"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Token A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Token B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Token C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "Target Encoded ID"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Workflow Path"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Include Footer"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Use Blocks"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Include Timestamp"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Message Mode"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Host"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Login"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Transliterate"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Target Contact"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Test Only"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Gateway"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Public Key"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Seed"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Rooms"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Target Routing Key"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "Entity ID"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Alert Type"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Image Link"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Sound Link"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Special Text Color"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Amount"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Currency"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Name"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Identifier"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Upload"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Log to STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "Target Chat ID"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Detect Bot Owner"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Web Page Preview"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Group Photo/Video Attachments"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "Topic Thread ID"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Markdown Version"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Content Placement"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Rich Message Template Path"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "Messaging Profile ID"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "Gateway ID"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "Target Threema ID"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "API Hostname"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "Image URL"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Event type"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Priority (Pushover compatibility)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Notification Method: sms or call"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Consumer Key"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Consumer Secret"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Access Secret"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Authentication Token"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "Receiver IDs"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "Bot Avatar URL"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "User Email"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Bot Access Token"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "Room IDs"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "Corp ID"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "App Secret"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "Agent ID"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Target Department"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Target Tag"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Bot Webhook Key"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "From Phone ID"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "A local Microsoft Windows environment is required."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "Workflow ID"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Signature"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Use Power Automate URL"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Power Automate Routing ID"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Wrap Text"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "API Version"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Topics"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Group / Option Code"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "App Token"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Token or Key"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Info Priority"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Success Priority"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Warning Priority"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Failure Priority"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Link Label"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Verification Token"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Target Stream"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Exchange"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Virtual Host"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Persistent"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Mandatory"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Time To Live"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Message Headers"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "SMTP Server"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Secure Mode"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "PGP Security Mode"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "PGP Public Key Path"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "PGP Private Key Path"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Web Key Directory"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Inline Attachments"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "To Email"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "OAuth2 KeyFile"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "Custom Image URL"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Notification Color"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Real Name"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Nickname"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Join Channels"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Auth Mode"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Target Room Alias"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Server Discovery"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Force Home Server on Room IDs"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Matrix API Version"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "End-to-End Encryption"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Automatic Device Verification"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "PEM Private KeyFile"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "Subscripion File"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "XMPP Server"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Get Roster"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Use Subject"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Keep Connection Alive"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "MUC Nickname"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "SCRAM-PLUS Channel Binding"
caronc-apprise-dfec414/apprise/i18n/es/000077500000000000000000000000001526720371000177505ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/es/LC_MESSAGES/000077500000000000000000000000001526720371000215355ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/es/LC_MESSAGES/apprise.po000066400000000000000000002060371526720371000235500ustar00rootroot00000000000000# Spanish translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: es\n"
"Language-Team: es \n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "Verificar el SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Seguir redirecciones"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Tiempo de espera de lectura del socket"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Tiempo de espera de conexión del socket"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Antigüedad de la caché"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Tipo MIME forzado"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Nombre de archivo forzado"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Archivo local"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Basado en la web"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Memoria"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Esquema"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Sin dependencias."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "Se requieren paquetes para funcionar."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "Se recomiendan paquetes para mejorar la funcionalidad."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "Nombre de usuario de la aplicación"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "Clave de la API"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Teléfono de destino"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Destinos"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Remitente"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "Modo SMS"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Modo por lotes"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Nombre del host"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Puerto"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Nombre de usuario"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Contraseña"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Token"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Etiquetas"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Método de consulta"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Versión de la API de Apprise"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "Cabecera HTTP"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Nombre de usuario"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Indicativo de destino"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Retraso de reenvío"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Configuración regional"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Dispositivo de destino"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Sonido"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Nivel"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Volumen"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Clic"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Insignia"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Categoría"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Grupo"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Incluir la imagen"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "URL del icono"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Llamada"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Clave de cifrado"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Modo de desbordamiento"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Formato de notificación"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Interpretar emojis"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Almacenamiento persistente"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Zona horaria"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Reintentos del servicio"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Espera entre reintentos"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Servicio opcional"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "Correo del remitente"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Equipo de destino"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Política de escalado"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Métodos de alerta"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Espera del equipo"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Número de serie"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Duración (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Tiempo de transición (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "Número de LED"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Correo de origen"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Correo de destino"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "Correo de respuesta"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Copia de carbón"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Copia de carbón oculta"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Secreto"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Número de teléfono de destino"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Grupo de destino"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Número de teléfono del remitente"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Grupo de enrutamiento"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Caracteres Unicode"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "Secreto de la API"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "Identificador del remitente"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "País"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "validez"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "Token de la API"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Token del webhook"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Nombre del bot"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Canal de destino"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Bot de destino"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Región"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "ID de la empresa"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "Difusión"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Método de obtención"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Adjuntar el archivo como"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Extras de la carga útil"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "Parámetros GET"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "Token de acceso a la API"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Dirección de origen"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Prioridad"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Grupos de transmisores"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "libdbus-1.so.x debe estar instalado."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "Notificación de DBus"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Urgencia"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "Eje X"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Eje Y"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "Identificador del webhook"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Síntesis de voz"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Imagen del avatar"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "URL del avatar"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "Identificador del hilo"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Mostrar el pie de página"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Logotipo del pie de página"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Usar campos"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Indicadores de Discord"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Mencionar usuarios o roles"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Ruta de la plantilla"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Agrupar los archivos adjuntos"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Tokens de la plantilla"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Número de serie del dispositivo"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "Modo de la API"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Actualizar ahora"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Firma del texto"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Icono en Base64 (API de texto)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Imagen en Base64 (API de imagen)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Enlace"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Borde"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Tipo de tramado"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Núcleo de tramado"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Clave de la tarea"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Modal"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Ruta"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Tiempo de espera del servidor"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Nombre de la instancia"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "SID de la cuenta"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Número de teléfono del remitente o identificador del remitente"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Nombre de la región"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Clave de acceso"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "Al identificador del usuario"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "Al identificador del canal"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Ruta del webhook"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Modo"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Nombre del hilo"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "Nombre de usuario de la API"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "Contraseña de la API"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Token de acceso"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Propietario"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Repositorio"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Tipo"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Número"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Etiquetas"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Asignados"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "libdbus-1.so.x o libdbus-2.so.x debe estar instalado."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "Notificación de GLib"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "Se requiere un entorno Gnome local."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Notificación de Gnome"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Claves de integración"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Acción"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Clave de deduplicación"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Metadatos"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Espacio de trabajo"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Clave del webhook"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Clave del hilo"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Plataforma"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Tema"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Entradas de datos"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "Identificador del bot"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Versión"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Fijado"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Token de acceso de larga duración"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "Identificador de la notificación"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Prefijo de la ruta"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Token o nombre de usuario"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Eventos"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Añadir tokens"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Quitar tokens"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Clave de integración"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Ruta"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "ID de la fuente de alertas"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Escalada de destino"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Horario de destino"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Usuario de destino"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Destinos "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Entidad"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Alias"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Detalles"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Asignación de acciones"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "Identificador del dispositivo"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Nombre del dispositivo"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Número de teléfono de origen"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Duración"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Clave del servidor"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Clave de la API del dispositivo"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "Identificador de la aplicación"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "Versión de la aplicación"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "Token de acceso de la aplicación"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Icono personalizado"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Tipo de icono"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Ciclos"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Token del bot"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "URL del clic"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Color"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Solo funciona con Mac OS X 10.8 y versiones posteriores. Además, requiere "
"que /usr/local/bin/terminal-notifier sea accesible localmente."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "Notificación de MacOSX"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "URL de apertura o de clic"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Versión de Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Remitente"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Responder a"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Dominio"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Nombre del remitente"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "Encabezado del correo"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Visibilidad"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Texto oculto"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Código de idioma"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Almacenar los resultados en caché"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Archivos adjuntos sensibles"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Mencionar usuarios o etiquetas"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "Usuario"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "Identificador del canal de destino"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Número máximo de partes del mensaje"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Referencia personalizada"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Cola de destino"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "Identificador del cliente"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Usar una sesión"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Conservar los mensajes"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "Identificador de la plantilla"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Clave de autenticación"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "URL corta"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Asignación de la plantilla"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "Prefijo de la URL"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "Identificador de la sala"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Notificación silenciosa"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Identificador del evento de Discord"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Origen"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "Identificador del proyecto"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Enlace de mensajes"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "Colores de IRC"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Prefijo"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Nombre de la campaña"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Nombre de la plantilla"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Referencia del cliente"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Alta calidad"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Encabezado del fax"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Adjuntar"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Nombre del archivo adjunto"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Retraso"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "Correo electrónico"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Acciones"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Tipo de autenticación"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "Usuario de la API"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Aceptar respuestas"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Propósito"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Dominio del inquilino"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "Correo de la cuenta o identificador del objeto"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Secreto del cliente"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Guardar en elementos enviados"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Plantilla"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "Identificador del jugador de destino"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Incluir el segmento"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Subtítulo"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Idioma"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Activar el contenido"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Decodificar los argumentos de la plantilla"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Datos personalizados"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Datos de retorno"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "Identificador del usuario de destino"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "Identificador del grupo de destino"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Componente"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Clase"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Gravedad"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Detalles personalizados"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "Identificador de la integración"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "Identificador de terceros"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Extras de Meta"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Clave maestra"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Dispositivo"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Espacio de nombres"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Insignias"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Tipo de mensaje"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "Identificador de destino"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "SMS de destino"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Canales"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "Identificador de autenticación"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Token de autenticación"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Clave del proveedor"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Clave de notificación"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Clave de la aplicación"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Secreto de la aplicación"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Clave secreta"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Mostrar el estado"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Clave del usuario"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "Título de la URL"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Intervalo de reintento de emergencia"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Caducidad"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Token del usuario"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Temas del grupo"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Canal"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Nombre del webhook"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Clave privada"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Vibración"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Nivel de información"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Nivel de éxito"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Nivel de advertencia"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Nivel de fallo"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Clave secreta de la API"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Tema de destino"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "Identificador de la aplicación"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Subreddit de destino"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Tipo"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "Identificador del flair"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Texto del flair"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "¿Es un anuncio?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Enviar las respuestas"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "Contiene spoiler"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Indicador de reenvío"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Dirección del remitente"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "Identificador del canal"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "URL incrustada"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Token o contraseña"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Entorno"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Modo de autenticación"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "Identificador de la sala de destino"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Modo del webhook"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Usar el avatar"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Servicio"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "Registrar el PID"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Organización"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Datos de la plantilla"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Nombre del remitente"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Token de sesión"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "Identificador de la clave de acceso"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Clave de acceso secreta"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Correos de destino"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Flash"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Etiqueta"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "Identificador del servicio"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Contraseña del servicio"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "Identificador del espacio"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Número de teléfono del destinatario"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Tipo de medio"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Tiempo de espera"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Voz de síntesis de voz"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Clave del cliente"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Notificación crítica"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Servicio"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Ubicación"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Escenario de alerta"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Filtrado"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "Identificador externo"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Estado"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Miembro de destino"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Compartido"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Etiqueta"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Código corto de destino"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "Token de acceso de OAuth"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Token A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Token B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Token C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "Identificador codificado de destino"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Ruta del flujo de trabajo"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Incluir el pie de página"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Usar bloques"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Incluir la marca de tiempo"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Modo del mensaje"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Servidor"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Usuario"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Transliterar"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Contacto de destino"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Solo prueba"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Pasarela"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Clave pública"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Semilla"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Salas"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Clave de enrutamiento de destino"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "Identificador de la entidad"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Tipo de alerta"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Enlace de la imagen"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Enlace del sonido"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Color de texto especial"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Importe"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Moneda"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Nombre"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Identificador"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Subir"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Registrar en STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "Identificador del chat de destino"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Detectar al propietario del bot"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Vista previa de la página web"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Agrupar adjuntos de foto/vídeo"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "Identificador del hilo del tema"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Versión de Markdown"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Ubicación del contenido"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Ruta de la plantilla de mensaje enriquecido"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "Identificador del perfil de mensajería"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "Identificador de la pasarela"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "Identificador de Threema de destino"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "Nombre del host de la API"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "URL de la imagen"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Tipo de evento"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Prioridad (compatibilidad con Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Método de notificación: sms o llamada"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Clave del consumidor"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Secreto del consumidor"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Secreto de acceso"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Token de autenticación"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "Identificadores de los destinatarios"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "URL del avatar del bot"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "Correo del usuario"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Token de acceso del bot"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "Identificadores de las salas"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "Identificador de la empresa"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "Secreto de la aplicación"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "Identificador del agente"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Departamento de destino"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Etiqueta de destino"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Clave del webhook del bot"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "Identificador del teléfono del remitente"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "Se requiere un entorno Microsoft Windows local."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "Identificador del flujo de trabajo"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Firma"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Usar una URL de Power Automate"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Identificador de enrutamiento de Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Ajustar el texto"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "Versión de la API"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Temas"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Código de grupo o de opción"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "Token de la aplicación"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Token o clave"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Prioridad de la información"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Prioridad del éxito"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Prioridad de la advertencia"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Prioridad del fallo"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Etiqueta del enlace"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Token de verificación"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Flujo de destino"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"Instale pika para AMQP 0.9.1, python-qpid-proton para AMQP 1.0, o ambos."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Intercambio"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Host virtual"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Persistente"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Obligatorio"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Tiempo de vida"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Cabeceras del mensaje"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "Servidor SMTP"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Modo seguro"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "Modo de seguridad de PGP"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "Ruta de la clave pública de PGP"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "Ruta de la clave privada de PGP"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Directorio de claves web"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Archivos adjuntos incrustados"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "Correo del destinatario"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "Archivo de clave de OAuth2"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "URL de imagen personalizada"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Color de la notificación"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Nombre real"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Apodo"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Unirse a los canales"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Modo de autenticación"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Alias de la sala de destino"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Descubrimiento del servidor"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Forzar el servidor de origen en los identificadores de sala"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Versión de la API de Matrix"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "Cifrado de extremo a extremo"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Verificación automática del dispositivo"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "Archivo de clave privada PEM"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "Archivo de suscripción"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "Servidor XMPP"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Obtener la lista de contactos"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Usar el asunto"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Mantener la conexión activa"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "Apodo de MUC"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "Vinculación de canal SCRAM-PLUS"
caronc-apprise-dfec414/apprise/i18n/fr/000077500000000000000000000000001526720371000177505ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/fr/LC_MESSAGES/000077500000000000000000000000001526720371000215355ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/fr/LC_MESSAGES/apprise.po000066400000000000000000002053021526720371000235420ustar00rootroot00000000000000# French translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: fr\n"
"Language-Team: fr \n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "Vérifier le SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Suivre les redirections"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Délai de lecture du socket"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Délai de connexion du socket"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Âge du cache"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Type MIME forcé"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Nom de fichier forcé"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Fichier local"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Sur le Web"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Mémoire"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Schéma"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Aucune dépendance."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "Des paquets sont requis pour fonctionner."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "Des paquets sont recommandés pour améliorer les fonctionnalités."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "Nom d'utilisateur de l'application"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "Clé d'API"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Téléphone cible"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Cibles"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Expéditeur"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "Mode SMS"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Mode par lots"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Nom d'hôte"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Port"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Nom d'utilisateur"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Mot de passe"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Jeton"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Étiquettes"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Méthode de requête"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Version de l'API Apprise"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "En-tête HTTP"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Nom d'utilisateur"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Indicatif cible"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Délai de réexpédition"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Paramètres régionaux"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Appareil cible"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Son"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Niveau"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Volume"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Clic"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Badge"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Catégorie"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Groupe"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Inclure l'image"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "URL de l'icône"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Appel"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Clé de chiffrement"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Mode de débordement"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Format de notification"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Interpréter les émojis"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Stockage persistant"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Fuseau horaire"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Nouvelles tentatives du service"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Attente entre les tentatives"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Service optionnel"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "Courriel de l'expéditeur"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Équipe cible"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Politique d'escalade"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Méthodes d'alerte"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Délai d'attente de l'équipe"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Numéro de série"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Durée (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Temps de fondu (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "Numéro de la DEL"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Courriel source"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Courriel cible"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "Courriel de réponse"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Copie conforme"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Copie conforme invisible"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Secret"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Numéro de téléphone cible"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Groupe cible"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Numéro de téléphone de l'expéditeur"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Groupe de routage"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Caractères Unicode"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "Secret d'API"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "Identifiant de l'expéditeur"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "Pays"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "validité"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "Jeton d'API"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Jeton du webhook"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Nom du bot"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Canal cible"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Bot cible"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Région"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "ID de l'entreprise"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "Diffusion"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Méthode de récupération"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Joindre le fichier sous"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Extras de la charge utile"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "Paramètres GET"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "Jeton d'accès à l'API"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Adresse d'origine"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Priorité"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Groupes d'émetteurs"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "libdbus-1.so.x doit être installé."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "Notification DBus"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Urgence"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "Axe X"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Axe Y"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "Identifiant du webhook"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Synthèse vocale"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Image de l'avatar"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "URL de l'avatar"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "Identifiant du fil"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Afficher le pied de page"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Logo du pied de page"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Utiliser les champs"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Indicateurs Discord"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Mentionner les utilisateurs ou les rôles"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Chemin du modèle"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Grouper les pièces jointes"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Jetons du modèle"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Numéro de série de l'appareil"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "Mode d'API"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Rafraîchir maintenant"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Signature du texte"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Icône en Base64 (API texte)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Image en Base64 (API image)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Lien"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Bordure"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Type de tramage"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Noyau de tramage"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Clé de la tâche"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Modale"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Chemin"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Délai d'attente du serveur"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Nom de l'instance"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "SID du compte"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Numéro de téléphone de l'expéditeur ou identifiant d'expéditeur"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Nom de la région"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Clé d'accès"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "Vers l'identifiant d'utilisateur"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "Vers l'identifiant du canal"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Chemin du webhook"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Mode"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Nom du fil"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "Nom d'utilisateur de l'API"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "Mot de passe de l'API"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Jeton d'accès"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Propriétaire"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Dépôt"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Type"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Numéro"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Étiquettes"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Responsables"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "libdbus-1.so.x ou libdbus-2.so.x doit être installé."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "Notification GLib"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "Un environnement Gnome local est requis."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Notification Gnome"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Clés d'intégration"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Action"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Clé de déduplication"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Métadonnées"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Espace de travail"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Clé du webhook"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Clé du fil"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Plateforme"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Sujet"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Entrées de données"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "Identifiant du bot"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Version"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Épinglé"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Jeton d'accès de longue durée"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "Identifiant de la notification"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Préfixe du chemin"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Jeton ou nom d'utilisateur"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Événements"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Ajouter des jetons"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Retirer des jetons"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Clé d'intégration"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Route"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "ID de la source d'alertes"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Escalade cible"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Horaire cible"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Utilisateur cible"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Cibles "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Entité"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Alias"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Détails"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Correspondance des actions"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "Identifiant de l'appareil"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Nom de l'appareil"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Numéro de téléphone source"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Durée"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Clé du serveur"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Clé d'API de l'appareil"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "Identifiant de l'application"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "Version de l'application"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "Jeton d'accès de l'application"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Icône personnalisée"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Type d'icône"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Cycles"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Jeton du bot"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "URL du clic"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Couleur"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Ne fonctionne qu'avec Mac OS X 10.8 et les versions ultérieures. Nécessite "
"également que /usr/local/bin/terminal-notifier soit accessible localement."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "Notification MacOSX"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "URL d'ouverture ou de clic"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Version de Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Expéditeur"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Répondre à"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Domaine"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Nom de l'expéditeur"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "En-tête du courriel"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Visibilité"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Texte masqué"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Code de langue"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Mettre les résultats en cache"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Pièces jointes sensibles"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Mentionner les utilisateurs ou les étiquettes"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "Utilisateur"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "Identifiant du canal cible"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Nombre maximal de parties du message"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Référence personnalisée"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "File d'attente cible"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "Identifiant du client"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Utiliser une session"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Conserver les messages"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "Identifiant du modèle"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Clé d'authentification"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "URL courte"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Correspondance du modèle"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "Préfixe de l'URL"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "Identifiant de la salle"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Notification silencieuse"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Identifiant de l'événement Discord"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Source"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "Identifiant du projet"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Crochet de message"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "Couleurs IRC"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Préfixe"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Nom de la campagne"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Nom du modèle"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Référence du client"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Haute qualité"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "En-tête du télécopieur"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Pièce jointe"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Nom du fichier joint"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Délai"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "Courriel"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Actions"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Type d'authentification"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "Identifiant de l'API"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Accepter les réponses"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Objet"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Domaine du locataire"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "Courriel du compte ou identifiant de l'objet"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Secret du client"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Enregistrer dans les éléments envoyés"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Modèle"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "Identifiant du joueur cible"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Inclure le segment"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Sous-titre"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Langue"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Activer le contenu"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Décoder les arguments du modèle"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Données personnalisées"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Données de retour"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "Identifiant de l'utilisateur cible"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "Identifiant du groupe cible"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Composant"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Classe"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Gravité"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Détails personnalisés"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "Identifiant de l'intégration"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "Identifiant tiers"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Extras Meta"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Clé maîtresse"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Appareil"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Espace de noms"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Badges"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Type de message"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "Identifiant cible"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "SMS cible"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Canaux"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "Identifiant d'authentification"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Jeton d'authentification"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Clé du fournisseur"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Clé de notification"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Clé de l'application"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Secret de l'application"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Clé secrète"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Afficher l'état"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Clé de l'utilisateur"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "Titre de l'URL"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Intervalle de répétition d'urgence"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Expiration"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Jeton de l'utilisateur"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Sujets du groupe"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Canal"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Nom du webhook"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Clé privée"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Vibration"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Niveau d'information"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Niveau de succès"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Niveau d'avertissement"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Niveau d'échec"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Clé d'API secrète"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Sujet cible"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "Identifiant de l'application"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Sous-Reddit cible"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Genre"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "Identifiant du flair"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Texte du flair"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "Est-ce une publicité ?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Envoyer les réponses"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "Contient un spoiler"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Indicateur de renvoi"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Adresse de l'expéditeur"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "Identifiant du canal"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "URL intégrée"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Jeton ou mot de passe"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Environnement"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Mode d'authentification"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "Identifiant de la salle cible"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Mode webhook"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Utiliser l'avatar"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Service"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "Journaliser le PID"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Organisation"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Données du modèle"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Nom de l'expéditeur"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Jeton de session"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "Identifiant de la clé d'accès"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Clé d'accès secrète"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Courriels cibles"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Flash"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Étiquette"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "Identifiant du service"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Mot de passe du service"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "Identifiant de l'espace"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Numéro de téléphone du destinataire"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Type de média"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Délai d'attente"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Voix de synthèse"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Clé du client"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Notification critique"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Service"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Emplacement"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Scénario d'alerte"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Filtrage"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "Identifiant externe"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "État"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Membre cible"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Partagé"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Étiquette"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Code court cible"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "Jeton d'accès OAuth"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Jeton A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Jeton B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Jeton C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "Identifiant encodé cible"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Chemin du flux de travail"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Inclure le pied de page"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Utiliser les blocs"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Inclure l'horodatage"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Mode de message"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Hôte"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Identifiant"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Translittérer"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Contact cible"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Test seulement"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Passerelle"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Clé publique"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Graine"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Salles"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Clé de routage cible"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "Identifiant de l'entité"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Type d'alerte"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Lien de l'image"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Lien du son"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Couleur de texte spéciale"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Montant"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Devise"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Nom"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Identifiant"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Téléverser"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Journaliser vers STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "Identifiant de la conversation cible"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Détecter le propriétaire du bot"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Aperçu de la page Web"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Regrouper les pièces jointes photo/vidéo"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "Identifiant du fil du sujet"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Version de Markdown"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Placement du contenu"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Chemin du modèle de message enrichi"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "Identifiant du profil de messagerie"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "Identifiant de la passerelle"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "Identifiant Threema cible"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "Nom d'hôte de l'API"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "URL de l'image"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Type d'événement"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Priorité (compatibilité Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Méthode de notification : sms ou appel"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Clé du consommateur"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Secret du consommateur"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Secret d'accès"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Jeton d'authentification"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "Identifiants des destinataires"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "URL de l'avatar du bot"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "Courriel de l'utilisateur"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Jeton d'accès du bot"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "Identifiants des salles"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "Identifiant de l'entreprise"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "Secret de l'application"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "Identifiant de l'agent"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Service cible"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Étiquette cible"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Clé du webhook du bot"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "Identifiant du téléphone de l'expéditeur"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "Un environnement Microsoft Windows local est requis."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "Identifiant du flux de travail"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Signature"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Utiliser une URL Power Automate"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Identifiant de routage Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Renvoyer le texte à la ligne"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "Version de l'API"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Sujets"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Code de groupe ou d'option"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "Jeton de l'application"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Jeton ou clé"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Priorité des informations"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Priorité des succès"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Priorité des avertissements"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Priorité des échecs"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Libellé du lien"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Jeton de vérification"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Flux cible"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"Installez pika pour AMQP 0.9.1, python-qpid-proton pour AMQP 1.0, ou les "
"deux."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Échange"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Hôte virtuel"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Persistant"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Obligatoire"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Durée de vie"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "En-têtes du message"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "Serveur SMTP"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Mode sécurisé"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "Mode de sécurité PGP"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "Chemin de la clé publique PGP"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "Chemin de la clé privée PGP"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Répertoire de clés Web"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Pièces jointes intégrées"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "Courriel du destinataire"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "Fichier de clé OAuth2"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "URL d'image personnalisée"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Couleur de la notification"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Nom réel"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Pseudonyme"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Rejoindre les canaux"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Mode d'authentification"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Alias de la salle cible"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Découverte du serveur"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Forcer le serveur d'origine sur les identifiants de salle"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Version de l'API Matrix"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "Chiffrement de bout en bout"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Vérification automatique de l'appareil"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "Fichier de clé privée PEM"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "Fichier d'abonnement"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "Serveur XMPP"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Obtenir la liste de contacts"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Utiliser le sujet"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Maintenir la connexion active"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "Pseudonyme MUC"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "Liaison de canal SCRAM-PLUS"
caronc-apprise-dfec414/apprise/i18n/hi/000077500000000000000000000000001526720371000177415ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/hi/LC_MESSAGES/000077500000000000000000000000001526720371000215265ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/hi/LC_MESSAGES/apprise.po000066400000000000000000002260441526720371000235410ustar00rootroot00000000000000# Hindi translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: hi\n"
"Language-Team: hi \n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "SSL सत्यापित करें"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "पुनर्निर्देशन का पालन करें"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "सॉकेट पढ़ने की समय सीमा"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "सॉकेट कनेक्ट करने की समय सीमा"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "कैश की आयु"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "बाध्य MIME प्रकार"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "बाध्य फ़ाइल नाम"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "स्थानीय फ़ाइल"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "वेब पर आधारित"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "स्मृति"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "स्कीमा"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "कोई निर्भरता नहीं।"

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "काम करने के लिए पैकेज आवश्यक हैं।"

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "कार्यक्षमता बढ़ाने के लिए पैकेज की सलाह दी जाती है।"

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "ऐप का उपयोगकर्ता नाम"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "API कुंजी"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "लक्षित फ़ोन"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "लक्ष्य"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "प्रेषक"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "SMS मोड"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "बैच मोड"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "होस्ट नाम"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "पोर्ट"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "उपयोगकर्ता नाम"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "पासवर्ड"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "टोकन"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "टैग"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "क्वेरी विधि"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Apprise API का संस्करण"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "HTTP शीर्षलेख"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "उपयोगकर्ता नाम"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "लक्षित कॉल संकेत"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "पुनः भेजने में विलंब"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "क्षेत्रीय सेटिंग"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "लक्षित उपकरण"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "ध्वनि"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "स्तर"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "ध्वनि स्तर"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "क्लिक"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "बैज"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "श्रेणी"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "समूह"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "छवि शामिल करें"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "आइकन का URL"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "कॉल"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "कूटलेखन कुंजी"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "अतिप्रवाह मोड"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "अधिसूचना स्वरूप"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "इमोजी की व्याख्या करें"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "स्थायी भंडारण"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "समय क्षेत्र"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "सेवा के पुनः प्रयास"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "प्रयासों के बीच प्रतीक्षा"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "वैकल्पिक सेवा"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "प्रेषक का ईमेल"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "लक्षित टीम"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "एस्केलेशन नीति"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "अलर्ट के तरीके"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "टीम प्रतीक्षा समय"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "क्रम संख्या"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "अवधि (मिलीसेकंड)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "धुंधलाने का समय (मिलीसेकंड)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "LED संख्या"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "स्रोत ईमेल"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "लक्षित ईमेल"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "उत्तर के लिए ईमेल"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "प्रतिलिपि"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "गुप्त प्रतिलिपि"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "गुप्त कुंजी"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "लक्षित फ़ोन नंबर"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "लक्षित समूह"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "प्रेषक का फ़ोन नंबर"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "मार्ग समूह"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "यूनिकोड वर्ण"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "API गुप्त कुंजी"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "प्रेषक की आईडी"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "देश"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "वैधता"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "API टोकन"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "वेबहुक टोकन"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "बॉट का नाम"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "लक्षित चैनल"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "लक्षित बॉट"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "क्षेत्र"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "कंपनी आईडी"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "प्रसारण"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "प्राप्त करने की विधि"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "फ़ाइल इस नाम से जोड़ें"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "पेलोड के अतिरिक्त मान"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "GET पैरामीटर"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "API पहुँच टोकन"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "मूल पता"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "प्राथमिकता"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "ट्रांसमीटर समूह"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "libdbus-1.so.x स्थापित होना चाहिए।"

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "DBus अधिसूचना"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "तात्कालिकता"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "X अक्ष"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Y अक्ष"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "वेबहुक की आईडी"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "पाठ से वाणी"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "अवतार छवि"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "अवतार का URL"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "सूत्र की आईडी"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "पादलेख दिखाएँ"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "पादलेख का लोगो"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "फ़ील्ड का उपयोग करें"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Discord फ़्लैग"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "उपयोगकर्ताओं या भूमिकाओं का उल्लेख करें"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "टेम्पलेट का पथ"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "अनुलग्नकों को एक साथ भेजें"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "टेम्पलेट टोकन"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "उपकरण की क्रम संख्या"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "API मोड"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "अभी ताज़ा करें"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "पाठ हस्ताक्षर"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Base64 में आइकन (पाठ API)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Base64 में छवि (छवि API)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "लिंक"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "किनारा"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "डिदरिंग का प्रकार"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "डिदरिंग कर्नेल"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "कार्य कुंजी"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "मोडल"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "पथ"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "सर्वर की समय सीमा"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "इंस्टेंस का नाम"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "खाते का SID"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "प्रेषक का फ़ोन नंबर या प्रेषक की आईडी"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "क्षेत्र का नाम"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "पहुँच कुंजी"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "उपयोगकर्ता आईडी को"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "चैनल आईडी को"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "वेबहुक का पथ"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "मोड"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "सूत्र का नाम"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "API उपयोगकर्ता नाम"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "API पासवर्ड"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "पहुँच टोकन"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "स्वामी"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "रिपॉज़िटरी"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "प्रकार"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "संख्या"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "लेबल्स"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "असाइनी"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "libdbus-1.so.x या libdbus-2.so.x स्थापित होना चाहिए।"

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "GLib अधिसूचना"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "स्थानीय Gnome वातावरण आवश्यक है।"

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Gnome अधिसूचना"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "एकीकरण कुंजियाँ"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "क्रिया"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "डुप्लिकेट-रोधी कुंजी"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "मेटाडेटा"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "कार्यस्थान"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "वेबहुक कुंजी"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "सूत्र कुंजी"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "प्लेटफ़ॉर्म"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "विषय"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "डेटा प्रविष्टियाँ"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "बॉट की आईडी"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "संस्करण"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "पिन किया गया"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "दीर्घकालिक पहुँच टोकन"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "अधिसूचना की आईडी"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "पथ का उपसर्ग"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "टोकन या उपयोगकर्ता नाम"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "घटनाएँ"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "टोकन जोड़ें"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "टोकन हटाएँ"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "एकीकरण कुंजी"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "मार्ग"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "अलर्ट स्रोत आईडी"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "लक्षित उन्नयन"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "लक्षित समय सारणी"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "लक्षित उपयोगकर्ता"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "लक्ष्य "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "इकाई"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "उपनाम"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "विवरण"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "क्रिया की मैपिंग"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "उपकरण की आईडी"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "उपकरण का नाम"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "स्रोत फ़ोन नंबर"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "अवधि"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "सर्वर कुंजी"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "उपकरण की API कुंजी"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "ऐप की आईडी"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "ऐप का संस्करण"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "ऐप का पहुँच टोकन"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "कस्टम आइकन"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "आइकन का प्रकार"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "चक्र"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "बॉट टोकन"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "क्लिक का URL"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "रंग"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"केवल Mac OS X 10.8 और उससे नए संस्करणों पर काम करता है। इसके अलावा /usr/local/bin/"
"terminal-notifier स्थानीय रूप से उपलब्ध होना चाहिए।"

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "MacOSX अधिसूचना"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "खोलने या क्लिक करने का URL"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Terminal-Notifier का संस्करण"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "प्रेषक"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "उत्तर यहाँ भेजें"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "डोमेन"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "प्रेषक का नाम"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "ईमेल शीर्षलेख"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "दृश्यता"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "छिपा हुआ पाठ"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "भाषा कोड"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "परिणाम कैश में रखें"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "संवेदनशील अनुलग्नक"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "उपयोगकर्ताओं या टैग का उल्लेख करें"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "उपयोगकर्ता"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "लक्षित चैनल की आईडी"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "संदेश के अधिकतम भाग"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "कस्टम संदर्भ"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "लक्षित कतार"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "क्लाइंट की आईडी"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "सत्र का उपयोग करें"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "संदेश बनाए रखें"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "टेम्पलेट की आईडी"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "प्रमाणीकरण कुंजी"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "छोटा URL"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "टेम्पलेट की मैपिंग"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "URL का उपसर्ग"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "कक्ष की आईडी"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "मौन अधिसूचना"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Discord घटना की आईडी"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "स्रोत"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "परियोजना की आईडी"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "संदेश हुक"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "IRC के रंग"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "उपसर्ग"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "अभियान का नाम"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "टेम्पलेट का नाम"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "क्लाइंट संदर्भ"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "उच्च गुणवत्ता"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "फ़ैक्स शीर्षलेख"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "अनुलग्नक"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "अनुलग्नक का फ़ाइल नाम"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "विलंब"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "ईमेल"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "क्रियाएँ"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "प्रमाणीकरण का प्रकार"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "API लॉगिन"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "उत्तर स्वीकार करें"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "प्रयोजन"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "किरायेदार का डोमेन"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "खाते का ईमेल या ऑब्जेक्ट की आईडी"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "क्लाइंट की गुप्त कुंजी"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "भेजे गए आइटम में सहेजें"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "टेम्पलेट"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "लक्षित प्लेयर की आईडी"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "खंड शामिल करें"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "उपशीर्षक"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "भाषा"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "सामग्री सक्षम करें"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "टेम्पलेट के तर्क विकोडित करें"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "कस्टम डेटा"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "पोस्टबैक डेटा"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "लक्षित उपयोगकर्ता की आईडी"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "लक्षित समूह की आईडी"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "घटक"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "वर्ग"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "गंभीरता"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "कस्टम विवरण"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "एकीकरण की आईडी"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "तृतीय पक्ष की आईडी"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Meta के अतिरिक्त मान"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "मुख्य कुंजी"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "उपकरण"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "नामस्थान"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "बैज"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "संदेश का प्रकार"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "लक्षित आईडी"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "लक्षित SMS"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "चैनल"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "प्रमाणीकरण की आईडी"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "प्रमाणीकरण टोकन"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "प्रदाता कुंजी"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "अधिसूचना कुंजी"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "अनुप्रयोग कुंजी"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "अनुप्रयोग की गुप्त कुंजी"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "गुप्त कुंजी"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "स्थिति दिखाएँ"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "उपयोगकर्ता कुंजी"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "URL का शीर्षक"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "आपातकालीन पुनः प्रयास अंतराल"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "समाप्ति"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "उपयोगकर्ता टोकन"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "समूह के विषय"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "चैनल"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "वेबहुक का नाम"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "निजी कुंजी"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "कंपन"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "सूचना स्तर"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "सफलता स्तर"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "चेतावनी स्तर"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "विफलता स्तर"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "गुप्त API कुंजी"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "लक्षित विषय"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "अनुप्रयोग की आईडी"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "लक्षित सबरेडिट"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "किस्म"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "फ़्लेयर की आईडी"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "फ़्लेयर का पाठ"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "क्या यह विज्ञापन है?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "उत्तर भेजें"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "इसमें स्पॉइलर है"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "पुनः प्रस्तुत करने का फ़्लैग"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "प्रेषक का पता"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "चैनल की आईडी"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "अंतर्निहित URL"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "टोकन या पासवर्ड"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "वातावरण"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "प्रमाणीकरण मोड"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "वेबहुक"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "लक्षित कक्ष की आईडी"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "वेबहुक मोड"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "अवतार का उपयोग करें"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "सुविधा"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "PID दर्ज करें"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "संगठन"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "टेम्पलेट का डेटा"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "प्रेषक का नाम"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "सत्र टोकन"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "पहुँच कुंजी की आईडी"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "गुप्त पहुँच कुंजी"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "लक्षित ईमेल"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "फ़्लैश"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "लेबल"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "सेवा की आईडी"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "सेवा का पासवर्ड"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "स्थान की आईडी"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "प्राप्तकर्ता का फ़ोन नंबर"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "मीडिया का प्रकार"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "समय सीमा"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "वाणी संश्लेषण की आवाज़"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "क्लाइंट कुंजी"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "अत्यावश्यक अधिसूचना"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "सेवा"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "स्थान"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "चेतावनी परिदृश्य"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "छानना"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "बाहरी आईडी"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "स्थिति"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "लक्ष्य सदस्य"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "साझा"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "टैग"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "लक्षित लघु कोड"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "OAuth पहुँच टोकन"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "टोकन A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "टोकन B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "टोकन C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "लक्षित कूटबद्ध आईडी"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "कार्यप्रवाह का पथ"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "पादलेख शामिल करें"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "ब्लॉक का उपयोग करें"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "समय चिह्न शामिल करें"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "संदेश मोड"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "होस्ट"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "लॉगिन"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "लिप्यंतरण करें"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "लक्षित संपर्क"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "केवल परीक्षण"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "गेटवे"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "सार्वजनिक कुंजी"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "बीज"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "कक्ष"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "लक्षित मार्ग कुंजी"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "इकाई की आईडी"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "चेतावनी का प्रकार"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "छवि का लिंक"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "ध्वनि का लिंक"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "विशेष पाठ रंग"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "राशि"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "मुद्रा"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "नाम"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "पहचानकर्ता"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "अपलोड"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "STDERR में दर्ज करें"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "लक्षित चैट की आईडी"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "बॉट के स्वामी का पता लगाएँ"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "वेब पृष्ठ की झलक"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "फ़ोटो/वीडियो अटैचमेंट को समूहित करें"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "विषय के सूत्र की आईडी"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Markdown का संस्करण"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "सामग्री का स्थान"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "सजे संदेश के टेम्पलेट का पथ"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "संदेश प्रोफ़ाइल की आईडी"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "गेटवे की आईडी"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "लक्षित Threema आईडी"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "API का होस्ट नाम"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "छवि का URL"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "घटना का प्रकार"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "प्राथमिकता (Pushover अनुकूलता)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "अधिसूचना की विधि: sms या कॉल"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "उपभोक्ता कुंजी"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "उपभोक्ता की गुप्त कुंजी"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "पहुँच की गुप्त कुंजी"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "प्रमाणीकरण टोकन"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "प्राप्तकर्ताओं की आईडी"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "बॉट के अवतार का URL"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "उपयोगकर्ता का ईमेल"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "बॉट का पहुँच टोकन"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "कक्षों की आईडी"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "कंपनी की आईडी"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "ऐप की गुप्त कुंजी"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "एजेंट की आईडी"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "लक्षित विभाग"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "लक्षित टैग"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "बॉट की वेबहुक कुंजी"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "प्रेषक के फ़ोन की आईडी"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "स्थानीय Microsoft Windows वातावरण आवश्यक है।"

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "कार्यप्रवाह की आईडी"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "हस्ताक्षर"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Power Automate का URL उपयोग करें"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Power Automate की मार्ग आईडी"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "पाठ लपेटें"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "API का संस्करण"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "विषय"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "समूह या विकल्प कोड"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "ऐप टोकन"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "टोकन या कुंजी"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "सूचना की प्राथमिकता"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "सफलता की प्राथमिकता"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "चेतावनी की प्राथमिकता"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "विफलता की प्राथमिकता"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "लिंक का लेबल"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "सत्यापन टोकन"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "लक्षित धारा"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"AMQP 0.9.1 के लिए pika, AMQP 1.0 के लिए python-qpid-proton, या दोनों इंस्टॉल करें।"

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "एक्सचेंज"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "वर्चुअल होस्ट"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "स्थायी"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "अनिवार्य"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "जीवनकाल (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "संदेश हेडर"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "SMTP सर्वर"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "सुरक्षित मोड"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "PGP सुरक्षा मोड"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "PGP सार्वजनिक कुंजी का पथ"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "PGP निजी कुंजी का पथ"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "वेब कुंजी निर्देशिका"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "अंतर्निहित अनुलग्नक"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "प्राप्तकर्ता का ईमेल"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "OAuth2 कुंजी फ़ाइल"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "कस्टम छवि का URL"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "अधिसूचना का रंग"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "वास्तविक नाम"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "उपनाम"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "चैनल में शामिल हों"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "प्रमाणीकरण मोड"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "लक्षित कक्ष का उपनाम"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "सर्वर की खोज"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "कक्ष आईडी पर मूल सर्वर बाध्य करें"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Matrix API का संस्करण"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "सिरे से सिरे तक कूटलेखन"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "उपकरण का स्वचालित सत्यापन"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "PEM निजी कुंजी फ़ाइल"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "सदस्यता फ़ाइल"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "XMPP सर्वर"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "संपर्क सूची प्राप्त करें"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "विषय का उपयोग करें"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "कनेक्शन बनाए रखें"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "MUC उपनाम"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "SCRAM-PLUS चैनल बंधन"
caronc-apprise-dfec414/apprise/i18n/id/000077500000000000000000000000001526720371000177355ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/id/LC_MESSAGES/000077500000000000000000000000001526720371000215225ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/id/LC_MESSAGES/apprise.po000066400000000000000000002012541526720371000235310ustar00rootroot00000000000000# Indonesian translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: id\n"
"Language-Team: id \n"
"Plural-Forms: nplurals=1; plural=0;\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "Verifikasi SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Ikuti pengalihan"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Batas waktu baca soket"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Batas waktu sambung soket"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Umur tembolok"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Jenis MIME yang dipaksakan"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Nama berkas yang dipaksakan"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Berkas lokal"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Berbasis web"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Memori"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Skema"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Tidak ada dependensi."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "Paket diperlukan agar dapat berfungsi."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "Paket disarankan untuk meningkatkan fungsi."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "Nama pengguna aplikasi"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "Kunci API"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Telepon tujuan"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Tujuan"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Pengirim"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "Mode SMS"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Mode gabungan"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Nama host"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Porta"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Nama pengguna"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Kata sandi"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Token"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Tanda"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Metode kueri"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Versi API Apprise"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "Tajuk HTTP"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Nama pengguna"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Tanda panggil tujuan"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Tunda pengiriman ulang"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Pengaturan lokal"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Perangkat tujuan"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Suara"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Tingkat"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Volume"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Klik"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Lencana"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Kategori"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Grup"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Sertakan gambar"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "URL ikon"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Panggilan"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Kunci enkripsi"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Mode luapan"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Format pemberitahuan"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Tafsirkan emoji"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Penyimpanan permanen"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Zona waktu"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Percobaan ulang layanan"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Tunggu antar percobaan"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Layanan opsional"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "Surel pengirim"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Tim tujuan"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Kebijakan Eskalasi"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Metode Peringatan"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Waktu Tunggu Tim"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Nomor seri"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Durasi (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Waktu peredupan (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "Nomor LED"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Surel sumber"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Surel tujuan"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "Surel untuk balasan"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Salinan"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Salinan tersembunyi"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Rahasia"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Nomor telepon tujuan"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Grup tujuan"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Nomor telepon pengirim"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Grup perutean"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Karakter Unicode"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "Rahasia API"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "ID pengirim"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "Negara"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "masa berlaku"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "Token API"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Token webhook"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Nama bot"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Saluran tujuan"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Bot tujuan"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Wilayah"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "ID perusahaan"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "Siaran"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Metode pengambilan"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Lampirkan berkas sebagai"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Tambahan muatan"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "Parameter GET"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "Token akses API"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Alamat asal"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Prioritas"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Grup pemancar"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "libdbus-1.so.x harus dipasang."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "Pemberitahuan DBus"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Tingkat urgensi"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "Sumbu X"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Sumbu Y"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "ID webhook"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Pengubah teks ke suara"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Gambar avatar"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "URL avatar"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "ID utas"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Tampilkan catatan kaki"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Logo catatan kaki"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Gunakan bidang"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Tanda Discord"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Sebut pengguna atau peran"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Jalur templat"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Gabungkan lampiran"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Token templat"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Nomor seri perangkat"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "Mode API"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Segarkan sekarang"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Tanda tangan teks"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Ikon dalam Base64 (API teks)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Gambar dalam Base64 (API gambar)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Tautan"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Bingkai"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Jenis dithering"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Kernel dithering"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Kunci tugas"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Modal"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Jalur"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Batas waktu server"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Nama instansi"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "SID akun"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Nomor telepon pengirim atau ID pengirim"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Nama wilayah"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Kunci akses"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "Ke ID pengguna"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "Ke ID saluran"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Jalur webhook"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Mode"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Nama utas"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "Nama pengguna API"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "Kata sandi API"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Token akses"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Pemilik"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Repositori"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Jenis"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Nomor"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Label"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Penerima tugas"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "libdbus-1.so.x atau libdbus-2.so.x harus dipasang."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "Pemberitahuan GLib"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "Diperlukan lingkungan Gnome lokal."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Pemberitahuan Gnome"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Kunci integrasi"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Tindakan"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Kunci deduplikasi"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Metadata"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Ruang kerja"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Kunci webhook"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Kunci utas"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Platform"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Topik"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Entri data"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "ID bot"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Versi"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Disematkan"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Token akses jangka panjang"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "ID pemberitahuan"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Awalan jalur"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Token atau nama pengguna"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Peristiwa"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Tambah token"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Hapus token"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Kunci integrasi"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Rute"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "ID Sumber Peringatan"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Eskalasi tujuan"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Jadwal tujuan"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Pengguna tujuan"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Tujuan "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Entitas"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Alias"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Rincian"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Pemetaan tindakan"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "ID perangkat"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Nama perangkat"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Nomor telepon sumber"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Durasi"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Kunci server"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Kunci API perangkat"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "ID aplikasi"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "Versi aplikasi"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "Token akses aplikasi"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Ikon khusus"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Jenis ikon"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Siklus"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Token bot"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "URL klik"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Warna"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Hanya bekerja dengan Mac OS X 10.8 dan yang lebih baru. Selain itu, /usr/"
"local/bin/terminal-notifier harus dapat diakses secara lokal."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "Pemberitahuan MacOSX"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "URL untuk dibuka atau diklik"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Versi Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Pengirim"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Balas ke"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Domain"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Nama pengirim"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "Tajuk surel"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Keterlihatan"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Teks tersembunyi"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Kode bahasa"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Simpan hasil di tembolok"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Lampiran sensitif"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Sebut pengguna atau tanda"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "Pengguna"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "ID saluran tujuan"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Jumlah maksimum bagian pesan"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Rujukan khusus"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Antrean tujuan"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "ID klien"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Gunakan sesi"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Simpan pesan"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "ID templat"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Kunci autentikasi"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "URL pendek"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Pemetaan templat"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "Awalan URL"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "ID ruang"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Pemberitahuan senyap"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "ID peristiwa Discord"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Sumber"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "ID proyek"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Hook pesan"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "Warna IRC"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Awalan"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Nama kampanye"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Nama templat"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Rujukan klien"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Kualitas tinggi"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Tajuk faks"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Lampiran"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Nama berkas lampiran"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Tunda"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "Surel"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Tindakan"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Jenis autentikasi"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "Nama masuk API"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Terima balasan"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Tujuan penggunaan"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Domain penyewa"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "Surel akun atau ID objek"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Rahasia klien"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Simpan ke item terkirim"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Templat"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "ID pemain tujuan"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Sertakan segmen"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Subjudul"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Bahasa"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Aktifkan isi"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Uraikan argumen templat"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Data khusus"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Data umpan balik"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "ID pengguna tujuan"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "ID grup tujuan"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Komponen"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Kelas"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Tingkat keparahan"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Rincian khusus"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "ID integrasi"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "ID pihak ketiga"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Tambahan Meta"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Kunci utama"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Perangkat"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Ruang nama"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Lencana"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Jenis pesan"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "ID tujuan"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "SMS tujuan"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Saluran"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "ID autentikasi"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Token autentikasi"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Kunci penyedia"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Kunci pemberitahuan"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Kunci aplikasi"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Rahasia aplikasi"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Kunci rahasia"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Tampilkan status"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Kunci pengguna"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "Judul URL"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Selang percobaan ulang darurat"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Kedaluwarsa"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Token pengguna"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Topik grup"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Saluran"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Nama webhook"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Kunci privat"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Getaran"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Tingkat informasi"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Tingkat keberhasilan"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Tingkat peringatan"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Tingkat kegagalan"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Kunci API rahasia"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Topik tujuan"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "ID aplikasi"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Subreddit tujuan"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Macam"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "ID flair"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Teks flair"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "Apakah iklan?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Kirim balasan"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "Mengandung spoiler"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Tanda pengiriman ulang"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Alamat pengirim"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "ID saluran"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "URL tersemat"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Token atau kata sandi"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Lingkungan"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Mode autentikasi"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "ID ruang tujuan"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Mode webhook"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Gunakan avatar"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Fasilitas"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "Catat PID"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Organisasi"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Data templat"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Nama pengirim"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Token sesi"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "ID kunci akses"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Kunci akses rahasia"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Surel tujuan"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Kilat"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Label"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "ID layanan"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Kata sandi layanan"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "ID ruang"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Nomor telepon penerima"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Jenis media"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Batas waktu"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Suara pengubah teks"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Kunci klien"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Pemberitahuan penting"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Layanan"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Lokasi"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Skenario peringatan"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Penyaringan"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "ID eksternal"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Status"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Anggota Tujuan"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Dibagikan"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Tag"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Kode pendek tujuan"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "Token akses OAuth"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Token A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Token B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Token C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "ID tersandi tujuan"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Jalur alur kerja"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Sertakan catatan kaki"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Gunakan blok"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Sertakan cap waktu"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Mode pesan"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Host"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Nama masuk"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Alihkan huruf"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Kontak tujuan"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Hanya uji"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Gerbang"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Kunci publik"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Benih"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Ruang"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Kunci perutean tujuan"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "ID entitas"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Jenis peringatan"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Tautan gambar"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Tautan suara"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Warna teks khusus"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Jumlah"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Mata uang"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Nama"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Pengenal"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Unggah"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Catat ke STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "ID obrolan tujuan"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Deteksi pemilik bot"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Pratinjau halaman web"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Kelompokkan lampiran foto/video"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "ID utas topik"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Versi Markdown"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Penempatan isi"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Jalur templat pesan berformat"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "ID profil perpesanan"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "ID gerbang"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "ID Threema tujuan"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "Nama host API"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "URL gambar"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Jenis peristiwa"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Prioritas (kompatibilitas Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Metode pemberitahuan: sms atau panggilan"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Kunci konsumen"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Rahasia konsumen"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Rahasia akses"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Token autentikasi"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "ID penerima"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "URL avatar bot"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "Surel pengguna"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Token akses bot"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "ID ruang"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "ID perusahaan"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "Rahasia aplikasi"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "ID agen"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Departemen tujuan"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Tanda tujuan"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Kunci webhook bot"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "ID telepon pengirim"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "Diperlukan lingkungan Microsoft Windows lokal."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "ID alur kerja"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Tanda tangan"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Gunakan URL Power Automate"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "ID perutean Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Bungkus teks"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "Versi API"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Topik"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Kode grup atau pilihan"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "Token aplikasi"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Token atau kunci"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Prioritas informasi"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Prioritas keberhasilan"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Prioritas peringatan"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Prioritas kegagalan"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Label tautan"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Token verifikasi"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Aliran tujuan"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"Instal pika untuk AMQP 0.9.1, python-qpid-proton untuk AMQP 1.0, atau "
"keduanya."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Exchange"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Host Virtual"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Persisten"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Wajib"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Waktu Hidup (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Header Pesan"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "Server SMTP"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Mode aman"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "Mode keamanan PGP"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "Jalur kunci publik PGP"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "Jalur kunci privat PGP"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Direktori kunci web"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Lampiran tersemat"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "Surel penerima"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "Berkas kunci OAuth2"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "URL gambar khusus"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Warna pemberitahuan"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Nama asli"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Nama panggilan"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Masuk ke saluran"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Mode autentikasi"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Alias ruang tujuan"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Penemuan server"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Paksa server asal pada ID ruang"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Versi API Matrix"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "Enkripsi ujung ke ujung"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Verifikasi perangkat otomatis"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "Berkas kunci privat PEM"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "Berkas langganan"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "Server XMPP"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Ambil daftar kontak"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Gunakan subjek"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Jaga sambungan tetap hidup"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "Nama panggilan MUC"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "Pengikatan saluran SCRAM-PLUS"
caronc-apprise-dfec414/apprise/i18n/it/000077500000000000000000000000001526720371000177555ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/it/LC_MESSAGES/000077500000000000000000000000001526720371000215425ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/it/LC_MESSAGES/apprise.po000066400000000000000000002037771526720371000235650ustar00rootroot00000000000000# Italian translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# albano battistella , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: it\n"
"Language-Team: it \n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "Verifica SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Segui i reindirizzamenti"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Timeout di lettura del socket"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Timeout di connessione del socket"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Età della cache"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Mime Type forzato"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Nome file forzato"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "File locale"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Basato sul Web"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Memoria"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Schema"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Nessuna dipendenza."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "I pacchetti sono richiesti per il funzionamento."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "I pacchetti sono consigliati per migliorare le funzionalità."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "Nome utente dell'app"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "Chiave API"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Telefono di destinazione"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Destinatari"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Da"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "Modalità SMS"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Modalità batch"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Nome host"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Porta"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Nome utente"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Password"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Token"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Tag"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Metodo di query"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Versione dell'API di Apprise"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "Intestazione HTTP"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Nome utente"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Nominativo di destinazione"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Ritardo di reinvio"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Impostazione locale"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Dispositivo di destinazione"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Suono"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Livello"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Volume"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Clic"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Badge"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Categoria"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Gruppo"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Includi immagine"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "URL dell'icona"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Chiamata"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Chiave di crittografia"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Modalità di overflow"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Formato di notifica"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Interpreta emoji"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Archiviazione persistente"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Fuso orario"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Tentativi del servizio"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Attesa tra i tentativi"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Servizio opzionale"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "Email del mittente"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Team di destinazione"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Criterio di escalation"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Metodi di avviso"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Attesa del team"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Numero di serie"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Durata (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Tempo di dissolvenza (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "Numero del LED"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Email di origine"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Email di destinazione"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "Email di risposta"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Copia conoscenza"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Copia conoscenza nascosta"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Segreto"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Numero di telefono di destinazione"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Gruppo di destinazione"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Numero di telefono mittente"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Gruppo di instradamento"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Caratteri Unicode"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "Segreto API"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "ID mittente"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "Paese"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "validità"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "Token API"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Token Webhook"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Nome del bot"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Canale di destinazione"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Bot di destinazione"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Regione"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "ID azienda"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "Trasmissione"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Metodo di recupero"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Allega file come"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Elementi extra del payload"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "Parametri GET"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "Token di accesso API"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Indirizzo di origine"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Priorità"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Gruppi di trasmissione"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "La libreria libdbus-1.so.x deve essere installata."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "Notifica DBus"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Urgenza"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "Asse X"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Asse Y"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "ID Webhook"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Sintesi vocale"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Immagine dell'avatar"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "URL dell'avatar"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "ID discussione"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Mostra piè di pagina"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Logo del piè di pagina"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Usa campi"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Flag di Discord"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Menziona utenti o ruoli"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Percorso del modello"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Allegati in batch"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Token del modello"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Numero di serie del dispositivo"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "Modalità API"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Aggiorna ora"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Firma di testo"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Icona Base64 (Text API)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Immagine Base64 (Image API)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Collegamento"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Bordo"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Tipo di dither"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Kernel di dither"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Chiave dell'attività"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Finestra modale"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Percorso"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Timeout del server"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Nome dell'istanza"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "SID dell'account"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Numero telefonico mittente / ID mittente"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Nome della regione"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Chiave di accesso"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "ID utente destinatario"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "ID canale destinatario"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Percorso del Webhook"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Modalità"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Nome della discussione"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "Nome utente API"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "Password API"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Token di accesso"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Proprietario"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Repository"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Tipo"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Numero"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Etichette"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Assegnatari"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "La libreria libdbus-1.so.x o libdbus-2.so.x deve essere installata."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "Notifica GLib"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "È richiesto un ambiente locale Gnome."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Notifica Gnome"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Chiavi di integrazione"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Azione"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Chiave di deduplicazione"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Metadati"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Area di lavoro"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Chiave del Webhook"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Chiave della discussione"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Piattaforma"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Argomento"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Voci di dati"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "ID del bot"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Versione"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Permanente"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Token di accesso a lungo termine"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "ID notifica"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Prefisso del percorso"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Token o Nome utente"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Eventi"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Aggiungi token"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Rimuovi token"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Chiave di integrazione"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Rotta"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "ID origine avvisi"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Escalation di destinazione"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Pianificazione di destinazione"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Utente di destinazione"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Destinatari "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Entità"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Alias"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Dettagli"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Mappatura delle azioni"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "ID dispositivo"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Nome dispositivo"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Numero di telefono mittente"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Durata"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Chiave del server"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Chiave API del dispositivo"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "ID dell'app"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "Versione dell'app"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "Token di accesso dell'app"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Icona personalizzata"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Tipo di icona"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Cicli"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Token del bot"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "URL del clic"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Colore"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Funziona solo con Mac OS X 10.8 e versioni successive. Richiede inoltre che /"
"usr/local/bin/terminal-notifier sia accessibile localmente."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "Notifica MacOSX"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "Apri/Fai clic su URL"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Versione di Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Mittente"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Rispondi a"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Dominio"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Nome del mittente"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "Intestazione dell'email"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Visibilità"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Testo dello spoiler"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Codice lingua"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Risultati della cache"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Allegati sensibili"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Menziona utenti o tag"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "Utente"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "ID del canale di destinazione"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Numero massimo di parti del messaggio"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Riferimento personalizzato"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Coda di destinazione"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "ID client"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Usa sessione"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Conserva i messaggi"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "ID del modello"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Chiave di autenticazione"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "URL breve"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Mappatura del modello"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "Prefisso URL"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "ID stanza"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Notifica silenziosa"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "ID evento Discord"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Origine"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "ID progetto"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Hook del messaggio"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "Colori IRC"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Prefisso"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Nome della campagna"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Nome del modello"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Riferimento client"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Alta qualità"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Intestazione fax"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Allega"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Nome del file allegato"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Ritardo"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "Email"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Azioni"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Tipo di autenticazione"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "Login API"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Accetta risposte"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Scopo"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Dominio Tenant"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "Email dell'account o Object ID"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Segreto client"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Salva in Posta inviata"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Modello"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "Player ID di destinazione"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Includi segmento"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Sottotitolo"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Lingua"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Abilita contenuti"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Decodifica argomenti del modello"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Dati personalizzati"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Dati di postback"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "ID utente di destinazione"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "ID gruppo di destinazione"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Componente"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Classe"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Gravità"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Dettagli personalizzati"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "ID integrazione"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "ID di terze parti"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Elementi meta extra"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Chiave principale"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Dispositivo"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Spazio dei nomi"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Badge"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Tipo di messaggio"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "ID di destinazione"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "SMS di destinazione"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Canali"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "ID di autenticazione"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Token di autenticazione"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Chiave del fornitore"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Chiave di notifica"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Chiave dell'applicazione"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Segreto dell'applicazione"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Chiave segreta"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Mostra stato"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Chiave dell'utente"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "Titolo dell'URL"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Intervallo tentativi di emergenza"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Scadenza"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Token utente"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Argomenti del gruppo"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Canale"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Nome del Webhook"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Chiave privata"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Vibrazione"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Livello info"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Livello successo"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Livello avviso"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Livello errore"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Chiave API segreta"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Argomento di destinazione"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "ID applicazione"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Subreddit di destinazione"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Tipo"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "ID Flair"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Testo Flair"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "È un annuncio?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Invia risposte"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "È uno spoiler"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Flag di rinvio"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Indirizzo mittente"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "ID canale"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "URL incorporato"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Token o password"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Ambiente"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Modalità di autenticazione"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "ID stanza di destinazione"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Modalità Webhook"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Usa avatar"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Servizio"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "Registra il PID"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Organizzazione"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Dati del modello"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Nome del mittente"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Token di sessione"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "ID della chiave di accesso"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Chiave di accesso segreta"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Email di destinazione"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Flash"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Etichetta"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "ID servizio"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Password del servizio"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "ID spazio"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Numero di telefono del destinatario"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Tipo di contenuto"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Tempo di attesa"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Voce TTS"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Chiave del client"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Notifica critica"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Servizio"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Posizione"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Scenario di avviso"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Filtraggio"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "ID esterno"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Stato"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Membro di destinazione"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Condiviso"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Etichetta"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Short Code di destinazione"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "Token di accesso OAuth"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Token A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Token B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Token C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "ID codificato di destinazione"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Percorso del workflow"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Includi piè di pagina"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Usa blocchi"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Includi timestamp"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Modalità messaggio"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Host"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Login"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Traslittera"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Contatto di destinazione"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Solo test"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Gateway"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Chiave pubblica"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Seme"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Stanze"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Routing Key di destinazione"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "ID entità"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Tipo di avviso"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Collegamento immagine"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Collegamento audio"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Colore testo speciale"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Importo"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Valuta"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Nome"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Identificatore"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Caricamento"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Registra su STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "ID chat di destinazione"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Rileva proprietario del bot"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Anteprima pagina web"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Raggruppa allegati foto/video"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "ID discussione dell'argomento"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Versione Markdown"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Posizionamento del contenuto"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Percorso del modello di messaggio formattato"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "ID del profilo di messaggistica"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "ID Gateway"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "ID Threema di destinazione"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "Nome host dell'API"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "URL dell'immagine"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Tipo di evento"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Priorità (compatibilità con Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Metodo di notifica: sms o chiamata"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Chiave del consumatore"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Segreto del consumatore"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Segreto di accesso"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Token di autenticazione"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "ID dei destinatari"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "URL dell'avatar del bot"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "Email utente"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Token di accesso del bot"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "ID stanze"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "ID aziendale"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "Segreto dell'app"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "ID dell'agente"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Dipartimento di destinazione"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Tag di destinazione"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Chiave Webhook del bot"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "ID telefono mittente"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "È richiesto un ambiente locale Microsoft Windows."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "ID workflow"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Firma"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Usa URL di Power Automate"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "ID di routing di Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "A capo automatico"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "Versione API"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Argomenti"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Codice del gruppo o dell'opzione"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "Token dell'app"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Token o chiave"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Priorità delle informazioni"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Priorità dei successi"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Priorità degli avvisi"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Priorità degli errori"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Etichetta del collegamento"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Token di verifica"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Stream di destinazione"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"Installa pika per AMQP 0.9.1, python-qpid-proton per AMQP 1.0, o entrambi."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Exchange"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Host virtuale"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Persistente"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Obbligatorio"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Durata (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Intestazioni del messaggio"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "Server SMTP"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Modalità sicura"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "Modalità di sicurezza PGP"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "Percorso della chiave pubblica PGP"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "Percorso della chiave privata PGP"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Directory delle chiavi web"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Allegati incorporati"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "Email del destinatario"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "KeyFile OAuth2"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "URL dell'immagine personalizzata"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Colore della notifica"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Nome reale"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Nickname"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Entra nei canali"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Modalità di autenticazione"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Alias della stanza di destinazione"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Rilevamento del server"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Forza Home Server sugli ID delle stanze"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Versione API Matrix"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "Crittografia end-to-end"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Verifica automatica del dispositivo"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "KeyFile privato PEM"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "File di iscrizione"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "Server XMPP"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Ottieni l'elenco dei contatti"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Usa oggetto"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Mantieni attiva la connessione"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "Nickname MUC"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "Channel Binding SCRAM-PLUS"
caronc-apprise-dfec414/apprise/i18n/ja/000077500000000000000000000000001526720371000177335ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/ja/LC_MESSAGES/000077500000000000000000000000001526720371000215205ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/ja/LC_MESSAGES/apprise.po000066400000000000000000002077311526720371000235350ustar00rootroot00000000000000# Japanese translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: ja\n"
"Language-Team: ja \n"
"Plural-Forms: nplurals=1; plural=0;\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "SSL を検証"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "リダイレクトに従う"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "ソケット読み取りのタイムアウト"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "ソケット接続のタイムアウト"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "キャッシュの有効期間"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "強制する MIME タイプ"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "強制するファイル名"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "ローカルファイル"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "ウェブ上"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "メモリー"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "スキーマ"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "依存関係はありません。"

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "動作にはパッケージが必要です。"

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "機能を高めるためにパッケージの導入を推奨します。"

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "アプリのユーザー名"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "API キー"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "宛先の電話"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "宛先"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "送信元"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "SMS モード"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "一括モード"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "ホスト名"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "ポート"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "ユーザー名"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "パスワード"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "トークン"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "タグ"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "クエリー方式"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Apprise API のバージョン"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "HTTP ヘッダー"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "ユーザー名"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "宛先のコールサイン"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "再送までの待ち時間"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "ロケール"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "宛先の端末"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "サウンド"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "レベル"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "音量"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "クリック"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "バッジ"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "カテゴリー"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "グループ"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "画像を含める"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "アイコンの URL"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "通話"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "暗号化キー"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "超過時の動作"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "通知の形式"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "絵文字を解釈する"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "永続ストレージ"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "タイムゾーン"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "サービスの再試行回数"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "再試行の間隔"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "任意のサービス"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "送信元のメール"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "宛先のチーム"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "エスカレーションポリシー"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "アラート方法"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "チーム待機時間"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "シリアル番号"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "継続時間 (ミリ秒)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "フェード時間 (ミリ秒)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "LED 番号"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "送信元のメールアドレス"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "宛先のメールアドレス"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "返信先のメールアドレス"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "カーボンコピー"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "ブラインドカーボンコピー"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "シークレット"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "宛先の電話番号"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "宛先のグループ"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "送信元の電話番号"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "ルーティンググループ"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Unicode 文字"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "API シークレット"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "送信者 ID"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "国"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "有効期間"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "API トークン"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Webhook のトークン"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "ボットの名前"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "宛先のチャンネル"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "宛先のボット"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "リージョン"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "会社 ID"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "ブロードキャスト"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "取得方式"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "添付ファイル名"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "ペイロードの追加項目"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "GET パラメーター"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "API アクセストークン"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "発信元アドレス"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "優先度"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "送信機グループ"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "libdbus-1.so.x がインストールされている必要があります。"

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "DBus 通知"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "緊急度"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "X 軸"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Y 軸"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "Webhook の ID"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "音声読み上げ"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "アバター画像"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "アバターの URL"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "スレッドの ID"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "フッターを表示"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "フッターのロゴ"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "フィールドを使う"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Discord のフラグ"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "ユーザーまたはロールにメンション"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "テンプレートのパス"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "添付ファイルをまとめる"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "テンプレートのトークン"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "端末のシリアル番号"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "API モード"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "今すぐ更新"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "テキストの署名"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Base64 のアイコン (テキスト API)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Base64 の画像 (画像 API)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "リンク"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "枠線"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "ディザリングの種類"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "ディザリングのカーネル"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "タスクキー"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "モーダル"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "パス"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "サーバーのタイムアウト"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "インスタンス名"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "アカウントの SID"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "送信元の電話番号または送信者 ID"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "リージョン名"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "アクセスキー"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "宛先のユーザー ID"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "宛先のチャンネル ID"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Webhook のパス"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "モード"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "スレッド名"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "API のユーザー名"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "API のパスワード"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "アクセストークン"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "所有者"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "リポジトリ"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "種類"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "番号"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "ラベル一覧"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "担当者"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr ""
"libdbus-1.so.x または libdbus-2.so.x がインストールされている必要があります。"

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "GLib 通知"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "ローカルの Gnome 環境が必要です。"

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Gnome 通知"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "連携キー一覧"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "アクション"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "重複排除キー"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "メタデータ"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "ワークスペース"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Webhook のキー"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "スレッドのキー"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "プラットフォーム"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "トピック"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "データ項目"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "ボットの ID"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "バージョン"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "固定表示"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "長期間有効なアクセストークン"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "通知の ID"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "パスの接頭辞"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "トークンまたはユーザー名"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "イベント"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "トークンを追加"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "トークンを削除"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "連携キー"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "ルート"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "アラートソースID"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "宛先のエスカレーション"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "宛先のスケジュール"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "宛先のユーザー"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "宛先 "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "エンティティー"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "エイリアス"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "詳細"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "アクションの対応付け"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "端末の ID"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "端末名"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "発信元の電話番号"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "継続時間"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "サーバーキー"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "端末の API キー"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "アプリの ID"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "アプリのバージョン"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "アプリのアクセストークン"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "カスタムアイコン"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "アイコンの種類"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "繰り返し回数"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "ボットのトークン"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "クリック時の URL"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "色"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Mac OS X 10.8 以降でのみ動作します。また、/usr/local/bin/terminal-notifier に"
"ローカルでアクセスできる必要があります。"

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "MacOSX 通知"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "開く、またはクリックする URL"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Terminal-Notifier のバージョン"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "送信者"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "返信先"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "ドメイン"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "送信者名"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "メールのヘッダー"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "公開範囲"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "隠しテキスト"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "言語コード"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "結果をキャッシュする"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "取り扱いに注意する添付ファイル"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "ユーザーまたはタグにメンション"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "ユーザー"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "宛先のチャンネル ID"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "メッセージの最大分割数"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "カスタムの参照番号"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "宛先のキュー"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "クライアント ID"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "セッションを使う"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "メッセージを保持する"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "テンプレートの ID"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "認証キー"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "短縮 URL"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "テンプレートの対応付け"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "URL の接頭辞"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "ルームの ID"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "サイレント通知"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Discord のイベント ID"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "ソース"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "プロジェクトの ID"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "メッセージフック"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "IRC の色"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "接頭辞"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "キャンペーン名"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "テンプレート名"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "クライアントの参照番号"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "高品質"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "FAX のヘッダー"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "添付ファイル"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "添付ファイルの名前"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "遅延"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "メール"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "アクション"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "認証の種類"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "API のログイン名"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "返信を受け付ける"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "用途"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "テナントのドメイン"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "アカウントのメールまたはオブジェクト ID"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "クライアントシークレット"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "送信済みアイテムに保存"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "テンプレート"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "宛先のプレーヤー ID"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "セグメントを含める"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "サブタイトル"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "言語"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "本文を有効にする"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "テンプレート引数をデコードする"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "カスタムデータ"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "ポストバックデータ"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "宛先のユーザー ID"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "宛先のグループ ID"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "コンポーネント"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "クラス"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "重大度"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "カスタムの詳細"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "連携の ID"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "サードパーティーの ID"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Meta の追加項目"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "マスターキー"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "端末"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "名前空間"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "バッジ"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "メッセージの種類"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "宛先の ID"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "宛先の SMS"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "チャンネル"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "認証 ID"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "認証トークン"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "プロバイダーのキー"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "通知キー"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "アプリケーションキー"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "アプリケーションシークレット"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "シークレットキー"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "ステータスを表示"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "ユーザーキー"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "URL のタイトル"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "緊急通知の再試行間隔"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "有効期限"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "ユーザートークン"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "グループのトピック"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "チャンネル"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Webhook の名前"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "秘密鍵"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "バイブレーション"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "情報レベル"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "成功レベル"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "警告レベル"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "失敗レベル"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "シークレット API キー"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "宛先のトピック"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "アプリケーションの ID"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "宛先のサブレディット"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "種別"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "フレアの ID"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "フレアのテキスト"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "広告ですか？"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "返信を送る"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "ネタバレを含む"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "再投稿フラグ"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "送信元アドレス"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "チャンネルの ID"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "埋め込む URL"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "トークンまたはパスワード"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "環境"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "認証モード"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "宛先のルーム ID"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Webhook モード"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "アバターを使う"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "ファシリティー"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "PID を記録する"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "組織"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "テンプレートのデータ"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "送信者名"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "セッショントークン"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "アクセスキー ID"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "シークレットアクセスキー"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "宛先のメールアドレス"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "フラッシュ"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "ラベル"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "サービス ID"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "サービスのパスワード"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "スペースの ID"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "受信者の電話番号"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "メディアの種類"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "タイムアウト"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "読み上げ音声"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "クライアントキー"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "重要な通知"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "サービス"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "場所"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "通知シナリオ"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "フィルタリング"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "外部 ID"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "ステータス"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "宛先のメンバー"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "共有"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "タグ"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "宛先のショートコード"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "OAuth アクセストークン"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "トークン A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "トークン B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "トークン C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "エンコードされた宛先 ID"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "ワークフローのパス"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "フッターを含める"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "ブロックを使う"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "タイムスタンプを含める"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "メッセージのモード"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "ホスト"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "ログイン名"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "文字を転写する"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "宛先の連絡先"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "テストのみ"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "ゲートウェイ"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "公開鍵"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "シード"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "ルーム"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "宛先のルーティングキー"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "エンティティーの ID"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "アラートの種類"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "画像のリンク"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "音声のリンク"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "特別なテキストの色"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "金額"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "通貨"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "名前"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "識別子"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "アップロード"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "STDERR に記録する"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "宛先のチャット ID"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "ボットの所有者を検出する"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "ウェブページのプレビュー"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "写真/動画の添付ファイルをまとめる"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "トピックのスレッド ID"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Markdown のバージョン"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "本文の配置"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "リッチメッセージのテンプレートのパス"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "メッセージプロファイルの ID"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "ゲートウェイの ID"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "宛先の Threema ID"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "API のホスト名"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "画像の URL"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "イベントの種類"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "優先度 (Pushover 互換)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "通知方法: sms または通話"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "コンシューマーキー"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "コンシューマーシークレット"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "アクセスシークレット"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "認証トークン"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "受信者の ID"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "ボットのアバターの URL"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "ユーザーのメールアドレス"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "ボットのアクセストークン"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "ルームの ID"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "企業の ID"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "アプリのシークレット"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "エージェントの ID"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "宛先の部署"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "宛先のタグ"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "ボットの Webhook キー"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "送信元の電話 ID"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "ローカルの Microsoft Windows 環境が必要です。"

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "ワークフローの ID"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "署名"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Power Automate の URL を使う"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Power Automate のルーティング ID"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "テキストを折り返す"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "API のバージョン"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "トピック"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "グループまたはオプションのコード"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "アプリのトークン"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "トークンまたはキー"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "情報の優先度"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "成功の優先度"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "警告の優先度"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "失敗の優先度"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "リンクのラベル"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "検証トークン"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "宛先のストリーム"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"AMQP 0.9.1 には pika を、AMQP 1.0 には python-qpid-proton を、または両方をイ"
"ンストールしてください。"

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "エクスチェンジ"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "仮想ホスト"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "永続化"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "必須"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "有効期間 (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "メッセージヘッダー"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "SMTP サーバー"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "セキュアモード"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "PGP のセキュリティーモード"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "PGP 公開鍵のパス"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "PGP 秘密鍵のパス"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "ウェブ鍵ディレクトリー"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "本文に埋め込む添付ファイル"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "受信者のメールアドレス"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "OAuth2 のキーファイル"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "カスタム画像の URL"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "通知の色"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "本名"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "ニックネーム"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "チャンネルに参加する"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "認証モード"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "宛先のルームエイリアス"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "サーバーの検出"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "ルーム ID にホームサーバーを強制する"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Matrix API のバージョン"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "エンドツーエンド暗号化"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "端末の自動検証"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "PEM 形式の秘密鍵ファイル"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "購読ファイル"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "XMPP サーバー"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "連絡先一覧を取得する"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "件名を使う"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "接続を維持する"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "MUC のニックネーム"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "SCRAM-PLUS のチャネルバインディング"
caronc-apprise-dfec414/apprise/i18n/ko/000077500000000000000000000000001526720371000177525ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/ko/LC_MESSAGES/000077500000000000000000000000001526720371000215375ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/ko/LC_MESSAGES/apprise.po000066400000000000000000002025221526720371000235450ustar00rootroot00000000000000# Korean translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: ko\n"
"Language-Team: ko \n"
"Plural-Forms: nplurals=1; plural=0;\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "SSL 확인"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "리디렉션 따라가기"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "소켓 읽기 제한 시간"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "소켓 연결 제한 시간"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "캐시 유효 기간"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "강제 지정할 MIME 형식"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "강제 지정할 파일 이름"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "로컬 파일"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "웹 기반"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "메모리"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "스키마"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "의존성이 없습니다."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "작동하려면 패키지가 필요합니다."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "기능을 높이려면 패키지 설치를 권장합니다."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "앱 사용자 이름"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "API 키"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "대상 전화"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "대상"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "보내는 사람"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "SMS 모드"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "일괄 모드"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "호스트 이름"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "포트"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "사용자 이름"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "비밀번호"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "토큰"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "태그"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "질의 방식"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Apprise API 버전"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "HTTP 헤더"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "사용자 이름"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "대상 호출 부호"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "재전송 지연 시간"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "지역 설정"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "대상 기기"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "소리"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "수준"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "음량"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "클릭"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "배지"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "분류"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "그룹"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "이미지 포함"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "아이콘 URL"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "통화"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "암호화 키"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "초과 시 처리 방식"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "알림 형식"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "이모지 해석"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "영구 저장소"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "시간대"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "서비스 재시도 횟수"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "재시도 간 대기 시간"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "선택 서비스"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "보내는 이메일"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "대상 팀"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "에스컬레이션 정책"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "알림 방법"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "팀 대기 시간"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "일련번호"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "지속 시간 (밀리초)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "페이드 시간 (밀리초)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "LED 번호"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "원본 이메일"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "대상 이메일"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "회신 이메일"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "참조"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "숨은 참조"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "시크릿"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "대상 전화번호"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "대상 그룹"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "보내는 전화번호"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "라우팅 그룹"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "유니코드 문자"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "API 시크릿"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "발신자 ID"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "국가"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "유효 기간"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "API 토큰"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "웹후크 토큰"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "봇 이름"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "대상 채널"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "대상 봇"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "지역"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "회사 ID"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "브로드캐스트"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "가져오기 방식"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "첨부 파일 이름"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "페이로드 추가 항목"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "GET 매개변수"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "API 액세스 토큰"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "발신 주소"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "우선순위"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "송신기 그룹"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "libdbus-1.so.x가 설치되어 있어야 합니다."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "DBus 알림"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "긴급도"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "X축"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Y축"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "웹후크 ID"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "음성 읽기"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "아바타 이미지"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "아바타 URL"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "스레드 ID"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "꼬리말 표시"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "꼬리말 로고"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "필드 사용"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Discord 플래그"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "사용자 또는 역할 멘션"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "템플릿 경로"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "첨부 파일 묶어 보내기"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "템플릿 토큰"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "기기 일련번호"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "API 모드"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "지금 새로 고침"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "텍스트 서명"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Base64 아이콘 (텍스트 API)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Base64 이미지 (이미지 API)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "링크"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "테두리"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "디더링 방식"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "디더링 커널"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "작업 키"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "모달"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "경로"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "서버 제한 시간"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "인스턴스 이름"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "계정 SID"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "보내는 전화번호 또는 발신자 ID"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "지역 이름"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "액세스 키"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "받는 사용자 ID"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "받는 채널 ID"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "웹후크 경로"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "모드"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "스레드 이름"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "API 사용자 이름"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "API 비밀번호"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "액세스 토큰"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "소유자"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "저장소"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "형식"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "번호"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "레이블 목록"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "담당자"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "libdbus-1.so.x 또는 libdbus-2.so.x가 설치되어 있어야 합니다."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "GLib 알림"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "로컬 Gnome 환경이 필요합니다."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Gnome 알림"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "연동 키 목록"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "동작"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "중복 제거 키"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "메타데이터"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "작업 공간"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "웹후크 키"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "스레드 키"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "플랫폼"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "주제"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "데이터 항목"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "봇 ID"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "버전"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "고정"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "장기 액세스 토큰"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "알림 ID"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "경로 접두사"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "토큰 또는 사용자 이름"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "이벤트"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "토큰 추가"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "토큰 삭제"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "연동 키"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "경로 설정"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "알림 소스 ID"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "대상 에스컬레이션"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "대상 일정"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "대상 사용자"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "대상 "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "엔티티"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "별칭"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "세부 정보"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "동작 매핑"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "기기 ID"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "기기 이름"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "원본 전화번호"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "지속 시간"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "서버 키"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "기기 API 키"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "앱 ID"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "앱 버전"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "앱 액세스 토큰"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "사용자 지정 아이콘"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "아이콘 형식"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "반복 횟수"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "봇 토큰"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "클릭 URL"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "색"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Mac OS X 10.8 이상에서만 작동합니다. 또한 /usr/local/bin/terminal-notifier에 "
"로컬로 접근할 수 있어야 합니다."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "MacOSX 알림"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "열기 또는 클릭 URL"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Terminal-Notifier 버전"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "발신자"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "회신 주소"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "도메인"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "보내는 사람 이름"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "이메일 헤더"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "공개 범위"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "가려진 텍스트"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "언어 코드"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "결과 캐시에 저장"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "민감한 첨부 파일"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "사용자 또는 태그 멘션"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "사용자"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "대상 채널 ID"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "최대 메시지 분할 수"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "사용자 지정 참조"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "대상 대기열"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "클라이언트 ID"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "세션 사용"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "메시지 보관"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "템플릿 ID"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "인증 키"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "짧은 URL"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "템플릿 매핑"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "URL 접두사"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "방 ID"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "무음 알림"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Discord 이벤트 ID"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "원본"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "프로젝트 ID"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "메시지 후크"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "IRC 색상"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "접두사"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "캠페인 이름"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "템플릿 이름"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "클라이언트 참조"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "고품질"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "팩스 헤더"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "첨부 파일"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "첨부 파일 이름"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "지연"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "이메일"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "동작"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "인증 방식"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "API 로그인 이름"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "회신 받기"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "용도"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "테넌트 도메인"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "계정 이메일 또는 객체 ID"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "클라이언트 시크릿"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "보낸 항목에 저장"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "템플릿"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "대상 플레이어 ID"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "세그먼트 포함"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "부제목"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "언어"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "내용 사용"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "템플릿 인수 디코딩"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "사용자 지정 데이터"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "포스트백 데이터"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "대상 사용자 ID"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "대상 그룹 ID"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "구성 요소"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "클래스"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "심각도"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "사용자 지정 세부 정보"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "연동 ID"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "서드파티 ID"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Meta 추가 항목"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "마스터 키"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "기기"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "이름 공간"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "배지"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "메시지 형식"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "대상 ID"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "대상 SMS"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "채널"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "인증 ID"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "인증 토큰"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "공급자 키"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "알림 키"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "애플리케이션 키"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "애플리케이션 시크릿"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "비밀 키"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "상태 표시"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "사용자 키"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "URL 제목"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "긴급 재시도 간격"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "만료"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "사용자 토큰"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "그룹 주제"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "채널"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "웹후크 이름"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "개인 키"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "진동"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "정보 수준"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "성공 수준"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "경고 수준"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "실패 수준"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "비밀 API 키"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "대상 주제"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "애플리케이션 ID"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "대상 서브레딧"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "종류"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "플레어 ID"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "플레어 텍스트"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "광고입니까?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "회신 보내기"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "스포일러 포함"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "재등록 플래그"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "보내는 주소"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "채널 ID"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "임베드 URL"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "토큰 또는 비밀번호"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "환경"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "인증 모드"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "웹후크"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "대상 방 ID"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "웹후크 모드"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "아바타 사용"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "퍼실리티"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "PID 기록"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "조직"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "템플릿 데이터"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "발신자 이름"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "세션 토큰"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "액세스 키 ID"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "비밀 액세스 키"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "대상 이메일 주소"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "플래시"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "레이블"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "서비스 ID"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "서비스 비밀번호"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "스페이스 ID"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "수신자 전화번호"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "미디어 형식"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "제한 시간"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "음성 읽기 목소리"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "클라이언트 키"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "중요 알림"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "서비스"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "위치"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "알림 시나리오"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "필터링"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "외부 ID"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "상태"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "대상 구성원"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "공유"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "태그"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "대상 단축 번호"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "OAuth 액세스 토큰"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "토큰 A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "토큰 B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "토큰 C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "인코딩된 대상 ID"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "워크플로 경로"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "꼬리말 포함"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "블록 사용"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "타임스탬프 포함"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "메시지 모드"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "호스트"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "로그인 이름"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "음역"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "대상 연락처"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "테스트만"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "게이트웨이"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "공개 키"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "시드"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "방"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "대상 라우팅 키"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "엔티티 ID"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "알림 종류"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "이미지 링크"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "소리 링크"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "특별 텍스트 색"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "금액"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "통화"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "이름"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "식별자"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "업로드"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "STDERR에 기록"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "대상 대화 ID"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "봇 소유자 확인"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "웹 페이지 미리 보기"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "사진/동영상 첨부 파일 묶기"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "주제 스레드 ID"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Markdown 버전"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "내용 배치"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "서식 있는 메시지 템플릿 경로"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "메시지 프로필 ID"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "게이트웨이 ID"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "대상 Threema ID"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "API 호스트 이름"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "이미지 URL"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "이벤트 종류"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "우선순위 (Pushover 호환)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "알림 방식: sms 또는 통화"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "컨슈머 키"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "컨슈머 시크릿"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "액세스 시크릿"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "인증 토큰"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "수신자 ID"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "봇 아바타 URL"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "사용자 이메일"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "봇 액세스 토큰"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "방 ID"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "기업 ID"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "앱 시크릿"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "에이전트 ID"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "대상 부서"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "대상 태그"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "봇 웹후크 키"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "보내는 전화 ID"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "로컬 Microsoft Windows 환경이 필요합니다."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "워크플로 ID"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "서명"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Power Automate URL 사용"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Power Automate 라우팅 ID"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "텍스트 줄바꿈"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "API 버전"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "주제"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "그룹 또는 옵션 코드"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "앱 토큰"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "토큰 또는 키"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "정보 우선순위"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "성공 우선순위"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "경고 우선순위"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "실패 우선순위"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "링크 레이블"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "확인 토큰"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "대상 스트림"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"AMQP 0.9.1에는 pika를, AMQP 1.0에는 python-qpid-proton을, 또는 둘 다 설치하세"
"요."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "익스체인지"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "가상 호스트"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "영구 저장"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "필수"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "유효 기간 (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "메시지 헤더"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "SMTP 서버"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "보안 모드"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "PGP 보안 모드"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "PGP 공개 키 경로"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "PGP 개인 키 경로"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "웹 키 디렉터리"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "본문에 넣는 첨부 파일"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "받는 이메일"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "OAuth2 키 파일"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "사용자 지정 이미지 URL"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "알림 색"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "실제 이름"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "별명"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "채널 참가"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "인증 모드"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "대상 방 별칭"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "서버 탐색"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "방 ID에 홈 서버 강제 적용"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Matrix API 버전"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "종단 간 암호화"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "기기 자동 확인"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "PEM 개인 키 파일"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "구독 파일"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "XMPP 서버"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "연락처 목록 가져오기"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "제목 사용"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "연결 유지"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "MUC 별명"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "SCRAM-PLUS 채널 바인딩"
caronc-apprise-dfec414/apprise/i18n/ms/000077500000000000000000000000001526720371000177605ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/ms/LC_MESSAGES/000077500000000000000000000000001526720371000215455ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/ms/LC_MESSAGES/apprise.po000066400000000000000000002013611526720371000235530ustar00rootroot00000000000000# Malay translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: ms\n"
"Language-Team: ms \n"
"Plural-Forms: nplurals=1; plural=0;\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "Sahkan SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Ikut pengalihan"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Had masa bacaan soket"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Had masa sambungan soket"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Usia cache"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Jenis MIME yang dipaksa"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Nama fail yang dipaksa"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Fail tempatan"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Berasaskan web"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Memori"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Skema"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Tiada kebergantungan."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "Pakej diperlukan untuk berfungsi."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "Pakej disyorkan untuk menambah baik kefungsian."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "Nama pengguna aplikasi"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "Kunci API"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Telefon sasaran"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Sasaran"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Penghantar"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "Mod SMS"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Mod berkelompok"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Nama hos"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Port"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Nama pengguna"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Kata laluan"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Token"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Tanda"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Kaedah pertanyaan"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Versi API Apprise"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "Pengepala HTTP"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Nama pengguna"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Tanda panggilan sasaran"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Lengah hantar semula"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Tetapan setempat"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Peranti sasaran"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Bunyi"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Tahap"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Kelantangan"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Klik"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Lencana"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Kategori"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Kumpulan"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Sertakan imej"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "URL ikon"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Panggilan"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Kunci penyulitan"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Mod limpahan"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Format pemberitahuan"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Tafsir emoji"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Storan kekal"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Zon waktu"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Cubaan semula perkhidmatan"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Tunggu antara cubaan"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Perkhidmatan pilihan"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "E-mel penghantar"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Pasukan sasaran"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Polisi Eskalasi"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Kaedah Amaran"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Masa Menunggu Pasukan"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Nombor siri"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Tempoh (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Masa pudar (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "Nombor LED"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "E-mel sumber"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "E-mel sasaran"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "E-mel untuk balasan"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Salinan"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Salinan tersembunyi"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Rahsia"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Nombor telefon sasaran"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Kumpulan sasaran"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Nombor telefon penghantar"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Kumpulan penghalaan"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Aksara Unicode"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "Rahsia API"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "ID penghantar"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "Negara"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "kesahan"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "Token API"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Token webhook"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Nama bot"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Saluran sasaran"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Bot sasaran"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Wilayah"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "ID syarikat"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "Siaran"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Kaedah pengambilan"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Lampirkan fail sebagai"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Tambahan muatan"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "Parameter GET"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "Token akses API"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Alamat asal"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Keutamaan"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Kumpulan pemancar"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "libdbus-1.so.x mesti dipasang."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "Pemberitahuan DBus"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Tahap desakan"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "Paksi X"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Paksi Y"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "ID webhook"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Teks ke pertuturan"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Imej avatar"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "URL avatar"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "ID bebenang"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Tunjukkan pengaki"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Logo pengaki"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Guna medan"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Bendera Discord"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Sebut pengguna atau peranan"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Laluan templat"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Gabungkan lampiran"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Token templat"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Nombor siri peranti"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "Mod API"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Muat semula sekarang"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Tandatangan teks"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Ikon dalam Base64 (API teks)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Imej dalam Base64 (API imej)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Pautan"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Sempadan"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Jenis dithering"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Kernel dithering"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Kunci tugas"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Modal"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Laluan"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Had masa pelayan"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Nama tika"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "SID akaun"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Nombor telefon penghantar atau ID penghantar"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Nama wilayah"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Kunci akses"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "Ke ID pengguna"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "Ke ID saluran"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Laluan webhook"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Mod"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Nama bebenang"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "Nama pengguna API"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "Kata laluan API"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Token akses"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Pemilik"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Repositori"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Jenis"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Nombor"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Label-label"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Penerima tugasan"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "libdbus-1.so.x atau libdbus-2.so.x mesti dipasang."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "Pemberitahuan GLib"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "Persekitaran Gnome tempatan diperlukan."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Pemberitahuan Gnome"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Kunci-kunci penyatuan"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Tindakan"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Kunci nyahduplikasi"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Metadata"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Ruang kerja"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Kunci webhook"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Kunci bebenang"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Platform"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Topik"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Entri data"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "ID bot"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Versi"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Disematkan"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Token akses jangka panjang"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "ID pemberitahuan"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Awalan laluan"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Token atau nama pengguna"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Peristiwa"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Tambah token"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Buang token"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Kunci penyatuan"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Laluan penghantaran"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "ID Sumber Amaran"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Peningkatan sasaran"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Jadual sasaran"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Pengguna sasaran"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Sasaran "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Entiti"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Alias"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Perincian"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Pemetaan tindakan"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "ID peranti"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Nama peranti"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Nombor telefon sumber"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Tempoh"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Kunci pelayan"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Kunci API peranti"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "ID aplikasi"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "Versi aplikasi"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "Token akses aplikasi"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Ikon tersuai"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Jenis ikon"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Kitaran"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Token bot"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "URL klik"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Warna"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Hanya berfungsi dengan Mac OS X 10.8 dan lebih baru. Selain itu, /usr/local/"
"bin/terminal-notifier mesti boleh dicapai secara tempatan."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "Pemberitahuan MacOSX"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "URL untuk dibuka atau diklik"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Versi Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Penghantar"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Balas kepada"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Domain"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Nama penghantar"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "Pengepala e-mel"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Keterlihatan"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Teks tersembunyi"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Kod bahasa"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Simpan hasil dalam cache"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Lampiran sensitif"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Sebut pengguna atau tanda"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "Pengguna"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "ID saluran sasaran"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Bilangan maksimum bahagian mesej"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Rujukan tersuai"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Baris gilir sasaran"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "ID klien"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Guna sesi"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Simpan mesej"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "ID templat"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Kunci pengesahan"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "URL pendek"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Pemetaan templat"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "Awalan URL"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "ID bilik"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Pemberitahuan senyap"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "ID peristiwa Discord"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Sumber"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "ID projek"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Cangkuk mesej"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "Warna IRC"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Awalan"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Nama kempen"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Nama templat"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Rujukan klien"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Kualiti tinggi"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Pengepala faks"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Lampiran"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Nama fail lampiran"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Lengah"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "E-mel"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Tindakan"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Jenis pengesahan"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "Nama masuk API"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Terima balasan"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Tujuan"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Domain penyewa"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "E-mel akaun atau ID objek"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Rahsia klien"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Simpan dalam item dihantar"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Templat"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "ID pemain sasaran"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Sertakan segmen"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Sari kata"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Bahasa"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Bolehkan kandungan"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Nyahkod argumen templat"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Data tersuai"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Data maklum balas"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "ID pengguna sasaran"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "ID kumpulan sasaran"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Komponen"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Kelas"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Tahap keterukan"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Perincian tersuai"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "ID penyatuan"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "ID pihak ketiga"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Tambahan Meta"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Kunci induk"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Peranti"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Ruang nama"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Lencana"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Jenis mesej"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "ID sasaran"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "SMS sasaran"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Saluran"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "ID pengesahan"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Token pengesahan"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Kunci penyedia"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Kunci pemberitahuan"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Kunci aplikasi"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Rahsia aplikasi"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Kunci rahsia"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Tunjukkan status"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Kunci pengguna"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "Tajuk URL"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Selang cubaan semula kecemasan"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Luput"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Token pengguna"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Topik kumpulan"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Saluran"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Nama webhook"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Kunci peribadi"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Getaran"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Tahap maklumat"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Tahap kejayaan"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Tahap amaran"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Tahap kegagalan"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Kunci API rahsia"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Topik sasaran"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "ID aplikasi"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Subreddit sasaran"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Jenis kandungan"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "ID flair"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Teks flair"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "Adakah iklan?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Hantar balasan"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "Mengandungi spoiler"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Bendera hantar semula"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Alamat penghantar"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "ID saluran"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "URL terbenam"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Token atau kata laluan"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Persekitaran"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Mod pengesahan"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "ID bilik sasaran"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Mod webhook"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Guna avatar"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Kemudahan"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "Rekod PID"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Organisasi"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Data templat"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Nama penghantar"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Token sesi"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "ID kunci akses"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Kunci akses rahsia"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "E-mel sasaran"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Denyar"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Label"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "ID perkhidmatan"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Kata laluan perkhidmatan"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "ID ruang"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Nombor telefon penerima"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Jenis media"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Had masa"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Suara teks ke pertuturan"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Kunci klien"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Pemberitahuan kritikal"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Perkhidmatan"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Lokasi"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Senario amaran"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Penapisan"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "ID luaran"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Status"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Ahli Sasaran"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Dikongsi"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Tag"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Kod pendek sasaran"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "Token akses OAuth"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Token A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Token B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Token C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "ID terkod sasaran"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Laluan aliran kerja"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Sertakan pengaki"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Guna blok"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Sertakan cap masa"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Mod mesej"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Hos"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Nama masuk"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Alih huruf"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Kenalan sasaran"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Ujian sahaja"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Get laluan"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Kunci awam"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Benih"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Bilik"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Kunci penghalaan sasaran"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "ID entiti"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Jenis amaran"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Pautan imej"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Pautan bunyi"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Warna teks khas"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Jumlah"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Mata wang"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Nama"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Pengenal"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Muat naik"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Rekod ke STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "ID sembang sasaran"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Kesan pemilik bot"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Pratonton halaman web"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Kumpulkan lampiran foto/video"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "ID bebenang topik"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Versi Markdown"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Penempatan kandungan"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Laluan templat mesej berformat"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "ID profil pemesejan"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "ID get laluan"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "ID Threema sasaran"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "Nama hos API"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "URL imej"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Jenis peristiwa"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Keutamaan (keserasian Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Kaedah pemberitahuan: sms atau panggilan"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Kunci pengguna API"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Rahsia pengguna API"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Rahsia akses"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Token pengesahan"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "ID penerima"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "URL avatar bot"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "E-mel pengguna"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Token akses bot"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "ID bilik"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "ID syarikat"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "Rahsia aplikasi"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "ID ejen"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Bahagian sasaran"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Tanda sasaran"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Kunci webhook bot"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "ID telefon penghantar"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "Persekitaran Microsoft Windows tempatan diperlukan."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "ID aliran kerja"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Tandatangan"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Guna URL Power Automate"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "ID penghalaan Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Balut teks"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "Versi API"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Topik"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Kod kumpulan atau pilihan"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "Token aplikasi"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Token atau kunci"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Keutamaan maklumat"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Keutamaan kejayaan"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Keutamaan amaran"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Keutamaan kegagalan"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Label pautan"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Token pengesahan"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Strim sasaran"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"Pasang pika untuk AMQP 0.9.1, python-qpid-proton untuk AMQP 1.0, atau kedua-"
"duanya."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Exchange"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Hos Maya"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Kekal"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Wajib"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Tempoh Hayat (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Pengepala Mesej"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "Pelayan SMTP"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Mod selamat"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "Mod keselamatan PGP"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "Laluan kunci awam PGP"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "Laluan kunci peribadi PGP"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Direktori kunci web"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Lampiran terbenam"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "E-mel penerima"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "Fail kunci OAuth2"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "URL imej tersuai"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Warna pemberitahuan"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Nama sebenar"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Nama panggilan"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Sertai saluran"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Mod pengesahan"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Alias bilik sasaran"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Penemuan pelayan"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Paksa pelayan asal pada ID bilik"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Versi API Matrix"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "Penyulitan hujung ke hujung"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Pengesahan peranti automatik"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "Fail kunci peribadi PEM"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "Fail langganan"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "Pelayan XMPP"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Dapatkan senarai kenalan"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Guna subjek"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Kekalkan sambungan"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "Nama panggilan MUC"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "Pengikatan saluran SCRAM-PLUS"
caronc-apprise-dfec414/apprise/i18n/nl/000077500000000000000000000000001526720371000177525ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/nl/LC_MESSAGES/000077500000000000000000000000001526720371000215375ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/nl/LC_MESSAGES/apprise.po000066400000000000000000002026661526720371000235560ustar00rootroot00000000000000# Dutch translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: nl\n"
"Language-Team: nl \n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "SSL verifiëren"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Omleidingen volgen"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Time-out voor lezen van socket"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Time-out voor verbinden van socket"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Ouderdom van de cache"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Afgedwongen MIME-type"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Afgedwongen bestandsnaam"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Lokaal bestand"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Op het web"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Geheugen"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Schema"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Geen afhankelijkheden."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "Er zijn pakketten nodig om te werken."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "Pakketten worden aanbevolen om de functionaliteit te verbeteren."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "Gebruikersnaam van de app"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "API-sleutel"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Doeltelefoon"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Doelen"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Afzender"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "SMS-modus"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Batchmodus"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Hostnaam"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Poort"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Gebruikersnaam"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Wachtwoord"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Token"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Labels"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Opvraagmethode"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Versie van de Apprise-API"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "HTTP-header"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Gebruikersnaam"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Doelroepnaam"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Vertraging voor opnieuw verzenden"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Landinstelling"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Doelapparaat"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Geluid"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Niveau"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Volume"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Klik"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Badge"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Categorie"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Groep"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Afbeelding toevoegen"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "Pictogram-URL"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Oproep"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Versleutelingssleutel"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Overloopmodus"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Meldingsopmaak"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Emoji's interpreteren"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Blijvende opslag"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Tijdzone"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Nieuwe pogingen van de dienst"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Wachttijd tussen pogingen"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Optionele dienst"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "E-mailadres van de afzender"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Doelteam"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Escalatiebeleid"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Waarschuwingsmethoden"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Wachttijd team"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Serienummer"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Duur (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Overvloeitijd (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "Lednummer"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Bron-e-mailadres"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Doel-e-mailadres"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "E-mailadres voor antwoorden"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Kopie"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Blinde kopie"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Geheim"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Doeltelefoonnummer"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Doelgroep"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Telefoonnummer van de afzender"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Routeringsgroep"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Unicode-tekens"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "API-geheim"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "Afzender-id"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "Land"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "geldigheid"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "API-token"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Webhook-token"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Botnaam"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Doelkanaal"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Doelbot"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Regio"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "Bedrijfs-ID"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "Uitzenden"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Ophaalmethode"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Bestand bijvoegen als"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Extra's voor de payload"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "GET-parameters"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "API-toegangstoken"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Oorsprongsadres"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Prioriteit"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Zendergroepen"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "libdbus-1.so.x moet geïnstalleerd zijn."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "DBus-melding"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Urgentie"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "X-as"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Y-as"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "Webhook-id"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Tekst-naar-spraak"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Avatarafbeelding"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "Avatar-URL"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "Draad-id"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Voettekst weergeven"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Logo in de voettekst"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Velden gebruiken"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Discord-vlaggen"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Gebruikers of rollen vermelden"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Pad naar het sjabloon"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Bijlagen samenvoegen"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Sjabloontokens"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Serienummer van het apparaat"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "API-modus"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Nu vernieuwen"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Tekstondertekening"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Pictogram in Base64 (tekst-API)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Afbeelding in Base64 (afbeeldings-API)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Koppeling"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Rand"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Type rasteren"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Kern voor rasteren"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Taaksleutel"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Modaal"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Pad"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Time-out van de server"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Naam van de instantie"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "SID van het account"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Telefoonnummer van de afzender of afzender-id"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Naam van de regio"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Toegangssleutel"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "Naar gebruikers-id"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "Naar kanaal-id"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Pad naar de webhook"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Modus"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Naam van de draad"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "API-gebruikersnaam"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "API-wachtwoord"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Toegangstoken"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Eigenaar"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Repository"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Type"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Nummer"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Labels"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Toegewezen personen"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "libdbus-1.so.x of libdbus-2.so.x moet geïnstalleerd zijn."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "GLib-melding"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "Er is een lokale Gnome-omgeving vereist."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Gnome-melding"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Integratiesleutels"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Actie"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Ontdubbelingssleutel"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Metagegevens"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Werkruimte"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Webhook-sleutel"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Draadsleutel"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Platform"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Onderwerp"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Gegevensvermeldingen"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "Bot-id"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Versie"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Vastgezet"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Langlevend toegangstoken"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "Meldings-id"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Voorvoegsel van het pad"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Token of gebruikersnaam"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Gebeurtenissen"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Tokens toevoegen"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Tokens verwijderen"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Integratiesleutel"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Route"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "Waarschuwingsbron-ID"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Doelescalatie"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Doelschema"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Doelgebruiker"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Doelen "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Entiteit"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Alias"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Details"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Actietoewijzing"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "Apparaat-id"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Apparaatnaam"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Telefoonnummer van de bron"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Duur"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Serversleutel"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "API-sleutel van het apparaat"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "App-id"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "Versie van de app"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "Toegangstoken van de app"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Eigen pictogram"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Type pictogram"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Cycli"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Bottoken"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "URL van de klik"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Kleur"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Werkt alleen met Mac OS X 10.8 en nieuwer. Daarnaast moet /usr/local/bin/"
"terminal-notifier lokaal beschikbaar zijn."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "MacOSX-melding"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "URL om te openen of aan te klikken"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Versie van Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Afzender"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Antwoorden naar"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Domein"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Naam van de afzender"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "E-mailheader"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Zichtbaarheid"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Verborgen tekst"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Taalcode"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Resultaten in de cache bewaren"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Gevoelige bijlagen"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Gebruikers of labels vermelden"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "Gebruiker"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "Id van het doelkanaal"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Maximaal aantal berichtdelen"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Eigen referentie"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Doelwachtrij"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "Client-id"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Een sessie gebruiken"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Berichten bewaren"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "Sjabloon-id"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Verificatiesleutel"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "Korte URL"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Sjabloontoewijzing"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "Voorvoegsel van de URL"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "Kamer-id"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Stille melding"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Id van de Discord-gebeurtenis"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Bron"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "Project-id"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Berichthook"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "IRC-kleuren"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Voorvoegsel"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Naam van de campagne"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Naam van het sjabloon"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Clientreferentie"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Hoge kwaliteit"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Faxheader"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Bijlage"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Bestandsnaam van de bijlage"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Vertraging"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "E-mail"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Acties"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Type verificatie"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "API-aanmeldnaam"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Antwoorden aanvaarden"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Doel"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Tenantdomein"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "E-mailadres van het account of object-id"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Clientgeheim"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Opslaan in verzonden items"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Sjabloon"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "Id van de doelspeler"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Segment toevoegen"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Ondertitel"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Taal"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Inhoud inschakelen"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Sjabloonargumenten decoderen"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Eigen gegevens"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Terugkoppelingsgegevens"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "Id van de doelgebruiker"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "Id van de doelgroep"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Onderdeel"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Klasse"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Ernst"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Eigen details"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "Integratie-id"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "Id van derden"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Meta-extra's"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Hoofdsleutel"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Apparaat"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Naamruimte"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Badges"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Berichttype"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "Doel-id"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "Doel-sms"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Kanalen"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "Verificatie-id"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Verificatietoken"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Sleutel van de aanbieder"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Meldingssleutel"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Toepassingssleutel"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Toepassingsgeheim"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Geheime sleutel"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Status weergeven"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Gebruikerssleutel"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "Titel van de URL"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Interval voor noodherhaling"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Verloopt"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Gebruikerstoken"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Groepsonderwerpen"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Kanaal"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Naam van de webhook"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Privésleutel"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Trillen"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Informatieniveau"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Succesniveau"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Waarschuwingsniveau"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Foutniveau"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Geheime API-sleutel"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Doelonderwerp"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "Toepassings-id"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Doelsubreddit"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Soort"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "Flair-id"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Flairtekst"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "Is dit een advertentie?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Antwoorden verzenden"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "Bevat een spoiler"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Vlag voor opnieuw verzenden"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Adres van de afzender"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "Kanaal-id"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "Ingesloten URL"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Token of wachtwoord"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Omgeving"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Verificatiemodus"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "Id van de doelkamer"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Webhookmodus"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Avatar gebruiken"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Voorziening"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "PID vastleggen"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Organisatie"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Sjabloongegevens"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Naam van de afzender"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Sessietoken"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "Id van de toegangssleutel"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Geheime toegangssleutel"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Doel-e-mailadressen"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Flits"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Label"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "Dienst-id"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Wachtwoord van de dienst"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "Ruimte-id"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Telefoonnummer van de ontvanger"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Mediatype"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Time-out"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Stem voor tekst-naar-spraak"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Clientsleutel"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Kritieke melding"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Dienst"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Locatie"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Waarschuwingsscenario"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Filteren"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "Externe id"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Status"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Doellid"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Gedeeld"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Label"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Doelkortcode"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "OAuth-toegangstoken"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Token A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Token B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Token C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "Gecodeerde doel-id"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Pad naar de werkstroom"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Voettekst toevoegen"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Blokken gebruiken"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Tijdstempel toevoegen"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Berichtmodus"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Host"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Aanmeldnaam"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Translitereren"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Doelcontact"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Alleen testen"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Gateway"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Openbare sleutel"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Startwaarde"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Kamers"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Routeringssleutel van het doel"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "Entiteit-id"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Type waarschuwing"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Koppeling naar de afbeelding"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Koppeling naar het geluid"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Bijzondere tekstkleur"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Bedrag"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Valuta"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Naam"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Identificatie"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Uploaden"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Vastleggen in STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "Id van de doelchat"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Eigenaar van de bot opsporen"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Voorbeeld van de webpagina"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Foto-/videobijlagen groeperen"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "Draad-id van het onderwerp"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Markdown-versie"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Plaatsing van de inhoud"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Pad naar het sjabloon voor opgemaakte berichten"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "Id van het berichtenprofiel"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "Gateway-id"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "Threema-id van het doel"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "API-hostnaam"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "URL van de afbeelding"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Type gebeurtenis"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Prioriteit (compatibel met Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Meldingsmethode: sms of oproep"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Consumersleutel"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Consumergeheim"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Toegangsgeheim"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Verificatietoken"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "Id's van de ontvangers"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "Avatar-URL van de bot"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "E-mailadres van de gebruiker"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Toegangstoken van de bot"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "Kamer-id's"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "Bedrijfs-id"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "Appgeheim"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "Agent-id"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Doelafdeling"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Doellabel"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Webhook-sleutel van de bot"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "Id van de telefoon van de afzender"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "Er is een lokale Microsoft Windows-omgeving vereist."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "Werkstroom-id"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Ondertekening"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Power Automate-URL gebruiken"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Routerings-id van Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Tekst afbreken"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "API-versie"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Onderwerpen"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Groeps- of optiecode"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "Apptoken"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Token of sleutel"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Prioriteit voor informatie"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Prioriteit voor successen"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Prioriteit voor waarschuwingen"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Prioriteit voor fouten"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Label van de koppeling"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Verificatietoken"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Doelstroom"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"Installeer pika voor AMQP 0.9.1, python-qpid-proton voor AMQP 1.0, of beide."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Exchange"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Virtuele host"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Persistent"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Verplicht"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Levensduur (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Berichtheaders"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "SMTP-server"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Beveiligde modus"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "PGP-beveiligingsmodus"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "Pad naar de openbare PGP-sleutel"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "Pad naar de privé-PGP-sleutel"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Map met websleutels"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Ingesloten bijlagen"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "E-mailadres van de ontvanger"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "OAuth2-sleutelbestand"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "Eigen afbeeldings-URL"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Kleur van de melding"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Echte naam"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Bijnaam"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Kanalen binnengaan"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Verificatiemodus"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Alias van de doelkamer"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Serverdetectie"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Thuisserver afdwingen bij kamer-id's"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Versie van de Matrix-API"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "Eind-tot-eindversleuteling"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Automatische verificatie van het apparaat"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "PEM-bestand met privésleutel"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "Abonnementsbestand"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "XMPP-server"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Contactenlijst ophalen"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Onderwerp gebruiken"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Verbinding in stand houden"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "MUC-bijnaam"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "SCRAM-PLUS-kanaalbinding"
caronc-apprise-dfec414/apprise/i18n/pl/000077500000000000000000000000001526720371000177545ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/pl/LC_MESSAGES/000077500000000000000000000000001526720371000215415ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/pl/LC_MESSAGES/apprise.po000066400000000000000000002043211526720371000235460ustar00rootroot00000000000000# Polish translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: pl\n"
"Language-Team: pl \n"
"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
"|| n%100>=20) ? 1 : 2);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "Weryfikuj SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Podążaj za przekierowaniami"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Limit czasu odczytu gniazda"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Limit czasu połączenia gniazda"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Wiek pamięci podręcznej"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Wymuszony typ MIME"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Wymuszona nazwa pliku"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Plik lokalny"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Oparte na sieci"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Pamięć"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Schemat"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Brak zależności."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "Do działania wymagane są pakiety."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "Zalecane są pakiety, aby poprawić funkcjonalność."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "Nazwa użytkownika aplikacji"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "Klucz API"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Telefon docelowy"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Cele"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Nadawca"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "Tryb SMS"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Tryb wsadowy"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Nazwa hosta"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Port"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Nazwa użytkownika"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Hasło"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Token"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Znaczniki"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Metoda zapytania"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Wersja API Apprise"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "Nagłówek HTTP"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Nazwa użytkownika"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Docelowy znak wywoławczy"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Opóźnienie ponownego wysłania"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Ustawienia regionalne"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Urządzenie docelowe"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Dźwięk"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Poziom"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Głośność"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Kliknięcie"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Plakietka"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Kategoria"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Grupa"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Dołącz obraz"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "Adres URL ikony"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Połączenie"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Klucz szyfrowania"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Tryb przepełnienia"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Format powiadomienia"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Interpretuj emoji"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Trwała pamięć"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Strefa czasowa"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Ponowne próby usługi"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Oczekiwanie między próbami"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Usługa opcjonalna"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "Adres e-mail nadawcy"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Zespół docelowy"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Zasady eskalacji"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Metody alarmowania"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Czas oczekiwania zespołu"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Numer seryjny"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Czas trwania (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Czas przejścia (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "Numer diody LED"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Źródłowy adres e-mail"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Docelowy adres e-mail"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "Adres e-mail do odpowiedzi"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Kopia"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Kopia ukryta"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Sekret"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Docelowy numer telefonu"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Grupa docelowa"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Numer telefonu nadawcy"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Grupa trasowania"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Znaki Unicode"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "Sekret API"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "Identyfikator nadawcy"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "Kraj"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "ważność"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "Token API"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Token webhooka"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Nazwa bota"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Kanał docelowy"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Bot docelowy"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Region"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "Identyfikator firmy"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "Rozgłoszenie"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Metoda pobierania"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Załącz plik jako"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Dodatki ładunku"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "Parametry GET"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "Token dostępu API"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Adres źródłowy"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Priorytet"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Grupy nadajników"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "Biblioteka libdbus-1.so.x musi być zainstalowana."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "Powiadomienie DBus"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Pilność"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "Oś X"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Oś Y"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "Identyfikator webhooka"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Synteza mowy"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Obraz awatara"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "Adres URL awatara"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "Identyfikator wątku"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Pokaż stopkę"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Logo w stopce"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Użyj pól"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Flagi Discorda"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Wspomnij użytkowników lub role"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Ścieżka szablonu"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Grupuj załączniki"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Tokeny szablonu"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Numer seryjny urządzenia"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "Tryb API"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Odśwież teraz"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Podpis tekstowy"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Ikona w Base64 (API tekstowe)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Obraz w Base64 (API obrazów)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Odnośnik"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Obramowanie"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Typ ditheringu"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Jądro ditheringu"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Klucz zadania"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Modalny"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Ścieżka"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Limit czasu serwera"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Nazwa instancji"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "SID konta"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Numer telefonu nadawcy lub identyfikator nadawcy"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Nazwa regionu"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Klucz dostępu"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "Do identyfikatora użytkownika"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "Do identyfikatora kanału"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Ścieżka webhooka"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Tryb"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Nazwa wątku"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "Nazwa użytkownika API"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "Hasło API"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Token dostępu"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Właściciel"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Repozytorium"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Typ"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Numer"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Etykiety"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Przypisane osoby"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "Biblioteka libdbus-1.so.x lub libdbus-2.so.x musi być zainstalowana."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "Powiadomienie GLib"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "Wymagane jest lokalne środowisko Gnome."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Powiadomienie Gnome"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Klucze integracji"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Akcja"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Klucz deduplikacji"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Metadane"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Przestrzeń robocza"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Klucz webhooka"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Klucz wątku"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Platforma"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Temat"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Wpisy danych"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "Identyfikator bota"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Wersja"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Przypięte"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Długotrwały token dostępu"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "Identyfikator powiadomienia"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Przedrostek ścieżki"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Token lub nazwa użytkownika"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Zdarzenia"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Dodaj tokeny"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Usuń tokeny"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Klucz integracji"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Trasa"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "Identyfikator źródła alertów"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Docelowa eskalacja"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Docelowy harmonogram"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Użytkownik docelowy"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Cele "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Podmiot"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Alias"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Szczegóły"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Mapowanie akcji"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "Identyfikator urządzenia"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Nazwa urządzenia"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Źródłowy numer telefonu"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Czas trwania"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Klucz serwera"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Klucz API urządzenia"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "Identyfikator aplikacji"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "Wersja aplikacji"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "Token dostępu aplikacji"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Własna ikona"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Typ ikony"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Cykle"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Token bota"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "Adres URL kliknięcia"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Kolor"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Działa tylko z systemem Mac OS X 10.8 i nowszym. Dodatkowo wymaga, aby /usr/"
"local/bin/terminal-notifier był dostępny lokalnie."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "Powiadomienie MacOSX"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "Adres URL do otwarcia lub kliknięcia"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Wersja Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Nadawca"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Odpowiedz do"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Domena"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Nazwa nadawcy"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "Nagłówek wiadomości e-mail"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Widoczność"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Ukryty tekst"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Kod języka"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Zapisuj wyniki w pamięci podręcznej"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Poufne załączniki"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Wspomnij użytkowników lub znaczniki"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "Użytkownik"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "Identyfikator kanału docelowego"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Maksymalna liczba części wiadomości"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Własny odnośnik"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Kolejka docelowa"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "Identyfikator klienta"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Użyj sesji"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Zachowuj wiadomości"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "Identyfikator szablonu"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Klucz uwierzytelniania"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "Krótki adres URL"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Mapowanie szablonu"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "Przedrostek adresu URL"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "Identyfikator pokoju"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Ciche powiadomienie"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Identyfikator zdarzenia Discorda"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Źródło"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "Identyfikator projektu"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Zaczep wiadomości"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "Kolory IRC"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Przedrostek"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Nazwa kampanii"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Nazwa szablonu"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Odnośnik klienta"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Wysoka jakość"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Nagłówek faksu"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Załącznik"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Nazwa pliku załącznika"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Opóźnienie"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "E-mail"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Akcje"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Typ uwierzytelniania"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "Login API"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Przyjmuj odpowiedzi"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Przeznaczenie"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Domena najemcy"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "Adres e-mail konta lub identyfikator obiektu"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Sekret klienta"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Zapisz w elementach wysłanych"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Szablon"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "Identyfikator docelowego odtwarzacza"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Dołącz segment"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Podtytuł"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Język"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Włącz treść"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Dekoduj argumenty szablonu"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Własne dane"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Dane zwrotne"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "Identyfikator użytkownika docelowego"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "Identyfikator grupy docelowej"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Składnik"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Klasa"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Waga"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Własne szczegóły"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "Identyfikator integracji"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "Identyfikator strony trzeciej"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Dodatki Meta"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Klucz główny"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Urządzenie"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Przestrzeń nazw"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Plakietki"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Typ wiadomości"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "Identyfikator docelowy"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "Docelowy SMS"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Kanały"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "Identyfikator uwierzytelniania"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Token uwierzytelniania"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Klucz dostawcy"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Klucz powiadomień"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Klucz aplikacji"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Sekret aplikacji"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Klucz tajny"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Pokaż status"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Klucz użytkownika"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "Tytuł adresu URL"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Odstęp ponawiania alarmu"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Wygaśnięcie"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Token użytkownika"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Tematy grupy"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Kanał"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Nazwa webhooka"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Klucz prywatny"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Wibracje"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Poziom informacji"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Poziom powodzenia"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Poziom ostrzeżenia"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Poziom błędu"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Tajny klucz API"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Temat docelowy"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "Identyfikator aplikacji"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Docelowy subreddit"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Rodzaj"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "Identyfikator etykiety"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Tekst etykiety"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "Czy to reklama?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Wysyłaj odpowiedzi"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "Zawiera spoiler"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Flaga ponownego wysłania"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Adres nadawcy"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "Identyfikator kanału"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "Osadzony adres URL"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Token lub hasło"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Środowisko"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Tryb uwierzytelniania"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "Identyfikator pokoju docelowego"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Tryb webhooka"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Użyj awatara"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Usługa"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "Zapisuj PID"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Organizacja"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Dane szablonu"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Nazwa nadawcy"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Token sesji"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "Identyfikator klucza dostępu"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Tajny klucz dostępu"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Docelowe adresy e-mail"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Flash"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Etykieta"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "Identyfikator usługi"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Hasło usługi"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "Identyfikator przestrzeni"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Numer telefonu odbiorcy"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Typ multimediów"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Limit czasu"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Głos syntezatora mowy"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Klucz klienta"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Powiadomienie krytyczne"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Usługa"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Lokalizacja"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Scenariusz alarmowania"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Filtrowanie"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "Identyfikator zewnętrzny"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Status"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Docelowy członek"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Współdzielone"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Etykieta"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Docelowy kod skrócony"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "Token dostępu OAuth"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Token A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Token B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Token C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "Zakodowany identyfikator docelowy"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Ścieżka przepływu pracy"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Dołącz stopkę"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Użyj bloków"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Dołącz znacznik czasu"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Tryb wiadomości"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Host"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Login"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Transliteruj"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Kontakt docelowy"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Tylko test"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Brama"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Klucz publiczny"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Ziarno"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Pokoje"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Docelowy klucz trasowania"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "Identyfikator podmiotu"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Typ alarmu"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Odnośnik do obrazu"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Odnośnik do dźwięku"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Specjalny kolor tekstu"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Kwota"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Waluta"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Nazwa"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Identyfikator"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Przesyłanie"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Zapisuj do STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "Identyfikator docelowej rozmowy"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Wykryj właściciela bota"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Podgląd strony internetowej"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Grupuj załączniki zdjęć/filmów"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "Identyfikator wątku tematu"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Wersja Markdown"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Rozmieszczenie treści"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Ścieżka szablonu wiadomości sformatowanej"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "Identyfikator profilu wiadomości"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "Identyfikator bramy"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "Docelowy identyfikator Threema"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "Nazwa hosta API"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "Adres URL obrazu"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Typ zdarzenia"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Priorytet (zgodność z Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Metoda powiadomienia: sms lub połączenie"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Klucz konsumenta"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Sekret konsumenta"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Sekret dostępu"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Token uwierzytelniania"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "Identyfikatory odbiorców"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "Adres URL awatara bota"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "Adres e-mail użytkownika"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Token dostępu bota"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "Identyfikatory pokojów"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "Identyfikator firmy"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "Sekret aplikacji"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "Identyfikator agenta"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Dział docelowy"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Docelowy znacznik"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Klucz webhooka bota"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "Identyfikator telefonu nadawcy"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "Wymagane jest lokalne środowisko Microsoft Windows."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "Identyfikator przepływu pracy"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Podpis"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Użyj adresu URL Power Automate"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Identyfikator trasowania Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Zawijaj tekst"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "Wersja API"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Tematy"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Kod grupy lub opcji"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "Token aplikacji"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Token lub klucz"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Priorytet informacji"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Priorytet powodzenia"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Priorytet ostrzeżeń"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Priorytet błędów"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Etykieta odnośnika"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Token weryfikacyjny"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Strumień docelowy"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"Zainstaluj pika dla AMQP 0.9.1, python-qpid-proton dla AMQP 1.0 lub oba."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Exchange"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Host wirtualny"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Trwały"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Obowiązkowy"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Czas życia (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Nagłówki wiadomości"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "Serwer SMTP"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Tryb bezpieczny"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "Tryb bezpieczeństwa PGP"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "Ścieżka klucza publicznego PGP"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "Ścieżka klucza prywatnego PGP"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Katalog kluczy sieciowych"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Załączniki osadzone"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "Adres e-mail odbiorcy"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "Plik klucza OAuth2"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "Własny adres URL obrazu"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Kolor powiadomienia"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Imię i nazwisko"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Pseudonim"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Dołącz do kanałów"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Tryb uwierzytelniania"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Alias pokoju docelowego"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Wykrywanie serwera"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Wymuś serwer domowy dla identyfikatorów pokojów"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Wersja API Matrix"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "Szyfrowanie end-to-end"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Automatyczna weryfikacja urządzenia"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "Plik klucza prywatnego PEM"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "Plik subskrypcji"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "Serwer XMPP"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Pobierz listę kontaktów"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Użyj tematu"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Utrzymuj połączenie"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "Pseudonim MUC"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "Powiązanie kanału SCRAM-PLUS"
caronc-apprise-dfec414/apprise/i18n/pt/000077500000000000000000000000001526720371000177645ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/pt/LC_MESSAGES/000077500000000000000000000000001526720371000215515ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/pt/LC_MESSAGES/apprise.po000066400000000000000000002056701526720371000235660ustar00rootroot00000000000000# Portuguese translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: pt\n"
"Language-Team: pt \n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "Verificar o SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Seguir os redirecionamentos"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Tempo limite de leitura do socket"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Tempo limite de ligação do socket"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Idade da cache"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Tipo MIME forçado"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Nome de ficheiro forçado"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Ficheiro local"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Baseado na web"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Memória"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Esquema"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Sem dependências."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "São necessários pacotes para funcionar."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "Recomendam-se pacotes para melhorar a funcionalidade."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "Nome de utilizador da aplicação"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "Chave da API"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Telefone de destino"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Destinos"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Remetente"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "Modo SMS"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Modo por lotes"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Nome do anfitrião"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Porta"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Nome de utilizador"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Palavra-passe"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Token"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Etiquetas"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Método de consulta"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Versão da API do Apprise"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "Cabeçalho HTTP"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Nome de utilizador"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Indicativo de destino"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Atraso de reenvio"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Configuração regional"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Dispositivo de destino"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Som"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Nível"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Volume"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Clique"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Insígnia"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Categoria"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Grupo"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Incluir a imagem"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "URL do ícone"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Chamada"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Chave de cifragem"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Modo de excesso"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Formato da notificação"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Interpretar os emojis"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Armazenamento persistente"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Zona horária"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Tentativas do serviço"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Espera entre tentativas"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Serviço opcional"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "Correio eletrónico do remetente"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Equipa de destino"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Política de escalonamento"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Métodos de alerta"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Espera da equipa"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Número de série"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Duração (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Tempo de desvanecimento (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "Número do LED"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Correio eletrónico de origem"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Correio eletrónico de destino"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "Correio eletrónico de resposta"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Cópia"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Cópia oculta"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Segredo"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Número de telefone de destino"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Grupo de destino"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Número de telefone do remetente"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Grupo de encaminhamento"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Caracteres Unicode"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "Segredo da API"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "Identificador do remetente"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "País"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "validade"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "Token da API"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Token do webhook"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Nome do bot"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Canal de destino"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Bot de destino"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Região"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "ID da empresa"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "Transmissão"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Método de obtenção"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Anexar o ficheiro como"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Extras da carga útil"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "Parâmetros GET"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "Token de acesso da API"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Endereço de origem"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Prioridade"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Grupos de transmissores"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "O libdbus-1.so.x tem de estar instalado."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "Notificação do DBus"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Urgência"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "Eixo X"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Eixo Y"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "Identificador do webhook"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Síntese de voz"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Imagem do avatar"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "URL do avatar"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "Identificador do tópico"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Mostrar o rodapé"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Logótipo do rodapé"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Utilizar os campos"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Indicadores do Discord"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Mencionar utilizadores ou funções"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Caminho do modelo"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Agrupar os anexos"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Tokens do modelo"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Número de série do dispositivo"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "Modo da API"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Atualizar agora"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Assinatura do texto"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Ícone em Base64 (API de texto)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Imagem em Base64 (API de imagem)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Ligação"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Contorno"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Tipo de pontilhado"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Núcleo de pontilhado"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Chave da tarefa"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Modal"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Caminho"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Tempo limite do servidor"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Nome da instância"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "SID da conta"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Número de telefone do remetente ou identificador do remetente"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Nome da região"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Chave de acesso"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "Para o identificador do utilizador"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "Para o identificador do canal"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Caminho do webhook"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Modo"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Nome do tópico"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "Nome de utilizador da API"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "Palavra-passe da API"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Token de acesso"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Proprietário"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Repositório"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Tipo"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Número"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Etiquetas"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Responsáveis"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "O libdbus-1.so.x ou o libdbus-2.so.x tem de estar instalado."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "Notificação do GLib"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "É necessário um ambiente Gnome local."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Notificação do Gnome"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Chaves de integração"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Ação"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Chave de desduplicação"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Metadados"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Área de trabalho"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Chave do webhook"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Chave do tópico"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Plataforma"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Tópico"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Entradas de dados"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "Identificador do bot"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Versão"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Fixado"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Token de acesso de longa duração"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "Identificador da notificação"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Prefixo do caminho"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Token ou nome de utilizador"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Eventos"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Adicionar tokens"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Remover tokens"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Chave de integração"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Rota"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "ID da fonte de alertas"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Escalada de destino"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Horário de destino"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Utilizador de destino"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Destinos "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Entidade"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Alias"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Detalhes"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Mapeamento das ações"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "Identificador do dispositivo"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Nome do dispositivo"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Número de telefone de origem"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Duração"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Chave do servidor"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Chave da API do dispositivo"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "Identificador da aplicação"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "Versão da aplicação"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "Token de acesso da aplicação"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Ícone personalizado"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Tipo de ícone"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Ciclos"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Token do bot"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "URL do clique"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Cor"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Só funciona com o Mac OS X 10.8 e versões posteriores. Também exige que o /"
"usr/local/bin/terminal-notifier esteja acessível localmente."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "Notificação do MacOSX"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "URL de abertura ou de clique"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Versão do Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Remetente"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Responder a"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Domínio"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Nome do remetente"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "Cabeçalho do correio eletrónico"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Visibilidade"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Texto oculto"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Código do idioma"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Guardar os resultados em cache"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Anexos sensíveis"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Mencionar utilizadores ou etiquetas"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "Utilizador"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "Identificador do canal de destino"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Número máximo de partes da mensagem"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Referência personalizada"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Fila de destino"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "Identificador do cliente"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Utilizar uma sessão"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Manter as mensagens"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "Identificador do modelo"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Chave de autenticação"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "URL curto"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Mapeamento do modelo"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "Prefixo do URL"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "Identificador da sala"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Notificação silenciosa"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Identificador do evento do Discord"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Origem"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "Identificador do projeto"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Gancho de mensagens"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "Cores do IRC"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Prefixo"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Nome da campanha"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Nome do modelo"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Referência do cliente"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Alta qualidade"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Cabeçalho do fax"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Anexar"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Nome do ficheiro anexado"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Atraso"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "Correio eletrónico"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Ações"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Tipo de autenticação"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "Utilizador da API"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Aceitar respostas"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Finalidade"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Domínio do inquilino"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "Correio eletrónico da conta ou identificador do objeto"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Segredo do cliente"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Guardar nos itens enviados"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Modelo"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "Identificador do jogador de destino"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Incluir o segmento"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Subtítulo"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Idioma"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Ativar o conteúdo"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Descodificar os argumentos do modelo"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Dados personalizados"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Dados de retorno"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "Identificador do utilizador de destino"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "Identificador do grupo de destino"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Componente"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Classe"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Gravidade"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Detalhes personalizados"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "Identificador da integração"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "Identificador de terceiros"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Extras da Meta"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Chave principal"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Dispositivo"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Espaço de nomes"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Insígnias"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Tipo de mensagem"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "Identificador de destino"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "SMS de destino"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Canais"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "Identificador de autenticação"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Token de autenticação"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Chave do fornecedor"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Chave de notificação"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Chave da aplicação"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Segredo da aplicação"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Chave secreta"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Mostrar o estado"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Chave do utilizador"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "Título do URL"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Intervalo de repetição de emergência"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Validade"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Token do utilizador"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Tópicos do grupo"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Canal"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Nome do webhook"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Chave privada"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Vibração"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Nível de informação"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Nível de sucesso"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Nível de aviso"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Nível de falha"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Chave secreta da API"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Tópico de destino"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "Identificador da aplicação"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Subreddit de destino"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Género"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "Identificador do flair"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Texto do flair"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "É um anúncio?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Enviar as respostas"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "Contém spoiler"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Indicador de reenvio"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Endereço do remetente"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "Identificador do canal"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "URL incorporado"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Token ou palavra-passe"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Ambiente"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Modo de autenticação"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "Identificador da sala de destino"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Modo do webhook"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Utilizar o avatar"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Serviço"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "Registar o PID"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Organização"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Dados do modelo"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Nome do remetente"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Token da sessão"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "Identificador da chave de acesso"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Chave de acesso secreta"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Correios eletrónicos de destino"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Flash"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Etiqueta"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "Identificador do serviço"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Palavra-passe do serviço"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "Identificador do espaço"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Número de telefone do destinatário"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Tipo de suporte"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Tempo limite"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Voz de síntese"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Chave do cliente"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Notificação crítica"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Serviço"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Localização"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Cenário de alerta"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Filtragem"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "Identificador externo"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Estado"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Membro de destino"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Compartilhado"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Etiqueta"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Código curto de destino"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "Token de acesso OAuth"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Token A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Token B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Token C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "Identificador codificado de destino"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Caminho do fluxo de trabalho"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Incluir o rodapé"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Utilizar blocos"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Incluir a data e a hora"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Modo da mensagem"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Anfitrião"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Utilizador"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Transliterar"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Contacto de destino"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Apenas teste"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Gateway"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Chave pública"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Semente"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Salas"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Chave de encaminhamento de destino"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "Identificador da entidade"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Tipo de alerta"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Ligação da imagem"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Ligação do som"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Cor de texto especial"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Montante"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Moeda"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Nome"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Identificador"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Enviar"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Registar no STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "Identificador da conversa de destino"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Detetar o proprietário do bot"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Pré-visualização da página web"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Agrupar anexos de foto/vídeo"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "Identificador do tópico do assunto"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Versão do Markdown"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Colocação do conteúdo"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Caminho do modelo de mensagem formatada"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "Identificador do perfil de mensagens"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "Identificador do gateway"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "Identificador Threema de destino"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "Nome do anfitrião da API"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "URL da imagem"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Tipo de evento"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Prioridade (compatibilidade com o Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Método de notificação: sms ou chamada"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Chave do consumidor"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Segredo do consumidor"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Segredo de acesso"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Token de autenticação"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "Identificadores dos destinatários"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "URL do avatar do bot"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "Correio eletrónico do utilizador"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Token de acesso do bot"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "Identificadores das salas"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "Identificador da empresa"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "Segredo da aplicação"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "Identificador do agente"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Departamento de destino"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Etiqueta de destino"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Chave do webhook do bot"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "Identificador do telefone do remetente"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "É necessário um ambiente Microsoft Windows local."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "Identificador do fluxo de trabalho"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Assinatura"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Utilizar um URL do Power Automate"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Identificador de encaminhamento do Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Ajustar o texto"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "Versão da API"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Tópicos"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Código de grupo ou de opção"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "Token da aplicação"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Token ou chave"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Prioridade das informações"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Prioridade dos sucessos"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Prioridade dos avisos"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Prioridade das falhas"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Etiqueta da ligação"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Token de verificação"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Fluxo de destino"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"Instale pika para AMQP 0.9.1, python-qpid-proton para AMQP 1.0, ou ambos."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Exchange"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Host virtual"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Persistente"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Obrigatório"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Tempo de vida"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Cabeçalhos da mensagem"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "Servidor SMTP"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Modo seguro"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "Modo de segurança do PGP"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "Caminho da chave pública PGP"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "Caminho da chave privada PGP"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Diretório de chaves web"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Anexos incorporados"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "Correio eletrónico do destinatário"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "Ficheiro de chave OAuth2"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "URL de imagem personalizada"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Cor da notificação"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Nome verdadeiro"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Alcunha"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Entrar nos canais"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Modo de autenticação"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Alias da sala de destino"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Deteção do servidor"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Forçar o servidor de origem nos identificadores de sala"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Versão da API do Matrix"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "Cifragem de ponta a ponta"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Verificação automática do dispositivo"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "Ficheiro de chave privada PEM"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "Ficheiro de subscrição"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "Servidor XMPP"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Obter a lista de contactos"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Utilizar o assunto"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Manter a ligação ativa"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "Alcunha MUC"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "Vinculação de canal SCRAM-PLUS"
caronc-apprise-dfec414/apprise/i18n/ru/000077500000000000000000000000001526720371000177675ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/ru/LC_MESSAGES/000077500000000000000000000000001526720371000215545ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/ru/LC_MESSAGES/apprise.po000066400000000000000000002220541526720371000235640ustar00rootroot00000000000000# Russian translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: ru\n"
"Language-Team: ru \n"
"Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "Проверять SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Следовать перенаправлениям"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Тайм-аут чтения сокета"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Тайм-аут подключения сокета"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Срок действия кеша"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Принудительный тип MIME"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Принудительное имя файла"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Локальный файл"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "В интернете"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Память"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Схема"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Зависимостей нет."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "Для работы требуются пакеты."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "Для расширения возможностей рекомендуются пакеты."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "Имя пользователя приложения"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "Ключ API"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Телефон получателя"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Получатели"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Отправитель"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "Режим SMS"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Пакетный режим"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Имя хоста"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Порт"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Имя пользователя"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Пароль"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Токен"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Метки"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Метод запроса"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Версия API Apprise"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "Заголовок HTTP"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Имя пользователя"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Позывной получателя"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Задержка повторной отправки"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Региональные настройки"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Устройство получателя"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Звук"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Уровень"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Громкость"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Нажатие"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Значок"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Категория"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Группа"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Включить изображение"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "URL значка"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Звонок"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Ключ шифрования"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Режим переполнения"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Формат уведомления"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Обрабатывать эмодзи"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Постоянное хранилище"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Часовой пояс"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Повторные попытки службы"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Ожидание между попытками"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Необязательная служба"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "Электронная почта отправителя"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Команда-получатель"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Политика эскалации"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Способы оповещения"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Ожидание команды"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Серийный номер"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Длительность (мс)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Время затухания (мс)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "Номер светодиода"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Адрес электронной почты источника"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Адрес электронной почты получателя"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "Адрес для ответа"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Копия"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Скрытая копия"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Секрет"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Номер телефона получателя"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Группа получателей"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Номер телефона отправителя"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Группа маршрутизации"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Символы Unicode"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "Секрет API"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "Идентификатор отправителя"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "Страна"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "срок действия"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "Токен API"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Токен веб-хука"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Имя бота"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Канал-получатель"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Бот-получатель"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Регион"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "ID компании"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "Рассылка всем"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Метод получения"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Прикрепить файл как"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Дополнения полезной нагрузки"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "Параметры GET"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "Токен доступа к API"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Адрес источника"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Приоритет"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Группы передатчиков"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "Должна быть установлена библиотека libdbus-1.so.x."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "Уведомление DBus"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Срочность"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "Ось X"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Ось Y"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "Идентификатор веб-хука"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Синтез речи"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Изображение аватара"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "URL аватара"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "Идентификатор обсуждения"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Показывать нижний колонтитул"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Логотип в нижнем колонтитуле"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Использовать поля"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Флаги Discord"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Упоминать пользователей или роли"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Путь к шаблону"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Объединять вложения"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Токены шаблона"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Серийный номер устройства"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "Режим API"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Обновить сейчас"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Подпись текста"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Значок в Base64 (текстовый API)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Изображение в Base64 (API изображений)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Ссылка"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Рамка"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Тип сглаживания"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Ядро сглаживания"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Ключ задачи"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Модальное окно"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Путь"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Тайм-аут сервера"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Имя экземпляра"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "SID учётной записи"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Номер телефона отправителя или идентификатор отправителя"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Название региона"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Ключ доступа"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "Идентификатор пользователя получателя"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "Идентификатор канала получателя"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Путь веб-хука"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Режим"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Название обсуждения"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "Имя пользователя API"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "Пароль API"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Токен доступа"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Владелец"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Репозиторий"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Тип"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Номер"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Метки"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Исполнители"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "Должна быть установлена библиотека libdbus-1.so.x или libdbus-2.so.x."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "Уведомление GLib"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "Требуется локальная среда Gnome."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Уведомление Gnome"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Ключи интеграции"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Действие"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Ключ дедупликации"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Метаданные"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Рабочая область"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Ключ веб-хука"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Ключ обсуждения"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Платформа"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Тема"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Записи данных"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "Идентификатор бота"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Версия"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Закреплено"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Долгоживущий токен доступа"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "Идентификатор уведомления"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Префикс пути"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Токен или имя пользователя"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "События"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Добавить токены"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Удалить токены"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Ключ интеграции"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Маршрут"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "Идентификатор источника оповещений"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Эскалация получателя"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Расписание получателя"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Пользователь-получатель"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Получатели "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Объект"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Псевдоним"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Подробности"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Сопоставление действий"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "Идентификатор устройства"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Имя устройства"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Номер телефона источника"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Длительность"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Ключ сервера"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Ключ API устройства"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "Идентификатор приложения"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "Версия приложения"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "Токен доступа приложения"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Свой значок"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Тип значка"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Циклы"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Токен бота"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "URL нажатия"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Цвет"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Работает только в Mac OS X 10.8 и новее. Кроме того, требуется локальный "
"доступ к /usr/local/bin/terminal-notifier."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "Уведомление MacOSX"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "URL для открытия или нажатия"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Версия Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Отправитель"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Ответить"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Домен"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Имя отправителя"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "Заголовок письма"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Видимость"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Скрытый текст"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Код языка"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Кешировать результаты"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Конфиденциальные вложения"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Упоминать пользователей или метки"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "Пользователь"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "Идентификатор канала-получателя"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Максимальное число частей сообщения"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Своя ссылка"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Очередь получателя"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "Идентификатор клиента"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Использовать сеанс"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Сохранять сообщения"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "Идентификатор шаблона"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Ключ аутентификации"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "Короткий URL"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Сопоставление шаблона"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "Префикс URL"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "Идентификатор комнаты"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Тихое уведомление"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Идентификатор события Discord"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Источник"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "Идентификатор проекта"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Хук сообщений"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "Цвета IRC"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Префикс"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Название кампании"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Название шаблона"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Ссылка клиента"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Высокое качество"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Заголовок факса"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Вложение"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Имя файла вложения"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Задержка"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "Электронная почта"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Действия"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Тип аутентификации"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "Логин API"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Принимать ответы"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Назначение"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Домен арендатора"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "Электронная почта учётной записи или идентификатор объекта"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Секрет клиента"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Сохранять в отправленных"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Шаблон"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "Идентификатор игрока-получателя"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Включить сегмент"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Подзаголовок"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Язык"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Включить содержимое"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Декодировать аргументы шаблона"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Свои данные"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Данные обратной передачи"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "Идентификатор пользователя-получателя"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "Идентификатор группы получателей"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Компонент"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Класс"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Серьёзность"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Свои подробности"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "Идентификатор интеграции"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "Сторонний идентификатор"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Дополнения Meta"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Главный ключ"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Устройство"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Пространство имён"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Значки"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Тип сообщения"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "Идентификатор получателя"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "SMS получателя"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Каналы"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "Идентификатор аутентификации"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Токен аутентификации"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Ключ поставщика"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Ключ уведомлений"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Ключ приложения"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Секрет приложения"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Секретный ключ"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Показывать состояние"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Ключ пользователя"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "Заголовок URL"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Интервал экстренных повторов"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Срок действия"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Токен пользователя"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Темы группы"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Канал"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Название веб-хука"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Закрытый ключ"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Вибрация"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Уровень информации"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Уровень успеха"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Уровень предупреждения"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Уровень сбоя"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Секретный ключ API"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Тема получателя"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "Идентификатор приложения"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Целевой субреддит"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Вид"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "Идентификатор метки"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Текст метки"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "Это реклама?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Отправлять ответы"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "Содержит спойлер"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Флаг повторной отправки"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Адрес отправителя"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "Идентификатор канала"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "Встроенный URL"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Токен или пароль"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Среда"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Режим аутентификации"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Веб-хук"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "Идентификатор комнаты-получателя"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Режим веб-хука"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Использовать аватар"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Подсистема"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "Записывать PID"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Организация"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Данные шаблона"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Имя отправителя"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Токен сеанса"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "Идентификатор ключа доступа"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Секретный ключ доступа"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Адреса электронной почты получателей"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Вспышка"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Подпись"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "Идентификатор службы"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Пароль службы"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "Идентификатор пространства"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Номер телефона получателя"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Тип содержимого"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Тайм-аут"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Голос синтеза речи"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Ключ клиента"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Критическое уведомление"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Служба"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Расположение"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Сценарий оповещения"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Фильтрация"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "Внешний идентификатор"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Состояние"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Целевой участник"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Общий"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Метка"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Короткий код получателя"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "Токен доступа OAuth"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Токен A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Токен B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Токен C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "Закодированный идентификатор получателя"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Путь рабочего процесса"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Включить нижний колонтитул"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Использовать блоки"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Включить метку времени"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Режим сообщения"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Хост"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Логин"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Транслитерировать"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Контакт-получатель"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Только проверка"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Шлюз"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Открытый ключ"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Начальное значение"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Комнаты"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Ключ маршрутизации получателя"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "Идентификатор объекта"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Тип оповещения"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Ссылка на изображение"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Ссылка на звук"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Особый цвет текста"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Сумма"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Валюта"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Имя"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Идентификатор"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Загрузка"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Записывать в STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "Идентификатор чата-получателя"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Определять владельца бота"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Предварительный просмотр страницы"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Группировать вложения фото/видео"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "Идентификатор обсуждения темы"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Версия Markdown"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Размещение содержимого"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Путь к шаблону форматированного сообщения"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "Идентификатор профиля сообщений"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "Идентификатор шлюза"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "Идентификатор Threema получателя"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "Имя хоста API"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "URL изображения"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Тип события"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Приоритет (совместимость с Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Способ уведомления: sms или звонок"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Ключ потребителя"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Секрет потребителя"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Секрет доступа"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Токен аутентификации"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "Идентификаторы получателей"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "URL аватара бота"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "Электронная почта пользователя"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Токен доступа бота"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "Идентификаторы комнат"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "Идентификатор организации"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "Секрет приложения"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "Идентификатор агента"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Отдел-получатель"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Метка получателя"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Ключ веб-хука бота"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "Идентификатор телефона отправителя"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "Требуется локальная среда Microsoft Windows."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "Идентификатор рабочего процесса"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Подпись"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Использовать URL Power Automate"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Идентификатор маршрутизации Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Переносить текст"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "Версия API"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Темы"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Код группы или параметра"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "Токен приложения"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Токен или ключ"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Приоритет информации"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Приоритет успеха"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Приоритет предупреждений"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Приоритет сбоев"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Подпись ссылки"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Токен проверки"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Поток-получатель"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"Установите pika для AMQP 0.9.1, python-qpid-proton для AMQP 1.0 или оба."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Обменник"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Виртуальный хост"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Постоянное"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Обязательное"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Время жизни (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Заголовки сообщения"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "Сервер SMTP"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Защищённый режим"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "Режим безопасности PGP"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "Путь к открытому ключу PGP"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "Путь к закрытому ключу PGP"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Каталог веб-ключей"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Встроенные вложения"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "Электронная почта получателя"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "Файл ключа OAuth2"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "Свой URL изображения"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Цвет уведомления"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Настоящее имя"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Псевдоним"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Входить в каналы"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Режим аутентификации"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Псевдоним комнаты-получателя"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Обнаружение сервера"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Принудительно использовать домашний сервер для идентификаторов комнат"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Версия API Matrix"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "Сквозное шифрование"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Автоматическая проверка устройства"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "Файл закрытого ключа PEM"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "Файл подписки"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "Сервер XMPP"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Получить список контактов"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Использовать тему"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Поддерживать соединение"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "Псевдоним MUC"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "Привязка канала SCRAM-PLUS"
caronc-apprise-dfec414/apprise/i18n/th/000077500000000000000000000000001526720371000177545ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/th/LC_MESSAGES/000077500000000000000000000000001526720371000215415ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/th/LC_MESSAGES/apprise.po000066400000000000000000002307371526720371000235600ustar00rootroot00000000000000# Thai translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: th\n"
"Language-Team: th \n"
"Plural-Forms: nplurals=1; plural=0;\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "ตรวจสอบ SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "ติดตามการเปลี่ยนเส้นทาง"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "เวลารอการอ่านซ็อกเก็ต"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "เวลารอการเชื่อมต่อซ็อกเก็ต"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "อายุของแคช"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "ชนิด MIME ที่บังคับใช้"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "ชื่อไฟล์ที่บังคับใช้"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "ไฟล์ในเครื่อง"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "อยู่บนเว็บ"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "หน่วยความจำ"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "สคีมา"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "ไม่มีสิ่งที่ต้องติดตั้งเพิ่ม"

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "ต้องติดตั้งแพ็กเกจเพื่อให้ใช้งานได้"

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "แนะนำให้ติดตั้งแพ็กเกจเพื่อเพิ่มความสามารถ"

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "ชื่อผู้ใช้ของแอป"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "คีย์ API"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "โทรศัพท์ปลายทาง"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "ปลายทาง"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "ผู้ส่ง"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "โหมด SMS"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "โหมดรวมชุด"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "ชื่อโฮสต์"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "พอร์ต"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "ชื่อผู้ใช้"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "รหัสผ่าน"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "โทเค็น"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "แท็ก"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "วิธีการสอบถาม"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "รุ่นของ Apprise API"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "ส่วนหัว HTTP"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "ชื่อผู้ใช้"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "รหัสเรียกขานปลายทาง"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "เวลาหน่วงก่อนส่งซ้ำ"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "การตั้งค่าภูมิภาค"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "อุปกรณ์ปลายทาง"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "เสียง"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "ระดับ"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "ระดับเสียง"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "การคลิก"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "ป้าย"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "หมวดหมู่"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "กลุ่ม"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "แนบรูปภาพ"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "URL ของไอคอน"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "การโทร"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "คีย์เข้ารหัส"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "โหมดเมื่อข้อความยาวเกิน"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "รูปแบบการแจ้งเตือน"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "แปลงอิโมจิ"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "ที่จัดเก็บแบบถาวร"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "เขตเวลา"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "จำนวนครั้งที่ลองใหม่ของบริการ"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "เวลารอระหว่างการลองใหม่"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "บริการที่เลือกใช้ได้"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "อีเมลผู้ส่ง"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "ทีมปลายทาง"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "นโยบายการยกระดับ"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "วิธีการแจ้งเตือน"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "เวลารอของทีม"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "หมายเลขเครื่อง"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "ระยะเวลา (มิลลิวินาที)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "เวลาหรี่แสง (มิลลิวินาที)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "หมายเลขหลอด LED"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "อีเมลต้นทาง"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "อีเมลปลายทาง"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "อีเมลสำหรับตอบกลับ"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "สำเนา"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "สำเนาลับ"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "รหัสลับ"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "หมายเลขโทรศัพท์ปลายทาง"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "กลุ่มปลายทาง"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "หมายเลขโทรศัพท์ผู้ส่ง"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "กลุ่มการกำหนดเส้นทาง"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "อักขระ Unicode"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "รหัสลับ API"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "รหัสผู้ส่ง"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "ประเทศ"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "อายุการใช้งาน"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "โทเค็น API"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "โทเค็น webhook"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "ชื่อบอท"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "ช่องปลายทาง"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "บอทปลายทาง"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "ภูมิภาค"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "รหัสบริษัท"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "ออกอากาศ"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "วิธีการดึงข้อมูล"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "แนบไฟล์ในชื่อ"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "ข้อมูลเพิ่มเติมที่ส่งไป"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "พารามิเตอร์ GET"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "โทเค็นเข้าถึง API"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "ที่อยู่ต้นทาง"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "ความสำคัญ"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "กลุ่มเครื่องส่ง"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "ต้องติดตั้ง libdbus-1.so.x"

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "การแจ้งเตือน DBus"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "ความเร่งด่วน"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "แกน X"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "แกน Y"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "รหัส webhook"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "การอ่านข้อความเป็นเสียง"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "รูปประจำตัว"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "URL ของรูปประจำตัว"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "รหัสกระทู้"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "แสดงส่วนท้าย"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "โลโก้ในส่วนท้าย"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "ใช้ฟิลด์"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "แฟล็กของ Discord"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "กล่าวถึงผู้ใช้หรือบทบาท"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "พาธของแม่แบบ"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "รวมไฟล์แนบเข้าด้วยกัน"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "โทเค็นของแม่แบบ"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "หมายเลขเครื่องของอุปกรณ์"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "โหมด API"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "รีเฟรชทันที"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "ลายเซ็นข้อความ"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "ไอคอนแบบ Base64 (API ข้อความ)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "รูปภาพแบบ Base64 (API รูปภาพ)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "ลิงก์"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "เส้นขอบ"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "ชนิดการเกลี่ยสี"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "เคอร์เนลการเกลี่ยสี"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "คีย์ของงาน"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "หน้าต่างซ้อน"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "พาธ"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "เวลารอของเซิร์ฟเวอร์"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "ชื่ออินสแตนซ์"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "SID ของบัญชี"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "หมายเลขโทรศัพท์ผู้ส่งหรือรหัสผู้ส่ง"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "ชื่อภูมิภาค"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "คีย์เข้าถึง"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "ไปยังรหัสผู้ใช้"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "ไปยังรหัสช่อง"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "พาธของ webhook"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "โหมด"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "ชื่อกระทู้"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "ชื่อผู้ใช้ API"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "รหัสผ่าน API"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "โทเค็นเข้าถึง"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "เจ้าของ"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "รีโพสิทอรี"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "ชนิด"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "หมายเลข"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "ป้ายกำกับ"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "ผู้รับผิดชอบ"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "ต้องติดตั้ง libdbus-1.so.x หรือ libdbus-2.so.x"

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "การแจ้งเตือน GLib"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "ต้องมีสภาพแวดล้อม Gnome ในเครื่อง"

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "การแจ้งเตือน Gnome"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "คีย์การเชื่อมต่อหลายรายการ"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "การกระทำ"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "คีย์ตัดรายการซ้ำ"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "ข้อมูลกำกับ"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "พื้นที่ทำงาน"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "คีย์ของ webhook"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "คีย์ของกระทู้"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "แพลตฟอร์ม"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "หัวข้อ"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "รายการข้อมูล"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "รหัสบอท"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "รุ่น"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "ปักหมุด"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "โทเค็นเข้าถึงอายุยาว"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "รหัสการแจ้งเตือน"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "คำนำหน้าพาธ"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "โทเค็นหรือชื่อผู้ใช้"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "เหตุการณ์"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "เพิ่มโทเค็น"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "ลบโทเค็น"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "คีย์การเชื่อมต่อ"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "เส้นทาง"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "รหัสแหล่งที่มาการแจ้งเตือน"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "ระดับการส่งต่อปลายทาง"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "ตารางเวรปลายทาง"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "ผู้ใช้ปลายทาง"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "ปลายทาง "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "เอนทิตี"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "ชื่อแทน"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "รายละเอียด"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "การจับคู่การกระทำ"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "รหัสอุปกรณ์"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "ชื่ออุปกรณ์"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "หมายเลขโทรศัพท์ต้นทาง"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "ระยะเวลา"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "คีย์ของเซิร์ฟเวอร์"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "คีย์ API ของอุปกรณ์"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "รหัสแอป"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "รุ่นของแอป"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "โทเค็นเข้าถึงของแอป"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "ไอคอนที่กำหนดเอง"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "ชนิดของไอคอน"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "จำนวนรอบ"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "โทเค็นของบอท"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "URL เมื่อคลิก"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "สี"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"ใช้งานได้กับ Mac OS X 10.8 ขึ้นไปเท่านั้น และต้องเข้าถึง /usr/local/bin/terminal-"
"notifier ในเครื่องได้"

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "การแจ้งเตือน MacOSX"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "URL ที่จะเปิดหรือคลิก"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "รุ่นของ Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "ผู้ส่ง"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "ตอบกลับไปที่"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "โดเมน"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "ชื่อผู้ส่ง"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "ส่วนหัวอีเมล"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "การมองเห็น"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "ข้อความที่ซ่อนไว้"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "รหัสภาษา"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "เก็บผลลัพธ์ไว้ในแคช"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "ไฟล์แนบที่เป็นความลับ"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "กล่าวถึงผู้ใช้หรือแท็ก"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "ผู้ใช้"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "รหัสช่องปลายทาง"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "จำนวนส่วนของข้อความสูงสุด"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "รหัสอ้างอิงที่กำหนดเอง"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "คิวปลายทาง"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "รหัสไคลเอ็นต์"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "ใช้เซสชัน"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "เก็บข้อความไว้"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "รหัสแม่แบบ"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "คีย์ยืนยันตัวตน"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "URL แบบสั้น"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "การจับคู่แม่แบบ"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "คำนำหน้า URL"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "รหัสห้อง"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "การแจ้งเตือนแบบไม่มีเสียง"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "รหัสเหตุการณ์ของ Discord"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "ต้นทาง"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "รหัสโครงการ"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "ฮุกของข้อความ"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "สีของ IRC"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "คำนำหน้า"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "ชื่อแคมเปญ"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "ชื่อแม่แบบ"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "รหัสอ้างอิงของไคลเอ็นต์"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "คุณภาพสูง"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "ส่วนหัวของโทรสาร"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "ไฟล์แนบ"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "ชื่อไฟล์แนบ"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "เวลาหน่วง"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "อีเมล"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "การกระทำ"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "ชนิดการยืนยันตัวตน"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "ชื่อเข้าใช้ API"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "รับการตอบกลับ"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "วัตถุประสงค์"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "โดเมนของผู้เช่า"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "อีเมลของบัญชีหรือรหัสวัตถุ"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "รหัสลับของไคลเอ็นต์"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "บันทึกไว้ในรายการที่ส่งแล้ว"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "แม่แบบ"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "รหัสผู้เล่นปลายทาง"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "รวมกลุ่มเป้าหมาย"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "คำบรรยายรอง"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "ภาษา"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "เปิดใช้เนื้อหา"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "ถอดรหัสอาร์กิวเมนต์ของแม่แบบ"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "ข้อมูลที่กำหนดเอง"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "ข้อมูลตอบกลับ"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "รหัสผู้ใช้ปลายทาง"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "รหัสกลุ่มปลายทาง"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "ส่วนประกอบ"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "คลาส"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "ระดับความรุนแรง"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "รายละเอียดที่กำหนดเอง"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "รหัสการเชื่อมต่อ"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "รหัสจากบุคคลที่สาม"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "ข้อมูลเพิ่มเติมของ Meta"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "คีย์หลัก"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "อุปกรณ์"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "เนมสเปซ"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "ป้าย"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "ชนิดข้อความ"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "รหัสปลายทาง"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "SMS ปลายทาง"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "ช่อง"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "รหัสการยืนยันตัวตน"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "โทเค็นการยืนยันตัวตน"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "คีย์ของผู้ให้บริการ"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "คีย์การแจ้งเตือน"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "คีย์ของแอปพลิเคชัน"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "รหัสลับของแอปพลิเคชัน"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "คีย์ลับ"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "แสดงสถานะ"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "คีย์ของผู้ใช้"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "ชื่อของ URL"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "ช่วงเวลาลองใหม่กรณีฉุกเฉิน"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "วันหมดอายุ"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "โทเค็นของผู้ใช้"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "หัวข้อของกลุ่ม"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "ช่อง"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "ชื่อของ webhook"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "คีย์ส่วนตัว"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "การสั่น"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "ระดับข้อมูล"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "ระดับความสำเร็จ"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "ระดับคำเตือน"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "ระดับความล้มเหลว"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "คีย์ API ลับ"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "หัวข้อปลายทาง"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "รหัสแอปพลิเคชัน"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "ซับเรดดิตปลายทาง"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "ชนิดเนื้อหา"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "รหัสป้ายกำกับ"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "ข้อความป้ายกำกับ"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "เป็นโฆษณาหรือไม่"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "ส่งการตอบกลับ"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "มีเนื้อหาสปอยล์"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "แฟล็กการส่งซ้ำ"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "ที่อยู่ผู้ส่ง"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "รหัสช่อง"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "URL ที่ฝังไว้"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "โทเค็นหรือรหัสผ่าน"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "สภาพแวดล้อม"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "โหมดการยืนยันตัวตน"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "รหัสห้องปลายทาง"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "โหมด webhook"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "ใช้รูปประจำตัว"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "หมวดของระบบ"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "บันทึก PID"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "องค์กร"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "ข้อมูลของแม่แบบ"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "ชื่อผู้ส่ง"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "โทเค็นของเซสชัน"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "รหัสคีย์เข้าถึง"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "คีย์เข้าถึงลับ"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "อีเมลปลายทาง"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "แฟลช"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "ป้ายชื่อ"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "รหัสบริการ"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "รหัสผ่านของบริการ"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "รหัสพื้นที่"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "หมายเลขโทรศัพท์ผู้รับ"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "ชนิดสื่อ"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "เวลารอ"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "เสียงอ่านข้อความ"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "คีย์ของไคลเอ็นต์"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "การแจ้งเตือนสำคัญ"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "บริการ"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "ตำแหน่ง"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "สถานการณ์การแจ้งเตือน"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "การกรอง"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "รหัสภายนอก"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "สถานะ"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "สมาชิกเป้าหมาย"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "แชร์"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "แท็ก"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "รหัสสั้นปลายทาง"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "โทเค็นเข้าถึง OAuth"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "โทเค็น A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "โทเค็น B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "โทเค็น C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "รหัสปลายทางที่เข้ารหัสไว้"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "พาธของกระบวนงาน"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "แสดงส่วนท้าย"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "ใช้บล็อก"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "แสดงเวลาที่บันทึก"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "โหมดข้อความ"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "โฮสต์"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "ชื่อเข้าใช้"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "ถอดอักษร"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "ผู้ติดต่อปลายทาง"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "ทดสอบเท่านั้น"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "เกตเวย์"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "คีย์สาธารณะ"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "ค่าเริ่มต้นสุ่ม"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "ห้อง"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "คีย์กำหนดเส้นทางปลายทาง"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "รหัสเอนทิตี"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "ชนิดการแจ้งเตือน"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "ลิงก์รูปภาพ"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "ลิงก์เสียง"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "สีข้อความพิเศษ"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "จำนวนเงิน"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "สกุลเงิน"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "ชื่อ"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "ตัวระบุ"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "การอัปโหลด"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "บันทึกไปที่ STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "รหัสแชทปลายทาง"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "ตรวจหาเจ้าของบอท"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "ตัวอย่างหน้าเว็บ"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "จัดกลุ่มไฟล์แนบรูปภาพ/วิดีโอ"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "รหัสกระทู้ของหัวข้อ"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "รุ่นของ Markdown"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "ตำแหน่งของเนื้อหา"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "พาธของแม่แบบข้อความมีรูปแบบ"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "รหัสโปรไฟล์การส่งข้อความ"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "รหัสเกตเวย์"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "รหัส Threema ปลายทาง"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "ชื่อโฮสต์ของ API"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "URL ของรูปภาพ"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "ชนิดของเหตุการณ์"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "ความสำคัญ (รองรับแบบ Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "วิธีแจ้งเตือน: sms หรือโทร"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "คีย์ของผู้ใช้ API"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "รหัสลับของผู้ใช้ API"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "รหัสลับเข้าถึง"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "โทเค็นยืนยันตัวตน"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "รหัสผู้รับ"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "URL รูปประจำตัวของบอท"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "อีเมลของผู้ใช้"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "โทเค็นเข้าถึงของบอท"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "รหัสห้อง"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "รหัสองค์กร"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "รหัสลับของแอป"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "รหัสเจ้าหน้าที่"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "แผนกปลายทาง"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "แท็กปลายทาง"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "คีย์ webhook ของบอท"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "รหัสโทรศัพท์ผู้ส่ง"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "ต้องมีสภาพแวดล้อม Microsoft Windows ในเครื่อง"

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "รหัสกระบวนงาน"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "ลายเซ็น"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "ใช้ URL ของ Power Automate"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "รหัสกำหนดเส้นทางของ Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "ตัดบรรทัดข้อความ"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "รุ่นของ API"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "หัวข้อ"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "รหัสกลุ่มหรือตัวเลือก"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "โทเค็นของแอป"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "โทเค็นหรือคีย์"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "ความสำคัญของข้อมูล"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "ความสำคัญของความสำเร็จ"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "ความสำคัญของคำเตือน"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "ความสำคัญของความล้มเหลว"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "ป้ายชื่อของลิงก์"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "โทเค็นการยืนยัน"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "สตรีมปลายทาง"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"ติดตั้ง pika สำหรับ AMQP 0.9.1, python-qpid-proton สำหรับ AMQP 1.0 หรือทั้งสองอย่าง"

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "เอ็กซ์เชนจ์"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "โฮสต์เสมือน"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "คงทน"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "บังคับ"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "อายุข้อความ (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "ส่วนหัวข้อความ"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "เซิร์ฟเวอร์ SMTP"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "โหมดปลอดภัย"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "โหมดความปลอดภัยของ PGP"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "พาธของคีย์สาธารณะ PGP"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "พาธของคีย์ส่วนตัว PGP"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "ไดเรกทอรีคีย์บนเว็บ"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "ไฟล์แนบแบบฝังในเนื้อหา"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "อีเมลผู้รับ"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "ไฟล์คีย์ OAuth2"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "URL รูปภาพที่กำหนดเอง"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "สีของการแจ้งเตือน"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "ชื่อจริง"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "ชื่อเล่น"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "เข้าร่วมช่อง"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "โหมดการยืนยันตัวตน"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "ชื่อแทนของห้องปลายทาง"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "การค้นหาเซิร์ฟเวอร์"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "บังคับใช้เซิร์ฟเวอร์ต้นสังกัดกับรหัสห้อง"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "รุ่นของ API ของ Matrix"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "การเข้ารหัสแบบต้นทางถึงปลายทาง"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "การยืนยันอุปกรณ์อัตโนมัติ"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "ไฟล์คีย์ส่วนตัวแบบ PEM"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "ไฟล์การสมัครรับข้อมูล"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "เซิร์ฟเวอร์ XMPP"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "ดึงรายชื่อผู้ติดต่อ"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "ใช้หัวเรื่อง"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "คงการเชื่อมต่อไว้"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "ชื่อเล่นใน MUC"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "การผูกช่องทางแบบ SCRAM-PLUS"
caronc-apprise-dfec414/apprise/i18n/tl/000077500000000000000000000000001526720371000177605ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/tl/LC_MESSAGES/000077500000000000000000000000001526720371000215455ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/tl/LC_MESSAGES/apprise.po000066400000000000000000002040401526720371000235500ustar00rootroot00000000000000# Tagalog translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: tl\n"
"Language-Team: tl \n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "I-verify ang SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Sundan ang mga redirect"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Timeout sa pagbasa ng socket"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Timeout sa pagkonekta ng socket"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Tanda ng cache"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Sapilitang uri ng MIME"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Sapilitang pangalan ng file"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Lokal na file"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Nasa web"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Memorya"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Skema"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Walang kailangang dependency."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "Kailangan ng mga package upang gumana."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "Inirerekomenda ang mga package upang mapabuti ang gamit."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "Pangalan ng user ng app"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "Susi ng API"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Telepono ng padadalhan"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Mga padadalhan"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Nagpadala"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "Mode ng SMS"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Pinagsamang mode"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Pangalan ng host"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Port"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Pangalan ng user"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Password"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Token"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Mga tag"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Paraan ng query"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Bersyon ng Apprise API"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "Header ng HTTP"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Pangalan ng user"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Callsign ng padadalhan"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Pagkaantala ng muling pagpadala"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Panrehiyong setting"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Device na padadalhan"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Tunog"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Antas"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Lakas ng tunog"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Pag-click"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Badge"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Kategorya"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Grupo"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Isama ang larawan"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "URL ng icon"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Tawag"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Susi ng pag-encrypt"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Mode kapag sumobra"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Format ng abiso"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Bigyang-kahulugan ang mga emoji"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Panatilihing imbakan"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Time zone"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Muling pagsubok ng serbisyo"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Paghihintay sa pagitan ng mga pagsubok"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Opsyonal na serbisyo"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "Email ng nagpadala"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Pangkat na padadalhan"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Patakaran sa Escalation"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Mga Paraan ng Alerto"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Paghihintay ng Team"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Serial number"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Tagal (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Tagal ng paglabo (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "Numero ng LED"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Pinagmulang email"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Email ng padadalhan"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "Email para sa sagot"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Kopya"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Nakatagong kopya"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Sekreto"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Numero ng telepono ng padadalhan"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Grupong padadalhan"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Numero ng telepono ng nagpadala"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Grupo ng ruta"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Mga karakter na Unicode"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "Sekreto ng API"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "ID ng nagpadala"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "Bansa"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "bisa"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "Token ng API"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Token ng webhook"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Pangalan ng bot"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Channel na padadalhan"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Bot na padadalhan"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Rehiyon"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "ID ng kumpanya"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "I-broadcast"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Paraan ng pagkuha"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Ilakip ang file bilang"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Karagdagan sa payload"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "Mga parameter ng GET"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "Token ng access sa API"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Pinagmulang address"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Prayoridad"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Mga grupo ng transmitter"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "Kailangang naka-install ang libdbus-1.so.x."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "Abiso ng DBus"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Pagkaapurahan"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "X na aksis"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Y na aksis"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "ID ng webhook"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Pagsasalita ng teksto"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Larawan ng avatar"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "URL ng avatar"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "ID ng thread"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Ipakita ang footer"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Logo sa footer"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Gamitin ang mga field"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Mga flag ng Discord"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Banggitin ang mga user o role"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Landas ng template"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Pagsamahin ang mga kalakip"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Mga token ng template"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Serial number ng device"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "Mode ng API"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "I-refresh ngayon"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Lagda ng teksto"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Icon sa Base64 (Text API)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Larawan sa Base64 (Image API)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Link"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Hangganan"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Uri ng dithering"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Kernel ng dithering"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Susi ng gawain"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Modal"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Landas"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Timeout ng server"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Pangalan ng instance"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "SID ng account"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Numero ng telepono ng nagpadala o ID ng nagpadala"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Pangalan ng rehiyon"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Susi ng access"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "Sa ID ng user"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "Sa ID ng channel"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Landas ng webhook"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Mode"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Pangalan ng thread"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "Pangalan ng user ng API"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "Password ng API"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Token ng access"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "May-ari"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Repository"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Uri"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Numero"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Mga label"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Mga itinalaga"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "Kailangang naka-install ang libdbus-1.so.x o libdbus-2.so.x."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "Abiso ng GLib"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "Kailangan ng lokal na Gnome environment."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Abiso ng Gnome"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Mga susi ng integrasyon"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Aksyon"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Susi ng deduplikasyon"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Metadata"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Workspace"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Susi ng webhook"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Susi ng thread"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Plataporma"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Paksa"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Mga entry ng datos"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "ID ng bot"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Bersyon"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Nakapaskil"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Pangmatagalang token ng access"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "ID ng abiso"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Unlapi ng landas"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Token o pangalan ng user"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Mga kaganapan"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Magdagdag ng token"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Mag-alis ng token"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Susi ng integrasyon"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Ruta"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "ID ng Pinagmulan ng Alerto"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Escalation na padadalhan"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Iskedyul na padadalhan"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "User na padadalhan"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Mga padadalhan "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Entity"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Alyas"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Mga detalye"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Pagtutugma ng aksyon"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "ID ng device"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Pangalan ng device"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Pinagmulang numero ng telepono"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Tagal"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Susi ng server"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Susi ng API ng device"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "ID ng app"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "Bersyon ng app"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "Token ng access ng app"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Pasadyang icon"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Uri ng icon"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Mga siklo"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Token ng bot"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "URL ng pag-click"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Kulay"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Gumagana lamang sa Mac OS X 10.8 at mas bago. Kailangan rin na naa-access "
"nang lokal ang /usr/local/bin/terminal-notifier."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "Abiso ng MacOSX"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "URL na bubuksan o i-click"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Bersyon ng Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Nagpadala"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Sagutin sa"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Domain"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Pangalan ng nagpadala"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "Header ng email"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Pagkakita"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Nakatagong teksto"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Code ng wika"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Itago ang resulta sa cache"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Mga sensitibong kalakip"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Banggitin ang mga user o tag"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "User"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "ID ng channel na padadalhan"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Pinakadaming bahagi ng mensahe"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Pasadyang sanggunian"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Pila na padadalhan"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "ID ng client"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Gumamit ng session"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Itago ang mga mensahe"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "ID ng template"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Susi ng pagpapatotoo"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "Maikling URL"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Pagtutugma ng template"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "Unlapi ng URL"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "ID ng room"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Tahimik na abiso"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "ID ng kaganapan sa Discord"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Pinagmulan"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "ID ng proyekto"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Hook ng mensahe"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "Mga kulay ng IRC"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Unlapi"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Pangalan ng kampanya"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Pangalan ng template"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Sanggunian ng client"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Mataas na kalidad"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Header ng fax"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Kalakip"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Pangalan ng file ng kalakip"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Pagkaantala"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "Email"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Mga aksyon"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Uri ng pagpapatotoo"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "Login sa API"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Tanggapin ang mga sagot"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Layunin"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Domain ng tenant"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "Email ng account o ID ng object"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Sekreto ng client"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Itabi sa mga naipadala"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Template"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "ID ng player na padadalhan"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Isama ang segment"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Subtitulo"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Wika"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Paganahin ang nilalaman"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "I-decode ang mga argumento ng template"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Pasadyang datos"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Datos ng postback"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "ID ng user na padadalhan"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "ID ng grupong padadalhan"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Bahagi"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Klase"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Kalubhaan"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Pasadyang detalye"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "ID ng integrasyon"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "ID ng third party"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Karagdagan ng Meta"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Pangunahing susi"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Device"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Namespace"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Mga badge"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Uri ng mensahe"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "ID ng padadalhan"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "SMS na padadalhan"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Mga channel"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "ID ng pagpapatotoo"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Token ng pagpapatotoo"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Susi ng provider"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Susi ng abiso"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Susi ng aplikasyon"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Sekreto ng aplikasyon"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Sekretong susi"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Ipakita ang status"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Susi ng user"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "Titulo ng URL"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Agwat ng muling pagsubok sa emergency"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Pag-expire"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Token ng user"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Mga paksa ng grupo"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Channel"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Pangalan ng webhook"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Pribadong susi"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Pag-vibrate"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Antas ng impormasyon"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Antas ng tagumpay"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Antas ng babala"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Antas ng pagpalya"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Sekretong susi ng API"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Paksang padadalhan"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "ID ng aplikasyon"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Subreddit na padadalhan"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Klase ng nilalaman"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "ID ng flair"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Teksto ng flair"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "Patalastas ba?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Ipadala ang mga sagot"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "May spoiler"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Flag ng muling pagsumite"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Address ng nagpadala"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "ID ng channel"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "Naka-embed na URL"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Token o password"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Kapaligiran"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Mode ng pagpapatotoo"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "ID ng room na padadalhan"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Mode ng webhook"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Gamitin ang avatar"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Pasilidad"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "Itala ang PID"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Organisasyon"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Datos ng template"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Pangalan ng nagpadala"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Token ng session"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "ID ng susi ng access"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Sekretong susi ng access"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Mga email na padadalhan"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Flash"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Label"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "ID ng serbisyo"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Password ng serbisyo"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "ID ng space"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Numero ng telepono ng tatanggap"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Uri ng media"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Timeout"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Boses ng pagsasalita"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Susi ng client"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Kritikal na abiso"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Serbisyo"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Lokasyon"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Senaryo ng pag-alerto"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Pagsala"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "Panlabas na ID"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Status"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Target na Miyembro"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Ibinahagi"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Tag"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Maikling code na padadalhan"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "Token ng access ng OAuth"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Token A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Token B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Token C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "Naka-encode na ID ng padadalhan"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Landas ng workflow"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Isama ang footer"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Gumamit ng mga block"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Isama ang timestamp"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Mode ng mensahe"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Host"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Login"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Isalin ang titik"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Contact na padadalhan"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Pagsubok lamang"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Gateway"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Pampublikong susi"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Binhi"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Mga room"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Susi ng ruta ng padadalhan"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "ID ng entity"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Uri ng alerto"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Link ng larawan"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Link ng tunog"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Espesyal na kulay ng teksto"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Halaga"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Pera"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Pangalan"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Pantukoy"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Pag-upload"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Itala sa STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "ID ng chat na padadalhan"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Alamin ang may-ari ng bot"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Preview ng web page"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Igrupo ang mga attachment na larawan/video"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "ID ng thread ng paksa"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Bersyon ng Markdown"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Lagay ng nilalaman"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Landas ng template ng pormatadong mensahe"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "ID ng profile ng pagmemensahe"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "ID ng gateway"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "Threema ID na padadalhan"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "Pangalan ng host ng API"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "URL ng larawan"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Uri ng kaganapan"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Prayoridad (angkop sa Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Paraan ng abiso: sms o tawag"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Susi ng consumer"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Sekreto ng consumer"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Sekreto ng access"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Token ng pagpapatotoo"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "Mga ID ng tatanggap"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "URL ng avatar ng bot"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "Email ng user"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Token ng access ng bot"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "Mga ID ng room"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "ID ng kompanya"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "Sekreto ng app"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "ID ng ahente"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Departamentong padadalhan"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Tag na padadalhan"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Susi ng webhook ng bot"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "ID ng telepono ng nagpadala"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "Kailangan ng lokal na Microsoft Windows environment."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "ID ng workflow"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Lagda"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Gamitin ang URL ng Power Automate"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "ID ng ruta ng Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Ibalot ang teksto"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "Bersyon ng API"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Mga paksa"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Code ng grupo o opsyon"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "Token ng app"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Token o susi"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Prayoridad ng impormasyon"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Prayoridad ng tagumpay"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Prayoridad ng babala"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Prayoridad ng pagpalya"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Label ng link"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Token ng pagpapatunay"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Stream na padadalhan"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"I-install ang pika para sa AMQP 0.9.1, python-qpid-proton para sa AMQP 1.0, "
"o pareho."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Exchange"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Virtual Host"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Persistent"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Kinakailangan"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Tagal ng Buhay (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Mga Header ng Mensahe"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "SMTP server"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Sigurong mode"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "Mode ng seguridad ng PGP"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "Landas ng pampublikong susi ng PGP"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "Landas ng pribadong susi ng PGP"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Direktoryo ng susi sa web"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Naka-embed na kalakip"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "Email ng tatanggap"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "File ng susi ng OAuth2"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "Pasadyang URL ng larawan"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Kulay ng abiso"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Tunay na pangalan"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Palayaw"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Sumali sa mga channel"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Mode ng pagpapatotoo"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Alyas ng room na padadalhan"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Pagtuklas ng server"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Ipilit ang home server sa mga ID ng room"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Bersyon ng API ng Matrix"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "End-to-end na pag-encrypt"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Awtomatikong pagpapatunay ng device"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "File ng pribadong susi na PEM"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "File ng subscription"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "XMPP server"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Kunin ang listahan ng contact"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Gamitin ang subject"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Panatilihing bukas ang koneksyon"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "Palayaw sa MUC"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "Pag-ugnay ng channel na SCRAM-PLUS"
caronc-apprise-dfec414/apprise/i18n/tr/000077500000000000000000000000001526720371000177665ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/tr/LC_MESSAGES/000077500000000000000000000000001526720371000215535ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/tr/LC_MESSAGES/apprise.po000066400000000000000000002031211526720371000235550ustar00rootroot00000000000000# Turkish translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: tr\n"
"Language-Team: tr \n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "SSL doğrula"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Yönlendirmeleri izle"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Yuva okuma zaman aşımı"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Yuva bağlantı zaman aşımı"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Önbellek yaşı"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Zorunlu MIME türü"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Zorunlu dosya adı"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Yerel dosya"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Web tabanlı"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Bellek"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Şema"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Bağımlılık yok."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "Çalışması için paketler gereklidir."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "İşlevselliği artırmak için paketler önerilir."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "Uygulama kullanıcı adı"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "API anahtarı"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Hedef telefon"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Hedefler"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Gönderen"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "SMS kipi"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Toplu kip"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Sunucu adı"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Kapı"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Kullanıcı adı"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Parola"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Belirteç"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Etiketler"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Sorgu yöntemi"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Apprise API sürümü"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "HTTP başlığı"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Kullanıcı adı"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Hedef çağrı işareti"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Yeniden gönderme gecikmesi"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Yerel ayar"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Hedef aygıt"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Ses"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Düzey"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Ses düzeyi"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Tıklama"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Simge rozeti"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Kategori"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Grup"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Resmi ekle"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "Simge adresi"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Arama"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Şifreleme anahtarı"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Taşma kipi"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Bildirim biçimi"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Emojileri yorumla"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Kalıcı depolama"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Saat dilimi"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Hizmet yeniden denemeleri"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Denemeler arası bekleme"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "İsteğe bağlı hizmet"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "Gönderen e-postası"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Hedef takım"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Eskalasyon Politikası"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Uyarı Yöntemleri"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Ekip Bekleme Süresi"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Seri numarası"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Süre (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Geçiş süresi (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "LED numarası"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Kaynak e-posta"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Hedef e-posta"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "Yanıt e-postası"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Bilgi"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Gizli bilgi"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Parola"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Hedef telefon numarası"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Hedef grup"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Gönderen telefon numarası"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Yönlendirme grubu"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Unicode karakterler"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "API parolası"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "Gönderen kimliği"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "Ülke"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "geçerlilik"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "API belirteci"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Web kancası belirteci"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Bot adı"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Hedef kanal"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Hedef bot"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Bölge"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "Şirket kimliği"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "Herkese Gönder"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Getirme yöntemi"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Dosyayı şu adla ekle"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Yük ekleri"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "GET parametreleri"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "API erişim belirteci"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Kaynak adres"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Öncelik"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Verici grupları"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "libdbus-1.so.x kurulu olmalıdır."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "DBus bildirimi"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Aciliyet"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "X ekseni"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Y ekseni"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "Web kancası kimliği"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Metin okuma"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Avatar resmi"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "Avatar adresi"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "Konu kimliği"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Alt bilgiyi göster"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Alt bilgi logosu"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Alanları kullan"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Discord bayrakları"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Kullanıcıları veya rolleri an"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Şablon yolu"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Ekleri birleştir"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Şablon belirteçleri"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Aygıt seri numarası"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "API kipi"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Şimdi yenile"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Metin imzası"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Base64 simge (metin API'si)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Base64 resim (resim API'si)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Bağlantı"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Kenarlık"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Karıştırma türü"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Karıştırma çekirdeği"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Görev anahtarı"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Kalıcı pencere"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Yol"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Sunucu zaman aşımı"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Örnek adı"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "Hesap SID'si"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Gönderen telefon numarası veya gönderen kimliği"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Bölge adı"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Erişim anahtarı"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "Hedef kullanıcı kimliği"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "Hedef kanal kimliği"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Web kancası yolu"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Kip"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Konu adı"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "API kullanıcı adı"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "API parolası"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Erişim belirteci"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Sahip"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Depo"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Tür"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Numara"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Etiketler"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Atananlar"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "libdbus-1.so.x veya libdbus-2.so.x kurulu olmalıdır."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "GLib bildirimi"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "Yerel bir Gnome ortamı gereklidir."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Gnome bildirimi"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Tümleştirme anahtarları"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Eylem"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Yinelenenleri kaldırma anahtarı"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Üst veriler"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Çalışma alanı"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Web kancası anahtarı"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Konu anahtarı"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Platform"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Konu"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Veri girdileri"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "Bot kimliği"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Sürüm"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Sabitlenmiş"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Uzun ömürlü erişim belirteci"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "Bildirim kimliği"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Yol ön eki"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Belirteç veya kullanıcı adı"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Olaylar"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Belirteç ekle"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Belirteç kaldır"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Tümleştirme anahtarı"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Yol"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "Uyarı Kaynağı Kimliği"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Hedef yükseltme"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Hedef takvim"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Hedef kullanıcı"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Hedefler "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Varlık"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Takma ad"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Ayrıntılar"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Eylem eşlemesi"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "Aygıt kimliği"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Aygıt adı"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Kaynak telefon numarası"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Süre"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Sunucu anahtarı"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Aygıt API anahtarı"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "Uygulama kimliği"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "Uygulama sürümü"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "Uygulama erişim belirteci"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Özel simge"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Simge türü"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Çevrimler"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Bot belirteci"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "Tıklama adresi"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Renk"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Yalnızca Mac OS X 10.8 ve daha yeni sürümlerde çalışır. Ayrıca /usr/local/"
"bin/terminal-notifier dosyasının yerel olarak erişilebilir olması gerekir."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "MacOSX bildirimi"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "Açma veya tıklama adresi"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Terminal-Notifier sürümü"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Gönderen"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Yanıt adresi"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Alan adı"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Gönderen adı"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "E-posta başlığı"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Görünürlük"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Gizlenen metin"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Dil kodu"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Sonuçları önbelleğe al"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Hassas ekler"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Kullanıcıları veya etiketleri an"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "Kullanıcı"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "Hedef kanal kimliği"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "En fazla ileti parçası"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Özel başvuru"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Hedef kuyruk"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "İstemci kimliği"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Oturum kullan"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "İletileri sakla"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "Şablon kimliği"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Kimlik doğrulama anahtarı"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "Kısa adres"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Şablon eşlemesi"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "Adres ön eki"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "Oda kimliği"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Sessiz bildirim"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Discord olay kimliği"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Kaynak"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "Proje kimliği"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "İleti kancası"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "IRC renkleri"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Ön ek"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Kampanya adı"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Şablon adı"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "İstemci başvurusu"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Yüksek kalite"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Faks başlığı"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Ek"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Ek dosya adı"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Gecikme"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "E-posta"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Eylemler"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Kimlik doğrulama türü"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "API oturum adı"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Yanıtları kabul et"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Amaç"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Kiracı alan adı"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "Hesap e-postası veya nesne kimliği"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "İstemci parolası"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Gönderilmiş öğelere kaydet"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Şablon"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "Hedef oynatıcı kimliği"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Bölümü ekle"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Alt başlık"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Dil"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "İçeriği etkinleştir"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Şablon argümanlarını çöz"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Özel veriler"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Geri bildirim verileri"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "Hedef kullanıcı kimliği"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "Hedef grup kimliği"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Bileşen"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Sınıf"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Önem derecesi"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Özel ayrıntılar"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "Tümleştirme kimliği"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "Üçüncü taraf kimliği"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Meta ekleri"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Ana anahtar"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Aygıt"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Ad alanı"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Simge rozetleri"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "İleti türü"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "Hedef kimliği"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "Hedef SMS"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Kanallar"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "Kimlik doğrulama kimliği"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Kimlik doğrulama belirteci"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Sağlayıcı anahtarı"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Bildirim anahtarı"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Uygulama anahtarı"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Uygulama parolası"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Gizli anahtar"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Durumu göster"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Kullanıcı anahtarı"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "Adres başlığı"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Acil yeniden deneme aralığı"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Son kullanma"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Kullanıcı belirteci"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Grup konuları"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Kanal"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Web kancası adı"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Özel anahtar"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Titreşim"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Bilgi düzeyi"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Başarı düzeyi"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Uyarı düzeyi"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Hata düzeyi"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Gizli API anahtarı"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Hedef konu"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "Uygulama kimliği"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Hedef alt Reddit"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Tür"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "Etiket kimliği"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Etiket metni"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "Reklam mı?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Yanıtları gönder"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "Sürpriz bozan içerir"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Yeniden gönderme bayrağı"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Gönderen adresi"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "Kanal kimliği"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "Gömülü adres"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Belirteç veya parola"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Ortam"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Kimlik doğrulama kipi"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Web kancası"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "Hedef oda kimliği"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Web kancası kipi"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Avatarı kullan"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Hizmet birimi"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "PID'yi kaydet"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Kuruluş"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Şablon verileri"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Gönderen adı"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Oturum belirteci"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "Erişim anahtarı kimliği"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Gizli erişim anahtarı"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Hedef e-postalar"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Flaş"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Etiket"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "Hizmet kimliği"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Hizmet parolası"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "Alan kimliği"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Alıcı telefon numarası"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Ortam türü"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Zaman aşımı"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Metin okuma sesi"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "İstemci anahtarı"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Kritik bildirim"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Hizmet"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Konum"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Uyarı senaryosu"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Süzme"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "Dış kimlik"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Durum"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Hedef Üye"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Paylaşılan"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Etiket"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Hedef kısa kod"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "OAuth erişim belirteci"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Belirteç A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Belirteç B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Belirteç C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "Hedef kodlanmış kimlik"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "İş akışı yolu"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Alt bilgiyi ekle"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Blokları kullan"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Zaman damgasını ekle"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "İleti kipi"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Sunucu"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Oturum adı"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Harf çevirisi yap"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Hedef kişi"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Yalnızca sınama"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Geçit"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Açık anahtar"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Tohum"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Odalar"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Hedef yönlendirme anahtarı"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "Varlık kimliği"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Uyarı türü"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Resim bağlantısı"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Ses bağlantısı"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Özel metin rengi"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Tutar"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Para birimi"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Ad"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Tanımlayıcı"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Yükleme"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "STDERR'e kaydet"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "Hedef sohbet kimliği"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Bot sahibini algıla"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Web sayfası ön izlemesi"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Fotoğraf/video eklerini grupla"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "Konu başlığı kimliği"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Markdown sürümü"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "İçerik yerleşimi"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Biçimli ileti şablonu yolu"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "İletileşme profili kimliği"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "Geçit kimliği"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "Hedef Threema kimliği"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "API sunucu adı"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "Resim adresi"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Olay türü"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Öncelik (Pushover uyumluluğu)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Bildirim yöntemi: sms veya arama"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Tüketici anahtarı"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Tüketici parolası"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Erişim parolası"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Kimlik doğrulama belirteci"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "Alıcı kimlikleri"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "Bot avatar adresi"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "Kullanıcı e-postası"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Bot erişim belirteci"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "Oda kimlikleri"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "Kurum kimliği"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "Uygulama parolası"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "Temsilci kimliği"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Hedef bölüm"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Hedef etiket"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Bot web kancası anahtarı"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "Gönderen telefon kimliği"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "Yerel bir Microsoft Windows ortamı gereklidir."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "İş akışı kimliği"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "İmza"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Power Automate adresini kullan"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Power Automate yönlendirme kimliği"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Metni kaydır"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "API sürümü"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Konular"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Grup veya seçenek kodu"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "Uygulama belirteci"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Belirteç veya anahtar"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Bilgi önceliği"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Başarı önceliği"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Uyarı önceliği"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Hata önceliği"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Bağlantı etiketi"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Doğrulama belirteci"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Hedef akış"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"AMQP 0.9.1 için pika, AMQP 1.0 için python-qpid-proton veya her ikisini "
"kurun."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Exchange"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Sanal Ana Bilgisayar"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Kalıcı"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Zorunlu"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Yaşam Süresi (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Mesaj Başlıkları"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "SMTP sunucusu"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Güvenli kip"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "PGP güvenlik kipi"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "PGP açık anahtar yolu"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "PGP özel anahtar yolu"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Web anahtar dizini"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Gömülü ekler"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "Alıcı e-postası"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "OAuth2 anahtar dosyası"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "Özel resim adresi"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Bildirim rengi"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Gerçek ad"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Takma ad"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Kanallara katıl"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Kimlik doğrulama kipi"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Hedef oda takma adı"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Sunucu keşfi"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Oda kimliklerinde ana sunucuyu zorla"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Matrix API sürümü"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "Uçtan uca şifreleme"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Kendiliğinden aygıt doğrulama"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "PEM özel anahtar dosyası"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "Abonelik dosyası"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "XMPP sunucusu"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Kişi listesini al"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Konuyu kullan"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Bağlantıyı açık tut"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "MUC takma adı"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "SCRAM-PLUS kanal bağlama"
caronc-apprise-dfec414/apprise/i18n/vi/000077500000000000000000000000001526720371000177575ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/vi/LC_MESSAGES/000077500000000000000000000000001526720371000215445ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/vi/LC_MESSAGES/apprise.po000066400000000000000000002062661526720371000235630ustar00rootroot00000000000000# Vietnamese translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: vi\n"
"Language-Team: vi \n"
"Plural-Forms: nplurals=1; plural=0;\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "Xác minh SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "Đi theo chuyển hướng"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "Thời gian chờ đọc socket"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "Thời gian chờ kết nối socket"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "Tuổi của bộ đệm"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "Loại MIME bắt buộc"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "Tên tệp bắt buộc"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "Tệp cục bộ"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "Trên web"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "Bộ nhớ"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "Lược đồ"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "Không có phụ thuộc."

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "Cần có các gói để hoạt động."

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "Nên cài các gói để cải thiện tính năng."

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "Tên người dùng ứng dụng"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "Khóa API"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "Điện thoại đích"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "Đích đến"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "Người gửi"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "Chế độ SMS"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "Chế độ theo lô"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "Tên máy chủ"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "Cổng"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "Tên người dùng"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "Mật khẩu"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "Mã thông báo"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "Thẻ"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "Phương thức truy vấn"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Phiên bản API Apprise"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "Tiêu đề HTTP"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "Tên người dùng"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "Tín hiệu gọi đích"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "Độ trễ gửi lại"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "Thiết lập vùng"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "Thiết bị đích"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "Âm thanh"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "Mức"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "Âm lượng"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "Nhấp"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "Huy hiệu"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "Danh mục"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "Nhóm"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "Kèm hình ảnh"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "URL biểu tượng"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "Cuộc gọi"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "Khóa mã hóa"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "Chế độ khi vượt quá"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "Định dạng thông báo"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "Diễn giải emoji"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "Lưu trữ lâu dài"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "Múi giờ"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "Số lần thử lại của dịch vụ"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "Thời gian chờ giữa các lần thử"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "Dịch vụ tùy chọn"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "Email người gửi"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "Nhóm trực đích"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "Chính sách leo thang"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "Phương thức cảnh báo"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "Thời gian chờ nhóm"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "Số sê-ri"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "Thời lượng (ms)"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "Thời gian mờ dần (ms)"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "Số hiệu đèn LED"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "Email nguồn"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "Email đích"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "Email để trả lời"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "Bản sao"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "Bản sao ẩn"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "Mã bí mật"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "Số điện thoại đích"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "Nhóm đích"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "Số điện thoại người gửi"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "Nhóm định tuyến"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Ký tự Unicode"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "Mã bí mật API"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "ID người gửi"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "Quốc gia"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "hiệu lực"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "Mã thông báo API"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Mã thông báo webhook"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "Tên bot"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "Kênh đích"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "Bot đích"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "Vùng"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "ID công ty"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "Phát cho tất cả"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "Phương thức lấy dữ liệu"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "Đính kèm tệp dưới tên"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "Phần bổ sung của dữ liệu gửi"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "Tham số GET"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "Mã thông báo truy cập API"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "Địa chỉ xuất phát"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "Độ ưu tiên"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "Nhóm bộ phát"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "Phải cài đặt libdbus-1.so.x."

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "Thông báo DBus"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "Mức khẩn cấp"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "Trục X"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Trục Y"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "ID webhook"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "Chuyển văn bản thành giọng nói"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "Ảnh đại diện"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "URL ảnh đại diện"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "ID chủ đề"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "Hiện chân trang"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "Logo ở chân trang"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "Dùng các trường"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Cờ của Discord"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "Nhắc người dùng hoặc vai trò"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "Đường dẫn mẫu"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "Gộp các tệp đính kèm"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "Mã thông báo của mẫu"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "Số sê-ri thiết bị"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "Chế độ API"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "Làm mới ngay"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "Chữ ký văn bản"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Biểu tượng dạng Base64 (API văn bản)"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Hình ảnh dạng Base64 (API hình ảnh)"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "Liên kết"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "Đường viền"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "Kiểu tạo hạt"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "Lõi tạo hạt"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "Khóa công việc"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "Hộp thoại"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "Đường dẫn"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "Thời gian chờ máy chủ"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "Tên phiên bản"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "SID của tài khoản"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "Số điện thoại người gửi hoặc ID người gửi"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "Tên vùng"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "Khóa truy cập"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "Đến ID người dùng"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "Đến ID kênh"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Đường dẫn webhook"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "Chế độ"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "Tên chủ đề"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "Tên người dùng API"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "Mật khẩu API"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "Mã thông báo truy cập"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "Chủ sở hữu"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "Kho mã"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "Loại"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "Số"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "Các nhãn"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "Người được giao"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "Phải cài đặt libdbus-1.so.x hoặc libdbus-2.so.x."

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "Thông báo GLib"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "Cần có môi trường Gnome cục bộ."

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Thông báo Gnome"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "Các khóa tích hợp"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "Hành động"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "Khóa chống trùng lặp"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "Dữ liệu mô tả"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "Không gian làm việc"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Khóa webhook"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "Khóa chủ đề"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "Nền tảng"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "Chủ đề"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "Mục dữ liệu"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "ID bot"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "Phiên bản"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "Được ghim"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "Mã thông báo truy cập dài hạn"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "ID thông báo"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "Tiền tố đường dẫn"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "Mã thông báo hoặc tên người dùng"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "Sự kiện"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "Thêm mã thông báo"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "Xóa mã thông báo"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "Khóa tích hợp"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "Tuyến"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "ID nguồn cảnh báo"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "Mức chuyển tiếp đích"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "Lịch trực đích"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "Người dùng đích"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "Đích đến "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "Thực thể"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "Bí danh"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "Chi tiết"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "Ánh xạ hành động"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "ID thiết bị"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "Tên thiết bị"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "Số điện thoại nguồn"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "Thời lượng"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "Khóa máy chủ"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "Khóa API thiết bị"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "ID ứng dụng"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "Phiên bản ứng dụng"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "Mã thông báo truy cập ứng dụng"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "Biểu tượng riêng"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "Loại biểu tượng"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "Số chu kỳ"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "Mã thông báo bot"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "URL khi nhấp"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "Màu"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"Chỉ hoạt động với Mac OS X 10.8 trở lên. Ngoài ra, cần truy cập được /usr/"
"local/bin/terminal-notifier trên máy."

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "Thông báo MacOSX"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "URL để mở hoặc nhấp"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Phiên bản Terminal-Notifier"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "Người gửi"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "Trả lời đến"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "Tên miền"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "Tên người gửi"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "Tiêu đề email"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "Khả năng xem"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "Văn bản ẩn"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "Mã ngôn ngữ"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "Lưu kết quả vào bộ đệm"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "Tệp đính kèm nhạy cảm"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "Nhắc người dùng hoặc thẻ"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "Người dùng"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "ID kênh đích"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "Số phần tối đa của tin nhắn"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "Tham chiếu riêng"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "Hàng đợi đích"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "ID ứng dụng khách"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "Dùng phiên"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "Giữ lại tin nhắn"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "ID mẫu"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "Khóa xác thực"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "URL ngắn"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "Ánh xạ mẫu"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "Tiền tố URL"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "ID phòng"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "Thông báo im lặng"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "ID sự kiện Discord"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "Nguồn"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "ID dự án"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "Móc tin nhắn"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "Màu IRC"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "Tiền tố"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "Tên chiến dịch"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "Tên mẫu"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "Tham chiếu của khách"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "Chất lượng cao"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "Tiêu đề fax"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "Tệp đính kèm"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "Tên tệp đính kèm"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "Độ trễ"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "Email"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "Hành động"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "Loại xác thực"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "Tên đăng nhập API"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "Nhận trả lời"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "Mục đích"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "Tên miền của tổ chức"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "Email tài khoản hoặc ID đối tượng"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "Mã bí mật của ứng dụng khách"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "Lưu vào thư đã gửi"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "Mẫu"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "ID người chơi đích"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "Kèm phân khúc"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "Phụ đề"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "Ngôn ngữ"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "Bật nội dung"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "Giải mã tham số của mẫu"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "Dữ liệu riêng"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "Dữ liệu phản hồi"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "ID người dùng đích"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "ID nhóm đích"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "Thành phần"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "Lớp"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "Mức nghiêm trọng"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "Chi tiết riêng"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "ID tích hợp"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "ID bên thứ ba"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Phần bổ sung của Meta"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "Khóa chính"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "Thiết bị"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "Không gian tên"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "Huy hiệu"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "Loại tin nhắn"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "ID đích"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "SMS đích"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "Kênh"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "ID xác thực"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "Mã thông báo xác thực"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "Khóa nhà cung cấp"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "Khóa thông báo"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "Khóa ứng dụng"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "Mã bí mật ứng dụng"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "Khóa bí mật"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "Hiện trạng thái"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "Khóa người dùng"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "Tiêu đề URL"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "Khoảng thời gian thử lại khẩn cấp"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "Hết hạn"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "Mã thông báo người dùng"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "Chủ đề của nhóm"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "Kênh"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Tên webhook"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "Khóa riêng"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "Rung"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "Mức thông tin"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "Mức thành công"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "Mức cảnh báo"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "Mức lỗi"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "Khóa API bí mật"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "Chủ đề đích"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "ID ứng dụng"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "Subreddit đích"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "Loại nội dung"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "ID nhãn"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "Văn bản nhãn"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "Là quảng cáo?"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "Gửi trả lời"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "Có nội dung tiết lộ"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "Cờ gửi lại"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "Địa chỉ người gửi"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "ID kênh"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "URL nhúng"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "Mã thông báo hoặc mật khẩu"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "Môi trường"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "Chế độ xác thực"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "ID phòng đích"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Chế độ webhook"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "Dùng ảnh đại diện"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "Phân hệ"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "Ghi lại PID"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "Tổ chức"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "Dữ liệu của mẫu"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "Tên người gửi"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "Mã thông báo phiên"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "ID khóa truy cập"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "Khóa truy cập bí mật"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "Các email đích"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "Đèn nháy"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "Nhãn"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "ID dịch vụ"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "Mật khẩu dịch vụ"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "ID không gian"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "Số điện thoại người nhận"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "Loại nội dung"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "Thời gian chờ"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "Giọng đọc"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "Khóa ứng dụng khách"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "Thông báo quan trọng"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "Dịch vụ"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "Vị trí"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "Tình huống cảnh báo"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "Lọc"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "ID bên ngoài"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "Trạng thái"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "Thành viên đích"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "Chia sẻ"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "Thẻ"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "Mã ngắn đích"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "Mã thông báo truy cập OAuth"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "Mã thông báo A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "Mã thông báo B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "Mã thông báo C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "ID đã mã hóa của đích"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "Đường dẫn luồng công việc"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "Kèm chân trang"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "Dùng khối"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "Kèm dấu thời gian"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "Chế độ tin nhắn"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "Máy chủ"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "Tên đăng nhập"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "Chuyển tự"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "Liên hệ đích"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "Chỉ thử nghiệm"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "Cổng kết nối"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "Khóa công khai"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "Hạt giống"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "Các phòng"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "Khóa định tuyến đích"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "ID thực thể"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "Loại cảnh báo"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "Liên kết hình ảnh"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "Liên kết âm thanh"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "Màu văn bản đặc biệt"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "Số tiền"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "Tiền tệ"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "Tên"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "Mã định danh"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "Tải lên"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "Ghi lại vào STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "ID cuộc trò chuyện đích"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "Phát hiện chủ sở hữu bot"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "Xem trước trang web"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "Nhóm tệp đính kèm ảnh/video"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "ID luồng của chủ đề"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Phiên bản Markdown"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "Vị trí nội dung"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "Đường dẫn mẫu tin nhắn có định dạng"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "ID hồ sơ tin nhắn"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "ID cổng kết nối"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "ID Threema đích"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "Tên máy chủ API"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "URL hình ảnh"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "Loại sự kiện"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "Độ ưu tiên (tương thích Pushover)"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "Cách thông báo: sms hoặc gọi"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "Khóa người dùng API"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "Mã bí mật người dùng API"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "Mã bí mật truy cập"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "Mã thông báo xác thực"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "Các ID người nhận"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "URL ảnh đại diện của bot"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "Email người dùng"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "Mã thông báo truy cập của bot"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "Các ID phòng"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "ID doanh nghiệp"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "Mã bí mật ứng dụng"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "ID nhân viên"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "Phòng ban đích"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "Thẻ đích"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "Khóa webhook của bot"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "ID điện thoại người gửi"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "Cần có môi trường Microsoft Windows cục bộ."

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "ID luồng công việc"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "Chữ ký"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "Dùng URL Power Automate"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "ID định tuyến Power Automate"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "Ngắt dòng văn bản"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "Phiên bản API"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "Chủ đề"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "Mã nhóm hoặc tùy chọn"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "Mã thông báo ứng dụng"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "Mã thông báo hoặc khóa"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "Độ ưu tiên của thông tin"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "Độ ưu tiên của thành công"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "Độ ưu tiên của cảnh báo"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "Độ ưu tiên của lỗi"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "Nhãn liên kết"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "Mã thông báo xác minh"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "Luồng đích"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"Cài đặt pika cho AMQP 0.9.1, python-qpid-proton cho AMQP 1.0, hoặc cả hai."

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "Exchange"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "Máy chủ ảo"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "Lưu bền"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "Bắt buộc"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "Thời gian tồn tại (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "Tiêu đề tin nhắn"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "Máy chủ SMTP"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "Chế độ bảo mật"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "Chế độ bảo mật PGP"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "Đường dẫn khóa công khai PGP"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "Đường dẫn khóa riêng PGP"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "Thư mục khóa trên web"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "Tệp đính kèm nhúng"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "Email người nhận"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "Tệp khóa OAuth2"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "URL hình ảnh riêng"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "Màu thông báo"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "Tên thật"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "Biệt danh"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "Tham gia các kênh"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "Chế độ xác thực"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "Bí danh phòng đích"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "Tìm kiếm máy chủ"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "Buộc dùng máy chủ gốc cho ID phòng"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Phiên bản API Matrix"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "Mã hóa đầu cuối"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "Tự động xác minh thiết bị"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "Tệp khóa riêng PEM"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "Tệp đăng ký"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "Máy chủ XMPP"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "Lấy danh sách liên hệ"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "Dùng tiêu đề"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "Giữ kết nối mở"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "Biệt danh MUC"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "Liên kết kênh SCRAM-PLUS"
caronc-apprise-dfec414/apprise/i18n/zh/000077500000000000000000000000001526720371000177625ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/zh/LC_MESSAGES/000077500000000000000000000000001526720371000215475ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/i18n/zh/LC_MESSAGES/apprise.po000066400000000000000000002004121526720371000235510ustar00rootroot00000000000000# Chinese translations for apprise.
# Copyright (C) 2026 Chris Caron
# This file is distributed under the same license as the apprise project.
# Chris Caron , 2026.
#
msgid ""
msgstr ""
"Project-Id-Version: apprise 2.1.0\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
"POT-Creation-Date: 2026-10-24 15:11-0400\n"
"PO-Revision-Date: 2026-09-25 12:00-0400\n"
"Last-Translator: Chris Caron \n"
"Language: zh\n"
"Language-Team: zh \n"
"Plural-Forms: nplurals=1; plural=0;\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.18.0\n"

#: apprise/attachment/base.py:97 apprise/url.py:158
msgid "Verify SSL"
msgstr "验证 SSL"

#: apprise/url.py:168
msgid "Follow Redirects"
msgstr "跟随重定向"

#: apprise/url.py:178
msgid "Socket Read Timeout"
msgstr "套接字读取超时"

#: apprise/url.py:192
msgid "Socket Connect Timeout"
msgstr "套接字连接超时"

#: apprise/attachment/base.py:83
msgid "Cache Age"
msgstr "缓存有效期"

#: apprise/attachment/base.py:89
msgid "Forced Mime Type"
msgstr "强制的 MIME 类型"

#: apprise/attachment/base.py:93
msgid "Forced File Name"
msgstr "强制的文件名"

#: apprise/attachment/file.py:41 apprise/config/file.py:41
msgid "Local File"
msgstr "本地文件"

#: apprise/attachment/http.py:50 apprise/config/http.py:55
msgid "Web Based"
msgstr "基于网络"

#: apprise/attachment/memory.py:46 apprise/config/memory.py:37
msgid "Memory"
msgstr "内存"

#: apprise/plugins/__init__.py:282
msgid "Schema"
msgstr "架构"

#: apprise/plugins/__init__.py:421
msgid "No dependencies."
msgstr "没有依赖项。"

#: apprise/plugins/__init__.py:424
msgid "Packages are required to function."
msgstr "需要安装软件包才能使用。"

#: apprise/plugins/__init__.py:428
msgid "Packages are recommended to improve functionality."
msgstr "建议安装软件包以增强功能。"

#: apprise/plugins/africas_talking.py:142
msgid "App User Name"
msgstr "应用用户名"

#: apprise/plugins/africas_talking.py:148 apprise/plugins/brevo.py:159
#: apprise/plugins/burstsms.py:105 apprise/plugins/clicksend.py:99
#: apprise/plugins/dot.py:136 apprise/plugins/evolution.py:120
#: apprise/plugins/exotel.py:214 apprise/plugins/fcm/__init__.py:144
#: apprise/plugins/flowtriq.py:113 apprise/plugins/httpsms.py:78
#: apprise/plugins/jira.py:231 apprise/plugins/join.py:141
#: apprise/plugins/kavenegar.py:116 apprise/plugins/kumulos.py:88
#: apprise/plugins/mailersend.py:128 apprise/plugins/mailgun.py:140
#: apprise/plugins/messagebird.py:79 apprise/plugins/notifyre.py:131
#: apprise/plugins/octopush.py:137 apprise/plugins/one_signal.py:115
#: apprise/plugins/opsgenie.py:229 apprise/plugins/pagerduty.py:154
#: apprise/plugins/pinglet.py:138 apprise/plugins/pingram.py:182
#: apprise/plugins/postmark.py:118 apprise/plugins/prowl.py:122
#: apprise/plugins/resend.py:108 apprise/plugins/resend.py:146
#: apprise/plugins/sendgrid.py:117 apprise/plugins/seven.py:76
#: apprise/plugins/smsmanager.py:107 apprise/plugins/smtp2go.py:119
#: apprise/plugins/sparkpost.py:170 apprise/plugins/splunk.py:166
#: apprise/plugins/techuluspush.py:98 apprise/plugins/telnyx.py:88
#: apprise/plugins/trigv.py:143 apprise/plugins/twilio.py:197
#: apprise/plugins/vapid/__init__.py:162 apprise/plugins/vonage.py:81
#: apprise/plugins/wpush.py:158
msgid "API Key"
msgstr "API 密钥"

#: apprise/plugins/africas_talking.py:155 apprise/plugins/fortysixelks.py:107
msgid "Target Phone"
msgstr "目标电话"

#: apprise/plugins/africas_talking.py:160 apprise/plugins/amqp/base.py:183
#: apprise/plugins/aprs.py:191 apprise/plugins/bark.py:179
#: apprise/plugins/brevo.py:176 apprise/plugins/bulksms.py:148
#: apprise/plugins/bulkvs.py:111 apprise/plugins/burstsms.py:132
#: apprise/plugins/clickatell.py:91 apprise/plugins/clicksend.py:113
#: apprise/plugins/cliq.py:191 apprise/plugins/d7networks.py:111
#: apprise/plugins/dapnet.py:139 apprise/plugins/dingtalk.py:115
#: apprise/plugins/eight00com.py:129 apprise/plugins/email/base.py:168
#: apprise/plugins/evolution.py:149 apprise/plugins/exotel.py:191
#: apprise/plugins/fcm/__init__.py:169 apprise/plugins/flock.py:126
#: apprise/plugins/fortysixelks.py:112 apprise/plugins/gorush.py:180
#: apprise/plugins/home_assistant.py:155 apprise/plugins/httpsms.py:98
#: apprise/plugins/humhub.py:150 apprise/plugins/irc/base.py:150
#: apprise/plugins/join.py:173 apprise/plugins/kavenegar.py:136
#: apprise/plugins/kook.py:179 apprise/plugins/line.py:94
#: apprise/plugins/mailersend.py:145 apprise/plugins/mailgun.py:151
#: apprise/plugins/mastodon.py:211 apprise/plugins/matrix/base.py:340
#: apprise/plugins/mattermost.py:195 apprise/plugins/messagebird.py:100
#: apprise/plugins/mobilemessage.py:145 apprise/plugins/mqtt.py:178
#: apprise/plugins/msg91.py:124 apprise/plugins/nextcloud.py:148
#: apprise/plugins/nextcloudtalk.py:135 apprise/plugins/notifiarr.py:104
#: apprise/plugins/notifyre.py:144 apprise/plugins/ntfy.py:242
#: apprise/plugins/octopush.py:154 apprise/plugins/office365.py:288
#: apprise/plugins/one_signal.py:143 apprise/plugins/onebot.py:167
#: apprise/plugins/pingram.py:205 apprise/plugins/plivo.py:118
#: apprise/plugins/postmark.py:134 apprise/plugins/pushbullet.py:106
#: apprise/plugins/pushed.py:108 apprise/plugins/pushover.py:399
#: apprise/plugins/pushsafer.py:377 apprise/plugins/pushy.py:98
#: apprise/plugins/reddit.py:173 apprise/plugins/resend.py:125
#: apprise/plugins/revolt.py:113 apprise/plugins/ringcentral.py:220
#: apprise/plugins/rocketchat.py:168 apprise/plugins/sendgrid.py:134
#: apprise/plugins/sendpulse.py:141 apprise/plugins/serwersms.py:162
#: apprise/plugins/seven.py:89 apprise/plugins/sfr.py:114
#: apprise/plugins/signal_api.py:164 apprise/plugins/simplepush.py:195
#: apprise/plugins/sinch.py:141 apprise/plugins/slack.py:289
#: apprise/plugins/smpp.py:133 apprise/plugins/smsc.py:157
#: apprise/plugins/smseagle.py:173 apprise/plugins/smsmanager.py:120
#: apprise/plugins/sns.py:172 apprise/plugins/telegram.py:609
#: apprise/plugins/telnyx.py:108 apprise/plugins/threema.py:116
#: apprise/plugins/trigv.py:156 apprise/plugins/twilio.py:177
#: apprise/plugins/twist.py:124 apprise/plugins/twitter.py:194
#: apprise/plugins/vapid/__init__.py:168 apprise/plugins/voipms.py:109
#: apprise/plugins/vonage.py:109 apprise/plugins/wechat.py:219
#: apprise/plugins/whatsapp.py:167 apprise/plugins/wxpusher.py:140
#: apprise/plugins/xmpp/base.py:135 apprise/plugins/zalo.py:125
#: apprise/plugins/zulip.py:154
msgid "Targets"
msgstr "目标"

#: apprise/plugins/africas_talking.py:176
msgid "From"
msgstr "发送方"

#: apprise/plugins/africas_talking.py:182
msgid "SMS Mode"
msgstr "短信模式"

#: apprise/plugins/africas_talking.py:191 apprise/plugins/bulksms.py:181
#: apprise/plugins/bulkvs.py:132 apprise/plugins/burstsms.py:167
#: apprise/plugins/clicksend.py:131 apprise/plugins/d7networks.py:145
#: apprise/plugins/dapnet.py:168 apprise/plugins/exotel.py:223
#: apprise/plugins/home_assistant.py:172 apprise/plugins/jira.py:283
#: apprise/plugins/mailgun.py:188 apprise/plugins/mastodon.py:256
#: apprise/plugins/mobilemessage.py:182 apprise/plugins/octopush.py:174
#: apprise/plugins/one_signal.py:190 apprise/plugins/opsgenie.py:308
#: apprise/plugins/plivo.py:141 apprise/plugins/signal_api.py:186
#: apprise/plugins/smseagle.py:212 apprise/plugins/smsmanager.py:153
#: apprise/plugins/smtp2go.py:152 apprise/plugins/sparkpost.py:210
#: apprise/plugins/twitter.py:219
msgid "Batch Mode"
msgstr "批量模式"

#: apprise/plugins/amqp/base.py:163 apprise/plugins/apprise_api.py:126
#: apprise/plugins/bark.py:153 apprise/plugins/betterstack.py:152
#: apprise/plugins/custom_form.py:140 apprise/plugins/custom_json.py:122
#: apprise/plugins/custom_xml.py:122 apprise/plugins/emby.py:86
#: apprise/plugins/enigma2.py:111 apprise/plugins/evolution.py:126
#: apprise/plugins/flowtriq.py:119 apprise/plugins/fluxer.py:187
#: apprise/plugins/goalert.py:151 apprise/plugins/gorush.py:155
#: apprise/plugins/gotify.py:130 apprise/plugins/growl.py:140
#: apprise/plugins/home_assistant.py:124 apprise/plugins/humhub.py:139
#: apprise/plugins/irc/base.py:118 apprise/plugins/kodi.py:96
#: apprise/plugins/lametric.py:461 apprise/plugins/mastodon.py:189
#: apprise/plugins/matrix/base.py:295 apprise/plugins/mattermost.py:161
#: apprise/plugins/misskey.py:118 apprise/plugins/mqtt.py:150
#: apprise/plugins/nextcloud.py:116 apprise/plugins/nextcloudtalk.py:102
#: apprise/plugins/notica.py:127 apprise/plugins/notifico.py:167
#: apprise/plugins/ntfy.py:212 apprise/plugins/onebot.py:137
#: apprise/plugins/parseplatform.py:91 apprise/plugins/pinglet.py:144
#: apprise/plugins/pushdeer.py:76 apprise/plugins/pushjet.py:72
#: apprise/plugins/rocketchat.py:121 apprise/plugins/rsyslog.py:181
#: apprise/plugins/signal_api.py:123 apprise/plugins/smseagle.py:136
#: apprise/plugins/sogs.py:209 apprise/plugins/synology.py:86
#: apprise/plugins/workflows.py:139 apprise/plugins/xmpp/base.py:102
msgid "Hostname"
msgstr "主机名"

#: apprise/plugins/amqp/base.py:168 apprise/plugins/apprise_api.py:131
#: apprise/plugins/bark.py:158 apprise/plugins/betterstack.py:156
#: apprise/plugins/custom_form.py:145 apprise/plugins/custom_json.py:127
#: apprise/plugins/custom_xml.py:127 apprise/plugins/email/base.py:157
#: apprise/plugins/emby.py:91 apprise/plugins/enigma2.py:116
#: apprise/plugins/evolution.py:131 apprise/plugins/flowtriq.py:124
#: apprise/plugins/fluxer.py:191 apprise/plugins/goalert.py:156
#: apprise/plugins/gorush.py:160 apprise/plugins/gotify.py:141
#: apprise/plugins/growl.py:145 apprise/plugins/home_assistant.py:129
#: apprise/plugins/humhub.py:144 apprise/plugins/irc/base.py:123
#: apprise/plugins/kodi.py:101 apprise/plugins/lametric.py:465
#: apprise/plugins/mastodon.py:199 apprise/plugins/matrix/base.py:300
#: apprise/plugins/mattermost.py:177 apprise/plugins/misskey.py:128
#: apprise/plugins/mqtt.py:155 apprise/plugins/nextcloud.py:121
#: apprise/plugins/nextcloudtalk.py:107 apprise/plugins/notica.py:131
#: apprise/plugins/notifico.py:171 apprise/plugins/ntfy.py:216
#: apprise/plugins/onebot.py:142 apprise/plugins/parseplatform.py:96
#: apprise/plugins/pinglet.py:149 apprise/plugins/pushdeer.py:80
#: apprise/plugins/pushjet.py:77 apprise/plugins/rocketchat.py:126
#: apprise/plugins/rsyslog.py:186 apprise/plugins/signal_api.py:128
#: apprise/plugins/smpp.py:113 apprise/plugins/smseagle.py:141
#: apprise/plugins/sogs.py:214 apprise/plugins/synology.py:91
#: apprise/plugins/trigv.py:164 apprise/plugins/workflows.py:144
#: apprise/plugins/xmpp/base.py:107
msgid "Port"
msgstr "端口"

#: apprise/plugins/apprise_api.py:137 apprise/plugins/bark.py:164
#: apprise/plugins/bluesky.py:126 apprise/plugins/custom_form.py:151
#: apprise/plugins/custom_json.py:133 apprise/plugins/custom_xml.py:133
#: apprise/plugins/emby.py:98 apprise/plugins/enigma2.py:122
#: apprise/plugins/freemobile.py:79 apprise/plugins/gorush.py:166
#: apprise/plugins/home_assistant.py:135 apprise/plugins/jira.py:237
#: apprise/plugins/kodi.py:107 apprise/plugins/lametric.py:472
#: apprise/plugins/matrix/base.py:306 apprise/plugins/nextcloud.py:127
#: apprise/plugins/nextcloudtalk.py:113 apprise/plugins/notica.py:137
#: apprise/plugins/notifico.py:177 apprise/plugins/ntfy.py:222
#: apprise/plugins/opsgenie.py:235 apprise/plugins/pushjet.py:89
#: apprise/plugins/rocketchat.py:132 apprise/plugins/serwersms.py:132
#: apprise/plugins/signal_api.py:134 apprise/plugins/smpp.py:97
#: apprise/plugins/synology.py:97
msgid "Username"
msgstr "用户名"

#: apprise/plugins/amqp/base.py:178 apprise/plugins/apprise_api.py:141
#: apprise/plugins/aprs.py:176 apprise/plugins/bark.py:168
#: apprise/plugins/bluesky.py:131 apprise/plugins/bulkvs.py:91
#: apprise/plugins/custom_form.py:155 apprise/plugins/custom_json.py:137
#: apprise/plugins/custom_xml.py:137 apprise/plugins/dapnet.py:124
#: apprise/plugins/email/base.py:147 apprise/plugins/emby.py:102
#: apprise/plugins/enigma2.py:126 apprise/plugins/freemobile.py:84
#: apprise/plugins/gorush.py:170 apprise/plugins/growl.py:151
#: apprise/plugins/home_assistant.py:139 apprise/plugins/humhub.py:134
#: apprise/plugins/irc/base.py:133 apprise/plugins/kodi.py:111
#: apprise/plugins/matrix/base.py:310 apprise/plugins/mqtt.py:166
#: apprise/plugins/nextcloud.py:131 apprise/plugins/nextcloudtalk.py:118
#: apprise/plugins/notica.py:141 apprise/plugins/notifico.py:181
#: apprise/plugins/ntfy.py:226 apprise/plugins/pushjet.py:93
#: apprise/plugins/reddit.py:148 apprise/plugins/rocketchat.py:136
#: apprise/plugins/serwersms.py:137 apprise/plugins/signal_api.py:138
#: apprise/plugins/simplepush.py:179 apprise/plugins/smpp.py:102
#: apprise/plugins/smsc.py:144 apprise/plugins/synology.py:101
#: apprise/plugins/twist.py:102 apprise/plugins/voipms.py:89
#: apprise/plugins/xmpp/base.py:118
msgid "Password"
msgstr "密码"

#: apprise/plugins/apprise_api.py:146 apprise/plugins/betterstack.py:146
#: apprise/plugins/bulksms.py:121 apprise/plugins/chanify.py:75
#: apprise/plugins/dingtalk.py:97 apprise/plugins/exotel.py:167
#: apprise/plugins/feishu.py:81 apprise/plugins/gotify.py:124
#: apprise/plugins/incidentio.py:127 apprise/plugins/kook.py:173
#: apprise/plugins/lauther.py:116 apprise/plugins/lfgalarm.py:99
#: apprise/plugins/mattermost.py:167 apprise/plugins/notica.py:120
#: apprise/plugins/notifiarr.py:92 apprise/plugins/ntfy.py:231
#: apprise/plugins/pushme.py:63 apprise/plugins/ryver.py:100
#: apprise/plugins/serverchan.py:71 apprise/plugins/slack.py:339
#: apprise/plugins/synology.py:106 apprise/plugins/zulip.py:137
msgid "Token"
msgstr "令牌"

#: apprise/plugins/apprise_api.py:160 apprise/plugins/jira.py:302
#: apprise/plugins/ntfy.py:290 apprise/plugins/opsgenie.py:295
#: apprise/plugins/pagertree.py:148 apprise/plugins/squadcast.py:194
msgid "Tags"
msgstr "标签"

#: apprise/plugins/apprise_api.py:164
msgid "Query Method"
msgstr "查询方式"

#: apprise/plugins/apprise_api.py:170
msgid "Apprise API Version"
msgstr "Apprise API 版本"

#: apprise/plugins/apprise_api.py:184 apprise/plugins/custom_form.py:184
#: apprise/plugins/custom_json.py:160 apprise/plugins/custom_xml.py:160
#: apprise/plugins/enigma2.py:154 apprise/plugins/nextcloud.py:181
#: apprise/plugins/nextcloudtalk.py:162 apprise/plugins/notica.py:157
#: apprise/plugins/pagertree.py:157 apprise/plugins/synology.py:131
msgid "HTTP Header"
msgstr "HTTP 标头"

#: apprise/plugins/amqp/base.py:174 apprise/plugins/aprs.py:171
#: apprise/plugins/bulkvs.py:86 apprise/plugins/clicksend.py:94
#: apprise/plugins/dapnet.py:119 apprise/plugins/email/base.py:143
#: apprise/plugins/mailgun.py:130 apprise/plugins/mqtt.py:161
#: apprise/plugins/reddit.py:143 apprise/plugins/sendpulse.py:112
#: apprise/plugins/smtp2go.py:109 apprise/plugins/sparkpost.py:160
msgid "User Name"
msgstr "用户名"

#: apprise/plugins/aprs.py:182 apprise/plugins/aprs.py:203
#: apprise/plugins/dapnet.py:130 apprise/plugins/dapnet.py:163
msgid "Target Callsign"
msgstr "目标呼号"

#: apprise/plugins/aprs.py:208
msgid "Resend Delay"
msgstr "重发延迟"

#: apprise/plugins/aprs.py:215
msgid "Locale"
msgstr "区域设置"

#: apprise/plugins/bark.py:173 apprise/plugins/fcm/__init__.py:158
#: apprise/plugins/gorush.py:175 apprise/plugins/home_assistant.py:150
#: apprise/plugins/pushbullet.py:90 apprise/plugins/pushover.py:387
#: apprise/plugins/pushsafer.py:367 apprise/plugins/pushy.py:86
msgid "Target Device"
msgstr "目标设备"

#: apprise/plugins/bark.py:192 apprise/plugins/gorush.py:210
#: apprise/plugins/lametric.py:517 apprise/plugins/lauther.py:139
#: apprise/plugins/macosx.py:166 apprise/plugins/pushover.py:416
#: apprise/plugins/pushsafer.py:393 apprise/plugins/pushy.py:111
msgid "Sound"
msgstr "声音"

#: apprise/plugins/bark.py:197 apprise/plugins/pushward.py:153
msgid "Level"
msgstr "级别"

#: apprise/plugins/bark.py:202 apprise/plugins/pushward.py:183
#: apprise/plugins/simplepush.py:221
msgid "Volume"
msgstr "音量"

#: apprise/plugins/bark.py:208 apprise/plugins/ilert.py:173
#: apprise/plugins/incidentio.py:156 apprise/plugins/ntfy.py:272
#: apprise/plugins/pagerduty.py:195
msgid "Click"
msgstr "点击"

#: apprise/plugins/bark.py:212 apprise/plugins/gorush.py:214
#: apprise/plugins/pushy.py:115
msgid "Badge"
msgstr "角标"

#: apprise/plugins/bark.py:217 apprise/plugins/github.py:245
msgid "Category"
msgstr "类别"

#: apprise/plugins/bark.py:221 apprise/plugins/join.py:159
#: apprise/plugins/lauther.py:158 apprise/plugins/pagerduty.py:186
#: apprise/plugins/youlmk.py:222
msgid "Group"
msgstr "群组"

#: apprise/plugins/bark.py:225 apprise/plugins/cliq.py:222
#: apprise/plugins/dbus.py:229 apprise/plugins/discord.py:236
#: apprise/plugins/fcm/__init__.py:198 apprise/plugins/flock.py:137
#: apprise/plugins/fluxer.py:287 apprise/plugins/glib.py:189
#: apprise/plugins/gnome.py:154 apprise/plugins/growl.py:175
#: apprise/plugins/ilert.py:177 apprise/plugins/join.py:184
#: apprise/plugins/kodi.py:129 apprise/plugins/line.py:109
#: apprise/plugins/macosx.py:157 apprise/plugins/matrix/base.py:351
#: apprise/plugins/mattermost.py:218 apprise/plugins/notifiarr.py:126
#: apprise/plugins/ntfy.py:258 apprise/plugins/one_signal.py:169
#: apprise/plugins/pagerduty.py:214 apprise/plugins/ryver.py:125
#: apprise/plugins/slack.py:307 apprise/plugins/telegram.py:620
#: apprise/plugins/vapid/__init__.py:214 apprise/plugins/windows.py:106
#: apprise/plugins/workflows.py:176 apprise/plugins/youlmk.py:229
msgid "Include Image"
msgstr "包含图片"

#: apprise/plugins/bark.py:231 apprise/plugins/lauther.py:147
#: apprise/plugins/mattermost.py:214 apprise/plugins/revolt.py:130
msgid "Icon URL"
msgstr "图标网址"

#: apprise/plugins/bark.py:235 apprise/plugins/streamlabs.py:122
msgid "Call"
msgstr "通话"

#: apprise/plugins/bark.py:240 apprise/plugins/pushover.py:448
msgid "Encryption Key"
msgstr "加密密钥"

#: apprise/plugins/base.py:349
msgid "Overflow Mode"
msgstr "超长处理方式"

#: apprise/plugins/base.py:364
msgid "Notify Format"
msgstr "通知格式"

#: apprise/plugins/base.py:380
msgid "Interpret Emojis"
msgstr "解析表情符号"

#: apprise/plugins/base.py:390
msgid "Persistent Storage"
msgstr "持久化存储"

#: apprise/plugins/base.py:400
msgid "Timezone"
msgstr "时区"

#: apprise/plugins/base.py:409
msgid "Service Retry"
msgstr "服务重试次数"

#: apprise/plugins/base.py:417
msgid "Inter-Retry Wait"
msgstr "重试间隔"

#: apprise/plugins/base.py:425
msgid "Optional Service"
msgstr "可选服务"

#: apprise/plugins/betterstack.py:162 apprise/plugins/email/base.py:178
#: apprise/plugins/pingram.py:243 apprise/plugins/sendpulse.py:152
#: apprise/plugins/ses.py:164
msgid "From Email"
msgstr "发送方邮箱"

#: apprise/plugins/betterstack.py:166 apprise/plugins/jira.py:259
#: apprise/plugins/opsgenie.py:257
msgid "Target Team"
msgstr "目标团队"

#: apprise/plugins/betterstack.py:186
msgid "Escalation Policy"
msgstr "升级策略"

#: apprise/plugins/betterstack.py:190
msgid "Alert Methods"
msgstr "告警方式"

#: apprise/plugins/betterstack.py:194
msgid "Team Wait"
msgstr "团队等待时间"

#: apprise/plugins/blink1.py:152
msgid "blink(1)"
msgstr "blink(1)"

#: apprise/plugins/blink1.py:179
msgid "Serial Number"
msgstr "序列号"

#: apprise/plugins/blink1.py:189
msgid "Duration (ms)"
msgstr "持续时间（毫秒）"

#: apprise/plugins/blink1.py:196
msgid "Fade Time (ms)"
msgstr "渐变时间（毫秒）"

#: apprise/plugins/blink1.py:203
msgid "LED Number"
msgstr "LED 编号"

#: apprise/plugins/brevo.py:166 apprise/plugins/mailersend.py:135
#: apprise/plugins/postmark.py:124 apprise/plugins/resend.py:115
#: apprise/plugins/sendgrid.py:124
msgid "Source Email"
msgstr "来源邮箱"

#: apprise/plugins/brevo.py:171 apprise/plugins/email/base.py:163
#: apprise/plugins/mailersend.py:140 apprise/plugins/mailgun.py:146
#: apprise/plugins/office365.py:283 apprise/plugins/one_signal.py:126
#: apprise/plugins/pingram.py:189 apprise/plugins/postmark.py:129
#: apprise/plugins/pushbullet.py:101 apprise/plugins/pushsafer.py:372
#: apprise/plugins/resend.py:120 apprise/plugins/sendgrid.py:129
#: apprise/plugins/sendpulse.py:136 apprise/plugins/slack.py:272
#: apprise/plugins/threema.py:106
msgid "Target Email"
msgstr "目标邮箱"

#: apprise/plugins/brevo.py:187 apprise/plugins/postmark.py:150
#: apprise/plugins/ses.py:206
msgid "Reply To Email"
msgstr "回复邮箱"

#: apprise/plugins/brevo.py:195 apprise/plugins/email/base.py:244
#: apprise/plugins/mailersend.py:159 apprise/plugins/mailgun.py:180
#: apprise/plugins/office365.py:308 apprise/plugins/pingram.py:252
#: apprise/plugins/postmark.py:158 apprise/plugins/resend.py:159
#: apprise/plugins/sendgrid.py:154 apprise/plugins/sendpulse.py:171
#: apprise/plugins/ses.py:233 apprise/plugins/smtp2go.py:144
#: apprise/plugins/sparkpost.py:202
msgid "Carbon Copy"
msgstr "抄送"

#: apprise/plugins/brevo.py:199 apprise/plugins/email/base.py:248
#: apprise/plugins/mailersend.py:163 apprise/plugins/mailgun.py:184
#: apprise/plugins/office365.py:312 apprise/plugins/pingram.py:256
#: apprise/plugins/postmark.py:162 apprise/plugins/resend.py:163
#: apprise/plugins/sendgrid.py:158 apprise/plugins/sendpulse.py:175
#: apprise/plugins/ses.py:237 apprise/plugins/smtp2go.py:148
#: apprise/plugins/sparkpost.py:206
msgid "Blind Carbon Copy"
msgstr "密送"

#: apprise/plugins/bulksms.py:127 apprise/plugins/dingtalk.py:104
#: apprise/plugins/nextcloudtalk.py:124 apprise/plugins/signl4.py:100
msgid "Secret"
msgstr "密文"

#: apprise/plugins/bulksms.py:134 apprise/plugins/bulkvs.py:104
#: apprise/plugins/burstsms.py:125 apprise/plugins/clickatell.py:84
#: apprise/plugins/clicksend.py:106 apprise/plugins/d7networks.py:104
#: apprise/plugins/dingtalk.py:110 apprise/plugins/eight00com.py:122
#: apprise/plugins/evolution.py:142 apprise/plugins/exotel.py:184
#: apprise/plugins/httpsms.py:91 apprise/plugins/kavenegar.py:129
#: apprise/plugins/messagebird.py:93 apprise/plugins/mobilemessage.py:138
#: apprise/plugins/msg91.py:117 apprise/plugins/notifyre.py:137
#: apprise/plugins/octopush.py:147 apprise/plugins/plivo.py:111
#: apprise/plugins/ringcentral.py:214 apprise/plugins/serwersms.py:149
#: apprise/plugins/seven.py:82 apprise/plugins/signal_api.py:150
#: apprise/plugins/sinch.py:128 apprise/plugins/smpp.py:126
#: apprise/plugins/smsc.py:150 apprise/plugins/smseagle.py:152
#: apprise/plugins/smsmanager.py:113 apprise/plugins/sns.py:159
#: apprise/plugins/telnyx.py:101 apprise/plugins/threema.py:99
#: apprise/plugins/twilio.py:164 apprise/plugins/voipms.py:102
#: apprise/plugins/vonage.py:102 apprise/plugins/whatsapp.py:148
msgid "Target Phone No"
msgstr "目标电话号码"

#: apprise/plugins/bulksms.py:141 apprise/plugins/nextcloud.py:142
#: apprise/plugins/pushover.py:393
msgid "Target Group"
msgstr "目标群组"

#: apprise/plugins/bulksms.py:160 apprise/plugins/bulkvs.py:97
#: apprise/plugins/bulkvs.py:123 apprise/plugins/clickatell.py:79
#: apprise/plugins/eight00com.py:115 apprise/plugins/eight00com.py:143
#: apprise/plugins/fortysixelks.py:101 apprise/plugins/httpsms.py:84
#: apprise/plugins/httpsms.py:116 apprise/plugins/ringcentral.py:208
#: apprise/plugins/signal_api.py:143 apprise/plugins/sinch.py:121
#: apprise/plugins/smpp.py:119 apprise/plugins/smsmanager.py:135
#: apprise/plugins/telnyx.py:94 apprise/plugins/telnyx.py:126
#: apprise/plugins/twilio.py:157 apprise/plugins/voipms.py:95
#: apprise/plugins/vonage.py:95
msgid "From Phone No"
msgstr "发送方电话号码"

#: apprise/plugins/bulksms.py:166
msgid "Route Group"
msgstr "路由群组"

#: apprise/plugins/bulksms.py:173 apprise/plugins/d7networks.py:137
#: apprise/plugins/exotel.py:229 apprise/plugins/mobilemessage.py:164
msgid "Unicode Characters"
msgstr "Unicode 字符"

#: apprise/plugins/burstsms.py:112 apprise/plugins/threema.py:93
#: apprise/plugins/vonage.py:88
msgid "API Secret"
msgstr "API 密文"

#: apprise/plugins/burstsms.py:119 apprise/plugins/mobilemessage.py:131
#: apprise/plugins/smsc.py:172
msgid "Sender ID"
msgstr "发送方标识"

#: apprise/plugins/burstsms.py:153
msgid "Country"
msgstr "国家或地区"

#: apprise/plugins/burstsms.py:162
msgid "validity"
msgstr "有效期"

#: apprise/plugins/chanify.py:48
msgid "Chanify"
msgstr "Chanify"

#: apprise/plugins/clickatell.py:46
msgid "Clickatell"
msgstr "Clickatell"

#: apprise/plugins/clickatell.py:73 apprise/plugins/eight00com.py:109
#: apprise/plugins/rocketchat.py:141 apprise/plugins/simplepush.py:173
msgid "API Token"
msgstr "API 令牌"

#: apprise/plugins/cliq.py:168 apprise/plugins/discord.py:176
#: apprise/plugins/fluxer.py:215 apprise/plugins/google_chat.py:132
#: apprise/plugins/stackfield.py:93 apprise/plugins/webexteams.py:172
msgid "Webhook Token"
msgstr "Webhook 令牌"

#: apprise/plugins/cliq.py:175 apprise/plugins/discord.py:165
#: apprise/plugins/flock.py:107 apprise/plugins/fluxer.py:203
#: apprise/plugins/ryver.py:107 apprise/plugins/slack.py:224
#: apprise/plugins/viber.py:100 apprise/plugins/zulip.py:125
msgid "Bot Name"
msgstr "机器人名称"

#: apprise/plugins/cliq.py:179 apprise/plugins/irc/base.py:144
#: apprise/plugins/mattermost.py:183 apprise/plugins/notifiarr.py:98
#: apprise/plugins/pushbullet.py:95 apprise/plugins/pushed.py:102
#: apprise/plugins/rocketchat.py:151 apprise/plugins/slack.py:283
#: apprise/plugins/trigv.py:151 apprise/plugins/twist.py:113
#: apprise/plugins/xmpp/base.py:129
msgid "Target Channel"
msgstr "目标频道"

#: apprise/plugins/cliq.py:185
msgid "Target Bot"
msgstr "目标机器人"

#: apprise/plugins/cliq.py:212 apprise/plugins/ses.py:182
#: apprise/plugins/sinch.py:158 apprise/plugins/sns.py:152
msgid "Region"
msgstr "区域"

#: apprise/plugins/cliq.py:218
msgid "Company ID"
msgstr "公司 ID"

#: apprise/plugins/cliq.py:228 apprise/plugins/simplepush.py:206
msgid "Broadcast"
msgstr "广播"

#: apprise/plugins/custom_form.py:167 apprise/plugins/custom_json.py:149
#: apprise/plugins/custom_xml.py:149
msgid "Fetch Method"
msgstr "获取方式"

#: apprise/plugins/custom_form.py:173
msgid "Attach File As"
msgstr "附件命名为"

#: apprise/plugins/custom_form.py:188 apprise/plugins/custom_json.py:164
#: apprise/plugins/custom_xml.py:164 apprise/plugins/pagertree.py:161
msgid "Payload Extras"
msgstr "附加负载内容"

#: apprise/plugins/custom_form.py:192 apprise/plugins/custom_json.py:168
#: apprise/plugins/custom_xml.py:168
msgid "GET Params"
msgstr "GET 参数"

#: apprise/plugins/d7networks.py:98
msgid "API Access Token"
msgstr "API 访问令牌"

#: apprise/plugins/d7networks.py:128 apprise/plugins/seven.py:106
msgid "Originating Address"
msgstr "发起地址"

#: apprise/plugins/amqp/base.py:222 apprise/plugins/dapnet.py:151
#: apprise/plugins/exotel.py:241 apprise/plugins/gorush.py:201
#: apprise/plugins/gotify.py:154 apprise/plugins/growl.py:163
#: apprise/plugins/ilert.py:163 apprise/plugins/jira.py:288
#: apprise/plugins/join.py:190 apprise/plugins/lametric.py:495
#: apprise/plugins/lauther.py:133 apprise/plugins/ntfy.py:284
#: apprise/plugins/opsgenie.py:281 apprise/plugins/pinglet.py:178
#: apprise/plugins/prowl.py:142 apprise/plugins/pushover.py:410
#: apprise/plugins/pushsafer.py:388 apprise/plugins/simplepush.py:216
#: apprise/plugins/smseagle.py:188 apprise/plugins/squadcast.py:184
#: apprise/plugins/youlmk.py:177
msgid "Priority"
msgstr "优先级"

#: apprise/plugins/dapnet.py:157
msgid "Transmitter Groups"
msgstr "发射机群组"

#: apprise/plugins/dbus.py:157
msgid "libdbus-1.so.x must be installed."
msgstr "必须安装 libdbus-1.so.x。"

#: apprise/plugins/dbus.py:161
msgid "DBus Notification"
msgstr "DBus 通知"

#: apprise/plugins/dbus.py:205 apprise/plugins/glib.py:166
#: apprise/plugins/gnome.py:142 apprise/plugins/pagertree.py:143
#: apprise/plugins/trigv.py:190
msgid "Urgency"
msgstr "紧急程度"

#: apprise/plugins/dbus.py:217 apprise/plugins/glib.py:177
msgid "X-Axis"
msgstr "X 轴"

#: apprise/plugins/dbus.py:223 apprise/plugins/glib.py:183
msgid "Y-Axis"
msgstr "Y 轴"

#: apprise/plugins/discord.py:170 apprise/plugins/fluxer.py:208
#: apprise/plugins/ifttt.py:104 apprise/plugins/zoom.py:140
msgid "Webhook ID"
msgstr "Webhook 标识"

#: apprise/plugins/discord.py:189 apprise/plugins/fluxer.py:238
msgid "Text To Speech"
msgstr "文字转语音"

#: apprise/plugins/discord.py:194 apprise/plugins/fluxer.py:243
msgid "Avatar Image"
msgstr "头像图片"

#: apprise/plugins/discord.py:199 apprise/plugins/fluxer.py:248
#: apprise/plugins/ntfy.py:264
msgid "Avatar URL"
msgstr "头像网址"

#: apprise/plugins/discord.py:203 apprise/plugins/fluxer.py:252
#: apprise/plugins/pushover.py:422 apprise/plugins/trigv.py:181
msgid "URL"
msgstr "URL"

#: apprise/plugins/discord.py:212 apprise/plugins/fluxer.py:259
msgid "Thread ID"
msgstr "话题标识"

#: apprise/plugins/discord.py:216 apprise/plugins/fluxer.py:267
msgid "Display Footer"
msgstr "显示页脚"

#: apprise/plugins/discord.py:221 apprise/plugins/fluxer.py:272
msgid "Footer Logo"
msgstr "页脚徽标"

#: apprise/plugins/discord.py:226 apprise/plugins/fluxer.py:277
msgid "Use Fields"
msgstr "使用字段"

#: apprise/plugins/discord.py:231 apprise/plugins/fluxer.py:282
msgid "Discord Flags"
msgstr "Discord 标记"

#: apprise/plugins/discord.py:245 apprise/plugins/fluxer.py:293
msgid "Ping Users/Roles"
msgstr "提及用户或角色"

#: apprise/plugins/discord.py:249 apprise/plugins/slack.py:346
#: apprise/plugins/workflows.py:201
msgid "Template Path"
msgstr "模板路径"

#: apprise/plugins/discord.py:257
msgid "Batch Attachments"
msgstr "合并发送附件"

#: apprise/plugins/discord.py:267 apprise/plugins/mailgun.py:202
#: apprise/plugins/pingram.py:265 apprise/plugins/slack.py:356
#: apprise/plugins/sparkpost.py:224 apprise/plugins/telegram.py:679
#: apprise/plugins/workflows.py:222
msgid "Template Tokens"
msgstr "模板令牌"

#: apprise/plugins/dot.py:142
msgid "Device Serial Number"
msgstr "设备序列号"

#: apprise/plugins/dot.py:155
msgid "API Mode"
msgstr "API 模式"

#: apprise/plugins/dot.py:161
msgid "Refresh Now"
msgstr "立即刷新"

#: apprise/plugins/dot.py:167
msgid "Text Signature"
msgstr "文本签名"

#: apprise/plugins/dot.py:171
msgid "Icon Base64 (Text API)"
msgstr "Base64 图标（文本接口）"

#: apprise/plugins/dot.py:175
msgid "Image Base64 (Image API)"
msgstr "Base64 图片（图片接口）"

#: apprise/plugins/dot.py:180 apprise/plugins/simplepush.py:231
#: apprise/plugins/youlmk.py:210
msgid "Link"
msgstr "链接"

#: apprise/plugins/dot.py:184
msgid "Border"
msgstr "边框"

#: apprise/plugins/dot.py:191
msgid "Dither Type"
msgstr "抖动类型"

#: apprise/plugins/dot.py:197
msgid "Dither Kernel"
msgstr "抖动核"

#: apprise/plugins/dot.py:203
msgid "Task Key"
msgstr "任务密钥"

#: apprise/plugins/emby.py:113
msgid "Modal"
msgstr "模态窗口"

#: apprise/plugins/enigma2.py:131 apprise/plugins/fluxer.py:197
#: apprise/plugins/goalert.py:162 apprise/plugins/gotify.py:135
#: apprise/plugins/mattermost.py:173 apprise/plugins/notica.py:146
#: apprise/plugins/pinglet.py:155
msgid "Path"
msgstr "路径"

#: apprise/plugins/enigma2.py:141
msgid "Server Timeout"
msgstr "服务器超时"

#: apprise/plugins/evolution.py:137
msgid "Instance Name"
msgstr "实例名称"

#: apprise/plugins/exotel.py:161 apprise/plugins/sinch.py:107
#: apprise/plugins/twilio.py:143
msgid "Account SID"
msgstr "账户 SID"

#: apprise/plugins/exotel.py:173
msgid "From Phone No / Sender ID"
msgstr "发送方电话号码或发送方标识"

#: apprise/plugins/exotel.py:234 apprise/plugins/jira.py:276
#: apprise/plugins/mailgun.py:170 apprise/plugins/opsgenie.py:274
#: apprise/plugins/pagerduty.py:199 apprise/plugins/pingram.py:227
#: apprise/plugins/sparkpost.py:192 apprise/plugins/squadcast.py:167
msgid "Region Name"
msgstr "区域名称"

#: apprise/plugins/feishu.py:50
msgid "Feishu"
msgstr "Feishu"

#: apprise/plugins/flock.py:100 apprise/plugins/twitter.py:176
msgid "Access Key"
msgstr "访问密钥"

#: apprise/plugins/flock.py:112
msgid "To User ID"
msgstr "目标用户标识"

#: apprise/plugins/flock.py:119
msgid "To Channel ID"
msgstr "目标频道标识"

#: apprise/plugins/flowtriq.py:130 apprise/plugins/matrix/base.py:373
msgid "Webhook Path"
msgstr "Webhook 路径"

#: apprise/plugins/fcm/__init__.py:183 apprise/plugins/fcm/__init__.py:189
#: apprise/plugins/fluxer.py:229 apprise/plugins/kook.py:199
#: apprise/plugins/lametric.py:511 apprise/plugins/mattermost.py:230
#: apprise/plugins/notifyre.py:158 apprise/plugins/ntfy.py:298
#: apprise/plugins/office365.py:320 apprise/plugins/pingram.py:233
#: apprise/plugins/sns.py:204 apprise/plugins/vapid/__init__.py:179
#: apprise/plugins/webexteams.py:198 apprise/plugins/zoom.py:159
msgid "Mode"
msgstr "模式"

#: apprise/plugins/fluxer.py:263
msgid "Thread Name"
msgstr "话题名称"

#: apprise/plugins/fortysixelks.py:59
msgid "46elks"
msgstr "46elks"

#: apprise/plugins/fortysixelks.py:90 apprise/plugins/mobilemessage.py:120
msgid "API Username"
msgstr "API 用户名"

#: apprise/plugins/fortysixelks.py:95 apprise/plugins/mobilemessage.py:125
msgid "API Password"
msgstr "API 密码"

#: apprise/plugins/freemobile.py:49
msgid "Free-Mobile"
msgstr "Free-Mobile"

#: apprise/plugins/github.py:197 apprise/plugins/groupme.py:131
#: apprise/plugins/line.py:83 apprise/plugins/mastodon.py:194
#: apprise/plugins/matrix/base.py:315 apprise/plugins/misskey.py:123
#: apprise/plugins/onebot.py:148 apprise/plugins/pushbullet.py:84
#: apprise/plugins/pushover.py:381 apprise/plugins/smseagle.py:147
#: apprise/plugins/spugpush.py:69 apprise/plugins/streamlabs.py:108
#: apprise/plugins/whatsapp.py:122
msgid "Access Token"
msgstr "访问令牌"

#: apprise/plugins/github.py:204
msgid "Owner"
msgstr "所有者"

#: apprise/plugins/github.py:210
msgid "Repository"
msgstr "仓库"

#: apprise/plugins/github.py:216 apprise/plugins/octopush.py:190
msgid "Type"
msgstr "类型"

#: apprise/plugins/github.py:222
msgid "Number"
msgstr "编号"

#: apprise/plugins/github.py:237 apprise/plugins/ilert.py:188
msgid "Labels"
msgstr "标签"

#: apprise/plugins/github.py:241
msgid "Assignees"
msgstr "负责人"

#: apprise/plugins/glib.py:124
msgid "libdbus-1.so.x or libdbus-2.so.x must be installed."
msgstr "必须安装 libdbus-1.so.x 或 libdbus-2.so.x。"

#: apprise/plugins/glib.py:128
msgid "GLib Notification"
msgstr "GLib 通知"

#: apprise/plugins/gnome.py:100
msgid "A local Gnome environment is required."
msgstr "需要本地的 Gnome 环境。"

#: apprise/plugins/gnome.py:104
msgid "Gnome Notification"
msgstr "Gnome 通知"

#: apprise/plugins/goalert.py:168
msgid "Integration Keys"
msgstr "集成密钥列表"

#: apprise/plugins/goalert.py:187 apprise/plugins/ilert.py:153
#: apprise/plugins/incidentio.py:146 apprise/plugins/jira.py:309
#: apprise/plugins/opsgenie.py:299 apprise/plugins/pagerduty.py:220
#: apprise/plugins/pagertree.py:127 apprise/plugins/signl4.py:137
#: apprise/plugins/splunk.py:203 apprise/plugins/squadcast.py:174
msgid "Action"
msgstr "操作"

#: apprise/plugins/goalert.py:193 apprise/plugins/ilert.py:159
#: apprise/plugins/incidentio.py:152 apprise/plugins/pagerduty.py:226
#: apprise/plugins/squadcast.py:180
msgid "Deduplication Key"
msgstr "去重密钥"

#: apprise/plugins/goalert.py:202 apprise/plugins/incidentio.py:165
#: apprise/plugins/pinglet.py:196
msgid "Metadata"
msgstr "元数据"

#: apprise/plugins/google_chat.py:120
msgid "Workspace"
msgstr "工作区"

#: apprise/plugins/google_chat.py:126 apprise/plugins/squadcast.py:150
msgid "Webhook Key"
msgstr "Webhook 密钥"

#: apprise/plugins/google_chat.py:138
msgid "Thread Key"
msgstr "话题密钥"

#: apprise/plugins/gorush.py:192
msgid "Platform"
msgstr "平台"

#: apprise/plugins/gorush.py:206 apprise/plugins/ntfy.py:236
#: apprise/plugins/pinglet.py:166
msgid "Topic"
msgstr "主题"

#: apprise/plugins/fcm/__init__.py:216 apprise/plugins/gorush.py:227
msgid "Data Entries"
msgstr "数据条目"

#: apprise/plugins/groupme.py:124
msgid "Bot ID"
msgstr "机器人标识"

#: apprise/plugins/amqp/base.py:194 apprise/plugins/growl.py:169
#: apprise/plugins/mqtt.py:196 apprise/plugins/nextcloud.py:163
msgid "Version"
msgstr "版本"

#: apprise/plugins/growl.py:181
msgid "Sticky"
msgstr "置顶"

#: apprise/plugins/home_assistant.py:144
msgid "Long-Lived Access Token"
msgstr "长期访问令牌"

#: apprise/plugins/home_assistant.py:167
msgid "Notification ID"
msgstr "通知标识"

#: apprise/plugins/home_assistant.py:184
msgid "Path Prefix"
msgstr "路径前缀"

#: apprise/plugins/humhub.py:128
msgid "Token or Username"
msgstr "令牌或用户名"

#: apprise/plugins/ifttt.py:110
msgid "Events"
msgstr "事件"

#: apprise/plugins/ifttt.py:130
msgid "Add Tokens"
msgstr "添加令牌"

#: apprise/plugins/ifttt.py:134
msgid "Remove Tokens"
msgstr "移除令牌"

#: apprise/plugins/ilert.py:136 apprise/plugins/pagerduty.py:161
#: apprise/plugins/pushward.py:135 apprise/plugins/spike.py:69
msgid "Integration Key"
msgstr "集成密钥"

#: apprise/plugins/ilert.py:168 apprise/plugins/lauther.py:166
msgid "Route"
msgstr "路由"

#: apprise/plugins/incidentio.py:121
msgid "Alert Source ID"
msgstr "告警来源 ID"

#: apprise/plugins/jira.py:241 apprise/plugins/opsgenie.py:239
msgid "Target Escalation"
msgstr "目标升级流程"

#: apprise/plugins/jira.py:247 apprise/plugins/opsgenie.py:245
msgid "Target Schedule"
msgstr "目标排班"

#: apprise/plugins/irc/base.py:138 apprise/plugins/jira.py:253
#: apprise/plugins/line.py:89 apprise/plugins/mastodon.py:205
#: apprise/plugins/matrix/base.py:322 apprise/plugins/nextcloud.py:136
#: apprise/plugins/one_signal.py:131 apprise/plugins/opsgenie.py:251
#: apprise/plugins/pushed.py:96 apprise/plugins/rocketchat.py:157
#: apprise/plugins/slack.py:277 apprise/plugins/twitter.py:188
#: apprise/plugins/wechat.py:199 apprise/plugins/xmpp/base.py:124
#: apprise/plugins/zulip.py:144
msgid "Target User"
msgstr "目标用户"

#: apprise/plugins/jira.py:265 apprise/plugins/opsgenie.py:263
msgid "Targets "
msgstr "目标 "

#: apprise/plugins/jira.py:294 apprise/plugins/opsgenie.py:287
msgid "Entity"
msgstr "实体"

#: apprise/plugins/jira.py:298 apprise/plugins/opsgenie.py:291
msgid "Alias"
msgstr "别名"

#: apprise/plugins/jira.py:320 apprise/plugins/opsgenie.py:318
msgid "Details"
msgstr "详细信息"

#: apprise/plugins/jira.py:324 apprise/plugins/opsgenie.py:322
#: apprise/plugins/splunk.py:214
msgid "Action Mapping"
msgstr "操作映射"

#: apprise/plugins/join.py:148
msgid "Device ID"
msgstr "设备标识"

#: apprise/plugins/join.py:154
msgid "Device Name"
msgstr "设备名称"

#: apprise/plugins/kavenegar.py:123 apprise/plugins/messagebird.py:86
#: apprise/plugins/notifyre.py:164 apprise/plugins/plivo.py:104
msgid "Source Phone No"
msgstr "来源电话号码"

#: apprise/plugins/kodi.py:123 apprise/plugins/streamlabs.py:144
#: apprise/plugins/windows.py:100
msgid "Duration"
msgstr "持续时间"

#: apprise/plugins/kumulos.py:100
msgid "Server Key"
msgstr "服务器密钥"

#: apprise/plugins/lametric.py:437
msgid "Device API Key"
msgstr "设备 API 密钥"

#: apprise/plugins/lametric.py:443 apprise/plugins/one_signal.py:104
#: apprise/plugins/parseplatform.py:102
msgid "App ID"
msgstr "应用标识"

#: apprise/plugins/lametric.py:449
msgid "App Version"
msgstr "应用版本"

#: apprise/plugins/lametric.py:456
msgid "App Access Token"
msgstr "应用访问令牌"

#: apprise/plugins/lametric.py:501
msgid "Custom Icon"
msgstr "自定义图标"

#: apprise/plugins/lametric.py:505
msgid "Icon Type"
msgstr "图标类型"

#: apprise/plugins/lametric.py:522
msgid "Cycles"
msgstr "循环次数"

#: apprise/plugins/lark.py:48
msgid "Lark (Feishu)"
msgstr "Lark (Feishu)"

#: apprise/plugins/lark.py:68 apprise/plugins/revolt.py:99
#: apprise/plugins/telegram.py:594 apprise/plugins/zalo.py:113
msgid "Bot Token"
msgstr "机器人令牌"

#: apprise/plugins/lauther.py:143 apprise/plugins/wpush.py:211
msgid "Click URL"
msgstr "点击网址"

#: apprise/plugins/lauther.py:151
msgid "Color"
msgstr "颜色"

#: apprise/plugins/macosx.py:109
msgid ""
"Only works with Mac OS X 10.8 and higher. Additionally  requires that /usr/"
"local/bin/terminal-notifier is locally accessible."
msgstr ""
"仅支持 Mac OS X 10.8 及更高版本。此外还需要能在本地访问 /usr/local/bin/"
"terminal-notifier。"

#: apprise/plugins/macosx.py:116
msgid "MacOSX Notification"
msgstr "MacOSX 通知"

#: apprise/plugins/macosx.py:170
msgid "Open/Click URL"
msgstr "打开或点击的网址"

#: apprise/plugins/macosx.py:175
msgid "Terminal-Notifier Version"
msgstr "Terminal-Notifier 版本"

#: apprise/plugins/macosx.py:181 apprise/plugins/octopush.py:143
msgid "Sender"
msgstr "发送方"

#: apprise/plugins/email/base.py:200 apprise/plugins/mailersend.py:167
#: apprise/plugins/office365.py:316 apprise/plugins/pingram.py:238
#: apprise/plugins/resend.py:151
msgid "Reply To"
msgstr "回复地址"

#: apprise/plugins/email/base.py:152 apprise/plugins/mailgun.py:135
#: apprise/plugins/sendpulse.py:117 apprise/plugins/smtp2go.py:114
#: apprise/plugins/sparkpost.py:165
msgid "Domain"
msgstr "域名"

#: apprise/plugins/email/base.py:183 apprise/plugins/mailgun.py:162
#: apprise/plugins/postmark.py:145 apprise/plugins/resend.py:141
#: apprise/plugins/ses.py:211 apprise/plugins/smtp2go.py:136
#: apprise/plugins/sparkpost.py:187
msgid "From Name"
msgstr "发送方名称"

#: apprise/plugins/email/base.py:257 apprise/plugins/mailgun.py:198
#: apprise/plugins/smtp2go.py:162 apprise/plugins/sparkpost.py:220
msgid "Email Header"
msgstr "邮件标头"

#: apprise/plugins/mastodon.py:225 apprise/plugins/misskey.py:144
msgid "Visibility"
msgstr "可见性"

#: apprise/plugins/mastodon.py:231
msgid "Spoiler Text"
msgstr "隐藏文本"

#: apprise/plugins/mastodon.py:235
msgid "Idempotency-Key"
msgstr "Idempotency-Key"

#: apprise/plugins/mastodon.py:239
msgid "Language Code"
msgstr "语言代码"

#: apprise/plugins/mastodon.py:243 apprise/plugins/twitter.py:211
msgid "Cache Results"
msgstr "缓存结果"

#: apprise/plugins/mastodon.py:248
msgid "Sensitive Attachments"
msgstr "敏感附件"

#: apprise/plugins/mastodon.py:264
msgid "Ping Users/Tags"
msgstr "提及用户或标签"

#: apprise/plugins/irc/base.py:129 apprise/plugins/mattermost.py:157
#: apprise/plugins/xmpp/base.py:113
msgid "User"
msgstr "用户"

#: apprise/plugins/mattermost.py:189 apprise/plugins/twist.py:119
msgid "Target Channel ID"
msgstr "目标频道标识"

#: apprise/plugins/mobilemessage.py:170
msgid "Max Message Parts"
msgstr "消息最大分段数"

#: apprise/plugins/mobilemessage.py:177
msgid "Custom Reference"
msgstr "自定义参考号"

#: apprise/plugins/mqtt.py:172
msgid "Target Queue"
msgstr "目标队列"

#: apprise/plugins/mqtt.py:189
msgid "QOS"
msgstr "QOS"

#: apprise/plugins/mqtt.py:202 apprise/plugins/office365.py:270
#: apprise/plugins/ringcentral.py:193 apprise/plugins/sendpulse.py:122
msgid "Client ID"
msgstr "客户端标识"

#: apprise/plugins/mqtt.py:206
msgid "Use Session"
msgstr "使用会话"

#: apprise/plugins/mqtt.py:211
msgid "Retain Messages"
msgstr "保留消息"

#: apprise/plugins/msg91.py:103 apprise/plugins/sendpulse.py:158
msgid "Template ID"
msgstr "模板标识"

#: apprise/plugins/msg91.py:110
msgid "Authentication Key"
msgstr "认证密钥"

#: apprise/plugins/msg91.py:139
msgid "Short URL"
msgstr "短网址"

#: apprise/plugins/msg91.py:149 apprise/plugins/whatsapp.py:204
msgid "Template Mapping"
msgstr "模板映射"

#: apprise/plugins/nextcloud.py:169 apprise/plugins/nextcloudtalk.py:153
msgid "URL Prefix"
msgstr "网址前缀"

#: apprise/plugins/nextcloudtalk.py:64
msgid "Nextcloud Talk"
msgstr "Nextcloud Talk"

#: apprise/plugins/nextcloudtalk.py:130
msgid "Room ID"
msgstr "房间标识"

#: apprise/plugins/nextcloudtalk.py:148 apprise/plugins/telegram.py:632
msgid "Silent Notification"
msgstr "静默通知"

#: apprise/plugins/notifiarr.py:122
msgid "Discord Event ID"
msgstr "Discord 事件标识"

#: apprise/plugins/notifiarr.py:132 apprise/plugins/pagerduty.py:168
msgid "Source"
msgstr "来源"

#: apprise/plugins/fcm/__init__.py:154 apprise/plugins/notifico.py:188
msgid "Project ID"
msgstr "项目标识"

#: apprise/plugins/notifico.py:197
msgid "Message Hook"
msgstr "消息钩子"

#: apprise/plugins/notifico.py:212
msgid "IRC Colors"
msgstr "IRC 颜色"

#: apprise/plugins/notifico.py:218
msgid "Prefix"
msgstr "前缀"

#: apprise/plugins/notifyre.py:169
msgid "Campaign Name"
msgstr "活动名称"

#: apprise/plugins/notifyre.py:173 apprise/plugins/whatsapp.py:129
msgid "Template Name"
msgstr "模板名称"

#: apprise/plugins/notifyre.py:177
msgid "Client Reference"
msgstr "客户端参考号"

#: apprise/plugins/notifyre.py:181
msgid "High Quality"
msgstr "高质量"

#: apprise/plugins/notifyre.py:186
msgid "Fax Header"
msgstr "传真标头"

#: apprise/plugins/ntfy.py:254
msgid "Attach"
msgstr "附件"

#: apprise/plugins/ntfy.py:268
msgid "Attach Filename"
msgstr "附件文件名"

#: apprise/plugins/ntfy.py:276
msgid "Delay"
msgstr "延迟"

#: apprise/plugins/ntfy.py:280 apprise/plugins/twist.py:108
msgid "Email"
msgstr "电子邮件"

#: apprise/plugins/ntfy.py:294
msgid "Actions"
msgstr "操作"

#: apprise/plugins/ntfy.py:307
msgid "Authentication Type"
msgstr "认证类型"

#: apprise/plugins/octopush.py:131
msgid "API Login"
msgstr "API 登录名"

#: apprise/plugins/octopush.py:179
msgid "Accept Replies"
msgstr "接受回复"

#: apprise/plugins/octopush.py:184
msgid "Purpose"
msgstr "用途"

#: apprise/plugins/office365.py:258
msgid "Tenant Domain"
msgstr "租户域名"

#: apprise/plugins/office365.py:265
msgid "Account Email or Object ID"
msgstr "账户邮箱或对象标识"

#: apprise/plugins/office365.py:277 apprise/plugins/ringcentral.py:200
#: apprise/plugins/sendpulse.py:129
msgid "Client Secret"
msgstr "客户端密文"

#: apprise/plugins/office365.py:326
msgid "Save to Sent Items"
msgstr "保存到已发送项目"

#: apprise/plugins/one_signal.py:110 apprise/plugins/sendgrid.py:147
msgid "Template"
msgstr "模板"

#: apprise/plugins/one_signal.py:121
msgid "Target Player ID"
msgstr "目标播放器标识"

#: apprise/plugins/one_signal.py:137
msgid "Include Segment"
msgstr "包含受众分组"

#: apprise/plugins/one_signal.py:157
msgid "Subtitle"
msgstr "副标题"

#: apprise/plugins/one_signal.py:161 apprise/plugins/sfr.py:126
#: apprise/plugins/whatsapp.py:142
msgid "Language"
msgstr "语言"

#: apprise/plugins/one_signal.py:175
msgid "Enable Contents"
msgstr "启用正文"

#: apprise/plugins/one_signal.py:181
msgid "Decode Template Args"
msgstr "解码模板参数"

#: apprise/plugins/one_signal.py:200
msgid "Custom Data"
msgstr "自定义数据"

#: apprise/plugins/one_signal.py:204
msgid "Postback Data"
msgstr "回传数据"

#: apprise/plugins/onebot.py:153 apprise/plugins/wxpusher.py:134
msgid "Target User ID"
msgstr "目标用户标识"

#: apprise/plugins/onebot.py:160 apprise/plugins/serwersms.py:156
#: apprise/plugins/signal_api.py:157 apprise/plugins/smseagle.py:159
#: apprise/plugins/whatsapp.py:160
msgid "Target Group ID"
msgstr "目标群组标识"

#: apprise/plugins/pagerduty.py:174
msgid "Component"
msgstr "组件"

#: apprise/plugins/pagerduty.py:190
msgid "Class"
msgstr "类"

#: apprise/plugins/pagerduty.py:208
msgid "Severity"
msgstr "严重程度"

#: apprise/plugins/pagerduty.py:235
msgid "Custom Details"
msgstr "自定义详细信息"

#: apprise/plugins/pagertree.py:114
msgid "Integration ID"
msgstr "集成标识"

#: apprise/plugins/pagertree.py:133
msgid "Third Party ID"
msgstr "第三方标识"

#: apprise/plugins/pagertree.py:165
msgid "Meta Extras"
msgstr "Meta 附加内容"

#: apprise/plugins/parseplatform.py:108
msgid "Master Key"
msgstr "主密钥"

#: apprise/plugins/parseplatform.py:121
msgid "Device"
msgstr "设备"

#: apprise/plugins/pinglet.py:161
msgid "Namespace"
msgstr "命名空间"

#: apprise/plugins/pinglet.py:192
msgid "Badges"
msgstr "角标"

#: apprise/plugins/matrix/base.py:385 apprise/plugins/pingram.py:176
msgid "Message Type"
msgstr "消息类型"

#: apprise/plugins/pingram.py:194
msgid "Target ID"
msgstr "目标标识"

#: apprise/plugins/pingram.py:200
msgid "Target SMS"
msgstr "目标短信"

#: apprise/plugins/pingram.py:222 apprise/plugins/signalgrid.py:102
msgid "Channels"
msgstr "频道"

#: apprise/plugins/plivo.py:92
msgid "Auth ID"
msgstr "认证标识"

#: apprise/plugins/plivo.py:98 apprise/plugins/simplepush.py:235
#: apprise/plugins/sinch.py:114 apprise/plugins/twilio.py:150
msgid "Auth Token"
msgstr "认证令牌"

#: apprise/plugins/prowl.py:129
msgid "Provider Key"
msgstr "服务商密钥"

#: apprise/plugins/pushdeer.py:86
msgid "Pushkey"
msgstr "推送密钥"

#: apprise/plugins/pushed.py:84
msgid "Application Key"
msgstr "应用密钥"

#: apprise/plugins/pushed.py:90 apprise/plugins/reddit.py:161
msgid "Application Secret"
msgstr "应用密文"

#: apprise/plugins/pushjet.py:83
msgid "Secret Key"
msgstr "私密密钥"

#: apprise/plugins/pushme.py:82 apprise/plugins/signal_api.py:178
#: apprise/plugins/smseagle.py:194
msgid "Show Status"
msgstr "显示状态"

#: apprise/plugins/pushover.py:375
msgid "User Key"
msgstr "用户密钥"

#: apprise/plugins/pushover.py:427
msgid "URL Title"
msgstr "网址标题"

#: apprise/plugins/pushover.py:432
msgid "Emergency Retry Interval"
msgstr "紧急重试间隔"

#: apprise/plugins/pushover.py:438
msgid "Expire"
msgstr "过期时间"

#: apprise/plugins/pushover.py:455
msgid "E2EE"
msgstr "E2EE"

#: apprise/plugins/pushplus.py:173
msgid "Pushplus"
msgstr "Pushplus"

#: apprise/plugins/pushplus.py:211 apprise/plugins/qq.py:67
msgid "User Token"
msgstr "用户令牌"

#: apprise/plugins/pushplus.py:220
msgid "Group Topics"
msgstr "群组主题"

#: apprise/plugins/pushplus.py:241 apprise/plugins/wpush.py:183
msgid "Channel"
msgstr "频道"

#: apprise/plugins/pushplus.py:258
msgid "Webhook Name"
msgstr "Webhook 名称"

#: apprise/plugins/pushsafer.py:361
msgid "Private Key"
msgstr "私钥"

#: apprise/plugins/pushsafer.py:398
msgid "Vibration"
msgstr "振动"

#: apprise/plugins/pushward.py:159
msgid "Info Level"
msgstr "信息级别"

#: apprise/plugins/pushward.py:165
msgid "Success Level"
msgstr "成功级别"

#: apprise/plugins/pushward.py:171
msgid "Warning Level"
msgstr "警告级别"

#: apprise/plugins/pushward.py:177
msgid "Failure Level"
msgstr "失败级别"

#: apprise/plugins/pushy.py:80
msgid "Secret API Key"
msgstr "私密 API 密钥"

#: apprise/plugins/fcm/__init__.py:163 apprise/plugins/pushy.py:92
#: apprise/plugins/simplepush.py:184 apprise/plugins/sns.py:165
#: apprise/plugins/wxpusher.py:129
msgid "Target Topic"
msgstr "目标主题"

#: apprise/plugins/qq.py:47
msgid "QQ Push"
msgstr "QQ Push"

#: apprise/plugins/reddit.py:154
msgid "Application ID"
msgstr "应用标识"

#: apprise/plugins/reddit.py:168
msgid "Target Subreddit"
msgstr "目标子版块"

#: apprise/plugins/reddit.py:185
msgid "Kind"
msgstr "种类"

#: apprise/plugins/reddit.py:191
msgid "Flair ID"
msgstr "标记标识"

#: apprise/plugins/reddit.py:196
msgid "Flair Text"
msgstr "标记文字"

#: apprise/plugins/reddit.py:201
msgid "NSFW"
msgstr "NSFW"

#: apprise/plugins/reddit.py:207
msgid "Is Ad?"
msgstr "是否为广告？"

#: apprise/plugins/reddit.py:213
msgid "Send Replies"
msgstr "发送回复"

#: apprise/plugins/reddit.py:219
msgid "Is Spoiler"
msgstr "含剧透内容"

#: apprise/plugins/reddit.py:225
msgid "Resubmit Flag"
msgstr "重新提交标记"

#: apprise/plugins/resend.py:136
msgid "From Address"
msgstr "发送方地址"

#: apprise/plugins/revolt.py:105
msgid "Channel ID"
msgstr "频道标识"

#: apprise/plugins/revolt.py:132
msgid "Embed URL"
msgstr "嵌入网址"

#: apprise/plugins/ringcentral.py:187
msgid "Token / Password"
msgstr "令牌或密码"

#: apprise/plugins/ringcentral.py:240
msgid "Environment"
msgstr "环境"

#: apprise/plugins/ringcentral.py:253
msgid "Authentication Mode"
msgstr "认证模式"

#: apprise/plugins/rocketchat.py:147
msgid "Webhook"
msgstr "Webhook"

#: apprise/plugins/matrix/base.py:328 apprise/plugins/rocketchat.py:163
msgid "Target Room ID"
msgstr "目标房间标识"

#: apprise/plugins/matrix/base.py:367 apprise/plugins/rocketchat.py:179
#: apprise/plugins/ryver.py:119
msgid "Webhook Mode"
msgstr "Webhook 模式"

#: apprise/plugins/rocketchat.py:184
msgid "Use Avatar"
msgstr "使用头像"

#: apprise/plugins/rsyslog.py:174 apprise/plugins/syslog.py:145
msgid "Facility"
msgstr "系统设施"

#: apprise/plugins/rsyslog.py:204 apprise/plugins/syslog.py:162
msgid "Log PID"
msgstr "记录进程号"

#: apprise/plugins/ryver.py:94 apprise/plugins/zulip.py:131
msgid "Organization"
msgstr "组织"

#: apprise/plugins/sendgrid.py:167 apprise/plugins/sendpulse.py:184
msgid "Template Data"
msgstr "模板数据"

#: apprise/plugins/serwersms.py:143 apprise/plugins/sfr.py:132
msgid "Sender Name"
msgstr "发送方名称"

#: apprise/plugins/ses.py:158 apprise/plugins/sns.py:134
msgid "Session Token"
msgstr "会话令牌"

#: apprise/plugins/ses.py:170 apprise/plugins/sns.py:140
msgid "Access Key ID"
msgstr "访问密钥标识"

#: apprise/plugins/ses.py:176 apprise/plugins/sns.py:146
msgid "Secret Access Key"
msgstr "私密访问密钥"

#: apprise/plugins/ses.py:189 apprise/plugins/smtp2go.py:125
#: apprise/plugins/sparkpost.py:176
msgid "Target Emails"
msgstr "目标邮箱"

#: apprise/plugins/seven.py:114 apprise/plugins/smseagle.py:204
msgid "Flash"
msgstr "闪光"

#: apprise/plugins/seven.py:118
msgid "Label"
msgstr "标注"

#: apprise/plugins/sfr.py:59
msgid "Société Française du Radiotéléphone"
msgstr "Société Française du Radiotéléphone"

#: apprise/plugins/sfr.py:91
msgid "Service ID"
msgstr "服务标识"

#: apprise/plugins/sfr.py:96
msgid "Service Password"
msgstr "服务密码"

#: apprise/plugins/sfr.py:102
msgid "Space ID"
msgstr "空间标识"

#: apprise/plugins/sfr.py:108
msgid "Recipient Phone Number"
msgstr "收件人电话号码"

#: apprise/plugins/sfr.py:139
msgid "Media Type"
msgstr "媒体类型"

#: apprise/plugins/sfr.py:146
msgid "Timeout"
msgstr "超时"

#: apprise/plugins/sfr.py:152
msgid "TTS Voice"
msgstr "语音朗读音色"

#: apprise/plugins/signalgrid.py:96
msgid "Client Key"
msgstr "客户端密钥"

#: apprise/plugins/signalgrid.py:119
msgid "Critical Notification"
msgstr "重要通知"

#: apprise/plugins/signl4.py:113
msgid "Service"
msgstr "服务"

#: apprise/plugins/signl4.py:117
msgid "Location"
msgstr "位置"

#: apprise/plugins/signl4.py:121
msgid "Alerting Scenario"
msgstr "告警场景"

#: apprise/plugins/signl4.py:125
msgid "Filtering"
msgstr "过滤"

#: apprise/plugins/signl4.py:130
msgid "External ID"
msgstr "外部标识"

#: apprise/plugins/signl4.py:143
msgid "Status"
msgstr "状态"

#: apprise/plugins/simplepush.py:189
msgid "Target Member"
msgstr "目标成员"

#: apprise/plugins/simplepush.py:211
msgid "Shared"
msgstr "共享"

#: apprise/plugins/simplepush.py:227
msgid "Tag"
msgstr "标签"

#: apprise/plugins/sinch.py:135 apprise/plugins/twilio.py:171
msgid "Target Short Code"
msgstr "目标短代码"

#: apprise/plugins/slack.py:232
msgid "OAuth Access Token"
msgstr "OAuth 访问令牌"

#: apprise/plugins/slack.py:241
msgid "Token A"
msgstr "令牌 A"

#: apprise/plugins/slack.py:250
msgid "Token B"
msgstr "令牌 B"

#: apprise/plugins/slack.py:259
msgid "Token C"
msgstr "令牌 C"

#: apprise/plugins/slack.py:266
msgid "Target Encoded ID"
msgstr "编码后的目标标识"

#: apprise/plugins/slack.py:295
msgid "Workflow Path"
msgstr "工作流路径"

#: apprise/plugins/slack.py:313
msgid "Include Footer"
msgstr "包含页脚"

#: apprise/plugins/slack.py:321
msgid "Use Blocks"
msgstr "使用区块"

#: apprise/plugins/slack.py:327
msgid "Include Timestamp"
msgstr "包含时间戳"

#: apprise/plugins/slack.py:333 apprise/plugins/twitter.py:205
msgid "Message Mode"
msgstr "消息模式"

#: apprise/plugins/smpp.py:66
msgid "SMPP"
msgstr "SMPP"

#: apprise/plugins/smpp.py:108
msgid "Host"
msgstr "主机"

#: apprise/plugins/smsc.py:139
msgid "Login"
msgstr "登录名"

#: apprise/plugins/smsc.py:176
msgid "Transliterate"
msgstr "音译"

#: apprise/plugins/smseagle.py:166
msgid "Target Contact"
msgstr "目标联系人"

#: apprise/plugins/smseagle.py:199
msgid "Test Only"
msgstr "仅测试"

#: apprise/plugins/smsmanager.py:144
msgid "Gateway"
msgstr "网关"

#: apprise/plugins/sogs.py:221
msgid "Public Key"
msgstr "公钥"

#: apprise/plugins/sogs.py:228
msgid "Seed"
msgstr "种子"

#: apprise/plugins/sogs.py:235
msgid "Rooms"
msgstr "房间"

#: apprise/plugins/spike.py:49
msgid "Spike.sh"
msgstr "Spike.sh"

#: apprise/plugins/splunk.py:118
msgid "Splunk On-Call"
msgstr "Splunk On-Call"

#: apprise/plugins/splunk.py:173
msgid "Target Routing Key"
msgstr "目标路由密钥"

#: apprise/plugins/splunk.py:180
msgid "Entity ID"
msgstr "实体标识"

#: apprise/plugins/spugpush.py:49
msgid "SpugPush"
msgstr "SpugPush"

#: apprise/plugins/streamlabs.py:128
msgid "Alert Type"
msgstr "告警类型"

#: apprise/plugins/streamlabs.py:134
msgid "Image Link"
msgstr "图片链接"

#: apprise/plugins/streamlabs.py:139
msgid "Sound Link"
msgstr "声音链接"

#: apprise/plugins/streamlabs.py:150
msgid "Special Text Color"
msgstr "特殊文字颜色"

#: apprise/plugins/streamlabs.py:156
msgid "Amount"
msgstr "金额"

#: apprise/plugins/streamlabs.py:162
msgid "Currency"
msgstr "货币"

#: apprise/plugins/streamlabs.py:168
msgid "Name"
msgstr "名称"

#: apprise/plugins/streamlabs.py:174
msgid "Identifier"
msgstr "标识符"

#: apprise/plugins/synology.py:119
msgid "Upload"
msgstr "上传"

#: apprise/plugins/syslog.py:168
msgid "Log to STDERR"
msgstr "记录到 STDERR"

#: apprise/plugins/telegram.py:603 apprise/plugins/zalo.py:120
msgid "Target Chat ID"
msgstr "目标聊天标识"

#: apprise/plugins/telegram.py:626
msgid "Detect Bot Owner"
msgstr "检测机器人所有者"

#: apprise/plugins/telegram.py:637
msgid "Web Page Preview"
msgstr "网页预览"

#: apprise/plugins/telegram.py:642
msgid "Group Photo/Video Attachments"
msgstr "将照片/视频附件分组"

#: apprise/plugins/telegram.py:647
msgid "Topic Thread ID"
msgstr "主题话题标识"

#: apprise/plugins/telegram.py:654
msgid "Markdown Version"
msgstr "Markdown 版本"

#: apprise/plugins/telegram.py:663
msgid "Content Placement"
msgstr "内容位置"

#: apprise/plugins/telegram.py:669
msgid "Rich Message Template Path"
msgstr "富文本消息模板路径"

#: apprise/plugins/telnyx.py:132
msgid "Messaging Profile ID"
msgstr "消息配置标识"

#: apprise/plugins/threema.py:86
msgid "Gateway ID"
msgstr "网关标识"

#: apprise/plugins/threema.py:111
msgid "Target Threema ID"
msgstr "目标 Threema 标识"

#: apprise/plugins/trigv.py:160
msgid "API Hostname"
msgstr "API 主机名"

#: apprise/plugins/trigv.py:186
msgid "Image URL"
msgstr "图片网址"

#: apprise/plugins/trigv.py:196
msgid "Event type"
msgstr "事件类型"

#: apprise/plugins/trigv.py:200
msgid "Priority (Pushover compatibility)"
msgstr "优先级（兼容 Pushover）"

#: apprise/plugins/twilio.py:203
msgid "Notification Method: sms or call"
msgstr "通知方式：短信或通话"

#: apprise/plugins/twitter.py:164
msgid "Consumer Key"
msgstr "使用方密钥"

#: apprise/plugins/twitter.py:170
msgid "Consumer Secret"
msgstr "使用方密文"

#: apprise/plugins/twitter.py:182
msgid "Access Secret"
msgstr "访问密文"

#: apprise/plugins/viber.py:50
msgid "Viber"
msgstr "Viber"

#: apprise/plugins/viber.py:82
msgid "Authentication Token"
msgstr "认证令牌"

#: apprise/plugins/viber.py:88
msgid "Receiver IDs"
msgstr "接收方标识"

#: apprise/plugins/viber.py:106
msgid "Bot Avatar URL"
msgstr "机器人头像网址"

#: apprise/plugins/voipms.py:84
msgid "User Email"
msgstr "用户邮箱"

#: apprise/plugins/vapid/__init__.py:189 apprise/plugins/vonage.py:134
msgid "ttl"
msgstr "ttl"

#: apprise/plugins/webexteams.py:179
msgid "Bot Access Token"
msgstr "机器人访问令牌"

#: apprise/plugins/webexteams.py:185
msgid "Room IDs"
msgstr "房间标识"

#: apprise/plugins/wechat.py:175
msgid "Corp ID"
msgstr "企业标识"

#: apprise/plugins/wechat.py:182
msgid "App Secret"
msgstr "应用密文"

#: apprise/plugins/wechat.py:190
msgid "Agent ID"
msgstr "应用代理标识"

#: apprise/plugins/wechat.py:206
msgid "Target Department"
msgstr "目标部门"

#: apprise/plugins/wechat.py:213
msgid "Target Tag"
msgstr "目标标签"

#: apprise/plugins/wecombot.py:100
msgid "Bot Webhook Key"
msgstr "机器人 Webhook 密钥"

#: apprise/plugins/whatsapp.py:135
msgid "From Phone ID"
msgstr "发送方电话标识"

#: apprise/plugins/windows.py:62
msgid "A local Microsoft Windows environment is required."
msgstr "需要本地的 Microsoft Windows 环境。"

#: apprise/plugins/workflows.py:151
msgid "Workflow ID"
msgstr "工作流标识"

#: apprise/plugins/workflows.py:159
msgid "Signature"
msgstr "签名"

#: apprise/plugins/workflows.py:182
msgid "Use Power Automate URL"
msgstr "使用 Power Automate 网址"

#: apprise/plugins/workflows.py:189
msgid "Power Automate Routing ID"
msgstr "Power Automate 路由标识"

#: apprise/plugins/workflows.py:196
msgid "Wrap Text"
msgstr "自动换行"

#: apprise/plugins/workflows.py:211
msgid "API Version"
msgstr "API 版本"

#: apprise/plugins/wpush.py:167
msgid "Topics"
msgstr "主题"

#: apprise/plugins/wpush.py:201
msgid "Group / Option Code"
msgstr "群组或选项代码"

#: apprise/plugins/wxpusher.py:122
msgid "App Token"
msgstr "应用令牌"

#: apprise/plugins/youlmk.py:159
msgid "Token or Key"
msgstr "令牌或密钥"

#: apprise/plugins/youlmk.py:183
msgid "Info Priority"
msgstr "信息优先级"

#: apprise/plugins/youlmk.py:189
msgid "Success Priority"
msgstr "成功优先级"

#: apprise/plugins/youlmk.py:195
msgid "Warning Priority"
msgstr "警告优先级"

#: apprise/plugins/youlmk.py:201
msgid "Failure Priority"
msgstr "失败优先级"

#: apprise/plugins/youlmk.py:216
msgid "Link Label"
msgstr "链接标注"

#: apprise/plugins/zoom.py:146
msgid "Verification Token"
msgstr "验证令牌"

#: apprise/plugins/zulip.py:149
msgid "Target Stream"
msgstr "目标频道流"

#: apprise/plugins/amqp/base.py:102
msgid "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0, or both."
msgstr ""
"为 AMQP 0.9.1 安装 pika，为 AMQP 1.0 安装 python-qpid-proton，或两者都安装。"

#: apprise/plugins/amqp/base.py:204
msgid "Exchange"
msgstr "交换机"

#: apprise/plugins/amqp/base.py:208
msgid "Virtual Host"
msgstr "虚拟主机"

#: apprise/plugins/amqp/base.py:212
msgid "Persistent"
msgstr "持久化"

#: apprise/plugins/amqp/base.py:217
msgid "Mandatory"
msgstr "强制"

#: apprise/plugins/amqp/base.py:228
msgid "Time To Live"
msgstr "生存时间 (TTL)"

#: apprise/plugins/amqp/base.py:243
msgid "Message Headers"
msgstr "消息头"

#: apprise/plugins/email/base.py:188
msgid "SMTP Server"
msgstr "SMTP 服务器"

#: apprise/plugins/email/base.py:193 apprise/plugins/xmpp/base.py:150
msgid "Secure Mode"
msgstr "安全模式"

#: apprise/plugins/email/base.py:205
msgid "PGP Security Mode"
msgstr "PGP 安全模式"

#: apprise/plugins/email/base.py:212
msgid "PGP Public Key Path"
msgstr "PGP 公钥路径"

#: apprise/plugins/email/base.py:220
msgid "PGP Private Key Path"
msgstr "PGP 私钥路径"

#: apprise/plugins/email/base.py:228
msgid "Web Key Directory"
msgstr "网络密钥目录"

#: apprise/plugins/email/base.py:234
msgid "Inline Attachments"
msgstr "内嵌附件"

#: apprise/plugins/email/base.py:239
msgid "To Email"
msgstr "收件邮箱"

#: apprise/plugins/fcm/__init__.py:149
msgid "OAuth2 KeyFile"
msgstr "OAuth2 密钥文件"

#: apprise/plugins/fcm/__init__.py:194
msgid "Custom Image URL"
msgstr "自定义图片网址"

#: apprise/plugins/fcm/__init__.py:206
msgid "Notification Color"
msgstr "通知颜色"

#: apprise/plugins/irc/base.py:160
msgid "Real Name"
msgstr "真实姓名"

#: apprise/plugins/irc/base.py:161
msgid "Nickname"
msgstr "昵称"

#: apprise/plugins/irc/base.py:163
msgid "Join Channels"
msgstr "加入频道"

#: apprise/plugins/irc/base.py:168
msgid "Auth Mode"
msgstr "认证模式"

#: apprise/plugins/matrix/base.py:334
msgid "Target Room Alias"
msgstr "目标房间别名"

#: apprise/plugins/matrix/base.py:357
msgid "Server Discovery"
msgstr "服务器发现"

#: apprise/plugins/matrix/base.py:362
msgid "Force Home Server on Room IDs"
msgstr "对房间标识强制使用主服务器"

#: apprise/plugins/matrix/base.py:379
msgid "Matrix API Version"
msgstr "Matrix API 版本"

#: apprise/plugins/matrix/base.py:391
msgid "End-to-End Encryption"
msgstr "端到端加密"

#: apprise/plugins/matrix/base.py:396
msgid "Automatic Device Verification"
msgstr "自动设备验证"

#: apprise/plugins/vapid/__init__.py:203
msgid "PEM Private KeyFile"
msgstr "PEM 私钥文件"

#: apprise/plugins/vapid/__init__.py:209
msgid "Subscripion File"
msgstr "订阅文件"

#: apprise/plugins/xmpp/base.py:145
msgid "XMPP Server"
msgstr "XMPP 服务器"

#: apprise/plugins/xmpp/base.py:157
msgid "Get Roster"
msgstr "获取联系人列表"

#: apprise/plugins/xmpp/base.py:162
msgid "Use Subject"
msgstr "使用主题"

#: apprise/plugins/xmpp/base.py:167
msgid "Keep Connection Alive"
msgstr "保持连接"

#: apprise/plugins/xmpp/base.py:173
msgid "MUC Nickname"
msgstr "MUC 昵称"

#: apprise/plugins/xmpp/base.py:177
msgid "SCRAM-PLUS Channel Binding"
msgstr "SCRAM-PLUS 通道绑定"
caronc-apprise-dfec414/apprise/locale.py000066400000000000000000000350161526720371000204000ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.


from __future__ import annotations

from collections.abc import Callable, Iterator
import contextlib
import contextvars
import ctypes
import locale
import os
from os.path import abspath, dirname, join
import re
from typing import Optional, Union

from .logger import logger

# This gets toggled to True if we succeed
GETTEXT_LOADED = False

try:
    # Initialize gettext
    import gettext

    # Toggle our flag
    GETTEXT_LOADED = True

except ImportError:
    # gettext isn't available; no problem; Use the library features without
    # multi-language support.
    pass


# The translation function used for lazy strings inside lang_at().
ACTIVE_GETTEXT = contextvars.ContextVar("apprise_active_gettext", default=None)


class AppriseLocale:
    """Load and switch between gettext languages as needed."""

    # Define our translation domain
    _domain = "apprise"

    # The path to our translations
    _locale_dir = abspath(join(dirname(__file__), "i18n"))

    # Locale regular expression
    #
    # Matches a locale such as en_CA.UTF-8 or ca_ES.UTF-8@valencia:
    # - A 2 or 3 letter language with an optional region (en_CA or en-CA).
    # - An optional codeset (.UTF-8) and modifier (@euro), both discarded.
    # - A codeset may hold dots and underscores (C.ANSI_X3.4-1968).
    _local_re = re.compile(
        r"^\s*((?PC|POSIX)|(?P([a-z]{2,3}))"
        r"([_-](?P[a-z0-9]{2,8}))?([_-][a-z0-9]{2,8})*)"
        r"(\.(?P[a-z0-9._-]+))?"
        r"(@(?P[a-z0-9_-]+))?\s*$",
        re.IGNORECASE,
    )

    # The environment variables that name a language, in the order gettext
    # itself consults them. LANGUAGE is the GNU extension and wins; LC_ALL
    # over-rides every category; LC_MESSAGES is the category that governs
    # translated text; LANG is the fallback for all of them.
    _env_variables = ("LANGUAGE", "LC_ALL", "LC_MESSAGES", "LANG")

    # The same list without LANGUAGE. These name a locale rather than a
    # language, and the first one set decides whether text is translated at
    # all.
    _locale_variables = ("LC_ALL", "LC_MESSAGES", "LANG")

    # Define our default encoding
    _default_encoding = "utf-8"

    # The function to assign `_` by default
    _fn = "gettext"

    # The language we should fall back to if all else fails
    _default_language = "en"

    def __init__(self, language: Optional[str] = None) -> None:
        """Use the requested language or detect it from the operating system.

        The configured default language is used when detection fails.
        """

        # Cache previously loaded translations
        self._gtobjs = {}

        # Get our language
        self.lang = AppriseLocale.detect_language(language)

        # Our mapping to our _fn
        self.__fn_map = None

        if GETTEXT_LOADED is False:
            # We're done
            return

        # Add language
        self.add(self.lang)

    def add(
        self,
        lang: Optional[str] = None,
        set_default: bool = True,
    ) -> bool:
        """Add a language to our list."""
        lang = lang if lang else self._default_language
        if lang not in self._gtobjs:
            # Try the regional catalog before its base language.
            languages = AppriseLocale.language_candidates(lang)
            if not languages:
                logger.warning(
                    "The language specified (%s) is not supported.", lang
                )
                return False

            # Load our gettext object and install our language
            try:
                self._gtobjs[lang] = gettext.translation(
                    self._domain,
                    localedir=self._locale_dir,
                    languages=languages,
                    fallback=False,
                )

                # Keep the selected gettext function without installing it.
                self.__fn_map = getattr(self._gtobjs[lang], self._fn)

            except FileNotFoundError:
                # The translation directory does not exist
                logger.debug(
                    "Could not load translation path: %s",
                    join(self._locale_dir, lang),
                )

                # Fallback (handle case where self.lang does not exist)
                if self.lang not in self._gtobjs:
                    self._gtobjs[self.lang] = gettext
                    self.__fn_map = getattr(self._gtobjs[self.lang], self._fn)

                return False

            logger.trace(
                "Loaded language %s (searched: %s)",
                lang,
                ", ".join(languages),
            )

        if set_default:
            logger.debug("Language set to %s", lang)
            self.lang = lang

        return True

    @contextlib.contextmanager
    def lang_at(
        self,
        lang: Optional[str],
        mapto: str = _fn,
    ) -> Iterator[Optional[Callable[[str], str]]]:
        """Temporarily use a language and yield its translation function.

        For example::

            with at.lang_at('fr'):
                # Strings use French within this block.
        """

        if GETTEXT_LOADED is False:
            # Do nothing
            yield None

            # No translation support is available.
            return

        # Normalize the requested language.
        lang = AppriseLocale.detect_language(lang, detect_fallback=False)
        if not lang or (
            lang not in self._gtobjs and not self.add(lang, set_default=False)
        ):
            # Nothing usable was asked for, or no catalog exists for it; fall
            # back to the language we were already set up with
            fn = getattr(self._gtobjs[self.lang], mapto)

        else:
            fn = getattr(self._gtobjs[lang], mapto)

        # Use this translation for lazy strings within the context.
        token = ACTIVE_GETTEXT.set(fn if mapto == self._fn else None)
        try:
            # Provide the selected translation function.
            yield fn

        finally:
            # Restore the translation used by the surrounding context.
            ACTIVE_GETTEXT.reset(token)

        return

    @property
    def gettext(self) -> Callable[[str], str]:
        """Return the current language gettext() function.

        Useful for assigning to `_`
        """
        return self._gtobjs[self.lang].gettext

    @staticmethod
    def normalize_language(lang: Optional[str]) -> Optional[str]:
        """Normalize a language code, or return None when it is invalid.

        Matching is case insensitive. A hyphen or an underscore separates a
        region, so ``en-CA``, ``en_CA``, and ``EN-ca`` all become ``en_CA``.
        A codeset or modifier is dropped, so ``en_CA.UTF-8@euro`` becomes
        ``en_CA``. Only the first value of a preference list is used.
        """
        if not isinstance(lang, str):
            return None

        # Use the first language in a preference list. A comma separates an
        # Accept-Language list and a colon separates a LANGUAGE= one.
        entry = re.split(r"[,:]", lang, maxsplit=1)[0]

        # Ignore a quality value such as ;q=0.9.
        entry = entry.split(";")[0]

        result = AppriseLocale._local_re.match(entry)
        if not result or not result.group("lang"):
            # The value is not a supported language format.
            return None

        # Language codes are lower case, regions are upper case (en_CA)
        language = result.group("lang").lower()
        country = result.group("country")

        # Drop unsupported regions or script names such as Hans in zh-Hans.
        if not country or not re.match(r"^[a-z]{2}$", country, re.I):
            return language

        return f"{language}_{country.upper()}"

    @staticmethod
    def is_ansii_locale(value: Optional[str]) -> bool:
        """Return True when ``value`` names the C (or POSIX) locale."""
        if not isinstance(value, str):
            return False

        # C, POSIX, and C.UTF-8 all mean the same thing here
        result = AppriseLocale._local_re.match(value)
        return bool(result and result.group("ansii"))

    @staticmethod
    def language_candidates(lang: Optional[str]) -> list[str]:
        """Return matching catalogs in preference order.

        For example, ``en_CA`` searches ``en_CA`` and then ``en``. Invalid
        values return an empty list.
        """
        language = AppriseLocale.normalize_language(lang)
        if not language:
            # No catalog can match an invalid value.
            return []

        # Retry a regional language without its region.
        return (
            [language, language.split("_")[0]]
            if "_" in language
            else [language]
        )

    @staticmethod
    def detect_language(
        lang: Optional[str] = None,
        detect_fallback: bool = True,
    ) -> Optional[str]:
        """Return a normalized language from the input or the system."""
        # Preserve valid regions; return None for invalid values.
        if not isinstance(lang, str):
            if detect_fallback is False:
                # no detection enabled; we're done
                return None

            # Posix lookup
            lookup = os.environ.get

            # The locale in charge of translated text. Asking for C (or
            # POSIX) is asking for no translation at all, and it silences
            # LANGUAGE too, so detection stops there.
            #
            # This follows GNU gettext, which documents LANGUAGE as being
            # ignored under the C locale. Python's own gettext.find() skips
            # that rule and lets LANGUAGE through; we do not, because
            # LC_ALL=C is how a script asks for untranslated output.
            localename = next(
                (
                    value
                    for value in (
                        lookup(variable)
                        for variable in AppriseLocale._locale_variables
                    )
                    if value
                ),
                None,
            )
            if localename and AppriseLocale.is_ansii_locale(localename):
                logger.debug(
                    "The %s locale asks for no translation; using %s",
                    localename,
                    AppriseLocale._default_language,
                )
                return AppriseLocale._default_language

            localename = None
            for variable in AppriseLocale._env_variables:
                localename = lookup(variable, None)
                if localename:
                    # Normalization applies the same rules and drops any
                    # encoding suffix such as .UTF-8 on its own.
                    language = AppriseLocale.normalize_language(localename)
                    if language:
                        return language

            # Windows handling
            if hasattr(ctypes, "windll"):
                windll = ctypes.windll.kernel32
                try:
                    lang = locale.windows_locale[
                        windll.GetUserDefaultUILanguage()
                    ]

                    # Our detected windows language
                    return AppriseLocale.normalize_language(lang)

                except (TypeError, KeyError):
                    # Fallback to posix detection
                    pass

            # Built in locale library check
            try:
                # Acquire our locale
                lang = locale.getlocale()[0]
                # Compatibility for Python >= 3.12
                if lang == "C":
                    lang = AppriseLocale._default_language

            except (ValueError, TypeError) as e:
                # An invalid environment locale can make getlocale() fail.
                # Warn the user so they can correct their locale variables.
                logger.warning(f"Language detection failure / {e!s}")
                return None

        return AppriseLocale.normalize_language(lang)

    def __getstate__(self) -> dict:
        """Return state that can be pickled."""
        state = self.__dict__.copy()

        # Remove the unpicklable entries.
        del state["_gtobjs"]
        del state["_AppriseLocale__fn_map"]
        return state

    def __setstate__(self, state: dict) -> None:
        """Restore pickled state and reload its language."""
        self.__dict__.update(state)
        # Our mapping to our _fn
        self.__fn_map = None
        self._gtobjs = {}
        self.add(state["lang"], set_default=True)


#
# Prepare our default LOCALE Singleton
#
LOCALE = AppriseLocale()


class LazyTranslation:
    """Translate text only when it is converted to a string."""

    def __init__(self, text: str, *args, **kwargs) -> None:
        """Store our text."""
        self.text = text

        super().__init__(*args, **kwargs)

    def __str__(self) -> str:
        if GETTEXT_LOADED is False:
            return self.text

        # A lang_at() context overrides the configured language.
        fn = ACTIVE_GETTEXT.get()
        return fn(self.text) if fn else LOCALE.gettext(self.text)


# Lazy translation handling
def gettext_lazy(text: str) -> LazyTranslation:
    """Return text that is translated when converted to a string."""

    return LazyTranslation(text=text)


# Identify our Translatable content
Translatable = Union[str, LazyTranslation]
caronc-apprise-dfec414/apprise/logger.py000066400000000000000000001043251526720371000204200ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from __future__ import annotations

import asyncio
from collections.abc import Iterator
import contextlib
import contextvars
from datetime import datetime, timezone
from io import StringIO
import json
import logging
import os
import struct
import tempfile
import threading
from typing import TYPE_CHECKING, Any, Callable, Optional, Union

from .common import AWARE_DATE_ISO_FORMAT, JSON_COMPACT_SEPARATORS
from .exception import AppriseDiskIOError

if TYPE_CHECKING:
    # Import NotifyBase only for static analysis. Importing it at runtime
    # would create a cycle through apprise.url and this logger module.
    from .plugins.base import NotifyBase

# The root identifier needed to monitor 'apprise' logging
LOGGER_NAME = "apprise"

# Tracks the service capture active in the current execution context.
_active_capture: contextvars.ContextVar[Optional[_ServiceLogCapture]] = (
    contextvars.ContextVar("apprise_active_log_capture", default=None)
)

# Keeps call-level logs isolated when notifications run concurrently.
_active_call_capture: contextvars.ContextVar[Optional[_ServiceLogCapture]] = (
    contextvars.ContextVar("apprise_active_call_log_capture", default=None)
)


# Define a verbosity level that is a noisier then debug mode
logging.TRACE = logging.DEBUG - 1

# Define a verbosity level that is always used even when no verbosity is set
# from the command line.  The idea here is to allow for deprecation notices
logging.DEPRECATE = logging.ERROR + 1

# Assign our Levels into our logging object
logging.addLevelName(logging.DEPRECATE, "DEPRECATION WARNING")
logging.addLevelName(logging.TRACE, "TRACE")


def trace(self, message, *args, **kwargs):
    """
    Verbose Debug Logging - Trace
    """
    if self.isEnabledFor(logging.TRACE):
        self._log(logging.TRACE, message, args, **kwargs)


def deprecate(self, message, *args, **kwargs):
    """Deprication Warning Logging."""
    if self.isEnabledFor(logging.DEPRECATE):
        self._log(logging.DEPRECATE, message, args, **kwargs)


# Assign our Loggers for use in Apprise
logging.Logger.trace = trace
logging.Logger.deprecate = deprecate

# Create ourselve a generic (singleton) logging reference
logger = logging.getLogger(LOGGER_NAME)


def _safe_internal_log(level: int, message: str, *args: Any) -> None:
    """Report a capture problem without letting logging handlers raise."""
    # Logging is best-effort while the original notification continues.
    with contextlib.suppress(Exception):
        # Capture handlers already block their own re-entry. This guard also
        # contains failures raised by application-provided handlers.
        logger.log(level, message, *args)


class NotifyLogEntry:
    """A log entry captured during notification processing."""

    def __init__(
        self, level: str, message: str, time: Optional[datetime] = None
    ) -> None:
        """Initialize a captured message and its UTC timestamp."""

        # The already-formatted log message
        self.message = message

        # The log level name (e.g. "WARNING", "ERROR")
        self.level = level

        # The log time
        self.time = time if time is not None else datetime.now(timezone.utc)

    def __eq__(self, other: object) -> bool:
        """Check equality of two entries by their (time, level, message)."""
        if not isinstance(other, NotifyLogEntry):
            return NotImplemented
        return (self.time, self.level, self.message) == (
            other.time,
            other.level,
            other.message,
        )

    def __hash__(self) -> int:
        """Hash on the same (time, level, message) for __eq__ uses."""
        return hash((self.time, self.level, self.message))

    def __lt__(self, other: NotifyLogEntry) -> bool:
        """Order by time alone, for chronological playback"""
        if not isinstance(other, NotifyLogEntry):
            return NotImplemented
        return self.time < other.time

    def __le__(self, other: NotifyLogEntry) -> bool:
        """Order by time alone, for chronological playback"""
        if not isinstance(other, NotifyLogEntry):
            return NotImplemented
        return self.time <= other.time

    def __gt__(self, other: NotifyLogEntry) -> bool:
        """See __lt__."""
        if not isinstance(other, NotifyLogEntry):
            return NotImplemented
        return self.time > other.time

    def __ge__(self, other: NotifyLogEntry) -> bool:
        """See __lt__."""
        if not isinstance(other, NotifyLogEntry):
            return NotImplemented
        return self.time >= other.time

    def asdict(self) -> dict[str, Any]:
        """Return this entry as a plain, JSON-serializable dict."""
        return {
            "level": self.level,
            "message": self.message,
            "time": self.time.strftime(AWARE_DATE_ISO_FORMAT),
        }

    def json(self) -> str:
        """Return this entry as a JSON string."""
        return json.dumps(self.asdict(), separators=JSON_COMPACT_SEPARATORS)

    def __str__(self) -> str:
        """Format the entry like a conventional Python log line."""
        # Match Python logging's familiar default-style output.
        asctime = "{},{:03d}".format(
            self.time.strftime("%Y-%m-%d %H:%M:%S"),
            self.time.microsecond // 1000,
        )
        return "{} - {} - {}".format(asctime, self.level, self.message)

    def __repr__(self) -> str:
        """Return an unambiguous representation of this entry."""
        return "".format(
            self.level, self.message, self.time
        )


class _LogCaptureBudget:
    """Share result-log memory and disk limits across one notify call."""

    # Store each entry's size and the next entry in this capture.
    _HEADER = struct.Struct("!QQ")

    # Update only the next-entry location when linking records.
    _LINK = struct.Struct("!Q")

    # This value marks the last record in one capture's disk chain.
    _END = (1 << 64) - 1

    # This message is retained when the configured disk allowance is full.
    _LIMIT_MESSAGE = (
        "Result log storage is full; additional entries were not retained."
    )

    # This message is retained when temporary storage stops working.
    _DISK_MESSAGE = (
        "Result log disk storage failed; additional entries may be missing."
    )

    def __init__(self, memory_size: int = 0, disk_size: int = 0) -> None:
        """Set byte limits; a zero disk limit keeps memory unbounded."""
        # Maximum memory shared by all captures in this notification call.
        self.memory_size = memory_size

        # Maximum temporary disk space shared by the same captures.
        self.disk_size = disk_size

        # Memory currently reserved by captured entries.
        self.memory_used = 0

        # Disk space currently reserved by captured entries.
        self.disk_used = 0

        # Stop further writes after the first disk error.
        self.disk_failed = False

        # Open the temporary file only when an entry spills to disk.
        self._disk: Optional[Any] = None

        # The final store to close releases the shared temporary file.
        self._store_count = 0

        # Report each storage problem once per notification call.
        self._reported_warnings: set[str] = set()

        # Protect shared limits and disk access across service threads.
        self._lock = threading.RLock()

    def register_store(self) -> None:
        """Keep shared disk storage open for one capture store."""
        with self._lock:
            # Every active store receives one ownership count.
            self._store_count += 1

    def reserve_memory(self, size: int) -> bool:
        """Reserve memory for one entry before it spills to disk."""
        with self._lock:
            # No disk allowance preserves the original all-memory behavior.
            if not self.disk_size:
                return True

            # Spill the complete entry rather than splitting it across stores.
            if self.memory_used + size > self.memory_size:
                return False

            # Reserve the entry's bytes before another thread can claim them.
            self.memory_used += size

            return True

    def claim_warning(self, message: str) -> bool:
        """Return true once for each storage warning in this notify call."""
        with self._lock:
            # A warning already claimed by another capture is not repeated.
            if message in self._reported_warnings:
                return False

            # Remember the warning before its caller writes to the logger.
            self._reported_warnings.add(message)

            return True

    def write(
        self, payload: bytes, previous: Optional[int]
    ) -> tuple[Optional[int], Optional[str]]:
        """Write one entry and return its offset or a safe warning."""
        # Disk accounting includes the record header and its log content.
        size = self._HEADER.size + len(payload)

        with self._lock:
            # A failed or full disk store cannot accept another record.
            if self.disk_failed or self.disk_used + size > self.disk_size:
                return (
                    None,
                    self._DISK_MESSAGE
                    if self.disk_failed
                    else self._LIMIT_MESSAGE,
                )

            # Reserve space first so parallel captures cannot exceed the cap.
            self.disk_used += size

            try:
                if self._disk is None:
                    # Share one anonymous file across this notification.
                    self._disk = tempfile.TemporaryFile(  # noqa: SIM115
                        mode="w+b"
                    )

                # Append new content without disturbing earlier records.
                self._disk.seek(0, os.SEEK_END)

                # New records always begin at the current end of the file.
                offset = self._disk.tell()

                # New records begin as the final item in their capture.
                header = self._HEADER.pack(len(payload), self._END)

                # A short write means the record cannot be trusted later.
                if self._disk.write(header) != len(header):
                    raise AppriseDiskIOError("short result log header write")

                # Write the complete log entry immediately after its header.
                if self._disk.write(payload) != len(payload):
                    raise AppriseDiskIOError("short result log entry write")

                if previous is not None:
                    # Link this capture's entries across the shared file.
                    self._disk.seek(previous + self._LINK.size)

                    # Point the prior record at the new record's location.
                    link = self._LINK.pack(offset)

                    if self._disk.write(link) != len(link):
                        raise AppriseDiskIOError("short result log link write")

                # Make completed writes available to result readers.
                self._disk.flush()

                return offset, None

            except Exception as e:
                # Return unused space after a failed write.
                self.disk_used -= size

                if self.claim_warning(self._DISK_MESSAGE):
                    # Keep the main warning concise and details at debug level.
                    _safe_internal_log(logging.WARNING, self._DISK_MESSAGE)
                    _safe_internal_log(
                        logging.DEBUG,
                        "Result log storage exception: %s",
                        str(e),
                    )

                # Future entries skip disk instead of repeating the failure.
                self.disk_failed = True

                return None, self._DISK_MESSAGE

    def read(self, offset: int) -> tuple[bytes, int]:
        """Read and validate one serialized entry at an owned offset."""
        with self._lock:
            # A closed result no longer has disk content to replay.
            if self._disk is None:
                raise AppriseDiskIOError("result log storage is closed")

            # Move directly to the record owned by this capture.
            self._disk.seek(offset)

            # Read the fixed-size details that describe the stored entry.
            header = self._disk.read(self._HEADER.size)

            # Reject partial records before decoding their content.
            if len(header) != self._HEADER.size:
                raise AppriseDiskIOError("truncated result log header")

            # Recover the content length and the next record location.
            size, next_offset = self._HEADER.unpack(header)

            # A record cannot be larger than the complete disk allowance.
            if size > self.disk_size:
                raise AppriseDiskIOError("invalid result log entry size")

            # Read only the number of bytes declared by this record.
            payload = self._disk.read(size)

            # Do not pass incomplete content to the JSON decoder.
            if len(payload) != size:
                raise AppriseDiskIOError("truncated result log entry")

            return payload, next_offset

    def release_store(self) -> None:
        """Close shared disk storage after its final capture is released."""
        with self._lock:
            # This store no longer needs access to the shared file.
            self._store_count -= 1

            # Another store still needs the file, or no file was opened.
            if self._store_count or self._disk is None:
                return

            try:
                # The last store owns final cleanup of temporary storage.
                self._disk.close()

            except Exception as e:
                # Report cleanup errors while still clearing the file below.
                _safe_internal_log(
                    logging.WARNING,
                    "Result log storage could not be closed.",
                )
                _safe_internal_log(
                    logging.DEBUG,
                    "Result log close exception: %s",
                    str(e),
                )

            finally:
                # Never leave a closed or failed handle available for reuse.
                self._disk = None


class _NotifyLogStore:
    """Keep captured entries in memory, spilling later entries to disk."""

    # Reuse the shared message when the configured allowance is full.
    _LIMIT_MESSAGE = _LogCaptureBudget._LIMIT_MESSAGE

    # Reuse the shared message when temporary storage stops working.
    _DISK_MESSAGE = _LogCaptureBudget._DISK_MESSAGE

    # Return a safe entry when retained disk content cannot be replayed.
    _READ_MESSAGE = "Stored result logs could not be read."

    def __init__(self, budget: _LogCaptureBudget) -> None:
        """Create an empty store using the call's shared byte budget."""
        # Register first so the shared file stays open for this store.
        self._budget = budget
        self._budget.register_store()

        # Memory always holds the oldest retained entries.
        self._memory: list[NotifyLogEntry] = []

        # This is where the first disk-backed entry can be found.
        self._first_offset: Optional[int] = None

        # This is where the newest disk-backed entry can be found.
        self._last_offset: Optional[int] = None

        # Count the disk entries this store can read.
        self._disk_count = 0

        # A final notice explains why later entries are missing.
        self._notice: Optional[NotifyLogEntry] = None

        # Closed stores ignore late entries and no longer read from disk.
        self._closed = False

        # Iteration and appends can occur from different worker threads.
        self._lock = threading.RLock()

    @staticmethod
    def _encode(entry: NotifyLogEntry) -> bytes:
        """Serialize an entry for length-prefixed disk storage."""
        return entry.json().encode("utf-8")

    @staticmethod
    def _decode(payload: bytes) -> NotifyLogEntry:
        """Restore an entry read from disk."""
        # Convert the stored JSON text back into its plain fields.
        data = json.loads(payload.decode("utf-8"))

        # Rebuild the same public entry type used by in-memory logs.
        return NotifyLogEntry(
            level=data["level"],
            message=data["message"],
            time=datetime.strptime(data["time"], AWARE_DATE_ISO_FORMAT),
        )

    def append(self, entry: NotifyLogEntry) -> None:
        """Append an entry without allowing storage errors to escape."""
        # Measure the encoded entry before choosing memory or disk.
        payload = self._encode(entry)

        # Include the small disk header in all shared byte accounting.
        size = self._budget._HEADER.size + len(payload)

        with self._lock:
            # Late messages cannot reopen a completed result.
            if self._closed:
                return

            # After data is lost, keep its warning as the final entry.
            if self._notice is not None:
                return

            # Once this store spills, keep every later entry behind it on disk.
            if self._first_offset is None and self._budget.reserve_memory(
                size
            ):
                # Fill memory before using slower disk storage.
                self._memory.append(entry)

                return

            # The last offset joins this entry to only this store's chain.
            offset, warning = self._budget.write(payload, self._last_offset)

            if offset is None:
                # Keep a readable explanation in place of discarded entries.
                self._set_notice(
                    warning or self._DISK_MESSAGE,
                    log=self._budget.claim_warning(
                        warning or self._DISK_MESSAGE
                    ),
                )

                return

            if self._first_offset is None:
                # Remember where replay for this store begins.
                self._first_offset = offset

            # This entry is now the final item in this store's disk chain.
            self._last_offset = offset

            # Count only entries that completed their disk write.
            self._disk_count += 1

    def _set_notice(self, message: str, log: bool = True) -> None:
        """Retain one bounded warning when entries must be discarded."""
        if self._notice is None:
            # The notice becomes the final entry returned to the caller.
            self._notice = NotifyLogEntry("WARNING", message)

            if log:
                # Also tell the application when this warning is first owned.
                _safe_internal_log(logging.WARNING, message)

    def __iter__(self) -> Iterator[NotifyLogEntry]:
        """Yield retained entries in capture order."""
        with self._lock:
            # Memory comes first because it contains the oldest entries.
            yield from self._memory

            if self._first_offset is not None:
                try:
                    # Follow only this store's entries in the shared file.
                    offset = self._first_offset

                    for index in range(self._disk_count):
                        # Read and restore one entry at its known location.
                        payload, next_offset = self._budget.read(offset)
                        yield self._decode(payload)

                        if (
                            next_offset == self._budget._END
                            and index + 1 < self._disk_count
                        ):
                            # The entry chain ended sooner than expected.
                            raise AppriseDiskIOError(
                                "truncated result log chain"
                            )

                        # Continue from the location saved in this record.
                        offset = next_offset

                except Exception as e:
                    # Replace unreadable content with one useful warning.
                    _safe_internal_log(logging.WARNING, self._READ_MESSAGE)
                    _safe_internal_log(
                        logging.DEBUG,
                        "Result log read exception: %s",
                        str(e),
                    )
                    yield NotifyLogEntry("WARNING", self._READ_MESSAGE)

            if self._notice is not None:
                # This stays last because later entries were discarded.
                yield self._notice

    def __len__(self) -> int:
        """Return the number of retained entries and any storage warning."""
        with self._lock:
            return (
                len(self._memory)
                + self._disk_count
                + (self._notice is not None)
            )

    def __getitem__(
        self, index: Union[int, slice]
    ) -> Union[NotifyLogEntry, list[NotifyLogEntry]]:
        """Return an entry or slice using normal sequence behavior."""
        with self._lock:
            # Return simple in-memory indexes without reading saved entries.
            if isinstance(index, int) and 0 <= index < len(self._memory):
                # The lock keeps another thread from changing the list here.
                return self._memory[index]

        # Slices, negative indexes, and saved entries need the full list.
        # Iteration already joins memory, saved entries, and warning data.
        return list(self)[index]

    def __eq__(self, other: object) -> bool:
        """Compare retained entries with another iterable."""
        if isinstance(other, _NotifyLogStore):
            return list(self) == list(other)

        if isinstance(other, (list, tuple)):
            return list(self) == list(other)

        return NotImplemented

    def close(self) -> None:
        """Release any temporary file owned by this store."""
        with self._lock:
            if not self._closed:
                # Clear locations so a closed store cannot replay disk data.
                self._closed = True

                self._first_offset = None

                self._last_offset = None

                self._disk_count = 0

                # Release this store's ownership of shared temporary storage.
                self._budget.release_store()

    def __del__(self) -> None:
        """Best-effort cleanup when callers do not close the result."""
        with contextlib.suppress(Exception):
            # Interpreter shutdown may already have cleared module globals.
            self.close()


class _ServiceLogCapture(logging.Handler):
    """Capture logs for one service or one notification call.

    The capture mode depends on ``service``:

    - A service captures entries from its current notification attempt.
    - ``service=None`` captures orchestration entries for the whole call.

    ``log_callback`` receives entries live and should return promptly.
    """

    def __init__(
        self,
        service: Optional[NotifyBase] = None,
        log_callback: Optional[
            Callable[[NotifyLogEntry, Optional[NotifyBase]], None]
        ] = None,
        level: int = logging.WARNING,
        memory_size: int = 0,
        disk_size: int = 0,
    ) -> None:
        """Prepare a service-level or call-level log handler."""
        super().__init__(level=level)

        # A service capture can reuse the budget owned by its enclosing call.
        call_capture = _active_call_capture.get()

        # Standalone and call-level captures create their own shared budget.
        self._budget = (
            call_capture._budget
            if service is not None and call_capture is not None
            else _LogCaptureBudget(memory_size, disk_size)
        )

        # Each handler owns one ordered view into that shared budget.
        self._entries = _NotifyLogStore(self._budget)

        # Call-level orchestration messages use the shared logger.
        self._logger = getattr(service, "logger", logger)

        # None identifies a call-level entry to the callback.
        self._service = service

        # The optional callback receives entries as they are captured.
        self._log_callback = log_callback

        # This token restores an enclosing service capture on exit.
        self._token: Optional[contextvars.Token] = None

        # This token restores an enclosing call capture on exit.
        self._call_token: Optional[contextvars.Token] = None

        # Prevent a callback from logging recursively through this handler.
        self._in_emit = False

    def emit(self, record: logging.LogRecord) -> None:
        """Store a record owned by this capture."""
        # Ignore logging triggered by this handler's own callback or warnings.
        if self._in_emit:
            return

        # Set the guard before formatting or invoking user callback code.
        self._in_emit = True

        try:
            self._emit(record)

        finally:
            # Always allow the next independent record through.
            self._in_emit = False

    def _emit(self, record: logging.LogRecord) -> None:
        """Process a record after the reentrancy check."""
        try:
            if not getattr(record, "apprise_capture", True):
                # Keep sensitive local messages out of results and streams.
                return

            if self._service is not None:
                # Per-service: only the exact active capture accepts.
                if _active_capture.get() is not self:
                    return

            else:
                # Accept only unclaimed records from this notification call.
                if (
                    _active_call_capture.get() is not self
                    or _active_capture.get() is not None
                ):
                    return

            entry = NotifyLogEntry(
                level=record.levelname,
                # Preserve normal logging behavior for formatted messages.
                # The outer handler catches malformed format strings.
                message=record.getMessage(),
                # Match the UTC-aware timestamps used by other results.
                time=datetime.fromtimestamp(record.created, tz=timezone.utc),
            )

            # Retain the entry before notifying a live callback.  A record
            # marked apprise_store=False is delivered live but not kept,
            # for a message the caller already stores somewhere itself.
            if getattr(record, "apprise_store", True):
                self._entries.append(entry)

            # Copy the reference in case application code later replaces it.
            callback = self._log_callback

            if callback is not None:
                self._invoke_log_callback(entry, callback)

        except Exception:
            # Use logging's normal error path for formatting or storage errors.
            self.handleError(record)

    def _invoke_log_callback(
        self,
        entry: NotifyLogEntry,
        callback: Callable[[NotifyLogEntry, Optional[NotifyBase]], None],
    ) -> None:
        """Call ``log_callback(entry, service)``.

        ``service`` is ``None`` for call-level entries. The return value is
        ignored.
        """
        try:
            result = callback(entry, self._service)

        except Exception as e:
            _safe_internal_log(
                logging.WARNING,
                "The log_callback function raised an exception.",
            )
            _safe_internal_log(
                logging.DEBUG,
                "log_callback Exception: %s",
                str(e),
            )
            return

        if asyncio.iscoroutine(result):
            # Close unsupported async callbacks without leaking a warning.
            result.close()

            _safe_internal_log(
                logging.WARNING,
                "The log_callback function must be synchronous; its "
                "returned coroutine was ignored. Schedule async work "
                "from inside the callback instead.",
            )

    @property
    def entries(self) -> _NotifyLogStore:
        """Return entries captured at or above this handler's level."""
        return self._entries

    def __enter__(self) -> _ServiceLogCapture:
        """Attach the handler and mark its capture context."""
        # Begin receiving records from the logger owned by this capture.
        self._logger.addHandler(self)

        if self._service is not None:
            # Mark this as the active capture for one service attempt.
            self._token = _active_capture.set(self)

        else:
            # Mark this as the active capture for the complete notify call.
            self._call_token = _active_call_capture.set(self)

        return self

    def __exit__(self, *_: object) -> None:
        """Detach the handler and restore the enclosing capture."""
        # Stop receiving records before changing the active context.
        self._logger.removeHandler(self)

        if self._token is not None:
            # Restore any service capture that surrounded this one.
            _active_capture.reset(self._token)

        if self._call_token is not None:
            # Restore any call capture that surrounded this one.
            _active_call_capture.reset(self._call_token)


class LogCapture:
    """A class used to allow one to instantiate loggers that write to memory
    for temporary purposes. e.g.:

    1.  with LogCapture() as captured:
    2.
    3.      # Send our notification(s)
    4.      aobj.notify("hello world")
    5.
    6.      # retrieve our logs produced by the above call via our
    7.      # `captured` StringIO object we have access to within the `with`
    8.      # block here:
    9.      print(captured.getvalue())
    """

    def __init__(
        self,
        path=None,
        level=None,
        name=LOGGER_NAME,
        delete=True,
        fmt="%(asctime)s - %(levelname)s - %(message)s",
    ):
        """Instantiate a temporary log capture object.

        If a path is specified, then log content is sent to that file instead
        of a StringIO object.

        You can optionally specify a logging level such as logging.INFO if you
        wish, otherwise by default the script uses whatever logging has been
        set globally. If you set delete to `False` then when using log files,
        they are not automatically cleaned up afterwards.

        Optionally over-ride the fmt as well if you wish.
        """
        # Our memory buffer placeholder
        self.__buffer_ptr = StringIO()

        # Store our file path as it will determine whether or not we write to
        # memory and a file
        self.__path = path
        self.__delete = delete

        # Our logging level tracking
        self.__level = level
        self.__restore_level = None

        # Acquire a pointer to our logger
        self.__logger = logging.getLogger(name)

        # Prepare our handler
        self.__handler = (
            logging.StreamHandler(self.__buffer_ptr)
            if not self.__path
            else logging.FileHandler(self.__path, mode="a", encoding="utf-8")
        )

        # Use the specified level, otherwise take on the already
        # effective level of our logger
        self.__handler.setLevel(
            self.__level
            if self.__level is not None
            else self.__logger.getEffectiveLevel()
        )

        # Prepare our formatter
        self.__handler.setFormatter(logging.Formatter(fmt))

    def __enter__(self):
        """Allows logger manipulation within a 'with' block."""

        if self.__level is not None:
            # Temporary adjust our log level if required
            self.__restore_level = self.__logger.getEffectiveLevel()
            if self.__restore_level > self.__level:
                # Bump our log level up for the duration of our `with`
                self.__logger.setLevel(self.__level)

            else:
                # No restoration required
                self.__restore_level = None

        else:
            # Do nothing but enforce that we have nothing to restore to
            self.__restore_level = None

        if self.__path:
            # If a path has been identified, ensure we can write to the path
            # and that the file exists
            with open(self.__path, "a"):
                os.utime(self.__path, None)

            # Update our buffer pointer
            self.__buffer_ptr = open(self.__path)

        # Add our handler
        self.__logger.addHandler(self.__handler)

        # return our memory pointer
        return self.__buffer_ptr

    def __exit__(self, exc_type, exc_value, tb):
        """Removes the handler gracefully when the with block has completed."""

        # Flush our content
        self.__handler.flush()
        self.__buffer_ptr.flush()

        # Drop our handler
        self.__logger.removeHandler(self.__handler)

        if self.__restore_level is not None:
            # Restore level
            self.__logger.setLevel(self.__restore_level)

        if self.__path:
            # Close our file pointer
            self.__buffer_ptr.close()
            self.__handler.close()
            if self.__delete:
                with contextlib.suppress(OSError):
                    # Always remove file afterwards
                    os.unlink(self.__path)

        return exc_type is None
caronc-apprise-dfec414/apprise/manager.py000066400000000000000000001040571526720371000205550ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import contextlib
import hashlib
import inspect
import os
from os.path import abspath, dirname, join
import re
import sys
import threading
import time

from .logger import logger
from .utils.disk import path_decode
from .utils.module import import_module
from .utils.parse import parse_list
from .utils.singleton import Singleton


class PluginManager(metaclass=Singleton):
    """Designed to be a singleton object to maintain all initialized loading of
    modules in memory."""

    # Description (used for logging)
    name = "Singleton Plugin"

    # Memory Space
    _id = "undefined"

    # Our Module Python path name
    module_name_prefix = f"apprise.{_id}"

    # The module path to scan
    module_path = join(abspath(dirname(__file__)), _id)

    # For filtering our result when scanning a module
    module_filter_re = re.compile(r"^(?P((?!_)[A-Za-z0-9]+))$")

    # thread safe loading
    _lock = threading.Lock()

    def __init__(self, *args, **kwargs):
        """Over-ride our class instantiation to provide a singleton."""

        self._module_map = None
        self._schema_map = None

        # This contains a mapping of all plugins dynamicaly loaded at runtime
        # from external modules such as the @notify decorator
        #
        # The elements here will be additionally added to the _schema_map if
        # there is no conflict otherwise.
        # The structure looks like the following:
        # Module path, e.g. /usr/share/apprise/plugins/my_notify_hook.py
        # {
        #   'path': path,
        #
        #   'notify': {
        #     'schema': {
        #       'name': 'Custom schema name',
        #       'fn_name': 'name_of_function_decorator_was_found_on',
        #       'url': 'schema://any/additional/info/found/on/url'
        #       'plugin': 
        #    },
        #     'schema2': {
        #       'name': 'Custom schema name',
        #       'fn_name': 'name_of_function_decorator_was_found_on',
        #       'url': 'schema://any/additional/info/found/on/url'
        #       'plugin': 
        #    }
        #  }
        # Note: that the  inherits from
        #       NotifyBase
        self._custom_module_map = {}

        # Track manually disabled modules (by their schema)
        self._disabled = set()

        # Reference counter for optional runtime libraries declared via
        # runtime_deps().  Maps top-level package name -> count of currently
        # *enabled* plugins that depend on it.  When a plugin is disabled and
        # its counter reaches zero the library *may* be evicted from
        # sys.modules - but only when evict_on_disable is True.
        self._dep_counter = {}

        # Controls whether libraries are evicted from sys.modules when their
        # dep counter reaches zero.  Defaults to False so that third-party
        # projects embedding Apprise are not surprised by modules disappearing.
        # The Apprise API sets this to True at startup to reclaim memory from
        # optional libraries whose plugins are all disabled.
        self.evict_on_disable = False

        # Hash of all paths previously scanned so we don't waste
        # effort/overhead doing it again
        self._paths_previously_scanned = set()

        # Track loaded module paths to prevent from loading them again
        self._loaded = set()

    def unload_modules(self, disable_native=False):
        """Reset our object and unload all modules."""

        with self._lock:
            if self._custom_module_map:
                # Handle Custom Module Assignments
                for meta in self._custom_module_map.values():
                    if meta["name"] not in self._module_map:
                        # Nothing to remove
                        continue

                    # For the purpose of tidying up un-used modules in memory
                    loaded = [
                        m
                        for m in sys.modules
                        if m.startswith(self._module_map[meta["name"]]["path"])
                    ]

                    for module_path in loaded:
                        del sys.modules[module_path]

            # Reset disabled plugins (if any)
            for schema in self._disabled:
                self._schema_map[schema].enabled = True
            self._disabled.clear()

            # Reset the library dependency counter (evict_on_disable is an
            # intentional configuration choice and is NOT reset here)
            self._dep_counter = {}

            # Reset our variables
            self._schema_map = {}
            self._custom_module_map = {}
            if disable_native:
                self._module_map = {}

            else:
                self._module_map = None
                self._loaded = set()

            # Reset our path cache
            self._paths_previously_scanned = set()

    def load_modules(self, path=None, name=None, force=False):
        """Load our modules into memory."""

        # Default value
        module_name_prefix = self.module_name_prefix if name is None else name
        module_path = self.module_path if path is None else path

        with self._lock:
            if not force and module_path in self._loaded:
                # We're done
                return

            # Our base reference
            module_count = len(self._module_map) if self._module_map else 0
            schema_count = len(self._schema_map) if self._schema_map else 0

            if not self:
                # Initialize our maps
                self._module_map = {}
                self._schema_map = {}
                self._custom_module_map = {}

            # Used for the detection of additional Notify Services objects
            # The .py extension is optional as we support loading directories
            # too
            module_re = re.compile(
                r"^(?P(?!base|_)[a-z0-9_]+)(\.py)?$", re.I
            )

            t_start = time.time()
            for f in os.listdir(module_path):
                tl_start = time.time()
                match = module_re.match(f)
                if not match:
                    # keep going
                    continue

                # Store our notification/plugin name:
                module_name = match.group("name")
                module_pyname = f"{module_name_prefix}.{module_name}"

                if module_name in self._module_map:
                    logger.warning(
                        "%s(s) (%s) already loaded; ignoring %s",
                        self.name,
                        module_name,
                        os.path.join(module_path, f),
                    )
                    continue

                try:
                    module = __import__(
                        module_pyname,
                        globals(),
                        locals(),
                        fromlist=[module_name],
                    )

                except ImportError:
                    # No problem, we can try again another way...
                    module = import_module(
                        os.path.join(module_path, f), module_pyname
                    )
                    if not module:
                        # logging found in import_module and not needed here
                        continue

                module_class = None
                for m_class in [
                    obj
                    for obj in dir(module)
                    if self.module_filter_re.match(obj)
                ]:
                    # Get our plugin
                    plugin = getattr(module, m_class)
                    if not hasattr(plugin, "app_id"):
                        # Filter out non-notification modules
                        logger.trace(
                            "(%s.%s) import failed; no app_id defined in %s",
                            self.name,
                            m_class,
                            os.path.join(module_path, f),
                        )
                        continue

                    # Add our plugin name to our module map
                    self._module_map[module_name] = {
                        "plugin": {plugin},
                        "module": module,
                        "path": f"{module_name_prefix}.{module_name}",
                        "native": True,
                    }

                    fn = getattr(plugin, "schemas", None)
                    schemas = set() if not callable(fn) else fn(plugin)

                    # map our schema to our plugin
                    for schema in schemas:
                        if schema in self._schema_map:
                            logger.error(
                                f"{self.name} schema ({schema}) mismatch"
                                " detected -"
                                f" {self._schema_map[schema]} already maps to"
                                f" {plugin}"
                            )
                            continue

                        # Assign plugin
                        self._schema_map[schema] = plugin

                    # Store our class
                    module_class = m_class
                    break

                if not module_class:
                    # Not a library we can load as it doesn't follow the simple
                    # rule that the class must bear the same name as the
                    # notification file itself.
                    logger.trace(
                        "%s (%s) import failed; no filename/Class "
                        "match found in %s",
                        self.name,
                        module_name,
                        os.path.join(module_path, f),
                    )
                    continue

                logger.trace(
                    f"{self.name} {module_name} loaded"
                    f" in {time.time() - tl_start:.6f}s"
                )

            # Track the directory loaded so we never load it again
            self._loaded.add(module_path)

            logger.debug(
                f"{len(self._module_map) - module_count} {self.name}(s) and"
                f" {len(self._schema_map) - schema_count} Schema(s) loaded in"
                f" {time.time() - t_start:.4f}s"
            )

            # Build the runtime dependency reference counter so that
            # disable() can evict libraries when their last user is
            # disabled.  This is done here (inside the lock) by iterating
            # _module_map directly to avoid a recursive lock acquisition.
            self._build_dep_counter()

    def module_detection(self, paths, cache=True):
        """Leverage the @notify decorator and load all objects found matching
        this."""
        # A simple restriction that we don't allow periods in the filename at
        # all so it can't be hidden (Linux OS's) and it won't conflict with
        # Python path naming.  This also prevents us from loading any python
        # file that starts with an underscore or dash
        # We allow for __init__.py as well
        module_re = re.compile(
            r"^(?P[_a-z0-9][a-z0-9._-]+)?(\.py)?$", re.I
        )

        # Validate if we're a loadable Python file or not
        valid_python_file_re = re.compile(r".+\.py(o|c)?$", re.IGNORECASE)

        if isinstance(paths, str):
            paths = [
                paths,
            ]

        if not paths or not isinstance(paths, (tuple, list)):
            # We're done
            return

        def _import_module(path):
            # Since our plugin name can conflict (as a module) with another
            # we want to generate random strings to avoid steping on
            # another's namespace
            if not (path and valid_python_file_re.match(path)):
                # Ignore file/module type
                logger.trace("Plugin Scan: Skipping %s", path)
                return

            t_start = time.time()
            module_name = hashlib.sha1(path.encode("utf-8")).hexdigest()
            module_pyname = "{prefix}.{name}".format(
                prefix="apprise.custom.module", name=module_name
            )

            if module_pyname in self._custom_module_map:
                # First clear out existing entries
                for schema in self._custom_module_map[module_pyname]["notify"]:
                    # Remove any mapped modules to this file
                    del self._schema_map[schema]

                # Reset
                del self._custom_module_map[module_pyname]

            # Load our module
            module = import_module(path, module_pyname)
            if not module:
                # No problem, we can't use this object
                logger.warning("Failed to load custom module: %s", path_)
                return

            # Print our loaded modules if any
            if module_pyname in self._custom_module_map:
                logger.debug(
                    "Custom module %s - %d schema(s)"
                    " (name=%s) loaded in %.6fs",
                    path_,
                    len(self._custom_module_map[module_pyname]["notify"]),
                    module_name,
                    (time.time() - t_start),
                )

                # Add our plugin name to our module map
                self._module_map[module_name] = {
                    "plugin": set(),
                    "module": module,
                    "path": module_pyname,
                    "native": False,
                }

                for schema, _meta in self._custom_module_map[module_pyname][
                    "notify"
                ].items():
                    # For mapping purposes; map our element in our main list
                    self._module_map[module_name]["plugin"].add(
                        self._schema_map[schema]
                    )

                    # Log our success
                    logger.info("Loaded custom notification: %s://", schema)
            else:
                # The code reaches here if we successfully loaded the Python
                # module but no hooks/triggers were found. So we can safely
                # just remove/ignore this entry
                del sys.modules[module_pyname]
                return

            # end of _import_module()
            return

        for path_ in paths:
            path = path_decode(path_)
            if (
                cache and path in self._paths_previously_scanned
            ) or not os.path.exists(path):
                # We're done as we've already scanned this
                continue

            # Store our path as a way of hashing it has been handled
            self._paths_previously_scanned.add(path)

            if os.path.isdir(path) and not os.path.isfile(
                os.path.join(path, "__init__.py")
            ):
                logger.debug("Scanning for custom plugins in: %s", path)
                for entry in os.listdir(path):
                    re_match = module_re.match(entry)
                    if not re_match:
                        # keep going
                        logger.trace("Plugin Scan: Ignoring %s", entry)
                        continue

                    new_path = os.path.join(path, entry)
                    if os.path.isdir(new_path):
                        # Update our path
                        new_path = os.path.join(path, entry, "__init__.py")
                        if not os.path.isfile(new_path):
                            logger.trace(
                                "Plugin Scan: Ignoring %s",
                                os.path.join(path, entry),
                            )
                            continue

                    if not cache or (
                        new_path not in self._paths_previously_scanned
                    ):
                        # Load our module
                        _import_module(new_path)

                        # Add our subdir path
                        self._paths_previously_scanned.add(new_path)
            else:
                if os.path.isdir(path):
                    # This logic is safe to apply because we already
                    # validated the directories state above; update our
                    # path
                    path = os.path.join(path, "__init__.py")
                    if cache and path in self._paths_previously_scanned:
                        continue

                    self._paths_previously_scanned.add(path)

                # directly load as is
                re_match = module_re.match(os.path.basename(path))
                # must be a match and must have a .py extension
                if not re_match or not re_match.group(1):
                    # keep going
                    logger.trace("Plugin Scan: Ignoring %s", path)
                    continue

                # Load our module
                _import_module(path)

        return None

    def add(self, plugin, schemas=None, url=None, send_func=None, force=False):
        """Ability to manually add Notification services to our stack."""

        if not self:
            # Lazy load
            self.load_modules()

        # Acquire a list of schemas
        p_schemas = parse_list(plugin.secure_protocol, plugin.protocol)
        if isinstance(schemas, str):
            schemas = [
                schemas,
            ]

        elif schemas is None:
            # Default
            schemas = p_schemas

        if not schemas or not isinstance(schemas, (set, tuple, list)):
            # We're done
            logger.error(
                "The schemas provided (type %s) is"
                " unsupported; loaded from %s.",
                type(schemas),
                send_func.__name__ if send_func else plugin.__class__.__name__,
            )
            return False

        # Convert our schemas into a set
        schemas = {s.lower() for s in schemas} | set(p_schemas)

        # Valdation
        conflict = [s for s in schemas if s in self]
        if conflict:
            if force:
                # Force implies that we unmap any conflicting schema entries
                # at the Apprise level, but we do not unload any previously
                # imported modules. This ensures other classes can safely
                # subclass from prior notify classes.
                logger.debug(
                    "The schema(s) (%s) are already defined and will be "
                    "force loaded; overriding %s%s.",
                    ", ".join(conflict),
                    "custom notify function " if send_func else "",
                    send_func.__name__
                    if send_func
                    else plugin.__class__.__name__,
                )
                self.remove(*conflict, unload=False)

            else:
                logger.warning(
                    "The schema(s) (%s) are already defined and could not be "
                    "loaded from %s%s.",
                    ", ".join(conflict),
                    "custom notify function " if send_func else "",
                    send_func.__name__
                    if send_func
                    else plugin.__class__.__name__,
                )
                return False

            # Re-check for conflicts after unmapping
            conflict = [s for s in schemas if s in self]
            if conflict:
                logger.warning(
                    "The schema(s) (%s) are already defined and could not be "
                    "loaded from %s%s.",
                    ", ".join(conflict),
                    "custom notify function " if send_func else "",
                    send_func.__name__
                    if send_func
                    else plugin.__class__.__name__,
                )
                return False

        if send_func:
            # Acquire the function name
            fn_name = send_func.__name__

            # Acquire the python filename path
            path = inspect.getfile(send_func)

            # Acquire our path to our module
            module_name = str(send_func.__module__)

            if module_name not in self._custom_module_map:
                # Support non-dynamic includes as well...
                self._custom_module_map[module_name] = {
                    # Name can be useful for indexing back into the
                    # _module_map object; this is the key to do it with:
                    "name": module_name.split(".")[-1],
                    # The path to the module loaded
                    "path": path,
                    # Initialize our template
                    "notify": {},
                }

            for schema in schemas:
                self._custom_module_map[module_name]["notify"][schema] = {
                    # The name of the send function the @notify decorator
                    # wrapped
                    "fn_name": fn_name,
                    # The URL that was provided in the @notify decorator call
                    # associated with the 'on='
                    "url": url,
                }

        else:
            module_name = hashlib.sha1(
                "".join(schemas).encode("utf-8")
            ).hexdigest()
            module_pyname = "{prefix}.{name}".format(
                prefix="apprise.adhoc.module", name=module_name
            )

            # Add our plugin name to our module map
            self._module_map[module_name] = {
                "plugin": {plugin},
                "module": None,
                "path": module_pyname,
                "native": False,
            }

        for schema in schemas:
            # Assign our mapping
            self._schema_map[schema] = plugin

        return True

    def remove(self, *schemas, unload=True):
        """Removes a loaded element (if defined)"""
        if not self:
            # Lazy load
            self.load_modules()

        for schema in schemas:
            with contextlib.suppress(KeyError):
                self._unmap_schema(schema, unload=unload)

    def plugins(self, include_disabled=True):
        """Return all of our loaded plugins."""
        if not self:
            # Lazy load
            self.load_modules()

        for module in self._module_map.values():
            for plugin in module["plugin"]:
                if not include_disabled and not plugin.enabled:
                    continue
                yield plugin

    def schemas(self, include_disabled=True):
        """Return all of our loaded schemas.

        if include_disabled == True, then even disabled notifications are
        returned
        """
        if not self:
            # Lazy load
            self.load_modules()

        # Return our list
        return (
            list(self._schema_map.keys())
            if include_disabled
            else [s for s in self._schema_map if self._schema_map[s].enabled]
        )

    def _build_dep_counter(self):
        """Build the runtime library reference counter from loaded plugins.

        Iterates `_module_map` directly (rather than calling
        `self.plugins()`) so it is safe to call while `_lock` is held
        inside `load_modules`.

        Only enabled plugins contribute to the counter - plugins already
        disabled because their optional library is not installed are not
        counted, as there is nothing in memory to evict for them.
        """
        self._dep_counter = {}
        if not self._module_map:
            return
        for module in self._module_map.values():
            for plugin in module["plugin"]:
                # Guard: attachment and other non-notify plugin types do not
                # carry `enabled` or `runtime_deps`; skip them safely.
                if not getattr(plugin, "enabled", False):
                    continue
                fn = getattr(plugin, "runtime_deps", None)
                if not callable(fn):
                    continue
                for lib in fn():
                    self._dep_counter[lib] = self._dep_counter.get(lib, 0) + 1

    def _evict_library(self, lib_name):
        """Remove a library and all its submodules from `sys.modules`.

        Called when `evict_on_disable` is `True` and the reference counter
        for *lib_name* reaches zero - meaning no enabled plugin requires it.
        """
        to_remove = [
            k
            for k in sys.modules
            if k == lib_name or k.startswith(lib_name + ".")
        ]

        evicted = 0
        for key in to_remove:
            try:
                del sys.modules[key]
                evicted += 1
            except KeyError:
                logger.trace("Eviction skipped: '%s' not in sys.modules", key)

        if evicted:
            logger.debug(
                "Evicted %d module(s) for '%s' from memory",
                evicted,
                lib_name,
            )
        elif to_remove:
            # Keys were found but all raised KeyError (race condition)
            logger.trace(
                "Eviction of '%s' found %d candidate(s) but removed none",
                lib_name,
                len(to_remove),
            )

    def _update_dep_counter(self, plugin, delta):
        """Increment or decrement dep counters for *plugin* by *delta* (+1/-1).

        Evicts libraries from memory when `evict_on_disable` is `True` and the
        counter reaches zero.
        """
        fn = getattr(plugin, "runtime_deps", None)
        if not callable(fn):
            return
        for lib in fn():
            count = self._dep_counter.get(lib, 0) + delta
            self._dep_counter[lib] = max(0, count)
            logger.trace(
                "Dep counter '%s': %d -> %d",
                lib,
                count - delta,
                self._dep_counter[lib],
            )
            if self.evict_on_disable and count <= 0:
                self._evict_library(lib)

    def disable(self, *schemas):
        """Disables the modules associated with the specified schemas."""
        if not self:
            # Lazy load
            self.load_modules()

        for schema in schemas:
            if schema not in self._schema_map:
                continue

            plugin = self._schema_map[schema]
            if not plugin.enabled:
                continue

            # Disable via the plugin classmethod so subclasses can hook in
            plugin.disable()
            self._disabled.add(schema)
            logger.debug("Disabled %s plugin (%s://)", self.name, schema)

            # Decrement dep counters; evict if evict_on_disable and zero
            self._update_dep_counter(plugin, -1)

    def enable_only(self, *schemas):
        """Disables the modules associated with the specified schemas."""
        if not self:
            # Lazy load
            self.load_modules()

        # convert to set for faster indexing
        schemas = set(schemas)

        for plugin in self.plugins():
            # Get our plugin's schema list
            p_schemas = set(
                parse_list(plugin.secure_protocol, plugin.protocol)
            )

            if not schemas & p_schemas:
                if plugin.enabled:
                    # Disable it (only if previously enabled); this prevents us
                    # from adjusting schemas that were disabled due to missing
                    # libraries or other environment reasons
                    plugin.disable()
                    self._disabled |= p_schemas
                    logger.debug(
                        "Disabled %s plugin (%s)",
                        self.name,
                        ", ".join(f"{s}://" for s in p_schemas),
                    )

                    # Decrement dep counters; evict at zero if evict_on_disable
                    self._update_dep_counter(plugin, -1)
                continue

            # If we reach here, our schema was flagged to be enabled
            if p_schemas & self._disabled:
                # Previously disabled; no worries, let's clear this up
                self._disabled -= p_schemas
                plugin.enable()
                logger.debug(
                    "Enabled %s plugin (%s)",
                    self.name,
                    ", ".join(f"{s}://" for s in p_schemas),
                )

                # Increment dep counters for the re-enabled plugin
                self._update_dep_counter(plugin, +1)

    def __contains__(self, schema):
        """Checks if a schema exists."""
        if not self:
            # Lazy load
            self.load_modules()

        return schema in self._schema_map

    def __delitem__(self, schema):
        """
        removes schema map and also unloads it from memory
        """
        self._unmap_schema(schema, unload=True)

    def __setitem__(self, schema, plugin):
        """Support fast assigning of Plugin/Notification Objects."""
        if not self:
            # Lazy load
            self.load_modules()

        # Set default values if not otherwise set
        if not plugin.service_name:
            # Assign service name if one doesn't exist
            plugin.service_name = f"{schema}://"

        p_schemas = set(parse_list(plugin.secure_protocol, plugin.protocol))
        if not p_schemas:
            # Assign our protocol
            plugin.secure_protocol = schema
            p_schemas.add(schema)

        elif schema not in p_schemas:
            # Add our others (if defined)
            plugin.secure_protocol = {
                schema,
                *parse_list(plugin.secure_protocol),
            }
            p_schemas.add(schema)

        if not self.add(plugin, schemas=p_schemas):
            raise KeyError("Conflicting Assignment")

    def _unmap_schema(self, schema, *, unload=True):
        """Unmap a schema entry without necessarily unloading modules.

        This function removes the schema mapping and updates internal cross
        references. When unload is True (default), modules are removed from
        sys.modules when they are no longer referenced by Apprise. When unload
        is False, the unmapping is performed but any imported modules remain
        intact in sys.modules.
        """

        if not self:
            # Lazy load
            self.load_modules()

        # Get our plugin (otherwise we throw a KeyError) which is intended on
        # unmap action that doesn't align.
        plugin = self._schema_map[schema]

        # Our list of all schema entries
        p_schemas = {schema}

        for key in list(self._module_map.keys()):
            if plugin in self._module_map[key]["plugin"]:
                # Remove our plugin
                self._module_map[key]["plugin"].remove(plugin)

                # Custom Plugin Entry; Clean up cross reference
                module_pyname = self._module_map[key]["path"]
                if (
                    not self._module_map[key]["native"]
                    and module_pyname in self._custom_module_map
                ):
                    notify = self._custom_module_map[module_pyname]["notify"]
                    del notify[schema]

                    if not self._custom_module_map[module_pyname]["notify"]:
                        #
                        # Last custom loaded element
                        #

                        # Free up custom object entry
                        del self._custom_module_map[module_pyname]

                if not self._module_map[key]["plugin"]:
                    #
                    # Last element
                    #
                    if self._module_map[key]["native"]:
                        # Get our plugin's schema list
                        p_schemas = {
                            s
                            for s in parse_list(
                                plugin.secure_protocol, plugin.protocol
                            )
                            if s in self._schema_map
                        }

                    # Free system memory only when unload=True
                    if unload and self._module_map[key]["module"]:
                        with contextlib.suppress(KeyError):
                            del sys.modules[self._module_map[key]["path"]]

                    # Free last remaining pointer in module map
                    del self._module_map[key]

        for schema in p_schemas:
            # Final tidy
            del self._schema_map[schema]

    def __getitem__(self, schema):
        """Returns the indexed plugin identified by the schema specified."""
        if not self:
            # Lazy load
            self.load_modules()

        return self._schema_map[schema]

    def __iter__(self):
        """Returns an iterator so we can iterate over our loaded modules."""
        if not self:
            # Lazy load
            self.load_modules()

        return iter(self._module_map.values())

    def __len__(self):
        """Returns the number of modules/plugins loaded."""
        if not self:
            # Lazy load
            self.load_modules()

        return len(self._module_map)

    def __bool__(self):
        """Determines if object has loaded or not."""
        return bool(self._loaded and self._module_map is not None)
caronc-apprise-dfec414/apprise/manager_attachment.py000066400000000000000000000041261526720371000227610ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from os.path import abspath, dirname, join
import re

from .manager import PluginManager


class AttachmentManager(PluginManager):
    """Designed to be a singleton object to maintain all initialized attachment
    plugins/modules in memory."""

    # Description (used for logging)
    name = "Attachment Plugin"

    # Filename Prefix to filter on
    fname_prefix = "Attach"

    # Memory Space
    _id = "attachment"

    # Our Module Python path name
    module_name_prefix = f"apprise.{_id}"

    # The module path to scan
    module_path = join(abspath(dirname(__file__)), _id)

    # For filtering our result set
    module_filter_re = re.compile(
        r"^(?P" + fname_prefix + r"(?!Base)[A-Za-z0-9]+)$"
    )
caronc-apprise-dfec414/apprise/manager_config.py000066400000000000000000000041421526720371000220740ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from os.path import abspath, dirname, join
import re

from .manager import PluginManager


class ConfigurationManager(PluginManager):
    """Designed to be a singleton object to maintain all initialized
    configuration plugins/modules in memory."""

    # Description (used for logging)
    name = "Configuration Plugin"

    # Filename Prefix to filter on
    fname_prefix = "Config"

    # Memory Space
    _id = "config"

    # Our Module Python path name
    module_name_prefix = f"apprise.{_id}"

    # The module path to scan
    module_path = join(abspath(dirname(__file__)), _id)

    # For filtering our result set
    module_filter_re = re.compile(
        r"^(?P" + fname_prefix + r"(?!Base|Format)[A-Za-z0-9]+)$"
    )
caronc-apprise-dfec414/apprise/manager_plugins.py000066400000000000000000000041601526720371000223100ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from os.path import abspath, dirname, join
import re

from .manager import PluginManager


class NotificationManager(PluginManager):
    """Designed to be a singleton object to maintain all initialized
    notifications in memory."""

    # Description (used for logging)
    name = "Notification Plugin"

    # Filename Prefix to filter on
    fname_prefix = "Notify"

    # Memory Space
    _id = "plugins"

    # Our Module Python path name
    module_name_prefix = f"apprise.{_id}"

    # The module path to scan
    module_path = join(abspath(dirname(__file__)), _id)

    # For filtering our result set
    module_filter_re = re.compile(
        r"^(?P"
        + fname_prefix
        + r"(?!Base|Format|ImageSize|Type)[A-Za-z0-9]+)$"
    )
caronc-apprise-dfec414/apprise/persistent_store.py000066400000000000000000001673601526720371000225650ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import base64
import binascii
import builtins
from collections.abc import Sequence, Set as AbstractSet
import contextlib
from datetime import datetime, timedelta, timezone
import glob
import gzip
import hashlib
from itertools import chain
import json
import os
import re
import tempfile
import time
from typing import Any, Optional, Union
import zlib

from . import exception
from .common import (
    AWARE_DATE_ISO_FORMAT,
    JSON_COMPACT_SEPARATORS,
    NAIVE_DATE_ISO_FORMAT,
    PersistentStoreMode,
)
from .exception import AppriseImproperlyConfigured
from .logger import logger
from .utils.disk import path_decode

# Used for writing/reading time stored in cache file
EPOCH = datetime(1970, 1, 1, tzinfo=timezone.utc)


def _ntf_tidy(ntf):
    """Reusable NamedTemporaryFile Cleanup."""
    if ntf:
        # Cleanup
        with contextlib.suppress(OSError):
            ntf.close()

        try:
            os.unlink(ntf.name)
            logger.trace("Persistent temporary file removed: %s", ntf.name)

        except (FileNotFoundError, AttributeError):
            # AttributeError: something weird was passed in, no action required
            # FileNotFound: no worries; we were removing it anyway
            pass

        except OSError as e:
            logger.error(
                "Persistent temporary file removal failed: %s", ntf.name
            )
            logger.debug("Persistent Storage Exception: %s", str(e))


class CacheObject:
    hash_engine = hashlib.sha256
    hash_length = 6

    def __init__(
        self,
        value: Any = None,
        expires: Union[bool, float, int, datetime, None] = False,
        persistent: bool = True,
    ) -> None:
        """Tracks our objects and associates a time limit with them."""

        self.__value = value
        self.__class_name = value.__class__.__name__
        self.__expires = None

        if expires:
            self.set_expiry(expires)

        # Whether or not we persist this object to disk or not
        self.__persistent = bool(persistent)

    def set(
        self,
        value: Any,
        expires: Union[bool, float, int, datetime, None] = None,
        persistent: Optional[bool] = None,
    ) -> None:
        """Replace the value and optionally update its metadata.

        Existing expiry and persistence settings remain when their arguments
        are ``None``.
        """

        self.__value = value
        self.__class_name = value.__class__.__name__
        if expires is not None:
            self.set_expiry(expires)

        if persistent is not None:
            self.__persistent = bool(persistent)

    def set_expiry(
        self, expires: Union[datetime, bool, float, int, None] = None
    ) -> None:
        """Sets a new expiry."""

        if isinstance(expires, datetime):
            self.__expires = expires.astimezone(timezone.utc)

        elif expires in (None, False):
            # Accepted - no expiry
            self.__expires = None

        elif expires is True:
            # Force expiry to now
            self.__expires = datetime.now(tz=timezone.utc)

        elif isinstance(expires, (float, int)):
            self.__expires = datetime.now(tz=timezone.utc) + timedelta(
                seconds=expires
            )

        else:  # Unsupported
            raise AppriseImproperlyConfigured(
                f"An invalid expiry time ({expires} was specified"
            )

    def hash(self) -> str:
        """Our checksum to track the validity of our data."""
        return self.hash_engine(
            str(self).encode("utf-8"), usedforsecurity=False
        ).hexdigest()

    def json(self) -> Optional[dict[str, Any]]:
        """Returns our preparable json object."""

        return {
            "v": self.__value,
            "x": (
                (self.__expires - EPOCH).total_seconds()
                if self.__expires
                else None
            ),
            "c": (
                self.__class_name
                if not isinstance(self.__value, datetime)
                else (
                    "aware_datetime"
                    if self.__value.tzinfo
                    else "naive_datetime"
                )
            ),
            "!": self.hash()[: self.hash_length],
        }

    @staticmethod
    def instantiate(
        content: dict[str, Any],
        persistent: bool = True,
        verify: bool = True,
    ) -> Optional["CacheObject"]:
        """Loads back data read in and returns a CacheObject or None if it
        could not be loaded.

        You can pass in the contents of CacheObject.json() and you'll receive a
        copy assuming the hash checks okay
        """
        try:
            value = content["v"]
            expires = content["x"]
            if expires is not None:
                expires = datetime.fromtimestamp(expires, timezone.utc)

            # Acquire some useful integrity objects
            class_name = content.get("c", "")
            if not isinstance(class_name, str):
                raise AppriseImproperlyConfigured(
                    "Class name not expected string"
                )

            hashsum = content.get("!", "")
            if not isinstance(hashsum, str):
                raise AppriseImproperlyConfigured(
                    "SHA1SUM not expected string"
                )

        except (TypeError, KeyError) as e:
            logger.trace(f"CacheObject could not be parsed from {content}")
            logger.trace("CacheObject exception: %s", str(e))
            return None

        if class_name in ("aware_datetime", "naive_datetime", "datetime"):
            # If datetime is detected, it will fall under the naive category
            iso_format = (
                AWARE_DATE_ISO_FORMAT
                if class_name[0] == "a"
                else NAIVE_DATE_ISO_FORMAT
            )
            try:
                # Python v3.6 Support
                value = datetime.strptime(value, iso_format)

            except (TypeError, ValueError):
                # TypeError is thrown if content is not string
                # ValueError is thrown if the string is not a valid format
                logger.trace(
                    f"CacheObject (dt) corrupted loading from {content}"
                )
                return None

        elif class_name == "bytes":
            try:
                # Convert our object back to a bytes
                value = base64.b64decode(value)

            except binascii.Error:
                logger.trace(
                    f"CacheObject (bin) corrupted loading from {content}"
                )
                return None

        # Initialize our object
        co = CacheObject(value, expires, persistent=persistent)
        if verify and co.hash()[: co.hash_length] != hashsum:
            # Our object was tampered with
            logger.debug(f"Tampering detected with cache entry {co}")
            del co
            return None

        return co

    @property
    def value(self) -> Any:
        """Returns our value."""
        return self.__value

    @property
    def persistent(self) -> bool:
        """Returns our persistent value."""
        return self.__persistent

    @property
    def expires(self) -> Optional[datetime]:
        """Returns the datetime the object will expire."""
        return self.__expires

    @property
    def expires_sec(self) -> Optional[float]:
        """Returns the number of seconds from now the object will expire."""

        return (
            None
            if self.__expires is None
            else max(
                0.0,
                (
                    self.__expires - datetime.now(tz=timezone.utc)
                ).total_seconds(),
            )
        )

    def __bool__(self) -> bool:
        """Returns True it the object hasn't expired, and False if it has."""
        if self.__expires is None:
            # No Expiry
            return True

        # Calculate if we've expired or not
        return self.__expires > datetime.now(tz=timezone.utc)

    def __eq__(self, other) -> bool:
        """Handles equality == flag."""
        if isinstance(other, CacheObject):
            return str(self) == str(other)

        return self.__value == other

    def __str__(self) -> str:
        """String output of our data."""
        persistent = "+" if self.persistent else "-"
        return f"{self.__class_name}:{persistent}:{self.__value} expires: " + (
            "never"
            if self.__expires is None
            else self.__expires.strftime(NAIVE_DATE_ISO_FORMAT)
        )


class CacheJSONEncoder(json.JSONEncoder):
    """A JSON Encoder for handling each of our cache objects."""

    def default(self, entry):
        if isinstance(entry, datetime):
            return entry.strftime(
                AWARE_DATE_ISO_FORMAT
                if entry.tzinfo is not None
                else NAIVE_DATE_ISO_FORMAT
            )

        elif isinstance(entry, CacheObject):
            return entry.json()

        elif isinstance(entry, bytes):
            return base64.b64encode(entry).decode("utf-8")

        return super().default(entry)


class PersistentStore:
    """An object to make working with persistent storage easier.

    read() and write() are used for direct file i/o

    set(), get() are used for caching
    """

    # The maximum file-size we will allow the persistent store to grow to
    # 1 MB = 1048576 bytes
    max_file_size = 1048576

    # 30 days in seconds
    default_file_expiry = 2678400

    # File encoding to use
    encoding = "utf-8"

    # Default data set
    base_key = "default"

    # Directory to store cache
    __cache_key = "cache"

    # Our Temporary working directory
    temp_dir = "tmp"

    # The directory our persistent store content gets placed in
    data_dir = "var"

    # Our Persistent Store File Extension
    __extension = ".psdata"

    # Identify our backup file extension
    __backup_extension = "._psbak"

    # Used to verify the key specified is valid
    #  - must start with an alpha_numeric
    #  - following optional characters can include period, underscore and
    #    equal
    __valid_key = re.compile(r"[a-z0-9][a-z0-9._-]*", re.I)

    # Reference only
    __not_found_ref = (None, None)

    def __init__(
        self,
        path: Optional[str] = None,
        namespace: str = "default",
        mode: Optional[Union[str, PersistentStoreMode]] = None,
    ) -> None:
        """Provide the namespace to work within.

        namespaces can only contain alpha-numeric characters with the exception
        of '-' (dash), '_' (underscore), and '.' (period). The namespace must
        be be relative to the current URL being controlled.
        """
        # Initalize our mode so __del__() calls don't go bad on the
        # error checking below
        self.__mode = None

        # Populated only once and after size() is called
        self.__exclude_list = None

        # Files to renew on calls to flush
        self.__renew = set()

        if not isinstance(namespace, str) or not self.__valid_key.fullmatch(
            namespace
        ):
            raise AppriseImproperlyConfigured(
                f"Persistent Storage namespace ({namespace}) provided is"
                " invalid"
            )

        if isinstance(path, str):
            # A storage path has been defined
            if mode is None:
                # Store Default if no mode was provided along side of it
                mode = PersistentStoreMode.AUTO

            # Store our information
            self.__base_path = os.path.join(path_decode(path), namespace)
            self.__temp_path = os.path.join(self.__base_path, self.temp_dir)
            self.__data_path = os.path.join(self.__base_path, self.data_dir)

        else:  # If no storage path is provide we set our mode to MEMORY
            mode = PersistentStoreMode.MEMORY
            self.__base_path = None
            self.__temp_path = None
            self.__data_path = None

        # Tracks when we have content to flush
        self.__dirty = False

        # A caching value to track persistent storage disk size
        self.__cache_size = None
        self.__cache_files = {}

        # Internal Cache
        self._cache = None

        try:
            # Store our mode
            self.__mode = (
                mode
                if isinstance(mode, PersistentStoreMode)
                else PersistentStoreMode(mode.lower())
            )

        except (AttributeError, ValueError):
            err = f"An invalid persistent storage mode ({mode}) was specified."
            logger.warning(err)
            raise AppriseImproperlyConfigured(err) from None

        # Prepare our environment
        self.__prepare()

    def read(
        self,
        key: Optional[str] = None,
        compress: bool = True,
        expires: Union[bool, float, int] = False,
    ) -> Optional[bytes]:
        """Read stored content as bytes.

        With ``expires=False``, the entry is marked for renewal so pruning
        does not remove it.
        """
        # Use the default key so renewal targets the file actually read.
        if key is None:
            key = self.base_key

        try:
            with self.open(key, mode="rb", compress=compress) as fd:
                results = fd.read(self.max_file_size)
                if expires is False:
                    self.__renew.add(
                        os.path.join(
                            self.__data_path, f"{key}{self.__extension}"
                        )
                    )

                return results

        except (FileNotFoundError, exception.AppriseDiskIOError):
            # FileNotFoundError: No problem
            # exception.AppriseDiskIOError:
            #   - Logging of error already occurred inside self.open()
            pass

        except (OSError, zlib.error, EOFError, UnicodeDecodeError) as e:
            # We can't access the file or it does not exist
            logger.warning("Could not read with persistent key: %s", key)
            logger.debug("Persistent Storage Exception: %s", str(e))

        # return none
        return None

    def write(
        self,
        data: Union[bytes, str, Any],
        key: Optional[str] = None,
        compress: bool = True,
        _recovery: bool = False,
    ) -> bool:
        """Write content when it fits within the file-size limit.

        Content is stored as bytes. ``_recovery`` is for internal use.
        """

        if key is None:
            key = self.base_key

        elif not isinstance(key, str) or not self.__valid_key.fullmatch(key):
            raise AppriseImproperlyConfigured(
                f"Persistent Storage key ({key} provided is invalid"
            )

        if not isinstance(data, (bytes, str)):
            # Accept readable objects when they return bytes or text.
            if not (hasattr(data, "read") and callable(data.read)):
                raise AppriseImproperlyConfigured(
                    f"Invalid data type {type(data)} provided to Persistent"
                    " Storage"
                )

            try:
                # Read in our data
                data = data.read()
                if not isinstance(data, (bytes, str)):
                    raise AppriseImproperlyConfigured(
                        f"Invalid data type {type(data)} provided to"
                        " Persistent Storage"
                    )

            except Exception as e:
                logger.warning(
                    "Could read() from potential iostream with persistent "
                    "key: %s",
                    key,
                )
                logger.debug("Persistent Storage Exception: %s", str(e))
                raise exception.AppriseDiskIOError(
                    f"Invalid data type {type(data)} provided to Persistent"
                    " Storage"
                ) from None

        if self.__mode == PersistentStoreMode.MEMORY:
            # Nothing further can be done
            return False

        if _recovery:
            # Attempt to recover from a bad directory structure or setup
            self.__prepare()

        # generate our filename based on the key provided
        io_file = os.path.join(self.__data_path, f"{key}{self.__extension}")

        # Calculate the files current filesize
        try:
            prev_size = os.stat(io_file).st_size

        except FileNotFoundError:
            # No worries, no size to accommodate
            prev_size = 0

        except OSError as e:
            # Permission error of some kind or disk problem...
            # There is nothing we can do at this point
            logger.warning("Could not write with persistent key: %s", key)
            logger.debug("Persistent Storage Exception: %s", str(e))
            return False

        # Create a temporary file to write our content into
        # ntf = NamedTemporaryFile
        ntf = None
        new_file_size = 0
        try:
            if isinstance(data, str):
                data = data.encode(self.encoding)

            ntf = tempfile.NamedTemporaryFile(  # noqa: SIM115
                mode="wb", dir=self.__temp_path, delete=False
            )

            # Close our file
            ntf.close()

            # Pointer to our open call
            open_ = open if not compress else gzip.open

            with open_(ntf.name, mode="wb") as fd:
                # Write our content
                fd.write(data)

            # Get our file size
            new_file_size = os.stat(ntf.name).st_size

            # Log our progress
            logger.trace(
                "Wrote %d bytes of data to persistent key: %s",
                new_file_size,
                key,
            )

        except FileNotFoundError:
            # This happens if the directory path is gone preventing the file
            # from being created...
            if not _recovery:
                return self.write(
                    data=data, key=key, compress=compress, _recovery=True
                )

            # We've already made our best effort to recover if we are here in
            # our code base... we're going to have to exit

            # Tidy our Named Temporary File
            _ntf_tidy(ntf)

            # Early Exit
            return False

        except (OSError, UnicodeEncodeError, zlib.error) as e:
            # We can't access the file or it does not exist
            logger.warning("Could not write to persistent key: %s", key)
            logger.debug("Persistent Storage Exception: %s", str(e))

            # Tidy our Named Temporary File
            _ntf_tidy(ntf)

            return False

        if (
            self.max_file_size > 0
            and (new_file_size + self.size() - prev_size) > self.max_file_size
        ):
            # The content to store is too large.
            logger.warning(
                "Persistent content exceeds allowable maximum file length"
                f" ({int(self.max_file_size / 1024)}KB); provide"
                f" {int(new_file_size / 1024)}KB"
            )
            return False

        # Return our final move
        if not self.__move(ntf.name, io_file):
            # Attempt to restore things as they were

            # Tidy our Named Temporary File
            _ntf_tidy(ntf)
            return False

        # Resetour reference variables
        self.__cache_size = None
        self.__cache_files.clear()

        # Content installed
        return True

    def __move(self, src, dst):
        """Moves the new file in place and handles the old if it exists already
        If the transaction fails in any way, the old file is swapped back.

        Function returns True if successful and False if not.
        """

        # A temporary backup of the file we want to move in place
        dst_backup = (
            dst[: -len(self.__backup_extension)] + self.__backup_extension
        )

        #
        # Backup the old file (if it exists) allowing us to have a restore
        # point in the event of a failure
        #
        try:
            # make sure the file isn't already present; if it is; remove it
            os.unlink(dst_backup)
            logger.trace(
                "Removed previous persistent backup file: %s", dst_backup
            )

        except FileNotFoundError:
            # no worries; we were removing it anyway
            pass

        except OSError as e:
            # Permission error of some kind or disk problem...
            # There is nothing we can do at this point
            logger.warning(
                "Could not previous persistent data backup: %s", dst_backup
            )
            logger.debug("Persistent Storage Exception: %s", str(e))
            return False

        try:
            # Back our file up so we have a fallback
            os.rename(dst, dst_backup)
            logger.trace(
                "Persistent storage backup file created: %s", dst_backup
            )

        except FileNotFoundError:
            # Not a problem; this is a brand new file we're writing
            # There is nothing to backup
            pass

        except OSError as e:
            # This isn't good... we couldn't put our new file in place
            logger.warning(
                "Could not install persistent content %s -> %s",
                dst,
                os.path.basename(dst_backup),
            )
            logger.debug("Persistent Storage Exception: %s", str(e))
            return False

        #
        # Now place the new file
        #
        try:
            os.rename(src, dst)
            logger.trace("Persistent file installed: %s", dst)

        except OSError as e:
            # This isn't good... we couldn't put our new file in place
            # Begin fall-back process before leaving the funtion
            logger.warning(
                "Could not install persistent content %s -> %s",
                src,
                os.path.basename(dst),
            )
            logger.debug("Persistent Storage Exception: %s", str(e))
            try:
                # Restore our old backup (if it exists)
                os.rename(dst_backup, dst)
                logger.trace("Restoring original persistent content: %s", dst)

            except FileNotFoundError:
                # Not a problem
                pass

            except OSError as e:
                # Permission error of some kind or disk problem...
                # There is nothing we can do at this point
                logger.warning(
                    "Failed to restore original persistent file: %s", dst
                )
                logger.debug("Persistent Storage Exception: %s", str(e))

            return False

        return True

    def open(
        self,
        key: Optional[str] = None,
        mode: str = "r",
        buffering: int = -1,
        encoding: Optional[str] = None,
        errors: Optional[str] = None,
        newline: Optional[str] = None,
        closefd: bool = True,
        opener: Optional[Any] = None,
        compress: bool = False,
        compresslevel: int = 9,
    ) -> Any:
        """Open a stored file by key, using the default when omitted."""

        if key is None:
            key = self.base_key

        elif not isinstance(key, str) or not self.__valid_key.fullmatch(key):
            raise AppriseImproperlyConfigured(
                f"Persistent Storage key ({key} provided is invalid"
            )

        if self.__mode == PersistentStoreMode.MEMORY:
            # Memory-only storage has no file that can be opened.
            raise exception.AppriseFileNotFound(
                "Persistent storage has no disk-backed file"
            )

        io_file = os.path.join(self.__data_path, f"{key}{self.__extension}")
        try:
            return (
                open(
                    io_file,
                    mode=mode,
                    buffering=buffering,
                    encoding=encoding,
                    errors=errors,
                    newline=newline,
                    closefd=closefd,
                    opener=opener,
                )
                if not compress
                else gzip.open(
                    io_file,
                    compresslevel=compresslevel,
                    encoding=encoding,
                    errors=errors,
                    newline=newline,
                )
            )

        except FileNotFoundError:
            # pass along (but wrap with Apprise exception)
            raise exception.AppriseFileNotFound(
                f"No such file or directory: '{io_file}'"
            ) from None

        except (OSError, zlib.error) as e:
            # We can't access the file or it does not exist
            logger.warning("Could not read with persistent key: %s", key)
            logger.debug("Persistent Storage Exception: %s", str(e))
            raise exception.AppriseDiskIOError(str(e)) from None

    def get(
        self,
        key: str,
        default: Any = None,
        lazy: bool = True,
    ) -> Any:
        """Fetches from cache."""

        if self._cache is None and not self.__load_cache():
            return default

        if (
            key in self._cache
            and self.__mode != PersistentStoreMode.MEMORY
            and not self.__dirty
        ):
            # ensure we renew our content
            self.__renew.add(self.cache_file)

        return self._cache[key].value if self._cache.get(key) else default

    def set(
        self,
        key: str,
        value: Any,
        expires: Union[float, int, datetime, bool, None] = None,
        persistent: bool = True,
        lazy: bool = True,
    ) -> bool:
        """Cache reference."""

        if self._cache is None and not self.__load_cache():
            return False

        cache = CacheObject(value, expires, persistent=persistent)
        # Fetch our cache value
        try:
            if lazy and cache == self._cache[key]:
                # We're done; nothing further to do
                return True

        except KeyError:
            pass

        # Replacing a saved entry changes what is on disk too
        replaced = key in self._cache and self._cache[key].persistent

        # Store our new cache
        self._cache[key] = CacheObject(value, expires, persistent=persistent)

        # Set our dirty flag, but never clear it.  An earlier change may
        # still be waiting to be written.
        self.__dirty = self.__dirty or persistent or replaced

        if self.__dirty and self.__mode == PersistentStoreMode.FLUSH:
            # Flush changes to disk
            return self.flush()

        return True

    def clear(self, *args: str) -> Optional[bool]:
        """Remove selected cache keys, or all keys when none are given.

        Examples: ``clear("key")``, ``clear("key1", "key2")``, or
        ``clear()``.
        """
        if self._cache is None and not self.__load_cache():
            return False

        if args:
            for arg in args:
                try:
                    del self._cache[arg]

                    # Set our dirty flag (if not set already)
                    self.__dirty = True

                except KeyError:
                    pass

        elif self._cache:
            # Request to remove everything and there is something to remove

            # Set our dirty flag (if not set already)
            self.__dirty = True

            # Reset our object
            self._cache.clear()

        if self.__dirty and self.__mode == PersistentStoreMode.FLUSH:
            # Flush changes to disk
            return self.flush()

    def prune(self) -> bool:
        """Eliminates expired cache entries."""
        if self._cache is None and not self.__load_cache():
            return False

        change = False
        for key in list(self._cache.keys()):
            if key not in self:
                # It's identified as being expired
                if not change and self._cache[key].persistent:
                    # track change only if content was persistent
                    change = True

                    # Set our dirty flag
                    self.__dirty = True

                del self._cache[key]

        if self.__dirty and self.__mode == PersistentStoreMode.FLUSH:
            # Flush changes to disk
            return self.flush()

        return change

    def __load_cache(self, _recovery=False):
        """Loads our cache.

        _recovery is reserved for internal usage and should not be changed
        """

        # Prepare our dirty flag
        self.__dirty = False

        if self.__mode == PersistentStoreMode.MEMORY:
            # Nothing further to do
            self._cache = {}
            return True

        # Prepare our cache file
        cache_file = self.cache_file
        try:
            with gzip.open(cache_file, "rb") as f:
                # Read our ontent from disk
                self._cache = {}
                for k, v in json.loads(f.read().decode(self.encoding)).items():
                    co = CacheObject.instantiate(v)
                    if co:
                        # Verify our object before assigning it
                        self._cache[k] = co

                    elif not self.__dirty:
                        # Track changes from our loadset
                        self.__dirty = True

        except (
            UnicodeDecodeError,
            json.decoder.JSONDecodeError,
            zlib.error,
            TypeError,
            AttributeError,
            EOFError,
        ):
            # Let users known there was a problem
            logger.warning(
                "Corrupted access persistent cache content: %s", cache_file
            )

            if not _recovery:
                try:
                    os.unlink(cache_file)
                    logger.trace(
                        "Removed previous persistent cache content: %s",
                        cache_file,
                    )

                except FileNotFoundError:
                    # no worries; we were removing it anyway
                    pass

                except OSError as e:
                    # Permission error of some kind or disk problem...
                    # There is nothing we can do at this point
                    logger.warning(
                        "Could not remove persistent cache content: %s",
                        cache_file,
                    )
                    logger.debug("Persistent Storage Exception: %s", str(e))
                    return False
                return self.__load_cache(_recovery=True)

            return False

        except FileNotFoundError:
            # No problem; no cache to load
            self._cache = {}

        except OSError as e:
            # Permission error of some kind or disk problem...
            # There is nothing we can do at this point
            logger.warning(
                "Could not load persistent cache for namespace %s",
                os.path.basename(self.__base_path),
            )
            logger.debug("Persistent Storage Exception: %s", str(e))
            return False

        # Ensure our dirty flag is set to False
        return True

    def __prepare(self, flush=True):
        """Prepares a working environment."""
        if self.__mode != PersistentStoreMode.MEMORY:
            # Ensure our path exists
            try:
                os.makedirs(self.__base_path, mode=0o770, exist_ok=True)

            except OSError as e:
                # Permission error
                logger.debug(
                    "Could not create persistent store directory %s",
                    self.__base_path,
                )
                logger.debug("Persistent Storage Exception: %s", str(e))

                # Mode changed back to MEMORY
                self.__mode = PersistentStoreMode.MEMORY

            # Ensure our path exists
            try:
                os.makedirs(self.__temp_path, mode=0o770, exist_ok=True)

            except OSError as e:
                # Permission error
                logger.debug(
                    "Could not create persistent store directory %s",
                    self.__temp_path,
                )
                logger.debug("Persistent Storage Exception: %s", str(e))

                # Mode changed back to MEMORY
                self.__mode = PersistentStoreMode.MEMORY

            try:
                os.makedirs(self.__data_path, mode=0o770, exist_ok=True)

            except OSError as e:
                # Permission error
                logger.debug(
                    "Could not create persistent store directory %s",
                    self.__data_path,
                )
                logger.debug("Persistent Storage Exception: %s", str(e))

                # Mode changed back to MEMORY
                self.__mode = PersistentStoreMode.MEMORY

            if self.__mode is PersistentStoreMode.MEMORY:
                logger.warning(
                    "The persistent storage could not be fully initialized; "
                    "operating in MEMORY mode"
                )

            else:
                if self._cache:
                    # Recovery taking place
                    self.__dirty = True
                    logger.warning(
                        "The persistent storage environment was disrupted"
                    )

                    if self.__mode is PersistentStoreMode.FLUSH and flush:
                        # Flush changes to disk
                        return self.flush(_recovery=True)

    def flush(
        self,
        force: bool = False,
        _recovery: bool = False,
    ) -> bool:
        """Save the cache to disk."""

        if self.__mode == PersistentStoreMode.MEMORY:
            # nothing to do
            return True

        while self.__renew:
            # update our files
            path = self.__renew.pop()
            ftime = time.time()

            try:
                # (access_time, modify_time)
                os.utime(path, (ftime, ftime))
                logger.trace("file timestamp updated: %s", path)

            except FileNotFoundError:
                # No worries... move along
                pass

            except OSError as e:
                # We can't access the file or it does not exist
                logger.debug("Could not update file timestamp: %s", path)
                logger.debug("Persistent Storage Exception: %s", str(e))

        if self._cache is None:
            # The cache was never loaded, so there is nothing to save
            return True

        if not force and self.__dirty is False:
            # Nothing further to do
            logger.trace("Persistent cache is consistent with memory map")
            return True

        if _recovery:
            # Attempt to recover from a bad directory structure or setup
            self.__prepare(flush=False)

        # Unset our size lazy setting
        self.__cache_size = None
        self.__cache_files.clear()

        # Prepare our cache file
        cache_file = self.cache_file
        if not self._cache:
            #
            # We're deleting the cache file s there are no entries left in it
            #
            backup_file = (
                cache_file[: -len(self.__backup_extension)]
                + self.__backup_extension
            )

            try:
                os.unlink(backup_file)
                logger.trace(
                    "Removed previous persistent cache backup: %s", backup_file
                )

            except FileNotFoundError:
                # no worries; we were removing it anyway
                pass

            except OSError as e:
                # Permission error of some kind or disk problem...
                # There is nothing we can do at this point
                logger.warning(
                    "Could not remove persistent cache backup: %s", backup_file
                )
                logger.debug("Persistent Storage Exception: %s", str(e))
                return False

            try:
                os.rename(cache_file, backup_file)
                logger.trace(
                    "Persistent cache backup file created: %s", backup_file
                )

            except FileNotFoundError:
                # Not a problem; do not create a log entry
                pass

            except OSError as e:
                # This isn't good... we couldn't put our new file in place
                logger.warning(
                    "Could not remove stale persistent cache file: %s",
                    cache_file,
                )
                logger.debug("Persistent Storage Exception: %s", str(e))
                return False
            return True

        #
        # If we get here, we need to update our file based cache
        #

        # ntf = NamedTemporaryFile
        ntf = None

        try:
            ntf = tempfile.NamedTemporaryFile(  # noqa: SIM115
                mode="w+",
                encoding=self.encoding,
                dir=self.__temp_path,
                delete=False,
            )

            ntf.close()

        except FileNotFoundError:
            # This happens if the directory path is gone preventing the file
            # from being created...
            if not _recovery:
                return self.flush(force=True, _recovery=True)

            # We've already made our best effort to recover if we are here in
            # our code base... we're going to have to exit

            # Tidy our Named Temporary File
            _ntf_tidy(ntf)

            # Early Exit
            return False

        except OSError as e:
            logger.error(
                "Persistent temporary directory inaccessible: %s",
                self.__temp_path,
            )
            logger.debug("Persistent Storage Exception: %s", str(e))

            # Tidy our Named Temporary File
            _ntf_tidy(ntf)

            # Early Exit
            return False

        try:
            # write our content currently saved to disk to our temporary file
            with gzip.open(ntf.name, "wb") as f:
                # Write our content to disk
                f.write(
                    json.dumps(
                        {
                            k: v
                            for k, v in self._cache.items()
                            if v and v.persistent
                        },
                        separators=JSON_COMPACT_SEPARATORS,
                        cls=CacheJSONEncoder,
                    ).encode(self.encoding)
                )

        except TypeError as e:
            # JSON object contains content that can not be encoded to disk
            logger.error(
                "Persistent temporary file can not be written to "
                "due to bad input data: %s",
                ntf.name,
            )
            logger.debug("Persistent Storage Exception: %s", str(e))

            # Tidy our Named Temporary File
            _ntf_tidy(ntf)

            # Early Exit
            return False

        except (OSError, EOFError, zlib.error) as e:
            logger.error(
                "Persistent temporary file inaccessible: %s", ntf.name
            )
            logger.debug("Persistent Storage Exception: %s", str(e))

            # Tidy our Named Temporary File
            _ntf_tidy(ntf)

            # Early Exit
            return False

        if not self.__move(ntf.name, cache_file):
            # Attempt to restore things as they were

            # Tidy our Named Temporary File
            _ntf_tidy(ntf)
            return False

        # Ensure our dirty flag is set to False
        self.__dirty = False

        return True

    def files(
        self,
        exclude: bool = True,
        lazy: bool = True,
    ) -> list[str]:
        """Returns the total files."""

        if lazy and exclude in self.__cache_files:
            # Take an early exit with our cached results
            return self.__cache_files[exclude]

        elif self.__mode == PersistentStoreMode.MEMORY:
            # Take an early exit
            # exclude is our cache switch and can be either True or False.
            # For the below, we just set both cases and set them up as an
            # empty record
            self.__cache_files.update({True: [], False: []})
            return []

        if not lazy or self.__exclude_list is None:
            # A list of criteria that should be excluded from the size count
            self.__exclude_list = (
                # Exclude backup cache file from count
                re.compile(
                    re.escape(
                        os.path.join(
                            self.__base_path,
                            f"{self.__cache_key}{self.__backup_extension}",
                        )
                    )
                ),
                # Exclude temporary files
                re.compile(re.escape(self.__temp_path) + r"[/\\].+"),
                # Exclude custom backup persistent files
                re.compile(
                    re.escape(self.__data_path)
                    + r"[/\\].+"
                    + re.escape(self.__backup_extension)
                ),
            )

        try:
            if exclude:
                self.__cache_files[exclude] = [
                    path
                    for path in filter(
                        os.path.isfile,
                        glob.glob(
                            os.path.join(self.__base_path, "**", "*"),
                            recursive=True,
                        ),
                    )
                    if next(
                        (False for p in self.__exclude_list if p.match(path)),
                        True,
                    )
                ]

            else:  # No exclusion list applied
                self.__cache_files[exclude] = list(
                    filter(
                        os.path.isfile,
                        glob.glob(
                            os.path.join(self.__base_path, "**", "*"),
                            recursive=True,
                        ),
                    )
                )

        except OSError:
            # We can't access the directory or it does not exist
            self.__cache_files[exclude] = []

        return self.__cache_files[exclude]

    @staticmethod
    def disk_scan(
        path: str,
        namespace: Optional[
            Union[str, Sequence[str], AbstractSet[str]]
        ] = None,
        closest: bool = True,
    ) -> list[str]:
        """Scan a path and return the detected namespaces."""

        logger.trace("Persistent path can of: %s", path)

        def is_namespace(x):
            """Validate what was detected is a valid namespace."""
            return os.path.isdir(
                os.path.join(path, x)
            ) and PersistentStore.__valid_key.fullmatch(x)

        # Handle our namespace searching
        if namespace:
            if isinstance(namespace, str):
                namespace = [namespace]

            elif not isinstance(namespace, (tuple, set, list)):
                raise AppriseImproperlyConfigured(
                    "namespace must be None, a string, or a tuple/set/list "
                    "of strings"
                )

        try:
            # Acquire all of the files in question
            namespaces = (
                [
                    ns
                    for ns in filter(is_namespace, os.listdir(path))
                    if not namespace
                    or next(
                        (True for n in namespace if ns.startswith(n)), False
                    )
                ]
                if closest
                else [
                    ns
                    for ns in filter(is_namespace, os.listdir(path))
                    if not namespace or ns in namespace
                ]
            )

        except FileNotFoundError:
            # no worries; Nothing to do
            logger.debug("Disk Prune path not found; nothing to clean.")
            return []

        except OSError as e:
            # Permission error of some kind or disk problem...
            # There is nothing we can do at this point
            logger.error("Disk Scan detetcted inaccessible path: %s", path)
            logger.debug("Persistent Storage Exception: %s", str(e))
            return []

        return namespaces

    @staticmethod
    def disk_prune(
        path: str,
        namespace: Optional[
            Union[str, Sequence[str], AbstractSet[str]]
        ] = None,
        expires: Optional[Union[int, float]] = None,
        action: bool = False,
    ) -> dict[str, list[dict[str, Union[str, bool]]]]:
        """Find expired persistent files below ``path``.

        ``namespace`` limits the scan. ``action=False`` previews matches;
        ``action=True`` removes them and records the result.
        """

        # Prepare our File Expiry.  A missing or negative value falls
        # back to the default expiry.
        expires = datetime.now() - timedelta(
            seconds=expires
            if isinstance(expires, (float, int)) and expires >= 0
            else PersistentStore.default_file_expiry
        )

        # Get our namespaces
        namespaces = PersistentStore.disk_scan(path, namespace)

        # Track matches
        map_ = {}

        for namespace in namespaces:
            # Prepare our map
            map_[namespace] = []

            # Reference Directories
            base_dir = os.path.join(path, namespace)
            data_dir = os.path.join(base_dir, PersistentStore.data_dir)
            temp_dir = os.path.join(base_dir, PersistentStore.temp_dir)

            # Careful to only focus on files created by this Persistent Store
            # object
            files = [
                os.path.join(
                    base_dir,
                    f"{PersistentStore.__cache_key}"
                    f"{PersistentStore.__extension}",
                ),
                os.path.join(
                    base_dir,
                    f"{PersistentStore.__cache_key}"
                    f"{PersistentStore.__backup_extension}",
                ),
            ]

            # Update our files (applying what was defined above too)
            valid_data_re = re.compile(
                r".*("
                + re.escape(PersistentStore.__extension)
                + r"|"
                + re.escape(PersistentStore.__backup_extension)
                + r")$"
            )

            files = [
                path
                for path in filter(
                    os.path.isfile,
                    chain(
                        glob.glob(
                            os.path.join(data_dir, "*"), recursive=False
                        ),
                        files,
                    ),
                )
                if valid_data_re.match(path)
            ]

            # Now all temporary files
            files.extend(
                list(
                    filter(
                        os.path.isfile,
                        glob.glob(
                            os.path.join(temp_dir, "*"), recursive=False
                        ),
                    )
                )
            )

            # Track if we should do a directory sweep later on
            dir_sweep = True

            # Scan our files
            for file in files:
                try:
                    mtime = datetime.fromtimestamp(os.path.getmtime(file))

                except FileNotFoundError:
                    # no worries; we were removing it anyway
                    continue

                except OSError as e:
                    # Permission error of some kind or disk problem...
                    # There is nothing we can do at this point
                    logger.error(
                        "Disk Prune (ns=%s, clean=%s) detetcted inaccessible "
                        "file: %s",
                        namespace,
                        "yes" if action else "no",
                        file,
                    )
                    logger.debug("Persistent Storage Exception: %s", str(e))

                    # No longer worth doing a directory sweep
                    dir_sweep = False
                    continue

                if expires < mtime:
                    continue

                #
                # Handle Removing
                #
                record = {
                    "path": file,
                    "removed": False,
                }

                if action:
                    try:
                        os.unlink(file)
                        # Update our record
                        record["removed"] = True
                        logger.info(
                            "Disk Prune (ns=%s, clean=%s) removed persistent "
                            "file: %s",
                            namespace,
                            "yes" if action else "no",
                            file,
                        )

                    except FileNotFoundError:
                        # no longer worth doing a directory sweep
                        dir_sweep = False

                        # otherwise, no worries; we were removing the file
                        # anyway

                    except OSError as e:
                        # Permission error of some kind or disk problem...
                        # There is nothing we can do at this point
                        logger.error(
                            "Disk Prune (ns=%s, clean=%s) failed to remove "
                            "persistent file: %s",
                            namespace,
                            "yes" if action else "no",
                            file,
                        )

                        logger.debug(
                            "Persistent Storage Exception: %s", str(e)
                        )

                        # No longer worth doing a directory sweep
                        dir_sweep = False

                # Store our record
                map_[namespace].append(record)

            # Memory tidy
            del files

            if dir_sweep:
                # Gracefully cleanup our namespace directory. It's okay if we
                # fail; This just means there were files in the directory.
                for dirpath in (temp_dir, data_dir, base_dir):
                    if action:
                        try:
                            os.rmdir(dirpath)
                            logger.info(
                                "Disk Prune (ns=%s, clean=%s) removed "
                                "persistent dir: %s",
                                namespace,
                                "yes" if action else "no",
                                dirpath,
                            )
                        except OSError:
                            # do nothing;
                            pass
        return map_

    def size(
        self,
        exclude: bool = True,
        lazy: bool = True,
    ) -> int:
        """Returns the total size of the persistent storage in bytes."""

        if lazy and self.__cache_size is not None:
            # Take an early exit
            return self.__cache_size

        elif self.__mode == PersistentStoreMode.MEMORY:
            # Take an early exit
            self.__cache_size = 0
            return self.__cache_size

        # Get a list of files (file paths) in the given directory
        try:
            self.__cache_size = sum(
                os.stat(path).st_size
                for path in self.files(exclude=exclude, lazy=lazy)
            )

        except OSError:
            # We can't access the directory or it does not exist
            self.__cache_size = 0

        return self.__cache_size

    def __del__(self) -> None:
        """Deconstruction of our object."""

        if self.__mode == PersistentStoreMode.AUTO:
            # Flush changes to disk
            self.flush()

    def __delitem__(self, key: str) -> None:
        """Remove a cache entry by its key."""
        if self._cache is None and not self.__load_cache():
            raise KeyError("Could not initialize cache")

        try:
            if self._cache[key].persistent:
                # Set our dirty flag in advance
                self.__dirty = True

            # Store our new cache
            del self._cache[key]

        except KeyError:
            # Nothing to do
            raise

        if self.__dirty and self.__mode == PersistentStoreMode.FLUSH:
            # Flush changes to disk
            self.flush()

        return

    def __contains__(self, key: str) -> bool:
        """Return whether storage contains a non-expired key."""
        if self._cache is None and not self.__load_cache():
            return False

        return key in self._cache and self._cache[key]

    def __setitem__(self, key: str, value: Any) -> None:
        """Sets a cache value without disrupting existing settings in place."""

        if self._cache is None and not self.__load_cache():
            raise KeyError("Could not initialize cache")

        if key not in self._cache and not self.set(key, value):
            raise KeyError("Could not set cache")

        else:
            # Update our value
            self._cache[key].set(value)

            if self._cache[key].persistent:
                # Set our dirty flag in advance
                self.__dirty = True

        if self.__dirty and self.__mode == PersistentStoreMode.FLUSH:
            # Flush changes to disk
            self.flush()

        return

    def __getitem__(self, key: str) -> Any:
        """Returns the indexed value."""

        if self._cache is None and not self.__load_cache():
            raise KeyError("Could not initialize cache")

        result = self.get(key, default=self.__not_found_ref, lazy=False)
        if result is self.__not_found_ref:
            raise KeyError(f" {key} not found in cache")

        return result

    def keys(self) -> builtins.set[str]:
        """Returns our keys."""
        if self._cache is None and not self.__load_cache():
            # There are no keys to return
            return {}.keys()

        return self._cache.keys()

    def delete(
        self,
        *args: str,
        all: Optional[bool] = None,
        temp: Optional[bool] = None,
        cache: Optional[bool] = None,
        validate: bool = True,
    ) -> bool:
        """Delete selected files, cached data, or all stored content.

        Examples: ``delete("key", "key2")`` or ``delete(all=True)``.
        """

        # Our failure flag
        has_error = False

        valid_key_re = re.compile(
            r"^(?P.+)("
            + re.escape(self.__backup_extension)
            + r"|"
            + re.escape(self.__extension)
            + r")$",
            re.I,
        )

        # Default asignments
        if all is None:
            all = bool(not (len(args) or temp or cache))
        if temp is None:
            temp = bool(all)
        if cache is None:
            cache = bool(all)

        if cache and self._cache:
            # Reset our object
            self._cache.clear()
            # Reset dirt flag
            self.__dirty = False

        for path in self.files(exclude=False):
            # Some information we use to validate the actions of our clean()
            # call. This is so we don't remove anything we shouldn't
            base = os.path.dirname(path)
            fname = os.path.basename(path)

            # Clean printable path details
            ppath = os.path.join(os.path.dirname(base), fname)

            if base == self.__base_path and cache:
                # We're handling a cache file (hopefully)
                result = valid_key_re.match(fname)
                key = (
                    None
                    if not result
                    else (
                        result["key"]
                        if self.__valid_key.fullmatch(result["key"])
                        else None
                    )
                )

                if validate and key != self.__cache_key:
                    # We're not dealing with a cache key
                    logger.debug(
                        "Persistent File cleanup ignoring file: %s", path
                    )
                    continue

                #
                # We should proceed with removing the file if we get here
                #

            elif base == self.__data_path and (args or all):
                # We're handling a file found in our custom data path
                result = valid_key_re.match(fname)
                key = (
                    None
                    if not result
                    else (
                        result["key"]
                        if self.__valid_key.fullmatch(result["key"])
                        else None
                    )
                )

                if validate and key is None:
                    # we're set to validate and a non-valid file was found
                    logger.debug(
                        "Persistent File cleanup ignoring file: %s", path
                    )
                    continue

                elif not all and (key is None or key not in args):
                    # no match found
                    logger.debug(
                        "Persistent File cleanup ignoring file: %s", path
                    )
                    continue

                #
                # We should proceed with removing the file if we get here
                #

            elif base == self.__temp_path and temp:
                #
                # This directory is a temporary path and nothing in here needs
                # to be further verified. Proceed with the removing of the file
                #
                pass

            else:
                # No match; move on
                logger.debug("Persistent File cleanup ignoring file: %s", path)
                continue

            try:
                os.unlink(path)
                logger.info("Removed persistent file: %s", ppath)

            except FileNotFoundError:
                # no worries; we were removing it anyway
                pass

            except OSError as e:
                # Permission error of some kind or disk problem...
                # There is nothing we can do at this point
                has_error = True
                logger.error("Failed to remove persistent file: %s", ppath)
                logger.debug("Persistent Storage Exception: %s", str(e))

        # Reset our reference variables
        self.__cache_size = None
        self.__cache_files.clear()

        return not has_error

    @property
    def cache_file(self) -> str:
        """Returns the full path to the namespace directory."""
        return os.path.join(
            self.__base_path,
            f"{self.__cache_key}{self.__extension}",
        )

    @property
    def path(self) -> Optional[str]:
        """Returns the full path to the namespace directory."""
        return self.__base_path

    @property
    def mode(self) -> PersistentStoreMode:
        """Returns the Persistent Storage mode."""
        return self.__mode
caronc-apprise-dfec414/apprise/plugins/000077500000000000000000000000001526720371000202435ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/plugins/__init__.py000066400000000000000000000466201526720371000223640ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import copy
import os

from ..common import (
    NOTIFY_IMAGE_SIZES,
    NOTIFY_TYPES,
    NotifyImageSize,
    NotifyType,
)
from ..locale import LazyTranslation, gettext_lazy as _
from ..logger import logger
from ..manager_plugins import NotificationManager
from ..utils.cwe312 import cwe312_loggable
from ..utils.parse import GET_SCHEMA_RE, parse_list

# Used for testing
from .base import NotifyBase

# Grant access to our Notification Manager Singleton
N_MGR = NotificationManager()

__all__ = [
    "NOTIFY_IMAGE_SIZES",
    "NOTIFY_TYPES",
    "NotifyBase",
    # Reference
    "NotifyImageSize",
    "NotifyType",
    # Tokenizer
    "url_to_dict",
]


def _sanitize_token(tokens, default_delimiter):
    """This is called by the details() function and santizes the output by
    populating expected and consistent arguments if they weren't otherwise
    specified."""

    # Used for tracking groups
    group_map = {}

    # Iterate over our tokens
    for key in tokens:
        for element in tokens[key]:
            # Perform translations (if detected to do so)
            if isinstance(tokens[key][element], LazyTranslation):
                tokens[key][element] = str(tokens[key][element])

        if "alias_of" in tokens[key]:
            # Do not touch this field
            continue

        elif "name" not in tokens[key]:
            # Default to key
            tokens[key]["name"] = key

        if "map_to" not in tokens[key]:
            # Default type to key
            tokens[key]["map_to"] = key

        # Track our map_to objects
        if tokens[key]["map_to"] not in group_map:
            group_map[tokens[key]["map_to"]] = set()
        group_map[tokens[key]["map_to"]].add(key)

        if "type" not in tokens[key]:
            # Default type to string
            tokens[key]["type"] = "string"

        elif tokens[key]["type"].startswith("list"):
            if "delim" not in tokens[key]:
                # Default list delimiter (if not otherwise specified)
                tokens[key]["delim"] = default_delimiter

            if key in group_map[tokens[key]["map_to"]]:  # pragma: no branch
                # Remove ourselves from the list
                group_map[tokens[key]["map_to"]].remove(key)

            # Pointing to the set directly so we can dynamically update
            # ourselves
            tokens[key]["group"] = group_map[tokens[key]["map_to"]]

        elif (
            tokens[key]["type"].startswith("choice")
            and "default" not in tokens[key]
            and "values" in tokens[key]
            and len(tokens[key]["values"]) == 1
        ):
            # If there is only one choice; then make it the default
            #  - support dictionaries too
            tokens[key]["default"] = (
                tokens[key]["values"][0]
                if not isinstance(tokens[key]["values"], dict)
                else next(iter(tokens[key]["values"]))
            )

        if "values" in tokens[key] and isinstance(tokens[key]["values"], dict):
            # Convert values into a list if it was defined as a dictionary
            tokens[key]["values"] = list(tokens[key]["values"].keys())

        if "regex" in tokens[key]:
            # Verify that we are a tuple; convert strings to tuples
            if isinstance(tokens[key]["regex"], str):
                # Default tuple setup
                tokens[key]["regex"] = (tokens[key]["regex"], None)

            elif not isinstance(tokens[key]["regex"], (list, tuple)):
                # Invalid regex
                del tokens[key]["regex"]

        if "required" not in tokens[key]:
            # Default required is False
            tokens[key]["required"] = False

        if "private" not in tokens[key]:
            # Private flag defaults to False if not set
            tokens[key]["private"] = False
    return


def details(plugin):
    """Provides templates that can be used by developers to build URLs
    dynamically.

    If a list of templates is provided, then they will be used over the default
    value.

    If a list of tokens are provided, then they will over-ride any additional
    settings built from this script and/or will be appended to them afterwards.
    """

    # Our unique list of parsing will be based on the provided templates
    # if none are provided we will use our own
    templates = tuple(plugin.templates)

    # The syntax is simple
    #   {
    #       # The token_name must tie back to an entry found in the
    #       # templates list.
    #       'token_name': {
    #
    #            # Types include 'string', 'int', 'choice', 'list', 'float',
    #            # and 'email'.
    #
    #            # 'choice' and 'list' may identify their value type after a
    #            # colon; the default is 'string'.
    #
    #            # 'email' is one address (local-part@domain). URL builders
    #            # keep its '@' unescaped, matching plugin URLs.
    #            'type': 'choice:string',
    #
    #            # values will only exist the type must be a fixed
    #            # list of inputs (generated from type choice for example)
    #
    #            # If this is a choice:bool then you should ALWAYS define
    #            # this list as a (True, False) such as ('Yes, 'No') or
    #            # ('Enabled', 'Disabled'), etc
    #            'values': [ 'http', 'https' ],
    #
    #            # Identifies if the entry specified is required or not
    #            'required': True,
    #
    #            # Identifies all tokens detected to be associated with the
    #            # list:string
    #            # This is ony present in list:string objects and is only set
    #            # if this element acts as an alias for several other
    #            # kwargs/fields.
    #            'group': [],
    #
    #            # Identify a default value
    #            'default': 'http',
    #
    #            # Optional Verification Entries min and max are for floats
    #            # and/or integers
    #            'min': 4,
    #            'max': 5,
    #
    #            # A list will always identify a delimiter.  If this is
    #            # part of a path, this may be a '/', or it could be a
    #            # comma and/or space. delimiters are always in a list
    #            #  eg (if space and/or comma is a delimiter the entry
    #            #      would look like: 'delim': [',' , ' ' ]
    #            'delim': None,
    #
    #            # Use regex if you want to share the regular expression
    #            # required to validate the field. The regex will never
    #            # accommodate the prefix (if one is specified).  That is
    #            # up to the user building the URLs to include the prefix
    #            # on the URL when constructing it.
    #            # The format is ('regex', 'reg options')
    #            'regex': (r'[A-Z0-9]+', 'i'),
    #
    #            # A Prefix is always a string, to differentiate between
    #            # multiple arguments, sometimes content is prefixed.
    #            'prefix': '@',
    #
    #            # By default the key of this object is to be interpreted
    #            # as the argument to the notification in question. However
    #            # To accommodate cases where there are multiple types that
    #            # all map to the same entry, one can find a map_to value.
    #            'map_to': 'function_arg',
    #
    #            # Some arguments act as an alias_of an already defined object
    #            # This plays a role more with configuration file generation
    #            # since yaml files allow you to define different argumuments
    #            # in line to simplify things.  If this directive is set, then
    #            # it should be treated exactly the same as the object it is
    #            # an alias of
    #            'alias_of': 'function_arg',
    #
    #            # Advise developers to consider the potential sensitivity
    #            # of this field owned by the user. This is for passwords,
    #            # and api keys, etc...
    #            'private': False,
    #       },
    #   }

    # Template tokens identify the arguments required to initialize the
    # plugin itself.  It identifies all of the tokens and provides some
    # details on their use.  Each token defined should in some way map
    # back to at least one URL {token} defined in the templates

    # Since we nest a dictionary within a dictionary, a simple copy isn't
    # enough. a deepcopy allows us to manipulate this object in this
    # funtion without obstructing the original.
    template_tokens = copy.deepcopy(plugin.template_tokens)

    # Arguments and/or Options either have a default value and/or are
    # optional to be set.
    #
    # Since we nest a dictionary within a dictionary, a simple copy isn't
    # enough. a deepcopy allows us to manipulate this object in this
    # funtion without obstructing the original.
    template_args = copy.deepcopy(plugin.template_args)

    # Our template keyword arguments ?+key=value&-key=value
    # Basically the user provides both the key and the value. this is only
    # possibly by identifying the key prefix required for them to be
    # interpreted hence the +/- keys are built into apprise by default for easy
    # reference. In these cases, entry might look like '+' being the prefix:
    #   {
    #      'arg_name': {
    #          'name': 'label',
    #          'prefix': '+',
    #       }
    #   }
    #
    # Since we nest a dictionary within a dictionary, a simple copy isn't
    # enough. a deepcopy allows us to manipulate this object in this
    # funtion without obstructing the original.
    template_kwargs = copy.deepcopy(plugin.template_kwargs)

    # We automatically create a schema entry
    template_tokens["schema"] = {
        "name": _("Schema"),
        "type": "choice:string",
        "required": True,
        "values": parse_list(plugin.secure_protocol, plugin.protocol),
    }

    # Sanitize our tokens
    _sanitize_token(template_tokens, default_delimiter=("/",))
    # Delimiter(s) are space and/or comma
    _sanitize_token(template_args, default_delimiter=(",", " "))
    _sanitize_token(template_kwargs, default_delimiter=(",", " "))

    # Argument/Option Handling
    for key in list(template_args.keys()):
        if "alias_of" in template_args[key]:
            # Check if the mapped reference is a list; if it is, then
            # we need to store a different delimiter
            alias_of = template_tokens.get(template_args[key]["alias_of"], {})
            if (
                alias_of.get("type", "").startswith("list")
                and "delim" not in template_args[key]
            ):
                # Set a default delimiter of a comma and/or space if one
                # hasn't already been specified
                template_args[key]["delim"] = (",", " ")

        # _lookup_default looks up what the default value
        if "_lookup_default" in template_args[key]:
            template_args[key]["default"] = getattr(
                plugin, template_args[key]["_lookup_default"]
            )

            # Tidy as we don't want to pass this along in response
            del template_args[key]["_lookup_default"]

        # _exists_if causes the argument to only exist IF after checking
        # the return of an internal variable requiring a check
        if "_exists_if" in template_args[key]:
            if not getattr(plugin, template_args[key]["_exists_if"]):
                # Remove entire object
                del template_args[key]

            else:
                # We only nee to remove this key
                del template_args[key]["_exists_if"]

    # notify_format may be one NotifyFormat or a tuple of supported
    # formats. `values` stays the broad three-item set because ?format=
    # remains a standard Apprise URL parameter on every plugin. The
    # additive `supported` field tells newer consumers which destination
    # formats this plugin actually renders natively, with index 0 as the
    # default. Keeping older `values`/`default` consumers working avoids
    # making the service metadata update a breaking change.
    # sort=False preserves declaration order because parse_list() sorts
    # alphabetically by default, which would change the fallback format.
    if "format" in template_args:
        formats = parse_list(plugin.notify_format, sort=False)
        template_args["format"]["supported"] = formats
        if len(formats) > 1:
            # A single-format plugin's default was already correctly
            # resolved above via _lookup_default; only a multi-format
            # plugin needs correcting here (that mechanism would
            # otherwise leave the raw tuple in place).
            template_args["format"]["default"] = formats[0]

    return {
        "templates": templates,
        "tokens": template_tokens,
        "args": template_args,
        "kwargs": template_kwargs,
    }


def requirements(plugin):
    """Provides a list of packages and its requirement details."""
    requirements = {
        # Use the description to provide a human interpretable description of
        # what is required to make the plugin work. This is only nessisary
        # if there are package dependencies
        "details": "",
        # Define any required packages needed for the plugin to run.  This is
        # an array of strings that simply look like lines in the
        # `requirements.txt` file...
        #
        # A single string is perfectly acceptable:
        # 'packages_required' = 'cryptography'
        #
        # Multiple entries should look like the following
        # 'packages_required' = [
        #   'cryptography < 3.4`,
        # ]
        #
        "packages_required": [],
        # Recommended packages identify packages that are not required to make
        # your plugin work, but would improve it's use or grant it access to
        # full functionality (that might otherwise be limited).
        # Similar to `packages_required`, you would identify each entry in
        # the array as you would in a `requirements.txt` file.
        #
        #   - Do not re-provide entries already in the `packages_required`
        "packages_recommended": [],
    }

    # Populate our template differently if we don't find anything above
    if not (
        hasattr(plugin, "requirements")
        and isinstance(plugin.requirements, dict)
    ):
        # We're done early
        return requirements

    # Get our required packages
    req_packages = plugin.requirements.get("packages_required")
    if isinstance(req_packages, str):
        # Convert to list
        req_packages = [req_packages]

    elif not isinstance(req_packages, (set, list, tuple)):
        # Allow one to set the required packages to None (as an example)
        req_packages = []

    requirements["packages_required"] = [str(p) for p in req_packages]

    # Get our recommended packages
    opt_packages = plugin.requirements.get("packages_recommended")
    if isinstance(opt_packages, str):
        # Convert to list
        opt_packages = [opt_packages]

    elif not isinstance(opt_packages, (set, list, tuple)):
        # Allow one to set the recommended packages to None (as an example)
        opt_packages = []

    requirements["packages_recommended"] = [str(p) for p in opt_packages]

    # Get our package details
    req_details = plugin.requirements.get("details")
    if not req_details:
        if not (req_packages or opt_packages):
            req_details = _("No dependencies.")

        elif req_packages:
            req_details = _("Packages are required to function.")

        else:  # opt_packages
            req_details = _(
                "Packages are recommended to improve functionality."
            )
    else:
        # Store our details if defined
        requirements["details"] = req_details

    # Return our compiled package requirements
    return requirements


def url_to_dict(url, secure_logging=True):
    """Takes an apprise URL and returns the tokens associated with it if they
    can be acquired based on the plugins available.

    None is returned if the URL could not be parsed, otherwise the tokens are
    returned.

    These tokens can be loaded into apprise through it's add() function.
    """

    # swap hash (#) tag values with their html version
    url_ = url.replace("/#", "/%23")

    # CWE-312 (Secure Logging) Handling
    loggable_url = cwe312_loggable(url, secure_logging)

    # Attempt to acquire the schema at the very least to allow our plugins to
    # determine if they can make a better interpretation of a URL geared for
    # them.
    schema = GET_SCHEMA_RE.match(url_)
    if schema is None:
        # Not a valid URL; take an early exit
        logger.error(f"Unsupported URL: {loggable_url}")
        return None

    # Ensure our schema is always in lower case
    schema = schema.group("schema").lower()
    if schema not in N_MGR:
        # Give the user the benefit of the doubt that the user may be using
        # one of the URLs provided to them by their notification service.
        # Before we fail for good, just scan all the plugins that support the
        # native_url() parse function
        results = None
        for plugin in N_MGR.plugins():
            results = plugin.parse_native_url(url_)
            if results:
                break

        if not results:
            logger.error(f"Unparseable URL {loggable_url}")
            return None

        logger.trace(
            "URL {} unpacked as:{}{}".format(
                url,
                os.linesep,
                os.linesep.join([f'{k}="{v}"' for k, v in results.items()]),
            )
        )

    else:
        # Parse the service URL into constructor arguments.
        results = N_MGR[schema].parse_url(url_)
        if not results:
            logger.error(
                f"Unparseable {N_MGR[schema].service_name} URL {loggable_url}"
            )
            return None

        logger.trace(
            "{} URL {} unpacked as:{}{}".format(
                N_MGR[schema].service_name,
                url,
                os.linesep,
                os.linesep.join([f'{k}="{v}"' for k, v in results.items()]),
            )
        )

    # Return our results
    return results
caronc-apprise-dfec414/apprise/plugins/africas_talking.py000066400000000000000000000507461526720371000237520ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# To use this plugin, you must have a Africas Talking Account setup; See here:
#  https://account.africastalking.com/
#  From here... acquire your APIKey
#
# API Details: https://developers.africastalking.com/docs/sms/sending/bulk
from __future__ import annotations

from json import loads
from typing import Any

import requests

from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..utils.parse import (
    is_phone_no,
    parse_bool,
    parse_phone_no,
    validate_regex,
)
from .base import NotifyBase


class AfricasTalkingSMSMode:
    """Africas Talking SMS Mode."""

    # BulkSMS Mode
    BULKSMS = "bulksms"

    # Premium Mode
    PREMIUM = "premium"

    # Sandbox Mode
    SANDBOX = "sandbox"


# Define the types in a list for validation purposes
AFRICAS_TALKING_SMS_MODES = (
    AfricasTalkingSMSMode.BULKSMS,
    AfricasTalkingSMSMode.PREMIUM,
    AfricasTalkingSMSMode.SANDBOX,
)


# Recipient ``statusCode`` values returned inside ``SMSMessageData``.
# These are not HTTP status codes.
AFRICAS_TALKING_HTTP_ERROR_MAP = {
    100: "Processed",
    101: "Sent",
    102: "Queued",
    401: "Risk Hold",
    402: "Invalid Sender ID",
    403: "Invalid Phone Number",
    404: "Unsupported Number Type",
    405: "Insufficient Balance",
    406: "User In Blacklist",
    407: "Could Not Route",
    409: "Do Not Disturb Rejection",
    500: "Internal Server Error",
    501: "Gateway Error",
    502: "Rejected By Gateway",
}

# Recipient statusCode values meaning the message was accepted
AFRICAS_TALKING_RECIPIENT_OK = (100, 101, 102)


class NotifyAfricasTalking(NotifyBase):
    """A wrapper for Africas Talking Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "Africas Talking"

    # The services URL
    service_url = "https://africastalking.com/"

    # The default secure protocol
    secure_protocol = "atalk"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/africas_talking/"

    # Africas Talking API Request URLs
    notify_url = {
        AfricasTalkingSMSMode.BULKSMS: (
            "https://api.africastalking.com/version1/messaging"
        ),
        AfricasTalkingSMSMode.PREMIUM: (
            "https://content.africastalking.com/version1/messaging"
        ),
        AfricasTalkingSMSMode.SANDBOX: (
            "https://api.sandbox.africastalking.com/version1/messaging"
        ),
    }

    # The maximum allowable characters allowed in the title per message
    title_maxlen = 0

    # The maximum allowable characters allowed in the body per message
    body_maxlen = 160

    # The maximum amount of phone numbers that can reside within a single
    # batch transfer
    default_batch_size = 50

    # Define object templates
    templates = ("{schema}://{appuser}@{apikey}/{targets}",)

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "appuser": {
                "name": _("App User Name"),
                "type": "string",
                "regex": (r"^[A-Z0-9_-]+$", "i"),
                "required": True,
            },
            "apikey": {
                "name": _("API Key"),
                "type": "string",
                "required": True,
                "private": True,
                "regex": (r"^[A-Z0-9_-]+$", "i"),
            },
            "target_phone": {
                "name": _("Target Phone"),
                "type": "string",
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
                "required": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "apikey": {
                "alias_of": "apikey",
            },
            "from": {
                # Your registered short code or alphanumeric
                "name": _("From"),
                "type": "string",
                "default": "AFRICASTKNG",
                "map_to": "sender",
            },
            "mode": {
                "name": _("SMS Mode"),
                "type": "choice:string",
                "values": AFRICAS_TALKING_SMS_MODES,
                "default": AFRICAS_TALKING_SMS_MODES[0],
            },
            "to": {
                "alias_of": "targets",
            },
            "batch": {
                "name": _("Batch Mode"),
                "type": "bool",
                "default": False,
            },
        },
    )

    def __init__(
        self,
        appuser,
        apikey,
        targets=None,
        sender=None,
        batch=None,
        mode=None,
        **kwargs,
    ):
        """Initialize Africas Talking Object."""
        super().__init__(**kwargs)

        self.appuser = validate_regex(
            appuser, *self.template_tokens["appuser"]["regex"]
        )
        if not self.appuser:
            msg = (
                f"The Africas Talking appuser specified ({appuser}) is"
                " invalid."
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        self.apikey = validate_regex(
            apikey, *self.template_tokens["apikey"]["regex"]
        )
        if not self.apikey:
            msg = (
                f"The Africas Talking apikey specified ({apikey}) is invalid."
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Prepare Sender
        self.sender = (
            self.template_args["from"]["default"] if sender is None else sender
        )

        # Prepare Batch Mode Flag
        self.batch = (
            self.template_args["batch"]["default"] if batch is None else batch
        )

        self.mode = (
            self.template_args["mode"]["default"]
            if not isinstance(mode, str)
            else mode.lower()
        )

        if isinstance(mode, str) and mode:
            self.mode = next(
                (
                    a
                    for a in AFRICAS_TALKING_SMS_MODES
                    if a.startswith(mode.lower())
                ),
                None,
            )

            if self.mode not in AFRICAS_TALKING_SMS_MODES:
                msg = (
                    f"The Africas Talking mode specified ({mode}) is invalid."
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)
        else:
            self.mode = self.template_args["mode"]["default"]

        # Parse our targets
        self.targets = []

        for target in parse_phone_no(targets):
            # Validate targets and drop bad ones:
            result = is_phone_no(target)
            if not result:
                self.logger.warning(
                    f"Dropped invalid phone # ({target}) specified.",
                )
                continue

            # store valid phone number
            # Carry forward '+' if defined, otherwise do not...
            self.targets.append(
                ("+" + result["full"])
                if target.lstrip()[0] == "+"
                else result["full"]
            )

    def send(
        self,
        body: str,
        title: str = "",
        notify_type: NotifyType = NotifyType.INFO,
        **kwargs: Any,
    ) -> bool:
        """Perform Africas Talking Notification."""

        if not self.targets:
            # There is no one to email; we're done
            self.logger.warning(
                "There are no Africas Talking recipients to notify"
            )
            return False

        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/x-www-form-urlencoded",
            "Accept": "application/json",
            "apiKey": self.apikey,
        }

        # error tracking (used for function return)
        has_error = False

        # Send in batches if identified to do so
        batch_size = 1 if not self.batch else self.default_batch_size

        # Retry only recipients that have not accepted the message.
        pending = [t for t in self.targets if not self.is_delivered(t)]

        for index in range(0, len(pending), batch_size):
            # Our batch of phone numbers
            _batch = pending[index : index + batch_size]

            # Prepare our payload
            payload = {
                "username": self.appuser,
                "to": ",".join(_batch),
                "from": self.sender,
                "message": body,
            }

            # Acquire our URL
            notify_url = self.notify_url[self.mode]

            self.logger.debug(
                "Africas Talking POST URL:"
                f" {notify_url} (cert_verify={self.verify_certificate!r})"
            )
            self.logger.debug(f"Africas Talking Payload: {payload!s}")

            # Printable target detail
            p_target = (
                _batch[0] if batch_size == 1 else f"{len(_batch)} target(s)"
            )

            # Always call throttle before any remote server i/o is made
            self.throttle()
            try:
                r = requests.post(
                    notify_url,
                    data=payload,
                    headers=headers,
                    verify=self.verify_certificate,
                    timeout=self.request_timeout,
                    allow_redirects=self.redirects,
                )
                # Sample response
                # {
                #     "SMSMessageData": {
                #         "Message": "Sent to 1/1 Total Cost: KES 0.8000",
                #         "Recipients": [{
                #             "statusCode": 101,
                #             "number": "+254711XXXYYY",
                #             "status": "Success",
                #             "cost": "KES 0.8000",
                #             "messageId": "ATPid_SampleTxnId123"
                #         }]
                #     }
                # }

                # The service answers with 201 Created; accept any 2xx
                if not (200 <= r.status_code < 300):
                    # We had a problem
                    status_str = (
                        NotifyAfricasTalking.http_response_code_lookup(
                            r.status_code
                        )
                    )

                    self.logger.warning(
                        "Failed to send Africas Talking notification to {}: "
                        "{}{}error={}.".format(
                            p_target,
                            status_str,
                            ", " if status_str else "",
                            r.status_code,
                        )
                    )

                    self.logger.debug(
                        "Response Details:\r\n%r", (r.content or b"")[:2000]
                    )

                    # Mark our failure
                    has_error = True
                    continue

            except requests.RequestException as e:
                self.logger.warning(
                    "A Connection error occurred sending Africas Talking "
                    f"notification to {p_target}."
                )
                self.logger.debug(f"Socket Exception: {e!s}")

                # Mark our failure
                has_error = True
                continue

            # Work out which numbers in this batch accepted the message
            delivered = self._accepted(r, _batch)

            for target in _batch:
                if target not in delivered:
                    # Mark our failure; a retry sends to it again
                    has_error = True
                    continue

                # Delivered; a retry can safely skip this recipient.
                self.mark_delivered(target)

            if delivered:
                self.logger.info(
                    "Sent Africas Talking notification to {}/{}"
                    " recipient(s).".format(len(delivered), len(_batch))
                )

        return not has_error

    def _accepted(self, r: Any, batch: list[str]) -> list[str]:
        """Return the numbers in batch the service accepted.

        - An unreadable body trusts the 2xx reply for the whole batch.
        - Otherwise a number counts only when its Recipients entry has a
          success statusCode (Processed, Sent or Queued).
        """

        try:
            content = loads(r.content)

        except (TypeError, ValueError):
            # ValueError  -- r.content is not valid JSON
            # TypeError   -- r.content is None (e.g. empty body)
            content = {}

        # Dig out our list of recipients
        data = (
            content.get("SMSMessageData")
            if isinstance(content, dict)
            else None
        )
        recipients = data.get("Recipients") if isinstance(data, dict) else None

        if not isinstance(recipients, list):
            # Nothing to inspect; the 2xx reply is all we have to go on
            return list(batch)

        # Collect the digits of every number in the reply, and of the ones
        # that were accepted
        numbers = set()
        accepted = []
        for entry in recipients:
            if not isinstance(entry, dict):
                continue

            number = "".join(
                c for c in str(entry.get("number", "")) if c.isdigit()
            ).lstrip("0")
            numbers.add(number)

            try:
                code = int(entry.get("statusCode"))

            except (TypeError, ValueError):
                code = None

            if code in AFRICAS_TALKING_RECIPIENT_OK:
                accepted.append(number)
                continue

            # Use the recipient map without changing shared HTTP messages.
            status_str = AFRICAS_TALKING_HTTP_ERROR_MAP.get(code, "")
            self.logger.warning(
                "Africas Talking rejected {}: {}{}statusCode={}.".format(
                    entry.get("number"),
                    status_str,
                    ", " if status_str else "",
                    entry.get("statusCode"),
                )
            )

        # Targets are stored as digits with an optional leading "+"
        digits = {target: target.lstrip("+0") for target in batch}

        # Targets whose own number appears in the reply, accepted or not
        exact = {t for t, d in digits.items() if d in numbers}

        result = set()
        for number in accepted:
            # An exact match always identifies the right target
            matched = [t for t, d in digits.items() if d == number]
            if not matched:
                # Replies may change local numbers to international form.
                # Match ending digits only when they identify one target.
                matched = [
                    t
                    for t, d in digits.items()
                    if t not in exact
                    and (number.endswith(d) or d.endswith(number))
                ]
                if len(matched) != 1:
                    continue

            result.update(matched)

        # Keep the batch order
        return [target for target in batch if target in result]

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (self.secure_protocol, self.appuser, self.apikey)

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "batch": "yes" if self.batch else "no",
        }

        if self.sender != self.template_args["from"]["default"]:
            # Set our sender if it was set
            params["from"] = self.sender

        if self.mode != self.template_args["mode"]["default"]:
            # Set our mode
            params["mode"] = self.mode

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        return "{schema}://{appuser}@{apikey}/{targets}?{params}".format(
            schema=self.secure_protocol,
            appuser=NotifyAfricasTalking.quote(self.appuser, safe=""),
            apikey=self.pprint(self.apikey, privacy, safe=""),
            targets="/".join(
                [NotifyAfricasTalking.quote(x, safe="+") for x in self.targets]
            ),
            params=NotifyAfricasTalking.urlencode(params),
        )

    def __len__(self):
        """Returns the number of targets associated with this notification."""
        #
        # Factor batch into calculation
        #
        batch_size = 1 if not self.batch else self.default_batch_size
        targets = len(self.targets)
        if batch_size > 1:
            targets = int(targets / batch_size) + (
                1 if targets % batch_size else 0
            )

        return targets if targets > 0 else 1

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # The Application User ID
        results["appuser"] = NotifyAfricasTalking.unquote(results["user"])

        # Prepare our targets
        results["targets"] = []

        # Our Application APIKey
        if "apikey" in results["qsd"] and len(results["qsd"]["apikey"]):
            # Store our apikey if specified as keyword
            results["apikey"] = NotifyAfricasTalking.unquote(
                results["qsd"]["apikey"]
            )

            # This means our host is actually a phone number (target)
            results["targets"].append(
                NotifyAfricasTalking.unquote(results["host"])
            )

        else:
            # First item is our apikey
            results["apikey"] = NotifyAfricasTalking.unquote(results["host"])

        # Store our remaining targets found on path
        results["targets"].extend(
            NotifyAfricasTalking.split_path(results["fullpath"])
        )

        # The 'from' makes it easier to use yaml configuration
        if "from" in results["qsd"] and len(results["qsd"]["from"]):
            results["sender"] = NotifyAfricasTalking.unquote(
                results["qsd"]["from"]
            )

        # Support the 'to' variable so that we can support targets this way too
        # The 'to' makes it easier to use yaml configuration
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyAfricasTalking.parse_phone_no(
                results["qsd"]["to"]
            )

        # Get our Mode
        if "mode" in results["qsd"] and len(results["qsd"]["mode"]):
            results["mode"] = NotifyAfricasTalking.unquote(
                results["qsd"]["mode"]
            )

        # Get Batch Mode Flag
        results["batch"] = parse_bool(
            results["qsd"].get(
                "batch", NotifyAfricasTalking.template_args["batch"]["default"]
            )
        )

        return results
caronc-apprise-dfec414/apprise/plugins/amqp/000077500000000000000000000000001526720371000212015ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/plugins/amqp/__init__.py000066400000000000000000000027311526720371000233150ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.


"""AMQP Notifications."""

from .base import NotifyAMQP

__all__ = [
    "NotifyAMQP",
]
caronc-apprise-dfec414/apprise/plugins/amqp/base.py000066400000000000000000000566501526720371000225010ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.


# Publish notifications to brokers such as RabbitMQ, ActiveMQ Artemis,
# Apache Qpid, or Azure Service Bus.
#
# Install the library for the AMQP version your broker supports:
#  - AMQP 0-9-1 (most brokers, RabbitMQ's default): pip install pika
#  - AMQP 1.0 (the OASIS standard): pip install python-qpid-proton
#
# Select one with ?version=. By default, Apprise prefers 0.9.1 when pika is
# installed and otherwise uses 1.0.
#
# Your Apprise URL is assembled as:
#    amqp://user:password@hostname/target
#    amqps://user:password@hostname:port/target1/target2
#
#  - AMQP 0-9-1 targets are routing keys. With the default exchange, use a
#    queue name; use ?exchange= for another exchange.
#  - AMQP 1.0 targets are queue or topic addresses. Put RabbitMQ addresses
#    such as /queues/name in ?to= to preserve their slashes.
#
# Resources:
# - https://www.rabbitmq.com/tutorials/amqp-concepts
# - https://www.rabbitmq.com/docs/amqp
# - https://docs.oasis-open.org/amqp/core/v1.0/amqp-core-overview-v1.0.html

"""AMQP Notifications"""

from __future__ import annotations

import re
from time import time
from typing import Any, Optional

from ...common import NotifyFormat, NotifyType
from ...exception import AppriseImproperlyConfigured
from ...locale import gettext_lazy as _
from ...url import PrivacyMode
from ...utils.parse import parse_bool, parse_list
from ..base import NotifyBase
from .common import (
    AMQP_CONTENT_TYPES,
    AMQP_SHORTSTR_MAX,
    AMQP_VERSION_MAP,
    AMQP_VERSION_OPTIONS,
    AMQP_VERSIONS,
    AMQPConfig,
    AMQPError,
    AMQPMessage,
    AMQPVersion,
)
from .v091 import AMQP091Adapter
from .v10 import AMQP10Adapter

# The adapter that speaks each version
AMQP_ADAPTERS = {
    AMQPVersion.V091: AMQP091Adapter,
    AMQPVersion.V10: AMQP10Adapter,
}

# A version is digits split by dots or dashes, with an optional leading v
AMQP_VERSION_FORMAT = re.compile(r"v?\d+(?:[.-]\d+)*", re.IGNORECASE)

# Strips everything but the digits from a version, so 0.9.1 becomes 091
AMQP_VERSION_DIGITS = re.compile(r"[^0-9]+")


class NotifyAMQP(NotifyBase):
    """A wrapper for AMQP Notifications."""

    # Each optional package enables one AMQP version. The plugin still loads
    # when neither is installed so it can report the missing dependency.
    requirements = {
        # Either package enables a supported version
        "details": _(
            "Install pika for AMQP 0.9.1, python-qpid-proton for AMQP 1.0,"
            " or both."
        ),
        "packages_recommended": [
            AMQP091Adapter.package,
            AMQP10Adapter.package,
        ],
    }

    # The default descriptive name associated with the Notification
    service_name = "AMQP"

    # The services URL
    service_url = "https://www.amqp.org/"

    # The default protocol
    protocol = "amqp"

    # The default secure protocol
    secure_protocol = "amqps"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/amqp/"

    # The default ports for both AMQP versions
    default_insecure_port = 5672
    default_secure_port = 5671

    # AMQP has no title field, so the title is placed in the body
    title_maxlen = 0

    # Character limit used when split or truncate overflow is requested
    body_maxlen = 16777216

    # Publish to each target without an added delay
    request_rate_per_sec = 0

    # Preserve the selected body format and label its content type
    notify_format = (
        NotifyFormat.TEXT,
        NotifyFormat.MARKDOWN,
        NotifyFormat.HTML,
    )

    # Define object templates
    templates = (
        "{schema}://{host}",
        "{schema}://{host}:{port}",
        "{schema}://{user}:{password}@{host}",
        "{schema}://{user}:{password}@{host}:{port}",
        "{schema}://{host}/{targets}",
        "{schema}://{host}:{port}/{targets}",
        "{schema}://{user}:{password}@{host}/{targets}",
        "{schema}://{user}:{password}@{host}:{port}/{targets}",
    )

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "host": {
                "name": _("Hostname"),
                "type": "string",
                "required": True,
            },
            "port": {
                "name": _("Port"),
                "type": "int",
                "min": 1,
                "max": 65535,
            },
            "user": {
                "name": _("User Name"),
                "type": "string",
            },
            "password": {
                "name": _("Password"),
                "type": "string",
                "private": True,
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "version": {
                "name": _("Version"),
                "type": "choice:string",
                "values": AMQP_VERSIONS,
                # 1.0 is used instead when only its library is installed
                "default": AMQPVersion.V091,
            },
            "ver": {
                "alias_of": "version",
            },
            "exchange": {
                "name": _("Exchange"),
                "type": "string",
            },
            "vhost": {
                "name": _("Virtual Host"),
                "type": "string",
            },
            "persistent": {
                "name": _("Persistent"),
                "type": "bool",
                "default": True,
            },
            "mandatory": {
                "name": _("Mandatory"),
                "type": "bool",
                "default": True,
            },
            "priority": {
                "name": _("Priority"),
                "type": "int",
                "min": 0,
                "max": 255,
            },
            "ttl": {
                "name": _("Time To Live"),
                "type": "int",
                "min": 0,
                # AMQP 1.0 stores it as an unsigned 32-bit value
                "max": 4294967295,
            },
            "to": {
                "alias_of": "targets",
            },
        },
    )

    # Define any kwargs we're using
    template_kwargs = {
        "headers": {
            "name": _("Message Headers"),
            "prefix": "+",
        },
    }

    def __init__(
        self,
        targets: Optional[list[str]] = None,
        version: Optional[str] = None,
        exchange: Optional[str] = None,
        vhost: Optional[str] = None,
        persistent: Optional[bool] = None,
        mandatory: Optional[bool] = None,
        priority: Optional[int] = None,
        ttl: Optional[int] = None,
        headers: Optional[dict[str, str]] = None,
        **kwargs: Any,
    ) -> None:
        """Initialize AMQP Object."""
        super().__init__(**kwargs)

        # The options we were given that only one AMQP version understands
        exclusive = [
            key
            for key, value in (
                ("exchange", exchange),
                ("mandatory", mandatory),
            )
            if value is not None and value != ""
        ]

        if version is None:
            # The versions those options belong to
            implied = {AMQP_VERSION_OPTIONS[key] for key in exclusive}

            # Version-specific options select their version. Otherwise use
            # the first supported version with an installed library.
            self.version = (
                implied.pop()
                if len(implied) == 1
                else next(
                    (v for v in AMQP_VERSIONS if AMQP_ADAPTERS[v].enabled),
                    AMQPVersion.V091,
                )
            )

        else:
            # Accept 0.9, 0-9-1, v1, 1.0 and similar spellings, but nothing
            # written around them
            value = str(version).strip()
            self.version = (
                AMQP_VERSION_MAP.get(AMQP_VERSION_DIGITS.sub("", value))
                if AMQP_VERSION_FORMAT.fullmatch(value)
                else None
            )
            if self.version is None:
                msg = f"An invalid AMQP version ({version}) was specified."
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)

        # The adapter that speaks our version
        self.adapter = AMQP_ADAPTERS[self.version]
        if not self.adapter.enabled:
            msg = (
                f"AMQP {self.version} requires the {self.adapter.package}"
                " package; install it with:"
                f" pip install {self.adapter.package}"
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Options that belong to the other version are ignored
        ignored = [
            key
            for key in exclusive
            if AMQP_VERSION_OPTIONS[key] != self.version
        ]
        for key in ignored:
            self.logger.warning(
                "The AMQP %s option is only used by AMQP %s; ignoring it.",
                key,
                AMQP_VERSION_OPTIONS[key],
            )

        # Our exchange; "" is the broker's default exchange
        self.exchange = (
            exchange
            if isinstance(exchange, str) and "exchange" not in ignored
            else ""
        )

        # Our virtual host; None leaves it to the broker
        self.vhost = vhost if isinstance(vhost, str) and vhost else None

        if self.version == AMQPVersion.V091:
            # AMQP 0-9-1 cannot carry longer names than this
            for key, value in (
                ("exchange", self.exchange),
                ("vhost", self.vhost),
            ):
                if value and len(value.encode("utf-8")) > AMQP_SHORTSTR_MAX:
                    msg = (
                        f"The AMQP {key} specified is longer than"
                        f" {AMQP_SHORTSTR_MAX} bytes."
                    )
                    self.logger.warning(msg)
                    raise AppriseImproperlyConfigured(msg)

        # Whether the broker should keep our messages on disk
        self.persistent = (
            self.template_args["persistent"]["default"]
            if persistent is None
            else parse_bool(
                persistent, self.template_args["persistent"]["default"]
            )
        )

        # Whether a message nobody can receive counts as a failure
        self.mandatory = (
            self.template_args["mandatory"]["default"]
            if mandatory is None or "mandatory" in ignored
            else parse_bool(
                mandatory, self.template_args["mandatory"]["default"]
            )
        )

        # Our optional message priority and expiry
        self.priority = self._bounded_int("priority", priority)
        self.ttl = self._bounded_int("ttl", ttl)

        # Extra headers to attach to every message
        self.headers = (
            {str(k): str(v) for k, v in headers.items()}
            if isinstance(headers, dict)
            else {}
        )

        # Our targets (routing keys or addresses)
        self.targets = []
        self.invalid_targets = []
        for target in parse_list(targets):
            if (
                self.version == AMQPVersion.V091
                and len(target.encode("utf-8")) > AMQP_SHORTSTR_MAX
            ):
                self.logger.warning(
                    "Dropped AMQP routing key longer than %d bytes (%s).",
                    AMQP_SHORTSTR_MAX,
                    target,
                )
                self.invalid_targets.append(target)
                continue

            self.targets.append(target)

    def _bounded_int(self, key: str, value: Any) -> Optional[int]:
        """Return ``value`` as an int within the limits of ``key``."""
        # Nothing set means the broker's own default applies
        if value is None or value == "":
            return None

        # Our limits are defined with our template arguments
        limits = self.template_args[key]

        try:
            result = int(value)

        except (TypeError, ValueError):
            # Not a number at all
            result = None

        if result is None or not limits["min"] <= result <= limits["max"]:
            msg = f"An invalid AMQP {key} ({value}) was specified."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        return result

    def send(
        self,
        body: str,
        title: str = "",
        notify_type: NotifyType = NotifyType.INFO,
        body_format: Optional[NotifyFormat] = None,
        **kwargs: Any,
    ) -> bool:
        """Perform AMQP Notification."""

        # With an exchange (such as a fanout one) and no targets, publish
        # once with an empty routing key
        targets = self.targets or ([""] if self.exchange else [])

        if not targets:
            # There is nowhere to publish to
            self.logger.warning("There are no AMQP targets to notify.")
            return False

        # A retry skips targets that already accepted this message
        targets = [t for t in targets if not self.is_delivered(t)]
        if not targets:
            # Every target was already reached
            return True

        # Prepare how we reach the broker
        port = self.port or (
            self.default_secure_port
            if self.secure
            else self.default_insecure_port
        )

        config = AMQPConfig(
            host=self.host,
            port=port,
            secure=self.secure,
            verify_certificate=self.verify_certificate,
            user=self.user,
            password=self.password,
            vhost=self.vhost,
            connect_timeout=self.socket_connect_timeout,
            read_timeout=self.socket_read_timeout,
            exchange=self.exchange,
            mandatory=self.mandatory,
        )

        # Prepare our message once; every target receives the same one
        message = AMQPMessage(
            # Replace invalid characters instead of failing the send
            body=body.encode("utf-8", errors="replace"),
            content_type=AMQP_CONTENT_TYPES.get(
                body_format, AMQP_CONTENT_TYPES[NotifyFormat.TEXT]
            ),
            app_id=self.app_id,
            timestamp=int(time()),
            persistent=self.persistent,
            priority=self.priority,
            ttl=self.ttl,
            headers=self.headers or None,
        )

        # For logging
        url = f"{self.host}:{port}"

        self.logger.debug(
            "AMQP %s connect: %s (cert_verify=%s)",
            self.version,
            url,
            self.verify_certificate,
        )

        # Always throttle before remote server I/O
        self.throttle()

        adapter = self.adapter(config)
        try:
            # Connect and log in
            adapter.connect()

        except AMQPError as e:
            # Nothing can be published without a connection
            self.logger.warning("Could not connect to AMQP server %s.", url)
            self.logger.debug("AMQP Exception: %s", str(e))
            return False

        has_error = False
        try:
            for target in targets:
                # Name where the message is going for our logs
                where = target or f"exchange {self.exchange}"

                # Always throttle before remote server I/O
                self.throttle()

                self.logger.debug("AMQP publish to %s/%s", url, where)
                self.logger.trace("AMQP Payload: %s", body)

                try:
                    # Publish and wait for the broker to accept it
                    adapter.publish(target, message)

                except AMQPError as e:
                    # Mark our failure and move on to our next target
                    self.logger.warning(
                        "Failed to publish AMQP notification to %s.", where
                    )
                    self.logger.debug("AMQP Exception: %s", str(e))
                    has_error = True
                    continue

                # Delivered; a retry can safely skip this target
                self.mark_delivered(target)
                self.logger.info("Sent AMQP notification to %s.", where)

        finally:
            # Always let go of our connection
            adapter.close()

        return not has_error

    @property
    def url_identifier(self) -> tuple[Any, ...]:
        """Return the fields that identify this broker connection.

        Targets are intentionally excluded.
        """
        return (
            self.secure_protocol if self.secure else self.protocol,
            self.version,
            self.user,
            self.password,
            self.host,
            self.port
            or (
                self.default_secure_port
                if self.secure
                else self.default_insecure_port
            ),
            self.vhost,
        )

    def url(self, privacy: bool = False, *args: Any, **kwargs: Any) -> str:
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "version": self.version,
            "persistent": "yes" if self.persistent else "no",
        }

        if self.version == AMQPVersion.V091:
            # Only AMQP 0-9-1 uses these
            params["mandatory"] = "yes" if self.mandatory else "no"
            if self.exchange:
                params["exchange"] = self.exchange

        if self.vhost:
            params["vhost"] = self.vhost

        if self.priority is not None:
            params["priority"] = str(self.priority)

        if self.ttl is not None:
            params["ttl"] = str(self.ttl)

        # Keep targets containing slashes in to= so they remain intact
        targets = (*self.targets, *self.invalid_targets)
        in_path, in_to = [], []
        for target in targets:
            (in_to if "/" in target or "\\" in target else in_path).append(
                target
            )

        if in_to:
            params["to"] = ",".join(in_to)

        # Append our headers into our parameters
        params.update({f"+{k}": v for k, v in self.headers.items()})

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        # Determine Authentication
        auth = ""
        if self.user and self.password:
            auth = "{user}:{password}@".format(
                user=NotifyAMQP.quote(self.user, safe=""),
                password=self.pprint(
                    self.password, privacy, mode=PrivacyMode.Secret, safe=""
                ),
            )

        elif self.user:
            auth = "{user}@".format(
                user=NotifyAMQP.quote(self.user, safe=""),
            )

        default_port = (
            self.default_secure_port
            if self.secure
            else self.default_insecure_port
        )

        return "{schema}://{auth}{hostname}{port}/{targets}?{params}".format(
            schema=self.secure_protocol if self.secure else self.protocol,
            auth=auth,
            # never encode hostname since we're expecting it to be a valid one
            hostname=self.host,
            port=(
                ""
                if self.port is None or self.port == default_port
                else f":{self.port}"
            ),
            targets="/".join(NotifyAMQP.quote(x, safe="") for x in in_path),
            params=NotifyAMQP.urlencode(params),
        )

    def __len__(self) -> int:
        """Returns the number of targets associated with this notification."""
        # Always return at least 1 so the framework counts this instance
        return len(self.targets) if self.targets else 1

    @staticmethod
    def parse_url(url: str) -> Optional[dict[str, Any]]:
        """Parse an AMQP URL into constructor arguments."""

        results = NotifyBase.parse_url(url)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # Our targets are found in the path
        results["targets"] = NotifyAMQP.split_path(results["fullpath"])

        # Values in to= keep the slashes used by many AMQP 1.0 addresses
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyAMQP.parse_list(
                NotifyAMQP.unquote(results["qsd"]["to"])
            )

        # The AMQP version to use; version= wins over its ver= alias
        if "ver" in results["qsd"] and len(results["qsd"]["ver"]):
            results["version"] = NotifyAMQP.unquote(results["qsd"]["ver"])

        if "version" in results["qsd"] and len(results["qsd"]["version"]):
            results["version"] = NotifyAMQP.unquote(results["qsd"]["version"])

        # The exchange to publish to
        if "exchange" in results["qsd"] and len(results["qsd"]["exchange"]):
            results["exchange"] = NotifyAMQP.unquote(
                results["qsd"]["exchange"]
            )

        # The virtual host to use
        if "vhost" in results["qsd"] and len(results["qsd"]["vhost"]):
            results["vhost"] = NotifyAMQP.unquote(results["qsd"]["vhost"])

        # Message flags
        if "persistent" in results["qsd"] and len(
            results["qsd"]["persistent"]
        ):
            results["persistent"] = parse_bool(results["qsd"]["persistent"])

        if "mandatory" in results["qsd"] and len(results["qsd"]["mandatory"]):
            results["mandatory"] = parse_bool(results["qsd"]["mandatory"])

        # Message priority and expiry
        if "priority" in results["qsd"] and len(results["qsd"]["priority"]):
            results["priority"] = NotifyAMQP.unquote(
                results["qsd"]["priority"]
            )

        if "ttl" in results["qsd"] and len(results["qsd"]["ttl"]):
            results["ttl"] = NotifyAMQP.unquote(results["qsd"]["ttl"])

        # Add our message headers and tidy entries by unquoting them
        results["headers"] = {
            NotifyAMQP.unquote(x): NotifyAMQP.unquote(y)
            for x, y in results["qsd+"].items()
        }

        return results

    @staticmethod
    def runtime_deps() -> tuple[str, ...]:
        """Return the optional packages imported by this plugin."""
        return ("pika", "proton")
caronc-apprise-dfec414/apprise/plugins/amqp/common.py000066400000000000000000000100231526720371000230370ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.


"""Shared AMQP configuration."""

from __future__ import annotations

from typing import Optional

from ...common import NotifyFormat
from ...compat.py39 import dataclass_compat as dataclass
from ...exception import AppriseException


class AMQPVersion:
    """The AMQP protocol versions a notification can be published with."""

    # AMQP 0-9-1 is what most brokers (such as RabbitMQ) speak by default
    V091 = "0.9.1"

    # AMQP 1.0 is the OASIS standard and a very different protocol
    V10 = "1.0"


# All of our supported versions, in the order they are preferred
AMQP_VERSIONS = (
    AMQPVersion.V091,
    AMQPVersion.V10,
)

# Accept common spellings by matching only the version digits
AMQP_VERSION_MAP = {
    "0": AMQPVersion.V091,
    "09": AMQPVersion.V091,
    "091": AMQPVersion.V091,
    "1": AMQPVersion.V10,
    "10": AMQPVersion.V10,
}

# Options that select a version when ?version= is omitted
AMQP_VERSION_OPTIONS = {
    "exchange": AMQPVersion.V091,
    "mandatory": AMQPVersion.V091,
}

# Content types used to label each supported body format
AMQP_CONTENT_TYPES = {
    NotifyFormat.TEXT: "text/plain; charset=utf-8",
    NotifyFormat.MARKDOWN: "text/markdown; charset=utf-8",
    NotifyFormat.HTML: "text/html; charset=utf-8",
}

# Maximum byte length of AMQP 0-9-1 short strings
AMQP_SHORTSTR_MAX = 255


class AMQPError(AppriseException):
    """Raised by an adapter when it cannot connect or publish."""


@dataclass(frozen=True, slots=True)
class AMQPConfig:
    """How to reach and log into the AMQP broker."""

    # Where the broker lives, and whether TLS is used to reach it
    host: str
    port: int
    secure: bool = False
    verify_certificate: bool = True

    # Our login; no user means the protocol's default/anonymous login
    user: Optional[str] = None
    password: Optional[str] = None

    # The virtual host to use; None leaves it to the broker
    vhost: Optional[str] = None

    # How long to wait to connect, and then for each reply (seconds)
    connect_timeout: float = 4.0
    read_timeout: float = 4.0

    # AMQP 0-9-1 exchange and unroutable-message handling
    exchange: str = ""
    mandatory: bool = True


@dataclass(frozen=True, slots=True)
class AMQPMessage:
    """One message, built once and published to every target."""

    # The encoded body and how to read it
    body: bytes
    content_type: str

    # Who sent it and when (seconds since the epoch)
    app_id: str
    timestamp: int

    # Storage, priority, and queue expiry in milliseconds
    persistent: bool = True
    priority: Optional[int] = None
    ttl: Optional[int] = None

    # Extra application headers to attach
    headers: Optional[dict[str, str]] = None
caronc-apprise-dfec414/apprise/plugins/amqp/v091.py000066400000000000000000000164361526720371000222640ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.


"""AMQP 0-9-1 publishing with pika.

Pika documentation: https://pika.readthedocs.io/
Publishes use broker confirmation: https://www.rabbitmq.com/docs/confirms
"""

from __future__ import annotations

import math
import ssl
from typing import Any, Optional

import certifi

from .common import AMQPConfig, AMQPError, AMQPMessage

# Default our global support flag
PIKA_SUPPORT_AVAILABLE = False

try:
    import pika
    from pika.exceptions import AMQPError as PikaError

    # We're good to go!
    PIKA_SUPPORT_AVAILABLE = True

except ImportError:
    # AMQP 0-9-1 cannot be used without pika
    pika = None
    PikaError = AMQPError


# Everything that can go wrong while talking to the broker.  OSError covers
# socket and TLS failures, while ValueError and TypeError cover values pika
# refuses to encode.
PIKA_FAILURES = (PikaError, OSError, ValueError, TypeError)


class AMQP091Adapter:
    """Publish messages over AMQP 0-9-1."""

    # Only usable when pika could be imported
    enabled = PIKA_SUPPORT_AVAILABLE

    # The package to install to use this version
    package = "pika"

    def __init__(self, config: AMQPConfig) -> None:
        """Prepare an adapter that is not connected yet."""
        # How to reach the broker
        self.config = config

        # Our connection, and the channel opened on it when publishing
        self.connection: Optional[Any] = None
        self.channel: Optional[Any] = None

    def connect(self) -> None:
        """Connect and log into the broker, or raise ``AMQPError``."""
        cfg = self.config

        try:
            # Prepare TLS when amqps:// is used
            ssl_options = None
            if cfg.secure:
                context = ssl.create_default_context(cafile=certifi.where())
                if not cfg.verify_certificate:
                    # Accept self-signed or otherwise unverified servers
                    context.check_hostname = False
                    context.verify_mode = ssl.CERT_NONE

                ssl_options = pika.SSLOptions(
                    context, server_hostname=cfg.host
                )

            # Prepare our connection details
            params = {
                "host": cfg.host,
                "port": cfg.port,
                "virtual_host": cfg.vhost or "/",
                "ssl_options": ssl_options,
                # Fail fast; Apprise already handles retries itself
                "connection_attempts": 1,
                # Bound the time spent on the socket and the login
                "socket_timeout": cfg.connect_timeout,
                "stack_timeout": cfg.connect_timeout + cfg.read_timeout,
                # A broker that is low on memory or disk blocks publishers.
                # Give up instead of waiting forever.
                "blocked_connection_timeout": cfg.read_timeout,
                # Heartbeats are how pika notices a broker that stopped
                # answering.  The broker's own proposal is often 60 seconds,
                # which can stall a send for minutes, so ask for one close
                # to our read timeout instead.
                "heartbeat": max(1, math.ceil(cfg.read_timeout)),
            }

            if cfg.user:
                # Otherwise pika logs in with its default guest account
                params["credentials"] = pika.PlainCredentials(
                    cfg.user, cfg.password or ""
                )

            # Establish our connection
            self.connection = pika.BlockingConnection(
                pika.ConnectionParameters(**params)
            )

        except PIKA_FAILURES as e:
            # Leave nothing half open behind us
            self.close()
            raise AMQPError(str(e) or type(e).__name__) from None

    def publish(self, target: str, message: AMQPMessage) -> None:
        """Publish ``message`` using ``target`` as the routing key."""
        cfg = self.config

        try:
            if self.channel is None or not self.channel.is_open:
                # The broker closes a channel after some errors (such as a
                # missing exchange), so open a new one when we need to.
                self.channel = self.connection.channel()

                # Have the broker confirm every message it accepts
                self.channel.confirm_delivery()

            # Publish our message and wait for the broker to confirm it.
            # A mandatory message nobody can receive raises an error.
            self.channel.basic_publish(
                exchange=cfg.exchange,
                routing_key=target,
                body=message.body,
                properties=pika.BasicProperties(
                    content_type=message.content_type,
                    # 2 asks the broker to write the message to disk
                    delivery_mode=2 if message.persistent else 1,
                    priority=message.priority,
                    # AMQP 0-9-1 carries the expiry as text (milliseconds)
                    expiration=(
                        None if message.ttl is None else str(message.ttl)
                    ),
                    timestamp=message.timestamp,
                    app_id=message.app_id,
                    headers=message.headers,
                ),
                mandatory=cfg.mandatory,
            )

        except PIKA_FAILURES as e:
            # The message was refused, or the connection was lost
            raise AMQPError(str(e) or type(e).__name__) from None

    def close(self) -> None:
        """Close our connection; this never raises."""
        # Forget our connection first so close() is safe to call twice
        connection, self.connection, self.channel = (
            self.connection,
            None,
            None,
        )

        try:
            if connection is not None and connection.is_open:
                # Let the broker know we are leaving
                connection.close()

        except Exception:
            # The connection is already broken; there is nothing to clean
            pass
caronc-apprise-dfec414/apprise/plugins/amqp/v10.py000066400000000000000000000205321526720371000221630ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.


"""AMQP 1.0 publishing with Apache Qpid Proton.

Qpid Proton documentation: https://qpid.apache.org/proton/
A publish succeeds only after the broker accepts the message.
"""

from __future__ import annotations

import contextlib
from typing import Any, Optional

import certifi

from .common import AMQPConfig, AMQPError, AMQPMessage

# Default our global support flag
PROTON_SUPPORT_AVAILABLE = False

try:
    from proton import Endpoint, Message, ProtonException, SSLDomain
    from proton.utils import BlockingConnection

    # We're good to go!
    PROTON_SUPPORT_AVAILABLE = True

except ImportError:
    # AMQP 1.0 cannot be used without python-qpid-proton
    Endpoint = None
    Message = None
    SSLDomain = None
    BlockingConnection = None
    ProtonException = AMQPError


# Everything that can go wrong while talking to the broker.  OSError covers
# socket failures, while the rest cover values proton refuses to encode.
PROTON_FAILURES = (ProtonException, OSError, KeyError, ValueError, TypeError)


class AMQP10Adapter:
    """Publish messages over AMQP 1.0."""

    # Only usable when python-qpid-proton could be imported
    enabled = PROTON_SUPPORT_AVAILABLE

    # The package to install to use this version
    package = "python-qpid-proton"

    def __init__(self, config: AMQPConfig) -> None:
        """Prepare an adapter that is not connected yet."""
        # How to reach the broker
        self.config = config

        # Our connection once we are connected
        self.connection: Optional[Any] = None

    def connect(self) -> None:
        """Connect and log into the broker, or raise ``AMQPError``."""
        cfg = self.config

        try:
            # Prepare TLS when amqps:// is used
            ssl_domain = None
            if cfg.secure:
                ssl_domain = SSLDomain(SSLDomain.MODE_CLIENT)
                if cfg.verify_certificate:
                    # Check the server certificate and its host name
                    ssl_domain.set_trusted_ca_db(certifi.where())
                    ssl_domain.set_peer_authentication(
                        SSLDomain.VERIFY_PEER_NAME
                    )

                else:
                    # Accept self-signed or otherwise unverified servers
                    ssl_domain.set_peer_authentication(
                        SSLDomain.ANONYMOUS_PEER
                    )

            # Log in with our user when we have one; otherwise anonymously
            options = (
                {
                    "user": cfg.user,
                    "password": cfg.password or "",
                    "allowed_mechs": "PLAIN",
                }
                if cfg.user
                else {"allowed_mechs": "ANONYMOUS"}
            )

            if cfg.vhost:
                # Proton would otherwise check the TLS certificate against
                # the virtual host instead of the server we connect to
                options["virtual_host"] = cfg.vhost
                options["sni"] = cfg.host

            # Wrap IPv6 addresses in brackets so the port stays separate
            host = f"[{cfg.host}]" if ":" in cfg.host else cfg.host

            # Establish our connection.  Proton turns a 0 timeout into 60
            # seconds, so never hand it anything smaller than a tick.
            self.connection = BlockingConnection(
                "{schema}://{host}:{port}".format(
                    schema="amqps" if cfg.secure else "amqp",
                    host=host,
                    port=cfg.port,
                ),
                timeout=max(cfg.connect_timeout, 0.1),
                ssl_domain=ssl_domain,
                # Fail fast; Apprise already handles retries itself
                reconnect=False,
                **options,
            )

            # Every wait from here on is for a reply to something we sent
            self.connection.timeout = max(cfg.read_timeout, 0.1)

        except PROTON_FAILURES as e:
            # Leave nothing half open behind us
            self.close()
            raise AMQPError(str(e) or type(e).__name__) from None

    def publish(self, target: str, message: AMQPMessage) -> None:
        """Publish ``message`` to the ``target`` address."""
        try:
            # Prepare our message.  The body is sent as raw bytes so that
            # any client (including an AMQP 0-9-1 one) reads exactly the
            # text we sent.
            msg = Message(
                body=message.body,
                content_type=message.content_type,
                durable=message.persistent,
                creation_time=message.timestamp,
                properties=message.headers,
            )

            # Send the bytes as a plain data section; otherwise proton
            # wraps them in an AMQP typed value
            msg.inferred = True

            if message.priority is not None:
                # Otherwise the AMQP 1.0 default priority (4) applies
                msg.priority = message.priority

            if message.ttl is not None:
                # Proton takes the expiry in seconds
                msg.ttl = message.ttl / 1000

            # Open a link to the address we are publishing to
            sender = self.connection.create_sender(target)

            try:
                # Send our message and wait for the broker to accept it
                sender.send(msg)

            finally:
                # Release our link; the connection stays open.  Any error
                # means the broker already closed it for us.
                with contextlib.suppress(Exception):
                    sender.close()

        except PROTON_FAILURES as e:
            # The address or the message was refused, or the connection
            # was lost
            raise AMQPError(str(e) or type(e).__name__) from None

    def close(self) -> None:
        """Close our connection within our read timeout; this never raises."""
        # Forget our connection first so close() is safe to call twice
        connection, self.connection = self.connection, None
        if connection is None:
            # We never connected
            return

        # The AMQP connection proton's blocking wrapper drives
        conn = connection.conn

        with contextlib.suppress(Exception):
            # Let the broker know we are leaving, and give it until our read
            # timeout to say goodbye
            conn.close()
            connection.wait(
                lambda: not (conn.state & Endpoint.REMOTE_ACTIVE),
                timeout=max(self.config.read_timeout, 0.1),
                msg="Closing connection",
            )

        with contextlib.suppress(Exception):
            # Shut the socket ourselves.  Proton would otherwise wait forever
            # on a broker that stopped answering.
            conn.transport.close_tail()
            conn.transport.close_head()

        with contextlib.suppress(Exception):
            # Free what is left.  The goodbye was already waited for above,
            # so do not wait for it a second time.
            connection.timeout = 0.1
            connection.close()
caronc-apprise-dfec414/apprise/plugins/apprise_api.py000066400000000000000000000532141526720371000231160ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from json import dumps
import logging
import re
from typing import Optional, Union

import requests

from .. import exception
from ..common import NotifyFormat, NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import URL_PATH_SAFE_CHARS, parse_list, validate_regex
from ..utils.sanitize import sanitize_payload
from .base import NotifyBase


class AppriseAPIMethod:
    """Defines the method used to post to the remote server."""

    JSON = "json"
    FORM = "form"


APPRISE_API_METHODS = (
    AppriseAPIMethod.FORM,
    AppriseAPIMethod.JSON,
)


class AppriseAPIVersion:
    """Defines how the configuration ID is sent to Apprise API."""

    V1 = "1"
    V2 = "2"


APPRISE_API_VERSIONS = (
    AppriseAPIVersion.V1,
    AppriseAPIVersion.V2,
)


class NotifyAppriseAPI(NotifyBase):
    """A wrapper for Apprise (Persistent) API Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "Apprise API"

    # The services URL
    service_url = "https://github.com/caronc/apprise-api"

    # The default protocol
    protocol = "apprise"

    # The default secure protocol
    secure_protocol = "apprises"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/apprise_api/"

    # Support attachments
    attachment_support = True

    # Relay content unchanged; the downstream Apprise server converts it.
    notify_format = (
        NotifyFormat.TEXT,
        NotifyFormat.HTML,
        NotifyFormat.MARKDOWN,
    )

    # Depending on the number of transactions/notifications taking place, this
    # could take a while. 30 seconds should be enough to perform the task
    socket_read_timeout = 30.0

    # Disable throttle rate for Apprise API requests since they are normally
    # local anyway
    request_rate_per_sec = 0.0

    # Define object templates
    templates = (
        "{schema}://{host}/{token}",
        "{schema}://{host}:{port}/{token}",
        "{schema}://:{password}@{host}/{token}",
        "{schema}://:{password}@{host}:{port}/{token}",
        "{schema}://{user}@{host}/{token}",
        "{schema}://{user}@{host}:{port}/{token}",
        "{schema}://{user}:{password}@{host}/{token}",
        "{schema}://{user}:{password}@{host}:{port}/{token}",
    )

    # Define our tokens; these are the minimum tokens required required to
    # be passed into this function (as arguments). The syntax appends any
    # previously defined in the base package and builds onto them
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "host": {
                "name": _("Hostname"),
                "type": "string",
                "required": True,
            },
            "port": {
                "name": _("Port"),
                "type": "int",
                "min": 1,
                "max": 65535,
            },
            "user": {
                "name": _("Username"),
                "type": "string",
            },
            "password": {
                "name": _("Password"),
                "type": "string",
                "private": True,
            },
            "token": {
                "name": _("Token"),
                "type": "string",
                "required": True,
                "private": True,
                "regex": (r"^[A-Z0-9_-]{1,128}$", "i"),
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "tags": {
                "name": _("Tags"),
                "type": "string",
            },
            "method": {
                "name": _("Query Method"),
                "type": "choice:string",
                "values": APPRISE_API_METHODS,
                "default": APPRISE_API_METHODS[0],
            },
            "version": {
                "name": _("Apprise API Version"),
                "type": "choice:string",
                "values": APPRISE_API_VERSIONS,
                "default": AppriseAPIVersion.V2,
            },
            "to": {
                "alias_of": "token",
            },
        },
    )

    # Define any kwargs we're using
    template_kwargs = {
        "headers": {
            "name": _("HTTP Header"),
            "prefix": "+",
        },
    }

    def __init__(
        self,
        token=None,
        tags=None,
        method=None,
        version=None,
        headers=None,
        **kwargs,
    ):
        """Initialize Apprise API Object.

        headers can be a dictionary of key/value pairs that you want to
        additionally include as part of the server headers to post with
        """
        super().__init__(**kwargs)

        self.token = validate_regex(
            token, *self.template_tokens["token"]["regex"]
        )
        if not self.token:
            msg = f"The Apprise API token specified ({token}) is invalid."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        self.method = (
            self.template_args["method"]["default"]
            if not isinstance(method, str)
            else method.lower()
        )

        if self.method not in APPRISE_API_METHODS:
            msg = f"The method specified ({method}) is invalid."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Version 2 keeps the configuration ID out of the HTTP URL. Version 1
        # remains available for older Apprise API servers.
        self.version = (
            self.template_args["version"]["default"]
            if not isinstance(version, str)
            else version
        )
        if self.version not in APPRISE_API_VERSIONS:
            msg = f"The Apprise API version specified ({version}) is invalid."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Build list of tags
        self.__tags = parse_list(tags)

        self.headers = {}
        if headers:
            # Store our extra headers
            self.headers.update(headers)

        return

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "method": self.method,
            "version": self.version,
        }

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        # Append our headers into our parameters
        params.update({f"+{k}": v for k, v in self.headers.items()})

        if self.__tags:
            params["tags"] = ",".join(list(self.__tags))

        # Determine Authentication
        auth = ""
        if self.password:
            auth = "{user}:{password}@".format(
                user=NotifyAppriseAPI.quote(self.user or "", safe=""),
                password=self.pprint(
                    self.password, privacy, mode=PrivacyMode.Secret, safe=""
                ),
            )
        elif self.user:
            auth = "{user}@".format(
                user=NotifyAppriseAPI.quote(self.user, safe=""),
            )

        default_port = 443 if self.secure else 80

        fullpath = self.fullpath.strip("/")
        return (
            "{schema}://{auth}{hostname}{port}{fullpath}{token}"
            "/?{params}".format(
                schema=self.secure_protocol if self.secure else self.protocol,
                auth=auth,
                # never encode hostname since we're expecting it to be a
                # valid one
                hostname=self.host,
                port=(
                    ""
                    if self.port is None or self.port == default_port
                    else f":{self.port}"
                ),
                fullpath=(
                    "/{}/".format(
                        NotifyAppriseAPI.quote(
                            fullpath, safe=URL_PATH_SAFE_CHARS
                        )
                    )
                    if fullpath
                    else "/"
                ),
                token=self.pprint(self.token, privacy, safe=""),
                params=NotifyAppriseAPI.urlencode(params),
            )
        )

    def resolve_format(
        self, body_format: Optional[Union[str, NotifyFormat]] = None
    ) -> NotifyFormat:
        """Keep the caller's format so this relay does not convert content.

        The downstream Apprise server performs the required conversion. With
        no source format, normal passthrough rules apply.
        """
        if body_format in self._formats():
            # Target the source format so no conversion takes place
            return NotifyFormat(body_format)

        # No source format; fall back to the normal resolution
        return super().resolve_format(body_format)

    def send(
        self,
        body,
        title="",
        notify_type=NotifyType.INFO,
        attach=None,
        body_format=None,
        body_passthrough=None,
        **kwargs,
    ):
        """Perform Apprise API Notification."""

        # Prepare HTTP Headers
        headers = {
            "User-Agent": self.app_id,
        }

        # Apply any/all header over-rides defined
        headers.update(self.headers)

        attachments = []
        files = []
        if attach and self.attachment_support:
            for no, attachment in enumerate(attach, start=1):
                # Perform some simple error checking
                if not attachment:
                    # We could not access the attachment
                    self.logger.error(
                        "Could not access Apprise API attachment"
                        f" {attachment.url(privacy=True)}."
                    )
                    return False

                try:
                    # Our Attachment filename
                    filename = (
                        attachment.name
                        if attachment.name
                        else f"file{no:03}.dat"
                    )

                    if self.method == AppriseAPIMethod.JSON:
                        # Output must be in a DataURL format (that's what
                        # PushSafer calls it):
                        attachments.append(
                            {
                                "filename": filename,
                                "base64": attachment.base64(),
                                "mimetype": attachment.mimetype,
                            }
                        )

                    else:  # AppriseAPIMethod.FORM
                        files.append(
                            (
                                f"file{no:02d}",
                                (
                                    filename,
                                    # file handle safely closed in
                                    # `finally`; inline open intentional
                                    open(attachment.path, "rb"),  # noqa: SIM115
                                    attachment.mimetype,
                                ),
                            )
                        )

                except (TypeError, OSError, exception.AppriseException):
                    # We could not access the attachment
                    self.logger.error(
                        "Could not access AppriseAPI attachment"
                        f" {attachment.url(privacy=True)}."
                    )
                    return False

                self.logger.debug(
                    "Appending AppriseAPI attachment"
                    f" {attachment.url(privacy=True)}"
                )

        # prepare Apprise API Object
        payload = {
            # Apprise API Payload
            "title": title,
            "body": body,
            "type": notify_type.value,
        }

        if body_passthrough:
            # For passthrough content, relay an explicit URL format only.
            if self._format_override is not None:
                payload["format"] = self._format_override.value

        elif body_format is not None:
            # Label unchanged content with its declared source format.
            payload["format"] = body_format.value

        if self.__tags:
            payload["tag"] = self.__tags

        if self.method == AppriseAPIMethod.JSON:
            headers["Content-Type"] = "application/json"

            if attachments:
                payload["attachments"] = attachments

            payload = dumps(payload)

        auth = None
        if self.user or self.password:
            # An empty username is valid for password-only Apprise API
            # administrator accounts.
            auth = (self.user or "", self.password)

        # Set our schema
        schema = "https" if self.secure else "http"

        url = f"{schema}://{self.host}"
        if isinstance(self.port, int):
            url += f":{self.port}"

        fullpath = self.fullpath.strip("/")
        url += "{}".format("/" + fullpath) if fullpath else ""
        url += "/notify"

        if self.version == AppriseAPIVersion.V1:
            # Version 1 places the configuration ID in the request path.
            url += f"/{self.token}"

        else:
            # Version 2 keeps the ID out of the request URL and access logs.
            headers["X-Apprise-Config-ID"] = self.token

        # Some entries can not be over-ridden
        headers.update(
            {
                # Our response to be in JSON format always
                "Accept": "application/json",
                # Pass our Source UUID4 Identifier
                "X-Apprise-ID": self.asset._uid,
                # Pass our current recursion count to our upstream server
                "X-Apprise-Recursion-Count": str(self.asset._recursion + 1),
            }
        )

        # Some Debug Logging
        if self.logger.isEnabledFor(logging.DEBUG):
            # Due to attachments; output can be quite heavy and io intensive
            # To accommodate this, we only show our debug payload information
            # if required.
            self.logger.debug(
                "Apprise API POST URL:"
                f" {url} (cert_verify={self.verify_certificate!r})"
            )
            self.logger.debug(
                "Apprise API Payload: %s", sanitize_payload(payload)
            )

        # Always call throttle before any remote server i/o is made
        self.throttle()

        try:
            r = requests.post(
                url,
                data=payload,
                headers=headers,
                auth=auth,
                files=files if files else None,
                verify=self.verify_certificate,
                timeout=self.request_timeout,
                allow_redirects=self.redirects,
            )
            if r.status_code != requests.codes.ok:
                # We had a problem
                status_str = NotifyAppriseAPI.http_response_code_lookup(
                    r.status_code
                )

                self.logger.warning(
                    "Failed to send Apprise API notification: "
                    "{}{}error={}.".format(
                        status_str, ", " if status_str else "", r.status_code
                    )
                )

                self.logger.debug(
                    "Response Details:\r\n%r", (r.content or b"")[:2000]
                )

                # Return; we're done
                return False

            else:
                self.logger.info(
                    "Sent Apprise API notification; method=%s.", self.method
                )

        except requests.RequestException as e:
            self.logger.warning(
                "A Connection error occurred sending Apprise API "
                f"notification to {self.host}."
            )
            self.logger.debug(f"Socket Exception: {e!s}")

            # Return; we're done
            return False

        except OSError as e:
            self.logger.warning(
                "An I/O error occurred while reading one of the "
                "attached files."
            )
            self.logger.debug(f"I/O Exception: {e!s}")
            return False

        finally:
            for file in files:
                # Ensure all files are closed
                file[1][1].close()

        return True

    @staticmethod
    def parse_native_url(url):
        """
        Support http://hostname/notify/token and
                http://hostname/path/notify/token
        """

        result = re.match(
            r"^http(?Ps?)://(?P[A-Z0-9._-]+)"
            r"(:(?P[0-9]+))?"
            r"(?P/[^?]+?)?/notify/(?P[A-Z0-9_-]{1,32})/?"
            r"(?P\?.+)?$",
            url,
            re.I,
        )

        if result:
            results = NotifyAppriseAPI.parse_url(
                "{schema}://{hostname}{port}{path}/{token}/{params}".format(
                    schema=(
                        NotifyAppriseAPI.secure_protocol
                        if result.group("secure")
                        else NotifyAppriseAPI.protocol
                    ),
                    hostname=result.group("hostname"),
                    port=(
                        ""
                        if not result.group("port")
                        else ":{}".format(result.group("port"))
                    ),
                    path=(
                        ""
                        if not result.group("path")
                        else result.group("path")
                    ),
                    token=result.group("token"),
                    # The "params" group already includes its own leading
                    # "?" (it's captured by the regex), so it's used as-is.
                    params=result.group("params") or "",
                )
            )

            if results and not results.get("version"):
                # A /notify/{token} URL is the Version 1 endpoint shape, so
                # default to it unless the URL already specified a version.
                results["version"] = AppriseAPIVersion.V1

            return results

        return None

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # Add our headers that the user can potentially over-ride if they wish
        # to to our returned result set and tidy entries by unquoting them
        results["headers"] = {
            NotifyAppriseAPI.unquote(x): NotifyAppriseAPI.unquote(y)
            for x, y in results["qsd+"].items()
        }

        # Support the passing of tags in the URL
        if "tags" in results["qsd"] and len(results["qsd"]["tags"]):
            results["tags"] = NotifyAppriseAPI.parse_list(
                results["qsd"]["tags"]
            )

        # Support the 'to' & 'token' variable so that we can support rooms
        # this way too.
        if "token" in results["qsd"] and len(results["qsd"]["token"]):
            results["token"] = NotifyAppriseAPI.unquote(
                results["qsd"]["token"]
            )

        elif "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["token"] = NotifyAppriseAPI.unquote(results["qsd"]["to"])

        else:
            # Start with a list of path entries to work with
            entries = NotifyAppriseAPI.split_path(results["fullpath"])
            if entries:
                # use our last entry found
                results["token"] = entries[-1]

                # pop our last entry off
                entries = entries[:-1]

                # re-assemble our full path
                results["fullpath"] = "/".join(entries)

        # Set method if specified
        if "method" in results["qsd"] and len(results["qsd"]["method"]):
            results["method"] = NotifyAppriseAPI.unquote(
                results["qsd"]["method"]
            )

        # Support the same long and short version arguments as Matrix.
        if "version" in results["qsd"] and len(results["qsd"]["version"]):
            results["version"] = NotifyAppriseAPI.unquote(
                results["qsd"]["version"]
            )

        elif "v" in results["qsd"] and len(results["qsd"]["v"]):
            results["version"] = NotifyAppriseAPI.unquote(results["qsd"]["v"])

        return results
caronc-apprise-dfec414/apprise/plugins/aprs.py000066400000000000000000000626711526720371000215760ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
#
# To use this plugin, you need to be a licensed ham radio operator
#
# Plugin constraints:
#
# - message length = 67 chars max.
# - message content = ASCII 7 bit
# - APRS messages will be sent without msg ID, meaning that
#   ham radio operators cannot acknowledge them
# - Bring your own APRS-IS passcode. If you don't know what
#   this is or how to get it, then this plugin is not for you
# - Do NOT change the Device/ToCall ID setting UNLESS this
#   module is used outside of Apprise. This identifier helps
#   the ham radio community with determining the software behind
#   a given APRS message.
# - With great (ham radio) power comes great responsibility; do
#   not use this plugin for spamming other ham radio operators

#
# In order to digest text input which is not in plain English,
# users can install the optional 'unidecode' package as part
# of their venv environment. Details: see plugin description
#

#
# You're done at this point, you only need to know your user/pass that
# you signed up with.

#  The following URLs would be accepted by Apprise:
#   - aprs://{user}:{password}@{callsign}
#   - aprs://{user}:{password}@{callsign1}/{callsign2}

# Optional parameters:
#   - locale --> APRS-IS target server to connect with
#                Default: EURO --> 'euro.aprs2.net'
#                Details: https://www.aprs2.net/

#
# APRS message format specification:
# http://www.aprs.org/doc/APRS101.PDF
#

from __future__ import annotations

import contextlib
from itertools import chain
import re
import socket
import sys
from typing import Any

from .. import __version__
from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import is_call_sign, parse_call_sign
from .base import NotifyBase

# Fixed APRS-IS server locales
# Default is 'EURO'
# See https://www.aprs2.net/ for details
# Select the rotating server in case you
# don"t care about a specific locale
APRS_LOCALES = {
    "NOAM": "noam.aprs2.net",
    "SOAM": "soam.aprs2.net",
    "EURO": "euro.aprs2.net",
    "ASIA": "asia.aprs2.net",
    "AUNZ": "aunz.aprs2.net",
    "ROTA": "rotate.aprs2.net",
}

# Identify all unsupported characters
APRS_BAD_CHARMAP = {
    r"Ä": "Ae",
    r"Ö": "Oe",
    r"Ü": "Ue",
    r"ä": "ae",
    r"ö": "oe",
    r"ü": "ue",
    r"ß": "ss",
}

# Our compiled mapping of bad characters
APRS_COMPILED_MAP = re.compile(r"(" + "|".join(APRS_BAD_CHARMAP.keys()) + r")")


class NotifyAprs(NotifyBase):
    """A wrapper for APRS Notifications via APRS-IS."""

    # The default descriptive name associated with the Notification
    service_name = "Aprs"

    # The services URL
    service_url = "https://www.aprs2.net/"

    # The default secure protocol
    secure_protocol = "aprs"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/aprs/"

    # APRS default port, supported by all core servers
    # Details: https://www.aprs-is.net/Connecting.aspx
    notify_port = 10152

    # The maximum length of the APRS message body
    body_maxlen = 67

    # Apprise APRS Device ID / TOCALL ID
    # This is a FIXED value which is associated with this plugin.
    # Its value MUST NOT be changed. If you use this APRS plugin
    # code OUTSIDE of Apprise, please request your own TOCALL ID.
    # Details: see https://github.com/aprsorg/aprs-deviceid
    #
    # Do NOT use the generic "APRS" TOCALL ID !!!!!
    #
    device_id = "APPRIS"

    # A title can not be used for APRS Messages.  Setting this to zero will
    # cause any title (if defined) to get placed into the message body.
    title_maxlen = 0

    # Helps to reduce the number of login-related errors where the
    # APRS-IS server "isn't ready yet". If we try to receive the rx buffer
    # without this grace perid in place, we may receive "incomplete" responses
    # where the login response lacks information. In case you receive too many
    # "Rx: APRS-IS msg is too short - needs to have at least two lines" error
    # messages, you might want to increase this value to a larger time span
    # Per previous experience, do not use values lower than 0.5 (seconds)
    request_rate_per_sec = 0.8

    # Encoding of retrieved content
    aprs_encoding = "latin-1"

    # Define object templates
    templates = ("{schema}://{user}:{password}@{targets}",)

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "user": {
                "name": _("User Name"),
                "type": "string",
                "required": True,
            },
            "password": {
                "name": _("Password"),
                "type": "string",
                "private": True,
                "required": True,
            },
            "target_callsign": {
                "name": _("Target Callsign"),
                "type": "string",
                "regex": (
                    r"^[a-z0-9]{2,5}(-[a-z0-9]{1,2})?$",
                    "i",
                ),
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
                "required": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "to": {
                "name": _("Target Callsign"),
                "type": "string",
                "map_to": "targets",
            },
            "delay": {
                "name": _("Resend Delay"),
                "type": "float",
                "min": 0.0,
                "max": 5.0,
                "default": 0.0,
            },
            "locale": {
                "name": _("Locale"),
                "type": "choice:string",
                "values": APRS_LOCALES,
                "default": "EURO",
            },
        },
    )

    def __init__(self, targets=None, locale=None, delay=None, **kwargs):
        """Initialize APRS Object."""
        super().__init__(**kwargs)

        # Our (future) socket sobject
        self.sock = None

        # Parse our targets
        self.targets = []
        """
        Check if the user has provided credentials
        """
        if not (self.user and self.password):
            msg = "An APRS user/pass was not provided."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        """
        Check if the user tries to use a read-only access
        to APRS-IS. We need to send content, meaning that
        read-only access will not work
        """
        if self.password == "-1":
            msg = "APRS read-only passwords are not supported."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        """
        Check if the password is numeric
        """
        if not self.password.isnumeric():
            msg = "Invalid APRS-IS password"
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        """
        Convert given user name (FROM callsign) and
        device ID to to uppercase
        """
        self.user = self.user.upper()
        self.device_id = self.device_id.upper()
        """
        Check if the user has provided a locale for the
        APRS-IS-server and validate it, if necessary
        """
        if locale and locale.upper() not in APRS_LOCALES:
            msg = (
                "Unsupported APRS-IS server locale. "
                "Received: {}. Valid: {}".format(
                    locale, ", ".join(str(x) for x in APRS_LOCALES)
                )
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Update our delay
        if delay is None:
            self.delay = NotifyAprs.template_args["delay"]["default"]

        else:
            try:
                self.delay = float(delay)
                if (
                    self.delay < NotifyAprs.template_args["delay"]["min"]
                    or self.delay >= NotifyAprs.template_args["delay"]["max"]
                ):
                    raise ValueError()

            except (TypeError, ValueError):
                msg = f"Unsupported APRS-IS delay ({delay}) specified. "
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg) from None

        # Bump up our request_rate
        self.request_rate_per_sec += self.delay

        # Set the transmitter group
        self.locale = (
            NotifyAprs.template_args["locale"]["default"]
            if not locale
            else locale.upper()
        )

        # Used for URL generation afterwards only
        self.invalid_targets = []

        for target in parse_call_sign(targets):
            # Validate targets and drop bad ones
            # We just need to know if the call sign (including SSID, if
            # provided) is valid and can then process the input as is
            result = is_call_sign(target)
            if not result:
                self.logger.warning(
                    f"Dropping invalid Amateur radio call sign ({target}).",
                )
                self.invalid_targets.append(target.upper())
                continue

            # Store entry
            self.targets.append(target.upper())

        return

    def socket_close(self):
        """Closes the socket connection whereas present."""
        if self.sock:
            with contextlib.suppress(Exception):
                self.sock.close()
            self.sock = None

    def socket_open(self):
        """Establishes the connection to the APRS-IS socket server."""
        self.logger.debug(
            "Creating socket connection with APRS-IS"
            f" {APRS_LOCALES[self.locale]}:{self.notify_port}"
        )

        try:
            self.sock = socket.create_connection(
                (APRS_LOCALES[self.locale], self.notify_port),
                self.socket_connect_timeout,
            )

        except ConnectionError as e:
            self.logger.debug("Socket Exception socket_open: %s", e)
            self.sock = None
            return False

        except socket.gaierror as e:
            self.logger.debug("Socket Exception socket_open: %s", e)
            self.sock = None
            return False

        except socket.timeout as e:
            self.logger.debug("Socket Timeout Exception socket_open: %s", e)
            self.sock = None
            return False

        except Exception as e:
            self.logger.debug("General Exception socket_open: %s", e)
            self.sock = None
            return False

        # We are connected.
        # getpeername() is not supported by every OS. Therefore,
        # we MAY receive an exception even though we are
        # connected successfully.
        try:
            # Get the physical host/port of the server
            host, port = self.sock.getpeername()
            # and create debug info
            self.logger.debug(f"Connected to {host}:{port}")

        except ValueError:
            # Seens as if we are running on an operating
            # system that does not support getpeername()
            # Create a minimal log file entry
            self.logger.debug("Connected to APRS-IS")

        # Return success
        return True

    def aprsis_login(self):
        """Generate the APRS-IS login string, send it to the server and parse
        the response.

        Returns True/False wrt whether the login was successful
        """
        self.logger.debug("socket_login: init")

        # Check if we are connected
        if not self.sock:
            self.logger.warning("socket_login: Not connected to APRS-IS")
            return False

        # APRS-IS login string, see https://www.aprs-is.net/Connecting.aspx
        login_str = (
            f"user {self.user} pass {self.password} vers apprise"
            f" {__version__}\r\n"
        )

        # Send the data & abort in case of error
        if not self.socket_send(login_str):
            self.logger.warning(
                "socket_login: Login to APRS-IS unsuccessful,"
                " exception occurred"
            )
            self.socket_close()
            return False

        rx_buf = self.socket_receive(len(login_str) + 100)
        # Abort the remaining process in case an error has occurred
        if not rx_buf:
            self.logger.warning(
                "socket_login: Login to APRS-IS "
                "unsuccessful, exception occurred"
            )
            self.socket_close()
            return False

        # APRS-IS sends at least two lines of data
        # The data that we need is in line #2 so
        # let's split the  content and see what we have
        rx_lines = rx_buf.splitlines()
        if len(rx_lines) < 2:
            self.logger.warning(
                "socket_login: APRS-IS msg is too short"
                " - needs to have at least two lines"
            )
            self.socket_close()
            return False

        # Now split the 2nd line's content and extract
        # both call sign and login status
        try:
            _, _, callsign, status, _ = rx_lines[1].split(" ", 4)

        except ValueError:
            # ValueError is returned if there were not enough elements to
            # populate the response
            self.logger.warning(
                "socket_login: received invalid response from APRS-IS"
            )
            self.socket_close()
            return False

        if callsign != self.user:
            self.logger.warning(f"socket_login: call signs differ: {callsign}")
            self.socket_close()
            return False

        if status.startswith("unverified"):
            self.logger.warning(
                "socket_login: invalid APRS-IS password for given call sign"
            )
            self.socket_close()
            return False

        # all validations are successful; we are connected
        return True

    def socket_send(self, tx_data):
        """Generic "Send data to a socket"."""
        self.logger.debug("socket_send: init")

        # Check if we are connected
        if not self.sock:
            self.logger.warning("socket_send: Not connected to APRS-IS")
            return False

        # Encode our data if we are on Python3 or later
        payload = (
            tx_data.encode("utf-8") if sys.version_info[0] >= 3 else tx_data
        )

        # Always call throttle before any remote server i/o is made
        self.throttle()

        # Try to open the socket
        # Send the content to APRS-IS
        try:
            self.sock.setblocking(True)
            self.sock.settimeout(self.socket_connect_timeout)
            self.sock.sendall(payload)

        except socket.gaierror as e:
            self.logger.warning(f"Socket Exception socket_send: {e!s}")
            self.sock = None
            return False

        except socket.timeout as e:
            self.logger.warning(f"Socket Timeout Exception socket_send: {e!s}")
            self.sock = None
            return False

        except Exception as e:
            self.logger.warning(f"General Exception socket_send: {e!s}")
            self.sock = None
            return False

        self.logger.debug("socket_send: successful")

        # mandatory on several APRS-IS servers
        # helps to reduce the number of errors where
        # the server only returns an abbreviated message
        return True

    def socket_reset(self):
        """Resets the socket's buffer."""
        self.logger.debug("socket_reset: init")
        _ = self.socket_receive(0)
        self.logger.debug("socket_reset: successful")
        return True

    def socket_receive(self, rx_len):
        """Generic "Receive data from a socket"."""
        self.logger.debug("socket_receive: init")

        # Check if we are connected
        if not self.sock:
            self.logger.warning("socket_receive: not connected to APRS-IS")
            return False

        # len is zero in case we intend to
        # reset the socket
        if rx_len > 0:
            self.logger.debug("socket_receive: Receiving data from APRS-IS")

        # Receive content from the socket
        try:
            self.sock.setblocking(False)
            self.sock.settimeout(self.socket_connect_timeout)
            rx_buf = self.sock.recv(rx_len)

        except socket.gaierror as e:
            self.logger.warning(f"Socket Exception socket_receive: {e!s}")
            self.sock = None
            return False

        except socket.timeout as e:
            self.logger.warning(
                f"Socket Timeout Exception socket_receive: {e!s}"
            )
            self.sock = None
            return False

        except Exception as e:
            self.logger.warning(f"General Exception socket_receive: {e!s}")
            self.sock = None
            return False

        rx_buf = (
            rx_buf.decode(self.aprs_encoding)
            if sys.version_info[0] >= 3
            else rx_buf
        )

        # There will be no data in case we reset the socket
        if rx_len > 0:
            self.logger.debug(f"Received content: {rx_buf}")

        self.logger.debug("socket_receive: successful")

        return rx_buf.rstrip()

    def send(
        self,
        body: str,
        title: str = "",
        notify_type: NotifyType = NotifyType.INFO,
        **kwargs: Any,
    ) -> bool:
        """Perform APRS Notification."""

        if not self.targets:
            # There is no one to notify; we're done
            self.logger.warning(
                "There are no amateur radio call signs to notify"
            )
            return False

        # prepare payload
        payload = body

        # sock object is "None" if we were unable to establish a connection
        # In case of errors, the error message has already been sent
        # to the logger object
        if not self.socket_open():
            return False

        # We have established a successful connection
        # to the socket server. Now send the login information
        if not self.aprsis_login():
            return False

        # Login & authorization confirmed
        # reset what is in our buffer
        self.socket_reset()

        # error tracking (used for function return)
        has_error = False

        # Create a copy of the targets list
        targets = list(self.targets)

        self.logger.debug("Starting Payload setup")

        # Prepare the outgoing message
        # Due to APRS's contraints, we need to do
        # a lot of filtering before we can send
        # the actual message
        #
        # First remove all characters from the
        # payload that would break APRS
        # see https://www.aprs.org/doc/APRS101.PDF pg. 71
        payload = re.sub(r"[{}|~]+", "", payload)

        payload = APRS_COMPILED_MAP.sub(  # pragma: no branch
            lambda x: APRS_BAD_CHARMAP[x.group()], payload
        )

        # APRS-IS ends packets at line breaks, so join the message into one
        # line. The pattern starts at the first space to scan long runs once.
        # See https://www.aprs-is.net/Connecting.aspx
        payload = re.sub(
            r"(?:(?{self.device_id}::{targets[index]:9}:{payload}"
            )

            # and send the content to the socket
            # Note that there will be no response from APRS and
            # that all exceptions are handled within the 'send' method
            self.logger.debug(f"Sending APRS message: {buffer}")

            # send the content
            if not self.socket_send(buffer):
                has_error = True
                break

            # Delivered; a retry can safely skip this callsign.
            self.mark_delivered(targets[index])

            # Finally, reset our socket buffer
            # we DO NOT read from the socket as we
            # would simply listen to the default APRS-IS stream
            self.socket_reset()

        self.logger.debug("Closing socket.")
        self.socket_close()
        self.logger.info(
            "Sent %d/%d APRS-IS notification(s)", index + 1, len(targets)
        )
        return not has_error

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {}

        if self.locale != NotifyAprs.template_args["locale"]["default"]:
            # Store our locale if not default
            params["locale"] = self.locale

        if self.delay != NotifyAprs.template_args["delay"]["default"]:
            # Store our locale if not default
            params["delay"] = f"{self.delay:.2f}"

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        # Setup Authentication
        auth = "{user}:{password}@".format(
            user=NotifyAprs.quote(self.user, safe=""),
            password=self.pprint(
                self.password, privacy, mode=PrivacyMode.Secret, safe=""
            ),
        )

        return "{schema}://{auth}{targets}?{params}".format(
            schema=self.secure_protocol,
            auth=auth,
            targets="/".join(
                chain(
                    [self.pprint(x, privacy, safe="") for x in self.targets],
                    [
                        self.pprint(x, privacy, safe="")
                        for x in self.invalid_targets
                    ],
                )
            ),
            params=NotifyAprs.urlencode(params),
        )

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (self.user, self.password, self.locale)

    def __len__(self):
        """Returns the number of targets associated with this notification."""
        targets = len(self.targets)
        return targets if targets > 0 else 1

    def __del__(self):
        """Ensure we close any lingering connections."""
        self.socket_close()

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # All elements are targets
        results["targets"] = [NotifyAprs.unquote(results["host"])]

        # All entries after the hostname are additional targets
        results["targets"].extend(NotifyAprs.split_path(results["fullpath"]))

        # Get Delay (if set)
        if "delay" in results["qsd"] and len(results["qsd"]["delay"]):
            results["delay"] = NotifyAprs.unquote(results["qsd"]["delay"])

        # Support the 'to' variable so that we can support rooms this way too
        # The 'to' makes it easier to use yaml configuration
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyAprs.parse_list(results["qsd"]["to"])

        # Set our APRS-IS server locale's key value and convert it to uppercase
        if "locale" in results["qsd"] and len(results["qsd"]["locale"]):
            results["locale"] = NotifyAprs.unquote(
                results["qsd"]["locale"]
            ).upper()

        return results
caronc-apprise-dfec414/apprise/plugins/bark.py000066400000000000000000000621771526720371000215510ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

#
# API: https://github.com/Finb/bark-server/blob/master/docs/API_V2.md#python
#
import base64
import json
import secrets

import requests

try:
    from cryptography.hazmat.primitives.ciphers.aead import AESGCM

    BARK_AESGCM_SUPPORT = True

except ImportError:
    BARK_AESGCM_SUPPORT = False

from ..common import NotifyFormat, NotifyImageSize, NotifyType
from ..exception import AppriseImproperlyConfigured, ApprisePluginException
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import parse_bool, parse_list
from .base import NotifyBase

# Sounds generated off of: https://github.com/Finb/Bark/tree/master/Sounds
BARK_SOUNDS = (
    "alarm.caf",
    "anticipate.caf",
    "bell.caf",
    "birdsong.caf",
    "bloom.caf",
    "calypso.caf",
    "chime.caf",
    "choo.caf",
    "descent.caf",
    "electronic.caf",
    "fanfare.caf",
    "glass.caf",
    "gotosleep.caf",
    "healthnotification.caf",
    "horn.caf",
    "ladder.caf",
    "mailsent.caf",
    "minuet.caf",
    "multiwayinvitation.caf",
    "newmail.caf",
    "newsflash.caf",
    "noir.caf",
    "paymentsuccess.caf",
    "shake.caf",
    "sherwoodforest.caf",
    "silence.caf",
    "spell.caf",
    "suspense.caf",
    "telegraph.caf",
    "tiptoes.caf",
    "typewriters.caf",
    "update.caf",
)


# Supported Level Entries
class NotifyBarkLevel:
    """Defines the Bark Level options."""

    ACTIVE = "active"

    TIME_SENSITIVE = "timeSensitive"

    PASSIVE = "passive"

    CRITICAL = "critical"


BARK_LEVELS = (
    NotifyBarkLevel.ACTIVE,
    NotifyBarkLevel.TIME_SENSITIVE,
    NotifyBarkLevel.PASSIVE,
    NotifyBarkLevel.CRITICAL,
)

BARK_AES_KEY_LENGTHS = frozenset({16, 24, 32})
BARK_GCM_IV_RANDOM_BYTES = 9
BARK_GCM_IV_LENGTH = 12


class NotifyBark(NotifyBase):
    """A wrapper for Notify Bark Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "Bark"

    requirements = {
        "packages_recommended": "cryptography",
    }

    # The services URL
    service_url = "https://github.com/Finb/Bark"

    # The default protocol
    protocol = "bark"

    # The default secure protocol
    secure_protocol = "barks"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/bark/"

    # Allows the user to specify the NotifyImageSize object; this is supported
    # through the webhook
    image_size = NotifyImageSize.XY_128

    # Define object templates
    templates = (
        "{schema}://{host}/{targets}",
        "{schema}://{host}:{port}/{targets}",
        "{schema}://{user}:{password}@{host}/{targets}",
        "{schema}://{user}:{password}@{host}:{port}/{targets}",
    )

    # Define our template arguments
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "host": {
                "name": _("Hostname"),
                "type": "string",
                "required": True,
            },
            "port": {
                "name": _("Port"),
                "type": "int",
                "min": 1,
                "max": 65535,
            },
            "user": {
                "name": _("Username"),
                "type": "string",
            },
            "password": {
                "name": _("Password"),
                "type": "string",
                "private": True,
            },
            "target_device": {
                "name": _("Target Device"),
                "type": "string",
                "map_to": "targets",
                "private": True,
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
                "required": True,
                "private": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "sound": {
                "name": _("Sound"),
                "type": "choice:string",
                "values": BARK_SOUNDS,
            },
            "level": {
                "name": _("Level"),
                "type": "choice:string",
                "values": BARK_LEVELS,
            },
            "volume": {
                "name": _("Volume"),
                "type": "int",
                "min": 0,
                "max": 10,
            },
            "click": {
                "name": _("Click"),
                "type": "string",
            },
            "badge": {
                "name": _("Badge"),
                "type": "int",
                "min": 0,
            },
            "category": {
                "name": _("Category"),
                "type": "string",
            },
            "group": {
                "name": _("Group"),
                "type": "string",
            },
            "image": {
                "name": _("Include Image"),
                "type": "bool",
                "default": True,
                "map_to": "include_image",
            },
            "icon": {
                "name": _("Icon URL"),
                "type": "string",
            },
            "call": {
                "name": _("Call"),
                "type": "bool",
                "default": False,
            },
            "key": {
                "name": _("Encryption Key"),
                "type": "string",
                "private": True,
                "map_to": "encryption_key",
            },
            "to": {
                "alias_of": "targets",
            },
        },
    )

    def __init__(
        self,
        targets=None,
        include_image=True,
        sound=None,
        category=None,
        group=None,
        level=None,
        click=None,
        badge=None,
        volume=None,
        icon=None,
        call=None,
        encryption_key=None,
        **kwargs,
    ):
        """Initialize Notify Bark Object."""
        super().__init__(**kwargs)

        # Prepare our URL
        self.notify_url = "{}://{}{}/push".format(
            "https" if self.secure else "http",
            self.host,
            (
                f":{self.port}"
                if (self.port and isinstance(self.port, int))
                else ""
            ),
        )

        # Assign our category
        self.category = category if isinstance(category, str) else None

        # Assign our group
        self.group = group if isinstance(group, str) else None

        # Initialize device list
        self.targets = parse_list(targets)

        # Place an image inline with the message body
        self.include_image = include_image

        # A clickthrough option for notifications
        self.click = click

        # Badge
        try:
            # Acquire our badge count if we can:
            #  - We accept both the integer form as well as a string
            #    representation
            self.badge = int(badge)
            if self.badge < 0:
                raise ValueError()

        except TypeError:
            # NoneType means use Default; this is an okay exception
            self.badge = None

        except ValueError:
            self.badge = None
            self.logger.warning(
                "The specified Bark badge (%s) is not valid", badge
            )

        # Sound (easy-lookup)
        self.sound = (
            None
            if not sound
            else next(
                (f for f in BARK_SOUNDS if f.startswith(sound.lower())), None
            )
        )
        if sound and not self.sound:
            self.logger.warning(
                "The specified Bark sound (%s) was not found", sound
            )

        # Volume
        self.volume = None
        if volume is not None:
            try:
                self.volume = int(volume) if volume is not None else None
                if self.volume is not None and not (0 <= self.volume <= 10):
                    raise ValueError()

            except (TypeError, ValueError):
                self.logger.warning(
                    "The specified Bark volume (%s) is not valid. "
                    "Must be between 0 and 10",
                    volume,
                )

        # Call
        self.call = parse_bool(call)

        # Encryption is off unless an encryption key was explicitly given
        self.encryption_key = None
        self._cipher = None
        if encryption_key:
            # The Bark app expects a raw ASCII key, so reject anything
            # that can't be represented as one up front
            try:
                encryption_key_bytes = encryption_key.encode("ascii")

            except (AttributeError, UnicodeEncodeError):
                msg = (
                    "The Bark encryption key must contain only ASCII "
                    "characters."
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg) from None

            # AES-GCM only accepts 128/192/256-bit (16/24/32 byte) keys
            if len(encryption_key_bytes) not in BARK_AES_KEY_LENGTHS:
                msg = (
                    "The Bark encryption key must contain exactly 16, 24, or "
                    "32 ASCII characters."
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)

            # Fail closed; never fall back to sending plaintext when the
            # caller asked for encryption but the library isn't available
            if not BARK_AESGCM_SUPPORT:
                msg = (
                    "Bark encryption requires the 'cryptography' package. "
                    "Install Apprise with the 'all-plugins' extra."
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)

            # We're ready to encrypt every outbound payload with this key
            self.encryption_key = encryption_key
            self._cipher = AESGCM(encryption_key_bytes)

        # Icon URL
        self.icon = icon if isinstance(icon, str) else None

        # Level
        self.level = (
            None
            if not level
            else next((f for f in BARK_LEVELS if f[0] == level[0]), None)
        )
        if level and not self.level:
            self.logger.warning(
                "The specified Bark level (%s) is not valid", level
            )

        return

    def send(self, body, title="", notify_type=NotifyType.INFO, **kwargs):
        """Perform Bark Notification."""

        # error tracking (used for function return)
        has_error = False

        if not self.targets:
            # We have nothing to notify; we're done
            self.logger.warning("There are no Bark devices to notify")
            return False

        # Prepare our headers
        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/json; charset=utf-8",
        }

        # Prepare our payload (sample below)
        # {
        #     "body": "Test Bark Server",
        #     "markdown": "# Markdown Content",
        #     "device_key": "nysrshcqielvoxsa",
        #     "title": "bleem",
        #     "category": "category",
        #     "sound": "minuet.caf",
        #     "badge": 1,
        #     "icon": "https://day.app/assets/images/avatar.jpg",
        #     "group": "test",
        #     "level": "active",
        #     "volume": 5,
        #     "call": 1,
        #     "url": "https://mritd.com"
        # }
        payload = {
            "title": title if title else self.app_desc,
        }

        if self.notify_format == NotifyFormat.MARKDOWN:
            payload["markdown"] = body
        else:
            payload["body"] = body

        # Acquire our image url if configured to do so
        image_url = (
            None if not self.include_image else self.image_url(notify_type)
        )

        # Use custom icon if provided, otherwise use default image
        if self.icon:
            payload["icon"] = self.icon
        elif image_url:
            payload["icon"] = image_url

        if self.sound:
            payload["sound"] = self.sound

        if self.click:
            payload["url"] = self.click

        if self.badge:
            payload["badge"] = self.badge

        if self.level:
            payload["level"] = self.level

        if self.category:
            payload["category"] = self.category

        if self.group:
            payload["group"] = self.group

        if self.volume:
            payload["volume"] = self.volume

        if self.call:
            payload["call"] = 1

        auth = None
        if self.user:
            auth = (self.user, self.password)

        # Create a copy of the targets
        targets = list(self.targets)

        while len(targets) > 0:
            # Retrieve our device key
            target = targets.pop()

            # Skip a target that already accepted this message so
            # a retry does not deliver it twice.
            if self.is_delivered(target):
                continue

            private_target = self.pprint(
                target,
                privacy=True,
                mode=PrivacyMode.Secret,
                safe="",
            )

            if self._cipher is not None:
                # Encrypt the payload; on success this replaces the
                # plaintext fields with a device_key/ciphertext/iv wire
                # payload for this target
                try:
                    ciphertext, iv = self._encrypt_payload(payload)
                    request_payload = {
                        "device_key": target,
                        "ciphertext": ciphertext,
                        "iv": iv,
                    }

                except Exception as e:
                    # Fail closed; never fall back to sending this
                    # target's notification as plaintext
                    self.logger.warning("Failed to encrypt Bark notification.")
                    self.logger.debug(
                        "Bark encryption failed with %s.", type(e).__name__
                    )
                    has_error = True
                    continue

            else:
                # Plaintext payload; just tag on this target's device key
                request_payload = {"device_key": target, **payload}

            self.logger.debug(
                "Bark POST URL:"
                f" {self.notify_url} "
                f"(cert_verify={self.verify_certificate!r}, "
                f"encrypted={self._cipher is not None!r})"
            )
            if self._cipher is None:
                # Never log ciphertext/iv; there's nothing readable in it
                self.logger.debug(f"Bark Payload: {request_payload!s}")

            # Always call throttle before any remote server i/o is made
            self.throttle()
            try:
                r = requests.post(
                    self.notify_url,
                    data=json.dumps(request_payload),
                    headers=headers,
                    auth=auth,
                    verify=self.verify_certificate,
                    timeout=self.request_timeout,
                    allow_redirects=self.redirects,
                )
                if r.status_code != requests.codes.ok:
                    # We had a problem
                    status_str = NotifyBark.http_response_code_lookup(
                        r.status_code
                    )

                    self.logger.warning(
                        "Failed to send Bark notification to {}: "
                        "{}{}error={}.".format(
                            private_target,
                            status_str,
                            ", " if status_str else "",
                            r.status_code,
                        )
                    )

                    if self._cipher is None:
                        # The response body is only safe to log when we
                        # sent a plaintext request in the first place
                        self.logger.debug(
                            "Response Details:\r\n%r",
                            (r.content or b"")[:2000],
                        )

                    # Mark our failure
                    has_error = True
                    continue

                else:
                    self.logger.info(
                        f"Sent Bark notification to {private_target}."
                    )

            except requests.RequestException as e:
                self.logger.warning(
                    "A Connection error occurred sending Bark "
                    f"notification to {private_target}."
                )
                if self._cipher is None:
                    # Suppress low-level exception text once encryption
                    # is active; it may echo back request fragments
                    self.logger.debug(f"Socket Exception: {e!s}")

                # Mark our failure
                has_error = True
                continue

            # Delivered; a retry can safely skip this target.
            self.mark_delivered(target)

        return not has_error

    def _encrypt_payload(self, payload):
        """Encrypt one Bark parameter object with a fresh AES-GCM IV."""

        # Generate a fresh IV for every request; Bark's client rebuilds
        # this string as raw bytes, so it must land on exactly 12 ASCII
        # characters (a 96-bit GCM nonce)
        iv = secrets.token_urlsafe(BARK_GCM_IV_RANDOM_BYTES)
        if len(iv) != BARK_GCM_IV_LENGTH or not iv.isascii():
            raise ApprisePluginException(
                "Bark generated an incompatible AES-GCM IV"
            )

        # Bark decrypts a compact JSON object back into its parameters
        plaintext = json.dumps(
            payload,
            ensure_ascii=False,
            separators=(",", ":"),
        ).encode("utf-8")

        # No additional authenticated data; tag is appended to the
        # ciphertext automatically (GCM "combined" mode)
        ciphertext = self._cipher.encrypt(
            iv.encode("ascii"),
            plaintext,
            None,
        )

        # Bark expects the ciphertext base64-encoded and the IV as-is
        return base64.b64encode(ciphertext).decode("ascii"), iv

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (
            self.secure_protocol if self.secure else self.protocol,
            self.user,
            self.password,
            self.host,
            self.port,
            self.encryption_key,
        )

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "image": "yes" if self.include_image else "no",
        }

        if self.sound:
            params["sound"] = self.sound

        if self.click:
            params["click"] = self.click

        if self.badge:
            params["badge"] = str(self.badge)

        if self.level:
            params["level"] = self.level

        if self.volume:
            params["volume"] = str(self.volume)

        if self.category:
            params["category"] = self.category

        if self.group:
            params["group"] = self.group

        if self.icon:
            params["icon"] = self.icon

        if self.call:
            params["call"] = "yes"

        if self.encryption_key:
            params["key"] = self.pprint(
                self.encryption_key,
                privacy,
                mode=PrivacyMode.Secret,
                safe="",
            )

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        # Determine Authentication
        auth = ""
        if self.user and self.password:
            auth = "{user}:{password}@".format(
                user=NotifyBark.quote(self.user, safe=""),
                password=self.pprint(
                    self.password, privacy, mode=PrivacyMode.Secret, safe=""
                ),
            )
        elif self.user:
            auth = "{user}@".format(
                user=NotifyBark.quote(self.user, safe=""),
            )

        default_port = 443 if self.secure else 80
        return "{schema}://{auth}{hostname}{port}/{targets}?{params}".format(
            schema=self.secure_protocol if self.secure else self.protocol,
            auth=auth,
            # never encode hostname since we're expecting it to be a valid one
            hostname=self.host,
            port=(
                ""
                if self.port is None or self.port == default_port
                else f":{self.port}"
            ),
            targets="/".join(
                [
                    self.pprint(
                        f"{x}",
                        privacy,
                        mode=PrivacyMode.Secret,
                        safe="",
                    )
                    for x in self.targets
                ]
            ),
            params=NotifyBark.urlencode(params),
        )

    def __len__(self):
        """Returns the number of targets associated with this notification."""
        return len(self.targets)

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""

        results = NotifyBase.parse_url(url)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # Apply our targets
        results["targets"] = NotifyBark.split_path(results["fullpath"])

        # Category
        if "category" in results["qsd"] and results["qsd"]["category"]:
            results["category"] = NotifyBark.unquote(
                results["qsd"]["category"].strip()
            )

        # Group
        if "group" in results["qsd"] and results["qsd"]["group"]:
            results["group"] = NotifyBark.unquote(
                results["qsd"]["group"].strip()
            )

        # Badge
        if "badge" in results["qsd"] and results["qsd"]["badge"]:
            results["badge"] = NotifyBark.unquote(
                results["qsd"]["badge"].strip()
            )

        # Volume
        if "volume" in results["qsd"] and results["qsd"]["volume"]:
            results["volume"] = NotifyBark.unquote(
                results["qsd"]["volume"].strip()
            )

        # Level
        if "level" in results["qsd"] and results["qsd"]["level"]:
            results["level"] = NotifyBark.unquote(
                results["qsd"]["level"].strip()
            )

        # Click (URL)
        if "click" in results["qsd"] and results["qsd"]["click"]:
            results["click"] = NotifyBark.unquote(
                results["qsd"]["click"].strip()
            )

        # Sound
        if "sound" in results["qsd"] and results["qsd"]["sound"]:
            results["sound"] = NotifyBark.unquote(
                results["qsd"]["sound"].strip()
            )

        # The 'to' makes it easier to use yaml configuration
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyBark.parse_list(results["qsd"]["to"])

        # use image= for consistency with the other plugins
        results["include_image"] = parse_bool(
            results["qsd"].get("image", True)
        )

        # Icon URL
        if "icon" in results["qsd"] and results["qsd"]["icon"]:
            results["icon"] = NotifyBark.unquote(
                results["qsd"]["icon"].strip()
            )

        # Call
        results["call"] = parse_bool(results["qsd"].get("call", False))

        # Encryption Key
        if "key" in results["qsd"] and results["qsd"]["key"]:
            results["encryption_key"] = NotifyBark.unquote(
                results["qsd"]["key"]
            )

        return results

    @staticmethod
    def runtime_deps():
        """Return optional runtime dependency package names."""
        return ("cryptography",)
caronc-apprise-dfec414/apprise/plugins/base.py000066400000000000000000002203241526720371000215320ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import asyncio
from collections.abc import Generator
import contextlib
import contextvars
from datetime import tzinfo
from functools import partial
import math
import re
import time
from typing import Any, ClassVar, Optional, TypedDict, Union
from zoneinfo import ZoneInfo

from ..apprise_attachment import AppriseAttachment
from ..common import (
    APPRISE_MAX_SERVICE_RETRY,
    APPRISE_MAX_SERVICE_WAIT,
    NOTIFY_FORMATS,
    OVERFLOW_MODES,
    NotifyFormat,
    NotifyImageSize,
    NotifyType,
    OverflowMode,
    PersistentStoreMode,
)
from ..conversion import (
    commonmark_repair_chunk,
    convert_between,
    split_dialect_chunk,
    truncate_dialect_chunk,
)
from ..exception import AppriseImproperlyConfigured
from ..locale import Translatable, gettext_lazy as _
from ..persistent_store import PersistentStore
from ..url import URLBase
from ..utils.format import smart_split
from ..utils.parse import parse_bool, parse_list
from ..utils.time import zoneinfo


class RequirementsSpec(TypedDict, total=False):
    """Defines our plugin requirements."""

    packages_required: Optional[Union[str, list[str]]]
    packages_recommended: Optional[Union[str, list[str]]]
    details: Optional[Translatable]


class _PayloadPrecappedToken:
    """Prove that ``Apprise.notify()`` capped the source before conversion.

    Only this token skips a second cap; truthy values from direct plugin
    callers do not bypass ``payload_max_size``.
    """


_PAYLOAD_PRECAPPED = _PayloadPrecappedToken()


# Remembers successful targets during retries. It remains unused when retries
# are disabled, preserving the original plugin behavior.
_delivery_tracker: contextvars.ContextVar[
    Optional[set[tuple[Optional[int], Any]]]
] = contextvars.ContextVar("apprise_delivery_tracker", default=None)

# Holds state that ``remember()`` and ``recall()`` share across attempts.
# It stays unset when retries are disabled because nothing will read it.
_delivery_memo: contextvars.ContextVar[Optional[dict[Any, Any]]] = (
    contextvars.ContextVar("apprise_delivery_memo", default=None)
)

# Identifies the current message piece so split messages are tracked one piece
# at a time.
_delivery_index: contextvars.ContextVar[int] = contextvars.ContextVar(
    "apprise_delivery_index", default=0
)

# Marks a whole message piece as accepted. A private object is used so it
# can never match a key a plugin tracks its own targets under.
_PIECE_DELIVERED = object()


class NotifyBase(URLBase):
    """This is the base class for all notification services."""

    # An internal flag used to test the state of the plugin. If set to
    # False, then the plugin is not used.  Plugins can disable themselves
    # due to enviroment issues (such as missing libraries, or platform
    # dependencies that are not present).  By default all plugins are
    # enabled.
    enabled = True

    @staticmethod
    def runtime_deps():
        """Return a tuple of top-level Python package names that this plugin
        imported as optional runtime dependencies.

        The plugin manager uses this to maintain a reference counter per
        library.  When every plugin that declared a given library is disabled,
        its counter reaches zero and the manager evicts the library from
        `sys.modules`, releasing the associated Python objects from memory.

        Names must be the importable top-level namespace - the same string you
        would pass to `import` - not the pip install name:

            ('paho',)        # paho-mqtt installs as 'paho'
            ('slixmpp',)
            ('cryptography',)

        Submodules are handled automatically; declaring the top-level name is
        sufficient.

        Override this in any plugin that conditionally imports a heavy optional
        library.  Return an empty tuple (the default) when the plugin has no
        optional dependencies that are worth evicting.
        """
        return ()

    @classmethod
    def enable(self):
        """Mark this plugin as enabled.

        This is the counterpart to :meth:`disable`.  Calling this restores the
        plugin to an active state so it will be used for notifications again.
        Note that if the plugin's runtime dependencies were evicted from memory
        by the plugin manager, re-enabling will restore the flag but the
        plugin may not function until the process is restarted.
        """
        self.enabled = True

    @classmethod
    def disable(self):
        """Mark this plugin as disabled.

        The plugin will not be used for notifications.  The plugin manager
        calls this when honouring `APPRISE_DENY_SERVICES` /
        `APPRISE_ALLOW_SERVICES` and uses the result of
        :method:`runtime_deps` to decrement its per-library reference counters,
        potentially evicting unused libraries from `sys.modules`.
        """
        self.enabled = False

    # The category allows for parent inheritance of this object to alter
    # this when it's function/use is intended to behave differently. The
    # following category types exist:
    #
    #  native: Is a native plugin written/stored in `apprise/plugins/Notify*`
    #  custom: Is a custom plugin written/stored in a users plugin directory
    #          that they loaded at execution time.
    category = "native"

    # Some plugins may require additional packages above what is provided
    # already by Apprise.
    #
    # Use this section to relay this information to the users of the script to
    # help guide them with what they need to know if they plan on using your
    # plugin.   The below configuration should otherwise accommodate all normal
    # situations and will not requrie any updating:
    requirements: ClassVar[RequirementsSpec] = {
        # Use the description to provide a human interpretable description of
        # what is required to make the plugin work. This is only nessisary
        # if there are package dependencies.  Setting this to default will
        # cause a general response to be returned.  Only set this if you plan
        # on over-riding the default.  Always consider language support here.
        # So before providing a value do the following in your code base:
        #
        #  from apprise.AppriseLocale import gettext_lazy as _
        #
        # 'details': _('My detailed requirements')
        "details": None,
        # Define any required packages needed for the plugin to run.  This is
        # an array of strings that simply look like lines residing in a
        # `requirements.txt` file...
        #
        # As an example, an entry may look like:
        # 'packages_required': [
        #   'cryptography < 3.4`,
        # ]
        "packages_required": [],
        # Recommended packages identify packages that are not required to make
        # your plugin work, but would improve it's use or grant it access to
        # full functionality (that might otherwise be limited).
        # Similar to `packages_required`, you would identify each entry in
        # the array as you would in a `requirements.txt` file.
        #
        #   - Do not re-provide entries already in the `packages_required`
        "packages_recommended": [],
    }

    # The services URL
    service_url = None

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = None

    # Most Servers do not like more then 1 request per 5 seconds, so 5.5 gives
    # us a safe play range. Override the one defined already in the URLBase
    request_rate_per_sec = 5.5

    # Allows the user to specify the NotifyImageSize object
    image_size = None

    # The maximum allowable characters allowed in the body per message
    body_maxlen = 32768

    # Defines the maximum allowable characters in the title; set this to zero
    # if a title can't be used. Titles that are not used but are defined are
    # automatically placed into the body
    title_maxlen = 250

    # Set the maximum line count; if this is set to anything larger then zero
    # the message (prior to it being sent) will be truncated to this number
    # of lines. Setting this to zero disables this feature.
    body_max_line_count = 0

    # Persistent storage default settings
    persistent_storage = True

    # Timezone Default; by setting it to None, the timezone detected
    # on the server is used
    timezone = None

    # Default Notify Format
    notify_format = NotifyFormat.TEXT

    # Default Overflow Mode
    overflow_mode = OverflowMode.UPSTREAM

    # Our default is to no not use persistent storage beyond in-memory
    # reference
    storage_mode = PersistentStoreMode.MEMORY

    # Default Emoji Interpretation
    interpret_emojis = False

    # Default retry count for failed notifications.  Plugins may override
    # via ?retry=N in their URL; the asset's default_service_retry is used
    # when no per-plugin value is set.
    # Always in [0, APPRISE_MAX_SERVICE_RETRY].
    service_retry = 0

    # Default wait (seconds) between retry attempts.  Plugins may override
    # via ?wait=N in their URL; the asset's default_service_wait is used when
    # no per-plugin value is set.  Always in [0.0, APPRISE_MAX_SERVICE_WAIT].
    service_wait = 0.0

    # When set to True, a delivery failure for this individual service is
    # silently absorbed by all three dispatch paths (sequential, thread-pool,
    # and asyncio coroutine).  The overall notify() / async_notify() call
    # still returns True even if this particular endpoint could not be
    # reached, provided that every *required* (non-optional) service in
    # the same batch succeeded.
    #
    # This flag is designed for "nice to have" services -- endpoints that
    # you want to notify when they are available but whose unavailability
    # must not be treated as a delivery failure by the calling application.
    #
    # Concrete example -- four Kodi home screens tagged "media":
    #
    #   Configure every Kodi entry with optional=yes.  When the application
    #   calls notify(tag="media"), Apprise attempts delivery to whichever
    #   screens are currently powered on and reachable.  If none of the four
    #   respond (all are off or unreachable), the call still returns True
    #   because every failing service was optional.  The application is
    #   never penalised for transient screen availability.
    #
    # Important behaviour details:
    #   - Retries are still performed up to the configured retry count
    #     before a service is considered to have failed.  The optional flag
    #     only fires *after* all retry attempts have been exhausted without
    #     a successful delivery.  In other words, optional does not bypass
    #     the retry loop -- it only changes the meaning of the final result.
    #   - Setting optional=True does NOT skip the service.  Delivery is
    #     still attempted on every call.  Only the *outcome* is affected:
    #     a failure is reported as True instead of False to the caller.
    #   - A batch that mixes optional and required services returns False
    #     only if one of the *required* (optional=False) services fails.
    #     Optional failures are never included in the aggregate result.
    #   - The flag is per-instance.  Different URLs that share a tag can
    #     have different optional values, so you can mix required and
    #     optional endpoints within the same tag group.
    #
    # Ways to enable this flag:
    #   - URL query parameter  : append ?optional=yes  to the service URL
    #   - YAML configuration   : add  optional: yes    under the URL entry
    #   - Python constructor   : MyPlugin(host="...", optional=True)
    #   - Direct assignment    : server.optional = True
    #
    # Accepted truthy values  : "yes", "true", "on", "1", True
    # Accepted falsy  values  : "no", "false", "off", "0", False
    #
    # Defaults to False -- every delivery failure is propagated to the
    # caller unchanged.
    optional = False

    # Support Attachments; this defaults to being disabled.
    # Since apprise allows you to send attachments without a body or title
    # defined, by letting Apprise know the plugin won't support attachments
    # up front, it can quickly pass over and ignore calls to these end points.

    # You must set this to true if your application can handle attachments.
    # You must also consider a flow change to your notification if this is set
    # to True as well as now there will be cases where both the body and title
    # may not be set.  There will never be a case where a body, or attachment
    # isn't set in the same call to your notify() function.
    attachment_support = False

    # Default Title HTML Tagging
    # When a title is specified for a notification service that doesn't accept
    # titles, by default apprise tries to give a plesant view and convert the
    # title so that it can be placed into the body. The default is to just
    # use a  tag.  The below causes the title to get generated:
    default_html_tag_id = "b"

    # Here is where we define all of the arguments we accept on the url
    # such as: schema://whatever/?overflow=upstream&format=text
    # These act the same way as tokens except they are optional and/or
    # have default values set if mandatory. This rule must be followed
    template_args = dict(
        URLBase.template_args,
        **{
            "overflow": {
                "name": _("Overflow Mode"),
                "type": "choice:string",
                "values": OVERFLOW_MODES,
                # Provide a default
                "default": overflow_mode,
                # look up default using the following parent class value at
                # runtime. The variable name identified here (in this case
                # overflow_mode) is checked and it's result is placed over-top
                # of the 'default'. This is done because once a parent class
                # inherits this one, the overflow_mode already set as a default
                # 'could' be potentially over-ridden and changed to a different
                # value.
                "_lookup_default": "overflow_mode",
            },
            "format": {
                "name": _("Notify Format"),
                "type": "choice:string",
                # ?format= is accepted for any of the 3 values on every
                # plugin. Single-format plugins force the requested
                # value directly; multi-format plugins decide later
                # whether to honor it. plugins.details() exposes the
                # plugin's native subset through the additive
                # format.supported field.
                "values": NOTIFY_FORMATS,
                # Provide a default
                "default": notify_format,
                # look up default using the following parent class value at
                # runtime.
                "_lookup_default": "notify_format",
            },
            "emojis": {
                "name": _("Interpret Emojis"),
                # SSL Certificate Authority Verification
                "type": "bool",
                # Provide a default
                "default": interpret_emojis,
                # look up default using the following parent class value at
                # runtime.
                "_lookup_default": "interpret_emojis",
            },
            "store": {
                "name": _("Persistent Storage"),
                # Use Persistent Storage
                "type": "bool",
                # Provide a default
                "default": persistent_storage,
                # look up default using the following parent class value at
                # runtime.
                "_lookup_default": "persistent_storage",
            },
            "tz": {
                "name": _("Timezone"),
                "type": "string",
                # Provide a default
                "default": timezone,
                # look up default using the following parent class value at
                # runtime.
                "_lookup_default": "timezone",
            },
            "retry": {
                "name": _("Service Retry"),
                "type": "int",
                "min": 0,
                "max": APPRISE_MAX_SERVICE_RETRY,
                "default": service_retry,
                "_lookup_default": "service_retry",
            },
            "wait": {
                "name": _("Inter-Retry Wait"),
                "type": "float",
                "min": 0.0,
                "max": APPRISE_MAX_SERVICE_WAIT,
                "default": service_wait,
                "_lookup_default": "service_wait",
            },
            "optional": {
                "name": _("Optional Service"),
                "type": "bool",
                "default": optional,
                "_lookup_default": "optional",
            },
        },
    )

    #
    # Overflow Defaults / Configuration applicable to SPLIT mode only
    #

    # Display Count  [X/X]
    #               ^^^^^^
    #               \\\\\\
    #               6 characters (space + count)
    # Display Count  [XX/XX]
    #               ^^^^^^^^
    #               \\\\\\\\
    #               8 characters (space + count)
    # Display Count  [XXX/XXX]
    #               ^^^^^^^^^^
    #               \\\\\\\\\\
    #               10 characters (space + count)
    # Display Count  [XXXX/XXXX]
    #               ^^^^^^^^^^^^
    #               \\\\\\\\\\\\
    #               12 characters (space + count)
    #
    # Given the above + some buffer we come up with the following:
    # If this value is exceeded, display counts automatically shut off
    overflow_max_display_count_width = 12

    # The number of characters to reserver for whitespace buffering
    # This is detected automatically, but you can enforce a value if
    # you desire:
    overflow_buffer = 0

    # the min accepted length of a title to allow for a counter display
    overflow_display_count_threshold = 130

    # Whether or not when over-flow occurs, if the title should be repeated
    # each time the message is split up
    #   - None: Detect
    #   - True: Always display title once
    #   - False: Display the title for each occurance
    overflow_display_title_once = None

    # If this is set to to True:
    #   The title_maxlen should be considered as a subset of the body_maxlen
    #    Hence: len(title) + len(body) should never be greater then body_maxlen
    #
    # If set to False, then there is no corrorlation between title_maxlen
    #  restrictions and that of body_maxlen
    overflow_amalgamate_title = False

    # Identifies the timezone to use;  if this is not over-ridden, then the
    # timezone defined in the AppriseAsset() object is used instead.  The
    # Below is expected to be in a ZoneInfo type already.  You can have this
    # automatically initialized by specifying ?tz= on the Apprise URLs
    __tzinfo = None

    @classmethod
    def __init_subclass__(cls, **kwargs):
        """Automatically wrap any __len__ defined on a subclass so that it
        multiplies its base target count by (retry + 1).

        This ensures every plugin's __len__ reflects the total number of
        transmission attempts (targets * retry-factor) without requiring
        each plugin to be updated individually.
        """
        super().__init_subclass__(**kwargs)
        if "__len__" in cls.__dict__:
            _orig = cls.__dict__["__len__"]

            def _retry_aware_len(self, _orig=_orig):
                return _orig(self) * (getattr(self, "retry", 0) + 1)

            cls.__len__ = _retry_aware_len

    def __init__(self, **kwargs):
        """Initialize some general configuration that will keep things
        consistent when working with the notifiers that will inherit this
        class."""

        super().__init__(**kwargs)

        # Initialize retry count from (in priority order):
        #   1. kwargs["retry"]  (from ?retry= URL param or YAML retry: key)
        #   2. asset.default_service_retry
        # Always clamped to [0, APPRISE_MAX_SERVICE_RETRY].
        _retry_raw = kwargs.get("retry")
        if _retry_raw is not None:
            try:
                _retry_val = int(_retry_raw)
                if _retry_val < 0:
                    msg = f"Service retry count must be >= 0; got {_retry_raw}"
                    self.logger.warning(msg)
                    raise AppriseImproperlyConfigured(msg)
                self.retry = min(_retry_val, APPRISE_MAX_SERVICE_RETRY)
            except (TypeError, ValueError):
                self.logger.warning(
                    "Invalid retry value specified (%s); using default",
                    _retry_raw,
                )
                self.retry = min(
                    max(0, self.asset.default_service_retry),
                    APPRISE_MAX_SERVICE_RETRY,
                )
        else:
            self.retry = min(
                max(0, self.asset.default_service_retry),
                APPRISE_MAX_SERVICE_RETRY,
            )

        # Initialize wait (inter-retry delay) from (in priority order):
        #   1. kwargs["wait"]  (from ?wait= URL param or YAML wait: key)
        #   2. asset.default_service_wait
        # Only valid non-negative finite floats are accepted; integers are
        # promoted to float.  Invalid values fall back to the asset default.
        # Negative values are invalid and use the same fallback.
        _wait_raw = kwargs.get("wait")
        if _wait_raw is not None:
            try:
                _wait_val = float(_wait_raw)
                if not math.isfinite(_wait_val) or _wait_val < 0.0:
                    msg = f"Service retry wait must be >= 0; got {_wait_raw}"
                    self.logger.warning(msg)
                    raise AppriseImproperlyConfigured(msg)
                self.wait = min(_wait_val, APPRISE_MAX_SERVICE_WAIT)
            except (TypeError, ValueError):
                self.logger.warning(
                    "Invalid wait value specified (%s); using default",
                    _wait_raw,
                )
                self.wait = min(
                    max(0.0, self.asset.default_service_wait),
                    APPRISE_MAX_SERVICE_WAIT,
                )
        else:
            self.wait = min(
                max(0.0, self.asset.default_service_wait),
                APPRISE_MAX_SERVICE_WAIT,
            )

        # Initialize the optional= flag from kwargs if provided, otherwise
        # fall back to the class-level attribute (default: False).
        #
        # Priority order (highest to lowest):
        #   1. kwargs["optional"]  -- supplied via ?optional=yes/no URL
        #      parameter, YAML optional: yes/no key, or a direct Python
        #      keyword argument to the constructor.
        #   2. The class-level 'optional' attribute on the plugin class
        #      (or any of its superclasses).  Plugin authors can ship
        #      with optional=True as the default simply by overriding
        #      the class attribute -- no extra __init__ boilerplate needed.
        #
        # parse_bool() is used for the string -> bool conversion so that
        # all of the canonical truthy/falsy representations that Apprise
        # accepts elsewhere are valid here too: "yes"/"no", "true"/"false",
        # "on"/"off", "1"/"0", and native Python booleans.  The function
        # returns the 'default' argument (False) for unrecognised strings,
        # so garbage input silently falls back to the safe behaviour
        # (propagate failures) rather than raising an exception.
        _optional_raw = kwargs.get("optional")
        if _optional_raw is not None:
            # An explicit value was passed in -- parse it and store on
            # this instance, shadowing the class-level attribute only for
            # this particular service object.
            self.optional = parse_bool(_optional_raw)
        # else: kwargs did not include "optional".  Leave self.optional
        #   unset so that normal Python attribute lookup falls through to
        #   the class-level default (NotifyBase.optional = False, or the
        #   value set by a plugin subclass that overrides it).

        # Store our interpret_emoji's setting
        # If asset emoji value is set to a default of True and the user
        #   specifies it to be false, this is accepted and False over-rides.
        #
        # If asset emoji value is set to a default of None, a user may
        #   optionally over-ride this and set it to True from the Apprise
        #   URL. ?emojis=yes
        #
        # If asset emoji value is set to a default of False, then all emoji's
        # are turned off (no user over-rides allowed)
        #

        # Our Persistent Storage object is initialized on demand
        self.__store = None

        # Take a default
        self.interpret_emojis = self.asset.interpret_emojis
        if "emojis" in kwargs:
            # possibly over-ride default
            self.interpret_emojis = bool(
                self.interpret_emojis in (None, True)
                and parse_bool(
                    kwargs.get("emojis", False),
                    default=NotifyBase.template_args["emojis"]["default"],
                )
            )

        # Store an explicit ?format= request for multi-format plugins.
        # Those plugins keep their declared notify_format tuple intact,
        # then resolve the one active destination later for each send.
        # Single-format plugins still force self.notify_format directly,
        # preserving the established URL override behavior.
        self._format_override: Optional[NotifyFormat] = None

        if "format" in kwargs:
            value = kwargs["format"]
            try:
                requested = (
                    value
                    if isinstance(value, NotifyFormat)
                    else NotifyFormat(value.lower())
                )

            except (AttributeError, ValueError):
                err = (
                    f"An invalid notification format ({value}) was specified."
                )
                self.logger.warning(err)
                raise AppriseImproperlyConfigured(err) from None

            if len(self._formats()) == 1:
                # Single-format plugin: force the requested destination
                # directly onto self.notify_format.
                self.notify_format = requested

            else:
                # Multi-format plugin: remember the request and validate
                # it during per-send resolution.
                self._format_override = requested

        if "tz" in kwargs:
            value = kwargs["tz"]
            self.__tzinfo = zoneinfo(value)
            if not self.__tzinfo:
                err = (
                    "An invalid notification timezone "
                    f"({value}) was specified."
                )
                self.logger.warning(err)
                raise AppriseImproperlyConfigured(err) from None

        if "overflow" in kwargs:
            value = kwargs["overflow"]
            try:
                self.overflow_mode = (
                    value
                    if isinstance(value, OverflowMode)
                    else OverflowMode(value.lower())
                )

            except (AttributeError, ValueError):
                err = f"An invalid overflow method ({value}) was specified."
                self.logger.warning(err)
                raise AppriseImproperlyConfigured(err) from None

        # Prepare our Persistent Storage switch.  Turning it off keeps the
        # URL identifier working; it only stops anything being written to
        # disk for it (see the store property below).
        self.persistent_storage = parse_bool(
            kwargs.get("store", NotifyBase.persistent_storage)
        )

    def image_url(
        self,
        notify_type: NotifyType,
        image_size: Optional[NotifyImageSize] = None,
        logo: bool = False,
        extension: Optional[str] = None,
    ) -> Optional[str]:
        """Returns Image URL if possible."""

        image_size = self.image_size if image_size is None else image_size
        if not image_size:
            return None

        return self.asset.image_url(
            notify_type=notify_type,
            image_size=image_size,
            logo=logo,
            extension=extension,
        )

    def image_path(
        self,
        notify_type: NotifyType,
        extension: Optional[str] = None,
    ) -> Optional[str]:
        """Returns the path of the image if it can."""
        if not self.image_size:
            return None

        return self.asset.image_path(
            notify_type=notify_type,
            image_size=self.image_size,
            extension=extension,
        )

    def image_raw(
        self,
        notify_type: NotifyType,
        extension: Optional[str] = None,
    ) -> Optional[bytes]:
        """Returns the raw image if it can."""
        if not self.image_size:
            return None

        return self.asset.image_raw(
            notify_type=notify_type,
            image_size=self.image_size,
            extension=extension,
        )

    def color(
        self,
        notify_type: NotifyType,
        color_type: Optional[type] = None,
    ) -> Union[str, int, tuple[int, int, int]]:
        """Returns the html color (hex code) associated with the
        notify_type."""

        return self.asset.color(
            notify_type=notify_type,
            color_type=color_type,
        )

    def ascii(
        self,
        notify_type: NotifyType,
    ) -> str:
        """Returns the ascii characters associated with the notify_type."""

        return self.asset.ascii(
            notify_type=notify_type,
        )

    def _formats(self) -> tuple[NotifyFormat, ...]:
        """Supported notify formats as a tuple.

        ``notify_format`` accepts one format or a list. The first entry is the
        default when no override or input format matches.
        """
        # Preserve declaration order because the first entry is the
        # default. parse_list() sorts alphabetically by default, which
        # would silently choose the wrong fallback format here.
        return tuple(
            NotifyFormat(f) for f in parse_list(self.notify_format, sort=False)
        )

    def resolve_format(
        self, body_format: Optional[Union[str, NotifyFormat]] = None
    ) -> NotifyFormat:
        """Resolve which format this send should actually render as.

        Resolution order:
        - A single-format plugin always uses its one declared format.
        - A multi-format plugin honors an explicit ?format= override,
          when that override is one of its declared formats.
        - Otherwise, if the caller's body_format matches a declared
          format, align to it directly (no conversion needed).
        - Otherwise, fall back to the plugin's default, formats[0].
        """
        formats = self._formats()
        if len(formats) == 1:
            return formats[0]

        if self._format_override is not None:
            if self._format_override in formats:
                return self._format_override

            # The requested destination is not one this plugin declared.
            # Fall through to input alignment/default instead of failing
            # delivery. The actual fallback (input alignment vs
            # formats[0]) is decided below, so it is not named here.
            if body_format is not None:
                self.logger.debug(
                    "%s does not support format %s; ignoring override.",
                    self.service_name,
                    self._format_override.value,
                )

        if body_format in formats:
            # body_format may arrive as a plain string (e.g. from the
            # CLI) rather than a NotifyFormat; normalize to the actual
            # matched member so callers can always rely on .value etc.
            return (
                body_format
                if isinstance(body_format, NotifyFormat)
                else NotifyFormat(body_format)
            )

        return formats[0]

    def is_delivered(self, key: Any, per_message: bool = False) -> bool:
        """Return whether ``key`` accepted the current message piece.

        Use a stable target identifier, such as a phone number, room ID,
        token, or email address. This always returns ``False`` when retries
        are disabled. Pair it with :meth:`mark_delivered`::

            for target in self.targets:
                if self.is_delivered(target):
                    continue

                if self._post(target, body):
                    self.mark_delivered(target)

        A long message is delivered in pieces, and each piece is tracked on
        its own. Set ``per_message`` for something sent once for the whole
        notification, such as an icon, so it is not repeated for every
        piece.
        """
        tracker = _delivery_tracker.get()
        # No tracker means retries are off; nothing has been recorded.
        if tracker is None:
            return False

        return self._slot(key, per_message) in tracker

    def mark_delivered(self, key: Any, per_message: bool = False) -> None:
        """Record a successful target for the current message piece.

        Call this only after the target accepts the message. A later retry
        can then skip it. See :meth:`is_delivered` for an example.

        Set ``per_message`` for something that belongs to the whole
        notification rather than one piece of it.
        """
        tracker = _delivery_tracker.get()
        if tracker is not None:
            tracker.add(self._slot(key, per_message))

    def remember(
        self, key: Any, value: Any, per_message: bool = False
    ) -> None:
        """Keep ``value`` available to later attempts of this notification.

        Values expire with the notification and are separate for each split
        piece. Set ``per_message`` to share one value across all pieces. With
        retries off, nothing is stored.
        """
        memo = _delivery_memo.get()
        # Without retries, no later attempt needs this value.
        if memo is not None:
            memo[self._slot(key, per_message)] = value

    def recall(
        self, key: Any, default: Any = None, per_message: bool = False
    ) -> Any:
        """Return what :meth:`remember` stored, else ``default``.

        An earlier attempt of this same notification is the only thing
        that can have stored it. Pass the same ``per_message`` that
        :meth:`remember` was given.
        """
        memo = _delivery_memo.get()
        # An absent memo reads the same way as one that was never written.
        if memo is None:
            return default

        return memo.get(self._slot(key, per_message), default)

    @staticmethod
    def _slot(key: Any, per_message: bool) -> tuple[Optional[int], Any]:
        """Return the entry ``key`` is recorded under.

        Split-message pieces use separate slots. ``per_message`` instead
        shares one slot across the notification. Including the type keeps
        look-alike values distinct, while ``repr`` supports container keys.
        """
        piece = None if per_message else _delivery_index.get()
        return (piece, (type(key), repr(key)))

    def _timed_send(self, **kwargs: Any) -> bool:
        """Send one prepared call and log its duration at DEBUG.

        Prefer a format-specific sender when available, otherwise use send().
        """
        # The format may arrive as a NotifyFormat, a plain string such as
        # "html", or None when a caller skipped it entirely.
        resolved = kwargs.get("body_format")
        fn = getattr(
            self, f"send_{getattr(resolved, 'value', resolved)}", None
        )
        send_fn = fn if callable(fn) else self.send

        # Track each piece of a split message separately.
        index_token = _delivery_index.set(kwargs.get("index", 0))

        send_start = time.monotonic()
        try:
            # A retry does not send a piece that was already accepted.
            if self.is_delivered(_PIECE_DELIVERED):
                self.logger.debug(
                    "%s already accepted this message piece; skipping.",
                    self.service_name,
                )
                return True

            result = send_fn(**kwargs)
            if result:
                # Remember the accepted piece so a retry can skip it.
                self.mark_delivered(_PIECE_DELIVERED)

        finally:
            # Always restore the previous piece, even if send() raised.
            _delivery_index.reset(index_token)

        self.logger.debug(
            "%s send() completed in %.2fs.",
            self.service_name,
            time.monotonic() - send_start,
        )
        return result

    def notify(self, *args: Any, **kwargs: Any) -> bool:
        """Performs notification."""
        try:
            # Build a list of dictionaries that can be used to call send().
            send_calls = list(self._build_send_calls(*args, **kwargs))

        except TypeError:
            # Internal error
            return False

        else:
            # Loop through each call, one at a time. (Use a list rather than a
            # generator to call all the partials, even in case of a failure.)
            the_calls = [self._timed_send(**kwargs2) for kwargs2 in send_calls]
            return all(the_calls)

    async def async_notify(self, *args: Any, **kwargs: Any) -> bool:
        """Performs notification for asynchronous callers."""
        try:
            # Build a list of dictionaries that can be used to call send().
            send_calls = list(self._build_send_calls(*args, **kwargs))

        except TypeError:
            # Internal error
            return False

        else:
            # Deferred import to dodge a circular import (apprise.apprise
            # loads this module first). Fine by call time.
            from ..apprise import get_shared_executor

            # Use Apprise's own shared pool, not the loop's default one --
            # keeps a stuck send() from starving unrelated executor work.
            # TODO: let plugins supply a native async_send() instead.
            executor = get_shared_executor()

            async def do_send(**kwargs2):
                """Run one prepared send() call in the executor."""
                send = partial(self._timed_send, **kwargs2)
                # Copy the current logging details into the worker thread.
                ctx = contextvars.copy_context()
                # Submit directly so cancellation still leaves access to the
                # worker future. A running send cannot be interrupted, so its
                # future is needed until the background work finishes.
                cf_future = executor.submit(ctx.run, send)
                try:
                    result = await asyncio.wrap_future(cf_future)

                except asyncio.CancelledError:
                    # Cancellation stops waiting, but cannot stop a running
                    # function inside a worker thread.
                    if cf_future.running():
                        # Import here to avoid modules loading each other
                        # before they are ready.
                        from ..apprise import track_abandoned_future
                        from ..dispatch import service_metadata

                        # Keep a safe description until the worker finishes.
                        name, url, _, _, _ = service_metadata(self)
                        track_abandoned_future(cf_future, name, url)
                    # Let the caller continue handling the cancellation.
                    raise

                # Forward the normal send result to async_notify().
                return result

            # Await this plugin's pieces in order so split text and attachments
            # arrive predictably. Services still run concurrently one level up,
            # and each blocking send remains in the shared executor.
            results = []
            for kwargs2 in send_calls:
                # Wait for each piece before starting the next one.
                results.append(await do_send(**kwargs2))
            # Every prepared piece must succeed for this service to succeed.
            return all(results)

    def _build_send_calls(
        self,
        body: Optional[str] = None,
        title: Optional[str] = None,
        notify_type: Union[str, NotifyType] = NotifyType.INFO,
        overflow: Optional[Union[str, OverflowMode]] = None,
        attach: Optional[Union[list[str], AppriseAttachment]] = None,
        body_format: Optional[Union[str, NotifyFormat]] = None,
        body_passthrough: Optional[bool] = None,
        _payload_precapped: object = None,
        **kwargs: Any,
    ) -> Generator[dict[str, Any], None, None]:
        """Prepare the arguments for each ``send()`` call.

        Parameters:
          - ``body`` and ``title`` provide the message content.
          - ``notify_type`` identifies the message severity.
          - ``overflow`` controls upstream, truncation, or splitting.
          - ``attach`` supplies one or more attachments.
          - ``body_format`` identifies the source or resolved format.
          - ``body_passthrough`` preserves content with no declared format.
          - ``_payload_precapped`` confirms Apprise already applied its cap.
          - Extra keyword arguments are accepted for caller compatibility.

        Yields one mapping per final ``send()`` call, including its zero-based
        ``index`` and the total number of calls.
        """

        # Normalization of notify_type before it ever reaches a plugin.
        if not isinstance(notify_type, NotifyType):
            with contextlib.suppress(AttributeError, ValueError):
                notify_type = NotifyType(notify_type.lower())

        # Direct plugin calls bypass Apprise's per-server resolution, so
        # resolve here and remember whether a source format was declared.
        # Keep the source format for conversion after size checks.
        source_format = None
        if body_passthrough is None:
            body_passthrough = body_format is None
            source_format = body_format
            body_format = self.resolve_format(body_format)

        if not self.enabled:
            # Deny notifications issued to services that are disabled
            msg = f"{self.service_name} is currently disabled on this system."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Prepare attachments if required
        if attach is not None and not isinstance(attach, AppriseAttachment):
            try:
                attach = AppriseAttachment(attach, asset=self.asset)

            except TypeError:
                # bad attachments
                raise

            # Handle situations where the body is None
            body = body if body else ""

        elif not (body or attach):
            # If there is not an attachment at the very least, a body must be
            # present
            msg = "No message body or attachment was specified."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        if not body and not self.attachment_support:
            # If no body was specified, then we know that an attachment
            # was.  This is logic checked earlier in the code.
            #
            # Knowing this, if the plugin itself doesn't support sending
            # attachments, there is nothing further to do here, just move
            # along.
            msg = (
                f"{self.service_name} does not support "
                "attachments; service skipped"
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Handle situations where the title is None
        title = title if title else ""

        if source_format is not None:
            # Cap direct-call source content before converting it to the
            # resolved format, matching Apprise.notify().
            title, body = self._enforce_payload_cap(title, body)
            _payload_precapped = _PAYLOAD_PRECAPPED

            # Convert our body
            body = convert_between(source_format, body_format, body)

            # A title is only converted when it is blended into the body
            if title and self.title_maxlen <= 0:
                title = convert_between(source_format, body_format, title)

        # Truncate mode keeps only the first of multiple attachments.
        # Prepare it once for all calls made by this service.
        overflow = self.overflow_mode if overflow is None else overflow
        if attach and len(attach) > 1 and overflow == OverflowMode.TRUNCATE:
            # Save the first attachment.
            attach_ = AppriseAttachment(attach[0], asset=self.asset)
        else:
            # Reuse the original attachment collection.
            attach_ = attach

        # Apply overflow and dialect resizing to every chunk first so plugins
        # receive the final call count before delivery begins.
        all_pieces = [
            self._apply_dialect_overflow(
                chunk, overflow, body_format, body_passthrough
            )
            for chunk in self._apply_overflow(
                body=body,
                title=title,
                overflow=overflow,
                body_format=body_format,
                body_passthrough=body_passthrough,
                _payload_precapped=_payload_precapped,
            )
        ]
        total = sum(len(pieces) for pieces in all_pieces)

        # Select one attachment-bearing call before split delivery begins.
        # This avoids duplicates and shared state during concurrent sends.
        attach_index = self._attachment_send_index(total) if attach_ else None

        # Track each call's position across all chunks so plugins can place
        # attachments relative to the first or last delivery.
        index = 0
        for pieces in all_pieces:
            for piece in pieces:
                # Send notification
                yield {
                    "body": piece["body"],
                    "title": piece["title"],
                    "notify_type": notify_type,
                    # Attach only on the one call chosen above; never repeat
                    # it across overflow chunks or dialect-split pieces.
                    "attach": attach_ if index == attach_index else None,
                    "body_format": body_format,
                    "body_passthrough": body_passthrough,
                    "index": index,
                    "total": total,
                }
                index += 1

    def _enforce_payload_cap(self, title: str, body: str) -> tuple[str, str]:
        """Apply the asset's payload_max_size to a title and body.

        Returns the (possibly trimmed) title and body, logging a warning
        when anything was removed.
        """
        original_len = len(title) + len(body)
        title, body = self.asset.enforce_payload_max_size(title, body)
        if len(title) + len(body) < original_len:
            self.logger.warning(
                "%s payload trimmed to stay within the configured "
                "payload_max_size of %d characters.",
                self.service_name,
                self.asset._payload_max_size,
            )

        return title, body

    def _attachment_send_index(self, total: int) -> int:
        """Return the flat call index that should carry an attachment.

        The default is the first call. Plugins may use ``total`` to select a
        later call when their delivery order requires it.
        """
        return 0

    def _apply_overflow(
        self,
        body: Optional[str],
        title: Optional[str] = None,
        overflow: Optional[Union[str, OverflowMode]] = None,
        body_format: Optional[NotifyFormat] = None,
        body_passthrough: Optional[bool] = None,
        _payload_precapped: object = None,
    ) -> list[dict[str, str]]:
        """Apply upstream, truncation, or split overflow rules.

        The title may be merged into the body when the service has no title
        field. ``body_format`` guides splitting and Markdown repair, while
        ``body_passthrough`` skips format conversion for an undeclared source.

        Returns one or more independently deliverable title/body mappings:
            [
                {
                    title: 'the title goes here',
                    body: 'the message body goes here',
                },
                {
                    title: 'the title goes here',
                    body: 'the continued message body goes here',
                },
            ]
        """
        response: list[dict[str, str]] = []

        # Tidy
        title = "" if not title else title.strip()
        body = "" if not body else body.rstrip()

        # Direct plugin calls still need the source-size cap. Only Apprise's
        # private token confirms it was already applied before conversion.
        if _payload_precapped is not _PAYLOAD_PRECAPPED:
            title, body = self._enforce_payload_cap(title, body)

        # Default overflow mode
        if overflow is None:
            overflow = self.overflow_mode

        if body_passthrough is None:
            body_passthrough = body_format is None
            body_format = self.resolve_format(body_format)

        # If the service does not support a title, amalgamate into body
        if self.title_maxlen <= 0 and len(title) > 0:
            if body_format == NotifyFormat.HTML:
                body = (
                    f"<{self.default_html_tag_id}>{title}"
                    f""
                    f"
    \r\n{body}"
                )

            elif body_format == NotifyFormat.MARKDOWN and not body_passthrough:
                # Declared Markdown/CommonMark can receive a heading.
                # Undeclared content uses the normal plain-text title layout.
                title = title.lstrip("\r\n \t\v\f#-")
                if title:
                    body = f"# {title}\n{body}"

            else:
                body = f"{title}\r\n{body}"

            title = ""

        # Enforce line count
        if self.body_max_line_count > 0:
            lines = re.split(r"\r*\n", body)
            body = "\r\n".join(lines[0 : self.body_max_line_count])

        # UPSTREAM mode: do not touch content
        if overflow == OverflowMode.UPSTREAM:
            response.append({"body": body, "title": title})
            return response

        # a value of '2' allows for the \r\n that is applied when amalgamating
        overflow_buffer = (
            max(2, self.overflow_buffer)
            if (self.title_maxlen == 0 and len(title))
            else self.overflow_buffer
        )

        #
        # TRUNCATE and SPLIT require sizing logic
        #

        # Handle situations where body and title are amalgamated
        title_maxlen = (
            self.title_maxlen
            if not self.overflow_amalgamate_title
            else min(
                len(title) + self.overflow_max_display_count_width,
                self.title_maxlen,
                self.body_maxlen,
            )
        )

        if len(title) > title_maxlen:
            # Truncate our title
            title = title[:title_maxlen].rstrip()

        # Compute body_maxlen as per legacy logic
        if (
            self.overflow_amalgamate_title
            and (self.body_maxlen - overflow_buffer) >= title_maxlen
        ):
            # status quo
            body_maxlen = (
                self.body_maxlen
                if not title
                else (self.body_maxlen - title_maxlen)
            ) - overflow_buffer
        else:
            # If the body fits, we're done
            body_maxlen = (
                self.body_maxlen
                if not self.overflow_amalgamate_title
                else (self.body_maxlen - overflow_buffer)
            )

        # If the body fits, we are done
        if body_maxlen > 0 and len(body) <= body_maxlen:
            response.append({"body": body, "title": title})
            return response

        # TRUNCATE mode: hard truncation (no smart-splitting)
        if overflow == OverflowMode.TRUNCATE:
            truncated = body[:body_maxlen].lstrip("\r\n\x0b\x0c").rstrip()
            if body_format == NotifyFormat.MARKDOWN and not body_passthrough:
                # An odd run of trailing backslashes means the last one
                # lost the character it escaped; drop it so it does not
                # dangle at the end of the message.
                if (len(truncated) - len(truncated.rstrip("\\"))) % 2:
                    truncated = truncated[:-1].rstrip()

                # Repair truncated constructs before dialect conversion.
                # Bounded discarded text can identify a possible closer.
                lookahead_end = body_maxlen + body_maxlen * 8
                lookahead = body[body_maxlen:lookahead_end]
                boundary_next_ch = (
                    body[lookahead_end : lookahead_end + 1] or None
                )
                truncated, _ = commonmark_repair_chunk(
                    truncated,
                    {},
                    next_chunk=lookahead or None,
                    next_chunk_boundary_ch=boundary_next_ch,
                )
            response.append({"body": truncated, "title": title})
            return response

        #
        # SPLIT mode
        #

        # Detect if we only display our title once or not (legacy logic)
        if self.overflow_display_title_once is None:
            # Detect if we only display our title once or not:
            overflow_display_title_once = bool(
                self.overflow_amalgamate_title
                and body_maxlen < self.overflow_display_count_threshold
            )
        else:
            overflow_display_title_once = self.overflow_display_title_once

        # SPLIT mode with repeated title (with/without counter)
        if not overflow_display_title_once and not (
            # edge case: amalgamated title but no body space
            self.overflow_amalgamate_title and body_maxlen <= 0
        ):
            # Decide whether to show a counter (legacy condition)
            show_counter = (
                title
                and len(body) > body_maxlen
                and (
                    (
                        self.overflow_amalgamate_title
                        and body_maxlen
                        >= self.overflow_display_count_threshold
                    )
                    or (
                        not self.overflow_amalgamate_title
                        and title_maxlen
                        > self.overflow_display_count_threshold
                    )
                )
                and (
                    title_maxlen
                    > (self.overflow_max_display_count_width + overflow_buffer)
                    and self.title_maxlen
                    >= self.overflow_display_count_threshold
                )
            )

            effective_body_maxlen = body_maxlen
            if show_counter:
                # introduce padding for the counter
                effective_body_maxlen -= overflow_buffer

            # Use smart splitting instead of naive slicing
            chunks = smart_split(
                body,
                effective_body_maxlen,
                body_format,
            )
            count = len(chunks)

            template = ""
            if show_counter:
                digits = len(str(count))
                overflow_display_count_width = 4 + (digits * 2)

                if (
                    overflow_display_count_width
                    <= self.overflow_max_display_count_width
                ):
                    # Truncate title further if needed to make room for counter
                    t_max = title_maxlen - overflow_display_count_width
                    if len(title) > t_max:
                        title = title[:t_max]
                    template = f" [{{:0{digits}d}}/{{:0{digits}d}}]"
                else:
                    # Too many messages; fall back to repeated title without
                    # counter displayed
                    show_counter = False

            response = []
            for idx, chunk_body in enumerate(chunks, start=1):
                suffix = template.format(idx, count) if show_counter else ""
                response.append(
                    {
                        "body": chunk_body.lstrip("\r\n\x0b\x0c").rstrip(),
                        "title": f"{title}{suffix}",
                        # Preserve this repeated title if dialect conversion
                        # splits the chunk again.
                        "repeat_title": True,
                    }
                )

        else:
            #
            # SPLIT mode, display title once and move on
            # (this covers both overflow_display_title_once=True
            #  and the edge case body_maxlen <= 0 with amalgamated title)
            #
            response = []
            consumed = 0
            remainder = body

            if body_maxlen > 0 and body:
                # First chunk uses body_maxlen (which already accounts for
                # the title)
                first_chunks = smart_split(
                    body,
                    body_maxlen,
                    body_format,
                )
                first_body = first_chunks[0] if first_chunks else ""
                consumed = len(first_body)
                remainder = body[consumed:]

                response.append(
                    {
                        "body": first_body.lstrip("\r\n\x0b\x0c").rstrip(),
                        "title": title,
                    }
                )

            else:
                # body_maxlen <= 0 or no body; send title only, still honouring
                # body
                response.append(
                    {
                        "body": "",
                        "title": title,
                    }
                )
                # remainder stays as full body; will be split below

            # Remaining chunks: no title, use the full body_maxlen of the
            # service
            if remainder:
                more_chunks = smart_split(
                    remainder,
                    self.body_maxlen,
                    body_format,
                )
                for chunk_body in more_chunks:
                    response.append(
                        {
                            "body": chunk_body.lstrip("\r\n\x0b\x0c").rstrip(),
                            "title": "",
                        }
                    )

        if body_format == NotifyFormat.MARKDOWN and not body_passthrough:
            # Repair chunks before dialect conversion. Raw lookahead classifies
            # a trailing delimiter against its real neighbor.
            pending = {}
            for idx, chunk in enumerate(response):
                next_body = (
                    response[idx + 1]["body"]
                    if idx + 1 < len(response)
                    else None
                )
                chunk["body"], pending = commonmark_repair_chunk(
                    chunk["body"], pending, next_chunk=next_body
                )

        return response

    def _apply_dialect_overflow(
        self,
        chunk: dict[str, str],
        overflow: Union[str, OverflowMode],
        body_format: Optional[NotifyFormat],
        body_passthrough: bool,
    ) -> list[dict[str, str]]:
        """Re-split or re-truncate one chunk after ``dialect_convert()``.

        Passthrough bodies and plugins without an override remain unchanged.
        The first piece keeps its title. Later pieces keep it only when the
        source chunk requested a repeated title.
        """
        has_dialect = (
            type(self).dialect_convert is not NotifyBase.dialect_convert
        )
        if not has_dialect or body_passthrough:
            return [chunk]

        def convert_fn(body: str) -> str:
            return self.dialect_convert(body, body_format)

        if overflow == OverflowMode.SPLIT:
            bodies = split_dialect_chunk(
                chunk["body"], self.body_maxlen, convert_fn, body_format
            )
        elif overflow == OverflowMode.TRUNCATE:
            bodies = [
                truncate_dialect_chunk(
                    chunk["body"], self.body_maxlen, convert_fn, body_format
                )
            ]
        else:
            # UPSTREAM: convert without splitting and let the service
            # itself handle an oversized payload.
            bodies = [convert_fn(chunk["body"])]

        # Repeated titles follow every new piece; one-time titles stay first.
        repeat_title = chunk.get("repeat_title", False)
        return [
            {
                "body": body,
                "title": chunk["title"] if (idx == 0 or repeat_title) else "",
            }
            for idx, body in enumerate(bodies)
        ]

    def dialect_convert(
        self,
        body: str,
        body_format: Optional[NotifyFormat] = None,
        *args: Any,
        **kwargs: Any,
    ) -> str:
        """Convert one chunk to the service's final markup dialect.

        Keep overrides stateless, accept ``*args, **kwargs``, and return
        unsupported formats unchanged. The framework reapplies size limits.
        """
        return body

    def send(
        self,
        body: str,
        title: str = "",
        notify_type: NotifyType = NotifyType.INFO,
        **kwargs: Any,
    ) -> bool:
        """Should preform the actual notification itself."""
        raise NotImplementedError(
            "send() is not implemented by the child class."
        )

    def __len__(self):
        """Returns the number of HTTP requests this instance will make,
        factoring in the configured retry count.

        Subclasses that override this are automatically wrapped by
        __init_subclass__ to apply the same retry multiplier, so they
        should return their raw target count without worrying about retry.
        """
        return self.retry + 1

    def url_parameters(
        self,
        *args: Any,
        **kwargs: Any,
    ) -> dict[str, Any]:
        """Provides a default set of parameters to work with.

        This can greatly simplify URL construction in the acommpanied url()
        function in all defined plugin services.
        """

        params = {"overflow": self.overflow_mode.value}

        # Single-format plugins always serialize their effective format.
        # Multi-format plugins only serialize format= when the user asked
        # for an explicit override. Omitting it keeps plain multi-format
        # URLs flexible on a round trip, so the next send can still align
        # to that call's body_format.
        formats = self._formats()
        if len(formats) == 1:
            params["format"] = formats[0].value
        elif self._format_override is not None:
            params["format"] = self._format_override.value

        # Timezone Information (if ZoneInfo)
        if self.__tzinfo and isinstance(self.__tzinfo, ZoneInfo):
            params["tz"] = self.__tzinfo.key

        # Persistent Storage Setting
        if self.persistent_storage != NotifyBase.persistent_storage:
            params["store"] = "yes" if self.persistent_storage else "no"

        # Always emit retry=, wait=, and optional= in the URL regardless
        # of whether they hold their zero/False defaults.  Emitting them
        # unconditionally keeps the URL fully self-describing: a service
        # URL that is round-tripped through parse_url() -> __init__() will
        # reconstruct an identical object with the same settings.  This
        # property is important for configuration-file generators, UI
        # tooling, and any code that serialises service objects to strings
        # and needs to restore them later without silent data loss.
        #
        # retry= and wait= are emitted as strings because URL query strings
        # are inherently text.  The receiving __init__() will re-parse them
        # with int() and float() respectively.
        #
        # optional= is emitted as the canonical lower-case pair "yes"/"no"
        # that parse_bool() recognises on the receiving end, ensuring the
        # round-trip is lossless even for the boolean case.
        params["retry"] = str(self.retry)
        params["wait"] = str(self.wait)
        params["optional"] = "yes" if self.optional else "no"

        params.update(super().url_parameters(*args, **kwargs))

        # return default parameters
        return params

    @staticmethod
    def parse_url(
        url: str,
        verify_host: bool = True,
        plus_to_space: bool = False,
    ) -> Optional[dict[str, Any]]:
        """Parses the URL and returns it broken apart into a dictionary.

        This is very specific and customized for Apprise.

        In addition to the fields extracted by URLBase.parse_url(), this
        method extracts the NotifyBase-level query-string parameters:
        ``format``, ``overflow``, ``emojis``, ``tz``, ``store``, ``retry``,
        ``wait``, and ``optional``.  The extracted values are placed
        directly in the returned results dict under their respective keys,
        ready to be consumed by NotifyBase.__init__() (or a subclass).
        Child classes should call this method via ``super()`` and then
        layer their own parameter extraction on top of the returned dict.

        Args:
            url (str): The URL you want to fully parse.
            verify_host (:obj:`bool`, optional): a flag kept with the parsed
                 URL which some child classes will later use to verify SSL
                 keys (if SSL transactions take place).  Unless under very
                 specific circumstances, it is strongly recomended that
                 you leave this default value set to True.

        Returns:
            A dictionary is returned containing the URL fully parsed if
            successful, otherwise None is returned.
        """
        results = URLBase.parse_url(
            url, verify_host=verify_host, plus_to_space=plus_to_space
        )

        if not results:
            # We're done; we failed to parse our url
            return results

        # Apply the query string options every notification supports
        return NotifyBase.parse_url_options(results)

    @staticmethod
    def parse_url_options(results: dict[str, Any]) -> dict[str, Any]:
        """Apply the query string options every notification supports.

        This reads ``format``, ``overflow``, ``emojis``, ``tz``, ``store``,
        ``retry``, ``wait`` and ``optional`` from ``results["qsd"]``.
        """
        if not isinstance(results.get("qsd"), dict):
            # There is no query string to read options from
            return results

        # Allow overriding the default format
        if "format" in results["qsd"]:
            results["format"] = results["qsd"].get("format", "").lower()
            if results["format"] not in NOTIFY_FORMATS:
                URLBase.logger.warning(
                    "Unsupported format specified %r",
                    results["qsd"]["format"],
                )
                del results["format"]

        # Allow overriding the default overflow
        if "overflow" in results["qsd"]:
            results["overflow"] = results["qsd"].get("overflow", "").lower()
            if results["overflow"] not in OVERFLOW_MODES:
                URLBase.logger.warning(
                    "Unsupported overflow mode specified "
                    f"{results['qsd']['overflow']!r}"
                )
                del results["overflow"]

        # Allow emoji's override
        if "emojis" in results["qsd"]:
            results["emojis"] = parse_bool(results["qsd"].get("emojis"))
            # Store our persistent storage boolean

        # Allow overriding the default timezone
        if "tz" in results["qsd"]:
            results["tz"] = results["qsd"].get("tz", "")

        if "store" in results["qsd"]:
            results["store"] = results["qsd"]["store"]

        # Global per-plugin retry count (?retry=N)
        if "retry" in results["qsd"] and results["qsd"]["retry"]:
            results["retry"] = results["qsd"]["retry"]

        # Global per-plugin inter-retry wait (?wait=N)
        if "wait" in results["qsd"] and results["qsd"]["wait"]:
            results["wait"] = results["qsd"]["wait"]

        # Global optional flag (?optional=yes/no).
        #
        # parse_bool() converts the raw query-string value to a native
        # Python bool using Apprise's canonical truth table: "yes", "true",
        # "on", "1" -> True; "no", "false", "off", "0" -> False.
        # Unrecognised strings fall back to False (the safe default).
        #
        # The parsed bool is stored in results["optional"] so that
        # NotifyBase.__init__() receives a value it can pass straight
        # through parse_bool() again without loss (parse_bool(True) is
        # True and parse_bool(False) is False).
        #
        # When ?optional= is absent from the URL entirely, this block is
        # skipped and results["optional"] is never set.  NotifyBase.__init__
        # will then leave self.optional at its class-level default (False),
        # which means the absence of the parameter is indistinguishable from
        # passing ?optional=no -- both result in failures being propagated.
        if "optional" in results["qsd"]:
            results["optional"] = parse_bool(results["qsd"]["optional"])

        return results

    @staticmethod
    def parse_native_url(url: str) -> Optional[dict[str, Any]]:
        """This is a base class that can be optionally over-ridden by child
        classes who can build their Apprise URL based on the one provided by
        the notification service they choose to use.

        The intent of this is to make Apprise a little more userfriendly to
        people who aren't familiar with constructing URLs and wish to use the
        ones that were just provied by their notification serivice that they're
        using.

        This function will return None if the passed in URL can't be matched as
        belonging to the notification service. Otherwise this function should
        return the same set of results that parse_url() does.
        """
        return None

    @property
    def store(self):
        """Returns a pointer to our persistent store for use.

        The best use cases are:
         self.store.get('key')
         self.store.set('key', 'value')
         self.store.delete('key1', 'key2', ...)

        You can also access the keys this way:
         self.store['key']

        And clear them:
         del self.store['key']
        """
        if self.__store is None:
            # Initialize our persistent store for use.  With storage turned
            # off the store still works, it simply keeps everything in
            # memory so nothing is written to disk for this URL.
            self.__store = PersistentStore(
                namespace=self.url_id(),
                path=self.asset.storage_path,
                mode=(
                    self.asset.storage_mode
                    if self.persistent_storage
                    else PersistentStoreMode.MEMORY
                ),
            )

        return self.__store

    def flush_store(self) -> None:
        """Write this service's persistent store to disk if it was used."""
        if self.__store is not None:
            self.__store.flush()

    @property
    def tzinfo(self) -> tzinfo:
        """Returns our tzinfo file associated with this plugin if set
        otherwise the default timezone is returned.
        """
        return self.__tzinfo if self.__tzinfo else self.asset.tzinfo
caronc-apprise-dfec414/apprise/plugins/betterstack.py000066400000000000000000000442231526720371000231350ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.


# Better Stack offers two ways to receive notifications:
#
# Incidents (pages whoever is on-call):
#  1. Visit https://betterstack.com/settings/api-tokens/0 and pick your
#     team.
#  2. Copy (or create) a token in the "Uptime API tokens" section.
#  3. Better Stack needs the e-mail of a user on your account to show
#     who requested the incident.
#
#  Your Apprise URL is assembled as:
#     betterstack://{token}/{email}
#
#  A global API token (https://betterstack.com/settings/global-api-tokens)
#  can raise an incident for any team.  List the teams after the e-mail:
#     betterstack://{token}/{email}/{team}/{team2}
#
# Logs (adds an entry to a log source):
#  1. Visit https://telemetry.betterstack.com/ and create (or open) a
#     log source of the type "HTTP".
#  2. Copy the "Source token" and the "Ingesting host" it shows you.
#
#  Your Apprise URL is assembled as:
#     betterstack://{source_token}@{ingesting_host}
#
# Resources:
# - https://betterstack.com/docs/uptime/api/create-a-new-incident/
# - https://betterstack.com/docs/logs/ingesting-data/http/logs/

from __future__ import annotations

from datetime import datetime, timezone
from json import dumps
from typing import Any, Optional, Union

import requests

from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..utils.parse import is_email, parse_list, validate_regex
from .base import NotifyBase

# Extend HTTP Error Messages
# Based on the response codes listed in the Better Stack API docs
BETTERSTACK_HTTP_ERROR_MAP = {
    402: "Quota or spending limit reached.",
    403: "Invalid source token.",
    404: "Authentication failed.",
    406: "Payload could not be parsed.",
    413: "Payload too large.",
}


class BetterStackMode:
    """Tracks the mode of operation for the Better Stack plugin."""

    # Create an incident that alerts the on-call person
    INCIDENT = "incident"

    # Add an entry to a log source
    LOGS = "logs"


# The ways Better Stack can alert the on-call person, mapped to the
# payload field that switches each one on
BETTERSTACK_ALERT_METHODS = {
    "call": "call",
    "sms": "sms",
    "email": "email",
    "push": "push",
    "critical": "critical_alert",
}

# Map Apprise notification types to Better Stack log levels
BETTERSTACK_LOG_LEVELS = {
    NotifyType.INFO: "info",
    NotifyType.SUCCESS: "info",
    NotifyType.WARNING: "warn",
    NotifyType.FAILURE: "error",
}


class NotifyBetterStack(NotifyBase):
    """A wrapper for Better Stack Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "Better Stack"

    # The services URL
    service_url = "https://betterstack.com/"

    # The default secure protocol
    secure_protocol = "betterstack"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/betterstack/"

    # Better Stack Incidents API URL
    incident_url = "https://incidents.betterstack.com/api/v3/incidents"

    # Define object URL templates
    templates = (
        # Incident mode
        "{schema}://{token}",
        "{schema}://{token}/{from_addr}",
        "{schema}://{token}/{targets}",
        "{schema}://{token}/{from_addr}/{targets}",
        # Logs mode
        "{schema}://{token}@{host}",
        "{schema}://{token}@{host}:{port}",
    )

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "token": {
                "name": _("Token"),
                "type": "string",
                "private": True,
                "required": True,
            },
            "host": {
                "name": _("Hostname"),
                "type": "string",
            },
            "port": {
                "name": _("Port"),
                "type": "int",
                "min": 1,
                "max": 65535,
            },
            "from_addr": {
                "name": _("From Email"),
                "type": "string",
            },
            "targets": {
                "name": _("Target Team"),
                "type": "list:string",
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "token": {
                "alias_of": "token",
            },
            "from": {
                "alias_of": "from_addr",
            },
            "to": {
                "alias_of": "targets",
            },
            "policy": {
                "name": _("Escalation Policy"),
                "type": "string",
            },
            "alert": {
                "name": _("Alert Methods"),
                "type": "list:string",
            },
            "team_wait": {
                "name": _("Team Wait"),
                "type": "int",
                "min": 0,
            },
        },
    )

    def __init__(
        self,
        token: str,
        from_addr: Optional[str] = None,
        targets: Optional[Union[str, list[str]]] = None,
        policy: Optional[str] = None,
        alert: Optional[Union[str, list[str]]] = None,
        team_wait: Optional[Union[int, str]] = None,
        **kwargs: Any,
    ) -> None:
        """Initialize Better Stack Object."""
        super().__init__(**kwargs)

        # An ingesting host is only given when sending logs
        self.mode = (
            BetterStackMode.LOGS if self.host else BetterStackMode.INCIDENT
        )

        # Our API or source token
        self.token = validate_regex(token)
        if not self.token:
            msg = "An invalid Better Stack token ({}) was specified.".format(
                token
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # The e-mail of the user requesting the incident
        self.from_addr = None
        if from_addr:
            result = is_email(from_addr)
            if not result:
                msg = (
                    "An invalid Better Stack From Email ({}) was "
                    "specified.".format(from_addr)
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)

            self.from_addr = result["full_email"]

        # The teams to raise an incident for.  Team names may hold spaces.
        self.targets = parse_list(targets, allow_whitespace=False)

        # The escalation policy to use
        self.policy = policy.strip() if policy else None

        # The alert methods to switch on.  None leaves the choice to the
        # Better Stack team settings.
        self.alert = None
        if alert:
            self.alert = []
            for method in parse_list(alert):
                method = method.lower()
                if method not in BETTERSTACK_ALERT_METHODS:
                    msg = (
                        "An invalid Better Stack alert method ({}) was "
                        "specified.".format(method)
                    )
                    self.logger.warning(msg)
                    raise AppriseImproperlyConfigured(msg)

                # Store each method only once
                if method not in self.alert:
                    self.alert.append(method)

        # Seconds to wait before escalating to the whole team
        self.team_wait = None
        if team_wait not in (None, ""):
            try:
                self.team_wait = int(team_wait)
                if self.team_wait < 0:
                    raise ValueError()

            except (TypeError, ValueError):
                msg = (
                    "An invalid Better Stack team wait ({}) was "
                    "specified.".format(team_wait)
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg) from None

    def send(
        self,
        body: str,
        title: str = "",
        notify_type: NotifyType = NotifyType.INFO,
        **kwargs: Any,
    ) -> bool:
        """Perform Better Stack Notification."""

        if self.mode == BetterStackMode.LOGS:
            # Prepare our log entry
            payload = {
                "dt": datetime.now(timezone.utc).isoformat(),
                "level": BETTERSTACK_LOG_LEVELS.get(notify_type, "info"),
                "message": body,
            }

            # Only include a title when one was given
            if title:
                payload["title"] = title

            # Prepare our URL
            url = "https://{host}{port}".format(
                host=self.host,
                port="" if self.port is None else ":{}".format(self.port),
            )

            return self._post(url, payload)

        # Prepare our incident payload
        payload = {
            "summary": title if title else body,
        }

        # The body becomes the full description when a title is used
        if title:
            payload["name"] = title
            payload["description"] = body

        if self.from_addr:
            payload["requester_email"] = self.from_addr

        if self.policy:
            payload["policy_id"] = self.policy

        if self.team_wait is not None:
            payload["team_wait"] = self.team_wait

        if self.alert is not None:
            # Switch on the methods asked for and switch off the rest
            for method, field in BETTERSTACK_ALERT_METHODS.items():
                payload[field] = method in self.alert

        # Without teams, the team that owns the token gets the incident
        has_error = False
        for team in self.targets if self.targets else [None]:
            # Skip a team that already has this incident so a retry
            # does not raise it twice
            if self.is_delivered(team):
                continue

            # Name the team that should own the incident
            if team:
                payload["team_name"] = team

            if not self._post(self.incident_url, payload):
                # Mark our failure
                has_error = True
                continue

            # Delivered, so a retry can safely skip this team
            self.mark_delivered(team)

        return not has_error

    def _post(self, url: str, payload: dict[str, Any]) -> bool:
        """Post ``payload`` to ``url`` and return whether it was accepted."""

        # Prepare our headers
        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/json",
            "Authorization": "Bearer {}".format(self.token),
        }

        self.logger.debug(
            "Better Stack POST URL: %s (cert_verify=%s)",
            url,
            self.verify_certificate,
        )
        self.logger.debug("Better Stack Payload: %s", payload)

        # Always call throttle before any remote server i/o is made
        self.throttle()

        try:
            r = requests.post(
                url,
                data=dumps(payload),
                headers=headers,
                verify=self.verify_certificate,
                timeout=self.request_timeout,
                allow_redirects=self.redirects,
            )
            if r.status_code not in (
                requests.codes.ok,
                requests.codes.created,
                requests.codes.accepted,
                requests.codes.no_content,
            ):
                # We had a problem
                status_str = NotifyBetterStack.http_response_code_lookup(
                    r.status_code, BETTERSTACK_HTTP_ERROR_MAP
                )

                self.logger.warning(
                    "Failed to send Better Stack %s: %s%serror=%s.",
                    self.mode,
                    status_str,
                    ", " if status_str else "",
                    r.status_code,
                )

                self.logger.debug("Response Details:\r\n%s", r.content)

                # Return; we're done
                return False

            self.logger.info("Sent Better Stack %s.", self.mode)

        except requests.RequestException as e:
            self.logger.warning(
                "A Connection error occurred sending Better Stack %s.",
                self.mode,
            )
            self.logger.debug("Socket Exception: %s", str(e))

            # Return; we're done
            return False

        return True

    @property
    def url_identifier(self) -> tuple[Any, ...]:
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (
            self.secure_protocol,
            self.mode,
            self.token,
            self.host,
            self.port if self.port else 443,
        )

    def url(self, privacy: bool = False, *args: Any, **kwargs: Any) -> str:
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {}

        if self.policy:
            params["policy"] = self.policy

        if self.alert is not None:
            params["alert"] = ",".join(self.alert)

        if self.team_wait is not None:
            params["team_wait"] = str(self.team_wait)

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        if self.mode == BetterStackMode.LOGS:
            return "{schema}://{token}@{host}{port}/?{params}".format(
                schema=self.secure_protocol,
                token=self.pprint(self.token, privacy, safe=""),
                host=self.host,
                port="" if self.port is None else ":{}".format(self.port),
                params=NotifyBetterStack.urlencode(params),
            )

        # Our requester e-mail (if any) leads the path, then our teams
        entries = [self.from_addr] if self.from_addr else []
        entries += self.targets

        return "{schema}://{token}/{entries}?{params}".format(
            schema=self.secure_protocol,
            token=self.pprint(self.token, privacy, safe=""),
            entries="".join(
                "{}/".format(NotifyBetterStack.quote(e, safe="@"))
                for e in entries
            ),
            params=NotifyBetterStack.urlencode(params),
        )

    def __len__(self) -> int:
        """Returns the number of targets associated with this notification."""
        # One incident is raised per team, and always at least one
        return (
            len(self.targets)
            if self.mode == BetterStackMode.INCIDENT and self.targets
            else 1
        )

    @staticmethod
    def parse_url(url: str) -> Optional[dict[str, Any]]:
        """Parses the URL and returns enough arguments that can allow us to
        re-instantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        if results.get("user"):
            # Logs mode keeps the source token in the user field
            results["token"] = NotifyBetterStack.unquote(results["user"])

        elif not ("token" in results["qsd"] and results["qsd"]["token"]):
            # Incident mode keeps the API token in the host field
            results["token"] = NotifyBetterStack.unquote(results["host"])
            results["host"] = None

        # Support ?token= for an easier yaml configuration
        if "token" in results["qsd"] and results["qsd"]["token"]:
            results["token"] = NotifyBetterStack.unquote(
                results["qsd"]["token"]
            )

        # Support ?from= for the requester e-mail
        if "from" in results["qsd"] and results["qsd"]["from"]:
            results["from_addr"] = NotifyBetterStack.unquote(
                results["qsd"]["from"]
            )

        # Our path holds an optional requester e-mail followed by teams
        results["targets"] = []
        for entry in NotifyBetterStack.split_path(results["fullpath"]):
            if not results.get("from_addr") and is_email(entry):
                # The first e-mail found is our requester
                results["from_addr"] = entry
                continue

            results["targets"].append(entry)

        # Support ?to= for teams
        if "to" in results["qsd"] and results["qsd"]["to"]:
            results["targets"] += NotifyBetterStack.parse_list(
                results["qsd"]["to"], allow_whitespace=False
            )

        if "policy" in results["qsd"] and results["qsd"]["policy"]:
            results["policy"] = NotifyBetterStack.unquote(
                results["qsd"]["policy"]
            )

        if "alert" in results["qsd"] and results["qsd"]["alert"]:
            results["alert"] = NotifyBetterStack.unquote(
                results["qsd"]["alert"]
            )

        if "team_wait" in results["qsd"] and results["qsd"]["team_wait"]:
            results["team_wait"] = NotifyBetterStack.unquote(
                results["qsd"]["team_wait"]
            )

        return results
caronc-apprise-dfec414/apprise/plugins/blink1.py000066400000000000000000000274031526720371000220030ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Sources:
# - https://blink1.thingm.com/
# - https://github.com/todbot/blink1-python
# - https://github.com/todbot/blink1/blob/main/docs/blink1-hid-commands.md

import time

from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from .base import NotifyBase

# Default our global support flag
NOTIFY_BLINK1_ENABLED = False

try:
    import hid as blink1_hid

    NOTIFY_BLINK1_ENABLED = True

except ImportError:
    # No problem -- hidapi is an optional dependency.  Users who wish to
    # use this plugin must install it:  pip install hidapi
    pass

#
# blink(1) USB HID constants
#

# USB vendor / product identifiers for all blink(1) revisions
BLINK1_VENDOR_ID = 0x27B8
BLINK1_PRODUCT_ID = 0x01ED

# HID report size (report ID byte + 8 payload bytes)
BLINK1_REPORT_ID = 0x01
BLINK1_REPORT_SIZE = 9

# Command byte: 'c' == fade to RGB with a time argument
BLINK1_CMD_FADE = ord("c")


class Blink1LED:
    """
    Defines the LED to focus on
    """

    ALL = 0
    FIRST = 1
    SECOND = 2


BLINK1_LED_CHOICES = {
    Blink1LED.ALL: "all",
    Blink1LED.FIRST: "1",
    Blink1LED.SECOND: "2",
}

# Maps inbound strings to Blink1LED constants; unknown values fall back to ALL
BLINK1_LED_MAP = {
    "0": Blink1LED.ALL,
    "all": Blink1LED.ALL,
    "a": Blink1LED.ALL,
    "1": Blink1LED.FIRST,
    "2": Blink1LED.SECOND,
}

# How long (ms) to hold the LED colour after the fade completes
BLINK1_DEFAULT_DURATION_MS = 5000
BLINK1_MIN_DURATION_MS = 0
BLINK1_MAX_DURATION_MS = 300000  # 5 minutes

# Fade transition time (ms); 0 = instant
BLINK1_DEFAULT_FADE_MS = 0
BLINK1_MIN_FADE_MS = 0
BLINK1_MAX_FADE_MS = 10000  # 10 seconds


def _blink1_fade_buf(red, green, blue, fade_ms, ledn):
    """Build the 9-byte HID feature-report buffer for a fade-to-RGB command.

    The blink(1) wire format (all values unsigned 8-bit unless noted):
      [0] REPORT_ID (0x01)
      [1] command 'c' (0x63)
      [2] red
      [3] green
      [4] blue
      [5] fade_time high byte  (fade_time = fade_ms // 10, 16-bit big-endian)
      [6] fade_time low byte
      [7] ledn (0=all, 1=LED1, 2=LED2)
      [8] 0x00 (padding)
    """
    fade_time = int(fade_ms) // 10
    th = (fade_time >> 8) & 0xFF
    tl = fade_time & 0xFF
    return [
        BLINK1_REPORT_ID,
        BLINK1_CMD_FADE,
        int(red),
        int(green),
        int(blue),
        th,
        tl,
        int(ledn),
        0x00,
    ]


class NotifyBlink1(NotifyBase):
    """A wrapper for blink(1) USB LED notifications.

    Colors are driven by Apprise's notification-type color map
    (info=blue, success=green, warning=yellow, failure=red).
    No external blink1 library is required; the USB HID wire protocol
    is implemented directly via the hidapi package.
    """

    # Set our global enabled flag
    enabled = NOTIFY_BLINK1_ENABLED

    requirements = {
        "packages_required": "hidapi",
    }

    # The default descriptive name associated with the notification
    service_name = _("blink(1)")

    # The services URL
    service_url = "https://blink1.thingm.com/"

    # The default protocol
    protocol = "blink1"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/blink1/"

    # blink(1) is a local USB device; a title field has no meaning here.
    title_maxlen = 0

    # No throttling needed for a local USB device
    request_rate_per_sec = 0

    # URL templates
    templates = (
        "{schema}://",
        "{schema}://{serial}/",
    )

    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "serial": {
                "name": _("Serial Number"),
                "type": "string",
            },
        },
    )

    template_args = dict(
        NotifyBase.template_args,
        **{
            "duration": {
                "name": _("Duration (ms)"),
                "type": "int",
                "min": BLINK1_MIN_DURATION_MS,
                "max": BLINK1_MAX_DURATION_MS,
                "default": BLINK1_DEFAULT_DURATION_MS,
            },
            "fade": {
                "name": _("Fade Time (ms)"),
                "type": "int",
                "min": BLINK1_MIN_FADE_MS,
                "max": BLINK1_MAX_FADE_MS,
                "default": BLINK1_DEFAULT_FADE_MS,
            },
            "ledn": {
                "name": _("LED Number"),
                "type": "choice:int",
                "values": BLINK1_LED_CHOICES,
                "default": Blink1LED.ALL,
            },
        },
    )

    def __init__(
        self,
        serial=None,
        duration=None,
        fade=None,
        ledn=None,
        **kwargs,
    ):
        """Initialize Blink1 Object."""

        super().__init__(**kwargs)

        # Device serial number; None means "first available device".
        # An underscore is accepted as a URL placeholder meaning "any".
        serial = serial.strip() if isinstance(serial, str) else None
        self.serial = serial if serial and serial != "_" else None

        # Duration (ms) to hold the LED colour before turning it off
        try:
            self.duration = int(
                BLINK1_DEFAULT_DURATION_MS if duration is None else duration
            )
            if not (
                BLINK1_MIN_DURATION_MS
                <= self.duration
                <= BLINK1_MAX_DURATION_MS
            ):
                raise AppriseImproperlyConfigured("out of range")

        except (TypeError, ValueError):
            msg = (
                f"blink(1) duration ({duration}) must be between"
                f" {BLINK1_MIN_DURATION_MS} and"
                f" {BLINK1_MAX_DURATION_MS} ms."
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg) from None

        # Fade transition time (ms)
        try:
            self.fade = int(BLINK1_DEFAULT_FADE_MS if fade is None else fade)
            if not (BLINK1_MIN_FADE_MS <= self.fade <= BLINK1_MAX_FADE_MS):
                raise AppriseImproperlyConfigured("out of range")

        except (TypeError, ValueError):
            msg = (
                f"blink(1) fade ({fade}) must be between"
                f" {BLINK1_MIN_FADE_MS} and {BLINK1_MAX_FADE_MS} ms."
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg) from None

        # LED selector; unrecognised values silently fall back to ALL
        self.ledn = (
            BLINK1_LED_MAP.get(str(ledn).lower(), Blink1LED.ALL)
            if ledn is not None
            else Blink1LED.ALL
        )

    def _open_device(self):
        """Open and return a hidapi device handle for the blink(1).

        Returns None and logs a warning when the device cannot be found.
        """
        try:
            dev = blink1_hid.device()
            dev.open(
                BLINK1_VENDOR_ID,
                BLINK1_PRODUCT_ID,
                self.serial,
            )
            return dev

        except OSError:
            msg = "Failed to open blink(1) device"
            if self.serial:
                msg += f" (serial={self.serial})"
            msg += "."
            self.logger.warning(msg)
            return None

    def _send_fade(self, dev, red, green, blue, fade_ms):
        """Send a single fade-to-RGB HID feature report.

        Returns True on success, False if the report could not be sent.
        """
        buf = _blink1_fade_buf(red, green, blue, fade_ms, self.ledn)
        try:
            rc = dev.send_feature_report(buf)

        except OSError as e:
            self.logger.warning("blink(1) HID write failed: %s", e)
            return False

        if rc != BLINK1_REPORT_SIZE:
            self.logger.warning(
                "blink(1) HID write returned %d (expected %d).",
                rc,
                BLINK1_REPORT_SIZE,
            )
            return False

        return True

    @property
    def url_identifier(self):
        """Returns all fields that uniquely identify this connection."""
        return (
            self.protocol,
            self.serial,
            self.ledn,
        )

    def send(self, body, title="", notify_type=NotifyType.INFO, **kwargs):
        """Perform blink(1) Notification."""

        # Resolve the RGB triple for this notification type
        r, g, b = self.color(notify_type=notify_type, color_type=tuple)

        dev = self._open_device()
        if dev is None:
            return False

        try:
            # Always throttle before any device I/O
            self.throttle()

            if not self._send_fade(dev, r, g, b, self.fade):
                return False

            # Hold for fade + duration, then switch off
            time.sleep((self.fade + self.duration) / 1000.0)

            # Turn off: instant fade to black
            if not self._send_fade(dev, 0, 0, 0, 0):
                return False

        finally:
            dev.close()

        self.logger.info("Sent blink(1) notification.")
        return True

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        params = {
            "duration": str(self.duration),
            "fade": str(self.fade),
            "ledn": str(self.ledn),
        }
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        serial = self.serial if self.serial else "_"
        return f"{self.protocol}://{serial}/?{NotifyBlink1.urlencode(params)}"

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments to re-instantiate."""

        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            return results

        # The hostname, when present, is the device serial number.
        # An underscore or empty value means "first available device".
        host = results.get("host", "")
        if host and host != "_":
            results["serial"] = NotifyBlink1.unquote(host)

        if results["qsd"].get("duration"):
            results["duration"] = NotifyBlink1.unquote(
                results["qsd"]["duration"]
            )

        if results["qsd"].get("fade"):
            results["fade"] = NotifyBlink1.unquote(results["qsd"]["fade"])

        if results["qsd"].get("ledn"):
            results["ledn"] = NotifyBlink1.unquote(results["qsd"]["ledn"])

        return results

    @staticmethod
    def runtime_deps():
        """Return optional runtime dependency package names."""
        return ("hid",)
caronc-apprise-dfec414/apprise/plugins/bluesky.py000066400000000000000000000624501526720371000223020ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# 1. Create a BlueSky account
# 2. Access Settings -> Privacy and Security
# 3. Generate an App Password.  Optionally grant yourself access to Direct
#    Messages if you want to be able to send them
# 4. Assemble your Apprise URL like:
#       bluesky://handle@you-token-here
#
from copy import deepcopy
from datetime import datetime, timedelta, timezone
import json
import re

import requests

from ..attachment.base import AttachBase
from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.http import is_secure_http_url, read_bounded_response
from .base import NotifyBase

# For parsing handles
HANDLE_HOST_PARSE_RE = re.compile(r"(?P[^.]+)\.+(?P.+)$")

IS_USER = re.compile(r"^\s*@?(?P[A-Z0-9_]+)(\.+(?P.+))?$", re.I)


class NotifyBlueSky(NotifyBase):
    """A wrapper for BlueSky Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "BlueSky"

    # The services URL
    service_url = "https://bluesky.us/"

    # Protocol
    secure_protocol = ("bsky", "bluesky")

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/bluesky/"

    # Support attachments
    attachment_support = True

    # XRPC Suffix URLs; Structured as:
    #  https://host/{suffix}

    # Taken right from google.auth.helpers:
    clock_skew = timedelta(seconds=10)

    # 1 hour in seconds (the lifetime of our token)
    access_token_lifetime_sec = timedelta(seconds=3600)

    # Detect your Decentralized Identitifer (DID), then you can get your Auth
    # Token.
    xrpc_suffix_did = "/xrpc/com.atproto.identity.resolveHandle"
    xrpc_suffix_session = "/xrpc/com.atproto.server.createSession"
    xrpc_suffix_record = "/xrpc/com.atproto.repo.createRecord"
    xrpc_suffix_blob = "/xrpc/com.atproto.repo.uploadBlob"
    plc_directory = "https://plc.directory/{did}"

    # BlueSky is kind enough to return how many more requests we're allowed to
    # continue to make within it's header response as:
    # RateLimit-Reset: The epoc time (in seconds) we can expect our
    #                   rate-limit to be reset.
    # RateLimit-Remaining: an integer identifying how many requests we're
    #                      still allow to make.
    request_rate_per_sec = 0

    # For Tracking Purposes
    ratelimit_reset = datetime.now(timezone.utc).replace(tzinfo=None)

    # Remaining messages
    ratelimit_remaining = 1

    # The default BlueSky host to use if one isn't specified
    bluesky_default_host = "bsky.social"

    # Identity and DID documents are small, so we cap what we will read
    # back from the servers that hand them to us.
    max_response_bytes = 1024 * 1024

    # Our message body size
    body_maxlen = 280

    # BlueSky does not support a title
    title_maxlen = 0

    # Define object templates
    templates = ("{schema}://{user}@{password}",)

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "user": {
                "name": _("Username"),
                "type": "string",
                "required": True,
            },
            "password": {
                "name": _("Password"),
                "type": "string",
                "private": True,
                "required": True,
            },
        },
    )

    def __init__(self, **kwargs):
        """Initialize BlueSky Object."""
        super().__init__(**kwargs)

        # Our access token
        self.__access_token = self.store.get("access_token")
        self.__refresh_token = None
        self.__access_token_expiry = datetime.now(timezone.utc)
        self.__endpoint = self.store.get("endpoint")

        if not self.user:
            msg = "A BlueSky UserID/Handle must be specified."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Set our default host
        self.host = self.bluesky_default_host
        self.__endpoint = (
            f"https://{self.host}" if not self.host else self.__endpoint
        )

        # Identify our Handle (if define)
        results = HANDLE_HOST_PARSE_RE.match(self.user)
        if results:
            self.user = results.group("handle").strip()
            self.host = results.group("host").strip()

        return

    def send(
        self,
        body,
        title="",
        notify_type=NotifyType.INFO,
        attach=None,
        **kwargs,
    ):
        """Perform BlueSky Notification."""

        if not self.__access_token and not self.login():
            # We failed to authenticate - we're done
            return False

        # Track our returning blob IDs as they're stored on the BlueSky server
        blobs = []

        if attach and self.attachment_support:
            url = f"{self.__endpoint}{self.xrpc_suffix_blob}"
            # We need to upload our payload first so that we can source it
            # in remaining messages
            for no, attachment in enumerate(attach, start=1):
                # Perform some simple error checking
                if not attachment:
                    # We could not access the attachment
                    self.logger.error(
                        "Could not access attachment"
                        f" {attachment.url(privacy=True)}."
                    )
                    return False

                if not re.match(r"^image/.*", attachment.mimetype, re.I):
                    # Only support images at this time
                    self.logger.warning(
                        "Ignoring unsupported BlueSky attachment"
                        f" {attachment.url(privacy=True)}."
                    )
                    continue

                self.logger.debug(
                    "Preparing BlueSky attachment"
                    f" {attachment.url(privacy=True)}"
                )

                # Upload our image and get our blob associated with it
                postokay, response = self._fetch(
                    url,
                    payload=attachment,
                )

                if not postokay:
                    # We can't post our attachment
                    return False

                # Prepare our filename
                filename = (
                    attachment.name if attachment.name else f"file{no:03}.dat"
                )

                if not (isinstance(response, dict) and response.get("blob")):
                    self.logger.debug(
                        "Could not attach the file to BlueSky: %s (mime=%s)",
                        filename,
                        attachment.mimetype,
                    )
                    continue

                blobs.append((response.get("blob"), filename))

        # Prepare our URL
        did, endpoint = self.get_identifier()
        url = f"{endpoint}{self.xrpc_suffix_record}"

        # prepare our batch of payloads to create
        payloads = []

        payload = {
            "collection": "app.bsky.feed.post",
            "repo": did,
            "record": {
                "text": body,
                # 'YYYY-mm-ddTHH:MM:SSZ'
                "createdAt": datetime.now(tz=timezone.utc).strftime("%FT%XZ"),
                "$type": "app.bsky.feed.post",
            },
        }

        if blobs:
            for no, blob in enumerate(blobs, start=1):
                # Deep copy so each post gets its own record; a shallow
                # copy would share one record between every post
                payload_ = deepcopy(payload)
                if no > 1:
                    #
                    # multiple instances
                    #
                    # 1. update createdAt time
                    # 2. Change text to identify image no
                    payload_["record"]["createdAt"] = datetime.now(
                        tz=timezone.utc
                    ).strftime("%FT%XZ")
                    payload_["record"]["text"] = f"{no:02d}/{len(blobs):02d}"

                payload_["record"]["embed"] = {
                    "images": [
                        {
                            "image": blob[0],
                            "alt": blob[1],
                        }
                    ],
                    "$type": "app.bsky.embed.images",
                }
                payloads.append(payload_)
        else:
            payloads.append(payload)

        for no, payload in enumerate(payloads, start=1):
            # Skip a post that was already created so a retry does not
            # publish it twice
            if self.is_delivered(no):
                continue

            # Send Login Information
            postokay, response = self._fetch(
                url,
                payload=json.dumps(payload),
            )
            if not postokay:
                # We failed
                # Bad responses look like:
                # {
                #   'error': 'InvalidRequest',
                #   'message': 'reason'
                # }
                return False

            # Posted; a retry can safely skip this post.
            self.mark_delivered(no)

        return True

    def get_identifier(self, user=None):
        """Performs a Decentralized User Lookup and returns the identifier."""

        if user is None:
            user = self.user

        user = f"{user}.{self.host}" if "." not in user else f"{user}"
        did_key = f"did.{user}"
        endpoint_key = f"endpoint.{user}"

        did = self.store.get(did_key)
        endpoint = self.store.get(endpoint_key)
        if did and endpoint:
            # Early return
            return did, endpoint

        # Step 1: Acquire DID from bsky.app
        url = f"https://public.api.bsky.app{self.xrpc_suffix_did}"
        params = {"handle": user}

        # Resolve the handle to a DID
        postokay, response = self._fetch(
            url,
            params=params,
            method="GET",
            # A public service; our token does not belong here
            auth=False,
            max_response_bytes=self.max_response_bytes,
        )

        if not postokay or not isinstance(response, dict):
            # We failed
            return (False, False)

        # Store our DID
        did = response.get("did")
        if not isinstance(did, str):
            self.logger.warning("An unparseable BlueSky DID was returned")
            return (False, False)

        # Step 2: Use DID to find the PDS
        if did.startswith("did:plc:"):
            did_url = self.plc_directory.format(did=did)

        elif did.startswith("did:web:"):
            # Convert to domain
            did_url = f"https://{did[8:]}/.well-known/did.json"

        else:
            self.logger.warning(
                f"Unknown BlueSky DID scheme detected in {did}"
            )
            return (False, False)

        # Acquire our DID document
        postokay, service_response = self._fetch(
            did_url,
            method="GET",
            # The document can live on any host at all
            auth=False,
            max_response_bytes=self.max_response_bytes,
        )
        if not postokay or not isinstance(service_response, dict):
            # We failed
            self.logger.warning(
                f"Could not fetch the DID document for {did}; "
                f"ensure {did_url} is available."
            )
            return (False, False)

        # Extract the list of services from the DID document.
        services = service_response.get("service")
        if not isinstance(services, list):
            services = []

        endpoint = next(
            (
                s.get("serviceEndpoint")
                for s in services
                if isinstance(s, dict)
                and s.get("type") == "AtprotoPersonalDataServer"
            ),
            None,
        )

        # Step 3: Send to correct endpoint
        if not is_secure_http_url(endpoint) or "?" in endpoint:
            self.logger.warning(
                "Failed to resolve a usable BlueSky PDS endpoint"
            )
            return (False, False)

        self.store.set(did_key, did)
        self.store.set(endpoint_key, endpoint)
        return (did, endpoint)

    def login(self):
        """A simple wrapper to authenticate with the BlueSky Server."""

        # Acquire our Decentralized Identitifer
        did, self.__endpoint = self.get_identifier(self.user)
        if not did:
            return False

        url = f"{self.__endpoint}{self.xrpc_suffix_session}"

        payload = {
            "identifier": did,
            "password": self.password,
        }

        # Send Login Information
        postokay, response = self._fetch(
            url,
            payload=json.dumps(payload),
            # Our password is in the payload above
            credentials=True,
            max_response_bytes=self.max_response_bytes,
        )

        # Our response object looks like this (content has been altered for
        # presentation purposes):
        # {
        #  'did': 'did:plc:ruk414jakghak402j1jqekj2',
        #  'didDoc': {
        #    '@context': [
        #      'https://www.w3.org/ns/did/v1',
        #      'https://w3id.org/security/multikey/v1',
        #      'https://w3id.org/security/suites/secp256k1-2019/v1'
        #    ],
        #    'id': 'did:plc:ruk414jakghak402j1jqekj2',
        #    'alsoKnownAs': ['at://apprise.bsky.social'],
        #    'verificationMethod': [
        #      {
        #        'id': 'did:plc:ruk414jakghak402j1jqekj2#atproto',
        #        'type': 'Multikey',
        #        'controller': 'did:plc:ruk414jakghak402j1jqekj2',
        #        'publicKeyMultibase' 'redacted'
        #      }
        #    ],
        #  'service': [
        #      {
        #        'id': '#atproto_pds',
        #        'type': 'AtprotoPersonalDataServer',
        #        'serviceEndpoint':
        #           'https://woodtuft.us-west.host.bsky.network'
        #      }
        #    ]
        #  },
        #  'handle': 'apprise.bsky.social',
        #  'email': 'whoami@gmail.com',
        #  'emailConfirmed': True,
        #  'emailAuthFactor': False,
        #  'accessJwt': 'redacted',
        #  'refreshJwt': 'redacted',
        #  'active': True,
        # }

        if not postokay or not response:
            # We failed
            return False

        # Acquire our Token
        self.__access_token = response.get("accessJwt")

        # Handle other optional arguments we can use
        self.__access_token_expiry = (
            self.access_token_lifetime_sec
            + datetime.now(timezone.utc)
            - self.clock_skew
        )

        # The Refresh Token
        self.__refresh_token = response.get("refreshJwt", self.__refresh_token)
        self.store.set(
            "access_token", self.__access_token, self.__access_token_expiry
        )
        self.store.set(
            "refresh_token", self.__refresh_token, self.__access_token_expiry
        )
        self.store.set("endpoint", self.__endpoint)

        self.logger.info(
            f"Authenticated to BlueSky as {self.user}.{self.host}"
        )
        return True

    def _loggable_content(self, body, credentials=False):
        """Return enough of a reply for a useful debug log entry.

        A reply to a request that carried our password is held back while
        secure logging is on.
        """
        if credentials and self.asset.secure_logging:
            return ""

        if not isinstance(body, (bytes, str)):
            # Nothing worth showing, and this is called while handling an
            # error, so it must not raise one of its own.
            return b""

        return body[:2000]

    def _fetch(
        self,
        url,
        payload=None,
        params=None,
        method="POST",
        content_type=None,
        credentials=False,
        auth=True,
        max_response_bytes=None,
    ):
        """Wrapper to BlueSky API requests object.

        Set ``credentials`` when the payload contains a password. This hides
        the payload from logs and prevents redirects to another server.

        Set ``auth`` to False for lookups made against somebody else's
        server, so our session token is not handed to them.

        Set ``max_response_bytes`` to discard replies larger than the limit.
        """

        # use what was specified, otherwise build headers dynamically
        headers = {
            "User-Agent": self.app_id,
            "Content-Type": (
                payload.mimetype
                if isinstance(payload, AttachBase)
                else (
                    "application/x-www-form-urlencoded; charset=utf-8"
                    if method == "GET"
                    else "application/json"
                )
            ),
        }

        if auth and self.__access_token:
            # Set our token
            headers["Authorization"] = f"Bearer {self.__access_token}"

        # Some Debug Logging
        self.logger.debug(
            f"BlueSky {method} URL:"
            f" {url} (cert_verify={self.verify_certificate})"
        )
        if credentials and self.asset.secure_logging:
            # Our login payload holds the account password.
            loggable_payload = ""

        elif isinstance(payload, AttachBase):
            loggable_payload = "attach: " + payload.name

        else:
            loggable_payload = str(payload)

        self.logger.debug("BlueSky Payload: %s", loggable_payload)

        # By default set wait to None
        wait = None

        if self.ratelimit_remaining == 0:
            # Determine how long we should wait for or if we should wait at
            # all. This isn't fool-proof because we can't be sure the client
            # time (calling this script) is completely synced up with the
            # Twitter server.  One would hope we're on NTP and our clocks are
            # the same allowing this to role smoothly:

            now = datetime.now(timezone.utc).replace(tzinfo=None)
            if now < self.ratelimit_reset:
                # We need to throttle for the difference in seconds
                # We add 0.3 seconds to the end just to allow a grace
                # period.
                wait = (self.ratelimit_reset - now).total_seconds() + 0.3

        # Always call throttle before any remote server i/o is made;
        self.throttle(wait=wait)

        # Initialize a default value for our content value
        content = {}

        # acquire our request mode
        fn = requests.post if method == "POST" else requests.get
        try:
            r = fn(
                url,
                data=(
                    payload
                    if not isinstance(payload, AttachBase)
                    else payload.open()
                ),
                params=params,
                headers=headers,
                verify=self.verify_certificate,
                timeout=self.request_timeout,
                # Never redirect a request carrying credentials
                allow_redirects=False if credentials else self.redirects,
                stream=max_response_bytes is not None,
            )

            if max_response_bytes is None:
                body = r.content

            else:
                body = read_bounded_response(r, max_response_bytes)
                if body is None:
                    self.logger.warning(
                        "BlueSky reply from %s passed %d bytes; discarding"
                        " it.",
                        url,
                        max_response_bytes,
                    )
                    return (False, {})

            # Get our JSON content if it's possible
            try:
                content = json.loads(body)

            except (
                AttributeError,
                RecursionError,
                TypeError,
                ValueError,
            ):
                # TypeError = body is not a String
                # ValueError = body is Unparsable
                # AttributeError = body is None
                # RecursionError = body is nested too deeply to parse
                content = {}
                self.logger.debug(
                    "Failed to parse BlueSky JSON response; body: %r",
                    self._loggable_content(body, credentials),
                )

            # Rate limit handling... our header objects at this point are:
            # 'RateLimit-Limit': '10',     # Total # of requests per hour
            # 'RateLimit-Remaining': '9',  # Requests remaining
            # 'RateLimit-Reset': '1741631362',  # Epoch Time
            # 'RateLimit-Policy': '10;w=86400' # NoEntries;w=
            try:
                # Capture rate limiting if possible
                self.ratelimit_remaining = int(
                    r.headers.get("ratelimit-remaining")
                )
                self.ratelimit_reset = datetime.fromtimestamp(
                    int(r.headers.get("ratelimit-reset")), timezone.utc
                ).replace(tzinfo=None)

            except (TypeError, ValueError):
                # This is returned if we could not retrieve this information
                # gracefully accept this state and move on
                pass

            if r.status_code != requests.codes.ok:
                # We had a problem
                status_str = NotifyBlueSky.http_response_code_lookup(
                    r.status_code
                )

                self.logger.warning(
                    "Failed to send BlueSky {} to {}: {}error={}.".format(
                        method, url, ", " if status_str else "", r.status_code
                    )
                )

                self.logger.debug(
                    "Response Details:\r\n%r",
                    self._loggable_content(body, credentials),
                )

                # Mark our failure
                return (False, content)

        except requests.RequestException as e:
            self.logger.warning(
                f"Exception received when sending BlueSky {method} to {url}: "
            )
            self.logger.debug(f"Socket Exception: {e!s}")

            # Mark our failure
            return (False, content)

        except OSError as e:
            self.logger.warning(
                "An I/O error occurred while handling {}.".format(
                    payload.name
                    if isinstance(payload, AttachBase)
                    else payload
                )
            )
            self.logger.debug(f"I/O Exception: {e!s}")
            return (False, content)

        return (True, content)

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (
            self.secure_protocol[0],
            self.user,
            self.password,
        )

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Apply our other parameters
        params = self.url_parameters(privacy=privacy, *args, **kwargs)

        user = self.user
        if self.host != self.bluesky_default_host:
            user += f".{self.host}"

        # our URL
        return "{schema}://{user}@{password}?{params}".format(
            schema=self.secure_protocol[0],
            user=NotifyBlueSky.quote(user, safe=""),
            password=self.pprint(
                self.password, privacy, mode=PrivacyMode.Secret, safe=""
            ),
            params=NotifyBlueSky.urlencode(params),
        )

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        if not results.get("password") and results["host"]:
            results["password"] = NotifyBlueSky.unquote(results["host"])

        # Do not use host field
        results["host"] = None
        return results
caronc-apprise-dfec414/apprise/plugins/brevo.py000066400000000000000000000503641526720371000217420ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# API Reference: https://developers.brevo.com/reference/getting-started-1

from json import dumps
import logging
from os.path import splitext

import requests

from .. import exception
from ..common import NotifyFormat, NotifyType
from ..conversion import convert_between
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..utils.parse import is_email, parse_list, validate_regex
from ..utils.sanitize import sanitize_payload
from .base import NotifyBase

# Extend HTTP Error Messages (most common Brevo SMTP errors)
BREVO_HTTP_ERROR_MAP = {
    400: "Bad Request - Invalid payload or missing parameters.",
    401: "Unauthorized - Invalid Brevo API key.",
    402: "Payment Required - Plan limitation or credit issue.",
    429: "Too Many Requests - Rate limit exceeded.",
}

# Comprehensive list of Brevo-supported extensions for Transactional Emails
# Source: Brevo API Documentation & Transactional Attachment Guidelines
BREVO_VALID_EXTENSIONS = (
    # Documents & Text
    "xlsx",
    "xls",
    "ods",
    "docx",
    "docm",
    "doc",
    "csv",
    "pdf",
    "txt",
    "rtf",
    "msg",
    "pub",
    "mobi",
    "ppt",
    "pptx",
    "eps",
    "odt",
    "ics",
    "xml",
    "css",
    "html",
    "htm",
    "shtml",
    # Images
    "gif",
    "jpg",
    "jpeg",
    "png",
    "tif",
    "tiff",
    "bmp",
    "cgm",
    # Archives
    "zip",
    "tar",
    "ez",
    "pkpass",
    # Audio
    "mp3",
    "m4a",
    "m4v",
    "wma",
    "ogg",
    "flac",
    "wav",
    "aif",
    "aifc",
    "aiff",
    # Video
    "mp4",
    "mov",
    "avi",
    "mkv",
    "mpeg",
    "mpg",
    "wmv",
)


class NotifyBrevo(NotifyBase):
    """A wrapper for Notify Brevo Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "Brevo"

    # The services URL
    service_url = "https://www.brevo.com/"

    # The default secure protocol
    secure_protocol = "brevo"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/brevo/"

    # Brevo can accept either HTML or plain text as the main message
    # body. HTML remains the default.
    notify_format = (NotifyFormat.HTML, NotifyFormat.TEXT)

    # The default Email API URL to use
    notify_url = "https://api.brevo.com/v3/smtp/email"

    # Support attachments
    attachment_support = True

    # Allow 300 requests per minute.
    # 60/300 = 0.2
    request_rate_per_sec = 0.2

    # The default subject to use if one isn't specified.
    default_empty_subject = ""

    # Define object templates
    templates = (
        "{schema}://{apikey}:{from_email}",
        "{schema}://{apikey}:{from_email}/{targets}",
    )

    # Define our template arguments
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "apikey": {
                "name": _("API Key"),
                "type": "string",
                "private": True,
                "required": True,
                "regex": (r"^[a-zA-Z0-9._-]+$", "i"),
            },
            "from_email": {
                "name": _("Source Email"),
                "type": "email",
                "required": True,
            },
            "target_email": {
                "name": _("Target Email"),
                "type": "email",
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "reply": {
                "name": _("Reply To Email"),
                "type": "string",
                "map_to": "reply_to",
            },
            "to": {
                "alias_of": "targets",
            },
            "cc": {
                "name": _("Carbon Copy"),
                "type": "list:string",
            },
            "bcc": {
                "name": _("Blind Carbon Copy"),
                "type": "list:string",
            },
        },
    )

    def __init__(
        self,
        apikey,
        from_email,
        targets=None,
        reply_to=None,
        cc=None,
        bcc=None,
        **kwargs,
    ):
        """Initialize Notify Brevo Object."""
        super().__init__(**kwargs)

        # API Key (associated with project)
        self.apikey = validate_regex(
            apikey, *self.template_tokens["apikey"]["regex"]
        )
        if not self.apikey:
            msg = f"An invalid Brevo API Key ({apikey}) was specified."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        result = is_email(from_email)
        if not result:
            msg = f"Invalid ~From~ email specified: {from_email}"
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Store email address
        self.from_email = result["full_email"]

        # Reply-to
        self.reply_to = None
        if reply_to:
            result = is_email(reply_to)
            if not result:
                msg = "An invalid Brevo Reply To ({}) was specified.".format(
                    f"{reply_to}"
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)

            self.reply_to = (
                result["name"] if result["name"] else False,
                result["full_email"],
            )

        # Acquire Targets (To Emails)
        self.targets = []

        # Acquire Carbon Copies
        self.cc = set()

        # Acquire Blind Carbon Copies
        self.bcc = set()

        # Validate recipients (to:) and drop bad ones:
        if targets:
            for recipient in parse_list(targets):
                result = is_email(recipient)
                if result:
                    self.targets.append(result["full_email"])
                    continue

                self.logger.warning(
                    f"Dropped invalid email ({recipient}) specified.",
                )
        else:
            # add ourselves
            self.targets.append(self.from_email)

        # Validate recipients (cc:) and drop bad ones:
        for recipient in parse_list(cc):
            result = is_email(recipient)
            if result:
                self.cc.add(result["full_email"])
                continue

            self.logger.warning(
                f"Dropped invalid Carbon Copy email ({recipient}) specified.",
            )

        # Validate recipients (bcc:) and drop bad ones:
        for recipient in parse_list(bcc):
            result = is_email(recipient)
            if result:
                self.bcc.add(result["full_email"])
                continue

            self.logger.warning(
                "Dropped invalid Blind Carbon Copy email "
                f"({recipient}) specified.",
            )

        return

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (self.secure_protocol, self.apikey, self.from_email)

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Our URL parameters
        params = self.url_parameters(privacy=privacy, *args, **kwargs)

        if len(self.cc) > 0:
            # Handle our Carbon Copy Addresses
            params["cc"] = ",".join(self.cc)

        if len(self.bcc) > 0:
            # Handle our Blind Carbon Copy Addresses
            params["bcc"] = ",".join(self.bcc)

        if self.reply_to:
            # Handle our reply to address
            params["reply"] = (
                "{} <{}>".format(*self.reply_to)
                if self.reply_to[0]
                else self.reply_to[1]
            )

        # a simple boolean check as to whether we display our target emails
        # or not
        has_targets = not (
            len(self.targets) == 1 and self.targets[0] == self.from_email
        )

        return "{schema}://{apikey}:{from_email}/{targets}?{params}".format(
            schema=self.secure_protocol,
            apikey=self.pprint(self.apikey, privacy, safe=""),
            # never encode email since it plays a huge role in our hostname
            from_email=self.from_email,
            targets=(
                ""
                if not has_targets
                else "/".join(
                    [NotifyBrevo.quote(x, safe="") for x in self.targets]
                )
            ),
            params=NotifyBrevo.urlencode(params),
        )

    def __len__(self):
        """Returns the number of targets associated with this notification."""
        return max(len(self.targets), 1)

    def send(
        self,
        body,
        title="",
        notify_type=NotifyType.INFO,
        attach=None,
        body_format=None,
        **kwargs,
    ):
        """Perform Brevo Notification."""

        if not self.targets:
            # There is no one to email; we're done
            self.logger.warning(
                "There are no Brevo email recipients to notify"
            )
            return False

        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/json",
            "Accept": "application/json",
            "api-key": self.apikey,
        }

        # error tracking (used for function return)
        has_error = False

        # A Simple Email Payload Template
        payload_ = {
            "sender": {
                "email": self.from_email,
            },
            # Placeholder, filled per target
            "to": [{"email": None}],
            "subject": title if title else self.default_empty_subject,
        }
        # Resolve the requested delivery representation for this send.
        # Brevo still wants both htmlContent and textContent, so the
        # resolved format decides which one is the original body and
        # which one is derived from it.
        use_html = self.resolve_format(body_format) == NotifyFormat.HTML

        if use_html:
            # HTML is the caller-selected representation; derive the
            # plain-text alternative for Brevo's companion field.
            payload_["htmlContent"] = body
            payload_["textContent"] = convert_between(
                NotifyFormat.HTML, NotifyFormat.TEXT, body
            )
        else:
            # Plain text is the caller-selected representation; derive
            # the HTML alternative so the payload remains complete.
            payload_["textContent"] = body
            payload_["htmlContent"] = convert_between(
                NotifyFormat.TEXT, NotifyFormat.HTML, body
            )

        if attach and self.attachment_support:
            attachments = []

            # Send our attachments
            for no, attachment in enumerate(attach, start=1):
                # Perform some simple error checking
                if not attachment:
                    # We could not access the attachment
                    self.logger.error(
                        "Could not access Brevo attachment"
                        f" {attachment.url(privacy=True)}."
                    )
                    return False

                # Brevo does not track content/mime type and relies 100%
                # entirely on the filename extension as to whether or not it
                # will accept it or not.
                #
                # The below prepares a safe_name (which can't be .dat like
                # other plugins since Brevo rejects that type). For this
                # reason .txt is chosen intentionally for this circumstance.

                # Use the attachment name if available, otherwise default to a
                # generic name
                raw_name = (
                    attachment.name if attachment.name else f"file{no:03}.txt"
                )

                # If the filename does NOT match a supported extension, append
                # .txt
                _, ext = splitext(raw_name)
                safe_name = (
                    f"{raw_name}.txt"
                    if (
                        not ext
                        or ext[1:].lower() not in BREVO_VALID_EXTENSIONS
                    )
                    else raw_name
                )

                try:
                    attachments.append(
                        {
                            "content": attachment.base64(),
                            "name": safe_name,
                        }
                    )

                except exception.AppriseException:
                    # We could not access the attachment
                    self.logger.error(
                        "Could not access Brevo attachment"
                        f" {attachment.url(privacy=True)}."
                    )
                    return False

                self.logger.debug(
                    "Appending Brevo attachment"
                    f" {attachment.url(privacy=True)}"
                )

            # Append our attachments to the payload
            payload_.update(
                {
                    "attachment": attachments,
                }
            )

        if self.reply_to:
            payload_["replyTo"] = {"email": self.reply_to[1]}

        targets = list(self.targets)
        while len(targets) > 0:
            target = targets.pop(0)

            # Skip a target that already accepted this message so
            # a retry does not deliver it twice.
            if self.is_delivered(target):
                continue

            # Create a copy of our template
            payload = payload_.copy()

            # the cc, bcc, to field must be unique or SendMail will fail, the
            # below code prepares this by ensuring the target isn't in the cc
            # list or bcc list. It also makes sure the cc list does not contain
            # any of the bcc entries
            cc = self.cc - self.bcc - {target}
            bcc = self.bcc - {target}

            # Set our main recipient
            payload["to"] = [{"email": target}]

            if len(cc):
                payload["cc"] = [{"email": email} for email in cc]

            if len(bcc):
                payload["bcc"] = [{"email": email} for email in bcc]

            # Some Debug Logging
            if self.logger.isEnabledFor(logging.DEBUG):
                # Due to attachments; output can be quite heavy and io
                # intensive.
                # To accommodate this, we only show our debug payload
                # information if required.
                self.logger.debug(
                    "Brevo POST URL:"
                    f" {self.notify_url} "
                    f"(cert_verify={self.verify_certificate!r})"
                )
                self.logger.debug(
                    "Brevo Payload: %s", sanitize_payload(payload)
                )

            # Always call throttle before any remote server i/o is made
            self.throttle()
            try:
                r = requests.post(
                    self.notify_url,
                    data=dumps(payload),
                    headers=headers,
                    verify=self.verify_certificate,
                    timeout=self.request_timeout,
                    allow_redirects=self.redirects,
                )
                if r.status_code not in (
                    requests.codes.ok,
                    requests.codes.accepted,
                    requests.codes.created,
                ):
                    # We had a problem
                    status_str = NotifyBrevo.http_response_code_lookup(
                        r.status_code, BREVO_HTTP_ERROR_MAP
                    )

                    self.logger.warning(
                        "Failed to send Brevo notification to {}: "
                        "{}{}error={}.".format(
                            target,
                            status_str,
                            ", " if status_str else "",
                            r.status_code,
                        )
                    )

                    self.logger.debug(
                        "Response Details:\r\n%r", (r.content or b"")[:2000]
                    )

                    # Mark our failure
                    has_error = True
                    continue

                else:
                    self.logger.info(f"Sent Brevo notification to {target}.")

            except requests.RequestException as e:
                self.logger.warning(
                    "A Connection error occurred sending Brevo "
                    f"notification to {target}."
                )
                self.logger.debug(f"Socket Exception: {e!s}")

                # Mark our failure
                has_error = True
                continue

            # Delivered; a retry can safely skip this target.
            self.mark_delivered(target)

        return not has_error

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""

        results = NotifyBase.parse_url(url)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # Our URL looks like this:
        #    {schema}://{apikey}:{from_email}/{targets}
        #
        # which actually equates to:
        #    {schema}://{user}:{password}@{host}/{email1}/{email2}/etc..
        #                 ^       ^         ^
        #                 |       |         |
        #              apikey     -from addr-

        if not results.get("user"):
            # An API Key as not properly specified
            return None

        if not results.get("password"):
            # A From Email was not correctly specified
            return None

        # Prepare our API Key
        results["apikey"] = NotifyBrevo.unquote(results["user"])

        # Prepare our From Email Address
        results["from_email"] = "{}@{}".format(
            NotifyBrevo.unquote(results["password"]),
            NotifyBrevo.unquote(results["host"]),
        )

        # Acquire our targets
        results["targets"] = NotifyBrevo.split_path(results["fullpath"])

        # The 'to' makes it easier to use yaml configuration
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyBrevo.parse_list(results["qsd"]["to"])

        # Handle Carbon Copy Addresses
        if "cc" in results["qsd"] and len(results["qsd"]["cc"]):
            results["cc"] = NotifyBrevo.parse_list(results["qsd"]["cc"])

        # Handle Blind Carbon Copy Addresses
        if "bcc" in results["qsd"] and len(results["qsd"]["bcc"]):
            results["bcc"] = NotifyBrevo.parse_list(results["qsd"]["bcc"])

        # Handle Reply To Address
        if "reply" in results["qsd"] and len(results["qsd"]["reply"]):
            results["reply_to"] = NotifyBrevo.unquote(results["qsd"]["reply"])

        return results
caronc-apprise-dfec414/apprise/plugins/bulksms.py000066400000000000000000000430141526720371000222770ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# To use this service you will need a BulkSMS account
# You will need credits (new accounts start with a few)
#     https://www.bulksms.com/account/
#
# BulkSMS signs you in with an API Token.  Create one under
# Settings > Developers > API Tokens; it gives you a Token ID and a
# Token Secret, used to build your Apprise URL:
#     bulksms://{token_id}:{token_secret}@{phone_no}
#
# The Token Secret can contain characters such as # that must be
# URL encoded (# becomes %23).
#
# API is documented here:
#   - https://www.bulksms.com/developer/json/v1/#tag/Message
from itertools import chain
import json
import re

import requests

from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import is_phone_no, parse_bool, parse_phone_no
from .base import NotifyBase

IS_GROUP_RE = re.compile(
    r"^(@?(?P[A-Z0-9_-]+))$",
    re.IGNORECASE,
)


class BulkSMSRoutingGroup:
    """The different categories of routing."""

    ECONOMY = "ECONOMY"
    STANDARD = "STANDARD"
    PREMIUM = "PREMIUM"


# Used for verification purposes
BULKSMS_ROUTING_GROUPS = (
    BulkSMSRoutingGroup.ECONOMY,
    BulkSMSRoutingGroup.STANDARD,
    BulkSMSRoutingGroup.PREMIUM,
)


class BulkSMSEncoding:
    """The different categories of routing."""

    TEXT = "TEXT"
    UNICODE = "UNICODE"
    BINARY = "BINARY"


class NotifyBulkSMS(NotifyBase):
    """A wrapper for BulkSMS Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "BulkSMS"

    # The services URL
    service_url = "https://bulksms.com/"

    # All notification requests are secure
    secure_protocol = "bulksms"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/bulksms/"

    # BulkSMS uses the http protocol with JSON requests
    notify_url = "https://api.bulksms.com/v1/messages"

    # The maximum length of the body
    body_maxlen = 160

    # The maximum amount of texts that can go out in one batch
    default_batch_size = 4000

    # A title can not be used for SMS Messages.  Setting this to zero will
    # cause any title (if defined) to get placed into the message body.
    title_maxlen = 0

    # Define object templates
    templates = ("{schema}://{token_id}:{token_secret}@{targets}",)

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "token_id": {
                "name": _("Token"),
                "type": "string",
                "required": True,
                "map_to": "user",
            },
            "token_secret": {
                "name": _("Secret"),
                "type": "string",
                "private": True,
                "required": True,
                "map_to": "password",
            },
            "target_phone": {
                "name": _("Target Phone No"),
                "type": "string",
                "prefix": "+",
                "regex": (r"^[0-9\s)(+-]+$", "i"),
                "map_to": "targets",
            },
            "target_group": {
                "name": _("Target Group"),
                "type": "string",
                "prefix": "@",
                "regex": (r"^[A-Z0-9 _-]+$", "i"),
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
                "required": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "from": {
                "name": _("From Phone No"),
                "type": "string",
                "regex": (r"^\+?[0-9\s)(+-]+$", "i"),
                "map_to": "source",
            },
            "route": {
                "name": _("Route Group"),
                "type": "choice:string",
                "values": BULKSMS_ROUTING_GROUPS,
                "default": BulkSMSRoutingGroup.STANDARD,
            },
            "unicode": {
                # Unicode characters
                "name": _("Unicode Characters"),
                "type": "bool",
                "default": True,
            },
            "to": {
                "alias_of": "targets",
            },
            "batch": {
                "name": _("Batch Mode"),
                "type": "bool",
                "default": False,
            },
        },
    )

    def __init__(
        self,
        source=None,
        targets=None,
        unicode=None,
        batch=None,
        route=None,
        **kwargs,
    ):
        """Initialize BulkSMS Object."""
        super().__init__(**kwargs)

        self.source = None
        if source:
            result = is_phone_no(source)
            if not result:
                msg = (
                    "The Account (From) Phone # specified "
                    f"({source}) is invalid."
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)

            # Tidy source
            self.source = "+{}".format(result["full"])

        # Setup our route
        self.route = (
            self.template_args["route"]["default"]
            if not isinstance(route, str)
            else route.upper()
        )
        if self.route not in BULKSMS_ROUTING_GROUPS:
            msg = f"The route specified ({route}) is invalid."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Define whether or not we should set the unicode flag
        self.unicode = (
            self.template_args["unicode"]["default"]
            if unicode is None
            else bool(unicode)
        )

        # Define whether or not we should operate in a batch mode
        self.batch = (
            self.template_args["batch"]["default"]
            if batch is None
            else bool(batch)
        )

        # Parse our targets
        self.targets = []
        self.groups = []

        for target in parse_phone_no(targets):
            # Parse each phone number we found
            result = is_phone_no(target)
            if result:
                self.targets.append("+{}".format(result["full"]))
                continue

            group_re = IS_GROUP_RE.match(target)
            if group_re and not target.isdigit():
                # If the target specified is all digits, it MUST have a @
                # in front of it to eliminate any ambiguity
                self.groups.append(group_re.group("group"))
                continue

            self.logger.warning(
                f"Dropped invalid phone # and/or Group ({target}) specified.",
            )

        return

    def send(self, body, title="", notify_type=NotifyType.INFO, **kwargs):
        """Perform BulkSMS Notification."""

        if not (self.password and self.user):
            self.logger.warning(
                "There were no valid login credentials provided"
            )
            return False

        if not (self.targets or self.groups):
            # We have nothing to notify
            self.logger.warning("There are no BulkSMS targets to notify")
            return False

        # Send in batches if identified to do so
        batch_size = 1 if not self.batch else self.default_batch_size

        # error tracking (used for function return)
        has_error = False

        # Prepare our headers
        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/json",
        }

        # Prepare our payload
        payload = {
            # The To gets populated in the loop below
            "to": None,
            "body": body,
            "routingGroup": self.route,
            "encoding": (
                BulkSMSEncoding.UNICODE
                if self.unicode
                else BulkSMSEncoding.TEXT
            ),
            # Options are NONE, ALL and ERRORS
            "deliveryReports": "ERRORS",
        }

        if self.source:
            payload.update(
                {
                    "from": self.source,
                }
            )

        # Authentication
        auth = (self.user, self.password)

        # Prepare our targets
        targets = (
            list(self.targets)
            if batch_size == 1
            else [
                self.targets[index : index + batch_size]
                for index in range(0, len(self.targets), batch_size)
            ]
        )
        targets += [{"type": "GROUP", "name": g} for g in self.groups]

        while len(targets):
            # Get our target to notify
            target = targets.pop(0)

            # Skip a target that already accepted this message so
            # a retry does not deliver it twice.
            if self.is_delivered(target):
                continue

            # Prepare our user
            payload["to"] = target

            # Printable reference
            if isinstance(target, dict):
                p_target = target["name"]

            elif isinstance(target, list):
                p_target = f"{len(target)} targets"

            else:
                p_target = target

            # Some Debug Logging
            self.logger.debug(
                "BulkSMS POST URL:"
                f" {self.notify_url} (cert_verify={self.verify_certificate})"
            )
            self.logger.debug(f"BulkSMS Payload: {payload}")

            # Always call throttle before any remote server i/o is made
            self.throttle()
            try:
                r = requests.post(
                    self.notify_url,
                    data=json.dumps(payload),
                    headers=headers,
                    auth=auth,
                    verify=self.verify_certificate,
                    timeout=self.request_timeout,
                    allow_redirects=self.redirects,
                )

                # The responsne might look like:
                # [
                #   {
                #       "id": "string",
                #       "type": "SENT",
                #       "from": "string",
                #       "to": "string",
                #       "body": null,
                #       "encoding": "TEXT",
                #       "protocolId": 0,
                #       "messageClass": 0,
                #       "numberOfParts": 0,
                #       "creditCost": 0,
                #       "submission": {...},
                #       "status": {...},
                #       "relatedSentMessageId": "string",
                #       "userSuppliedId": "string"
                #   }
                # ]

                if r.status_code not in (
                    requests.codes.created,
                    requests.codes.ok,
                ):
                    # We had a problem
                    status_str = NotifyBase.http_response_code_lookup(
                        r.status_code
                    )

                    # set up our status code to use
                    status_code = r.status_code

                    self.logger.warning(
                        "Failed to send BulkSMS notification to {}: "
                        "{}{}error={}.".format(
                            p_target,
                            status_str,
                            ", " if status_str else "",
                            status_code,
                        )
                    )

                    self.logger.debug(
                        "Response Details:\r\n%r", (r.content or b"")[:2000]
                    )

                    # Mark our failure
                    has_error = True
                    continue

                else:
                    self.logger.info(
                        f"Sent BulkSMS notification to {p_target}."
                    )

            except requests.RequestException as e:
                self.logger.warning(
                    "A Connection error occurred sending BulkSMS: to %s ",
                    p_target,
                )
                self.logger.debug(f"Socket Exception: {e!s}")

                # Mark our failure
                has_error = True
                continue

            # Delivered; a retry can safely skip this target.
            self.mark_delivered(target)

        return not has_error

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "unicode": "yes" if self.unicode else "no",
            "batch": "yes" if self.batch else "no",
            "route": self.route,
        }

        if self.source:
            params["from"] = self.source

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        return "{schema}://{user}:{password}@{targets}/?{params}".format(
            schema=self.secure_protocol,
            user=self.pprint(self.user, privacy, safe=""),
            password=self.pprint(
                self.password, privacy, mode=PrivacyMode.Secret, safe=""
            ),
            targets="/".join(
                chain(
                    [
                        NotifyBulkSMS.quote(f"{x}", safe="+")
                        for x in self.targets
                    ],
                    [
                        NotifyBulkSMS.quote(f"@{x}", safe="@")
                        for x in self.groups
                    ],
                )
            ),
            params=NotifyBulkSMS.urlencode(params),
        )

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (
            self.secure_protocol,
            self.user if self.user else None,
            self.password if self.password else None,
        )

    def __len__(self):
        """Returns the number of targets associated with this notification."""

        #
        # Factor batch into calculation
        #
        # Note: Groups always require a separate request (and can not be
        # included in batch calculations)
        batch_size = 1 if not self.batch else self.default_batch_size
        targets = len(self.targets)
        if batch_size > 1:
            targets = int(targets / batch_size) + (
                1 if targets % batch_size else 0
            )

        return targets + len(self.groups)

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # Get our entries; split_path() looks after unquoting content for us
        # by default
        results["targets"] = [
            NotifyBulkSMS.unquote(results["host"]),
            *NotifyBulkSMS.split_path(results["fullpath"]),
        ]

        # Support the 'from'  and 'source' variable so that we can support
        # targets this way too.
        # The 'from' makes it easier to use yaml configuration
        if "from" in results["qsd"] and len(results["qsd"]["from"]):
            results["source"] = NotifyBulkSMS.unquote(results["qsd"]["from"])

        # Support the 'to' variable so that we can support targets this way too
        # The 'to' makes it easier to use yaml configuration
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyBulkSMS.parse_phone_no(
                results["qsd"]["to"]
            )

        # Unicode Characters
        results["unicode"] = parse_bool(
            results["qsd"].get(
                "unicode", NotifyBulkSMS.template_args["unicode"]["default"]
            )
        )

        # Get Batch Mode Flag
        results["batch"] = parse_bool(
            results["qsd"].get(
                "batch", NotifyBulkSMS.template_args["batch"]["default"]
            )
        )

        # Allow one to define a route group
        if "route" in results["qsd"] and len(results["qsd"]["route"]):
            results["route"] = NotifyBulkSMS.unquote(results["qsd"]["route"])

        return results
caronc-apprise-dfec414/apprise/plugins/bulkvs.py000066400000000000000000000340411526720371000221250ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# To use this service you will need a BulkVS account
# You will need credits (new accounts start with a few)
#     https://www.bulkvs.com/

# API is documented here:
#   - https://portal.bulkvs.com/api/v1.0/documentation#/\
#             Messaging/post_messageSend
import json

import requests

from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import is_phone_no, parse_bool, parse_phone_no
from .base import NotifyBase


class NotifyBulkVS(NotifyBase):
    """A wrapper for BulkVS Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "BulkVS"

    # The services URL
    service_url = "https://www.bulkvs.com/"

    # All notification requests are secure
    secure_protocol = "bulkvs"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/bulkvs/"

    # BulkVS uses the http protocol with JSON requests
    notify_url = "https://portal.bulkvs.com/api/v1.0/messageSend"

    # The maximum length of the body
    body_maxlen = 160

    # The maximum amount of texts that can go out in one batch
    default_batch_size = 4000

    # A title can not be used for SMS Messages.  Setting this to zero will
    # cause any title (if defined) to get placed into the message body.
    title_maxlen = 0

    # Define object templates
    templates = (
        "{schema}://{user}:{password}@{from_phone}/{targets}",
        "{schema}://{user}:{password}@{from_phone}",
    )

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "user": {
                "name": _("User Name"),
                "type": "string",
                "required": True,
            },
            "password": {
                "name": _("Password"),
                "type": "string",
                "private": True,
                "required": True,
            },
            "from_phone": {
                "name": _("From Phone No"),
                "type": "string",
                "regex": (r"^\+?[0-9\s)(+-]+$", "i"),
                "map_to": "source",
                "required": True,
            },
            "target_phone": {
                "name": _("Target Phone No"),
                "type": "string",
                "prefix": "+",
                "regex": (r"^[0-9\s)(+-]+$", "i"),
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
                "required": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "from": {
                "name": _("From Phone No"),
                "type": "string",
                "regex": (r"^\+?[0-9\s)(+-]+$", "i"),
                "map_to": "source",
            },
            "to": {
                "alias_of": "targets",
            },
            "batch": {
                "name": _("Batch Mode"),
                "type": "bool",
                "default": False,
            },
        },
    )

    def __init__(self, source=None, targets=None, batch=None, **kwargs):
        """Initialize BulkVS Object."""
        super().__init__(**kwargs)

        if not (self.user and self.password):
            msg = "A BulkVS user/pass was not provided."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        result = is_phone_no(source)
        if not result:
            msg = (
                f"The Account (From) Phone # specified ({source}) is invalid."
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Tidy source
        self.source = result["full"]

        # Define whether or not we should operate in a batch mode
        self.batch = (
            self.template_args["batch"]["default"]
            if batch is None
            else bool(batch)
        )

        # Parse our targets
        self.targets = []

        has_error = False
        for target in parse_phone_no(targets):
            # Parse each phone number we found
            result = is_phone_no(target)
            if result:
                self.targets.append(result["full"])
                continue

            has_error = True
            self.logger.warning(
                f"Dropped invalid phone # ({target}) specified.",
            )

        if not targets and not has_error:
            # Default the SMS Message to ourselves
            self.targets.append(self.source)

        return

    def send(self, body, title="", notify_type=NotifyType.INFO, **kwargs):
        """Perform BulkVS Notification."""

        if not self.targets:
            # We have nothing to notify
            self.logger.warning("There are no BulkVS targets to notify")
            return False

        # Send in batches if identified to do so
        batch_size = 1 if not self.batch else self.default_batch_size

        # error tracking (used for function return)
        has_error = False

        # Prepare our headers
        headers = {
            "User-Agent": self.app_id,
            "Accept": "application/json",
            "Content-Type": "application/json",
        }

        # Prepare our payload
        payload = {
            # The To gets populated in the loop below
            "From": self.source,
            "To": None,
            "Message": body,
        }

        # Authentication
        auth = (self.user, self.password)

        # Prepare our targets
        targets = (
            list(self.targets)
            if batch_size == 1
            else [
                self.targets[index : index + batch_size]
                for index in range(0, len(self.targets), batch_size)
            ]
        )

        while len(targets):
            # Get our target to notify
            target = targets.pop(0)

            # Skip a target that already accepted this message so
            # a retry does not deliver it twice.
            if self.is_delivered(target):
                continue

            # Prepare our user
            payload["To"] = target

            # Printable reference
            if isinstance(target, list):
                p_target = f"{len(target)} targets"

            else:
                p_target = target

            # Some Debug Logging
            self.logger.debug(
                "BulkVS POST URL:"
                f" {self.notify_url} (cert_verify={self.verify_certificate})"
            )
            self.logger.debug(f"BulkVS Payload: {payload}")

            # Always call throttle before any remote server i/o is made
            self.throttle()
            try:
                r = requests.post(
                    self.notify_url,
                    data=json.dumps(payload),
                    headers=headers,
                    auth=auth,
                    verify=self.verify_certificate,
                    timeout=self.request_timeout,
                    allow_redirects=self.redirects,
                )

                # A Response may look like:
                # {
                #   "RefId": "5a66dee6-ff7a-40ee-8218-5805c074dc01",
                #   "From": "13109060901",
                #   "MessageType": "SMS|MMS",
                #   "Results": [
                #     {
                #       "To": "13105551212",
                #       "Status": "SUCCESS"
                #     },
                #     {
                #       "To": "13105551213",
                #       "Status": "SUCCESS"
                #     }
                #   ]
                # }
                if r.status_code != requests.codes.ok:
                    # We had a problem
                    status_str = NotifyBase.http_response_code_lookup(
                        r.status_code
                    )

                    # set up our status code to use
                    status_code = r.status_code

                    self.logger.warning(
                        "Failed to send BulkVS notification to {}: "
                        "{}{}error={}.".format(
                            p_target,
                            status_str,
                            ", " if status_str else "",
                            status_code,
                        )
                    )

                    self.logger.debug(
                        "Response Details:\r\n%r", (r.content or b"")[:2000]
                    )

                    # Mark our failure
                    has_error = True
                    continue

                else:
                    self.logger.info(
                        f"Sent BulkVS notification to {p_target}."
                    )

            except requests.RequestException as e:
                self.logger.warning(
                    "A Connection error occurred sending BulkVS: to %s ",
                    p_target,
                )
                self.logger.debug(f"Socket Exception: {e!s}")

                # Mark our failure
                has_error = True
                continue

            # Delivered; a retry can safely skip this target.
            self.mark_delivered(target)

        return not has_error

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (self.secure_protocol, self.source, self.user, self.password)

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "batch": "yes" if self.batch else "no",
        }

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        # A nice way of cleaning up the URL length a bit
        targets = (
            []
            if len(self.targets) == 1 and self.targets[0] == self.source
            else self.targets
        )

        return (
            "{schema}://{user}:{password}@{source}/{targets}?{params}".format(
                schema=self.secure_protocol,
                source=self.source,
                user=self.pprint(self.user, privacy, safe=""),
                password=self.pprint(
                    self.password, privacy, mode=PrivacyMode.Secret, safe=""
                ),
                targets="/".join(
                    [NotifyBulkVS.quote(f"{x}", safe="+") for x in targets]
                ),
                params=NotifyBulkVS.urlencode(params),
            )
        )

    def __len__(self):
        """Returns the number of targets associated with this notification."""

        #
        # Factor batch into calculation
        #
        batch_size = 1 if not self.batch else self.default_batch_size
        targets = len(self.targets) if self.targets else 1
        if batch_size > 1:
            targets = int(targets / batch_size) + (
                1 if targets % batch_size else 0
            )

        return targets

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # Support the 'from'  and 'source' variable so that we can support
        # targets this way too.
        # The 'from' makes it easier to use yaml configuration
        if "from" in results["qsd"] and len(results["qsd"]["from"]):
            results["source"] = NotifyBulkVS.unquote(results["qsd"]["from"])

            # hostname will also be a target in this case
            results["targets"] = [
                *NotifyBulkVS.parse_phone_no(results["host"]),
                *NotifyBulkVS.split_path(results["fullpath"]),
            ]

        else:
            # store our source
            results["source"] = NotifyBulkVS.unquote(results["host"])

            # store targets
            results["targets"] = NotifyBulkVS.split_path(results["fullpath"])

        # Support the 'to' variable so that we can support targets this way too
        # The 'to' makes it easier to use yaml configuration
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyBulkVS.parse_phone_no(
                results["qsd"]["to"]
            )

        # Get Batch Mode Flag
        results["batch"] = parse_bool(
            results["qsd"].get(
                "batch", NotifyBulkVS.template_args["batch"]["default"]
            )
        )

        return results
caronc-apprise-dfec414/apprise/plugins/burstsms.py000066400000000000000000000404141526720371000225020ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Sign-up with https://burstsms.com/
#
# Define your API Secret here and acquire your API Key
#  - https://can.transmitsms.com/profile
#
import requests

from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import (
    is_phone_no,
    parse_bool,
    parse_phone_no,
    validate_regex,
)
from .base import NotifyBase


class BurstSMSCountryCode:
    # Australia
    AU = "au"
    # New Zeland
    NZ = "nz"
    # United Kingdom
    UK = "gb"
    # United States
    US = "us"


BURST_SMS_COUNTRY_CODES = (
    BurstSMSCountryCode.AU,
    BurstSMSCountryCode.NZ,
    BurstSMSCountryCode.UK,
    BurstSMSCountryCode.US,
)


class NotifyBurstSMS(NotifyBase):
    """A wrapper for Burst SMS Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "Burst SMS"

    # The services URL
    service_url = "https://burstsms.com/"

    # The default protocol
    secure_protocol = "burstsms"

    # The maximum amount of SMS Messages that can reside within a single
    # batch transfer based on:
    #  https://developer.transmitsms.com/#74911cf8-dec6-4319-a499-7f535a7fd08c
    default_batch_size = 500

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/burstsms/"

    # Burst SMS uses the http protocol with JSON requests
    notify_url = "https://api.transmitsms.com/send-sms.json"

    # The maximum length of the body
    body_maxlen = 160

    # A title can not be used for SMS Messages.  Setting this to zero will
    # cause any title (if defined) to get placed into the message body.
    title_maxlen = 0

    # Define object templates
    templates = ("{schema}://{apikey}:{secret}@{sender_id}/{targets}",)

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "apikey": {
                "name": _("API Key"),
                "type": "string",
                "required": True,
                "regex": (r"^[a-z0-9]+$", "i"),
                "private": True,
            },
            "secret": {
                "name": _("API Secret"),
                "type": "string",
                "private": True,
                "required": True,
                "regex": (r"^[a-z0-9]+$", "i"),
            },
            "sender_id": {
                "name": _("Sender ID"),
                "type": "string",
                "required": True,
                "map_to": "source",
            },
            "target_phone": {
                "name": _("Target Phone No"),
                "type": "string",
                "prefix": "+",
                "regex": (r"^[0-9\s)(+-]+$", "i"),
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
                "required": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "from": {
                "alias_of": "sender_id",
            },
            "key": {
                "alias_of": "apikey",
            },
            "secret": {
                "alias_of": "secret",
            },
            "country": {
                "name": _("Country"),
                "type": "choice:string",
                "values": BURST_SMS_COUNTRY_CODES,
                "default": BurstSMSCountryCode.US,
            },
            # Validity
            # Expire a message send if it is undeliverable (defined in minutes)
            # If set to Zero (0); this is the default and sets the max validity
            # period
            "validity": {"name": _("validity"), "type": "int", "default": 0},
            "to": {
                "alias_of": "targets",
            },
            "batch": {
                "name": _("Batch Mode"),
                "type": "bool",
                "default": False,
            },
        },
    )

    def __init__(
        self,
        apikey,
        secret,
        source,
        targets=None,
        country=None,
        validity=None,
        batch=None,
        **kwargs,
    ):
        """Initialize Burst SMS Object."""
        super().__init__(**kwargs)

        # API Key (associated with project)
        self.apikey = validate_regex(
            apikey, *self.template_tokens["apikey"]["regex"]
        )
        if not self.apikey:
            msg = f"An invalid Burst SMS API Key ({apikey}) was specified."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # API Secret (associated with project)
        self.secret = validate_regex(
            secret, *self.template_tokens["secret"]["regex"]
        )
        if not self.secret:
            msg = f"An invalid Burst SMS API Secret ({secret}) was specified."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        if not country:
            self.country = self.template_args["country"]["default"]

        else:
            self.country = country.lower().strip()
            if country not in BURST_SMS_COUNTRY_CODES:
                msg = (
                    f"An invalid Burst SMS country ({country}) was specified."
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)

        # Set our Validity
        self.validity = self.template_args["validity"]["default"]
        if validity:
            try:
                self.validity = int(validity)

            except (ValueError, TypeError):
                msg = (
                    f"The Burst SMS Validity specified ({validity}) is"
                    " invalid."
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg) from None

        # Prepare Batch Mode Flag
        self.batch = (
            self.template_args["batch"]["default"] if batch is None else batch
        )

        # The Sender ID
        self.source = validate_regex(source)
        if not self.source:
            msg = f"The Account Sender ID specified ({source}) is invalid."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Parse our targets
        self.targets = []

        for target in parse_phone_no(targets):
            # Validate targets and drop bad ones:
            result = is_phone_no(target)
            if not result:
                self.logger.warning(
                    f"Dropped invalid phone # ({target}) specified.",
                )
                continue

            # store valid phone number
            self.targets.append(result["full"])

        return

    def send(self, body, title="", notify_type=NotifyType.INFO, **kwargs):
        """Perform Burst SMS Notification."""

        if not self.targets:
            self.logger.warning(
                "There are no valid Burst SMS targets to notify."
            )
            return False

        # error tracking (used for function return)
        has_error = False

        # Prepare our headers
        headers = {
            "User-Agent": self.app_id,
            "Accept": "application/json",
        }

        # Prepare our authentication
        auth = (self.apikey, self.secret)

        # Prepare our payload
        payload = {
            "countrycode": self.country,
            "message": body,
            # Sender ID
            "from": self.source,
            # The to gets populated in the loop below
            "to": None,
        }

        # Send in batches if identified to do so
        batch_size = 1 if not self.batch else self.default_batch_size

        # Create a copy of the targets list
        targets = list(self.targets)

        for index in range(0, len(targets), batch_size):
            # Skip a batch that already went out so a retry does
            # not deliver it to those recipients twice.
            if self.is_delivered(index):
                continue

            # Prepare our user
            payload["to"] = ",".join(self.targets[index : index + batch_size])

            # Some Debug Logging
            self.logger.debug(
                "Burst SMS POST URL:"
                f" {self.notify_url} (cert_verify={self.verify_certificate})"
            )
            self.logger.debug(f"Burst SMS Payload: {payload}")

            # Always call throttle before any remote server i/o is made
            self.throttle()

            try:
                r = requests.post(
                    self.notify_url,
                    data=payload,
                    headers=headers,
                    auth=auth,
                    verify=self.verify_certificate,
                    timeout=self.request_timeout,
                    allow_redirects=self.redirects,
                )

                if r.status_code != requests.codes.ok:
                    # We had a problem
                    status_str = NotifyBurstSMS.http_response_code_lookup(
                        r.status_code
                    )

                    self.logger.warning(
                        "Failed to send Burst SMS notification to {} "
                        "target(s): {}{}error={}.".format(
                            len(self.targets[index : index + batch_size]),
                            status_str,
                            ", " if status_str else "",
                            r.status_code,
                        )
                    )

                    self.logger.debug(
                        "Response Details:\r\n%r", (r.content or b"")[:2000]
                    )

                    # Mark our failure
                    has_error = True
                    continue

                else:
                    self.logger.info(
                        "Sent Burst SMS notification to "
                        f"{len(self.targets[index : index + batch_size])} "
                        "target(s)."
                    )

            except requests.RequestException as e:
                self.logger.warning(
                    f"A Connection error occurred sending Burst SMS "
                    "notification to "
                    f"{len(self.targets[index : index + batch_size])} "
                    "target(s)."
                )
                self.logger.debug(f"Socket Exception: {e!s}")

                # Mark our failure
                has_error = True
                continue

            # Delivered; a retry can safely skip this batch.
            self.mark_delivered(index)

        return not has_error

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "country": self.country,
            "batch": "yes" if self.batch else "no",
        }

        if self.validity:
            params["validity"] = str(self.validity)

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        return "{schema}://{key}:{secret}@{source}/{targets}/?{params}".format(
            schema=self.secure_protocol,
            key=self.pprint(self.apikey, privacy, safe=""),
            secret=self.pprint(
                self.secret, privacy, mode=PrivacyMode.Secret, safe=""
            ),
            source=NotifyBurstSMS.quote(self.source, safe=""),
            targets="/".join(
                [NotifyBurstSMS.quote(x, safe="") for x in self.targets]
            ),
            params=NotifyBurstSMS.urlencode(params),
        )

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (self.secure_protocol, self.apikey, self.secret, self.source)

    def __len__(self):
        """Returns the number of targets associated with this notification."""
        #
        # Factor batch into calculation
        #
        batch_size = 1 if not self.batch else self.default_batch_size
        targets = len(self.targets)
        if batch_size > 1:
            targets = int(targets / batch_size) + (
                1 if targets % batch_size else 0
            )

        return targets if targets > 0 else 1

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # The hostname is our source (Sender ID)
        results["source"] = NotifyBurstSMS.unquote(results["host"])

        # Get any remaining targets
        results["targets"] = NotifyBurstSMS.split_path(results["fullpath"])

        # Get our account_side and auth_token from the user/pass config
        results["apikey"] = NotifyBurstSMS.unquote(results["user"])
        results["secret"] = NotifyBurstSMS.unquote(results["password"])

        # API Key
        if "key" in results["qsd"] and len(results["qsd"]["key"]):
            # Extract the API Key from an argument
            results["apikey"] = NotifyBurstSMS.unquote(results["qsd"]["key"])

        # API Secret
        if "secret" in results["qsd"] and len(results["qsd"]["secret"]):
            # Extract the API Secret from an argument
            results["secret"] = NotifyBurstSMS.unquote(
                results["qsd"]["secret"]
            )

        # Support the 'from'  and 'source' variable so that we can support
        # targets this way too.
        # The 'from' makes it easier to use yaml configuration
        if "from" in results["qsd"] and len(results["qsd"]["from"]):
            results["source"] = NotifyBurstSMS.unquote(results["qsd"]["from"])
        if "source" in results["qsd"] and len(results["qsd"]["source"]):
            results["source"] = NotifyBurstSMS.unquote(
                results["qsd"]["source"]
            )

        # Support country
        if "country" in results["qsd"] and len(results["qsd"]["country"]):
            results["country"] = NotifyBurstSMS.unquote(
                results["qsd"]["country"]
            )

        # Support validity value
        if "validity" in results["qsd"] and len(results["qsd"]["validity"]):
            results["validity"] = NotifyBurstSMS.unquote(
                results["qsd"]["validity"]
            )

        # Get Batch Mode Flag
        if "batch" in results["qsd"] and len(results["qsd"]["batch"]):
            results["batch"] = parse_bool(results["qsd"]["batch"])

        # Support the 'to' variable so that we can support rooms this way too
        # The 'to' makes it easier to use yaml configuration
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyBurstSMS.parse_phone_no(
                results["qsd"]["to"]
            )

        return results
caronc-apprise-dfec414/apprise/plugins/chanify.py000066400000000000000000000155561526720371000222520ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Chanify
#   1. Visit https://chanify.net/

# The API URL will look something like this:
#    https://api.chanify.net/v1/sender/token
#

import requests

from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..utils.parse import validate_regex
from .base import NotifyBase


class NotifyChanify(NotifyBase):
    """A wrapper for Chanify Notifications."""

    # The default descriptive name associated with the Notification
    service_name = _("Chanify")

    # The services URL
    service_url = "https://chanify.net/"

    # The default secure protocol
    secure_protocol = "chanify"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/chanify/"

    # Notification URL
    notify_url = "https://api.chanify.net/v1/sender/{token}/"

    # Define object templates
    templates = ("{schema}://{token}",)

    # The title is not used
    title_maxlen = 0

    # Define our tokens; these are the minimum tokens required required to
    # be passed into this function (as arguments). The syntax appends any
    # previously defined in the base package and builds onto them
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "token": {
                "name": _("Token"),
                "type": "string",
                "private": True,
                "required": True,
                "regex": (r"^[A-Z0-9._-]+$", "i"),
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "token": {
                "alias_of": "token",
            },
        },
    )

    def __init__(self, token, **kwargs):
        """Initialize Chanify Object."""
        super().__init__(**kwargs)

        self.token = validate_regex(
            token, *self.template_tokens["token"]["regex"]
        )
        if not self.token:
            msg = f"The Chanify token specified ({token}) is invalid."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        return

    def send(self, body, title="", notify_type=NotifyType.INFO, **kwargs):
        """Send our notification."""

        # prepare our headers
        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/x-www-form-urlencoded",
        }

        # Our Message
        payload = {"text": body}

        self.logger.debug(
            "Chanify GET URL:"
            f" {self.notify_url} (cert_verify={self.verify_certificate!r})"
        )
        self.logger.debug(f"Chanify Payload: {payload!s}")

        # Always call throttle before any remote server i/o is made
        self.throttle()

        try:
            r = requests.post(
                self.notify_url.format(token=self.token),
                data=payload,
                headers=headers,
                verify=self.verify_certificate,
                timeout=self.request_timeout,
                allow_redirects=self.redirects,
            )
            if r.status_code != requests.codes.ok:
                # We had a problem
                status_str = NotifyChanify.http_response_code_lookup(
                    r.status_code
                )

                self.logger.warning(
                    "Failed to send Chanify notification: "
                    "{}{}error={}.".format(
                        status_str, ", " if status_str else "", r.status_code
                    )
                )

                self.logger.debug(
                    "Response Details:\r\n%r", (r.content or b"")[:2000]
                )

                # Return; we're done
                return False

            else:
                self.logger.info("Sent Chanify notification.")

        except requests.RequestException as e:
            self.logger.warning(
                "A Connection error occurred sending Chanify notification."
            )
            self.logger.debug(f"Socket Exception: {e!s}")

            # Return; we're done
            return False

        return True

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Prepare our parameters
        params = self.url_parameters(privacy=privacy, *args, **kwargs)

        return "{schema}://{token}/?{params}".format(
            schema=self.secure_protocol,
            token=self.pprint(self.token, privacy, safe=""),
            params=NotifyChanify.urlencode(params),
        )

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (self.secure_protocol, self.token)

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""

        # parse_url already handles getting the `user` and `password` fields
        # populated.
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # Allow over-ride
        if "token" in results["qsd"] and len(results["qsd"]["token"]):
            results["token"] = NotifyChanify.unquote(results["qsd"]["token"])

        else:
            results["token"] = NotifyChanify.unquote(results["host"])

        return results
caronc-apprise-dfec414/apprise/plugins/clickatell.py000066400000000000000000000251501526720371000227270ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from itertools import chain

# To use this service you will need a Clickatell account to which you can get
# your API_TOKEN at:
#     https://www.clickatell.com/
import requests

from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..utils.parse import is_phone_no, parse_phone_no, validate_regex
from .base import NotifyBase


class NotifyClickatell(NotifyBase):
    """A wrapper for Clickatell Notifications."""

    # The default descriptive name associated with the Notification
    service_name = _("Clickatell")

    # The services URL
    service_url = "https://www.clickatell.com/"

    # All notification requests are secure
    secure_protocol = "clickatell"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/clickatell/"

    # Clickatell API Endpoint
    notify_url = "https://platform.clickatell.com/messages/http/send"

    # A title can not be used for SMS Messages.  Setting this to zero will
    # cause any title (if defined) to get placed into the message body.
    title_maxlen = 0

    templates = (
        "{schema}://{apikey}/{targets}",
        "{schema}://{source}@{apikey}/{targets}",
    )

    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "apikey": {
                "name": _("API Token"),
                "type": "string",
                "private": True,
                "required": True,
            },
            "source": {
                "name": _("From Phone No"),
                "type": "string",
                "regex": (r"^[0-9\s)(+-]+$", "i"),
            },
            "target_phone": {
                "name": _("Target Phone No"),
                "type": "string",
                "prefix": "+",
                "regex": (r"^[0-9\s)(+-]+$", "i"),
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
                "required": True,
            },
        },
    )

    template_args = dict(
        NotifyBase.template_args,
        **{
            "apikey": {"alias_of": "apikey"},
            "to": {
                "alias_of": "targets",
            },
            "from": {
                "alias_of": "source",
            },
        },
    )

    def __init__(self, apikey, source=None, targets=None, **kwargs):
        """Initialize Clickatell Object."""

        super().__init__(**kwargs)

        self.apikey = validate_regex(apikey)
        if not self.apikey:
            msg = f"An invalid Clickatell API Token ({apikey}) was specified."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        self.source = None
        if source:
            result = is_phone_no(source)
            if not result:
                msg = (
                    "The Account (From) Phone # specified "
                    f"({source}) is invalid."
                )
                self.logger.warning(msg)

                raise AppriseImproperlyConfigured(msg)

            # Tidy source
            self.source = result["full"]

        # Used for URL generation afterwards only
        self._invalid_targets = []

        # Parse our targets
        self.targets = []

        for target in parse_phone_no(targets, prefix=True):
            # Validate targets and drop bad ones:
            result = is_phone_no(target)
            if not result:
                self.logger.warning(
                    f"Dropped invalid phone # ({target}) specified.",
                )
                self._invalid_targets.append(target)
                continue

            # store valid phone number
            self.targets.append(result["full"])

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (self.apikey, self.source)

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        params = self.url_parameters(privacy=privacy, *args, **kwargs)

        return "{schema}://{source}{apikey}/{targets}/?{params}".format(
            schema=self.secure_protocol,
            source=f"{self.source}@" if self.source else "",
            apikey=self.pprint(self.apikey, privacy, safe="="),
            targets="/".join(
                [
                    NotifyClickatell.quote(t, safe="")
                    for t in chain(self.targets, self._invalid_targets)
                ]
            ),
            params=self.urlencode(params),
        )

    def __len__(self):
        """Returns the number of targets associated with this notification.

        Always return 1 at least
        """
        return len(self.targets) if self.targets else 1

    def send(self, body, title="", notify_type=NotifyType.INFO, **kwargs):
        """Perform Clickatell Notification."""

        if not self.targets:
            # There were no targets to notify
            self.logger.warning("There were no Clickatell targets to notify")
            return False

        headers = {
            "User-Agent": self.app_id,
            "Accept": "application/json",
            "Content-Type": "application/json",
        }

        params_base = {
            "apiKey": self.apikey,
            "from": self.source,
            "content": body,
        }

        # error tracking (used for function return)
        has_error = False

        for target in self.targets:
            # Skip a target that already accepted this message so
            # a retry does not deliver it twice.
            if self.is_delivered(target):
                continue

            params = params_base.copy()
            params["to"] = target

            # Some Debug Logging
            self.logger.debug(
                "Clickatell GET URL:"
                f" {self.notify_url} (cert_verify={self.verify_certificate})"
            )
            self.logger.debug(f"Clickatell Payload: {params}")

            # Always call throttle before any remote server i/o is made
            self.throttle()

            try:
                r = requests.get(
                    self.notify_url,
                    params=params,
                    headers=headers,
                    verify=self.verify_certificate,
                    timeout=self.request_timeout,
                    allow_redirects=self.redirects,
                )

                if (
                    r.status_code != requests.codes.ok
                    and r.status_code != requests.codes.accepted
                ):
                    # We had a problem
                    status_str = self.http_response_code_lookup(r.status_code)

                    self.logger.warning(
                        "Failed to send Clickatell notification: "
                        "{}{}error={}.".format(
                            status_str,
                            ", " if status_str else "",
                            r.status_code,
                        )
                    )

                    self.logger.debug(
                        "Response Details:\r\n%r", (r.content or b"")[:2000]
                    )

                    # Mark our failure
                    has_error = True
                    continue

                else:
                    self.logger.info(
                        "Sent Clickatell notification to %s", target
                    )

            except requests.RequestException as e:
                self.logger.warning(
                    "A Connection error occurred sending Clickatell: to %s ",
                    target,
                )
                self.logger.debug(f"Socket Exception: {e!s}")
                # Mark our failure
                has_error = True
                continue

            # Delivered; a retry can safely skip this target.
            self.mark_delivered(target)

        return not has_error

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't parse the URL
            return results

        results["targets"] = NotifyClickatell.split_path(results["fullpath"])
        results["apikey"] = NotifyClickatell.unquote(results["host"])

        if results["user"]:
            results["source"] = NotifyClickatell.unquote(results["user"])

        # Support the 'to' variable so that we can support targets this way too
        # The 'to' makes it easier to use yaml configuration
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyClickatell.parse_phone_no(
                results["qsd"]["to"]
            )

        # Support the 'from'  and 'source' variable so that we can support
        # targets this way too.
        # The 'from' makes it easier to use yaml configuration
        if "from" in results["qsd"] and len(results["qsd"]["from"]):
            results["source"] = NotifyClickatell.unquote(
                results["qsd"]["from"]
            )

        return results
caronc-apprise-dfec414/apprise/plugins/clicksend.py000066400000000000000000000302361526720371000225600ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# To use this plugin, simply signup with clicksend:
#  https://www.clicksend.com/
#
# You're done at this point, you only need to know your user/pass that
# you signed up with.

#  The following URLs would be accepted by Apprise:
#   - clicksend://{user}:{password}@{phoneno}
#   - clicksend://{user}:{password}@{phoneno1}/{phoneno2}

# The API reference used to build this plugin was documented here:
#  https://developers.clicksend.com/docs/rest/v3/
#
from json import dumps

import requests

from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import is_phone_no, parse_bool, parse_phone_no
from .base import NotifyBase

# Extend HTTP Error Messages
CLICKSEND_HTTP_ERROR_MAP = {
    401: "Unauthorized - Invalid Token.",
}


class NotifyClickSend(NotifyBase):
    """A wrapper for ClickSend Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "ClickSend"

    # The services URL
    service_url = "https://clicksend.com/"

    # The default secure protocol
    secure_protocol = "clicksend"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/clicksend/"

    # ClickSend uses the http protocol with JSON requests
    notify_url = "https://rest.clicksend.com/v3/sms/send"

    # The maximum length of the body
    body_maxlen = 160

    # A title can not be used for SMS Messages.  Setting this to zero will
    # cause any title (if defined) to get placed into the message body.
    title_maxlen = 0

    # The maximum SMS batch size accepted by the ClickSend API
    default_batch_size = 1000

    # Define object templates
    templates = ("{schema}://{user}:{apikey}@{targets}",)

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "user": {
                "name": _("User Name"),
                "type": "string",
                "required": True,
            },
            "apikey": {
                "name": _("API Key"),
                "type": "string",
                "private": True,
                "required": True,
                "map_to": "password",
            },
            "target_phone": {
                "name": _("Target Phone No"),
                "type": "string",
                "prefix": "+",
                "regex": (r"^[0-9\s)(+-]+$", "i"),
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
                "required": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "key": {
                "alias_of": "apikey",
            },
            "to": {
                "alias_of": "targets",
            },
            "batch": {
                "name": _("Batch Mode"),
                "type": "bool",
                "default": False,
            },
        },
    )

    def __init__(self, targets=None, batch=False, **kwargs):
        """Initialize ClickSend Object."""
        super().__init__(**kwargs)

        # Prepare Batch Mode Flag
        self.batch = batch

        # Parse our targets
        self.targets = []

        if not (self.user and self.password):
            msg = "A ClickSend user/pass was not provided."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        for target in parse_phone_no(targets):
            # Validate targets and drop bad ones:
            result = is_phone_no(target)
            if not result:
                self.logger.warning(
                    f"Dropped invalid phone # ({target}) specified.",
                )
                continue

            # store valid phone number
            self.targets.append(result["full"])

    def send(self, body, title="", notify_type=NotifyType.INFO, **kwargs):
        """Perform ClickSend Notification."""

        if len(self.targets) == 0:
            # There were no services to notify
            self.logger.warning("There were no ClickSend targets to notify.")
            return False

        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/json; charset=utf-8",
        }

        # error tracking (used for function return)
        has_error = False

        # prepare JSON Object
        payload = {"messages": []}

        # Send in batches if identified to do so
        default_batch_size = 1 if not self.batch else self.default_batch_size

        for index in range(0, len(self.targets), default_batch_size):
            # Skip a batch that already went out so a retry does
            # not deliver it to those recipients twice.
            if self.is_delivered(index):
                continue

            payload["messages"] = [
                {
                    "source": "php",
                    "body": body,
                    "to": f"+{to}",
                }
                for to in self.targets[index : index + default_batch_size]
            ]

            self.logger.debug(
                "ClickSend POST URL:"
                f" {self.notify_url} (cert_verify={self.verify_certificate!r})"
            )
            self.logger.debug(f"ClickSend Payload: {payload!s}")

            # Always call throttle before any remote server i/o is made
            self.throttle()
            try:
                r = requests.post(
                    self.notify_url,
                    data=dumps(payload),
                    auth=(self.user, self.password),
                    headers=headers,
                    verify=self.verify_certificate,
                    timeout=self.request_timeout,
                    allow_redirects=self.redirects,
                )
                if r.status_code != requests.codes.ok:
                    # We had a problem
                    status_str = NotifyClickSend.http_response_code_lookup(
                        r.status_code, CLICKSEND_HTTP_ERROR_MAP
                    )

                    self.logger.warning(
                        "Failed to send {} ClickSend notification{}: "
                        "{}{}error={}.".format(
                            len(payload["messages"]),
                            (
                                f" to {self.targets[index]}"
                                if default_batch_size == 1
                                else "(s)"
                            ),
                            status_str,
                            ", " if status_str else "",
                            r.status_code,
                        )
                    )

                    self.logger.debug(
                        "Response Details:\r\n%r", (r.content or b"")[:2000]
                    )

                    # Mark our failure
                    has_error = True
                    continue

                else:
                    self.logger.info(
                        "Sent {} ClickSend notification{}.".format(
                            len(payload["messages"]),
                            (
                                f" to {self.targets[index]}"
                                if default_batch_size == 1
                                else "(s)"
                            ),
                        )
                    )

            except requests.RequestException as e:
                self.logger.warning(
                    "A Connection error occurred sending {} ClickSend "
                    "notification(s).".format(len(payload["messages"]))
                )
                self.logger.debug(f"Socket Exception: {e!s}")

                # Mark our failure
                has_error = True
                continue

            # Delivered; a retry can safely skip this batch.
            self.mark_delivered(index)

        return not has_error

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "batch": "yes" if self.batch else "no",
        }

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        # Setup Authentication
        auth = "{user}:{password}@".format(
            user=NotifyClickSend.quote(self.user, safe=""),
            password=self.pprint(
                self.password, privacy, mode=PrivacyMode.Secret, safe=""
            ),
        )

        return "{schema}://{auth}{targets}?{params}".format(
            schema=self.secure_protocol,
            auth=auth,
            targets="/".join(
                [NotifyClickSend.quote(x, safe="") for x in self.targets]
            ),
            params=NotifyClickSend.urlencode(params),
        )

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (self.secure_protocol, self.user, self.password)

    def __len__(self):
        """Returns the number of targets associated with this notification."""
        #
        # Factor batch into calculation
        #
        batch_size = 1 if not self.batch else self.default_batch_size
        targets = len(self.targets)
        if batch_size > 1:
            targets = int(targets / batch_size) + (
                1 if targets % batch_size else 0
            )

        return targets

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # All elements are targets
        results["targets"] = [NotifyClickSend.unquote(results["host"])]

        # All entries after the hostname are additional targets
        results["targets"].extend(
            NotifyClickSend.split_path(results["fullpath"])
        )

        # Get Batch Mode Flag
        results["batch"] = parse_bool(results["qsd"].get("batch", False))

        # API Key
        if "key" in results["qsd"] and len(results["qsd"]["key"]):
            # Extract the API Key from an argument
            results["password"] = NotifyClickSend.unquote(
                results["qsd"]["key"]
            )

        # Support the 'to' variable so that we can support rooms this way too
        # The 'to' makes it easier to use yaml configuration
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyClickSend.parse_phone_no(
                results["qsd"]["to"]
            )

        return results
caronc-apprise-dfec414/apprise/plugins/cliq.py000066400000000000000000000626701526720371000215600ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Zoho Cliq posts messages using a Webhook Token:
#  1. Sign in to Zoho Cliq and open "Bots & Tools", then "Webhook Tokens".
#  2. Complete the two-factor check and click "Generate New Token".
#  3. Copy the token; it looks like:
#     1001.2798931fdf4905dc5d37806b47d8253a.2d73063dae2ccf4a04810ddb0a1b2c3d
#
#  Messages can go to a channel (by its unique name) or to a bot.  A
#  channel's unique name is shown in its "Channel Info" page.
#
#  Your Apprise URL should be assembled as:
#     cliq://{token}/#{channel}
#     cliq://{token}/@{bot}
#
#  Accounts hosted outside of the US data center add ?region= (for
#  example ?region=eu for cliq.zoho.eu).
#
#  Webhook Tokens can only post messages; uploading files requires a
#  full OAuth login, so attachments are not supported.
#
# Resources:
# - https://www.zoho.com/cliq/help/platform/webhook-tokens.html
# - https://www.zoho.com/cliq/help/restapi/v2/messages/
# - https://www.zoho.com/cliq/help/restapi/v2/messagecards/

from __future__ import annotations

from json import dumps
import re
from typing import Any, Optional

import requests

from ..common import NotifyFormat, NotifyImageSize, NotifyType
from ..conversion import (
    commonmark_emphasis_run,
    commonmark_find_backtick_run,
    commonmark_index_backtick_runs,
    commonmark_new_scan_budget,
    commonmark_pick_emphasis_sentinel,
    commonmark_render_emphasis_markers,
    commonmark_scan_angle_dest,
    commonmark_scan_autolink_dest,
    commonmark_scan_paren_dest,
)
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..utils.parse import parse_bool, parse_list, validate_regex
from .base import NotifyBase

# Extend HTTP Error Messages
# Based on: https://www.zoho.com/cliq/help/restapi/v2/
CLIQ_HTTP_ERROR_MAP = {
    400: "Bad Request - Check the channel or bot name.",
    401: "Unauthorized - Invalid Webhook Token.",
    404: "The channel or bot could not be found.",
    429: "Too many requests were made.",
}


class CliqRegion:
    """The Zoho data centers that host Cliq accounts."""

    US = "us"
    EU = "eu"
    INDIA = "in"
    AUSTRALIA = "au"
    CHINA = "cn"
    JAPAN = "jp"
    SAUDI_ARABIA = "sa"
    UNITED_KINGDOM = "uk"
    CANADA = "ca"


# Each region and the Cliq domain it is reached on
CLIQ_REGION_DOMAINS = {
    CliqRegion.US: "cliq.zoho.com",
    CliqRegion.EU: "cliq.zoho.eu",
    CliqRegion.INDIA: "cliq.zoho.in",
    CliqRegion.AUSTRALIA: "cliq.zoho.com.au",
    CliqRegion.CHINA: "cliq.zoho.com.cn",
    CliqRegion.JAPAN: "cliq.zoho.jp",
    CliqRegion.SAUDI_ARABIA: "cliq.zoho.sa",
    CliqRegion.UNITED_KINGDOM: "cliq.zoho.uk",
    CliqRegion.CANADA: "cliq.zohocloud.ca",
}

# Look up a region from the domain found in a pasted Cliq URL
CLIQ_DOMAIN_REGIONS = {v: k for k, v in CLIQ_REGION_DOMAINS.items()}

# The regions in the order they are offered to users
CLIQ_REGIONS = tuple(CLIQ_REGION_DOMAINS.keys())

# A channel is the default target, so its "#" is optional
IS_CHANNEL = re.compile(r"^#?(?P[A-Z0-9_.-]+)$", re.I)

# A bot is always written with a leading "@"
IS_BOT = re.compile(r"^@(?P[A-Z0-9_.-]+)$", re.I)


class NotifyCliq(NotifyBase):
    """A wrapper for Zoho Cliq Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "Zoho Cliq"

    # The services URL
    service_url = "https://www.zoho.com/cliq/"

    # The default secure protocol; the extra names are accepted aliases
    secure_protocol = ("cliq", "zcliq", "zohocliq")

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/cliq/"

    # Our message URL; {path} is "channelsbyname" or "bots"
    notify_url = "https://{domain}{company}/api/v2/{path}/{name}/message"

    # Allows the user to specify the NotifyImageSize object
    image_size = NotifyImageSize.XY_72

    # Cliq renders its own flavour of Markdown
    notify_format = NotifyFormat.MARKDOWN

    # The maximum allowable characters allowed in the body per message
    body_maxlen = 5000

    # The title is shown in a message card above the body
    title_maxlen = 200

    # Define object URL templates
    templates = (
        "{schema}://{token}/{targets}",
        "{schema}://{botname}@{token}/{targets}",
    )

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "token": {
                "name": _("Webhook Token"),
                "type": "string",
                "private": True,
                "required": True,
                "regex": (r"^[A-Z0-9]+(\.[A-Z0-9]+)+$", "i"),
            },
            "botname": {
                "name": _("Bot Name"),
                "type": "string",
            },
            "target_channel": {
                "name": _("Target Channel"),
                "type": "string",
                "prefix": "#",
                "map_to": "targets",
            },
            "target_bot": {
                "name": _("Target Bot"),
                "type": "string",
                "prefix": "@",
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
                "required": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "to": {
                "alias_of": "targets",
            },
            "token": {
                "alias_of": "token",
            },
            "botname": {
                "alias_of": "botname",
            },
            "region": {
                "name": _("Region"),
                "type": "choice:string",
                "values": CLIQ_REGIONS,
                "default": CliqRegion.US,
            },
            "company": {
                "name": _("Company ID"),
                "type": "string",
            },
            "image": {
                "name": _("Include Image"),
                "type": "bool",
                "default": True,
                "map_to": "include_image",
            },
            "broadcast": {
                "name": _("Broadcast"),
                "type": "bool",
                "default": False,
            },
        },
    )

    def __init__(
        self,
        token: str,
        targets: Optional[Any] = None,
        botname: Optional[str] = None,
        region: Optional[str] = None,
        company: Optional[str] = None,
        include_image: bool = True,
        broadcast: bool = False,
        **kwargs: Any,
    ) -> None:
        """Initialize Zoho Cliq Object."""
        super().__init__(**kwargs)

        # Our Webhook Token
        self.token = validate_regex(
            token, *self.template_tokens["token"]["regex"]
        )
        if not self.token:
            msg = (
                f"An invalid Zoho Cliq Webhook Token ({token}) was specified."
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # The data center our account lives in
        self.region = (
            region.strip().lower()
            if isinstance(region, str) and region.strip()
            else CliqRegion.US
        )
        if self.region not in CLIQ_REGION_DOMAINS:
            msg = f"An invalid Zoho Cliq region ({region}) was specified."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Users belonging to more than one company can pick which one
        self.company = None
        if company:
            self.company = validate_regex(company, r"^[A-Z0-9_-]+$", "i")
            if not self.company:
                msg = (
                    f"An invalid Zoho Cliq Company ID ({company}) was"
                    " specified."
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)

        # The display name shown as the sender of our messages
        self.botname = botname.strip() if isinstance(botname, str) else None
        if not self.botname:
            self.botname = None

        # Show the Apprise image as the sender's avatar
        self.include_image = parse_bool(include_image)

        # Send bot messages to all of the bot's subscribers
        self.broadcast = parse_bool(broadcast)

        # Our channel and bot names, stored with their prefix
        self.targets = []

        # Anything we could not make sense of; kept for url()
        self.invalid_targets = []

        for target in parse_list(targets):
            # Bots must be checked first since "#" is optional on channels
            result = IS_BOT.match(target)
            if result:
                self.targets.append("@" + result.group("name"))
                continue

            result = IS_CHANNEL.match(target)
            if result:
                self.targets.append("#" + result.group("name"))
                continue

            self.logger.warning(
                "Dropped invalid Zoho Cliq target (%s) specified.", target
            )
            self.invalid_targets.append(target)

        return

    def dialect_convert(
        self,
        body: str,
        body_format: Optional[str] = None,
        *args: Any,
        **kwargs: Any,
    ) -> str:
        """Translate declared CommonMark to Zoho Cliq formatting."""
        # Only Markdown has anything for us to translate
        if body_format != NotifyFormat.MARKDOWN:
            return body
        return self._commonmark_to_cliq(body)

    # Adapt HTML-derived CommonMark to the Zoho Cliq formatting.
    # Direct Cliq formatting is left unchanged.
    # Syntax: https://www.zoho.com/cliq/help/chat-window/format-messages.html

    @classmethod
    def _commonmark_to_cliq(cls, body: str) -> str:
        """Translate CommonMark to Zoho Cliq formatting.

        CommonMark          Zoho Cliq
        ------------------  -----------------
        **bold**            *bold*
        *italic*            _italic_
        [label]()      [label](url)
                       url
        \\*                 *
        """
        # Accumulate translated characters one item at a time.
        out = []
        # Record ``*`` markup in order, then match it after the scan.
        delimiters = []
        # Track possible link-label openings in LIFO order.
        link_stack = []

        # Initialize the single-pass scanner.
        i = 0
        n = len(body)

        # Record backtick positions so matching code spans is quick.
        backtick_runs = commonmark_index_backtick_runs(body)
        # Pick a temporary marker that does not occur in the message.
        sentinel = commonmark_pick_emphasis_sentinel(body)
        # Bound the total work spent scanning labeled-link destinations.
        scan_budget = commonmark_new_scan_budget(body)

        while i < n:
            ch = body[i]

            # Drop CommonMark escapes because Cliq shows them literally.
            if ch == "\\" and i + 1 < n:
                out.append(body[i + 1])
                i += 2
                continue

            # Keep code spans as they are so their content is not styled.
            if ch == "`":
                j = i
                # Measure the run length by counting consecutive backticks.
                while j < n and body[j] == "`":
                    j += 1
                run = j - i
                # Search the pre-built index for the matching close run.
                close = commonmark_find_backtick_run(backtick_runs, j, run)

                # Unmatched backticks are kept as literal text.
                end = j if close is None else close + run
                out.append(body[i:end])
                i = end
                continue

            # Record a possible CommonMark link-label opening.
            if ch == "[":
                link_stack.append(len(out))
                out.append("[")
                i += 1
                continue

            # Unwrap ``[label]()`` into Cliq's ``[label](url)``.
            if body.startswith("](<", i) and link_stack:
                # Scan forward with escape awareness for the ">)" terminator.
                close = commonmark_scan_angle_dest(
                    body, i, n, budget=scan_budget
                )

                if close is not None:
                    # Protect the wrapping parenthesis from URL content.
                    url = body[i + 3 : close].replace(")", "%29")
                    link_stack.pop()
                    out.append(f"]({url})")
                    # Skip past the closing ">)" of the destination.
                    i = close + 2
                    continue

                # Let the bare-link check handle this failed angle form.

            # Copy bare destinations without scanning their URL as emphasis.
            if body.startswith("](", i) and link_stack:
                close = commonmark_scan_paren_dest(
                    body, i + 1, n, budget=scan_budget
                )

                if close is not None:
                    link_stack.pop()
                    out.append(body[i : close + 1])
                    # Skip past the closing ")".
                    i = close + 1
                    continue

                # This "](" does not finish a link, so retire its opener.
                link_stack.pop()

            # A "]" that never forms "](" cannot close a link. Retire the
            # innermost pending "[" so a later, unrelated "](" cannot
            # incorrectly reuse it as its own opener.
            if ch == "]" and link_stack and not body.startswith("](", i):
                link_stack.pop()

            # Drop autolink brackets; Cliq links the remaining URL itself.
            if ch == "<":
                close = commonmark_scan_autolink_dest(body, i, n)[0]
                if close is not None:
                    out.append(body[i + 1 : close])
                    i = close + 1
                    continue

            # Map CommonMark emphasis to Cliq's ``*``/``_`` syntax.
            if ch == "*":
                i = commonmark_emphasis_run(
                    body, i, n, delimiters, out, sentinel
                )
                continue

            # Preserve ordinary characters.
            out.append(ch)
            i += 1

        # Replace temporary markers with Cliq bold and italic markup.
        return commonmark_render_emphasis_markers(
            "".join(out), delimiters, ("*", "*"), ("_", "_"), sentinel
        )

    def send(
        self,
        body: str,
        title: str = "",
        notify_type: NotifyType = NotifyType.INFO,
        **kwargs: Any,
    ) -> bool:
        """Perform Zoho Cliq Notification."""

        if not self.targets:
            # We have nothing to notify
            self.logger.warning(
                "There are no Zoho Cliq channels or bots to notify."
            )
            return False

        # Prepare our headers
        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/json; charset=utf-8",
        }

        # Our Webhook Token is passed on the URL
        params = {"zapikey": self.token}

        # Cliq needs text, so a title on its own becomes the text
        payload = {"text": body if body else title}

        # Otherwise the title is shown in a card above the message
        if title and body:
            payload["card"] = {
                "title": title,
                "theme": "modern-inline",
            }

        # Acquire our image url if configured to do so
        image_url = (
            None if not self.include_image else self.image_url(notify_type)
        )

        # Cliq requires a name whenever the sender is changed
        if self.botname or image_url:
            payload["bot"] = {"name": self.botname or self.app_id}
            if image_url:
                payload["bot"]["image"] = image_url

        # Users in more than one company include it in the URL path
        company = f"/company/{self.company}" if self.company else ""

        # error tracking (used for function return)
        has_error = False

        for target in self.targets:
            # Skip a target that already accepted this message so a retry
            # does not deliver it twice.
            if self.is_delivered(target):
                continue

            # Our prefix tells us where the message is going
            is_bot = target[0] == "@"

            # Prepare our URL
            url = self.notify_url.format(
                domain=CLIQ_REGION_DOMAINS[self.region],
                company=company,
                path="bots" if is_bot else "channelsbyname",
                name=NotifyCliq.quote(target[1:], safe=""),
            )

            # Bot messages can reach every subscriber instead of just us
            _payload = (
                dict(payload, broadcast=True)
                if is_bot and self.broadcast
                else payload
            )

            self.logger.debug(
                "Zoho Cliq POST URL: %s (cert_verify=%r)",
                url,
                self.verify_certificate,
            )
            self.logger.debug("Zoho Cliq Payload: %s", _payload)

            # Always call throttle before any remote server i/o is made
            self.throttle()

            try:
                r = requests.post(
                    url,
                    params=params,
                    data=dumps(_payload),
                    headers=headers,
                    verify=self.verify_certificate,
                    timeout=self.request_timeout,
                    allow_redirects=self.redirects,
                )

                if r.status_code not in (
                    requests.codes.ok,
                    requests.codes.no_content,
                ):
                    # We had a problem
                    status_str = NotifyCliq.http_response_code_lookup(
                        r.status_code, CLIQ_HTTP_ERROR_MAP
                    )

                    self.logger.warning(
                        "Failed to send Zoho Cliq notification to %s: "
                        "%s%serror=%s.",
                        target,
                        status_str,
                        ", " if status_str else "",
                        r.status_code,
                    )

                    self.logger.debug(
                        "Response Details:\r\n%r", (r.content or b"")[:2000]
                    )

                    # Mark our failure
                    has_error = True
                    continue

                self.logger.info("Sent Zoho Cliq notification to %s.", target)

            except requests.RequestException as e:
                self.logger.warning(
                    "A Connection error occurred sending Zoho Cliq "
                    "notification to %s.",
                    target,
                )
                self.logger.debug("Socket Exception: %s", str(e))

                # Mark our failure
                has_error = True
                continue

            # Delivered; a retry can safely skip this target.
            self.mark_delivered(target)

        return not has_error

    def __len__(self) -> int:
        """Returns the number of targets associated with this notification."""
        # Always return at least 1 so the framework counts this instance
        return len(self.targets) if self.targets else 1

    @property
    def url_identifier(self) -> tuple[Any, ...]:
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        # The region and company decide which account the token belongs to
        return (
            self.secure_protocol[0],
            self.region,
            self.company,
            self.token,
        )

    def url(self, privacy: bool = False, *args: Any, **kwargs: Any) -> str:
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "image": "yes" if self.include_image else "no",
            "broadcast": "yes" if self.broadcast else "no",
        }

        # Only emit what differs from the defaults
        if self.region != CliqRegion.US:
            params["region"] = self.region

        if self.company:
            params["company"] = self.company

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        # Our bot name is placed in front of the token
        botname = (
            "{}@".format(NotifyCliq.quote(self.botname, safe=""))
            if self.botname
            else ""
        )

        return "{schema}://{botname}{token}/{targets}?{params}".format(
            schema=self.secure_protocol[0],
            botname=botname,
            token=self.pprint(self.token, privacy, safe=""),
            targets="/".join(
                NotifyCliq.quote(x, safe="@")
                for x in (self.targets + self.invalid_targets)
            ),
            params=NotifyCliq.urlencode(params),
        )

    @staticmethod
    def parse_url(url: str) -> Optional[dict[str, Any]]:
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # The token is our host unless ?token= says otherwise
        results["token"] = NotifyCliq.unquote(
            results["qsd"]["token"]
            if results["qsd"].get("token")
            else results["host"]
        )

        # Our channels and bots are in the path
        results["targets"] = NotifyCliq.split_path(results["fullpath"])

        # Support ?to= for targets
        if results["qsd"].get("to"):
            results["targets"] += NotifyCliq.parse_list(results["qsd"]["to"])

        # The bot name sits in front of the token
        if results["user"]:
            results["botname"] = NotifyCliq.unquote(results["user"])

        # Support ?botname= as an override
        if results["qsd"].get("botname"):
            results["botname"] = NotifyCliq.unquote(results["qsd"]["botname"])

        if results["qsd"].get("region"):
            results["region"] = NotifyCliq.unquote(results["qsd"]["region"])

        if results["qsd"].get("company"):
            results["company"] = NotifyCliq.unquote(results["qsd"]["company"])

        # Include our image unless told not to
        results["include_image"] = parse_bool(
            results["qsd"].get("image", True)
        )

        results["broadcast"] = parse_bool(
            results["qsd"].get("broadcast", False)
        )

        return results

    @staticmethod
    def parse_native_url(url: str) -> Optional[dict[str, Any]]:
        """
        Support:
           https://cliq.zoho.com/api/v2/channelsbyname/{channel}/message
                 ?zapikey={token}
           https://cliq.zoho.eu/company/{id}/api/v2/bots/{bot}/message
                 ?zapikey={token}
        """
        result = re.match(
            r"^https?://(?Pcliq\.zoho(cloud)?(\.[a-z]+){1,2})/+"
            r"(company/(?P[A-Z0-9_-]+)/+)?api/v2/+"
            r"(?Pchannelsbyname|bots)/(?P[^/?]+)/+message/*"
            r"\?(?P(.*&)?zapikey=(?P[^&]+).*)$",
            url,
            re.I,
        )

        if not result:
            return None

        # Map the domain back to the region it serves
        region = CLIQ_DOMAIN_REGIONS.get(result.group("domain").lower())
        if not region:
            return None

        # Rebuild our target with the prefix that describes it
        target = "{}{}".format(
            "@" if result.group("path").lower() == "bots" else "#",
            result.group("name"),
        )

        return NotifyCliq.parse_url(
            "{schema}://{token}/{target}?region={region}{company}".format(
                schema=NotifyCliq.secure_protocol[0],
                token=result.group("token"),
                target=NotifyCliq.quote(target, safe="@"),
                region=region,
                company=(
                    "&company={}".format(result.group("company"))
                    if result.group("company")
                    else ""
                ),
            )
        )
caronc-apprise-dfec414/apprise/plugins/custom_form.py000066400000000000000000000462011526720371000231550ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import re

import requests

from ..common import NotifyFormat, NotifyImageSize, NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import URL_ENCODED_PATH_SAFE_CHARS
from .base import NotifyBase


class FORMPayloadField:
    """Identifies the fields available in the FORM Payload."""

    VERSION = "version"
    TITLE = "title"
    MESSAGE = "message"
    MESSAGETYPE = "type"


# Defines the method to send the notification
METHODS = (
    "POST",
    "GET",
    "DELETE",
    "PUT",
    "HEAD",
    "PATCH",
    "UPDATE",
    "OPTIONS",
)


class NotifyForm(NotifyBase):
    """A wrapper for Form Notifications."""

    # Support
    # - file*
    # - file?
    # - file*name
    # - file?name
    # - ?file
    # - *file
    # - file
    # The code will convert the ? or * to the digit increments
    __attach_as_re = re.compile(
        r"((?P(?P[a-z0-9_-]+)?"
        r"(?P[*?+$:.%]+)(?P[a-z0-9_-]+))"
        r"|(?P(?P[a-z0-9_-]+)(?P[*?+$:.%]?)))",
        re.IGNORECASE,
    )

    # Our count
    attach_as_count = "{:02d}"

    # the default attach_as value
    attach_as_default = f"file{attach_as_count}"

    # The default descriptive name associated with the Notification
    service_name = "Form"

    # The default protocol
    protocol = "form"

    # The default secure protocol
    secure_protocol = "forms"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/form/"

    # Support attachments
    attachment_support = True

    # Pass-through Notify Formats. The endpoint receives whichever body
    # representation Apprise resolved for this send.
    notify_format = (
        NotifyFormat.TEXT,
        NotifyFormat.HTML,
        NotifyFormat.MARKDOWN,
    )

    # Allows the user to specify the NotifyImageSize object
    image_size = NotifyImageSize.XY_128

    # Disable throttle rate for Form requests since they are normally
    # local anyway
    request_rate_per_sec = 0

    # Define the FORM version to place in all payloads
    # Version: Major.Minor,  Major is only updated if the entire schema is
    # changed. If just adding new items (or removing old ones, only increment
    # the Minor!
    form_version = "1.0"

    # Define object templates
    templates = (
        "{schema}://{host}",
        "{schema}://{host}:{port}",
        "{schema}://{user}@{host}",
        "{schema}://{user}@{host}:{port}",
        "{schema}://{user}:{password}@{host}",
        "{schema}://{user}:{password}@{host}:{port}",
    )

    # Define our tokens; these are the minimum tokens required required to
    # be passed into this function (as arguments). The syntax appends any
    # previously defined in the base package and builds onto them
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "host": {
                "name": _("Hostname"),
                "type": "string",
                "required": True,
            },
            "port": {
                "name": _("Port"),
                "type": "int",
                "min": 1,
                "max": 65535,
            },
            "user": {
                "name": _("Username"),
                "type": "string",
            },
            "password": {
                "name": _("Password"),
                "type": "string",
                "private": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "method": {
                "name": _("Fetch Method"),
                "type": "choice:string",
                "values": METHODS,
                "default": METHODS[0],
            },
            "attach-as": {
                "name": _("Attach File As"),
                "type": "string",
                "default": "file*",
                "map_to": "attach_as",
            },
        },
    )

    # Define any kwargs we're using
    template_kwargs = {
        "headers": {
            "name": _("HTTP Header"),
            "prefix": "+",
        },
        "payload": {
            "name": _("Payload Extras"),
            "prefix": ":",
        },
        "params": {
            "name": _("GET Params"),
            "prefix": "-",
        },
    }

    def __init__(
        self,
        headers=None,
        method=None,
        payload=None,
        params=None,
        attach_as=None,
        **kwargs,
    ):
        """Initialize Form Object.

        headers can be a dictionary of key/value pairs that you want to
        additionally include as part of the server headers to post with
        """
        super().__init__(**kwargs)

        self.fullpath = kwargs.get("fullpath")
        if not isinstance(self.fullpath, str):
            self.fullpath = ""

        self.method = (
            self.template_args["method"]["default"]
            if not isinstance(method, str)
            else method.upper()
        )

        if self.method not in METHODS:
            msg = f"The method specified ({method}) is invalid."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Custom File Attachment Over-Ride Support
        if not isinstance(attach_as, str):
            # Default value
            self.attach_as = self.attach_as_default
            self.attach_multi_support = True

        else:
            result = self.__attach_as_re.match(attach_as.strip())
            if not result:
                msg = f"The attach-as specified ({attach_as}) is invalid."
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)

            self.attach_as = ""
            self.attach_multi_support = False
            if result.group("match1"):
                if result.group("id1a"):
                    self.attach_as += result.group("id1a")

                self.attach_as += self.attach_as_count
                self.attach_multi_support = True
                self.attach_as += result.group("id1b")

            else:  # result.group('match2'):
                self.attach_as += result.group("id2")
                if result.group("wc2"):
                    self.attach_as += self.attach_as_count
                    self.attach_multi_support = True

        # A payload map allows users to over-ride the default mapping if
        # they're detected with the :overide=value.  Normally this would
        # create a new key and assign it the value specified.  However
        # if the key you specify is actually an internally mapped one,
        # then a re-mapping takes place using the value
        self.payload_map = {
            FORMPayloadField.VERSION: FORMPayloadField.VERSION,
            FORMPayloadField.TITLE: FORMPayloadField.TITLE,
            FORMPayloadField.MESSAGE: FORMPayloadField.MESSAGE,
            FORMPayloadField.MESSAGETYPE: FORMPayloadField.MESSAGETYPE,
        }

        self.params = {}
        if params:
            # Store our extra headers
            self.params.update(params)

        self.headers = {}
        if headers:
            # Store our extra headers
            self.headers.update(headers)

        self.payload_overrides = {}
        self.payload_extras = {}
        if payload:
            # Store our extra payload entries
            self.payload_extras.update(payload)
            for key in list(self.payload_extras.keys()):
                # Any values set in the payload to alter a system related one
                # alters the system key.  Hence :message=msg maps the 'message'
                # variable that otherwise already contains the payload to be
                # 'msg' instead (containing the payload)
                if key in self.payload_map:
                    self.payload_map[key] = self.payload_extras[key]
                    self.payload_overrides[key] = self.payload_extras[key]
                    del self.payload_extras[key]

        return

    def send(
        self,
        body,
        title="",
        notify_type=NotifyType.INFO,
        attach=None,
        **kwargs,
    ):
        """Perform Form Notification."""

        # Prepare HTTP Headers
        headers = {
            "User-Agent": self.app_id,
        }

        # Apply any/all header over-rides defined
        headers.update(self.headers)

        # Track our potential attachments
        files = []
        if attach and self.attachment_support:
            for no, attachment in enumerate(attach, start=1):
                # Perform some simple error checking
                if not attachment:
                    # We could not access the attachment
                    self.logger.error(
                        "Could not access attachment"
                        f" {attachment.url(privacy=True)}."
                    )
                    return False

                try:
                    files.append(
                        (
                            (
                                self.attach_as.format(no)
                                if self.attach_multi_support
                                else self.attach_as
                            ),
                            (
                                (
                                    attachment.name
                                    if attachment.name
                                    else f"file{no:03}.dat"
                                ),
                                # file handle safely closed in
                                # `finally`; inline open intentional
                                open(attachment.path, "rb"),  # noqa: SIM115
                                attachment.mimetype,
                            ),
                        )
                    )

                except OSError as e:
                    self.logger.warning(
                        "An I/O error occurred while opening {}.".format(
                            attachment.name if attachment else "attachment"
                        )
                    )
                    self.logger.debug(f"I/O Exception: {e!s}")
                    return False

            if not self.attach_multi_support and no > 1:
                self.logger.warning(
                    "Multiple attachments provided while "
                    "form:// Multi-Attachment Support not enabled"
                )

        # prepare Form Object
        payload = {}

        for key, value in (
            (FORMPayloadField.VERSION, self.form_version),
            (FORMPayloadField.TITLE, title),
            (FORMPayloadField.MESSAGE, body),
            (FORMPayloadField.MESSAGETYPE, notify_type.value),
        ):
            if not self.payload_map[key]:
                # Do not store element in payload response
                continue
            payload[self.payload_map[key]] = value

        # Apply any/all payload over-rides defined
        payload.update(self.payload_extras)

        auth = None
        if self.user:
            auth = (self.user, self.password)

        # Set our schema
        schema = "https" if self.secure else "http"

        url = f"{schema}://{self.host}"
        if isinstance(self.port, int):
            url += f":{self.port}"

        url += self.fullpath

        self.logger.debug(
            f"Form {self.method} URL:"
            f" {url} (cert_verify={self.verify_certificate!r})"
        )
        self.logger.debug(f"Form Payload: {payload!s}")

        # Always call throttle before any remote server i/o is made
        self.throttle()

        # For GET the payload becomes URL query parameters; for all other
        # methods it is sent as the request body.
        if self.method == "GET":
            payload.update(self.params)

        try:
            r = requests.request(
                self.method,
                url,
                files=files if files else None,
                data=payload if self.method != "GET" else None,
                params=payload if self.method == "GET" else self.params,
                headers=headers,
                auth=auth,
                verify=self.verify_certificate,
                timeout=self.request_timeout,
                allow_redirects=self.redirects,
            )
            if r.status_code < 200 or r.status_code >= 300:
                # We had a problem
                status_str = NotifyForm.http_response_code_lookup(
                    r.status_code
                )

                self.logger.warning(
                    "Failed to send Form %s notification: %s%serror=%s.",
                    self.method,
                    status_str,
                    ", " if status_str else "",
                    r.status_code,
                )

                self.logger.debug(
                    "Response Details:\r\n%r", (r.content or b"")[:2000]
                )

                # Return; we're done
                return False

            else:
                self.logger.info("Sent Form %s notification.", self.method)

        except requests.RequestException as e:
            self.logger.warning(
                "A Connection error occurred sending Form "
                f"notification to {self.host}."
            )
            self.logger.debug(f"Socket Exception: {e!s}")

            # Return; we're done
            return False

        except OSError as e:
            self.logger.warning(
                "An I/O error occurred while reading one of the "
                "attached files."
            )
            self.logger.debug(f"I/O Exception: {e!s}")
            return False

        finally:
            for file in files:
                # Ensure all files are closed
                file[1][1].close()

        return True

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (
            self.secure_protocol if self.secure else self.protocol,
            self.user,
            self.password,
            self.host,
            self.port if self.port else (443 if self.secure else 80),
            self.fullpath.rstrip("/"),
        )

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "method": self.method,
        }

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        # Append our headers into our parameters
        params.update({f"+{k}": v for k, v in self.headers.items()})

        # Append our GET params into our parameters
        params.update({f"-{k}": v for k, v in self.params.items()})

        # Append our payload extra's into our parameters
        params.update({f":{k}": v for k, v in self.payload_extras.items()})
        params.update({f":{k}": v for k, v in self.payload_overrides.items()})

        if self.attach_as != self.attach_as_default:
            # Provide Attach-As extension details
            params["attach-as"] = self.attach_as

        # Determine Authentication
        auth = ""
        if self.user and self.password:
            auth = "{user}:{password}@".format(
                user=NotifyForm.quote(self.user, safe=""),
                password=self.pprint(
                    self.password, privacy, mode=PrivacyMode.Secret, safe=""
                ),
            )
        elif self.user:
            auth = "{user}@".format(
                user=NotifyForm.quote(self.user, safe=""),
            )

        default_port = 443 if self.secure else 80
        return "{schema}://{auth}{hostname}{port}{fullpath}?{params}".format(
            schema=self.secure_protocol if self.secure else self.protocol,
            auth=auth,
            # never encode hostname since we're expecting it to be a valid one
            hostname=self.host,
            port=(
                ""
                if self.port is None or self.port == default_port
                else f":{self.port}"
            ),
            fullpath=(
                NotifyForm.quote(
                    self.fullpath, safe=URL_ENCODED_PATH_SAFE_CHARS
                )
                if self.fullpath
                else "/"
            ),
            params=NotifyForm.urlencode(params),
        )

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # store any additional payload extra's defined
        results["payload"] = {
            NotifyForm.unquote(x): NotifyForm.unquote(y)
            for x, y in results["qsd:"].items()
        }

        # Add our headers that the user can potentially over-ride if they wish
        # to to our returned result set and tidy entries by unquoting them
        results["headers"] = {
            NotifyForm.unquote(x): NotifyForm.unquote(y)
            for x, y in results["qsd+"].items()
        }

        # Add our GET paramters in the event the user wants to pass these along
        results["params"] = {
            NotifyForm.unquote(x): NotifyForm.unquote(y)
            for x, y in results["qsd-"].items()
        }

        # Allow Attach-As Support which over-rides the name of the filename
        # posted with the form://
        # the default is file01, file02, file03, etc
        if "attach-as" in results["qsd"] and len(results["qsd"]["attach-as"]):
            results["attach_as"] = results["qsd"]["attach-as"]

        # Set method if not otherwise set
        if "method" in results["qsd"] and len(results["qsd"]["method"]):
            results["method"] = NotifyForm.unquote(results["qsd"]["method"])

        return results
caronc-apprise-dfec414/apprise/plugins/custom_json.py000066400000000000000000000356461526720371000231760ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from json import dumps
import logging

import requests

from .. import exception
from ..common import NotifyFormat, NotifyImageSize, NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import URL_ENCODED_PATH_SAFE_CHARS
from ..utils.sanitize import sanitize_payload
from .base import NotifyBase


class JSONPayloadField:
    """Identifies the fields available in the JSON Payload."""

    VERSION = "version"
    TITLE = "title"
    MESSAGE = "message"
    ATTACHMENTS = "attachments"
    MESSAGETYPE = "type"


# Defines the method to send the notification
METHODS = (
    "POST",
    "GET",
    "DELETE",
    "PUT",
    "HEAD",
    "PATCH",
    "UPDATE",
    "OPTIONS",
)


class NotifyJSON(NotifyBase):
    """A wrapper for JSON Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "JSON"

    # The default protocol
    protocol = "json"

    # The default secure protocol
    secure_protocol = "jsons"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/json/"

    # Support attachments
    attachment_support = True

    # Pass-through Notify Formats. The endpoint receives whichever body
    # representation Apprise resolved for this send.
    notify_format = (
        NotifyFormat.TEXT,
        NotifyFormat.HTML,
        NotifyFormat.MARKDOWN,
    )

    # Allows the user to specify the NotifyImageSize object
    image_size = NotifyImageSize.XY_128

    # Disable throttle rate for JSON requests since they are normally
    # local anyway
    request_rate_per_sec = 0

    # Define the JSON version to place in all payloads
    # Version: Major.Minor,  Major is only updated if the entire schema is
    # changed. If just adding new items (or removing old ones, only increment
    # the Minor!
    json_version = "1.0"

    # Define object templates
    templates = (
        "{schema}://{host}",
        "{schema}://{host}:{port}",
        "{schema}://{user}@{host}",
        "{schema}://{user}@{host}:{port}",
        "{schema}://{user}:{password}@{host}",
        "{schema}://{user}:{password}@{host}:{port}",
    )

    # Define our tokens; these are the minimum tokens required required to
    # be passed into this function (as arguments). The syntax appends any
    # previously defined in the base package and builds onto them
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "host": {
                "name": _("Hostname"),
                "type": "string",
                "required": True,
            },
            "port": {
                "name": _("Port"),
                "type": "int",
                "min": 1,
                "max": 65535,
            },
            "user": {
                "name": _("Username"),
                "type": "string",
            },
            "password": {
                "name": _("Password"),
                "type": "string",
                "private": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "method": {
                "name": _("Fetch Method"),
                "type": "choice:string",
                "values": METHODS,
                "default": METHODS[0],
            },
        },
    )

    # Define any kwargs we're using
    template_kwargs = {
        "headers": {
            "name": _("HTTP Header"),
            "prefix": "+",
        },
        "payload": {
            "name": _("Payload Extras"),
            "prefix": ":",
        },
        "params": {
            "name": _("GET Params"),
            "prefix": "-",
        },
    }

    def __init__(
        self, headers=None, method=None, payload=None, params=None, **kwargs
    ):
        """Initialize JSON Object.

        headers can be a dictionary of key/value pairs that you want to
        additionally include as part of the server headers to post with
        """
        super().__init__(**kwargs)

        self.fullpath = kwargs.get("fullpath")
        if not isinstance(self.fullpath, str):
            self.fullpath = ""

        self.method = (
            self.template_args["method"]["default"]
            if not isinstance(method, str)
            else method.upper()
        )

        if self.method not in METHODS:
            msg = f"The method specified ({method}) is invalid."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        self.params = {}
        if params:
            # Store our extra headers
            self.params.update(params)

        self.headers = {}
        if headers:
            # Store our extra headers
            self.headers.update(headers)

        self.payload_extras = {}
        if payload:
            # Store our extra payload entries
            self.payload_extras.update(payload)

        return

    def send(
        self,
        body,
        title="",
        notify_type=NotifyType.INFO,
        attach=None,
        **kwargs,
    ):
        """Perform JSON Notification."""

        # Prepare HTTP Headers
        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/json",
        }

        # Apply any/all header over-rides defined
        headers.update(self.headers)

        # Track our potential attachments
        attachments = []
        if attach and self.attachment_support:
            for no, attachment in enumerate(attach, start=1):
                # Perform some simple error checking
                if not attachment:
                    # We could not access the attachment
                    self.logger.error(
                        "Could not access Custom JSON attachment"
                        f" {attachment.url(privacy=True)}."
                    )
                    return False

                try:
                    attachments.append(
                        {
                            "filename": (
                                attachment.name
                                if attachment.name
                                else f"file{no:03}.dat"
                            ),
                            "base64": attachment.base64(),
                            "mimetype": attachment.mimetype,
                        }
                    )

                except exception.AppriseException:
                    # We could not access the attachment
                    self.logger.error(
                        "Could not access Custom JSON attachment"
                        f" {attachment.url(privacy=True)}."
                    )
                    return False

                self.logger.debug(
                    "Appending Custom JSON attachment"
                    f" {attachment.url(privacy=True)}"
                )

        # Prepare JSON Object
        payload = {
            JSONPayloadField.VERSION: self.json_version,
            JSONPayloadField.TITLE: title,
            JSONPayloadField.MESSAGE: body,
            JSONPayloadField.ATTACHMENTS: attachments,
            JSONPayloadField.MESSAGETYPE: notify_type.value,
        }

        for key, value in self.payload_extras.items():
            if key in payload:
                if not value:
                    # Do not store element in payload response
                    del payload[key]

                else:
                    # Re-map
                    payload[value] = payload[key]
                    del payload[key]

            else:
                # Append entry
                payload[key] = value

        auth = None
        if self.user:
            auth = (self.user, self.password)

        # Set our schema
        schema = "https" if self.secure else "http"

        url = f"{schema}://{self.host}"
        if isinstance(self.port, int):
            url += f":{self.port}"

        url += self.fullpath

        # Some Debug Logging
        if self.logger.isEnabledFor(logging.DEBUG):
            # Due to attachments; output can be quite heavy and io intensive
            # To accommodate this, we only show our debug payload information
            # if required.
            self.logger.debug(
                f"JSON POST URL: {url} "
                f"(cert_verify={self.verify_certificate!r})"
            )
            self.logger.debug("JSON Payload: %s", sanitize_payload(payload))

        # Always call throttle before any remote server i/o is made
        self.throttle()

        try:
            r = requests.request(
                self.method,
                url,
                data=dumps(payload),
                params=self.params,
                headers=headers,
                auth=auth,
                verify=self.verify_certificate,
                timeout=self.request_timeout,
                allow_redirects=self.redirects,
            )
            if r.status_code < 200 or r.status_code >= 300:
                # We had a problem
                status_str = NotifyJSON.http_response_code_lookup(
                    r.status_code
                )

                self.logger.warning(
                    "Failed to send JSON %s notification: %s%serror=%s.",
                    self.method,
                    status_str,
                    ", " if status_str else "",
                    r.status_code,
                )

                self.logger.debug(
                    "Response Details:\r\n%r", (r.content or b"")[:2000]
                )

                # Return; we're done
                return False

            else:
                self.logger.info("Sent JSON %s notification.", self.method)

        except requests.RequestException as e:
            self.logger.warning(
                "A Connection error occurred sending JSON "
                f"notification to {self.host}."
            )
            self.logger.debug(f"Socket Exception: {e!s}")

            # Return; we're done
            return False

        return True

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (
            self.secure_protocol if self.secure else self.protocol,
            self.user,
            self.password,
            self.host,
            self.port if self.port else (443 if self.secure else 80),
            self.fullpath.rstrip("/"),
        )

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "method": self.method,
        }

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        # Append our headers into our parameters
        params.update({f"+{k}": v for k, v in self.headers.items()})

        # Append our GET params into our parameters
        params.update({f"-{k}": v for k, v in self.params.items()})

        # Append our payload extra's into our parameters
        params.update({f":{k}": v for k, v in self.payload_extras.items()})

        # Determine Authentication
        auth = ""
        if self.user and self.password:
            auth = "{user}:{password}@".format(
                user=NotifyJSON.quote(self.user, safe=""),
                password=self.pprint(
                    self.password, privacy, mode=PrivacyMode.Secret, safe=""
                ),
            )
        elif self.user:
            auth = "{user}@".format(
                user=NotifyJSON.quote(self.user, safe=""),
            )

        default_port = 443 if self.secure else 80
        return "{schema}://{auth}{hostname}{port}{fullpath}?{params}".format(
            schema=self.secure_protocol if self.secure else self.protocol,
            auth=auth,
            # never encode hostname since we're expecting it to be a valid one
            hostname=self.host,
            port=(
                ""
                if self.port is None or self.port == default_port
                else f":{self.port}"
            ),
            fullpath=(
                NotifyJSON.quote(
                    self.fullpath, safe=URL_ENCODED_PATH_SAFE_CHARS
                )
                if self.fullpath
                else "/"
            ),
            params=NotifyJSON.urlencode(params),
        )

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # store any additional payload extra's defined
        results["payload"] = {
            NotifyJSON.unquote(x): NotifyJSON.unquote(y)
            for x, y in results["qsd:"].items()
        }

        # Add our headers that the user can potentially over-ride if they wish
        # to to our returned result set and tidy entries by unquoting them
        results["headers"] = {
            NotifyJSON.unquote(x): NotifyJSON.unquote(y)
            for x, y in results["qsd+"].items()
        }

        # Add our GET paramters in the event the user wants to pass these along
        results["params"] = {
            NotifyJSON.unquote(x): NotifyJSON.unquote(y)
            for x, y in results["qsd-"].items()
        }

        # Set method if not otherwise set
        if "method" in results["qsd"] and len(results["qsd"]["method"]):
            results["method"] = NotifyJSON.unquote(results["qsd"]["method"])

        return results
caronc-apprise-dfec414/apprise/plugins/custom_xml.py000066400000000000000000000443161526720371000230170ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import logging
import re

import requests

from .. import exception
from ..common import NotifyFormat, NotifyImageSize, NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import URL_ENCODED_PATH_SAFE_CHARS
from ..utils.sanitize import sanitize_payload
from .base import NotifyBase


class XMLPayloadField:
    """Identifies the fields available in the JSON Payload."""

    VERSION = "Version"
    TITLE = "Subject"
    MESSAGE = "Message"
    MESSAGETYPE = "MessageType"


# Defines the method to send the notification
METHODS = (
    "POST",
    "GET",
    "DELETE",
    "PUT",
    "HEAD",
    "PATCH",
    "UPDATE",
    "OPTIONS",
)


class NotifyXML(NotifyBase):
    """A wrapper for XML Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "XML"

    # The default protocol
    protocol = "xml"

    # The default secure protocol
    secure_protocol = "xmls"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/xml/"

    # Support attachments
    attachment_support = True

    # Pass-through Notify Formats. The endpoint receives whichever body
    # representation Apprise resolved for this send.
    notify_format = (
        NotifyFormat.TEXT,
        NotifyFormat.HTML,
        NotifyFormat.MARKDOWN,
    )

    # Allows the user to specify the NotifyImageSize object
    image_size = NotifyImageSize.XY_128

    # Disable throttle rate for JSON requests since they are normally
    # local anyway
    request_rate_per_sec = 0

    # XSD Information
    xsd_ver = "1.1"
    xsd_default_url = (
        "https://raw.githubusercontent.com/caronc/apprise/master"
        "/apprise/assets/NotifyXML-{version}.xsd"
    )

    # Define object templates
    templates = (
        "{schema}://{host}",
        "{schema}://{host}:{port}",
        "{schema}://{user}@{host}",
        "{schema}://{user}@{host}:{port}",
        "{schema}://{user}:{password}@{host}",
        "{schema}://{user}:{password}@{host}:{port}",
    )

    # Define our tokens; these are the minimum tokens required required to
    # be passed into this function (as arguments). The syntax appends any
    # previously defined in the base package and builds onto them
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "host": {
                "name": _("Hostname"),
                "type": "string",
                "required": True,
            },
            "port": {
                "name": _("Port"),
                "type": "int",
                "min": 1,
                "max": 65535,
            },
            "user": {
                "name": _("Username"),
                "type": "string",
            },
            "password": {
                "name": _("Password"),
                "type": "string",
                "private": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "method": {
                "name": _("Fetch Method"),
                "type": "choice:string",
                "values": METHODS,
                "default": METHODS[0],
            },
        },
    )

    # Define any kwargs we're using
    template_kwargs = {
        "headers": {
            "name": _("HTTP Header"),
            "prefix": "+",
        },
        "payload": {
            "name": _("Payload Extras"),
            "prefix": ":",
        },
        "params": {
            "name": _("GET Params"),
            "prefix": "-",
        },
    }

    def __init__(
        self, headers=None, method=None, payload=None, params=None, **kwargs
    ):
        """Initialize XML Object.

        headers can be a dictionary of key/value pairs that you want to
        additionally include as part of the server headers to post with
        """
        super().__init__(**kwargs)

        self.payload = """

    
        
            {{CORE}}
            {{ATTACHMENTS}}
       
    
"""

        self.fullpath = kwargs.get("fullpath")
        if not isinstance(self.fullpath, str):
            self.fullpath = ""

        self.method = (
            self.template_args["method"]["default"]
            if not isinstance(method, str)
            else method.upper()
        )

        if self.method not in METHODS:
            msg = f"The method specified ({method}) is invalid."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # A payload map allows users to over-ride the default mapping if
        # they're detected with the :overide=value.  Normally this would
        # create a new key and assign it the value specified.  However
        # if the key you specify is actually an internally mapped one,
        # then a re-mapping takes place using the value
        self.payload_map = {
            XMLPayloadField.VERSION: XMLPayloadField.VERSION,
            XMLPayloadField.TITLE: XMLPayloadField.TITLE,
            XMLPayloadField.MESSAGE: XMLPayloadField.MESSAGE,
            XMLPayloadField.MESSAGETYPE: XMLPayloadField.MESSAGETYPE,
        }

        self.params = {}
        if params:
            # Store our extra headers
            self.params.update(params)

        self.headers = {}
        if headers:
            # Store our extra headers
            self.headers.update(headers)

        self.payload_overrides = {}
        self.payload_extras = {}
        if payload:
            # Store our extra payload entries (but tidy them up since they will
            # become XML Keys (they can't contain certain characters
            for k, v in payload.items():
                key = re.sub(r"[^A-Za-z0-9_-]*", "", k)
                if not key:
                    self.logger.warning(
                        f"Ignoring invalid XML Stanza element name({k})"
                    )
                    continue

                # Any values set in the payload to alter a system related one
                # alters the system key.  Hence :message=msg maps the 'message'
                # variable that otherwise already contains the payload to be
                # 'msg' instead (containing the payload)
                if key in self.payload_map:
                    self.payload_map[key] = v
                    self.payload_overrides[key] = v

                else:
                    self.payload_extras[key] = v

        # Set our xsd url
        self.xsd_url = (
            None
            if self.payload_overrides or self.payload_extras
            else self.xsd_default_url.format(version=self.xsd_ver)
        )

        return

    def send(
        self,
        body,
        title="",
        notify_type=NotifyType.INFO,
        attach=None,
        **kwargs,
    ):
        """Perform XML Notification."""

        # Prepare HTTP Headers
        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/xml",
        }

        # Apply any/all header over-rides defined
        headers.update(self.headers)

        # Our XML Attachmement subsitution
        xml_attachments = ""

        payload_base = {}

        for key, value in (
            (XMLPayloadField.VERSION, self.xsd_ver),
            (
                XMLPayloadField.TITLE,
                NotifyXML.escape_html(title, whitespace=False),
            ),
            (
                XMLPayloadField.MESSAGE,
                NotifyXML.escape_html(body, whitespace=False),
            ),
            (
                XMLPayloadField.MESSAGETYPE,
                NotifyXML.escape_html(notify_type.value, whitespace=False),
            ),
        ):
            if not self.payload_map[key]:
                # Do not store element in payload response
                continue
            payload_base[self.payload_map[key]] = value

        # Apply our payload extras
        payload_base.update(
            {
                k: NotifyXML.escape_html(v, whitespace=False)
                for k, v in self.payload_extras.items()
            }
        )

        # Base Entres
        xml_base = "".join(
            [f"<{k}>{v}" for k, v in payload_base.items()]
        )

        attachments = []
        if attach and self.attachment_support:
            for no, attachment in enumerate(attach, start=1):
                # Perform some simple error checking
                if not attachment:
                    # We could not access the attachment
                    self.logger.error(
                        "Could not access Custom XML attachment"
                        f" {attachment.url(privacy=True)}."
                    )
                    return False

                try:
                    # Prepare our Attachment in Base64
                    entry = ''.format(
                        NotifyXML.escape_html(
                            (
                                attachment.name
                                if attachment.name
                                else f"file{no:03}.dat"
                            ),
                            whitespace=False,
                        ),
                        NotifyXML.escape_html(
                            attachment.mimetype, whitespace=False
                        ),
                    )
                    entry += attachment.base64()
                    entry += ""
                    attachments.append(entry)

                except exception.AppriseException:
                    # We could not access the attachment
                    self.logger.error(
                        "Could not access Custom XML attachment"
                        f" {attachment.url(privacy=True)}."
                    )
                    return False

                self.logger.debug(
                    "Appending Custom XML attachment"
                    f" {attachment.url(privacy=True)}"
                )

            # Update our xml_attachments record:
            xml_attachments = (
                ''
                + "".join(attachments)
                + ""
            )

        re_map = {
            "{{XSD_URL}}": (
                f' xmlns:xsi="{self.xsd_url}"' if self.xsd_url else ""
            ),
            "{{ATTACHMENTS}}": xml_attachments,
            "{{CORE}}": xml_base,
        }

        # Iterate over above list and store content accordingly
        re_table = re.compile(
            r"(" + "|".join(re_map.keys()) + r")",
            re.IGNORECASE,
        )

        auth = None
        if self.user:
            auth = (self.user, self.password)

        # Set our schema
        schema = "https" if self.secure else "http"

        url = f"{schema}://{self.host}"
        if isinstance(self.port, int):
            url += f":{self.port}"

        url += self.fullpath
        payload = re_table.sub(lambda x: re_map[x.group()], self.payload)

        # Some Debug Logging
        if self.logger.isEnabledFor(logging.DEBUG):
            # Due to attachments; output can be quite heavy and io intensive
            # To accommodate this, we only show our debug payload information
            # if required.
            self.logger.debug(
                f"XML POST URL: {url} "
                f"(cert_verify={self.verify_certificate!r})"
            )
            self.logger.debug("XML Payload: %s", sanitize_payload(payload))

        # Always call throttle before any remote server i/o is made
        self.throttle()

        try:
            r = requests.request(
                self.method,
                url,
                data=payload,
                headers=headers,
                auth=auth,
                verify=self.verify_certificate,
                timeout=self.request_timeout,
                allow_redirects=self.redirects,
            )
            if r.status_code < 200 or r.status_code >= 300:
                # We had a problem
                status_str = NotifyXML.http_response_code_lookup(r.status_code)

                self.logger.warning(
                    "Failed to send JSON %s notification: %s%serror=%s.",
                    self.method,
                    status_str,
                    ", " if status_str else "",
                    r.status_code,
                )

                self.logger.debug(
                    "Response Details:\r\n%r", (r.content or b"")[:2000]
                )

                # Return; we're done
                return False

            else:
                self.logger.info("Sent XML %s notification.", self.method)

        except requests.RequestException as e:
            self.logger.warning(
                "A Connection error occurred sending XML "
                f"notification to {self.host}."
            )
            self.logger.debug(f"Socket Exception: {e!s}")

            # Return; we're done
            return False

        return True

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (
            self.secure_protocol if self.secure else self.protocol,
            self.user,
            self.password,
            self.host,
            self.port if self.port else (443 if self.secure else 80),
            self.fullpath.rstrip("/"),
        )

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "method": self.method,
        }

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        # Append our headers into our parameters
        params.update({f"+{k}": v for k, v in self.headers.items()})

        # Append our GET params into our parameters
        params.update({f"-{k}": v for k, v in self.params.items()})

        # Append our payload extra's into our parameters
        params.update({f":{k}": v for k, v in self.payload_extras.items()})
        params.update({f":{k}": v for k, v in self.payload_overrides.items()})

        # Determine Authentication
        auth = ""
        if self.user and self.password:
            auth = "{user}:{password}@".format(
                user=NotifyXML.quote(self.user, safe=""),
                password=self.pprint(
                    self.password, privacy, mode=PrivacyMode.Secret, safe=""
                ),
            )
        elif self.user:
            auth = "{user}@".format(
                user=NotifyXML.quote(self.user, safe=""),
            )

        default_port = 443 if self.secure else 80
        return "{schema}://{auth}{hostname}{port}{fullpath}?{params}".format(
            schema=self.secure_protocol if self.secure else self.protocol,
            auth=auth,
            # never encode hostname since we're expecting it to be a valid one
            hostname=self.host,
            port=(
                ""
                if self.port is None or self.port == default_port
                else f":{self.port}"
            ),
            fullpath=(
                NotifyXML.quote(
                    self.fullpath, safe=URL_ENCODED_PATH_SAFE_CHARS
                )
                if self.fullpath
                else "/"
            ),
            params=NotifyXML.urlencode(params),
        )

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # store any additional payload extra's defined
        results["payload"] = {
            NotifyXML.unquote(x): NotifyXML.unquote(y)
            for x, y in results["qsd:"].items()
        }

        # Add our headers that the user can potentially over-ride if they wish
        # to to our returned result set and tidy entries by unquoting them
        results["headers"] = {
            NotifyXML.unquote(x): NotifyXML.unquote(y)
            for x, y in results["qsd+"].items()
        }

        # Add our GET paramters in the event the user wants to pass these along
        results["params"] = {
            NotifyXML.unquote(x): NotifyXML.unquote(y)
            for x, y in results["qsd-"].items()
        }

        # Set method if not otherwise set
        if "method" in results["qsd"] and len(results["qsd"]["method"]):
            results["method"] = NotifyXML.unquote(results["qsd"]["method"])

        return results
caronc-apprise-dfec414/apprise/plugins/d7networks.py000066400000000000000000000376021526720371000227340ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# To use this service you will need a D7 Networks account from their website
# at https://d7networks.com/
#
# After you've established your account you can get your api login credentials
# (both user and password) from the API Details section from within your
# account profile area:  https://d7networks.com/accounts/profile/
#
# API Reference: https://d7networks.com/docs/Messages/Send_Message/

from json import dumps, loads

import requests

from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..utils.parse import (
    is_phone_no,
    parse_bool,
    parse_phone_no,
    validate_regex,
)
from .base import NotifyBase

# Extend HTTP Error Messages
D7NETWORKS_HTTP_ERROR_MAP = {
    401: "Invalid Argument(s) Specified.",
    403: "Unauthorized - Authentication Failure.",
    412: "A Routing Error Occured",
    500: "A Serverside Error Occured Handling the Request.",
}


class NotifyD7Networks(NotifyBase):
    """A wrapper for D7 Networks Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "D7 Networks"

    # The services URL
    service_url = "https://d7networks.com/"

    # All notification requests are secure
    secure_protocol = "d7sms"

    # Allow 300 requests per minute.
    # 60/300 = 0.2
    request_rate_per_sec = 0.20

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/d7networks/"

    # D7 Networks single notification URL
    notify_url = "https://api.d7networks.com/messages/v1/send"

    # The maximum length of the body
    body_maxlen = 160

    # A title can not be used for SMS Messages.  Setting this to zero will
    # cause any title (if defined) to get placed into the message body.
    title_maxlen = 0

    # Define object templates
    templates = ("{schema}://{token}@{targets}",)

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "token": {
                "name": _("API Access Token"),
                "type": "string",
                "required": True,
                "private": True,
            },
            "target_phone": {
                "name": _("Target Phone No"),
                "type": "string",
                "prefix": "+",
                "regex": (r"^[0-9\s)(+-]+$", "i"),
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
                "required": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "source": {
                # Originating address,In cases where the rewriting of the
                # sender's address is supported or permitted by the SMS-C.
                # This is used to transmit the message, this number is
                # transmitted as the originating address and is completely
                # optional.
                "name": _("Originating Address"),
                "type": "string",
                "map_to": "source",
            },
            "from": {
                "alias_of": "source",
            },
            "unicode": {
                # Unicode characters (default is 'auto')
                "name": _("Unicode Characters"),
                "type": "bool",
                "default": False,
            },
            "to": {
                "alias_of": "targets",
            },
            "batch": {
                "name": _("Batch Mode"),
                "type": "bool",
                "default": False,
            },
        },
    )

    def __init__(
        self,
        token=None,
        targets=None,
        source=None,
        batch=False,
        unicode=None,
        **kwargs,
    ):
        """Initialize D7 Networks Object."""
        super().__init__(**kwargs)

        # Prepare Batch Mode Flag
        self.batch = batch

        # Setup our source address (if defined)
        self.source = None if not isinstance(source, str) else source.strip()

        # Define whether or not we should set the unicode flag
        self.unicode = (
            self.template_args["unicode"]["default"]
            if unicode is None
            else bool(unicode)
        )

        # The token associated with the account
        self.token = validate_regex(token)
        if not self.token:
            msg = f"The D7 Networks token specified ({token}) is invalid."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Parse our targets
        self.targets = []
        for target in parse_phone_no(targets):
            # Validate targets and drop bad ones:
            result = result = is_phone_no(target)
            if not result:
                self.logger.warning(
                    f"Dropped invalid phone # ({target}) specified.",
                )
                continue

            # store valid phone number
            self.targets.append(result["full"])

        return

    def send(self, body, title="", notify_type=NotifyType.INFO, **kwargs):
        """Depending on whether we are set to batch mode or single mode this
        redirects to the appropriate handling."""

        if len(self.targets) == 0:
            # There were no services to notify
            self.logger.warning("There were no D7 Networks targets to notify.")
            return False

        # error tracking (used for function return)
        has_error = False

        # Prepare our headers
        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/json",
            "Accept": "application/json",
            "Authorization": f"Bearer {self.token}",
        }

        payload = {
            "message_globals": {
                "channel": "sms",
            },
            "messages": [
                {
                    # Populated later on
                    "recipients": None,
                    "content": body,
                    "data_coding":
                    # auto is a better substitute over 'text' as text
                    # is easier to detect from a post than `unicode`.
                    "auto" if not self.unicode else "unicode",
                }
            ],
        }

        # use the list directly
        targets = list(self.targets)

        if self.source:
            payload["message_globals"]["originator"] = self.source

        target = None
        while len(targets):
            if self.batch:
                # Prepare our payload
                payload["messages"][0]["recipients"] = self.targets

                # Reset our targets so we don't keep going. This is required
                # because we're in batch mode; we only need to loop once.
                targets = []

            else:
                # We're not in a batch mode; so get our next target
                # Get our target(s) to notify
                target = targets.pop(0)

                # Skip a target that already accepted this message so
                # a retry does not deliver it twice.
                if self.is_delivered(target):
                    continue

                # Prepare our payload
                payload["messages"][0]["recipients"] = [target]

            # Some Debug Logging
            self.logger.debug(
                "D7 Networks POST URL:"
                f" {self.notify_url} (cert_verify={self.verify_certificate})"
            )
            self.logger.debug(f"D7 Networks Payload: {payload}")

            # Always call throttle before any remote server i/o is made
            self.throttle()
            try:
                r = requests.post(
                    self.notify_url,
                    data=dumps(payload),
                    headers=headers,
                    verify=self.verify_certificate,
                    timeout=self.request_timeout,
                    allow_redirects=self.redirects,
                )

                if r.status_code not in (
                    requests.codes.created,
                    requests.codes.ok,
                ):
                    # We had a problem
                    status_str = NotifyBase.http_response_code_lookup(
                        r.status_code, D7NETWORKS_HTTP_ERROR_MAP
                    )

                    try:
                        # Update our status response if we can
                        json_response = loads(r.content)
                        status_str = json_response.get("message", status_str)

                    except (AttributeError, TypeError, ValueError):
                        # ValueError = r.content is Unparsable
                        # TypeError = r.content is None
                        # AttributeError = r is None

                        # We could not parse JSON response.
                        # We will just use the status we already have.
                        self.logger.debug(
                            "Failed to parse D7Networks JSON response; "
                            "body: %r",
                            (r.content or b"")[:2000],
                        )
                        pass

                    self.logger.warning(
                        "Failed to send D7 Networks SMS notification to {}: "
                        "{}{}error={}.".format(
                            ", ".join(target) if self.batch else target,
                            status_str,
                            ", " if status_str else "",
                            r.status_code,
                        )
                    )

                    self.logger.debug(
                        "Response Details:\r\n%r", (r.content or b"")[:2000]
                    )

                    # Mark our failure
                    has_error = True
                    continue

                else:
                    if self.batch:
                        self.logger.info(
                            "Sent D7 Networks batch SMS notification to "
                            f"{len(self.targets)} target(s)."
                        )

                    else:
                        self.logger.info(
                            f"Sent D7 Networks SMS notification to {target}."
                        )

                    self.logger.debug(f"Response Details:\r\n{r.content}")

            except requests.RequestException as e:
                self.logger.warning(
                    "A Connection error occurred sending"
                    " D7 Networks:{} notification.".format(
                        ", ".join(self.targets)
                    )
                )
                self.logger.debug(f"Socket Exception: {e!s}")
                # Mark our failure
                has_error = True
                continue

            # Delivered; a retry can safely skip this target.
            self.mark_delivered(target)

        return not has_error

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "batch": "yes" if self.batch else "no",
            "unicode": "yes" if self.unicode else "no",
        }

        if self.source:
            params["source"] = self.source

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        return "{schema}://{token}@{targets}/?{params}".format(
            schema=self.secure_protocol,
            token=self.pprint(self.token, privacy, safe=""),
            targets="/".join(
                [NotifyD7Networks.quote(x, safe="") for x in self.targets]
            ),
            params=NotifyD7Networks.urlencode(params),
        )

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (self.secure_protocol, self.token)

    def __len__(self):
        """Returns the number of targets associated with this notification."""
        #
        # Factor batch into calculation
        #
        return len(self.targets) if not self.batch else 1

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        if "token" in results["qsd"] and len(results["qsd"]["token"]):
            results["token"] = NotifyD7Networks.unquote(
                results["qsd"]["token"]
            )

        elif results["user"]:
            results["token"] = NotifyD7Networks.unquote(results["user"])

            if results["password"]:
                # Support token containing a colon (:)
                results["token"] += ":" + NotifyD7Networks.unquote(
                    results["password"]
                )

        elif results["password"]:
            # Support token starting with a colon (:)
            results["token"] = ":" + NotifyD7Networks.unquote(
                results["password"]
            )

        # Initialize our targets
        results["targets"] = []

        # The store our first target stored in the hostname
        results["targets"].append(NotifyD7Networks.unquote(results["host"]))

        # Get our entries; split_path() looks after unquoting content for us
        # by default
        results["targets"].extend(
            NotifyD7Networks.split_path(results["fullpath"])
        )

        # Get Batch Mode Flag
        results["batch"] = parse_bool(results["qsd"].get("batch", False))

        # Get Unicode Flag
        results["unicode"] = parse_bool(results["qsd"].get("unicode", False))

        # Support the 'to' variable so that we can support targets this way too
        # The 'to' makes it easier to use yaml configuration
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyD7Networks.parse_phone_no(
                results["qsd"]["to"]
            )

        # Support the 'from' and source variable
        if "from" in results["qsd"] and len(results["qsd"]["from"]):
            results["source"] = NotifyD7Networks.unquote(
                results["qsd"]["from"]
            )

        elif "source" in results["qsd"] and len(results["qsd"]["source"]):
            results["source"] = NotifyD7Networks.unquote(
                results["qsd"]["source"]
            )

        return results
caronc-apprise-dfec414/apprise/plugins/dapnet.py000066400000000000000000000340041526720371000220710ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# To use this plugin, sign up with Hampager (you need to be a licensed
# ham radio operator
#  http://www.hampager.de/
#
# You're done at this point, you only need to know your user/pass that
# you signed up with.

#  The following URLs would be accepted by Apprise:
#   - dapnet://{user}:{password}@{callsign}
#   - dapnet://{user}:{password}@{callsign1}/{callsign2}

# Optional parameters:
#   - priority (NORMAL or EMERGENCY). Default: NORMAL
#   - txgroups --> comma-separated list of DAPNET transmitter
#                           groups. Default: 'dl-all'
#                           https://hampager.de/#/transmitters/groups

from json import dumps

# The API reference used to build this plugin was documented here:
#  https://hampager.de/dokuwiki/doku.php#dapnet_api
#
import requests
from requests.auth import HTTPBasicAuth

from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import is_call_sign, parse_bool, parse_call_sign, parse_list
from .base import NotifyBase


class DapnetPriority:
    NORMAL = 0
    EMERGENCY = 1


DAPNET_PRIORITIES = {
    DapnetPriority.NORMAL: "normal",
    DapnetPriority.EMERGENCY: "emergency",
}


DAPNET_PRIORITY_MAP = {
    # Maps against string 'normal'
    "n": DapnetPriority.NORMAL,
    # Maps against string 'emergency'
    "e": DapnetPriority.EMERGENCY,
    # Entries to additionally support (so more like Dapnet's API)
    "0": DapnetPriority.NORMAL,
    "1": DapnetPriority.EMERGENCY,
}


class NotifyDapnet(NotifyBase):
    """A wrapper for DAPNET / Hampager Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "Dapnet"

    # The services URL
    service_url = "https://hampager.de/"

    # The default secure protocol
    secure_protocol = "dapnet"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/dapnet/"

    # Dapnet uses the http protocol with JSON requests
    notify_url = "http://www.hampager.de:8080/calls"

    # The maximum length of the body
    body_maxlen = 80

    # A title can not be used for Dapnet Messages.  Setting this to zero will
    # cause any title (if defined) to get placed into the message body.
    title_maxlen = 0

    # The maximum amount of emails that can reside within a single transmission
    default_batch_size = 50

    # Define object templates
    templates = ("{schema}://{user}:{password}@{targets}",)

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "user": {
                "name": _("User Name"),
                "type": "string",
                "required": True,
            },
            "password": {
                "name": _("Password"),
                "type": "string",
                "private": True,
                "required": True,
            },
            "target_callsign": {
                "name": _("Target Callsign"),
                "type": "string",
                "regex": (
                    r"^[a-z0-9]{2,5}(-[a-z0-9]{1,2})?$",
                    "i",
                ),
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
                "required": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "priority": {
                "name": _("Priority"),
                "type": "choice:int",
                "values": DAPNET_PRIORITIES,
                "default": DapnetPriority.NORMAL,
            },
            "txgroups": {
                "name": _("Transmitter Groups"),
                "type": "string",
                "default": "dl-all",
                "private": True,
            },
            "to": {
                "name": _("Target Callsign"),
                "type": "string",
                "map_to": "targets",
            },
            "batch": {
                "name": _("Batch Mode"),
                "type": "bool",
                "default": False,
            },
        },
    )

    def __init__(
        self, targets=None, priority=None, txgroups=None, batch=False, **kwargs
    ):
        """Initialize Dapnet Object."""
        super().__init__(**kwargs)

        # Parse our targets
        self.targets = []

        # The Priority of the message
        self.priority = int(
            NotifyDapnet.template_args["priority"]["default"]
            if priority is None
            else next(
                (
                    v
                    for k, v in DAPNET_PRIORITY_MAP.items()
                    if str(priority).lower().startswith(k)
                ),
                NotifyDapnet.template_args["priority"]["default"],
            )
        )

        if not (self.user and self.password):
            msg = "A Dapnet user/pass was not provided."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Get the transmitter group
        self.txgroups = parse_list(
            txgroups
            if txgroups
            else NotifyDapnet.template_args["txgroups"]["default"]
        )

        # Prepare Batch Mode Flag
        self.batch = batch

        for target in parse_call_sign(targets):
            # Validate targets and drop bad ones:
            result = is_call_sign(target)
            if not result:
                self.logger.warning(
                    f"Dropping invalid Amateur radio call sign ({target}).",
                )
                continue

            # Store callsign without SSID and ignore duplicates
            if result["callsign"] not in self.targets:
                self.targets.append(result["callsign"])

        return

    def send(self, body, title="", notify_type=NotifyType.INFO, **kwargs):
        """Perform Dapnet Notification."""

        if not self.targets:
            # There is no one to email; we're done
            self.logger.warning(
                "There are no Amateur radio callsigns to notify"
            )
            return False

        # Send in batches if identified to do so
        batch_size = 1 if not self.batch else self.default_batch_size

        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/json; charset=utf-8",
        }

        # error tracking (used for function return)
        has_error = False

        # Create a copy of the targets list
        targets = list(self.targets)

        for index in range(0, len(targets), batch_size):
            # Skip a batch that already went out so a retry does not
            # deliver it to those recipients twice.
            if self.is_delivered(index):
                continue

            # prepare JSON payload
            payload = {
                "text": body,
                "callSignNames": targets[index : index + batch_size],
                "transmitterGroupNames": self.txgroups,
                "emergency": self.priority == DapnetPriority.EMERGENCY,
            }

            self.logger.debug(f"DAPNET POST URL: {self.notify_url}")
            self.logger.debug(f"DAPNET Payload: {dumps(payload)}")

            # Always call throttle before any remote server i/o is made
            self.throttle()
            try:
                r = requests.post(
                    self.notify_url,
                    data=dumps(payload),
                    headers=headers,
                    auth=HTTPBasicAuth(
                        username=self.user, password=self.password
                    ),
                    verify=self.verify_certificate,
                    timeout=self.request_timeout,
                    allow_redirects=self.redirects,
                )
                if r.status_code != requests.codes.created:
                    # We had a problem

                    self.logger.warning(
                        "Failed to send DAPNET notification {} to {}: "
                        "error={}.".format(
                            payload["text"],
                            f" to {self.targets}",
                            r.status_code,
                        )
                    )

                    self.logger.debug(
                        "Response Details:\r\n%r", (r.content or b"")[:2000]
                    )

                    # Mark our failure
                    has_error = True
                    continue

                else:
                    self.logger.info(
                        "Sent '{}' DAPNET notification {}".format(
                            payload["text"], f"to {self.targets}"
                        )
                    )

            except requests.RequestException as e:
                self.logger.warning(
                    "A Connection error occurred sending DAPNET "
                    f"notification to {self.targets}"
                )
                self.logger.debug(f"Socket Exception: {e!s}")

                # Mark our failure
                has_error = True
                continue

            # Delivered; a retry can safely skip this batch.
            self.mark_delivered(index)

        return not has_error

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "priority": (
                DAPNET_PRIORITIES[self.template_args["priority"]["default"]]
                if self.priority not in DAPNET_PRIORITIES
                else DAPNET_PRIORITIES[self.priority]
            ),
            "batch": "yes" if self.batch else "no",
            "txgroups": ",".join(self.txgroups),
        }

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        # Setup Authentication
        auth = "{user}:{password}@".format(
            user=NotifyDapnet.quote(self.user, safe=""),
            password=self.pprint(
                self.password, privacy, mode=PrivacyMode.Secret, safe=""
            ),
        )

        return "{schema}://{auth}{targets}?{params}".format(
            schema=self.secure_protocol,
            auth=auth,
            targets="/".join(
                [self.pprint(x, privacy, safe="") for x in self.targets]
            ),
            params=NotifyDapnet.urlencode(params),
        )

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (self.secure_protocol, self.user, self.password)

    def __len__(self):
        """Returns the number of targets associated with this notification."""
        #
        # Factor batch into calculation
        #
        batch_size = 1 if not self.batch else self.default_batch_size
        targets = len(self.targets)
        if batch_size > 1:
            targets = int(targets / batch_size) + (
                1 if targets % batch_size else 0
            )

        return targets

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to re-
        instantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # All elements are targets
        results["targets"] = [NotifyDapnet.unquote(results["host"])]

        # All entries after the hostname are additional targets
        results["targets"].extend(NotifyDapnet.split_path(results["fullpath"]))

        # Support the 'to' variable so that we can support rooms this way too
        # The 'to' makes it easier to use yaml configuration
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyDapnet.parse_list(results["qsd"]["to"])

        # Set our priority
        if "priority" in results["qsd"] and len(results["qsd"]["priority"]):
            results["priority"] = NotifyDapnet.unquote(
                results["qsd"]["priority"]
            )

        # Check for one or multiple transmitter groups (comma separated)
        # and split them up, when necessary
        if "txgroups" in results["qsd"]:
            results["txgroups"] = [
                x.lower()
                for x in NotifyDapnet.parse_list(results["qsd"]["txgroups"])
            ]

        # Get Batch Mode Flag
        results["batch"] = parse_bool(
            results["qsd"].get(
                "batch", NotifyDapnet.template_args["batch"]["default"]
            )
        )

        return results
caronc-apprise-dfec414/apprise/plugins/dbus.py000066400000000000000000000347261526720371000215660ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import sys

from ..common import NotifyImageSize, NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..utils.parse import parse_bool
from .base import NotifyBase

# Default our global support flag
NOTIFY_DBUS_SUPPORT_ENABLED = False

# Image support is dependant on the GdkPixbuf library being available
NOTIFY_DBUS_IMAGE_SUPPORT = False

# Initialize our mainloops
LOOP_GLIB = None
LOOP_QT = None


try:
    # D-Bus Message Bus Daemon 1.12.XX Essentials
    from dbus import Byte, ByteArray, DBusException, Interface, SessionBus

    #
    # now we try to determine which mainloop(s) we can access
    #

    # glib/dbus
    try:
        from dbus.mainloop.glib import DBusGMainLoop

        LOOP_GLIB = DBusGMainLoop()

    except ImportError:  # pragma: no cover
        # No problem
        pass

    # qt
    try:
        from dbus.mainloop.qt import DBusQtMainLoop

        LOOP_QT = DBusQtMainLoop(set_as_default=True)

    except ImportError:
        # No problem
        pass

    # We're good as long as at least one
    NOTIFY_DBUS_SUPPORT_ENABLED = LOOP_GLIB is not None or LOOP_QT is not None

    # ImportError: When using gi.repository you must not import static modules
    # like "gobject". Please change all occurrences of "import gobject" to
    # "from gi.repository import GObject".
    # See: https://bugzilla.gnome.org/show_bug.cgi?id=709183
    if "gobject" in sys.modules:  # pragma: no cover
        del sys.modules["gobject"]

    try:
        # The following is required for Image/Icon loading only
        import gi

        gi.require_version("GdkPixbuf", "2.0")
        from gi.repository import GdkPixbuf

        NOTIFY_DBUS_IMAGE_SUPPORT = True

    except (ImportError, ValueError, AttributeError):
        # No problem; this will get caught in outer try/catch

        # A ValueError will get thrown upon calling gi.require_version() if
        # GDK/GTK isn't installed on the system but gi is.
        pass

except ImportError:
    # No problem; we just simply can't support this plugin; we could
    # be in microsoft windows, or we just don't have the python-gobject
    # library available to us (or maybe one we don't support)?
    pass

# Define our supported protocols and the loop to assign them.
# The key to value pairs are the actual supported schema's matched
# up with the Main Loop they should reference when accessed.
MAINLOOP_MAP = {
    "qt": LOOP_QT,
    "kde": LOOP_QT,
    "dbus": LOOP_QT if LOOP_QT else LOOP_GLIB,
}


# Urgencies
class DBusUrgency:
    LOW = 0
    NORMAL = 1
    HIGH = 2


DBUS_URGENCIES = {
    # Note: This also acts as a reverse lookup mapping
    DBusUrgency.LOW: "low",
    DBusUrgency.NORMAL: "normal",
    DBusUrgency.HIGH: "high",
}

DBUS_URGENCY_MAP = {
    # Maps against string 'low'
    "l": DBusUrgency.LOW,
    # Maps against string 'moderate'
    "m": DBusUrgency.LOW,
    # Maps against string 'normal'
    "n": DBusUrgency.NORMAL,
    # Maps against string 'high'
    "h": DBusUrgency.HIGH,
    # Maps against string 'emergency'
    "e": DBusUrgency.HIGH,
    # Entries to additionally support (so more like DBus's API)
    "0": DBusUrgency.LOW,
    "1": DBusUrgency.NORMAL,
    "2": DBusUrgency.HIGH,
}


class NotifyDBus(NotifyBase):
    """A wrapper for local DBus/Qt Notifications."""

    # Set our global enabled flag
    enabled = NOTIFY_DBUS_SUPPORT_ENABLED

    requirements = {
        # Define our required packaging in order to work
        "details": _("libdbus-1.so.x must be installed.")
    }

    # The default descriptive name associated with the Notification
    service_name = _("DBus Notification")

    # The services URL
    service_url = "http://www.freedesktop.org/Software/dbus/"

    # The default protocols
    # Python 3 keys() does not return a list object, it is its own dict_keys()
    # object if we were to reference, we wouldn't be backwards compatible with
    # Python v2.  So converting the result set back into a list makes us
    # compatible
    protocol = list(MAINLOOP_MAP.keys())

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/dbus/"

    # No throttling required for DBus queries
    request_rate_per_sec = 0

    # Allows the user to specify the NotifyImageSize object
    image_size = NotifyImageSize.XY_128

    # The number of milliseconds to keep the message present for
    message_timeout_ms = 13000

    # Limit results to just the first 10 line otherwise there is just to much
    # content to display
    body_max_line_count = 10

    # The following are required to hook into the notifications:
    dbus_interface = "org.freedesktop.Notifications"
    dbus_setting_location = "/org/freedesktop/Notifications"

    # No URL Identifier will be defined for this service as there simply isn't
    # enough details to uniquely identify one dbus:// from another.
    url_identifier = False

    # Define object templates
    templates = ("{schema}://",)

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "urgency": {
                "name": _("Urgency"),
                "type": "choice:int",
                "values": DBUS_URGENCIES,
                "default": DBusUrgency.NORMAL,
            },
            "priority": {
                # Apprise uses 'priority' everywhere; it's just a nice
                # consistent feel to be able to use it here as well. Just map
                # the value back to 'priority'
                "alias_of": "urgency",
            },
            "x": {
                "name": _("X-Axis"),
                "type": "int",
                "min": 0,
                "map_to": "x_axis",
            },
            "y": {
                "name": _("Y-Axis"),
                "type": "int",
                "min": 0,
                "map_to": "y_axis",
            },
            "image": {
                "name": _("Include Image"),
                "type": "bool",
                "default": True,
                "map_to": "include_image",
            },
        },
    )

    def __init__(
        self,
        urgency=None,
        x_axis=None,
        y_axis=None,
        include_image=True,
        **kwargs,
    ):
        """Initialize DBus Object."""

        super().__init__(**kwargs)

        # Track our notifications
        self.registry = {}

        # Store our schema; default to dbus
        self.schema = kwargs.get("schema", "dbus")

        if self.schema not in MAINLOOP_MAP:
            msg = f"The schema specified ({self.schema}) is not supported."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # The urgency of the message
        self.urgency = int(
            NotifyDBus.template_args["urgency"]["default"]
            if urgency is None
            else next(
                (
                    v
                    for k, v in DBUS_URGENCY_MAP.items()
                    if str(urgency).lower().startswith(k)
                ),
                NotifyDBus.template_args["urgency"]["default"],
            )
        )

        # Our x/y axis settings
        if x_axis or y_axis:
            try:
                self.x_axis = int(x_axis)
                self.y_axis = int(y_axis)

            except (TypeError, ValueError):
                # Invalid x/y values specified
                msg = (
                    f"The x,y coordinates specified ({x_axis},{y_axis}) are"
                    " invalid."
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg) from None
        else:
            self.x_axis = None
            self.y_axis = None

        # Track whether we want to add an image to the notification.
        self.include_image = include_image

    def send(self, body, title="", notify_type=NotifyType.INFO, **kwargs):
        """Perform DBus Notification."""
        # Acquire our session
        try:
            session = SessionBus(mainloop=MAINLOOP_MAP[self.schema])

        except DBusException as e:
            # Handle exception
            self.logger.warning("Failed to send DBus notification.")
            self.logger.debug(f"DBus Exception: {e}")
            return False

        # If there is no title, but there is a body, swap the two to get rid
        # of the weird whitespace
        if not title:
            title = body
            body = ""

        # acquire our dbus object
        dbus_obj = session.get_object(
            self.dbus_interface,
            self.dbus_setting_location,
        )

        # Acquire our dbus interface
        dbus_iface = Interface(
            dbus_obj,
            dbus_interface=self.dbus_interface,
        )

        # image path
        icon_path = (
            None
            if not self.include_image
            else self.image_path(notify_type, extension=".ico")
        )

        # Our meta payload
        meta_payload = {"urgency": Byte(self.urgency)}

        if not (self.x_axis is None and self.y_axis is None):
            # Set x/y access if these were set
            meta_payload["x"] = self.x_axis
            meta_payload["y"] = self.y_axis

        if NOTIFY_DBUS_IMAGE_SUPPORT and icon_path:
            try:
                # Use Pixbuf to create the proper image type
                image = GdkPixbuf.Pixbuf.new_from_file(icon_path)

                # Associate our image to our notification
                meta_payload["icon_data"] = (
                    image.get_width(),
                    image.get_height(),
                    image.get_rowstride(),
                    image.get_has_alpha(),
                    image.get_bits_per_sample(),
                    image.get_n_channels(),
                    ByteArray(image.get_pixels()),
                )

            except Exception as e:
                self.logger.warning(
                    "Could not load notification icon (%s).", icon_path
                )
                self.logger.debug(f"DBus Exception: {e}")

        try:
            # Always call throttle() before any remote execution is made
            self.throttle()

            dbus_iface.Notify(
                # Application Identifier
                self.app_id,
                # Message ID (0 = New Message)
                0,
                # Icon (str) - not used
                "",
                # Title
                str(title),
                # Body
                str(body),
                # Actions
                [],
                # Meta
                meta_payload,
                # Message Timeout
                self.message_timeout_ms,
            )

            self.logger.info("Sent DBus notification.")

        except Exception as e:
            self.logger.warning("Failed to send DBus notification.")
            self.logger.debug(f"DBus Exception: {e}")
            return False

        return True

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any URL parameters
        params = {
            "image": "yes" if self.include_image else "no",
            "urgency": (
                DBUS_URGENCIES[self.template_args["urgency"]["default"]]
                if self.urgency not in DBUS_URGENCIES
                else DBUS_URGENCIES[self.urgency]
            ),
        }

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        # x in (x,y) screen coordinates
        # Use an explicit None check so a valid coordinate of 0 (a screen
        # edge) is preserved; this mirrors the send() payload which guards
        # on `is None` rather than truthiness.
        if self.x_axis is not None:
            params["x"] = str(self.x_axis)

        # y in (x,y) screen coordinates
        if self.y_axis is not None:
            params["y"] = str(self.y_axis)

        return f"{self.schema}://_/?{NotifyDBus.urlencode(params)}"

    @staticmethod
    def parse_url(url):
        """There are no parameters nessisary for this protocol; simply having
        gnome:// is all you need.

        This function just makes sure that is in place.
        """

        results = NotifyBase.parse_url(url, verify_host=False)

        # Include images with our message
        results["include_image"] = parse_bool(
            results["qsd"].get("image", True)
        )

        # DBus supports urgency, but we we also support the keyword priority
        # so that it is consistent with some of the other plugins
        if "priority" in results["qsd"] and len(results["qsd"]["priority"]):
            # We intentionally store the priority in the urgency section
            results["urgency"] = NotifyDBus.unquote(results["qsd"]["priority"])

        if "urgency" in results["qsd"] and len(results["qsd"]["urgency"]):
            results["urgency"] = NotifyDBus.unquote(results["qsd"]["urgency"])

        # handle x,y coordinates
        if "x" in results["qsd"] and len(results["qsd"]["x"]):
            results["x_axis"] = NotifyDBus.unquote(results["qsd"].get("x"))

        if "y" in results["qsd"] and len(results["qsd"]["y"]):
            results["y_axis"] = NotifyDBus.unquote(results["qsd"].get("y"))

        return results
caronc-apprise-dfec414/apprise/plugins/deltachat.py000066400000000000000000000117101526720371000225460ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Delta Chat reuses Email delivery and adds its chat-specific headers.
#
# Steps to set this up:
#  1. Get a mailbox for your bot. Any regular e-mail account works, but a
#     purpose-built "chatmail" relay (see https://chatmail.at/) is what
#     most Delta Chat users are already on.
#  2. Note the account's SMTP host, port, username, and password.
#  3. The person you want to notify must already have (or add) your bot's
#     address as a contact in Delta Chat; a first message from an unknown
#     address lands in their "Contact Requests" list until accepted.
#
#  Your Apprise URL should be assembled as:
#     deltachat://user:password@smtp.example.com/friend@example.org
#
# Many chatmail relays reject unencrypted mail outright, so consider
# pairing this with ?pgp=sign or ?pgp=encrypt. Email's PGP documentation
# applies here unchanged.
#
# Resources:
# - https://delta.chat/
# - https://github.com/deltachat/spec (the e-mail-chat protocol)
# - https://docs.autocrypt.org/level1.html (the Autocrypt header format)

from ..common import NotifyFormat, NotifyType
from .email.base import NotifyEmail, PGPMode

# Longest excerpt of the message body placed in the outer Subject header
DELTACHAT_SUBJECT_EXCERPT_LEN = 50


class NotifyDeltaChat(NotifyEmail):
    """Send Delta Chat messages through Email's SMTP and PGP support."""

    # The default descriptive name associated with the Notification
    service_name = "Delta Chat"

    # The services URL
    service_url = "https://delta.chat/"

    # The default protocol
    protocol = "deltachat"

    # The default secure protocol
    secure_protocol = "deltachats"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/deltachat/"

    # Delta Chat clients render messages as plain text
    notify_format = NotifyFormat.TEXT

    # Delta Chat has no separate subject/title field in the chat bubble
    # itself, so let the framework merge the title into the body for us
    title_maxlen = 0

    @staticmethod
    def parse_url(url):
        """Parse an Email URL while always selecting plain text."""
        results = NotifyEmail.parse_url(url)
        if results:
            results["format"] = "text"

        return results

    def send(
        self,
        body,
        title="",
        notify_type=NotifyType.INFO,
        attach=None,
        body_format=None,
        **kwargs,
    ):
        """Perform Delta Chat Notification."""

        # The framework has merged the title into the body. Build the chat
        # subject from that combined text.
        return super().send(
            body=body,
            title=self._chat_subject(body),
            notify_type=notify_type,
            attach=attach,
            body_format=body_format,
            **kwargs,
        )

    def _protocol_headers(self, body):
        """Return Delta Chat's protocol headers."""

        # Chat-Version is required by the spec on every outgoing message
        return {"Chat-Version": "1.0"}

    def _chat_subject(self, body):
        """Build a ``Chat:`` subject without exposing protected content."""

        if self.pgp_mode == PGPMode.ENCRYPT:
            # Delta Chat recommends this placeholder when encrypted metadata
            # is not carried with Memoryhole.
            return "Chat: Encrypted message"

        if self.pgp_mode == PGPMode.SIGN:
            return "Chat:"

        excerpt = " ".join(body.split())
        if len(excerpt) > DELTACHAT_SUBJECT_EXCERPT_LEN:
            excerpt = excerpt[:DELTACHAT_SUBJECT_EXCERPT_LEN] + "..."

        return f"Chat: {excerpt}" if excerpt else "Chat:"
caronc-apprise-dfec414/apprise/plugins/dingtalk.py000066400000000000000000000317141526720371000224200ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import base64
import hashlib
import hmac
from json import dumps
import re
import time
from typing import Any, Optional

import requests

from ..common import NotifyFormat, NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import parse_list, validate_regex
from .base import NotifyBase

# Register at https://dingtalk.com
#   - Download their PC based software as it is the only way you can create
#     a custom robot.  You can create a custom robot per group.  You will
#     be provided an access_token that Apprise will need.

# Syntax:
#  dingtalk://{access_token}/
#  dingtalk://{access_token}/{optional_phone_no}
#  dingtalk://{access_token}/{phone_no_1}/{phone_no_2}/{phone_no_N/

# Some Phone Number Detection
IS_PHONE_NO = re.compile(r"^\+?(?P[0-9\s)(+-]+)\s*$")


class NotifyDingTalk(NotifyBase):
    """A wrapper for DingTalk Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "DingTalk"

    # The services URL
    service_url = "https://www.dingtalk.com/"

    # All notification requests are secure
    secure_protocol = "dingtalk"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/dingtalk/"

    # DingTalk API
    notify_url = "https://oapi.dingtalk.com/robot/send?access_token={token}"

    # Keep the title separate so send() can place it consistently in both
    # text and Markdown messages.

    # DingTalk renders both plain text and markdown natively. Text is
    # listed first, making it the default when nothing else applies.
    notify_format = (NotifyFormat.TEXT, NotifyFormat.MARKDOWN)

    # Define object templates
    templates = (
        "{schema}://{token}/",
        "{schema}://{token}/{targets}/",
        "{schema}://{secret}@{token}/",
        "{schema}://{secret}@{token}/{targets}/",
    )

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "token": {
                "name": _("Token"),
                "type": "string",
                "private": True,
                "required": True,
                "regex": (r"^[a-z0-9]+$", "i"),
            },
            "secret": {
                "name": _("Secret"),
                "type": "string",
                "private": True,
                "regex": (r"^[a-z0-9]+$", "i"),
            },
            "target_phone_no": {
                "name": _("Target Phone No"),
                "type": "string",
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "to": {
                "alias_of": "targets",
            },
            "token": {
                "alias_of": "token",
            },
            "secret": {
                "alias_of": "secret",
            },
        },
    )

    def __init__(self, token, targets=None, secret=None, **kwargs):
        """Initialize DingTalk Object."""
        super().__init__(**kwargs)

        # Secret Key (associated with project)
        self.token = validate_regex(
            token, *self.template_tokens["token"]["regex"]
        )
        if not self.token:
            msg = f"An invalid DingTalk API Token ({token}) was specified."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        self.secret = None
        if secret:
            self.secret = validate_regex(
                secret, *self.template_tokens["secret"]["regex"]
            )
            if not self.secret:
                msg = f"An invalid DingTalk Secret ({token}) was specified."
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)

        # Parse our targets
        self.targets = []

        for target in parse_list(targets):
            # Validate targets and drop bad ones:
            result = IS_PHONE_NO.match(target)
            if result:
                # Further check our phone # for it's digit count
                result = "".join(re.findall(r"\d+", result.group("phone")))
                if len(result) < 11 or len(result) > 14:
                    self.logger.warning(
                        f"Dropped invalid phone # ({target}) specified.",
                    )
                    continue

                # store valid phone number
                self.targets.append(result)
                continue

            self.logger.warning(
                f"Dropped invalid phone # ({target}) specified.",
            )

        return

    def get_signature(self):
        """Calculates time-based signature so that we can send arbitrary
        messages."""
        timestamp = str(round(time.time() * 1000))
        secret_enc = self.secret.encode("utf-8")
        str_to_sign_enc = f"{timestamp}\n{self.secret}".encode()
        hmac_code = hmac.new(
            secret_enc, str_to_sign_enc, digestmod=hashlib.sha256
        ).digest()
        signature = NotifyDingTalk.quote(base64.b64encode(hmac_code), safe="")
        return timestamp, signature

    def send(
        self,
        body: str,
        title: str = "",
        notify_type: NotifyType = NotifyType.INFO,
        body_format: Optional[NotifyFormat] = None,
        **kwargs: Any,
    ) -> bool:
        """Perform DingTalk Notification."""

        payload = {
            "msgtype": "text",
            "at": {
                "atMobiles": self.targets,
                "isAtAll": False,
            },
        }

        if body_format == NotifyFormat.MARKDOWN:
            # Keep the title on one line and drop any leading heading or
            # list markers so it reads cleanly as a heading
            title = " ".join(title.split()).lstrip("#- ")

            # ``markdown.title`` is only a preview, so repeat the title as
            # a heading in ``markdown.text``.
            # See: https://open.dingtalk.com/document/app/
            #      custom-robot-access
            payload["markdown"] = {
                # A title is mandatory for markdown messages
                "title": title if title else self.app_desc,
                "text": f"# {title}\n{body}" if title else body,
            }
            payload["msgtype"] = "markdown"

        else:
            # Plain text has no title field, so the title goes on the
            # first line
            payload["text"] = {
                "content": f"{title}\r\n{body}" if title else body,
            }

        # Our Notification URL
        notify_url = self.notify_url.format(token=self.token)

        params = None
        if self.secret:
            timestamp, signature = self.get_signature()
            params = {
                "timestamp": timestamp,
                "sign": signature,
            }

        # Prepare our headers
        headers = {
            "User-Agent": self.app_id,
            "Content-Type": "application/json",
        }

        # Some Debug Logging
        self.logger.debug(
            "DingTalk URL:"
            f" {notify_url} (cert_verify={self.verify_certificate})"
        )
        self.logger.debug(f"DingTalk Payload: {payload}")

        # Always call throttle before any remote server i/o is made
        self.throttle()

        try:
            r = requests.post(
                notify_url,
                data=dumps(payload),
                headers=headers,
                params=params,
                verify=self.verify_certificate,
                timeout=self.request_timeout,
                allow_redirects=self.redirects,
            )

            if r.status_code != requests.codes.ok:
                # We had a problem
                status_str = NotifyDingTalk.http_response_code_lookup(
                    r.status_code
                )

                self.logger.warning(
                    "Failed to send DingTalk notification: "
                    "{}{}error={}.".format(
                        status_str, ", " if status_str else "", r.status_code
                    )
                )

                self.logger.debug(
                    "Response Details:\r\n%r", (r.content or b"")[:2000]
                )

                return False

            else:
                self.logger.info("Sent DingTalk notification.")

        except requests.RequestException as e:
            self.logger.warning(
                "A Connection error occured sending DingTalk notification."
            )
            self.logger.debug(f"Socket Exception: {e!s}")
            return False

        return True

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        # Define any arguments set. url_parameters() knows how to
        # serialize format= for a multi-format plugin; it is only
        # emitted when the user asked for an explicit override.
        args = self.url_parameters(privacy=privacy, *args, **kwargs)

        return "{schema}://{secret}{token}/{targets}/?{args}".format(
            schema=self.secure_protocol,
            secret=(
                ""
                if not self.secret
                else "{}@".format(
                    self.pprint(
                        self.secret, privacy, mode=PrivacyMode.Secret, safe=""
                    )
                )
            ),
            token=self.pprint(self.token, privacy, safe=""),
            targets="/".join(
                [NotifyDingTalk.quote(x, safe="") for x in self.targets]
            ),
            args=NotifyDingTalk.urlencode(args),
        )

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (self.secure_protocol, self.secret, self.token)

    def __len__(self):
        """Returns the number of targets associated with this notification."""
        targets = len(self.targets)
        return targets if targets > 0 else 1

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to
        substantiate this object."""
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        results["token"] = NotifyDingTalk.unquote(results["host"])

        # if a user has been defined, use it's value as the secret
        if results.get("user"):
            results["secret"] = results.get("user")

        # Get our entries; split_path() looks after unquoting content for us
        # by default
        results["targets"] = NotifyDingTalk.split_path(results["fullpath"])

        # Support the use of the `token` keyword argument
        if "token" in results["qsd"] and len(results["qsd"]["token"]):
            results["token"] = NotifyDingTalk.unquote(results["qsd"]["token"])

        # Support the use of the `secret` keyword argument
        if "secret" in results["qsd"] and len(results["qsd"]["secret"]):
            results["secret"] = NotifyDingTalk.unquote(
                results["qsd"]["secret"]
            )

        # Support the 'to' variable so that we can support targets this way too
        # The 'to' makes it easier to use yaml configuration
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyDingTalk.parse_list(
                results["qsd"]["to"]
            )

        return results
caronc-apprise-dfec414/apprise/plugins/discord.py000066400000000000000000001304771526720371000222600ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# For this to work correctly you need to create a webhook. To do this just
# click on the little gear icon next to the channel you're part of. From
# here you'll be able to access the Webhooks menu and create a new one.
#
#  When you've completed, you'll get a URL that looks a little like this:
#  https://discord.com/api/webhooks/417429632418316298/\
#         JHZ7lQml277CDHmQKMHI8qBe7bk2ZwO5UKjCiOAF7711o33MyqU344Qpgv7YTpadV_js
#
#  Simplified, it looks like this:
#     https://discord.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN
#
#  This plugin will simply work using the url of:
#     discord://WEBHOOK_ID/WEBHOOK_TOKEN
#
# API Documentation on Webhooks:
#    - https://discord.com/developers/docs/resources/webhook
#
from __future__ import annotations

from datetime import datetime, timedelta, timezone
from itertools import chain
from json import dumps, loads
from json.decoder import JSONDecodeError
import re
from typing import Any

import requests

from ..apprise_attachment import AppriseAttachment
from ..attachment.base import AttachBase
from ..common import NotifyFormat, NotifyImageSize, NotifyType
from ..conversion import commonmark_sections
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..utils.parse import parse_bool, parse_list, validate_regex
from ..utils.templates import TemplateType, apply_template
from .base import NotifyBase

# Used to detect user/role IDs and @here/@everyone tokens.
USER_ROLE_DETECTION_RE = re.compile(
    r"\s*(?:&?)(?P[0-9]+)>?|@(?P[a-z0-9]+))", re.I
)

# Discord draws any :name: it recognizes as an emoji, even in the middle
# of a word, so 2001:db8:100::1 would show an emoji in place of :100:.
# This finds every colon that opens a :name: so it can be escaped.  These
# are stepped over and left exactly as they are:
#  - Characters that are already escaped.
#  - Code, where Discord never draws emoji.
#  - Discord tokens such as <:party:123>,  and <@123>.
#  - Web links, so an address like http://[fe80::1:2]/ keeps working.
DISCORD_EMOJI_ESCAPE_RE = re.compile(
    r"(?P\\.|(?P`+).+?(?P=tick)|<[^<>\s]*>"
    r"|(?i:https?)://\S+)"
    r"|:(?=[a-z0-9_+-]+:)",
    re.S,
)


class NotifyDiscord(NotifyBase):
    """A wrapper to Discord Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "Discord"

    # The services URL
    service_url = "https://discord.com/"

    # The default secure protocol
    secure_protocol = "discord"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/discord/"

    # Discord Webhook
    notify_url = "https://discord.com/api/webhooks"

    # Discord supports plain text and Markdown-style embeds. Plain text
    # remains the default.
    notify_format = (NotifyFormat.TEXT, NotifyFormat.MARKDOWN)

    # Support attachments
    attachment_support = True

    # Allows the user to specify the NotifyImageSize object
    image_size = NotifyImageSize.XY_256

    # Discord is kind enough to return how many more requests we're allowed to
    # continue to make within it's header response as:
    # X-RateLimit-Reset: The epoc time (in seconds) we can expect our
    #                    rate-limit to be reset.
    # X-RateLimit-Remaining: an integer identifying how many requests we're
    #                        still allow to make.
    request_rate_per_sec = 0

    # Taken right from google.auth.helpers:
    clock_skew = timedelta(seconds=10)

    # The maximum allowable characters allowed in the body per message
    body_maxlen = 2000

    # The 2000 characters above defined by the body_maxlen include that of the
    # title.  Setting this to True ensures overflow options behave properly
    overflow_amalgamate_title = True

    # Discord has a limit of the number of fields you can include in an
    # embeds message. This value allows the discord message to safely
    # break into multiple messages to handle these cases.
    discord_max_fields = 10

    # Discord limits the length of each embed field name and value; see
    # https://docs.discord.com/developers/resources/message
    discord_field_name_maxlen = 256
    discord_field_value_maxlen = 1024

    # There is no reason we should exceed 35KB when reading in a JSON
    # file. If it is more than this, then it is not accepted
    max_discord_template_size = 35000

    # Maximum number of attachments Discord accepts in a single message
    discord_max_attachments = 10

    # Maximum total attachment bytes per message.
    # Discord's documented default is 25 MiB for most users.
    discord_max_attach_bytes = 25 * 1024 * 1024

    # Define object templates
    templates = (
        "{schema}://{webhook_id}/{webhook_token}",
        "{schema}://{botname}@{webhook_id}/{webhook_token}",
    )

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "botname": {
                "name": _("Bot Name"),
                "type": "string",
                "map_to": "user",
            },
            "webhook_id": {
                "name": _("Webhook ID"),
                "type": "string",
                "private": True,
                "required": True,
            },
            "webhook_token": {
                "name": _("Webhook Token"),
                "type": "string",
                "private": True,
                "required": True,
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "tts": {
                "name": _("Text To Speech"),
                "type": "bool",
                "default": False,
            },
            "avatar": {
                "name": _("Avatar Image"),
                "type": "bool",
                "default": True,
            },
            "avatar_url": {
                "name": _("Avatar URL"),
                "type": "string",
            },
            "href": {
                "name": _("URL"),
                "type": "string",
            },
            "url": {
                "alias_of": "href",
            },
            # Send a message to the specified thread within a webhook's
            # channel. The thread will automatically be unarchived.
            "thread": {
                "name": _("Thread ID"),
                "type": "string",
            },
            "footer": {
                "name": _("Display Footer"),
                "type": "bool",
                "default": False,
            },
            "footer_logo": {
                "name": _("Footer Logo"),
                "type": "bool",
                "default": True,
            },
            "fields": {
                "name": _("Use Fields"),
                "type": "bool",
                "default": True,
            },
            "flags": {
                "name": _("Discord Flags"),
                "type": "int",
                "min": 0,
            },
            "image": {
                "name": _("Include Image"),
                "type": "bool",
                "default": False,
                "map_to": "include_image",
            },
            # Explicit ping targets. Examples:
            #  - ping=12345,67890
            #  - ping=<@12345>,<@&67890>,@here
            "ping": {
                "name": _("Ping Users/Roles"),
                "type": "list:string",
            },
            "template": {
                "name": _("Template Path"),
                "type": "string",
                "private": True,
            },
            # When True (default) multiple attachments are grouped into
            # batches and sent in a single message where possible.
            # Set to no/false to revert to one attachment per message.
            "batch": {
                "name": _("Batch Attachments"),
                "type": "bool",
                "default": True,
            },
        },
    )

    # Define our token control
    template_kwargs = {
        "tokens": {
            "name": _("Template Tokens"),
            "prefix": ":",
        },
    }

    def __init__(
        self,
        webhook_id: str,
        webhook_token: str,
        tts: bool = False,
        avatar: bool = True,
        footer: bool = False,
        footer_logo: bool = True,
        include_image: bool = False,
        fields: bool = True,
        avatar_url: str | None = None,
        href: str | None = None,
        thread: str | None = None,
        flags: int | None = None,
        ping: list[str] | None = None,
        template: str | None = None,
        tokens: dict | None = None,
        batch: bool | None = None,
        **kwargs: Any,
    ) -> None:
        """Initialize Discord Object."""
        super().__init__(**kwargs)

        # Webhook ID (associated with project)
        self.webhook_id = validate_regex(webhook_id)
        if not self.webhook_id:
            msg = (
                f"An invalid Discord Webhook ID ({webhook_id}) was specified."
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Webhook Token (associated with project)
        self.webhook_token = validate_regex(webhook_token)
        if not self.webhook_token:
            msg = (
                "An invalid Discord Webhook Token "
                f"({webhook_token}) was specified."
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Text To Speech
        self.tts = tts

        # Over-ride Avatar Icon
        self.avatar = avatar

        # Place a footer
        self.footer = footer

        # include a footer_logo in footer
        self.footer_logo = footer_logo

        # Place a thumbnail image inline with the message body
        self.include_image = include_image

        # Use Fields
        self.fields = fields

        # Specified Thread ID
        self.thread_id = thread

        # Avatar URL
        # This allows a user to provide an over-ride to the otherwise
        # dynamically generated avatar url images
        self.avatar_url = avatar_url

        # A URL to have the title link to
        self.href = href

        # A URL to have the title link to
        if flags:
            try:
                self.flags = int(flags)
                if self.flags < NotifyDiscord.template_args["flags"]["min"]:
                    raise ValueError()

            except (TypeError, ValueError):
                msg = (
                    f"An invalid Discord flags setting ({flags}) was "
                    "specified."
                )
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg) from None
        else:
            self.flags = None

        # Ping targets (tokens from URL, already split by parse_list)
        self.ping: list[str] = parse_list(ping)

        # When True, group multiple attachments into a single message
        # where count and size limits allow; False reverts to one per
        # message (old behaviour)
        self.batch = (
            self.template_args["batch"]["default"]
            if batch is None
            else parse_bool(
                batch,
                default=self.template_args["batch"]["default"],
            )
        )

        self.ratelimit_reset = datetime.now(timezone.utc).replace(tzinfo=None)

        # Default to 1.0
        self.ratelimit_remaining = 1.0

        # Our template object is just an AppriseAttachment object
        self.template = AppriseAttachment(asset=self.asset)
        if template:
            # Add our definition to our template
            self.template.add(template)
            if not len(self.template):
                # add() failed (unsupported schema, unparseable URL, etc.)
                msg = "The Discord template specified could not be loaded."
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)

            # Enforce maximum file size
            self.template[0].max_file_size = self.max_discord_template_size

        # Template functionality
        self.tokens: dict = {}
        if isinstance(tokens, dict):
            self.tokens.update(tokens)

        elif tokens:
            msg = (
                "The specified Discord Template Tokens "
                f"({tokens}) are not identified as a dictionary."
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # else: NoneType - this is okay

        return

    def gen_payload(
        self, body, title="", notify_type=NotifyType.INFO, **kwargs
    ):
        """Return a validated Discord webhook payload from template,
        or False on failure."""

        # Acquire the first template attachment
        template = self.template[0]
        if not template:
            # We could not access the attachment
            self.logger.error(
                "Could not access Discord template"
                f" {template.url(privacy=True)}."
            )
            return False

        # Acquire our image URL for potential token substitution
        image_url = self.image_url(notify_type)

        # Take a copy of our token dictionary
        tokens = self.tokens.copy()

        # Apply our standard template variable defaults
        tokens["app_body"] = body
        tokens["app_title"] = title
        tokens["app_type"] = notify_type.value
        tokens["app_id"] = self.app_id
        tokens["app_desc"] = self.app_desc
        tokens["app_color"] = self.color(notify_type)
        # app_color_hex is an explicit alias for app_color, provided so
        # templates can name the hex variant unambiguously alongside
        # app_color_int
        tokens["app_color_hex"] = self.color(notify_type)
        # Discord embed payloads require color as a decimal integer;
        # app_color_int provides that while app_color stays hex for
        # consistency with all other template-capable plugins
        tokens["app_color_int"] = self.color(notify_type, int)
        tokens["app_image_url"] = image_url
        tokens["app_url"] = self.app_url

        # Templates are always JSON; enforce JSON escaping
        tokens["app_mode"] = TemplateType.JSON

        # Stringify substitutions before JSON escaping; preserve app_mode
        safe_tokens = {
            k: (
                v
                if k == "app_mode" or isinstance(v, str)
                else ("" if v is None else str(v))
            )
            for k, v in tokens.items()
        }

        try:
            with open(template.path) as fp:
                content = apply_template(fp.read(), **safe_tokens)

        except OSError:
            self.logger.error(
                "Discord template"
                f" {template.url(privacy=True)} could not be read."
            )
            return False

        # Parse and validate as JSON
        try:
            content = loads(content)

        except (JSONDecodeError, ValueError) as e:
            self.logger.error(
                "Discord template"
                f" {template.url(privacy=True)} contains invalid JSON."
            )
            self.logger.debug(f"JSONDecodeError: {e}")
            return False

        # Template must parse to a JSON object, not an array or scalar
        if not isinstance(content, dict):
            self.logger.error(
                "Discord template"
                f" {template.url(privacy=True)} must be a JSON object"
                " (got {}).".format(type(content).__name__)
            )
            return False

        # A Discord webhook payload must have a non-empty 'content' string
        # or a non-empty 'embeds' list containing embed dicts
        has_content = (
            isinstance(content.get("content"), str) and content["content"]
        )
        has_embeds = (
            isinstance(content.get("embeds"), list) and content["embeds"]
        )
        if not (has_content or has_embeds):
            self.logger.error(
                "Discord template"
                f" {template.url(privacy=True)} must contain"
                " a non-empty 'content' string or a non-empty 'embeds'"
                " list."
            )
            return False

        # If embeds is present, each entry must be a JSON object (dict)
        if has_embeds and not all(
            isinstance(e, dict) for e in content["embeds"]
        ):
            self.logger.error(
                "Discord template"
                f" {template.url(privacy=True)} contains"
                " an embed entry that is not a JSON object."
            )
            return False

        # Return the validated payload content dict
        return content

    def dialect_convert(
        self,
        body: str,
        body_format: NotifyFormat | None = None,
        *args: Any,
        **kwargs: Any,
    ) -> str:
        """Escape each ``:name:`` so Discord shows it as text.

        This only happens when emoji support is turned off.
        """
        if self.interpret_emojis is not False:
            # Left unset, Discord draws emoji as it always has.  Turned on,
            # Apprise already converted the names it knows and Discord is
            # free to draw the rest.
            return body

        # Discord shows \: as a plain colon, in text and markdown alike.
        return DISCORD_EMOJI_ESCAPE_RE.sub(
            lambda m: m.group("skip") or "\\:", body
        )

    def send(
        self,
        body: str,
        title: str = "",
        notify_type: NotifyType = NotifyType.INFO,
        attach: list[AttachBase] | None = None,
        body_format: NotifyFormat | None = None,
        **kwargs: Any,
    ) -> bool:
        """Perform Discord Notification."""

        # body_format arrives as the resolved render target.

        if title and not kwargs.get("body_passthrough"):
            # The title skips dialect_convert(), so protect it here too.
            title = self.dialect_convert(title)

        # Use embeds only when the URL explicitly selects Markdown. Discord
        # already renders Markdown sent as regular content.
        use_embeds = self._format_override == NotifyFormat.MARKDOWN

        payload: dict[str, Any] = {
            "tts": self.tts,
            # If Text-To-Speech is set to True, then we do not want to wait
            # for the whole message before continuing. Otherwise, we wait
            "wait": self.tts is False,
        }

        if self.flags:
            # Set our flag if defined:
            payload["flags"] = self.flags

        # Acquire image_url
        image_url = self.image_url(notify_type)

        if self.avatar and (image_url or self.avatar_url):
            payload["avatar_url"] = (
                self.avatar_url if self.avatar_url else image_url
            )

        if self.user:
            # Optionally override the default username of the webhook
            payload["username"] = self.user

        # Associate our thread_id with our message
        params = {"thread_id": self.thread_id} if self.thread_id else None

        # Template mode bypasses ping detection and embed construction;
        # the template defines the complete payload content.
        if not self.template:
            # Embed mode can detect pings; ping= is additive there and
            # explicit for regular content.
            if use_embeds:
                if self.ping:
                    payload.update(
                        self.ping_payload(body, " ".join(self.ping))
                    )
                else:
                    payload.update(self.ping_payload(body))

            # Regular content: no body parsing, ping= is exclusive.
            elif self.ping:
                payload.update(self.ping_payload(" ".join(self.ping)))

        if self.template:
            # Generate our payload from the user-supplied template file
            template_payload = self.gen_payload(
                body=body,
                title=title,
                notify_type=notify_type,
                **kwargs,
            )
            if template_payload is False:
                # gen_payload() already logged the error; bail early
                return False

            # Merge template content over our base payload
            payload.update(template_payload)

            # Skip the message if an earlier attempt already posted it
            if not self.is_delivered("message"):
                if not self._send(payload, params=params):
                    # We failed to post our message
                    return False

                # Posted; a retry can safely skip it
                self.mark_delivered("message")

        elif body:
            # Track extra embed fields (if used)
            fields: list[dict[str, str]] = []

            if use_embeds:
                # Use embeds for payload
                payload["embeds"] = [
                    {
                        "author": {
                            "name": self.app_id,
                            "url": self.app_url,
                        },
                        "title": title,
                        "description": body,
                        # Our color associated with our notification
                        "color": self.color(notify_type, int),
                    }
                ]

                if self.href:
                    payload["embeds"][0]["url"] = self.href

                if self.footer:
                    # Acquire logo URL
                    logo_url = self.image_url(notify_type, logo=True)

                    # Set Footer text to our app description
                    payload["embeds"][0]["footer"] = {
                        "text": self.app_desc,
                    }

                    if self.footer_logo and logo_url:
                        payload["embeds"][0]["footer"]["icon_url"] = logo_url

                if self.include_image and image_url:
                    payload["embeds"][0]["thumbnail"] = {
                        "url": image_url,
                        "height": 256,
                        "width": 256,
                    }

                if self.fields:
                    # Break titles out so that we can sort them in embeds
                    description, fields = self.extract_markdown_sections(body)

                    # Swap first entry for description
                    payload["embeds"][0]["description"] = description
                    if fields:
                        # Apply our additional parsing for a better
                        # presentation
                        payload["embeds"][0]["fields"] = fields[
                            : self.discord_max_fields
                        ]
                        fields = fields[self.discord_max_fields :]

            else:
                # TEXT, HTML, or markdown without an explicit request:
                # - No ping detection unless ping= was provided.
                # - If ping= was provided, ping_payload() already generated
                #   payload["content"] starting with "👉 ...", and we
                #   append it.
                payload["content"] = (
                    body if not title else f"{title}\r\n{body}"
                ) + payload.get("content", "")

            # Skip the message if an earlier attempt already posted it
            if not self.is_delivered("message"):
                if not self._send(payload, params=params):
                    # We failed to post our message
                    return False

                # Posted; a retry can safely skip it
                self.mark_delivered("message")

            # Send remaining fields (if any)
            if fields:
                payload["embeds"][0]["description"] = ""
                for i in range(0, len(fields), self.discord_max_fields):
                    # Each extra message of fields is tracked on its own
                    if self.is_delivered(("fields", i)):
                        continue

                    payload["embeds"][0]["fields"] = fields[
                        i : i + self.discord_max_fields
                    ]
                    if not self._send(payload, params=params):
                        # We failed to post our message
                        return False

                    # Posted; a retry can safely skip these fields
                    self.mark_delivered(("fields", i))

        if attach and self.attachment_support:
            # Update our payload; the idea is to preserve it's other detected
            # and assigned values for re-use here too
            payload.update(
                {
                    # Text-To-Speech
                    "tts": False,
                    # Wait until the upload has posted itself before continuing
                    "wait": True,
                }
            )

            #
            # Remove our text/title based content for attachment use
            #
            payload.pop("embeds", None)
            payload.pop("content", None)
            payload.pop("allow_mentions", None)

            #
            # Build attachment batches in strict serial order.
            # Each batch respects the per-message attachment count and
            # total byte limits.  When batch=False every attachment is
            # its own message (legacy one-per-message behaviour).
            #
            max_per = self.discord_max_attachments if self.batch else 1

            batches: list[list[AttachBase]] = []
            current: list[AttachBase] = []
            current_size = 0

            for attachment in attach:
                # Size is only needed for byte-limit batching; skip the
                # stat()/download() it triggers when batching is off
                size = (
                    (len(attachment) if attachment else 0) if self.batch else 0
                )

                if current and (
                    len(current) >= max_per
                    or (
                        self.batch
                        and current_size + size > self.discord_max_attach_bytes
                    )
                ):
                    # Current batch is full; flush and start a new one
                    batches.append(current)
                    current = []
                    current_size = 0

                current.append(attachment)
                current_size += size

            # current always holds at least the last attachment here
            batches.append(current)

            #
            # Send each attachment batch
            #
            for index, batch in enumerate(batches):
                # Skip a batch an earlier attempt already posted
                if self.is_delivered(("attach", index)):
                    continue

                if not self._send(payload, params=params, attach=batch):
                    # We failed to post our attachment batch
                    return False

                # Posted; a retry can safely skip this batch
                self.mark_delivered(("attach", index))

        # Otherwise return
        return True

    def _send(
        self,
        payload: dict[str, Any],
        attach: list[AttachBase] | None = None,
        params: dict[str, str] | None = None,
        rate_limit: int = 1,
        **kwargs: Any,
    ) -> bool:
        """Wrapper to the requests (post) object."""

        # Our headers
        headers = {
            "User-Agent": self.app_id,
        }

        # Construct Notify URL
        notify_url = (
            f"{self.notify_url}/{self.webhook_id}/{self.webhook_token}"
        )

        self.logger.debug(
            "Discord POST URL:"
            f" {notify_url} (cert_verify={self.verify_certificate!r})"
        )
        self.logger.debug(f"Discord Payload: {payload!s}")

        wait: float | None = None

        if self.ratelimit_remaining <= 0.0:
            # Determine how long we should wait for or if we should wait at
            # all. This isn't fool-proof because we can't be sure the client
            # time (calling this script) is completely synced up with the
            # Discord server.  One would hope we're on NTP and our clocks are
            # the same allowing this to role smoothly:

            now = datetime.now(timezone.utc).replace(tzinfo=None)
            if now < self.ratelimit_reset:
                # We need to throttle for the difference in seconds
                wait = abs(
                    (
                        self.ratelimit_reset - now + self.clock_skew
                    ).total_seconds()
                )

        # Always call throttle before any remote server i/o is made;
        self.throttle(wait=wait)

        # File handles opened for this call; all closed in `finally`
        handles: list[Any] = []
        # Multipart file list built from the attach batch
        files: list[Any] | None = None
        attach_ok = True

        try:
            # Open our attachment path(s) if required:
            if attach:
                files = []
                for idx, attachment in enumerate(attach):
                    # Verify accessibility before opening
                    if not attachment:
                        self.logger.warning(
                            "Could not access Discord attachment %s.",
                            attachment.url(privacy=True),
                        )
                        attach_ok = False
                        break

                    self.logger.debug(
                        "Posting Discord attachment %s",
                        attachment.url(privacy=True),
                    )

                    # Catch OSError per attachment open
                    try:
                        handle = attachment.open()
                    except OSError as e:
                        self.logger.warning(
                            "An I/O error occurred while reading %s.",
                            attachment.name or "attachment",
                        )
                        self.logger.debug("I/O Exception: %s", str(e))
                        attach_ok = False
                        break

                    # Register handle before appending to files
                    handles.append(handle)
                    files.append(
                        (
                            f"files[{idx}]",
                            (
                                attachment.name,
                                handle,
                                attachment.mimetype,
                            ),
                        )
                    )

                if not attach_ok:
                    return False

            else:
                headers["Content-Type"] = "application/json; charset=utf-8"

            r = requests.post(
                notify_url,
                params=params,
                data=(
                    {"payload_json": dumps(payload)}
                    if files
                    else dumps(payload)
                ),
                headers=headers,
                files=files,
                verify=self.verify_certificate,
                timeout=self.request_timeout,
                allow_redirects=self.redirects,
            )

            # Handle rate limiting (if specified)
            try:
                # Store our rate limiting (if provided)
                self.ratelimit_remaining = float(
                    r.headers.get("X-RateLimit-Remaining")
                )
                self.ratelimit_reset = datetime.fromtimestamp(
                    int(r.headers.get("X-RateLimit-Reset")), timezone.utc
                ).replace(tzinfo=None)

            except (TypeError, ValueError):
                # This is returned if we could not retrieve this
                # information gracefully accept this state and move on
                pass

            if r.status_code not in (
                requests.codes.ok,
                requests.codes.no_content,
            ):
                # We had a problem
                status_str = NotifyBase.http_response_code_lookup(
                    r.status_code
                )

                if (
                    r.status_code == requests.codes.too_many_requests
                    and rate_limit > 0
                ):
                    # handle rate limiting
                    self.logger.warning(
                        "Discord rate limiting in effect; "
                        "blocking for %.2f second(s)",
                        self.ratelimit_remaining,
                    )

                    # Try one more time before failing
                    return self._send(
                        payload=payload,
                        attach=attach,
                        params=params,
                        rate_limit=rate_limit - 1,
                        **kwargs,
                    )

                self.logger.warning(
                    "Failed to send Discord %s: %s%serror=%s.",
                    (
                        "{} attachment(s)".format(len(attach))
                        if attach
                        else "notification"
                    ),
                    status_str,
                    ", " if status_str else "",
                    r.status_code,
                )

                self.logger.debug(
                    "Response Details:\r\n%r", (r.content or b"")[:2000]
                )

                # Return; we're done
                return False

            else:
                if attach:
                    self.logger.info(
                        "Sent Discord %d attachment(s).", len(attach)
                    )
                else:
                    self.logger.info("Sent Discord notification.")

        except requests.RequestException as e:
            self.logger.warning(
                "A Connection error occurred posting to Discord."
            )
            self.logger.debug(f"Socket Exception: {e!s}")
            return False

        except OSError as e:
            # Catches I/O errors from requests.post() and any unexpected
            # file-system errors not caught by the per-attachment check above
            self.logger.warning("An I/O error occurred posting to Discord.")
            self.logger.debug(f"I/O Exception: {e!s}")
            return False

        finally:
            # Close all handles regardless of success or failure
            for handle in handles:
                handle.close()

        return True

    def url(self, privacy: bool = False, *args: Any, **kwargs: Any) -> str:
        """Returns the URL built dynamically based on specified arguments."""

        params: dict[str, str] = {
            "tts": "yes" if self.tts else "no",
            "avatar": "yes" if self.avatar else "no",
            "footer": "yes" if self.footer else "no",
            "footer_logo": "yes" if self.footer_logo else "no",
            "image": "yes" if self.include_image else "no",
            "fields": "yes" if self.fields else "no",
            "batch": "yes" if self.batch else "no",
        }

        if self.avatar_url:
            params["avatar_url"] = self.avatar_url

        if self.flags:
            params["flags"] = str(self.flags)

        if self.href:
            params["href"] = self.href

        if self.thread_id:
            params["thread"] = self.thread_id

        if self.ping:
            # Let Apprise urlencode handle list formatting
            params["ping"] = ",".join(self.ping)

        if self.template:
            # Include our template reference
            params["template"] = NotifyDiscord.quote(
                self.template[0].url(), safe=""
            )

        # Store any template token entries if specified
        params.update({f":{k}": v for k, v in self.tokens.items()})

        # Ensure our botname is set
        botname = (
            f"{NotifyDiscord.quote(self.user, safe='')}@" if self.user else ""
        )

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        return (
            "{schema}://{bname}{webhook_id}/{webhook_token}/?{params}".format(
                schema=self.secure_protocol,
                bname=botname,
                webhook_id=self.pprint(self.webhook_id, privacy, safe=""),
                webhook_token=self.pprint(
                    self.webhook_token, privacy, safe=""
                ),
                params=NotifyDiscord.urlencode(params),
            )
        )

    @property
    def url_identifier(self) -> tuple[str, str, str]:
        """Returns all of the identifiers that make this URL unique."""
        return (self.secure_protocol, self.webhook_id, self.webhook_token)

    @staticmethod
    def parse_url(url: str) -> dict[str, Any] | None:
        """Parses the URL and returns arguments for instantiating this object.

        Syntax:
          discord://webhook_id/webhook_token
        """
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # Store our webhook ID
        webhook_id = NotifyDiscord.unquote(results["host"])

        # Now fetch our tokens
        try:
            webhook_token = NotifyDiscord.split_path(results["fullpath"])[0]

        except IndexError:
            # Force some bad values that will get caught
            # in parsing later
            webhook_token = None

        results["webhook_id"] = webhook_id
        results["webhook_token"] = webhook_token

        # Text To Speech
        results["tts"] = parse_bool(results["qsd"].get("tts", False))

        # Use sections
        # effectively detect multiple fields and break them off
        # into sections
        results["fields"] = parse_bool(results["qsd"].get("fields", True))

        # Use Footer
        results["footer"] = parse_bool(results["qsd"].get("footer", False))

        # Use Footer Logo
        results["footer_logo"] = parse_bool(
            results["qsd"].get("footer_logo", True)
        )

        # Update Avatar Icon
        results["avatar"] = parse_bool(results["qsd"].get("avatar", True))

        # Boolean to include an image or not
        results["include_image"] = parse_bool(
            results["qsd"].get(
                "image", NotifyDiscord.template_args["image"]["default"]
            )
        )

        if "botname" in results["qsd"]:
            # Alias to User
            results["user"] = NotifyDiscord.unquote(results["qsd"]["botname"])

        if "flags" in results["qsd"]:
            # Alias to User
            results["flags"] = NotifyDiscord.unquote(results["qsd"]["flags"])

        # Extract avatar url if it was specified
        if "avatar_url" in results["qsd"]:
            results["avatar_url"] = NotifyDiscord.unquote(
                results["qsd"]["avatar_url"]
            )

        # Extract url if it was specified
        if "href" in results["qsd"]:
            results["href"] = NotifyDiscord.unquote(results["qsd"]["href"])

        elif "url" in results["qsd"]:
            results["href"] = NotifyDiscord.unquote(results["qsd"]["url"])
            # Markdown is implied
            results["format"] = NotifyFormat.MARKDOWN

        # Extract thread id if it was specified
        if "thread" in results["qsd"]:
            results["thread"] = NotifyDiscord.unquote(results["qsd"]["thread"])
            # Markdown is implied
            results["format"] = NotifyFormat.MARKDOWN

        # Extract ping targets, comma/space separated
        if "ping" in results["qsd"]:
            results["ping"] = NotifyDiscord.unquote(results["qsd"]["ping"])

        # Template Handling
        if "template" in results["qsd"] and results["qsd"]["template"]:
            results["template"] = NotifyDiscord.unquote(
                results["qsd"]["template"]
            )

        # Store our template tokens
        results["tokens"] = results["qsd:"]

        # Batch attachments flag
        results["batch"] = parse_bool(
            results["qsd"].get(
                "batch",
                NotifyDiscord.template_args["batch"]["default"],
            )
        )

        return results

    @staticmethod
    def parse_native_url(url: str) -> dict[str, Any] | None:
        """
        Support https://discord.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN
        Support Legacy URL as well:
            https://discordapp.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN
        """

        result = re.match(
            r"^https?://discord(app)?\.com/api/webhooks/"
            r"(?P[0-9]+)/"
            r"(?P[A-Z0-9_-]+)/?"
            r"(?P\?.+)?$",
            url,
            re.I,
        )

        if result:
            return NotifyDiscord.parse_url(
                "{schema}://{webhook_id}/{webhook_token}/{params}".format(
                    schema=NotifyDiscord.secure_protocol,
                    webhook_id=result.group("webhook_id"),
                    webhook_token=result.group("webhook_token"),
                    params=(
                        ""
                        if not result.group("params")
                        else result.group("params")
                    ),
                )
            )

        return None

    def ping_payload(self, *args: str) -> dict[str, Any]:
        """
        Takes one or more strings and applies the payload associated with
        pinging the users detected within.

        This returns a dict that may contain:
          - allow_mentions
          - content (starting with "👉 " and containing mention tokens)
        """

        payload: dict[str, Any] = {}

        roles: set[str] = set()
        users: set[str] = set()
        parse: set[str] = set()

        for arg in args:
            # parse for user id's <@123> and role IDs <@&456>
            results = USER_ROLE_DETECTION_RE.findall(arg)
            if not results:
                continue

            for is_role, no, value in results:
                if value:
                    parse.add(value)

                elif is_role:
                    roles.add(no)

                else:  # is_user
                    users.add(no)

        if not (roles or users or parse):
            # Nothing to add
            return payload

        payload["allow_mentions"] = {
            "parse": list(parse),
            "users": list(users),
            "roles": list(roles),
        }

        payload["content"] = "👉 " + " ".join(
            chain(
                [f"@{value}" for value in parse],
                [f"<@&{value}>" for value in roles],
                [f"<@{value}>" for value in users],
            )
        )

        return payload

    @classmethod
    def extract_markdown_sections(
        cls,
        markdown: str,
    ) -> tuple[str, list[dict[str, str]]]:
        """Extract headers and their corresponding sections into embed
        fields."""

        # Room left for a section's text once the code block markers
        # ("```md\n" and "\n```") are wrapped around it
        description, sections = commonmark_sections(
            markdown,
            cls.discord_field_name_maxlen,
            cls.discord_field_value_maxlen - 10,
        )

        # Show each section as a code block.  An empty one stays empty.
        fields = [
            {
                "name": name,
                "value": "```md\n{}\n```".format(value.rstrip())
                if value
                else "```\n```",
            }
            for name, value in sections
        ]

        return description, fields
caronc-apprise-dfec414/apprise/plugins/dot.py000066400000000000000000000503061526720371000214070ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

#
# API: https://dot.mindreset.tech/docs/service/open/text_api
#      https://dot.mindreset.tech/docs/service/open/image_api
#
# New API endpoints (v2):
#   - Text API: /api/authV2/open/device/:deviceId/text
#   - Image API: /api/authV2/open/device/:deviceId/image
#
# Note: Old endpoints (/api/open/text and /api/open/image) are deprecated
# and will be removed in the future. Requests are automatically forwarded
# to the new endpoints.
#
# Text API Fields:
#   - refreshNow (bool, optional, default true): controls display timing.
#   - title (string, optional): title text shown on screen.
#   - message (string, optional): body text shown on screen.
#   - signature (string, optional): footer/signature text.
#   - icon (string, optional): base64 PNG icon (40px x 40px).
#   - link (string, optional): tap-to-interact target URL.
#   - taskKey (string, optional): specify which text API content to update.
#
# Image API Fields:
#   - refreshNow (bool, optional, default true): controls display timing.
#   - image (string, required): base64 PNG image (296px x 152px).
#   - link (string, optional): tap-to-interact target URL.
#   - border (number, optional, default 0): 0=white, 1=black frame.
#   - ditherType (string, optional, default DIFFUSION): dithering mode.
#   - ditherKernel (string, optional, default FLOYD_STEINBERG):
#     dithering kernel.
#   - taskKey (string, optional): specify which image API content to update.
#
# Mode selection:
#   - text (default): smart dual-send mode.  Body/title go to the Text API;
#     image= param or an attachment goes to the Image API.  When both are
#     present, text is dispatched first, then image.  If only one is
#     available, only that API is called.
#   - image: only the Image API is called; body and title are ignored.
#
#   Providing image= in the URL without an explicit mode= leaves the mode
#   as the default (text), which will send the image alongside any text.

from contextlib import suppress
import json
import logging

import requests

from ..common import NotifyImageSize, NotifyType
from ..locale import gettext_lazy as _
from ..url import PrivacyMode
from ..utils.parse import parse_bool
from ..utils.sanitize import sanitize_payload
from .base import NotifyBase

# Supported Dither Types
DOT_DITHER_TYPES = (
    "DIFFUSION",
    "ORDERED",
    "NONE",
)

# Supported Dither Kernels
DOT_DITHER_KERNELS = (
    "THRESHOLD",
    "ATKINSON",
    "BURKES",
    "FLOYD_STEINBERG",
    "SIERRA2",
    "STUCKI",
    "JARVIS_JUDICE_NINKE",
    "DIFFUSION_ROW",
    "DIFFUSION_COLUMN",
    "DIFFUSION_2D",
)

# Supported API modes; first entry is the default
DOT_MODES = ("text", "image")


class NotifyDot(NotifyBase):
    """A wrapper for Dot. Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "Dot."

    # The services URL
    service_url = "https://dot.mindreset.tech"

    # All notification requests are secure
    secure_protocol = "dot"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/dot/"

    # Allows the user to specify the NotifyImageSize object
    image_size = NotifyImageSize.XY_128

    # Support Attachments
    attachment_support = True

    # Define object templates
    templates = ("{schema}://{apikey}@{device_id}/",)

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "apikey": {
                "name": _("API Key"),
                "type": "string",
                "required": True,
                "private": True,
            },
            "device_id": {
                "name": _("Device Serial Number"),
                "type": "string",
                "required": True,
                "map_to": "device_id",
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "mode": {
                "name": _("API Mode"),
                "type": "choice:string",
                "values": DOT_MODES,
                "default": DOT_MODES[0],
            },
            "refresh": {
                "name": _("Refresh Now"),
                "type": "bool",
                "default": True,
                "map_to": "refresh_now",
            },
            "signature": {
                "name": _("Text Signature"),
                "type": "string",
            },
            "icon": {
                "name": _("Icon Base64 (Text API)"),
                "type": "string",
            },
            "image": {
                "name": _("Image Base64 (Image API)"),
                "type": "string",
                "map_to": "image_data",
            },
            "link": {
                "name": _("Link"),
                "type": "string",
            },
            "border": {
                "name": _("Border"),
                "type": "int",
                "min": 0,
                "max": 1,
                "default": 0,
            },
            "dither_type": {
                "name": _("Dither Type"),
                "type": "choice:string",
                "values": DOT_DITHER_TYPES,
                "default": "DIFFUSION",
            },
            "dither_kernel": {
                "name": _("Dither Kernel"),
                "type": "choice:string",
                "values": DOT_DITHER_KERNELS,
                "default": "FLOYD_STEINBERG",
            },
            "task_key": {
                "name": _("Task Key"),
                "type": "string",
            },
        },
    )

    def __init__(
        self,
        apikey=None,
        device_id=None,
        mode=DOT_MODES[0],
        refresh_now=None,
        signature=None,
        icon=None,
        link=None,
        border=None,
        dither_type=None,
        dither_kernel=None,
        image_data=None,
        task_key=None,
        **kwargs,
    ):
        """Initialize Notify Dot Object."""
        super().__init__(**kwargs)

        # API Key (from user)
        self.apikey = apikey

        # Device ID tracks the Dot hardware serial.
        self.device_id = device_id

        # Refresh Now flag: True shows content immediately (default).
        self.refresh_now = (
            parse_bool(
                refresh_now,
                self.template_args["refresh"]["default"],
            )
            if refresh_now is not None
            else self.template_args["refresh"]["default"]
        )

        # API mode
        self.mode = (
            mode.lower()
            if isinstance(mode, str) and mode.lower() in DOT_MODES
            else DOT_MODES[0]
        )
        if not isinstance(mode, str) or mode.lower() not in DOT_MODES:
            self.logger.warning(
                "Unsupported Dot mode (%s) specified; defaulting to '%s'.",
                mode,
                self.mode,
            )

        # Signature text used by the Text API footer.
        self.signature = signature if isinstance(signature, str) else None

        # Icon for the Text API (base64 PNG 40x40, lower-left corner).
        self.icon = icon if isinstance(icon, str) else None

        # Image payload for the Image API (base64 PNG 296x152).
        self.image_data = (
            image_data if image_data and isinstance(image_data, str) else None
        )

        # Link for tap-to-interact navigation.
        self.link = link if isinstance(link, str) else None

        # Border for the Image API
        self.border = border

        # Dither type for Image API
        self.dither_type = dither_type

        # Dither kernel for the Image API
        self.dither_kernel = dither_kernel

        # Task Key for specifying which content to update
        self.task_key = (
            task_key if task_key and isinstance(task_key, str) else None
        )

        # Text API endpoint (v2)
        self.text_api_url = (
            "https://dot.mindreset.tech/api/authV2/open/device/"
            f"{self.device_id}/text"
        )

        # Image API endpoint (v2)
        self.image_api_url = (
            "https://dot.mindreset.tech/api/authV2/open/device/"
            f"{self.device_id}/image"
        )

        return

    def _post(self, api_url, payload, headers):
        """POST payload to api_url; return True on success, False otherwise."""

        if self.logger.isEnabledFor(logging.DEBUG):
            self.logger.debug(
                "Dot POST URL: %s (cert_verify=%r)",
                api_url,
                self.verify_certificate,
            )
            self.logger.debug("Dot Payload %s", sanitize_payload(payload))

        # Always call throttle before any remote server i/o is made
        self.throttle()

        try:
            r = requests.post(
                api_url,
                data=json.dumps(payload),
                headers=headers,
                verify=self.verify_certificate,
                timeout=self.request_timeout,
                allow_redirects=self.redirects,
            )

            if r.status_code == requests.codes.ok:
                self.logger.info(
                    "Sent Dot notification to %s.", self.device_id
                )
                return True

            status_str = NotifyDot.http_response_code_lookup(r.status_code)
            self.logger.warning(
                "Failed to send Dot notification to %s: %s%serror=%d.",
                self.device_id,
                status_str,
                ", " if status_str else "",
                r.status_code,
            )
            self.logger.debug(
                "Response Details:\r\n%r", (r.content or b"")[:2000]
            )
            return False

        except requests.RequestException as e:
            self.logger.warning(
                "A Connection error occurred sending Dot notification to %s.",
                self.device_id,
            )
            self.logger.debug("Socket Exception: %s", str(e))
            return False

    def _send_text(self, body, title, icon_data, headers):
        """Send body/title via the Text API."""
        payload = {"refreshNow": self.refresh_now}

        if title:
            payload["title"] = title
        if body:
            payload["message"] = body
        if self.signature:
            payload["signature"] = self.signature
        if icon_data:
            payload["icon"] = icon_data
        if self.link:
            payload["link"] = self.link
        if self.task_key is not None:
            payload["taskKey"] = self.task_key

        return self._post(self.text_api_url, payload, headers)

    def _send_image(self, image_data, headers):
        """Send image_data via the Image API."""
        payload = {
            "image": image_data,
            "refreshNow": self.refresh_now,
        }

        if self.link:
            payload["link"] = self.link
        if self.border is not None:
            payload["border"] = self.border
        if self.dither_type is not None:
            payload["ditherType"] = self.dither_type
        if self.dither_kernel is not None:
            payload["ditherKernel"] = self.dither_kernel
        if self.task_key is not None:
            payload["taskKey"] = self.task_key

        return self._post(self.image_api_url, payload, headers)

    def _resolve_attachment(self, attach, warn_label):
        """Return base64 string from the first usable attachment, or None."""
        if not (attach and self.attachment_support):
            return None
        if len(attach) > 1:
            self.logger.warning(
                "Multiple attachments provided; only the first"
                " one will be used as %s.",
                warn_label,
            )
        try:
            attachment = attach[0]
            if attachment:
                return attachment.base64()
        except Exception as e:
            self.logger.warning("Failed to process attachment: %s", str(e))
        return None

    def send(
        self,
        body,
        title="",
        notify_type=NotifyType.INFO,
        attach=None,
        **kwargs,
    ):
        """Perform Dot Notification."""

        if not self.apikey:
            self.logger.warning("No API key was specified")
            return False

        if not self.device_id:
            self.logger.warning("No device ID was specified")
            return False

        headers = {
            "Authorization": f"Bearer {self.apikey}",
            "Content-Type": "application/json",
            "User-Agent": self.app_id,
        }

        if self.mode == "image":
            # Image-only mode: body and title are ignored.
            if title or body:
                self.logger.warning(
                    "Title and body are not supported in image mode"
                    " and will be ignored."
                )
            image_data = (
                self.image_data
                if isinstance(self.image_data, str)
                else self._resolve_attachment(attach, "image")
            )
            if not image_data:
                self.logger.warning(
                    "Image mode selected but no image data was provided."
                )
                return False
            return self._send_image(image_data, headers)

        # Text mode (default): smart dual-send.
        # Body/title go to the Text API; image data or attachment goes
        # to the Image API.  Text is always dispatched before image.
        image_data = (
            self.image_data
            if isinstance(self.image_data, str)
            else self._resolve_attachment(attach, "image")
        )
        has_text = bool(body or title)
        has_image = bool(image_data)

        if not has_text and not has_image:
            self.logger.warning(
                "Nothing to send to Dot. device %s.", self.device_id
            )
            return False

        has_error = False
        if has_text and not self._send_text(body, title, self.icon, headers):
            has_error = True

        if has_image and not self._send_image(image_data, headers):
            has_error = True
        return not has_error

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another similar one.
        """
        return (
            self.secure_protocol,
            self.apikey,
            self.device_id,
            self.mode,
        )

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified arguments."""

        params = {}
        params["refresh"] = "yes" if self.refresh_now else "no"

        # Include mode only when non-default
        if self.mode != DOT_MODES[0]:
            params["mode"] = self.mode

        if self.signature:
            params["signature"] = self.signature
        if self.icon:
            params["icon"] = self.icon
        if self.image_data:
            params["image"] = self.image_data
        if self.border is not None:
            params["border"] = str(self.border)
        if self.dither_type and self.dither_type != "DIFFUSION":
            params["dither_type"] = self.dither_type
        if self.dither_kernel and self.dither_kernel != "FLOYD_STEINBERG":
            params["dither_kernel"] = self.dither_kernel
        if self.link:
            params["link"] = self.link
        if self.task_key:
            params["task_key"] = self.task_key

        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        return "{schema}://{apikey}@{device_id}/?{params}".format(
            schema=self.secure_protocol,
            apikey=self.pprint(
                self.apikey, privacy, mode=PrivacyMode.Secret, safe=""
            ),
            device_id=NotifyDot.quote(self.device_id, safe=""),
            params=NotifyDot.urlencode(params),
        )

    def __len__(self):
        """Returns the number of targets associated with this notification."""
        return 1 if self.device_id else 0

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow us to
        re-instantiate this object."""

        results = NotifyBase.parse_url(url)
        if not results:
            return results

        # Determine mode: explicit ?mode= wins; path provides backward compat.
        mode = DOT_MODES[0]
        if results["qsd"].get("mode"):
            candidate = results["qsd"]["mode"].lower().strip()
            if candidate in DOT_MODES:
                mode = candidate
            else:
                NotifyDot.logger.warning(
                    "Unsupported Dot mode (%s) specified; defaulting to '%s'.",
                    candidate,
                    DOT_MODES[0],
                )
        else:
            path_tokens = NotifyDot.split_path(results.get("fullpath"))
            if path_tokens:
                candidate = path_tokens[0].lower()
                if candidate in DOT_MODES:
                    mode = candidate
                else:
                    NotifyDot.logger.warning(
                        "Unsupported Dot mode (%s) specified;"
                        " defaulting to '%s'.",
                        candidate,
                        DOT_MODES[0],
                    )
        results["mode"] = mode

        # Extract API key from user
        if results.get("user"):
            results["apikey"] = NotifyDot.unquote(results["user"])

        # Extract device ID from hostname
        if results.get("host"):
            results["device_id"] = NotifyDot.unquote(results["host"])

        # Refresh Now
        refresh_value = results["qsd"].get("refresh")
        if refresh_value:
            results["refresh_now"] = parse_bool(refresh_value.strip())

        # Signature
        if results["qsd"].get("signature"):
            results["signature"] = NotifyDot.unquote(
                results["qsd"]["signature"].strip()
            )

        # Icon
        if results["qsd"].get("icon"):
            results["icon"] = NotifyDot.unquote(results["qsd"]["icon"].strip())

        # Link
        if results["qsd"].get("link"):
            results["link"] = NotifyDot.unquote(results["qsd"]["link"].strip())

        # Border
        if results["qsd"].get("border"):
            with suppress(TypeError, ValueError):
                results["border"] = int(results["qsd"]["border"].strip())

        # Dither Type
        if results["qsd"].get("dither_type"):
            results["dither_type"] = NotifyDot.unquote(
                results["qsd"]["dither_type"].strip()
            )

        # Dither Kernel
        if results["qsd"].get("dither_kernel"):
            results["dither_kernel"] = NotifyDot.unquote(
                results["qsd"]["dither_kernel"].strip()
            )

        # Image (Image API)
        if results["qsd"].get("image"):
            results["image_data"] = NotifyDot.unquote(
                results["qsd"]["image"].strip()
            )

        # Task Key
        if results["qsd"].get("task_key"):
            results["task_key"] = NotifyDot.unquote(
                results["qsd"]["task_key"].strip()
            )

        return results
caronc-apprise-dfec414/apprise/plugins/eight00com.py000066400000000000000000000420611526720371000225570ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# To use this service you will need an 800.com account
#
#  1. Visit https://www.800.com and sign in or create an account.
#  2. Go to User Settings (top-right avatar -> Settings).
#  3. In the API section, click "Generate Token".
#  4. Copy the token immediately -- it is only displayed once.
#
#  Your Apprise URL should be assembled as:
#    eight00com://TOKEN@FromPhoneNo
#    eight00com://TOKEN@FromPhoneNo/ToPhoneNo
#    eight00com://TOKEN@FromPhoneNo/ToPhoneNo1/ToPhoneNo2
#
#  Where:
#    TOKEN       : Your 800.com Personal Access Token
#    FromPhoneNo : Your text-enabled 800.com number (e.g. 8005551234)
#    ToPhoneNo   : Recipient phone number(s)
#
# The API also supports MMS (picture messaging).  Apprise will
# automatically send any provided attachments as MMS when possible.
#
# API Reference:
#   https://api.800.com/docs

from json import dumps

import requests

from ..common import NotifyType
from ..exception import AppriseImproperlyConfigured
from ..locale import gettext_lazy as _
from ..utils.parse import is_phone_no, parse_phone_no, validate_regex
from .base import NotifyBase

# Extend HTTP Error Messages
EIGHT00COM_HTTP_ERROR_MAP = {
    401: "Unauthorized - Invalid or missing Bearer Token.",
    422: "Validation Error - Check sender/recipient number format.",
    429: "Too many requests - Rate limit exceeded.",
}


class NotifyEight00com(NotifyBase):
    """A wrapper for 800.com SMS/MMS Notifications."""

    # The default descriptive name associated with the Notification
    service_name = "800.com"

    # The services URL
    service_url = "https://www.800.com"

    # All notification requests are sent over HTTPS
    secure_protocol = "eight00com"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/eight00com/"

    # 800.com REST API endpoint for outbound messages
    notify_url = "https://api.800.com/message"

    # The maximum SMS body length (800.com supports long-form texts
    # up to 600 characters)
    body_maxlen = 600

    # A title cannot be used for SMS messages; setting this to zero
    # causes any title to be prepended to the body automatically.
    title_maxlen = 0

    # 800.com supports MMS (picture messaging / attachments)
    attachment_support = True

    # Define object URL templates
    templates = (
        "{schema}://{token}@{from_phone}",
        "{schema}://{token}@{from_phone}/{targets}",
    )

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "token": {
                "name": _("API Token"),
                "type": "string",
                "private": True,
                "required": True,
            },
            "from_phone": {
                "name": _("From Phone No"),
                "type": "string",
                "regex": (r"^\+?[0-9\s)(+-]+$", "i"),
                "map_to": "source",
                "required": True,
            },
            "target_phone": {
                "name": _("Target Phone No"),
                "type": "string",
                "prefix": "+",
                "regex": (r"^[0-9\s)(+-]+$", "i"),
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
            },
        },
    )

    # Define our template arguments
    template_args = dict(
        NotifyBase.template_args,
        **{
            "token": {
                "alias_of": "token",
            },
            "from": {
                "name": _("From Phone No"),
                "type": "string",
                "map_to": "source",
            },
            "to": {
                "alias_of": "targets",
            },
        },
    )

    def __init__(self, token=None, source=None, targets=None, **kwargs):
        """Initialize 800.com Object."""
        super().__init__(**kwargs)

        # Validate our Personal Access Token
        self.token = validate_regex(token)
        if not self.token:
            msg = "An 800.com Personal Access Token must be specified."
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Validate the from (source) phone number
        result = is_phone_no(source)
        if not result:
            msg = "The 800.com from phone # ({}) is invalid.".format(source)
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Store our source number as digits only
        self.source = result["full"]

        # Parse our targets list
        self.targets = []

        # Track if we encountered any error parsing targets
        has_error = False
        for target in parse_phone_no(targets):
            # Validate each target phone number
            result = is_phone_no(target)
            if result:
                self.targets.append(result["full"])
                continue

            has_error = True
            self.logger.warning(
                "Dropped invalid 800.com phone # (%s).",
                target,
            )

        if not targets and not has_error:
            # Default: send to ourselves when no target is provided
            self.targets.append(self.source)

        return

    def send(
        self,
        body,
        title="",
        notify_type=NotifyType.INFO,
        attach=None,
        **kwargs,
    ):
        """Perform 800.com SMS/MMS Notification."""

        # Ensure we have at least one target
        if not self.targets:
            self.logger.warning("No 800.com targets to notify.")
            return False

        # Prepare our authorization header (shared by SMS and MMS)
        headers = {
            "User-Agent": self.app_id,
            "Authorization": "Bearer {}".format(self.token),
        }

        # Error tracking variable
        has_error = False

        # Work through a copy so the original list is preserved
        targets = list(self.targets)
        while targets:
            # Pop the next recipient
            target = targets.pop(0)

            # Skip a target that already accepted this message so a
            # retry does not deliver it twice.
            if self.is_delivered(target):
                continue

            # Build the E.164-style sender and recipient strings
            sender = "+{}".format(self.source)
            recipient = "+{}".format(target)

            self.logger.debug(
                "800.com POST URL: %s (cert_verify=%s)",
                self.notify_url,
                self.verify_certificate,
            )

            if attach and self.attachment_support:
                # Send as MMS with attachment(s)
                if not self._send_mms(
                    sender, recipient, body, attach, headers
                ):
                    has_error = True
                    continue

            elif not self._send_sms(sender, recipient, body, headers):
                # Send as a plain SMS
                has_error = True
                continue

            # Delivered; a retry can safely skip this target.
            self.mark_delivered(target)

        return not has_error

    def _send_sms(self, sender, recipient, body, headers):
        """Send a plain text SMS via the 800.com REST API."""

        # Prepare our JSON payload
        payload = {
            "sender": sender,
            "recipient": recipient,
            "message": body,
        }

        # Copy headers and add JSON content type
        sms_headers = dict(headers)
        sms_headers["Content-Type"] = "application/json"

        self.logger.debug("800.com SMS Payload: %s", payload)

        # Always call throttle before any remote server i/o is made
        self.throttle()

        try:
            r = requests.post(
                self.notify_url,
                data=dumps(payload),
                headers=sms_headers,
                verify=self.verify_certificate,
                timeout=self.request_timeout,
                allow_redirects=self.redirects,
            )

            if r.status_code != requests.codes.ok:
                # We had a problem
                status_str = NotifyEight00com.http_response_code_lookup(
                    r.status_code, EIGHT00COM_HTTP_ERROR_MAP
                )
                self.logger.warning(
                    "Failed to send 800.com SMS to %s: %s%serror=%s.",
                    recipient,
                    status_str,
                    ", " if status_str else "",
                    r.status_code,
                )
                self.logger.debug(
                    "Response Details:\r\n%r",
                    (r.content or b"")[:2000],
                )
                return False

            else:
                self.logger.info("Sent 800.com SMS to %s.", recipient)

        except requests.RequestException as e:
            self.logger.warning(
                "A Connection error occurred sending 800.com SMS to %s.",
                recipient,
            )
            self.logger.debug("Socket Exception: %s", str(e))
            return False

        return True

    def _send_mms(self, sender, recipient, body, attach, headers):
        """Send an MMS with one or more attachments via the 800.com API.

        Uses Pattern B (multi-file multipart/form-data).
        """

        # Accumulate open file handles for cleanup in the finally block
        handles = []
        files = []
        attach_ok = True

        try:
            for attachment in attach:
                # Guard 1: verify the attachment is accessible
                if not attachment:
                    self.logger.warning(
                        "Could not access 800.com attachment %s.",
                        attachment.url(privacy=True),
                    )
                    attach_ok = False
                    break

                # Guard 2: catch I/O errors when opening the file
                try:
                    handle = attachment.open()
                except OSError as exc:
                    self.logger.warning(
                        "An I/O error occurred reading 800.com attachment %s.",
                        attachment.name,
                    )
                    self.logger.debug("I/O Exception: %s", str(exc))
                    attach_ok = False
                    break

                # Register handle immediately so finally closes it
                handles.append(handle)
                files.append(
                    (
                        "media[]",
                        (
                            attachment.name,
                            handle,
                            attachment.mimetype,
                        ),
                    )
                )

            if not attach_ok:
                # Bail early; finally block will close any open handles
                return False

            # Prepare the multipart form fields.
            # Do NOT set Content-Type -- requests sets the multipart
            # boundary header automatically when files is not None.
            data = {
                "sender": sender,
                "recipient": recipient,
                "message": body,
            }

            self.logger.debug("800.com MMS data: %s", data)

            # Always call throttle before any remote server i/o is made
            self.throttle()

            r = requests.post(
                self.notify_url,
                data=data,
                headers=headers,
                files=files,
                verify=self.verify_certificate,
                timeout=self.request_timeout,
                allow_redirects=self.redirects,
            )

            if r.status_code != requests.codes.ok:
                # We had a problem
                status_str = NotifyEight00com.http_response_code_lookup(
                    r.status_code, EIGHT00COM_HTTP_ERROR_MAP
                )
                self.logger.warning(
                    "Failed to send 800.com MMS to %s: %s%serror=%s.",
                    recipient,
                    status_str,
                    ", " if status_str else "",
                    r.status_code,
                )
                self.logger.debug(
                    "Response Details:\r\n%r",
                    (r.content or b"")[:2000],
                )
                return False

            else:
                self.logger.info("Sent 800.com MMS to %s.", recipient)

        except requests.RequestException as e:
            self.logger.warning(
                "A Connection error occurred sending 800.com MMS to %s.",
                recipient,
            )
            self.logger.debug("Socket Exception: %s", str(e))
            return False

        finally:
            # Guard 3: close every file handle regardless of outcome
            for handle in handles:
                handle.close()

        return True

    @property
    def url_identifier(self):
        """Returns all of the identifiers that make this URL unique from
        another simliar one.

        Targets or end points should never be identified here.
        """
        return (self.secure_protocol, self.source, self.token)

    def url(self, privacy=False, *args, **kwargs):
        """Returns the URL built dynamically based on specified
        arguments."""

        # Prepare our standard parameters
        params = self.url_parameters(privacy=privacy, *args, **kwargs)

        # Omit the target list when the only target is ourselves
        targets = (
            []
            if len(self.targets) == 1 and self.targets[0] == self.source
            else self.targets
        )

        return "{schema}://{token}@{source}/{targets}?{params}".format(
            schema=self.secure_protocol,
            token=self.pprint(self.token, privacy, safe=""),
            source=self.source,
            targets="/".join(
                NotifyEight00com.quote(x, safe="+") for x in targets
            ),
            params=NotifyEight00com.urlencode(params),
        )

    def __len__(self):
        """Returns the number of targets associated with this
        notification."""
        return len(self.targets) if self.targets else 1

    @staticmethod
    def parse_url(url):
        """Parses the URL and returns enough arguments that can allow
        us to re-instantiate this object."""

        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            return results

        # Support ?from= to specify the source number separately,
        # in which case the hostname becomes an additional target.
        if "from" in results["qsd"] and len(results["qsd"]["from"]):
            results["source"] = NotifyEight00com.unquote(
                results["qsd"]["from"]
            )
            results["targets"] = [
                *NotifyEight00com.parse_phone_no(results["host"]),
                *NotifyEight00com.split_path(results["fullpath"]),
            ]

        else:
            # Hostname is the source (from) phone number
            results["source"] = NotifyEight00com.unquote(results["host"])
            # Path entries are target phone numbers
            results["targets"] = NotifyEight00com.split_path(
                results["fullpath"]
            )

        # Support ?to= as an alias for targets
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"] += NotifyEight00com.parse_phone_no(
                results["qsd"]["to"]
            )

        # Support ?token= to override the token in the URL user field
        if "token" in results["qsd"] and len(results["qsd"]["token"]):
            results["token"] = NotifyEight00com.unquote(
                results["qsd"]["token"]
            )

        else:
            # Token lives in the user position of the URL
            results["token"] = NotifyEight00com.unquote(results["user"] or "")

        return results
caronc-apprise-dfec414/apprise/plugins/email/000077500000000000000000000000001526720371000213325ustar00rootroot00000000000000caronc-apprise-dfec414/apprise/plugins/email/__init__.py000066400000000000000000000035751526720371000234550ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from email import charset

from .base import NotifyEmail
from .common import (
    SECURE_MODES,
    AppriseEmailException,
    EmailMessage,
    SecureMailMode,
    WebBaseLogin,
)
from .templates import EMAIL_TEMPLATES

# Globally Default encoding mode set to Quoted Printable.
charset.add_charset("utf-8", charset.QP, charset.QP, "utf-8")

__all__ = [
    "EMAIL_TEMPLATES",
    "SECURE_MODES",
    "AppriseEmailException",
    "EmailMessage",
    "NotifyEmail",
    "SecureMailMode",
    "WebBaseLogin",
]
caronc-apprise-dfec414/apprise/plugins/email/base.py000066400000000000000000001536731526720371000226350ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from datetime import datetime
from email.header import Header
from email.mime.application import MIMEApplication
from email.mime.base import MIMEBase
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.utils import format_datetime, formataddr, make_msgid
import re
import smtplib
from typing import Optional

from ...common import NotifyFormat, NotifyType, PersistentStoreMode
from ...conversion import convert_between
from ...exception import AppriseImproperlyConfigured
from ...locale import gettext_lazy as _
from ...logger import logger
from ...url import PrivacyMode
from ...utils import pgp as _pgp, wkd as _wkd
from ...utils.parse import (
    is_email,
    is_hostname,
    is_ipaddr,
    parse_bool,
    parse_emails,
)
from ..base import NotifyBase
from . import templates
from .common import (
    SECURE_MODES,
    AppriseEmailException,
    EmailMessage,
    SecureMailMode,
    WebBaseLogin,
)
from .smtp import AppriseSMTPController


class PGPMode:
    """PGP security mode for outbound email."""

    # No PGP applied (default)
    NONE = "no"

    # Sign using the sender's private key; encrypt opportunistically when
    # a recipient public key is available (via WKD or pgppub=)
    SIGN = "sign"

    # Encrypt using the recipient's public key (fails if no key found)
    ENCRYPT = "encrypt"


# Ordered tuple of all valid PGP modes; prefix matching uses this order
PGP_MODES = (
    PGPMode.NONE,
    PGPMode.SIGN,
    PGPMode.ENCRYPT,
)

# The mode used when ?pgp= is absent or empty
PGP_MODE_DEFAULT = PGPMode.NONE


class NotifyEmail(NotifyBase):
    """
    A wrapper to Email Notifications

    """

    # The default descriptive name associated with the Notification
    service_name = "E-Mail"

    # The default simple (insecure) protocol
    protocol = "mailto"

    # The default secure protocol
    secure_protocol = "mailtos"

    # A URL that takes you to the setup/help of the specific protocol
    setup_url = "https://appriseit.com/services/email/"

    # Support attachments
    attachment_support = True

    # Our default is to no not use persistent storage beyond in-memory
    # reference; this allows us to auto-generate our config if needed
    storage_mode = PersistentStoreMode.AUTO

    # Email can send either HTML or plain text. HTML remains the default.
    notify_format = (NotifyFormat.HTML, NotifyFormat.TEXT)

    # Default SMTP Timeout (in seconds)
    socket_connect_timeout = 15

    # Define object templates
    templates = (
        "{schema}://{host}",
        "{schema}://{host}:{port}",
        "{schema}://{host}:{port}/{targets}",
        "{schema}://{host}/{targets}",
        "{schema}://{user}@{host}",
        "{schema}://{user}@{host}/{targets}",
        "{schema}://{user}@{host}:{port}",
        "{schema}://{user}@{host}/{targets}",
        "{schema}://{user}@{host}:{port}/{targets}",
        "{schema}://{user}:{password}@{host}",
        "{schema}://{user}:{password}@{host}/{targets}",
        "{schema}://{user}:{password}@{host}:{port}",
        "{schema}://{user}:{password}@{host}:{port}/{targets}",
    )

    # Define our template tokens
    template_tokens = dict(
        NotifyBase.template_tokens,
        **{
            "user": {
                "name": _("User Name"),
                "type": "string",
            },
            "password": {
                "name": _("Password"),
                "type": "string",
                "private": True,
            },
            "host": {
                "name": _("Domain"),
                "type": "string",
                "required": True,
            },
            "port": {
                "name": _("Port"),
                "type": "int",
                "min": 1,
                "max": 65535,
            },
            "target_email": {
                "name": _("Target Email"),
                "type": "string",
                "map_to": "targets",
            },
            "targets": {
                "name": _("Targets"),
                "type": "list:string",
            },
        },
    )

    template_args = dict(
        NotifyBase.template_args,
        **{
            "from": {
                "name": _("From Email"),
                "type": "string",
                "map_to": "from_addr",
            },
            "name": {
                "name": _("From Name"),
                "type": "string",
                "map_to": "from_addr",
            },
            "smtp": {
                "name": _("SMTP Server"),
                "type": "string",
                "map_to": "smtp_host",
            },
            "mode": {
                "name": _("Secure Mode"),
                "type": "choice:string",
                "values": SECURE_MODES,
                "default": SecureMailMode.STARTTLS,
                "map_to": "secure_mode",
            },
            "reply": {
                "name": _("Reply To"),
                "type": "list:string",
                "map_to": "reply_to",
            },
            "pgp": {
                "name": _("PGP Security Mode"),
                "type": "choice:string",
                "values": PGP_MODES,
                "default": PGP_MODE_DEFAULT,
                "map_to": "pgp_mode",
            },
            "pgppub": {
                "name": _("PGP Public Key Path"),
                "type": "string",
                "private": True,
                # By default persistent storage is referenced
                "default": "",
                "map_to": "pgp_key",
            },
            "pgpprv": {
                "name": _("PGP Private Key Path"),
                "type": "string",
                "private": True,
                # By default persistent storage is referenced
                "default": "",
                "map_to": "pgp_privkey",
            },
            "wkd": {
                "name": _("Web Key Directory"),
                "type": "bool",
                "default": False,
                "map_to": "use_wkd",
            },
            "inline": {
                "name": _("Inline Attachments"),
                "type": "bool",
                "default": False,
            },
            "to": {
                "name": _("To Email"),
                "type": "string",
                "map_to": "targets",
            },
            "cc": {
                "name": _("Carbon Copy"),
                "type": "list:string",
            },
            "bcc": {
                "name": _("Blind Carbon Copy"),
                "type": "list:string",
            },
        },
    )

    # Define any kwargs we're using
    template_kwargs = {
        "headers": {
            "name": _("Email Header"),
            "prefix": "+",
        },
    }

    def __init__(
        self,
        smtp_host=None,
        from_addr=None,
        secure_mode=None,
        targets=None,
        cc=None,
        bcc=None,
        reply_to=None,
        headers=None,
        pgp_mode=None,
        pgp_key=None,
        pgp_privkey=None,
        use_wkd=False,
        inline=None,
        **kwargs,
    ):
        """
        Initialize Email Object

        The smtp_host and secure_mode can be automatically detected depending
        on how the URL was built
        """
        super().__init__(**kwargs)

        # Acquire Email 'To'
        self.targets = []

        # Acquire Carbon Copies
        self.cc = set()

        # Acquire Blind Carbon Copies
        self.bcc = set()

        # Acquire Reply To
        self.reply_to = set()

        # For tracking our email -> name lookups
        self.names = {}

        self.headers = {}
        if headers:
            # Store our extra headers
            self.headers.update(headers)

        # Now we want to construct the To and From email
        # addresses from the URL provided
        self.from_addr = [False, ""]

        # Now detect the SMTP Server
        self.smtp_host = smtp_host if isinstance(smtp_host, str) else ""

        # Now detect secure mode
        if secure_mode:
            self.secure_mode = (
                None
                if not isinstance(secure_mode, str)
                else secure_mode.lower()
            )
        else:
            self.secure_mode = (
                SecureMailMode.INSECURE
                if not self.secure
                else self.template_args["mode"]["default"]
            )

        if self.secure_mode not in SECURE_MODES:
            msg = "The secure mode specified ({}) is invalid.".format(
                secure_mode
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Validate recipients (cc:) and drop bad ones:
        for recipient in parse_emails(cc):
            email = is_email(recipient)
            if email:
                self.cc.add(email["full_email"])

                # Index our name (if one exists)
                self.names[email["full_email"]] = (
                    email["name"] if email["name"] else False
                )
                continue

            self.logger.warning(
                "Dropped invalid Carbon Copy email ({}) specified.".format(
                    recipient
                ),
            )

        # Validate recipients (bcc:) and drop bad ones:
        for recipient in parse_emails(bcc):
            email = is_email(recipient)
            if email:
                self.bcc.add(email["full_email"])

                # Index our name (if one exists)
                self.names[email["full_email"]] = (
                    email["name"] if email["name"] else False
                )
                continue

            self.logger.warning(
                "Dropped invalid Blind Carbon Copy email "
                "({}) specified.".format(recipient),
            )

        # Validate recipients (reply-to:) and drop bad ones:
        for recipient in parse_emails(reply_to):
            email = is_email(recipient)
            if email:
                self.reply_to.add(email["full_email"])

                # Index our name (if one exists)
                self.names[email["full_email"]] = (
                    email["name"] if email["name"] else False
                )
                continue

            self.logger.warning(
                "Dropped invalid Reply To email ({}) specified.".format(
                    recipient
                ),
            )

        # Apply any defaults based on certain known configurations
        self.apply_email_defaults(secure_mode=secure_mode, **kwargs)

        if self.user:
            if self.host:
                # Prepare the bases of our email
                self.from_addr = [
                    self.app_id,
                    "{}@{}".format(
                        re.split(r"[\s@]+", self.user)[0],
                        self.host,
                    ),
                ]

            else:
                result = is_email(self.user)
                if result:
                    # Prepare the bases of our email and include domain
                    self.host = result["domain"]
                    self.from_addr = [self.app_id, self.user]

        if from_addr:
            result = is_email(from_addr)
            if result:
                self.from_addr = (
                    result["name"] if result["name"] else False,
                    result["full_email"],
                )
            else:
                # Only update the string but use the already detected info
                self.from_addr[0] = from_addr

        result = is_email(self.from_addr[1])
        if not result:
            # Parse Source domain based on from_addr
            msg = "Invalid ~From~ email specified: {}".format(
                "{} <{}>".format(self.from_addr[0], self.from_addr[1])
                if self.from_addr[0]
                else "{}".format(self.from_addr[1])
            )
            self.logger.warning(msg)
            raise AppriseImproperlyConfigured(msg)

        # Store our lookup
        self.names[self.from_addr[1]] = self.from_addr[0]

        if targets:
            # Validate recipients (to:) and drop bad ones:
            for recipient in parse_emails(targets):
                result = is_email(recipient)
                if result:
                    self.targets.append(
                        (
                            result["name"] if result["name"] else False,
                            result["full_email"],
                        )
                    )
                    continue

                self.logger.warning(
                    "Dropped invalid To email ({}) specified.".format(
                        recipient
                    ),
                )

        else:
            # If our target email list is empty we want to add ourselves to it
            self.targets.append((False, self.from_addr[1]))

        if not self.secure and self.secure_mode != SecureMailMode.INSECURE:
            # Enable Secure mode if not otherwise set
            self.secure = True

        if not self.port:
            # Assign our port based on our secure_mode if not otherwise
            # detected
            self.port = SECURE_MODES[self.secure_mode]["default_port"]

        # if there is still no smtp_host then we fall back to the hostname
        if not self.smtp_host:
            self.smtp_host = self.host

        # Track whether pgp_mode was explicitly provided so wkd= implication
        # does not override a deliberate pgp=none choice
        pgp_mode_explicit = pgp_mode is not None

        # Accept unambiguous prefixes such as "e" and "en". Treat "none"
        # as "no", and reject unknown values instead of disabling PGP.
        if not pgp_mode:
            self.pgp_mode = PGP_MODE_DEFAULT

        elif str(pgp_mode).lower() == "none":
            self.pgp_mode = PGPMode.NONE

        else:
            self.pgp_mode = next(
                (m for m in PGP_MODES if m.startswith(str(pgp_mode).lower())),
                None,
            )
            if self.pgp_mode is None:
                msg = f"The Email PGP mode specified ({pgp_mode}) is invalid."
                self.logger.warning(msg)
                raise AppriseImproperlyConfigured(msg)

        # Parse string values such as "no" correctly.
        self.use_wkd = parse_bool(use_wkd)

        # wkd=yes implies pgp=encrypt when pgp= was not explicitly set
        if self.use_wkd and not pgp_mode_explicit:
            self.pgp_mode = PGPMode.ENCRYPT

        # Build a WKD controller when WKD key discovery is requested
        wkd_ctrl = (
            _wkd.AppriseWKDController(
                asset=self.asset,
                verify_certificate=self.verify_certificate,
                request_timeout=self.request_timeout,
                allow_redirects=self.redirects,
            )
            if self.use_wkd
            else None
        )

        # Prepare our Pretty Good Privacy Object
        self.pgp = _pgp.ApprisePGPController(
            path=self.store.path,
            pub_keyfile=pgp_key,
            prv_keyfile=pgp_privkey,
            email=self.from_addr[1],
            asset=self.asset,
            wkd=wkd_ctrl,
        )

        # We store so we can generate a URL later on
        self.pgp_key = pgp_key

        # Store the private key path so it can be round-tripped via url()
        self.pgp_privkey = pgp_privkey

        if self.pgp_mode != PGP_MODE_DEFAULT and not _pgp.PGP_SUPPORT:
            self.logger.warning(
                "PGP Support is not available on this installation; "
                "ask admin to install PGPy"
            )

        # Store inline attachment mode (RFC 2387); fall back to the
        # template default when the value is None or unrecognisable
        self.inline = parse_bool(
            inline, self.template_args["inline"]["default"]
        )

        return

    def _protocol_headers(self, body):
        """Return protocol headers supplied by an Email subclass."""
        return {}

    def apply_email_defaults(self, secure_mode=None, port=None, **kwargs):
        """Apply provider defaults inferred from the sender address."""

        if self.smtp_host:
            # Preserve an explicitly selected SMTP server.
            return

        # detect our email address using our user/host combo
        from_addr = (
            "{}@{}".format(
                re.split(r"[\s@]+", self.user)[0],
                self.host,
            )
            if self.user
            else self.host
        )

        for i in range(len(templates.EMAIL_TEMPLATES)):  # pragma: no branch
            self.logger.trace(
                "Scanning %s against %s",
                from_addr,
                templates.EMAIL_TEMPLATES[i][0],
            )

            match = templates.EMAIL_TEMPLATES[i][1].match(from_addr)
            if match:
                self.logger.debug(
                    f"Applying {templates.EMAIL_TEMPLATES[i][0]} Defaults"
                )

                # A template may require a specific security mode.
                self.secure = templates.EMAIL_TEMPLATES[i][2].get(
                    "secure", self.secure
                )

                # The SMTP Host check is already done above; if it was
                # specified we wouldn't even reach this part of the code.
                self.smtp_host = templates.EMAIL_TEMPLATES[i][2].get(
                    "smtp_host", self.smtp_host
                )

                # The following can be over-ridden if defined manually in the
                # Apprise URL.  Otherwise they take on the template value
                if not port:
                    self.port = templates.EMAIL_TEMPLATES[i][2].get(
                        "port", self.port
                    )
                if not secure_mode:
                    self.secure_mode = templates.EMAIL_TEMPLATES[i][2].get(
                        "secure_mode", self.secure_mode
                    )

                # Adjust email login based on the defined usertype. If no entry
                # was specified, then we default to having them all set (which
                # basically implies that there are no restrictions and use use
                # whatever was specified)
                login_type = templates.EMAIL_TEMPLATES[i][2].get(
                    "login_type", []
                )
                if login_type:
                    # only apply additional logic to our user if a login_type
                    # was specified.
                    if is_email(self.user):
                        if WebBaseLogin.EMAIL not in login_type:
                            # Email specified but login type
                            # not supported; switch it to user id
                            self.user = match.group("id")

                        else:
                            # Enforce our host information
                            self.host = self.user.split("@")[1]

                    elif WebBaseLogin.USERID not in login_type:
                        # user specified but login type
                        # not supported; switch it to email
                        self.user = "{}@{}".format(self.user, self.host)

                if (
                    "from_user" in templates.EMAIL_TEMPLATES[i][2]
                    and not self.from_addr[1]
                ):
                    # Update our from address if defined
                    self.from_addr[1] = "{}@{}".format(
                        templates.EMAIL_TEMPLATES[i][2]["from_user"], self.host
                    )

                break

    def send(
        self,
        body,
        title="",
        notify_type=NotifyType.INFO,
        attach=None,
        body_format=None,
        **kwargs,
    ):
        """Perform Email Notification."""

        if not self.targets:
            # There is no one to email; we're done
            logger.warning("There are no Email recipients to notify")
            return False

        # error tracking (used for function return)
        has_error = False

        # Always call throttle before any remote server i/o is made
        self.throttle()

        try:
            with AppriseSMTPController(
                host=self.smtp_host,
                port=self.port,
                secure_mode=self.secure_mode,
                user=self.user,
                password=self.password,
                verify_certificate=self.verify_certificate,
                socket_connect_timeout=self.socket_connect_timeout,
            ) as smtp:
                # Prepare our headers
                headers = {
                    "X-Application": self.app_id,
                }
                headers.update(self.headers)

                # Add any protocol headers supplied by a subclass.
                headers.update(self._protocol_headers(body))

                # Build each message in its resolved text or HTML format.
                for message in NotifyEmail.prepare_emails(
                    subject=title,
                    body=body,
                    notify_format=self.resolve_format(body_format),
                    from_addr=self.from_addr,
                    to=self.targets,
                    cc=self.cc,
                    bcc=self.bcc,
                    reply_to=self.reply_to,
                    smtp_host=self.smtp_host,
                    attach=attach,
                    headers=headers,
                    names=self.names,
                    pgp=self.pgp,
                    pgp_mode=self.pgp_mode,
                    inline=self.inline,
                    tzinfo=self.tzinfo,
                ):
                    # Skip a recipient that already accepted this message
                    # so a retry does not deliver it twice.
                    if self.is_delivered(message.recipient):
                        continue

                    if smtp.sendmail(
                        self.from_addr[1], message.to_addrs, message.body
                    ):
                        self.logger.info("Sent Email to %s", message.recipient)

                        # Delivered; a retry can safely skip this one.
                        self.mark_delivered(message.recipient)

                    else:
                        self.logger.warning(
                            'Sending email to "%s" failed.',
                            message.recipient,
                        )

                        # Mark as failure
                        has_error = True

        except (
            OSError,
            smtplib.SMTPException,
            RuntimeError,
            AppriseImproperlyConfigured,
        ) as e:
            self.logger.warning(
                'Connection error while submitting email to "%s"',
                self.smtp_host,
            )
            self.logger.debug(f"Socket Exception: {e}")

            # Mark as failure
            has_error = True

        except AppriseEmailException as e:
            self.logger.debug(f"Socket Exception: {e}")

            # Mark as failure
            has_error = True

        # Reduce our dictionary (eliminate expired keys if any)
        self.pgp.prune()

        return not has_error

    def _url_address(self, email: str) -> str:
        """Return ``email`` with its display name (if any) for url()."""
        name = self.names.get(email)
        if not name:
            return email

        # Quote a name holding a list delimiter (or @) so it is not split
        # apart.  Apprise parses the name back as is, so no RFC 2047
        # encoding or escaping is wanted here.
        return (
            f'"{name}" <{email}>'
            if any(c in name for c in ",;@")
            else f"{name} <{email}>"
        )

    def url(self, privacy=False, *args, **kwargs):
        """
        Returns the URL built dynamically based on specified arguments.
        """

        # Define an URL parameters
        params = {}

        # Always emit pgp= when wkd=yes is set, even when the mode is the
        # default 'none'.  Without this, a URL like ?pgp=none&wkd=yes would
        # round-trip as ?wkd=yes and the wkd=yes→pgp=encrypt implication
        # would silently re-enable encryption on re-parse.
        if self.pgp_mode != PGP_MODE_DEFAULT or self.use_wkd:
            params["pgp"] = self.pgp_mode

        # Store our public key back into the URL when one was supplied;
        # mask the value when building a privacy-safe URL because the key
        # path can reveal local filesystem layout or remote key server URLs
        if self.pgp_key is not None:
            params["pgppub"] = (
                "****"
                if privacy
                else NotifyEmail.quote(self.pgp_key, safe=":\\/")
            )

        # Store the private key path in the URL in the same way; masked
        # in privacy mode because private key paths are sensitive
        if self.pgp_privkey is not None:
            params["pgpprv"] = (
                "****"
                if privacy
                else NotifyEmail.quote(self.pgp_privkey, safe=":\\/")
            )

        # Include wkd= when Web Key Directory lookup is enabled
        if self.use_wkd:
            params["wkd"] = "yes"

        # Emit inline flag only when enabled
        if self.inline:
            params["inline"] = "yes"

        # Append our headers into our parameters
        params.update({"+{}".format(k): v for k, v in self.headers.items()})

        # Extend our parameters
        params.update(self.url_parameters(privacy=privacy, *args, **kwargs))

        from_addr = None
        if not self.user or self.from_addr[1] != "{}@{}".format(
            re.split(r"[\s@]+", self.user)[0], self.host
        ):
            # A custom email was provided.  Write it out unless the next
            # parse would rebuild the same address from user@host.
            from_addr = self.from_addr[1]

        if self.smtp_host != self.host:
            # Apply our SMTP Host only if it differs from the provided hostname
            params["smtp"] = self.smtp_host

        if self.secure:
            # Mode is only required if we're dealing with a secure connection
            params["mode"] = self.secure_mode

        if self.from_addr[0] and self.from_addr[0] != self.app_id:
            # A custom name was provided
            params["from"] = (
                self.from_addr[0]
                if not from_addr
                else formataddr(
                    (self.from_addr[0], from_addr), charset="utf-8"
                )
            )

        elif from_addr:
            params["from"] = formataddr((False, from_addr), charset="utf-8")

        if self.cc:
            # Handle our Carbon Copy Addresses
            params["cc"] = ",".join([self._url_address(e) for e in self.cc])

        if self.bcc:
            # Handle our Blind Carbon Copy Addresses
            params["bcc"] = ",".join([self._url_address(e) for e in self.bcc])

        if self.reply_to:
            # Handle our Reply-To Addresses
            params["reply"] = ",".join(
                [self._url_address(e) for e in self.reply_to]
            )

        # pull email suffix from username (if present)
        user = None if not self.user else self.user.split("@")[0]

        # Determine Authentication
        auth = ""
        if self.user and self.password:
            auth = "{user}:{password}@".format(
                user=NotifyEmail.quote(user, safe=""),
                password=self.pprint(
                    self.password, privacy, mode=PrivacyMode.Secret, safe=""
                ),
            )
        elif user:
            # user url
            auth = "{user}@".format(
                user=NotifyEmail.quote(user, safe=""),
            )

        # Default Port setup
        default_port = SECURE_MODES[self.secure_mode]["default_port"]

        # a simple boolean check as to whether we display our target emails
        # or not
        has_targets = not (
            len(self.targets) == 1 and self.targets[0][1] == self.from_addr[1]
        )

        return "{schema}://{auth}{hostname}{port}/{targets}?{params}".format(
            schema=self.secure_protocol if self.secure else self.protocol,
            auth=auth,
            # never encode hostname since we're expecting it to be a valid one
            hostname=self.host,
            port=(
                ""
                if self.port is None or self.port == default_port
                else ":{}".format(self.port)
            ),
            targets=(
                ""
                if not has_targets
                else "/".join(
                    [
                        NotifyEmail.quote(
                            "{}{}".format(
                                "" if not e[0] else "{}:".format(e[0]), e[1]
                            ),
                            safe="",
                        )
                        for e in self.targets
                    ]
                )
            ),
            params=NotifyEmail.urlencode(params, safe="*"),
        )

    @property
    def url_identifier(self):
        """
        Returns all of the identifiers that make this URL unique from
        another similar one. Targets or end points should never be identified
        here.
        """
        return (
            self.secure_protocol if self.secure else self.protocol,
            self.user,
            self.password,
            self.host,
            self.smtp_host,
            (
                self.port
                if self.port
                else SECURE_MODES[self.secure_mode]["default_port"]
            ),
        )

    def __len__(self):
        """
        Returns the number of targets associated with this notification
        """
        return len(self.targets) if self.targets else 1

    @staticmethod
    def parse_url(url):
        """
        Parses the URL and returns enough arguments that can allow
        us to re-instantiate this object.

        """
        results = NotifyBase.parse_url(url, verify_host=False)
        if not results:
            # We're done early as we couldn't load the results
            return results

        # Prepare our target lists
        results["targets"] = []

        if is_ipaddr(results["host"]):
            # Silently move on and do not disrupt any configuration
            pass

        elif not is_hostname(
            results["host"], ipv4=False, ipv6=False, underscore=False
        ):
            if is_email(NotifyEmail.unquote(results["host"])):
                # Don't lose defined email addresses
                results["targets"].append(NotifyEmail.unquote(results["host"]))

            # Clear invalid hosts so a later step can infer one.
            results["host"] = ""

        # Accept PGP mode prefixes and treat "none" as "no".
        pgp_raw = results["qsd"].get("pgp", "")
        if pgp_raw:
            pgp_mode = next(
                (m for m in PGP_MODES if m.startswith(str(pgp_raw).lower())),
                None,
            )
            if pgp_mode is None:
                # Let __init__ report invalid and removed boolean values.
                pgp_mode = pgp_raw
            results["pgp_mode"] = pgp_mode

        # Get Web Key Directory flag
        if "wkd" in results["qsd"] and results["qsd"]["wkd"]:
            results["use_wkd"] = parse_bool(results["qsd"]["wkd"])

        # wkd=yes implies pgp=encrypt when pgp= was not present in the URL
        if results.get("use_wkd") and "pgp_mode" not in results:
            results["pgp_mode"] = PGPMode.ENCRYPT

        # Get PGP Public Key Override (canonical name: pgppub=)
        if "pgppub" in results["qsd"] and results["qsd"]["pgppub"]:
            results["pgp_key"] = NotifyEmail.unquote(results["qsd"]["pgppub"])

        # Get PGP Private Key Override (canonical name: pgpprv=)
        if "pgpprv" in results["qsd"] and results["qsd"]["pgpprv"]:
            results["pgp_privkey"] = NotifyEmail.unquote(
                results["qsd"]["pgpprv"]
            )

        # Get inline attachment flag
        if "inline" in results["qsd"]:
            results["inline"] = parse_bool(
                results["qsd"]["inline"],
                NotifyEmail.template_args["inline"]["default"],
            )

        # The From address is a must; either through the use of templates
        # from= entry and/or merging the user and hostname together, this
        # must be calculated or parse_url will fail.
        from_addr = ""

        # The server we connect to to send our mail to
        smtp_host = ""

        # Get our potential email targets; if none our found we'll just
        # add one to ourselves
        results["targets"] += NotifyEmail.split_path(results["fullpath"])

        # Attempt to detect 'to' email address
        if "to" in results["qsd"] and len(results["qsd"]["to"]):
            results["targets"].append(results["qsd"]["to"])

        # Attempt to detect 'from' email address
        if "from" in results["qsd"] and len(results["qsd"]["from"]):
            from_addr = NotifyEmail.unquote(results["qsd"]["from"])

            if "name" in results["qsd"] and len(results["qsd"]["name"]):
                from_addr = formataddr(
                    (NotifyEmail.unquote(results["qsd"]["name"]), from_addr),
                    charset="utf-8",
                )

        elif "name" in results["qsd"] and len(results["qsd"]["name"]):
            # Extract from name to associate with from address
            from_addr = NotifyEmail.unquote(results["qsd"]["name"])

        # Store SMTP Host if specified
        if "smtp" in results["qsd"] and len(results["qsd"]["smtp"]):
            # Extract the smtp server
            smtp_host = NotifyEmail.unquote(results["qsd"]["smtp"])

        if "mode" in results["qsd"] and len(results["qsd"]["mode"]):
            # Extract the security mode override.
            results["secure_mode"] = results["qsd"]["mode"].lower()

        # Handle Carbon Copy Addresses
        if "cc" in results["qsd"] and len(results["qsd"]["cc"]):
            results["cc"] = results["qsd"]["cc"]

        # Handle Blind Carbon Copy Addresses
        if "bcc" in results["qsd"] and len(results["qsd"]["bcc"]):
            results["bcc"] = results["qsd"]["bcc"]

        # Handle Reply To Addresses
        if "reply" in results["qsd"] and len(results["qsd"]["reply"]):
            results["reply_to"] = results["qsd"]["reply"]

        results["from_addr"] = from_addr
        results["smtp_host"] = smtp_host

        # Add our Meta Headers that the user can provide with their outbound
        # emails
        results["headers"] = {
            NotifyBase.unquote(x): NotifyBase.unquote(y)
            for x, y in results["qsd+"].items()
        }

        return results

    @staticmethod
    def _get_charset(input_string):
        """Use UTF-8 only when text contains non-ASCII characters.

        Encoding ASCII unnecessarily can trigger spam filters such as
        Rspamd's ``SUBJ_EXCESS_QP`` rule.
        """
        if not input_string:
            return None
        return "utf-8" if not all(ord(c) < 128 for c in input_string) else None

    @staticmethod
    def prepare_emails(
        subject,
        body,
        from_addr,
        to,
        cc: Optional[set] = None,
        bcc: Optional[set] = None,
        reply_to: Optional[set] = None,
        # SMTP host used in the Message-ID
        smtp_host=None,
        # Either HTML or plain text
        notify_format=NotifyFormat.HTML,
        attach=None,
        headers: Optional[dict] = None,
        # Display names keyed by address
        names=None,
        # Optional PGP controller
        pgp=None,
        # PGP mode string (PGPMode.NONE / PGPMode.SIGN / PGPMode.ENCRYPT)
        pgp_mode=PGP_MODE_DEFAULT,
        # When True, image attachments are embedded inline (RFC 2387)
        # so HTML bodies can reference them via 
        inline=False,
        # Use the system timezone when none is provided.
        tzinfo=None,
    ):
        """Yield prepared email messages.

        - ``from_addr`` is ``(name, address)``; ``to`` contains those pairs.
        - ``cc`` and ``bcc`` are address sets; ``reply_to`` is one address.
        - ``smtp_host`` forms the Message-ID, and ``notify_format`` selects
          plain text or HTML.
        - ``attach`` contains Apprise attachments; ``headers`` adds headers.
        - ``names`` maps addresses to display names for CC and BCC entries.
        - ``pgp`` supplies signing or encryption. ``PGPMode.SIGN`` may also
          encrypt when a recipient key is available.
        """
        if not to:
            # There is no one to email; we're done
            msg = "There are no Email recipients to notify"
            logger.warning(msg)
            raise AppriseEmailException(msg) from None

        elif pgp and pgp_mode != PGP_MODE_DEFAULT and not _pgp.PGP_SUPPORT:
            msg = "PGP Support unavailable; install PGPy library"
            logger.warning(msg)
            raise AppriseEmailException(msg) from None

        if headers is None:
            headers = {}

        if cc is None:
            cc = set()

        if bcc is None:
            bcc = set()

        if reply_to is None:
            reply_to = set()

        if not names:
            # Prepare a empty dictionary to prevent errors/warnings
            names = {}

        if not smtp_host:
            # Generate a host identifier (used for Message-ID Creation)
            smtp_host = from_addr[1].split("@")[1]

        if not tzinfo:
            # use server time
            tzinfo = datetime.now().astimezone().tzinfo

        if subject:
            # Email subjects must be one header line, so collapse whitespace
            # as described by RFC 5322 section 2.2.3.
            subject = " ".join(subject.split())

        logger.debug(f"SMTP Host: {smtp_host}")

        # Create a copy of the targets list
        emails = list(to)
        while len(emails):
            # Get our email to notify
            to_name, to_addr = emails.pop(0)

            # Strip target out of cc list if in To or Bcc
            cc_ = cc - bcc - {to_addr}

            # Strip target out of bcc list if in To
            bcc_ = bcc - {to_addr}

            # Strip target out of reply_to list if in To
            reply_to_ = reply_to - {to_addr}

            # Format our cc addresses to support the Name field
            cc_ = [
                formataddr((names.get(addr, False), addr), charset="utf-8")
                for addr in cc_
            ]

            # Format our bcc addresses to support the Name field
            bcc_ = [
                formataddr((names.get(addr, False), addr), charset="utf-8")
                for addr in bcc_
            ]

            # Format our reply-to addresses to support the Name field
            reply_to_ = [
                formataddr((names.get(addr, False), addr), charset="utf-8")
                for addr in reply_to_
            ]

            logger.debug(
                "Email From: {}".format(formataddr(from_addr, charset="utf-8"))
            )

            logger.debug("Email To: {}".format(to_addr))
            if cc_:
                logger.debug("Email Cc: {}".format(", ".join(cc_)))
            if bcc_:
                logger.debug("Email Bcc: {}".format(", ".join(bcc_)))
            if reply_to_:
                logger.debug("Email Reply-To: {}".format(", ".join(reply_to_)))

            # Prepare inline attachments before building the MIME body:
            # - HTML appends missing image references.
            # - Plain text adds an [Image: name] marker.
            # Non-images remain regular attachments unless explicitly linked.
            cid_refs = set()
            if inline and attach:
                if notify_format == NotifyFormat.HTML:
                    # Collect filenames already referenced via cid:;
                    # decode %20 to spaces so filenames with spaces match
                    # the raw attachment name regardless of how the caller
                    # encoded the URI.
                    cid_refs = {
                        ref.replace("%20", " ")
                        for ref in re.findall(r'cid:([^\s"\'>\)]+)', body)
                    }

                    # Build a set of all attachment filenames so we can
                    # warn about cid: refs that have no matching file
                    _attach_names = {
                        _a.name or f"file{_no:03}.dat"
                        for _no, _a in enumerate(attach, start=1)
                    }

                    # Warn when a cid: reference has no matching attachment.
                    for _ref in sorted(cid_refs - _attach_names):
                        logger.warning(
                            "Email inline: no attachment matches "
                            "cid:%s -- check the filename.",
                            _ref,
                        )

                    # Ignore missing files when selecting the MIME wrapper.
                    # Explicit matching references may use any file type.
                    cid_refs &= _attach_names

                    # Append inline anchors for any image not yet listed
                    img_appends = []
                    for _no, _a in enumerate(attach, start=1):
                        _fname = _a.name or f"file{_no:03}.dat"
                        if (_a.mimetype or "").lower().startswith(
                            "image/"
                        ) and _fname not in cid_refs:
                            img_appends.append(_fname)
                            cid_refs.add(_fname)

                    if img_appends:
                        # Encode spaces as %20 in cid: URIs so filenames
                        # with spaces remain valid HTML attribute values
                        body = body + "".join(
                            '
    '.format(
                                n.replace(" ", "%20")
                            )
                            for n in img_appends
                        )

                else:
                    # Plain text: annotate inline images with a short
                    # text placeholder (images cannot be embedded here)
                    txt_imgs = []
                    for _no, _a in enumerate(attach, start=1):
                        _fname = _a.name or f"file{_no:03}.dat"
                        if (_a.mimetype or "").lower().startswith("image/"):
                            txt_imgs.append(_fname)

                    if txt_imgs:
                        body = (
                            body
                            + "\n"
                            + "\n".join(f"[Image: {n}]" for n in txt_imgs)
                        )

            # Prepare Email Message
            if notify_format == NotifyFormat.HTML:
                base = MIMEMultipart("alternative")
                base.attach(
                    MIMEText(
                        convert_between(
                            NotifyFormat.HTML, NotifyFormat.TEXT, body
                        ),
                        "plain",
                        "utf-8",
                    )
                )
                base.attach(MIMEText(body, "html", "utf-8"))

            else:
                base = MIMEText(body, "plain", "utf-8")

            if attach:
                # Use multipart/related when any image will be embedded
                # inline (RFC 2387); otherwise keep multipart/mixed
                mixed = MIMEMultipart("related" if cid_refs else "mixed")
                mixed.attach(base)

                # Now store our attachments
                for no, attachment in enumerate(attach, start=1):
                    if not attachment:
                        # We could not load the attachment; take an early
                        # exit since this isn't what the end user wanted

                        # We could not access the attachment
                        msg = "Could not access attachment {}.".format(
                            attachment.url(privacy=True)
                        )
                        logger.warning(msg)
                        raise AppriseEmailException(msg)

                    logger.debug(
                        "Preparing Email attachment {}".format(
                            attachment.url(privacy=True)
                        )
                    )

                    with attachment.open() as abody:
                        app = MIMEApplication(abody.read())
                        app.set_type(attachment.mimetype)

                        # Prepare our attachment name
                        filename = (
                            attachment.name
                            if attachment.name
                            else f"file{no:03}.dat"
                        )

                        if filename in cid_refs:
                            # Filename is referenced by a cid: anchor in
                            # the HTML body; embed it inline so clients
                            # render it in-place rather than as a download
                            app.add_header(
                                "Content-Disposition",
                                'inline; filename="{}"'.format(
                                    Header(filename, "utf-8")
                                ),
                            )
                            app.add_header(
                                "Content-ID",
                                # Encode spaces so the Content-ID matches
                                # the cid: URI in the HTML anchor
                                "<{}>".format(filename.replace(" ", "%20")),
                            )

                        else:
                            # Non-image or plain-text-email attachment;
                            # keep it as a regular downloadable file
                            app.add_header(
                                "Content-Disposition",
                                'attachment; filename="{}"'.format(
                                    Header(filename, "utf-8")
                                ),
                            )
                        mixed.attach(app)

                base = mixed

            # Suppress a custom Autocrypt value only when the controller
            # supplies one of its own.
            autocrypt_added = False

            if pgp and pgp_mode == PGPMode.SIGN:
                logger.debug("Securing Email with PGP Signature")
                # RFC 3156 requires the signature to be computed over the CRLF
                # to guarantee all recipients can verify against it.
                sig_result = pgp.sign(
                    re.sub(r"(?:\r\n|\n|\r(?!\n))", "\r\n", base.as_string())
                )

                if not sig_result:
                    # Signing was requested but could not be performed;
                    # this is a hard failure for the sign mode.  Include the
                    # plugin-specific hint here (pgp.py logs only generic
                    # debug detail so it stays reusable across plugins).
                    msg = (
                        "Unable to sign email via PGP; supply a private key"
                        " via pgpprv= or place one in the cache directory"
                    )
                    logger.warning(msg)
                    raise AppriseEmailException(msg)

                # Unpack the signature and its hash algorithm label
                sig_str, micalg = sig_result

                # Build the RFC 3156 multipart/signed container
                signed = MIMEMultipart(
                    "signed",
                    micalg=micalg,
                    protocol="application/pgp-signature",
                )

                # First part: the original message body (must not be
                # modified after this point as the signature covers it)
                signed.attach(base)

                # Second part: the detached PGP signature block
                sig_part = MIMEBase("application", "pgp-signature")
                sig_part.set_payload(sig_str)
                sig_part.add_header(
                    "Content-Disposition",
                    "attachment",
                    filename="signature.asc",
                )
                signed.attach(sig_part)

                # Replace base with the signed container so the rest of
                # the function continues to work unchanged
                base = signed

                # Encrypt when the recipient already has a public key.
                # Sign mode remains usable when no recipient key exists.
                enc_content = pgp.encrypt(
                    base.as_string(), to_addr, autogen=False
                )
                if enc_content:
                    logger.debug("PGP public key found; adding encryption")

                    # Wrap the signed body in a multipart/encrypted
                    # container (the signed payload becomes the ciphertext)
                    enc = MIMEMultipart(
                        "encrypted",
                        protocol="application/pgp-encrypted",
                    )

                    # Version identifier part (required by RFC 3156)
                    ver_part = MIMEText("Version: 1", "plain")
                    ver_part.set_type("application/pgp-encrypted")
                    enc.attach(ver_part)

                    # Encrypted data part
                    data_part = MIMEBase("application", "octet-stream")
                    data_part.set_payload(enc_content)
                    enc.attach(data_part)

                    # Replace base with the fully encrypted container
                    base = enc

                # Advertise our key on the outer message so an Autocrypt-aware
                # recipient can encrypt future replies.
                autocrypt = pgp.autocrypt_header()
                if autocrypt:
                    base.add_header("Autocrypt", autocrypt)
                    autocrypt_added = True

            elif pgp and pgp_mode == PGPMode.ENCRYPT:
                logger.debug("Securing Email with PGP Encryption")
                # Set our header information to include in the encryption
                base["From"] = formataddr(
                    (None, from_addr[1]), charset="utf-8"
                )
                base["To"] = formataddr((None, to_addr), charset="utf-8")
                base["Subject"] = Header(
                    subject, NotifyEmail._get_charset(subject)
                )

                # External recipients need an existing key. Self-sends may
                # generate the sender's key when pgp_autogen permits it.
                autogen = (
                    None if to_addr.lower() == from_addr[1].lower() else False
                )
                encrypted_content = pgp.encrypt(
                    base.as_string(), to_addr, autogen=autogen
                )

                if not encrypted_content:
                    # Give Email users a plugin-specific recovery hint.
                    msg = (
                        "Unable to encrypt email via PGP; supply a public key"
                        " via pgppub= or place one in the cache directory"
                    )
                    logger.warning(msg)
                    raise AppriseEmailException(msg)

                # prepare our message
                base = MIMEMultipart(
                    "encrypted", protocol="application/pgp-encrypted"
                )

                # Advertise our key for encrypted replies.
                autocrypt = pgp.autocrypt_header()
                if autocrypt:
                    base.add_header("Autocrypt", autocrypt)
                    autocrypt_added = True

                # Set Encryption Info Part
                enc_payload = MIMEText("Version: 1", "plain")
                enc_payload.set_type("application/pgp-encrypted")
                base.attach(enc_payload)

                # Set Encrypted Data Part
                enc_payload = MIMEBase("application", "octet-stream")
                enc_payload.set_payload(encrypted_content)
                base.attach(enc_payload)

            # Header names are case-insensitive; keep only the first
            # Autocrypt value unless the controller supplied its own.
            autocrypt_seen = autocrypt_added
            for k, v in headers.items():
                if k.strip().lower() == "autocrypt":
                    if autocrypt_seen:
                        continue
                    autocrypt_seen = True
                base[k] = Header(v, NotifyEmail._get_charset(v))

            base["Subject"] = Header(
                subject, NotifyEmail._get_charset(subject)
            )
            base["From"] = formataddr(from_addr, charset="utf-8")
            base["To"] = formataddr((to_name, to_addr), charset="utf-8")
            base["Message-ID"] = make_msgid(domain=smtp_host)
            base["Date"] = format_datetime(datetime.now(tz=tzinfo))

            if cc_:
                base["Cc"] = ",".join(cc_)

            if reply_to_:
                base["Reply-To"] = ",".join(reply_to_)

            yield EmailMessage(
                recipient=to_addr,
                to_addrs=[to_addr, *list(cc_), *list(bcc_)],
                body=base.as_string(),
            )

    @staticmethod
    def runtime_deps():
        """Return this plugin's optional package names."""
        return ("pgpy",)
caronc-apprise-dfec414/apprise/plugins/email/common.py000066400000000000000000000045031526720371000231760ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.


import dataclasses

from ...exception import ApprisePluginException
from .smtp import SMTP_DEFAULT_PORTS, SMTPSecureMode


class AppriseEmailException(ApprisePluginException):
    """Raised when an email cannot be prepared."""

    def __init__(self, message, error_code=601):
        super().__init__(message, error_code=error_code)


class WebBaseLogin:
    """Identify the login format expected by an email provider."""

    # User Login must be Email Based
    EMAIL = "Email"

    # Login must use a user ID
    USERID = "UserID"


# Keep the established email name as an alias for the shared SMTP modes.
SecureMailMode = SMTPSecureMode

# Preserve the existing mode-to-default-port format for email callers.
SECURE_MODES = {
    mode: {"default_port": port} for mode, port in SMTP_DEFAULT_PORTS.items()
}


@dataclasses.dataclass
class EmailMessage:
    """Prepared email payload and recipients."""

    recipient: str
    to_addrs: list[str]
    body: str
caronc-apprise-dfec414/apprise/plugins/email/smtp.py000066400000000000000000000147221526720371000226750ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Shared SMTP connection handling for Email and its subclasses.

import contextlib
import smtplib
import ssl
from typing import Optional

from ...exception import AppriseImproperlyConfigured
from ...logger import logger


class SMTPSecureMode:
    """SMTP transport security mode."""

    # No transport security at all
    INSECURE = "insecure"

    # Implicit TLS from the first byte of the connection
    SSL = "ssl"

    # Plaintext connection upgraded to TLS via STARTTLS
    STARTTLS = "starttls"


# Every valid secure mode
SMTP_SECURE_MODES = (
    SMTPSecureMode.STARTTLS,
    SMTPSecureMode.SSL,
    SMTPSecureMode.INSECURE,
)

# Default SMTP submission port per security mode
SMTP_DEFAULT_PORTS = {
    SMTPSecureMode.STARTTLS: 587,
    SMTPSecureMode.SSL: 465,
    SMTPSecureMode.INSECURE: 25,
}

# The exceptions every SMTP operation in this module guards against
SMTP_EXCEPTIONS = (OSError, smtplib.SMTPException, RuntimeError)


class AppriseSMTPController:
    """Manage one authenticated SMTP connection within a context manager.

    ``sendmail()`` returns false for delivery errors. Connection and login
    errors leave the context so the plugin can report the whole send as failed.

        with AppriseSMTPController(
            host=host, port=port, secure_mode=secure_mode,
            user=user, password=password,
        ) as smtp:
            for target in targets:
                message = build_message(target)
                if not smtp.sendmail(from_addr, [target], message):
                    has_error = True
    """

    def __init__(
        self,
        host: str,
        port: int,
        secure_mode: str,
        user: Optional[str] = None,
        password: Optional[str] = None,
        verify_certificate: bool = True,
        socket_connect_timeout: int = 15,
    ) -> None:
        self.host = host
        self.port = port
        self.secure_mode = secure_mode
        self.user = user
        self.password = password
        self.verify_certificate = verify_certificate
        self.socket_connect_timeout = socket_connect_timeout

        # Bind our socket variable to the current namespace
        self._socket = None

    def __enter__(self) -> "AppriseSMTPController":
        """Connects, secures, and authenticates the SMTP session."""

        if self.secure_mode not in SMTP_SECURE_MODES:
            # Reject unknown modes rather than silently using plain SMTP.
            raise AppriseImproperlyConfigured(
                f"Invalid SMTP secure mode: {self.secure_mode!r}"
            )

        # Configure certificate and hostname checks for encrypted connections.
        context = ssl.create_default_context()
        if not self.verify_certificate:
            context.check_hostname = False
            context.verify_mode = ssl.CERT_NONE

        try:
            logger.debug("Connecting to remote SMTP server...")
            socket_func = smtplib.SMTP
            socket_args = {}
            if self.secure_mode == SMTPSecureMode.SSL:
                logger.debug("Securing connection with SSL...")
                socket_func = smtplib.SMTP_SSL
                socket_args["context"] = context

            self._socket = socket_func(
                self.host,
                self.port,
                None,
                timeout=self.socket_connect_timeout,
                **socket_args,
            )

            if self.secure_mode == SMTPSecureMode.STARTTLS:
                # Handle Secure Connections
                logger.debug("Securing connection with STARTTLS...")
                self._socket.starttls(context=context)

            logger.trace("Login ID: %s", self.user)
            if self.user and self.password:
                # Apply Login credentials
                logger.debug("Applying user credentials...")
                self._socket.login(self.user, self.password)

        except SMTP_EXCEPTIONS:
            # Close a connection that failed during STARTTLS or login.
            if self._socket is not None:
                with contextlib.suppress(*SMTP_EXCEPTIONS):
                    self._socket.quit()
                self._socket = None
            raise

        return self

    def sendmail(self, from_addr: str, to_addrs: list, message: str) -> bool:
        """Send one prepared message and return whether it succeeded."""

        try:
            # A non-empty result lists recipients SMTP refused.
            refused = self._socket.sendmail(from_addr, to_addrs, message)

        except SMTP_EXCEPTIONS as e:
            logger.debug("Socket Exception: %s", str(e))
            return False

        if refused:
            for addr, (code, resp) in refused.items():
                logger.warning(
                    "SMTP recipient %s was refused: %s %s", addr, code, resp
                )
            return False

        return True

    def __exit__(self, exc_type, exc_val, exc_tb) -> None:
        """Gracefully terminates the connection with the server."""

        if self._socket is not None:
            with contextlib.suppress(*SMTP_EXCEPTIONS):
                # The socket may already be invalid after a TLS failure.
                self._socket.quit()
caronc-apprise-dfec414/apprise/plugins/email/templates.py000066400000000000000000000241541526720371000237100ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.


import re

from .common import SecureMailMode, WebBaseLogin

# To attempt to make this script stupid proof, if we detect an email address
# that is part of the this table, we can pre-use a lot more defaults if they
# aren't otherwise specified on the users input.
EMAIL_TEMPLATES = (
    # Google GMail
    (
        "Google Mail",
        re.compile(
            r"^((?P     in two
            split_at = html_tag_adjust(text, start, split_at, window_end)

        elif body_format is NotifyFormat.MARKDOWN:
            # Markdown may also contain HTML entities.
            split_at = html_adjust(text, start, split_at)
            split_at = markdown_adjust(text, start, split_at)

            # Never separate an escaping backslash from the character it
            # escapes. An odd run of backslashes right before the split
            # means the last one still needs its partner, so keep them
            # together in the next chunk.
            chunk = text[start:split_at]
            if (len(chunk) - len(chunk.rstrip("\\"))) % 2:
                split_at -= 1

        if split_at <= start:
            split_at = orig_split

        result.append(text[start:split_at])
        start = split_at

    return result
caronc-apprise-dfec414/apprise/utils/http.py000066400000000000000000000460041526720371000212570ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

"""Opt-in HTTP destination checks for callers that fetch untrusted URLs.

Apprise API imports HTTPPolicy, HTTPPolicySession and is_public_ip_address
from here, so this module is shared between the two projects rather than
being internal to Apprise. Anything in it that looks unused from inside
Apprise alone is most likely there for that caller; check apprise-api
before removing it.

Requests and urllib3 are the only HTTP libraries involved, and nothing here
needs, or should grow, another one. urllib3 is not held at arm's length
though: pinning a connection to an address we already approved is not
something its public interface can express, so this module subclasses its
connection and pool classes and hooks two protected details.

- ``_new_conn()`` is overridden to open our own pinned socket.
- ``_dns_host`` is read rather than ``host``, because it is the name urllib3
  itself resolves; ``host`` may have been normalized by then.

Both have been present unchanged through urllib3 1.26 and 2.x. What is
deliberately avoided is *importing* underscore-prefixed names out of
urllib3, since those do move between releases and several are missing from
1.26 altogether; ``_DEFAULT_TIMEOUT`` below is defined locally for exactly
that reason.

Because of that coupling, the tests for this module are a compatibility
gate rather than plain unit tests. Run them against the oldest urllib3 that
Apprise supports (the 1.26 series, which RHEL and Rocky Linux ship) as well
as the current one before accepting a change here.
"""

from concurrent.futures import (
    ThreadPoolExecutor,
    TimeoutError as FutureTimeoutError,
)
import ipaddress
import socket
from socket import timeout as SocketTimeout
import sys
import threading
from urllib.parse import urlsplit

import requests
from requests.adapters import HTTPAdapter
from urllib3.connection import HTTPConnection, HTTPSConnection
from urllib3.connectionpool import HTTPConnectionPool, HTTPSConnectionPool
from urllib3.exceptions import (
    ConnectTimeoutError,
    NewConnectionError,
)
from urllib3.poolmanager import PoolManager
from urllib3.util.connection import allowed_gai_family

from .parse import is_hostname

# Keep this sentinel local because urllib3's private equivalent varies by
# version and is absent from the widely used 1.26.x series.
_DEFAULT_TIMEOUT = object()

# DNS work is shared so many policies cannot create unbounded thread pools.
_DNS_POOL = ThreadPoolExecutor(
    max_workers=8,
    thread_name_prefix="apprise-http-resolve",
)
_DNS_SLOTS = threading.BoundedSemaphore(16)

# RFC 6598 shared space is neither private nor generally Internet-routable.
_CGN_SHARED_V4 = ipaddress.ip_network("100.64.0.0/10")

# Standard NAT64 prefixes carry an IPv4 destination in their final 32 bits.
_NAT64_NETWORKS = (
    ipaddress.ip_network("64:ff9b::/96"),
    ipaddress.ip_network("64:ff9b:1::/48"),
)


def is_public_ip_address(value):
    """Return true for an ordinary public unicast IP address."""
    try:
        address = ipaddress.ip_address(value)
    except ValueError:
        return False

    if isinstance(address, ipaddress.IPv6Address):
        # NAT64 inherits the safety classification of its embedded IPv4.
        for network in _NAT64_NETWORKS:
            if address in network:
                embedded = ipaddress.IPv4Address(int(address) & 0xFFFFFFFF)
                return is_public_ip_address(embedded)

        # Judge IPv4-mapped addresses by their embedded IPv4 address because
        # some Python releases misclassify the IPv6 wrapper as reserved.
        if address.ipv4_mapped is not None:
            return is_public_ip_address(address.ipv4_mapped)

    # Reject any address that is not a public unicast address.
    blocked = (
        address.is_private
        or address.is_loopback
        or address.is_link_local
        or (
            isinstance(address, ipaddress.IPv6Address)
            and address.is_site_local
        )
        or address.is_reserved
        or address.is_unspecified
        or address.is_multicast
        or (
            isinstance(address, ipaddress.IPv4Address)
            and address in _CGN_SHARED_V4
        )
    )
    if blocked:
        return False

    if isinstance(address, ipaddress.IPv6Address):
        # IPv4-mapped addresses returned above; validate 6to4 addresses here.
        if address.sixtofour and not is_public_ip_address(address.sixtofour):
            return False

        # Teredo addresses embed an IPv4 address in their last 32 bits.
        if address.teredo and not all(
            is_public_ip_address(item) for item in address.teredo
        ):
            return False

    return True


def is_secure_http_url(url):
    """Validate a URL before it is used as a request target.

    A valid URL:
     - uses HTTPS
     - points at a valid hostname or IP address
     - carries no username or password, even an empty one
     - has a usable port
     - has no fragment, which would not reach the server

    Private hosts remain valid for self-hosted services. Returns ``True``
    when all checks pass and ``False`` otherwise.
    """

    if not isinstance(url, str):
        return False

    try:
        parsed = urlsplit(url)

        # Reading an invalid port, or a malformed IPv6 address, raises a
        # ValueError here.
        port = parsed.port

    except ValueError:
        return False

    # Port zero cannot be connected to.
    if port == 0:
        return False

    # A fragment is never sent to a server. An empty one still counts, so
    # the character itself is what we look for.
    if "#" in url:
        return False

    # Anything that is not HTTPS is refused.
    if parsed.scheme.lower() != "https":
        return False

    # A URL with no destination host is of no use to us.
    hostname = parsed.hostname
    if not hostname:
        return False

    # Reject credentials embedded in the URL. The comparison is against
    # None so that an empty https://@example.com is caught too.
    if parsed.username is not None or parsed.password is not None:
        return False

    # Confirm the host itself is sane. This covers hostnames, IPv4 and
    # IPv6 alike; only the yes or no answer is needed here.
    return bool(is_hostname(hostname))


def read_bounded_response(r, max_bytes, chunk_size=65536):
    """Read and close a streamed response.

    Return ``None`` if the response exceeds ``max_bytes``; otherwise,
    return the bytes read.
    """
    chunks = []
    total = 0
    try:
        for chunk in r.iter_content(chunk_size=chunk_size):
            if not chunk:
                continue

            total += len(chunk)
            if total > max_bytes:
                return None

            chunks.append(chunk)

        return b"".join(chunks)

    finally:
        r.close()


def _release_dns_slot(_future):
    """Release a DNS slot only after its lookup has actually stopped."""
    _DNS_SLOTS.release()


def _set_socket_options(sock, options):
    """Apply the same socket options urllib3 would normally configure.

    Three shapes of option arrive here, and all three are supported on
    purpose:

    - ``(level, option, value)``, which is what urllib3 itself supplies.
    - ``(level, option, value, "tcp"|"udp")``, which urllib3-future adds so
      one option list can describe both transports. Apprise never requires
      urllib3-future, but a host may well have it installed, and an option
      it supplies must not raise here.
    - ``(level, option, None, length)``, Python's own form for an option
      given by length rather than by value.

    The tests build each shape by hand instead of installing anything, so
    they also pass on systems that ship the older urllib3 1.26 series.
    """
    if options is None:
        return

    for opt in options:
        # A fourth item that is text names the transport the option belongs
        # to, so an option meant for UDP is not pushed onto a TCP socket.
        if len(opt) == 4 and isinstance(opt[3], str):
            socket_type = {
                "tcp": socket.SOCK_STREAM,
                "udp": socket.SOCK_DGRAM,
            }.get(opt[3].lower())
            if socket_type == sock.type:
                sock.setsockopt(*opt[:3])

            continue

        # This also preserves Python's (level, option, None, length) form.
        sock.setsockopt(*opt)


class HTTPPolicy:
    """Validate URLs and pin connections to approved DNS answers.

    ``url_filter`` and ``address_filter`` return true for allowed values.
    They are optional so applications can enforce only the rules they need.
    """

    def __init__(
        self,
        url_filter=None,
        address_filter=None,
        resolve_timeout=5.0,
    ):
        self.url_filter = url_filter
        self.address_filter = address_filter
        self.resolve_timeout = resolve_timeout

    def validate_url(self, url):
        """Raise InvalidURL when a request URL is not approved."""
        if not self.url_filter:
            return

        try:
            allowed = self.url_filter(url)
        except Exception as exc:
            # A broken application policy must fail closed as a request error.
            raise requests.exceptions.InvalidURL(
                "Outbound HTTP URL policy failed"
            ) from exc

        if not allowed:
            # A policy that returns false must fail closed as a request error.
            raise requests.exceptions.InvalidURL(
                "URL denied by outbound HTTP policy"
            )

    def resolve(self, host, port):
        """Resolve once and return approved connection addresses."""
        # Refuse new work when slow DNS has consumed the bounded capacity.
        if not _DNS_SLOTS.acquire(blocking=False):
            raise socket.gaierror(
                socket.EAI_AGAIN,
                "DNS resolver capacity exhausted",
            )

        try:
            # Submit a DNS lookup to the shared thread pool so it cannot block
            # the caller.
            future = _DNS_POOL.submit(
                socket.getaddrinfo,
                host,
                port,
                allowed_gai_family(),
                socket.SOCK_STREAM,
            )
        except Exception as exc:
            _DNS_SLOTS.release()
            raise socket.gaierror(
                socket.EAI_AGAIN,
                "DNS resolver is unavailable",
            ) from exc

        # Timed-out native lookups retain their slot until the worker exits.
        future.add_done_callback(_release_dns_slot)
        try:
            answers = future.result(timeout=self.resolve_timeout)
        except FutureTimeoutError as exc:
            future.cancel()
            raise socket.gaierror(
                socket.EAI_AGAIN,
                "DNS resolution timed out",
            ) from exc
        except Exception as exc:
            # Normalize resolver failures for urllib3's connection handling.
            raise socket.gaierror(
                socket.EAI_NONAME,
                "DNS resolution failed",
            ) from exc

        # Preserve each full sockaddr so connecting cannot trigger new DNS.
        approved = []
        for answer in answers:
            try:
                address = answer[4][0]
            except (IndexError, TypeError):
                # An unrecognizable resolver result cannot be trusted.
                continue

            if self.address_filter:
                try:
                    if not self.address_filter(address):
                        continue
                except Exception as exc:
                    # A broken policy callback must fail closed.
                    raise socket.gaierror(
                        socket.EAI_NONAME,
                        "Address policy failed",
                    ) from exc

            approved.append(answer)

        if not approved:
            raise socket.gaierror(
                socket.EAI_NONAME,
                "No DNS address passed the outbound HTTP policy",
            )

        return approved

    def create_connection(
        self,
        host,
        port,
        timeout=_DEFAULT_TIMEOUT,
        source_address=None,
        socket_options=None,
    ):
        """Connect to a previously validated DNS answer."""
        error = None
        for family, socktype, proto, _canonname, sockaddr in self.resolve(
            host,
            port,
        ):
            sock = None
            try:
                # Apply the same socket settings urllib3 normally uses.
                sock = socket.socket(family, socktype, proto)
                _set_socket_options(sock, socket_options)
                if timeout is not _DEFAULT_TIMEOUT:
                    sock.settimeout(timeout)
                if source_address:
                    sock.bind(source_address)

                sock.connect(sockaddr)

                # Confirm the socket reached the exact address DNS approved.
                try:
                    expected_address = ipaddress.ip_address(sockaddr[0])
                    peer_address = ipaddress.ip_address(sock.getpeername()[0])
                except (IndexError, TypeError, ValueError) as exc:
                    raise OSError(
                        "Connected socket returned an invalid peer address"
                    ) from exc

                if peer_address != expected_address:
                    raise OSError(
                        "Connected peer did not match the approved DNS address"
                    )

                return sock

            except OSError as exc:
                error = exc
                if sock is not None:
                    sock.close()

        if error is not None:
            raise error

        raise OSError("getaddrinfo returned no usable addresses")


class _PolicyConnectionMixin:
    """Route urllib3 connections through an HTTPPolicy."""

    policy = None

    def _new_conn(self):
        """Open a pinned socket while retaining the original TLS hostname."""
        try:
            sock = self.policy.create_connection(
                self._dns_host,
                self.port,
                timeout=self.timeout,
                source_address=self.source_address,
                socket_options=self.socket_options,
            )
        except socket.gaierror as exc:
            # This exception exists across supported urllib3 releases.
            raise NewConnectionError(
                self,
                "Failed to resolve an approved address for "
                f"{self.host}: {exc}",
            ) from exc
        except SocketTimeout as exc:
            raise ConnectTimeoutError(
                self,
                f"Connection to {self.host} timed out. "
                f"(connect timeout={self.timeout})",
            ) from exc
        except OSError as exc:
            raise NewConnectionError(
                self,
                f"Failed to establish a new connection: {exc}",
            ) from exc

        sys.audit("http.client.connect", self, self.host, self.port)
        return sock


def _policy_pool_classes(policy):
    """Build connection pools bound to one request policy."""

    class PolicyHTTPConnection(_PolicyConnectionMixin, HTTPConnection):
        pass

    class PolicyHTTPSConnection(_PolicyConnectionMixin, HTTPSConnection):
        pass

    # Class attributes avoid leaking policy objects into urllib3 pool keys.
    PolicyHTTPConnection.policy = policy
    PolicyHTTPSConnection.policy = policy

    class PolicyHTTPConnectionPool(HTTPConnectionPool):
        """Use a policy-aware connection class for HTTP."""

        ConnectionCls = PolicyHTTPConnection

    class PolicyHTTPSConnectionPool(HTTPSConnectionPool):
        """Use a policy-aware connection class for HTTPS."""

        ConnectionCls = PolicyHTTPSConnection

    return {
        "http": PolicyHTTPConnectionPool,
        "https": PolicyHTTPSConnectionPool,
    }


class _PolicyHTTPAdapter(HTTPAdapter):
    """Install policy-aware connection pools into Requests."""

    def __init__(self, policy, *args, **kwargs):
        self.policy = policy
        super().__init__(*args, **kwargs)

    def init_poolmanager(
        self,
        connections,
        maxsize,
        block=False,
        **pool_kwargs,
    ):
        """Create the normal manager, then replace its pool classes."""
        # These three belong to Requests' own adapter rather than to urllib3.
        # They are part of what it pickles, so an adapter that overrides this
        # method still has to set them.
        self._pool_connections = connections
        self._pool_maxsize = maxsize
        self._pool_block = block
        self.poolmanager = PoolManager(
            num_pools=connections,
            maxsize=maxsize,
            block=block,
            **pool_kwargs,
        )
        self.poolmanager.pool_classes_by_scheme = _policy_pool_classes(
            self.policy
        )

    def proxy_manager_for(self, proxy, **proxy_kwargs):
        """Reject proxies because they resolve targets outside this policy."""
        raise requests.exceptions.ProxyError(
            "Proxies are disabled by outbound HTTP policy"
        )


class HTTPPolicySession(requests.Session):
    """A Requests session that validates every hop and pins its DNS result."""

    def __init__(self, policy):
        """Create a session that enforces the given HTTPPolicy."""
        super().__init__()
        self.policy = policy

        # Environment proxies must not reroute a checked destination.
        self.trust_env = False

        # Install a policy-aware adapter for all HTTP and HTTPS requests.
        adapter = _PolicyHTTPAdapter(policy)
        self.mount("http://", adapter)
        self.mount("https://", adapter)

    def send(self, request, **kwargs):
        """Validate the initial URL and every redirect before transmission."""
        self.policy.validate_url(request.url)
        return super().send(request, **kwargs)
caronc-apprise-dfec414/apprise/utils/json.py000066400000000000000000000042561526720371000212540ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import base64
from datetime import datetime
import json

from ..common import AWARE_DATE_ISO_FORMAT, NAIVE_DATE_ISO_FORMAT
from ..locale import LazyTranslation


class AppriseJSONEncoder(json.JSONEncoder):
    """A JSON Encoder for handling Apprise internals."""

    def default(self, entry):
        if isinstance(entry, datetime):
            return entry.strftime(
                AWARE_DATE_ISO_FORMAT
                if entry.tzinfo is not None
                else NAIVE_DATE_ISO_FORMAT
            )

        elif isinstance(entry, bytes):
            return base64.b64encode(entry).decode("utf-8")

        elif isinstance(entry, (set, frozenset, tuple)):
            return list(entry)

        elif isinstance(entry, LazyTranslation):
            return str(entry)

        return super().default(entry)
caronc-apprise-dfec414/apprise/utils/logic.py000066400000000000000000000131571526720371000214000ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
from itertools import chain

from .. import common
from ..tag import AppriseTag
from .parse import parse_list


def _token_matches_data(tok, data, match_all):
    """Return True if filter token *tok* matches any entry in *data*.

    When the token carries an explicit priority (e.g. "3:endpoint"), only data
    entries that are AppriseTag objects with that exact priority match.  When
    the token has no priority prefix, any data entry with the same tag name
    matches regardless of its stored priority.
    """
    ft = AppriseTag.parse(tok)
    tag_name = str(ft)

    if tag_name == match_all:
        return True

    if not ft.has_priority:
        # Name-only: works transparently for both str and AppriseTag in data
        # because AppriseTag.__hash__ == hash(tag_name) and __eq__ handles str.
        return tag_name in data

    # Priority-exact: must find a matching AppriseTag with the same priority.
    # Plain-string entries in data (backward compat) fall back to name-only.
    for item in data:
        if isinstance(item, AppriseTag):
            if str(item) == tag_name and item.priority == ft.priority:
                return True
        else:
            if str(item).lower() == tag_name:
                return True
    return False


def is_exclusive_match(
    logic,
    data,
    match_all=common.MATCH_ALL_TAG,
    match_always=common.MATCH_ALWAYS_TAG,
):
    """The data variable should always be a set of strings that the logic can
    be compared against. It should be a set.  If it isn't already, then it will
    be converted as such. These identify the tags themselves.

    Our logic should be a list as well:
      - top level entries are treated as an 'or'
      - second level (or more) entries are treated as 'and'

      examples:
        logic="tagA, tagB"                = tagA or tagB
        logic=['tagA', 'tagB']            = tagA or tagB
        logic=[('tagA', 'tagC'), 'tagB']  = (tagA and tagC) or tagB
        logic=[('tagB', 'tagC')]          = tagB and tagC

    Filter tokens may carry an explicit priority prefix (e.g. "3:endpoint").
    When present, only server tags that are AppriseTag objects with that exact
    priority will match.  Tokens without a priority prefix match any priority.

    If `match_always` is not set to None, then its value is added as an 'or'
    to all specified logic searches.
    """

    if isinstance(logic, str):
        # Update our logic to support our delimiters
        logic = set(parse_list(logic))

    if not logic:
        # If there is no logic to apply then we're done early; we only match
        # if there is also no data to match against
        return not data

    if not isinstance(logic, (list, tuple, set)):
        # garbage input
        return False

    if match_always:
        # Add our match_always to our logic searching if specified
        logic = chain(logic, [match_always])

    # Track what we match against; but by default we do not match
    # against anything
    matched = False

    # Every entry here will be or'ed with the next
    for entry in logic:
        if not isinstance(entry, (str, list, tuple, set)):
            # Garbage entry in our logic found
            return False

        # All tokens within an entry are AND-ed: every token must match data.
        raw = parse_list(entry)
        if not raw:
            # We got a bogus set of tags to parse; match only if data is empty
            return not data

        if all(_token_matches_data(tok, data, match_all) for tok in raw):
            matched = True
            break

        # else: keep looking

    # Return True if we matched against our logic (or simply none was
    # specified).
    return matched


def dict_full_update(dict1, dict2):
    """Takes 2 dictionaries (dict1 and dict2) that contain sub-dictionaries and
    gracefully merges them into dict1.

    This is similar to: dict1.update(dict2) except that internal dictionaries
    are also recursively applied.
    """

    def _merge(dict1, dict2):
        for k in dict2:
            if (
                k in dict1
                and isinstance(dict1[k], dict)
                and isinstance(dict2[k], dict)
            ):
                _merge(dict1[k], dict2[k])
            else:
                dict1[k] = dict2[k]

    _merge(dict1, dict2)
    return
caronc-apprise-dfec414/apprise/utils/module.py000066400000000000000000000040061526720371000215610ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
import contextlib
import importlib.util
import sys

from ..logger import logger


def import_module(path, name):
    """Load our module based on path."""
    spec = importlib.util.spec_from_file_location(name, path)
    try:
        module = importlib.util.module_from_spec(spec)
        sys.modules[name] = module

        spec.loader.exec_module(module)

    except Exception as e:
        # module isn't loadable
        with contextlib.suppress(KeyError):
            del sys.modules[name]

        module = None

        logger.debug(
            "Module exception raised from %s (name=%s) %s", path, name, str(e)
        )

    return module
caronc-apprise-dfec414/apprise/utils/parse.py000066400000000000000000001322571526720371000214200ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
import contextlib
from functools import reduce
import re
from urllib.parse import quote, unquote, urlencode as _urlencode, urlparse

from .disk import tidy_path

# URL Indexing Table for returns via parse_url()
# The below accepts and scans for:
#  - schema://
#  - schema://path
#  - schema://path?kwargs
#
VALID_URL_RE = re.compile(
    r"^[\s]*((?P[^:\s]+):[/\\]+)?((?P[^?]+)"
    r"(\?(?P.+))?)?[\s]*$",
)
VALID_QUERY_RE = re.compile(r"^(?P.*[/\\])(?P[^/\\]+)?$")

# RFC 3986 path characters that are safe to leave unencoded when we
# quote() a URL path. This is the pchar sub-delims set minus comma and
# semicolon, which Apprise reserves as its own list delimiters. Shared by
# parse_url() below and by every url() implementation that re-quotes a
# previously parsed fullpath, so a literal path character (such as the
# '@' in a jsDelivr version selector) is never re-percent-encoded when a
# URL is reconstructed.
URL_PATH_SAFE_CHARS = "/:@!$&'()*+="

# The same characters without the slash, for quoting one path segment.
# An encoded slash (%2F) inside a segment then stays encoded.
URL_SEGMENT_SAFE_CHARS = URL_PATH_SAFE_CHARS.replace("/", "")

# The same characters plus '%', for quoting a path that is already
# percent-encoded (the way parse_url() returns it).  Existing escapes
# such as %20 or %2F are kept instead of being encoded a second time.
URL_ENCODED_PATH_SAFE_CHARS = URL_PATH_SAFE_CHARS + "%"

# delimiters used to separate values when content is passed in by string.
# This is useful when turning a string into a list
STRING_DELIMITERS = r"[\[\]\;,\s]+"

# String Delimiters without the whitespace
STRING_DELIMITERS_NO_WS = r"[\[\]\;,]+"

# The handling of custom arguments passed in the URL; we treat any
# argument (which would otherwise appear in the qsd area of our parse_url()
# function differently if they start with a +, - or : value
NOTIFY_CUSTOM_ADD_TOKENS = re.compile(r"^( |\+)(?P.*)\s*")
NOTIFY_CUSTOM_DEL_TOKENS = re.compile(r"^-(?P.*)\s*")
NOTIFY_CUSTOM_COLON_TOKENS = re.compile(r"^:(?P.*)\s*")

# Used for attempting to acquire the schema if the URL can't be parsed.
GET_SCHEMA_RE = re.compile(r"\s*(?P[a-z0-9]{1,32})://.*$", re.I)

# Used for validating that a provided entry is indeed a schema
# this is slightly different then the GET_SCHEMA_RE above which
# insists the schema is only valid with a :// entry.  this one
# extrapolates the individual entries
URL_DETAILS_RE = re.compile(
    r"\s*(?P[a-z0-9]{1,32})(://(?P.*))?$", re.I
)

# Regular expression based and expanded from:
# http://www.regular-expressions.info/email.html
# Extended to support colon (:) delimiter for parsing names from the URL
# such as:
#   - 'Optional Name':user@example.com
#   - 'Optional Name' 
#
# The expression also parses the general email as well such as:
#   - user@example.com
#   - label+user@example.com
GET_EMAIL_RE = re.compile(
    r'(([\s"\']{0,32})?(?P[^:<\'"]{0,128})?[:<\s\'"]{1,32})?'
    r"(?P((?P
    

  

  
      
    
    1. apprise(1)
      2. 
    
    2. 
    
    3. apprise(1)
      4. 
  
    

  


    NAME
    

    
  apprise - Push Notifications that work with just about every platform!

    

    SYNOPSIS
    


    apprise [options...] service-url...
    
apprise storage [options...] [action] [url-or-uid...]
    


    DESCRIPTION
    


    Apprise allows you to send a notification to almost all of the most
popular notification services available to us today such as: Discord,
Telegram, Pushbullet, Slack, Twitter, etc.
    


      
  
    • One notification library to rule them all.
      • 
  
    • A common and intuitive notification syntax.
      • 
  
    • Supports the handling of images (to the notification services that will
accept them).
      • 
  
    • It's incredibly lightweight.
      • 
  
    • Amazing response times because all messages sent asynchronously.
      • 

    


    OPTIONS
    


    The Apprise options are as follows:
    


    -b, --body=VALUE:
  Specify the message body. If no body is specified then content is read from
  stdin.
    


    -t, --title=VALUE:
  Specify the message title. This field is completely optional.
    


    -c, --config=CONFIG-URL:
  Specify one or more configuration locations.
    


    -a, --attach=ATTACH-URL:
  Specify one or more file attachment locations.
    


    -P, --plugin-path=PATH:
  Specify a path to scan for custom notification plugin support.
  You can create your own notification by simply creating a Python file
  that contains the @notify("schema") decorator.
    


    You can optionally choose to specify more than one --plugin-path (-P)
  to increase the modules included.
    


    -n, --notification-type=VALUE:
  Specify the message type (default=info). Possible values are "info",
  "success", "failure", and "warning".
    


    -i, --input-format=VALUE:
  Specify the input message format (default=text). Possible values are "text",
  "html", and "markdown".
    


    -T, --theme=VALUE:
  Specify the default theme.
    


    -tv, --template-var=NAME=VALUE:
  Supply a value used by a YAML configuration written with ${NAME}.
  Specify this option more than once to supply more than one value, but
  name each one only once.
  A value not provided here uses the default in the configuration's
  template: section, then APPRISE_TEMPLATE_<NAME>. A URL that still has no value
  available is not loaded.
    


    -g, --tag=VALUE:
  Specify one or more tags to filter which services to notify:
    


      
  
    • 
-g "tagA" -g "tagB": Match tagA OR tagB (Union).
      • 
  
    • 
-g "tagA,tagB": Match tagA AND tagB (Strict).
      • 
  
    • 
-g "all": Notify ALL services.
      • 
  
    • 
(Omitted): Notify untagged services only.
      • 

    


    Tag values may include an optional priority prefix and/or retry suffix:
    


      
  
    • 
-g "2:tagA": Match only entries for tagA assigned priority 2.
      • 
  
    • 
-g "tagA:3": Match all tagA entries, retrying each up to 3 times.
      • 
  
    • 
-g "2:tagA:3": Priority-2 tagA entries only, with up to 3 retries.
      • 

    


    -Da, --disable-async:
  Send notifications synchronously (one after the other) instead of
  all at once.
    


    -L, --limit=SECONDS:
  Give up on the whole run if it's taking too long, e.g. -L 10 or
  -L 2.5. By default (0) there's no limit; see --service-limit
  below to cap each service on its own instead. If a service is truly
  stuck, Apprise gives it a few extra seconds to wrap up, then exits
  anyway with status 5.
    


    -SL, --service-limit=SECONDS:
  Give up on any single service if it's taking too long, e.g. -SL 10
  or -SL 2.5, or 0 to turn this off entirely. Leave it unset to use
  Apprise's own default of 60 seconds.
    


    -R, --recursion-depthINTEGER:
  The number of recursive import entries that can be loaded from within
  Apprise configuration. By default this is set to 1. If this is set to
  zero, then import statements found in any configuration is ignored.
    


    -e, --interpret-escapes
  Enable interpretation of backslash escapes. For example, this would convert
  sequences such as \n and \r to their respected ascii new-line and carriage
  return characters prior to the delivery of the notification.
    


    -j, --interpret-emojis
  Enable interpretation of emoji strings. For example, this would convert
  sequences such as :smile: or :grin: to their respected unicode emoji
  character.
    


    -S, --storage-path=PATH:
  Specify the path to the persistent storage caching location
    


    -SM, --storage-mode=MODE:
  Specify the persistent storage operational mode. Possible values are "auto",
  "flush", and "memory". The default is "auto" if not specified.
    


    -SPD, --storage-prune-days=INTEGER:
  Define the number of days the storage prune should run using.
  Setting this to zero (0) will eliminate all accumulated content. By
  default this value is 30 (days).
    


    -SUL, --storage-uid-length=INTEGER:
  Define the number of unique characters to store persistent cache in.
  By default this value is 8 (characters).
    


    -d, --dry-run:
  Perform a trial run but only prints the notification services to-be
  triggered to stdout. Notifications are never sent using this mode.
    


    -l, --details
  Prints details about the current services supported by Apprise.
    


    -v, --verbose:
  The more of these you specify, the more verbose the output is. e.g: -vvvv
    


    -D, --debug:
  A debug mode; useful for troubleshooting.
    


    -V, --version:
  Display the apprise version and exit.
    


    -h, --help:
  Show this message and exit.
    


    PERSISTENT STORAGE
    


    Persistent storage by default writes to the following location unless the environment variable APPRISE_STORAGE_PATH overrides it and/or --storage-path (-SP) is specified to override it:
    


    ~/.local/share/apprise/cache

    


    To utilize the persistent storage element associated with Apprise, simply
specify the keyword storage
    


    $ apprise storage

    


    The storage action has the following sub actions:
    


    list:
  List all of the detected persistent storage elements and their state
  (stale, active, or unused).  This is the default action if
  nothing further is identified.  Results may be filtered by passing one
  or more 8-character UID prefix strings, or by passing full Apprise
  service URLs — each URL is resolved to its storage namespace
  automatically, making it easy to look up a specific plugin's cache
  entry without knowing the hash in advance.
    


    prune:
  Removes all persistent storage that has not been referenced for more than 30
  days. You can optionally set the --storage-prune-days to alter this
  default value.
    


    clean:
  Removes all persistent storage regardless of age.
    


    EXIT STATUS
    


    apprise exits with a status of:
    


      
  
    • 
0 if all of the notifications were sent successfully.
      • 
  
    • 
1 if every notification failed, or the notification could not start.
      • 
  
    • 
2 if there was an error specified on the command line such as not
providing a valid argument.
      • 
  
    • 
3 if one or more Apprise Service URLs were successfully loaded but
none could be notified due to user filtering (via tags).
      • 
  
    • 
4 if at least one notification was sent successfully and at least
one other was not (whether it failed outright or ran out of time).
      • 
  
    • 
5 if no notification was sent, and the only problem was that one or
more services ran out of time.
      • 

    


    SERVICE URLS
    


    There are too many service URL and combinations to list here. It's best to
visit the Apprise GitHub page and see what's available.
Also try out the Apprise URL Builder to easily construct the URLS
this tool supports and works with.
    


    The environment variable of APPRISE_URLS (comma/space delimited) can be specified to
provide the default set of URLs you wish to notify if none are otherwise specified.
    


    EXAMPLES
    


    Send a notification to multiple services by chaining their URLs:
    


    $ apprise -vv -t "my title" -b "my notification body" \
   "mailto://myemail:mypass@gmail.com" \
   "pbul://o.gn5kj6nfhv736I7jC3cj3QLRiyhgl98b"

    


    If you don't specify a --body (-b) then stdin is used allowing you to
use the tool as part of your every day administration:
    


    $ cat /proc/cpuinfo | apprise -vv -t "cpu info" \
    "mailto://myemail:mypass@gmail.com"

    


    Load in a configuration file which identifies all of your notification service
URLs and notify them all:
    


    $ apprise -vv -t "my title" -b "my notification body" \
   --config=~/apprise.yml

    


    Load in a configuration file from a remote server that identifies all of your
notification service URLs and only notify the ones tagged as devops.
    


    $ apprise -vv -t "my title" -b "my notification body" \
   --config=https://localhost/my/apprise/config \
   -t devops

    


    Tagging Logic Examples:
    


    Notify any service tagged with "devops" OR "admin" (Union):
    


    $ apprise -vv -t "Union Test" \
   --config=~/apprise.yml \
   -g devops -g admin

    


    Notify only services tagged with BOTH "devops" AND "critical" (Intersection):
    


    $ apprise -vv -t "Intersection Test" \
   --config=~/apprise.yml \
   -g devops,critical

    


    Notify only priority-2 "alerts" services (exclusive priority filter):
    


    $ apprise -vv -t "High Alert" \
   --config=~/apprise.yml \
   -g "2:alerts"

    


    Notify all "alerts" services and retry each up to 3 times on failure:
    


    $ apprise -vv -t "Critical Event" \
   --config=~/apprise.yml \
   -g "alerts:3"

    


    Include an attachment:
    


    $ apprise -vv -t "School Assignment" -b "See attached" \
   --attach=Documents/FinalReport.docx

    


    List all of the notifications loaded:
    


    $ apprise --dry-run --tag=all

    


    List all of the details around the current persistent storage setup:
    


    $ apprise storage list

    


    Look up the storage namespace for a specific notification URL (shows the
UID even when no data has been written yet):
    


    $ apprise storage list "mailtos://user:pass@example.com"

    


    Prune all persistent storage that has not been referenced for at least 10 days or more
    


    $ apprise storage prune --storage-prune-days=10

    


    CUSTOM PLUGIN/NOTIFICATIONS
    

    Apprise can additionally allow you to define your own custom schema://
entries that you can trigger on and call services you've defined.
    


    By default apprise looks in the following local locations for custom plugin
files and loads them:
    


    ~/.apprise/plugins
~/.config/apprise/plugins
/var/lib/apprise/plugins

    


    The environment variable of APPRISE_PLUGIN_PATH can be specified to override
the list identified above with one of your own.  use a semi-colon (;), line-feed (\n),
and/or carriage return (\r) to delimit multiple entries.
    


    Simply create your own python file with the following bare minimum content in
it:
    


    from apprise.decorators import notify

# This example assumes you want your function to trigger on foobar://
# references:
@notify(on="foobar", name="My Custom Notification")
def my_wrapper(body, title, notify_type, *args, **kwargs):

     print("Define your custom code here")

     # Returning True/False will relay your status back through Apprise
     # Returning nothing (None by default) is always interpreted as True
     return True

    


    CONFIGURATION
    


    An Apprise configuration file can be in the format of either TEXT
or YAML where TEXT is the easiest and most ideal solution for most users.
However YAML configuration files grants the user a bit more leverage and access
to some of the internal features of Apprise. Regardless of which format you choose,
both provide the users the ability to leverage tagging which adds a more rich and
powerful notification environment.
    


    Configuration files can be directly referenced via apprise when referencing
the --config= (-c) CLI directive.  You can identify as many as you like on the
command line and all of them will be loaded.  You can also point your configuration to
a cloud location (by referencing http:// or https://. By default apprise looks
in the following local locations for configuration files and loads them:
    


    ~/.apprise.conf
~/.apprise.yaml
~/.config/apprise.conf
~/.config/apprise.yaml

~/.apprise/apprise.conf
~/.apprise/apprise.yaml
~/.config/apprise/apprise.conf
~/.config/apprise/apprise.yaml

/etc/apprise.conf
/etc/apprise.yaml
/etc/apprise/apprise.conf
/etc/apprise/apprise.yaml

    


    The configuration files specified above can also be identified with a .yml
extension or even just entirely removing the .conf extension altogether.
    


    The environment variable of APPRISE_CONFIG_PATH can be specified to override
the list identified above with one of your own.  use a semi-colon (;), line-feed (\n),
and/or carriage return (\r) to delimit multiple entries.
    


    If a default configuration file is referenced in any way by the apprise
tool, you no longer need to provide it a Service URL.  Usage of the apprise
tool simplifies to:
    


    $ apprise -vv -t "my title" -b "my notification body"

    


    If you leveraged tagging, you can define all of Apprise Service URLs in your
configuration that you want and only specifically notify a subset of them:
    


    $ apprise -vv --title "Will Be Late Getting Home" \
    --body "Please go ahead and make dinner without me." \
    --tag=family

    


    TEMPLATE VARIABLES
    


    A YAML configuration can leave a value out of a URL and have it filled in
later.  Write ${NAME} where the value belongs and declare every name you use
in a template: section:
    


    template:
  # A value written here is used when nothing else supplies one
  smtp_host: smtp.example.com
  # No value, so this one must always be supplied
  api_key:

urls:
  - sendgrid://${API_KEY}:noreply@example.com/you@example.com:
      - tag: alerts

    


    Values are looked for in this order, stopping at the first that answers:
    


      
  
    • a value given with --template-var (-tv)
      • 
  
    • the default written in the template: section
      • 
  
    • the environment variable APPRISE_TEMPLATE_<NAME>

      • 

    


    A URL with no value available is not loaded, and apprise exits with a
status of 4 if others were notified, or 1 if none were.  Use
--dry-run to see which values a configuration is still waiting for.
    


    ${NAME} only means something when NAME appears in the template: section.
Anywhere else it is ordinary text and is sent exactly as written, so a password
containing ${...} is never altered.  Names ignore case, and a name may be
used as often as you like. Values may be up to 1,024 characters. Extra supplied
names are accepted and ignored; their names appear only in the local debug log,
never with their values.
    


    The configuration author may place a variable directly in a URL or in a named
YAML setting below it. URL markers can change any field, including the
destination; whole-host markers also accept user@host and user:pass@host.
A named setting changes only its option, so prefer it for values supplied by
less-trusted callers.
    


    A variable may not appear before ://, may not be used for tag:/tags:, and
may not be used as a setting's name. The service and tags are selected before
values are filled in, so neither can be dynamic.
    


    This applies to YAML configuration only; TEXT configuration is passed
through unchanged.
    


    ENVIRONMENT VARIABLES
    

    APPRISE_URLS:
  Specify the default URLs to notify IF none are otherwise specified on the command line
  explicitly.  If the --config (-c) is specified, then this will override any
  reference to this variable. Use white space and/or a comma (,) to delimit multiple entries.
    


    APPRISE_CONFIG_PATH:
  Explicitly specify the config search path to use (overriding the default).
  Use a semi-colon (;), line-feed (\n), and/or carriage return (\r) to delimit multiple entries.
    


    APPRISE_PLUGIN_PATH:
  Explicitly specify the custom plugin search path to use (overriding the default).
  Use a semi-colon (;), line-feed (\n), and/or carriage return (\r) to delimit multiple entries.
    


    APPRISE_STORAGE_PATH:
  Explicitly specify the persistent storage path to use (overriding the default).
    


    APPRISE_TEMPLATE_<NAME>:
  Supply a value for a ${NAME} used by a YAML configuration.  For example
  APPRISE_TEMPLATE_API_KEY fills in ${API_KEY}.  A value supplied with
  --template-var (-tv) and a configuration default both take priority.
  Blank values are ignored.
    


    HTTP_PROXY, HTTPS_PROXY, NO_PROXY:
  Standard proxy variables honored by the underlying requests library (not
  Apprise-specific). Set HTTP_PROXY/HTTPS_PROXY to route outbound
  notifications through a proxy, and NO_PROXY to exempt specific hosts.
  SOCKS proxies (socks5h://...) additionally require the optional
  PySocks package (pip install pysocks) to be installed.
    


    BUGS
    


    If you find any bugs, please make them known at:
https://github.com/caronc/apprise/issues
    


    DONATIONS
    

    If you found Apprise useful at all, please consider sponsoring or donating!
    




    Apprise is Copyright (C) 2026 Chris Caron lead2gold@gmail.com
    

  
      
    
    1. Chris Caron <lead2gold@gmail.com>
      2. 
    
    2. September 2026
      3. 
    
    3. apprise(1)
      4. 
  
    

  
    


caronc-apprise-dfec414/packaging/man/apprise.md000066400000000000000000000420471526720371000216120ustar00rootroot00000000000000apprise(1) -- Push Notifications that work with just about every platform!
==========================================================================

## SYNOPSIS

`apprise` [...] ...
    
`apprise` storage [...] [] [...]
    

## DESCRIPTION

**Apprise** allows you to send a notification to _almost all_ of the most
popular notification services available to us today such as: Discord,
Telegram, Pushbullet, Slack, Twitter, etc.

  * One notification library to rule them all.
  * A common and intuitive notification syntax.
  * Supports the handling of images (to the notification services that will
    accept them).
  * It's incredibly lightweight.
  * Amazing response times because all messages sent asynchronously.

## OPTIONS

The Apprise options are as follows:

  `-b`, `--body=`:
  Specify the message body. If no body is specified then content is read from
  .

  `-t`, `--title=`:
  Specify the message title. This field is completely optional.

  `-c`, `--config=`:
  Specify one or more configuration locations.

  `-a`, `--attach=`:
  Specify one or more file attachment locations.

  `-P`, `--plugin-path=`:
  Specify a path to scan for custom notification plugin support.
  You can create your own notification by simply creating a Python file
  that contains the `@notify("schema")` decorator.

  You can optionally choose to specify more than one **--plugin-path** (**-P**)
  to increase the modules included.

  `-n`, `--notification-type=`:
  Specify the message type (default=info). Possible values are "info",
  "success", "failure", and "warning".

  `-i`, `--input-format=`:
  Specify the input message format (default=text). Possible values are "text",
  "html", and "markdown".

  `-T`, `--theme=`:
  Specify the default theme.

  `-tv`, `--template-var=`:
  Supply a value used by a YAML configuration written with `${NAME}`.
  Specify this option more than once to supply more than one value, but
  name each one only once.
  A value not provided here uses the default in the configuration's
  `template:` section, then `APPRISE_TEMPLATE_`. A URL that still has no value
  available is not loaded.

  `-g`, `--tag=`:
  Specify one or more tags to filter which services to notify:

  * `-g "tagA" -g "tagB"`: Match tagA **OR** tagB (Union).
  * `-g "tagA,tagB"`: Match tagA **AND** tagB (Strict).
  * `-g "all"`: Notify **ALL** services.
  * `(Omitted)`: Notify **untagged** services only.

  Tag values may include an optional priority prefix and/or retry suffix:

  * `-g "2:tagA"`: Match **only** entries for tagA assigned priority 2.
  * `-g "tagA:3"`: Match all tagA entries, retrying each up to 3 times.
  * `-g "2:tagA:3"`: Priority-2 tagA entries only, with up to 3 retries.

  `-Da`, `--disable-async`:
  Send notifications synchronously (one after the other) instead of
  all at once.

  `-L`, `--limit=`:
  Give up on the whole run if it's taking too long, e.g. `-L 10` or
  `-L 2.5`. By default (`0`) there's no limit; see `--service-limit`
  below to cap each service on its own instead. If a service is truly
  stuck, Apprise gives it a few extra seconds to wrap up, then exits
  anyway with status **5**.

  `-SL`, `--service-limit=`:
  Give up on any single service if it's taking too long, e.g. `-SL 10`
  or `-SL 2.5`, or `0` to turn this off entirely. Leave it unset to use
  Apprise's own default of 60 seconds.

  `-R`, `--recursion-depth`:
  The number of recursive import entries that can be loaded from within
  Apprise configuration. By default this is set to 1. If this is set to
  zero, then import statements found in any configuration is ignored.

  `-e`, `--interpret-escapes`
  Enable interpretation of backslash escapes. For example, this would convert
  sequences such as \n and \r to their respected ascii new-line and carriage
  return characters prior to the delivery of the notification.

  `-j`, `--interpret-emojis`
  Enable interpretation of emoji strings. For example, this would convert
  sequences such as :smile: or :grin: to their respected unicode emoji
  character.

  `-S`, `--storage-path=`:
  Specify the path to the persistent storage caching location

  `-SM`, `--storage-mode=`:
  Specify the persistent storage operational mode. Possible values are "auto",
  "flush", and "memory". The default is "auto" if not specified.

  `-SPD`, `--storage-prune-days=`:
  Define the number of days the storage prune should run using.
  Setting this to zero (0) will eliminate all accumulated content. By
  default this value is 30 (days).

  `-SUL`, `--storage-uid-length=`:
  Define the number of unique characters to store persistent cache in.
  By default this value is 8 (characters).

  `-d`, `--dry-run`:
  Perform a trial run but only prints the notification services to-be
  triggered to **stdout**. Notifications are never sent using this mode.

  `-l`, `--details`
  Prints details about the current services supported by Apprise.

  `-v`, `--verbose`:
  The more of these you specify, the more verbose the output is. e.g: -vvvv

  `-D`, `--debug`:
  A debug mode; useful for troubleshooting.

  `-V`, `--version`:
  Display the apprise version and exit.

  `-h`, `--help`:
  Show this message and exit.

## PERSISTENT STORAGE

Persistent storage by default writes to the following location unless the environment variable `APPRISE_STORAGE_PATH` overrides it and/or `--storage-path` (`-SP`) is specified to override it:

    ~/.local/share/apprise/cache

To utilize the [persistent storage][pstorage] element associated with Apprise, simply
specify the keyword **storage**

    $ apprise storage

The **storage** action has the following sub actions:

  `list`:
  List all of the detected persistent storage elements and their state
  (**stale**, **active**, or **unused**).  This is the default action if
  nothing further is identified.  Results may be filtered by passing one
  or more 8-character UID prefix strings, or by passing full Apprise
  service URLs — each URL is resolved to its storage namespace
  automatically, making it easy to look up a specific plugin's cache
  entry without knowing the hash in advance.

  `prune`:
  Removes all persistent storage that has not been referenced for more than 30
  days. You can optionally set the `--storage-prune-days` to alter this
  default value.

  `clean`:
  Removes all persistent storage regardless of age.

## EXIT STATUS

**apprise** exits with a status of:

* **0** if all of the notifications were sent successfully.
* **1** if every notification failed, or the notification could not start.
* **2** if there was an error specified on the command line such as not
  providing a valid argument.
* **3** if one or more Apprise Service URLs were successfully loaded but
  none could be notified due to user filtering (via tags).
* **4** if at least one notification was sent successfully and at least
  one other was not (whether it failed outright or ran out of time).
* **5** if no notification was sent, and the only problem was that one or
  more services ran out of time.

## SERVICE URLS

There are too many service URL and combinations to list here. It's best to
visit the [Apprise GitHub page][serviceurls] and see what's available.
Also try out the [Apprise URL Builder][buildurls] to easily construct the URLS
this tool supports and works with.

[serviceurls]: https://appriseit.com/services/
[buildurls]: https://appriseit.com/tools/url-builder/

The **environment variable** of `APPRISE_URLS` (comma/space delimited) can be specified to
provide the default set of URLs you wish to notify if none are otherwise specified.

## EXAMPLES

Send a notification to multiple services by chaining their URLs:

    $ apprise -vv -t "my title" -b "my notification body" \
       "mailto://myemail:mypass@gmail.com" \
       "pbul://o.gn5kj6nfhv736I7jC3cj3QLRiyhgl98b"

If you don't specify a **--body** (**-b**) then stdin is used allowing you to
use the tool as part of your every day administration:

    $ cat /proc/cpuinfo | apprise -vv -t "cpu info" \
        "mailto://myemail:mypass@gmail.com"

Load in a configuration file which identifies all of your notification service
URLs and notify them all:

    $ apprise -vv -t "my title" -b "my notification body" \
       --config=~/apprise.yml

Load in a configuration file from a remote server that identifies all of your
notification service URLs and only notify the ones tagged as _devops_.

    $ apprise -vv -t "my title" -b "my notification body" \
       --config=https://localhost/my/apprise/config \
       -t devops

**Tagging Logic Examples:**

Notify any service tagged with "devops" OR "admin" (Union):

    $ apprise -vv -t "Union Test" \
       --config=~/apprise.yml \
       -g devops -g admin

Notify only services tagged with BOTH "devops" AND "critical" (Intersection):

    $ apprise -vv -t "Intersection Test" \
       --config=~/apprise.yml \
       -g devops,critical

Notify only priority-2 "alerts" services (exclusive priority filter):

    $ apprise -vv -t "High Alert" \
       --config=~/apprise.yml \
       -g "2:alerts"

Notify all "alerts" services and retry each up to 3 times on failure:

    $ apprise -vv -t "Critical Event" \
       --config=~/apprise.yml \
       -g "alerts:3"

Include an attachment:

    $ apprise -vv -t "School Assignment" -b "See attached" \
       --attach=Documents/FinalReport.docx

List all of the notifications loaded:

    $ apprise --dry-run --tag=all

List all of the details around the current persistent storage setup:

    $ apprise storage list

Look up the storage namespace for a specific notification URL (shows the
UID even when no data has been written yet):

    $ apprise storage list "mailtos://user:pass@example.com"

Prune all persistent storage that has not been referenced for at least 10 days or more

    $ apprise storage prune --storage-prune-days=10

## CUSTOM PLUGIN/NOTIFICATIONS
Apprise can additionally allow you to define your own custom **schema://**
entries that you can trigger on and call services you've defined.

By default **apprise** looks in the following local locations for custom plugin
files and loads them:

    ~/.apprise/plugins
    ~/.config/apprise/plugins
    /var/lib/apprise/plugins

The **environment variable** of `APPRISE_PLUGIN_PATH` can be specified to override
the list identified above with one of your own.  use a semi-colon (`;`), line-feed (`\n`),
and/or carriage return (`\r`) to delimit multiple entries.

Simply create your own python file with the following bare minimum content in
it:

    from apprise.decorators import notify

    # This example assumes you want your function to trigger on foobar://
    # references:
    @notify(on="foobar", name="My Custom Notification")
    def my_wrapper(body, title, notify_type, *args, **kwargs):

         print("Define your custom code here")

         # Returning True/False will relay your status back through Apprise
         # Returning nothing (None by default) is always interpreted as True
         return True

## CONFIGURATION

An [Apprise configuration file][config] can be in the format of either **TEXT**
or **YAML** where TEXT is the easiest and most ideal solution for most users.
However YAML configuration files grants the user a bit more leverage and access
to some of the internal features of Apprise. Regardless of which format you choose,
both provide the users the ability to leverage **tagging** which adds a more rich and
powerful notification environment.

Configuration files can be directly referenced via **apprise** when referencing
the `--config=` (`-c`) CLI directive.  You can identify as many as you like on the
command line and all of them will be loaded.  You can also point your configuration to
a cloud location (by referencing `http://` or `https://`. By default **apprise** looks
in the following local locations for configuration files and loads them:

    ~/.apprise.conf
    ~/.apprise.yaml
    ~/.config/apprise.conf
    ~/.config/apprise.yaml

    ~/.apprise/apprise.conf
    ~/.apprise/apprise.yaml
    ~/.config/apprise/apprise.conf
    ~/.config/apprise/apprise.yaml

    /etc/apprise.conf
    /etc/apprise.yaml
    /etc/apprise/apprise.conf
    /etc/apprise/apprise.yaml

The **configuration files** specified above can also be identified with a `.yml`
extension or even just entirely removing the `.conf` extension altogether.

The **environment variable** of `APPRISE_CONFIG_PATH` can be specified to override
the list identified above with one of your own.  use a semi-colon (`;`), line-feed (`\n`),
and/or carriage return (`\r`) to delimit multiple entries.

If a default configuration file is referenced in any way by the **apprise**
tool, you no longer need to provide it a Service URL.  Usage of the **apprise**
tool simplifies to:

    $ apprise -vv -t "my title" -b "my notification body"

If you leveraged [tagging][tagging], you can define all of Apprise Service URLs in your
configuration that you want and only specifically notify a subset of them:

    $ apprise -vv --title "Will Be Late Getting Home" \
        --body "Please go ahead and make dinner without me." \
        --tag=family

### TEMPLATE VARIABLES

A **YAML** configuration can leave a value out of a URL and have it filled in
later.  Write `${NAME}` where the value belongs and declare every name you use
in a `template:` section:

    template:
      # A value written here is used when nothing else supplies one
      smtp_host: smtp.example.com
      # No value, so this one must always be supplied
      api_key:

    urls:
      - sendgrid://${API_KEY}:noreply@example.com/you@example.com:
          - tag: alerts

Values are looked for in this order, stopping at the first that answers:

* a value given with `--template-var` (`-tv`)
* the default written in the `template:` section
* the environment variable `APPRISE_TEMPLATE_`

A URL with no value available is not loaded, and **apprise** exits with a
status of **4** if others were notified, or **1** if none were.  Use
`--dry-run` to see which values a configuration is still waiting for.

`${NAME}` only means something when `NAME` appears in the `template:` section.
Anywhere else it is ordinary text and is sent exactly as written, so a password
containing `${...}` is never altered.  Names ignore case, and a name may be
used as often as you like. Values may be up to 1,024 characters. Extra supplied
names are accepted and ignored; their names appear only in the local debug log,
never with their values.

The configuration author may place a variable directly in a URL or in a named
YAML setting below it. URL markers can change any field, including the
destination; whole-host markers also accept `user@host` and `user:pass@host`.
A named setting changes only its option, so prefer it for values supplied by
less-trusted callers.

A variable may not appear before `://`, may not be used for `tag:`/`tags:`, and
may not be used as a setting's name. The service and tags are selected before
values are filled in, so neither can be dynamic.

This applies to **YAML** configuration only; **TEXT** configuration is passed
through unchanged.

[config]: https://appriseit.com/getting-started/configuration/
[tagging]: https://appriseit.com/cli/usage/#tagging-and-filtering
[pstorage]: https://appriseit.com/cli/persistent-storage/

## ENVIRONMENT VARIABLES
  `APPRISE_URLS`:
  Specify the default URLs to notify IF none are otherwise specified on the command line
  explicitly.  If the `--config` (`-c`) is specified, then this will override any
  reference to this variable. Use white space and/or a comma (`,`) to delimit multiple entries.

  `APPRISE_CONFIG_PATH`:
  Explicitly specify the config search path to use (overriding the default).
  Use a semi-colon (`;`), line-feed (`\n`), and/or carriage return (`\r`) to delimit multiple entries.

  `APPRISE_PLUGIN_PATH`:
  Explicitly specify the custom plugin search path to use (overriding the default).
  Use a semi-colon (`;`), line-feed (`\n`), and/or carriage return (`\r`) to delimit multiple entries.

  `APPRISE_STORAGE_PATH`:
  Explicitly specify the persistent storage path to use (overriding the default).

  `APPRISE_TEMPLATE_`:
  Supply a value for a `${NAME}` used by a YAML configuration.  For example
  `APPRISE_TEMPLATE_API_KEY` fills in `${API_KEY}`.  A value supplied with
  `--template-var` (`-tv`) and a configuration default both take priority.
  Blank values are ignored.

  `HTTP_PROXY`, `HTTPS_PROXY`, `NO_PROXY`:
  Standard proxy variables honored by the underlying `requests` library (not
  Apprise-specific). Set `HTTP_PROXY`/`HTTPS_PROXY` to route outbound
  notifications through a proxy, and `NO_PROXY` to exempt specific hosts.
  SOCKS proxies (`socks5h://...`) additionally require the optional
  `PySocks` package (`pip install pysocks`) to be installed.

## BUGS

If you find any bugs, please make them known at:


## DONATIONS
If you found Apprise useful at all, [please consider sponsoring][sponsorship] or [donating][donating]!

[sponsorship]: https://github.com/sponsors/caronc
[donating]: https://www.paypal.com/donate/?hosted_button_id=CR6YF7KLQWQ5E

## COPYRIGHT

Apprise is Copyright (C) 2026 Chris Caron 
caronc-apprise-dfec414/packaging/redhat/000077500000000000000000000000001526720371000203125ustar00rootroot00000000000000caronc-apprise-dfec414/packaging/redhat/python-apprise.rpmlintrc.el10000066400000000000000000000002221526720371000257640ustar00rootroot00000000000000from Config import *

# Ignore false-positive spelling errors on brand names
addFilter('spelling-error.*ntfy')
addFilter('spelling-error.*ilert')
caronc-apprise-dfec414/packaging/redhat/python-apprise.rpmlintrc.el9000066400000000000000000000005311526720371000257170ustar00rootroot00000000000000from Config import *

# Ignore false-positive spelling errors on brand names
addFilter('spelling-error.*ntfy')
addFilter('spelling-error.*ilert')
addFilter('spelling-error.*Cliq')
addFilter('spelling-error.*Zoho')
addFilter('spelling-error.*httpSMS')
addFilter('invalid-license BSD-2-Clause')
addFilter('obsolete-not-provided python.*-apprise')
caronc-apprise-dfec414/packaging/redhat/python-apprise.spec000066400000000000000000000522151526720371000241550ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
###################################################################
%if 0%{?_module_build}
%bcond_with tests
%else
# When bootstrapping Python, we cannot test this yet
%bcond_without tests
%endif

# Handling of new python building structure (for backwards compatiblity)
%global legacy_python_build 0
%if 0%{?fedora} && 0%{?fedora} <= 29
%global legacy_python_build 1
%endif
%if 0%{?rhel} && 0%{?rhel} <= 9
%global legacy_python_build 1
%endif

%global pypi_name apprise

# Use up to 8 test workers; builders can lower this with _smp_ncpus_max
%global pytest_workers %{lua: print(math.min(8, tonumber(rpm.expand("%{_smp_build_ncpus}")) or 1))}

# Handle rpmlint false positives
# - Prevent warnings:
#    en_US ntfy -> notify
#    en_US httpSMS -> HTTP
#
# rpmlint: ignore-spelling httpSMS ntfy

# - RHEL9 does not recognize: BSD-2-Clause which is correct
#
# rpmlint: ignore invalid-license

%global common_description %{expand: \
Apprise is a Python package that simplifies access to many popular \
notification services. It supports sending alerts to platforms such as: \
\
`46elks`, `800.com`, `AfricasTalking`, `AMQP`, \
`Apprise API`, `APRS`, \
`AWS SES`, `AWS SNS`, `Bark`, `Better Stack`, `Blink(1)`, `BlueSky`, \
`Brevo`, `Burst SMS`, `BulkSMS`, `BulkVS`, \
`Chanify`, `Clickatell`, `ClickSend`, `DAPNET`, `Delta Chat`, \
`DingTalk`, `Discord`, \
`Dot. (Quote/0)`, `E-Mail`, `Emby`, `Evolution API`, `Exotel`, \
`FCM`, `Feishu`, `Flock`, `Flowtriq`, `Fluxer`, `Free Mobile`, `GitHub`, \
`GoAlert`, `Google Chat`, `Gorush`, `Gotify`, `GroupMe`, `Growl`, \
`Guilded`, `Home Assistant`, `httpSMS`, \
`HumHub`, `IFTTT`, `ilert`, `incident.io`, \
`IRC`, `Jellyfin`, `Jira`, `Join`, `Kavenegar`, `KODI`, `Kook`, \
`Kumulos`, `LaMetric`, `Lark`, `Lauther`, `LFG Alarm`, `Line`, \
`MacOSX`, `Mailgun`, \
`MailerSend`, \
`Mastodon`, \
`Mattermost`, `Matrix`, `MessageBird`, `Microsoft Windows`, \
`Microsoft Teams`, `Misskey`, `Mobile Message`, \
`MQTT`, `MSG91`, `MyAndroid`, `Nexmo`, `Nextcloud`, \
`NextcloudTalk`, `Notica`, `Notifiarr`, `Notifico`, \
`Notifyre`, \
`ntfy`, `Octopush`, `Office365`, `OneBot`, `OneSignal`, \
`Opsgenie`, `PagerDuty`, \
`PagerTree`, `ParsePlatform`, `Pinglet`, `Pingram`, `Plivo`, `Prowl`, \
`Postmark`, `Pushalot`, `PushBullet`, \
`Pushjet`, `PushMe`, `Pushover`, `Pushplus`, `PushSafer`, `PushWard`, \
`Pushy`, `PushDeer`, \
`QQ Push`, `Revolt`, `Reddit`, `Resend`, `RingCentral`, `Rocket.Chat`, \
`RSyslog`, `SendGrid`, \
`SendPulse`, `ServerChan`, `SerwerSMS`, `Session Open Group Server`, \
`Seven`, `SFR`, \
`Signal`, `Signalgrid`, `SIGNL4`, `Simplepush`, \
`Sinch`, `Slack`, `SMPP`, `SMSC`, `SMSEagle`, `SMS Manager`, `SMTP2Go`, \
`SparkPost`, `Splunk`, `Spike`, `Spug Push`, `Squadcast`, \
`Stackfield`, `Super Toasty`, \
`Streamlabs`, `Stride`, \
`Synology Chat`, `Syslog`, `Techulus Push`, `Telegram`, `Telnyx`, \
`Threema Gateway`, `Trigv`, `Twilio`, `Twitter`, `Twist`, `Vapid`, \
`Viber`, `VictorOps`, \
`Voipms`, `Vonage`, `WebPush`, `WeChat (WeCom)`, `WeCom Bot`, `WhatsApp`, \
`Webex Teams`, `Workflows`, `WPUSH`, `WxPusher`, `XBMC`, `XMPP`, `YouLMK`, \
`Zalo`, `Zoho Cliq`, `Zoom`, and `Zulip`.}

Name:           python-%{pypi_name}
Version:        2.1.0
Release:        1%{?dist}
Summary:        A simple wrapper to many popular notification services used today
License:        BSD-2-Clause
URL:            https://github.com/caronc/%{pypi_name}
Source0:        %{url}/archive/v%{version}/%{pypi_name}-%{version}.tar.gz
BuildArch:      noarch

%description %{common_description}

%package -n %{pypi_name}
Summary: Notify messaging platforms from the command line

Obsoletes: %{pypi_name} < %{version}-%{release}
Provides: %{pypi_name} = %{version}-%{release}

Requires: python3dist(click) >= 5.0
Requires: python%{python3_pkgversion}-%{pypi_name} = %{version}-%{release}

%description -n %{pypi_name}
An accompanied CLI tool that can be used as part of Apprise
to issue notifications from the command line to you favorite
services.

%package -n python%{python3_pkgversion}-%{pypi_name}
Summary: A simple wrapper to many popular notification services used today

Obsoletes: python%{python3_pkgversion}-%{pypi_name} < %{version}-%{release}
%{?python_provide:%python_provide python%{python3_pkgversion}-%{pypi_name}}

BuildRequires: gettext
BuildRequires: python%{python3_pkgversion}-devel

%if %{legacy_python_build}
BuildRequires: python3dist(setuptools)
%else
BuildRequires: python3dist(setuptools) >= 69
%endif

BuildRequires: python3dist(wheel)
BuildRequires: python3dist(requests)
BuildRequires: python3dist(urllib3)
BuildRequires: python3dist(requests-oauthlib)
BuildRequires: python3dist(click) >= 5.0
BuildRequires: python3dist(markdown)
BuildRequires: python3dist(pyyaml)
BuildRequires: python3dist(babel)
BuildRequires: python3dist(cryptography)
BuildRequires: python3dist(certifi)
BuildRequires: python3dist(tox)

%if %{with tests}
BuildRequires: python3dist(pytest)
BuildRequires: python3dist(pytest-mock)
BuildRequires: python3dist(pytest-xdist)
%endif

Requires: python3dist(requests)
Requires: python3dist(urllib3)
Requires: python3dist(requests-oauthlib)
Requires: python3dist(markdown)
Requires: python3dist(cryptography)
Requires: python3dist(certifi)
Requires: python3dist(pyyaml)

Recommends: python3dist(hidapi)
Recommends: python3dist(pika)
Recommends: python3dist(python-qpid-proton)
Recommends: python3dist(pynacl)
Recommends: python3dist(paho-mqtt) >= 2.1.0
Recommends: python3dist(slixmpp)

%if 0%{?legacy_python_build} == 0
# Logic for non-RHEL ≤ 9 systems
%generate_buildrequires
%pyproject_buildrequires
%endif

%description -n python%{python3_pkgversion}-%{pypi_name} %{common_description}

%prep
%autosetup -n %{pypi_name}-%{version}

%build
%if %{legacy_python_build}
# backwards compatible
%py3_build
%else
%pyproject_wheel
%endif

%install
%if %{legacy_python_build}
# backwards compatible
%py3_install
# Compile gettext catalogues from SOURCE into the INSTALLED tree
pushd %{_builddir}/%{pypi_name}-%{version}
for po in apprise/i18n/*/LC_MESSAGES/apprise.po; do
    [ -f "$po" ] || continue
    langdir="$(dirname "${po#apprise/i18n/}")"
    outdir="%{buildroot}%{python3_sitelib}/%{pypi_name}/i18n/${langdir}"
    install -d "$outdir"
    msguniq --use-first -o "$po" "$po"
    msgfmt -o "${outdir}/apprise.mo" "$po"
done
%else
%pyproject_install
%pyproject_save_files apprise

# Compile gettext catalogues into the installed tree
pushd %{buildroot}%{python3_sitelib}/apprise/i18n
for po in */LC_MESSAGES/apprise.po; do
    [ -f "$po" ] || continue
    msguniq --use-first -o "$po" "$po"
    msgfmt -o "${po%.po}.mo" "$po"
done
%endif

popd

%{__install} -p -D -T -m 0644 packaging/man/%{pypi_name}.1 \
   %{buildroot}%{_mandir}/man1/%{pypi_name}.1

%if %{with tests}
%check
%if %{legacy_python_build}
# backwards compatible
LANG=C.UTF-8 PYTHONPATH=%{buildroot}%{python3_sitelib}:%{_builddir}/%{name}-%{version} py.test-%{python3_version} -n %{pytest_workers}
%else
%pytest -n %{pytest_workers}
%endif
%endif

%files -n python%{python3_pkgversion}-%{pypi_name}
%license LICENSE
%doc SECURITY.md README.md ACKNOWLEDGEMENTS.md CONTRIBUTING.md
%{python3_sitelib}/%{pypi_name}/
# Exclude i18n as it is handled below with the lang(spoken) tag below
%exclude %{python3_sitelib}/%{pypi_name}/cli.*
%exclude %{python3_sitelib}/%{pypi_name}/__pycache__/cli*.py?

%if %{legacy_python_build}
# Handle egg-info vs. dist-info based on build backend
%{python3_sitelib}/apprise-*.egg-info
# Legacy: include all compiled locales that we produced under the package tree
%lang(ar) %{python3_sitelib}/%{pypi_name}/i18n/ar/LC_MESSAGES/apprise.mo
%lang(de) %{python3_sitelib}/%{pypi_name}/i18n/de/LC_MESSAGES/apprise.mo
%lang(en) %{python3_sitelib}/%{pypi_name}/i18n/en/LC_MESSAGES/apprise.mo
%lang(es) %{python3_sitelib}/%{pypi_name}/i18n/es/LC_MESSAGES/apprise.mo
%lang(fr) %{python3_sitelib}/%{pypi_name}/i18n/fr/LC_MESSAGES/apprise.mo
%lang(hi) %{python3_sitelib}/%{pypi_name}/i18n/hi/LC_MESSAGES/apprise.mo
%lang(id) %{python3_sitelib}/%{pypi_name}/i18n/id/LC_MESSAGES/apprise.mo
%lang(it) %{python3_sitelib}/%{pypi_name}/i18n/it/LC_MESSAGES/apprise.mo
%lang(ja) %{python3_sitelib}/%{pypi_name}/i18n/ja/LC_MESSAGES/apprise.mo
%lang(ko) %{python3_sitelib}/%{pypi_name}/i18n/ko/LC_MESSAGES/apprise.mo
%lang(ms) %{python3_sitelib}/%{pypi_name}/i18n/ms/LC_MESSAGES/apprise.mo
%lang(nl) %{python3_sitelib}/%{pypi_name}/i18n/nl/LC_MESSAGES/apprise.mo
%lang(pl) %{python3_sitelib}/%{pypi_name}/i18n/pl/LC_MESSAGES/apprise.mo
%lang(pt) %{python3_sitelib}/%{pypi_name}/i18n/pt/LC_MESSAGES/apprise.mo
%lang(ru) %{python3_sitelib}/%{pypi_name}/i18n/ru/LC_MESSAGES/apprise.mo
%lang(th) %{python3_sitelib}/%{pypi_name}/i18n/th/LC_MESSAGES/apprise.mo
%lang(tl) %{python3_sitelib}/%{pypi_name}/i18n/tl/LC_MESSAGES/apprise.mo
%lang(tr) %{python3_sitelib}/%{pypi_name}/i18n/tr/LC_MESSAGES/apprise.mo
%lang(vi) %{python3_sitelib}/%{pypi_name}/i18n/vi/LC_MESSAGES/apprise.mo
%lang(zh) %{python3_sitelib}/%{pypi_name}/i18n/zh/LC_MESSAGES/apprise.mo
%else
# Handle egg-info vs. dist-info based on build backend
%{python3_sitelib}/apprise-*.dist-info/
# Localised Files
%exclude %{python3_sitelib}/%{pypi_name}/i18n/
%lang(ar) %{python3_sitelib}/%{pypi_name}/i18n/ar/LC_MESSAGES/apprise.mo
%lang(de) %{python3_sitelib}/%{pypi_name}/i18n/de/LC_MESSAGES/apprise.mo
%lang(en) %{python3_sitelib}/%{pypi_name}/i18n/en/LC_MESSAGES/apprise.mo
%lang(es) %{python3_sitelib}/%{pypi_name}/i18n/es/LC_MESSAGES/apprise.mo
%lang(fr) %{python3_sitelib}/%{pypi_name}/i18n/fr/LC_MESSAGES/apprise.mo
%lang(hi) %{python3_sitelib}/%{pypi_name}/i18n/hi/LC_MESSAGES/apprise.mo
%lang(id) %{python3_sitelib}/%{pypi_name}/i18n/id/LC_MESSAGES/apprise.mo
%lang(it) %{python3_sitelib}/%{pypi_name}/i18n/it/LC_MESSAGES/apprise.mo
%lang(ja) %{python3_sitelib}/%{pypi_name}/i18n/ja/LC_MESSAGES/apprise.mo
%lang(ko) %{python3_sitelib}/%{pypi_name}/i18n/ko/LC_MESSAGES/apprise.mo
%lang(ms) %{python3_sitelib}/%{pypi_name}/i18n/ms/LC_MESSAGES/apprise.mo
%lang(nl) %{python3_sitelib}/%{pypi_name}/i18n/nl/LC_MESSAGES/apprise.mo
%lang(pl) %{python3_sitelib}/%{pypi_name}/i18n/pl/LC_MESSAGES/apprise.mo
%lang(pt) %{python3_sitelib}/%{pypi_name}/i18n/pt/LC_MESSAGES/apprise.mo
%lang(ru) %{python3_sitelib}/%{pypi_name}/i18n/ru/LC_MESSAGES/apprise.mo
%lang(th) %{python3_sitelib}/%{pypi_name}/i18n/th/LC_MESSAGES/apprise.mo
%lang(tl) %{python3_sitelib}/%{pypi_name}/i18n/tl/LC_MESSAGES/apprise.mo
%lang(tr) %{python3_sitelib}/%{pypi_name}/i18n/tr/LC_MESSAGES/apprise.mo
%lang(vi) %{python3_sitelib}/%{pypi_name}/i18n/vi/LC_MESSAGES/apprise.mo
%lang(zh) %{python3_sitelib}/%{pypi_name}/i18n/zh/LC_MESSAGES/apprise.mo
%endif

%files -n %{pypi_name}
%{_bindir}/%{pypi_name}
%{_mandir}/man1/%{pypi_name}.1*
%{python3_sitelib}/%{pypi_name}/cli.py
%{python3_sitelib}/%{pypi_name}/__pycache__/cli*.py?

%changelog
* Sat Oct 24 2026 Chris Caron  - 2.1.0-1
- Updated to v2.1.0

* Sat Oct  3 2026 Chris Caron  - 2.0.1-1
- Updated to v2.0.1

* Sat Sep 26 2026 Chris Caron  - 2.0.0-1
- Updated to major release of v2.0.0

* Sun Aug 30 2026 Chris Caron  - 1.13.1-1
- Updated to v1.13.1

* Thu Aug 20 2026 Chris Caron  - 1.13.0-1
- Updated to v1.13.0

* Thu Jul 16 2026 Fedora Release Engineering  - 1.12.0-2
- Rebuilt for https://fedoraproject.org/wiki/Fedora_45_Mass_Rebuild

* Sat Jul  4 2026 Chris Caron  - 1.12.0-1
- Updated to v1.12.0

* Thu Jun 04 2026 Python Maint  - 1.11.0-2
- Rebuilt for Python 3.15

* Fri May 29 2026 Chris Caron  - 1.11.0-1
- Updated to v1.11.0

* Sun Apr 26 2026 Chris Caron  - 1.10.0-1
- Updated to v1.10.0

* Sat Mar 21 2026 Chris Caron  - 1.9.9-1
- Updated to v1.9.9

* Sun Mar  8 2026 Chris Caron  - 1.9.8-1
- Updated to v1.9.8

* Tue Jan 20 2026 Chris Caron  - 1.9.7-1
- Updated to v1.9.7

* Sun Jan 18 2026 Benjamin A. Beasley  - 1.9.6-3
- Remove unnecessary pytest-runner, pytest-cov dependencies

* Sat Jan 17 2026 Fedora Release Engineering  - 1.9.6-2
- Rebuilt for https://fedoraproject.org/wiki/Fedora_44_Mass_Rebuild

* Sun Dec  7 2025 Chris Caron  - 1.9.6-1
- Updated to v1.9.6

* Tue Sep 30 2025 Chris Caron  - 1.9.5-1
- Updated to v1.9.5

* Fri Sep 19 2025 Python Maint  - 1.9.4-4
- Rebuilt for Python 3.14.0rc3 bytecode

* Sat Aug 16 2025 Chris Caron  - 1.9.4-3
- Spec file modernization BZ2377453
- Translation files patch added to allow v1.9.4 to build corectly

* Fri Aug 15 2025 Python Maint  - 1.9.4-2
- Rebuilt for Python 3.14.0rc2 bytecode

* Sat Aug  2 2025 Chris Caron  - 1.9.4
- Updated to v1.9.4

* Sun Mar 30 2025 Chris Caron  - 1.9.3
- Updated to v1.9.3

* Sat Jan 18 2025 Fedora Release Engineering  - 1.9.1-2
- Rebuilt for https://fedoraproject.org/wiki/Fedora_42_Mass_Rebuild

* Wed Jan  8 2025 Chris Caron  - 1.9.2
- Updated to v1.9.2

* Tue Dec 17 2024 Chris Caron  - 1.9.1
- Updated to v1.9.1

* Mon Sep  2 2024 Chris Caron  - 1.9.0
- Updated to v1.9.0

* Thu Jul 25 2024 Chris Caron  - 1.8.1
- Updated to v1.8.1

* Fri Jul 19 2024 Fedora Release Engineering  - 1.8.0-3
- Rebuilt for https://fedoraproject.org/wiki/Fedora_41_Mass_Rebuild

* Fri Jun 07 2024 Python Maint  - 1.8.0-2
- Rebuilt for Python 3.13

* Sat May 11 2024 Chris Caron  - 1.8.0
- Updated to v1.8.0

* Sat Apr 13 2024 Chris Caron  - 1.7.6
- Updated to v1.7.6

* Sat Mar 30 2024 Chris Caron  - 1.7.5
- Updated to v1.7.5

* Sat Mar  9 2024 Chris Caron  - 1.7.4
- Updated to v1.7.4

* Sun Mar  3 2024 Chris Caron  - 1.7.3
- Updated to v1.7.3

* Sat Jan 27 2024 Chris Caron  - 1.7.2
- Updated to v1.7.2

* Fri Jan 26 2024 Fedora Release Engineering  - 1.6.0-3
- Rebuilt for https://fedoraproject.org/wiki/Fedora_40_Mass_Rebuild

* Sun Jan 21 2024 Fedora Release Engineering  - 1.6.0-2
- Rebuilt for https://fedoraproject.org/wiki/Fedora_40_Mass_Rebuild

* Sun Oct 15 2023 Chris Caron  - 1.6.0
- Updated to v1.6.0

* Sun Aug 27 2023 Chris Caron  - 1.5.0
- Updated to v1.5.0
- apprise-fedora-rpm-testcase-handling.patch added for test handling

* Fri Jul 21 2023 Fedora Release Engineering  - 1.4.5-2
- Rebuilt for https://fedoraproject.org/wiki/Fedora_39_Mass_Rebuild

* Thu Jul  6 2023 Chris Caron  - 1.4.5
- Updated to v1.4.5

* Wed Jun 14 2023 Python Maint  - 1.4.0-2
- Rebuilt for Python 3.12

* Mon May 15 2023 Chris Caron  - 1.4.0
- Updated to v1.4.0

* Wed Feb 22 2023 Chris Caron  - 1.3.0
- Updated to v1.3.0

* Fri Jan 20 2023 Fedora Release Engineering  - 1.2.1-2
- Rebuilt for https://fedoraproject.org/wiki/Fedora_38_Mass_Rebuild

* Wed Dec 28 2022 Chris Caron  - 1.2.1-1
- Updated to v1.2.1

* Tue Nov 15 2022 Chris Caron  - 1.2.0-1
- Updated to v1.2.0

* Sat Oct  8 2022 Chris Caron  - 1.1.0-1
- Updated to v1.1.0

* Fri Oct  7 2022 Chris Caron  - 1.0.0-3
- Python 2 Support dropped

* Wed Aug 31 2022 Chris Caron  - 1.0.0-2
- Rebuilt for RHEL9 Support

* Sat Aug  6 2022 Chris Caron  - 1.0.0-1
- Updated to v1.0.0

* Fri Jul 22 2022 Fedora Release Engineering  - 0.9.9-3
- Rebuilt for https://fedoraproject.org/wiki/Fedora_37_Mass_Rebuild

* Wed Jun 15 2022 Python Maint  - 0.9.9-2
- Rebuilt for Python 3.11

* Thu Jun  2 2022 Chris Caron  - 0.9.9-1
- Updated to v0.9.9

* Thu Apr 28 2022 Chris Caron  - 0.9.8.3-1
- Updated to v0.9.8.3

* Sat Apr 23 2022 Chris Caron  - 0.9.8.2-1
- Updated to v0.9.8.2

* Tue Apr 19 2022 Chris Caron  - 0.9.8.1-1
- Updated to v0.9.8.1

* Mon Apr 18 2022 Chris Caron  - 0.9.8-1
- Updated to v0.9.8

* Wed Feb  2 2022 Chris Caron  - 0.9.7-1
- Updated to v0.9.7

* Wed Dec  1 2021 Chris Caron  - 0.9.6-1
- Updated to v0.9.6

* Sat Sep 18 2021 Chris Caron  - 0.9.5.1-2
- Updated to v0.9.5.1

* Sat Sep 18 2021 Chris Caron  - 0.9.5-1
- Updated to v0.9.5

* Wed Aug 11 2021 Chris Caron  - 0.9.4-1
- Updated to v0.9.4

* Fri Jul 23 2021 Fedora Release Engineering  - 0.9.3-3
- Rebuilt for https://fedoraproject.org/wiki/Fedora_35_Mass_Rebuild

* Fri Jun 04 2021 Python Maint  - 0.9.3-2
- Rebuilt for Python 3.10

* Sun May 16 2021 Chris Caron  - 0.9.3-1
- Updated to v0.9.3

* Sun May  2 2021 Chris Caron  - 0.9.2-1
- Updated to v0.9.2

* Tue Feb 23 2021 Chris Caron  - 0.9.1-2
- Added missing cryptography dependency

* Tue Feb 23 2021 Chris Caron  - 0.9.1-1
- Updated to v0.9.1

-* Wed Jan 27 2021 Fedora Release Engineering  - 0.9.0-3
-- Rebuilt for https://fedoraproject.org/wiki/Fedora_34_Mass_Rebuild

* Thu Jan 14 2021 Chris Caron  - 0.9.0-2
- Fixed unit tests

* Wed Dec 30 2020 Chris Caron  - 0.9.0-1
- Updated to v0.9.0

* Sun Oct  4 2020 Chris Caron  - 0.8.9-1
- Updated to v0.8.9

* Wed Sep  2 2020 Chris Caron  - 0.8.8-1
- Updated to v0.8.8

* Thu Aug 13 2020 Chris Caron  - 0.8.7-1
- Updated to v0.8.7

* Mon Aug 03 2020 Chris Caron  - 0.8.6-4
- Updated SPEC so Fedora 33 Mass Rebuild would pass

* Sat Aug 01 2020 Fedora Release Engineering  - 0.8.6-3
- Second attempt - Rebuilt for
  https://fedoraproject.org/wiki/Fedora_33_Mass_Rebuild

* Tue Jul 28 2020 Fedora Release Engineering  - 0.8.6-2
- Rebuilt for https://fedoraproject.org/wiki/Fedora_33_Mass_Rebuild

* Sat Jun 13 2020 Chris Caron  - 0.8.6-1
- Updated to v0.8.6

* Tue May 26 2020 Miro Hrončok  - 0.8.5-2
- Rebuilt for Python 3.9

* Mon Mar 30 2020 Chris Caron  - 0.8.5-1
- Updated to v0.8.5

* Sat Feb  1 2020 Chris Caron  - 0.8.4-1
- Updated to v0.8.4

* Sun Jan 12 2020 Chris Caron  - 0.8.3-1
- Updated to v0.8.3

* Mon Nov 25 2019 Chris Caron  - 0.8.2-1
- Updated to v0.8.2

* Sun Oct 13 2019 Chris Caron  - 0.8.1-1
- Updated to v0.8.1

* Fri Sep 20 2019 Chris Caron  - 0.8.0-1
- Updated to v0.8.0

* Fri Jul 19 2019 Chris Caron  - 0.7.9-1
- Updated to v0.7.9

* Thu Jun  6 2019 Chris Caron  - 0.7.8-1
- Updated to v0.7.8

* Fri May 31 2019 Chris Caron  - 0.7.7-1
- Updated to v0.7.7

* Tue Apr 16 2019 Chris Caron  - 0.7.6-1
- Updated to v0.7.6

* Sun Apr  7 2019 Chris Caron  - 0.7.5-1
- Updated to v0.7.5

* Sun Mar 10 2019 Chris Caron  - 0.7.4-1
- Updated to v0.7.4
- Fedora review process added a man page, spec restructuring and 2 patch files
  to accommodate some valid points brought forth. These have already been pushed
  upstream and will be removed on the next version.

* Fri Feb 22 2019 Chris Caron  - 0.7.3-1
- Updated to v0.7.3
- Added Python 3 build support

* Sun Sep  9 2018 Chris Caron  - 0.5.0-1
- Updated to v0.5.0

* Sun Mar 11 2018 Chris Caron  - 0.0.8-1
- Initial Release
caronc-apprise-dfec414/packaging/verify_translations.py000066400000000000000000000103771526720371000235320ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

"""Check that every built wheel carries each compiled translation catalog.

Run it from the repository root after building:

    python packaging/verify_translations.py

- Apprise only reads compiled ``.mo`` files.  Without them, every language
  falls back to English.
- Every ``.po`` file in the source tree needs a matching ``.mo`` in each
  wheel in ``dist/``.
- Anything missing is listed and the script exits with an error.
"""

from __future__ import annotations

import argparse
from glob import glob
from os.path import abspath, basename, dirname, join
import sys
from typing import Optional
import zipfile

# The repository root, one level up from this script
ROOT_DIR = abspath(join(dirname(__file__), ".."))

# Where our translations live in the source tree
I18N_DIR = join(ROOT_DIR, "apprise", "i18n")


def expected_catalogs() -> list[str]:
    """The wheel path of each compiled catalog a release must carry."""
    # One per language with a catalog in the source tree
    catalogs = []
    for po_path in sorted(glob(join(I18N_DIR, "*", "LC_MESSAGES", "*.po"))):
        # e.g. apprise/i18n/fr/LC_MESSAGES/apprise.mo
        language = basename(dirname(dirname(po_path)))
        name = basename(po_path)[:-3] + ".mo"
        catalogs.append(f"apprise/i18n/{language}/LC_MESSAGES/{name}")

    return catalogs


def missing_catalogs(wheel_path: str, expected: list[str]) -> list[str]:
    """The expected compiled catalogs that ``wheel_path`` does not carry."""
    # Read the wheel's file listing
    with zipfile.ZipFile(wheel_path) as wheel:
        present = set(wheel.namelist())

    return [catalog for catalog in expected if catalog not in present]


def main(argv: Optional[list[str]] = None) -> int:
    """Checks every wheel in the dist folder and reports the outcome."""
    # Prepare our arguments
    parser = argparse.ArgumentParser(description=__doc__.splitlines()[0])
    parser.add_argument(
        "dist",
        nargs="?",
        default=join(ROOT_DIR, "dist"),
        help="folder holding the built wheels (default: dist)",
    )
    args = parser.parse_args(argv)

    # There is nothing to check without a wheel
    wheels = sorted(glob(join(args.dist, "*.whl")))
    if not wheels:
        print(f"No wheel found in {args.dist}")
        return 1

    # Every wheel must carry every language
    expected = expected_catalogs()
    failed = False
    for wheel_path in wheels:
        missing = missing_catalogs(wheel_path, expected)
        if missing:
            failed = True
            name = basename(wheel_path)
            print(f"{name} is missing {len(missing)} catalogs:")
            for catalog in missing:
                print(f"  - {catalog}")

        else:
            print(
                f"{basename(wheel_path)} carries all "
                f"{len(expected)} translation catalogs"
            )

    return 1 if failed else 0


if __name__ == "__main__":
    sys.exit(main())
caronc-apprise-dfec414/pyproject.toml000066400000000000000000000227251526720371000200430ustar00rootroot00000000000000[build-system]
requires = [
    "setuptools>=69",
    "wheel",
    "babel",
]
build-backend = "setuptools.build_meta"

[project]
name = "apprise"
description = "Push Notifications that work with just about every platform!"
readme = "README.md"
authors = [
    { name = "Chris Caron", email = "lead2gold@gmail.com" },
]
dynamic = ["version"]

# Not supported yet for all Distributions
license = { text = "BSD-2-Clause" }

requires-python = ">=3.9"
classifiers = [
    "Development Status :: 5 - Production/Stable",
    "Intended Audience :: Developers",
    "Intended Audience :: System Administrators",
    "Operating System :: OS Independent",
    "Natural Language :: English",
    "Programming Language :: Python",
    "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.14",
    "Programming Language :: Python :: 3.15",
    "Programming Language :: Python :: Implementation :: CPython",
    "Programming Language :: Python :: Implementation :: PyPy",
    "Topic :: Software Development :: Libraries :: Python Modules",
    "Topic :: Software Development :: Libraries :: Application Frameworks",
]

dependencies = [
    # Application dependencies
    "requests",
    "urllib3",
    "requests-oauthlib",
    "click>=5.0",
    "markdown",
    "PyYAML",
    # Root certificate authority bundle
    "certifi",
    # Always ship IANA tzdb on Windows so ZoneInfo works
    "tzdata; platform_system == 'Windows'",
]

# Identifies all of the supported plugins
keywords = [
    "46elks",
    "800.com",
    "Africas Talking",
    "Alerts",
    "AMQP",
    "Apprise API",
    "Automated Packet Reporting System",
    "AWS",
    "Bark",
    "Better Stack",
    "Blink(1)",
    "BlueSky",
    "Brevo",
    "BulkSMS",
    "BulkVS",
    "Burst SMS",
    "Chanify",
    "Chat",
    "CLI",
    "Clickatell",
    "ClickSend",
    "D7Networks",
    "Dapnet",
    "DBus",
    "Delta Chat",
    "DingTalk",
    "Discord",
    "Dot",
    "Email",
    "Emby",
    "Enigma2",
    "Evolution API",
    "Exotel",
    "FCM",
    "Feishu",
    "Flock",
    "Flowtriq",
    "Fluxer",
    "Form",
    "Free Mobile",
    "GitHub",
    "Gnome",
    "GoAlert",
    "Google Chat",
    "Gorush",
    "Gotify",
    "GroupMe",
    "Growl",
    "Guilded",
    "Home Assistant",
    "httpSMS",
    "HumHub",
    "IFTTT",
    "ilert",
    "incident.io",
    "IRC",
    "Jellyfin",
    "Jira",
    "Join",
    "JSON",
    "Kavenegar",
    "KODI",
    "Kook",
    "Kumulos",
    "LaMetric",
    "Lark",
    "Lauther",
    "LFG Alarm",
    "Line",
    "MacOSX",
    "Mailgun",
    "MailerSend",
    "Mastodon",
    "Matrix",
    "Mattermost",
    "MessageBird",
    "Microsoft",
    "MobileMessage",
    "Misskey",
    "MQTT",
    "MSG91",
    "MSTeams",
    "Nextcloud",
    "NextcloudTalk",
    "Notica",
    "Notifiarr",
    "Notifico",
    "Notifyre",
    "Ntfy",
    "Office365",
    "OneBot",
    "OneSignal",
    "Opsgenie",
    "PagerDuty",
    "PagerTree",
    "ParsePlatform",
    "Pinglet",
    "Pingram",
    "Plivo",
    "Postmark",
    "Power Automate",
    "Prowl",
    "Push Notifications",
    "PushBullet",
    "PushDeer",
    "Pushed",
    "Pushjet",
    "PushMe",
    "Pushover",
    "Pushplus",
    "PushSafer",
    "PushWard",
    "Pushy",
    "QQ Push",
    "Quote/0",
    "Reddit",
    "Resend",
    "Revolt",
    "RingCentral",
    "Rocket.Chat",
    "RSyslog",
    "Ryver",
    "SendGrid",
    "SendPulse",
    "ServerChan",
    "SerwerSMS",
    "Session Open Group Server",
    "SES",
    "Seven",
    "SFR",
    "Signal",
    "Signalgrid",
    "SIGNL4",
    "Simplepush",
    "Sinch",
    "Slack",
    "SMPP",
    "SMS Manager",
    "SMSC",
    "SMSEagle",
    "SMTP2Go",
    "SNS",
    "SparkPost",
    "Spike",
    "Splunk",
    "SpugPush",
    "Squadcast",
    "Stackfield",
    "Streamlabs",
    "Stride",
    "Synology Chat",
    "Syslog",
    "Techulus",
    "Telegram",
    "Telnyx",
    "Threema Gateway",
    "Trigv",
    "Twilio",
    "Twist",
    "Twitter",
    "Vapid",
    "Viber",
    "VictorOps",
    "Voipms",
    "Vonage",
    "Webex",
    "Webpush",
    "WeChat (WeCom)",
    "WeCom Bot",
    "WhatsApp",
    "Windows",
    "Workflows",
    "WPUSH",
    "WxPusher",
    "XBMC",
    "XML",
    "XMPP",
    "YouLMK",
    "Zalo",
    "Zoho Cliq",
    "Zoom",
    "Zulip",
]

[project.optional-dependencies]

# All packages required to test/build against
dev = [
    "coverage",
    "mock",
    "tox",
    "pytest",
    "pytest-cov",
    "pytest-mock",
    "pytest-xdist",
    "ruff==0.15.8",
    "babel",
    "validate-pyproject",
]

# Defines all Python libraries for Apprise to work with
# all plugins
all-plugins = [
    # Used in many applications requiring cryptography
    # such as fcm:// and much more
    "cryptography",

    # Provides encrypted spush:// sends
    "PyNaCl",

    # Provides amqp:// support for AMQP 0.9.1
    "pika",

    # AMQP 1.0 requires a source build on Linux. Install it separately with:
    #   pip install python-qpid-proton
    # "python-qpid-proton",

    # provides growl:// support
    "gntp",
    # Provides mqtt:// support
    "paho-mqtt >= 2.1.0",

    # Enables PGP for mailto:// and deltachat://
    "PGPy",

    # Provides blink1:// support
    "hidapi",

    # Provides smpp:// support
    "smpplib",

    # For xmpp:// support (slixmpp 1.16.0+ needs Python 3.11 or newer)
    "slixmpp >= 1.16.0; python_version >= '3.11'",
]
windows = [
    "pywin32",
    "tzdata",
]

[dependency-groups]
# Development environment for uv; "uv sync" installs this group by default.
# Dependency groups are never published, so PyPI users are unaffected.
dev = [
    "apprise[dev,all-plugins]",
]

[project.urls]
Homepage = "https://appriseit.com"
Source = "https://github.com/caronc/apprise"
Tracker = "https://github.com/caronc/apprise/issues"
Documentation = "https://appriseit.com"

[project.scripts]
apprise = "apprise.cli:main"

[tool.setuptools]
include-package-data = true

[tool.setuptools.package-data]
apprise = [
    "assets/NotifyXML-*.xsd",
    "assets/themes/default/*.png",
    "assets/themes/default/*.ico",
    "i18n/*.py",
    "i18n/*/LC_MESSAGES/*.mo",
    "py.typed",
    "*.pyi",
    "*/*.pyi",
]

[tool.setuptools.packages.find]
where = [
    ".",
]
exclude = [
    "tests*",
    "tools*",
]
include = ["apprise*"]

[tool.setuptools.dynamic]
version = {attr = "apprise.__version__"}

[tool.ruff]
line-length = 79  # Respecting BSD-style 79-char limit
target-version = "py39"
exclude = [
  "tests/data",
  "bin",
  "build",
  "dist",
  ".eggs",
  ".tox",
  ".local",
  ".venv",
  "venv",
]


[tool.ruff.lint]
select = [
  "E",    # pycodestyle errors
  "F",    # pyflakes
  "W",    # pycodestyle warnings
  "Q",    # Quote handling ' -> "
  "I",    # isort
  "UP",   # pyupgrade
  "B",    # flake8-bugbear
  "C4",   # flake8-comprehensions
  "SIM",  # flake8-simplify
  "T20",  # flake8-print (catches stray `print`)
  "RUF",  # Ruff-native rules
]

ignore = [
  "D100",    # missing docstring in public module
  "D104",    # missing docstring in public package
  "B008",    # do not call `dict()` with keyword args
  "E741",    # Ambiguous variable name (e.g., l, O, I)
  "W605",    # Invalid escape sequence
  "B026",    # Star-arg play a big part of Apprise; must be accepted for now

  # The following needs to be supported at some point and is of great value
  "RUF012",  # typing.ClassVar implimentation
  "RUF029",  # Use of async without await or async subcalls
  "UP032",   # This is a massive undertaking and requires a massive rewrite
             # of test cases; this will take a while to fix, so turning off
             # for now
]

[tool.ruff.lint.per-file-ignores]
# Our translation report is a command line tool; printing is its whole job
"packaging/i18n_status.py" = ["T201"]
"packaging/verify_translations.py" = ["T201"]

[tool.ruff.lint.pyupgrade]
keep-runtime-typing = true

[tool.ruff.lint.flake8-quotes]
inline-quotes = "double"

[tool.ruff.lint.isort]
known-first-party = ["apprise"]
force-sort-within-sections = true
combine-as-imports = true
order-by-type = true
section-order = ["future", "standard-library", "third-party", "first-party", "local-folder"]

[tool.ruff.lint.flake8-builtins]
builtins-ignorelist = ["_"]

[tool.pytest.ini_options]
# Keep pytest-cov minimal, let Coverage.py control formatting.
addopts = "-ra"
testpaths = ["tests"]
python_files = ["test_*.py", "tests/test_*.py"]
filterwarnings = [
    "once::Warning",
    # Ignore warnings from PGPy's dependencies and unfinished checks, which
    # Apprise cannot resolve.
    "ignore::Warning:pgpy(\\.|$)",
    # PGPy reports this internal encryption warning from Apprise's call site.
    "ignore:^Selected compression algorithm not in key preferences$:UserWarning",
]

[tool.coverage.run]
branch = true
parallel = false
data_file = ".coverage"
source = ["apprise"]
relative_files = true

[tool.coverage.paths]
# Normalise .tox and site-packages layouts back to 'apprise'
source = [
    "apprise",
    "/apprise/apprise",
    ".tox/*/lib/python*/site-packages/apprise",
    ".tox/pypy/site-packages/apprise"
]

[tool.coverage.report]
# Controls terminal and XML content when Coverage.py renders reports
show_missing = true
skip_covered = true
skip_empty = true
precision = 1
exclude_lines = [
    "pragma: no cover",
    "if TYPE_CHECKING:",
    "if __name__ == .__main__.:",
    "raise NotImplementedError",
    "pass$",
]

[tool.coverage.xml]
# Ensure GitHub Action can find a predictable file
output = "coverage.xml"
caronc-apprise-dfec414/requirements.txt000066400000000000000000000005641526720371000204100ustar00rootroot00000000000000#
# Note: This file is being kept for backwards compatibility with
#       legacy systems that point here.  All future changes should
#       occur in pyproject.toml.  Contents of this file can be found
#       in project.dependencies

# Root certificate authority bundle
certifi

# Application dependencies
requests
urllib3
requests-oauthlib
click >= 5.0
markdown
PyYAML
caronc-apprise-dfec414/setup.py000077500000000000000000000074541526720371000166460ustar00rootroot00000000000000#!/usr/bin/env python
# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

#
# 2025.07.10 NOTE:
# setup.py (Temporary shim for RHEL9 Package Building Only)
# Refer to tox for everything else; this will be removed once RHEL9 support
# is dropped.
#
import glob
import os
import re

from setuptools import find_packages, setup
from setuptools.command.build_py import build_py


class BuildPyWithTranslations(build_py):
    """Compile the translation catalogs before building the package.

    The ``.mo`` files are not kept in git, so without this a build from a
    git checkout ships no translations.
    """

    def run(self) -> None:
        # Babel is already a build requirement (see pyproject.toml)
        from babel.messages.mofile import write_mo
        from babel.messages.pofile import read_po

        # Compile each language's catalog next to its source
        pattern = os.path.join("apprise", "i18n", "*", "LC_MESSAGES", "*.po")
        for po_path in glob.glob(pattern):
            # Read our human-editable catalog
            with open(po_path, "rb") as po_file:
                catalog = read_po(po_file)

            # Write the compiled copy that gettext actually reads
            with open(po_path[:-3] + ".mo", "wb") as mo_file:
                write_mo(mo_file, catalog)

        # Now build as normal; package_data picks up the .mo files
        super().run()


def read_version() -> str:
    with open(os.path.join("apprise", "__init__.py"), encoding="utf-8") as f:
        for line in f:
            m = re.match(r'^__version__\s*=\s*[\'"]([^\'"]+)', line)
            if m:
                return m.group(1)
    raise RuntimeError("Version not found")


# tox is not supported well in RHEL9 so this stub file is the only way to
# successfully build the RPM; packaging/redhat/python-apprise.spec has
# been updated accordingly to accommodate reference to this for older
# versions of the distribution only
setup(
    name="apprise",
    cmdclass={"build_py": BuildPyWithTranslations},
    version=read_version(),
    packages=find_packages(exclude=["tests*", "packaging*"]),
    entry_points={
        "console_scripts": [
            "apprise = apprise.cli:main",
        ],
    },
    package_data={
        "apprise": [
            "assets/NotifyXML-*.xsd",
            "assets/themes/default/*.png",
            "assets/themes/default/*.ico",
            "i18n/*.py",
            "i18n/*/LC_MESSAGES/*.mo",
            "py.typed",
            "*.pyi",
            "*/*.pyi",
        ],
    },
)
caronc-apprise-dfec414/tests/000077500000000000000000000000001526720371000162615ustar00rootroot00000000000000caronc-apprise-dfec414/tests/conftest.py000066400000000000000000000215761526720371000204730ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import concurrent.futures as cf
import contextlib
import gc
import logging
import mimetypes
import os
import sys
from types import ModuleType
import warnings

import pytest

from apprise import (
    AttachmentManager,
    ConfigurationManager,
    NotificationManager,
)
import apprise.apprise as apprise_module
from apprise.logger import logger as apprise_logger
from apprise.utils.singleton import Singleton

sys.path.append(os.path.join(os.path.dirname(__file__), "helpers"))

# Grant access to our Notification Manager Singleton
N_MGR = NotificationManager()
# Grant access to our Config Manager Singleton
C_MGR = ConfigurationManager()
# Grant access to our Attachment Manager Singleton
A_MGR = AttachmentManager()

# Packages whose module globals are restored after each test
RESTORED_PACKAGES = ("apprise", "helpers")


def is_restored_module(name):
    """True for Apprise, test helper and test file modules."""
    # Match the top-level package exactly so apprise_extra is left alone.
    top = name.partition(".")[0]
    return top in RESTORED_PACKAGES or top.startswith("test_")


def restore_module_globals(snapshot):
    """Restore module globals changed by reload().

    This keeps class identities stable between tests on the same worker.
    """
    # Restore replaced globals, but keep module references in sync with
    # sys.modules.
    changed = False
    for current, saved in snapshot.values():
        for key, value in saved.items():
            if current.get(key) is not value and not isinstance(
                value, ModuleType
            ):
                current[key] = value
                changed = True

    if not changed:
        # No reload cleanup is needed.
        return

    # A module global that no longer matches sys.modules still points at a
    # fake or replaced module, such as a mocked gi.  Put back what was there.
    for current, saved in snapshot.values():
        for key, value in current.copy().items():
            if (
                not isinstance(value, ModuleType)
                or sys.modules.get(value.__name__) is value
            ):
                continue

            if key in saved:
                current[key] = saved[key]

            else:
                current.pop(key, None)

    # A reload builds a new manager class, and its singleton instance would
    # keep the old plugin modules alive.  Keep only the current classes.
    for cls in list(Singleton._instances):
        module = sys.modules.get(cls.__module__)
        if getattr(module, cls.__name__, None) is not cls:
            Singleton._instances.pop(cls, None)

    # Drop modules created from reloaded classes so they are rebuilt later.
    # Copy the names first since a background thread may still import.
    for name in [
        name
        for name in sys.modules.copy()
        if is_restored_module(name) and name not in snapshot
    ]:
        module = sys.modules.pop(name, None)
        if module is None:
            # Another thread already removed it.
            continue

        # Also remove the reference held by its parent package.  Another
        # thread may remove it first, which is fine.
        parent, _, attr = name.rpartition(".")
        parent_module = sys.modules.get(parent)
        if getattr(parent_module, attr, None) is module:
            with contextlib.suppress(AttributeError):
                delattr(parent_module, attr)


@pytest.hookimpl(hookwrapper=True)
def pytest_runtest_setup(item):
    """Remember shared state before any fixture of the test runs."""
    # Save the globals from project and test modules.  copy() takes the
    # module list in one step, so a cleanup that imports cannot change it
    # part way through.
    item._apprise_modules = {
        name: (module.__dict__, dict(module.__dict__))
        for name, module in sys.modules.copy().items()
        if is_restored_module(name) and module is not None
    }

    # Calls left by earlier tests were already waited on and reported.
    with apprise_module._abandoned_futures_lock:
        item._apprise_earlier_calls = {
            future for future, _, _ in apprise_module._abandoned_futures
        }

    yield


@pytest.hookimpl(hookwrapper=True)
def pytest_runtest_teardown(item, nextitem):
    """Clean up shared state around the test's own fixture teardown."""
    # Timed-out calls keep running after notify(), so wait for this test's
    # while its mocks and patches are still in place.
    # Take the saved state off the item, since pytest keeps every item for
    # the whole run and the copies would otherwise stay in memory.
    earlier = item.__dict__.pop("_apprise_earlier_calls", set())
    snapshot = item.__dict__.pop("_apprise_modules", None)

    with apprise_module._abandoned_futures_lock:
        running = [
            future
            for future, _, _ in apprise_module._abandoned_futures
            if future not in earlier
        ]

    # Keep calls that exceed the timeout tracked as leaks, reported once.
    _, still_running = cf.wait(running, timeout=10)

    # Let every fixture, monkeypatch and mock undo itself first.
    yield

    # sys.modules is back to normal now, so module globals can be checked
    # against it.
    if snapshot:
        restore_module_globals(snapshot)

    # Warn last, so a warning treated as an error cannot skip the cleanup.
    if still_running:
        warnings.warn(
            f"{len(still_running)} background service call(s) still "
            "running 10s after the test finished.",
            ResourceWarning,
            stacklevel=1,
        )


@pytest.fixture(scope="function", autouse=True)
def mimetypes_always_available():
    """Use the test MIME database for every test."""
    files = (os.path.join(os.path.dirname(__file__), "var", "mime.types"),)
    mimetypes.init(files=files)


@pytest.fixture(scope="function", autouse=True)
def no_throttling_everywhere(mocker):
    """Disable plugin throttling for every test.

    Function-scoped cleanup prevents patches from accumulating across the
    suite and slowing final teardown.
    """
    # Ensure we're working with a clean slate for each test
    N_MGR.unload_modules()
    C_MGR.unload_modules()
    A_MGR.unload_modules()

    for plugin in N_MGR.plugins():
        mocker.patch.object(plugin, "request_rate_per_sec", 0)


@pytest.fixture(scope="function", autouse=True)
def _reset_apprise_logger_state():
    """Reset shared logger state around every test.

    CLI tests change the Apprise and asyncio loggers. Restoring their levels
    and handlers prevents those changes from affecting later log assertions.
    """
    asyncio_logger = logging.getLogger("asyncio")

    original_level = apprise_logger.level
    original_handlers = list(apprise_logger.handlers)
    original_asyncio_level = asyncio_logger.level
    original_asyncio_handlers = list(asyncio_logger.handlers)

    # Many tests switch logging back on with logging.disable(NOTSET).  Put
    # the global level back afterwards so the next test is not affected.
    original_disable = logging.root.manager.disable

    apprise_logger.setLevel(logging.NOTSET)
    asyncio_logger.setLevel(logging.NOTSET)
    asyncio_logger.handlers[:] = []
    yield
    apprise_logger.setLevel(original_level)
    apprise_logger.handlers[:] = original_handlers
    asyncio_logger.setLevel(original_asyncio_level)
    asyncio_logger.handlers[:] = original_asyncio_handlers
    logging.disable(original_disable)


@pytest.fixture(scope="function", autouse=True)
def collect_all_garbage():
    """Collect garbage after each test to isolate plugin finalizers."""
    # Force garbage collection
    gc.collect()
caronc-apprise-dfec414/tests/docker/000077500000000000000000000000001526720371000175305ustar00rootroot00000000000000caronc-apprise-dfec414/tests/docker/Dockerfile.el10000066400000000000000000000053461526720371000222720ustar00rootroot00000000000000# -*- coding: utf-8 -*-
# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Base
FROM rockylinux/rockylinux:10
ENV container=docker

# Basic build tooling and RPM stack
RUN \
    rm -f /lib/systemd/system/multi-user.target.wants/*;\
    rm -f /etc/systemd/system/*.wants/*;\
    rm -f /lib/systemd/system/local-fs.target.wants/*; \
    rm -f /lib/systemd/system/sockets.target.wants/*udev*; \
    rm -f /lib/systemd/system/sockets.target.wants/*initctl*; \
    rm -f /lib/systemd/system/basic.target.wants/*;\
    rm -f /lib/systemd/system/anaconda.target.wants/*; \
    echo "assumeyes=1" >> /etc/yum.conf; \
    dnf -y update && \
    dnf install -y epel-release; \
    dnf install -y rpm-build python3-pip \
    dnf-plugins-core 'dnf-command(config-manager)' \
    'dnf-command(builddep)' sudo rsync rpmdevtools && \
    dnf config-manager --set-enabled crb && \
    dnf -y install pyproject-rpm-macros rpmlint rubygem-ronn-ng && \
    dnf clean all

# Place our build file into the path
COPY packaging/redhat/python-apprise.spec /
RUN rpmspec -q --buildrequires /python-apprise.spec | cut -f1 -d' ' | \
    xargs dnf install -y && dnf clean all

# RPM build structure setup
ENV FLAVOR=rpmbuild OS=centos DIST=el10

RUN useradd builder -u 1000 -m -G users,wheel &>/dev/null && \
    echo "builder ALL=(ALL:ALL) NOPASSWD:ALL" >> /etc/sudoers

VOLUME ["/apprise"]
WORKDIR /apprise

# RPMs should never be built as root
USER builder
caronc-apprise-dfec414/tests/docker/Dockerfile.el9000066400000000000000000000052321526720371000222140ustar00rootroot00000000000000# -*- coding: utf-8 -*-
# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Base
FROM rockylinux/rockylinux:9
ENV container=docker

# Basic build tooling and RPM stack
RUN \
    rm -f /lib/systemd/system/multi-user.target.wants/*;\
    rm -f /etc/systemd/system/*.wants/*;\
    rm -f /lib/systemd/system/local-fs.target.wants/*; \
    rm -f /lib/systemd/system/sockets.target.wants/*udev*; \
    rm -f /lib/systemd/system/sockets.target.wants/*initctl*; \
    rm -f /lib/systemd/system/basic.target.wants/*;\
    rm -f /lib/systemd/system/anaconda.target.wants/*; \
    echo "assumeyes=1" >> /etc/yum.conf; \
    dnf -y update && \
    dnf install -y epel-release; \
    dnf install -y rpm-build rpmlint python3-pip rubygem-ronn \
    dnf-plugins-core 'dnf-command(config-manager)' \
    'dnf-command(builddep)' sudo rsync rpmdevtools; \
    dnf config-manager --set-enabled crb

# Place our build file into the path
COPY packaging/redhat/python-apprise.spec /
RUN rpmspec -q --buildrequires /python-apprise.spec | cut -f1 -d' ' | \
    xargs dnf install -y && dnf clean all

# RPM Build Structure Setup
ENV FLAVOR=rpmbuild OS=centos DIST=el9
RUN useradd builder -u 1000 -m -G users,wheel &>/dev/null && \
    echo "builder ALL=(ALL:ALL) NOPASSWD:ALL" >> /etc/sudoers

VOLUME ["/apprise"]
WORKDIR /apprise

# RPMs should never be built as root
USER builder
caronc-apprise-dfec414/tests/docker/Dockerfile.f44000066400000000000000000000060771526720371000221300ustar00rootroot00000000000000# -*- coding: utf-8 -*-
# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

## The following was added to accommodate:
#   https://bugzilla.redhat.com/show_bug.cgi?id=2216807
#
# the switch was added and it didn't work:
#  dnf update -y --setopt=protected_packages=,
#
# The second work-around was to add --skip-broken
# This also didn't work.  the final option was to download the RPMs in
# advance and just force them.
#
# Base
FROM fedora:44
ENV container=docker

# https://bugzilla.redhat.com/show_bug.cgi?id=2216807 workaround
RUN dnf download -y --destdir BZ2216807 --resolve dnf-data && \
    rpm -Uhi --force BZ2216807/*

RUN \
    rm -f /usr/lib/systemd/system/multi-user.target.wants/*;\
    rm -f /etc/systemd/system/*.wants/*;\
    rm -f /usr/lib/systemd/system/local-fs.target.wants/*; \
    rm -f /usr/lib/systemd/system/sockets.target.wants/*udev*; \
    rm -f /usr/lib/systemd/system/sockets.target.wants/*initctl*; \
    rm -f /usr/lib/systemd/system/basic.target.wants/*;\
    rm -f /usr/lib/systemd/system/anaconda.target.wants/*; \
    echo "assumeyes=1" >> /etc/dnf/dnf.conf; \
    dnf install -y epel-release; \
    dnf install -y rpm-build rpmlint python3-pip rubygem-ronn \
    dnf-plugins-core 'dnf-command(config-manager)' \
    'dnf-command(builddep)' sudo rsync rpmdevtools

# Place our build file into the path
COPY packaging/redhat/python-apprise.spec /
RUN rpmspec -q --buildrequires /python-apprise.spec | cut -f1 -d' ' | \
    xargs dnf install -y && dnf clean all

# RPM Build Structure Setup
ENV FLAVOR=rpmbuild OS=centos DIST=f44
RUN useradd builder -u 1000 -m -G users,wheel &>/dev/null && \
    echo "builder ALL=(ALL:ALL) NOPASSWD:ALL" >> /etc/sudoers

VOLUME ["/apprise"]
WORKDIR /apprise

# RPMs should never be built as root
USER builder
caronc-apprise-dfec414/tests/docker/Dockerfile.py310000066400000000000000000000041441526720371000224000ustar00rootroot00000000000000# -*- coding: utf-8 -*-
# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Base
FROM python:3.10-buster
RUN apt-get update && \
    apt-get install -y --no-install-recommends libdbus-1-dev libgirepository1.0-dev build-essential musl-dev bash dbus && \
    rm -rf /var/lib/apt/lists/*
RUN pip install --no-cache-dir dbus-python "PyGObject==3.44.2"

# Apprise Setup
VOLUME ["/apprise"]
WORKDIR /apprise
COPY requirements.txt /
COPY dev-requirements.txt /
ENV PYTHONPATH=/apprise
ENV PYTHONPYCACHEPREFIX=/apprise/__pycache__/py310

RUN pip install --no-cache-dir -r /requirements.txt -r /dev-requirements.txt

RUN addgroup --gid ${USER_GID:-1000} apprise
RUN adduser --system --uid ${USER_UID:-1000} --ingroup apprise --home /apprise --no-create-home --disabled-password apprise

USER apprise
caronc-apprise-dfec414/tests/docker/Dockerfile.py311000066400000000000000000000041441526720371000224010ustar00rootroot00000000000000# -*- coding: utf-8 -*-
# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Base
FROM python:3.11-buster
RUN apt-get update && \
    apt-get install -y --no-install-recommends libdbus-1-dev libgirepository1.0-dev build-essential musl-dev bash dbus && \
    rm -rf /var/lib/apt/lists/*
RUN pip install --no-cache-dir dbus-python "PyGObject==3.44.2"

# Apprise Setup
VOLUME ["/apprise"]
WORKDIR /apprise
COPY requirements.txt /
COPY dev-requirements.txt /
ENV PYTHONPATH=/apprise
ENV PYTHONPYCACHEPREFIX=/apprise/__pycache__/py311

RUN pip install --no-cache-dir -r /requirements.txt -r /dev-requirements.txt

RUN addgroup --gid ${USER_GID:-1000} apprise
RUN adduser --system --uid ${USER_UID:-1000} --ingroup apprise --home /apprise --no-create-home --disabled-password apprise

USER apprise
caronc-apprise-dfec414/tests/docker/Dockerfile.py312000066400000000000000000000041461526720371000224040ustar00rootroot00000000000000# -*- coding: utf-8 -*-
# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Base
FROM python:3.12-bookworm
RUN apt-get update && \
    apt-get install -y --no-install-recommends libdbus-1-dev libgirepository1.0-dev build-essential musl-dev bash dbus && \
    rm -rf /var/lib/apt/lists/*
RUN pip install --no-cache-dir dbus-python "PyGObject==3.44.2"

# Apprise Setup
VOLUME ["/apprise"]
WORKDIR /apprise
COPY requirements.txt /
COPY dev-requirements.txt /
ENV PYTHONPATH=/apprise
ENV PYTHONPYCACHEPREFIX=/apprise/__pycache__/py312

RUN pip install --no-cache-dir -r /requirements.txt -r /dev-requirements.txt

RUN addgroup --gid ${USER_GID:-1000} apprise
RUN adduser --system --uid ${USER_UID:-1000} --ingroup apprise --home /apprise --no-create-home --disabled-password apprise

USER apprise
caronc-apprise-dfec414/tests/docker/Dockerfile.py39000066400000000000000000000041441526720371000223300ustar00rootroot00000000000000# -*- coding: utf-8 -*-
# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Base
FROM python:3.9-bookworm
RUN apt-get update && \
    apt-get install -y --no-install-recommends libdbus-1-dev libgirepository1.0-dev build-essential musl-dev bash dbus && \
    rm -rf /var/lib/apt/lists/*
RUN pip install --no-cache-dir dbus-python "PyGObject==3.44.2"

# Apprise Setup
VOLUME ["/apprise"]
WORKDIR /apprise
COPY requirements.txt /
COPY dev-requirements.txt /
ENV PYTHONPATH=/apprise
ENV PYTHONPYCACHEPREFIX=/apprise/__pycache__/py39

RUN pip install --no-cache-dir -r /requirements.txt -r /dev-requirements.txt

RUN addgroup --gid ${USER_GID:-1000} apprise
RUN adduser --system --uid ${USER_UID:-1000} --ingroup apprise --home /apprise --no-create-home --disabled-password apprise

USER apprise
caronc-apprise-dfec414/tests/docker/Dockerfile.rawhide000066400000000000000000000061101526720371000231420ustar00rootroot00000000000000# -*- coding: utf-8 -*-
# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

## The following was added to accommodate:
#   https://bugzilla.redhat.com/show_bug.cgi?id=2216807
#
# the switch was added and it didn't work:
#  dnf update -y --setopt=protected_packages=,
#
# The second work-around was to add --skip-broken
# This also didn't work.  the final option was to download the RPMs in
# advance and just force them.
#
# Base
FROM fedora:rawhide
ENV container=docker

# https://bugzilla.redhat.com/show_bug.cgi?id=2216807 workaround
RUN dnf download -y --destdir BZ2216807 --resolve dnf-data && \
    rpm -Uhi --force BZ2216807/*

RUN \
    rm -f /usr/lib/systemd/system/multi-user.target.wants/*;\
    rm -f /etc/systemd/system/*.wants/*;\
    rm -f /usr/lib/systemd/system/local-fs.target.wants/*; \
    rm -f /usr/lib/systemd/system/sockets.target.wants/*udev*; \
    rm -f /usr/lib/systemd/system/sockets.target.wants/*initctl*; \
    rm -f /usr/lib/systemd/system/basic.target.wants/*;\
    rm -f /usr/lib/systemd/system/anaconda.target.wants/*; \
    echo "assumeyes=1" >> /etc/dnf/dnf.conf; \
    dnf install -y epel-release; \
    dnf install -y rpm-build rpmlint python3-pip rubygem-ronn \
    dnf-plugins-core 'dnf-command(config-manager)' \
    'dnf-command(builddep)' sudo rsync rpmdevtools

# Place our build file into the path
COPY packaging/redhat/python-apprise.spec /
RUN rpmspec -q --buildrequires /python-apprise.spec | cut -f1 -d' ' | \
    xargs dnf install -y && dnf clean all

# RPM Build Structure Setup
ENV FLAVOR=rpmbuild OS=centos DIST=rawhide
RUN useradd builder -u 1000 -m -G users,wheel &>/dev/null && \
    echo "builder ALL=(ALL:ALL) NOPASSWD:ALL" >> /etc/sudoers

VOLUME ["/apprise"]
WORKDIR /apprise

# RPMs should never be built as root
USER builder
caronc-apprise-dfec414/tests/helpers/000077500000000000000000000000001526720371000177235ustar00rootroot00000000000000caronc-apprise-dfec414/tests/helpers/__init__.py000066400000000000000000000034601526720371000220370ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from .asyncio import OuterEventLoop
from .delivery import (
    ATTACHMENT,
    OK_BODY,
    OK_FIELDS,
    delivery_marks,
    ok_response,
)
from .environment import environ
from .module import reload_plugin
from .rest import AppriseURLTester

__all__ = [
    "ATTACHMENT",
    "OK_BODY",
    "OK_FIELDS",
    "AppriseURLTester",
    "OuterEventLoop",
    "delivery_marks",
    "environ",
    "ok_response",
    "reload_plugin",
]
caronc-apprise-dfec414/tests/helpers/asyncio.py000066400000000000000000000034741526720371000217520ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import asyncio


class OuterEventLoop:
    """An event loop that is easy to put up and tear down from synchronous test
    code."""

    def __init__(self):
        self._loop = None

    def __enter__(self):
        loop = asyncio.new_event_loop()
        asyncio.set_event_loop(loop)
        self._loop = loop
        return loop

    def __exit__(self, type, value, traceback):
        asyncio.set_event_loop(None)
        self._loop.close()
caronc-apprise-dfec414/tests/helpers/delivery.py000066400000000000000000000076411526720371000221300ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.


"""Shared responses, attachments, and recorders for delivery tests."""

import contextlib
from json import dumps
import os
from unittest import mock

import requests

from apprise.plugins.base import NotifyBase

# Attachment Directory
TEST_VAR_DIR = os.path.join(
    os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "var"
)
ATTACHMENT = os.path.join(TEST_VAR_DIR, "apprise-test.gif")

# Fields a service might look for in a good answer.  It is deliberately
# wide: one answer has to satisfy every service in the fleet, and a field
# a service does not know about is simply ignored.
OK_FIELDS = {
    "ok": True,
    "success": True,
    "status": "success",
    "id": "1",
    "uuid": "1",
    "sid": "1",
    "requestId": "1",
    "code": 0,
    "errcode": 0,
    "error": None,
    "channel": "C1",
    "access_token": "abc",
    "expires_in": 3600,
    "message_id": 1,
    "upload_url": "https://localhost/upload",
    "file_id": "F1",
    "file_name": "apprise-test.gif",
    "file_type": "image/gif",
    "file_url": "https://localhost/x",
    "media_id": 1,
    "media_id_string": "1",
    "content_uri": "mxc://localhost/1",
    "event_id": "e1",
    "room_id": "!r:localhost",
    "user_id": "@u:localhost",
    "url": "https://cdn.example/x",
    "post": {"id": 1},
    "data": {"url": "https://cdn.example/x", "id": "1"},
    "json": {"errors": []},
    "result": {"message_id": 1, "id": "1", "status": "ok"},
    "items": [{"id": "1"}],
    "messages": [{"status": "0", "message-id": "1"}],
}

# The same answer as a JSON document
OK_BODY = dumps(OK_FIELDS)


def ok_response(*args, **kwargs):
    """Return a response a service will treat as a success."""
    response = requests.Request()
    response.status_code = requests.codes.ok
    response.content = OK_BODY
    response.text = OK_BODY
    response.headers = {"Content-Type": "application/json"}

    def iter_content(chunk_size=None):
        # A bounded read pulls the body in chunks, the way requests does
        return iter([OK_BODY.encode("utf-8")])

    def close():
        # Nothing to release on a stand-in
        pass

    response.iter_content = iter_content
    response.close = close
    return response


@contextlib.contextmanager
def delivery_marks():
    """Collect every target a service records while the block runs."""

    recorded = []
    real = NotifyBase.mark_delivered

    def counted(self, key, per_message=False):
        recorded.append(key)
        return real(self, key, per_message)

    with mock.patch.object(NotifyBase, "mark_delivered", counted):
        yield recorded
caronc-apprise-dfec414/tests/helpers/environment.py000066400000000000000000000047351526720371000226520ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import contextlib
import locale

# Disable logging for a cleaner testing output
import logging
import os

logging.disable(logging.CRITICAL)


@contextlib.contextmanager
def environ(*remove, **update):
    """Temporarily updates the ``os.environ`` dictionary in-place.

    The ``os.environ`` dictionary is updated in-place so that the modification
    is sure to work in all situations.

    :param remove: Environment variable(s) to remove.
    :param update: Dictionary of environment variables and values to
                   add/update.
    """
    env_orig = os.environ.copy()

    # Query every category at once. getlocale() is mocked by some tests, and
    # feeding its stand-in value back would leave the whole process in the C
    # locale once this block exits.
    loc_orig = locale.setlocale(locale.LC_ALL)
    try:
        os.environ.update(update)
        for k in remove:
            os.environ.pop(k, None)
        yield

    finally:
        os.environ.clear()
        os.environ.update(env_orig)
        with contextlib.suppress(locale.Error):
            locale.setlocale(locale.LC_ALL, loc_orig)
caronc-apprise-dfec414/tests/helpers/module.py000066400000000000000000000237531526720371000215740ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from importlib import import_module, reload
from itertools import chain
import re
import sys

from apprise import (
    AttachmentManager,
    ConfigurationManager,
    NotificationManager,
)

# Grant access to our Notification Manager Singleton
N_MGR = NotificationManager()

# Grant access to our Attachment Manager Singleton
A_MGR = AttachmentManager()

# Grant access to our Configuration Manager Singleton
C_MGR = ConfigurationManager()

# For filtering our result when scanning a module
# Identify any items below we should match on that we can freely
# directly copy around between our modules.  This should only
# catch class/function/variables we want to allow explicity
# copy/paste access with
module_filter_re = re.compile(
    r"^(?P(Notify|Config|Attach)[A-Za-z0-9]+)$"
)


def reload_plugin(name):
    """Reload built-in plugin module, e.g. `NotifyGnome`.

    Reloading plugin modules is needed when testing module-level code of
    notification plugins.

    See also
    https://stackoverflow.com/questions/31363311.
    """

    A_MGR.unload_modules()

    reload(sys.modules["apprise.apprise_attachment"])
    reload(sys.modules["apprise.attachment.base"])
    new_apprise_attachment_mod = import_module("apprise.apprise_attachment")
    new_apprise_attach_base_mod = import_module("apprise.attachment.base")
    reload(sys.modules["apprise.manager_attachment"])

    module_pyname = f"{N_MGR.module_name_prefix}.{name}"
    if module_pyname in sys.modules:
        reload(sys.modules[module_pyname])
    new_notify_mod = import_module(module_pyname)

    A_MGR.unload_modules()

    reload(sys.modules["apprise.apprise_config"])
    reload(sys.modules["apprise.config.base"])
    new_apprise_configuration_mod = import_module("apprise.apprise_config")
    new_apprise_config_base_mod = import_module("apprise.config.base")
    reload(sys.modules["apprise.manager_config"])

    C_MGR.unload_modules()

    module_pyname = f"{N_MGR.module_name_prefix}.{name}"
    if module_pyname in sys.modules:
        reload(sys.modules[module_pyname])
    new_notify_mod = import_module(module_pyname)

    # Detect our class object
    class_matches = {}
    for class_name in [
        obj for obj in dir(new_notify_mod) if module_filter_re.match(obj)
    ]:
        # Store our entry
        class_matches[class_name] = getattr(new_notify_mod, class_name)

    # the user running the tests did not correctly use reload_plugin() or
    # they did, but libraries around them have shifted.  We need to error out
    # so the test can be fixed
    if not class_matches:
        raise AttributeError(f"Module {name} has no URLBase defined in it!")

    reload(sys.modules["apprise.manager_plugins"])
    reload(sys.modules["apprise.apprise"])
    reload(sys.modules["apprise.utils"])
    reload(sys.modules["apprise.locale"])
    reload(sys.modules["apprise"])

    # Acquire all of the test files we have
    tests = [k for k in sys.modules if re.match(r"^test_.+$", k)]

    # Iterate over all of our test modules
    for module_name in tests:
        # Filter the test files by only those using the class_name we found
        # within our module
        possible_matches = [
            m
            for m in dir(sys.modules[module_name])
            if re.match(
                "^(?P{})$".format("|".join(class_matches.keys())), m
            )
        ]
        if not possible_matches:
            continue

        # if we get here, we have test_ files that utilize the Class we just
        # reloaded

        # Fix reference to new plugin class in given module.
        # Needed for updating the module-level import reference like
        # `from apprise.plugins.NotifyABCDE import NotifyABCDE`.
        #
        # We reload NotifyABCDE and place it back in its spot
        test_mod = import_module(module_name)
        for class_name, class_plugin in class_matches.items():
            if hasattr(test_mod, class_name):
                setattr(test_mod, class_name, class_plugin)

    #
    # Detect our Apprise Modules (include helpers)
    #
    apprise_modules = sorted(
        [k for k in sys.modules if re.match(r"^(apprise|helpers)(\.|.+)$", k)],
        reverse=True,
    )

    #
    # This section below reloads our attachment classes
    #

    for entry in A_MGR:
        reload(sys.modules[entry["path"]])
        for module_pyname in chain(apprise_modules, tests):
            detect = re.compile(
                r"^(?P(AppriseAttachment|AttachBase|"
                + entry["path"].split(".")[-1]
                + r"))$"
            )

            possible_matches = [
                m for m in dir(sys.modules[module_pyname]) if detect.match(m)
            ]
            if not possible_matches:
                continue

            apprise_mod = import_module(module_pyname)
            # Fix reference to new plugin class in given module.
            # Needed for updating the module-level import reference
            # like `from apprise. import AttachABCDE`.
            #
            # We reload NotifyABCDE and place it back in its spot
            # new_attach = import_module(entry['path'])
            for name in possible_matches:
                if name == "AppriseAttachment":
                    setattr(
                        apprise_mod,
                        name,
                        getattr(new_apprise_attachment_mod, name),
                    )

                elif name == "AttachBase":
                    setattr(
                        apprise_mod,
                        name,
                        getattr(new_apprise_attach_base_mod, name),
                    )

                else:
                    module_pyname = f"{A_MGR.module_name_prefix}.{name}"
                    new_attach_mod = import_module(module_pyname)

                    # Detect our class object
                    class_matches = {}
                    for class_name in [
                        obj
                        for obj in dir(new_attach_mod)
                        if module_filter_re.match(obj)
                    ]:
                        # Store our entry
                        class_matches[class_name] = getattr(
                            new_attach_mod, class_name
                        )

                    for class_name, class_plugin in class_matches.items():
                        if hasattr(apprise_mod, class_name):
                            setattr(apprise_mod, class_name, class_plugin)

    #
    # This section below reloads our configuration classes
    #

    for entry in C_MGR:
        reload(sys.modules[entry["path"]])
        for module_pyname in chain(apprise_modules, tests):
            detect = re.compile(
                r"^(?P(AppriseConfig|ConfigBase|"
                + entry["path"].split(".")[-1]
                + r"))$"
            )

            possible_matches = [
                m for m in dir(sys.modules[module_pyname]) if detect.match(m)
            ]
            if not possible_matches:
                continue

            apprise_mod = import_module(module_pyname)
            # Fix reference to new plugin class in given module.
            # Needed for updating the module-level import reference
            # like `from apprise. import ConfigABCDE`.
            #
            # We reload NotifyABCDE and place it back in its spot
            # new_attach = import_module(entry['path'])
            for name in possible_matches:
                if name == "AppriseConfig":
                    setattr(
                        apprise_mod,
                        name,
                        getattr(new_apprise_configuration_mod, name),
                    )

                elif name == "ConfigBase":
                    setattr(
                        apprise_mod,
                        name,
                        getattr(new_apprise_config_base_mod, name),
                    )

                else:
                    module_pyname = f"{A_MGR.module_name_prefix}.{name}"
                    new_config_mod = import_module(module_pyname)

                    # Detect our class object
                    class_matches = {}
                    for class_name in [
                        obj
                        for obj in dir(new_config_mod)
                        if module_filter_re.match(obj)
                    ]:
                        # Store our entry
                        class_matches[class_name] = getattr(
                            new_config_mod, class_name
                        )

                    for class_name, class_plugin in class_matches.items():
                        if hasattr(apprise_mod, class_name):
                            setattr(apprise_mod, class_name, class_plugin)
caronc-apprise-dfec414/tests/helpers/rest.py000066400000000000000000000675001526720371000212620ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from json import dumps

# Disable logging for a cleaner testing output
import logging
import os
from random import choice
import re
from string import ascii_uppercase as str_alpha, digits as str_num
from unittest import mock

import requests

from apprise import (
    Apprise,
    AppriseAsset,
    AppriseAttachment,
    NotifyBase,
    NotifyType,
    PersistentStoreMode,
)
from apprise.common import OverflowMode

logging.disable(logging.CRITICAL)


class AppriseURLTester:
    # Some exception handling we'll use
    req_exceptions = (
        requests.ConnectionError(0, "requests.ConnectionError() not handled"),
        requests.RequestException(
            0, "requests.RequestException() not handled"
        ),
        requests.HTTPError(0, "requests.HTTPError() not handled"),
        requests.ReadTimeout(0, "requests.ReadTimeout() not handled"),
        requests.TooManyRedirects(
            0, "requests.TooManyRedirects() not handled"
        ),
    )

    # Attachment Testing Directory
    __test_var_dir = os.path.join(
        os.path.dirname(os.path.dirname(__file__)), "var"
    )

    # Our URLs we'll test against
    __tests = []

    # Define how many characters exist per line
    row = 80

    # Some variables we use to control the data we work with
    body_len = 1024
    title_len = 1024

    def __init__(self, tests=None, *args, **kwargs):
        """Our initialization."""
        # Create a large body and title with random data
        self.body = "".join(
            choice(str_alpha + str_num + " ") for _ in range(self.body_len)
        )
        self.body = "\r\n".join(
            [
                self.body[i : i + self.row]
                for i in range(0, len(self.body), self.row)
            ]
        )

        # Create our title using random data
        self.title = "".join(
            choice(str_alpha + str_num) for _ in range(self.title_len)
        )

        if tests:
            self.__tests = tests

    @staticmethod
    def __iter_content(robj):
        """Build ``iter_content()`` for a mocked response.

        The configured body is returned as one chunk for streaming plugins.
        """

        def _iter_content(chunk_size=None, *args, **kwargs):
            content = robj.content or b""
            if isinstance(content, str):
                content = content.encode("utf-8")
            return iter([content]) if content else iter([])

        return _iter_content

    def add(self, url, meta):
        """Adds a test suite to our object."""
        self.__tests.append(
            {
                "url": url,
                "meta": meta,
            }
        )

    def run_all(self, tmpdir=None):
        """Run all of our tests."""
        # iterate over our dictionary and test it out
        for url, meta in self.__tests:
            self.run(url, meta, tmpdir)

    @mock.patch("requests.get")
    @mock.patch("requests.post")
    @mock.patch("requests.request")
    def run(self, url, meta, tmpdir, mock_request, mock_post, mock_get):
        """Run a specific test."""

        if meta is False:
            # Prepare a default structure to make life easy
            meta = {
                "instance": TypeError,
            }

        # Our expected instance
        instance = meta.get("instance")

        # Our expected server objects
        self_ = meta.get("self")

        # Our expected privacy url
        # Don't set this if don't need to check it's value
        privacy_url = meta.get("privacy_url")

        # Our regular expression
        url_matches = meta.get("url_matches")

        # Detect our storage path (used to set persistent storage
        # mode
        storage_path = (
            tmpdir
            if tmpdir and isinstance(tmpdir, str) and os.path.isdir(tmpdir)
            else None
        )

        # Our storage mode to set
        storage_mode = meta.get(
            "storage_mode",
            (
                PersistentStoreMode.MEMORY
                if not storage_path
                else PersistentStoreMode.AUTO
            ),
        )

        # Debug Mode
        pdb = meta.get("pdb", False)

        # Whether or not we should include an image with our request; unless
        # otherwise specified, we assume that images are to be included
        include_image = meta.get("include_image", True)
        if include_image:
            # a default asset
            asset = AppriseAsset(
                storage_mode=storage_mode,
                storage_path=storage_path,
            )

        else:
            # Disable images
            asset = AppriseAsset(
                image_path_mask=False,
                image_url_mask=False,
                storage_mode=storage_mode,
                storage_path=storage_path,
            )
            asset.image_url_logo = None

        # Mock our request object
        robj = mock.Mock()
        robj.content = ""
        robj.iter_content = self.__iter_content(robj)
        mock_get.return_value = robj
        mock_post.return_value = robj
        mock_request.return_value = robj

        if pdb:
            # Makes it easier to debug with this peice of code
            # just add `pdb': True to the call that is failing
            import pdb

            pdb.set_trace()

        try:
            # We can now instantiate our object:
            obj = Apprise.instantiate(
                url, asset=asset, suppress_exceptions=False
            )

        except Exception as e:
            # Handle our exception
            if instance is None:
                raise e

            if not isinstance(e, instance):
                raise e

            # We're okay if we get here
            return

        if obj is None:
            if instance is not None:
                # We're done (assuming this is what we were
                # expecting)
                raise AssertionError()
            # We're done because we got the results we expected
            return

        if instance is None:
            # Expected None but didn't get it
            raise AssertionError()

        if not isinstance(obj, instance):
            raise AssertionError()

        if isinstance(obj, NotifyBase):
            # Ensure we are not performing any type of thorttling
            obj.request_rate_per_sec = 0

            # We loaded okay; now lets make sure we can reverse
            # this url
            assert isinstance(obj.url(), str) is True

            # Test that we support a url identifier
            url_id = obj.url_id()

            # It can be either disabled or a string; nothing else
            assert isinstance(url_id, str) or (
                url_id is None and obj.url_identifier is False
            )

            # Verify we can acquire a target count as an integer
            assert isinstance(len(obj), int)

            # Test url() with privacy=True
            assert isinstance(obj.url(privacy=True), str) is True

            # Some Simple Invalid Instance Testing
            assert instance.parse_url(None) is None
            assert instance.parse_url(object) is None
            assert instance.parse_url(42) is None

            # Assess that our privacy url is as expected
            if privacy_url and not obj.url(privacy=True).startswith(
                privacy_url
            ):
                raise AssertionError(
                    f"URL: {url} Privacy URL:"
                    f" '{obj.url(privacy=True)[: len(privacy_url)]}' !="
                    f" expected '{privacy_url}'"
                )

            # Assess that our URL matches a set regex
            if url_matches and not re.search(url_matches, obj.url()):
                raise AssertionError(
                    f"URL: {url} generated an reloadable "
                    f"url() of {obj.url()} that does not match "
                    f"'{url_matches}'"
                )

            # Instantiate the exact same object again using the URL
            # from the one that was already created properly
            obj_cmp = Apprise.instantiate(obj.url())

            if not isinstance(obj_cmp, NotifyBase):
                raise AssertionError(
                    f"URL: {url} generated an un-reloadable "
                    f"url() of {obj.url()}"
                )

            # Our new object should produce the same url identifier
            elif obj.url_identifier != obj_cmp.url_identifier:
                raise AssertionError(
                    f"URL: {url} URL Identifier: "
                    f"'{obj_cmp.url_identifier}' != expected"
                    f" '{obj.url_identifier}'"
                )

            # Back our check up
            if obj.url_id() != obj_cmp.url_id():
                raise AssertionError(
                    f"URL: {url} URL ID(): '{obj_cmp.url_id()}' != expected"
                    f" '{obj.url_id()}'"
                )

            # Verify there is no change from the old and the new
            if len(obj) != len(obj_cmp):
                raise AssertionError(
                    f"URL: {url} generated an reloadable "
                    f"url() of {obj.url()} produced target miscount "
                    f"{len(obj)} != {len(obj_cmp)}"
                )

            # Tidy our object
            del obj_cmp
            del instance

        if self_:
            # Iterate over our expected entries inside of our
            # object
            for key, val in self_.items():
                # Test that our object has the desired key
                assert hasattr(obj, key) is True
                assert getattr(obj, key) == val

        try:
            self.__notify(url, obj, meta, asset)

        except AssertionError:
            # Don't mess with these entries
            raise

        # Tidy our object and allow any possible defined destructors to
        # be executed.
        del obj

    @mock.patch("requests.get")
    @mock.patch("requests.post")
    @mock.patch("requests.head")
    @mock.patch("requests.put")
    @mock.patch("requests.delete")
    @mock.patch("requests.patch")
    @mock.patch("requests.request")
    def __notify(
        self,
        url,
        obj,
        meta,
        asset,
        mock_request,
        mock_patch,
        mock_del,
        mock_put,
        mock_head,
        mock_post,
        mock_get,
    ):
        """Perform notification testing against object specified."""
        #
        # Prepare our options
        #

        # Allow notification type override, otherwise default to INFO
        notify_type = meta.get("notify_type", NotifyType.INFO)

        # Whether or not we're testing exceptions or not
        test_requests_exceptions = meta.get("test_requests_exceptions", False)

        # Our expected Query response (True, False, or exception type)
        response = meta.get("response", True)

        # Our expected Notify response (True or False)
        notify_response = meta.get("notify_response", response)

        # Our expected Notify Attachment response (True or False)
        attach_response = meta.get("attach_response", notify_response)

        # Test attachments
        # Don't set this if don't need to check it's value
        check_attachments = meta.get("check_attachments", True)

        # Debug/Trace Monitoring
        force_debug = meta.get("force_debug", False)

        # Allow us to force the server response code to be something other then
        # the defaults
        requests_response_code = meta.get(
            "requests_response_code",
            requests.codes.ok if response else requests.codes.not_found,
        )

        # Allow us to force the server response text to be something other then
        # the defaults
        requests_response_text = meta.get("requests_response_text")
        requests_response_content = None

        if isinstance(requests_response_text, str):
            requests_response_content = requests_response_text.encode("utf-8")

        elif isinstance(requests_response_text, bytes):
            requests_response_content = requests_response_text
            requests_response_text = requests_response_text.decode("utf-8")

        elif not isinstance(requests_response_text, str):
            # Convert to string
            requests_response_text = dumps(requests_response_text)
            requests_response_content = requests_response_text.encode("utf-8")

        else:
            requests_response_content = ""
            requests_response_text = ""

        # A request
        robj = mock.Mock()
        robj.content = ""
        robj.text = ""
        robj.iter_content = self.__iter_content(robj)
        mock_get.return_value = robj
        mock_post.return_value = robj
        mock_head.return_value = robj
        mock_patch.return_value = robj
        mock_del.return_value = robj
        mock_put.return_value = robj
        mock_request.return_value = robj

        if test_requests_exceptions is False:
            # Handle our default response
            mock_put.return_value.status_code = requests_response_code
            mock_head.return_value.status_code = requests_response_code
            mock_del.return_value.status_code = requests_response_code
            mock_post.return_value.status_code = requests_response_code
            mock_get.return_value.status_code = requests_response_code
            mock_patch.return_value.status_code = requests_response_code
            mock_request.return_value.status_code = requests_response_code

            # Handle our default text response
            mock_get.return_value.content = requests_response_content
            mock_post.return_value.content = requests_response_content
            mock_del.return_value.content = requests_response_content
            mock_put.return_value.content = requests_response_content
            mock_head.return_value.content = requests_response_content
            mock_patch.return_value.content = requests_response_content
            mock_request.return_value.content = requests_response_content

            mock_get.return_value.text = requests_response_text
            mock_post.return_value.text = requests_response_text
            mock_put.return_value.text = requests_response_text
            mock_del.return_value.text = requests_response_text
            mock_head.return_value.text = requests_response_text
            mock_patch.return_value.text = requests_response_text
            mock_request.return_value.text = requests_response_text

            # Ensure there is no side effect set
            mock_post.side_effect = None
            mock_del.side_effect = None
            mock_put.side_effect = None
            mock_head.side_effect = None
            mock_get.side_effect = None
            mock_patch.side_effect = None
            mock_request.side_effect = None

        else:
            # Handle exception testing; first we turn the boolean flag
            # into a list of exceptions
            test_requests_exceptions = self.req_exceptions

        try:
            if test_requests_exceptions is False:
                # Verify we can acquire a target count as an integer
                targets = len(obj)

                # check that we're as expected
                resp = obj.notify(
                    body=self.body, title=self.title, notify_type=notify_type
                )
                if resp != notify_response:
                    raise AssertionError(
                        f"notify() call; notify_response={resp} "
                        f"(expected {notify_response}) on {url}"
                    )

                if notify_response:
                    # If we successfully got a response, there must have been
                    # at least 1 target present
                    assert targets > 0

                # check that this doesn't change using different overflow
                # methods
                assert (
                    obj.notify(
                        body=self.body,
                        title=self.title,
                        notify_type=notify_type,
                        overflow=OverflowMode.UPSTREAM,
                    )
                    == notify_response
                )
                assert (
                    obj.notify(
                        body=self.body,
                        title=self.title,
                        notify_type=notify_type,
                        overflow=OverflowMode.TRUNCATE,
                    )
                    == notify_response
                )
                assert (
                    obj.notify(
                        body=self.body,
                        title=self.title,
                        notify_type=notify_type,
                        overflow=OverflowMode.SPLIT,
                    )
                    == notify_response
                )

                #
                # Handle varations of the Asset Object missing fields
                #

                # First make a backup
                app_id = asset.app_id
                app_desc = asset.app_desc

                # now clear records
                asset.app_id = None
                asset.app_desc = None

                # Notify should still work
                assert (
                    obj.notify(
                        body=self.body,
                        title=self.title,
                        notify_type=notify_type,
                    )
                    == notify_response
                )

                # App ID only
                asset.app_id = app_id
                asset.app_desc = None

                # Notify should still work
                assert (
                    obj.notify(
                        body=self.body,
                        title=self.title,
                        notify_type=notify_type,
                    )
                    == notify_response
                )

                # App Desc only
                asset.app_id = None
                asset.app_desc = app_desc

                if force_debug:
                    # Enable access to areas otherwise locked away by the log
                    # level
                    original_is_enabled_for = obj.logger.isEnabledFor
                    original_debug = obj.logger.debug
                    try:
                        # Force code paths guarded by isEnabledFor(DEBUG)
                        obj.logger.isEnabledFor = mock.Mock(return_value=True)

                        # Prevent actual logging emission (avoids pytest
                        # capture closed stream)
                        obj.logger.debug = mock.Mock()

                        assert (
                            obj.notify(
                                body=self.body,
                                title=self.title,
                                notify_type=notify_type,
                            )
                            == notify_response
                        )

                    finally:
                        # Restore
                        obj.logger.isEnabledFor = original_is_enabled_for
                        obj.logger.debug = original_debug
                else:
                    assert (
                        obj.notify(
                            body=self.body,
                            title=self.title,
                            notify_type=notify_type,
                        )
                        == notify_response
                    )

                # Restore
                asset.app_id = app_id
                asset.app_desc = app_desc

                if check_attachments:
                    # Test single attachment support; even if the service
                    # doesn't support attachments, it should still
                    # gracefully ignore the data
                    attach = os.path.join(
                        self.__test_var_dir, "apprise-test.gif"
                    )
                    assert (
                        obj.notify(
                            body=self.body,
                            title=self.title,
                            notify_type=notify_type,
                            attach=attach,
                        )
                        == attach_response
                    )

                    # Same results should apply to a list of attachments
                    attach = AppriseAttachment(
                        (
                            os.path.join(
                                self.__test_var_dir, "apprise-test.gif"
                            ),
                            os.path.join(
                                self.__test_var_dir, "apprise-test.png"
                            ),
                            os.path.join(
                                self.__test_var_dir, "apprise-test.jpeg"
                            ),
                        )
                    )

                    assert (
                        obj.notify(
                            body=self.body,
                            title=self.title,
                            notify_type=notify_type,
                            attach=attach,
                        )
                        == attach_response
                    )

                    if obj.attachment_support:
                        #
                        # Services that support attachments should support
                        # sending a attachment (or more) without a body or
                        # title specified:
                        #
                        assert (
                            obj.notify(
                                body=None,
                                title=None,
                                notify_type=notify_type,
                                attach=attach,
                            )
                            == attach_response
                        )

                        # Turn off attachment support on the notifications
                        # that support it so we can test that any logic we
                        # have ot test against this flag is ran
                        obj.attachment_support = False

                        #
                        # Notifications should still transmit as normal if
                        # Attachment support is flipped off
                        #
                        assert (
                            obj.notify(
                                body=self.body,
                                title=self.title,
                                notify_type=notify_type,
                                attach=attach,
                            )
                            == notify_response
                        )

                        #
                        # We should not be able to send a message without a
                        # body or title in this circumstance
                        #
                        assert (
                            obj.notify(
                                body=None,
                                title=None,
                                notify_type=notify_type,
                                attach=attach,
                            )
                            is False
                        )

                        # Toggle Back
                        obj.attachment_support = True

                    else:  # No Attachment support
                        #
                        # We should not be able to send a message without a
                        # body or title in this circumstance
                        #
                        assert (
                            obj.notify(
                                body=None,
                                title=None,
                                notify_type=notify_type,
                                attach=attach,
                            )
                            is False
                        )
            else:
                for exception in self.req_exceptions:
                    mock_post.side_effect = exception
                    mock_head.side_effect = exception
                    mock_del.side_effect = exception
                    mock_put.side_effect = exception
                    mock_get.side_effect = exception
                    mock_patch.side_effect = exception
                    mock_request.side_effect = exception

                    try:
                        assert (
                            obj.notify(
                                body=self.body,
                                title=self.title,
                                notify_type=notify_type,
                            )
                            is False
                        )

                    except AssertionError:
                        # Don't mess with these entries
                        raise

                    except Exception:
                        # We can't handle this exception type
                        raise

        except AssertionError:
            # Don't mess with these entries
            raise

        except Exception as e:
            # Check that we were expecting this exception to happen
            try:
                if not isinstance(e, response):
                    raise e

            except TypeError:
                raise e  # noqa: B904 - intentional re-raising in test helper

        #
        # Do the test again but without a title defined
        #
        try:
            if test_requests_exceptions is False:
                # check that we're as expected
                assert (
                    obj.notify(body="body", notify_type=notify_type)
                    == notify_response
                )

            else:
                for exception in self.req_exceptions:
                    mock_post.side_effect = exception
                    mock_del.side_effect = exception
                    mock_put.side_effect = exception
                    mock_head.side_effect = exception
                    mock_get.side_effect = exception
                    mock_patch.side_effect = exception
                    mock_request.side_effect = exception

                    try:
                        assert (
                            obj.notify(body=self.body, notify_type=notify_type)
                            is False
                        )

                    except AssertionError:
                        # Don't mess with these entries
                        raise

                    except Exception:
                        # We can't handle this exception type
                        raise

        except AssertionError:
            # Don't mess with these entries
            raise

        except Exception as e:
            # Check that we were expecting this exception to happen
            if not isinstance(e, response):
                raise e

        return True
caronc-apprise-dfec414/tests/test_api.py000066400000000000000000003263711526720371000204570ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import asyncio
import concurrent.futures
import inspect
from inspect import cleandoc

# Disable logging for a cleaner testing output
import logging
from os.path import dirname, join
import re
import sys
from typing import ClassVar
from unittest import mock

from helpers import OuterEventLoop
import pytest
import requests

from apprise import (
    LOGGER_NAME,
    NOTIFY_FORMATS,
    Apprise,
    AppriseAsset,
    AppriseAttachment,
    AppriseResultStatus,
    NotificationManager,
    NotifyBase,
    NotifyFormat,
    NotifyImageSize,
    NotifyType,
    PersistentStoreMode,
    PrivacyMode,
    URLBase,
    __version__,
    plugins,
)
from apprise.locale import LazyTranslation, gettext_lazy as _
from apprise.plugins.base import RequirementsSpec
from apprise.utils.parse import parse_list

logging.disable(logging.CRITICAL)

# Attachment Directory
TEST_VAR_DIR = join(dirname(__file__), "var")

# Grant access to our Notification Manager Singleton
N_MGR = NotificationManager()


def test_apprise_object():
    """
    API: Apprise() object

    """

    def do_notify(service, *args, **kwargs):
        return service.notify(*args, **kwargs)

    apprise_test(do_notify)


def test_apprise_async():
    """
    API: Apprise() object asynchronous methods

    """
    with OuterEventLoop() as loop:

        def do_notify(service, *args, **kwargs):
            return loop.run_until_complete(
                service.async_notify(*args, **kwargs)
            )

        apprise_test(do_notify)


def apprise_test(do_notify):
    """Exercise the core Apprise container and notification behavior."""
    a = Apprise()

    # no items
    assert len(a) == 0

    # Apprise object can also be directly tested with 'if' keyword
    # No entries results in a False response
    assert not a

    # Create an Asset object
    asset = AppriseAsset(theme="default")

    # We can load the device using our asset
    a = Apprise(asset=asset)

    # We can load our services up front as well
    services = [
        "json://myhost",
        "kodi://kodi.server.local",
    ]

    a = Apprise(services=services)

    # 2 services loaded
    assert len(a) == 2

    # Apprise object can also be directly tested with 'if' keyword
    # At least one entry results in a True response
    assert a

    # We can retrieve our URLs this way:
    assert len(a.urls()) == 2

    # We can add another service
    assert (
        a.add(
            "mmosts://mattermost.server.local/3ccdd113474722377935511fc85d3dd4"
        )
        is True
    )
    assert len(a) == 3

    # Try adding nothing but delimiters
    assert a.add(",, ,, , , , ,") is False

    # The number of services added doesn't change
    assert len(a) == 3

    # We can pop an object off of our stack by it's indexed value:
    obj = a.pop(0)
    assert isinstance(obj, NotifyBase) is True
    assert len(a) == 2

    # We can retrieve elements from our list too by reference:
    assert isinstance(a[0].url(), str) is True

    # We can iterate over our list too:
    count = 0
    for o in a:
        assert isinstance(o.url(), str) is True
        count += 1
    # verify that we did indeed iterate over each element
    assert len(a) == count

    # We can empty our set
    a.clear()
    assert len(a) == 0

    # An invalid schema
    assert a.add("this is not a parseable url at all") is False
    assert len(a) == 0

    # An unsupported schema
    assert a.add("invalid://we.just.do.not.support.this.plugin.type") is False
    assert len(a) == 0

    # A poorly formatted URL
    assert a.add("json://user:@@@:bad?no.good") is False
    assert len(a) == 0

    # Add a service with our asset we created earlier
    assert (
        a.add(
            "mmosts://mattermost.server.local/"
            "3ccdd113474722377935511fc85d3dd4",
            asset=asset,
        )
        is True
    )

    # Clear our service listings again
    a.clear()
    assert len(a) == 0

    # No services to notify
    assert bool(do_notify(a, title="my title", body="my body")) is False

    # More Variations of Multiple Adding of URLs
    a = Apprise()
    assert a.add(services)
    assert len(a) == 2
    a.clear()

    assert a.add("ntfys://user:pass@host/test, json://localhost")
    assert len(a) == 2
    a.clear()

    assert a.add(["ntfys://user:pass@host/test", "json://localhost"])
    assert len(a) == 2
    a.clear()

    assert a.add(("ntfys://user:pass@host/test", "json://localhost"))
    assert len(a) == 2
    a.clear()

    assert a.add({"ntfys://user:pass@host/test", "json://localhost"})
    assert len(a) == 2
    a.clear()

    # Pass a list entry containing 1 string with 2 elements in it
    # Mimic Home-Assistant core-2024.2.1 Issue:
    #   - https://github.com/home-assistant/core/issues/110242
    #
    # In this case, the first one will load, but not the second entry
    # This is by design; but captured here to illustrate the issue
    assert a.add(["ntfys://user:pass@host/test, json://localhost"])
    assert len(a) == 1
    assert a[0].url().startswith("ntfys://")
    a.clear()

    # Following thorugh with the problem of providing a list containing
    # an entry with 2 URLs in it... while the ntfys parsed okay above,
    # the same can't be said for other combinations.  It's important
    # to always keep strings separately
    assert a.add(["mailto://user:pass@example.com, json://localhost"]) is False
    assert len(a) == 0

    # Showing that the URLs were valid on their own:
    assert a.add(*["mailto://user:pass@example.com, json://localhost"])
    assert len(a) == 2
    assert a[0].url().startswith("mailto://")
    assert a[1].url().startswith("json://")
    a.clear()

    class BadNotification(NotifyBase):
        def __init__(self, **kwargs):
            super().__init__(**kwargs)

            # We fail whenever we're initialized
            raise TypeError()

        @staticmethod
        def parse_url(url, *args, **kwargs):
            # always parseable
            return NotifyBase.parse_url(url, verify_host=False)

    class GoodNotification(NotifyBase):
        def __init__(self, **kwargs):
            super().__init__(notify_format=NotifyFormat.HTML, **kwargs)

        def send(self, **kwargs):
            # Pretend everything is okay
            return True

        @staticmethod
        def parse_url(url, *args, **kwargs):
            # always parseable
            return NotifyBase.parse_url(url, verify_host=False)

    # Store our bad notification in our schema map
    N_MGR["bad"] = BadNotification

    # Store our good notification in our schema map
    N_MGR["good"] = GoodNotification

    # Just to explain what is happening here, we would have parsed the
    # url properly but failed when we went to go and create an instance
    # of it.
    assert a.add("bad://localhost") is False
    assert len(a) == 0

    # We'll fail because we've got nothing to notify
    assert bool(do_notify(a, title="my title", body="my body")) is False

    # Clear our service listings again
    a.clear()

    assert a.add("good://localhost") is True
    assert len(a) == 1

    # Bad Notification Types are not accepted
    assert (
        bool(do_notify(a, title="my title", body="my body", notify_type="bad"))
        is False
    )

    # Notifications of string type are accepted
    assert (
        bool(
            do_notify(
                a, title="my title", body="my body", notify_type="warning"
            )
        )
        is True
    )

    # Notifications of string type are accepted
    assert (
        bool(
            do_notify(
                a, title="my title", body="my body", notify_type="warning"
            )
        )
        is True
    )

    # Notifications of string type are accepted
    assert (
        bool(
            do_notify(
                a, title="my title", body="my body", notify_type="warning"
            )
        )
        is True
    )

    # Notifications where notify_type is of the NotifyType object is the
    # preferred choice
    assert (
        bool(
            do_notify(
                a,
                title="my title",
                body="my body",
                notify_type=NotifyType.WARNING,
            )
        )
        is True
    )

    # No Title/Body combo's
    assert bool(do_notify(a, title=None, body=None)) is False
    assert bool(do_notify(a, title="", body=None)) is False
    assert bool(do_notify(a, title=None, body="")) is False

    assert bool(do_notify(a, title=5, body=b"bytes")) is False
    assert bool(do_notify(a, title=b"bytes", body=10)) is False
    assert bool(do_notify(a, title=object(), body=b"bytes")) is False
    assert bool(do_notify(a, title=b"bytes", body=object())) is False

    # A Body must be present
    assert bool(do_notify(a, title="present", body=None)) is False

    # Other combinations work fine
    assert bool(do_notify(a, title=None, body="present")) is True
    assert bool(do_notify(a, title="present", body="present")) is True

    # Send Attachment with success
    attach = join(TEST_VAR_DIR, "apprise-test.gif")
    assert (
        bool(
            do_notify(
                a,
                body="body",
                title="test",
                notify_type=NotifyType.INFO,
                attach=attach,
            )
        )
        is True
    )

    # Send the attachment as an AppriseAttachment object
    assert (
        bool(
            do_notify(
                a,
                body="body",
                title="test",
                notify_type=NotifyType.INFO,
                attach=AppriseAttachment(attach),
            )
        )
        is True
    )

    # test a invalid attachment
    assert (
        bool(
            do_notify(
                a,
                body="body",
                title="test",
                notify_type=NotifyType.INFO,
                attach="invalid://",
            )
        )
        is False
    )

    # Repeat the same tests above...
    # however do it by directly accessing the object; this grants the similar
    # results:
    assert (
        bool(
            do_notify(
                a[0],
                body="body",
                title="test",
                notify_type=NotifyType.INFO,
                attach=attach,
            )
        )
        is True
    )

    # Send the attachment as an AppriseAttachment object
    assert (
        bool(
            do_notify(
                a[0],
                body="body",
                title="test",
                notify_type=NotifyType.INFO,
                attach=AppriseAttachment(attach),
            )
        )
        is True
    )

    # test a invalid attachment
    assert (
        bool(
            do_notify(
                a[0],
                body="body",
                title="test",
                notify_type=NotifyType.INFO,
                attach="invalid://",
            )
        )
        is False
    )

    class ThrowNotification(NotifyBase):
        def notify(self, **kwargs):
            # Pretend everything is okay
            raise TypeError()

        async def async_notify(self, **kwargs):
            # Pretend everything is okay (async)
            raise TypeError()

    class RuntimeNotification(NotifyBase):
        def notify(self, **kwargs):
            # Pretend everything is okay
            raise RuntimeError()

        async def async_notify(self, **kwargs):
            # Pretend everything is okay (async)
            raise TypeError()

    class FailNotification(NotifyBase):
        def notify(self, **kwargs):
            # Pretend everything is okay
            return False

        async def async_notify(self, **kwargs):
            # Pretend everything is okay (async)
            raise TypeError()

    # Store our bad notification in our schema map
    N_MGR["throw"] = ThrowNotification

    # Store our good notification in our schema map
    N_MGR["fail"] = FailNotification

    # Store our good notification in our schema map
    N_MGR["runtime"] = RuntimeNotification

    for async_mode in (True, False):
        # Create an Asset object
        asset = AppriseAsset(theme="default", async_mode=async_mode)

        # We can load the device using our asset
        a = Apprise(asset=asset)

        assert a.add("runtime://localhost") is True
        assert a.add("throw://localhost") is True
        assert a.add("fail://localhost") is True
        assert len(a) == 3

        # Test when our notify both throws an exception and or just
        # simply returns False
        assert bool(do_notify(a, title="present", body="present")) is False

    # Create a Notification that throws an unexected exception
    class ThrowInstantiateNotification(NotifyBase):
        def __init__(self, **kwargs):
            # Pretend everything is okay
            raise TypeError()

    N_MGR.unload_modules()
    N_MGR["throw"] = ThrowInstantiateNotification

    # Store our good notification in our schema map
    N_MGR["good"] = GoodNotification

    # Reset our object
    a.clear()
    assert len(a) == 0

    # Test our socket details
    # rto = Socket Read Timeout
    # cto = Socket Connect Timeout
    plugin = a.instantiate("good://localhost?rto=5.1&cto=10")
    assert isinstance(plugin, NotifyBase)
    assert plugin.socket_connect_timeout == pytest.approx(10.0)
    assert plugin.socket_read_timeout == pytest.approx(5.1)

    plugin = a.instantiate("good://localhost?rto=invalid&cto=invalid")
    assert isinstance(plugin, NotifyBase)
    assert plugin.socket_connect_timeout == URLBase.socket_connect_timeout
    assert plugin.socket_read_timeout == URLBase.socket_read_timeout

    # Reset our object
    a.clear()
    assert len(a) == 0

    with pytest.raises(ValueError):
        # Encoding error
        AppriseAsset(encoding="ascii", storage_salt="ボールト")

    with pytest.raises(ValueError):
        # Not a valid storage salt (must be str or bytes)
        AppriseAsset(storage_salt=42)

    # Set our cache to be off
    plugin = a.instantiate("good://localhost?store=no", asset=asset)
    assert isinstance(plugin, NotifyBase)
    # The identifier still works; turning storage off only stops anything
    # being written to disk for it
    assert plugin.url_id(lazy=False)
    assert plugin.store.mode is PersistentStoreMode.MEMORY
    # Verify our cache is disabled
    assert "store=no" in plugin.url()

    with pytest.raises(ValueError):
        # idlen must be greater then 0
        AppriseAsset(storage_idlen=-1)

    # Create a larger idlen
    asset = AppriseAsset(storage_idlen=32)
    plugin = a.instantiate("good://localhost", asset=asset)
    assert len(plugin.url_id()) == 32

    # Instantiate a bad object
    plugin = a.instantiate(object, tag="bad_object")
    assert plugin is None

    # Instantiate a good object
    plugin = a.instantiate("good://localhost", tag="good")
    assert isinstance(plugin, NotifyBase)

    # Test simple tagging inside of the object
    assert "good" in plugin
    assert "bad" not in plugin

    # the in (__contains__ override) is based on or'ed content; so although
    # 'bad' isn't tagged as being in the plugin, 'good' is, so the return
    # value of this is True
    assert ["bad", "good"] in plugin
    assert {"bad", "good"} in plugin
    assert ("bad", "good") in plugin

    # We an add already substatiated instances into our Apprise object
    a.add(plugin)
    assert len(a) == 1

    # We can add entries as a list too (to add more then one)
    a.add([plugin, plugin, plugin])
    assert len(a) == 4

    # Reset our object again
    a.clear()
    with pytest.raises(TypeError):
        a.instantiate("throw://localhost", suppress_exceptions=False)

    assert len(a) == 0

    assert a.instantiate("throw://localhost", suppress_exceptions=True) is None
    assert len(a) == 0

    #
    # We rince and repeat the same tests as above, however we do them
    # using the dict version
    #

    # Reset our object
    a.clear()
    assert len(a) == 0

    # Instantiate a good object
    plugin = a.instantiate({"schema": "good", "host": "localhost"}, tag="good")
    assert isinstance(plugin, NotifyBase)

    # Test simple tagging inside of the object
    assert "good" in plugin
    assert "bad" not in plugin

    # the in (__contains__ override) is based on or'ed content; so although
    # 'bad' isn't tagged as being in the plugin, 'good' is, so the return
    # value of this is True
    assert ["bad", "good"] in plugin
    assert {"bad", "good"} in plugin
    assert ("bad", "good") in plugin

    # We an add already substatiated instances into our Apprise object
    a.add(plugin)
    assert len(a) == 1

    # We can add entries as a list too (to add more then one)
    a.add([plugin, plugin, plugin])
    assert len(a) == 4

    # Reset our object again
    a.clear()
    with pytest.raises(TypeError):
        a.instantiate(
            {"schema": "throw", "host": "localhost"}, suppress_exceptions=False
        )

    assert len(a) == 0

    assert (
        a.instantiate(
            {"schema": "throw", "host": "localhost"}, suppress_exceptions=True
        )
        is None
    )
    assert len(a) == 0


def test_apprise_pretty_print():
    """
    API: Apprise() Pretty Print tests

    """
    # Privacy Print
    # PrivacyMode.Secret always returns the same thing to avoid guessing
    assert (
        URLBase.pprint(None, privacy=True, mode=PrivacyMode.Secret) == "****"
    )
    assert URLBase.pprint(42, privacy=True, mode=PrivacyMode.Secret) == "****"
    assert (
        URLBase.pprint(object, privacy=True, mode=PrivacyMode.Secret) == "****"
    )
    assert URLBase.pprint("", privacy=True, mode=PrivacyMode.Secret) == "****"
    assert URLBase.pprint("a", privacy=True, mode=PrivacyMode.Secret) == "****"
    assert (
        URLBase.pprint("ab", privacy=True, mode=PrivacyMode.Secret) == "****"
    )
    assert (
        URLBase.pprint("abcdefghijk", privacy=True, mode=PrivacyMode.Secret)
        == "****"
    )

    # PrivacyMode.Outer
    assert URLBase.pprint(None, privacy=True, mode=PrivacyMode.Outer) == ""
    assert URLBase.pprint(42, privacy=True, mode=PrivacyMode.Outer) == ""
    assert URLBase.pprint(object, privacy=True, mode=PrivacyMode.Outer) == ""
    assert URLBase.pprint("", privacy=True, mode=PrivacyMode.Outer) == ""
    assert URLBase.pprint("a", privacy=True, mode=PrivacyMode.Outer) == "a...a"
    assert (
        URLBase.pprint("ab", privacy=True, mode=PrivacyMode.Outer) == "a...b"
    )
    assert (
        URLBase.pprint("abcdefghijk", privacy=True, mode=PrivacyMode.Outer)
        == "a...k"
    )

    # PrivacyMode.Tail
    assert URLBase.pprint(None, privacy=True, mode=PrivacyMode.Tail) == ""
    assert URLBase.pprint(42, privacy=True, mode=PrivacyMode.Tail) == ""
    assert URLBase.pprint(object, privacy=True, mode=PrivacyMode.Tail) == ""
    assert URLBase.pprint("", privacy=True, mode=PrivacyMode.Tail) == ""
    assert URLBase.pprint("a", privacy=True, mode=PrivacyMode.Tail) == "...a"
    assert URLBase.pprint("ab", privacy=True, mode=PrivacyMode.Tail) == "...ab"
    assert (
        URLBase.pprint("abcdefghijk", privacy=True, mode=PrivacyMode.Tail)
        == "...hijk"
    )

    # Quoting settings
    assert URLBase.pprint(" ", privacy=False, safe="") == "%20"
    assert URLBase.pprint(" ", privacy=False, quote=False, safe="") == " "


@mock.patch("requests.request")
def test_apprise_tagging(mock_request):
    """
    API: Apprise() object tagging functionality

    """

    def do_notify(service, *args, **kwargs):
        return service.notify(*args, **kwargs)

    apprise_tagging_test(mock_request, do_notify)


@mock.patch("requests.request")
def test_apprise_tagging_async(mock_request):
    """
    API: Apprise() object tagging functionality asynchronous methods

    """
    with OuterEventLoop() as loop:

        def do_notify(service, *args, **kwargs):
            return loop.run_until_complete(
                service.async_notify(*args, **kwargs)
            )

        apprise_tagging_test(mock_request, do_notify)


def apprise_tagging_test(mock_request, do_notify):
    """Exercise tag filtering and grouped notification behavior."""
    # A request
    robj = mock.Mock()
    robj.raw = mock.Mock()
    # Allow raw.read() calls
    robj.raw.read.return_value = ""
    robj.text = ""
    robj.content = ""
    mock_request.return_value = robj

    # Simulate a successful notification
    mock_request.return_value.status_code = requests.codes.ok

    # Create our object
    a = Apprise()

    # An invalid addition can't add the tag
    assert a.add("averyinvalidschema://localhost", tag="uhoh") is False
    assert (
        a.add(
            {"schema": "averyinvalidschema", "host": "localhost"}, tag="uhoh"
        )
        is False
    )

    # Add entry and assign it to a tag called 'awesome'
    assert a.add("json://localhost/path1/", tag="awesome") is True
    assert (
        a.add(
            {"schema": "json", "host": "localhost", "fullpath": "/path1/"},
            tag="awesome",
        )
        is True
    )

    # Add another notification and assign it to a tag called 'awesome'
    # and another tag called 'local'
    assert a.add("json://localhost/path2/", tag=["mmost", "awesome"]) is True

    # notify the awesome tag; this would notify both services behind the
    # scenes
    assert (
        bool(do_notify(a, title="my title", body="my body", tag="awesome"))
        is True
    )

    # notify all of the tags
    assert (
        bool(
            do_notify(
                a, title="my title", body="my body", tag=["awesome", "mmost"]
            )
        )
        is True
    )

    # When we query against our loaded notifications for a tag that simply
    # isn't assigned to anything, we return NOMATCH.  NOMATCH (different
    # then FAILURE) tells us that we litterally had nothing to query.  We
    # didn't fail... but we also didn't do anything...
    assert (
        do_notify(a, title="my title", body="my body", tag="missing").status
        == AppriseResultStatus.NOMATCH
    )

    # Now to test the ability to and and/or notifications
    a = Apprise()

    # Add a tag by tuple
    assert a.add("json://localhost/tagA/", tag=("TagA",)) is True
    # Add 2 tags by string
    assert a.add("json://localhost/tagAB/", tag="TagA, TagB") is True
    # Add a tag using a set
    assert a.add("json://localhost/tagB/", tag={"TagB"}) is True
    # Add a tag by string (again)
    assert a.add("json://localhost/tagC/", tag="TagC") is True
    # Add 2 tags using a list
    assert a.add("json://localhost/tagCD/", tag=["TagC", "TagD"]) is True
    # Add a tag by string (again)
    assert a.add("json://localhost/tagD/", tag="TagD") is True
    # add a tag set by set (again)
    assert (
        a.add("json://localhost/tagCDE/", tag={"TagC", "TagD", "TagE"}) is True
    )

    # Expression: TagC and TagD
    # Matches the following only:
    #   - json://localhost/tagCD/
    #   - json://localhost/tagCDE/
    assert (
        bool(
            do_notify(
                a,
                title="my title",
                body="my body",
                tag=[("TagC", "TagD")],
            )
        )
        is True
    )

    # Expression: (TagY and TagZ) or TagX
    # Matches nothing, NOMATCH is returned in this case
    assert (
        do_notify(
            a, title="my title", body="my body", tag=[("TagY", "TagZ"), "TagX"]
        ).status
        == AppriseResultStatus.NOMATCH
    )

    # Expression: (TagY and TagZ) or TagA
    # Matches the following only:
    #   - json://localhost/tagAB/
    assert (
        bool(
            do_notify(
                a,
                title="my title",
                body="my body",
                tag=[("TagY", "TagZ"), "TagA"],
            )
        )
        is True
    )

    # Expression: (TagE and TagD) or TagB
    # Matches the following only:
    #   - json://localhost/tagCDE/
    #   - json://localhost/tagAB/
    #   - json://localhost/tagB/
    assert (
        bool(
            do_notify(
                a,
                title="my title",
                body="my body",
                tag=[("TagE", "TagD"), "TagB"],
            )
        )
        is True
    )

    # Garbage Entries in tag field just get stripped out. the below
    # is the same as notifying no tags at all. Since we have not added
    # any entries that do not have tags (that we can match against)
    # we fail.  NOMATCH is returned as a way of letting us know that we
    # had Notifications to notify, but since none of them matched our tag
    # none were notified.
    assert (
        do_notify(
            a,
            title="my title",
            body="my body",
            tag=[
                (object,),
            ],
        ).status
        == AppriseResultStatus.NOMATCH
    )


def test_apprise_schemas():
    """
    API: Apprise().schema() tests

    """
    # Clear loaded modules
    a = Apprise()

    # no items
    assert len(a) == 0

    class TextNotification(NotifyBase):
        # set our default notification format
        notify_format = NotifyFormat.TEXT

        # Garbage Protocol Entries
        protocol = None

        secure_protocol = (None, object)

    class HtmlNotification(NotifyBase):
        protocol = ("html", "htm")

        secure_protocol = ("htmls", "htms")

    class MarkDownNotification(NotifyBase):
        protocol = "markdown"

        secure_protocol = "markdowns"

    schemas = URLBase.schemas(TextNotification)
    assert isinstance(schemas, set) is True
    # We didn't define a protocol or secure protocol
    assert len(schemas) == 0

    # Store our notifications into our schema map
    N_MGR["text"] = TextNotification
    N_MGR["html"] = HtmlNotification
    N_MGR["markdown"] = MarkDownNotification

    schemas = URLBase.schemas(TextNotification)
    assert isinstance(schemas, set) is True
    # We didn't define a protocol or secure protocol one
    # but one got assigned in he above N_MGR call
    assert len(schemas) == 1
    assert "text" in schemas

    schemas = URLBase.schemas(HtmlNotification)
    assert isinstance(schemas, set) is True
    assert len(schemas) == 4
    assert "html" in schemas
    assert "htm" in schemas
    assert "htmls" in schemas
    assert "htms" in schemas

    # Invalid entries do not disrupt schema calls
    for garbage in (object(), None, 42):
        schemas = URLBase.schemas(garbage)
        assert isinstance(schemas, set) is True
        assert len(schemas) == 0


def test_apprise_urlbase_object():
    """
    API: Apprise() URLBase object testing

    """
    results = URLBase.parse_url("https://localhost/path/?cto=3.0&verify=no")
    assert results.get("user") is None
    assert results.get("password") is None
    assert results.get("path") == "/path/"
    assert results.get("secure") is True
    assert results.get("verify") is False
    base = URLBase(**results)
    assert base.request_timeout == (3.0, 4.0)
    assert base.request_auth is None
    assert base.request_url == "https://localhost/path/"
    assert base.url().startswith("https://localhost/")

    results = URLBase.parse_url(
        "http://user:pass@localhost:34/path/here?rto=3.0&verify=yes"
    )
    assert results.get("user") == "user"
    assert results.get("password") == "pass"
    assert results.get("fullpath") == "/path/here"
    assert results.get("secure") is False
    assert results.get("verify") is True
    base = URLBase(**results)
    assert base.request_timeout == (4.0, 3.0)
    assert base.request_auth == ("user", "pass")
    assert base.request_url == "http://localhost:34/path/here"
    assert base.url().startswith("http://user:pass@localhost:34/path/here")

    results = URLBase.parse_url("http://user@127.0.0.1/path/")
    assert results.get("user") == "user"
    assert results.get("password") is None
    assert results.get("fullpath") == "/path/"
    assert results.get("secure") is False
    assert results.get("verify") is True
    base = URLBase(**results)
    assert base.request_timeout == (4.0, 4.0)
    assert base.request_auth == ("user", None)
    assert base.request_url == "http://127.0.0.1/path/"
    assert base.url().startswith("http://user@127.0.0.1/path/")

    # redirect= defaults to True (follows redirects, matching requests default)
    results = URLBase.parse_url("https://localhost/path/?redirect=yes")
    assert results.get("redirect") is True
    base = URLBase(**results)
    assert base.redirects is True
    # redirect=yes is the default, so it must not appear in url() output
    assert "redirect" not in base.url()

    # redirect=no disables redirect following and round-trips in the URL
    results = URLBase.parse_url(
        "http://user:pass@localhost:34/path/here?redirect=no"
    )
    assert results.get("redirect") is False
    base = URLBase(**results)
    assert base.redirects is False
    assert "redirect=no" in base.url()

    # redirect is absent from results when not specified -- URLBase inherits
    # the global default from the asset (default asset has http_redirects=True)
    results = URLBase.parse_url("http://user@127.0.0.1/path/")
    assert "redirect" not in results
    base = URLBase(**results)
    assert base.redirects is True
    assert "redirect" not in base.url()

    # AppriseAsset(http_redirects=False) flows through to every plugin when the
    # URL does not specify redirect=
    from apprise import AppriseAsset

    asset_no_redirect = AppriseAsset(http_redirects=False)
    results = URLBase.parse_url("http://user@127.0.0.1/path/")
    assert "redirect" not in results
    base = URLBase(**results, asset=asset_no_redirect)
    assert base.redirects is False  # inherited the asset global
    # redirects matches the asset default -- no override to serialise
    assert "redirect" not in base.url()

    # URL-level redirect=yes overrides asset http_redirects=False; the
    # override must be preserved in url() so the round-trip is idempotent
    results = URLBase.parse_url("http://user@127.0.0.1/path/?redirect=yes")
    assert results.get("redirect") is True
    base = URLBase(**results, asset=asset_no_redirect)
    assert base.redirects is True  # URL wins over asset
    assert "redirect=yes" in base.url()  # differs from asset default, emitted

    # YAML config path: redirect= provided in the results dict directly
    # (not via qsd) -- exercises the elif "redirect" in results branch in
    # post_process_parse_url_results()
    results = URLBase.parse_url("http://user@127.0.0.1/path/")
    assert "redirect" not in results
    results["redirect"] = "no"
    URLBase.post_process_parse_url_results(results)
    assert results.get("redirect") is False

    results["redirect"] = "yes"
    URLBase.post_process_parse_url_results(results)
    assert results.get("redirect") is True

    # URL_TOKEN_ALIASES: 'pass' in top-level results is normalized to
    # 'password' by post_process_parse_url_results (covers the YAML config
    # path where a flat dict is passed rather than a parsed URL string)
    results = URLBase.parse_url("http://user@127.0.0.1/path/")
    results["pass"] = "secret"
    URLBase.post_process_parse_url_results(results)
    assert results.get("password") == "secret"
    assert "pass" not in results

    # URL_TOKEN_ALIASES: canonical 'password' wins when already set to a
    # real value -- 'pass' in top-level results must not overwrite an
    # explicitly provided URL-path password; a WARNING is logged so the
    # operator knows the alias was present but dropped (no values logged)
    results = URLBase.parse_url("http://user:realpass@127.0.0.1/path/")
    results["pass"] = "shouldnotwin"
    with mock.patch("apprise.url.logger") as mock_log:
        URLBase.post_process_parse_url_results(results)
        mock_log.warning.assert_called_once()
        call_args = mock_log.warning.call_args[0]
        # alias and canonical key names appear; actual values must not
        assert "pass" in call_args[1]
        assert "password" in call_args[2]
    assert results.get("password") == "realpass"
    assert "pass" not in results

    # URL_TOKEN_ALIASES: qsd 'pass=' overrides the URL-path password because
    # query-string parameters always take the highest priority
    results = URLBase.parse_url(
        "http://user:shouldnotwin@127.0.0.1/path/?pass=realpass"
    )
    URLBase.post_process_parse_url_results(results)
    assert results.get("password") == "realpass"
    assert "pass" not in results

    # URL_TOKEN_ALIASES: 'pass' in qsd is also normalized to 'password'
    results = URLBase.parse_url("http://user@127.0.0.1/path/?pass=qsecret")
    URLBase.post_process_parse_url_results(results)
    assert results.get("password") == "qsecret"

    # Generic initialization
    base = URLBase(**{"schema": ""})
    assert base.request_timeout == (4.0, 4.0)
    assert base.request_auth is None
    assert base.request_url == "http:///"
    assert base.url().startswith("http:///")

    base = URLBase()
    assert base.request_timeout == (4.0, 4.0)
    assert base.request_auth is None
    assert base.request_url == "http:///"
    assert base.url().startswith("http:///")

    # URLBase.__len__ defaults to 1; subclasses that support multiple
    # targets override this to return the actual count.
    assert len(base) == 1

    # Invalid asset type -- a non-AppriseAsset value must be silently ignored
    # and a debug log must tell the caller what happened.  The instance must
    # still receive a valid default AppriseAsset so nothing downstream breaks.
    with mock.patch("apprise.url.logger") as mock_log:
        base = URLBase(asset="not-an-asset")
        mock_log.debug.assert_called_once()
        call_args = mock_log.debug.call_args[0]
        # The type name appears in the message so the caller can identify it
        assert "str" in call_args[1]

    assert isinstance(base.asset, AppriseAsset)


def test_apprise_urlbase_simple_results():
    """A simple parse without a password still applies the query string."""
    from apprise.utils.parse import parse_url

    # A simple parse leaves out the user and password entries entirely
    results = parse_url("custom://host?x=1", verify_host=False, simple=True)
    assert "password" not in results

    # No password and no user= override
    URLBase.post_process_parse_url_results(results)
    assert results["verify"] is True
    assert "password" not in results

    # A user= override with no password to fall back to
    results = parse_url(
        "custom://host?user=bob&verify=no", verify_host=False, simple=True
    )
    URLBase.post_process_parse_url_results(results)
    assert results["user"] == "bob"
    assert results["password"] is None
    assert results["verify"] is False

    # The original user becomes the password when user= replaces it
    results = parse_url(
        "custom://secret@host?user=bob", verify_host=False, simple=True
    )
    URLBase.post_process_parse_url_results(results)
    assert results["user"] == "bob"
    assert results["password"] == "secret"


def test_apprise_unique_id():
    """
    API: Apprise() Input Formats tests

    """

    # Default testing
    obj1 = Apprise.instantiate("json://user@127.0.0.1/path")
    obj2 = Apprise.instantiate("json://user@127.0.0.1/path/?arg=")

    assert obj1.url_identifier == obj2.url_identifier
    assert obj1.url_id() == obj2.url_id()
    # Second call leverages lazy reference (so it's much faster
    assert obj1.url_id() == obj2.url_id()
    # Disable Lazy Setting
    assert obj1.url_id(lazy=False) == obj2.url_id(lazy=False)

    # A variation such as providing a password or altering the path makes the
    # url_id() different:
    obj2 = Apprise.instantiate("json://user@127.0.0.1/path2/?arg=")  # path
    assert obj1.url_id() != obj2.url_id()
    obj2 = Apprise.instantiate(
        "jsons://user@127.0.0.1/path/?arg="
    )  # secure flag
    assert obj1.url_id() != obj2.url_id()
    obj2 = Apprise.instantiate("json://user2@127.0.0.1/path/?arg=")  # user
    assert obj1.url_id() != obj2.url_id()
    obj2 = Apprise.instantiate("json://user@127.0.0.1:8080/path/?arg=")  # port
    assert obj1.url_id() != obj2.url_id()
    obj2 = Apprise.instantiate(
        "json://user:pass@127.0.0.1/path/?arg="
    )  # password
    assert obj1.url_id() != obj2.url_id()

    # Leverage salt setting
    asset = AppriseAsset(storage_salt="abcd")

    obj2 = Apprise.instantiate("json://user@127.0.0.1/path/", asset=asset)
    assert obj1.url_id(lazy=False) != obj2.url_id(lazy=False)

    asset = AppriseAsset(storage_salt=b"abcd")
    # same salt value produces a match again
    obj1 = Apprise.instantiate("json://user@127.0.0.1/path/", asset=asset)
    assert obj1.url_id() == obj2.url_id()

    # We'll add a good notification to our list
    class TesNoURLID(NotifyBase):
        """This class is just sets a use case where we don't return a
        url_identifier."""

        # we'll use this as a key to make our service easier to find
        # in the next part of the testing
        service_name = "nourl"

        _url_identifier = False

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

        @staticmethod
        def parse_url(url):
            return NotifyBase.parse_url(url, verify_host=False)

        @property
        def url_identifier(self):
            """No URL Identifier."""
            return self._url_identifier

    N_MGR["nourl"] = TesNoURLID

    # setting URL Identifier to False disables the generator
    url = "nourl://"
    obj = Apprise.instantiate(url)
    # No generation takes place
    assert obj.url_id() is None

    #
    # Dictionary Testing
    #
    obj._url_identifier = {
        "abc": "123",
        "def": b"\0",
        "hij": 42,
        "klm": object,
    }
    # call uses cached value (from above)
    assert obj.url_id() is None
    # Tests dictionary key generation
    assert obj.url_id(lazy=False) is not None

    # List/Set/Tuple Testing
    #
    obj1 = Apprise.instantiate(url)
    obj1._url_identifier = ["123", b"\0", 42, object]
    # Tests dictionary key generation
    assert obj1.url_id() is not None

    obj2 = Apprise.instantiate(url)
    obj2._url_identifier = ("123", b"\0", 42, object)
    assert obj2.url_id() is not None
    assert obj1.url_id() == obj2.url_id()

    obj3 = Apprise.instantiate(url)
    obj3._url_identifier = {"123", b"\0", 42, object}
    assert obj3.url_id() is not None

    obj = Apprise.instantiate(url)
    obj._url_identifier = b"test"
    assert obj.url_id() is not None

    obj = Apprise.instantiate(url)
    obj._url_identifier = "test"
    assert obj.url_id() is not None

    # Testing Garbage
    for x in (31, object, 43.1):
        obj = Apprise.instantiate(url)
        obj._url_identifier = x
        assert obj.url_id() is not None


def test_apprise_notify_formats():
    """
    API: Apprise() Input Formats tests

    """
    # Need to set async_mode=False to call notify() instead of async_notify().
    asset = AppriseAsset(async_mode=False)

    a = Apprise(asset=asset)

    # no items
    assert len(a) == 0

    class TextNotification(NotifyBase):
        # set our default notification format
        notify_format = NotifyFormat.TEXT

        def __init__(self, **kwargs):
            super().__init__(**kwargs)

        def notify(self, **kwargs):
            # Pretend everything is okay
            return True

    class HtmlNotification(NotifyBase):
        # set our default notification format
        notify_format = NotifyFormat.HTML

        def __init__(self, **kwargs):
            super().__init__(**kwargs)

        def notify(self, **kwargs):
            # Pretend everything is okay
            return True

    class MarkDownNotification(NotifyBase):
        # set our default notification format
        notify_format = NotifyFormat.MARKDOWN

        def __init__(self, **kwargs):
            super().__init__(**kwargs)

        def notify(self, **kwargs):
            # Pretend everything is okay
            return True

    # Store our notifications into our schema map
    N_MGR["text"] = TextNotification
    N_MGR["html"] = HtmlNotification
    N_MGR["markdown"] = MarkDownNotification

    # Test Markdown; the above calls the markdown because our good://
    # defined plugin above was defined to default to HTML which triggers
    # a markdown to take place if the body_format specified on the notify
    # call
    assert a.add("html://localhost") is True
    assert a.add("html://another.server") is True
    assert a.add("html://and.another") is True
    assert a.add("text://localhost") is True
    assert a.add("text://another.server") is True
    assert a.add("text://and.another") is True
    assert a.add("markdown://localhost") is True
    assert a.add("markdown://another.server") is True
    assert a.add("markdown://and.another") is True

    assert len(a) == 9

    assert (
        bool(
            a.notify(
                title="markdown",
                body="## Testing Markdown",
                body_format=NotifyFormat.MARKDOWN,
            )
        )
        is True
    )

    assert (
        bool(
            a.notify(
                title="text",
                body="Testing Text",
                body_format=NotifyFormat.TEXT,
            )
        )
        is True
    )

    assert (
        bool(
            a.notify(
                title="html", body="HTML", body_format=NotifyFormat.HTML
            )
        )
        is True
    )


def test_apprise_multi_format_resolution(caplog):
    """
    API: multi-format notify_format resolution

    """
    # Older pytest versions may leave logging disabled after set_level().
    # Override that state only when needed, then restore it below.
    caplog.set_level(logging.DEBUG, logger=LOGGER_NAME)
    manual_override = not logging.getLogger(LOGGER_NAME).isEnabledFor(
        logging.DEBUG
    )
    if manual_override:
        logging.disable(logging.NOTSET)

    try:

        class SingleFormatNotification(NotifyBase):
            """Test plugin that resolves to one fixed format."""

            # Single-format plugins always use their declared format.
            notify_format = NotifyFormat.HTML

            def send(self, body, title="", notify_type=None, **kwargs):
                """Accept the prepared body without doing network work."""
                return True

        class MultiFormatNotification(NotifyBase):
            """Test plugin that can render either HTML or Markdown."""

            # Declares more than one supported format, index[0] is default
            notify_format = (NotifyFormat.HTML, NotifyFormat.MARKDOWN)

            received = []

            def send(self, body, title="", notify_type=None, **kwargs):
                """Record fallback sends with no format-specific hook."""
                self.received.append(("send", body))
                return True

            def send_markdown(
                self, body, title="", notify_type=None, **kwargs
            ):
                """Record Markdown-specific dispatch."""
                self.received.append(("send_markdown", body))
                return True

        # Single-format plugin: _formats()/resolve_format() resolve to the
        # one declared format no matter what is passed in.
        single = SingleFormatNotification(host="localhost")
        assert single._formats() == (NotifyFormat.HTML,)
        assert single.resolve_format(None) == NotifyFormat.HTML
        assert single.resolve_format(NotifyFormat.TEXT) == NotifyFormat.HTML
        assert (
            single.resolve_format(NotifyFormat.MARKDOWN) == NotifyFormat.HTML
        )

        # A plain string is accepted
        assert single.resolve_format("text") == NotifyFormat.HTML

        # Multi-format plugin, no override, no matching input: default wins
        multi = MultiFormatNotification(host="localhost")
        assert multi._formats() == (NotifyFormat.HTML, NotifyFormat.MARKDOWN)
        assert multi.resolve_format(None) == NotifyFormat.HTML
        assert multi.resolve_format(NotifyFormat.TEXT) == NotifyFormat.HTML

        # Multi-format plugin, no override, input aligns to a declared format
        assert (
            multi.resolve_format(NotifyFormat.MARKDOWN)
            == NotifyFormat.MARKDOWN
        )

        # A plain string is supported
        resolved = multi.resolve_format("markdown")
        assert resolved == NotifyFormat.MARKDOWN
        assert isinstance(resolved, NotifyFormat)

        # Multi-format plugin, explicit ?format= override in the declared set
        multi_override = MultiFormatNotification(
            host="localhost", format="markdown"
        )
        assert multi_override._format_override == NotifyFormat.MARKDOWN
        assert multi_override.resolve_format(NotifyFormat.HTML) == (
            NotifyFormat.MARKDOWN
        )

        # Multi-format plugin, ?format= override NOT in the declared set falls
        # back through to input alignment, then default, with a debug message.
        multi_bad_override = MultiFormatNotification(
            host="localhost", format="text"
        )
        assert multi_bad_override._format_override == NotifyFormat.TEXT
        caplog.clear()
        assert multi_bad_override.resolve_format(NotifyFormat.MARKDOWN) == (
            NotifyFormat.MARKDOWN
        )
        assert "does not support format" in caplog.text
        assert "DEBUG" in caplog.text

        # No declared source format: same fallback, but silent -- matches
        # the historical no-noise conversion behavior.
        caplog.clear()
        assert multi_bad_override.resolve_format(None) == NotifyFormat.HTML
        assert "does not support format" not in caplog.text

        # send_{type}() dispatch: send_markdown() defined, used when resolved
        multi.received.clear()
        assert (
            multi.notify(body="# hi", body_format=NotifyFormat.MARKDOWN)
            is True
        )
        assert multi.received == [("send_markdown", "# hi")]

        # send_{type}() dispatch: no send_html() defined, falls back to send()
        multi.received.clear()
        assert multi.notify(body="hi", body_format=NotifyFormat.HTML) is True
        assert multi.received == [("send", "hi")]
    finally:
        if manual_override:
            logging.disable(logging.CRITICAL)


def test_apprise_multi_format_conversion_cache():
    """
    API: multi-format resolution reuses one converted body per resolved
    target, same as the existing single-format conversion cache.

    """
    asset = AppriseAsset(async_mode=False)
    a = Apprise(asset=asset)

    class HtmlOnlyNotification(NotifyBase):
        """Test plugin that resolves to HTML."""

        notify_format = NotifyFormat.HTML

        def send(self, body, title="", notify_type=None, **kwargs):
            """Accept the prepared body without doing network work."""
            return True

    class MultiFormatNotification(NotifyBase):
        """Test plugin that also resolves to HTML by default."""

        # Resolves to HTML by default, same target as HtmlOnlyNotification
        notify_format = (NotifyFormat.HTML, NotifyFormat.MARKDOWN)

        def send(self, body, title="", notify_type=None, **kwargs):
            """Accept the prepared body without doing network work."""
            return True

    N_MGR["htmlonly"] = HtmlOnlyNotification
    N_MGR["multi"] = MultiFormatNotification

    assert a.add("htmlonly://localhost") is True
    assert a.add("multi://localhost") is True
    assert len(a) == 2

    with mock.patch(
        "apprise.apprise.convert_between",
        side_effect=lambda *a, **k: "converted",
    ) as mock_convert:
        assert (
            bool(a.notify(body="hello", body_format=NotifyFormat.TEXT)) is True
        )
        # Both services resolve to HTML; the body should only be converted
        # once and reused, exactly like the single-format cache today.
        assert mock_convert.call_count == 1


def test_apprise_payload_max_size_enforced_before_conversion():
    """API: Apply the payload cap before conversion and title merging."""
    asset = AppriseAsset(async_mode=False, payload_max_size=20)
    a = Apprise(asset=asset)

    class TitlelessNotification(NotifyBase):
        """Test plugin with no native title field."""

        title_maxlen = 0

        def __init__(self, *args, **kwargs):
            super().__init__(**kwargs)
            self.sent = []

        def send(self, body, title="", notify_type=None, **kwargs):
            """Record what would have gone out over the wire."""
            self.sent.append((title, body))
            return True

    N_MGR["titleless"] = TitlelessNotification

    obj = TitlelessNotification(host="localhost", asset=asset)
    assert a.add(obj) is True

    title = "T" * 100
    body = "B" * 1000

    with mock.patch(
        "apprise.apprise.convert_between",
        side_effect=lambda src, dst, content: content,
    ) as mock_convert:
        assert bool(a.notify(title=title, body=body)) is True

        # Conversion only receives content that already fits the input cap.
        for call in mock_convert.call_args_list:
            assert len(call.kwargs["content"]) <= 20

    # Title markup may add a few characters after the input cap is applied.
    assert len(obj.sent) == 1
    delivered_title, delivered_body = obj.sent[0]
    assert delivered_title == ""
    assert len(delivered_body) < 30


def test_apprise_payload_max_size_not_reapplied_after_conversion():
    """API: Cap source text once without truncating converted markup."""

    class HTMLNotification(NotifyBase):
        """Test plugin whose declared format is HTML."""

        notify_format = NotifyFormat.HTML
        title_maxlen = 0

        def __init__(self, *args, **kwargs):
            super().__init__(**kwargs)
            self.sent = []

        def send(self, body, title="", notify_type=None, **kwargs):
            """Record what would have gone out over the wire."""
            self.sent.append((title, body))
            return True

    N_MGR["htmltest"] = HTMLNotification

    # The five-character source fits, although its HTML conversion is longer.
    asset = AppriseAsset(async_mode=False, payload_max_size=5)
    a = Apprise(asset=asset)
    obj = HTMLNotification(host="localhost", asset=asset)
    assert a.add(obj) is True

    result = a.notify(
        title="", body="**x**", body_format=NotifyFormat.MARKDOWN
    )
    assert bool(result) is True

    assert len(obj.sent) == 1
    _, delivered_body = obj.sent[0]
    assert delivered_body == "
    x
    "

    # Direct plugin calls still enforce the cap because no earlier step did.
    obj.sent.clear()
    assert obj.notify(title="", body="B" * 100) is True
    assert len(obj.sent) == 1
    _, direct_body = obj.sent[0]
    assert len(direct_body) <= 5

    # The old public keyword is ignored, so direct callers cannot use it to
    # bypass the cap.
    obj.sent.clear()
    assert obj.notify(title="", body="B" * 100, payload_precapped=True) is True
    assert len(obj.sent) == 1
    _, guessed_kwarg_body = obj.sent[0]
    assert len(guessed_kwarg_body) <= 5


def test_apprise_payload_max_size_uses_service_asset_limit():
    """API: Apply each service's asset cap before conversion.

    The service limit still applies when the top-level asset has no cap.
    """

    class TitlelessNotification(NotifyBase):
        """Test plugin with no native title field."""

        title_maxlen = 0

        def __init__(self, *args, **kwargs):
            super().__init__(**kwargs)
            self.sent = []

        def send(self, body, title="", notify_type=None, **kwargs):
            """Record what would have gone out over the wire."""
            self.sent.append((title, body))
            return True

    N_MGR["titleless"] = TitlelessNotification

    # The top-level asset used by Apprise() itself has the cap disabled.
    global_asset = AppriseAsset(async_mode=False, payload_max_size=0)
    a = Apprise(asset=global_asset)

    # Give this service a separate asset with its own cap.
    service_asset = AppriseAsset(async_mode=False, payload_max_size=20)
    obj = TitlelessNotification(host="localhost", asset=service_asset)
    assert a.add(obj) is True

    title = "T" * 100
    body = "B" * 1000

    with mock.patch(
        "apprise.apprise.convert_between",
        side_effect=lambda src, dst, content: content,
    ) as mock_convert:
        assert bool(a.notify(title=title, body=body)) is True

        # Conversion receives content trimmed to the service's own cap.
        for call in mock_convert.call_args_list:
            assert len(call.kwargs["content"]) <= 20

    assert len(obj.sent) == 1
    delivered_title, delivered_body = obj.sent[0]
    assert len(delivered_title) + len(delivered_body) < 30


def test_apprise_payload_max_size_cache_key_includes_buffer_settings():
    """API: Services with different payload settings use separate caches."""

    class TitlelessNotification(NotifyBase):
        """Test plugin with no native title field."""

        title_maxlen = 0

        def __init__(self, *args, **kwargs):
            super().__init__(**kwargs)
            self.sent = []

        def send(self, body, title="", notify_type=None, **kwargs):
            """Record what would have gone out over the wire."""
            self.sent.append((title, body))
            return True

    N_MGR["titleless"] = TitlelessNotification

    global_asset = AppriseAsset(async_mode=False)
    a = Apprise(asset=global_asset)

    # The second service disables the short-side rule.
    asset1 = AppriseAsset(async_mode=False, payload_max_size=35)
    obj1 = TitlelessNotification(host="host1", asset=asset1)
    assert a.add(obj1) is True

    asset2 = AppriseAsset(
        async_mode=False, payload_max_size=35, payload_buffer_threshold=0
    )
    obj2 = TitlelessNotification(host="host2", asset=asset2)
    assert a.add(obj2) is True

    title = "T" * 9
    body = "B" * 33

    with mock.patch(
        "apprise.apprise.convert_between",
        side_effect=lambda src, dst, content: content,
    ):
        assert bool(a.notify(title=title, body=body)) is True

    assert len(obj1.sent) == 1
    assert len(obj2.sent) == 1

    # With no title field, the different allocations appear in each body.
    delivered1 = obj1.sent[0][1]
    delivered2 = obj2.sent[0][1]
    assert delivered1 != delivered2


def test_apprise_payload_trim_warning(caplog):
    """API: Log a warning only when a service cap trims the input."""
    # Older pytest versions may leave logging disabled after set_level().
    # Override that state only when needed, then restore it below.
    caplog.set_level(logging.WARNING, logger=LOGGER_NAME)
    manual_override = not logging.getLogger(LOGGER_NAME).isEnabledFor(
        logging.WARNING
    )
    if manual_override:
        logging.disable(logging.NOTSET)

    try:

        class PlainNotification(NotifyBase):
            title_maxlen = 10

            def send(self, body, title="", notify_type=None, **kwargs):
                return True

        N_MGR["plain"] = PlainNotification

        asset = AppriseAsset(async_mode=False, payload_max_size=5)
        a = Apprise(asset=asset)
        obj = PlainNotification(host="localhost", asset=asset)
        assert a.add(obj) is True

        caplog.clear()
        assert bool(a.notify(title="", body="x" * 100)) is True
        assert "payload_max_size" in caplog.text

        # A body that already fits the cap logs no warning at all.
        caplog.clear()
        assert bool(a.notify(title="", body="x")) is True
        assert "payload_max_size" not in caplog.text
    finally:
        if manual_override:
            logging.disable(logging.CRITICAL)


def test_apprise_multi_format_details():
    """
    API: Apprise() Details reflect a plugin's real supported formats

    """

    class SingleFormatNotification(NotifyBase):
        """Test plugin whose public details should stay broad."""

        service_name = "Single Format Testing"
        protocol = "singlefmt"
        notify_format = NotifyFormat.HTML

        templates = ("{schema}://{host}",)

        def send(self, body, title="", notify_type=None, **kwargs):
            """Accept the prepared body without doing network work."""
            return True

    class MultiFormatNotification(NotifyBase):
        """Test plugin whose public details expose supported formats."""

        service_name = "Multi Format Testing"
        protocol = "multifmtdetails"
        # Declaration order matters: markdown is the default (index[0])
        notify_format = (NotifyFormat.MARKDOWN, NotifyFormat.HTML)

        templates = ("{schema}://{host}",)

        def send(self, body, title="", notify_type=None, **kwargs):
            """Accept the prepared body without doing network work."""
            return True

    # values/default remain broad for every plugin so consumers that only
    # know those fields keep seeing the standard Apprise ?format= choices.
    # The additive `supported` field carries the narrower native subset.
    single_details = plugins.details(SingleFormatNotification)
    assert single_details["args"]["format"]["values"] == NOTIFY_FORMATS
    assert single_details["args"]["format"]["default"] == "html"
    # `supported` names the subset this plugin actually renders natively:
    # one entry for a single-format plugin.
    assert single_details["args"]["format"]["supported"] == ["html"]

    multi_details = plugins.details(MultiFormatNotification)
    assert multi_details["args"]["format"]["values"] == NOTIFY_FORMATS
    assert multi_details["args"]["format"]["default"] == "markdown"
    # Declaration order preserved, not alphabetically re-sorted
    assert multi_details["args"]["format"]["supported"] == [
        "markdown",
        "html",
    ]


def test_apprise_asset(tmpdir):
    """
    API: AppriseAsset() object

    """
    a = AppriseAsset(theme="light")
    # Default theme
    assert a.theme == "light"

    # Invalid kw handling
    with pytest.raises(AttributeError):
        AppriseAsset(invalid_kw="value")

    a = AppriseAsset(
        theme="dark",
        image_path_mask="/{THEME}/{TYPE}-{XY}{EXTENSION}",
        image_url_mask="http://localhost/{THEME}/{TYPE}-{XY}{EXTENSION}",
    )

    a.default_html_color = "#abcabc"

    assert a.color("invalid", tuple) == (171, 202, 188)
    assert a.color(NotifyType.INFO, tuple) == (58, 163, 227)

    assert a.color("invalid", int) == 11258556
    assert a.color(NotifyType.INFO, int) == 3843043

    assert a.color("invalid", None) == "#abcabc"
    assert a.color(NotifyType.INFO, None) == "#3AA3E3"
    # None is the default
    assert a.color(NotifyType.INFO) == "#3AA3E3"

    # Invalid Type
    with pytest.raises(ValueError):
        # The exception we expect since dict is not supported
        a.color(NotifyType.INFO, dict)

    # Test our ASCII mappings
    assert a.ascii("invalid") == "[?]"
    assert a.ascii(NotifyType.INFO) == "[i]"
    assert a.ascii(NotifyType.SUCCESS) == "[+]"
    assert a.ascii(NotifyType.WARNING) == "[~]"
    assert a.ascii(NotifyType.FAILURE) == "[!]"

    # Invalid Type
    with pytest.raises(ValueError):
        # The exception we expect since dict is not supported
        a.color(NotifyType.INFO, dict)

    assert (
        a.image_url(NotifyType.INFO, NotifyImageSize.XY_128)
        == "http://localhost/dark/info-128x128.png"
    )

    # Default image size
    assert (
        a.image_url(NotifyType.INFO)
        == "http://localhost/dark/info-256x256.png"
    )

    assert (
        a.image_path(NotifyType.INFO, NotifyImageSize.XY_256, must_exist=False)
        == "/dark/info-256x256.png"
    )

    # This path doesn't exist so image_raw will fail (since we just
    # randompyl picked it for testing)
    assert a.image_raw(NotifyType.INFO, NotifyImageSize.XY_256) is None

    assert (
        a.image_path(NotifyType.INFO, NotifyImageSize.XY_256, must_exist=True)
        is None
    )

    # Create a new object (with our default settings)
    a = AppriseAsset()

    # Our default configuration can access our file
    assert (
        a.image_path(NotifyType.INFO, NotifyImageSize.XY_256, must_exist=True)
        is not None
    )

    assert a.image_raw(NotifyType.INFO, NotifyImageSize.XY_256) is not None

    # Create a temporary directory
    sub = tmpdir.mkdir("great.theme")

    # Write a file
    sub.join(
        f"{NotifyType.INFO.value}-{NotifyImageSize.XY_256.value}.png"
    ).write("the content doesn't matter for testing.")

    # Create an asset that will reference our file we just created
    a = AppriseAsset(
        theme="great.theme",
        image_path_mask=(
            f"{dirname(sub.strpath)}/{{THEME}}/{{TYPE}}-{{XY}}.png"
        ),
    )

    # We'll be able to read file we just created
    assert a.image_raw(NotifyType.INFO, NotifyImageSize.XY_256) is not None

    # We can retrieve the filename at this point even with must_exist set
    # to True
    assert (
        a.image_path(NotifyType.INFO, NotifyImageSize.XY_256, must_exist=True)
        is not None
    )

    # Test case where we can't access the image file
    with mock.patch("builtins.open", side_effect=OSError()):
        assert a.image_raw(NotifyType.INFO, NotifyImageSize.XY_256) is None

    # Our content is retrivable again
    assert a.image_raw(NotifyType.INFO, NotifyImageSize.XY_256) is not None

    # Disable all image references
    a = AppriseAsset(image_path_mask=False, image_url_mask=False)

    # We always return none in these calls now
    assert a.image_raw(NotifyType.INFO, NotifyImageSize.XY_256) is None
    assert a.image_url(NotifyType.INFO, NotifyImageSize.XY_256) is None
    assert (
        a.image_path(NotifyType.INFO, NotifyImageSize.XY_256, must_exist=False)
        is None
    )
    assert (
        a.image_path(NotifyType.INFO, NotifyImageSize.XY_256, must_exist=True)
        is None
    )

    # Test our default extension out
    a = AppriseAsset(
        image_path_mask="/{THEME}/{TYPE}-{XY}{EXTENSION}",
        image_url_mask="http://localhost/{THEME}/{TYPE}-{XY}{EXTENSION}",
        default_extension=".jpeg",
    )
    assert (
        a.image_path(NotifyType.INFO, NotifyImageSize.XY_256, must_exist=False)
        == "/default/info-256x256.jpeg"
    )

    assert (
        a.image_url(NotifyType.INFO, NotifyImageSize.XY_256)
        == "http://localhost/default/info-256x256.jpeg"
    )

    # extension support
    assert (
        a.image_path(
            NotifyType.INFO,
            NotifyImageSize.XY_128,
            must_exist=False,
            extension=".ico",
        )
        == "/default/info-128x128.ico"
    )

    assert (
        a.image_url(NotifyType.INFO, NotifyImageSize.XY_256, extension=".test")
        == "http://localhost/default/info-256x256.test"
    )

    a = AppriseAsset(plugin_paths=("/tmp",))
    assert a.plugin_paths == ("/tmp",)


def test_apprise_disabled_plugins():
    """
    API: Apprise() Disabled Plugin States

    """
    # Ensure there are no other drives loaded
    N_MGR.unload_modules(disable_native=True)
    assert len(N_MGR) == 0

    class TestDisabled01Notification(NotifyBase):
        """This class is used to test a pre-disabled state."""

        # Just flat out disable our service
        enabled = False

        # we'll use this as a key to make our service easier to find
        # in the next part of the testing
        service_name = "na01"

        def notify(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["na01"] = TestDisabled01Notification

    class TestDisabled02Notification(NotifyBase):
        """This class is used to test a post-disabled state."""

        # we'll use this as a key to make our service easier to find
        # in the next part of the testing
        service_name = "na02"

        def __init__(self, *args, **kwargs):
            super().__init__(**kwargs)

            # enable state changes **AFTER** we initialize
            self.enabled = False

        def notify(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["na02"] = TestDisabled02Notification

    # Create our Apprise instance
    a = Apprise()

    result = a.details(lang="ca-en", show_disabled=True)
    assert isinstance(result, dict)
    assert "schemas" in result
    assert len(result["schemas"]) == 2

    # our na01 is disabled right from the get-go
    entry = next(
        (x for x in result["schemas"] if x["service_name"] == "na01"), None
    )
    assert entry is not None
    assert entry["enabled"] is False

    plugin = a.instantiate("na01://localhost")
    # Object is just flat out disabled... nothing is instatiated
    assert plugin is None

    # our na02 isn't however until it's initialized; as a result
    # it get's returned in our result set
    entry = next(
        (x for x in result["schemas"] if x["service_name"] == "na02"), None
    )
    assert entry is not None
    assert entry["enabled"] is True

    plugin = a.instantiate("na02://localhost")
    # Object isn't disabled until the __init__() call.  But this is still
    # enough to not instantiate the object:
    assert plugin is None

    # If we choose to filter our disabled, we can't unfortunately filter those
    # that go disabled after instantiation, but we do filter out any that are
    # already known to not be enabled:
    result = a.details(lang="ca-en", show_disabled=False)
    assert isinstance(result, dict)
    assert "schemas" in result
    assert len(result["schemas"]) == 1

    # We'll add a good notification to our list
    class TesEnabled01Notification(NotifyBase):
        """This class is just a simple enabled one."""

        # we'll use this as a key to make our service easier to find
        # in the next part of the testing
        service_name = "good"

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["good"] = TesEnabled01Notification

    # The last thing we'll simulate is a case where the plugin is just
    # disabled at a later time long into it's life.  this is just to allow
    # administrators to stop the flow of their notifications for their own
    # given reasons.
    plugin = a.instantiate("good://localhost")
    assert isinstance(plugin, NotifyBase)

    # we'll toggle our state
    plugin.enabled = False

    # As a result, we can now no longer send a notification:
    assert bool(plugin.notify("My Message")) is False

    # As just a proof of how you can toggle the state back:
    plugin.enabled = True

    # our notifications will go okay now
    assert bool(plugin.notify("My Message")) is True

    # Restore our modules
    N_MGR.unload_modules()


def test_apprise_details():
    """
    API: Apprise() Details

    """

    # This is a made up class that is just used to verify
    class TestDetailNotification(NotifyBase):
        """This class is used to test various configurations supported."""

        # Minimum requirements for a plugin to produce details
        service_name = "Detail Testing"

        # The default simple (insecure) protocol (used by NotifyMail)
        protocol = "details"

        # Set test_bool flag
        always_true = True
        always_false = False

        # Define object templates
        templates = (
            "{schema}://{host}",
            "{schema}://{host}:{port}",
            "{schema}://{user}@{host}:{port}",
            "{schema}://{user}:{pass}@{host}:{port}",
        )

        # Define our tokens; these are the minimum tokens required required to
        # be passed into this function (as arguments). The syntax appends any
        # previously defined in the base package and builds onto them
        template_tokens = dict(
            NotifyBase.template_tokens,
            **{
                "notype": {
                    # name is a minimum requirement
                    "name": _("no type"),
                },
                "regex_test01": {
                    "name": _("RegexTest"),
                    "type": "string",
                    "regex": r"^[A-Z0-9]$",
                },
                "regex_test02": {
                    "name": _("RegexTest"),
                    # Support regex options too
                    "regex": (r"^[A-Z0-9]$", "i"),
                },
                "regex_test03": {
                    "name": _("RegexTest"),
                    # Support regex option without a second option
                    "regex": r"^[A-Z0-9]$",
                },
                "regex_test04": {
                    # this entry would just end up getting removed
                    "regex": None,
                },
                # List without delimiters (causes defaults to kick in)
                "mylistA": {
                    "name": "fruit",
                    "type": "list:string",
                },
                # A list with a delimiter list
                "mylistB": {
                    "name": "softdrinks",
                    "type": "list:string",
                    "delim": ["|", "-"],
                },
            },
        )

        template_args = dict(
            NotifyBase.template_args,
            **{
                # Test _exist_if logic
                "test_exists_if_01": {
                    "name": "Always False",
                    "type": "bool",
                    # Provide a default
                    "default": False,
                    # Base the existance of this key/value entry on the lookup
                    # of this class value at runtime. Hence:
                    #     if not NotifyObject.always_false
                    #         del this_entry
                    #
                    "_exists_if": "always_false",
                },
                # Test _exist_if logic
                "test_exists_if_02": {
                    "name": "Always True",
                    "type": "bool",
                    # Provide a default
                    "default": False,
                    # Base the existance of this key/value entry on the lookup
                    # of this class value at runtime. Hence:
                    #     if not NotifyObject.always_true
                    #         del this_entry
                    #
                    "_exists_if": "always_true",
                },
                # alias_of testing
                "test_alias_of": {"alias_of": "mylistB", "delim": ("-", " ")},
            },
        )

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    # Store our good detail notification in our schema map
    N_MGR["details"] = TestDetailNotification

    # This is a made up class that is just used to verify
    class TestReq01Notification(NotifyBase):
        """This class is used to test various requirement configurations."""

        # Set some requirements
        requirements: ClassVar[RequirementsSpec] = {
            "packages_required": [
                "cryptography <= 3.4",
                "ultrasync",
            ],
            "packages_recommended": "django",
        }

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["req01"] = TestReq01Notification

    # This is a made up class that is just used to verify
    class TestReq02Notification(NotifyBase):
        """This class is used to test various requirement configurations."""

        # Just not enabled at all
        enabled = False

        # Set some requirements
        requirements: ClassVar[RequirementsSpec] = {
            # None and/or [] is implied, but jsut to show that the code won't
            # crash if explicitly set this way:
            "packages_required": None,
            "packages_recommended": [
                "cryptography <= 3.4",
            ],
        }

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["req02"] = TestReq02Notification

    # This is a made up class that is just used to verify
    class TestReq03Notification(NotifyBase):
        """This class is used to test various requirement configurations."""

        # Set some requirements
        requirements: ClassVar[RequirementsSpec] = {
            # We can over-ride the default details assigned to our plugin if
            # specified
            "details": _("some specified requirement details"),
            # We can set a string value as well (it does not have to be a list)
            "packages_recommended": "cryptography <= 3.4",
        }

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["req03"] = TestReq03Notification

    # This is a made up class that is just used to verify
    class TestReq04Notification(NotifyBase):
        """This class is used to test a case where our requirements is fixed to
        a None."""

        # This is the same as saying there are no requirements
        requirements = None

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["req04"] = TestReq04Notification

    # This is a made up class that is just used to verify
    class TestReq05Notification(NotifyBase):
        """This class is used to test a case where only packages_recommended is
        identified."""

        requirements: ClassVar[RequirementsSpec] = {
            # We can set a string value as well (it does not have to be a list)
            "packages_recommended": "cryptography <= 3.4"
        }

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["req05"] = TestReq05Notification

    # Create our Apprise instance
    a = Apprise()

    # Dictionary response
    result = a.details()
    assert isinstance(result, dict)

    # Test different variations of our call
    result = a.details(lang="ca-fr")
    assert isinstance(result, dict)
    for entry in result["schemas"]:
        # Verify our key does not exist because we did not ask for it
        assert "enabled" not in entry
        assert "requirements" not in entry

    result = a.details(lang="us-en", show_requirements=True)
    assert isinstance(result, dict)
    for entry in result["schemas"]:
        # Verify our key does not exist because we did not ask for it
        assert "enabled" not in entry

        # Requirements are set for display
        assert "requirements" in entry
        assert "details" in entry["requirements"]
        assert "packages_required" in entry["requirements"]
        assert "packages_recommended" in entry["requirements"]
        assert isinstance(
            entry["requirements"]["details"], (str, LazyTranslation)
        )
        assert isinstance(entry["requirements"]["packages_required"], list)
        assert isinstance(entry["requirements"]["packages_recommended"], list)

    result = a.details(lang="ca-en", show_disabled=True)
    assert isinstance(result, dict)
    for entry in result["schemas"]:
        # Verify that our plugin state is available to us
        assert "enabled" in entry
        assert isinstance(entry["enabled"], bool)

        # Verify our key does not exist because we did not ask for it
        assert "requirements" not in entry

    result = a.details(
        lang="ca-fr", show_requirements=True, show_disabled=True
    )
    assert isinstance(result, dict)
    for entry in result["schemas"]:
        # Plugin States are set for display
        assert "enabled" in entry
        assert isinstance(entry["enabled"], bool)

        # Requirements are set for display
        assert "requirements" in entry
        assert "details" in entry["requirements"]
        assert "packages_required" in entry["requirements"]
        assert "packages_recommended" in entry["requirements"]
        assert isinstance(
            entry["requirements"]["details"], (str, LazyTranslation)
        )
        assert isinstance(entry["requirements"]["packages_required"], list)
        assert isinstance(entry["requirements"]["packages_recommended"], list)


def test_apprise_details_plugin_verification():
    """
    API: Apprise() Details Plugin Verification

    """
    # Prepare our object
    a = Apprise()

    # Details object
    details = a.details()

    # Dictionary response
    assert isinstance(details, dict)

    # Details object with language defined:
    details = a.details(lang="en")

    # Dictionary response
    assert isinstance(details, dict)

    # Details object with unsupported language:
    details = a.details(lang="xx")

    # Dictionary response
    assert isinstance(details, dict)

    # Apprise version
    assert "version" in details
    assert details.get("version") == __version__

    # Defined schemas identify each plugin
    assert "schemas" in details
    assert isinstance(details.get("schemas"), list)

    # We have an entry per defined plugin
    assert "asset" in details
    assert isinstance(details.get("asset"), dict)
    assert "app_id" in details["asset"]
    assert "app_desc" in details["asset"]
    assert "default_extension" in details["asset"]
    assert "theme" in details["asset"]
    assert "image_path_mask" in details["asset"]
    assert "image_url_mask" in details["asset"]
    assert "image_url_logo" in details["asset"]

    # Valid Type Regular Expression Checker
    # Case Sensitive and MUST match the following:
    is_valid_type_re = re.compile(
        r"((choice|list):)?(string|bool|int|float|email)"
    )

    # match tokens found in templates so we can cross reference them back
    # to see if they have a matching argument
    template_token_re = re.compile(r"{([^}]+)}[^{]*?(?=$|{)")

    # Define acceptable map_to arguments that can be tied in with the
    # kwargs function definitions.
    valid_kwargs = {
        # General Parameters
        "user",
        "password",
        "port",
        "host",
        "schema",
        "fullpath",
        # NotifyBase parameters:
        "tz",
        "format",
        "overflow",
        "emojis",
        "retry",
        "wait",
        "optional",
        # URLBase parameters:
        "verify",
        "redirect",
        "cto",
        "rto",
        "store",
    }

    # Valid Schema Entries:
    valid_schema_keys = (
        "name",
        "private",
        "required",
        "type",
        "values",
        # The subset of `values` this specific plugin actually renders
        # natively; only meaningfully narrower than `values` for a
        # multi-format plugin. See NotifyBase.resolve_format().
        "supported",
        "min",
        "max",
        "regex",
        "default",
        "list",
        "delim",
        "prefix",
        "map_to",
        "alias_of",
        "group",
    )
    for entry in details["schemas"]:
        # Track the map_to entries (if specified); We need to make sure that
        # these properly map back
        map_to_entries = set()

        # Track the alias_of entries
        map_to_aliases = set()

        # A Service Name MUST be defined
        assert "service_name" in entry
        assert isinstance(entry["service_name"], (str, LazyTranslation))

        # Acquire our protocols
        protocols = parse_list(entry["protocols"], entry["secure_protocols"])

        # At least one schema/protocol MUST be defined
        assert len(protocols) > 0

        # our details
        assert "details" in entry
        assert isinstance(entry["details"], dict)

        # All schema details should include args
        for section in ["kwargs", "args", "tokens"]:
            assert section in entry["details"]
            assert isinstance(entry["details"][section], dict)

            for key, arg in entry["details"][section].items():
                # Validate keys (case-sensitive)
                assert len([k for k in arg if k not in valid_schema_keys]) == 0

                # Test our argument
                assert isinstance(arg, dict)

                if "alias_of" not in arg:
                    # Minimum requirement of an argument
                    assert "name" in arg
                    assert isinstance(arg["name"], str)

                    assert "type" in arg
                    assert isinstance(arg["type"], str)
                    assert is_valid_type_re.match(arg["type"]) is not None

                    if "min" in arg:
                        assert arg["type"].endswith("float") or arg[
                            "type"
                        ].endswith("int")
                        assert isinstance(arg["min"], (int, float))

                        if "max" in arg:
                            # If a min and max was specified, at least check
                            # to confirm the min is less then the max
                            assert arg["min"] < arg["max"]

                    if "max" in arg:
                        assert arg["type"].endswith("float") or arg[
                            "type"
                        ].endswith("int")
                        assert isinstance(arg["max"], (int, float))

                    if "private" in arg:
                        assert isinstance(arg["private"], bool)

                    if "required" in arg:
                        assert isinstance(arg["required"], bool)

                    if "prefix" in arg:
                        assert isinstance(arg["prefix"], str)
                        if section == "kwargs":
                            # The only acceptable prefix types for kwargs
                            assert arg["prefix"] in (":", "+", "-")

                    else:
                        # kwargs requires that the 'prefix' is defined
                        assert section != "kwargs"

                    if "map_to" in arg:
                        # must be a string
                        assert isinstance(arg["map_to"], str)
                        # Track our map_to object
                        map_to_entries.add(arg["map_to"])

                    else:
                        map_to_entries.add(key)

                    # Some verification
                    if arg["type"].startswith("choice"):
                        # choice:bool is redundant and should be swapped to
                        # just bool
                        assert not arg["type"].endswith("bool")

                        # Choices require that a values list is provided
                        assert "values" in arg
                        assert isinstance(
                            arg["values"], (list, tuple, frozenset, set)
                        )
                        assert len(arg["values"]) > 0

                        # Test default
                        if "default" in arg:
                            # if a default is provided on a choice object,
                            # it better be in the list of values
                            assert arg["default"] in arg["values"]

                    if arg["type"].startswith("bool"):
                        # Boolean choices are less restrictive but require a
                        # default value
                        assert "default" in arg
                        assert isinstance(arg["default"], bool)

                    if "regex" in arg:
                        # Regex must ALWAYS be in the format (regex, option)
                        assert isinstance(arg["regex"], (tuple, list))
                        assert len(arg["regex"]) == 2
                        assert isinstance(arg["regex"][0], str)
                        assert arg["regex"][1] is None or isinstance(
                            arg["regex"][1], str
                        )

                        # Compile the regular expression to verify that it is
                        # valid
                        try:
                            re.compile(arg["regex"][0])

                        except Exception as e:
                            # Treat any compilation failure as invalid.
                            pytest.fail(
                                "{} is an invalid regex ({}: {})".format(
                                    arg["regex"][0], type(e).__name__, e
                                )
                            )

                        # Regex should always start and/or end with ^/$
                        assert (
                            re.match(r"^\^.+?$", arg["regex"][0]) is not None
                        )
                        assert (
                            re.match(r"^.+?\$$", arg["regex"][0]) is not None
                        )

                    if arg["type"].startswith("list"):
                        # Delimiters MUST be defined
                        assert "delim" in arg
                        assert isinstance(arg["delim"], (list, tuple))
                        assert len(arg["delim"]) > 0

                else:  # alias_of is in the object
                    # Ensure we're not already in the tokens section
                    # The alias_of object has no value here
                    assert section != "tokens"

                    # must be a string
                    assert isinstance(arg["alias_of"], (str, list, tuple, set))

                    aliases = (
                        [arg["alias_of"]]
                        if isinstance(arg["alias_of"], str)
                        else arg["alias_of"]
                    )

                    for alias_of in aliases:
                        # Track our alias_of object
                        map_to_aliases.add(alias_of)

                        # We can't be an alias_of ourselves
                        if key == alias_of:
                            # This is acceptable as long as we exist in the
                            # tokens table because that is truely what we map
                            # back to
                            assert key in entry["details"]["tokens"]

                        else:
                            # Throw the problem into an assert tag for
                            # debugging purposes... the mapping is not
                            # acceptable
                            assert key != alias_of

                        # alias_of always references back to tokens
                        assert (
                            alias_of in entry["details"]["tokens"]
                            or alias_of in entry["details"]["args"]
                        )

                        # Find a list directive in our tokens
                        t_match = (
                            entry["details"]["tokens"]
                            .get(alias_of, {})
                            .get("type", "")
                            .startswith("list")
                        )

                        a_match = (
                            entry["details"]["args"]
                            .get(alias_of, {})
                            .get("type", "")
                            .startswith("list")
                        )

                        if not (t_match or a_match):
                            # Ensure the only token we have is the alias_of
                            # hence record should look like as example):
                            # {
                            #    'token': {
                            #      'alias_of': 'apitoken',
                            #    },
                            # }
                            #
                            # Or if it can represent more then one entry; in
                            # this case, one must define a name (to define
                            # grouping).
                            # {
                            #    'token': {
                            #      'name': 'Tokens',
                            #      'alias_of': ('apitoken', 'webtoken'),
                            #    },
                            # }
                            if isinstance(arg["alias_of"], str):
                                assert len(entry["details"][section][key]) == 1
                            else:  # is tuple,list, or set
                                assert len(entry["details"][section][key]) == 2
                                # Must have a name defined to define grouping
                                assert "name" in entry["details"][section][key]

                        else:
                            # We're a list, we allow up to 2 variables
                            # Obviously we have the alias_of entry; that's why
                            # were at this part of the code.  But we can
                            # additionally provide a 'delim' over-ride.
                            assert len(entry["details"][section][key]) <= 2
                            if len(entry["details"][section][key]) == 2:
                                # Verify that it is in fact the 'delim' tag
                                assert (
                                    "delim" in entry["details"][section][key]
                                )
                                # If we do have a delim value set, it must be
                                # of a list/set/tuple type
                                assert isinstance(
                                    entry["details"][section][key]["delim"],
                                    (tuple, set, list),
                                )

        spec = inspect.getfullargspec(N_MGR._schema_map[protocols[0]].__init__)

        function_args = (
            (set(parse_list(spec.varkw)) - {"kwargs"})
            | (set(spec.args) - {"self"})
            | valid_kwargs
        )

        # Iterate over our map_to_entries and make sure that everything
        # maps to a function argument
        for arg in map_to_entries:
            if arg not in function_args:
                # This print statement just makes the error easier to
                # troubleshoot
                raise AssertionError(
                    "{}.__init__() expects a {}=None entry according to "
                    "template configuration".format(
                        N_MGR._schema_map[protocols[0]].__name__, arg
                    )
                )

        # Iterate over all of the function arguments and make sure that
        # it maps back to a key
        function_args -= valid_kwargs
        for arg in function_args:
            if arg not in map_to_entries:
                err = N_MGR._schema_map[protocols[0]].__name__.__init__(arg)
                raise AssertionError(
                    f"{err} found but not defined in the template "
                    "configuration"
                )

        # Iterate over our map_to_aliases and make sure they were defined in
        # either the as a token or arg
        for arg in map_to_aliases:
            assert arg in set(entry["details"]["args"].keys()) | set(
                entry["details"]["tokens"].keys()
            )

        # Template verification
        assert "templates" in entry["details"]
        assert isinstance(entry["details"]["templates"], (set, tuple, list))

        # Iterate over our templates and parse our arguments
        for template in entry["details"]["templates"]:
            # Ensure we've properly opened and closed all of our tokens
            assert template.count("{") == template.count("}")

            expected_tokens = template.count("}")
            args = template_token_re.findall(template)
            assert expected_tokens == len(args)

            # Build a cross reference set of our current defined objects
            defined_tokens = set()
            for key, arg in entry["details"]["tokens"].items():
                defined_tokens.add(key)
                if "alias_of" in arg:
                    defined_tokens.add(arg["alias_of"])

            # We want to make sure all of our defined tokens have been
            # accounted for in at least one defined template
            for arg in args:
                assert arg in set(entry["details"]["args"].keys()) | set(
                    entry["details"]["tokens"].keys()
                )

                # The reverse of the above; make sure that each entry defined
                # in the template_tokens is accounted for in at least one of
                # the defined templates
                assert arg in defined_tokens


def test_apprise_details_plugin_raw_template_tokens():
    """Require an explicit type in every raw plugin template token.

    Sanitizing supplies a missing ``string`` default, so this checks the raw
    declarations first.
    """

    # Use the same valid token types as the plugin verification test.
    is_valid_type_re = re.compile(
        r"((choice|list):)?(string|bool|int|float|email)"
    )

    for plugin in N_MGR.plugins():
        label = plugin.__name__

        for section_name, raw in (
            ("template_tokens", plugin.template_tokens),
            ("template_args", plugin.template_args),
        ):
            for key, token in raw.items():
                # alias_of entries are intentionally type-free; skip them
                if "alias_of" in token:
                    continue

                assert "type" in token, (
                    f"{label}.{section_name}[{key!r}] is missing a"
                    " 'type' field. Every non-alias token must declare"
                    " its type explicitly -- _sanitize_token silently"
                    " fills in 'string' and the omission goes"
                    " undetected by the post-processed details() checks."
                )

                assert isinstance(token["type"], str) and (
                    is_valid_type_re.match(token["type"]) is not None
                ), (
                    f"{label}.{section_name}[{key!r}]['type'] ="
                    f" {token['type']!r} is not a valid type string."
                    " Expected one of: string, bool, int, float,"
                    " choice:string, list:string, etc."
                )


def test_apprise_details_email_token_types():
    """Ensure URL email fields declare their token type as ``email``.

    Code that builds URLs from this metadata must leave ``@`` unescaped.
    Add fields only after confirming that behavior in the plugin's ``url()``
    method; a field name alone is not enough.
    """
    # (plugin class name, template_tokens key)
    expected_email_tokens = {
        ("NotifySES", "from_email"),
        ("NotifyPostmark", "from_email"),
        ("NotifyPostmark", "target_email"),
        ("NotifyResend", "from_addr"),
        ("NotifyResend", "target_email"),
        ("NotifyMailerSend", "from_email"),
        ("NotifyMailerSend", "target_email"),
        ("NotifyOffice365", "target_email"),
        ("NotifyOctopush", "api_login"),
        ("NotifyThreema", "target_email"),
        ("NotifyBrevo", "from_email"),
        ("NotifyBrevo", "target_email"),
        ("NotifySendGrid", "from_email"),
        ("NotifySendGrid", "target_email"),
        ("NotifyMailgun", "target_email"),
        ("NotifyOneSignal", "target_email"),
        ("NotifyPingram", "target_email"),
        ("NotifyPushBullet", "target_email"),
        ("NotifySendPulse", "target_email"),
        ("NotifySlack", "target_email"),
        ("NotifyTwist", "email"),
        ("NotifyVoipms", "email"),
        ("NotifyZulip", "target_user"),
    }

    plugins_by_name = {plugin.__name__: plugin for plugin in N_MGR.plugins()}
    found = set()
    for plugin_name, token_key in expected_email_tokens:
        assert plugin_name in plugins_by_name, (
            f"{plugin_name} was not found -- has it been renamed/removed?"
            " Update expected_email_tokens to match."
        )
        plugin = plugins_by_name[plugin_name]
        assert token_key in plugin.template_tokens, (
            f"{plugin_name}.template_tokens no longer defines"
            f" {token_key!r} -- update expected_email_tokens to match."
        )
        assert plugin.template_tokens[token_key]["type"] == "email", (
            f"{plugin_name}.template_tokens[{token_key!r}]['type'] must"
            " stay 'email' -- this field's own url() preserves a literal"
            " '@' when rebuilding the URL, so a client keying off this"
            " metadata needs the same signal."
        )
        found.add((plugin_name, token_key))

    # Scan all declared email tokens so new fields must join the allowlist.
    for plugin in N_MGR.plugins():
        for key, token in plugin.template_tokens.items():
            if token.get("type") == "email":
                assert (plugin.__name__, key) in found, (
                    f"{plugin.__name__}.template_tokens[{key!r}] is tagged"
                    " 'email' but isn't listed in expected_email_tokens --"
                    " add it there (after confirming this field's own"
                    " url() actually needs it, per this test's docstring)."
                )


def test_apprise_send_format_handlers_match_notify_format():
    """
    API: send_text()/send_html()/send_markdown() vs notify_format sanity

    A format-specific send_() method must be reachable through
    the plugin's notify_format declaration.
    """

    for plugin in N_MGR.plugins():
        label = plugin.__name__

        # Only consider format-specific methods defined directly on this
        # class (not merely inherited), so a subclass that narrows
        # notify_format isn't blamed for a handler its parent defined.
        declared_handlers = {
            fmt for fmt in NOTIFY_FORMATS if f"send_{fmt}" in vars(plugin)
        }

        if not declared_handlers:
            continue

        # notify_format may be a single NotifyFormat or a tuple; resolve
        # it the same way NotifyBase._formats() does.
        supported = set(parse_list(plugin.notify_format, sort=False))

        missing = declared_handlers - supported
        assert not missing, (
            f"{label} defines send_{next(iter(missing))}() but "
            f"{next(iter(missing))!r} is not declared in its "
            f"notify_format {plugin.notify_format!r}; the handler can "
            "never be reached."
        )


def test_apprise_multi_format_plugins_no_scalar_comparison():
    """Multi-format plugins must resolve before scalar comparisons."""

    scalar_compare_re = re.compile(r"self\.notify_format\s*==")

    for plugin in N_MGR.plugins():
        formats = parse_list(plugin.notify_format, sort=False)
        if len(formats) <= 1:
            # Single-format plugins can compare their scalar directly.
            continue

        try:
            source = inspect.getsource(plugin)
        except (OSError, TypeError):
            # Dynamic plugins have no source file to inspect.
            continue

        assert not scalar_compare_re.search(source), (
            f"{plugin.__name__} declares a multi-format notify_format "
            f"{plugin.notify_format!r} but compares self.notify_format "
            "directly somewhere in its source; use "
            "self.resolve_format(body_format) instead, since a tuple "
            "never equals a scalar and the comparison can never be "
            "True."
        )


@mock.patch("requests.request")
@mock.patch("asyncio.gather", wraps=asyncio.gather)
@mock.patch(
    "concurrent.futures.ThreadPoolExecutor",
    wraps=concurrent.futures.ThreadPoolExecutor,
)
def test_apprise_async_mode(mock_threadpool, mock_gather, mock_request):
    """
    API: Apprise() async_mode tests

    """
    mock_request.return_value.status_code = requests.codes.ok

    # Define some services
    services = [
        "xml://localhost",
        "json://localhost",
    ]

    # Services use asynchronous mode by default.
    asset = AppriseAsset()
    assert asset.async_mode is True

    # Build an Apprise object with that shared asset.
    a = Apprise(asset=asset)

    # Add both test services.
    a.add(services=services)

    # Both service URLs should load.
    assert len(a) == 2

    # Both services share the asset's asynchronous setting.
    for service in a:
        assert service.asset.async_mode is True

    # Reset the process-wide pool so this test observes its first creation.
    # mock.patch restores any pool that an earlier test created.
    with mock.patch("apprise.apprise._shared_executor", None):
        # Send both notifications asynchronously.
        assert bool(a.notify("async")) is True

        # The first send creates the shared worker pool once.
        assert mock_threadpool.call_count == 1
        mock_threadpool.reset_mock()

        # Repeat the test with asynchronous mode disabled.
        asset = AppriseAsset(async_mode=False)
        assert asset.async_mode is False

        # Build a fresh Apprise object with the new asset.
        a = Apprise(asset=asset)

        # The new object keeps the disabled setting.
        assert a.asset.async_mode is False

        # Add both test services again.
        a.add(services=services)

        # Both service URLs should load.
        assert len(a) == 2

        # Both services now use ordered delivery.
        for service in a:
            assert service.asset.async_mode is False

        # Send both notifications one at a time.
        assert bool(a.notify("sync")) is True
        # Ordered delivery does not need asyncio.gather().
        assert mock_gather.call_count == 0
        mock_gather.reset_mock()

        # Each loaded service exposes the same disabled setting.
        assert a[0].asset.async_mode is False
        assert a[1].asset.async_mode is False

        # Changing the shared asset through one service affects both.
        a[0].asset.async_mode = True
        assert a[0].asset.async_mode is True

        # The second service sees the same shared asset change.
        assert a[1].asset.async_mode is True

        # Give only the second service its own asset.
        a[1].asset = AppriseAsset(async_mode=False)
        assert a[0].asset.async_mode is True
        assert a[1].asset.async_mode is False

        # Send one service each way in the same batch.
        assert bool(a.notify("a mixed batch")) is True

        # The single async-mode service still goes through the thread
        # pool even though it's alone in its batch: AppriseAsset.
        # service_timeout defaults to 60s, so a deadline applies, and
        # only a thread-pool dispatch can abandon a service that runs
        # past its deadline. No NEW executor is constructed though --
        # the one from the first dispatch above is shared and reused.
        assert mock_threadpool.call_count == 0

        # Disable this service's own timeout budget entirely -- with no
        # deadline of any kind in effect, a single async-mode service has
        # nothing that could ever need abandoning, so the thread-pool
        # shortcut applies again (no executor use at all, shared or not).
        a[0].asset = AppriseAsset(async_mode=True, service_timeout=0)
        a[1].asset = AppriseAsset(async_mode=False)
        assert bool(a.notify("a mixed batch, no timeout")) is True
        assert mock_threadpool.call_count == 0

        # Shut down the executor constructed inside this patched block
        # before it's discarded -- otherwise its worker threads would
        # sit idle forever with nothing left referencing them once
        # mock.patch restores apprise.apprise._shared_executor below.
        import apprise.apprise as apprise_module

        if apprise_module._shared_executor is not None:
            apprise_module._shared_executor.shutdown(wait=False)


def test_notify_matrix_dynamic_importing(tmpdir):
    """
    API: Apprise() Notify Matrix Importing

    """

    # Make our new path valid
    suite = tmpdir.mkdir("apprise_notify_test_suite")
    suite.join("__init__.py").write("")

    module_name = "badnotify"

    # Update our path to point to our new test suite
    sys.path.insert(0, str(suite))

    # Create a base area to work within
    base = suite.mkdir(module_name)
    base.join("__init__.py").write("")

    # Test no app_id
    base.join("NotifyBadFile1.py").write(
        cleandoc("""
        class NotifyBadFile1:
            pass
        """)
    )

    # No class of the same name
    base.join("NotifyBadFile2.py").write(
        cleandoc("""
        class BadClassName:
            pass
        """)
    )

    # Exception thrown
    base.join("NotifyBadFile3.py").write("""raise ImportError()""")

    # Utilizes a schema:// already occupied (as string)
    base.join("NotifyGoober.py").write(
        cleandoc("""
        from apprise import NotifyBase
        class NotifyGoober(NotifyBase):
            # This class tests the fact we have a new class name, but we're
            # trying to over-ride items previously used

            # The default simple (insecure) protocol (used by NotifyMail)
            protocol = ('mailto', 'goober')

            # The default secure protocol (used by NotifyMail)
            secure_protocol = 'mailtos'

            @staticmethod
            def parse_url(url, *args, **kwargs):
                # always parseable
                return ConfigBase.parse_url(url, verify_host=False)
        """)
    )

    # Utilizes a schema:// already occupied (as tuple)
    base.join("NotifyBugger.py").write(
        cleandoc("""
        from apprise import NotifyBase
        class NotifyBugger(NotifyBase):
            # This class tests the fact we have a new class name, but we're
            # trying to over-ride items previously used

            # The default simple (insecure) protocol (used by NotifyMail), the
            # other isn't
            protocol = ('mailto', 'bugger-test' )

            # The default secure protocol (used by NotifyMail), the other isn't
            secure_protocol = ('mailtos', ['garbage'])

            @staticmethod
            def parse_url(url, *args, **kwargs):
                # always parseable
                return ConfigBase.parse_url(url, verify_host=False)
            """)
    )

    N_MGR.load_modules(path=str(base), name=module_name)


def test_apprise_ipv6_host_preserved():
    """
    API: an IPv6 host in a URL reaches the plugin intact

    """
    # Compressed IPv6 addresses
    for url, host in (
        ("json://[2001:db8::1]:8080/path", "[2001:db8::1]"),
        ("json://[fd00::5]:8080/path", "[fd00::5]"),
        ("json://[::1]:8080/path", "[::1]"),
        (
            "form://[2001:db8:85a3::8a2e:370:7334]/p",
            "[2001:db8:85a3::8a2e:370:7334]",
        ),
        (
            "xml://[2001:0db8:85a3:0000:0000:8a2e:0370:7334]/p",
            "[2001:0db8:85a3:0000:0000:8a2e:0370:7334]",
        ),
    ):
        obj = Apprise.instantiate(url, suppress_exceptions=False)
        assert obj is not None
        assert obj.host == host

        # The generated url carries the same address, so re-loading it keeps
        # pointing at the same place
        assert host in obj.url()

        reloaded = Apprise.instantiate(obj.url(), suppress_exceptions=False)
        assert reloaded.host == host
        assert reloaded.url() == obj.url()


def test_apprise_ipv6_host_invalid():
    """
    API: a malformed IPv6 host in a URL is refused

    """
    # More than one :: is not a valid address, so there is nothing sensible
    # to deliver to
    for url in (
        "json://[2001:db8::1::2]:8080/path",
        "json://[2001:db8::12345]/path",
        "json://[not:an:address]/path",
    ):
        assert Apprise.instantiate(url, suppress_exceptions=True) is None
caronc-apprise-dfec414/tests/test_apprise_asset.py000066400000000000000000000353211526720371000225400ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
from datetime import timezone, tzinfo
import logging
import sys
from zoneinfo import ZoneInfo

import pytest

from apprise.asset import AppriseAsset
from apprise.exception import AppriseImproperlyConfigured

logging.disable(logging.CRITICAL)

# Ensure we don't create .pyc files for these tests
sys.dont_write_bytecode = True


def test_timezone():
    "asset: timezone() testing"
    asset = AppriseAsset(timezone="utc")
    assert isinstance(asset.tzinfo, tzinfo)

    # Default (uses system value)
    asset = AppriseAsset(timezone=None)
    assert isinstance(asset.tzinfo, tzinfo)

    # Timezone can also already be a tzinfo object
    asset = AppriseAsset(timezone=timezone.utc)
    assert isinstance(asset.tzinfo, tzinfo)
    asset = AppriseAsset(timezone=ZoneInfo("America/Toronto"))
    assert isinstance(asset.tzinfo, tzinfo)

    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(timezone=object)

    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(timezone="invalid")

    # The private field cannot bypass the validated timezone argument.
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(_tzinfo=timezone.utc)


def test_language():
    "asset: language() testing"
    # None leaves the detection of the language up to Apprise
    assert AppriseAsset().language is None

    # Both the 2 and the 5 letter forms are accepted; a region is stored
    # upper case and the language lower case no matter how it arrives
    for entry in ("en", "EN", " en "):
        assert AppriseAsset(language=entry).language == "en"

    for entry in ("en-CA", "en_CA", "EN-ca", "en_ca"):
        assert AppriseAsset(language=entry).language == "en_CA"

    # A script or any other extra part is dropped, leaving the language
    assert AppriseAsset(language="zh-Hans").language == "zh"
    assert AppriseAsset(language="zh-Hans-CN").language == "zh"

    # Only the first entry of an Accept-Language styled value is used
    asset = AppriseAsset(language="en-US,en;q=0.9,de;q=0.5")
    assert asset.language == "en_US"

    # An empty value is the same as not providing one at all
    assert AppriseAsset(language="").language is None
    assert AppriseAsset(language="   ").language is None

    # Anything we can not make sense of is a configuration error
    for entry in ("garbage", "!", 42, {}, object()):
        with pytest.raises(AppriseImproperlyConfigured):
            AppriseAsset(language=entry)

    # The language is locked in once the asset is built; a new language
    # means a new asset
    with pytest.raises(AttributeError):
        AppriseAsset().language = "fr"

    # The private field cannot bypass the validated language argument.
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(_language="garbage")


def test_service_timeout():
    "asset: service_timeout() testing"

    # Default value is 60 seconds, defined directly on AppriseAsset
    asset = AppriseAsset()
    assert asset._service_timeout == 60.0

    # Accepts an int and stores it as a float
    asset = AppriseAsset(service_timeout=10)
    assert asset._service_timeout == 10.0
    assert isinstance(asset._service_timeout, float)

    # Accepts a float directly
    asset = AppriseAsset(service_timeout=12.5)
    assert asset._service_timeout == 12.5

    # 0 is valid -- it disables the timeout entirely
    asset = AppriseAsset(service_timeout=0)
    assert asset._service_timeout == 0.0

    # Negative values are rejected
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(service_timeout=-1)

    # Non-numeric types are rejected
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(service_timeout="invalid")

    # Booleans are rejected even though bool is technically an int subclass
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(service_timeout=True)

    # inf might look like a second way to spell "unbounded" (0 is the
    # documented one), but concurrent.futures.Future.result(timeout=
    # float("inf")) raises OverflowError on some platforms, silently
    # turning a successful notification into a reported FAILURE -- so
    # it's rejected outright, same as any other non-finite value.
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(service_timeout=float("inf"))

    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(service_timeout=float("-inf"))

    # NaN fails every ordering comparison, so it would otherwise slip
    # past a plain "< 0" check and silently disable the timeout as an
    # accidental side effect of its comparison semantics.
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(service_timeout=float("nan"))

    # The private field cannot bypass the validated public argument.
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(_service_timeout=99.0)


def test_payload_max_size():
    "asset: payload_max_size() testing"

    # Zero disables the cap by default.
    asset = AppriseAsset()
    assert asset._payload_max_size == 0

    # Accepts a positive int, turning the cap on
    asset = AppriseAsset(payload_max_size=500)
    assert asset._payload_max_size == 500

    # 0 is valid -- it is also the default, and disables the cap entirely
    asset = AppriseAsset(payload_max_size=0)
    assert asset._payload_max_size == 0

    # Negative values are rejected
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(payload_max_size=-1)

    # Non-int types are rejected -- a float character count makes no sense
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(payload_max_size=12.5)

    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(payload_max_size="invalid")

    # Booleans are rejected even though bool is technically an int subclass
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(payload_max_size=True)

    # The private field cannot bypass the validated public argument.
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(_payload_max_size=250)


def test_payload_buffer_threshold_and_min_buffer():
    "asset: payload_buffer_threshold() / payload_min_buffer() testing"

    # Defaults match the documented values.
    asset = AppriseAsset()
    assert asset._payload_buffer_threshold == 10
    assert asset._payload_min_buffer == 25

    # Public constructor arguments configure both settings.
    asset = AppriseAsset(payload_buffer_threshold=3, payload_min_buffer=5)
    assert asset._payload_buffer_threshold == 3
    assert asset._payload_min_buffer == 5

    # 0 is valid for both.
    asset = AppriseAsset(payload_buffer_threshold=0, payload_min_buffer=0)
    assert asset._payload_buffer_threshold == 0
    assert asset._payload_min_buffer == 0

    # Negative values are rejected.
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(payload_buffer_threshold=-1)

    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(payload_min_buffer=-1)

    # Non-int types are rejected.
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(payload_buffer_threshold=12.5)

    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(payload_min_buffer="invalid")

    # Booleans are rejected even though bool is technically an int subclass.
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(payload_buffer_threshold=True)

    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(payload_min_buffer=True)

    # Private fields cannot bypass the validated public arguments.
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(_payload_buffer_threshold=2)

    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(_payload_min_buffer=7)


def test_result_log_storage_sizes():
    """Result-log storage accepts non-negative byte limits."""
    asset = AppriseAsset()
    assert asset.result_log_memory_size == 0
    assert asset.result_log_disk_size == 0

    asset = AppriseAsset(
        result_log_memory_size=2048, result_log_disk_size=4096
    )
    assert asset.result_log_memory_size == 2048
    assert asset.result_log_disk_size == 4096

    for name in ("result_log_memory_size", "result_log_disk_size"):
        with pytest.raises(AppriseImproperlyConfigured):
            AppriseAsset(**{name: -1})
        for value in (True, 1.5, "1024"):
            with pytest.raises(AppriseImproperlyConfigured):
                AppriseAsset(**{name: value})
        with pytest.raises(AppriseImproperlyConfigured):
            AppriseAsset(**{"_{}".format(name): 1})


def test_enforce_payload_max_size():
    "asset: enforce_payload_max_size() testing"

    # Disabled (the default): nothing is ever trimmed.
    asset = AppriseAsset()
    title, body = asset.enforce_payload_max_size("T" * 100, "B" * 1000)
    assert title == "T" * 100
    assert body == "B" * 1000

    # Already within budget: left untouched.
    asset = AppriseAsset(payload_max_size=2000)
    title, body = asset.enforce_payload_max_size("T" * 100, "B" * 1000)
    assert title == "T" * 100
    assert body == "B" * 1000


def test_enforce_payload_max_size_absent_side():
    "asset: enforce_payload_max_size() never trims a missing side"

    asset = AppriseAsset(payload_max_size=20)

    # An empty title never competes with the body for room.
    title, body = asset.enforce_payload_max_size("", "B" * 1000)
    assert title == ""
    assert len(body) == 20

    # An empty body never competes with the title for room.
    title, body = asset.enforce_payload_max_size("T" * 1000, "")
    assert len(title) == 20
    assert body == ""


def test_enforce_payload_max_size_short_side_guaranteed():
    """asset: keep a short side whole when the other minimum fits"""

    # A short title stays whole; the body receives the remaining room.
    asset = AppriseAsset(payload_max_size=40)
    title, body = asset.enforce_payload_max_size("T" * 9, "B" * 1000)
    assert title == "T" * 9
    assert len(body) == 31

    # The same rule keeps a short body whole.
    title, body = asset.enforce_payload_max_size("T" * 40, "hi!")
    assert title == "T" * 37
    assert body == "hi!"

    # A title exactly at the buffer width still qualifies.
    title, body = asset.enforce_payload_max_size("T" * 10, "B" * 1000)
    assert title == "T" * 10
    assert len(body) == 30


def test_enforce_payload_max_size_guarantee_unaffordable():
    """asset: use proportional sharing when a guarantee cannot fit"""

    # Two long sides share the cap proportionally.
    asset = AppriseAsset(payload_max_size=20)
    title, body = asset.enforce_payload_max_size("T" * 20, "B" * 18)
    assert len(title) + len(body) == 20
    assert len(title) == 10
    assert len(body) == 10

    # The title is short, but the body minimum cannot fit beside it.
    tiny_asset = AppriseAsset(payload_max_size=11)
    title, body = tiny_asset.enforce_payload_max_size("T" * 10, "B" * 1000)
    assert len(title) + len(body) == 11
    assert len(title) == 1
    assert len(body) == 10

    # The mirrored short-body rule also falls back when space is tight.
    balanced_asset = AppriseAsset(payload_max_size=15)
    title, body = balanced_asset.enforce_payload_max_size("T" * 15, "B" * 10)
    assert len(title) + len(body) == 15
    assert len(title) == 9
    assert len(body) == 6


def test_enforce_payload_max_size_proportional_tier():
    "asset: enforce_payload_max_size() proportional split for two long sides"

    # Both sides are longer than the buffer, so title and body share the
    # cap in proportion to their original lengths.
    asset = AppriseAsset(payload_max_size=200)
    title, body = asset.enforce_payload_max_size("T" * 100, "B" * 1000)
    assert len(title) + len(body) == 200
    # The title receives 100/1100 of the budget, rounded down.
    assert len(title) == 18
    assert len(body) == 182

    # A title-heavy split keeps most of the budget for the title.
    heavy_asset = AppriseAsset(payload_max_size=50)
    title, body = heavy_asset.enforce_payload_max_size("T" * 100, "B" * 60)
    assert len(title) + len(body) == 50
    assert len(title) > len(body)

    # Keep one title character when a title longer than the buffer still
    # has its proportional share round down to zero.
    title, body = asset.enforce_payload_max_size("T" * 11, "B" * 2200)
    assert title == "T"
    assert len(body) == 199


def test_enforce_payload_max_size_configurable_tiers():
    "asset: payload_buffer_threshold / payload_min_buffer are tunable"

    # Public constructor arguments can override both settings.
    asset = AppriseAsset(
        payload_max_size=12,
        payload_buffer_threshold=3,
        payload_min_buffer=5,
    )
    assert asset._payload_buffer_threshold == 3
    assert asset._payload_min_buffer == 5

    # Both sides exceed the custom buffer threshold (3), so this falls
    # through to the proportional split.
    title, body = asset.enforce_payload_max_size("T" * 4, "B" * 20)
    assert len(title) == 2
    assert len(body) == 10

    # A title at or below the custom buffer threshold now qualifies for
    # the whole-and-guaranteed rule, using the custom (smaller) minimum.
    custom_asset = AppriseAsset(
        payload_max_size=12,
        payload_buffer_threshold=5,
        payload_min_buffer=3,
    )
    title, body = custom_asset.enforce_payload_max_size("T" * 4, "B" * 20)
    assert title == "T" * 4
    assert len(body) == 8
caronc-apprise-dfec414/tests/test_apprise_attachments.py000066400000000000000000000337401526720371000237370ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from inspect import cleandoc
import json

# Disable logging for a cleaner testing output
import logging
from os.path import dirname, getsize, join
from unittest import mock

import pytest
import requests

from apprise import Apprise, AppriseAsset, AttachmentManager
from apprise.apprise_attachment import AppriseAttachment
from apprise.attachment import AttachBase
from apprise.common import ContentLocation
from apprise.exception import AppriseImproperlyConfigured
from apprise.logger import LogCapture

logging.disable(logging.CRITICAL)

TEST_VAR_DIR = join(dirname(__file__), "var")

# Grant access to our Attachment Manager Singleton
A_MGR = AttachmentManager()


def test_apprise_attachment():
    """
    API: AppriseAttachment basic testing

    """

    # Create ourselves an attachment object
    aa = AppriseAttachment()

    # There are no attachents loaded
    assert len(aa) == 0

    # Object can be directly checked as a boolean; response is False
    # when there are no entries loaded
    assert not aa

    # An attachment object using a custom Apprise Asset object
    # Set a cache expiry of 5 minutes (300 seconds)
    aa = AppriseAttachment(asset=AppriseAsset(), cache=300)

    # still no attachments added
    assert len(aa) == 0

    # Add a file by it's path
    path = join(TEST_VAR_DIR, "apprise-test.gif")
    assert aa.add(path)

    # There is now 1 attachment
    assert len(aa) == 1

    # our attachment took on our cache value
    assert aa[0].cache == 300

    # we can test the object as a boolean and get a value of True now
    assert aa

    # Add another entry already in it's AttachBase format
    response = AppriseAttachment.instantiate(path, cache=True)
    assert isinstance(response, AttachBase)
    assert aa.add(response, asset=AppriseAsset())

    # There is now 2 attachments
    assert len(aa) == 2

    # Cache is initialized to True
    assert aa[1].cache is True

    # Reset our object
    aa = AppriseAttachment()

    # We can add by lists as well in a variety of formats
    attachments = (
        path,
        f"file://{path}?name=newfilename.gif?cache=120",
        AppriseAttachment.instantiate(
            f"file://{path}?name=anotherfilename.gif", cache=100
        ),
    )

    # Add them
    assert aa.add(attachments, cache=False)

    # There is now 3 attachments
    assert len(aa) == 3

    # Take on our fixed cache value of False.
    # The last entry will have our set value of 100
    assert aa[0].cache is False
    # Even though we set a value of 120, we take on the value of False because
    # it was forced on the instantiate call
    assert aa[1].cache is False
    assert aa[2].cache == 100

    # We can pop the last element off of the list as well
    attachment = aa.pop()
    assert isinstance(attachment, AttachBase)
    # we can test of the attachment is valid using a boolean check:
    assert attachment
    assert len(aa) == 2
    assert attachment.path == path
    assert attachment.name == "anotherfilename.gif"
    assert attachment.mimetype == "image/gif"

    # elements can also be directly indexed
    assert isinstance(aa[0], AttachBase)
    assert isinstance(aa[1], AttachBase)

    with pytest.raises(IndexError):
        aa[2]

    # We can iterate over attachments too:
    for count, a in enumerate(aa):
        assert isinstance(a, AttachBase)

        # we'll never iterate more then the number of entries in our object
        assert count < len(aa)

    # Get the file-size of our image
    expected_size = getsize(path) * len(aa)

    # verify that's what we get as a result
    assert aa.size() == expected_size

    # Attachments can also be loaded during the instantiation of the
    # AppriseAttachment object
    aa = AppriseAttachment(attachments)

    # There is now 3 attachments
    assert len(aa) == 3

    # Reset our object
    aa.clear()
    assert len(aa) == 0
    assert not aa

    assert aa.add(
        AppriseAttachment.instantiate(
            f"file://{path}?name=andanother.png&cache=Yes"
        )
    )
    assert aa.add(
        AppriseAttachment.instantiate(
            f"file://{path}?name=andanother.png&cache=No"
        )
    )
    AppriseAttachment.instantiate(
        f"file://{path}?name=andanother.png&cache=600"
    )
    assert aa.add(
        AppriseAttachment.instantiate(
            f"file://{path}?name=andanother.png&cache=600"
        )
    )

    assert len(aa) == 3
    assert aa[0].cache is True
    assert aa[1].cache is False
    assert aa[2].cache == 600

    # Negative cache are not allowed
    assert not aa.add(
        AppriseAttachment.instantiate(
            f"file://{path}?name=andanother.png&cache=-600"
        )
    )

    # Invalid cache value
    assert not aa.add(
        AppriseAttachment.instantiate(
            f"file://{path}?name=andanother.png", cache="invalid"
        )
    )

    # No length change
    assert len(aa) == 3

    # Reset our object
    aa.clear()

    # Garbage in produces garbage out
    assert aa.add(None) is False
    assert aa.add(object()) is False
    assert aa.add(42) is False

    # length remains unchanged
    assert len(aa) == 0

    # We can add by lists as well in a variety of formats
    attachments = (
        None,
        object(),
        42,
        "garbage://",
    )

    # Add our attachments
    assert aa.add(attachments) is False

    # length remains unchanged
    assert len(aa) == 0

    # Direct construction reports attachments that could not be loaded.
    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAttachment("garbage://")

    # Load our other attachment types
    aa = AppriseAttachment(location=ContentLocation.LOCAL)

    # Hosted type won't allow us to import files
    aa = AppriseAttachment(location=ContentLocation.HOSTED)
    assert len(aa) == 0

    # Add our attachments defined a the head of this function
    aa.add(attachments)

    # Our length is still zero because we can't import files in
    # a hosted environment
    assert len(aa) == 0

    # Inaccessible type prevents the adding of new stuff
    aa = AppriseAttachment(location=ContentLocation.INACCESSIBLE)
    assert len(aa) == 0

    # Add our attachments defined a the head of this function
    aa.add(attachments)

    # Our length is still zero
    assert len(aa) == 0

    with pytest.raises(AppriseImproperlyConfigured):
        # Invalid location specified
        AppriseAttachment(location="invalid")

    # test cases when file simply doesn't exist
    aa = AppriseAttachment("file://non-existant-file.png")
    # Our length is still 1
    assert len(aa) == 1
    # Our object will still return a True
    assert aa

    # However our indexed entry will not
    assert not aa[0]

    # length will return 0
    assert len(aa[0]) == 0

    # Total length will also return 0
    assert aa.size() == 0


@mock.patch("requests.request")
def test_apprise_attachment_truncate(mock_request):
    """
    API: AppriseAttachment when truncation in place

    """

    # Prepare our response
    response = requests.Request()
    response.status_code = requests.codes.ok

    # Prepare Mock
    mock_request.return_value = response

    # our Apprise Object
    ap_obj = Apprise()

    # Add ourselves an object set to truncate
    ap_obj.add("json://localhost/?method=GET&overflow=truncate")

    # Create ourselves an attachment object
    aa = AppriseAttachment()

    # There are no attachents loaded
    assert len(aa) == 0

    # Object can be directly checked as a boolean; response is False
    # when there are no entries loaded
    assert not aa

    # Add 2 attachments
    assert aa.add(join(TEST_VAR_DIR, "apprise-test.gif"))
    assert aa.add(join(TEST_VAR_DIR, "apprise-test.png"))

    assert mock_request.call_count == 0
    assert ap_obj.notify(body="body", title="title", attach=aa)

    assert mock_request.call_count == 1

    # Our first item was truncated, so only 1 attachment
    details = mock_request.call_args_list[0]
    assert details[0][0] == "GET"
    dataset = json.loads(details[1]["data"])
    assert len(dataset["attachments"]) == 1

    # Reset our object
    mock_request.reset_mock()

    # our Apprise Object
    ap_obj = Apprise()

    # Add ourselves an object set to upstream
    ap_obj.add("json://localhost/?method=GET&overflow=upstream")

    # Create ourselves an attachment object
    aa = AppriseAttachment()

    # Add 2 attachments
    assert aa.add(join(TEST_VAR_DIR, "apprise-test.gif"))
    assert aa.add(join(TEST_VAR_DIR, "apprise-test.png"))

    assert mock_request.call_count == 0
    assert ap_obj.notify(body="body", title="title", attach=aa)

    assert mock_request.call_count == 1

    # Our item was not truncated, so all attachments
    details = mock_request.call_args_list[0]
    assert details[0][0] == "GET"
    dataset = json.loads(details[1]["data"])
    assert len(dataset["attachments"]) == 2


def test_apprise_attachment_instantiate():
    """
    API: AppriseAttachment.instantiate()

    """
    assert (
        AppriseAttachment.instantiate("file://?", suppress_exceptions=True)
        is None
    )

    assert (
        AppriseAttachment.instantiate("invalid://?", suppress_exceptions=True)
        is None
    )

    class BadAttachType(AttachBase):
        def __init__(self, **kwargs):
            super().__init__(**kwargs)

            # We fail whenever we're initialized
            raise TypeError()

    # Store our bad attachment type in our schema map
    A_MGR["bad"] = BadAttachType

    with pytest.raises(TypeError):
        AppriseAttachment.instantiate("bad://path", suppress_exceptions=False)

    # Same call but exceptions suppressed
    assert (
        AppriseAttachment.instantiate("bad://path", suppress_exceptions=True)
        is None
    )


def test_attachment_matrix_dynamic_importing(tmpdir):
    """
    API: Apprise() Attachment Matrix Importing

    """

    # Make our new path valid
    suite = tmpdir.mkdir("apprise_attach_test_suite")
    suite.join("__init__.py").write("")

    module_name = "badattach"

    # Create a base area to work within
    base = suite.mkdir(module_name)
    base.join("__init__.py").write("")

    # Test no app_id
    base.join("AttachBadFile1.py").write(
        cleandoc("""
        class AttachBadFile1:
            pass
        """)
    )

    # No class of the same name
    base.join("AttachBadFile2.py").write(
        cleandoc("""
        class BadClassName:
            pass
        """)
    )

    # Exception thrown
    base.join("AttachBadFile3.py").write("""raise ImportError()""")

    # Utilizes a schema:// already occupied (as string)
    base.join("AttachGoober.py").write(
        cleandoc("""
        from apprise import AttachBase
        class AttachGoober(AttachBase):
            # This class tests the fact we have a new class name, but we're
            # trying to over-ride items previously used

            # The default simple (insecure) protocol
            protocol = 'http'

            # The default secure protocol
            secure_protocol = 'https'
        """)
    )

    # Utilizes a schema:// already occupied (as tuple)
    base.join("AttachBugger.py").write(
        cleandoc("""
        from apprise import AttachBase
        class AttachBugger(AttachBase):
            # This class tests the fact we have a new class name, but we're
            # trying to over-ride items previously used

            # The default simple (insecure) protocol
            protocol = ('http', 'bugger-test' )

            # The default secure protocol
            secure_protocol = ('https', 'bugger-tests')
        """)
    )

    A_MGR.load_modules(path=str(base), name=module_name)


def test_attachment_manager_no_import_failures():
    """Verify all native attach plugins load without TRACE import errors."""

    # Remove the global test-suite log suppression so TRACE records
    # are visible during the scan below
    logging.disable(logging.NOTSET)

    # Force a clean reload of the native attachment plugin directory
    A_MGR.unload_modules()

    with LogCapture(level=logging.TRACE) as stream:
        # Trigger load_modules() via the lazy-load path
        len(A_MGR)

        # Grab the captured log content before the handler is removed
        content = stream.getvalue()

    # Restore log suppression for the remainder of the test suite
    logging.disable(logging.CRITICAL)

    # Any "import failed" line means a plugin directory was found but
    # contained no loadable Attach* class (e.g. a stale __pycache__
    # directory left behind after a rename).
    failures = [
        line for line in content.splitlines() if "import failed" in line
    ]
    assert not failures, (
        "Attachment plugin import failures detected:\n" + "\n".join(failures)
    )

    # Leave the manager in a clean state for subsequent tests
    A_MGR.unload_modules()
caronc-apprise-dfec414/tests/test_apprise_cli.py000066400000000000000000002707531526720371000222020ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from importlib import reload
from importlib.metadata import PackageNotFoundError
from inspect import cleandoc
import json

# Disable logging for a cleaner testing output
import logging
import os
from os.path import dirname, join
import re
import sys
from typing import ClassVar
from unittest import mock

from click.testing import CliRunner
from helpers import environ
import pytest
import requests

from apprise import (
    Apprise,
    AppriseAsset,
    AppriseResultStatus,
    NotificationManager,
    NotifyBase,
    cli,
)
from apprise.locale import gettext_lazy as _
from apprise.plugins.base import RequirementsSpec

logging.disable(logging.CRITICAL)

# Grant access to our Notification Manager Singleton
N_MGR = NotificationManager()


def test_apprise_cli_nux_env(tmpdir):
    """
    CLI: Nux Environment

    """

    class GoodNotification(NotifyBase):
        def __init__(self, *args, **kwargs):
            super().__init__(*args, **kwargs)

        def notify(self, **kwargs):
            # Pretend everything is okay (when passing --disable-async)
            return True

        async def async_notify(self, **kwargs):
            # Pretend everything is okay
            return True

        def url(self, *args, **kwargs):
            # Support url()
            return "good://"

    class BadNotification(NotifyBase):
        def __init__(self, *args, **kwargs):
            super().__init__(*args, **kwargs)

        async def async_notify(self, **kwargs):
            # Pretend everything is okay
            return False

        def url(self, *args, **kwargs):
            # Support url()
            return "bad://"

    # Set up our notification types
    N_MGR["good"] = GoodNotification
    N_MGR["bad"] = BadNotification

    runner = CliRunner()
    result = runner.invoke(cli.main)
    # no services specified; we return 1 (non-zero)
    assert result.exit_code == 1

    result = runner.invoke(cli.main, ["-v"])
    assert result.exit_code == 1

    result = runner.invoke(cli.main, ["-vv"])
    assert result.exit_code == 1

    result = runner.invoke(cli.main, ["-vvv"])
    assert result.exit_code == 1

    result = runner.invoke(cli.main, ["-vvvv"])
    assert result.exit_code == 1

    # Display version information and exit
    result = runner.invoke(cli.main, ["-V"])
    assert result.exit_code == 0

    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "-b",
            "test body",
            "good://localhost",
        ],
    )
    assert result.exit_code == 0

    with mock.patch("requests.request") as mock_request:
        # Prepare Mock
        mock_request.return_value = requests.Request()
        mock_request.return_value.status_code = requests.codes.ok

        result = runner.invoke(
            cli.main,
            [
                "-t",
                "test title",
                "-b",
                "test body\\nsNewLine",
                # Test using interpret escapes
                "-e",
                # Use our JSON query
                "json://localhost",
            ],
        )
        assert result.exit_code == 0

        # Test our call count
        assert mock_request.call_count == 1
        details = mock_request.call_args_list[0]
        assert details[0][0] == "POST"

        # Our string is now escaped correctly
        assert (
            json.loads(details[1]["data"]).get("message", "")
            == "test body\nsNewLine"
        )

        # Reset
        mock_request.reset_mock()

        result = runner.invoke(
            cli.main,
            [
                "-t",
                "test title",
                "-b",
                "test body\\nsNewLine",
                # No -e switch at all (so we don't escape the above)
                # Use our JSON query
                "json://localhost",
            ],
        )
        assert result.exit_code == 0

        # Test our call count
        assert mock_request.call_count == 1
        details = mock_request.call_args_list[0]
        assert details[0][0] == "POST"

        # Our string is now escaped correctly
        assert (
            json.loads(details[1]["data"]).get("message", "")
            == "test body\\nsNewLine"
        )

    # Run in synchronous mode
    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "-b",
            "test body",
            "good://localhost",
            "--disable-async",
        ],
    )
    assert result.exit_code == 0

    # Test Debug Mode (--debug)
    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "-b",
            "test body",
            "good://localhost",
            "--debug",
        ],
    )
    assert result.exit_code == 0

    # Test Debug Mode (-D)
    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "-b",
            "test body",
            "good://localhost",
            "-D",
        ],
    )
    assert result.exit_code == 0

    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "good://localhost",
        ],
        input="test stdin body\n",
    )
    assert result.exit_code == 0

    # Run in synchronous mode
    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "good://localhost",
            "--disable-async",
        ],
        input="test stdin body\n",
    )
    assert result.exit_code == 0

    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "-b",
            "test body",
            "bad://localhost",
        ],
    )
    assert result.exit_code == 1

    # Run in synchronous mode
    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "-b",
            "test body",
            "bad://localhost",
            "-Da",
        ],
    )
    assert result.exit_code == 1

    # Testing with the --dry-run flag reveals a successful response since we
    # don't actually execute the bad:// notification; we only display it
    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "-b",
            "test body",
            "bad://localhost",
            "--dry-run",
        ],
    )
    assert result.exit_code == 0

    # Write a simple text based configuration file
    t = tmpdir.mkdir("apprise-obj").join("apprise")
    buf = f"""
    # Include ourselves
    include {t!s}

    taga,tagb=good://localhost
    tagc=good://nuxref.com
    """
    t.write(buf)

    # This will read our configuration and not send any notices at all
    # because we assigned tags to all of our urls and didn't identify
    # a specific match below.

    # 'include' reference in configuration file would have included the file a
    # second time (since recursion default is 1).
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "test config",
            "--config",
            str(t),
        ],
    )
    # Even when recursion take place, tags are all honored
    # so 2 is returned because nothing was notified
    assert result.exit_code == 3

    # This will send out 1 notification because our tag matches
    # one of the entries above
    # translation: has taga
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "has taga",
            "--config",
            str(t),
            "--tag",
            "taga",
        ],
    )
    assert result.exit_code == 0

    # Test recursion
    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "-b",
            "test body",
            "--config",
            str(t),
            "--tag",
            "tagc",
            # Invalid entry specified for recursion
            "-R",
            "invalid",
        ],
    )
    assert result.exit_code == 2

    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "-b",
            "test body",
            "--config",
            str(t),
            "--tag",
            "tagc",
            # missing entry specified for recursion
            "--recursive-depth",
        ],
    )
    assert result.exit_code == 2

    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "-b",
            "test body",
            "--config",
            str(t),
            "--tag",
            "tagc",
            # Disable recursion (thus inclusion will be ignored)
            "-R",
            "0",
        ],
    )
    assert result.exit_code == 0

    # Test recursion
    result = runner.invoke(
        cli.main,
        [
            "-t",
            "test title",
            "-b",
            "test body",
            "--config",
            str(t),
            "--tag",
            "tagc",
            # Recurse up to 5 times
            "--recursion-depth",
            "5",
        ],
    )
    assert result.exit_code == 0

    # This will send out 2 notifications because by specifying 2 tag
    # entries, we 'or' them together:
    # translation: has taga or tagb or tagd
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "has taga OR tagc OR tagd",
            "--config",
            str(t),
            "--tag",
            "taga",
            "--tag",
            "tagc",
            "--tag",
            "tagd",
        ],
    )
    assert result.exit_code == 0

    # Write a simple text based configuration file
    t = tmpdir.mkdir("apprise-obj2").join("apprise-test2")
    buf = """
    good://localhost/1
    good://localhost/2
    good://localhost/3
    good://localhost/4
    good://localhost/5
    myTag=good://localhost/6
    """
    t.write(buf)

    # This will read our configuration and send a notification to
    # the first 5 entries in the list, but not the one that has
    # the tag associated with it
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "test config",
            "--config",
            str(t),
        ],
    )
    assert result.exit_code == 0

    # Test our notification type switch (it defaults to info) so we want to
    # try it as a different value. Should return without a problem
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "# test config",
            "--config",
            str(t),
            "-n",
            "success",
        ],
    )
    assert result.exit_code == 0

    # Test our notification type switch when set to something unsupported
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "test config",
            "--config",
            str(t),
            "--notification-type",
            "invalid",
        ],
    )
    # An error code of 2 is returned if invalid input is specified on the
    # command line
    assert result.exit_code == 2

    # The notification type switch is case-insensitive
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "test config",
            "--config",
            str(t),
            "--notification-type",
            "WARNING",
        ],
    )
    assert result.exit_code == 0

    # Test our formatting switch (it defaults to text) so we want to try it as
    # a different value. Should return without a problem
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "# test config",
            "--config",
            str(t),
            "-i",
            "markdown",
        ],
    )
    assert result.exit_code == 0

    # Test our formatting switch when set to something unsupported
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "test config",
            "--config",
            str(t),
            "--input-format",
            "invalid",
        ],
    )
    # An error code of 2 is returned if invalid input is specified on the
    # command line
    assert result.exit_code == 2

    # The formatting switch is not case sensitive
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "# test config",
            "--config",
            str(t),
            "--input-format",
            "HTML",
        ],
    )
    assert result.exit_code == 0

    # As a way of ensuring we match the first 5 entries, we can run a
    # --dry-run against the same result set above and verify the output
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "test config",
            "--config",
            str(t),
            "--dry-run",
        ],
    )
    assert result.exit_code == 0
    lines = re.split(r"[\r\n]", result.output.strip())
    # 5 lines of all good:// entries matched + url id underneath
    assert len(lines) == 10
    # Verify we match against the remaining good:// entries
    for i in range(0, 10, 2):
        assert lines[i].endswith("good://")

    # Tags are case-insensitive; mytag matches myTag
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "has mytag",
            "--config",
            str(t),
            "--tag",
            "mytag",
        ],
    )
    assert result.exit_code == 0

    # Same command with --dry-run; one entry matches so exit code is 0
    result = runner.invoke(
        cli.main,
        ["-b", "has mytag", "--config", str(t), "--tag", "mytag", "--dry-run"],
    )
    assert result.exit_code == 0

    # A tag that does not exist in the config produces no matches; the live
    # run returns exit code 3 to signal "no services found".
    result = runner.invoke(
        cli.main,
        ["-b", "no match", "--config", str(t), "--tag", "nonexistent"],
    )
    assert result.exit_code == 3

    # --dry-run must mirror the live result: a non-matching tag also returns
    # exit code 3, not 0.  This guards against dry-run masking "no services
    # found" by always reporting success.
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "no match",
            "--config",
            str(t),
            "--tag",
            "nonexistent",
            "--dry-run",
        ],
    )
    assert result.exit_code == 3

    # Here is a case where we get what was expected; we also attach a file
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "has myTag",
            "--config",
            str(t),
            "--attach",
            join(dirname(__file__), "var", "apprise-test.gif"),
            "--tag",
            "myTag",
        ],
    )
    assert result.exit_code == 0

    # Testing with the --dry-run flag reveals the same positive results
    # because there was at least one match
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "has myTag",
            "--config",
            str(t),
            "--tag",
            "myTag",
            "--dry-run",
        ],
    )
    assert result.exit_code == 0

    #
    # Test environment variables
    #
    # Write a simple text based configuration file
    t2 = tmpdir.mkdir("apprise-obj-env").join("apprise")
    buf = """
    # A general one
    good://localhost

    # A failure (if we use the fail tag)
    fail=bad://localhost

    # A normal one tied to myTag
    myTag=good://nuxref.com
    """
    t2.write(buf)

    with environ(APPRISE_URLS="good://localhost"):
        # This will load okay because we defined the environment
        # variable with a valid URL
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "test environment",
                # Test that we ignore our tag
                "--tag",
                "mytag",
            ],
        )
        assert result.exit_code == 0

        # Same action but without --tag
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "test environment",
            ],
        )
        assert result.exit_code == 0

    with (
        mock.patch("apprise.cli.DEFAULT_CONFIG_PATHS", []),
        environ(APPRISE_URLS="      "),
    ):
        # An empty string is not valid and therefore not loaded so the below
        # fails. We override the DEFAULT_CONFIG_PATHS because we don't want to
        # detect ones loaded on the machine running the unit tests
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "test environment",
            ],
        )
        assert result.exit_code == 1

    with environ(APPRISE_URLS="bad://localhost"):
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "test environment",
            ],
        )
        assert result.exit_code == 1

        # An inline URL overrides the environment.
        # variable
        result = runner.invoke(
            cli.main,
            [
                "-t",
                "test title",
                "-b",
                "test body",
                "good://localhost",
            ],
        )
        assert result.exit_code == 0

        # A Config file also over-rides the environment variable if
        # specified on the command line:
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "has myTag",
                "--config",
                str(t2),
                "--tag",
                "myTag",
            ],
        )
        assert result.exit_code == 0

    with environ(APPRISE_CONFIG_PATH=str(t2)):
        # Load the configuration from the current environment variable.
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "has myTag",
                "--tag",
                "myTag",
            ],
        )
        assert result.exit_code == 0

    with environ(APPRISE_CONFIG=str(t2)):
        # The deprecated name still works and emits a notice.
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "has myTag",
                "--tag",
                "myTag",
            ],
        )
        assert result.exit_code == 0

    with environ(
        APPRISE_CONFIG_PATH=str(t2),
        APPRISE_CONFIG="garbage/file/path.yaml",
    ):
        # Prefer APPRISE_CONFIG_PATH when both names are defined.
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "has myTag",
                "--tag",
                "myTag",
            ],
        )
        assert result.exit_code == 0

    with environ(APPRISE_CONFIG_PATH=str(t2) + ";/another/path"):
        # The current variable accepts multiple configuration paths.
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "has myTag",
                "--tag",
                "myTag",
            ],
        )
        assert result.exit_code == 0

    with (
        mock.patch("apprise.cli.DEFAULT_CONFIG_PATHS", []),
        environ(APPRISE_CONFIG_PATH="      "),
    ):
        # We will fail to send the notification as no path was specified.
        # We override the DEFAULT_CONFIG_PATHS because we don't want to detect
        # ones loaded on the machine running the unit tests
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "my message",
            ],
        )
        assert result.exit_code == 1

    with environ(APPRISE_CONFIG_PATH="garbage/file/path.yaml"):
        # We will fail to send the notification as the path
        # specified is not loadable
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "my message",
            ],
        )
        assert result.exit_code == 1

        # A command-line configuration overrides the invalid environment path.
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "has myTag",
                "--config",
                str(t2),
                "--tag",
                "myTag",
            ],
        )
        assert result.exit_code == 0

    # Explicit URLs take priority over --config.
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "has myTag",
            "--config",
            str(t2),
            "good://localhost",
            "--tag",
            "fail",
        ],
    )
    # Tags are ignored, URL specified, so it trump config
    assert result.exit_code == 0

    # we just repeat the test as a proof that it only executes
    # the urls despite the fact the --config was specified
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "reads the url entry only",
            "--config",
            str(t2),
            "good://localhost",
            "--tag",
            "fail",
        ],
    )
    # Tags are ignored, URL specified, so it trump config
    assert result.exit_code == 0

    # once agian, but we call bad://
    result = runner.invoke(
        cli.main,
        [
            "-b",
            "reads the url entry only",
            "--config",
            str(t2),
            "bad://localhost",
            "--tag",
            "myTag",
        ],
    )
    assert result.exit_code == 1

    # Test Escaping:
    result = runner.invoke(
        cli.main,
        [
            "-e",
            "-t",
            "test\ntitle",
            "-b",
            "test\nbody",
            "good://localhost",
        ],
    )
    assert result.exit_code == 0

    # Test Escaping (without title)
    result = runner.invoke(
        cli.main,
        [
            "--interpret-escapes",
            "-b",
            "test\nbody",
            "good://localhost",
        ],
    )
    assert result.exit_code == 0

    # Test Emojis:
    result = runner.invoke(
        cli.main,
        [
            "-j",
            "-t",
            ":smile:",
            "-b",
            ":grin:",
            "good://localhost",
        ],
    )
    assert result.exit_code == 0

    result = runner.invoke(
        cli.main,
        [
            "--interpret-emojis",
            "-t",
            ":smile:",
            "-b",
            ":grin:",
            "good://localhost",
        ],
    )
    assert result.exit_code == 0


def test_apprise_cli_modules(tmpdir):
    """
    CLI: --plugin (-P)

    """

    runner = CliRunner()

    #
    # Loading of modules works correctly
    #
    notify_cmod_base = tmpdir.mkdir("cli_modules")
    notify_cmod = notify_cmod_base.join("hook.py")
    notify_cmod.write(
        cleandoc("""
    from apprise.decorators import notify

    @notify(on="climod")
    def mywrapper(body, title, notify_type, *args, **kwargs):
        pass
    """)
    )

    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            str(notify_cmod),
            "-t",
            "title",
            "-b",
            "body",
            "climod://",
        ],
    )

    assert result.exit_code == 0

    # Test -P
    result = runner.invoke(
        cli.main,
        [
            "-P",
            str(notify_cmod),
            "-t",
            "title",
            "-b",
            "body",
            "climod://",
        ],
    )

    assert result.exit_code == 0

    # Test double hooks
    notify_cmod2 = notify_cmod_base.join("hook2.py")
    notify_cmod2.write(
        cleandoc("""
    from apprise.decorators import notify

    @notify(on="climod2")
    def mywrapper(body, title, notify_type, *args, **kwargs):
        pass
    """)
    )

    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            str(notify_cmod),
            "--plugin-path",
            str(notify_cmod2),
            "-t",
            "title",
            "-b",
            "body",
            "climod://",
            "climod2://",
        ],
    )

    assert result.exit_code == 0

    with environ(
        APPRISE_PLUGIN_PATH=str(notify_cmod) + ";" + str(notify_cmod2)
    ):
        # Leverage our environment variables to specify the plugin path
        result = runner.invoke(
            cli.main,
            [
                "-b",
                "body",
                "climod://",
                "climod2://",
            ],
        )

        assert result.exit_code == 0


@pytest.mark.skipif(
    sys.platform == "win32", reason="Unreliable results to be determined"
)
def test_apprise_cli_persistent_storage(tmpdir):
    """
    CLI: test persistent storage

    """

    # This is a made up class that is just used to verify
    class NoURLIDNotification(NotifyBase):
        """A no URL ID."""

        # Update URL identifier
        url_identifier = False

        def __init__(self, *args, **kwargs):
            super().__init__(*args, **kwargs)

        def send(self, **kwargs):

            # Pretend everything is okay
            return True

        def url(self, *args, **kwargs):
            # Support URL
            return "noper://"

        def parse_url(self, *args, **kwargs):
            # parse our url
            return {"schema": "noper"}

    # This is a made up class that is just used to verify
    class TestNotification(NotifyBase):
        """A Testing Script."""

        def __init__(self, *args, **kwargs):
            super().__init__(*args, **kwargs)

        def send(self, **kwargs):

            # Test our persistent settings
            self.store.set("key", "value")
            assert self.store.get("key") == "value"

            # Pretend everything is okay
            return True

        def url(self, *args, **kwargs):
            # Support URL
            return "test://"

        def parse_url(self, *args, **kwargs):
            # parse our url
            return {"schema": "test"}

    # assign test:// to our  notification defined above
    N_MGR["test"] = TestNotification
    N_MGR["noper"] = NoURLIDNotification

    # Write a simple text based configuration file
    config = tmpdir.join("apprise.cfg")
    buf = cleandoc("""
    # Create a config file we can source easily
    test=test://
    noper=noper://

    # Define a second test URL that will
    two-urls=test://

    # Create another entry that has no tag associatd with it
    test://?entry=2
    """)
    config.write(buf)

    runner = CliRunner()

    # Generate notification that creates persistent data
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
            "list",
        ],
    )
    # list our entries
    assert result.exit_code == 0

    # our persist storage has not been created yet
    stdout = result.stdout.strip()

    # Click output can wrap based on terminal width, and storage backend
    # sizes are not stable across Python/OS variations. Validate semantics.
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+unused\b",
        stdout,
        re.MULTILINE,
    )
    assert re.search(r"(?m)^\s*-\s+test://\s*$", stdout)

    # An invalid mode specified
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--storage-mode",
            "invalid",
            "--config",
            str(config),
            "-g",
            "test",
            "-t",
            "title",
            "-b",
            "body",
        ],
    )
    # Bad mode specified
    assert result.exit_code == 2

    # Invalid uid lenth specified
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--storage-mode",
            "flush",
            "--storage-uid-length",
            1,
            "--config",
            str(config),
            "-g",
            "test",
            "-t",
            "title",
            "-b",
            "body",
        ],
    )
    # storage uid length to small
    assert result.exit_code == 2

    # No files written yet; just config file exists
    dir_content = os.listdir(str(tmpdir))
    assert len(dir_content) == 1
    assert "apprise.cfg" in dir_content

    # Generate notification that creates persistent data
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--storage-mode",
            "flush",
            "--config",
            str(config),
            "-t",
            "title",
            "-b",
            "body",
            "-g",
            "test",
        ],
    )
    # We parsed our data accordingly
    assert result.exit_code == 0

    dir_content = os.listdir(str(tmpdir))
    assert len(dir_content) == 2
    assert "apprise.cfg" in dir_content
    assert "ea482db7" in dir_content

    # Have a look at our storage listings
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
            "list",
        ],
    )
    # list our entries
    assert result.exit_code == 0

    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )

    # keyword list is not required
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
        ],
    )
    # list our entries
    assert result.exit_code == 0

    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )

    # search on something that won't match
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
            "list",
            "nomatch",
        ],
    )
    # list our entries
    assert result.exit_code == 0

    assert not result.stdout.strip()

    # closest match search
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
            "list",
            # Closest match will hit a result
            "ea",
        ],
    )
    # list our entries
    assert result.exit_code == 0

    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )

    # list is the presumed option if no match
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
            # Closest match will hit a result
            "ea",
        ],
    )
    # list our entries successfully again..
    assert result.exit_code == 0

    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )

    # Search based on tag
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
            "list",
            # We can match by tags too
            "-g",
            "test",
        ],
    )
    # list our entries
    assert result.exit_code == 0

    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )

    # Create a stale 8-char namespace on disk that belongs to a different
    # URL — it must NOT appear in the output when filtering by URL.
    tmpdir.mkdir("aaaaaaaa")

    # Filter by URL directly — no config file required; the URL is loaded
    # inline and its uid is used to match storage entries.
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "storage",
            "list",
            # Pass the raw URL instead of an 8-char UID prefix
            "test://",
        ],
    )
    # Should produce exactly one entry (the url's namespace); the
    # unrelated stale directory 'aaaaaaaa' must not bleed into output.
    assert result.exit_code == 0

    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )
    # Confirm only one entry — stale 'aaaaaaaa' must be absent
    assert not re.search(r"aaaaaaaa", stdout)

    # URL filter alongside --config: URL filters trump all other sources,
    # including --config.  'a' is reset and only the URL-filter plugin
    # is loaded.  Its storage was already created, so exactly one active
    # entry should appear.
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
            "list",
            "test://",
        ],
    )
    assert result.exit_code == 0
    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )

    # Duplicate URL filter: the same URL specified twice.  Both entries
    # are added to the fresh Apprise instance; the uids dict groups them
    # under one uid key, so only a single storage entry should appear.
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "storage",
            "list",
            "test://",
            "test://",
        ],
    )
    assert result.exit_code == 0
    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )
    # Only one numbered entry should appear despite two URL arguments
    assert len(re.findall(r"^\d+\.", stdout, re.MULTILINE)) == 1

    # URL filter with an unrecognised schema: a.add() silently rejects the
    # URL, leaving the Apprise instance empty.  With no plugin uids resolved,
    # disk_scan is skipped entirely and the output is empty.
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "storage",
            "list",
            "nosuchschema://filter",
        ],
    )
    assert result.exit_code == 0
    assert not result.stdout.strip()

    # URL filter with --tag: URL filter fires rule #1 which clears the tag
    # (same as sending a notification — URLs trump all, including tags).
    # The test:// plugin's storage is shown; the stale dirs are absent
    # because disk_scan is scoped to the URL-filter plugin's uid.
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--tag",
            "test",
            "storage",
            "list",
            "test://",
        ],
    )
    assert result.exit_code == 0
    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )
    # Stale dirs must not bleed into output when URL filter is active
    assert not re.search(r"aaaaaaaa", stdout)

    # URL filter scopes PRUNE too: only the test:// plugin's storage
    # directory is eligible; stale dirs like 'aaaaaaaa' are left alone.
    # Use --dry-run so we exercise the _had_url_filters namespace-scoping
    # branch without actually modifying disk (keeping ea482db7 active for
    # the assertions that follow).
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--storage-prune-days",
            0,
            "--dry-run",
            "storage",
            "prune",
            "test://",
        ],
    )
    assert result.exit_code == 0
    # The stale 'aaaaaaaa' directory must still exist after the URL-scoped
    # prune because it was outside the test:// namespace.
    assert os.path.isdir(os.path.join(str(tmpdir), "aaaaaaaa"))

    # URL filter scopes CLEAR too: only the test:// plugin's namespace is
    # cleared; unrelated stale directories are untouched.
    # Use --dry-run so we exercise the _had_url_filters scoping path
    # without wiping ea482db7 contents (subsequent tests expect it active).
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--dry-run",
            "storage",
            "clear",
            "test://",
        ],
    )
    assert result.exit_code == 0
    # 'aaaaaaaa' must still be present — it was outside the cleared scope
    assert os.path.isdir(os.path.join(str(tmpdir), "aaaaaaaa"))

    # Tag-scoped PRUNE: --tag limits the prune namespace to only the uids
    # that matched the tag filter.  The stale 'aaaaaaaa' directory is
    # outside that namespace and must not be removed.
    # Use --dry-run so the test is non-destructive and ea482db7 stays active.
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "--tag",
            "test",
            "--storage-prune-days",
            0,
            "--dry-run",
            "storage",
            "prune",
        ],
    )
    assert result.exit_code == 0
    # The stale 'aaaaaaaa' directory must be untouched — it was outside the
    # tag-scoped prune namespace.
    assert os.path.isdir(os.path.join(str(tmpdir), "aaaaaaaa"))

    # Tag-scoped CLEAR: same principle — only the tagged plugin's namespace
    # is eligible for clearing; everything else is left alone.
    # Use --dry-run to keep ea482db7 active for subsequent assertions.
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "--tag",
            "test",
            "--dry-run",
            "storage",
            "clear",
        ],
    )
    assert result.exit_code == 0
    # The stale 'aaaaaaaa' directory must survive — it was not in scope
    assert os.path.isdir(os.path.join(str(tmpdir), "aaaaaaaa"))

    # When a tag or URL filter is specified but resolves to nothing,
    # disk_prune() must NOT be called. The tests below confirm that ea482db7
    # survives each no-match check.

    # Tag-scoped PRUNE with a tag that matches no loaded plugin: nothing
    # resolves so disk_prune() must be skipped entirely.
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "--tag",
            "no-such-tag",
            "--storage-prune-days",
            0,
            "storage",
            "prune",
        ],
    )
    assert result.exit_code == 0
    # A prune with no matches must leave existing storage intact.
    assert os.path.isdir(os.path.join(str(tmpdir), "ea482db7"))

    # Tag-scoped CLEAR with the same unmatchable tag: same guard must fire.
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "--tag",
            "no-such-tag",
            "storage",
            "clear",
        ],
    )
    assert result.exit_code == 0
    # A clear with no matches must leave existing storage intact.
    assert os.path.isdir(os.path.join(str(tmpdir), "ea482db7"))

    # URL filter that fails to load (unknown schema): _had_url_filters is
    # True but no uid resolves, so disk_prune() must not be called.
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--storage-prune-days",
            0,
            "storage",
            "prune",
            "nosuchschema://",
        ],
    )
    assert result.exit_code == 0
    assert os.path.isdir(os.path.join(str(tmpdir), "ea482db7"))

    # Same guard applies to clear when the URL filter resolves nothing.
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "storage",
            "clear",
            "nosuchschema://",
        ],
    )
    assert result.exit_code == 0
    assert os.path.isdir(os.path.join(str(tmpdir), "ea482db7"))

    # Prune call but prune-days set incorrectly
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--storage-prune-days",
            -1,
            "storage",
            "prune",
        ],
    )
    # storage prune days is invalid
    assert result.exit_code == 2

    # Create a tmporary namespace
    tmpdir.mkdir("namespace")

    # Generates another listing
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
        ],
    )

    # list our entries
    assert result.exit_code == 0

    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )
    assert re.match(
        r".*\s*[0-9]\.\s+namespace\s+0\.00B\s+stale.*",
        stdout,
        (re.MULTILINE | re.DOTALL),
    )

    # Generates another listing but utilize the tag
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "--tag",
            "test",
            "storage",
        ],
    )

    # list our entries
    assert result.exit_code == 0

    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )
    assert (
        re.match(
            r".*\s*[0-9]\.\s+namespace\s+0\.00B\s+stale.*",
            stdout,
            (re.MULTILINE | re.DOTALL),
        )
        is None
    )

    # Clear all of our accumulated disk space
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
            "clear",
        ],
    )

    # successful
    assert result.exit_code == 0

    # Generate another listing
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
        ],
    )

    # list our entries
    assert result.exit_code == 0

    stdout = result.stdout.strip()
    # back to unused state and 0 bytes
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+unused\b",
        stdout,
        re.MULTILINE,
    )
    # namespace is gone now
    assert (
        re.match(
            r".*\s*[0-9]\.\s+namespace\s+0\.00B\s+stale.*",
            stdout,
            (re.MULTILINE | re.DOTALL),
        )
        is None
    )

    # Provide both tags and uid
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
            "ea",
            "-g",
            "test",
        ],
    )

    # list our entries
    assert result.exit_code == 0

    stdout = result.stdout.strip()
    # back to unused state and 0 bytes
    assert re.match(
        r"^[0-9]\.\s+[a-z0-9_-]{8}\s+0\.00B\s+unused\s+-\s+test://$",
        stdout,
        re.MULTILINE,
    )

    # Generate notification that creates persistent data
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--storage-mode",
            "flush",
            "--config",
            str(config),
            "-t",
            "title",
            "-b",
            "body",
            "-g",
            "test",
        ],
    )
    # We parsed our data accordingly
    assert result.exit_code == 0

    # Have a look at our storage listings
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
            "list",
        ],
    )
    # list our entries
    assert result.exit_code == 0

    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )

    # Prune call but prune-days set incorrectly
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "storage",
            "prune",
        ],
    )

    # Run our prune successfully
    assert result.exit_code == 0

    # Have a look at our storage listings (expected no change in output)
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
            "list",
        ],
    )
    # list our entries
    assert result.exit_code == 0

    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+active\b",
        stdout,
        re.MULTILINE,
    )

    # Prune call but prune-days set incorrectly
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            # zero simulates a full clean
            "--storage-prune-days",
            0,
            "storage",
            "prune",
        ],
    )

    # Run our prune successfully
    assert result.exit_code == 0

    # Have a look at our storage listings (expected no change in output)
    result = runner.invoke(
        cli.main,
        [
            "--storage-path",
            str(tmpdir),
            "--config",
            str(config),
            "storage",
            "list",
        ],
    )
    # list our entries
    assert result.exit_code == 0

    # Note: An prune/expiry of zero gets everything except for MS Windows
    # during testing only.
    # Until this can be resolved, this is the section of the test that
    # caused us to disable it in MS Windows
    stdout = result.stdout.strip()
    assert re.search(
        r"^1\.\s+[a-z0-9_-]{8}\s+\d+(?:\.\d{2})?[KMGT]?B\s+unused\b",
        stdout,
        re.MULTILINE,
    )

    # New Temporary namespace
    new_persistent_base = tmpdir.mkdir("namespace")
    with environ(APPRISE_STORAGE_PATH=str(new_persistent_base)):
        # Reload our module
        reload(cli)

        # Nothing in our directory yet
        dir_content = os.listdir(str(new_persistent_base))
        assert len(dir_content) == 0

        # Generate notification that creates persistent data
        # storage path is pulled out of our environment variable
        result = runner.invoke(
            cli.main,
            [
                "--storage-mode",
                "flush",
                "--config",
                str(config),
                "-t",
                "title",
                "-b",
                "body",
                "-g",
                "test",
            ],
        )
        # We parsed our data accordingly
        assert result.exit_code == 0

        # Now content exists
        dir_content = os.listdir(str(new_persistent_base))
        assert len(dir_content) == 1

    # Reload our module with our environment variable gone
    reload(cli)

    # Clear loaded modules
    N_MGR.unload_modules()


@pytest.mark.parametrize(
    "prune_days, uid_length, expected",
    [
        ("", "", (30, 8)),
        ("   ", "abc", (30, 8)),
        ("not-a-number", "", (30, 8)),
        ("45", " 12 ", (45, 12)),
    ],
)
def test_apprise_cli_storage_env_defaults(prune_days, uid_length, expected):
    """
    CLI: an empty or invalid storage environment variable no longer breaks
    loading the CLI or --help

    """
    try:
        with environ(
            APPRISE_STORAGE_PRUNE_DAYS=prune_days,
            APPRISE_STORAGE_UID_LENGTH=uid_length,
        ):
            reload(cli)
            assert expected == (
                cli.DEFAULT_STORAGE_PRUNE_DAYS,
                cli.DEFAULT_STORAGE_UID_LENGTH,
            )

            result = CliRunner().invoke(cli.main, ["--help"])
            assert result.exit_code == 0
    finally:
        reload(cli)


def test_apprise_cli_storage_env_invalid():
    """CLI: a non-numeric storage environment variable stops the CLI."""
    try:
        with environ(APPRISE_STORAGE_PRUNE_DAYS="abc"):
            reload(cli)
            assert cli.INVALID_ENV == [("APPRISE_STORAGE_PRUNE_DAYS", "abc")]

            # --help still works so the user can find the right value
            result = CliRunner().invoke(cli.main, ["--help"])
            assert result.exit_code == 0

            # Anything else stops with a message naming the variable
            result = CliRunner().invoke(cli.main, ["-b", "test"])
            assert result.exit_code == 2
            assert "APPRISE_STORAGE_PRUNE_DAYS" in result.output
    finally:
        reload(cli)


def test_apprise_cli_details(tmpdir):
    """
    CLI: --details (-l)

    """

    runner = CliRunner()

    #
    # Testing the printout of our details
    #   --details or -l
    #
    result = runner.invoke(
        cli.main,
        [
            "--details",
        ],
    )
    assert result.exit_code == 0

    result = runner.invoke(
        cli.main,
        [
            "-l",
        ],
    )
    assert result.exit_code == 0

    # Clear loaded modules
    N_MGR.unload_modules()

    # This is a made up class that is just used to verify
    class TestReq01Notification(NotifyBase):
        """This class is used to test various requirement configurations."""

        # Set some requirements
        requirements: ClassVar[RequirementsSpec] = {
            "packages_required": [
                "cryptography <= 3.4",
                "ultrasync",
            ],
            "packages_recommended": "django",
        }

        def url(self, **kwargs):
            # Support URL
            return ""

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["req01"] = TestReq01Notification

    # This is a made up class that is just used to verify
    class TestReq02Notification(NotifyBase):
        """This class is used to test various requirement configurations."""

        # Just not enabled at all
        enabled = False

        # Set some requirements
        requirements: ClassVar[RequirementsSpec] = {
            # None and/or [] is implied, but jsut to show that the code won't
            # crash if explicitly set this way:
            "packages_required": None,
            "packages_recommended": [
                "cryptography <= 3.4",
            ],
        }

        def url(self, **kwargs):
            # Support URL
            return ""

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["req02"] = TestReq02Notification

    # This is a made up class that is just used to verify
    class TestReq03Notification(NotifyBase):
        """This class is used to test various requirement configurations."""

        # Set requirements with a custom details value.
        requirements: ClassVar[RequirementsSpec] = {
            # Allow callers to override the plugin's default details.
            "details": _("some specified requirement details"),
            # We can set a string value as well (it does not have to be a list)
            "packages_recommended": "cryptography <= 3.4",
        }

        def url(self, **kwargs):
            # Support URL
            return ""

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["req03"] = TestReq03Notification

    # This is a made up class that is just used to verify
    class TestReq04Notification(NotifyBase):
        """This class is used to test a case where our requirements is fixed to
        a None."""

        # This is the same as saying there are no requirements
        requirements = None

        def url(self, **kwargs):
            # Support URL
            return ""

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["req04"] = TestReq04Notification

    # This is a made up class that is just used to verify
    class TestReq05Notification(NotifyBase):
        """This class is used to test a case where only packages_recommended is
        identified."""

        requirements: ClassVar[RequirementsSpec] = {
            "packages_recommended": "cryptography <= 3.4"
        }

        def url(self, **kwargs):
            # Support URL
            return ""

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["req05"] = TestReq05Notification

    class TestDisabled01Notification(NotifyBase):
        """This class is used to test a pre-disabled state."""

        # Just flat out disable our service
        enabled = False

        # we'll use this as a key to make our service easier to find
        # in the next part of the testing
        service_name = "na01"

        def url(self, **kwargs):
            # Support URL
            return ""

        def notify(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["na01"] = TestDisabled01Notification

    class TestDisabled02Notification(NotifyBase):
        """This class is used to test a post-disabled state."""

        # we'll use this as a key to make our service easier to find
        # in the next part of the testing
        service_name = "na02"

        def __init__(self, *args, **kwargs):
            super().__init__(**kwargs)

            # enable state changes **AFTER** we initialize
            self.enabled = False

        def url(self, **kwargs):
            # Support URL
            return ""

        def notify(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["na02"] = TestDisabled02Notification

    # We'll add a good notification to our list
    class TesEnabled01Notification(NotifyBase):
        """This class is just a simple enabled one."""

        # we'll use this as a key to make our service easier to find
        # in the next part of the testing
        service_name = "good"

        def url(self, **kwargs):
            # Support URL
            return ""

        def send(self, **kwargs):
            # Pretend everything is okay (so we don't break other tests)
            return True

    N_MGR["good"] = TesEnabled01Notification

    # Verify that we can pass through all of our different details
    result = runner.invoke(
        cli.main,
        [
            "--details",
        ],
    )
    assert result.exit_code == 0

    result = runner.invoke(
        cli.main,
        [
            "-l",
        ],
    )
    assert result.exit_code == 0

    # Clear loaded modules
    N_MGR.unload_modules()


def test_apprise_cli_print_help():
    """
    CLI: --help (-h)

    """
    runner = CliRunner()

    # Clear our working variables so they don't obstruct the next test
    # This simulates an actual call from the CLI.  Unfortunately through
    # testing were occupying the same memory space so our singleton's
    # have already been populated
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()

    # Print help and exit
    result = runner.invoke(cli.main, ["--help"])
    assert result.exit_code == 0

    result = runner.invoke(cli.main, ["-h"])
    assert result.exit_code == 0


@mock.patch("requests.request")
def test_apprise_cli_plugin_loading(mock_request, tmpdir):
    """
    CLI: --plugin-path (-P)

    """
    # Prepare Mock
    mock_request.return_value = requests.Request()
    mock_request.return_value.status_code = requests.codes.ok

    runner = CliRunner()

    # Clear our working variables so they don't obstruct the next test
    # This simulates an actual call from the CLI.  Unfortunately through
    # testing were occupying the same memory space so our singleton's
    # have already been populated
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()

    # Test a path that has no files to load in it
    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            join(str(tmpdir), "invalid_path"),
            "-b",
            "test\nbody",
            "json://localhost",
        ],
    )
    # The valid notification still loads despite the invalid path.
    assert result.exit_code == 0

    # Directories that don't exist passed in by the CLI aren't even scanned
    assert len(N_MGR._paths_previously_scanned) == 0
    assert len(N_MGR._custom_module_map) == 0

    # Test our current existing path that has no entries in it
    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            str(tmpdir.mkdir("empty")),
            "-b",
            "test\nbody",
            "json://localhost",
        ],
    )
    # The valid notification still loads despite the invalid path.
    assert result.exit_code == 0
    assert len(N_MGR._paths_previously_scanned) == 1
    assert join(str(tmpdir), "empty") in N_MGR._paths_previously_scanned

    # However there was nothing to load
    assert len(N_MGR._custom_module_map) == 0

    # Clear our working variables so they don't obstruct the next test
    # This simulates an actual call from the CLI.  Unfortunately through
    # testing were occupying the same memory space so our singleton's
    # have already been populated
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()

    # Prepare ourselves a file to work with
    notify_hook_a_base = tmpdir.mkdir("random")
    notify_hook_a = notify_hook_a_base.join("myhook01.py")
    notify_hook_a.write(
        cleandoc("""
    raise ImportError
    """)
    )

    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            str(notify_hook_a),
            "-b",
            "test\nbody",
            # A custom hook:
            "clihook://",
        ],
    )
    # It doesn't exist so it will fail
    # meanwhile we would have failed to load the myhook path
    assert result.exit_code == 1

    # The valid notification still loads despite the invalid path.
    assert len(N_MGR._paths_previously_scanned) == 1
    assert str(notify_hook_a) in N_MGR._paths_previously_scanned
    # However there was nothing to load
    assert len(N_MGR._custom_module_map) == 0

    # Prepare ourselves a file to work with
    notify_hook_aa = notify_hook_a_base.join("myhook02.py")
    notify_hook_aa.write(
        cleandoc("""
    garbage entry
    """)
    )

    N_MGR.plugins()
    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            str(notify_hook_aa),
            "-b",
            "test\nbody",
            # A custom hook:
            "clihook://custom",
        ],
    )
    # It doesn't exist so it will fail
    # meanwhile we would have failed to load the myhook path
    assert result.exit_code == 1

    # The path is silently loaded but fails...
    # as a result the path stacks with the last
    assert len(N_MGR._paths_previously_scanned) == 2
    assert str(notify_hook_a) in N_MGR._paths_previously_scanned
    assert str(notify_hook_aa) in N_MGR._paths_previously_scanned
    # However there was nothing to load
    assert len(N_MGR._custom_module_map) == 0

    # Clear our working variables so they don't obstruct the next test
    # This simulates an actual call from the CLI.  Unfortunately through
    # testing were occupying the same memory space so our singleton's
    # have already been populated
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()

    # Prepare ourselves a file to work with
    notify_hook_b = tmpdir.mkdir("goodmodule").join("__init__.py")
    notify_hook_b.write(
        cleandoc("""
    from apprise.decorators import notify

    # We want to trigger on anyone who configures a call to clihook://
    @notify(on="clihook")
    def mywrapper(body, title, notify_type, *args, **kwargs):
        # A simple test - print to screen
        print("{}: {} - {}".format(notify_type, title, body))

        # No return (so a return of None) get's translated to True

    # Define another in the same file
    @notify(on="clihookA")
    def mywrapper(body, title, notify_type, *args, **kwargs):
        # A simple test - print to screen
        print("!! {}: {} - {}".format(notify_type, title, body))

        # No return (so a return of None) get's translated to True
    """)
    )

    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            str(tmpdir),
            "-b",
            "test body",
            # A custom hook:
            "clihook://still/valid",
        ],
    )

    # We can detect the goodmodule (which has an __init__.py in it)
    # so we'll load okay
    assert result.exit_code == 0

    # Let's see how things got loaded:
    assert len(N_MGR._paths_previously_scanned) == 2
    assert str(tmpdir) in N_MGR._paths_previously_scanned
    # absolute path to detected module is also added
    assert (
        join(str(tmpdir), "goodmodule", "__init__.py")
        in N_MGR._paths_previously_scanned
    )

    # We also loaded our clihook properly
    assert len(N_MGR._custom_module_map) == 1

    # We can find our new hook loaded in our schema map now...
    assert "clihook" in N_MGR

    # Capture our key for reference
    key = next(iter(N_MGR._custom_module_map.keys()))

    # We loaded 2 entries from the same file
    assert len(N_MGR._custom_module_map[key]["notify"]) == 2
    assert "clihook" in N_MGR._custom_module_map[key]["notify"]
    # Converted to lower case
    assert "clihooka" in N_MGR._custom_module_map[key]["notify"]

    # Our function name
    assert (
        N_MGR._custom_module_map[key]["notify"]["clihook"]["fn_name"]
        == "mywrapper"
    )
    # What we parsed from the `on` keyword in the @notify decorator
    assert (
        N_MGR._custom_module_map[key]["notify"]["clihook"]["url"]
        == "clihook://"
    )
    # our default name Assignment.  This can be-overridden on the @notify
    # decorator by just adding a name= to the parameter list
    assert N_MGR["clihook"].service_name == "Custom - clihook"

    # Our Base Notification object when initialized:
    assert (
        len(N_MGR._module_map[N_MGR._custom_module_map[key]["name"]]["plugin"])
        == 2
    )
    for plugin in N_MGR._module_map[N_MGR._custom_module_map[key]["name"]][
        "plugin"
    ]:
        assert isinstance(plugin(), NotifyBase)

    # Clear our working variables so they don't obstruct the next test
    # This simulates an actual call from the CLI.  Unfortunately through
    # testing were occupying the same memory space so our singleton's
    # have already been populated
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()
    del N_MGR["clihook"]

    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            str(notify_hook_b),
            "-b",
            "test body",
            # A custom hook:
            "clihook://",
        ],
    )

    # Absolute path to __init__.py is okay
    assert result.exit_code == 0

    # we can verify that it prepares our message
    assert result.stdout.strip() == "info:  - test body"

    # Clear our working variables so they don't obstruct the next test
    # This simulates an actual call from the CLI.  Unfortunately through
    # testing were occupying the same memory space so our singleton's
    # have already been populated
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()
    del N_MGR["clihook"]

    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            dirname(str(notify_hook_b)),
            "-b",
            "test body",
            # A custom hook:
            "clihook://",
        ],
    )

    # Now we succeed to load our module when pointed to it only because
    # an __init__.py is found on the inside of it
    assert result.exit_code == 0

    # we can verify that it prepares our message
    assert result.stdout.strip() == "info:  - test body"

    # Test double paths that are the same; this ensures we only
    # load the plugin once
    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            dirname(str(notify_hook_b)),
            "--plugin-path",
            str(notify_hook_b),
            "--details",
        ],
    )

    # Now we succeed to load our module when pointed to it only because
    # an __init__.py is found on the inside of it
    assert result.exit_code == 0

    # Clear our working variables so they don't obstruct the next test
    # This simulates an actual call from the CLI.  Unfortunately through
    # testing were occupying the same memory space so our singleton's
    # have already been populated
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()
    del N_MGR["clihook"]

    # Prepare ourselves a file to work with
    notify_hook_b = tmpdir.mkdir("complex").join("complex.py")
    notify_hook_b.write(
        cleandoc("""
    from apprise.decorators import notify

    # Existing elements cannot be overridden.
    # in this case json://
    @notify(on="json")
    def mywrapper_01(body, title, notify_type, *args, **kwargs):
        # Return True (same as None)
        return True

    @notify(on="willfail", name="always failing...")
    def mywrapper_02(body, title, notify_type, *args, **kwargs):
        # Simply fail
        return False

    @notify(on="clihook1", name="the original clihook entry")
    def mywrapper_03(body, title, notify_type, *args, **kwargs):
        # Return True
        return True

    # A duplicate schema cannot be loaded.
    @notify(on="clihook1", name="a duplicate of the clihook entry")
    def mywrapper_04(body, title, notify_type, *args, **kwargs):
        # Return True
        return True

    # A schema URL may also provide defaults for the wrapper.
    @notify(on="clihook2://localhost")
    def mywrapper_05(body, title, notify_type, *args, **kwargs):
        # Return True
        return True


    # This can't load because of the defined schema/on definition
    @notify(on="", name="an invalid schema was specified")
    def mywrapper_06(body, title, notify_type, *args, **kwargs):
        return True
    """)
    )

    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            join(str(tmpdir), "complex"),
            "-b",
            "test body",
            # A custom hook that does not exist
            "clihook://",
        ],
    )

    # Since clihook:// isn't in our complex listing, this will fail
    assert result.exit_code == 1

    # Let's see how things got loaded
    assert len(N_MGR._paths_previously_scanned) == 2
    # Our path we specified on the CLI...
    assert join(str(tmpdir), "complex") in N_MGR._paths_previously_scanned

    # absolute path to detected module is also added
    assert (
        join(str(tmpdir), "complex", "complex.py")
        in N_MGR._paths_previously_scanned
    )

    # We loaded our one module successfuly
    assert len(N_MGR._custom_module_map) == 1

    # We can find our new hook loaded in our SCHEMA_MAP now...
    assert "willfail" in N_MGR
    assert "clihook1" in N_MGR
    assert "clihook2" in N_MGR

    # Capture our key for reference
    key = next(iter(N_MGR._custom_module_map.keys()))

    assert len(N_MGR._custom_module_map[key]["notify"]) == 3
    assert "willfail" in N_MGR._custom_module_map[key]["notify"]
    assert "clihook1" in N_MGR._custom_module_map[key]["notify"]
    # We only load 1 instance of the clihook2, the second will fail
    assert "clihook2" in N_MGR._custom_module_map[key]["notify"]
    # We can never load previously created notifications
    assert "json" not in N_MGR._custom_module_map[key]["notify"]

    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            join(str(tmpdir), "complex"),
            "-b",
            "test body",
            # A custom notification set up for failure
            "willfail://",
        ],
    )
    # Note that the failure of the decorator carries all the way back
    # to the CLI
    assert result.exit_code == 1

    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            join(str(tmpdir), "complex"),
            "-b",
            "test body",
            # our clihook that returns true
            "clihook1://",
            # our other loaded clihook
            "clihook2://",
        ],
    )
    # Note that the failure of the decorator carries all the way back
    # to the CLI
    assert result.exit_code == 0

    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            join(str(tmpdir), "complex"),
            "--notification-type",
            "invalid",
            "-b",
            "test body",
            # our clihook that returns true
            "clihook1://",
        ],
    )
    # Bad notification type specified
    assert result.exit_code == 2

    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            join(str(tmpdir), "complex"),
            "-b",
            "-i",
            "warningtest body",
            # our clihook that returns true
            "clihook1://",
        ],
    )
    # Bad notification type specified
    assert result.exit_code == 0

    result = runner.invoke(
        cli.main,
        [
            "--plugin-path",
            join(str(tmpdir), "complex"),
            # Print our custom details to the screen
            "--details",
        ],
    )
    assert "willfail" in result.stdout
    assert "always failing..." in result.stdout

    assert "clihook1" in result.stdout
    assert "the original clihook entry" in result.stdout
    assert "a duplicate of the clihook entry" not in result.stdout

    assert "clihook2" in result.stdout
    assert "Custom - clihook2" in result.stdout

    # Note that the failure of the decorator carries all the way back
    # to the CLI
    assert result.exit_code == 0


@mock.patch("platform.system")
def test_apprise_cli_windows_env(mock_system):
    """
    CLI: Windows Environment

    """
    # Force a windows environment
    mock_system.return_value = "Windows"

    # Reload our module
    reload(cli)


@mock.patch("apprise.cli.NotificationManager")
@mock.patch("importlib.metadata.packages_distributions", create=True)
@mock.patch("importlib.metadata.version")
@mock.patch("apprise.cli.logger")
def test_apprise_cli_runtime_env_skip_when_not_debug(
    mock_logger, mock_ver, mock_dist, mock_mgr
):
    """
    CLI: _log_runtime_env() exits immediately when not at DEBUG level.
    """
    # Simulate a logger that is not at DEBUG level
    mock_logger.isEnabledFor.return_value = False

    cli._log_runtime_env()

    # Nothing should be computed or logged
    mock_logger.debug.assert_not_called()
    mock_mgr.assert_not_called()
    mock_dist.assert_not_called()
    mock_ver.assert_not_called()


@mock.patch("apprise.cli.NotificationManager")
@mock.patch("importlib.metadata.packages_distributions", create=True)
@mock.patch("importlib.metadata.version")
@mock.patch("apprise.cli.logger")
def test_apprise_cli_runtime_env_logging(
    mock_logger, mock_ver, mock_dist, mock_mgr
):
    """
    CLI: _log_runtime_env() summary
    """
    # Simulate a DEBUG-level logger
    mock_logger.isEnabledFor.return_value = True

    # Plugin whose dep should appear in output
    class EnabledPlugin:
        enabled = True

        @staticmethod
        def runtime_deps():
            return ("testpkg",)

    # Dependencies from disabled plugins must not appear.
    class DisabledPlugin:
        enabled = False

        @staticmethod
        def runtime_deps():
            return ("disabled-dep",)

    # Plugins without runtime_deps are skipped.
    class NoRuntimeDepsPlugin:
        enabled = True

    mock_mgr.return_value = [
        {
            "plugin": {
                EnabledPlugin,
                DisabledPlugin,
                NoRuntimeDepsPlugin,
            },
        },
    ]
    mock_dist.return_value = {"testpkg": ["test-package"]}
    mock_ver.return_value = "9.9.9"

    cli._log_runtime_env()

    # Collect positional-arg tuples from each debug() call
    calls = [a for a, _ in mock_logger.debug.call_args_list]

    # Environment summary lines must be present
    assert any(a[0] == "Apprise: %s" for a in calls)
    assert any(a[0] == "Python: %s" for a in calls)
    assert any(a[0] == "Platform: %s" for a in calls)
    assert any(a[0] == "Encoding: %s" for a in calls)

    # Resolved deps emitted as a single inline line
    assert any(
        a[0] == "Runtime deps: %s" and a[1] == "test-package=9.9.9"
        for a in calls
    )

    # Disabled plugin dep must not be logged
    assert not any("disabled-dep" in str(a) for a in calls)


@mock.patch("apprise.cli.NotificationManager")
@mock.patch("importlib.metadata.packages_distributions", create=True)
@mock.patch("importlib.metadata.version")
@mock.patch("apprise.cli.logger")
def test_apprise_cli_runtime_env_no_runtime_deps(
    mock_logger, mock_ver, mock_dist, mock_mgr
):
    """
    CLI: _log_runtime_env()
    """
    mock_logger.isEnabledFor.return_value = True

    # Plugin that declares no deps
    class NoDepsPlugin:
        enabled = True

        @staticmethod
        def runtime_deps():
            return ()

    mock_mgr.return_value = [{"plugin": {NoDepsPlugin}}]

    cli._log_runtime_env()

    # Environment header was still logged
    calls = [a for a, _ in mock_logger.debug.call_args_list]
    assert any(a[0] == "Apprise: %s" for a in calls)

    # Package-metadata scan must not have been attempted
    mock_dist.assert_not_called()
    mock_ver.assert_not_called()

    # No "  pkg: ver" lines
    assert not any(a[0] == "Runtime deps: %s" for a in calls)


@mock.patch("apprise.cli.NotificationManager")
@mock.patch("importlib.metadata.packages_distributions", create=True)
@mock.patch("importlib.metadata.version")
@mock.patch("apprise.cli.logger")
def test_apprise_cli_runtime_env_dist_map_exception(
    mock_logger, mock_ver, mock_dist, mock_mgr
):
    """
    CLI: _log_runtime_env() handles packages_distributions() failures.
    """
    mock_logger.isEnabledFor.return_value = True

    class DepPlugin:
        enabled = True

        @staticmethod
        def runtime_deps():
            return ("somepkg",)

    mock_mgr.return_value = [{"plugin": {DepPlugin}}]
    mock_dist.side_effect = Exception("metadata unavailable")

    # Must not raise
    cli._log_runtime_env()

    # pkg_version should never be reached
    mock_ver.assert_not_called()

    # No "  pkg: ver" lines
    calls = [a for a, _ in mock_logger.debug.call_args_list]
    assert not any(a[0] == "Runtime deps: %s" for a in calls)


@mock.patch("apprise.cli.NotificationManager")
@mock.patch("importlib.metadata.packages_distributions", create=True)
@mock.patch("importlib.metadata.version")
@mock.patch("apprise.cli.logger")
def test_apprise_cli_runtime_env_lookup_errors(
    mock_logger, mock_ver, mock_dist, mock_mgr
):
    """
    CLI: _log_runtime_env() silently skips packages exception raised.
    """
    mock_logger.isEnabledFor.return_value = True

    # Plugin whose runtime_deps() raises
    class BrokenPlugin:
        enabled = True

        @staticmethod
        def runtime_deps():
            raise RuntimeError("plugin error")

    # Plugin whose dep import name is not in the dist map
    class UnmappedPlugin:
        enabled = True

        @staticmethod
        def runtime_deps():
            return ("notmapped",)

    # Plugin whose dep maps to a dist but the version lookup fails
    class VersionlessPlugin:
        enabled = True

        @staticmethod
        def runtime_deps():
            return ("verpkg",)

    mock_mgr.return_value = [
        {
            "plugin": {
                BrokenPlugin,
                UnmappedPlugin,
                VersionlessPlugin,
            },
        },
    ]

    # "notmapped" absent from map; "verpkg" present but ver raises
    mock_dist.return_value = {"verpkg": ["ver-package"]}
    mock_ver.side_effect = PackageNotFoundError("ver-package")

    # Must not raise
    cli._log_runtime_env()

    # None of the error paths should produce a "  pkg: ver" line
    calls = [a for a, _ in mock_logger.debug.call_args_list]
    assert not any(a[0] == "Runtime deps: %s" for a in calls)


@pytest.mark.skipif(
    sys.version_info < (3, 11),
    reason="packages_distributions requires Python 3.11+",
)
@mock.patch("apprise.cli.NotificationManager")
@mock.patch("apprise.cli.logger")
def test_apprise_cli_runtime_env_no_packages_distributions(
    mock_logger, mock_mgr
):
    """
    CLI: _log_runtime_env() gracefully skips dep listing when
    packages_distributions() is missing (ImportError path).
    Simulates the Python < 3.11 scenario on Python 3.11+ by temporarily
    removing packages_distributions from importlib.metadata.
    """
    import importlib.metadata as _meta

    mock_logger.isEnabledFor.return_value = True

    class DepPlugin:
        enabled = True

        @staticmethod
        def runtime_deps():
            return ("somepkg",)

    mock_mgr.return_value = [{"plugin": {DepPlugin}}]

    # Temporarily hide packages_distributions to trigger the ImportError
    _pd = _meta.packages_distributions
    del _meta.packages_distributions
    try:
        cli._log_runtime_env()
    finally:
        _meta.packages_distributions = _pd

    # Env summary was still logged despite the missing function
    calls = [a for a, _ in mock_logger.debug.call_args_list]
    assert any(a[0] == "Apprise: %s" for a in calls)

    # No dependency list is logged without packages_distributions.
    assert not any(a[0] == "Runtime deps: %s" for a in calls)


# Remove this test when Python 3.9 support is dropped.
@pytest.mark.skipif(
    sys.version_info >= (3, 11),
    reason="packages_distributions exists on Python 3.11+",
)
@mock.patch("apprise.cli.NotificationManager")
@mock.patch("apprise.cli.logger")
def test_apprise_cli_runtime_env_py39_no_packages_distributions(
    mock_logger, mock_mgr
):
    """
    CLI: _log_runtime_env() gracefully skips dep listing on Python < 3.11
    where packages_distributions() is genuinely absent.
    """
    mock_logger.isEnabledFor.return_value = True

    class DepPlugin:
        enabled = True

        @staticmethod
        def runtime_deps():
            return ("somepkg",)

    mock_mgr.return_value = [{"plugin": {DepPlugin}}]

    # This Python version lacks packages_distributions natively.
    cli._log_runtime_env()

    # Env summary was still logged despite the missing function
    calls = [a for a, _ in mock_logger.debug.call_args_list]
    assert any(a[0] == "Apprise: %s" for a in calls)

    # No dependency list is logged without packages_distributions.
    assert not any(a[0] == "Runtime deps: %s" for a in calls)


def test_apprise_cli_limit_option_in_help():
    """
    CLI: --limit (-L) appears in --help output
    """
    runner = CliRunner()
    result = runner.invoke(cli.main, ["--help"])
    assert result.exit_code == 0
    assert "--limit" in result.output
    assert "-L" in result.output


@mock.patch("requests.request")
def test_apprise_cli_notify_runtime_stat_log(mock_request):
    """CLI: log runtime, counts, and overall status after notification.

    Patch only ``logger.debug`` because setup also uses the logger's level.
    """
    response = mock.Mock()
    response.status_code = requests.codes.ok
    response.content = b""
    mock_request.return_value = response

    runner = CliRunner()
    with mock.patch.object(cli.logger, "debug") as mock_debug:
        result = runner.invoke(
            cli.main,
            ["-t", "title", "-b", "body", "json://good"],
        )
    assert result.exit_code == 0

    calls = [a for a, _ in mock_debug.call_args_list]
    assert any(
        a[0]
        == (
            "Finished in %.2fs. %d service(s) tried (%s): %d sent / "
            "%d failed / %d timed out."
        )
        # The elapsed-seconds value is the first substitution.
        and a[2:] == (1, "SUCCESS", 1, 0, 0)
        for a in calls
    )


@mock.patch("apprise.cli._force_exit")
@mock.patch("requests.request")
def test_apprise_cli_limit_option_times_out_service(
    mock_request, mock_force_exit
):
    """CLI: ``--limit`` reports TIMEOUT without requiring a hard exit.

    The long service delay avoids timing races. Mock ``_force_exit`` because
    its real ``os._exit`` would stop the in-process test runner.
    """
    import time

    def _slow_failure(*args, **kwargs):
        """Return a delayed HTTP failure to force the CLI timeout path."""
        time.sleep(2.0)
        response = mock.Mock()
        response.status_code = requests.codes.internal_server_error
        response.content = b""
        response.text = ""
        return response

    mock_request.side_effect = _slow_failure

    runner = CliRunner()
    result = runner.invoke(
        cli.main,
        [
            "-t",
            "title",
            "-b",
            "body",
            "--limit",
            "0.05",
            "json://good?retry=3",
        ],
    )

    # A lone timeout produces the TIMEOUT exit code, not generic FAILURE.
    # Its diagnostic uses logging and is tested separately.
    assert result.exit_code == AppriseResultStatus.TIMEOUT

    # The service finishes during the grace period, avoiding a hard exit.
    mock_force_exit.assert_not_called()


@mock.patch("apprise.cli._force_exit")
@mock.patch("requests.request")
def test_apprise_cli_limit_hard_exit(mock_request, mock_force_exit):
    """Force exit when a call outlives the timeout grace period.

    A two-second delay avoids timing races. ``_force_exit()`` is mocked so the
    test process stays alive.
    """
    import time

    def _slow_failure(*args, **kwargs):
        """Return a delayed HTTP failure to force the CLI timeout path."""
        time.sleep(2.0)
        response = mock.Mock()
        response.status_code = requests.codes.internal_server_error
        response.content = b""
        response.text = ""
        return response

    mock_request.side_effect = _slow_failure

    with mock.patch("apprise.cli.CLI_TIMEOUT_EXIT_GRACE_SECONDS", 0.05):
        runner = CliRunner()
        result = runner.invoke(
            cli.main,
            [
                "-t",
                "title",
                "-b",
                "body",
                "--limit",
                "0.05",
                "json://good?retry=3",
            ],
        )

    assert result.exit_code == AppriseResultStatus.TIMEOUT
    mock_force_exit.assert_called_once()
    assert mock_force_exit.call_args.args[1] == AppriseResultStatus.TIMEOUT


def test_wait_for_abandoned_calls_polls_full_grace_period():
    """Poll in short intervals until the full grace period expires."""
    with (
        mock.patch("apprise.cli.time.sleep") as mock_sleep,
        mock.patch(
            "apprise.cli.any_abandoned_calls_still_running",
            return_value=True,
        ) as mock_still_running,
    ):
        result = cli._wait_for_abandoned_calls(
            cli.CLI_TIMEOUT_EXIT_GRACE_SECONDS
        )

    assert result is False
    assert mock_still_running.called
    total_slept = sum(call.args[0] for call in mock_sleep.call_args_list)
    assert total_slept == pytest.approx(cli.CLI_TIMEOUT_EXIT_GRACE_SECONDS)
    for call in mock_sleep.call_args_list:
        assert call.args[0] <= cli.CLI_TIMEOUT_EXIT_POLL_INTERVAL


def test_wait_for_abandoned_calls_logs_masked_services():
    """Log masked descriptions for unfinished calls at DEBUG once."""
    with (
        mock.patch("apprise.cli.time.sleep"),
        mock.patch(
            "apprise.cli.any_abandoned_calls_still_running",
            return_value=False,
        ),
        mock.patch(
            "apprise.cli.abandoned_call_descriptions",
            return_value=["dummy (dummy://masked@host)"],
        ),
        mock.patch("apprise.cli.logger.debug") as mock_debug,
    ):
        cli._wait_for_abandoned_calls(cli.CLI_TIMEOUT_EXIT_GRACE_SECONDS)

    first_call_message = mock_debug.call_args_list[0].args
    assert "dummy (dummy://masked@host)" in first_call_message


def test_wait_for_abandoned_calls_exits_early_when_calls_finish():
    """Stop polling as soon as every abandoned call finishes."""
    # Two busy checks produce two short sleeps before completion.
    with (
        mock.patch("apprise.cli.time.sleep") as mock_sleep,
        mock.patch(
            "apprise.cli.any_abandoned_calls_still_running",
            side_effect=[True, True, False],
        ) as mock_still_running,
    ):
        result = cli._wait_for_abandoned_calls(
            cli.CLI_TIMEOUT_EXIT_GRACE_SECONDS
        )

    assert result is True
    assert mock_still_running.call_count == 3
    assert mock_sleep.call_count == 2
    for call in mock_sleep.call_args_list:
        assert call.args[0] == cli.CLI_TIMEOUT_EXIT_POLL_INTERVAL


def test_wait_for_abandoned_calls_finishes_right_as_grace_period_ends():
    """A final post-loop check can catch work that just finished."""
    with (
        mock.patch("apprise.cli.time.sleep"),
        mock.patch(
            "apprise.cli.any_abandoned_calls_still_running",
            # Four in-loop polls still report running. The final check
            # sees that the abandoned work has just finished.
            side_effect=[True, True, True, True, False],
        ) as mock_still_running,
    ):
        result = cli._wait_for_abandoned_calls(1.0)

    assert result is True
    assert mock_still_running.call_count == 5


def test_force_exit_sequence():
    """Flush stores and output before forcing the process to exit.

    All external effects are mocked so the sequence is tested safely.
    """
    a = Apprise()
    services = [mock.Mock(spec=NotifyBase) for _ in range(3)]
    for service in services:
        a.add(service)

    with (
        mock.patch("apprise.cli.logging.shutdown") as mock_shutdown,
        mock.patch("apprise.cli.sys.stdout.flush") as mock_stdout_flush,
        mock.patch("apprise.cli.sys.stderr.flush") as mock_stderr_flush,
        mock.patch("apprise.cli.os._exit") as mock_os_exit,
    ):
        cli._force_exit(a, AppriseResultStatus.TIMEOUT)

    for service in services:
        service.flush_store.assert_called_once()
    mock_shutdown.assert_called_once()
    mock_stdout_flush.assert_called_once()
    mock_stderr_flush.assert_called_once()
    mock_os_exit.assert_called_once_with(AppriseResultStatus.TIMEOUT)


def test_force_exit_flush_failure_does_not_skip_others():
    """A failed store flush does not skip other stores or the hard exit.

    The broken service comes first to exercise the remaining flushes.
    """
    a = Apprise()
    broken_service = mock.Mock(spec=NotifyBase)
    broken_service.flush_store.side_effect = RuntimeError("disk full")
    ok_service = mock.Mock(spec=NotifyBase)
    a.add(broken_service)
    a.add(ok_service)

    with (
        mock.patch("apprise.cli.logging.shutdown") as mock_shutdown,
        mock.patch("apprise.cli.os._exit") as mock_os_exit,
    ):
        cli._force_exit(a, AppriseResultStatus.TIMEOUT)

    # The service after the broken one in iteration order still got
    # its own flush attempt.
    ok_service.flush_store.assert_called_once()
    mock_os_exit.assert_called_once_with(AppriseResultStatus.TIMEOUT)
    # logging.shutdown() is unrelated to the failing store and should
    # still run normally afterward.
    mock_shutdown.assert_called_once()


def test_force_exit_reaches_exit_despite_logging_failure():
    """A logging shutdown failure does not prevent output flushes or exit."""
    a = Apprise()
    service = mock.Mock(spec=NotifyBase)
    a.add(service)

    with (
        mock.patch(
            "apprise.cli.logging.shutdown",
            side_effect=RuntimeError("logging is broken"),
        ),
        mock.patch("apprise.cli.sys.stdout.flush") as mock_stdout_flush,
        mock.patch("apprise.cli.sys.stderr.flush") as mock_stderr_flush,
        mock.patch("apprise.cli.os._exit") as mock_os_exit,
    ):
        cli._force_exit(a, AppriseResultStatus.TIMEOUT)

    service.flush_store.assert_called_once()
    mock_stdout_flush.assert_called_once()
    mock_stderr_flush.assert_called_once()
    mock_os_exit.assert_called_once_with(AppriseResultStatus.TIMEOUT)


def test_apprise_cli_limit_option_negative_value_errors():
    """
    CLI: --limit (-L) rejects a negative value the same way notify()
    and AppriseAsset(service_timeout=...) do.
    """
    runner = CliRunner()
    result = runner.invoke(
        cli.main,
        ["-t", "title", "-b", "body", "--limit", "-5", "json://good"],
    )
    assert result.exit_code != 0


def test_apprise_cli_service_limit_option_in_help():
    """
    CLI: --service-limit (-SL) appears in --help output
    """
    runner = CliRunner()
    result = runner.invoke(cli.main, ["--help"])
    assert result.exit_code == 0
    assert "--service-limit" in result.output
    assert "-SL" in result.output


def test_apprise_cli_service_limit_option_negative_value_errors():
    """
    CLI: --service-limit (-SL) rejects a negative value the same way
    AppriseAsset(service_timeout=...) does.
    """
    runner = CliRunner()
    result = runner.invoke(
        cli.main,
        [
            "-t",
            "title",
            "-b",
            "body",
            "--service-limit",
            "-5",
            "json://good",
        ],
    )
    assert result.exit_code != 0


@mock.patch("apprise.cli.AppriseAsset")
@mock.patch("requests.request")
def test_apprise_cli_service_limit_option_passed_to_asset(
    mock_request, mock_asset_cls
):
    """
    CLI: --service-limit (-SL), when specified, is passed into
    AppriseAsset(service_timeout=...) independently of --limit.
    """
    mock_asset_cls.side_effect = AppriseAsset
    mock_request.return_value = requests.Request()
    mock_request.return_value.status_code = requests.codes.ok

    runner = CliRunner()
    result = runner.invoke(
        cli.main,
        [
            "-t",
            "title",
            "-b",
            "body",
            "--limit",
            "30",
            "--service-limit",
            "5",
            "json://localhost",
        ],
    )
    assert result.exit_code == 0

    # --service-limit is independently set on the AppriseAsset, no
    # matter what --limit was also set to.
    assert mock_asset_cls.call_args.kwargs.get("service_timeout") == 5.0


@mock.patch("apprise.cli.AppriseAsset")
@mock.patch("requests.request")
def test_apprise_cli_service_limit_option_omitted(
    mock_request, mock_asset_cls
):
    """
    CLI: when --service-limit is not specified, AppriseAsset() receives
    service_timeout=None -- its own built-in default remains in effect,
    even if --limit was specified.
    """
    mock_asset_cls.side_effect = AppriseAsset
    mock_request.return_value = requests.Request()
    mock_request.return_value.status_code = requests.codes.ok

    runner = CliRunner()
    result = runner.invoke(
        cli.main,
        [
            "-t",
            "title",
            "-b",
            "body",
            "--limit",
            "30",
            "json://localhost",
        ],
    )
    assert result.exit_code == 0
    assert mock_asset_cls.call_args.kwargs.get("service_timeout") is None
caronc-apprise-dfec414/tests/test_apprise_config.py000066400000000000000000001320531526720371000226660ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
import logging
import sys
import time
from unittest import mock

import pytest

from apprise import (
    Apprise,
    AppriseAsset,
    AppriseConfig,
    ConfigFormat,
    ConfigurationManager,
    ContentIncludeMode,
    NotificationManager,
    NotifyFormat,
)
from apprise.config import ConfigBase
from apprise.config.file import ConfigFile
from apprise.logger import LogCapture
from apprise.plugins import NotifyBase

logging.disable(logging.CRITICAL)

# Grant access to our Notification Manager Singleton
N_MGR = NotificationManager()

# Grant access to our Configuration Manager Singleton
C_MGR = ConfigurationManager()


def test_apprise_config(tmpdir):
    """
    API: AppriseConfig basic testing

    """

    # Create ourselves a config object
    ac = AppriseConfig()

    # There are no services loaded
    assert len(ac) == 0

    # Object can be directly checked as a boolean; response is False
    # when there are no entries loaded
    assert not ac

    # lets try anyway
    assert len(ac.services()) == 0

    t = tmpdir.mkdir("simple-formatting").join("apprise")
    t.write("""
    # A comment line over top of a URL
    mailto://usera:pass@gmail.com

    # A line with mulitiple tag assignments to it
    taga,tagb=gnome://

    # Event if there is accidental leading spaces, this configuation
    # is accepting of htat and will not exclude them
                tagc=kde://

    # A very poorly structured url
    sns://:@/

    # Just 1 token provided causes exception
    sns://T1JJ3T3L2/

    # XML
    xml://localhost/?+HeaderEntry=Test&:IgnoredEntry=Ignored
    """)

    # Create ourselves a config object
    ac = AppriseConfig(paths=str(t))

    # One configuration file should have been found
    assert len(ac) == 1

    # Object can be directly checked as a boolean; response is True
    # when there is at least one entry
    assert ac

    # We should be able to read our 4 services from that
    assert len(ac.services()) == 4

    # Get our URL back
    assert isinstance(ac[0].url(), str)

    # Test cases where our URL is invalid
    t = tmpdir.mkdir("strange-lines").join("apprise")
    t.write("""
    # basicly this consists of defined tags and no url
    tag=
    """)

    # Create ourselves a config object
    ac = AppriseConfig(paths=str(t), asset=AppriseAsset())

    # One configuration file should have been found
    assert len(ac) == 1

    # No urls were set
    assert len(ac.services()) == 0

    # Create a ConfigBase object
    cb = ConfigBase()

    # Test adding of all entries
    assert ac.add(configs=cb, asset=AppriseAsset(), tag="test") is True

    # Test adding of all entries
    assert (
        ac.add(
            configs=[
                "file://?",
            ],
            asset=AppriseAsset(),
            tag="test",
        )
        is False
    )

    # Test the adding of garbage
    assert ac.add(configs=object()) is False

    # Try again but enforce our format
    ac = AppriseConfig(paths=f"file://{t!s}?format=text")

    # One configuration file should have been found
    assert len(ac) == 1

    # No urls were set
    assert len(ac.services()) == 0

    #
    # Test Internatialization and the handling of unicode characters
    #
    istr = """
        # Iñtërnâtiônàlization Testing
        windows://"""

    # Write our content to our file
    t = tmpdir.mkdir("internationalization").join("apprise")
    with open(str(t), "wb") as f:
        f.write(istr.encode("latin-1"))

    # Create ourselves a config object
    ac = AppriseConfig(paths=str(t))

    # One configuration file should have been found
    assert len(ac) == 1

    # This will fail because our default encoding is utf-8; however the file
    # we opened was not; it was latin-1 and could not be parsed.
    assert len(ac.services()) == 0

    # Test iterator
    count = 0
    for _entry in ac:
        count += 1
    assert len(ac) == count

    # We can fix this though; set our encoding to latin-1
    ac = AppriseConfig(paths=f"file://{t!s}?encoding=latin-1")

    # One configuration file should have been found
    assert len(ac) == 1

    # Our URL should be found
    assert len(ac.services()) == 1

    # Get our URL back
    assert isinstance(ac[0].url(), str)

    # pop an entry from our list
    assert isinstance(ac.pop(0), ConfigBase)

    # Determine we have no more configuration entries loaded
    assert len(ac) == 0

    #
    # Test buffer handling (and overflow)
    t = tmpdir.mkdir("buffer-handling").join("apprise")
    buf = "gnome://"
    t.write(buf)

    # Reset our config object
    ac.clear()

    # Create ourselves a config object
    ac = AppriseConfig(paths=str(t))

    # update our length to be the size of our actual file
    ac[0].max_buffer_size = len(buf)

    # One configuration file should have been found
    assert len(ac) == 1

    assert len(ac.services()) == 1

    # update our buffer size to be slightly smaller then what we allow
    ac[0].max_buffer_size = len(buf) - 1

    # Content is automatically cached; so even though we adjusted the buffer
    # above, our results have been cached so we get a 1 response.
    assert len(ac.services()) == 1


def test_apprise_multi_config_entries(tmpdir):
    """
    API: AppriseConfig basic multi-adding functionality

    """
    # temporary file to work with
    t = tmpdir.mkdir("apprise-multi-add").join("apprise")
    buf = """
    good://hostname
    """
    t.write(buf)

    # temporary empty file to work with
    te = tmpdir.join("apprise-multi-add", "apprise-empty")
    te.write("")

    # Define our good:// url
    class GoodNotification(NotifyBase):
        def __init__(self, **kwargs):
            super().__init__(notify_format=NotifyFormat.HTML, **kwargs)

        def notify(self, **kwargs):
            # Pretend everything is okay
            return True

        def url(self, **kwargs):
            # support url()
            return ""

    # Store our good notification in our schema map
    N_MGR._schema_map["good"] = GoodNotification

    # Create ourselves a config object
    ac = AppriseConfig()

    # There are no services loaded
    assert len(ac) == 0

    # Support adding of muilt strings and objects:
    assert ac.add(configs=(str(t), str(t))) is True
    assert (
        ac.add(configs=(ConfigFile(path=str(te)), ConfigFile(path=str(t))))
        is True
    )

    # don't support the adding of invalid content
    assert ac.add(configs=(object(), object())) is False
    assert ac.add(configs=object()) is False

    # Try to pop an element out of range
    with pytest.raises(IndexError):
        ac.service_pop(len(ac.services()))

    # Pop our elements
    while len(ac.services()) > 0:
        assert isinstance(ac.service_pop(len(ac.services()) - 1), NotifyBase)


def test_apprise_add_config():
    """API AppriseConfig.add_config()"""
    content = """
    # A comment line over top of a URL
    mailto://usera:pass@gmail.com

    # A line with mulitiple tag assignments to it
    taga,tagb=gnome://

    # Event if there is accidental leading spaces, this configuation
    # is accepting of htat and will not exclude them
                tagc=kde://

    # A very poorly structured url
    sns://:@/

    # Just 1 token provided causes exception
    sns://T1JJ3T3L2/
    """
    # Create ourselves a config object
    ac = AppriseConfig()
    assert ac.add_config(content=content) is True

    # One configuration file should have been found
    assert len(ac) == 1
    assert ac[0].config_format is ConfigFormat.TEXT

    # Object can be directly checked as a boolean; response is True
    # when there is at least one entry
    assert ac

    # We should be able to read our 3 services from that
    assert len(ac.services()) == 3

    # Get our URL back
    assert isinstance(ac[0].url(), str)

    # Test invalid content
    assert ac.add_config(content=object()) is False
    assert ac.add_config(content=42) is False
    assert ac.add_config(content=None) is False

    # Still only one service loaded
    assert len(ac) == 1

    # Test having a pre-defined asset object and tag created
    assert (
        ac.add_config(content=content, asset=AppriseAsset(), tag="a") is True
    )

    # Now there are 2 services loaded
    assert len(ac) == 2

    # and 6 urls.. (as we've doubled up)
    assert len(ac.services()) == 6

    content = """
    # A YAML File
    urls:
       - mailto://usera:pass@gmail.com
       - gnome://:
          tag: taga,tagb

       - json://localhost:
          +HeaderEntry1: 'a header entry'
          -HeaderEntryDepricated: 'a deprecated entry'
          :HeaderEntryIgnored: 'an ignored header entry'

       - xml://localhost:
          +HeaderEntry1: 'a header entry'
          -HeaderEntryDepricated: 'a deprecated entry'
          :HeaderEntryIgnored: 'an ignored header entry'
    """

    # Create ourselves a config object
    ac = AppriseConfig()
    assert ac.add_config(content=content) is True

    # One configuration file should have been found
    assert len(ac) == 1
    assert ac[0].config_format is ConfigFormat.YAML

    # Object can be directly checked as a boolean; response is True
    # when there is at least one entry
    assert ac

    # We should be able to read our 4 services from that
    assert len(ac.services()) == 4

    # Now an invalid configuration file
    content = "invalid"

    # Create ourselves a config object
    ac = AppriseConfig()
    assert ac.add_config(content=content) is False

    # Nothing is loaded
    assert len(ac.services()) == 0


def test_apprise_config_tagging(tmpdir):
    """
    API: AppriseConfig tagging

    """

    # temporary file to work with
    t = tmpdir.mkdir("tagging").join("apprise")
    buf = "gnome://"
    t.write(buf)

    # Create ourselves a config object
    ac = AppriseConfig()

    # Add an item associated with tag a
    assert ac.add(configs=str(t), asset=AppriseAsset(), tag="a") is True
    # Add an item associated with tag b
    assert ac.add(configs=str(t), asset=AppriseAsset(), tag="b") is True
    # Add an item associated with tag a or b
    assert ac.add(configs=str(t), asset=AppriseAsset(), tag="a,b") is True

    # Now filter: a:
    assert len(ac.services(tag="a")) == 2
    # Now filter: a or b:
    assert len(ac.services(tag="a,b")) == 3
    # Now filter: a and b
    assert len(ac.services(tag=[("a", "b")])) == 1
    # all matches everything
    assert len(ac.services(tag="all")) == 3

    # Test cases using the `always` keyword
    # Create ourselves a config object
    ac = AppriseConfig()

    # Add an item associated with tag a
    assert ac.add(configs=str(t), asset=AppriseAsset(), tag="a,always") is True
    # Add an item associated with tag b
    assert ac.add(configs=str(t), asset=AppriseAsset(), tag="b") is True
    # Add an item associated with tag a or b
    assert ac.add(configs=str(t), asset=AppriseAsset(), tag="c,d") is True

    # Now filter: a:
    assert len(ac.services(tag="a")) == 1
    # Now filter: a or b:
    assert len(ac.services(tag="a,b")) == 2
    # Now filter: e
    # we'll match the `always'
    assert len(ac.services(tag="e")) == 1
    assert len(ac.services(tag="e", match_always=False)) == 0
    # all matches everything
    assert len(ac.services(tag="all")) == 3

    # Now filter: d
    # we'll match the `always' tag
    assert len(ac.services(tag="d")) == 2
    assert len(ac.services(tag="d", match_always=False)) == 1


def test_apprise_config_instantiate():
    """
    API: AppriseConfig.instantiate()

    """
    assert (
        AppriseConfig.instantiate("file://?", suppress_exceptions=True) is None
    )

    assert (
        AppriseConfig.instantiate("invalid://?", suppress_exceptions=True)
        is None
    )

    class BadConfig(ConfigBase):
        # always allow incusion
        allow_cross_includes = ContentIncludeMode.ALWAYS

        def __init__(self, **kwargs):
            super().__init__(**kwargs)

            # We fail whenever we're initialized
            raise TypeError()

        @staticmethod
        def parse_url(url, *args, **kwargs):
            # always parseable
            return ConfigBase.parse_url(url, verify_host=False)

    # Store our bad configuration in our schema map
    C_MGR["bad"] = BadConfig

    with pytest.raises(TypeError):
        AppriseConfig.instantiate("bad://path", suppress_exceptions=False)

    # Same call but exceptions suppressed
    assert (
        AppriseConfig.instantiate("bad://path", suppress_exceptions=True)
        is None
    )


def test_invalid_apprise_config(tmpdir):
    """Parse invalid configuration includes."""

    class BadConfig(ConfigBase):
        # always allow incusion
        allow_cross_includes = ContentIncludeMode.ALWAYS

        def __init__(self, **kwargs):
            super().__init__(**kwargs)

            # We intentionally fail whenever we're initialized
            raise TypeError()

        @staticmethod
        def parse_url(url, *args, **kwargs):
            # always parseable
            return ConfigBase.parse_url(url, verify_host=False)

    # Store our bad configuration in our schema map
    C_MGR["bad"] = BadConfig

    # temporary file to work with
    t = tmpdir.mkdir("apprise-bad-obj").join("invalid")
    buf = f"""
    # Include an invalid schema
    include invalid://

    # An unparsable valid schema
    include https://

    # A valid configuration that will throw an exception
    include bad://

    # Include ourselves (So our recursive includes fails as well)
    include {t!s}

    """
    t.write(buf)

    # Create ourselves a config object with caching disbled
    ac = AppriseConfig(recursion=2, insecure_includes=True, cache=False)

    # Nothing loaded yet
    assert len(ac) == 0

    # Add our config
    assert ac.add(configs=str(t), asset=AppriseAsset()) is True

    # One configuration file
    assert len(ac) == 1

    # All of the services were invalid and would not load
    assert len(ac.services()) == 0


def test_apprise_config_with_apprise_obj(tmpdir):
    """
    API: ConfigBase - parse valid config

    """

    # temporary file to work with
    t = tmpdir.mkdir("apprise-obj").join("apprise")
    buf = """
    good://hostname
    localhost=good://localhost
    """
    t.write(buf)

    # Define our good:// url
    class GoodNotification(NotifyBase):
        def __init__(self, **kwargs):
            super().__init__(notify_format=NotifyFormat.HTML, **kwargs)

        def notify(self, **kwargs):
            # Pretend everything is okay
            return True

        def url(self, **kwargs):
            # support url()
            return ""

    # Store our good notification in our schema map
    N_MGR._schema_map["good"] = GoodNotification

    # Create ourselves a config object
    ac = AppriseConfig(cache=False)

    # Nothing loaded yet
    assert len(ac) == 0

    # Add an item associated with tag a
    assert ac.add(configs=str(t), asset=AppriseAsset(), tag="a") is True

    # One configuration file
    assert len(ac) == 1

    # 2 services found in it
    assert len(ac.services()) == 2

    # Pop one of them (at index 0)
    ac.service_pop(0)

    # Verify that it no longer listed
    assert len(ac.services()) == 1

    # Test our ability to add Config objects to our apprise object
    a = Apprise()

    # Add our configuration object
    assert a.add(services=ac) is True

    # Detect our 1 entry (originally there were 2 but we deleted one)
    assert len(a) == 1

    # Notify our service
    assert bool(a.notify(body="apprise configuration power!")) is True

    # Add our configuration object
    assert (
        a.add(services=[AppriseConfig(str(t)), AppriseConfig(str(t))]) is True
    )

    # Detect our 5 loaded entries now; 1 from first config, and another
    # 2x2 based on adding our list above
    assert len(a) == 5

    # We can't add garbage
    assert a.add(services=object()) is False
    assert a.add(services=[object(), object()]) is False

    # Our length is unchanged
    assert len(a) == 5

    # reference index 0 of our list
    ref = a[0]
    assert isinstance(ref, NotifyBase)

    # Our length is unchanged
    assert len(a) == 5

    # pop the index
    ref_popped = a.pop(0)

    # Verify our response
    assert isinstance(ref_popped, NotifyBase)

    # Our length drops by 1
    assert len(a) == 4

    # Content popped is the same as one referenced by index
    # earlier
    assert ref == ref_popped

    # pop an index out of range
    with pytest.raises(IndexError):
        a.pop(len(a))

    # Our length remains unchanged
    assert len(a) == 4

    # Reference content out of range
    with pytest.raises(IndexError):
        a[len(a)]

    # reference index at the end of our list
    ref = a[len(a) - 1]

    # Verify our response
    assert isinstance(ref, NotifyBase)

    # Our length stays the same
    assert len(a) == 4

    # We can pop from the back of the list without a problem too
    ref_popped = a.pop(len(a) - 1)

    # Verify our response
    assert isinstance(ref_popped, NotifyBase)

    # Content popped is the same as one referenced by index
    # earlier
    assert ref == ref_popped

    # Our length drops by 1
    assert len(a) == 3

    # Now we'll test adding another element to the list so that it mixes up
    # our response object.
    # Below we add 3 different types, a ConfigBase, NotifyBase, and URL
    assert (
        a.add(
            services=[
                ConfigFile(path=(str(t))),
                "good://another.host",
                GoodNotification(**{"host": "nuxref.com"}),
            ]
        )
        is True
    )

    # Our length increases by 4 (2 entries in the config file, + 2 others)
    assert len(a) == 7

    # reference index at the end of our list
    ref = a[len(a) - 1]

    # Verify our response
    assert isinstance(ref, NotifyBase)

    # We can pop from the back of the list without a problem too
    ref_popped = a.pop(len(a) - 1)

    # Verify our response
    assert isinstance(ref_popped, NotifyBase)

    # Content popped is the same as one referenced by index
    # earlier
    assert ref == ref_popped

    # Our length drops by 1
    assert len(a) == 6

    # pop our list
    while len(a) > 0:
        assert isinstance(a.pop(len(a) - 1), NotifyBase)


def test_recursive_config_inclusion(tmpdir):
    """
    API: Apprise() Recursive Config Inclusion

    """

    # To test our config classes, we make three dummy configs
    class ConfigCrossPostAlways(ConfigFile):
        """A dummy config that is set to always allow inclusion."""

        service_name = "always"

        # protocol
        protocol = "always"

        # Always type
        allow_cross_includes = ContentIncludeMode.ALWAYS

    class ConfigCrossPostStrict(ConfigFile):
        """A dummy config that is set to strict inclusion."""

        service_name = "strict"

        # protocol
        protocol = "strict"

        # Always type
        allow_cross_includes = ContentIncludeMode.STRICT

    class ConfigCrossPostNever(ConfigFile):
        """A dummy config that is set to never allow inclusion."""

        service_name = "never"

        # protocol
        protocol = "never"

        # Always type
        allow_cross_includes = ContentIncludeMode.NEVER

    # store our entries
    C_MGR["never"] = ConfigCrossPostNever
    C_MGR["strict"] = ConfigCrossPostStrict
    C_MGR["always"] = ConfigCrossPostAlways

    # Make our new path valid
    suite = tmpdir.mkdir("apprise_config_recursion")

    cfg01 = suite.join("cfg01.cfg")
    cfg02 = suite.mkdir("dir1").join("cfg02.cfg")
    cfg03 = suite.mkdir("dir2").join("cfg03.cfg")
    cfg04 = suite.mkdir("dir3").join("cfg04.cfg")

    # Populate our files with valid configuration include lines
    cfg01.write(f"""
# json entry
json://localhost:8080

# absolute path inclusion to ourselves
include {cfg01!s}""")

    cfg02.write("""
# json entry
json://localhost:8080

# recursively include ourselves
include cfg02.cfg""")

    cfg03.write("""
# xml entry
xml://localhost:8080

# relative path inclusion
include ../dir1/cfg02.cfg

# test that we can't include invalid entries
include invalid://entry

# Include non includable type
include memory://""")

    cfg04.write(f"""
# xml entry
xml://localhost:8080

# always include of our file
include always://{cfg04!s}

# never include of our file
include never://{cfg04!s}

# strict include of our file
include strict://{cfg04!s}""")

    # Create ourselves a config object
    ac = AppriseConfig()

    # There are no services loaded
    assert len(ac) == 0

    # load our configuration
    assert ac.add(configs=str(cfg01)) is True

    # verify it loaded
    assert len(ac) == 1

    # 1 service will be loaded as there is no recursion at this point
    assert len(ac.services()) == 1

    # Create ourselves a config object
    ac = AppriseConfig(recursion=1)

    # load our configuration
    assert ac.add(configs=str(cfg01)) is True

    # verify one configuration file loaded however since it recursively
    # loaded itself 1 more time, it still doesn't impact the load count:
    assert len(ac) == 1

    # 2 services loaded now that we loaded the same file twice
    assert len(ac.services()) == 2

    #
    # Now we test relative file inclusion
    #

    # Create ourselves a config object
    ac = AppriseConfig(recursion=10)

    # There are no services loaded
    assert len(ac) == 0

    # load our configuration
    assert ac.add(configs=str(cfg02)) is True

    # verify it loaded
    assert len(ac) == 1

    # 11 services loaded because we reloaded ourselves 10 times
    # after loading the first entry
    assert len(ac.services()) == 11

    # Test our include modes (strict, always, and never)

    # Create ourselves a config object
    ac = AppriseConfig(recursion=1)

    # There are no services loaded
    assert len(ac) == 0

    # load our configuration
    assert ac.add(configs=str(cfg04)) is True

    # verify it loaded
    assert len(ac) == 1

    # 2 services loaded
    # 1 - from the file read (which is set at mode STRICT
    # 1 - from the always://
    #
    # The never:// can ever be includeed, and the strict:// is ot of type
    #  file:// (the one doing the include) so it is also ignored.
    #
    # By turning on the insecure_includes, we can include the strict files too
    assert len(ac.services()) == 2

    # Create ourselves a config object
    ac = AppriseConfig(recursion=1, insecure_includes=True)

    # There are no services loaded
    assert len(ac) == 0

    # load our configuration
    assert ac.add(configs=str(cfg04)) is True

    # verify it loaded
    assert len(ac) == 1

    # 3 services loaded
    # 1 - from the file read (which is set at mode STRICT
    # 1 - from the always://
    # 1 - from the strict:// (due to insecure_includes set)
    assert len(ac.services()) == 3


def test_apprise_config_file_loading(tmpdir):
    """
    API: AppriseConfig() URL Testing

    """

    config_path = tmpdir / "apprise.yml"

    # Create a temporary config file
    config_path.write("urls:\n      - json://localhost")

    # Flow from README.md
    ap = Apprise()
    ap.add("xml://localhost")
    config = AppriseConfig()
    config.add(str(config_path))
    ap.add(config)

    # Using urls()
    assert len(ap.urls()) == 2


def test_apprise_config_matrix_load():
    """
    API: AppriseConfig() matrix initialization

    """

    import apprise

    class ConfigDummy(ConfigBase):
        """A dummy wrapper for testing the different options in the load_matrix
        function."""

        # The default descriptive name associated with the Notification
        service_name = "dummy"

        # protocol as tuple
        protocol = ("uh", "oh")

        # secure protocol as tuple
        secure_protocol = ("no", "yes")

    class ConfigDummy2(ConfigBase):
        """A dummy wrapper for testing the different options in the load_matrix
        function."""

        # The default descriptive name associated with the Notification
        service_name = "dummy2"

        # secure protocol as tuple
        secure_protocol = ("true", "false")

    class ConfigDummy3(ConfigBase):
        """A dummy wrapper for testing the different options in the load_matrix
        function."""

        # The default descriptive name associated with the Notification
        service_name = "dummy3"

        # secure protocol as string
        secure_protocol = "true"

    class ConfigDummy4(ConfigBase):
        """A dummy wrapper for testing the different options in the load_matrix
        function."""

        # The default descriptive name associated with the Notification
        service_name = "dummy4"

        # protocol as string
        protocol = "true"

    # Generate ourselves a fake entry
    apprise.config.ConfigDummy = ConfigDummy
    apprise.config.ConfigDummy2 = ConfigDummy2
    apprise.config.ConfigDummy3 = ConfigDummy3
    apprise.config.ConfigDummy4 = ConfigDummy4


def test_configmatrix_dynamic_importing(tmpdir):
    """
    API: Apprise() Config Matrix Importing

    """

    # Make our new path valid
    suite = tmpdir.mkdir("apprise_config_test_suite")
    suite.join("__init__.py").write("")

    module_name = "badconfig"

    # Update our path to point to our new test suite
    sys.path.insert(0, str(suite))

    # Create a base area to work within
    base = suite.mkdir(module_name)
    base.join("__init__.py").write("")

    # Test no app_id
    base.join("ConfigBadFile1.py").write("""
class ConfigBadFile1:
    pass""")

    # No class of the same name
    base.join("ConfigBadFile2.py").write("""
class BadClassName:
    pass""")

    # Exception thrown
    base.join("ConfigBadFile3.py").write("""raise ImportError()""")

    # Utilizes a schema:// already occupied (as string)
    base.join("ConfigGoober.py").write("""
from apprise.config import ConfigBase
class ConfigGoober(ConfigBase):
    # This class tests the fact we have a new class name, but we're
    # trying to over-ride items previously used

    # The default simple (insecure) protocol (used by ConfigHTTP)
    protocol = ('http', 'goober')

    # The default secure protocol (used by ConfigHTTP)
    secure_protocol = 'https'

    @staticmethod
    def parse_url(url, *args, **kwargs):
        # always parseable
        return ConfigBase.parse_url(url, verify_host=False)""")

    # Utilizes a schema:// already occupied (as tuple)
    base.join("ConfigBugger.py").write("""
from apprise.config import ConfigBase
class ConfigBugger(ConfigBase):
    # This class tests the fact we have a new class name, but we're
    # trying to over-ride items previously used

    # The default simple (insecure) protocol (used by ConfigHTTP), the other
    # isn't
    protocol = ('http', 'bugger-test' )

    # The default secure protocol (used by ConfigHTTP), the other isn't
    secure_protocol = ('https', ['garbage'])

    @staticmethod
    def parse_url(url, *args, **kwargs):
        # always parseable
        return ConfigBase.parse_url(url, verify_host=False)""")


@mock.patch("os.path.getsize")
def test_config_base_inaccessible_text_file(mock_getsize, tmpdir):
    """
    API: ConfigBase.parse_inaccessible_text_file

    """

    # temporary file to work with
    t = tmpdir.mkdir("inaccessible").join("apprise")
    buf = "gnome://"
    t.write(buf)

    # Set getsize return value
    mock_getsize.return_value = None
    mock_getsize.side_effect = OSError

    # Create ourselves a config object
    ac = AppriseConfig(paths=str(t))

    # The following internally throws an exception but still counts
    # as a loaded configuration file
    assert len(ac) == 1

    # Thus no notifications are loaded
    assert len(ac.services()) == 0


def test_config_base_parse_yaml_file01(tmpdir):
    """
    API: ConfigBase.parse_yaml_file (#1)

    """
    t = tmpdir.mkdir("empty-file").join("apprise.yml")
    t.write("")

    # Create ourselves a config object
    ac = AppriseConfig(paths=str(t))

    # The number of configuration files that exist
    assert len(ac) == 1

    # no notifications are loaded
    assert len(ac.services()) == 0


def test_config_base_parse_yaml_file02(tmpdir):
    """
    API: ConfigBase.parse_yaml_file (#2)

    """
    t = tmpdir.mkdir("matching-tags").join("apprise.yml")
    t.write("""urls:
  - pover://nsisxnvnqixq39t0cw54pxieyvtdd9@2jevtmstfg5a7hfxndiybasttxxfku:
    - tag: test1
  - pover://rg8ta87qngcrkc6t4qbykxktou0uug@tqs3i88xlufexwl8t4asglt4zp5wfn:
    - tag: test2
  - pover://jcqgnlyq2oetea4qg3iunahj8d5ijm@evalvutkhc8ipmz2lcgc70wtsm0qpb:
    - tag: test3""")

    # Create ourselves a config object
    ac = AppriseConfig(paths=str(t))

    # The number of configuration files that exist
    assert len(ac) == 1

    # no notifications are loaded
    assert len(ac.services()) == 3

    # Test our ability to add Config objects to our apprise object
    a = Apprise()

    # Add our configuration object
    assert a.add(services=ac) is True

    # Detect our 3 entry as they should have loaded successfully
    assert len(a) == 3

    # No match
    assert sum(1 for _ in a.find("no-match")) == 0
    # Match everything
    assert sum(1 for _ in a.find("all")) == 3
    # Match test1 entry
    assert sum(1 for _ in a.find("test1")) == 1
    # Match test2 entry
    assert sum(1 for _ in a.find("test2")) == 1
    # Match test3 entry
    assert sum(1 for _ in a.find("test3")) == 1
    # Match test1 or test3 entry
    assert sum(1 for _ in a.find("test1, test3")) == 2


def test_config_base_parse_yaml_file03(tmpdir):
    """
    API: ConfigBase.parse_yaml_file (#3)

    """

    t = tmpdir.mkdir("bad-first-entry").join("apprise.yml")
    # The first entry is -tag and not tag
    # The element is therefore not picked up; This causes us to display
    # some warning messages to the screen complaining of this typo yet
    # still allowing us to load the URL since it is valid
    t.write("""urls:
  - pover://nsisxnvnqixq39t0cw54pxieyvtdd9@2jevtmstfg5a7hfxndiybasttxxfku:
    -tag: test1
  - pover://rg8ta87qngcrkc6t4qbykxktou0uug@tqs3i88xlufexwl8t4asglt4zp5wfn:
    - tag: test2
  - pover://jcqgnlyq2oetea4qg3iunahj8d5ijm@evalvutkhc8ipmz2lcgc70wtsm0qpb:
    - tag: test3""")

    # Create ourselves a config object
    ac = AppriseConfig(paths=str(t))

    # The number of configuration files that exist
    assert len(ac) == 1

    # no notifications lines processed is 3
    assert len(ac.services()) == 3

    # Test our ability to add Config objects to our apprise object
    a = Apprise()

    # Add our configuration object
    assert a.add(services=ac) is True

    # Detect our 3 entry as they should have loaded successfully
    assert len(a) == 3

    # No match
    assert sum(1 for _ in a.find("no-match")) == 0
    # Match everything
    assert sum(1 for _ in a.find("all")) == 3
    # No match for bad entry
    assert sum(1 for _ in a.find("test1")) == 0
    # Match test2 entry
    assert sum(1 for _ in a.find("test2")) == 1
    # Match test3 entry
    assert sum(1 for _ in a.find("test3")) == 1
    # Match test1 or test3 entry; (only matches test3)
    assert sum(1 for _ in a.find("test1, test3")) == 1


def test_config_base_parse_yaml_file04(tmpdir):
    """
    API: ConfigBase.parse_yaml_file (#4)

    Test the always keyword

    """
    t = tmpdir.mkdir("always-keyword").join("apprise.yml")
    t.write("""urls:
  - pover://nsisxnvnqixq39t0cw54pxieyvtdd9@2jevtmstfg5a7hfxndiybasttxxfku:
    - tag: test1,always
  - pover://rg8ta87qngcrkc6t4qbykxktou0uug@tqs3i88xlufexwl8t4asglt4zp5wfn:
    - tag: test2
  - pover://jcqgnlyq2oetea4qg3iunahj8d5ijm@evalvutkhc8ipmz2lcgc70wtsm0qpb:
    - tag: test3""")

    # Create ourselves a config object
    ac = AppriseConfig(paths=str(t))

    # The number of configuration files that exist
    assert len(ac) == 1

    # no notifications are loaded
    assert len(ac.services()) == 3

    # Test our ability to add Config objects to our apprise object
    a = Apprise()

    # Add our configuration object
    assert a.add(services=ac) is True

    # Detect our 3 entry as they should have loaded successfully
    assert len(a) == 3

    # No match still matches `always` keyword
    assert sum(1 for _ in a.find("no-match")) == 1
    # Unless we explicitly do not look for that file
    assert sum(1 for _ in a.find("no-match", match_always=False)) == 0
    # Match everything
    assert sum(1 for _ in a.find("all")) == 3
    # Match test1 entry (also has `always` keyword
    assert sum(1 for _ in a.find("test1")) == 1
    assert sum(1 for _ in a.find("test1", match_always=False)) == 1
    # Match test2 entry (and test1 due to always keyword)
    assert sum(1 for _ in a.find("test2")) == 2
    assert sum(1 for _ in a.find("test2", match_always=False)) == 1
    # Match test3 entry (and test1 due to always keyword)
    assert sum(1 for _ in a.find("test3")) == 2
    assert sum(1 for _ in a.find("test3", match_always=False)) == 1
    # Match test1 or test3 entry
    assert sum(1 for _ in a.find("test1, test3")) == 2


def test_apprise_config_template_parse(tmpdir):
    """
    API: AppriseConfig parsing of templates

    """

    # Create ourselves a config object
    ac = AppriseConfig()

    t = tmpdir.mkdir("template-testing").join("apprise.yml")
    t.write("""

    tag:
      - company

    # A comment line over top of a URL
    urls:
       - mailto://user:pass@example.com:
          - to: user1@gmail.com
            cc: test@hotmail.com

          - to: user2@gmail.com
            tag: co-worker
    """)

    # Create ourselves a config object
    ac = AppriseConfig(paths=str(t))

    # 2 emails to be sent
    assert len(ac.services()) == 2

    # The below checks are very customized for NotifyMail but just
    # test that the content got passed correctly
    assert (False, "user1@gmail.com") in ac[0][0].targets
    assert "test@hotmail.com" in ac[0][0].cc
    assert "company" in ac[0][1].tags

    assert (False, "user2@gmail.com") in ac[0][1].targets
    assert "company" in ac[0][1].tags
    assert "co-worker" in ac[0][1].tags

    #
    # Specifically test _special_token_handler()
    #
    tokens = {
        # This maps to itself (bcc); no change here
        "bcc": "user@test.com",
        # This should get mapped to 'targets'
        "to": "user1@abc.com",
        # white space and tab is intentionally added to the end to verify we
        # do not play/tamper with information
        "targets": "user2@abc.com, user3@abc.com   \t",
        # If the end user provides a configuration for data we simply don't use
        # this isn't a proble... we simply don't touch it either; we leave it
        # as is.
        "ignore": "not-used",
    }

    result = ConfigBase._special_token_handler("mailto", tokens)
    # to gets mapped to targets
    assert "to" not in result

    # bcc is allowed here
    assert "bcc" in result
    assert "targets" in result
    # Not used, but also not touched; this entry should still be in our result
    # set
    assert "ignore" in result
    # We'll concatinate all of our targets together
    assert len(result["targets"]) == 2
    assert "user1@abc.com" in result["targets"]
    # Content is passed as is
    assert "user2@abc.com, user3@abc.com   \t" in result["targets"]

    # We re-do the simmiar test above.  The very key difference is the
    # `targets` is a list already (it's expected type) so `to` can properly be
    # concatinated into the list vs the above (which tries to correct the
    # situation)
    tokens = {
        # This maps to itself (bcc); no change here
        "bcc": "user@test.com",
        # This should get mapped to 'targets'
        "to": "user1@abc.com",
        # similar to the above test except targets is now a proper
        # dictionary allowing the `to` (when translated to `targets`) to get
        # appended to it
        "targets": ["user2@abc.com", "user3@abc.com"],
        # If the end user provides a configuration for data we simply don't use
        # this isn't a proble... we simply don't touch it either; we leave it
        # as is.
        "ignore": "not-used",
    }

    result = ConfigBase._special_token_handler("mailto", tokens)
    # to gets mapped to targets
    assert "to" not in result

    # bcc is allowed here
    assert "bcc" in result
    assert "targets" in result
    # Not used, but also not touched; this entry should still be in our result
    # set
    assert "ignore" in result

    # Now we'll see the new user added as expected (concatinated into our list)
    assert len(result["targets"]) == 3
    assert "user1@abc.com" in result["targets"]
    assert "user2@abc.com" in result["targets"]
    assert "user3@abc.com" in result["targets"]

    # Test the False branch of the isinstance guard in the template_kwargs
    # loop -- where the kwarg key already holds a valid dict AND prefix
    # matches exist (so we do NOT reset the existing dict to {}).  The
    # slack schema has template_kwargs with a ':' prefix on the 'tokens'
    # key, which mirrors the old msteams layout used to cover this path.
    tokens = {
        # Pre-populated dict; must be preserved, not reset
        "tokens": {"existing": "value"},
        # ':' prefix match -- keeps matches non-empty so the loop body runs
        ":newkey": "newvalue",
    }

    result = ConfigBase._special_token_handler("slack", tokens)
    # The prefixed entry must be stripped from the top-level result
    assert ":newkey" not in result
    # The pre-existing dict must survive (not be wiped to {})
    assert isinstance(result.get("tokens"), dict)
    assert result["tokens"].get("existing") == "value"
    # The prefix match must be merged in alongside the existing entry
    assert result["tokens"].get("newkey") == "newvalue"

    # Test providing a list
    t.write("""
    # A comment line over top of a URL
    urls:
       - mailtos://user:pass@example.com:
          - smtp: smtp3-dev.google.gmail.com
            to:
              - John Smith 
              - Jason Tater 
              - user3@gmail.com

          - to: Henry Fisher , Jason Archie 
            smtp_host: smtp5-dev.google.gmail.com
            tag: drinking-buddy

       # provide case where the URL includes some input too
       # In both of these cases, the cc and targets (to) get over-ridden
       # by values below
       - mailtos://user:pass@example.com/arnold@imdb.com/?cc=bill@micro.com/:
            to:
              - override01@gmail.com
            cc:
              - override02@gmail.com

       - sinch://:
          - spi: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
            token: bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb

            # Test a case where we expect a string, but yaml reads it in as
            # a number
            from: 10005243890
            to: +1(123)555-1234
    """)

    # Create ourselves a config object
    ac = AppriseConfig(paths=str(t))

    # 2 emails to be sent and 1 Sinch service call
    assert len(ac.services()) == 4

    # Verify our users got placed into the to
    assert len(ac[0][0].targets) == 3
    assert ("John Smith", "user1@gmail.com") in ac[0][0].targets
    assert ("Jason Tater", "user2@gmail.com") in ac[0][0].targets
    assert (False, "user3@gmail.com") in ac[0][0].targets
    assert ac[0][0].smtp_host == "smtp3-dev.google.gmail.com"

    assert len(ac[0][1].targets) == 2
    assert ("Henry Fisher", "user4@gmail.com") in ac[0][1].targets
    assert ("Jason Archie", "user5@gmail.com") in ac[0][1].targets
    assert "drinking-buddy" in ac[0][1].tags
    assert ac[0][1].smtp_host == "smtp5-dev.google.gmail.com"

    # Our third test tests cases where some variables are defined inline
    # and additional ones are defined below that share the same token space
    assert len(ac[0][2].targets) == 1
    assert len(ac[0][2].cc) == 1
    assert (False, "override01@gmail.com") in ac[0][2].targets
    assert "override02@gmail.com" in ac[0][2].cc

    # Test our Since configuration now:
    assert len(ac[0][3].targets) == 1
    assert ac[0][3].service_plan_id == "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    assert ac[0][3].source == "+10005243890"
    assert ac[0][3].targets[0] == "+11235551234"


def test_config_base_yaml_trace_logging(tmpdir):
    """
    ConfigBase: cover TRACE-only logging path in YAML parsing

    This specifically targets:
      if ConfigBase.logger.isEnabledFor(logging.TRACE):
          ConfigBase.logger.trace(...)
    """
    t = tmpdir.mkdir("trace-logging").join("apprise.yml")
    t.write("""urls:
  - json://localhost
""")

    # Patch logger methods to force and observe TRACE logging behaviour
    with (
        mock.patch.object(
            ConfigBase.logger,
            "isEnabledFor",
            side_effect=lambda level: level == logging.TRACE,
        ),
        mock.patch.object(ConfigBase.logger, "trace") as m_trace,
    ):
        ac = AppriseConfig(paths=str(t))
        assert len(ac) == 1
        assert len(ac.services()) == 1

        # We expect our TRACE log call to have happened at least once
        assert m_trace.called is True


def test_config_base_clear_cache(tmpdir):
    """
    ConfigBase: cover clear_cache() behaviour
    """
    t = tmpdir.mkdir("clear-cache").join("apprise.yml")
    t.write("""urls:
  - json://localhost
""")

    ac = AppriseConfig(paths=str(t))

    # Trigger a load to populate cache inside the config instance
    assert len(ac.services()) == 1

    # The underlying config object should have cached state
    cfg = ac[0]
    assert isinstance(cfg, ConfigBase)
    assert isinstance(getattr(cfg, "_cached_services", None), list)
    assert getattr(cfg, "_cached_time", None) is not None

    # Now clear it and confirm it resets as expected
    cfg.clear_cache()
    assert getattr(cfg, "_cached_services", None) is None
    assert getattr(cfg, "_cached_time", None) is None


def test_config_base_parse_url_cache_variants():
    """
    ConfigBase.parse_url(): cover cache parsing for int and bool values
    """
    # Integer cache value
    r = ConfigBase.parse_url("file:///tmp/apprise.yml?cache=60")
    assert isinstance(r, dict)
    assert r.get("cache") == 60

    # Boolean cache value (non-int)
    r = ConfigBase.parse_url("file:///tmp/apprise.yml?cache=no")
    assert isinstance(r, dict)
    assert r.get("cache") is False

    r = ConfigBase.parse_url("file:///tmp/apprise.yml?cache=yes")
    assert isinstance(r, dict)
    assert r.get("cache") is True


def test_config_base_parse_url_invalid_format_removed():
    """
    ConfigBase.parse_url(): cover invalid format handling (format removed)
    """
    r = ConfigBase.parse_url(
        "file:///tmp/apprise.yml?format=definitely-not-a-format"
    )
    assert isinstance(r, dict)

    # Invalid format should be dropped from results
    assert "format" not in r


def test_config_base_expired_with_int_cache(monkeypatch):
    """
    ConfigBase.expired(): cover int cache expiry checks

    Simulate time movement to ensure both non-expired and expired paths.
    """
    cb = ConfigBase(cache=30)

    # Seed cache
    cb._cached_services = []
    cb._cached_time = 1000.0

    # Within cache window
    monkeypatch.setattr(time, "time", lambda: 1020.0)
    assert cb.expired() is False

    # Beyond cache window
    monkeypatch.setattr(time, "time", lambda: 1031.0)
    assert cb.expired() is True


def test_configuration_manager_no_import_failures():
    """Verify all native config plugins load without TRACE import errors."""

    # Remove the global test-suite log suppression so TRACE records
    # are visible during the scan below
    logging.disable(logging.NOTSET)

    # Force a clean reload of the native config plugin directory
    C_MGR.unload_modules()

    with LogCapture(level=logging.TRACE) as stream:
        # Trigger load_modules() via the lazy-load path
        len(C_MGR)

        # Grab the captured log content before the handler is removed
        content = stream.getvalue()

    # Restore log suppression for the remainder of the test suite
    logging.disable(logging.CRITICAL)

    # Any "import failed" line means a plugin directory was found but
    # contained no loadable Config* class (e.g. a stale __pycache__
    # directory left behind after a rename).
    failures = [
        line for line in content.splitlines() if "import failed" in line
    ]
    assert not failures, (
        "Config plugin import failures detected:\n" + "\n".join(failures)
    )

    # Leave the manager in a clean state for subsequent tests
    C_MGR.unload_modules()
caronc-apprise-dfec414/tests/test_apprise_emojis.py000066400000000000000000000111061526720371000227020ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
import logging
import sys

from apprise import emojis

logging.disable(logging.CRITICAL)

# Ensure we don't create .pyc files for these tests
sys.dont_write_bytecode = True


def test_emojis():
    "emojis: apply_emojis() testing"

    assert emojis.apply_emojis("") == ""
    assert emojis.apply_emojis("no change") == "no change"
    assert emojis.apply_emojis(":smile:") == "😄"
    assert emojis.apply_emojis(":smile::smile:") == "😄😄"

    # Missing Delimiters
    assert emojis.apply_emojis(":smile") == ":smile"
    assert emojis.apply_emojis("smile:") == "smile:"

    # Bad data
    assert emojis.apply_emojis(None) == ""
    assert emojis.apply_emojis(object) == ""
    assert emojis.apply_emojis(True) == ""
    assert emojis.apply_emojis(4.0) == ""


def test_emojis_alternation_aliases():
    """emojis: apply_emojis() handles regex alternation keys correctly."""

    # thumbsup / +1
    assert emojis.apply_emojis(":thumbsup:") == "👍"
    assert emojis.apply_emojis(":+1:") == "👍"

    # thumbsdown / -1
    assert emojis.apply_emojis(":thumbsdown:") == "👎"
    assert emojis.apply_emojis(":-1:") == "👎"

    # laughing / satisfied
    assert emojis.apply_emojis(":laughing:") == "😆"
    assert emojis.apply_emojis(":satisfied:") == "😆"

    # poop aliases
    assert emojis.apply_emojis(":poop:") == "💩"
    assert emojis.apply_emojis(":hankey:") == "💩"
    assert emojis.apply_emojis(":shit:") == "💩"

    # boom / collision
    assert emojis.apply_emojis(":boom:") == "💥"
    assert emojis.apply_emojis(":collision:") == "💥"

    # exclamation aliases
    assert emojis.apply_emojis(":exclamation:") == "❗"
    assert emojis.apply_emojis(":heavy_exclamation_mark:") == "❗"

    # knife / hocho
    assert emojis.apply_emojis(":knife:") == "🔪"
    assert emojis.apply_emojis(":hocho:") == "🔪"

    # memo / pencil
    assert emojis.apply_emojis(":memo:") == "📝"
    assert emojis.apply_emojis(":pencil:") == "📝"

    # uk / gb
    assert emojis.apply_emojis(":uk:") == "🇬🇧"
    assert emojis.apply_emojis(":gb:") == "🇬🇧"

    # aliases embedded in text
    assert emojis.apply_emojis("hello :thumbsup: world") == "hello 👍 world"
    assert emojis.apply_emojis(":poop::boom:") == "💩💥"

    # optional-group patterns: ':hand:' and ':raised_hand:' both map to ✋
    assert emojis.apply_emojis(":hand:") == "✋"
    assert emojis.apply_emojis(":raised_hand:") == "✋"

    # runner / running
    assert emojis.apply_emojis(":runner:") == "🏃"
    assert emojis.apply_emojis(":running:") == "🏃"


def test_emojis_lookup_no_pattern_match():
    """emojis: _lookup() returns the raw token when _EMOJI_PATTERN_LIST is
    empty (defensive fallback -- return text branch)."""

    # Ensure the engine is initialised first.
    emojis.apply_emojis(":smile:")

    original = emojis._EMOJI_PATTERN_LIST
    emojis._EMOJI_PATTERN_LIST = []
    try:
        # With no patterns to match against, _lookup falls through to
        # "return text", so the matched token is passed back unchanged.
        result = emojis.apply_emojis(":smile:")
        assert result == ":smile:"
    finally:
        emojis._EMOJI_PATTERN_LIST = original
caronc-apprise-dfec414/tests/test_apprise_helpers.py000066400000000000000000000106571526720371000230700ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
import logging
import os
import sys

import helpers

logging.disable(logging.CRITICAL)

# Ensure we don't create .pyc files for these tests
sys.dont_write_bytecode = True


def test_environ_temporary_change():
    """helpers: environ() testing"""
    # This is a helper function; but it does enough that we want to verify
    # our usage of it works correctly; yes... we're testing a test

    e_key1 = "APPRISE_TEMP1"
    e_key2 = "APPRISE_TEMP2"
    e_key3 = "APPRISE_TEMP3"

    e_val1 = "ABCD"
    e_val2 = "DEFG"
    e_val3 = "HIJK"

    os.environ[e_key1] = e_val1
    os.environ[e_key2] = e_val2
    os.environ[e_key3] = e_val3

    # Ensure our environment variable stuck
    assert e_key1 in os.environ
    assert e_val1 in os.environ[e_key1]
    assert e_key2 in os.environ
    assert e_val2 in os.environ[e_key2]
    assert e_key3 in os.environ
    assert e_val3 in os.environ[e_key3]

    with helpers.environ(e_key1, e_key3):
        # Eliminates Environment Variable 1 and 3
        assert e_key1 not in os.environ
        assert e_key2 in os.environ
        assert e_val2 in os.environ[e_key2]
        assert e_key3 not in os.environ

    # after with is over, environment is restored to normal
    assert e_key1 in os.environ
    assert e_val1 in os.environ[e_key1]
    assert e_key2 in os.environ
    assert e_val2 in os.environ[e_key2]
    assert e_key3 in os.environ
    assert e_val3 in os.environ[e_key3]

    d_key = "APPRISE_NOT_SET"
    n_key = "APPRISE_NEW_KEY"
    n_val = "NEW_VAL"

    # Verify that our temporary variables (defined above) are not pre-existing
    # environemnt variables as we'll be setting them below
    assert n_key not in os.environ
    assert d_key not in os.environ

    # makes it easier to pass in the arguments
    updates = {
        e_key1: e_val3,
        e_key2: e_val1,
        n_key: n_val,
    }
    with helpers.environ(d_key, e_key3, **updates):
        # Attempt to eliminate an undefined key (silently ignored)
        # Eliminates Environment Variable 3
        # Environment Variable 1 takes on the value of Env 3
        # Environment Variable 2 takes on the value of Env 1
        # Set a brand new variable that previously didn't exist
        assert e_key1 in os.environ
        assert e_val3 in os.environ[e_key1]
        assert e_key2 in os.environ
        assert e_val1 in os.environ[e_key2]
        assert e_key3 not in os.environ

        # Can't delete a variable that doesn't exist; so we're in the same
        # state here.
        assert d_key not in os.environ

        # Our temporary variables will be found now
        assert n_key in os.environ
        assert n_val in os.environ[n_key]

    # after with is over, environment is restored to normal
    assert e_key1 in os.environ
    assert e_val1 in os.environ[e_key1]
    assert e_key2 in os.environ
    assert e_val2 in os.environ[e_key2]
    assert e_key3 in os.environ
    assert e_val3 in os.environ[e_key3]

    # Even our temporary variables are now missing
    assert n_key not in os.environ
    assert d_key not in os.environ
caronc-apprise-dfec414/tests/test_apprise_jsonencoder.py000066400000000000000000000202051526720371000237250ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import base64
from datetime import datetime, timezone
import json

# Disable logging for a cleaner testing output
import logging
import sys
from unittest import mock

import pytest

from apprise import Apprise
from apprise.common import AWARE_DATE_ISO_FORMAT, NAIVE_DATE_ISO_FORMAT
from apprise.locale import LazyTranslation
from apprise.utils.json import AppriseJSONEncoder

logging.disable(logging.CRITICAL)

# Ensure we don't create .pyc files for these tests
sys.dont_write_bytecode = True


def test_apprise_json_encoder_datetime_naive():
    "AppriseJSONEncoder: naive datetime serialization"

    dt = datetime(2026, 3, 11, 12, 30, 45, 123456)
    result = json.dumps(dt, cls=AppriseJSONEncoder)
    assert result == f'"{dt.strftime(NAIVE_DATE_ISO_FORMAT)}"'
    assert "T" in result
    # Naive datetimes have no timezone offset
    assert result.endswith('"')
    assert "+00:00" not in result


def test_apprise_json_encoder_datetime_aware():
    "AppriseJSONEncoder: aware datetime serialization"

    dt = datetime(2026, 3, 11, 12, 30, 45, 123456, tzinfo=timezone.utc)
    result = json.dumps(dt, cls=AppriseJSONEncoder)
    assert result == f'"{dt.strftime(AWARE_DATE_ISO_FORMAT)}"'
    assert "T" in result
    # Aware datetimes include the timezone offset
    assert "+0000" in result


def test_apprise_json_encoder_bytes():
    "AppriseJSONEncoder: bytes serialization"

    data = b"hello world"
    result = json.dumps(data, cls=AppriseJSONEncoder)
    expected = base64.b64encode(data).decode("utf-8")
    assert result == f'"{expected}"'

    # Empty bytes
    result = json.dumps(b"", cls=AppriseJSONEncoder)
    assert result == '""'

    # Binary data
    data = bytes(range(256))
    result = json.dumps(data, cls=AppriseJSONEncoder)
    expected = base64.b64encode(data).decode("utf-8")
    assert result == f'"{expected}"'


def test_apprise_json_encoder_set():
    "AppriseJSONEncoder: set serialization"

    data = {1, 2, 3}
    result = json.loads(json.dumps(data, cls=AppriseJSONEncoder))
    assert isinstance(result, list)
    assert sorted(result) == [1, 2, 3]

    # Empty set
    result = json.loads(json.dumps(set(), cls=AppriseJSONEncoder))
    assert result == []


def test_apprise_json_encoder_frozenset():
    "AppriseJSONEncoder: frozenset serialization"

    data = frozenset([4, 5, 6])
    result = json.loads(json.dumps(data, cls=AppriseJSONEncoder))
    assert isinstance(result, list)
    assert sorted(result) == [4, 5, 6]

    # Empty frozenset
    result = json.loads(json.dumps(frozenset(), cls=AppriseJSONEncoder))
    assert result == []


def test_apprise_json_encoder_tuple():
    "AppriseJSONEncoder: tuple serialization"

    data = (7, 8, 9)
    result = json.loads(json.dumps(data, cls=AppriseJSONEncoder))
    assert isinstance(result, list)
    assert result == [7, 8, 9]

    # Empty tuple
    result = json.loads(json.dumps((), cls=AppriseJSONEncoder))
    assert result == []


def test_apprise_json_encoder_lazy_translation():
    "AppriseJSONEncoder: LazyTranslation serialization"

    lt = LazyTranslation(text="hello world")
    result = json.dumps(lt, cls=AppriseJSONEncoder)
    assert result == '"hello world"'

    # A translation with no gettext mapping returns the original text
    lt = LazyTranslation(text="no-translation-key-xyz")
    result = json.dumps(lt, cls=AppriseJSONEncoder)
    assert result == '"no-translation-key-xyz"'


def test_apprise_json_encoder_unsupported_type():
    "AppriseJSONEncoder: unsupported type raises TypeError"

    class CustomObj:
        pass

    with pytest.raises(TypeError):
        json.dumps(CustomObj(), cls=AppriseJSONEncoder)


def test_apprise_json_encoder_nested():
    "AppriseJSONEncoder: nested structures with mixed types"

    data = {
        "when": datetime(2026, 3, 11, 0, 0, 0, tzinfo=timezone.utc),
        "payload": b"binary data",
        "tags": {"alpha", "beta"},
        "label": LazyTranslation(text="nested"),
        "coords": (1.0, 2.0),
    }
    result = json.loads(json.dumps(data, cls=AppriseJSONEncoder))

    assert isinstance(result["when"], str)
    assert "T" in result["when"]
    assert isinstance(result["payload"], str)
    assert result["payload"] == base64.b64encode(b"binary data").decode(
        "utf-8"
    )
    assert isinstance(result["tags"], list)
    assert sorted(result["tags"]) == ["alpha", "beta"]
    assert result["label"] == "nested"
    assert result["coords"] == [1.0, 2.0]


def test_apprise_json_method_no_path():
    "Apprise.json(): returns compact JSON string when no path is given"

    apobj = Apprise()

    # Default call — compact output (indent=None), no newlines
    result = apobj.json()
    assert isinstance(result, str)
    parsed = json.loads(result)
    assert isinstance(parsed, dict)
    # Compact: no newlines in the output
    assert "\n" not in result

    # show_requirements and show_disabled flags are forwarded to details()
    result_req = apobj.json(show_requirements=True)
    assert isinstance(result_req, str)
    assert json.loads(result_req)

    result_dis = apobj.json(show_disabled=True)
    assert isinstance(result_dis, str)
    assert json.loads(result_dis)


def test_apprise_json_method_indent():
    "Apprise.json(): indent > 0 produces pretty-printed output with newlines"

    apobj = Apprise()

    result = apobj.json(indent=4)
    assert isinstance(result, str)
    # Pretty-printed output contains newlines
    assert "\n" in result
    assert json.loads(result)


def test_apprise_json_method_with_path(tmpdir):
    "Apprise.json(): writes JSON to file and returns True"

    apobj = Apprise()
    output = tmpdir.join("details.json")

    assert apobj.json(path=str(output)) is True
    assert output.check(file=True)

    content = output.read()
    parsed = json.loads(content)
    assert isinstance(parsed, dict)

    # Compact by default — no newlines
    assert "\n" not in content


def test_apprise_json_method_with_path_and_indent(tmpdir):
    "Apprise.json(): writes pretty-printed JSON to file when indent is set"

    apobj = Apprise()
    output = tmpdir.join("details_pretty.json")

    assert apobj.json(path=str(output), indent=2) is True
    content = output.read()
    assert "\n" in content
    assert json.loads(content)


def test_apprise_json_method_write_failure(tmpdir):
    "Apprise.json(): returns False when json.dump raises OSError"

    apobj = Apprise()
    output = tmpdir.join("fail.json")

    with mock.patch(
        "apprise.apprise.json.dump", side_effect=OSError("disk full")
    ):
        assert apobj.json(path=str(output)) is False


def test_apprise_json_method_write_eoferror(tmpdir):
    "Apprise.json(): returns False when json.dump raises EOFError"

    apobj = Apprise()
    output = tmpdir.join("eof.json")

    with mock.patch("apprise.apprise.json.dump", side_effect=EOFError):
        assert apobj.json(path=str(output)) is False
caronc-apprise-dfec414/tests/test_apprise_pickle.py000066400000000000000000000071121526720371000226650ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
import logging
import pickle
import sys

from apprise import Apprise, AppriseAsset, AppriseLocale

logging.disable(logging.CRITICAL)

# Ensure we don't create .pyc files for these tests
sys.dont_write_bytecode = True


def test_apprise_pickle_asset(tmpdir):
    """pickle: AppriseAsset"""
    asset = AppriseAsset()
    serialized = pickle.dumps(asset)
    new_asset = pickle.loads(serialized)

    # iterate over some keys to verify they're still the same:
    keys = (
        "app_id",
        "app_desc",
        "app_url",
        "html_notify_map",
        "ascii_notify_map",
        "default_html_color",
        "default_extension",
        "theme",
        "image_url_mask",
        "image_url_logo",
        "image_path_mask",
        "body_format",
        "async_mode",
        "interpret_escapes",
        "encoding",
        "secure_logging",
        "_recursion",
    )

    for key in keys:
        assert getattr(asset, key) == getattr(new_asset, key)


def test_apprise_pickle_locale(tmpdir):
    """pickle: AppriseLocale"""
    locale = AppriseLocale()
    serialized = pickle.dumps(locale)
    new_locale = pickle.loads(serialized)

    assert locale.lang == new_locale.lang

    # Ensure internal functions still call in new object
    new_locale.detect_language()


def test_apprise_pickle_core(tmpdir):
    """pickle: Apprise"""
    asset = AppriseAsset(app_id="default")
    apobj = Apprise(asset=asset)

    # Create a custom asset so we can verify it gets correctly serialized
    xml_asset = AppriseAsset(app_id="xml")

    # Store our Entries
    apobj.add("json://localhost")
    apobj.add("xml://localhost", asset=xml_asset)
    apobj.add("form://localhost")
    apobj.add("mailto://user:pass@localhost", tag="email")
    serialized = pickle.dumps(apobj)

    # Unserialize our object
    new_apobj = pickle.loads(serialized)

    # Verify that it loaded our URLs back
    assert len(new_apobj) == 4

    # Our assets were kept (note the XML altered entry)
    assert apobj[0].app_id == "default"
    assert apobj[1].app_id == "xml"
    assert apobj[2].app_id == "default"
    assert apobj[3].app_id == "default"

    # Our tag was kept
    assert "email" in apobj[3].tags
caronc-apprise-dfec414/tests/test_apprise_template.py000066400000000000000000002311441526720371000232350ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
"""Tests for template variables end to end.

Where a variable may be written, and what each placement can reach, is
covered separately in ``test_apprise_template_placement.py``.
"""

# Disable logging for a cleaner testing output
from collections import UserDict
from json import loads
import logging
import os
from types import MappingProxyType
from unittest import mock

import pytest
import requests

from apprise import Apprise, AppriseAsset, AppriseConfig, NotifyTemplate
from apprise.config import ConfigBase
from apprise.exception import AppriseTemplateError
from apprise.result import AppriseResultStatus


def parse(content):
    """Return the services a YAML configuration produces."""
    return ConfigBase.config_parse_yaml(content)[0]


def load(content):
    """Build an Apprise object around a YAML configuration."""
    apobj = Apprise()
    config = AppriseConfig()
    assert config.add_config(content, format="yaml")
    assert apobj.add(config)
    return apobj


@pytest.fixture
def logging_enabled():
    """Enable logging while tests inspect captured records."""
    previous = logging.root.manager.disable
    logging.disable(logging.NOTSET)
    yield
    logging.disable(previous)


@pytest.fixture
def sent():
    """Accept every outbound request so delivery reports success."""
    with mock.patch("requests.request") as request:
        response = mock.Mock()
        response.status_code = requests.codes.ok
        response.content = ""
        response.headers = {}
        request.return_value = response
        yield request


def test_apprise_template_deferred_entry():
    """The service cannot be built while a value is missing."""
    services = parse(
        "template:\n  - target\nurls:\n  - json://localhost/?to=${TARGET}\n"
    )
    assert len(services) == 1
    assert isinstance(services[0], NotifyTemplate)
    assert services[0].template_names == ("target",)
    assert services[0].template_required == ("target",)
    assert services[0].url_id() is None


def test_apprise_template_text_config():
    """TEXT configurations keep ${...} as literal text."""
    services, _ = ConfigBase.config_parse_text(
        "json://user:${NOT_A_VAR}@localhost"
    )
    assert len(services) == 1
    assert "$" in services[0].password


@pytest.mark.parametrize(
    "entry",
    (
        "json://localhost/:\n    - tag: ${T}",
        "json://localhost/:\n    - tags: ${T}",
    ),
)
def test_apprise_template_rejects_tag_variable(entry, logging_enabled, caplog):
    """Singular and plural YAML tag keys stay fixed."""
    with caplog.at_level(logging.ERROR):
        assert parse("template:\n  - t\nurls:\n  - {}\n".format(entry)) == []

    assert "not permitted in tag/tags" in caplog.text


@pytest.mark.parametrize(
    "url, field",
    (
        ("apprise://localhost/key?method=json&tags=${T}", "body"),
        ("json://localhost/?tag=${T}", None),
        ("json://localhost/?tags=${T}", None),
        ("json://localhost/?-tag=${T}", "params"),
        ("json://localhost/?:tag=${T}", "body"),
        ("json://localhost/?+tag=${T}", "headers"),
    ),
)
def test_apprise_template_url_tag_passthrough(url, field):
    """A templated tag on the URL is handed to the plugin, not routing."""
    apobj = load("template:\n  - t\nurls:\n  - {}\n".format(url))

    # The URL value never becomes an Apprise routing tag
    service = next(apobj.find(template={"t": "devops"}))
    assert not service.tags

    response = mock.Mock()
    response.status_code = requests.codes.ok
    response.content = b""
    response.headers = {}

    with (
        mock.patch("requests.post", return_value=response) as post,
        mock.patch("requests.request", return_value=response) as request,
    ):
        assert apobj.notify(body="x", template={"t": "devops"})

    # Only one of the two calls is used by each plugin
    call = (post.call_args or request.call_args).kwargs

    if field == "body":
        # The value reaches the request payload
        assert loads(call["data"])["tag"] in ("devops", ["devops"])

    elif field == "params":
        # The value reaches the request query string
        assert call["params"]["tag"] == "devops"

    elif field == "headers":
        # The value reaches the request headers
        assert call["headers"]["tag"] == "devops"


@pytest.mark.parametrize(
    "tags",
    ("tag: ${T}", "tags: ${T}", 'tags: [fixed, "${T}"]'),
)
def test_apprise_template_rejects_global_tag_variable(
    tags, logging_enabled, caplog
):
    """Global routing tags must also be known before resolution."""
    with caplog.at_level(logging.ERROR):
        services = parse(
            f"template:\n  - t\n{tags}\nurls:\n  - json://localhost/\n"
        )

    assert services == []
    assert "not permitted in tag/tags" in caplog.text


def test_apprise_template_disabled_keeps_global_tag_marker():
    """A tag marker is ordinary text when template support is disabled."""
    services, _ = ConfigBase.config_parse_yaml(
        "template:\n  - t\ntag: ${T}\nurls:\n  - json://localhost/\n",
        asset=AppriseAsset(allow_templates=False),
    )

    assert len(services) == 1
    assert {str(tag) for tag in services[0].tags} == {"${t}"}


def test_apprise_template_keeps_undeclared_global_tag_marker():
    """Only declared variables are forbidden in routing tags."""
    services = parse(
        "template:\n  - other\ntag: ${T}\nurls:\n  - json://localhost/\n"
    )

    assert len(services) == 1
    assert {str(tag) for tag in services[0].tags} == {"${t}"}


def test_apprise_template_fills_marker_after_schema():
    """Every marker past :// is filled in, wherever it was written."""
    entry = parse(
        "template:\n  - t\nurls:\n  - json://localhost/?+${T}=1&+X=${T}\n"
    )[0]

    assert isinstance(entry, NotifyTemplate)
    assert entry.template_names == ("t",)

    # The parameter name and the value both take the supplied value
    service = entry.resolve({"t": "REAL"})
    assert service.headers == {"REAL": "1", "X": "REAL"}


def test_apprise_template_preserves_yaml_setting_name():
    """A marker written as a YAML setting name is not a variable.

    Only values are replaced underneath a URL, so the name stays as the
    configuration spelled it and Apprise reads it the usual way.
    """
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - json://localhost/:\n"
        "      '+${T}': 1\n      '+X': ${T}\n"
    )[0]

    service = entry.resolve({"t": "REAL"})
    assert service.headers == {"${T}": "1", "X": "REAL"}


def test_apprise_template_bad_entry_isolated():
    """One refused entry leaves the rest of the file usable."""
    services = parse(
        "template:\n  - t\n"
        "urls:\n  - mailto://u:p@gmail.com:${T}\n  - json://other/\n"
    )
    assert len(services) == 1
    assert not isinstance(services[0], NotifyTemplate)


def test_apprise_template_rejects_yaml_loop(logging_enabled, caplog):
    """A recursive YAML value rejects its entry without escaping an error."""
    with caplog.at_level(logging.ERROR):
        services = parse(
            "template:\n  - t\n"
            "urls:\n  - json://user:${T}@localhost/:\n"
            "    - headers: &loop [*loop]\n"
            "  - json://localhost/\n"
        )

    assert len(services) == 1
    assert "Looping structure" in caplog.text


@pytest.mark.parametrize(
    "url",
    [
        "json://${T}/path",
        "json://host/${T}",
        "json://user:${T}@host/",
        "json://${T}:pass@host/",
        "json://host/?to=${T}",
    ],
)
def test_apprise_template_url_fields(url):
    """Host, path, credentials and parameters all accept one."""
    services = parse(f"template:\n  - t\nurls:\n  - {url}\n")
    assert len(services) == 1
    assert isinstance(services[0], NotifyTemplate)


def test_apprise_template_yaml_setting():
    """A setting written under the URL may be templated too."""
    services = parse(
        "template:\n  - t\n"
        "urls:\n  - json://localhost/:\n    - to: ${T}\n      tag: work\n"
    )
    assert len(services) == 1
    assert services[0].template_names == ("t",)
    assert {str(t) for t in services[0].tags} == {"work"}


def test_apprise_template_yaml_url_key():
    """The mapping form is supported as well as the plain form."""
    services = parse(
        "template:\n  - t\n"
        "urls:\n  - json://localhost/${T}:\n    - tag: work\n"
    )
    assert len(services) == 1
    assert isinstance(services[0], NotifyTemplate)


def test_apprise_template_value_encoding(sent):
    """Credential punctuation reaches the parsed password field unchanged."""
    apobj = load("template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n")
    hostile = "a b&c=d?e/f@g"
    assert apobj.notify(body="x", template={"t": hostile})

    service = next(apobj.find(template={"t": hostile}))

    # The value survives untouched
    assert service.password == hostile

    # The plugin escapes that field if it later renders a URL.
    rendered = service.url()
    assert "%26" in rendered
    assert "a b&c" not in rendered


def test_apprise_template_undeclared_marker_literal():
    """``${NAME}`` only means something when it was declared.

    Anything else is ordinary text, and the entry is not treated as
    templated at all.
    """
    services = parse(
        "template:\n  - t\nurls:\n  - json://user:${NOT_DECLARED}@localhost/\n"
    )

    assert len(services) == 1
    # It loaded straight away; nothing is waiting on a value
    assert not isinstance(services[0], NotifyTemplate)
    assert services[0].password == "${NOT_DECLARED}"


def test_apprise_template_undeclared_marker_not_pending(sent):
    """The URL is sent exactly as written."""
    apobj = load(
        "template:\n  - t\nurls:\n  - json://user:${NOPE}@localhost/\n"
    )

    assert apobj.template_vars() == {}
    assert apobj.notify(body="x").status == AppriseResultStatus.SUCCESS


def test_apprise_template_success_status(sent):
    """A complete set of values delivers as normal."""
    apobj = load(
        "template:\n  - t\n"
        "urls:\n  - json://localhost/?:x=${T}\n  - json://other/\n"
    )
    result = apobj.notify(body="x", template={"t": "value"})
    assert result.status == AppriseResultStatus.SUCCESS
    assert len(list(result)) == 2


def test_apprise_template_partial_status(sent):
    """A skipped entry must not read as a clean success."""
    apobj = load(
        "template:\n  - t\n"
        "urls:\n  - json://localhost/?:x=${T}\n  - json://other/\n"
    )
    result = apobj.notify(body="x")
    assert result.status == AppriseResultStatus.PARTIAL
    assert len(list(result)) == 1


def test_apprise_template_missing_all_status(sent):
    """Every match being held back is a failure, not a no-match."""
    apobj = load("template:\n  - t\nurls:\n  - json://localhost/?:x=${T}\n")
    assert apobj.notify(body="x").status == AppriseResultStatus.FAILURE


def test_apprise_template_environment_value(sent, monkeypatch):
    """A deployment can supply values without touching the config."""
    monkeypatch.setenv("APPRISE_TEMPLATE_T", "from-env")
    apobj = load("template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n")
    assert apobj.notify(body="x").status == AppriseResultStatus.SUCCESS
    assert next(apobj.find()).password == "from-env"


def test_apprise_template_tag_matching(sent):
    """Tags are known up front, so filtering is unaffected."""
    apobj = load(
        "template:\n  - t\n"
        "urls:\n  - json://user:${T}@localhost/:\n    - tag: work\n"
        "  - json://other/:\n    - tag: home\n"
    )
    matched = list(apobj.find(tag="work", template={"t": "x"}))
    assert len(matched) == 1
    assert matched[0].password == "x"


def test_apprise_template_pending_url_display():
    """Introspection reveals which values are still wanted."""
    apobj = load("template:\n  - t\nurls:\n  - json://host/${T}\n")
    assert "${T}" in apobj.urls()[0]
    assert "${T}" in apobj.urls(privacy=True)[0]


def test_apprise_template_secret_masking():
    """A variable name is safe to show; a password is not."""
    apobj = load(
        "template:\n  - t\nurls:\n  - json://user:hunter2secret@host/${T}\n"
    )
    shown = apobj.urls(privacy=True)[0]
    assert "${T}" in shown
    assert "hunter2secret" not in shown


def test_apprise_template_service_reuse(sent):
    """Anything the service remembers survives between calls."""
    entry = parse(
        "template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n"
    )[0]
    first = entry.resolve({"t": "x"})
    assert entry.resolve({"t": "x"}) is first
    assert entry.resolve({"t": "y"}) is not first

    # ...and an identifier only exists once it has been built
    assert entry.url_id() is None
    assert first.url_id()


def test_apprise_template_cache_limit():
    """A caller sending new values each time cannot grow it."""
    from apprise.template import MAX_RESOLVE_CACHE

    entry = parse(
        "template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n"
    )[0]
    for i in range(MAX_RESOLVE_CACHE + 10):
        entry.resolve({"t": f"value{i}"})

    assert len(entry._cache) <= MAX_RESOLVE_CACHE


def test_apprise_template_vars_summary():
    """Callers can ask what a configuration expects."""
    apobj = load(
        "template:\n  - needed\n  - other: a-default\n"
        "urls:\n  - json://host/${NEEDED}/${OTHER}\n"
    )
    report = apobj.template_vars()

    # No default means the call or environment needs to fill the name.
    assert report["needed"]["default"] is None

    # ...otherwise the default itself is reported
    assert report["other"]["default"] == "a-default"

    assert report["needed"]["services"] == 1


def test_apprise_template_missing_name_not_captured(sent, logging_enabled):
    """Keep missing names out of logs returned to API callers."""
    captured = []
    apobj = load(
        "template:\n  - super_secret_name\n"
        "urls:\n  - json://localhost/?:x=${SUPER_SECRET_NAME}\n"
        "  - json://other/\n"
    )
    result = apobj.notify(
        body="x",
        log_callback=lambda entry, service: captured.append(entry),
        log_level=logging.DEBUG,
    )

    assert result.status == AppriseResultStatus.PARTIAL

    blob = " ".join(entry.message for entry in captured).lower()
    assert "super_secret_name" not in blob
    assert "${" not in blob

    # The operator is still told that something was left out
    assert "skipped" in blob


def test_apprise_template_config_not_captured(sent, logging_enabled):
    """A capture must never carry the configuration body."""
    captured = []
    apobj = load(
        "template:\n  - t\n"
        "urls:\n  - json://user:hunter2secret@localhost/?:x=${T}\n"
    )
    apobj.notify(
        body="x",
        log_callback=lambda entry, service: captured.append(entry),
        log_level=logging.DEBUG,
    )

    blob = " ".join(entry.message for entry in captured)
    assert "hunter2secret" not in blob


def test_apprise_template_log_capture_opt_out(logging_enabled):
    """The flag the template code relies on works on its own."""
    from apprise.logger import _ServiceLogCapture, logger

    captured = []
    with _ServiceLogCapture(
        service=None,
        log_callback=lambda entry, service: captured.append(entry),
        level=logging.DEBUG,
    ):
        logger.error("PUBLIC-MARKER")
        logger.error("PRIVATE-MARKER", extra={"apprise_capture": False})

    blob = " ".join(entry.message for entry in captured)
    assert "PUBLIC-MARKER" in blob
    assert "PRIVATE-MARKER" not in blob


def test_apprise_template_included_declarations(sent, tmpdir):
    """Each file declares what it uses; values reach them all."""
    child = tmpdir.join("child.yml")
    child.write(
        "template:\n  - shared\nurls:\n  - json://user:${SHARED}@child-host/\n"
    )
    parent = tmpdir.join("parent.yml")
    parent.write(
        "template:\n  - shared\n"
        f"include:\n  - {child!s}\n"
        "urls:\n  - json://user:${SHARED}@parent-host/\n"
    )

    apobj = Apprise()
    config = AppriseConfig(recursion=1)
    assert config.add(str(parent))
    assert apobj.add(config)

    # One value supplied once reaches both files
    built = list(apobj.find(template={"shared": "one-value"}))
    assert len(built) == 2
    assert {service.password for service in built} == {"one-value"}


def test_apprise_template_shared_yaml_block(sent):
    """A YAML anchor used twice does not confuse the parser."""
    apobj = load(
        "template:\n  - t\n"
        "shared: &shared\n  to: ${T}\n"
        "urls:\n  - json://first/:\n    <<: *shared\n"
        "  - json://second/:\n    <<: *shared\n"
    )
    assert len(list(apobj.find(template={"t": "x"}))) == 2


def test_apprise_template_cli_value(tmpdir, sent):
    """--template supplies a value for a run."""
    from click.testing import CliRunner

    from apprise import cli

    config = tmpdir.join("apprise.yml")
    config.write("template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n")

    result = CliRunner().invoke(
        cli.main,
        ["-b", "x", f"--config={config!s}", "--template-var", "t=supplied"],
    )
    assert result.exit_code == 0


def test_apprise_template_cli_invalid_value(tmpdir):
    """A --template entry has to read as NAME=VALUE."""
    from click.testing import CliRunner

    from apprise import cli

    config = tmpdir.join("apprise.yml")
    config.write("urls:\n  - json://localhost\n")

    result = CliRunner().invoke(
        cli.main,
        ["-b", "x", f"--config={config!s}", "-tv", "no-equals-sign"],
    )
    assert result.exit_code == 2
    assert "NAME=VALUE" in result.output


def test_apprise_template_cli_dry_run(tmpdir):
    """The written form and the required names are both listed."""
    from click.testing import CliRunner

    from apprise import cli

    config = tmpdir.join("apprise.yml")
    config.write(
        "template:\n  - t\n  - other: a-default\n"
        "urls:\n  - json://host/${T}/${OTHER}\n"
    )

    result = CliRunner().invoke(
        cli.main, ["-b", "x", f"--config={config!s}", "--dry-run"]
    )
    assert "${T}" in result.output
    assert "t (required)" in result.output
    assert "other (has default)" in result.output


def test_apprise_template_pending_repr():
    """It stands in for a service, so it answers the same questions."""
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - json://user:${T}@localhost/:\n"
        "    - tag: work\n      retry: 2\n"
    )[0]

    assert entry.schema == "json"
    assert entry.service_name == "JSON"
    assert entry.enabled is True
    assert entry.retry == 2
    assert entry.optional is None
    assert "json" in repr(entry)
    assert "${T}" in str(entry)


def test_apprise_template_unknown_service_metadata():
    """A schema we do not carry is answered for safely."""
    entry = parse(
        "template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n"
    )[0]
    entry.results["schema"] = "not-a-real-schema"

    assert entry._plugin is None
    assert entry.service_name is None
    assert entry.enabled is True


def test_apprise_template_setting_display():
    """A setting is listed so it is clear a value is wanted."""
    apobj = load(
        "template:\n  - t\n"
        "urls:\n  - mailto://user:pass@gmail.com:\n    - to: ${T}\n"
    )
    shown = apobj.urls()[0]
    assert "${T}" in shown
    # ...and it survives being escaped for the URL
    assert "%24%7B" not in shown


def test_apprise_template_repeated_name(sent):
    """A variable may be written as many times as you like."""
    apobj = load(
        "template:\n  - t\n"
        "urls:\n  - json://user:${T}@localhost/${T}/:\n    - to: ${T}\n"
    )

    service = next(apobj.find(template={"t": "same"}))
    assert service.password == "same"
    assert "/same/" in service.url()


def test_apprise_template_url_size_limit(monkeypatch, logging_enabled, caplog):
    """A built URL is capped no matter what values arrive."""
    import apprise.template as template_module

    entry = parse(
        "template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n"
    )[0]
    monkeypatch.setattr(template_module, "MAX_RESOLVED_URL_LEN", 10)

    with caplog.at_level(logging.ERROR):
        assert entry.resolve({"t": "a-value-well-over-ten-characters"}) is None

    # The message says which lines of the file to go and look at
    assert "YAML entry #1, item #1" in caplog.text


def test_apprise_template_build_failure(logging_enabled, caplog):
    """A value the service rejects skips the entry, not the run."""
    entry = parse(
        "template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n"
    )[0]

    from apprise.template import N_MGR

    with (
        mock.patch.object(
            type(N_MGR),
            "__getitem__",
            side_effect=TypeError("the value was refused"),
        ),
        caplog.at_level(logging.ERROR),
    ):
        assert entry.resolve({"t": "x"}) is None

    assert "YAML entry #1, item #1" in caplog.text


def test_apprise_template_substitution_failure(logging_enabled, caplog):
    """A failure while filling values in is handled quietly."""
    entry = parse(
        "template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n"
    )[0]

    with (
        mock.patch.object(
            entry.placeholders, "substitute", side_effect=RuntimeError("nope")
        ),
        caplog.at_level(logging.ERROR),
    ):
        assert entry.resolve({"t": "x"}) is None

    assert "YAML entry #1, item #1" in caplog.text


def test_apprise_template_exception_detail_is_never_captured(
    logging_enabled, caplog
):
    """A rejected value is not handed back through the result log."""
    apobj = Apprise()
    config = AppriseConfig()
    config.add_config(
        "template:\n  - key\n"
        "urls:\n  - sendgrid://${KEY}:user@example.com/to@example.com\n",
        format="yaml",
    )
    apobj.add(config)

    captured = []

    with caplog.at_level(logging.DEBUG, logger="apprise"):
        apobj.notify(
            body="x",
            # Refused by the service, which names it in the error it raises
            template={"key": "SECRET!!!KEY"},
            log_callback=lambda entry, plugin: captured.append(entry),
            log_level=logging.DEBUG,
        )

    messages = [str(getattr(entry, "message", entry)) for entry in captured]

    # The entry was skipped, and said so without naming the value
    assert any("Could not load" in m for m in messages)

    # The service's own exception text never reaches the caller
    assert not [m for m in messages if "Loading Exception" in m]


def test_apprise_template_location_counts_each_expansion():
    """One URL block that becomes several services numbers them apart."""
    services = parse(
        "template:\n  - t\n"
        "urls:\n  - mailto://user:pass@gmail.com:\n"
        "    - to: one@example.com\n      cc: ${T}\n"
        "    - to: two@example.com\n      cc: ${T}\n"
    )

    # Both came from the first block under urls:, as separate items
    assert [s.location for s in services] == [
        "YAML entry #1, item #1",
        "YAML entry #1, item #2",
    ]


def test_apprise_template_adjacent_text_masking():
    """Only the variable name is safe to show; the rest is not."""
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - json://user:prefix${T}suffix@localhost/\n"
    )[0]

    shown = entry.url(privacy=True)
    assert "${T}" in shown
    assert "prefix" not in shown
    assert "suffix" not in shown

    # Without privacy the whole thing reads back as written
    assert "prefix${T}suffix" in entry.url()


def test_apprise_template_query_display():
    """A parameter waiting on a value is visible in the URL."""
    entry = parse(
        "template:\n  - t\nurls:\n  - json://localhost/?:custom=${T}\n"
    )[0]
    assert "${T}" in entry.url()


def test_apprise_template_parse_time_validation(logging_enabled, caplog):
    """Report services that must validate a field while parsing."""
    with caplog.at_level(logging.ERROR):
        services = parse(
            "template:\n  - t\n"
            "urls:\n  - sendgrid://SG.abcdefghij:${T}/to@example.com\n"
        )

    assert services == []
    assert "template variable can not be used at this position" in (
        caplog.text.lower()
    )


def test_apprise_template_valid_service_position():
    """The limitation is the position, not the service."""
    services = parse(
        "template:\n  - t\n"
        "urls:\n  - sendgrid://${T}:from@example.com/to@example.com\n"
    )
    assert len(services) == 1
    assert isinstance(services[0], NotifyTemplate)


def test_apprise_template_service_coverage():
    """A spot check across a few differently shaped URLs."""
    for url in (
        "discord://${T}/${T}",
        "slack://${T}/${T}/${T}",
        "mailtos://user:pass@example.com/a@b.com?smtp=${T}",
        "twilio://sid:token@${T}/+15551234567",
        "tgram://123456789:${T}/-1001234567890",
    ):
        services = parse(f"template:\n  - t\nurls:\n  - {url}\n")
        assert len(services) == 1, url
        assert isinstance(services[0], NotifyTemplate), url


def test_apprise_template_many_url_variables(sent):
    """There is no cap on how many are used in one URL."""
    names = [f"v{i}" for i in range(60)]
    declared = "\n".join(f"  - {name}" for name in names)
    path = "/".join("${{{}}}".format(name.upper()) for name in names)

    apobj = load(f"template:\n{declared}\nurls:\n  - json://host/{path}\n")
    values = {name: f"val{i}" for i, name in enumerate(names)}

    service = next(apobj.find(template=values))
    for i in range(60):
        assert f"val{i}" in service.url()


def test_apprise_template_shared_url_setting(sent):
    """One name can fill the URL and a setting below it."""
    apobj = load(
        "template:\n  - t\n"
        "urls:\n  - json://user:${T}@localhost/:\n"
        "    - to: ${T}\n      tag: work\n"
    )
    service = next(apobj.find(template={"t": "shared"}))
    assert service.password == "shared"


def test_apprise_template_query_value_is_not_reparsed(sent):
    """A parsed query value is not reparsed as more query settings."""
    apobj = load(
        "template:\n  - v\nurls:\n  - json://localhost/?:custom=${V}\n"
    )
    control = load("template:\n  - v\nurls:\n  - json://localhost/?:c=${V}\n")

    evil = next(
        apobj.find(template={"v": "x&method=GET&to=hijacked@example.com"})
    )
    clean = next(control.find(template={"v": "x"}))

    # The marker occupied one parsed value, so its punctuation stays there.
    assert evil.method == clean.method == "POST"


def test_apprise_template_path_punctuation(sent):
    """Path fields preserve punctuation selected by the config author."""
    apobj = load("template:\n  - v\nurls:\n  - json://h/${V}/x\n")
    service = next(apobj.find(template={"v": "seg/ment?x=1&y=2#z"}))
    assert service.fullpath == "/seg/ment?x=1&y=2#z/x"


def test_apprise_template_service_validates_value(sent):
    """Garbage is handed to the service to make sense of."""
    apobj = load("template:\n  - v\nurls:\n  - json://${V}/\n")
    for value in ("ok.example.com", "evil.com/p", "not a host", "a@b"):
        assert next(apobj.find(template={"v": value}), None) is not None


def test_apprise_template_embedded_host_is_preserved(sent):
    """A partial hostname keeps author-supplied URL punctuation."""
    apobj = load("template:\n  - v\nurls:\n  - json://trusted-${V}/\n")
    service = next(
        apobj.find(template={"v": "name@evil.test:80/path?x=1#part"})
    )

    assert service.host == "trusted-name@evil.test:80/path?x=1#part"
    assert service.fullpath == "/"


@pytest.mark.parametrize(
    "entry",
    [
        # Written on its own
        "${V}://host/",
        # Written as a YAML key with settings under it
        "${V}://host/:\n    - tag: work",
        # A marker standing in for the schema and its separator
        "${V}user:pass@host/",
        # Trailing text after the marker, as in a secure variant
        "${V}s://host/",
        # Leading text before the marker
        "json${V}://host/",
        # ...and the same the other way around
        "${V}json://host/",
        # Buried in the middle of an otherwise real schema
        "js${V}on://host/",
        # A secure variant built from both
        "mailto${V}s://host/",
        # No separator at all
        "${V}",
        # A separator that is not quite one
        "${V}//host/",
        # A later separator does not hide a variable in the schema position
        "${V}/path://later",
        # The mapping form must make the same decision
        "${V}/path://later:\n    - tag: work",
        # A URL hidden in a query value cannot provide the schema boundary
        "${V}localhost/?url=http://bad.actor.com",
        # A backslash before :// does not make a variable schema acceptable
        r"abc${V}s\://localhost",
    ],
)
def test_apprise_template_rejects_schema_variable(
    entry, logging_enabled, caplog
):
    """Nothing before :// can be a template variable.

    The schema decides which service reads the URL, and that is settled
    long before a value is known, so this is a configuration error rather
    than an unresolved notification service.
    """
    with caplog.at_level(logging.ERROR):
        assert parse("template:\n  - v\nurls:\n  - {}\n".format(entry)) == []

    assert "not permitted in URL schemas" in caplog.text


def test_apprise_template_dollar_is_literal():
    """A "$" before a marker is just a "$".

    There is no escape syntax. To keep a ${NAME} literal, simply do not
    declare that name.
    """
    entry = parse("template:\n  - t\nurls:\n  - json://l/?+X=$${T}\n")[0]

    service = entry.resolve({"t": "abc"})
    assert service.headers == {"X": "$abc"}


def test_apprise_template_default_marker_is_literal():
    """A default is used exactly as written, markers and all.

    One declaration never builds on another. ``key`` below is the text
    ``${value}``, not ``34``. Assemble values in the URL instead.
    """
    apobj = load(
        "template:\n  value: 34\n  key: ${value}\n"
        "urls:\n  - json://l/?+K=${KEY}&+V=${VALUE}\n"
    )

    # K keeps the marker; V shows that 'value' really does resolve to 34
    assert next(apobj.find()).headers == {"K": "${value}", "V": "34"}


def test_apprise_template_supplied_marker_is_literal():
    """A value handed in for one call is not looked at again either."""
    apobj = load(
        "template:\n  value: 34\n  key:\n"
        "urls:\n  - json://l/?+K=${KEY}&+V=${VALUE}\n"
    )
    service = next(apobj.find(template={"key": "${value}"}))

    assert service.headers == {"K": "${value}", "V": "34"}


def test_apprise_template_environment_marker_is_literal():
    """An environment value is taken as written in the same way."""
    with mock.patch.dict(os.environ, {"APPRISE_TEMPLATE_KEY": "${value}"}):
        apobj = load(
            "template:\n  value: 34\n  key:\n"
            "urls:\n  - json://l/?+K=${KEY}&+V=${VALUE}\n"
        )
        assert next(apobj.find()).headers == {"K": "${value}", "V": "34"}


def test_apprise_template_bad_schema_isolated(sent):
    """One bad entry leaves the rest of the file usable."""
    services = parse(
        "template:\n  - v\nurls:\n  - ${V}://host/\n  - json://ok/\n"
    )
    assert len(services) == 1
    assert not isinstance(services[0], NotifyTemplate)


def test_apprise_template_credential_separators(sent):
    """Ordinary password punctuation is kept unchanged."""
    apobj = load("template:\n  - v\nurls:\n  - json://u:${V}@host/\n")
    service = next(apobj.find(template={"v": "p/a?s&s"}))
    assert service.password == "p/a?s&s"


@pytest.mark.parametrize("credentials", ("user", "user:pass"))
def test_apprise_template_combined_credentials(credentials, sent):
    """A user field may carry either supported credential form."""
    apobj = load("template:\n  - creds\nurls:\n  - json://${CREDS}@host/\n")
    service = next(apobj.find(template={"creds": credentials}))
    user, separator, password = credentials.partition(":")
    assert service.user == user
    assert service.password == (password if separator else None)
    assert service.host == "host"


def test_apprise_template_email_authority(sent):
    """A service may accept an email as its complete authority value."""
    apobj = load(
        "template:\n  - email\n"
        "urls:\n"
        "  - ses://${EMAIL}/T1JJ3T3L2/A1BRTD4JD/"
        "TIiajkdnlazkcevi7FQ/us-west-2/user2@example.com\n"
    )
    service = next(apobj.find(template={"email": "sender@example.com"}))
    assert service.from_addr == "sender@example.com"


# The characters that separate one part of a URL from the next, and a few
# everyday ones that have to survive untouched.
SEPARATORS = ("/", "&", "@")

VALUES = (
    "plain-value",
    "a/b",
    "a&b",
    "a@b",
    "user:pass",
    "one,two",
    "a/b&c@d",
    "b64/secret+value==",
)


@pytest.mark.parametrize("value", VALUES)
def test_apprise_template_url_value_is_preserved(value, sent):
    """A value written into a URL fills the one spot it was written in."""
    apobj = load("template:\n  - v\nurls:\n  - json://user:${V}@host/\n")
    service = next(apobj.find(template={"v": value}))

    # The service still talks to the host the author wrote
    assert service.host == "host"
    assert service.user == "user"

    # ...and the value arrives whole, however it was written
    assert service.password == value


@pytest.mark.parametrize("value", VALUES)
def test_apprise_template_setting_value_is_left_alone(value, sent):
    """A setting under the URL already says what its value is for."""
    apobj = load(
        "template:\n  - v\n"
        "urls:\n  - json://user:pass@host/:\n    - to: ${V}\n"
    )
    service = next(apobj.find(template={"v": value}))

    assert service.host == "host"
    assert service.password == "pass"


@pytest.mark.parametrize("value", VALUES)
def test_apprise_template_query_value_adds_no_parameter(value, sent):
    """An "&" in a value cannot become another parameter."""
    apobj = load("template:\n  - v\nurls:\n  - json://host/?:custom=${V}\n")
    control = load("template:\n  - v\nurls:\n  - json://host/?:custom=${V}\n")

    service = next(apobj.find(template={"v": value}))
    clean = next(control.find(template={"v": "plain"}))

    # Nothing the value carried changed how the service was set up
    assert service.method == clean.method
    assert service.host == clean.host == "host"


@pytest.mark.parametrize(
    "address", ["[::1]", "::1", "2001:db8::1", "127.0.0.1", "host.example"]
)
def test_apprise_template_real_addresses_survive(address, sent):
    """A genuine address is written through untouched."""
    apobj = load("template:\n  - v\nurls:\n  - json://${V}/\n")
    assert next(apobj.find(template={"v": address})).host == address


@pytest.mark.parametrize("hostile", VALUES)
def test_apprise_template_email_setting_keeps_server(hostile, sent):
    """A named email setting cannot change the configured mail server."""
    apobj = load(
        "template:\n  - v\n"
        "urls:\n  - mailtos://user:pass@example.com/:\n    - bcc: ${V}\n"
    )
    service = next(apobj.find(template={"v": hostile}))

    # The server being talked to is still the one the author wrote
    assert service.host == "example.com"
    assert service.user == "user"
    assert service.password == "pass"


def two_configurations():
    """Two separately loaded configurations, each with its own variable."""
    apobj = Apprise()
    for name in ("alpha", "beta"):
        config = AppriseConfig()
        assert config.add_config(
            f"template:\n  - {name}\n"
            f"urls:\n  - json://user:${{{name.upper()}}}@{name}-host/\n",
            format="yaml",
        )
        assert apobj.add(config)
    return apobj


def test_apprise_template_values_span_configurations(sent):
    """One set of values covers everything that is loaded.

    Each entry passes over the names belonging to the other
    configuration rather than refusing them.
    """
    built = list(
        two_configurations().find(template={"alpha": "1", "beta": "2"})
    )
    assert sorted(service.host for service in built) == [
        "alpha-host",
        "beta-host",
    ]
    assert sorted(service.password for service in built) == ["1", "2"]


def test_apprise_template_case_is_ignored_end_to_end(sent):
    """Declaration, marker, and supplied key casing may all differ."""
    apobj = Apprise()
    config = AppriseConfig()
    assert config.add_config(
        "template:\n  - MiXeD\nurls:\n  - json://user:${mIxEd}@localhost/\n",
        format="yaml",
    )
    assert apobj.add(config)

    service = next(apobj.find(template={"MIXED": "value"}))
    assert service.password == "value"


def test_apprise_template_partial_values_span_configurations(sent):
    """Supplying one still delivers to the one it belongs to."""
    built = list(two_configurations().find(template={"alpha": "1"}))
    assert [service.host for service in built] == ["alpha-host"]


def test_apprise_template_unknown_name_is_ignored(sent):
    """A name no loaded configuration uses does not block delivery."""
    built = list(
        two_configurations().find(template={"alpha": "1", "nowhere": "x"})
    )
    assert [service.host for service in built] == ["alpha-host"]


def test_apprise_template_unknown_name_does_not_change_status(sent):
    """An unused name does not turn a successful send into a partial one."""
    apobj = Apprise()
    assert apobj.add("json://untemplated/")

    result = apobj.notify(body="x", template={"nowhere": "x"})

    assert result.status == AppriseResultStatus.SUCCESS


def test_apprise_template_hides_unknown_name_from_capture(
    sent, logging_enabled
):
    """The names must not reach whoever asked for the notification."""
    captured = []
    two_configurations().notify(
        body="x",
        template={"a_secret_name": "x"},
        log_callback=lambda entry, service: captured.append(entry),
        log_level=logging.DEBUG,
    )

    blob = " ".join(entry.message for entry in captured).lower()
    assert "a_secret_name" not in blob


def test_apprise_template_logs_unknown_name_locally(
    sent, logging_enabled, caplog
):
    """The local debug log names unused inputs without logging values."""
    with caplog.at_level(logging.DEBUG):
        list(
            two_configurations().find(
                template={"NoWhErE": "do-not-log-this-value"}
            )
        )

    assert "nowhere" in caplog.text
    assert "supplied but not used" in caplog.text
    assert "do-not-log-this-value" not in caplog.text


def test_apprise_template_unused_name_log_is_bounded(logging_enabled, caplog):
    """A large unused mapping cannot create an equally large log entry."""
    values = {"name{}".format(i): "secret{}".format(i) for i in range(25)}

    with caplog.at_level(logging.DEBUG):
        list(Apprise().find(template=values))

    assert "(+5 more)" in caplog.text
    assert "name19" in caplog.text
    assert "name20" not in caplog.text
    assert "secret" not in caplog.text


def test_apprise_template_can_be_switched_off(sent):
    """The configuration is then read as it was before templates.

    Nothing is held back, nothing is read from the environment, and the
    markers stay exactly as they were written.
    """
    content = "template:\n  - v\nurls:\n  - json://user:${V}@localhost/\n"
    asset = AppriseAsset(allow_templates=False)

    apobj = Apprise(asset=asset)
    config = AppriseConfig(asset=asset)
    assert config.add_config(content, format="yaml")
    assert apobj.add(config)

    service = next(apobj.find())
    assert not isinstance(service, NotifyTemplate)
    assert service.password == "${V}"
    assert apobj.template_vars() == {}


def test_apprise_template_disabled_ignores_environment(sent, monkeypatch):
    """A value in the environment must not quietly take effect."""
    monkeypatch.setenv("APPRISE_TEMPLATE_V", "from-env")
    asset = AppriseAsset(allow_templates=False)

    apobj = Apprise(asset=asset)
    config = AppriseConfig(asset=asset)
    assert config.add_config(
        "template:\n  - v\nurls:\n  - json://user:${V}@localhost/\n",
        format="yaml",
    )
    assert apobj.add(config)

    assert next(apobj.find()).password == "${V}"


def test_apprise_template_duplicate_setting_uses_last_value():
    """PyYAML's normal last-value behavior applies below root sections."""
    services = parse(
        "urls:\n  - json://localhost/:\n"
        "    - method: GET\n      method: POST\n"
    )

    assert len(services) == 1
    assert services[0].method == "POST"


def test_config_yaml_duplicate_section_uses_last_value():
    """Repeated root sections retain PyYAML's last-value behavior."""
    services = parse("urls:\n  - json://first/\nurls:\n  - json://second/\n")

    assert len(services) == 1
    assert services[0].host == "second"


def test_apprise_template_late_declaration_is_recognized(
    logging_enabled, caplog
):
    """A declaration may follow the service that uses it."""
    with caplog.at_level(logging.DEBUG):
        services = parse(
            "urls:\n  - json://user:${LATE}@localhost/\ntemplate:\n  - late\n"
        )

    assert len(services) == 1
    assert isinstance(services[0], NotifyTemplate)
    assert "not defined" not in caplog.text


def test_apprise_template_keeps_undeclared_marker(logging_enabled, caplog):
    """An undeclared marker remains literal and receives a debug hint."""
    with caplog.at_level(logging.DEBUG):
        services = parse("urls:\n  - json://user:${MISSING}@localhost/\n")

    assert services[0].password == "${MISSING}"
    assert "'missing' is not defined" in caplog.text
    assert "kept as written" in caplog.text
    assert not [r for r in caplog.records if r.levelno >= logging.WARNING]


def test_apprise_template_keeps_undeclared_marker_beside_declared_one(
    logging_enabled, caplog
):
    """Declaring one marker does not activate other marker-like text."""
    with caplog.at_level(logging.DEBUG):
        services = parse(
            "template:\n  - used\n"
            "urls:\n  - json://user:${MISSING}@localhost/?to=${USED}\n"
        )

    assert services[0].results["password"] == "${MISSING}"
    assert "'missing' is not defined" in caplog.text


def test_apprise_template_reports_unused_declaration(logging_enabled, caplog):
    """Debug inspection warns about declarations unused by service entries."""
    with caplog.at_level(logging.DEBUG):
        services = parse(
            "template:\n  - unused\nurls:\n  - json://localhost/\n"
        )

    assert len(services) == 1
    assert "'unused' is defined but not referenced" in caplog.text
    assert any(
        record.levelno == logging.WARNING
        and "'unused' is defined but not referenced" in record.message
        for record in caplog.records
    )


def test_apprise_template_yaml_value_counts_as_reference(
    logging_enabled, caplog
):
    """A marker in a YAML option value counts as a real use."""
    with caplog.at_level(logging.DEBUG):
        services = parse(
            "template:\n  - used\n"
            "urls:\n  - json://localhost/:\n"
            "      headers:\n        X-Test: ${USED}\n"
        )

    assert len(services) == 1
    assert isinstance(services[0], NotifyTemplate)
    assert "not referenced" not in caplog.text


def test_apprise_template_yaml_name_is_not_a_reference(
    logging_enabled, caplog
):
    """YAML setting names stay literal and do not count as variable use."""
    with caplog.at_level(logging.DEBUG):
        services = parse(
            "template:\n  - unused\n"
            "urls:\n  - json://localhost/:\n"
            "      '+${UNUSED}': literal\n"
        )

    assert len(services) == 1
    assert "'unused' is defined but not referenced" in caplog.text


def test_apprise_template_skips_reference_scan_without_debug(
    logging_enabled, caplog
):
    """Reference discovery adds no work when debug logging is disabled."""
    with (
        mock.patch(
            "apprise.config.base.template_references",
            side_effect=AssertionError("unexpected template scan"),
        ),
        caplog.at_level(logging.INFO),
    ):
        services = parse(
            "template:\n  - unused\nurls:\n  - json://localhost/\n"
        )

    assert len(services) == 1


def test_apprise_template_supports_shared_yaml_anchor():
    """A YAML anchor may reuse an entry containing a template marker."""
    services = parse(
        "template:\n  - t\n"
        "urls:\n  - &shared json://localhost/?to=${T}\n  - *shared\n"
    )

    # Both entries load and both still wait on the same value
    assert len(services) == 2
    assert all(isinstance(s, NotifyTemplate) for s in services)


def test_apprise_template_disabled_marker_is_left_alone(
    logging_enabled, caplog
):
    """Disabled templates neither inspect nor change marker-like text."""
    asset = AppriseAsset(allow_templates=False)
    with caplog.at_level(logging.DEBUG):
        services, _ = ConfigBase.config_parse_yaml(
            "template:\n  - unused\nurls:\n  - json://user:${V}@localhost/\n",
            asset=asset,
        )

    assert services[0].password == "${V}"
    assert "not defined" not in caplog.text
    assert "not referenced" not in caplog.text


@pytest.mark.parametrize(
    ("label", "content"),
    [
        (
            "marker used as a query name",
            "template:\n  - t\nurls:\n  - json://localhost/?+${T}=1\n",
        ),
        (
            "marker used as a value",
            "template:\n  - t\nurls:\n  - json://localhost/?+X=${T}\n",
        ),
        (
            "marker used as a YAML setting name",
            "template:\n  - t\n"
            "urls:\n  - json://localhost/:\n      '+${T}': 1\n",
        ),
        (
            "marker in the credentials",
            "template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n",
        ),
        (
            "no template section at all",
            "urls:\n  - json://localhost/?+X=${T}\n",
        ),
    ],
)
def test_apprise_template_disabled_matches_no_section(label, content):
    """Disabled templates leave declared markers as literal text."""
    asset = AppriseAsset(allow_templates=False)
    services, _ = ConfigBase.config_parse_yaml(content, asset=asset)

    assert len(services) == 1

    # A real service, never an entry waiting on a value
    assert not isinstance(services[0], NotifyTemplate)


def test_apprise_template_disabled_ignores_the_environment(monkeypatch):
    """A disabled file never reads APPRISE_TEMPLATE_ values."""
    monkeypatch.setenv("APPRISE_TEMPLATE_T", "from-the-environment")
    content = "template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n"

    services, _ = ConfigBase.config_parse_yaml(
        content, asset=AppriseAsset(allow_templates=False)
    )
    assert services[0].password == "${T}"

    # With the feature on, the same file uses that value
    assert next(load(content).find()).password == "from-the-environment"


def test_apprise_template_disabled_ignores_repeated_sections():
    """A disabled template table follows PyYAML's last-value behavior."""
    asset = AppriseAsset(allow_templates=False)
    services, _ = ConfigBase.config_parse_yaml(
        "template:\n  first: one\n  first: two\n"
        "urls:\n  - json://localhost/\n"
        "template:\n  - second\n",
        asset=asset,
    )

    assert len(services) == 1


def test_apprise_template_url_handles_a_non_text_setting():
    """A setting that is not text has no marker to show."""
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - json://user:${T}@localhost/:\n"
        "    - verify: no\n      retry: 2\n"
    )[0]

    # It renders without complaint, and the marker still shows
    assert "${T}" in entry.url()


@pytest.mark.parametrize("declaration", ("", "template:\n  - t\n"))
def test_config_skips_non_text_sibling_before_url(declaration):
    """A non-text sibling cannot be mistaken for the URL key."""
    services = parse(
        declaration + "urls:\n  - 1: ignored\n    json://localhost/:\n"
    )
    assert len(services) == 1


def test_apprise_template_url_shows_every_field_using_a_name():
    """Show a shared marker in every field that uses it.

    A marker identifies where the caller's value goes. Leaving it out of
    one field would hide a setting the notification still uses.
    """
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailto://user:${T}@gmail.com:\n"
        "    - to: ${T}\n      cc: ${T}\n"
    )[0]

    url = entry.url()
    assert "user:${T}@" in url
    assert "to=${T}" in url
    assert "cc=${T}" in url


def test_apprise_template_url_without_a_path():
    """Not every URL has a path to render."""
    entry = parse("template:\n  - t\nurls:\n  - json://${T}\n")[0]
    assert "${T}" in entry.url()


def test_apprise_template_invalid_declaration_refuses_file(
    logging_enabled, caplog
):
    """An unreadable template section stops the whole file."""
    with caplog.at_level(logging.ERROR):
        services = parse(
            "template:\n  - name\n  - NAME\nurls:\n  - json://localhost/\n"
        )

    assert services == []
    assert "template section" in caplog.text.lower()


def test_apprise_template_unusable_placeholder_prefix(logging_enabled, caplog):
    """Giving up on a placeholder prefix stops the whole file."""
    taken = "0" * 16
    with (
        mock.patch(
            "apprise.utils.template.secrets.token_hex", return_value=taken
        ),
        caplog.at_level(logging.ERROR),
    ):
        # The prefix it keeps choosing already appears in the file
        services = parse(
            f"template:\n  - v\nurls:\n  - json://a{taken}/${{V}}\n"
        )

    assert services == []


def test_apprise_template_mapping_form_setting_name(logging_enabled, caplog):
    """A marker naming a YAML setting is left to the usual token check.

    Apprise already refuses a setting name it does not recognise, so the
    marker takes the same path any other unusable name would.
    """
    with caplog.at_level(logging.WARNING):
        services = parse(
            "template:\n  - t\n"
            "urls:\n  - json://localhost/:\n    - ${T}: value\n"
        )

    assert len(services) == 1
    assert "Ignoring invalid token (${T})" in caplog.text

    # A file that never declared the name is treated the same way
    with caplog.at_level(logging.WARNING):
        plain = parse("urls:\n  - json://localhost/:\n    - ${T}: value\n")

    assert len(plain) == 1
    assert "Ignoring invalid token (${T})" in caplog.text


def test_apprise_template_mapping_form_bad_position(logging_enabled, caplog):
    """The positional refusal also covers the mapping form."""
    with caplog.at_level(logging.ERROR):
        services = parse(
            "template:\n  - t\n"
            "urls:\n  - sendgrid://SG.abcdefghij:${T}/to@example.com:\n"
            "    - tag: work\n"
        )

    assert services == []
    assert "can not be used at this position" in caplog.text


def test_apprise_template_vars_reports_a_disagreement(sent):
    """Two configurations may not agree on a default."""
    apobj = Apprise()
    for default in ("first-default", "second-default"):
        config = AppriseConfig()
        assert config.add_config(
            f"template:\n  - shared: {default}\n"
            "urls:\n  - json://user:${SHARED}@host/\n",
            format="yaml",
        )
        assert apobj.add(config)

    # Neither default is assumed; use a call or environment value instead.
    assert apobj.template_vars()["shared"]["default"] is None


def test_apprise_template_status_other_outcomes():
    """Only a clean run and a no-match are reworded."""
    from apprise.dispatch import template_status

    for status in (
        AppriseResultStatus.FAILURE,
        AppriseResultStatus.PARTIAL,
        AppriseResultStatus.TIMEOUT,
    ):
        assert template_status(status, ["skipped"]) == status


def test_apprise_asset_allow_templates_must_be_a_flag():
    """It is a yes or no answer, not a piece of text."""
    from apprise.exception import AppriseImproperlyConfigured

    with pytest.raises(AppriseImproperlyConfigured):
        AppriseAsset(allow_templates="yes")


def schema_for(*names):
    """A declared schema to check a URL's service choice against."""
    from apprise.utils.template import TemplateSchema

    return TemplateSchema.parse(list(names))


@pytest.mark.parametrize(
    "section", ["template:", "template: []", "template: {}"]
)
def test_apprise_template_empty_section_changes_nothing(section, sent):
    """A template section that declares nothing is simply empty.

    Nothing was declared, so every marker is ordinary text and each URL
    loads straight away.
    """
    services = parse(f"{section}\nurls:\n  - json://user:${{T}}@localhost/\n")

    assert len(services) == 1
    assert not isinstance(services[0], NotifyTemplate)
    assert services[0].password == "${T}"


def test_apprise_template_vars_counts_agreeing_configurations(sent):
    """Two configurations may declare the same variable the same way."""
    apobj = Apprise()
    for host in ("first", "second"):
        config = AppriseConfig()
        assert config.add_config(
            "template:\n  - shared: agreed\n"
            f"urls:\n  - json://user:${{SHARED}}@{host}/\n",
            format="yaml",
        )
        assert apobj.add(config)

    report = apobj.template_vars()

    # They agree, so the default stands and both entries are counted
    assert report["shared"]["default"] == "agreed"
    assert report["shared"]["services"] == 2


@pytest.mark.parametrize(
    "url",
    [
        "mailtos://user:pass@example.com/${EMAIL}",
        "sendgrid://SG.abcdefghij:from@example.com/${EMAIL}",
    ],
)
def test_apprise_template_email_address_value_works(url, sent):
    """A whole email address is a perfectly ordinary value.

    Some services are written as ``schema://{email}/...``, where the value
    really is ``user@host``.  Escaping must not stand in the way of that.
    """
    apobj = load(f"template:\n  - email\nurls:\n  - {url}\n")
    service = next(apobj.find(template={"email": "you@example.ca"}))

    assert "you@example.ca" in [
        target[1] if isinstance(target, tuple) else target
        for target in service.targets
    ]


def test_apprise_template_email_address_as_a_setting(sent):
    """The same address written against a setting instead."""
    apobj = load(
        "template:\n  - email\n"
        "urls:\n  - mailtos://user:pass@example.com/:\n    - to: ${EMAIL}\n"
    )
    service = next(apobj.find(template={"email": "you@example.ca"}))

    assert [target[1] for target in service.targets] == ["you@example.ca"]


def test_config_yaml_rejects_an_unusable_key():
    """Reject a YAML key that cannot be looked up."""
    # A list written as a key; there is nothing to index a mapping by
    assert ConfigBase.config_parse_yaml("? [a, b]\n: value\n") == ([], [])


def test_config_query_tag_check_without_templates():
    """With nothing templated there is no query to examine."""
    from apprise.utils.yaml import templated_tag

    assert templated_tag({"qsd": {}}, None) is False
    assert templated_tag("not a mapping", None) is False


def test_config_query_tag_check_skips_unusable_buckets(sent):
    """A query bucket that is not a mapping is passed over."""
    from apprise.utils.template import TemplatePlaceholderMap, TemplateSchema
    from apprise.utils.yaml import templated_tag

    placeholders = TemplatePlaceholderMap(TemplateSchema.parse(["t"]), "")
    results = {"qsd": None, "qsd+": {}, "qsd-": {}, "qsd:": {}}
    assert templated_tag(results, placeholders) is False


def test_apprise_template_rejects_invalid_supplied_name(sent):
    """A name that is not text is refused rather than guessed at.

    Nothing can be looked up by it, so the request is turned down
    instead of being filled in from a malformed mapping.
    """
    apobj = load("template:\n  - t\nurls:\n  - json://user:${T}@host/\n")

    with pytest.raises(AppriseTemplateError):
        list(apobj.find(template={"t": "value", 7: "ignored"}))


def run_cli(tmpdir, content, *args):
    """Run a dry run against a configuration written to disk."""
    from click.testing import CliRunner

    from apprise import cli

    config = tmpdir.join("apprise.yml")
    config.write(content)
    return CliRunner().invoke(
        cli.main, ["-b", "x", f"--config={config!s}", "--dry-run", *args]
    )


def test_apprise_cli_dry_run_supplied_value(tmpdir):
    """A value given on the command line is filled in for the preview."""
    result = run_cli(
        tmpdir,
        "template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n",
        "--template-var",
        "t=supplied",
    )

    # The entry resolved, so it has a real identifier rather than a notice
    assert "missing value(s)" not in result.output
    assert "- n/a -" not in result.output
    assert result.exit_code == AppriseResultStatus.SUCCESS


def test_apprise_cli_dry_run_reports_no_identifier(tmpdir):
    """A service that keeps no stored data has no identifier to show."""
    from apprise.plugins.custom_json import NotifyJSON

    with mock.patch.object(NotifyJSON, "url_id", return_value=None):
        result = run_cli(tmpdir, "urls:\n  - json://localhost/\n")

    assert "- n/a -" in result.output
    assert result.exit_code == AppriseResultStatus.SUCCESS


def test_apprise_cli_dry_run_partial(tmpdir):
    """Some entries are ready and some are still waiting on a value."""
    result = run_cli(
        tmpdir,
        "template:\n  - t\n"
        "urls:\n  - json://user:${T}@localhost/\n  - json://ready/\n",
    )

    assert "could not be resolved" in result.output
    assert "1 of 2" in result.output

    # The same outcome a real run would report
    assert result.exit_code == AppriseResultStatus.PARTIAL


def test_apprise_cli_dry_run_failure(tmpdir):
    """Every entry is waiting on a value, so nothing would be sent."""
    result = run_cli(
        tmpdir, "template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n"
    )

    assert result.exit_code == AppriseResultStatus.FAILURE


def test_config_yaml_loader_failure_is_reported():
    """A YAML loader failure returns an empty configuration."""
    with mock.patch(
        "yaml.load",
        side_effect=AttributeError("no loader"),
    ):
        assert ConfigBase.config_parse_yaml("urls:\n  - json://a/\n") == (
            [],
            [],
        )


def test_apprise_cli_details_lists_required_packages():
    """A service that is switched off explains what it needs."""
    from click.testing import CliRunner

    from apprise import cli

    entry = {
        "service_name": "Example",
        "service_url": "https://example.ca",
        "setup_url": None,
        "enabled": False,
        "details": {"templates": ("{schema}://example",)},
        "category": "native",
        "attachment_support": False,
        "protocols": ("example",),
        "secure_protocols": None,
        "requirements": {
            "details": "Needs an extra package",
            "packages_required": ["examplelib"],
            "packages_recommended": [],
        },
    }

    with mock.patch(
        "apprise.Apprise.details",
        return_value={"version": "1.0", "asset": {}, "schemas": [entry]},
    ):
        result = CliRunner().invoke(cli.main, ["--details"])

    assert "Python Packages Required" in result.output
    assert "examplelib" in result.output


@pytest.mark.parametrize("supplied", ["a=b", ["a"], 7, ("a", "b")])
def test_apprise_template_rejects_a_non_mapping(supplied):
    """Values must arrive as name/value pairs."""
    apobj = load("template:\n  - t\nurls:\n  - json://user:${T}@host/\n")

    with pytest.raises(AppriseTemplateError):
        list(apobj.find(template=supplied))


def test_apprise_notify_failure_for_non_mapping():
    """A bad value table fails the call instead of raising."""
    apobj = load("template:\n  - t\nurls:\n  - json://user:${T}@host/\n")

    result = apobj.notify(body="x", template="a=b")
    assert not result
    assert result.status == AppriseResultStatus.FAILURE


def test_apprise_template_rejects_a_repeated_name():
    """Two spellings of one name leave no way to tell which was meant."""
    apobj = load("template:\n  - t\nurls:\n  - json://user:${T}@host/\n")

    with pytest.raises(AppriseTemplateError):
        list(apobj.find(template={"t": "one", "T": "two"}))


def test_apprise_template_name_not_captured(logging_enabled, caplog):
    """An unusable name is turned down before anything is written out."""
    apobj = load("template:\n  - t\nurls:\n  - json://user:${T}@host/\n")

    with caplog.at_level(logging.DEBUG), pytest.raises(AppriseTemplateError):
        list(apobj.find(template={"t": "value", "unused\nwrite": "x"}))

    assert "\nwrite" not in caplog.text


def test_apprise_template_empty_environment_value(monkeypatch, sent):
    """An empty environment value never replaces a real one.

    Whitespace is not a value, and a default written in the configuration
    outranks the environment in any case.
    """
    monkeypatch.setenv("APPRISE_TEMPLATE_T", "   ")
    apobj = load(
        "template:\n  t: fallback\nurls:\n  - json://user:${T}@localhost/\n"
    )

    service = next(apobj.find())
    assert service.password == "fallback"


@pytest.mark.parametrize("entry", ["bad name=x", "=x", "a\nb=x", "a-b=x"])
def test_apprise_template_cli_unusable_name(tmpdir, entry):
    """A --template-var name has to look like a variable name."""
    from click.testing import CliRunner

    from apprise import cli

    config = tmpdir.join("apprise.yml")
    config.write("urls:\n  - json://localhost\n")

    result = CliRunner().invoke(
        cli.main, ["-b", "x", f"--config={config!s}", "-tv", entry]
    )
    assert result.exit_code == 2
    assert "NAME=VALUE" in result.output


def test_apprise_template_cli_repeated_name(tmpdir):
    """The same name twice leaves no way to tell which value was meant."""
    from click.testing import CliRunner

    from apprise import cli

    config = tmpdir.join("apprise.yml")
    config.write("template:\n  - t\nurls:\n  - json://user:${T}@localhost/\n")

    result = CliRunner().invoke(
        cli.main,
        ["-b", "x", f"--config={config!s}", "-tv", "t=one", "-tv", "T=two"],
    )
    assert result.exit_code == 2
    assert "more than once" in result.output


def test_apprise_template_reads_a_configuration_once():
    """One find() visits each configuration source a single time."""
    apobj = Apprise()
    config = AppriseConfig(cache=False)
    assert config.add_config(
        "template:\n  - t\nurls:\n  - json://localhost/?to=${T}\n",
        format="yaml",
    )
    assert apobj.add(config)

    source = config[0]
    reads = []
    original = source.read

    def counted(*args, **kwargs):
        reads.append(1)
        return original(*args, **kwargs)

    source.read = counted
    assert len(list(apobj.find(template={"t": "x"}))) == 1
    assert len(reads) == 1


@pytest.mark.parametrize(
    "supplied",
    [
        MappingProxyType({"t": "value"}),
        UserDict({"t": "value"}),
    ],
)
def test_apprise_template_accepts_any_mapping(supplied, sent):
    """Any mapping is usable, not only a plain dictionary."""
    apobj = load("template:\n  - t\nurls:\n  - json://localhost/?to=${T}\n")

    service = next(apobj.find(template=supplied))
    assert service is not None


def test_apprise_template_cli_error_hides_value(tmpdir):
    """A refused entry must not echo whatever followed the equals sign."""
    from click.testing import CliRunner

    from apprise import cli

    config = tmpdir.join("apprise.yml")
    config.write("urls:\n  - json://localhost\n")

    result = CliRunner().invoke(
        cli.main,
        ["-b", "x", f"--config={config!s}", "-tv", "bad name=super-secret"],
    )
    assert result.exit_code == 2
    assert "super-secret" not in result.output
    assert "bad name" in result.output


def test_apprise_template_url_shows_a_list_setting():
    """Keep markers in list settings, such as email recipients.

    Email recipients are stored as a list. A listing that only checks text
    fields would silently lose their markers.
    """
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailto://user:pass@gmail.com:\n      to: ${T}\n"
    )[0]

    assert "to=${T}" in entry.url()


def test_apprise_template_url_lists_all_members():
    """A list mixing a marker with fixed members keeps them all."""
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailto://user:pass@gmail.com:\n"
        "      to:\n        - ${T}\n        - fixed@example.com\n"
    )[0]

    # Members come back the way a URL supplies a list: comma separated
    url = entry.url()
    assert "${T}" in url
    assert "fixed%40example.com" in url


def test_apprise_template_url_uses_the_argument_a_url_accepts():
    """Show YAML ``smtp:`` as the URL argument ``smtp=``.

    The YAML value is stored as ``smtp_host`` inside the service, but a URL
    must use ``smtp=`` to set that same field when read back.
    """
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailto://user:pass@gmail.com:\n      smtp: ${T}\n"
    )[0]

    url = entry.url()
    assert "smtp=${T}" in url
    assert "smtp_host" not in url

    service = Apprise.instantiate(url.replace("${T}", "mail.example.com"))
    assert service.smtp_host == "mail.example.com"


def test_apprise_template_url_shows_a_grouped_setting():
    """A header waiting on a value is shown with its URL prefix."""
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - json://localhost:\n      '+X-Token': ${T}\n"
    )[0]

    url = entry.url()
    assert "${T}" in url

    service = Apprise.instantiate(url.replace("${T}", "abc123"))
    assert service.headers == {"X-Token": "abc123"}


def test_apprise_template_url_skips_non_string_group_key():
    """Skip grouped settings whose YAML keys are not strings.

    YAML parses a bare ``1:`` as a number, which cannot name a URL header.
    """
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - json://localhost:\n"
        "      headers:\n        1: fixed\n        X-Token: ${T}\n"
    )[0]

    url = entry.url()
    assert "X-Token=${T}" in url
    assert "fixed" not in url


def test_apprise_template_url_deduplicates_header():
    """A header written in the URL is listed once, not twice."""
    entry = parse(
        "template:\n  - t\nurls:\n  - json://localhost/?+X-Token=${T}\n"
    )[0]

    assert entry.url().lower().count("x-token") == 1


def test_apprise_template_url_shows_a_port_waiting_on_a_value():
    """A port setting shows its marker, not the internal stand-in."""
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailto://user:pass@gmail.com:\n      port: ${T}\n"
    )[0]

    for url in (entry.url(), entry.url(privacy=True)):
        assert ":${T}" in url
        assert entry.placeholders.pattern.search(url) is None


def test_apprise_template_url_never_escapes_a_marker():
    """Markers stay literal so they can be found and replaced.

    A marker is not a value yet, so escaping it would leave a caller with
    nothing to search for.
    """
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailto://user:${T}@${T}.example/:\n"
        "      to: ${T}\n      smtp: ${T}\n"
    )[0]

    for url in (entry.url(), entry.url(privacy=True)):
        assert "%24%7B" not in url
        assert url.count("${T}") == 4


def test_apprise_template_url_masks_around_a_marker_only():
    """Privacy hides stored text but never the marker itself."""
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailto://user:pass@gmail.com:\n"
        "      smtp: secretserver.${T}\n"
    )[0]

    shown = entry.url(privacy=True)
    assert "${T}" in shown
    assert "secretserver" not in shown


def test_apprise_template_url_rejects_unparsed_marker(logging_enabled, caplog):
    """Reject a URL when a port marker disappears during parsing.

    A port is parsed as a number, so a marker there may vanish along with
    part of the hostname. Do not load the resulting broken entry.
    """
    entries = (
        # Written on its own
        "urls:\n  - mailto://user:pass@gmail.com:${T}\n",
        # Written with settings underneath it
        "urls:\n  - mailto://user:pass@gmail.com:${T}:\n"
        "      to: me@example.com\n",
    )

    for entry in entries:
        caplog.clear()
        with caplog.at_level(logging.ERROR):
            services = parse("template:\n  - t\n" + entry)

        assert services == []
        assert "can not be used at this position" in caplog.text


def test_apprise_template_url_omits_a_setting_no_url_can_set():
    """Do not show ``to=`` for ``json://``, which has no such option.

    A setting the service cannot use changes nothing when sending. Adding
    it to the listed URL would suggest the value goes somewhere it does not.
    """
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - json://user:pass@localhost/:\n      to: ${T}\n"
    )[0]

    url = entry.url()
    assert "to=" not in url

    # The same setting on a service that does have it is still shown
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailto://user:pass@gmail.com:\n      to: ${T}\n"
    )[0]
    assert "to=${T}" in entry.url()


def test_apprise_template_url_grouped_setting_replaces_the_group():
    """A header written under the URL replaces the URL's whole group.

    Apprise treats a group such as headers as one setting, so writing any
    of them under the URL drops the ones the URL carried.
    """
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - json://localhost/?+X-Token=unused:\n"
        "      '+Other': ${T}\n"
    )[0]

    url = entry.url()
    assert "${T}" in url
    assert "unused" not in url


@pytest.mark.parametrize(
    ("placement", "entry"),
    [
        ("host", "json://${V}/"),
        ("part of a host", "json://api.${V}.net/"),
        ("user", "json://${V}:pass@localhost/"),
        ("password", "json://user:${V}@localhost/"),
        ("path", "json://localhost/${V}/end"),
        ("query value", "json://localhost/?:custom=${V}"),
        ("header", "json://localhost/?+X-Tok=${V}"),
        ("setting", "mailto://u:p@gmail.com:\n      smtp: ${V}\n"),
        ("port", "mailto://u:p@gmail.com:\n      port: ${V}\n"),
        (
            "list setting",
            "mailto://u:p@gmail.com:\n      to:\n"
            "        - ${V}\n        - s@e.com\n",
        ),
        (
            "beside other text",
            "mailto://u:p@gmail.com:\n      smtp: a-${V}-b\n",
        ),
    ],
)
def test_apprise_template_marker_is_never_escaped(placement, entry):
    """A marker reads back as written wherever it was put.

    Escaping is right for everything else a URL carries, but a marker is
    not a value yet. It has to stay something a reader can spot and a
    caller can search for and replace, in both privacy modes.
    """
    suffix = "" if entry.endswith("\n") else "\n"
    services = parse("template:\n  - v\nurls:\n  - " + entry + suffix)
    entry_obj = services[0]

    for url in (entry_obj.url(), entry_obj.url(privacy=True)):
        assert "${V}" in url
        assert "%24%7B" not in url


def test_apprise_template_undeclared_marker_stays_readable():
    """A name left out of the template section is still shown as written.

    It is not a variable and no value is ever filled into it, but leaving
    it readable is what shows the author why the entry never asks for it.
    """
    entry = parse(
        "template:\n  - v\n"
        "urls:\n  - json://localhost/?a=${undeclared}&b=${V}\n"
    )[0]

    url = entry.url()
    assert "b=${V}" in url
    assert "a=${undeclared}" in url

    # ...but only the declared name is something to supply a value for
    assert entry.template_names == ("v",)


def test_apprise_template_url_uses_written_name():
    """A setting keeps the name it was written under, not an alias.

    mailto's ``from`` and ``name`` both end up in ``from_addr``, yet they
    mean different things, so the listing must not rename one to the other.
    """
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailtos://u:p@gmail.com:\n      name: ${T}\n"
    )[0]

    url = entry.url()
    assert "name=${T}" in url
    assert "from=" not in url


def test_apprise_template_url_setting_precedence():
    """A YAML setting replaces a URL alias for the same field.

    Here, ``name:`` and ``from=`` both fill ``from_addr``. Listing only the
    YAML setting ensures the displayed URL behaves like the configuration.
    """
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailtos://u:p@gmail.com?from=someone@example.com:\n"
        "      name: ${T}\n"
    )[0]

    url = entry.url()
    assert "name=${T}" in url
    assert "someone%40example.com" not in url


def test_apprise_template_url_last_written_setting_wins():
    """When two names fill one field, the later one is the one listed."""
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailtos://u:p@gmail.com:\n"
        "      from: real@example.com\n      name: ${T}\n"
    )[0]

    url = entry.url()
    assert "name=${T}" in url
    assert "real%40example.com" not in url


def test_apprise_template_url_round_trip():
    """A listed URL resolves to what the saved configuration resolves to.

    Settings that hold no marker are listed too, so nothing the entry needs
    is lost when the URL is filled in and loaded on its own.
    """
    config = (
        "template:\n  - t\n"
        "urls:\n  - mailtos://u:p@gmail.com:\n"
        "      to: rcpt@example.com\n      name: ${T}\n"
    )

    entry = parse(config)[0]
    url = entry.url().replace("${T}", "Bob")

    # The recipient is carried over rather than dropped
    assert "to=rcpt%40example.com" in url

    apobj = load(config)
    saved = next(apobj.find(template={"t": "Bob"}))

    reloaded = Apprise()
    assert reloaded.add(url)
    listed = next(reloaded.find())

    assert listed.from_addr == saved.from_addr
    assert listed.targets == saved.targets


def test_apprise_template_flatten_reads_nested_lists():
    """A list wrapped in more lists is read as one list of text."""
    from apprise.template import _flatten

    assert _flatten(["a", ["b", ("c",)]]) == ["a", "b", "c"]

    # A set is ordered only once every member is known to be text
    assert _flatten({"b", "a"}) == ["a", "b"]


def test_apprise_template_flatten_rejects_non_text():
    """Anything that is not text makes the whole setting unusable."""
    from apprise.template import _flatten

    # A number cannot hold a marker
    assert _flatten(["a", 5]) is None

    # ...and neither can one nested inside another list
    assert _flatten(["a", ["b", 5]]) is None

    # A set mixing text and numbers cannot even be ordered
    assert _flatten({"${T}", 5}) is None


def test_apprise_template_flatten_stops_at_the_nesting_limit():
    """A list that contains itself is abandoned rather than followed."""
    from apprise.template import _flatten

    loop = ["a"]
    loop.append(loop)
    assert _flatten(loop) is None


def test_apprise_template_url_omits_empty_setting():
    """An empty list, or a value no URL can carry, is left out."""
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailtos://u:p@gmail.com:\n"
        "      to: []\n      cc: null\n      name: ${T}\n"
    )[0]

    url = entry.url()
    assert "name=${T}" in url
    assert "to=" not in url
    assert "cc=" not in url


def test_apprise_template_url_args_without_a_usable_plugin():
    """A service we cannot describe simply gets no translation."""
    from apprise.template import _url_args

    # Nothing to describe at all
    assert _url_args(None) == {}

    # ...and a plugin whose details cannot be read is treated the same way
    class Broken:
        """Stands in for a service that cannot be described."""

    with mock.patch("apprise.plugins.details", side_effect=ValueError("nope")):
        assert _url_args(Broken) == {}


def test_apprise_template_settable_needs_a_known_service():
    """A schema with no plugin behind it can carry no settings."""
    entry = parse(
        "template:\n  - t\n"
        "urls:\n  - mailtos://u:p@gmail.com:\n      name: ${T}\n"
    )[0]

    # Point the entry at a schema no plugin provides
    entry.results["schema"] = "not-a-real-schema"
    assert entry._settable("name") is False
caronc-apprise-dfec414/tests/test_apprise_template_placement.py000066400000000000000000000171221526720371000252630ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
"""Test where template values may be placed and what they can change.

URL markers can change any field, including the destination. Markers in named
YAML settings change only that setting, making them safer for untrusted input.
The Apprise API uses the same rules at every access level.
"""

# Disable logging for a cleaner testing output
import logging
from unittest import mock

import pytest
import requests

from apprise import Apprise, AppriseConfig

logging.disable(logging.CRITICAL)


def load(content):
    """Build an Apprise object around a YAML configuration."""
    apobj = Apprise()
    config = AppriseConfig()
    assert config.add_config(content, format="yaml")
    assert apobj.add(config)
    return apobj


@pytest.fixture
def sent():
    """Accept every outbound request so delivery reports success."""
    with mock.patch("requests.request") as request:
        response = mock.Mock()
        response.status_code = requests.codes.ok
        response.content = ""
        response.headers = {}
        request.return_value = response
        yield request


# A value that would reach further than one field if anything re-parsed
# it. Every placement below is checked against this.
REACHING_VALUE = "evil.example/hook"


@pytest.mark.parametrize(
    ("placement", "entry"),
    [
        ("whole host", "json://${V}/"),
        ("part of a host", "json://${V}.example/"),
        ("host beside credentials", "json://user:pass@${V}/"),
        ("host beside a path", "json://${V}/api/notify"),
        ("host beside a query value", "json://${V}/?apikey=stored"),
        ("host beside a header", "json://${V}/?:Authorization=Bearer+s"),
        ("host beside a payload field", "json://${V}/?+token=stored"),
        ("user", "json://${V}:pass@host/"),
        ("password", "json://user:${V}@host/"),
        ("path", "json://host/${V}"),
        ("query value", "json://host/?:custom=${V}"),
    ],
)
def test_variable_in_any_url_field(placement, entry, sent):
    """Confirm every URL field accepts a variable, including the host."""
    apobj = load("template:\n  - v\nurls:\n  - {}\n".format(entry))

    assert next(apobj.find(template={"v": "filled-in"})) is not None


def test_all_url_fields_as_variables(sent):
    """One URL can be made entirely of variables."""
    apobj = load(
        "template:\n  - user\n  - secret\n  - host\n"
        "urls:\n  - json://${USER}:${SECRET}@${HOST}/\n"
    )

    service = next(
        apobj.find(
            template={"user": "me", "secret": "mine", "host": "my.example"}
        )
    )
    assert service.user == "me"
    assert service.password == "mine"
    assert service.host == "my.example"


def test_host_variable_with_settings(sent):
    """Settings written under the URL do not hold the entry back."""
    apobj = load(
        "template:\n  - host\nurls:\n  - json://user:pass@${HOST}/:\n"
        "      - headers:\n          Authorization: Bearer stored\n"
    )

    assert next(apobj.find(template={"host": "my.example"})).host == (
        "my.example"
    )


@pytest.mark.parametrize(
    "source",
    ["supplied", "environment", "default"],
)
def test_host_variable_value_sources(source, monkeypatch, sent):
    """Treat supplied, environment, and default host values alike."""
    declaration = "  host: my.example" if source == "default" else "  - host"
    supplied = {"host": "my.example"} if source == "supplied" else None
    if source == "environment":
        monkeypatch.setenv("APPRISE_TEMPLATE_HOST", "my.example")

    apobj = load(
        "template:\n{}\nurls:\n  - json://user:pass@${{HOST}}/\n".format(
            declaration
        )
    )

    service = next(apobj.find(template=supplied))
    assert service.host == "my.example"
    assert service.user == "user"


def test_url_variable_changes_destination(sent):
    """A host variable chooses where the URL and its credentials are sent."""
    apobj = load("template:\n  - v\nurls:\n  - json://user:pass@${V}/\n")

    service = next(apobj.find(template={"v": REACHING_VALUE}))
    assert service.host == REACHING_VALUE
    assert service.user == "user"
    assert service.password == "pass"


def test_setting_variable_keeps_destination(sent):
    """A named setting changes one option without moving the destination."""
    apobj = load(
        "template:\n  - v\n"
        "urls:\n  - json://user:pass@fixed.example/:\n      - to: ${V}\n"
    )

    service = next(apobj.find(template={"v": REACHING_VALUE}))
    assert service.host == "fixed.example"
    assert service.user == "user"
    assert service.password == "pass"


def test_url_and_setting_scope(sent):
    """Contrast unrestricted URL placement with a scoped YAML setting."""
    in_url = load("template:\n  - v\nurls:\n  - json://user:pass@${V}/\n")
    in_setting = load(
        "template:\n  - v\n"
        "urls:\n  - json://user:pass@fixed.example/:\n      - to: ${V}\n"
    )

    moved = next(in_url.find(template={"v": REACHING_VALUE}))
    fixed = next(in_setting.find(template={"v": REACHING_VALUE}))

    assert moved.host != fixed.host
    assert fixed.host == "fixed.example"


@pytest.mark.parametrize(
    "position",
    [
        "json://localhost/:\n    - tag: ${V}",
        "${V}://localhost/",
    ],
)
def test_disallowed_variable_positions(position):
    """Do not let values choose a service or a tag.

    These fields are read before template values are applied.
    """
    apobj = Apprise()
    config = AppriseConfig()
    config.add_config(
        "template:\n  - v\nurls:\n  - {}\n".format(position),
        format="yaml",
    )
    apobj.add(config)

    assert list(apobj.find(template={"v": "anything"})) == []


def test_yaml_setting_name_stays_literal():
    """Only values are replaced underneath a URL, never the names.

    A setting is called whatever the configuration file called it, so a
    marker written as one stays plain text.
    """
    apobj = Apprise()
    config = AppriseConfig()
    config.add_config(
        "template:\n  - v\n"
        "urls:\n  - json://localhost/:\n"
        "      '+${V}': 1\n      '+X': ${V}\n",
        format="yaml",
    )
    apobj.add(config)

    service = next(apobj.find(template={"v": "supplied"}))

    # The name kept its marker; only the value took the supplied text
    assert service.headers == {"${V}": "1", "X": "supplied"}
caronc-apprise-dfec414/tests/test_apprise_translations.py000066400000000000000000000647621526720371000241550ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

import ctypes
from importlib import reload

# Disable logging for a cleaner testing output
import logging
import os
import sys
from unittest import mock

from helpers import environ
import pytest

from apprise import Apprise, AppriseAsset, locale

logging.disable(logging.CRITICAL)

# True when the catalogs have been compiled (tox -e compile).  They are not
# kept in git and CI does not build them, so add() results depend on this.
CATALOG_COMPILED = os.path.isfile(
    os.path.join(
        os.path.dirname(os.path.dirname(os.path.abspath(__file__))),
        "apprise",
        "i18n",
        "en",
        "LC_MESSAGES",
        "apprise.mo",
    )
)


def test_apprise_trans():
    """
    API: Test apprise locale object
    """
    # Text with no translation reads the same in every language
    text = "A string Apprise has no translation for"
    lazytrans = locale.LazyTranslation(text)
    assert str(lazytrans) == text


@pytest.mark.skipif("gettext" not in sys.modules, reason="Requires gettext")
def test_apprise_trans_gettext_init():
    """
    API: Handle gettext
    """
    # Toggle
    locale.GETTEXT_LOADED = False

    # Objects can still be created
    al = locale.AppriseLocale()

    with al.lang_at("en") as _:
        # functions still behave as normal
        assert _ is None

    # Lazy strings hand back the English source text they were given
    assert str(locale.gettext_lazy("Token")) == "Token"

    # Restore the object
    locale.GETTEXT_LOADED = True


@pytest.mark.skipif("gettext" not in sys.modules, reason="Requires gettext")
@mock.patch("gettext.translation")
@mock.patch("locale.getlocale")
def test_apprise_trans_gettext_translations(
    mock_getlocale, mock_gettext_trans
):
    """
    API: Apprise() Gettext translations

    """

    # Set the gettext locale returned by the mock.
    mock_getlocale.return_value = ("en_US", "UTF-8")

    mock_gettext_trans.side_effect = FileNotFoundError()

    # This throws internally but we handle it gracefully
    al = locale.AppriseLocale()

    with al.lang_at("en"):
        # functions still behave as normal
        pass

    # This throws internally but we handle it gracefully
    locale.AppriseLocale(language="fr")


@pytest.mark.skipif(hasattr(ctypes, "windll"), reason="Unique Nux test cases")
@pytest.mark.skipif("gettext" not in sys.modules, reason="Requires gettext")
@mock.patch("locale.getlocale")
def test_apprise_trans_gettext_lang_at(mock_getlocale):
    """
    API: Apprise() Gettext lang_at

    """

    # Set the gettext locale returned by the mock.
    mock_getlocale.return_value = ("en_CA", "UTF-8")

    # Clear the language variables so only the mock above is detected
    with environ("LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", "LANG"):
        # This throws internally but we handle it gracefully
        al = locale.AppriseLocale()

    # We detected en_CA, so plain en needs a compiled catalog
    assert al.add("en", set_default=False) is CATALOG_COMPILED
    assert al.add("en", set_default=True) is CATALOG_COMPILED

    with al.lang_at("en"):
        # functions still behave as normal
        pass

    # This throws internally but we handle it gracefully
    locale.AppriseLocale(language="fr")

    with al.lang_at("en") as _:
        # functions still behave as normal
        assert callable(_)

    with al.lang_at("es") as _:
        # functions still behave as normal
        assert callable(_)

    with al.lang_at("fr") as _:
        # functions still behave as normal
        assert callable(_)

    # Test our initialization when our fallback is a language we do
    # not have. This is only done to test edge cases when for whatever
    # reason the person who set up apprise does not have the languages
    # installed.
    fallback = locale.AppriseLocale._default_language
    mock_getlocale.return_value = None

    with environ("LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", "LANG"):
        # Our default language
        locale.AppriseLocale._default_language = "zz"

        # We will detect the zz since there were no environment variables to
        # help us otherwise
        assert locale.AppriseLocale.detect_language() is None
        al = locale.AppriseLocale()

        # No language can be set because its locale directory does not exist.
        assert al.lang is None

        with al.lang_at(None) as _:
            # functions still behave as normal
            assert callable(_)

        with al.lang_at("en") as _:
            # functions still behave as normal
            assert callable(_)

        with al.lang_at("es") as _:
            # functions still behave as normal
            assert callable(_)

        with al.lang_at("fr") as _:
            # functions still behave as normal
            assert callable(_)

        # We can still perform simple lookups; they access a dummy wrapper:
        assert al.gettext("test") == "test"

    locale.AppriseLocale._default_language = "fr"

    with environ(
        "LANGUAGE",
        "LC_MESSAGES",
        "LC_CTYPE",
        LC_ALL="C.UTF-8",
        LANG="en_CA",
    ):
        # LC_ALL is authoritative, and the C locale it names is a request for
        # no translation at all. LANG is not consulted, and we settle on the
        # language configured as our default.
        assert locale.AppriseLocale.detect_language() == "fr"

    with environ(
        "LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", LANG="en_CA"
    ):
        # With no C locale in the way, LANG decides and overrides the
        # default. The region is kept so that an en_CA translation is
        # preferred over the en translation.
        assert locale.AppriseLocale.detect_language() == "en_CA"
        al = locale.AppriseLocale()
        assert al.lang == "en_CA"
        assert al.gettext("test") == "test"

        # Test case with set_default set to False (so we're still set to 'fr')
        assert al.add("zy", set_default=False) is False
        assert al.gettext("test") == "test"

        al.add("ab", set_default=True)
        assert al.gettext("test") == "test"

        assert al.add("zy", set_default=False) is False
    locale.AppriseLocale._default_language = fallback


def test_normalize_language():
    """Both the 2 and 5 letter language forms are accepted."""

    # A plain language stays as it is, and case never matters
    for entry in ("en", "EN", " en "):
        assert locale.AppriseLocale.normalize_language(entry) == "en"

    # A region may be separated by a hyphen or an underscore
    for entry in ("en-CA", "en_CA", "EN-ca", "en-ca"):
        assert locale.AppriseLocale.normalize_language(entry) == "en_CA"

    # A codeset (.UTF-8) and modifier (@euro) are both dropped
    for entry in (
        "en_CA.UTF-8",
        "en_CA.utf8",
        "en_CA.ISO8859-1",
        "en_CA.ANSI_X3.4-1968",
        "en_CA@euro",
        "en_CA.UTF-8@euro",
    ):
        assert locale.AppriseLocale.normalize_language(entry) == "en_CA"

    # A modifier is dropped even without a codeset
    assert locale.AppriseLocale.normalize_language("sr_RS@latin") == "sr_RS"
    assert locale.AppriseLocale.normalize_language("fr@euro") == "fr"

    # The form locale.normalize() returns for ca_ES@valencia
    assert (
        locale.AppriseLocale.normalize_language("ca_ES.UTF-8@valencia")
        == "ca_ES"
    )

    # A codeset or modifier on its own is not a language
    for entry in (".UTF-8", "@euro", "garbage.stuff_more"):
        assert locale.AppriseLocale.normalize_language(entry) is None

    # Anything beyond a 2 letter region is dropped, leaving the language
    assert locale.AppriseLocale.normalize_language("zh-Hans") == "zh"
    assert locale.AppriseLocale.normalize_language("zh-Hans-CN") == "zh"

    # Only the first entry of a preference list is honored, whether it is
    # comma separated like an Accept-Language header or colon separated like
    # a LANGUAGE= environment variable
    assert (
        locale.AppriseLocale.normalize_language("en-US,en;q=0.9,de;q=0.5")
        == "en_US"
    )
    assert locale.AppriseLocale.normalize_language("fr:de") == "fr"

    # A colon is a list separator, so it never introduces a region
    assert locale.AppriseLocale.normalize_language("en:CA") == "en"

    # Values we can not work with
    for entry in ("", "garbage", "!", "C", "C.UTF-8", None, 42):
        assert locale.AppriseLocale.normalize_language(entry) is None


def test_is_ansii_locale():
    """The C locale is recognized under each of its spellings."""

    # Every spelling, with or without a codeset or modifier
    for entry in (
        "C",
        "c",
        "POSIX",
        "posix",
        "C.UTF-8",
        "C.utf8",
        "C.ANSI_X3.4-1968",
        "POSIX.UTF-8",
        "C@euro",
    ):
        assert locale.AppriseLocale.is_ansii_locale(entry) is True

    # A language is not the C locale, including the ones that start with a c
    for entry in ("en", "ca", "cs", "ca_ES", "cat", "", None, 42):
        assert locale.AppriseLocale.is_ansii_locale(entry) is False


def test_language_candidates():
    """A region is always retried without it before we give up."""

    # A plain language has nowhere else to look
    assert locale.AppriseLocale.language_candidates("fr") == ["fr"]

    # A region is preferred, but the language itself is the backup
    assert locale.AppriseLocale.language_candidates("pt-BR") == [
        "pt_BR",
        "pt",
    ]

    # Nothing to search for
    assert locale.AppriseLocale.language_candidates("garbage") == []


@pytest.mark.skipif(sys.platform == "win32", reason="Unique Nux test cases")
@mock.patch("locale.getlocale")
def test_detect_language_precedence(mock_getlocale):
    """The environment is read in the order gettext itself reads it."""

    # Never reached while an environment variable answers for us
    mock_getlocale.return_value = (None, None)

    with environ(
        "LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", LANG="en_CA"
    ):
        # LANG on its own
        assert locale.AppriseLocale.detect_language() == "en_CA"

    with environ(
        "LANGUAGE", "LC_ALL", "LC_CTYPE", LANG="en_CA", LC_MESSAGES="fr_CA"
    ):
        # LC_MESSAGES is the category that governs translated text
        assert locale.AppriseLocale.detect_language() == "fr_CA"

    with environ(
        "LANGUAGE",
        "LC_CTYPE",
        LANG="en_CA",
        LC_MESSAGES="fr_CA",
        LC_ALL="de_DE",
    ):
        # LC_ALL over-rides every category
        assert locale.AppriseLocale.detect_language() == "de_DE"

    with environ(
        "LC_CTYPE",
        LANG="en_CA",
        LC_MESSAGES="fr_CA",
        LC_ALL="de_DE",
        LANGUAGE="es",
    ):
        # LANGUAGE wins over all of them
        assert locale.AppriseLocale.detect_language() == "es"

    with environ(
        "LANGUAGE", "LC_ALL", "LC_MESSAGES", LANG="en_CA", LC_CTYPE="de_DE"
    ):
        # LC_CTYPE governs character handling, not the language of text
        assert locale.AppriseLocale.detect_language() == "en_CA"

    with environ(
        "LC_ALL", "LC_MESSAGES", "LC_CTYPE", LANG="en_CA", LANGUAGE="fr:de"
    ):
        # A LANGUAGE list is colon separated; its first entry is used
        assert locale.AppriseLocale.detect_language() == "fr"

    with environ(
        "LANGUAGE",
        "LC_ALL",
        "LC_MESSAGES",
        "LC_CTYPE",
        LANG="fr_FR.ISO8859-1@euro",
    ):
        # The codeset and modifier are dropped
        assert locale.AppriseLocale.detect_language() == "fr_FR"

    default = locale.AppriseLocale._default_language
    for value in (
        "C",
        "POSIX",
        "C.UTF-8",
        "posix",
        "C.ANSI_X3.4-1968",
        "C@euro",
    ):
        with environ(
            "LC_MESSAGES",
            "LC_CTYPE",
            LC_ALL=value,
            LANG="fr_FR.UTF-8",
            LANGUAGE="de",
        ):
            # Asking for the C locale is asking for untranslated text, so
            # nothing below LC_ALL gets a say, LANGUAGE included
            assert locale.AppriseLocale.detect_language() == default

    with environ(
        "LANGUAGE", "LC_ALL", "LC_CTYPE", LANG="C", LC_MESSAGES="fr_CA"
    ):
        # A higher priority category still decides; only the locale actually
        # in charge of messages can silence translation
        assert locale.AppriseLocale.detect_language() == "fr_CA"

    with environ(
        "LC_ALL", "LC_MESSAGES", "LC_CTYPE", LANGUAGE="garbage", LANG="fr_CA"
    ):
        # A value we can make no sense of is stepped over rather than
        # stopping us; only the C locale does that
        assert locale.AppriseLocale.detect_language() == "fr_CA"


@pytest.mark.skipif("gettext" not in sys.modules, reason="Requires gettext")
def test_lang_at_invalid_entries():
    """An unusable language falls back instead of raising."""

    al = locale.AppriseLocale()

    # None of these can be turned into a language, yet each still hands
    # back a usable translation function
    for entry in (None, "", "   ", "garbage", "!", 42):
        with al.lang_at(entry) as fn:
            assert callable(fn)

    # The same holds true for the public details() call
    obj = Apprise()
    assert isinstance(obj.details(lang="invalid!"), dict)


@pytest.mark.skipif("gettext" not in sys.modules, reason="Requires gettext")
@mock.patch("gettext.translation")
def test_lazy_translation_context(mock_translation):
    """A lang_at() block decides how lazy strings are translated."""

    # Our stand-in catalog marks anything it translates
    dummy = mock.Mock()
    dummy.gettext = lambda text: f"xx:{text}"
    mock_translation.return_value = dummy

    al = locale.AppriseLocale()
    entry = locale.gettext_lazy("Token")

    # Our own singleton is untouched outside of the block
    before = str(entry)

    with al.lang_at("fr"):
        assert str(entry) == "xx:Token"

    # The language in effect before us is restored
    assert str(entry) == before

    # Asking for a function other than gettext leaves lazy strings alone
    with al.lang_at("fr", mapto="ngettext"):
        assert str(entry) == before


@pytest.mark.skipif("gettext" not in sys.modules, reason="Requires gettext")
@mock.patch("gettext.translation")
def test_asset_language_honored(mock_translation):
    """An asset language is used by the details() it returns."""

    # Our stand-in catalog marks anything it translates
    dummy = mock.Mock()
    dummy.gettext = lambda text: f"xx:{text}"
    mock_translation.return_value = dummy

    obj = Apprise(asset=AppriseAsset(language="fr-CA"))

    # Our asset decided the language of the object we built
    assert obj.locale.lang == "fr_CA"

    # Every human readable entry came back translated
    names = [
        token["name"]
        for schema in obj.details()["schemas"]
        for token in schema["details"]["tokens"].values()
    ]
    assert names
    assert all(str(name).startswith("xx:") for name in names)


@pytest.mark.skipif("gettext" not in sys.modules, reason="Requires gettext")
@mock.patch("locale.getlocale")
def test_apprise_trans_add(mock_getlocale):
    """
    API: Apprise() Gettext add

    """
    # Used when no language variable is set.  Windows asks the system
    # first, but always gets a regional answer (en_US), so the checks below
    # still hold.
    mock_getlocale.return_value = ("en_CA", "UTF-8")

    with environ("LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", "LANG"):
        # We start on en_CA, so plain en needs a compiled catalog
        al = locale.AppriseLocale()
        assert al.add("en") is CATALOG_COMPILED

    with environ(
        "LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", LANG="C.UTF-8"
    ):
        # The C locale starts on our default language, so en is loaded
        al = locale.AppriseLocale()
        assert al.lang == locale.AppriseLocale._default_language
        assert al.add("en") is True

    with environ(
        "LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", LANG="en_CA.UTF-8"
    ):
        # Test English Environment
        al = locale.AppriseLocale()
        assert al.add("en") is CATALOG_COMPILED

        # Double add (copy of above) to access logic that prevents adding it
        # again
        assert al.add("en") is CATALOG_COMPILED

    # Invalid Language
    assert al.add("bad") is False

    # A value that is not a language at all never reaches gettext; there is
    # no catalog name that could be built from it
    for entry in ("C", "!", "1"):
        assert al.add(entry) is False

    # An empty value is not a failure; it selects the default language
    assert al.add("") is CATALOG_COMPILED


@pytest.mark.skipif(
    not hasattr(ctypes, "windll"), reason="Unique Windows test cases"
)
@pytest.mark.skipif("gettext" not in sys.modules, reason="Requires gettext")
@mock.patch("locale.getlocale")
def test_apprise_trans_windows_users_win(mock_getlocale):
    """
    API: Apprise() Windows Locale Testing (Win version)

    """

    # Set the gettext locale returned by the mock.
    mock_getlocale.return_value = ("fr_CA", "UTF-8")

    with mock.patch(
        "ctypes.windll.kernel32.GetUserDefaultUILanguage"
    ) as ui_lang:
        # 4105 = en_CA
        ui_lang.return_value = 4105

        with environ("LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", "LANG"):
            # Our default language
            locale.AppriseLocale._default_language = "zz"

            # The Windows locale supplies English.
            assert locale.AppriseLocale.detect_language() == "en_CA"

        # Environment variables take precedence over the Windows locale.
        with environ(
            "LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", LANG="es_AR"
        ):
            assert locale.AppriseLocale.detect_language() == "es_AR"

        # Without environment variables, use the Windows locale.
        with environ("LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", "LANG"):
            assert locale.AppriseLocale.detect_language() == "en_CA"

        assert (
            locale.AppriseLocale.detect_language(detect_fallback=False) is None
        )

        # 0 = IndexError
        ui_lang.return_value = 0
        with environ("LANGUAGE", "LANG", "LC_ALL", "LC_MESSAGES", "LC_CTYPE"):
            # Fall back to the POSIX locale.
            assert locale.AppriseLocale.detect_language() == "fr_CA"


@pytest.mark.skipif(hasattr(ctypes, "windll"), reason="Unique Nux test cases")
@pytest.mark.skipif("gettext" not in sys.modules, reason="Requires gettext")
@mock.patch("locale.getlocale")
def test_apprise_trans_windows_users_nux(mock_getlocale):
    """
    API: Apprise() Windows Locale Testing (Nux version)

    """

    # Set the gettext locale returned by the mock.
    mock_getlocale.return_value = ("fr_CA", "UTF-8")

    # Emulate a windows environment
    windll = mock.Mock()
    ctypes.windll = windll

    # 4105 = en_CA
    windll.kernel32.GetUserDefaultUILanguage.return_value = 4105

    # Store default value to not break other tests
    default_language = locale.AppriseLocale._default_language

    with environ("LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", "LANG"):
        # Our default language
        locale.AppriseLocale._default_language = "zz"

        # The Windows locale supplies English.
        assert locale.AppriseLocale.detect_language() == "en_CA"

    # Environment variables take precedence over the Windows locale.
    with environ(
        "LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", LANG="es_AR"
    ):
        assert locale.AppriseLocale.detect_language() == "es_AR"

    # Without environment variables, use the Windows locale.
    with environ("LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE", "LANG"):
        assert locale.AppriseLocale.detect_language() == "en_CA"

    assert locale.AppriseLocale.detect_language(detect_fallback=False) is None

    # 0 = IndexError
    windll.kernel32.GetUserDefaultUILanguage.return_value = 0
    with environ("LANGUAGE", "LANG", "LC_ALL", "LC_MESSAGES", "LC_CTYPE"):
        # Fall back to the POSIX locale.
        assert locale.AppriseLocale.detect_language() == "fr_CA"

    del ctypes.windll

    # Restore default value
    locale.AppriseLocale._default_language = default_language


@pytest.mark.skipif(sys.platform == "win32", reason="Unique Nux test cases")
@mock.patch("locale.getlocale")
def test_detect_language_using_env(mock_getlocale):
    """Test the reading of information from an environment variable."""

    # Set the gettext locale returned by the mock.
    mock_getlocale.return_value = ("en_CA", "UTF-8")

    # The below accesses the windows fallback code and fail
    # then it will resort to the environment variables.
    with environ("LANG", "LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE"):
        # Language can now be detected in this case
        assert isinstance(locale.AppriseLocale.detect_language(), str)

    # Detect French language.
    with environ(
        "LANGUAGE", "LC_ALL", "LC_MESSAGES", LC_CTYPE="garbage", LANG="fr_CA"
    ):
        assert locale.AppriseLocale.detect_language() == "fr_CA"

    # A system reporting the C locale falls back to our default language
    mock_getlocale.return_value = ("C", "UTF-8")
    with environ("LANG", "LANGUAGE", "LC_ALL", "LC_MESSAGES", "LC_CTYPE"):
        assert (
            locale.AppriseLocale.detect_language()
            == locale.AppriseLocale._default_language
        )

    # Restore what the rest of this test expects
    mock_getlocale.return_value = ("en_CA", "UTF-8")

    # The following unsets all environment variables and sets LC_CTYPE
    # This was causing Python 2.7 to internally parse UTF-8 as an invalid
    # locale and throw an uncaught ValueError; Python v2 support has been
    # dropped, but just to ensure this issue does not come back, we keep
    # this test:
    with environ(*list(os.environ.keys()), LC_CTYPE="UTF-8"):
        assert isinstance(locale.AppriseLocale.detect_language(), str)

    # Test with no environment variables.
    with environ(*list(os.environ.keys())):
        assert isinstance(locale.AppriseLocale.detect_language(), str)

    # Handle case where getlocale() can't be detected
    mock_getlocale.return_value = None
    with environ("LC_ALL", "LC_MESSAGES", "LC_CTYPE", "LANG", "LANGUAGE"):
        assert locale.AppriseLocale.detect_language() is None

    mock_getlocale.return_value = (None, None)
    with environ("LC_ALL", "LC_MESSAGES", "LC_CTYPE", "LANG", "LANGUAGE"):
        assert locale.AppriseLocale.detect_language() is None

    # if detect_language and windows env fail us, then we don't
    # set up a default language on first load
    locale.AppriseLocale()


@pytest.mark.skipif("gettext" not in sys.modules, reason="Requires gettext")
def test_apprise_trans_gettext_missing(tmpdir):
    """Verify we can still operate without the gettext library."""

    # Reloading a module rebinds every class it defines. Anything that
    # imported one of them earlier keeps the original, and the two no longer
    # compare as the same object, which breaks isinstance() checks and
    # pickling for the rest of the run. Only what Apprise hands out by
    # reference is restored afterwards; the modules this one imports are
    # left as the reload found them so they can still be mocked.
    restore = {
        name: getattr(sys.modules["apprise.locale"], name)
        for name in (
            "ACTIVE_GETTEXT",
            "AppriseLocale",
            "LOCALE",
            "LazyTranslation",
            "Translatable",
            "gettext_lazy",
        )
    }

    # remove gettext from our system enviroment
    del sys.modules["gettext"]

    try:
        # Put a failing fake gettext module ahead of the real one.
        gettext_dir = tmpdir.mkdir("gettext")
        gettext_dir.join("__init__.py").write("")
        gettext_dir.join("gettext.py").write("""raise ImportError()""")

        # Update our path to point path to head
        sys.path.insert(0, str(gettext_dir))

        # reload our module (forcing the import error when it tries to load
        # gettext
        reload(sys.modules["apprise.locale"])
        from apprise import locale

        assert locale.GETTEXT_LOADED is False

        # Now roll our changes back
        sys.path.pop(0)

        # Reload again (reverting back)
        reload(sys.modules["apprise.locale"])
        from apprise import locale

        assert locale.GETTEXT_LOADED is True

    finally:
        # Hand back the classes the rest of Apprise is already holding
        module = sys.modules["apprise.locale"]
        for name, value in restore.items():
            setattr(module, name, value)


@mock.patch("gettext.translation")
def test_apprise_locale_add_existing_language(mock_translation):
    """Re-add an existing language to hit fallback mapping path."""
    # Return a fake gettext object with a valid gettext() method
    dummy = mock.Mock()
    dummy.gettext = lambda x: f"tr:{x}"
    mock_translation.return_value = dummy

    al = locale.AppriseLocale()
    assert al.add("en", set_default=True) is True
    assert al.add("en", set_default=False) is True


@mock.patch("gettext.translation")
@mock.patch("locale.getlocale")
def test_apprise_trans_successful_translation(
    mock_getlocale, mock_translation
):
    """Trigger logger.trace by mocking successful gettext.translation()"""
    mock_getlocale.return_value = ("en_CA", "UTF-8")

    dummy_translation = mock.Mock()
    dummy_translation.gettext = lambda x: f"tr:{x}"
    mock_translation.return_value = dummy_translation

    al = locale.AppriseLocale()
    assert al.add("en") is True
    assert al.gettext("test") == "tr:test"
caronc-apprise-dfec414/tests/test_apprise_utils.py000066400000000000000000004050051526720371000225610ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from datetime import tzinfo
from inspect import cleandoc

# Disable logging for a cleaner testing output
import logging
import os
import re
import sys
import time
from unittest import mock
from urllib.parse import unquote

from apprise import Apprise, NotificationManager, utils
from apprise.tag import AppriseTag

logging.disable(logging.CRITICAL)

# Ensure we don't create .pyc files for these tests
sys.dont_write_bytecode = True

# Grant access to our Notification Manager Singleton
N_MGR = NotificationManager()


def test_parse_qsd():
    "utils: parse_qsd() testing"

    result = utils.parse.parse_qsd("a=1&b=&c&d=abcd")
    assert isinstance(result, dict)
    assert len(result) == 4
    assert "qsd" in result
    assert "qsd+" in result
    assert "qsd-" in result
    assert "qsd:" in result

    assert len(result["qsd"]) == 4
    assert "a" in result["qsd"]
    assert "b" in result["qsd"]
    assert "c" in result["qsd"]
    assert "d" in result["qsd"]

    assert len(result["qsd-"]) == 0
    assert len(result["qsd+"]) == 0
    assert len(result["qsd:"]) == 0


def test_parse_url_general():
    "utils: parse_url() testing"

    result = utils.parse.parse_url("http://hostname")
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # GitHub Ticket 1234 - Unparseable Hostname
    result = utils.parse.parse_url("http://5t4m59hl-34343.euw.devtunnels.ms")
    assert result["schema"] == "http"
    assert result["host"] == "5t4m59hl-34343.euw.devtunnels.ms"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://5t4m59hl-34343.euw.devtunnels.ms"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url("http://hostname/")
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["query"] is None
    assert result["url"] == "http://hostname/"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # colon after hostname without port number is no good
    assert utils.parse.parse_url("http://hostname:") is None

    # An invalid port
    result = utils.parse.parse_url(
        "http://hostname:invalid", verify_host=False, strict_port=True
    )
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == "invalid"
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname:invalid"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # However if we don't verify the host, it is okay
    result = utils.parse.parse_url("http://hostname:", verify_host=False)
    assert result["schema"] == "http"
    assert result["host"] == "hostname:"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname:"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # A port of Zero is not valid with strict port checking
    assert utils.parse.parse_url("http://hostname:0", strict_port=True) is None

    # Without strict port checking however, it is okay
    result = utils.parse.parse_url("http://hostname:0", strict_port=False)
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == 0
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname:0"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # A negative port is not valid
    assert (
        utils.parse.parse_url("http://hostname:-92", strict_port=True) is None
    )
    result = utils.parse.parse_url(
        "http://hostname:-92", verify_host=False, strict_port=True
    )
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == -92
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname:-92"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # A port that is too large is not valid
    assert (
        utils.parse.parse_url("http://hostname:65536", strict_port=True)
        is None
    )

    # This is an accetable port (the maximum)
    result = utils.parse.parse_url("http://hostname:65535", strict_port=True)
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == 65535
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname:65535"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # This is an accetable port (the maximum)
    result = utils.parse.parse_url("http://hostname:1", strict_port=True)
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == 1
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname:1"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # A port that was identfied as a string is invalid
    assert (
        utils.parse.parse_url("http://hostname:invalid", strict_port=True)
        is None
    )
    result = utils.parse.parse_url(
        "http://hostname:invalid", verify_host=False, strict_port=True
    )
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == "invalid"
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname:invalid"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url(
        "http://hostname:invalid", verify_host=False, strict_port=False
    )
    assert result["schema"] == "http"
    assert result["host"] == "hostname:invalid"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname:invalid"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url(
        "http://hostname:invalid?key=value&-minuskey=mvalue",
        verify_host=False,
        strict_port=False,
    )
    assert result["schema"] == "http"
    assert result["host"] == "hostname:invalid"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname:invalid"
    assert unquote(result["qsd"]["-minuskey"]) == "mvalue"
    assert unquote(result["qsd"]["key"]) == "value"
    assert unquote(result["qsd-"]["minuskey"]) == "mvalue"
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # Handling of floats
    assert (
        utils.parse.parse_url("http://hostname:4.2", strict_port=True) is None
    )
    result = utils.parse.parse_url(
        "http://hostname:4.2", verify_host=False, strict_port=True
    )
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == "4.2"
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname:4.2"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # A Port of zero is not acceptable for a regular hostname
    assert utils.parse.parse_url("http://hostname:0", strict_port=True) is None

    # No host verification (zero is an acceptable port when this is the case
    result = utils.parse.parse_url("http://hostname:0", verify_host=False)
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == 0
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname:0"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url(
        "http://[2001:db8:002a:3256:adfe:05c0:0003:0006]:8080",
        verify_host=False,
    )
    assert result["schema"] == "http"
    assert result["host"] == "[2001:db8:002a:3256:adfe:05c0:0003:0006]"
    assert result["port"] == 8080
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert (
        result["url"] == "http://[2001:db8:002a:3256:adfe:05c0:0003:0006]:8080"
    )
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url(
        "http://hostname:0", verify_host=False, strict_port=True
    )
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == 0
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://hostname:0"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url("http://hostname/?-KeY=Value")
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["query"] is None
    assert result["url"] == "http://hostname/"
    assert "-key" in result["qsd"]
    assert unquote(result["qsd"]["-key"]) == "Value"
    assert "KeY" in result["qsd-"]
    assert unquote(result["qsd-"]["KeY"]) == "Value"
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url("http://hostname/?+KeY=Value")
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["query"] is None
    assert result["url"] == "http://hostname/"
    assert "+key" in result["qsd"]
    assert "KeY" in result["qsd+"]
    assert result["qsd+"]["KeY"] == "Value"
    assert result["qsd-"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url("http://hostname/?:kEy=vALUE")
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["query"] is None
    assert result["url"] == "http://hostname/"
    assert ":key" in result["qsd"]
    assert "kEy" in result["qsd:"]
    assert result["qsd:"]["kEy"] == "vALUE"
    assert result["qsd+"] == {}
    assert result["qsd-"] == {}

    result = utils.parse.parse_url(
        "http://hostname/?+KeY=ValueA&-kEy=ValueB&KEY=Value%20+C&:colon=y"
    )
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["query"] is None
    assert result["url"] == "http://hostname/"
    assert "+key" in result["qsd"]
    assert "-key" in result["qsd"]
    assert ":colon" in result["qsd"]
    assert result["qsd:"]["colon"] == "y"
    assert "key" in result["qsd"]
    assert "KeY" in result["qsd+"]
    assert result["qsd+"]["KeY"] == "ValueA"
    assert "kEy" in result["qsd-"]
    assert result["qsd-"]["kEy"] == "ValueB"
    assert result["qsd"]["key"] == "Value +C"
    assert result["qsd"]["+key"] == result["qsd+"]["KeY"]
    assert result["qsd"]["-key"] == result["qsd-"]["kEy"]

    result = utils.parse.parse_url(
        "http://hostname/?+KeY=ValueA&-kEy=ValueB&KEY=Value%20+C&:colon=y",
        plus_to_space=True,
    )
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["query"] is None
    assert result["url"] == "http://hostname/"
    assert "+key" in result["qsd"]
    assert "-key" in result["qsd"]
    assert ":colon" in result["qsd"]
    assert result["qsd:"]["colon"] == "y"
    assert "key" in result["qsd"]
    assert "KeY" in result["qsd+"]
    assert result["qsd+"]["KeY"] == "ValueA"
    assert "kEy" in result["qsd-"]
    assert result["qsd-"]["kEy"] == "ValueB"
    assert result["qsd"]["key"] == "Value  C"
    assert result["qsd"]["+key"] == result["qsd+"]["KeY"]
    assert result["qsd"]["-key"] == result["qsd-"]["kEy"]

    result = utils.parse.parse_url("http://hostname////")
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["query"] is None
    assert result["url"] == "http://hostname/"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url("http://hostname:40////")
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == 40
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["query"] is None
    assert result["url"] == "http://hostname:40/"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url("HTTP://HoStNaMe:40/test.php")
    assert result["schema"] == "http"
    assert result["host"] == "HoStNaMe"
    assert result["port"] == 40
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/test.php"
    assert result["path"] == "/"
    assert result["query"] == "test.php"
    assert result["url"] == "http://HoStNaMe:40/test.php"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url("HTTPS://user@hostname/test.py")
    assert result["schema"] == "https"
    assert result["host"] == "hostname"
    assert result["port"] is None
    assert result["user"] == "user"
    assert result["password"] is None
    assert result["fullpath"] == "/test.py"
    assert result["path"] == "/"
    assert result["query"] == "test.py"
    assert result["url"] == "https://user@hostname/test.py"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url("  HTTPS://///user@@@hostname///test.py  ")
    assert result["schema"] == "https"
    assert result["host"] == "hostname"
    assert result["port"] is None
    assert result["user"] == "user"
    assert result["password"] is None
    assert result["fullpath"] == "/test.py"
    assert result["path"] == "/"
    assert result["query"] == "test.py"
    assert result["url"] == "https://user@hostname/test.py"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url(
        "HTTPS://user:password@otherHost/full///path/name/",
    )
    assert result["schema"] == "https"
    assert result["host"] == "otherHost"
    assert result["port"] is None
    assert result["user"] == "user"
    assert result["password"] == "password"
    assert result["fullpath"] == "/full/path/name/"
    assert result["path"] == "/full/path/name/"
    assert result["query"] is None
    assert result["url"] == "https://user:password@otherHost/full/path/name/"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url(
        "HTTPS://hostname/a/path/ending/with/slash/?key=value",
    )
    assert result["schema"] == "https"
    assert result["host"] == "hostname"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/a/path/ending/with/slash/"
    assert result["path"] == "/a/path/ending/with/slash/"
    assert result["query"] is None
    assert result["url"] == "https://hostname/a/path/ending/with/slash/"
    assert result["qsd"] == {"key": "value"}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # Handle garbage
    assert utils.parse.parse_url(None) is None

    result = utils.parse.parse_url(
        "mailto://user:password@otherHost/lead2gold@gmail.com"
        + "?from=test@test.com&name=Chris%20Caron&format=text"
    )
    assert result["schema"] == "mailto"
    assert result["host"] == "otherHost"
    assert result["port"] is None
    assert result["user"] == "user"
    assert result["password"] == "password"
    assert unquote(result["fullpath"]) == "/lead2gold@gmail.com"
    assert result["path"] == "/"
    assert unquote(result["query"]) == "lead2gold@gmail.com"
    assert (
        unquote(result["url"])
        == "mailto://user:password@otherHost/lead2gold@gmail.com"
    )
    assert len(result["qsd"]) == 3
    assert "name" in result["qsd"]
    assert unquote(result["qsd"]["name"]) == "Chris Caron"
    assert "from" in result["qsd"]
    assert unquote(result["qsd"]["from"]) == "test@test.com"
    assert "format" in result["qsd"]
    assert unquote(result["qsd"]["format"]) == "text"
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # Test Passwords with question marks ?; not supported
    result = utils.parse.parse_url("http://user:pass.with.?question@host")
    assert result is None

    # just hostnames
    result = utils.parse.parse_url("nuxref.com")
    assert result["schema"] == "http"
    assert result["host"] == "nuxref.com"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "http://nuxref.com"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # just host and path
    result = utils.parse.parse_url("invalid/host")
    assert result["schema"] == "http"
    assert result["host"] == "invalid"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/host"
    assert result["path"] == "/"
    assert result["query"] == "host"
    assert result["url"] == "http://invalid/host"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # just all out invalid
    assert utils.parse.parse_url("?") is None
    assert utils.parse.parse_url("/") is None

    # Test some illegal strings
    result = utils.parse.parse_url(object, verify_host=False)
    assert result is None
    result = utils.parse.parse_url(None, verify_host=False)
    assert result is None

    # Just a schema; invalid host
    result = utils.parse.parse_url("test://")
    assert result is None

    # Do it again without host validation
    result = utils.parse.parse_url("test://", verify_host=False)
    assert result["schema"] == "test"
    # It's worth noting that the hostname is an empty string and is NEVER set
    # to None if it wasn't specified.
    assert result["host"] == ""
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    assert result["url"] == "test://"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url("testhostname")
    assert result["schema"] == "http"
    assert result["host"] == "testhostname"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    # The default_schema kicks in here
    assert result["url"] == "http://testhostname"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url("example.com", default_schema="unknown")
    assert result["schema"] == "unknown"
    assert result["host"] == "example.com"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    # The default_schema kicks in here
    assert result["url"] == "unknown://example.com"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # An empty string without a hostame is still valid if verify_host is set
    result = utils.parse.parse_url("", verify_host=False)
    assert result["schema"] == "http"
    assert result["host"] == ""
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] is None
    assert result["path"] is None
    assert result["query"] is None
    # The default_schema kicks in here
    assert result["url"] == "http://"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # A messed up URL
    result = utils.parse.parse_url("test://:@/", verify_host=False)
    assert result["schema"] == "test"
    assert result["host"] == ""
    assert result["port"] is None
    assert result["user"] == ""
    assert result["password"] == ""
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["query"] is None
    assert result["url"] == "test://:@/"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    result = utils.parse.parse_url(
        "crazy://:@//_/@^&/jack.json", verify_host=False
    )
    assert result["schema"] == "crazy"
    assert result["host"] == ""
    assert result["port"] is None
    assert result["user"] == ""
    assert result["password"] == ""
    assert unquote(result["fullpath"]) == "/_/@^&/jack.json"
    assert unquote(result["path"]) == "/_/@^&/"
    assert result["query"] == "jack.json"
    assert unquote(result["url"]) == "crazy://:@/_/@^&/jack.json"
    assert result["qsd"] == {}
    assert result["qsd-"] == {}
    assert result["qsd+"] == {}
    assert result["qsd:"] == {}

    # Sanitizing
    result = utils.parse.parse_url(
        "hTTp://hostname/?+KeY=ValueA&-kEy=ValueB&KEY=Value%20+C&:cOlON=YeS",
        sanitize=False,
    )

    assert len(result["qsd-"]) == 1
    assert len(result["qsd+"]) == 1
    assert len(result["qsd"]) == 4
    assert len(result["qsd:"]) == 1

    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["query"] is None
    assert result["url"] == "http://hostname/"
    assert "+KeY" in result["qsd"]
    assert "-kEy" in result["qsd"]
    assert ":cOlON" in result["qsd"]
    assert result["qsd:"]["cOlON"] == "YeS"
    assert "key" not in result["qsd"]
    assert "KeY" in result["qsd+"]
    assert result["qsd+"]["KeY"] == "ValueA"
    assert "kEy" in result["qsd-"]
    assert result["qsd-"]["kEy"] == "ValueB"
    assert result["qsd"]["KEY"] == "Value +C"
    assert result["qsd"]["+KeY"] == result["qsd+"]["KeY"]
    assert result["qsd"]["-kEy"] == result["qsd-"]["kEy"]

    # Testing Defect 1264 - whitespaces in url
    result = utils.parse.parse_url(
        "posts://example.com/my endpoint?-token=ab cdefg"
    )

    assert len(result["qsd-"]) == 1
    assert len(result["qsd+"]) == 0
    assert len(result["qsd"]) == 1
    assert len(result["qsd:"]) == 0

    assert result["schema"] == "posts"
    assert result["host"] == "example.com"
    assert result["port"] is None
    assert result["user"] is None
    assert result["password"] is None
    assert result["fullpath"] == "/my%20endpoint"
    assert result["path"] == "/"
    assert result["query"] == "my%20endpoint"
    assert result["url"] == "posts://example.com/my%20endpoint"
    assert "-token" in result["qsd"]
    assert result["qsd-"]["token"] == "ab cdefg"

    # Testing Defect 1672 - reserved characters in URL paths
    url = "https://cdn.jsdelivr.net/gh/Cleanuparr/Cleanuparr@main/Logo/256.png"
    result = utils.parse.parse_url(url)
    assert result["fullpath"] == "/gh/Cleanuparr/Cleanuparr@main/Logo/256.png"
    assert result["url"] == url

    # RFC 3986 path characters must survive a parse_url() round trip because
    # some services distinguish literal characters from encoded ones.
    url = "https://example.com/a:b@c!d$e&f'g(h)i*j+k=n/file.txt"
    result = utils.parse.parse_url(url)
    assert result["fullpath"] == "/a:b@c!d$e&f'g(h)i*j+k=n/file.txt"
    assert result["url"] == url

    # Keep commas and semicolons encoded because Apprise uses them as path/list
    # delimiters. Otherwise path data such as a Home Assistant target list
    # could become extra segments. Related regressions have dedicated plugin
    # tests.
    result = utils.parse.parse_url("https://example.com/a,b;c/file.txt")
    assert result["fullpath"] == "/a%2Cb%3Bc/file.txt"

    # Characters outside an RFC 3986 path segment must remain encoded when the
    # safe list is expanded.
    result = utils.parse.parse_url("https://example.com/a b/c[1]#/file.txt")
    assert "%20" in result["fullpath"]
    assert "[" not in result["fullpath"]
    assert "]" not in result["fullpath"]

    # An encoded slash belongs to its segment and must not become a
    # separator, while a literal slash still splits the path.
    result = utils.parse.parse_url(
        "https://example.com/api/v4/projects/my%2Frepo/file%2fname"
    )
    assert result["fullpath"] == "/api/v4/projects/my%2Frepo/file%2Fname"
    assert result["query"] == "file%2Fname"


def test_parse_url_markdown_content():
    """
    utils: parse_url() with unmatched-bracket content (GH#1693)
    """
    # Content whose host portion carries an unmatched '[' (for example from
    # Markdown link syntax) makes the underlying urlparse() raise
    # "Invalid IPv6 URL". parse_url() documents that it returns None when
    # content cannot be extracted, so that ValueError must not propagate.
    assert (
        utils.parse.parse_url("**bold** and [link](https://example.com)")
        is None
    )
    assert utils.parse.parse_url("text with [unclosed bracket") is None


def test_parse_url_path_no_redos():
    "utils: parse_url() does not regress into slow/backtracking behavior"

    # Escaping uses linear-time table lookups. This guards against a future
    # regex-based implementation backtracking on untrusted paths.
    segment = "%40%3A%21%24%26%27%28%29%2A%2B%2C%3B%3D-a" * 5000
    url = f"https://example.com/{segment}/file.txt?foo=bar"

    start = time.time()
    result = utils.parse.parse_url(url)
    elapsed = time.time() - start

    assert result is not None
    # The generous limit allows slower CI while catching nonlinear behavior.
    assert elapsed < 5.0


def test_parse_url_simple():
    "utils: parse_url() testing"

    result = utils.parse.parse_url("http://hostname", simple=True)
    assert len(result) == 3
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["url"] == "http://hostname"

    result = utils.parse.parse_url("http://hostname/", simple=True)
    assert len(result) == 5
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["url"] == "http://hostname/"

    # colon after hostname without port number is no good
    assert utils.parse.parse_url("http://hostname:", simple=True) is None

    # An invalid port
    result = utils.parse.parse_url(
        "http://hostname:invalid",
        verify_host=False,
        strict_port=True,
        simple=True,
    )
    assert len(result) == 4
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == "invalid"
    assert result["url"] == "http://hostname:invalid"

    # However if we don't verify the host, it is okay
    result = utils.parse.parse_url(
        "http://hostname:", verify_host=False, simple=True
    )
    assert len(result) == 3
    assert result["schema"] == "http"
    assert result["host"] == "hostname:"
    assert result["url"] == "http://hostname:"

    # A port of Zero is not valid with strict port checking
    assert (
        utils.parse.parse_url(
            "http://hostname:0", strict_port=True, simple=True
        )
        is None
    )

    # Without strict port checking however, it is okay
    result = utils.parse.parse_url(
        "http://hostname:0", strict_port=False, simple=True
    )
    assert len(result) == 4
    assert result["schema"] == "http"
    assert result["port"] == 0
    assert result["host"] == "hostname"
    assert result["url"] == "http://hostname:0"

    # A negative port is not valid
    assert (
        utils.parse.parse_url(
            "http://hostname:-92", strict_port=True, simple=True
        )
        is None
    )
    result = utils.parse.parse_url(
        "http://hostname:-92", verify_host=False, strict_port=True, simple=True
    )
    assert len(result) == 4
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == -92
    assert result["url"] == "http://hostname:-92"

    # A port that is too large is not valid
    assert (
        utils.parse.parse_url(
            "http://hostname:65536", strict_port=True, simple=True
        )
        is None
    )

    # This is an accetable port (the maximum)
    result = utils.parse.parse_url(
        "http://hostname:65535", strict_port=True, simple=True
    )
    assert len(result) == 4
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == 65535
    assert result["url"] == "http://hostname:65535"

    # This is an accetable port (the maximum)
    result = utils.parse.parse_url(
        "http://hostname:1", strict_port=True, simple=True
    )
    assert len(result) == 4
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == 1
    assert result["url"] == "http://hostname:1"

    # A port that was identfied as a string is invalid
    assert (
        utils.parse.parse_url(
            "http://hostname:invalid", strict_port=True, simple=True
        )
        is None
    )
    result = utils.parse.parse_url(
        "http://hostname:invalid",
        verify_host=False,
        strict_port=True,
        simple=True,
    )
    assert len(result) == 4
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == "invalid"
    assert result["url"] == "http://hostname:invalid"

    result = utils.parse.parse_url(
        "http://hostname:invalid",
        verify_host=False,
        strict_port=False,
        simple=True,
    )
    assert len(result) == 3
    assert result["schema"] == "http"
    assert result["host"] == "hostname:invalid"
    assert result["url"] == "http://hostname:invalid"

    result = utils.parse.parse_url(
        "http://hostname:invalid?key=value&-minuskey=mvalue",
        verify_host=False,
        strict_port=False,
        simple=True,
    )
    assert len(result) == 4
    assert result["schema"] == "http"
    assert result["host"] == "hostname:invalid"
    assert result["url"] == "http://hostname:invalid"
    assert isinstance(result["qsd"], dict)
    assert len(result["qsd"]) == 2
    assert unquote(result["qsd"]["-minuskey"]) == "mvalue"
    assert unquote(result["qsd"]["key"]) == "value"

    # Handling of floats
    assert (
        utils.parse.parse_url(
            "http://hostname:4.2", strict_port=True, simple=True
        )
        is None
    )
    result = utils.parse.parse_url(
        "http://hostname:4.2", verify_host=False, strict_port=True, simple=True
    )
    assert len(result) == 4
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == "4.2"
    assert result["url"] == "http://hostname:4.2"

    # A Port of zero is not acceptable for a regular hostname
    assert (
        utils.parse.parse_url(
            "http://hostname:0", strict_port=True, simple=True
        )
        is None
    )

    # No host verification (zero is an acceptable port when this is the case
    result = utils.parse.parse_url(
        "http://hostname:0", verify_host=False, simple=True
    )
    assert len(result) == 4
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == 0
    assert result["url"] == "http://hostname:0"

    result = utils.parse.parse_url(
        "http://[2001:db8:002a:3256:adfe:05c0:0003:0006]:8080",
        verify_host=False,
        simple=True,
    )
    assert len(result) == 4
    assert result["schema"] == "http"
    assert result["host"] == "[2001:db8:002a:3256:adfe:05c0:0003:0006]"
    assert result["port"] == 8080
    assert (
        result["url"] == "http://[2001:db8:002a:3256:adfe:05c0:0003:0006]:8080"
    )

    result = utils.parse.parse_url(
        "http://hostname:0", verify_host=False, strict_port=True, simple=True
    )
    assert len(result) == 4
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == 0
    assert result["url"] == "http://hostname:0"

    result = utils.parse.parse_url("http://hostname/?-KeY=Value", simple=True)
    assert len(result) == 6
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["url"] == "http://hostname/"
    assert "-key" in result["qsd"]
    assert unquote(result["qsd"]["-key"]) == "Value"

    result = utils.parse.parse_url("http://hostname/?+KeY=Value", simple=True)
    assert len(result) == 6
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["url"] == "http://hostname/"
    assert "+key" in result["qsd"]
    assert result["qsd"]["+key"] == "Value"

    result = utils.parse.parse_url("http://hostname/?:kEy=vALUE", simple=True)
    assert len(result) == 6
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["url"] == "http://hostname/"
    assert ":key" in result["qsd"]
    assert result["qsd"][":key"] == "vALUE"

    result = utils.parse.parse_url(
        "http://hostname/?+KeY=ValueA&-kEy=ValueB&KEY=Value%20+C&:colon=y",
        simple=True,
    )
    assert len(result) == 6
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["url"] == "http://hostname/"
    assert "+key" in result["qsd"]
    assert "-key" in result["qsd"]
    assert ":colon" in result["qsd"]
    assert result["qsd"][":colon"] == "y"
    assert result["qsd"]["key"] == "Value +C"
    assert result["qsd"]["+key"] == "ValueA"
    assert result["qsd"]["-key"] == "ValueB"

    result = utils.parse.parse_url("http://hostname////", simple=True)
    assert len(result) == 5
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["url"] == "http://hostname/"

    result = utils.parse.parse_url("http://hostname:40////", simple=True)
    assert len(result) == 6
    assert result["schema"] == "http"
    assert result["host"] == "hostname"
    assert result["port"] == 40
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["url"] == "http://hostname:40/"

    result = utils.parse.parse_url("HTTP://HoStNaMe:40/test.php", simple=True)
    assert len(result) == 7
    assert result["schema"] == "http"
    assert result["host"] == "HoStNaMe"
    assert result["port"] == 40
    assert result["fullpath"] == "/test.php"
    assert result["path"] == "/"
    assert result["query"] == "test.php"
    assert result["url"] == "http://HoStNaMe:40/test.php"

    result = utils.parse.parse_url(
        "HTTPS://user@hostname/test.py", simple=True
    )
    assert len(result) == 7
    assert result["schema"] == "https"
    assert result["host"] == "hostname"
    assert result["user"] == "user"
    assert result["fullpath"] == "/test.py"
    assert result["path"] == "/"
    assert result["query"] == "test.py"
    assert result["url"] == "https://user@hostname/test.py"

    result = utils.parse.parse_url(
        "  HTTPS://///user@@@hostname///test.py  ", simple=True
    )
    assert len(result) == 7
    assert result["schema"] == "https"
    assert result["host"] == "hostname"
    assert result["user"] == "user"
    assert result["fullpath"] == "/test.py"
    assert result["path"] == "/"
    assert result["query"] == "test.py"
    assert result["url"] == "https://user@hostname/test.py"

    result = utils.parse.parse_url(
        "HTTPS://user:password@otherHost/full///path/name/",
        simple=True,
    )
    assert len(result) == 7
    assert result["schema"] == "https"
    assert result["host"] == "otherHost"
    assert result["user"] == "user"
    assert result["password"] == "password"
    assert result["fullpath"] == "/full/path/name/"
    assert result["path"] == "/full/path/name/"
    assert result["url"] == "https://user:password@otherHost/full/path/name/"

    # Handle garbage
    assert utils.parse.parse_url(None) is None

    result = utils.parse.parse_url(
        "mailto://user:password@otherHost/lead2gold@gmail.com"
        + "?from=test@test.com&name=Chris%20Caron&format=text",
        simple=True,
    )
    assert len(result) == 9
    assert result["schema"] == "mailto"
    assert result["host"] == "otherHost"
    assert result["user"] == "user"
    assert result["password"] == "password"
    assert unquote(result["fullpath"]) == "/lead2gold@gmail.com"
    assert result["path"] == "/"
    assert unquote(result["query"]) == "lead2gold@gmail.com"
    assert (
        unquote(result["url"])
        == "mailto://user:password@otherHost/lead2gold@gmail.com"
    )
    assert len(result["qsd"]) == 3
    assert "name" in result["qsd"]
    assert unquote(result["qsd"]["name"]) == "Chris Caron"
    assert "from" in result["qsd"]
    assert unquote(result["qsd"]["from"]) == "test@test.com"
    assert "format" in result["qsd"]
    assert unquote(result["qsd"]["format"]) == "text"

    # Test Passwords with question marks ?; not supported
    result = utils.parse.parse_url(
        "http://user:pass.with.?question@host", simple=True
    )
    assert result is None

    # just hostnames
    result = utils.parse.parse_url(
        "nuxref.com",
        simple=True,
    )
    assert len(result) == 3
    assert result["schema"] == "http"
    assert result["host"] == "nuxref.com"
    assert result["url"] == "http://nuxref.com"

    # just host and path
    result = utils.parse.parse_url("invalid/host", simple=True)
    assert len(result) == 6
    assert result["schema"] == "http"
    assert result["host"] == "invalid"
    assert result["fullpath"] == "/host"
    assert result["path"] == "/"
    assert result["query"] == "host"
    assert result["url"] == "http://invalid/host"

    # just all out invalid
    assert utils.parse.parse_url("?", simple=True) is None
    assert utils.parse.parse_url("/", simple=True) is None

    # Test some illegal strings
    result = utils.parse.parse_url(object, verify_host=False, simple=True)
    assert result is None
    result = utils.parse.parse_url(None, verify_host=False, simple=True)
    assert result is None

    # Just a schema; invalid host
    result = utils.parse.parse_url("test://", simple=True)
    assert result is None

    # Do it again without host validation
    result = utils.parse.parse_url("test://", verify_host=False, simple=True)
    assert len(result) == 2
    assert result["schema"] == "test"
    assert result["url"] == "test://"

    result = utils.parse.parse_url("testhostname", simple=True)
    assert len(result) == 3
    assert result["schema"] == "http"
    assert result["host"] == "testhostname"
    # The default_schema kicks in here
    assert result["url"] == "http://testhostname"

    result = utils.parse.parse_url(
        "example.com", default_schema="unknown", simple=True
    )
    assert len(result) == 3
    assert result["schema"] == "unknown"
    assert result["host"] == "example.com"
    # The default_schema kicks in here
    assert result["url"] == "unknown://example.com"

    # An empty string without a hostame is still valid if verify_host is set
    result = utils.parse.parse_url("", verify_host=False, simple=True)
    assert len(result) == 2
    assert result["schema"] == "http"
    # The default_schema kicks in here
    assert result["url"] == "http://"

    # A messed up URL
    result = utils.parse.parse_url(
        "test://:@/", verify_host=False, simple=True
    )
    assert len(result) == 6
    assert result["schema"] == "test"
    assert result["user"] == ""
    assert result["password"] == ""
    assert result["fullpath"] == "/"
    assert result["path"] == "/"
    assert result["url"] == "test://:@/"

    result = utils.parse.parse_url(
        "crazy://:@//_/@^&/jack.json", verify_host=False, simple=True
    )
    assert len(result) == 7
    assert result["schema"] == "crazy"
    assert result["user"] == ""
    assert result["password"] == ""
    assert unquote(result["fullpath"]) == "/_/@^&/jack.json"
    assert unquote(result["path"]) == "/_/@^&/"
    assert result["query"] == "jack.json"
    assert unquote(result["url"]) == "crazy://:@/_/@^&/jack.json"


def test_url_assembly():
    """ "utils: url_assembly() testing."""

    url = "schema://user:password@hostname:port/path/?key=value"
    assert (
        utils.parse.url_assembly(
            **utils.parse.parse_url(url, verify_host=False)
        )
        == url
    )

    # Same URL without trailing slash after path
    url = "schema://user:password@hostname:port/path?key=value"
    assert (
        utils.parse.url_assembly(
            **utils.parse.parse_url(url, verify_host=False)
        )
        == url
    )

    url = "schema://user@hostname:port/path?key=value"
    assert (
        utils.parse.url_assembly(
            **utils.parse.parse_url(url, verify_host=False)
        )
        == url
    )

    url = "schema://hostname:10/a/file.php"
    assert (
        utils.parse.url_assembly(
            **utils.parse.parse_url(url, verify_host=False)
        )
        == url
    )

    # When spaces and special characters are introduced, the URL
    # is hard to mimic what was entered. Instead it is normalized
    url = (
        "schema://hostname:10/a space/file.php?"
        "arg=a+space&arg2=a%20space&arg3=a space"
    )
    assert (
        utils.parse.url_assembly(
            **utils.parse.parse_url(url, verify_host=False)
        )
        == "schema://hostname:10/a%20space/file.php?"
        "arg=a%2Bspace&arg2=a%20space&arg3=a%20space"
    )

    # encode=True should only be used if you're passing in un-assembled
    # content... hence the following is likely not what is expected:
    assert (
        utils.parse.url_assembly(
            **utils.parse.parse_url(url, verify_host=False), encode=True
        )
        == "schema://hostname:10/a%2520space/file.php?"
        "arg=a%2Bspace&arg2=a%20space&arg3=a%20space"
    )

    # But the following utilizes the encode=True and produces the
    # desired effects:
    content = {
        "host": "hostname",
        # Note that fullpath requires escaping in this case
        "fullpath": "/a space/file.php",
        "path": "/a space/",
        "query": "file.php",
        "schema": "schema",
        # our query arguments also require escaping as well
        "qsd": {"arg": "a+space", "arg2": "a space", "arg3": "a space"},
    }
    assert (
        utils.parse.url_assembly(**content, encode=True)
        == "schema://hostname/a%20space/file.php?"
        "arg=a%2Bspace&arg2=a%20space&arg3=a%20space"
    )


def test_parse_bool():
    "utils: parse_bool() testing"

    assert utils.parse.parse_bool("Enabled", None) is True
    assert utils.parse.parse_bool("Disabled", None) is False
    assert utils.parse.parse_bool("Allow", None) is True
    assert utils.parse.parse_bool("Deny", None) is False
    assert utils.parse.parse_bool("Yes", None) is True
    assert utils.parse.parse_bool("YES", None) is True
    assert utils.parse.parse_bool("Always", None) is True
    assert utils.parse.parse_bool("No", None) is False
    assert utils.parse.parse_bool("NO", None) is False
    assert utils.parse.parse_bool("NEVER", None) is False
    assert utils.parse.parse_bool("TrUE", None) is True
    assert utils.parse.parse_bool("tRUe", None) is True
    assert utils.parse.parse_bool("FAlse", None) is False
    assert utils.parse.parse_bool("F", None) is False
    assert utils.parse.parse_bool("T", None) is True
    assert utils.parse.parse_bool("0", None) is False
    assert utils.parse.parse_bool("1", None) is True
    assert utils.parse.parse_bool("True", None) is True
    assert utils.parse.parse_bool("Yes", None) is True
    assert utils.parse.parse_bool(1, None) is True
    assert utils.parse.parse_bool(0, None) is False
    assert utils.parse.parse_bool(True, None) is True
    assert utils.parse.parse_bool(False, None) is False

    # only the int of 0 will return False since the function
    # casts this to a boolean
    assert utils.parse.parse_bool(2, None) is True
    # An empty list is still false
    assert utils.parse.parse_bool([], None) is False
    # But a list that contains something is True
    assert (
        utils.parse.parse_bool(
            [
                "value",
            ],
            None,
        )
        is True
    )

    # Use Default (which is False)
    assert utils.parse.parse_bool("OhYeah") is False
    # Adjust Default and get a different result
    assert utils.parse.parse_bool("OhYeah", True) is True


def test_is_uuid():
    """
    API: is_uuid() function
    """
    # Invalid Entries
    assert utils.parse.is_uuid("invalid") is False
    assert utils.parse.is_uuid(None) is False
    assert utils.parse.is_uuid(5) is False
    assert utils.parse.is_uuid(object) is False

    # A slightly invalid uuid4 entry
    assert utils.parse.is_uuid("591ed387-fa65-ac97-9712-b9d2a15e42a9") is False
    assert utils.parse.is_uuid("591ed387-fa65-Jc97-9712-b9d2a15e42a9") is False

    # Valid UUID4 Entries
    assert utils.parse.is_uuid("591ed387-fa65-4c97-9712-b9d2a15e42a9") is True
    assert utils.parse.is_uuid("32b0b447-fe84-4df1-8368-81925e729265") is True


def test_is_hostname():
    """
    API: is_hostname() function

    """
    # Valid Hostnames
    assert utils.parse.is_hostname("yahoo.ca") == "yahoo.ca"
    assert utils.parse.is_hostname("yahoo.ca.") == "yahoo.ca"
    assert (
        utils.parse.is_hostname("valid-dashes-in-host.ca")
        == "valid-dashes-in-host.ca"
    )
    assert (
        utils.parse.is_hostname("valid-underscores_in_host.ca")
        == "valid-underscores_in_host.ca"
    )

    # Underscores are supported by default
    assert (
        utils.parse.is_hostname("valid_dashes_in_host.ca")
        == "valid_dashes_in_host.ca"
    )
    # However they are not if specified otherwise:
    assert (
        utils.parse.is_hostname("valid_dashes_in_host.ca", underscore=False)
        is False
    )

    # Invalid Hostnames
    assert (
        utils.parse.is_hostname("-hostname.that.starts.with.a.dash") is False
    )
    assert utils.parse.is_hostname("invalid-characters_#^.ca") is False
    assert utils.parse.is_hostname("    spaces   ") is False
    assert utils.parse.is_hostname("       ") is False
    assert utils.parse.is_hostname("") is False

    # Valid IPv4 Addresses
    assert utils.parse.is_hostname("127.0.0.1") == "127.0.0.1"
    assert utils.parse.is_hostname("0.0.0.0") == "0.0.0.0"
    assert utils.parse.is_hostname("255.255.255.255") == "255.255.255.255"

    # But not if we're not checking for this:
    assert utils.parse.is_hostname("127.0.0.1", ipv4=False) is False
    assert utils.parse.is_hostname("0.0.0.0", ipv4=False) is False
    assert utils.parse.is_hostname("255.255.255.255", ipv4=False) is False

    # Invalid IPv4 Addresses
    assert utils.parse.is_hostname("1.2.3") is False
    assert utils.parse.is_hostname("256.256.256.256") is False
    assert utils.parse.is_hostname("999.0.0.0") is False
    assert utils.parse.is_hostname("1.2.3.4.5") is False
    assert utils.parse.is_hostname("    127.0.0.1   ") is False
    assert utils.parse.is_hostname("       ") is False
    assert utils.parse.is_hostname("") is False

    # Valid IPv6 Addresses (square brakets supported for URL construction)
    assert (
        utils.parse.is_hostname("[2001:0db8:85a3:0000:0000:8a2e:0370:7334]")
        == "[2001:0db8:85a3:0000:0000:8a2e:0370:7334]"
    )
    assert (
        utils.parse.is_hostname("2001:0db8:85a3:0000:0000:8a2e:0370:7334")
        == "[2001:0db8:85a3:0000:0000:8a2e:0370:7334]"
    )
    assert (
        utils.parse.is_hostname("[2001:db8:002a:3256:adfe:05c0:0003:0006]")
        == "[2001:db8:002a:3256:adfe:05c0:0003:0006]"
    )

    # localhost
    assert utils.parse.is_hostname("::1") == "[::1]"
    assert utils.parse.is_hostname("0:0:0:0:0:0:0:1") == "[0:0:0:0:0:0:0:1]"

    # compressed addresses
    assert utils.parse.is_hostname("2001:db8::1") == "[2001:db8::1]"
    assert utils.parse.is_hostname("[2001:db8::1]") == "[2001:db8::1]"
    assert utils.parse.is_hostname("fd00::5") == "[fd00::5]"
    assert utils.parse.is_hostname("[fd00::5]") == "[fd00::5]"

    # A malformed address is refused rather than partially accepted
    assert utils.parse.is_hostname("2001:db8::1::2") is False
    assert utils.parse.is_hostname("[2001:db8::1") is False

    # But not if we're not checking for this:
    assert (
        utils.parse.is_hostname(
            "[2001:0db8:85a3:0000:0000:8a2e:0370:7334]", ipv6=False
        )
        is False
    )
    assert (
        utils.parse.is_hostname(
            "2001:0db8:85a3:0000:0000:8a2e:0370:7334", ipv6=False
        )
        is False
    )

    # Test hostnames with a single character hostname
    assert (
        utils.parse.is_hostname("cloud.a.example.com", ipv4=False, ipv6=False)
        == "cloud.a.example.com"
    )


def test_is_ipaddr():
    """
    API: is_ipaddr() function

    """
    # Valid IPv4 Addresses
    assert utils.parse.is_ipaddr("127.0.0.1") == "127.0.0.1"
    assert utils.parse.is_ipaddr("0.0.0.0") == "0.0.0.0"
    assert utils.parse.is_ipaddr("255.255.255.255") == "255.255.255.255"

    # Invalid IPv4 Addresses
    assert utils.parse.is_ipaddr("1.2.3") is False
    assert utils.parse.is_ipaddr("256.256.256.256") is False
    assert utils.parse.is_ipaddr("999.0.0.0") is False
    assert utils.parse.is_ipaddr("1.2.3.4.5") is False
    assert utils.parse.is_ipaddr("    127.0.0.1   ") is False
    assert utils.parse.is_ipaddr("       ") is False
    assert utils.parse.is_ipaddr("") is False

    # Valid IPv6 Addresses (square brakets supported for URL construction)
    assert (
        utils.parse.is_ipaddr("[2001:0db8:85a3:0000:0000:8a2e:0370:7334]")
        == "[2001:0db8:85a3:0000:0000:8a2e:0370:7334]"
    )
    assert (
        utils.parse.is_ipaddr("2001:0db8:85a3:0000:0000:8a2e:0370:7334")
        == "[2001:0db8:85a3:0000:0000:8a2e:0370:7334]"
    )
    assert (
        utils.parse.is_ipaddr("[2001:db8:002a:3256:adfe:05c0:0003:0006]")
        == "[2001:db8:002a:3256:adfe:05c0:0003:0006]"
    )

    # localhost
    assert utils.parse.is_ipaddr("::1") == "[::1]"
    assert utils.parse.is_ipaddr("0:0:0:0:0:0:0:1") == "[0:0:0:0:0:0:0:1]"

    # Compressed addresses
    assert utils.parse.is_ipaddr("2001:db8::1") == "[2001:db8::1]"
    assert utils.parse.is_ipaddr("[2001:db8::1]") == "[2001:db8::1]"
    assert utils.parse.is_ipaddr("fd00::5") == "[fd00::5]"
    assert utils.parse.is_ipaddr("fe80::1") == "[fe80::1]"
    assert utils.parse.is_ipaddr("::") == "[::]"
    assert utils.parse.is_ipaddr("1::") == "[1::]"
    assert utils.parse.is_ipaddr("1::8") == "[1::8]"
    assert utils.parse.is_ipaddr("2001:db8::8a2e:370:7334") == (
        "[2001:db8::8a2e:370:7334]"
    )
    assert utils.parse.is_ipaddr("2001:db8:85a3::8a2e:370:7334") == (
        "[2001:db8:85a3::8a2e:370:7334]"
    )
    assert utils.parse.is_ipaddr("2001:db8:0:0:1::1") == (
        "[2001:db8:0:0:1::1]"
    )

    # IPv4 mapped and embedded forms
    assert utils.parse.is_ipaddr("::ffff:192.0.2.1") == "[::ffff:192.0.2.1]"
    assert utils.parse.is_ipaddr("::192.0.2.1") == "[::192.0.2.1]"
    assert utils.parse.is_ipaddr("2001:db8::192.0.2.1") == (
        "[2001:db8::192.0.2.1]"
    )

    # A link local address may carry a zone id
    assert utils.parse.is_ipaddr("fe80::1%eth0") == "[fe80::1%eth0]"
    assert utils.parse.is_ipaddr("[fe80::1%eth0]") == "[fe80::1%eth0]"

    # Invalid IPv6 Addresses; more than one :: is not allowed
    assert utils.parse.is_ipaddr("2001:db8::1::2") is False
    assert utils.parse.is_ipaddr("::1::") is False

    # Groups longer than four hex digits, or that are not hex at all
    assert utils.parse.is_ipaddr("2001:db8::12345") is False
    assert utils.parse.is_ipaddr("not:an:address") is False
    assert utils.parse.is_ipaddr("2001:db8::xyz") is False

    # Too many groups
    assert utils.parse.is_ipaddr("1:2:3:4:5:6:7:8:9") is False

    # Trailing and leading junk is not quietly dropped
    assert utils.parse.is_ipaddr("2001:db8::1junk") is False
    assert utils.parse.is_ipaddr("junk2001:db8::1") is False
    assert utils.parse.is_ipaddr("2001:db8::1 ") is False
    assert utils.parse.is_ipaddr(" 2001:db8::1") is False

    # Brackets have to come in pairs
    assert utils.parse.is_ipaddr("[2001:db8::1") is False
    assert utils.parse.is_ipaddr("2001:db8::1]") is False
    assert utils.parse.is_ipaddr("[::1") is False
    assert utils.parse.is_ipaddr("::1]") is False

    # An IPv6 address is not accepted when we are not looking for one
    assert utils.parse.is_ipaddr("2001:db8::1", ipv6=False) is False
    assert utils.parse.is_ipaddr("fd00::5", ipv6=False) is False

    # ...and likewise for IPv4
    assert utils.parse.is_ipaddr("127.0.0.1", ipv4=False) is False

    # An IPv4 address is not an IPv6 one, brackets or not
    assert utils.parse.is_ipaddr("[127.0.0.1]") is False


def test_parse_url_ipv6_host():
    """
    API: parse_url() IPv6 host handling

    """
    # Compressed addresses
    result = utils.parse.parse_url("https://[2001:db8::1]/path")
    assert result["host"] == "[2001:db8::1]"
    assert result["port"] is None
    assert result["url"] == "https://[2001:db8::1]/path"

    # ...and the port is kept separate from the address
    result = utils.parse.parse_url("https://[2001:db8::1]:8443/path")
    assert result["host"] == "[2001:db8::1]"
    assert result["port"] == 8443
    assert result["url"] == "https://[2001:db8::1]:8443/path"

    # An address written without brackets and without a port also works
    result = utils.parse.parse_url("https://fd00::5/path")
    assert result["host"] == "[fd00::5]"
    assert result["port"] is None
    assert result["url"] == "https://[fd00::5]/path"

    # A full length address is unchanged
    result = utils.parse.parse_url(
        "https://[2001:0db8:85a3:0000:0000:8a2e:0370:7334]:443/x"
    )
    assert result["host"] == "[2001:0db8:85a3:0000:0000:8a2e:0370:7334]"
    assert result["port"] == 443

    # Credentials sit alongside an IPv6 host without disturbing it
    result = utils.parse.parse_url("https://user:pass@[fd00::5]:8443/path")
    assert result["host"] == "[fd00::5]"
    assert result["port"] == 8443
    assert result["user"] == "user"
    assert result["password"] == "pass"

    # A malformed bracketed address is refused.
    assert utils.parse.parse_url("https://[2001:db8::1::2]/x") is None
    assert (
        utils.parse.parse_url("https://[2001:db8::1::2]/x", verify_host=False)
        is None
    )

    # An address written without brackets
    assert utils.parse.parse_url("https://2001:db8::1::2/x") is None

    result = utils.parse.parse_url(
        "https://2001:db8::1::2/x", verify_host=False
    )
    assert result["host"] == "2001:db8::1::2"


def test_parse_url_ipv6_round_trip():
    """
    API: parse_url() IPv6 addresses survive a round trip

    """
    # ipv6 host checks
    for host in (
        "[2001:db8::1]",
        "[fd00::5]",
        "[::1]",
        "[2001:db8:85a3::8a2e:370:7334]",
        "[2001:0db8:85a3:0000:0000:8a2e:0370:7334]",
    ):
        url = f"https://{host}:8443/path"
        first = utils.parse.parse_url(url)
        assert first["host"] == host

        second = utils.parse.parse_url(first["url"])
        assert second["host"] == host
        assert second["url"] == first["url"]


def test_is_email():
    """
    API: is_email() function

    """
    # Valid Emails
    results = utils.parse.is_email("test@gmail.com")
    assert results["name"] == ""
    assert results["email"] == "test@gmail.com"
    assert results["full_email"] == "test@gmail.com"
    assert results["domain"] == "gmail.com"
    assert results["user"] == "test"
    assert results["label"] == ""

    results = utils.parse.is_email("test@my-valid_host.com")
    assert results["name"] == ""
    assert results["email"] == "test@my-valid_host.com"
    assert results["full_email"] == "test@my-valid_host.com"
    assert results["domain"] == "my-valid_host.com"
    assert results["user"] == "test"
    assert results["label"] == ""

    results = utils.parse.is_email("tag+test@gmail.com")
    assert results["name"] == ""
    assert results["email"] == "test@gmail.com"
    assert results["full_email"] == "tag+test@gmail.com"
    assert results["domain"] == "gmail.com"
    assert results["user"] == "test"
    assert results["label"] == "tag"

    # Support Full Names as well
    results = utils.parse.is_email("Bill Gates: bgates@microsoft.com")
    assert results["name"] == "Bill Gates"
    assert results["email"] == "bgates@microsoft.com"
    assert results["full_email"] == "bgates@microsoft.com"
    assert results["domain"] == "microsoft.com"
    assert results["user"] == "bgates"
    assert results["label"] == ""

    results = utils.parse.is_email("Bill Gates ")
    assert results["name"] == "Bill Gates"
    assert results["email"] == "bgates@microsoft.com"
    assert results["full_email"] == "bgates@microsoft.com"
    assert results["domain"] == "microsoft.com"
    assert results["user"] == "bgates"
    assert results["label"] == ""

    results = utils.parse.is_email("Bill Gates: ")
    assert results["name"] == "Bill Gates"
    assert results["email"] == "bgates@microsoft.com"
    assert results["full_email"] == "bgates@microsoft.com"
    assert results["domain"] == "microsoft.com"
    assert results["user"] == "bgates"
    assert results["label"] == ""

    results = utils.parse.is_email("Sundar Pichai ")
    assert results["name"] == "Sundar Pichai"
    assert results["email"] == "spichai@gmail.com"
    assert results["full_email"] == "ceo+spichai@gmail.com"
    assert results["domain"] == "gmail.com"
    assert results["user"] == "spichai"
    assert results["label"] == "ceo"

    # Support Quotes
    results = utils.parse.is_email('"Chris Hemsworth" ')
    assert results["name"] == "Chris Hemsworth"
    assert results["email"] == "ch@test.com"
    assert results["full_email"] == "ch@test.com"
    assert results["domain"] == "test.com"
    assert results["user"] == "ch"
    assert results["label"] == ""

    # An email without name, but contains delimiters
    results = utils.parse.is_email("      ")
    assert results["name"] == ""
    assert results["email"] == "spichai@gmail.com"
    assert results["full_email"] == "spichai@gmail.com"
    assert results["domain"] == "gmail.com"
    assert results["user"] == "spichai"
    assert results["label"] == ""

    # a valid email not properly delimited with a colon or angle bracket
    # We do a best guess and still parse it correctly
    results = utils.parse.is_email("Name valid@example.com")
    assert results["name"] == "Name"
    assert results["email"] == "valid@example.com"
    assert results["full_email"] == "valid@example.com"
    assert results["domain"] == "example.com"
    assert results["user"] == "valid"
    assert results["label"] == ""

    # a valid email not properly delimited with a colon or angle bracket
    # We do a best guess and still parse it correctly
    results = utils.parse.is_email("Руслан Эра russian+russia@example.ru")
    assert results["name"] == "Руслан Эра"
    assert results["email"] == "russia@example.ru"
    assert results["full_email"] == "russian+russia@example.ru"
    assert results["domain"] == "example.ru"
    assert results["user"] == "russia"
    assert results["label"] == "russian"

    # Invalid Emails
    assert utils.parse.is_email("invalid.com") is False
    assert utils.parse.is_email(object()) is False
    assert utils.parse.is_email(None) is False
    assert utils.parse.is_email("Just A Name") is False
    assert utils.parse.is_email("Name ") is False

    # Extended valid emails
    #
    # The first + denotes our label, so this test really validates
    # that there is a correct split and parsing of our email
    results = utils.parse.is_email("a-z0-9_!#$%&*+/=?%`{|}~^.-@gmail.com")
    assert results["name"] == ""
    assert results["label"] == "a-z0-9_!#$%&*"
    assert results["email"] == "/=?%`{|}~^.-@gmail.com"
    assert results["full_email"] == "a-z0-9_!#$%&*+/=?%`{|}~^.-@gmail.com"
    assert results["domain"] == "gmail.com"
    assert results["user"] == "/=?%`{|}~^.-"

    # A similar test without '+' (use of a label)

    # The first + denotes our label, so this test really validates
    # that there is a correct split and parsing of our email
    results = utils.parse.is_email("a-z0-9_!#$%&*/=?%`{|}~^.-@gmail.com")
    assert results["name"] == ""
    assert results["label"] == ""
    assert results["email"] == "a-z0-9_!#$%&*/=?%`{|}~^.-@gmail.com"
    assert results["full_email"] == "a-z0-9_!#$%&*/=?%`{|}~^.-@gmail.com"
    assert results["domain"] == "gmail.com"
    assert results["user"] == "a-z0-9_!#$%&*/=?%`{|}~^.-"


def test_is_domain_service_target():
    """
    API: is_domain_service_target() function

    """
    # Invalid information
    assert utils.parse.is_domain_service_target(None) is False
    assert utils.parse.is_domain_service_target(42) is False
    assert utils.parse.is_domain_service_target(object) is False
    assert utils.parse.is_domain_service_target("") is False
    assert utils.parse.is_domain_service_target("+()") is False
    assert utils.parse.is_domain_service_target("+") is False

    # Valid entries
    result = utils.parse.is_domain_service_target("service")
    assert isinstance(result, dict)
    assert result["service"] == "service"
    # Default domain
    assert result["domain"] == "notify"
    assert isinstance(result["targets"], list)
    assert len(result["targets"]) == 0

    result = utils.parse.is_domain_service_target("domain.service")
    assert isinstance(result, dict)
    assert result["service"] == "service"
    assert result["domain"] == "domain"
    assert isinstance(result["targets"], list)
    assert len(result["targets"]) == 0

    result = utils.parse.is_domain_service_target("domain.service:target")
    assert isinstance(result, dict)
    assert result["service"] == "service"
    assert result["domain"] == "domain"
    assert isinstance(result["targets"], list)
    assert len(result["targets"]) == 1
    assert result["targets"][0] == "target"

    result = utils.parse.is_domain_service_target("domain.service:t1,t2,t3")
    assert isinstance(result, dict)
    assert result["service"] == "service"
    assert result["domain"] == "domain"
    assert isinstance(result["targets"], list)
    assert len(result["targets"]) == 3
    assert "t1" in result["targets"]
    assert "t2" in result["targets"]
    assert "t3" in result["targets"]

    result = utils.parse.is_domain_service_target(
        "service:t1,t2,t3", domain="new_default"
    )
    assert isinstance(result, dict)
    assert result["service"] == "service"
    # Default domain
    assert result["domain"] == "new_default"
    assert isinstance(result["targets"], list)
    assert len(result["targets"]) == 3
    assert "t1" in result["targets"]
    assert "t2" in result["targets"]
    assert "t3" in result["targets"]


def test_is_call_sign_no():
    """
    API: is_call_sign() function

    """
    # Invalid numbers
    assert utils.parse.is_call_sign(None) is False
    assert utils.parse.is_call_sign(42) is False
    assert utils.parse.is_call_sign(object) is False
    assert utils.parse.is_call_sign("") is False
    assert utils.parse.is_call_sign("1") is False
    assert utils.parse.is_call_sign("12") is False
    assert utils.parse.is_call_sign("abc") is False
    assert utils.parse.is_call_sign("+()") is False
    assert utils.parse.is_call_sign("+") is False
    assert utils.parse.is_call_sign(None) is False
    assert utils.parse.is_call_sign(42) is False

    # To short or 2 long
    assert utils.parse.is_call_sign("DF1ABCX") is False
    assert utils.parse.is_call_sign("DF1ABCEFG") is False
    assert utils.parse.is_call_sign("1ABCX") is False
    # 4th character is not an number
    assert utils.parse.is_call_sign("XXXXXX") is False

    # Some valid checks
    # 1x2
    result = utils.parse.is_call_sign("A0AF")
    assert isinstance(result, dict)
    assert result["callsign"] == "A0AF"
    assert result["ssid"] == ""

    # 2x1
    result = utils.parse.is_call_sign("AA0A")
    assert isinstance(result, dict)
    assert result["callsign"] == "AA0A"
    assert result["ssid"] == ""

    # 2x2
    result = utils.parse.is_call_sign("AA0AF")
    assert isinstance(result, dict)
    assert result["callsign"] == "AA0AF"
    assert result["ssid"] == ""

    result = utils.parse.is_call_sign("AA0AF-23")
    assert isinstance(result, dict)
    assert result["callsign"] == "AA0AF"
    assert result["ssid"] == "23"

    # 1x3
    result = utils.parse.is_call_sign("K0ACL")
    assert isinstance(result, dict)
    assert result["callsign"] == "K0ACL"
    assert result["ssid"] == ""

    # 2x3
    result = utils.parse.is_call_sign("DF1ABC")
    assert isinstance(result, dict)
    assert result["callsign"] == "DF1ABC"
    assert result["ssid"] == ""

    # Get our SSID
    result = utils.parse.is_call_sign("DF1ABC-14")
    assert result["callsign"] == "DF1ABC"
    assert result["ssid"] == "14"


def test_is_phone_no():
    """
    API: is_phone_no() function

    """
    # Invalid numbers
    assert utils.parse.is_phone_no(None) is False
    assert utils.parse.is_phone_no(42) is False
    assert utils.parse.is_phone_no(object) is False
    assert utils.parse.is_phone_no("") is False
    assert utils.parse.is_phone_no("1") is False
    assert utils.parse.is_phone_no("12") is False
    assert utils.parse.is_phone_no("abc") is False
    assert utils.parse.is_phone_no("+()") is False
    assert utils.parse.is_phone_no("+") is False
    assert utils.parse.is_phone_no(None) is False
    assert utils.parse.is_phone_no(42) is False
    assert utils.parse.is_phone_no(object, min_len=0) is False
    assert utils.parse.is_phone_no("", min_len=1) is False
    assert utils.parse.is_phone_no("abc", min_len=0) is False
    assert utils.parse.is_phone_no("", min_len=0) is False

    # Ambigious, but will document it here in this test as such
    results = utils.parse.is_phone_no("+((()))--+", min_len=0)
    assert results["country"] == ""
    assert results["area"] == ""
    assert results["line"] == ""
    assert results["pretty"] == ""
    assert results["full"] == ""

    # Valid phone numbers
    assert utils.parse.is_phone_no("+(0)") is False
    results = utils.parse.is_phone_no("+(0)", min_len=1)
    assert results["country"] == ""
    assert results["area"] == ""
    assert results["line"] == "0"
    assert results["pretty"] == "0"
    assert results["full"] == "0"

    assert utils.parse.is_phone_no("1") is False
    results = utils.parse.is_phone_no("1", min_len=1)
    assert results["country"] == ""
    assert results["area"] == ""
    assert results["line"] == "1"
    assert results["pretty"] == "1"
    assert results["full"] == "1"

    assert utils.parse.is_phone_no("12") is False
    results = utils.parse.is_phone_no("12", min_len=2)
    assert results["country"] == ""
    assert results["area"] == ""
    assert results["line"] == "12"
    assert results["pretty"] == "12"
    assert results["full"] == "12"

    assert utils.parse.is_phone_no("911") is False
    results = utils.parse.is_phone_no("911", min_len=3)
    assert isinstance(results, dict)
    assert results["country"] == ""
    assert results["area"] == ""
    assert results["line"] == "911"
    assert results["pretty"] == "911"
    assert results["full"] == "911"

    assert utils.parse.is_phone_no("1234") is False
    results = utils.parse.is_phone_no("1234", min_len=4)
    assert isinstance(results, dict)
    assert results["country"] == ""
    assert results["area"] == ""
    assert results["line"] == "1234"
    assert results["pretty"] == "1234"
    assert results["full"] == "1234"

    assert utils.parse.is_phone_no("12345") is False
    results = utils.parse.is_phone_no("12345", min_len=5)
    assert isinstance(results, dict)
    assert results["country"] == ""
    assert results["area"] == ""
    assert results["line"] == "12345"
    assert results["pretty"] == "12345"
    assert results["full"] == "12345"

    assert utils.parse.is_phone_no("123456") is False
    results = utils.parse.is_phone_no("123456", min_len=6)
    assert isinstance(results, dict)
    assert results["country"] == ""
    assert results["area"] == ""
    assert results["line"] == "123456"
    assert results["pretty"] == "123456"
    assert results["full"] == "123456"

    # at 7 digits, the format hyphenates in the `pretty` section
    assert utils.parse.is_phone_no("1234567") is False
    results = utils.parse.is_phone_no("1234567", min_len=7)
    assert isinstance(results, dict)
    assert results["country"] == ""
    assert results["area"] == ""
    assert results["line"] == "1234567"
    assert results["pretty"] == "123-4567"
    assert results["full"] == "1234567"

    results = utils.parse.is_phone_no("1(800) 123-4567")
    assert isinstance(results, dict)
    assert results["country"] == "1"
    assert results["area"] == "800"
    assert results["line"] == "1234567"
    assert results["pretty"] == "+1 800-123-4567"
    assert results["full"] == "18001234567"


def test_parse_call_sign():
    """utils: parse_call_sign() testing"""
    # A simple single array entry (As str)
    results = utils.parse.parse_call_sign("")
    assert isinstance(results, list)
    assert len(results) == 0

    # just delimeters
    results = utils.parse.parse_call_sign(",  ,, , ,,, ")
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_call_sign(None)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_call_sign(42)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_call_sign(
        "this is not a parseable call sign at all"
    )
    assert isinstance(results, list)
    assert len(results) == 9

    results = utils.parse.parse_call_sign(
        "this is not a parseable call sign at all", store_unparseable=False
    )
    assert isinstance(results, list)
    assert len(results) == 0

    # Now test valid call signs
    results = utils.parse.parse_call_sign("0A1DEF")
    assert isinstance(results, list)
    assert len(results) == 1
    assert "0A1DEF" in results

    results = utils.parse.parse_call_sign("0A1DEF, DF1ABC")
    assert isinstance(results, list)
    assert len(results) == 2
    assert "0A1DEF" in results
    assert "DF1ABC" in results

    results = utils.parse.parse_call_sign("AA0A, A0AF-12, GARBAGE")
    assert isinstance(results, list)
    assert len(results) == 2
    assert "AA0A" in results
    assert "A0AF-12" in results


def test_parse_domain_service_targets():
    """utils: parse_domain_service_targets() testing"""

    results = utils.parse.parse_domain_service_targets("")
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_domain_service_targets("service1 service2")
    assert isinstance(results, list)
    assert len(results) == 2
    assert "service1" in results
    assert "service2" in results

    results = utils.parse.parse_domain_service_targets(
        "service1:target1,target2"
    )
    assert isinstance(results, list)
    assert len(results) == 1
    assert "service1:target1,target2" in results

    results = utils.parse.parse_domain_service_targets(
        "service1:target1,target2 service2 domain.service3"
    )
    assert isinstance(results, list)
    assert len(results) == 3
    assert "service1:target1,target2" in results
    assert "service2" in results
    assert "domain.service3" in results

    # Support a comma in the space between entries
    results = utils.parse.parse_domain_service_targets(
        "service1:target1,target2, service2 ,domain.service3,    ,  , service4"
    )
    assert isinstance(results, list)
    assert len(results) == 4
    assert "service1:target1,target2" in results
    assert "service2" in results
    assert "domain.service3" in results
    assert "service4" in results

    results = utils.parse.parse_domain_service_targets(
        "service:target1,target2"
    )
    assert isinstance(results, list)
    assert len(results) == 1
    assert "service:target1,target2" in results

    # Handle unparseables
    results = utils.parse.parse_domain_service_targets(
        ": %invalid ^entries%", store_unparseable=False
    )
    assert isinstance(results, list)
    assert len(results) == 0

    # Verify many separators complete in reasonable time.
    t0 = time.monotonic()
    utils.parse.parse_domain_service_targets("ha.smtp" + " , " * 30)
    assert time.monotonic() - t0 < 5.0


def test_parse_phone_no():
    """utils: parse_phone_no() testing"""
    # A simple single array entry (As str)
    results = utils.parse.parse_phone_no("")
    assert isinstance(results, list)
    assert len(results) == 0

    # just delimeters
    results = utils.parse.parse_phone_no(",  ,, , ,,, ")
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_phone_no(",")
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_phone_no(None)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_phone_no(42)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_phone_no(
        "this is not a parseable phoneno at all"
    )
    assert isinstance(results, list)
    assert len(results) == 8
    # Now we do it again with the store_unparsable flag set to False
    results = utils.parse.parse_phone_no(
        "this is not a parseable email at all", store_unparseable=False
    )
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_phone_no("+", store_unparseable=False)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_phone_no("(", store_unparseable=False)
    assert isinstance(results, list)
    assert len(results) == 0

    # Number is too short
    results = utils.parse.parse_phone_no("0", store_unparseable=False)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_phone_no("12", store_unparseable=False)
    assert isinstance(results, list)
    assert len(results) == 0

    # Now test valid phone numbers
    results = utils.parse.parse_phone_no("+1 (124) 245 2345")
    assert isinstance(results, list)
    assert len(results) == 1
    assert "+1 (124) 245 2345" in results

    results = utils.parse.parse_phone_no("911", store_unparseable=False)
    assert isinstance(results, list)
    assert len(results) == 1
    assert "911" in results

    results = utils.parse.parse_phone_no(
        "911, 123-123-1234", store_unparseable=False
    )
    assert isinstance(results, list)
    assert len(results) == 2
    assert "911" in results
    assert "123-123-1234" in results

    # Space variations
    results = utils.parse.parse_phone_no(" 911  , +1 (123) 123-1234")
    assert isinstance(results, list)
    assert len(results) == 2
    assert "911" in results
    assert "+1 (123) 123-1234" in results

    results = utils.parse.parse_phone_no(" 911  , + 1 ( 123 ) 123-1234")
    assert isinstance(results, list)
    assert len(results) == 2
    assert "911" in results
    assert "+ 1 ( 123 ) 123-1234" in results

    # Verify trailing-whitespace runs complete in reasonable time.
    t0 = time.monotonic()
    results = utils.parse.parse_phone_no("+12345678901" + " " * 1000)
    assert time.monotonic() - t0 < 5.0
    assert results == ["+12345678901"]


def test_parse_emails():
    """utils: parse_emails() testing"""
    # A simple single array entry (As str)
    results = utils.parse.parse_emails("")
    assert isinstance(results, list)
    assert len(results) == 0

    # just delimeters
    results = utils.parse.parse_emails(",  ,, , ,,, ")
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_emails(",")
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_emails(None)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_emails(42)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_emails("this is not a parseable email at all")
    assert isinstance(results, list)
    assert len(results) == 8
    # Now we do it again with the store_unparsable flag set to False
    results = utils.parse.parse_emails(
        "this is not a parseable email at all", store_unparseable=False
    )
    assert isinstance(results, list)
    assert len(results) == 0

    # Now test valid emails
    results = utils.parse.parse_emails("user@example.com")
    assert isinstance(results, list)
    assert len(results) == 1
    assert "user@example.com" in results

    results = utils.parse.parse_emails("a@")
    assert isinstance(results, list)
    assert len(results) == 1
    assert "a@" in results

    results = utils.parse.parse_emails("user1@example.com user2@example.com")
    assert isinstance(results, list)
    assert len(results) == 2
    assert "user1@example.com" in results
    assert "user2@example.com" in results

    # Commas and spaces found inside URLs are ignored
    emails = [
        "user1@example.com,",
        "test1@example.com,,, abcd@example.com",
        "Chuck Norris roundhouse@kick.com",
        "David Spade dspade@example.com, Yours Truly yours@truly.com",
    ]

    results = utils.parse.parse_emails(", ".join(emails))
    assert isinstance(results, list)
    assert len(results) == 6
    assert "user1@example.com" in results
    assert "test1@example.com" in results
    assert "abcd@example.com" in results
    assert "Chuck Norris roundhouse@kick.com" in results
    assert "David Spade dspade@example.com" in results
    assert "Yours Truly yours@truly.com" in results

    # Test triangle bracket parsing
    # Commas and spaces found inside URLs are ignored
    emails = [
        "User1 user1@example.com",
        "User 2 user2@example.com",
        "User Three ",
        "The Forth User: ",
        "5th User: user4@example.com",
    ]

    results = utils.parse.parse_emails(", ".join(emails))
    assert isinstance(results, list)
    assert len(results) == len(emails)
    for email in emails:
        assert email in results
        is_email = utils.parse.is_email(email)
        assert is_email
        assert is_email.get("name")

    # pass the entries in as a list
    results = utils.parse.parse_emails(emails)
    assert isinstance(results, list)
    assert len(results) == len(emails)
    for email in emails:
        assert email in results

    # Pass in some unparseables
    results = utils.parse.parse_emails("garbage")
    assert isinstance(results, list)
    assert len(results) == 1

    results = utils.parse.parse_emails("garbage", store_unparseable=False)
    assert isinstance(results, list)
    assert len(results) == 0

    # Pass in garbage
    results = utils.parse.parse_emails(object)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_emails(42)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_emails([None, object, 42])
    assert isinstance(results, list)
    assert len(results) == 0

    # Verify trailing-whitespace runs complete in reasonable time.
    t0 = time.monotonic()
    results = utils.parse.parse_emails("victim@example.com" + " " * 400)
    assert time.monotonic() - t0 < 5.0
    assert results == ["victim@example.com"]

    # Quoted display names containing commas are kept as a single token.
    results = utils.parse.parse_emails(
        '"John, Jason & Mike" '
    )
    assert results == ['"John, Jason & Mike" ']

    results = utils.parse.parse_emails(
        '"Smith, Jane" , Bob Jones '
    )
    assert len(results) == 2
    assert '"Smith, Jane" ' in results
    assert "Bob Jones " in results


def test_parse_urls():
    """utils: parse_urls() testing"""
    # A simple single array entry (As str)
    results = utils.parse.parse_urls("")
    assert isinstance(results, list)
    assert len(results) == 0

    # just delimeters
    results = utils.parse.parse_urls(",  ,, , ,,, ")
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_urls(",")
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_urls(None)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_urls(42)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_urls("this is not a parseable url at all")
    assert isinstance(results, list)
    # we still end up returning this
    assert len(results) == 8

    results = utils.parse.parse_urls(
        "this is not a parseable url at all", store_unparseable=False
    )
    assert isinstance(results, list)
    assert len(results) == 0

    # Now test valid URLs
    results = utils.parse.parse_urls("windows://")
    assert isinstance(results, list)
    assert len(results) == 1
    assert "windows://" in results

    results = utils.parse.parse_urls("windows:// gnome://")
    assert isinstance(results, list)
    assert len(results) == 2
    assert "windows://" in results
    assert "gnome://" in results

    # We don't want to parse out URLs that are part of another URL's arguments
    results = utils.parse.parse_urls("discord://host?url=https://localhost")
    assert isinstance(results, list)
    assert len(results) == 1
    assert "discord://host?url=https://localhost" in results

    # Commas and spaces found inside URLs are ignored
    urls = [
        (
            "mailgun://noreply@sandbox.mailgun.org/apikey/"
            "?to=test@example.com,test2@example.com,,"
            " abcd@example.com"
        ),
        (
            "mailgun://noreply@sandbox.another.mailgun.org/apikey/"
            "?to=hello@example.com,,hmmm@example.com,, abcd@example.com, ,"
        ),
        "windows://",
    ]

    # Since comma's and whitespace are the delimiters; they won't be
    # present at the end of the URL; so we just need to write a special
    # rstrip() as a regular exression to handle whitespace (\s) and comma
    # delimiter
    rstrip_re = re.compile(r"[\s,]+$")

    # Since a comma acts as a delimiter, we run a risk of a problem where the
    # comma exists as part of the URL and is therefore lost if it was found
    # at the end of it.

    results = utils.parse.parse_urls(", ".join(urls))
    assert isinstance(results, list)
    assert len(results) == len(urls)
    for url in urls:
        assert rstrip_re.sub("", url) in results

    # However if a comma is found at the end of a single url without a new
    # match to hit, it is saved and not lost

    # The comma at the end of the password will not be lost if we're
    # dealing with a single entry:
    url = "http://hostname?password=,abcd,"
    results = utils.parse.parse_urls(url)
    assert isinstance(results, list)
    assert len(results) == 1
    assert url in results

    # however if we have multiple entries, commas and spaces between
    # URLs will be lost, however the last URL will not lose the comma
    urls = [
        "schema1://hostname?password=,abcd,",
        "schema2://hostname?password=,abcd,",
    ]
    results = utils.parse.parse_urls(", ".join(urls))
    assert isinstance(results, list)
    assert len(results) == len(urls)

    # No match because the comma is gone in the results entry
    # schema1://hostname?password=,abcd
    assert urls[0] not in results
    assert urls[0][:-1] in results

    # However we wouldn't have lost the comma in the second one:
    # schema2://hostname?password=,abcd,
    assert urls[1] in results

    # Pass the list in (as a list); results are the same
    results = utils.parse.parse_urls(urls)
    assert isinstance(results, list)
    assert len(results) == len(urls)

    # Pass in garbage
    results = utils.parse.parse_urls(object)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_urls(42)
    assert isinstance(results, list)
    assert len(results) == 0

    results = utils.parse.parse_urls([None, object, 42])
    assert isinstance(results, list)
    assert len(results) == 0

    # Verify trailing-whitespace runs complete in reasonable time.
    t0 = time.monotonic()
    results = utils.parse.parse_urls("https://example.com" + " " * 50000)
    assert time.monotonic() - t0 < 5.0
    assert results == ["https://example.com"]


def test_parse_urls_semicolon_delimiter():
    """utils: parse_urls() accepts a semicolon between URLs"""

    # A semicolon is a delimiter just like the comma and whitespace
    for text in (
        "json://a/;json://b/",
        "json://a/ ; json://b/",
        "json://a/; json://b/",
        "json://a/,;  json://b/",
        "json://a/ ,; json://b/",
    ):
        assert utils.parse.parse_urls(text) == ["json://a/", "json://b/"]

    results = utils.parse.parse_urls("json://a/;json://b/;mailto://c/")
    assert results == ["json://a/", "json://b/", "mailto://c/"]

    # Each URL becomes its own service, the same as the comma form
    for text in (
        "json://a/;json://b/",
        "mailtos://u:p@h.com;json://b/",
    ):
        asset = Apprise()
        assert asset.add(text) is True
        assert len(asset) == 2
        comma = Apprise()
        assert comma.add(text.replace(";", ",")) is True
        assert len(asset) == len(comma)

    # A semicolon not followed by another URL is part of the URL
    for text in (
        "json://a/?x=1;2",
        "json://u:p;w@h/",
        "json://a/;b",
        "json://a/?url=x;y,z",
    ):
        assert utils.parse.parse_urls(text) == [text]

    # Even when other URLs are present
    results = utils.parse.parse_urls("json://a/?x=1;2;json://u:p;w@h/")
    assert results == ["json://a/?x=1;2", "json://u:p;w@h/"]


def test_dict_full_update():
    """utils: dict_full_update() testing"""
    dict_1 = {
        "a": 1,
        "b": 2,
        "c": 3,
        "d": {
            "z": 27,
            "y": 26,
            "x": 25,
        },
    }

    dict_2 = {
        "d": {
            "x": "updated",
            "w": 24,
        },
        "c": "updated",
        "e": 5,
    }
    utils.logic.dict_full_update(dict_1, dict_2)
    # Dictionary 2 is untouched
    assert len(dict_2) == 3
    assert dict_2["c"] == "updated"
    assert dict_2["d"]["w"] == 24
    assert dict_2["d"]["x"] == "updated"
    assert dict_2["e"] == 5

    # Dictionary 3 however has entries from Dict 2 applied
    # without disrupting entries that were not matched.
    assert len(dict_1) == 5
    assert dict_1["a"] == 1
    assert dict_1["b"] == 2
    assert dict_1["c"] == "updated"
    assert dict_1["d"]["w"] == 24
    assert dict_1["d"]["x"] == "updated"
    assert dict_1["d"]["y"] == 26
    assert dict_1["d"]["z"] == 27
    assert dict_1["e"] == 5


def test_parse_list():
    """utils: parse_list() testing"""

    # A simple single array entry (As str)
    results = utils.parse.parse_list(
        ".mkv,.avi,.divx,.xvid,.mov,.wmv,.mp4,.mpg,.mpeg,.vob,.iso"
    )

    assert results == sorted(
        [
            ".divx",
            ".iso",
            ".mkv",
            ".mov",
            ".mpg",
            ".avi",
            ".mpeg",
            ".vob",
            ".xvid",
            ".wmv",
            ".mp4",
        ]
    )

    class StrangeObject:
        def __str__(self):
            return ".avi"

    # Now 2 lists with lots of duplicates and other delimiters
    results = utils.parse.parse_list(
        ".mkv,.avi,.divx,.xvid,.mov,.wmv,.mp4,.mpg .mpeg,.vob,,; ;",
        (".mkv,.avi,.divx,.xvid,.mov    ", "    .wmv,.mp4;.mpg,.mpeg,"),
        ".vob,.iso",
        [
            ".vob",
            [
                ".vob",
                ".mkv",
                StrangeObject(),
            ],
        ],
        StrangeObject(),
    )

    assert results == sorted(
        [
            ".divx",
            ".iso",
            ".mkv",
            ".mov",
            ".mpg",
            ".avi",
            ".mpeg",
            ".vob",
            ".xvid",
            ".wmv",
            ".mp4",
        ]
    )

    # Garbage in is removed
    assert utils.parse.parse_list(object(), 42, None) == []

    # Now a list with extras we want to add as strings
    # empty entries are removed
    results = utils.parse.parse_list(
        [
            ".divx",
            ".iso",
            ".mkv",
            ".mov",
            "",
            "  ",
            ".avi",
            ".mpeg",
            ".vob",
            ".xvid",
            ".mp4",
        ],
        ".mov,.wmv,.mp4,.mpg",
    )

    assert results == sorted(
        [
            ".divx",
            ".wmv",
            ".iso",
            ".mkv",
            ".mov",
            ".mpg",
            ".avi",
            ".vob",
            ".xvid",
            ".mpeg",
            ".mp4",
        ]
    )


def test_import_module(tmpdir):
    """utils: import_module testing"""
    # Prepare ourselves a file to work with
    bad_file_base = tmpdir.mkdir("a")
    bad_file = bad_file_base.join("README.md")
    bad_file.write(
        cleandoc("""
    I'm a README file, not a Python one.

    I can't be loaded
    """)
    )
    assert utils.module.import_module(str(bad_file), "invalidfile1") is None
    assert (
        utils.module.import_module(str(bad_file_base), "invalidfile2") is None
    )


def test_module_detection(tmpdir):
    """utils: test_module_detection() testing"""

    # Clear our working variables so they don't obstruct with the tests here
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()

    # Test case where we load invalid data
    N_MGR.module_detection(None)

    # Invalid data does not load anything
    assert len(N_MGR._paths_previously_scanned) == 0
    assert len(N_MGR._custom_module_map) == 0

    # Prepare ourselves a file to work with
    notify_hook_a_base = tmpdir.mkdir("a")
    notify_hook_a = notify_hook_a_base.join("hook.py")
    notify_hook_a.write(
        cleandoc("""
    from apprise.decorators import notify

    @notify(on="clihook")
    def mywrapper(body, title, notify_type, *args, **kwargs):
        pass
    """)
    )

    notify_ignore = notify_hook_a_base.join("README.md")
    notify_ignore.write(
        cleandoc("""
    We're not a .py file, so this file gets gracefully skipped
    """)
    )

    # Not previously loaded
    assert "clihook" not in N_MGR

    # load entry by string
    N_MGR.module_detection(str(notify_hook_a))
    N_MGR.module_detection(str(notify_ignore))
    N_MGR.module_detection(str(notify_hook_a_base))

    assert len(N_MGR._paths_previously_scanned) == 3
    assert len(N_MGR._custom_module_map) == 1

    # Now loaded
    assert "clihook" in N_MGR

    # load entry by array
    N_MGR.module_detection([str(notify_hook_a)])

    # No changes to our path
    assert len(N_MGR._paths_previously_scanned) == 3
    assert len(N_MGR._custom_module_map) == 1

    # Reset our variables for the next test
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()

    # Hidden files are ignored
    notify_hook_b_base = tmpdir.mkdir("b")
    notify_hook_b = notify_hook_b_base.join(".hook.py")
    notify_hook_b.write(
        cleandoc("""
    from apprise.decorators import notify

    # this is in a hidden file so it will not load
    @notify(on="hidden")
    def mywrapper(body, title, notify_type, *args, **kwargs):
        pass
    """)
    )

    assert "hidden" not in N_MGR

    N_MGR.module_detection([str(notify_hook_b)])

    # Verify that it did not load
    assert "hidden" not in N_MGR

    # Path was scanned; nothing loaded
    assert len(N_MGR._paths_previously_scanned) == 1
    assert len(N_MGR._custom_module_map) == 0

    # Reset our variables for the next test
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()

    # modules with no hooks found are ignored
    notify_hook_c_base = tmpdir.mkdir("c")
    notify_hook_c = notify_hook_c_base.join("empty.py")
    notify_hook_c.write("")

    N_MGR.module_detection([str(notify_hook_c)])

    # File was found, no custom modules
    assert len(N_MGR._paths_previously_scanned) == 1
    assert len(N_MGR._custom_module_map) == 0

    # A new path scanned
    N_MGR.module_detection([str(notify_hook_c_base)])
    assert len(N_MGR._paths_previously_scanned) == 2
    assert len(N_MGR._custom_module_map) == 0

    def create_hook(tdir, cache=True, on="valid1"):
        """Just a temporary hook creation tool for writing a working notify
        hook."""
        tdir.write(
            cleandoc(f"""
        from apprise.decorators import notify

        # this is a good hook but burried in hidden directory which won't
        # be accessed unless the file is pointed to via absolute path
        @notify(on="{on}")
        def mywrapper(body, title, notify_type, *args, **kwargs):
            pass
        """)
        )

        N_MGR.module_detection([str(tdir)], cache=cache)

    create_hook(notify_hook_c, on="valid1")
    assert "valid1" not in N_MGR

    # Even if we correct our empty file; the fact the directory has been
    # scanned and failed to load (same with file), it won't be loaded
    # a second time. This is intentional since module_detection() get's
    # called for every AppriseAsset() object creation.  This prevents us
    # from reloading conent over and over again wasting resources
    assert "valid1" not in N_MGR
    N_MGR.module_detection([str(notify_hook_c)])
    assert len(N_MGR._paths_previously_scanned) == 2
    assert len(N_MGR._custom_module_map) == 0

    # Even by absolute path...
    N_MGR.module_detection([str(notify_hook_c)])
    assert "valid1" not in N_MGR
    assert len(N_MGR._paths_previously_scanned) == 2
    assert len(N_MGR._custom_module_map) == 0

    # However we can bypass the cache if we really want to
    N_MGR.module_detection([str(notify_hook_c_base)], cache=False)
    assert "valid1" in N_MGR
    assert len(N_MGR._paths_previously_scanned) == 2
    assert len(N_MGR._custom_module_map) == 1

    # Bypassing it twice causes the module to load twice (not very efficient)
    # However we can bypass the cache if we really want to
    N_MGR.module_detection([str(notify_hook_c_base)], cache=False)
    assert "valid1" in N_MGR
    assert len(N_MGR._paths_previously_scanned) == 2
    assert len(N_MGR._custom_module_map) == 1

    # If you update the module (corrupting it in the process and reload)
    notify_hook_c.write(
        cleandoc("""
    raise ValueError
    """)
    )

    # Force no cache to cause the file to be replaced
    N_MGR.module_detection([str(notify_hook_c_base)], cache=False)

    # Our valid entry is no longer loaded
    assert "valid1" not in N_MGR

    # No change to scanned paths
    assert len(N_MGR._paths_previously_scanned) == 2
    # The previously loaded module is now gone
    assert len(N_MGR._custom_module_map) == 0

    # Reload our valid1 entry
    create_hook(notify_hook_c, on="valid1", cache=False)
    assert "valid1" in N_MGR
    assert len(N_MGR._paths_previously_scanned) == 2
    assert len(N_MGR._custom_module_map) == 1

    # Prepare an empty file
    notify_hook_c.write("")
    N_MGR.module_detection([str(notify_hook_c_base)], cache=False)

    # Our valid entry is no longer loaded
    assert "valid1" not in N_MGR
    assert len(N_MGR._paths_previously_scanned) == 2
    assert len(N_MGR._custom_module_map) == 0

    # Now reload our module again (this time rather then an exception, the
    # module is read back and swaps `valid1` for `valid2`
    create_hook(notify_hook_c, on="valid1", cache=False)
    assert "valid1" in N_MGR
    assert "valid2" not in N_MGR
    assert len(N_MGR._paths_previously_scanned) == 2
    assert len(N_MGR._custom_module_map) == 1

    create_hook(notify_hook_c, on="valid2", cache=False)
    assert "valid1" not in N_MGR
    assert "valid2" in N_MGR
    assert len(N_MGR._paths_previously_scanned) == 2
    assert len(N_MGR._custom_module_map) == 1

    # Reset our variables for the next test
    create_hook(notify_hook_c, on="valid1", cache=False)
    del N_MGR["valid1"]
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()

    notify_hook_d = notify_hook_c_base.join(".ignore.py")
    notify_hook_d.write("")
    notify_hook_e_base = notify_hook_c_base.mkdir(".ignore")
    notify_hook_e = notify_hook_e_base.join("__init__.py")
    notify_hook_e.write(
        cleandoc("""
    from apprise.decorators import notify

    # this is a good hook but burried in hidden directory which won't
    # be accessed unless the file is pointed to via absolute path
    @notify(on="valid2")
    def mywrapper(body, title, notify_type, *args, **kwargs):
        pass
    """)
    )

    # Try to load our base directory again; this time we search by the
    # directory; the only edge case we're testing here is it will not
    # even look at the .ignore.py file found since it is invalid
    N_MGR.module_detection([str(notify_hook_c_base)])
    assert "valid1" in N_MGR
    assert len(N_MGR._paths_previously_scanned) == 2
    assert len(N_MGR._custom_module_map) == 1

    # Reset our variables for the next test
    del N_MGR._schema_map["valid1"]
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()

    # Try to load our base directory again
    N_MGR.module_detection([str(notify_hook_c)])
    assert "valid1" in N_MGR

    # Hidden directories are not scanned
    assert "valid2" not in N_MGR

    assert len(N_MGR._paths_previously_scanned) == 1
    assert str(notify_hook_c) in N_MGR._paths_previously_scanned
    assert len(N_MGR._custom_module_map) == 1

    # However a direct reference to the hidden directory is okay
    N_MGR.module_detection([str(notify_hook_e_base)])

    # We loaded our module
    assert "valid2" in N_MGR
    assert len(N_MGR._paths_previously_scanned) == 3
    assert str(notify_hook_c) in N_MGR._paths_previously_scanned
    assert str(notify_hook_e) in N_MGR._paths_previously_scanned
    assert str(notify_hook_e_base) in N_MGR._paths_previously_scanned
    assert len(N_MGR._custom_module_map) == 2

    # Reset our variables for the next test
    del N_MGR._schema_map["valid1"]
    del N_MGR._schema_map["valid2"]
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()

    # Load our file directly
    assert "valid2" not in N_MGR
    N_MGR.module_detection([str(notify_hook_e)])

    # Now we have it loaded as expected
    assert "valid2" in N_MGR
    assert len(N_MGR._paths_previously_scanned) == 1
    assert str(notify_hook_e) in N_MGR._paths_previously_scanned
    assert len(N_MGR._custom_module_map) == 1

    # however if we try to load the base directory where the __init__.py
    # was already loaded from, it will not change anything
    N_MGR.module_detection([str(notify_hook_e_base)])
    assert "valid2" in N_MGR
    assert len(N_MGR._paths_previously_scanned) == 2
    assert str(notify_hook_e) in N_MGR._paths_previously_scanned
    assert str(notify_hook_e_base) in N_MGR._paths_previously_scanned
    assert len(N_MGR._custom_module_map) == 1

    # Tidy up for the next test
    del N_MGR._schema_map["valid2"]
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()

    assert "valid1" not in N_MGR
    assert "valid2" not in N_MGR
    assert "valid3" not in N_MGR
    notify_hook_f_base = tmpdir.mkdir("f")
    notify_hook_f = notify_hook_f_base.join("invalid.py")
    notify_hook_f.write(
        cleandoc("""
    from apprise.decorators import notify

    # A very invalid hook type... on should not be None
    @notify(on=None)
    def mywrapper(body, title, notify_type, *args, **kwargs):
        pass

    # An invalid name
    @notify(on='valid1', name=None)
    def mywrapper(body, title, notify_type, *args, **kwargs):
        pass

    # Another invalid name (so it's ignored)
    @notify(on='valid2', name=object)
    def mywrapper(body, title, notify_type, *args, **kwargs):
        pass

    # Simply put... the name has to be a string to be referenced
    # however this will still be loaded
    @notify(on='valid3', name=4)
    def mywrapper(body, title, notify_type, *args, **kwargs):
        pass

    """)
    )

    N_MGR.module_detection([str(notify_hook_f)])

    assert len(N_MGR._paths_previously_scanned) == 1
    assert len(N_MGR._custom_module_map) == 1
    assert "valid1" in N_MGR
    assert "valid2" in N_MGR
    assert "valid3" in N_MGR

    # Reset our variables for the next test
    del N_MGR._schema_map["valid1"]
    del N_MGR._schema_map["valid2"]
    del N_MGR._schema_map["valid3"]
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()

    # Now test the handling of just bad data entirely
    notify_hook_g_base = tmpdir.mkdir("g")
    notify_hook_g = notify_hook_g_base.join("binary.py")
    with open(str(notify_hook_g), "wb") as fout:
        fout.write(os.urandom(512))

    N_MGR.module_detection([str(notify_hook_g)])
    assert len(N_MGR._paths_previously_scanned) == 1
    assert len(N_MGR._custom_module_map) == 0

    # Reset our variables before we leave
    N_MGR._paths_previously_scanned.clear()
    N_MGR._custom_module_map.clear()


def test_exclusive_match():
    """utils: is_exclusive_match() testing"""

    # No Logic always returns True if there is also no data
    assert utils.logic.is_exclusive_match(data=None, logic=None) is True
    assert utils.logic.is_exclusive_match(data=None, logic=set()) is True
    assert utils.logic.is_exclusive_match(data="", logic=set()) is True
    assert utils.logic.is_exclusive_match(data="", logic=set()) is True

    # however, once data is introduced, True is no longer returned
    # if no logic has been specified
    assert utils.logic.is_exclusive_match(data="check", logic=set()) is False
    assert (
        utils.logic.is_exclusive_match(data=["check", "checkb"], logic=set())
        is False
    )

    # String delimters are stripped out so that a list can be formed
    # the below is just an empty token list
    assert utils.logic.is_exclusive_match(data=set(), logic=",;   ,") is True

    # garbage logic is never an exclusive match
    assert utils.logic.is_exclusive_match(data=set(), logic=object()) is False
    assert (
        utils.logic.is_exclusive_match(
            data=set(),
            logic=[
                object(),
            ],
        )
        is False
    )

    #
    # Test with logic:
    #
    data = {"abc"}

    # def in data
    assert utils.logic.is_exclusive_match(logic="def", data=data) is False
    # def in data
    assert (
        utils.logic.is_exclusive_match(
            logic=[
                "def",
            ],
            data=data,
        )
        is False
    )
    # def in data
    assert utils.logic.is_exclusive_match(logic=("def",), data=data) is False
    # def in data
    assert (
        utils.logic.is_exclusive_match(
            logic={
                "def",
            },
            data=data,
        )
        is False
    )
    # abc in data
    assert (
        utils.logic.is_exclusive_match(
            logic=[
                "abc",
            ],
            data=data,
        )
        is True
    )
    # abc in data
    assert utils.logic.is_exclusive_match(logic=("abc",), data=data) is True
    # abc in data
    assert (
        utils.logic.is_exclusive_match(
            logic={
                "abc",
            },
            data=data,
        )
        is True
    )
    # abc or def in data
    assert utils.logic.is_exclusive_match(logic="abc, def", data=data) is True

    #
    # Update our data set so we can do more advance checks
    #
    data = {"abc", "def", "efg", "xyz"}

    # match_all matches everything
    assert utils.logic.is_exclusive_match(logic="all", data=data) is True
    assert utils.logic.is_exclusive_match(logic=["all"], data=data) is True

    # def and abc in data
    assert (
        utils.logic.is_exclusive_match(logic=[("abc", "def")], data=data)
        is True
    )

    # cba and abc in data
    assert (
        utils.logic.is_exclusive_match(logic=[("cba", "abc")], data=data)
        is False
    )

    # www or zzz or abc and xyz
    assert (
        utils.logic.is_exclusive_match(
            logic=["www", "zzz", ("abc", "xyz")], data=data
        )
        is True
    )
    # www or zzz or abc and xyz (strings are valid too)
    assert (
        utils.logic.is_exclusive_match(
            logic=["www", "zzz", "abc, xyz"], data=data
        )
        is True
    )

    # www or zzz or abc and jjj
    assert (
        utils.logic.is_exclusive_match(
            logic=["www", "zzz", ("abc", "jjj")], data=data
        )
        is False
    )

    #
    # Empty data set
    #
    data = set()
    assert utils.logic.is_exclusive_match(logic=["www"], data=data) is False
    assert utils.logic.is_exclusive_match(logic="all", data=data) is True

    #
    # Update our data set so we can do more advance checks
    #
    data = {"always", "entry1"}
    # We'll always match on the with keyword always
    assert utils.logic.is_exclusive_match(logic="always", data=data) is True
    assert utils.logic.is_exclusive_match(logic="garbage", data=data) is True
    # However we will not match if we turn this feature off
    assert (
        utils.logic.is_exclusive_match(
            logic="garbage", data=data, match_always=False
        )
        is False
    )

    # Change default value from 'all' to 'match_me'. Logic matches
    # so we pass
    assert (
        utils.logic.is_exclusive_match(
            logic="match_me", data=data, match_all="match_me"
        )
        is True
    )


def test_exclusive_match_priority_tokens():
    """utils: is_exclusive_match() with priority-prefixed filter tokens"""

    # AppriseTag.__hash__ is name-only, so a set holds at most one entry per
    # tag name -- matching real usage where each URL has one priority.
    tag_ep3 = AppriseTag("endpoint", priority=3, has_priority=True)
    tag_other = AppriseTag("other", priority=1, has_priority=True)

    data = {tag_ep3, tag_other}

    # Exact priority match
    assert (
        utils.logic.is_exclusive_match(logic="3:endpoint", data=data) is True
    )

    # Priority mismatch -- "2:endpoint" does not match priority-3 entry
    assert (
        utils.logic.is_exclusive_match(logic="2:endpoint", data=data) is False
    )

    # Name-only filter matches via O(1) hash path regardless of stored priority
    assert utils.logic.is_exclusive_match(logic="endpoint", data=data) is True

    # Absent tag returns False
    assert utils.logic.is_exclusive_match(logic="absent", data=data) is False

    # AND group: both tokens present with correct priorities
    assert (
        utils.logic.is_exclusive_match(
            logic=[("3:endpoint", "1:other")], data=data
        )
        is True
    )

    # AND group: one priority mismatch fails the whole group
    assert (
        utils.logic.is_exclusive_match(
            logic=[("2:endpoint", "1:other")], data=data
        )
        is False
    )

    # OR: failing AND group rescued by a matching single token
    assert (
        utils.logic.is_exclusive_match(
            logic=[("2:endpoint", "1:other"), "3:endpoint"], data=data
        )
        is True
    )

    # OR: no term matches -- all fail
    assert (
        utils.logic.is_exclusive_match(
            logic=[("2:endpoint", "1:other"), "99:endpoint"], data=data
        )
        is False
    )

    # Backward compat: plain strings in data matched by a priority-prefixed
    # filter token (the for-loop fallback in _token_matches_data)
    str_data = {"endpoint", "other"}
    assert (
        utils.logic.is_exclusive_match(logic="7:endpoint", data=str_data)
        is True
    )
    assert (
        utils.logic.is_exclusive_match(logic="7:absent", data=str_data)
        is False
    )

    # match_all keyword short-circuits even with priority data
    assert utils.logic.is_exclusive_match(logic="all", data=data) is True


def test_apprise_validate_regex():
    """
    API: Apprise() Validate Regex tests

    """
    assert utils.parse.validate_regex(None) is None
    assert utils.parse.validate_regex(object) is None
    assert utils.parse.validate_regex(42) is None
    assert utils.parse.validate_regex("") is None
    assert utils.parse.validate_regex("  ") is None
    assert utils.parse.validate_regex("abc") == "abc"

    # value is a keyword that is extracted (if found)
    assert (
        utils.parse.validate_regex(
            "- abcd -", r"-(?P[^-]+)-", fmt="{value}"
        )
        == "abcd"
    )
    assert (
        utils.parse.validate_regex(
            "- abcd -", r"-(?P[^-]+)-", strip=False, fmt="{value}"
        )
        == " abcd "
    )

    # String flags supported in addition to numeric
    assert (
        utils.parse.validate_regex(
            "- abcd -", r"-(?P[^-]+)-", "i", fmt="{value}"
        )
        == "abcd"
    )
    assert (
        utils.parse.validate_regex(
            "- abcd -", r"-(?P[^-]+)-", re.I, fmt="{value}"
        )
        == "abcd"
    )

    # Test multiple flag settings
    assert (
        utils.parse.validate_regex(
            "- abcd -", r"-(?P[^-]+)-", "isax", fmt="{value}"
        )
        == "abcd"
    )

    # Invalid flags are just ignored. The below fails to match
    # because the default value of 'i' is over-ridden by what is
    # identfied below, and no flag is set at the end of the day
    assert (
        utils.parse.validate_regex(
            "- abcd -", r"-(?P[ABCD]+)-", "-%2gb", fmt="{value}"
        )
        is None
    )
    assert (
        utils.parse.validate_regex(
            "- abcd -", r"-(?P[ABCD]+)-", "", fmt="{value}"
        )
        is None
    )
    assert (
        utils.parse.validate_regex(
            "- abcd -", r"-(?P[ABCD]+)-", None, fmt="{value}"
        )
        is None
    )


def test_apply_templating():
    """utils: apply_template() testing"""

    template = "Hello {{fname}}, How are you {{whence}}?"

    result = utils.templates.apply_template(
        template, **{"fname": "Chris", "whence": "this morning"}
    )
    assert isinstance(result, str)
    assert result == "Hello Chris, How are you this morning?"

    # In this example 'whence' isn't provided, so it isn't swapped
    result = utils.templates.apply_template(template, **{"fname": "Chris"})
    assert isinstance(result, str)
    assert result == "Hello Chris, How are you {{whence}}?"

    # white space won't cause any ill affects:
    template = "Hello {{ fname }}, How are you {{   whence}}?"
    result = utils.templates.apply_template(
        template, **{"fname": "Chris", "whence": "this morning"}
    )
    assert isinstance(result, str)
    assert result == "Hello Chris, How are you this morning?"

    # No arguments won't cause any problems
    template = "Hello {{fname}}, How are you {{whence}}?"
    result = utils.templates.apply_template(template)
    assert isinstance(result, str)
    assert result == template

    # Wrong elements are simply ignored
    result = utils.templates.apply_template(
        template, **{"fname": "l2g", "whence": "this evening", "ignore": "me"}
    )
    assert isinstance(result, str)
    assert result == "Hello l2g, How are you this evening?"

    # Empty template makes things easy
    result = utils.templates.apply_template(
        "", **{"fname": "l2g", "whence": "this evening"}
    )
    assert isinstance(result, str)
    assert result == ""

    # Regular expressions are safely escapped and act as normal
    # tokens:
    template = "Hello {{.*}}, How are you {{[A-Z0-9]+}}?"
    result = utils.templates.apply_template(
        template, **{".*": "l2g", "[A-Z0-9]+": "this afternoon"}
    )
    assert result == "Hello l2g, How are you this afternoon?"

    # JSON is handled too such as escaping quotes
    template = '{value: "{{ value }}"}'
    result = utils.templates.apply_template(
        template,
        app_mode=utils.templates.TemplateType.JSON,
        **{"value": '"quotes are escaped"'},
    )
    assert result == '{value: "\\"quotes are escaped\\""}'


def test_cwe312_word():
    """utils: cwe312_word() testing"""
    assert utils.cwe312.cwe312_word(None) is None
    assert utils.cwe312.cwe312_word(42) == 42
    assert utils.cwe312.cwe312_word("") == ""
    assert utils.cwe312.cwe312_word(" ") == " "
    assert utils.cwe312.cwe312_word("!") == "!"

    assert utils.cwe312.cwe312_word("a") == "a"
    assert utils.cwe312.cwe312_word("ab") == "ab"
    assert utils.cwe312.cwe312_word("abc") == "abc"
    assert utils.cwe312.cwe312_word("abcd") == "abcd"
    assert utils.cwe312.cwe312_word("abcd", force=True) == "a...d"

    assert utils.cwe312.cwe312_word("abc--d") == "abc--d"
    assert utils.cwe312.cwe312_word("a-domain.ca") == "a...a"

    # Variances to still catch domain
    assert (
        utils.cwe312.cwe312_word("a-domain.ca", advanced=False)
        == "a-domain.ca"
    )
    assert (
        utils.cwe312.cwe312_word("a-domain.ca", threshold=6) == "a-domain.ca"
    )


def test_cwe312_url():
    """utils: cwe312_url() testing"""
    assert utils.cwe312.cwe312_url(None) is None
    assert utils.cwe312.cwe312_url(42) == 42
    assert utils.cwe312.cwe312_url("http://") == "http://"
    assert utils.cwe312.cwe312_url("discord://") == "discord://"
    assert utils.cwe312.cwe312_url("path") == "http://path"
    assert utils.cwe312.cwe312_url("path/") == "http://path/"

    # Now test http:// private data
    assert (
        utils.cwe312.cwe312_url("http://user:pass123@localhost")
        == "http://user:p...3@localhost"
    )
    assert (
        utils.cwe312.cwe312_url("http://user@localhost")
        == "http://user@localhost"
    )
    assert (
        utils.cwe312.cwe312_url("http://user@localhost?password=abc123")
        == "http://user@localhost?password=a...3"
    )
    assert (
        utils.cwe312.cwe312_url("http://user@localhost?secret=secret-.12345")
        == "http://user@localhost?secret=s...5"
    )

    assert (
        utils.cwe312.cwe312_url(
            "slack://mybot@xoxb-43598234231-3248932482278"
            "-BZK5Wj15B9mPh1RkShJoCZ44"
            "/lead2gold@gmail.com"
        )
        == "slack://mybot@x...4/l...m"
    )
    assert (
        utils.cwe312.cwe312_url(
            "slack://test@B4QP3WWB4/J3QWT41JM/XIl2ffpqXkzkwMXrJdevi7W3/#random"
        )
        == "slack://test@B...4/J...M/X...3/"
    )


def test_cwe312_loggable():
    """utils: cwe312_loggable() testing"""

    # A url carrying credentials is masked
    assert (
        utils.cwe312.cwe312_loggable("http://user:pass123@localhost")
        == "http://user:p...3@localhost"
    )
    assert (
        utils.cwe312.cwe312_loggable(
            "https://user:pass123@example.com/private_key.pem"
        )
        == "https://user:p...3@example.com/p...m"
    )

    # Masking can be switched off, which is what secure_logging=False does
    assert (
        utils.cwe312.cwe312_loggable(
            "http://user:pass123@localhost", secure=False
        )
        == "http://user:pass123@localhost"
    )

    # Keep local paths readable so failures identify the affected file.
    for path in (
        "/etc/apprise/private_key.pem",
        "~/keys/private_key.pem",
        "./subscriptions.json",
        "subscriptions.json",
        "private_key.pem",
        "C:\\keys\\private.pem",
    ):
        assert utils.cwe312.cwe312_loggable(path) == path
        assert utils.cwe312.cwe312_loggable(path, secure=False) == path

    # Nothing to print reads as a placeholder rather than 'None'
    assert utils.cwe312.cwe312_loggable(None) == "(none)"
    assert utils.cwe312.cwe312_loggable("") == "(none)"
    assert utils.cwe312.cwe312_loggable(0) == "(none)"
    assert utils.cwe312.cwe312_loggable(None, secure=False) == "(none)"

    # Anything that is not a string is turned into one rather than raising
    assert utils.cwe312.cwe312_loggable(42) == "42"
    assert utils.cwe312.cwe312_loggable(4.2) == "4.2"

    # Dictionaries remain available for administrator-facing diagnostics.
    details = {"password": "pass123"}
    assert utils.cwe312.cwe312_loggable(details) == str(details)
    assert utils.cwe312.cwe312_loggable(details, secure=False) == str(details)

    # Mask by default when the caller omits the setting.
    url = "http://user:pass123@localhost"
    assert utils.cwe312.cwe312_loggable(url) != url

    # Malformed URLs fail closed instead of returning credentials unchanged.
    for url in (
        "http://user:pass123@[",
        "http://user:pass123@example.com:bad",
        "http://user:pass123@example.com\nforged",
    ):
        result = utils.cwe312.cwe312_loggable(url)
        assert "pass123" not in result
        assert "\n" not in result

    assert (
        utils.cwe312.cwe312_loggable("http://user:pass123@[") == "http://..."
    )
    assert (
        utils.cwe312.cwe312_loggable("http://user:pass123@example.com:bad")
        == "http://..."
    )


def test_base64_encode_decode():
    """Utils:Base64:URLEncode & Decode."""
    assert utils.base64.base64_urlencode(None) is None
    assert utils.base64.base64_urlencode(42) is None
    assert utils.base64.base64_urlencode(object) is None
    assert utils.base64.base64_urlencode({}) is None
    assert utils.base64.base64_urlencode("") is None
    assert utils.base64.base64_urlencode("abc") is None
    assert utils.base64.base64_urlencode(b"") == ""
    assert utils.base64.base64_urlencode(b"abc") == "YWJj"

    assert utils.base64.base64_urldecode(None) is None
    assert utils.base64.base64_urldecode(42) is None
    assert utils.base64.base64_urldecode(object) is None
    assert utils.base64.base64_urldecode({}) is None

    assert utils.base64.base64_urldecode("abc") == b"i\xb7"
    assert utils.base64.base64_urldecode("") == b""
    assert utils.base64.base64_urldecode("YWJj") == b"abc"


def test_dict_base64_codec(tmpdir):
    """Test encoding/decoding of base64 content."""
    original = {
        "int": 1,
        "float": 2.3,
    }

    encoded, needs_decoding = utils.base64.encode_b64_dict(original)
    assert encoded == {"int": "b64:MQ==", "float": "b64:Mi4z"}
    assert needs_decoding is True
    decoded = utils.base64.decode_b64_dict(encoded)
    assert decoded == original

    with mock.patch("json.dumps", side_effect=TypeError()):
        encoded, needs_decoding = utils.base64.encode_b64_dict(original)
        # we failed
        assert needs_decoding is False
        assert encoded == {
            "int": "1",
            "float": "2.3",
        }


def test_dir_size(tmpdir):
    """Test dir size tool."""

    # Nothing to find/see
    size, errors = utils.disk.dir_size(str(tmpdir))
    assert size == 0
    assert len(errors) == 0

    # Write a file in our root directory
    tmpdir.join("root.psdata").write("0" * 1024 * 1024)

    # Prepare some more directories
    namespace_1 = tmpdir.mkdir("abcdefg")
    namespace_2 = tmpdir.mkdir("defghij")
    namespace_2.join("cache.psdata").write("0" * 1024 * 1024)
    size, errors = utils.disk.dir_size(str(tmpdir))
    assert size == 1024 * 1024 * 2
    assert len(errors) == 0

    # Write another file
    namespace_1.join("cache.psdata").write("0" * 1024 * 1024)
    size, errors = utils.disk.dir_size(str(tmpdir))
    assert size == 1024 * 1024 * 3
    assert len(errors) == 0

    size, errors = utils.disk.dir_size(str(namespace_1))
    assert size == 1024 * 1024
    assert len(errors) == 0

    # Create a directory insde one of our namespaces
    subspace_1 = namespace_1.mkdir("zyx")
    size, errors = utils.disk.dir_size(str(namespace_1))
    assert size == 1024 * 1024

    subspace_1.join("cache.psdata").write("0" * 1024 * 1024)
    size, errors = utils.disk.dir_size(str(tmpdir))
    assert size == 1024 * 1024 * 4
    assert len(errors) == 0

    # Recursion limit reduced... no change at 2 as we can go 2
    # diretories deep no problem
    size, errors = utils.disk.dir_size(str(tmpdir), max_depth=2)
    assert size == 1024 * 1024 * 4
    assert len(errors) == 0

    size, errors = utils.disk.dir_size(str(tmpdir), max_depth=1)
    assert size == 1024 * 1024 * 3
    # we can't get into our subspace_1
    assert len(errors) == 1
    assert str(subspace_1) in errors

    size, errors = utils.disk.dir_size(str(tmpdir), max_depth=0)
    assert size == 1024 * 1024
    # we can't get into our namespace directories
    assert len(errors) == 2
    assert str(namespace_1) in errors
    assert str(namespace_2) in errors

    # Let's cause problems now and test the output
    size, errors = utils.disk.dir_size("invalid-directory", missing_okay=True)
    assert size == 0
    assert len(errors) == 0

    size, errors = utils.disk.dir_size("invalid-directory", missing_okay=False)
    assert size == 0
    assert len(errors) == 1
    assert "invalid-directory" in errors

    with mock.patch("os.scandir", side_effect=OSError()):
        size, errors = utils.disk.dir_size(str(tmpdir), missing_okay=True)
        assert size == 0
        assert len(errors) == 1
        assert str(tmpdir) in errors

    with mock.patch("os.scandir") as mock_scandir:
        mock_entry = mock.MagicMock()
        mock_entry.is_file.side_effect = OSError()
        mock_entry.path = "/test/path"
        # Mock the scandir return value to yield the mock entry
        mock_scandir.return_value.__enter__.return_value = [mock_entry]

        size, errors = utils.disk.dir_size(str(tmpdir))
        assert size == 0
        assert len(errors) == 1
        assert mock_entry.path in errors

    with mock.patch("os.scandir") as mock_scandir:
        mock_entry = mock.MagicMock()
        mock_entry.is_file.return_value = False
        mock_entry.is_dir.side_effect = OSError()
        mock_entry.path = "/test/path"
        # Mock the scandir return value to yield the mock entry
        mock_scandir.return_value.__enter__.return_value = [mock_entry]
        size, errors = utils.disk.dir_size(str(tmpdir))
        assert len(errors) == 1
        assert mock_entry.path in errors

    with mock.patch("os.scandir") as mock_scandir:
        mock_entry = mock.MagicMock()
        mock_entry.is_file.return_value = False
        mock_entry.is_dir.return_value = False
        # Mock the scandir return value to yield the mock entry
        mock_scandir.return_value.__enter__.return_value = [mock_entry]
        size, errors = utils.disk.dir_size(str(tmpdir))
        assert size == 0
        assert len(errors) == 0

    with mock.patch("os.scandir") as mock_scandir:
        mock_entry = mock.MagicMock()
        mock_entry.is_file.side_effect = FileNotFoundError()
        mock_entry.path = "/test/path"
        # Mock the scandir return value to yield the mock entry
        mock_scandir.return_value.__enter__.return_value = [mock_entry]

        size, errors = utils.disk.dir_size(str(tmpdir))
        assert size == 0
        # No file isn't a problem, we're calculating disksize anyway,
        # one less thing to calculate
        assert len(errors) == 0


def test_bytes_to_str():
    """Test Bytes to String representation."""
    # Garbage Entry
    assert utils.disk.bytes_to_str(None) is None
    assert utils.disk.bytes_to_str("") is None
    assert utils.disk.bytes_to_str("GARBAGE") is None

    # Good Entries
    assert utils.disk.bytes_to_str(0) == "0.00B"
    assert utils.disk.bytes_to_str(1) == "1.00B"
    assert utils.disk.bytes_to_str(1.1) == "1.10B"
    assert utils.disk.bytes_to_str(1024) == "1.00KB"
    assert utils.disk.bytes_to_str(1024 * 1024) == "1.00MB"
    assert utils.disk.bytes_to_str(1024 * 1024 * 1024) == "1.00GB"
    assert utils.disk.bytes_to_str(1024 * 1024 * 1024 * 1024) == "1.00TB"

    # Support strings too
    assert utils.disk.bytes_to_str("0") == "0.00B"
    assert utils.disk.bytes_to_str("1024") == "1.00KB"


def test_time_zoneinfo():
    """utils: zoneinfo() testing"""

    # Some valid strings
    assert isinstance(utils.time.zoneinfo("UTC"), tzinfo)
    assert isinstance(utils.time.zoneinfo("z"), tzinfo)
    assert isinstance(utils.time.zoneinfo("gmt"), tzinfo)
    assert isinstance(utils.time.zoneinfo("utc"), tzinfo)
    assert isinstance(utils.time.zoneinfo("Toronto"), tzinfo)
    assert isinstance(utils.time.zoneinfo("America/Toronto"), tzinfo)
    assert isinstance(utils.time.zoneinfo("america/toronto"), tzinfo)

    # Edge Case with time also supported:
    tz = utils.time.zoneinfo("America/Argentina/Cordoba")
    isinstance(tz, tzinfo)
    assert isinstance(utils.time.zoneinfo("Argentina/Cordoba"), tzinfo)
    assert utils.time.zoneinfo("Argentina/Cordoba").key == tz.key
    # "America/Cordoba" has been obsoleted by IANA in facor of
    #  "America/Argentina/Cordoba", however the IANA database
    #  instance used is system-dependent, so these tests have
    #  different results depending on the system running them
    if utils.time.zoneinfo("Cordoba") is not None:
        # the system has the obsolete "America/Cordoba" entry
        assert isinstance(utils.time.zoneinfo("Cordoba"), tzinfo)
        assert utils.time.zoneinfo("Cordoba").key == "America/Cordoba"
    else:
        assert utils.time.zoneinfo("Cordoba") is None
        # the utils helper should still resolve this abbreviated (and
        #  lowercase) form
        assert (
            utils.time.zoneinfo("argentina/cordoba").key
            == "America/Argentina/Cordoba"
        )

    # Too ambiguous
    assert utils.time.zoneinfo("Argentina") is None

    # bad data
    assert utils.time.zoneinfo(object) is None
    assert utils.time.zoneinfo(None) is None
    assert utils.time.zoneinfo(1) is None
    assert utils.time.zoneinfo("") is None
    assert utils.time.zoneinfo("invalid") is None
caronc-apprise-dfec414/tests/test_asyncio.py000066400000000000000000000067621526720371000213520ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
import logging
import sys

import pytest

from apprise import Apprise, NotificationManager, NotifyBase, NotifyFormat

logging.disable(logging.CRITICAL)

# Grant access to our Notification Manager Singleton
N_MGR = NotificationManager()


@pytest.mark.skipif(
    sys.version_info >= (3, 7), reason="Requires Python 3.0 to 3.6"
)
def test_apprise_asyncio_runtime_error():
    """
    API: Apprise() AsyncIO RuntimeError handling

    """

    class GoodNotification(NotifyBase):
        def __init__(self, **kwargs):
            super().__init__(notify_format=NotifyFormat.HTML, **kwargs)

        def url(self, **kwargs):
            # Support URL
            return ""

        def send(self, **kwargs):
            # Pretend everything is okay
            return True

        @staticmethod
        def parse_url(url, *args, **kwargs):
            # always parseable
            return NotifyBase.parse_url(url, verify_host=False)

    # Store our good notification in our schema map
    N_MGR["good"] = GoodNotification

    # Create ourselves an Apprise object
    a = Apprise()

    # Add a few entries
    for _ in range(25):
        a.add("good://")

    # Python v3.6 and lower can't handle situations gracefully when an
    # event_loop isn't already established(). Test that Apprise can handle
    # these situations
    import asyncio

    # Get our event loop
    try:
        loop = asyncio.get_event_loop()

    except RuntimeError:
        loop = None

    # Adjust out event loop to not point at anything
    asyncio.set_event_loop(None)

    # With the event loop inactive, we'll fail trying to get the active loop
    with pytest.raises(RuntimeError):
        asyncio.get_event_loop()

    try:
        # Below, we internally will throw a RuntimeError() since there will
        # be no active event_loop in place. However internally it will be smart
        # enough to create a new event loop and continue...
        assert bool(a.notify(title="title", body="body")) is True

    finally:
        # Restore our event loop (in the event the above test failed)
        asyncio.set_event_loop(loop)
caronc-apprise-dfec414/tests/test_attach_base.py000066400000000000000000000111111526720371000221230ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
import logging
from unittest import mock

import pytest

from apprise.attachment.base import AttachBase
from apprise.exception import AppriseImproperlyConfigured

logging.disable(logging.CRITICAL)


def test_mimetype_initialization():
    """
    API: AttachBase() mimetype initialization

    """
    with (
        mock.patch("mimetypes.init") as mock_init,
        mock.patch("mimetypes.inited", True),
    ):
        AttachBase()
        assert mock_init.call_count == 0

    with (
        mock.patch("mimetypes.init") as mock_init,
        mock.patch("mimetypes.inited", False),
    ):
        AttachBase()
        assert mock_init.call_count == 1


def test_attach_base():
    """
    API: AttachBase()

    """
    # an invalid mime-type
    with pytest.raises(AppriseImproperlyConfigured):
        AttachBase(**{"mimetype": "invalid"})

    # a valid mime-type does not cause an exception to throw
    AttachBase(**{"mimetype": "image/png"})

    # Create an object with no mimetype over-ride
    obj = AttachBase()

    # Get our url object
    str(obj)

    # We can not process name/path/mimetype at a Base level
    with pytest.raises(NotImplementedError):
        obj.download()

    # Unsupported URLs are not parsed
    assert AttachBase.parse_url(url="invalid://") is None

    # Valid URL & Valid Format
    results = AttachBase.parse_url(url="file://relative/path")
    assert isinstance(results, dict)
    # No mime is defined
    assert results.get("mimetype") is None

    # Valid URL & Valid Format with mime type set
    results = AttachBase.parse_url(url="file://relative/path?mime=image/jpeg")
    assert isinstance(results, dict)
    # mime defined
    assert results.get("mimetype") == "image/jpeg"
    # We can retrieve our url
    assert str(results)


def test_attach_base_parse_url_name_sanitization():
    """
    API: AttachBase.parse_url() ?name= sanitization

    """
    # Normal name -- returned as-is (lowercased)
    results = AttachBase.parse_url(
        url="file://path/to/file?name=thumbnail.jpg"
    )
    assert isinstance(results, dict)
    assert results.get("name") == "thumbnail.jpg"

    # Path traversal stripped; only the basename is kept
    results = AttachBase.parse_url(url="file://path/to/file?name=/etc/passwd")
    assert isinstance(results, dict)
    assert results.get("name") == "passwd"

    # Deep traversal -- same rule applies
    results = AttachBase.parse_url(
        url="file://path/to/file?name=../../secret.jpg"
    )
    assert isinstance(results, dict)
    assert results.get("name") == "secret.jpg"

    # Empty ?name= -- treated as not specified; key must be absent
    results = AttachBase.parse_url(url="file://path/to/file?name=")
    assert isinstance(results, dict)
    assert "name" not in results

    # Whitespace-only ?name= (URL-encoded spaces) -- treated as not specified
    results = AttachBase.parse_url(url="file://path/to/file?name=%20%20%20")
    assert isinstance(results, dict)
    assert "name" not in results

    # Directory-only path (no filename component) -- treated as not specified
    results = AttachBase.parse_url(url="file://path/to/file?name=/")
    assert isinstance(results, dict)
    assert "name" not in results
caronc-apprise-dfec414/tests/test_attach_file.py000066400000000000000000000260131526720371000221370ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
import logging
from os.path import dirname, join
import re
import time
from unittest import mock
import urllib

import pytest

from apprise import AppriseAttachment, exception
from apprise.attachment.base import AttachBase
from apprise.attachment.file import AttachFile
from apprise.common import ContentLocation

logging.disable(logging.CRITICAL)

TEST_VAR_DIR = join(dirname(__file__), "var")


def test_attach_file_parse_url():
    """
    API: AttachFile().parse_url()

    """

    # bad entry
    assert AttachFile.parse_url("garbage://") is None

    # no file path specified
    assert AttachFile.parse_url("file://") is None


def test_file_expiry(tmpdir):
    """
    API: AttachFile Expiry
    """
    path = join(TEST_VAR_DIR, "apprise-test.gif")
    image = tmpdir.mkdir("apprise_file").join("test.jpg")
    with open(path, "rb") as data:
        image.write(data)

    aa = AppriseAttachment.instantiate(str(image), cache=30)

    # Our file is now available
    assert aa.exists()

    # Our second call has the file already downloaded, but now compares
    # it's date against when we consider it to have expire.  We're well
    # under 30 seconds here (our set value), so this will succeed
    assert aa.exists()

    with mock.patch("time.time", return_value=time.time() + 31):
        # This will force a re-download as our cache will have
        # expired
        assert aa.exists()

    with mock.patch("time.time", side_effect=OSError):
        # We will throw an exception
        assert aa.exists()


def test_attach_mimetype():
    """
    API: AttachFile MimeType()

    """
    # Simple gif test
    path = join(TEST_VAR_DIR, "apprise-test.gif")
    response = AppriseAttachment.instantiate(path)
    assert isinstance(response, AttachFile)
    assert response.path == path
    assert response.name == "apprise-test.gif"
    assert response.mimetype == "image/gif"

    # Force mimetype
    response._mimetype = None
    response.detected_mimetype = None

    assert response.mimetype == "image/gif"

    response._mimetype = None
    response.detected_mimetype = None
    with mock.patch("mimetypes.guess_type", side_effect=TypeError):
        assert response.mimetype == "application/octet-stream"


def test_attach_file():
    """
    API: AttachFile()

    """
    # Simple gif test
    path = join(TEST_VAR_DIR, "apprise-test.gif")
    response = AppriseAttachment.instantiate(path)
    assert isinstance(response, AttachFile)
    assert response.path == path
    assert response.name == "apprise-test.gif"
    assert response.mimetype == "image/gif"
    # Download is successful and has already been called by now; below pulls
    # results from cache
    assert response.download()

    with mock.patch("os.path.isfile", side_effect=OSError):
        assert response.exists() is False

    with mock.patch("os.path.isfile", return_value=False):
        assert response.exists() is False

    # Test that our file exists
    assert response.exists() is True
    response.cache = True
    # Leverage always-cached flag
    assert response.exists() is True

    # On Windows, it is:
    #  `file://D%3A%5Ca%5Capprise%5Capprise%5Ctest%5Cvar%5Capprise-test.gif`
    path_in_url = urllib.parse.quote(path)
    assert response.url().startswith(f"file://{path_in_url}")

    # No mime-type and/or filename over-ride was specified, so it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", response.url()) is None
    assert re.search(r"[?&]name=", response.url()) is None

    # Test case where location is simply set to INACCESSIBLE
    # Below is a bad example, but it proves the section of code properly works.
    # Ideally a server admin may wish to just disable all File based
    # attachments entirely. In this case, they simply just need to change the
    # global singleton at the start of their program like:
    #
    # import apprise
    # apprise.attachment.AttachFile.location = \
    #       apprise.ContentLocation.INACCESSIBLE
    #
    response = AppriseAttachment.instantiate(path)
    assert isinstance(response, AttachFile)
    response.location = ContentLocation.INACCESSIBLE
    assert response.path is None
    # Downloads just don't work period
    assert response.download() is False

    # File handling (even if image is set to maxium allowable)
    response = AppriseAttachment.instantiate(path)
    assert isinstance(response, AttachFile)
    with mock.patch("os.path.getsize", return_value=AttachBase.max_file_size):
        # It will still work
        assert response.path == path

    # File handling when size is to large
    response = AppriseAttachment.instantiate(path)
    assert isinstance(response, AttachFile)
    with mock.patch(
        "os.path.getsize", return_value=AttachBase.max_file_size + 1
    ):
        # We can't work in this case
        assert response.path is None

    # File handling when image is not available
    response = AppriseAttachment.instantiate(path)
    assert isinstance(response, AttachFile)
    with mock.patch("os.path.isfile", return_value=False):
        # This triggers a full check and will fail the isfile() check
        assert response.path is None

    # The call to AttachBase.path automatically triggers a call to download()
    # but this same is done with a call to AttachBase.name as well.  Above
    # test cases reference 'path' right after instantiation; here we reference
    # 'name'
    response = AppriseAttachment.instantiate(path)
    assert response.name == "apprise-test.gif"
    assert response.path == path
    assert response.mimetype == "image/gif"
    # No mime-type and/or filename over-ride was specified, so therefore it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", response.url()) is None
    assert re.search(r"[?&]name=", response.url()) is None

    # continuation to cheking 'name' instead of 'path' first where our call
    # to download() fails
    response = AppriseAttachment.instantiate(path)
    assert isinstance(response, AttachFile)
    with mock.patch("os.path.isfile", return_value=False):
        # This triggers a full check and will fail the isfile() check
        assert response.name is None

    # The call to AttachBase.path automatically triggers a call to download()
    # but this same is done with a call to AttachBase.mimetype as well.  Above
    # test cases reference 'path' right after instantiation; here we reference
    # 'mimetype'
    response = AppriseAttachment.instantiate(path)
    assert response.mimetype == "image/gif"
    assert response.name == "apprise-test.gif"
    assert response.path == path
    # No mime-type and/or filename over-ride was specified, so therefore it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", response.url()) is None
    assert re.search(r"[?&]name=", response.url()) is None

    # continuation to cheking 'name' instead of 'path' first where our call
    # to download() fails
    response = AppriseAttachment.instantiate(path)
    assert isinstance(response, AttachFile)
    with mock.patch("os.path.isfile", return_value=False):
        # download() fails so we don't have a mimetpe
        assert response.mimetype is None
        assert response.name is None
        assert response.path is None
        # This triggers a full check and will fail the isfile() check

    # Force a mime-type and new name
    response = AppriseAttachment.instantiate(
        "file://{}?mime={}&name={}".format(path, "image/jpeg", "test.jpeg")
    )
    assert isinstance(response, AttachFile)
    assert response.path == path
    assert response.name == "test.jpeg"
    assert response.mimetype == "image/jpeg"
    assert re.search(r"[?&]mime=image/jpeg", response.url(), re.I)
    assert re.search(r"[?&]name=test\.jpeg", response.url(), re.I)

    # Test hosted configuration and that we can't add a valid file
    aa = AppriseAttachment(location=ContentLocation.HOSTED)
    # No entries defined yet
    assert bool(aa) is False
    assert aa.sync() is False

    # Entry count does not impact sync if told to act that way
    assert aa.sync(abort_if_empty=False) is True
    assert aa.add(path) is False

    response = AppriseAttachment.instantiate(path)
    assert len(response) > 0

    # Get file
    assert response.download()

    # Test the inability to get our file size
    with mock.patch("os.path.getsize", side_effect=(0, OSError)):
        assert len(response) == 0

    # get file again
    assert response.download()
    with mock.patch("os.path.isfile", return_value=True):
        response.cache = True
        with mock.patch("os.path.getsize", side_effect=OSError):
            assert len(response) == 0


def test_attach_file_base64():
    """
    API: AttachFile() with base64 encoding

    """

    # Simple gif test
    path = join(TEST_VAR_DIR, "apprise-test.gif")
    response = AppriseAttachment.instantiate(path)
    assert isinstance(response, AttachFile)
    assert response.name == "apprise-test.gif"
    assert response.mimetype == "image/gif"

    # now test our base64 output
    assert isinstance(response.base64(), str)
    # No encoding if we choose
    assert isinstance(response.base64(encoding=None), bytes)

    # Error cases:
    with (
        mock.patch("os.path.isfile", return_value=False),
        pytest.raises(exception.AppriseFileNotFound),
    ):
        response.base64()

    with mock.patch(
        "builtins.open",
        new_callable=mock.mock_open,
        read_data="mocked file content",
    ) as mock_file:
        mock_file.side_effect = FileNotFoundError
        with pytest.raises(exception.AppriseFileNotFound):
            response.base64()

        mock_file.side_effect = OSError
        with pytest.raises(exception.AppriseDiskIOError):
            response.base64()
caronc-apprise-dfec414/tests/test_attach_http.py000066400000000000000000000604761526720371000222120ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
import errno
import logging
import mimetypes
from os.path import dirname, getsize, join
import re
from typing import ClassVar
from unittest import mock

import pytest
import requests

from apprise import Apprise, AppriseAttachment, NotificationManager, exception
from apprise.attachment.http import AttachHTTP
from apprise.common import ContentLocation
from apprise.plugins import NotifyBase

logging.disable(logging.CRITICAL)

TEST_VAR_DIR = join(dirname(__file__), "var")

# Grant access to our Notification Manager Singleton
N_MGR = NotificationManager()

# Some exception handling we'll use
REQUEST_EXCEPTIONS = (
    requests.ConnectionError(0, "requests.ConnectionError() not handled"),
    requests.RequestException(0, "requests.RequestException() not handled"),
    requests.HTTPError(0, "requests.HTTPError() not handled"),
    requests.ReadTimeout(0, "requests.ReadTimeout() not handled"),
    requests.TooManyRedirects(0, "requests.TooManyRedirects() not handled"),
    # Throw OSError exceptions too
    OSError("SystemError"),
)


def test_attach_http_parse_url():
    """
    API: AttachHTTP().parse_url()

    """

    # bad entry
    assert AttachHTTP.parse_url("garbage://") is None

    # no url specified
    assert AttachHTTP.parse_url("http://") is None


def test_attach_http_encoded_path():
    """AttachHTTP() keeps an encoded path intact through url()."""

    # A GitLab style file path with encoded slashes
    url = "https://example.com/api/v4/projects/my%2Frepo/files/a%2Fb.txt"
    results = AttachHTTP.parse_url(url)
    attach = AttachHTTP(**results)
    assert attach.fullpath == "/api/v4/projects/my%2Frepo/files/a%2Fb.txt"

    # url() does not encode the path a second time
    assert attach.url().startswith(url + "?")


def test_attach_http_query_string_dictionary():
    """
    API: AttachHTTP() Query String Dictionary

    """

    # Set verify off
    results = AttachHTTP.parse_url("http://localhost?verify=no&rto=9&cto=8")
    assert isinstance(results, dict)

    # Create our object
    obj = AttachHTTP(**results)
    assert isinstance(obj, AttachHTTP)

    # verify is disabled and therefore set
    assert re.search(r"[?&]verify=no", obj.url())

    # Our connect timeout flag is set since it differs from the default
    assert re.search(r"[?&]cto=8", obj.url())
    # Our read timeout flag is set since it differs from the default
    assert re.search(r"[?&]rto=9", obj.url())

    # Now lets create a URL with a custom Query String entry

    # some custom qsd entries specified
    results = AttachHTTP.parse_url("http://localhost?dl=1&_var=test")
    assert isinstance(results, dict)

    # Create our object
    obj = AttachHTTP(**results)
    assert isinstance(obj, AttachHTTP)

    # verify is not in the URL as it is implied (default)
    assert not re.search(r"[?&]verify=yes", obj.url())

    # But now test that our custom arguments have also been set
    assert re.search(r"[?&]dl=1", obj.url())
    assert re.search(r"[?&]_var=test", obj.url())


@mock.patch("requests.request")
@mock.patch("requests.get")
def test_attach_http(mock_get, mock_request):
    """
    API: AttachHTTP() object

    """

    # Define our good:// url
    class GoodNotification(NotifyBase):
        def __init__(self, *args, **kwargs):
            super().__init__(*args, **kwargs)

        def notify(self, *args, **kwargs):
            # Pretend everything is okay
            return True

        def url(self):
            # Support url() function
            return ""

    # Store our good notification in our schema map
    N_MGR["good"] = GoodNotification

    # Temporary path
    path = join(TEST_VAR_DIR, "apprise-test.gif")

    class DummyResponse:
        """A dummy response used to manage our object."""

        status_code = requests.codes.ok
        headers: ClassVar[dict[str, str]] = {
            "Content-Length": getsize(path),
            "Content-Type": "text/plain",
        }

        # Pointer to file
        ptr = None

        # used to return random keep-alive chunks
        _keepalive_chunk_ref = 0

        def close(self):
            return

        def iter_content(self, chunk_size=1024):
            """Lazy function (generator) to read a file piece by piece.

            Default chunk size: 1k.
            """

            while True:
                self._keepalive_chunk_ref += 1
                if 16 % self._keepalive_chunk_ref == 0:
                    # Yield a keep-alive block
                    yield ""

                data = self.ptr.read(chunk_size)
                if not data:
                    break
                yield data

        def raise_for_status(self):
            return

        def __enter__(self):
            self.ptr = open(path, "rb")
            return self

        def __exit__(self, *args, **kwargs):
            self.ptr.close()

    # Prepare Mock
    dummy_response = DummyResponse()
    mock_get.return_value = dummy_response

    # Test custom url get parameters
    results = AttachHTTP.parse_url(
        "http://user:pass@localhost/apprise.gif?DL=1&cache=300"
    )
    assert isinstance(results, dict)
    attachment = AttachHTTP(**results)
    assert isinstance(attachment.url(), str) is True

    # Test that our extended variables are passed along
    assert mock_get.call_count == 0
    assert attachment
    assert mock_get.call_count == 1
    assert "params" in mock_get.call_args_list[0][1]
    assert "DL" in mock_get.call_args_list[0][1]["params"]

    # Verify that arguments that are reserved for apprise are not
    # passed along
    assert "cache" not in mock_get.call_args_list[0][1]["params"]

    with mock.patch("os.unlink", side_effect=OSError()):
        # Test invalidation with exception thrown
        attachment.invalidate()

    results = AttachHTTP.parse_url(
        "http://user:pass@localhost/apprise.gif?+key=value&cache=True"
    )
    assert isinstance(results, dict)
    attachment = AttachHTTP(**results)
    assert isinstance(attachment.url(), str) is True
    # No mime-type and/or filename over-ride was specified, so therefore it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", attachment.url()) is None
    assert re.search(r"[?&]name=", attachment.url()) is None
    # No Content-Disposition; so we use filename from path
    assert attachment.name == "apprise.gif"
    # Format is text/plain because of the Content-Type in the HTTP Query
    assert attachment.mimetype == "text/plain"

    # To get our desired effect, we'd have to have had to detect everything
    attachment.detected_mimetype = None
    attachment._mimetype = None

    # Now a call would yield a detected result that we'd agree with:
    assert attachment.mimetype == "image/gif"

    # Detect the MIME type again without a Content-Type header.
    # we would have had a different result; the below forces it to detect it
    # again:
    attachment.detected_mimetype = None

    # Now we get what we would have expected:
    assert attachment.mimetype == "image/gif"

    results = AttachHTTP.parse_url(
        "http://localhost:3000/noname.gif?name=usethis.jpg&mime=image/jpeg"
    )
    assert isinstance(results, dict)
    attachment = AttachHTTP(**results)
    assert isinstance(attachment.url(), str) is True
    # both mime and name over-ridden
    assert re.search(r"[?&]mime=image/jpeg", attachment.url())
    assert re.search(r"[?&]name=usethis.jpg", attachment.url())
    # No Content-Disposition; so we use filename from path
    assert attachment.name == "usethis.jpg"
    assert attachment.mimetype == "image/jpeg"

    # Edge case; download called a second time when content already retrieved
    assert attachment.download()
    assert attachment
    assert len(attachment) == getsize(path)

    # Administrators can disable all HTTP attachments globally:
    #
    # import apprise
    # apprise.attachment.AttachHTTP.location = \
    #       apprise.ContentLocation.INACCESSIBLE
    attachment = AttachHTTP(**results)
    attachment.location = ContentLocation.INACCESSIBLE
    assert attachment.path is None
    # Downloads are blocked when HTTP attachments are inaccessible.
    assert attachment.download() is False

    # No path specified
    # No Content-Disposition specified
    # No filename (because no path)
    results = AttachHTTP.parse_url("http://localhost")
    assert isinstance(results, dict)
    attachment = AttachHTTP(**results)
    assert isinstance(attachment.url(), str) is True
    # No mime-type and/or filename over-ride was specified, so therefore it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", attachment.url()) is None
    assert re.search(r"[?&]name=", attachment.url()) is None
    # Format is text/plain because of the Content-Type in the HTTP Query
    assert attachment.mimetype == "text/plain"

    # To get our desired effect, we'd have to have had to detect everything
    attachment.detected_mimetype = None
    attachment._mimetype = None

    # Now we are unable to detect our file without enough data to do it with
    assert attachment.mimetype == "application/octet-stream"

    # Because we could determine our mime type, we could build an extension
    # for our unknown filename
    assert (
        attachment.name == f"{AttachHTTP.unknown_filename}"
        f"{mimetypes.guess_extension(attachment.mimetype)}"
    )
    assert attachment
    assert len(attachment) == getsize(path)

    # Set Content-Length to a value that exceeds our maximum allowable
    dummy_response.headers["Content-Length"] = AttachHTTP.max_file_size + 1
    results = AttachHTTP.parse_url("http://localhost/toobig.jpg")
    assert isinstance(results, dict)
    attachment = AttachHTTP(**results)
    # we can not download this attachment
    assert not attachment
    assert isinstance(attachment.url(), str) is True
    # No mime-type and/or filename over-ride was specified, so therefore it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", attachment.url()) is None
    assert re.search(r"[?&]name=", attachment.url()) is None
    assert attachment.mimetype is None
    assert attachment.name is None
    assert len(attachment) == 0

    # Handle cases where we have no Content-Length and we need to rely
    # on what is read as it is streamed
    del dummy_response.headers["Content-Length"]
    # No path specified
    # No Content-Disposition specified
    # No Content-Length specified
    # No filename (because no path)
    results = AttachHTTP.parse_url("http://localhost/no-length.gif")
    assert isinstance(results, dict)
    attachment = AttachHTTP(**results)
    assert isinstance(attachment.url(), str) is True
    # No mime-type and/or filename over-ride was specified, so therefore it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", attachment.url()) is None
    assert re.search(r"[?&]name=", attachment.url()) is None

    # Format is text/plain because of the Content-Type in the HTTP Query
    assert attachment.mimetype == "text/plain"

    # Because we could determine our mime type, we could build an extension
    # for our unknown filename
    assert attachment.name == "no-length.gif"
    assert attachment
    assert len(attachment) == getsize(path)

    # Set our limit to be the length of our image; everything should work
    # without a problem
    max_file_size = AttachHTTP.max_file_size
    AttachHTTP.max_file_size = getsize(path)
    # Set ourselves a Content-Disposition (providing a filename)
    dummy_response.headers["Content-Disposition"] = (
        'attachment; filename="myimage.gif"'
    )
    # Remove our content type so we're forced to guess it from our filename
    # specified in our Content-Disposition
    del dummy_response.headers["Content-Type"]
    # No path specified
    # No Content-Length specified
    # Filename in Content-Disposition (over-rides one found in path
    results = AttachHTTP.parse_url("http://user@localhost/ignore-filename.gif")
    assert isinstance(results, dict)
    attachment = AttachHTTP(**results)
    assert isinstance(attachment.url(), str) is True
    # No mime-type and/or filename over-ride was specified, so therefore it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", attachment.url()) is None
    assert re.search(r"[?&]name=", attachment.url()) is None
    assert attachment.mimetype == "image/gif"
    # Because we could determine our mime type, we could build an extension
    # for our unknown filename
    assert attachment.name == "myimage.gif"
    assert attachment
    assert len(attachment) == getsize(path)

    # Similar to test above except we make our max message size just 1 byte
    # smaller then our gif file. This will cause us to fail to read the
    # attachment
    AttachHTTP.max_file_size = getsize(path) - 1
    results = AttachHTTP.parse_url("http://localhost/toobig.jpg")
    assert isinstance(results, dict)
    attachment = AttachHTTP(**results)
    # we can not download this attachment
    assert not attachment
    assert isinstance(attachment.url(), str) is True
    # No mime-type and/or filename over-ride was specified, so therefore it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", attachment.url()) is None
    assert re.search(r"[?&]name=", attachment.url()) is None
    assert attachment.mimetype is None
    assert attachment.name is None
    assert len(attachment) == 0

    # Disable our file size limitations
    AttachHTTP.max_file_size = 0
    results = AttachHTTP.parse_url("http://user@localhost")
    assert isinstance(results, dict)
    attachment = AttachHTTP(**results)
    assert isinstance(attachment.url(), str) is True
    # No mime-type and/or filename over-ride was specified, so therefore it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", attachment.url()) is None
    assert re.search(r"[?&]name=", attachment.url()) is None
    assert attachment.mimetype == "image/gif"
    # Because we could determine our mime type, we could build an extension
    # for our unknown filename
    assert attachment.name == "myimage.gif"
    assert attachment
    assert len(attachment) == getsize(path)

    # Set our header up with an invalid Content-Length; we can still process
    # this data. It just means we track it lower when reading back content
    dummy_response.headers = {"Content-Length": "invalid"}
    results = AttachHTTP.parse_url("http://localhost/invalid-length.gif")
    assert isinstance(results, dict)
    attachment = AttachHTTP(**results)
    assert isinstance(attachment.url(), str) is True
    # No mime-type and/or filename over-ride was specified, so therefore it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", attachment.url()) is None
    assert re.search(r"[?&]name=", attachment.url()) is None
    assert attachment.mimetype == "image/gif"
    # Because we could determine our mime type, we could build an extension
    # for our unknown filename
    assert attachment.name == "invalid-length.gif"
    assert attachment

    # Give ourselves nothing to work with
    dummy_response.headers = {}
    results = AttachHTTP.parse_url("http://user@localhost")
    assert isinstance(results, dict)
    attachment = AttachHTTP(**results)
    # we can not download this attachment
    assert attachment
    assert isinstance(attachment.url(), str) is True
    # No mime-type and/or filename over-ride was specified, so therefore it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", attachment.url()) is None
    assert re.search(r"[?&]name=", attachment.url()) is None

    # Handle edge-case where detected_name is None for whatever reason
    attachment.detected_name = None
    assert attachment.mimetype == attachment.unknown_mimetype
    assert attachment.name.startswith(AttachHTTP.unknown_filename)
    assert len(attachment) == getsize(path)

    # Exception handling
    mock_get.return_value = None
    for exception_ in REQUEST_EXCEPTIONS:
        aa = AppriseAttachment.instantiate(
            "http://localhost/exception.gif?cache=30"
        )
        assert isinstance(aa, AttachHTTP)

        mock_get.side_effect = exception_
        assert not aa

    # Restore value
    AttachHTTP.max_file_size = max_file_size

    # Multi Message Testing
    mock_get.side_effect = None
    mock_get.return_value = DummyResponse()

    # Prepare our POST response (from notify call)
    response = requests.Request()
    response.status_code = requests.codes.ok
    response.content = ""
    mock_request.return_value = response

    mock_get.reset_mock()
    mock_request.reset_mock()
    assert mock_get.call_count == 0

    apobj = Apprise()
    assert apobj.add("form://localhost")
    assert apobj.add("json://localhost")
    assert apobj.add("xml://localhost")
    assert len(apobj) == 3
    assert (
        bool(
            apobj.notify(
                body="one attachment split 3 times",
                attach="http://localhost/test.gif",
            )
        )
        is True
    )

    # We posted 3 times
    assert mock_request.call_count == 3
    # We only fetched once and re-used the same fetch for all posts
    assert mock_get.call_count == 1

    mock_get.reset_mock()
    mock_request.reset_mock()
    apobj = Apprise()
    for n in range(10):
        assert apobj.add(f"json://localhost?:entry={n}&method=post")
        assert apobj.add(f"form://localhost?:entry={n}&method=post")
        assert apobj.add(f"xml://localhost?:entry={n}&method=post")

    assert (
        bool(
            apobj.notify(
                body="one attachment split 30 times",
                attach="http://localhost/test.gif",
            )
        )
        is True
    )

    # We posted 30 times
    assert mock_request.call_count == 30
    # We only fetched once and re-used the same fetch for all posts
    assert mock_get.call_count == 1

    #
    # We will test our base64 handling now
    #
    mock_get.reset_mock()
    mock_request.reset_mock()

    AttachHTTP.max_file_size = getsize(path)
    # Set ourselves a Content-Disposition (providing a filename)
    dummy_response.headers["Content-Disposition"] = (
        'attachment; filename="myimage.gif"'
    )
    results = AttachHTTP.parse_url("http://user@localhost/filename.gif")
    assert isinstance(results, dict)
    obj = AttachHTTP(**results)

    # now test our base64 output
    assert isinstance(obj.base64(), str)
    # No encoding if we choose
    assert isinstance(obj.base64(encoding=None), bytes)

    # Test that a 3xx redirect is rejected when redirect=no is set; a
    # status-code range guard (300-399) catches what raise_for_status() misses.
    class RedirectResponse:
        """Simulates a 301 response returned when allow_redirects=False."""

        status_code = requests.codes.moved_permanently
        headers: ClassVar[dict[str, str]] = {}

        def raise_for_status(self):
            return

        def __enter__(self):
            return self

        def __exit__(self, *args, **kwargs):
            return

    mock_get.return_value = RedirectResponse()
    results = AttachHTTP.parse_url(
        "http://user@localhost/filename.gif?redirect=no"
    )
    assert isinstance(results, dict)
    obj_no_redir = AttachHTTP(**results)
    assert obj_no_redir.redirects is False
    # Do not stream a redirect response when redirects are disabled.
    assert obj_no_redir.download() is False
    # Restore for downstream tests
    mock_get.return_value = dummy_response

    # Error cases:
    with mock.patch(
        "builtins.open",
        new_callable=mock.mock_open,
        read_data="mocked file content",
    ) as mock_file:
        mock_file.side_effect = FileNotFoundError
        with pytest.raises(exception.AppriseFileNotFound):
            obj.base64()

        mock_file.side_effect = OSError
        with pytest.raises(exception.AppriseDiskIOError):
            obj.base64()


class SizedResponse:
    """A dummy response that streams a fixed payload in small chunks."""

    status_code = requests.codes.ok
    headers: ClassVar[dict[str, str]] = {"Content-Type": "text/plain"}

    # The payload streamed back to the caller
    payload = b"abcdefghij"

    def close(self):
        return

    def iter_content(self, chunk_size=1024):
        """Stream our payload back 2 bytes at a time."""
        for index in range(0, len(self.payload), 2):
            yield self.payload[index : index + 2]

    def raise_for_status(self):
        return

    def __enter__(self):
        return self

    def __exit__(self, *args, **kwargs):
        return


@mock.patch("requests.get")
def test_attach_http_download_dir(mock_get, tmpdir):
    """AttachHTTP writes downloads into the requested directory."""

    mock_get.return_value = SizedResponse()

    # Point our download at a directory of our own choosing
    download_dir = str(tmpdir.mkdir("attachments"))
    results = AttachHTTP.parse_url("http://localhost/file.txt")
    assert isinstance(results, dict)
    attachment = AttachHTTP(download_dir=download_dir, **results)
    assert attachment

    # Our content lives in the directory we asked for
    assert dirname(attachment.path) == download_dir
    assert len(attachment) == len(SizedResponse.payload)

    # Without a download_dir we fall back to the system temporary directory
    attachment = AttachHTTP(**results)
    assert attachment
    assert dirname(attachment.path) != download_dir


@mock.patch("requests.get")
def test_attach_http_size_limit(mock_get):
    """AttachHTTP never writes more than max_file_size bytes."""

    mock_get.return_value = SizedResponse()

    # Track how large the file grew before it was thrown away
    written = []
    invalidate = AttachHTTP.invalidate

    def record(self):
        if self._temp_file:
            # tell() covers buffered writes that have not reached disk yet
            written.append(self._temp_file.tell())

        invalidate(self)

    results = AttachHTTP.parse_url("http://localhost/file.txt")
    assert isinstance(results, dict)

    with mock.patch.object(AttachHTTP, "invalidate", record):
        attachment = AttachHTTP(**results)

        # Allow 5 of the 10 bytes on offer
        attachment.max_file_size = 5

        # Our download fails because the payload is over our limit
        assert attachment.download() is False

    # Stop before the chunk that would cross the limit.
    assert written
    assert all(size <= 5 for size in written)
    assert written[0] == 4

    # A payload landing exactly on our limit is still accepted
    attachment = AttachHTTP(**results)
    attachment.max_file_size = len(SizedResponse.payload)
    assert attachment.download() is True
    assert len(attachment) == len(SizedResponse.payload)


@mock.patch("apprise.attachment.http.NamedTemporaryFile")
@mock.patch("requests.get")
def test_attach_http_preserves_storage_error(mock_get, mock_temp_file):
    """Callers can inspect a download failure caused by local storage."""

    mock_get.return_value = SizedResponse()
    storage_error = OSError(errno.ENOSPC, "disk full")
    mock_temp_file.side_effect = storage_error

    results = AttachHTTP.parse_url("http://localhost/file.txt")
    attachment = AttachHTTP(**results)

    assert attachment.download() is False
    assert attachment.download_error is storage_error
caronc-apprise-dfec414/tests/test_attach_memory.py000066400000000000000000000220511526720371000225260ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
import logging
import re
import urllib

import pytest

from apprise import AppriseAttachment, exception
from apprise.attachment.base import AttachBase
from apprise.attachment.memory import AttachMemory
from apprise.common import ContentLocation
from apprise.exception import AppriseImproperlyConfigured

logging.disable(logging.CRITICAL)


def test_attach_memory_parse_url():
    """
    API: AttachMemory().parse_url()

    """

    # Bad Entry
    assert AttachMemory.parse_url(object) is None

    # Our filename is detected automatically
    assert AttachMemory.parse_url("memory://")

    # pass our content in as a string
    mem = AttachMemory(content="string")
    # it loads a string type by default
    assert mem.mimetype == "text/plain"
    # Our filename is automatically generated (with .txt)
    assert re.match(r"^[a-z0-9-]+\.txt$", mem.name, re.I)

    # open our file
    with mem as fp:
        assert fp.getbuffer().nbytes == len(mem)

    # pass our content in as a string
    mem = AttachMemory(
        content="", name="test.html", mimetype="text/html"
    )
    # it loads a string type by default
    assert mem.mimetype == "text/html"
    assert mem.name == "test.html"

    # Stub function
    assert mem.download()

    with pytest.raises(AppriseImproperlyConfigured):
        # garbage in, garbage out
        AttachMemory(content=3)

    # Each open call returns an independent pointer to our data.
    first = mem.open()
    second = mem.open()
    assert first is not second
    assert first.read(1) == b"<"
    assert second.read() == b""

    # Closing one pointer does not affect another or the attachment.
    with first:
        assert first.read() == b"html/>"
    assert first.closed is True
    assert second.closed is False
    assert second.read() == b""

    # The attachment remains readable after its prior pointers are closed.
    second.close()
    with mem.open() as pointer:
        assert pointer.read() == b""
    assert pointer.closed is True
    with mem.open() as pointer:
        assert pointer.read() == b""

    # pass our content in as a string
    mem = AttachMemory(content=b"binary-data", name="raw.dat")
    # it loads a string type by default
    assert mem.mimetype == "application/octet-stream"
    assert mem.name == "raw.dat"

    # pass our content in as a string
    mem = AttachMemory(content=b"binary-data")
    # it loads a string type by default
    assert mem.mimetype == "application/octet-stream"
    # Our filename is automatically generated (with .dat)
    assert re.match(r"^[a-z0-9-]+\.dat$", mem.name, re.I)


def test_attach_memory():
    """
    API: AttachMemory()

    """
    # A url we can test with
    fname = "testfile"
    url = f"memory:///ignored/path/{fname}"

    # Simple gif test
    response = AppriseAttachment.instantiate(url)
    assert isinstance(response, AttachMemory)

    # There is no path yet as we haven't written anything to our memory object
    # yet
    assert response.path is None
    assert bool(response) is False

    with response as memobj:
        memobj.write(b"content")

    # Memory object defaults
    assert response.name == fname
    assert response.path == response.name
    assert response.mimetype == "application/octet-stream"
    assert bool(response) is True

    #
    fname_in_url = urllib.parse.quote(response.name)
    assert response.url().startswith(f"memory://{fname_in_url}")

    # Mime is always part of url
    assert re.search(r"[?&]mime=", response.url()) is not None

    # Test case where location is simply set to INACCESSIBLE
    # Below is a bad example, but it proves the section of code properly works.
    # Ideally a server admin may wish to just disable all File based
    # attachments entirely. In this case, they simply just need to change the
    # global singleton at the start of their program like:
    #
    # import apprise
    # apprise.attachment.AttachMemory.location = \
    #       apprise.ContentLocation.INACCESSIBLE
    #
    response = AppriseAttachment.instantiate(url)
    assert isinstance(response, AttachMemory)
    with response as memobj:
        memobj.write(b"content")

    response.location = ContentLocation.INACCESSIBLE
    assert response.path is None
    # Downloads just don't work period
    assert response.download() is False

    # File handling (even if image is set to maxium allowable)
    response = AppriseAttachment.instantiate(url)
    assert isinstance(response, AttachMemory)
    with response as memobj:
        memobj.write(b"content")

    # Memory handling when size is to large
    response = AppriseAttachment.instantiate(url)
    assert isinstance(response, AttachMemory)
    with response as memobj:
        memobj.write(b"content")

    # Test case where we exceed our defined max_file_size in memory
    prev_value = AttachBase.max_file_size
    AttachBase.max_file_size = len(response) - 1
    # We can't work in this case
    assert response.path is None
    assert response.download() is False

    # Restore our file_size
    AttachBase.max_file_size = prev_value

    response = AppriseAttachment.instantiate(
        "memory://apprise-file.gif?mime=image/gif"
    )
    assert isinstance(response, AttachMemory)
    with response as memobj:
        memobj.write(b"content")

    assert response.name == "apprise-file.gif"
    assert response.path == response.name
    assert response.mimetype == "image/gif"
    # No mime-type and/or filename over-ride was specified, so therefore it
    # won't show up in the generated URL
    assert re.search(r"[?&]mime=", response.url()) is not None
    assert "image/gif" in response.url()

    # Force a mime-type and new name
    response = AppriseAttachment.instantiate(
        "memory://{}?mime={}&name={}".format(
            "ignored.gif", "image/jpeg", "test.jpeg"
        )
    )
    assert isinstance(response, AttachMemory)
    with response as memobj:
        memobj.write(b"content")

    assert response.name == "test.jpeg"
    assert response.path == response.name
    assert response.mimetype == "image/jpeg"
    # We will match on mime type now  (%2F = /)
    assert re.search(r"[?&]mime=image/jpeg", response.url(), re.I)
    assert response.url().startswith("memory://test.jpeg")

    # Test hosted configuration and that we can't add a valid memory file
    aa = AppriseAttachment(location=ContentLocation.HOSTED)
    assert aa.add(response) is False

    # now test our base64 output
    assert isinstance(response.base64(), str)
    # No encoding if we choose
    assert isinstance(response.base64(encoding=None), bytes)

    response.invalidate()
    with pytest.raises(exception.AppriseFileNotFound):
        response.base64()


def test_attach_memory_open_reusable():
    """
    API: AttachMemory().open() returns a reusable handle

    """
    mem = AttachMemory(content=b"content")

    # Closing a handle returned by open() (as a `with` block does)
    # must not affect the attachment itself
    with mem.open() as fp:
        assert fp.read() == b"content"

    # The attachment is still usable afterwards
    assert bool(mem) is True
    assert len(mem) == len(b"content")
    assert mem.exists() is True

    # A second open() call still works and returns the full content
    with mem.open() as fp:
        assert fp.read() == b"content"

    # Each call to open() hands back an independent object
    assert mem.open() is not mem.open()


def test_attach_memory_invalidate_closed_buffer():
    """
    API: AttachMemory().invalidate() on an already-closed buffer

    """
    mem = AttachMemory(content=b"content")

    # Simulate our internal buffer already being closed
    mem._data.close()

    # invalidate() must not attempt to truncate a closed buffer
    mem.invalidate()
caronc-apprise-dfec414/tests/test_compat_markdown33.py000066400000000000000000000037321526720371000232320ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

"""Tests for Python-Markdown 3.3 (Rocky Linux 9) compatibility."""


def test_compat_markdown_escape_placeholders():
    """Escape placeholders left by older Python-Markdown become valid HTML."""
    from markdown.util import ETX, STX

    from apprise.compat.markdown33 import _UnescapePostprocessor

    # Python-Markdown 3.3 leaves "\&" and "\<" as numbered placeholders
    text = f"a {STX}38{ETX} b {STX}60{ETX} c"
    assert _UnescapePostprocessor().run(text) == "a & b < c"

    # Text without placeholders is returned as it was
    assert _UnescapePostprocessor().run("plain") == "plain"
caronc-apprise-dfec414/tests/test_compat_py39.py000066400000000000000000000057251526720371000220520ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

"""Tests for Python 3.9 Compatibility."""

from __future__ import annotations

from unittest import mock

import pytest

from apprise.plugins.irc import protocol


def test_compat_dataclass_keeps_slots():
    """dataclass_compat() passes slots= through on Python 3.10+."""
    # protocol.dataclass is a compat wrapper around
    # apprise.compat.py39._dataclass.
    with (
        mock.patch("apprise.compat.py39._HAS_SLOTS", True),
        mock.patch("apprise.compat.py39._dataclass") as m,
    ):
        sentinel = object()
        m.return_value = sentinel

        assert protocol.dataclass(frozen=True, slots=True) is sentinel
        m.assert_called_once_with(frozen=True, slots=True)


def test_compat_dataclass_drops_slots():
    """dataclass_compat() drops slots= on Python 3.9."""
    with (
        mock.patch("apprise.compat.py39._HAS_SLOTS", False),
        mock.patch("apprise.compat.py39._dataclass") as m,
    ):
        sentinel = object()
        m.return_value = sentinel

        assert protocol.dataclass(frozen=True, slots=True) is sentinel
        m.assert_called_once_with(frozen=True)


def test_compat_dataclass_errors_not_hidden():
    """dataclass_compat() never retries or hides a TypeError."""
    with (
        mock.patch("apprise.compat.py39._HAS_SLOTS", True),
        mock.patch("apprise.compat.py39._dataclass") as m,
    ):
        m.side_effect = TypeError("boom")

        with pytest.raises(TypeError):
            protocol.dataclass(frozen=True, slots=True)

        # The call was made once, with slots still requested
        m.assert_called_once_with(frozen=True, slots=True)
caronc-apprise-dfec414/tests/test_config_base.py000066400000000000000000002413351526720371000221410ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from datetime import datetime, timezone as _tz, tzinfo
from inspect import cleandoc

# Disable logging for a cleaner testing output
import logging
import sys
from typing import Any
from unittest.mock import Mock

import pytest
from pytest_mock import MockerFixture
import requests
import yaml

from apprise import Apprise, AppriseAsset, AppriseConfig, ConfigFormat
from apprise.config import ConfigBase
from apprise.exception import AppriseImproperlyConfigured
from apprise.plugins.email import NotifyEmail
from apprise.utils.time import zoneinfo

logging.disable(logging.CRITICAL)


@pytest.fixture
def requests_remote_config(mocker: MockerFixture) -> Mock:
    """
    Patch requests.post globally.

    The config loader will still go through its normal HTTP logic, but all
    outbound GETs will receive controlled in-memory responses.
    """

    def fake_post(url: str, *args: Any, **kwargs: Any) -> requests.Response:
        if url == "http://localhost:8000/get/test-001":
            body = cleandoc("""
                json://localhost
                form://localhost
                """)
        elif url == "http://localhost:8000/get/test-002":
            body = cleandoc("""
                xml://localhost
                """)
        else:
            pytest.fail(f"Unexpected URL fetched: {url!r}")

        resp = requests.Response()
        resp.status_code = requests.codes.ok
        resp.url = url
        resp._content = body.encode("utf-8")  # type: ignore[attr-defined]
        resp.encoding = "utf-8"
        return resp

    # Patch the actual requests.post symbol that ConfigHTTP uses internally
    mock_post: Mock = mocker.patch("requests.post", side_effect=fake_post)
    return mock_post


def test_config_base():
    """
    API: ConfigBase() object

    """

    # invalid types throw exceptions
    with pytest.raises(AppriseImproperlyConfigured):
        ConfigBase(**{"format": "invalid"})

    # Config format types are not the same as ConfigBase ones
    with pytest.raises(AppriseImproperlyConfigured):
        ConfigBase(**{"format": "markdown"})

    cb = ConfigBase(**{"format": "yaml"})
    assert isinstance(cb, ConfigBase)

    cb = ConfigBase(**{"format": "text"})
    assert isinstance(cb, ConfigBase)

    # Set encoding
    cb = ConfigBase(encoding="utf-8", format="text")
    assert isinstance(cb, ConfigBase)

    # read is not supported in the base object; only the children
    assert cb.read() is None

    # There are no services loaded on a freshly created object
    assert len(cb.services()) == 0

    # Unsupported URLs are not parsed
    assert ConfigBase.parse_url(url="invalid://") is None

    # Valid URL & Valid Format
    results = ConfigBase.parse_url(
        url="file://relative/path?format=yaml&encoding=latin-1"
    )
    assert isinstance(results, dict)
    # These are moved into the root
    assert results.get("format") == "yaml"
    assert results.get("encoding") == "latin-1"

    # But they also exist in the qsd location
    assert isinstance(results.get("qsd"), dict)
    assert results["qsd"].get("encoding") == "latin-1"
    assert results["qsd"].get("format") == "yaml"

    # Valid URL & Invalid Format
    results = ConfigBase.parse_url(
        url="file://relative/path?format=invalid&encoding=latin-1"
    )
    assert isinstance(results, dict)
    # Only encoding is moved into the root
    assert "format" not in results
    assert results.get("encoding") == "latin-1"

    # But they will always exist in the qsd location
    assert isinstance(results.get("qsd"), dict)
    assert results["qsd"].get("encoding") == "latin-1"
    assert results["qsd"].get("format") == "invalid"


def test_config_base_detect_config_format():
    """
    API: ConfigBase.detect_config_format

    """

    # Garbage Handling
    for garbage in (object(), None, 42):
        # A response is always correctly returned
        assert ConfigBase.detect_config_format(garbage) is None

    # Empty files are valid
    assert ConfigBase.detect_config_format("") is ConfigFormat.TEXT

    # Valid Text Configuration
    assert (
        ConfigBase.detect_config_format("""
    # A comment line over top of a URL
    mailto://userb:pass@gmail.com
    """)
        is ConfigFormat.TEXT
    )

    # A text file that has semi-colon as comment characters
    # is valid too
    assert (
        ConfigBase.detect_config_format("""
    ; A comment line over top of a URL
    mailto://userb:pass@gmail.com
    """)
        is ConfigFormat.TEXT
    )

    # Valid YAML Configuration
    assert (
        ConfigBase.detect_config_format("""
    # A comment line over top of a URL
    version: 1
    """)
        is ConfigFormat.YAML
    )

    # Just a whole lot of blank lines...
    assert ConfigBase.detect_config_format("\n\n\n") is ConfigFormat.TEXT

    # A tag group assignment carries tags instead of a URL, but it is still
    # TEXT format; detection must not stop at the first one it encounters
    assert (
        ConfigBase.detect_config_format("""
    # A group lets one name stand for several others
    family=me,wife,kids
    me=mailto://userb:pass@gmail.com
    """)
        is ConfigFormat.TEXT
    )

    # A group assignment that carries a priority prefixed tag
    assert (
        ConfigBase.detect_config_format("""
    1:alerts,me=ntfy://ntfy.sh/chris-phone
    """)
        is ConfigFormat.TEXT
    )

    # A colon in the key still identifies YAML when no URL or tag list
    # follows it
    assert (
        ConfigBase.detect_config_format("""
    version: 1
    """)
        is ConfigFormat.YAML
    )

    # Invalid Config
    assert ConfigBase.detect_config_format("3") is None


def test_config_base_config_parse():
    """
    API: ConfigBase.config_parse

    """

    # Garbage Handling
    for garbage in (object(), None, 42):
        # A response is always correctly returned
        result = ConfigBase.config_parse(garbage)
        # response is a tuple...
        assert isinstance(result, tuple)
        # containing 2 items (plugins, config)
        assert len(result) == 2
        # In the case of garbage in, we get garbage out; both lists are empty
        assert result == ([], [])

    # Valid Text Configuration
    result = ConfigBase.config_parse(
        """
    # A comment line over top of a URL
    mailto://userb:pass@gmail.com
    """,
        asset=AppriseAsset(),
    )
    # We expect to parse 1 entry from the above
    assert isinstance(result, tuple)
    assert len(result) == 2
    # The first element is the number of notification services processed
    assert len(result[0]) == 1
    # If we index into the item, we can check to see the tags associate
    # with it
    assert len(result[0][0].tags) == 0

    # The second is the number of configuration include lines parsed
    assert len(result[1]) == 0

    # Valid Configuration
    result = ConfigBase.config_parse(
        """
# if no version is specified then version 1 is presumed
version: 1

#
# Define your notification urls:
#
urls:
  - pbul://o.gn5kj6nfhv736I7jC3cj3QLRiyhgl98b
  - mailto://test:password@gmail.com
  - json://localhost:
      - tag: devops, admin
    """,
        asset=AppriseAsset(),
    )

    # We expect to parse 2 entries from the above
    assert isinstance(result, tuple)
    assert len(result) == 2
    assert isinstance(result[0], list)
    assert len(result[0]) == 3
    assert len(result[0][0].tags) == 0
    assert len(result[0][1].tags) == 0
    assert len(result[0][2].tags) == 2

    # Test case where we pass in a bad format
    result = ConfigBase.config_parse(
        """
    ; A comment line over top of a URL
    mailto://userb:pass@gmail.com
    """,
        config_format="invalid-format",
    )

    # This is not parseable despite the valid text
    assert isinstance(result, tuple)
    assert isinstance(result[0], list)
    assert len(result[0]) == 0

    result, _ = ConfigBase.config_parse(
        """
    ; A comment line over top of a URL
    mailto://userb:pass@gmail.com
    """,
        config_format=ConfigFormat.TEXT,
    )

    # Parseable
    assert isinstance(result, list)
    assert len(result) == 1


def test_config_base_discord_bug_report_01():
    """
    API: ConfigBase.config_parse user feedback

    A Discord report that a tag was not correctly assigned to a URL when
    presented in the following format
       urls:
         - json://myhost:
           - tag: test
             userid: test
    """
    result, config = ConfigBase.config_parse(
        """
    urls:
      - json://myhost:
        - tag: test
          userid: test
    """,
        asset=AppriseAsset(),
    )

    # We expect to parse 4 entries from the above
    assert isinstance(result, list)
    assert isinstance(config, list)
    assert len(result) == 1
    assert len(result[0].tags) == 1
    assert "test" in result[0].tags


def test_config_base_config_parse_text():
    """
    API: ConfigBase.config_parse_text object

    """

    # Garbage Handling
    for garbage in (object(), None, 42):
        # A response is always correctly returned
        result = ConfigBase.config_parse_text(garbage)
        # response is a tuple...
        assert isinstance(result, tuple)
        # containing 2 items (plugins, config)
        assert len(result) == 2
        # In the case of garbage in, we get garbage out; both lists are empty
        assert result == ([], [])

    # Valid Configuration
    result, config = ConfigBase.config_parse_text(
        """
    # A completely invalid token on json string (it gets ignored)
    # but the URL is still valid
    json://localhost?invalid-token=nodashes

    # A comment line over top of a URL
    mailto://userb:pass@gmail.com

    # Test a URL using it's native format; in this case Ryver
    https://apprise.ryver.com/application/webhook/ckhrjW8w672m6HG

    # Invalid URL as it's not associated with a plugin
    # or a native url
    https://not.a.native.url/

    # A line with mulitiple tag assignments to it
    taga,tagb=kde://

    # An include statement to Apprise API with trailing spaces:
    include http://localhost:8080/notify/apprise

    # A relative include statement (with trailing spaces)
    include apprise.cfg     """,
        asset=AppriseAsset(),
    )

    # We expect to parse 4 entries from the above
    assert isinstance(result, list)
    assert isinstance(config, list)
    assert len(result) == 4
    assert len(result[0].tags) == 0

    # Our last element will have 2 tags associated with it
    assert len(result[-1].tags) == 2
    assert "taga" in result[-1].tags
    assert "tagb" in result[-1].tags

    assert len(config) == 2
    assert "http://localhost:8080/notify/apprise" in config
    assert "apprise.cfg" in config

    # Here is a similar result set however this one has an invalid line
    # in it which invalidates the entire file
    result, config = ConfigBase.config_parse_text("""
    # A comment line over top of a URL
    mailto://userc:pass@gmail.com

    # A line with mulitiple tag assignments to it
    taga,tagb=windows://

    I am an invalid line that does not follow any of the Apprise file rules!
    """)

    # We expect to parse 0 entries from the above because the invalid line
    # invalidates the entire configuration file. This is for security reasons;
    # we don't want to point at files load content in them just because they
    # resemble an Apprise configuration.
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # More invalid data
    result, config = ConfigBase.config_parse_text("""
    # An invalid URL
    invalid://user:pass@gmail.com

    # A tag without a url
    taga=

    # A very poorly structured url
    sns://:@/

    # Just 1 token provided
    sns://T1JJ3T3L2/

    # Even with the above invalid entries, we can still
    # have valid include lines
    include file:///etc/apprise.cfg

    # An invalid include (nothing specified afterwards)
    include

    # An include of a config type we don't support
    include invalid://
    """)

    # We expect to parse 0 entries from the above
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # Test case where a comment is on it's own line with nothing else
    result, config = ConfigBase.config_parse_text("#")
    # We expect to parse 0 entries from the above
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # Verify our tagging works when multiple tags are provided
    result, config = ConfigBase.config_parse_text("""
    tag1, tag2, tag3=json://user:pass@localhost
    """)

    assert isinstance(result, list)
    assert len(result) == 1
    assert len(result[0].tags) == 3
    assert "tag1" in result[0].tags
    assert "tag2" in result[0].tags
    assert "tag3" in result[0].tags


def test_config_base_config_tag_groups_text():
    """
    API: ConfigBase.config_tag_groups_text object

    """

    # Valid Configuration
    result, config = ConfigBase.config_parse_text(
        """
    # Tag assignments
    groupA, groupB = tagB, tagC

    # groupB doubles down as it takes the entries initialized above
    # plus the added ones defined below
    groupB = tagA, tagB, tagD
    groupC = groupA, groupB, groupC, tagE

    # Tag that recursively looks to more tags
    groupD = groupC

    # Assigned ourselves
    groupX = groupX

    # Set up a recursive loop
    groupE = groupF
    groupF = groupE

    # Set up a larger recursive loop
    groupG = groupH
    groupH = groupI
    groupI = groupJ
    groupJ = groupK
    groupK = groupG

    # Bad assignments
    groupM = , , ,
     , ,   = , , ,

    # int's and floats are okay
    1 = 2
    a = 5

    # A comment line over top of a URL
    4, groupB = mailto://userb:pass@gmail.com

    # Tag Assignments
    tagA,groupB=json://localhost

    # More Tag Assignments
    tagC,groupB=xml://localhost

    # More Tag Assignments
    groupD=form://localhost

    """,
        asset=AppriseAsset(),
    )

    # We expect to parse 4 entries from the above
    assert isinstance(result, list)
    assert isinstance(config, list)
    assert len(result) == 4

    # Our first element is our group tags
    assert len(result[0].tags) == 2
    assert "groupb" in result[0].tags
    assert "4" in result[0].tags

    # No additional configuration is loaded
    assert len(config) == 0

    apobj = Apprise()
    assert apobj.add(result)
    # We match against 1 entry
    assert len(list(apobj.find("tagA"))) == 1
    assert len(list(apobj.find("tagB"))) == 0
    assert len(list(apobj.find("groupA"))) == 1
    assert len(list(apobj.find("groupB"))) == 3
    assert len(list(apobj.find("groupC"))) == 2
    assert len(list(apobj.find("groupD"))) == 3

    # Invalid Assignment
    result, config = ConfigBase.config_parse_text("""
    # Must have something to equal or it's a bad line
    group =

    # A tag Assignments that is never gotten to as the line
    # above is bad
    groupD=form://localhost
    """)

    # We expect to parse 0 entries from the above
    assert isinstance(result, list)
    assert isinstance(config, list)
    assert len(result) == 0
    assert len(config) == 0

    # Invalid Assignment
    result, config = ConfigBase.config_parse_text("""
    # Rundant assignment
    group = group

    # Our group assignment
    group=windows://

    """)

    # the redundant assignment does us no harm; but it doesn't grant us any
    # value either
    assert isinstance(result, list)
    assert len(result) == 1

    # Our first element is our group tags
    assert len(result[0].tags) == 1
    assert "group" in result[0].tags

    # There were no include entries defined
    assert len(config) == 0

    # More invalid data
    result, config = ConfigBase.config_parse_text("""
    # A tag without a url or group assignment
    taga=

    """)

    # We expect to parse 0 entries from the above
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    result, config = ConfigBase.config_parse_text("""
    # A tag without a url or group assignment
    taga= %%INVALID
    """)

    # We expect to parse 0 entries from the above
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0


def test_config_base_config_parse_text_with_url():
    """
    API: ConfigBase.config_parse_text object_with_url

    """
    # Here is a similar result set however this one has an invalid line
    # in it which invalidates the entire file
    result, config = ConfigBase.config_parse_text("""
    # Test a URL that has a URL as an argument
    json://user:pass@localhost?+arg=http://example.com?arg2=1&arg3=3
    """)

    # No tag is parsed, but our URL successfully parses as is

    assert isinstance(result, list)
    assert len(result) == 1
    assert len(result[0].tags) == 0

    # Verify our URL is correctly captured
    assert "%2Barg=http%3A%2F%2Fexample.com%3Farg2%3D1" in result[0].url()
    assert "json://user:pass@localhost/" in result[0].url()

    # There were no include entries defined
    assert len(config) == 0

    # Pass in our configuration again
    result, config = ConfigBase.config_parse_text(result[0].url())

    # Verify that our results repeat themselves
    assert isinstance(result, list)
    assert len(result) == 1
    assert len(result[0].tags) == 0
    assert "%2Barg=http%3A%2F%2Fexample.com%3Farg2%3D1" in result[0].url()
    assert "json://user:pass@localhost/" in result[0].url()

    assert len(config) == 0


def test_config_base_config_parse_yaml():
    """
    API: ConfigBase.config_parse_yaml object

    """

    # general reference used below
    asset = AppriseAsset()

    # Garbage Handling
    for garbage in (object(), None, "", 42):
        # A response is always correctly returned
        result = ConfigBase.config_parse_yaml(garbage)
        # response is a tuple...
        assert isinstance(result, tuple)
        # containing 2 items (plugins, config)
        assert len(result) == 2
        # In the case of garbage in, we get garbage out; both lists are empty
        assert result == ([], [])

    # Invalid Version
    result, config = ConfigBase.config_parse_yaml("version: 2a", asset=asset)

    # Invalid data gets us an empty result set
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # Invalid Syntax (throws a ScannerError)
    result, config = ConfigBase.config_parse_yaml(
        """
# if no version is specified then version 1 is presumed
version: 1

urls
""",
        asset=asset,
    )

    # Invalid data gets us an empty result set
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # Missing url token
    result, config = ConfigBase.config_parse_yaml(
        """
# if no version is specified then version 1 is presumed
version: 1

""",
        asset=asset,
    )

    # Invalid data gets us an empty result set
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # No urls defined
    result, config = ConfigBase.config_parse_yaml(
        """
# if no version is specified then version 1 is presumed
version: 1

urls:
""",
        asset=asset,
    )

    # Invalid data gets us an empty result set
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # Invalid url defined
    result, config = ConfigBase.config_parse_yaml(
        """
# if no version is specified then version 1 is presumed
version: 1

# Invalid URL definition; yet the answer to life at the same time
urls: 43
""",
        asset=asset,
    )

    # Invalid data gets us an empty result set
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # Invalid url/schema
    result, config = ConfigBase.config_parse_yaml(
        """
# if no version is specified then version 1 is presumed
version: 1

urls:
  - invalid://

""",
        asset=asset,
    )

    # Invalid data gets us an empty result set
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # Invalid url/schema
    result, config = ConfigBase.config_parse_yaml(
        """
# if no version is specified then version 1 is presumed
version: 1

urls:
  - invalid://:
    - a: b

""",
        asset=asset,
    )

    # Invalid data gets us an empty result set
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # Invalid url/schema
    result, config = ConfigBase.config_parse_yaml(
        """
# Include entry with nothing associated with it
include:

urls:
  - just some free text that isn't valid:
    - a garbage entry to go with it

""",
        asset=asset,
    )

    # Invalid data gets us an empty result set
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # Invalid url/schema
    result, config = ConfigBase.config_parse_yaml(
        """
# if no version is specified then version 1 is presumed
version: 1

urls:
  - not even a proper url

""",
        asset=asset,
    )

    # Invalid data gets us an empty result set
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # Invalid url/schema
    result, config = ConfigBase.config_parse_yaml(
        """
urls:
  # a very invalid sns entry
  - sns://T1JJ3T3L2/
  - sns://:@/:
    - invalid: test
  - sns://T1JJ3T3L2/:
    - invalid: test
    - _invalid: Token can not start with an underscore

  # some strangeness
  -
    -
      - test

""",
        asset=asset,
    )

    # Invalid data gets us an empty result set
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # Valid Configuration
    result, config = ConfigBase.config_parse_yaml(
        """
# if no version is specified then version 1 is presumed
version: 1

# Including by dict
include:
  # File includes
  - file:///absolute/path/
  - relative/path
  # Trailing colon shouldn't disrupt include
  - http://test.com:

  # invalid (numeric)
  - 4

  # some strangeness
  -
    -
      - test

#
# Define your notification urls:
#
urls:
  - pbul://o.gn5kj6nfhv736I7jC3cj3QLRiyhgl98b
  - mailto://test:password@gmail.com
  - https://apprise.ryver.com/application/webhook/ckhrjW8w672m6HG
  - https://not.a.native.url/

    # A completely invalid token on json string (it gets ignored)
    # but the URL is still valid
  - json://localhost?invalid-token=nodashes

""",
        asset=asset,
    )

    # We expect to parse 4 entries from the above
    # The Ryver one is in a native form and the 4th one is invalid
    assert isinstance(result, list)
    assert len(result) == 4
    assert len(result[0].tags) == 0

    # There were 3 include entries
    assert len(config) == 3
    assert "file:///absolute/path/" in config
    assert "relative/path" in config
    assert "http://test.com" in config

    # Valid Configuration
    result, config = ConfigBase.config_parse_yaml(
        """
# A single line include is supported
include: http://localhost:8080/notify/apprise

urls:
  # The following generates 1 service
  - json://localhost:
       tag: my-custom-tag, my-other-tag

  # The following also generates 1 service
  - json://localhost:
    - tag: my-custom-tag, my-other-tag

  # How to stack multiple entries (this generates 2):
  - mailto://user:123abc@yahoo.ca:
    - to: test@examle.com
    - to: test2@examle.com

      # This is an illegal entry; the schema can not be changed
      schema: json

  # accidently left a colon at the end of the url; no problem
  # we'll accept it
  - mailto://oscar:pass@gmail.com:

  # A Ryver URL (using Native format); still accepted
  - https://apprise.ryver.com/application/webhook/ckhrjW8w672m6HG:

  # An invalid URL with colon (ignored)
  - https://not.a.native.url/:

  # A telegram entry (returns a None in parse_url())
  - tgram://invalid

""",
        asset=asset,
    )

    # We expect to parse 6 entries from the above because the tgram:// entry
    # would have failed to be loaded
    assert isinstance(result, list)
    assert len(result) == 6
    assert len(result[0].tags) == 2

    # Our single line included
    assert len(config) == 1
    assert "http://localhost:8080/notify/apprise" in config

    # Global Tags
    result, config = ConfigBase.config_parse_yaml(
        """
# Global Tags stacked as a list
tag:
  - admin
  - devops

urls:
  - json://localhost
  - dbus://
""",
        asset=asset,
    )

    # We expect to parse 2 entries from the above
    assert isinstance(result, list)
    assert len(result) == 2

    # There were no include entries defined
    assert len(config) == 0

    # all entries will have our global tags defined in them
    for entry in result:
        assert "admin" in entry.tags
        assert "devops" in entry.tags

    # Global Tags
    result, config = ConfigBase.config_parse_yaml(
        """
# Global Tags
tag: admin, devops

urls:
  # The following tags will get added to the global set
  - json://localhost:
    - tag: string-tag, my-other-tag, text

  # Tags can be presented in this list format too:
  - dbus://:
    - tag:
      - list-tag
      - dbus
""",
        asset=asset,
    )

    # all entries will have our global tags defined in them
    for entry in result:
        assert "admin" in entry.tags
        assert "devops" in entry.tags

    # We expect to parse 2 entries from the above
    assert isinstance(result, list)
    assert len(result) == 2

    # json:// has 2 globals + 3 defined
    assert len(result[0].tags) == 5
    assert "text" in result[0].tags

    # json:// has 2 globals + 2 defined
    assert len(result[1].tags) == 4
    assert "list-tag" in result[1].tags

    # There were no include entries defined
    assert len(config) == 0

    # An invalid set of entries
    result, config = ConfigBase.config_parse_yaml(
        """
urls:
  # The following tags will get added to the global set
  - json://localhost:
    -
      -
        - entry
""",
        asset=asset,
    )

    # We expect to parse 0 entries from the above
    assert isinstance(result, list)
    assert len(result) == 0

    # There were no include entries defined
    assert len(config) == 0

    # An asset we'll manipulate; set some system flags
    asset = AppriseAsset(_uid="abc123", _recursion=1)

    # Global Tags
    result, config = ConfigBase.config_parse_yaml(
        """
# Test the creation of our apprise asset object
asset:
  app_id: AppriseTest
  app_desc: Apprise Test Notifications
  app_url: http://nuxref.com
  async_mode: no

  # System flags should never get set
  _uid: custom_id
  _recursion: 100

  # Support setting empty values
  image_url_mask:
  image_url_logo:

  image_path_mask: tmp/path

  # Timezone (supports tz keyword too)
  tz: America/Montreal

  # invalid entry
  theme:
    -
      -
        - entry

  # Now for some invalid entries
  invalid: entry
  __init__: can't be over-ridden
  nolists:
    - we don't support these entries
    - in the apprise object

urls:
  - json://localhost:
""",
        asset=asset,
    )

    # We expect to parse 1 entries from the above
    assert isinstance(result, list)
    assert len(result) == 1

    # There were no include entries defined
    assert len(config) == 0

    assert asset.app_id == "AppriseTest"
    assert asset.app_desc == "Apprise Test Notifications"
    assert asset.app_url == "http://nuxref.com"

    # Verify our system flags retain only the value they were initialized to
    assert asset._uid == "abc123"
    assert asset._recursion == 1

    # Boolean types stay boolean
    assert asset.async_mode is False

    # Our TimeZone
    assert isinstance(asset.tzinfo, tzinfo)
    assert asset.tzinfo.key == zoneinfo("America/Montreal").key

    # the theme was not updated and remains the same as it was
    assert asset.theme == AppriseAsset().theme

    # Empty string assignment
    assert isinstance(asset.image_url_mask, str)
    assert asset.image_url_mask == ""
    assert isinstance(asset.image_url_logo, str)
    assert asset.image_url_logo == ""

    # For on-lookers looking through this file; here is a perfectly formatted
    # YAML configuration file for your reference so you can see it without
    # all of the errors like the ones identified above
    result, config = ConfigBase.config_parse_yaml(
        """
# if no version is specified then version 1 is presumed. Thus this is a
# completely optional field. It's a good idea to just add this line because it
# will help with future ambiguity (if it ever occurs).
version: 1

# Define an Asset object if you wish (Optional)
asset:
  app_id: AppriseTest
  app_desc: Apprise Test Notifications
  app_url: http://nuxref.com

  # An invalid timezone
  timezone: invalid

# Optionally define some global tags to associate with ALL of your
# urls below.
tag: admin, devops

# Define your URLs (Mandatory!)
urls:
  # Either on-line each entry like this:
  - json://localhost

  # Or add a colon to the end of the URL where you can optionally provide
  # over-ride entries.  One of the most likely entry to be used here
  # is the tag entry.  This gets extended to the global tag (if defined)
  # above
  - xml://localhost:
    - tag: customer

  # The more elements you specify under a URL the more times the URL will
  # get replicated and used. Hence this entry actually could be considered
  # 2 URLs being called with just the destination email address changed:
  - mailto://george:password@gmail.com:
     - to: jason@hotmail.com
     - to: fred@live.com

  # Again... to re-iterate, the above mailto:// would actually fire two (2)
  # separate emails each with a different destination address specified.
  # Be careful when defining your arguments and differentiating between
  # when to use the dash (-) and when not to.  Each time you do, you will
  # cause another instance to be created.

  # Defining more then 1 element to a muti-set is easy, it looks like this:
  - mailto://jackson:abc123@hotmail.com:
     - to: jeff@gmail.com
       tag: jeff, customer

     - to: chris@yahoo.com
       tag: chris, customer
""",
        asset=asset,
    )

    # okay, here is how we get our total based on the above (read top-down)
    # +1  json:// entry
    # +1  xml:// entry
    # +2  mailto:// entry to jason@hotmail.com and fred@live.com
    # +2  mailto:// entry to jeff@gmail.com and chris@yahoo.com
    # = 6
    assert len(result) == 6

    # all six entries will have our global tags defined in them
    for entry in result:
        assert "admin" in entry.tags
        assert "devops" in entry.tags

    # Entries can be directly accessed as they were added

    # our json:// had no additional tags added; so just the global ones
    # So just 2; admin and devops (these were already validated above in the
    # for loop
    assert len(result[0].tags) == 2

    # our xml:// object has 1 tag added (customer)
    assert len(result[1].tags) == 3
    assert "customer" in result[1].tags

    # You get the idea, here is just a direct mapping to the remaining entries
    # in the same order they appear above
    assert len(result[2].tags) == 2
    assert len(result[3].tags) == 2

    assert len(result[4].tags) == 4
    assert "customer" in result[4].tags
    assert "jeff" in result[4].tags

    assert len(result[5].tags) == 4
    assert "customer" in result[5].tags
    assert "chris" in result[5].tags

    # There were no include entries defined
    assert len(config) == 0

    # Valid Configuration (multi inline configuration entries)
    result, config = ConfigBase.config_parse_yaml(
        """
# A configuration file that contains 2 includes separated by a comma and/or
# space:
include: http://localhost:8080/notify/apprise, http://localhost/apprise/cfg

""",
        asset=asset,
    )

    # We will have loaded no results
    assert isinstance(result, list)
    assert len(result) == 0

    # But our two configuration files will be present:
    assert len(config) == 2
    assert "http://localhost:8080/notify/apprise" in config
    assert "http://localhost/apprise/cfg" in config

    # Valid Configuration (another way of specifying more then one include)
    result, config = ConfigBase.config_parse_yaml(
        """
# A configuration file that contains 4 includes on their own
# lines beneath the keyword `include`:
include:
   http://localhost:8080/notify/apprise
   http://localhost/apprise/cfg01
   http://localhost/apprise/cfg02
   http://localhost/apprise/cfg03

""",
        asset=asset,
    )

    # We will have loaded no results
    assert isinstance(result, list)
    assert len(result) == 0

    # But our 4 configuration files will be present:
    assert len(config) == 4
    assert "http://localhost:8080/notify/apprise" in config
    assert "http://localhost/apprise/cfg01" in config
    assert "http://localhost/apprise/cfg02" in config
    assert "http://localhost/apprise/cfg03" in config

    # Test a configuration with an invalid schema with options
    result, config = ConfigBase.config_parse_yaml(
        """
    urls:
      - invalid://:
          tag: 'invalid'
          :name: 'Testing2'
          :body: 'test body2'
          :title: 'test title2'
""",
        asset=asset,
    )

    # We will have loaded no results
    assert isinstance(result, list)
    assert len(result) == 0

    # Valid Configuration (we allow comma separated entries for
    # each defined bullet)
    result, config = ConfigBase.config_parse_yaml(
        """
# A configuration file that contains 4 includes on their own
# lines beneath the keyword `include`:
include:
   - http://localhost:8080/notify/apprise, http://localhost/apprise/cfg01
     http://localhost/apprise/cfg02
   - http://localhost/apprise/cfg03

""",
        asset=asset,
    )

    # We will have loaded no results
    assert isinstance(result, list)
    assert len(result) == 0

    # But our 4 configuration files will be present:
    assert len(config) == 4
    assert "http://localhost:8080/notify/apprise" in config
    assert "http://localhost/apprise/cfg01" in config
    assert "http://localhost/apprise/cfg02" in config
    assert "http://localhost/apprise/cfg03" in config


def test_config_base_yaml_includes(
    requests_remote_config: Mock,
) -> None:
    """
    API: ConfigBase.config_parse_yaml_includes

    Verify that HTTP include entries are fetched via requests.get and that
    the remote config bodies are parsed into json:// and xml:// notifiers.
    """

    # general reference used below
    asset = AppriseAsset()

    # Initialize our apprise configuration
    ac = AppriseConfig(asset=asset, recursion=1)

    # Add our entry
    ac.add_config(
        cleandoc("""
        # Include our Apprise Configuration from 2 locations
        include:
           - http://localhost:8000/get/test-001
           - http://localhost:8000/get/test-002

        # no further URLs defined
    """)
    )

    # Force a fresh parse and get the loaded plugin
    services = ac.services()

    # the following will return
    assert len(services) == 3

    # representation for NotifyBase subclasses.
    urls = {n.url() for n in services}

    # The *exact* URL string may include extra params depending on defaults,
    # so we check using containment instead of strict equality.
    assert any(u.startswith("json://localhost") for u in urls)
    assert any(u.startswith("xml://localhost") for u in urls)
    assert any(u.startswith("form://localhost") for u in urls)


def test_yaml_vs_text_tagging():
    """
    API: ConfigBase YAML vs TEXT tagging
    """

    yaml_result, _ = ConfigBase.config_parse_yaml("""
    urls:
      - mailtos://lead2gold:yesqbrulvaelyxve@gmail.com:
         tag: mytag
    """)
    assert yaml_result

    text_result, _ = ConfigBase.config_parse_text("""
    mytag=mailtos://lead2gold:yesqbrulvaelyxve@gmail.com
    """)
    assert text_result

    # Now we compare our results and verify they are the same
    assert len(yaml_result) == len(text_result)
    assert isinstance(yaml_result[0], NotifyEmail)
    assert isinstance(text_result[0], NotifyEmail)
    assert "mytag" in text_result[0]
    assert "mytag" in yaml_result[0]


def test_config_base_config_tag_groups_yaml_01():
    """
    API: ConfigBase.config_tag_groups_yaml #1 object

    """

    # general reference used below
    asset = AppriseAsset()

    # Valid Configuration
    result, config = ConfigBase.config_parse_yaml(
        """
# if no version is specified then version 1 is presumed
version: 1

groups:
  - group1: tagB, tagC, tagNotAssigned
  - group2:
      - tagA
      - tagC
  - group3:
      - tagD: optional comment
      - tagA: optional comment #2

  # No assignment
  - group4

  # No assignment type 2
  - group5:

  # Integer assignment
  - group6: 3
  - group6: 3, 4, 5, test
  - group6: 3.5, tagC

  # Recursion
  - groupA: groupB
  - groupB: groupA
  # And Again... (just because)
  - groupA: groupB
  - groupB: groupA

  # Self assignment
  - groupX: groupX

  # Set up a larger recursive loop
  - groupG: groupH
  - groupH: groupI, groupJ
  - groupI: groupJ, groupG
  - groupJ: groupK, groupH, groupI
  - groupK: groupG

  # No tags assigned
  - groupK: ",,  , ,"
  - " , ": ",, , ,"

  # Multi Assignments
  - groupL, groupM: tagD, tagA
  - 4, groupN:
     - tagD
     - tagE, TagA

  # Add one more tag to groupL making it different then GroupM by 1
  - groupL: tagB
#
# Define your notification urls:
#
urls:
  - form://localhost:
     - tag: tagA
  - mailto://test:password@gmail.com:
     - tag: tagB
  - xml://localhost:
     - tag: tagC
  - json://localhost:
     - tag: tagD, tagA

""",
        asset=asset,
    )

    # We expect to parse 4 entries from the above
    assert isinstance(result, list)
    assert isinstance(config, list)
    assert len(result) == 4

    # Our first element is our group tags
    assert len(result[0].tags) == 5
    assert "group2" in result[0].tags
    assert "group3" in result[0].tags
    assert "groupl" in result[0].tags
    assert "groupm" in result[0].tags
    assert "taga" in result[0].tags

    # No additional configuration is loaded
    assert len(config) == 0

    apobj = Apprise()
    assert apobj.add(result)
    # We match against 1 entry
    assert len(list(apobj.find("tagA"))) == 2
    assert len(list(apobj.find("tagB"))) == 1
    assert len(list(apobj.find("tagC"))) == 1
    assert len(list(apobj.find("tagD"))) == 1
    assert len(list(apobj.find("group1"))) == 2
    assert len(list(apobj.find("group2"))) == 3
    assert len(list(apobj.find("group3"))) == 2
    assert len(list(apobj.find("group4"))) == 0
    assert len(list(apobj.find("group5"))) == 0
    # json:// -- group6 -> 4 -> TagA
    # xml://  -- group6 -> TagC
    assert len(list(apobj.find("group6"))) == 2
    assert len(list(apobj.find("4"))) == 1
    assert len(list(apobj.find("groupN"))) == 1


def test_config_base_config_tag_groups_yaml_02():
    """
    API: ConfigBase.config_tag_groups_yaml #2 object

    """

    # general reference used below
    asset = AppriseAsset()

    # Valid Configuration
    result, config = ConfigBase.config_parse_yaml(
        """
# if no version is specified then version 1 is presumed
version: 1

groups:
  group1: tagB, tagC, tagNotAssigned
  group2:
    - tagA
    - tagC
  group3:
    - tagD: optional comment
    - tagA: optional comment #2

  # No assignment type 2
  group5:

  # Integer assignment (since it's not a list, the last element prevails
  # and replaces the above); '4' does not get appended as it would in
  # the event this was a list instead
  group6: 3
  group6: 3, 4, 5, test
  group6: 3.5, tagC

  # Recursion
  groupA: groupB
  groupB: groupA
  # And Again... (just because)
  groupA: groupB
  groupB: groupA

  # Self assignment
  groupX: groupX

  # Set up a larger recursive loop
  groupG: groupH
  groupH: groupI, groupJ
  groupI: groupJ, groupG
  groupJ: groupK, groupH, groupI
  groupK: groupG

  # No tags assigned
  groupK: ",,  , ,"
  " , ": ",, , ,"

  # Multi Assignments
  groupL, groupM: tagD, tagA
  4, groupN:
   - tagD
   - tagE, TagA

  # Add one more tag to groupL making it different then GroupM by 1
  groupL: tagB
#
# Define your notification urls:
#
urls:
  - form://localhost:
     - tag: tagA
  - mailto://test:password@gmail.com:
     - tag: tagB
  - xml://localhost:
     - tag: tagC
  - json://localhost:
     - tag: tagD, tagA

""",
        asset=asset,
    )

    # We expect to parse 4 entries from the above
    assert isinstance(result, list)
    assert isinstance(config, list)
    assert len(result) == 4

    # Our first element is our group tags
    assert len(result[0].tags) == 5
    assert "group2" in result[0].tags
    assert "group3" in result[0].tags
    assert "groupl" in result[0].tags
    assert "groupm" in result[0].tags
    assert "taga" in result[0].tags

    # No additional configuration is loaded
    assert len(config) == 0

    apobj = Apprise()
    assert apobj.add(result)
    # We match against 1 entry
    assert len(list(apobj.find("tagA"))) == 2
    assert len(list(apobj.find("tagB"))) == 1
    assert len(list(apobj.find("tagC"))) == 1
    assert len(list(apobj.find("tagD"))) == 1
    assert len(list(apobj.find("group1"))) == 2
    assert len(list(apobj.find("group2"))) == 3
    assert len(list(apobj.find("group3"))) == 2
    assert len(list(apobj.find("group4"))) == 0
    assert len(list(apobj.find("group5"))) == 0
    # NOT json:// -- group6 -> 4 -> TagA (not appended because dict storage)
    #                          ^
    #                          |
    #            See: test_config_base_config_tag_groups_yaml_01 (above)
    #                 dict storage (as this tests for) causes last entry to
    #                 prevail; previous assignments are lost
    #
    # xml://  -- group6 -> TagC
    assert len(list(apobj.find("group6"))) == 1
    assert len(list(apobj.find("4"))) == 1
    assert len(list(apobj.find("groupN"))) == 1
    assert len(list(apobj.find("groupK"))) == 0


def test_config_base_config_parse_yaml_globals():
    """
    API: ConfigBase.config_parse_yaml globals

    """

    # general reference used below
    asset = AppriseAsset()

    # Invalid Syntax (throws a ScannerError)
    results, config = ConfigBase.config_parse_yaml(
        cleandoc("""
    urls:
      - jsons://localhost1:
         - to: jeff@gmail.com
           tag: jeff, customer
           cto: 30
           rto: 30
           verify: no

      - jsons://localhost2?cto=30&rto=30&verify=no:
         - to: json@gmail.com
           tag: json, customer
    """),
        asset=asset,
    )

    # Invalid data gets us an empty result set
    assert isinstance(results, list)

    # Our results loaded
    assert len(results) == 2
    assert len(config) == 0

    # Now verify that our global variables correctly initialized
    for entry in results:
        assert entry.verify_certificate is False
        assert entry.socket_read_timeout == 30
        assert entry.socket_connect_timeout == 30


# This test fails on CentOS 8.x so it was moved into it's own function
# so it could be bypassed. The ability to use lists in YAML files didn't
# appear to happen until later on; it's certainly not available in v3.12
# which was what shipped with CentOS v8 at the time.
@pytest.mark.skipif(
    int(yaml.__version__.split(".")[0]) <= 3,
    reason="requires pyaml v4.x or higher.",
)
def test_config_base_config_parse_yaml_list():
    """
    API: ConfigBase.config_parse_yaml list parsing

    """

    # general reference used below
    asset = AppriseAsset()

    # Invalid url/schema
    result, config = ConfigBase.config_parse_yaml(
        """
# no lists... just no
urls: [milk, pumpkin pie, eggs, juice]

# Including by list is okay
include: [file:///absolute/path/, relative/path, http://test.com]

""",
        asset=asset,
    )

    # Invalid data gets us an empty result set
    assert isinstance(result, list)
    assert len(result) == 0

    # There were 3 include entries
    assert len(config) == 3
    assert "file:///absolute/path/" in config
    assert "relative/path" in config
    assert "http://test.com" in config


def test_yaml_asset_timezone_and_asset_tokens(tmpdir):
    """
    Covers: valid tz, reserved keys, invalid key, bool coercion, None->"",
    invalid type for string, and %z formatting path used later by plugins.
    """
    cfg = tmpdir.join("asset-tz.yml")
    cfg.write(
        """
version: 1
asset:
  tz: "  america/toronto  "     # case-insensitive + whitespace cleanup
  _private: "ignored"           # reserved (starts with _)
  name_: "ignored"              # reserved (ends with _)
  not_a_field: "ignored"        # invalid asset key
  secure_logging: "yes"         # string -> bool via parse_bool
  app_id: null                  # None becomes empty string
  app_desc: [ "list" ]          # invalid type for string -> warning path
urls:
  - json://localhost
"""
    )

    ac = AppriseConfig(paths=str(cfg))
    # Force a fresh parse and get the loaded plugin
    services = ac.services()
    assert len(services) == 1

    plugin = services[0]
    asset = plugin.asset

    # tz was accepted and normalised
    # lower() is required since Mac and Window are not case sensitive and will
    # See output as it was passed in and not corrected per IANA
    assert getattr(asset.tzinfo, "key", None).lower() == "america/toronto"
    # boolean coercion applied
    assert asset.secure_logging is True
    # None -> ""
    assert asset.app_id == ""


def test_yaml_asset_language(tmpdir):
    """A YAML asset may set the language Apprise presents strings in."""

    def language_for(content):
        """Load ``content`` and return the language of its asset."""
        cfg = tmpdir.join("asset-lang.yml")
        cfg.write(content)
        services = AppriseConfig(paths=str(cfg)).services()
        assert len(services) == 1
        return services[0].asset.language

    # Accepted, and stored in its normalized form
    assert (
        language_for(
            """
version: 1
asset:
  language: "  ES-mx  "
urls:
  - json://localhost
"""
        )
        == "es_MX"
    )

    # lang is accepted as well
    assert (
        language_for(
            """
version: 1
asset:
  lang: fr
urls:
  - json://localhost
"""
        )
        == "fr"
    )

    # language wins when both are present
    assert (
        language_for(
            """
version: 1
asset:
  lang: fr
  language: de
urls:
  - json://localhost
"""
        )
        == "de"
    )

    # Anything we can not work with is ignored, leaving the system language
    for value in ('"garbage"', "null", "[ a, b ]", "42"):
        assert (
            language_for(
                f"""
version: 1
asset:
  lang: {value}
urls:
  - json://localhost
"""
            )
            is None
        )


def test_yaml_asset_timezone_invalid_and_precedence(tmpdir):
    """
    If 'timezone' is present but invalid, it takes precedence over 'tz'
    and MUST NOT set the asset to the 'tz' value. We assert that London
    was not applied. We deliberately avoid asserting the exact fallback,
    since environments may surface a system tz (datetime.timezone) that
    lacks a `.key` attribute.
    """
    cfg = tmpdir.join("asset-tz-invalid.yml")
    cfg.write(
        """
version: 1
asset:
  timezone: null                # invalid (will be seen as "None")
  tz: Europe/London             # would be valid, but 'timezone' wins
urls:
  - json://localhost
"""
    )

    base_asset = AppriseAsset(timezone="UTC")
    ac = AppriseConfig(paths=str(cfg))
    services = ac.services(asset=base_asset)
    assert len(services) == 1

    tzinfo = services[0].asset.tzinfo

    # The key assertion: 'tz' MUST NOT have been applied
    assert getattr(tzinfo, "key", "").lower() != "europe/london"

    # Sanity check that something sensible is set
    # Compare offsets at a fixed instant instead of object identity
    dt = datetime(2024, 1, 1, 12, 0, tzinfo=_tz.utc)
    assert tzinfo.utcoffset(dt) is not None


@pytest.mark.parametrize(
    "garbage_yaml",
    [
        "123",
        "3.1415",
        "true",
        "[UTC]",
        "{x: UTC}",
    ],
)
def test_yaml_asset_tz_garbage_types_only(tmpdir, garbage_yaml):
    """
    If only 'tz' is present and it is non-string, it is ignored.
    We assert it didn't become a real IANA zone (e.g., Europe/London),
    and that the tzinfo is usable.
    """
    cfg = tmpdir.join("asset-tz-garbage-only.yml")
    cfg.write(
        f"""
version: 1
asset:
  tz: {garbage_yaml}            # non-string -> warning path
urls:
  - json://localhost
"""
    )

    base_asset = AppriseAsset(timezone="UTC")
    ac = AppriseConfig(paths=str(cfg))
    services = ac.services(asset=base_asset)
    assert len(services) == 1

    tzinfo = services[0].asset.tzinfo

    # 1) Did not “accidentally” become a valid IANA from elsewhere.
    assert getattr(tzinfo, "key", "").lower() != "europe/london"

    # 2) tzinfo is usable (offset resolves at a fixed instant).
    dt = datetime(2024, 1, 1, 12, 0, tzinfo=_tz.utc)
    assert tzinfo.utcoffset(dt) is not None
    # also stable tzname resolution
    assert isinstance(tzinfo.tzname(dt), str)


def test_config_base_yaml_missing(monkeypatch):
    """YAML config loads nothing when PyYAML is not installed."""

    # A None entry in sys.modules makes import yaml raise ImportError.
    monkeypatch.setitem(sys.modules, "yaml", None)
    assert ConfigBase.config_parse_yaml("urls:\n  - json://localhost\n") == (
        [],
        [],
    )

    # URLs and text configuration still work.
    assert ConfigBase.config_parse_text("json://localhost")[0]


def test_config_base_yaml_tag_alias_dict(tmpdir):
    """
    API: ConfigBase.parse_yaml_file (#5)

    Validate `tags` is accepted as an alias of `tag` in the dict form:
      - "schema://...":
           tags: a-tag

    Also implicitly verifies `tags` does not leak into plugin kwargs, because
    plugin instantiation would fail if an unexpected kwarg is passed through.
    """
    t = tmpdir.mkdir("tags-alias-dict-form").join("apprise.yml")
    t.write("""urls:
  - pover://nsisxnvnqixq39t0cw54pxieyvtdd9@2jevtmstfg5a7hfxndiybasttxxfku:
      tags: test1
  - pover://rg8ta87qngcrkc6t4qbykxktou0uug@tqs3i88xlufexwl8t4asglt4zp5wfn:
      tags: test2
  - pover://jcqgnlyq2oetea4qg3iunahj8d5ijm@evalvutkhc8ipmz2lcgc70wtsm0qpb:
      tags: test3
""")

    ac = AppriseConfig(paths=str(t))

    # The number of configuration files that exist
    assert len(ac) == 1

    # All entries should load
    assert len(ac.services()) == 3

    a = Apprise()
    assert a.add(services=ac) is True
    assert len(a) == 3

    # Verify tag matching works
    assert sum(1 for _ in a.find("no-match")) == 0
    assert sum(1 for _ in a.find("all")) == 3
    assert sum(1 for _ in a.find("test1")) == 1
    assert sum(1 for _ in a.find("test2")) == 1
    assert sum(1 for _ in a.find("test3")) == 1
    assert sum(1 for _ in a.find("test1, test3")) == 2


def test_config_base_yaml_tag_alias_list(tmpdir):
    """
    API: ConfigBase.parse_yaml_file (#6)

    Validate `tags` is accepted as an alias of `tag` in the list-of-dicts form:
      - "schema://...":
          - tags: a-tag
          - tags: another-tag

    Expected behaviour: expands into multiple entries (one per list item),
    and each is tagged appropriately.
    """
    t = tmpdir.mkdir("tags-alias-list-form").join("apprise.yml")
    t.write("""urls:
  - pover://nsisxnvnqixq39t0cw54pxieyvtdd9@2jevtmstfg5a7hfxndiybasttxxfku:
    - tags: test1
    - tags: test2
  - pover://jcqgnlyq2oetea4qg3iunahj8d5ijm@evalvutkhc8ipmz2lcgc70wtsm0qpb:
    - tags: test3
""")

    ac = AppriseConfig(paths=str(t))

    # The number of configuration files that exist
    assert len(ac) == 1

    # First URL expands to 2, second expands to 1
    assert len(ac.services()) == 3

    a = Apprise()
    assert a.add(services=ac) is True
    assert len(a) == 3

    # Verify tag matching works across expanded entries
    assert sum(1 for _ in a.find("test1")) == 1
    assert sum(1 for _ in a.find("test2")) == 1
    assert sum(1 for _ in a.find("test3")) == 1
    assert sum(1 for _ in a.find("test1, test2")) == 2


def test_config_base_yaml_tag_priority(tmpdir):
    """
    API: ConfigBase.parse_yaml_file (#7)

    Validate priority: when both `tag` and `tags` are present, `tag` wins.

    This must remain true to preserve the original documented behaviour.
    """
    t = tmpdir.mkdir("tag-priority-over-tags").join("apprise.yml")
    t.write("""urls:
  - pover://nsisxnvnqixq39t0cw54pxieyvtdd9@2jevtmstfg5a7hfxndiybasttxxfku:
      tag: primary
      tags: secondary
""")

    ac = AppriseConfig(paths=str(t))

    # The number of configuration files that exist
    assert len(ac) == 1

    # Entry should load successfully
    assert len(ac.services()) == 1

    a = Apprise()
    assert a.add(services=ac) is True
    assert len(a) == 1

    # Tag priority check
    assert sum(1 for _ in a.find("primary")) == 1
    assert sum(1 for _ in a.find("secondary")) == 0


@pytest.mark.parametrize(
    "url",
    (
        "apprise://localhost/mykey?tags=devops",
        "opsgenie://apikey/?tags=devops",
        "pagertree://int_abcdefghij?tags=devops",
        "jira://apikey/?tags=devops",
    ),
)
def test_config_base_yaml_plugin_tags_kept(url):
    """
    API: ConfigBase.config_parse_yaml

    A plugin's own ?tags= reaches the plugin and never becomes a routing tag.
    """
    text_result, _ = ConfigBase.config_parse_text(url)
    yaml_result, _ = ConfigBase.config_parse_yaml(f"urls:\n  - {url}\n")

    assert len(text_result) == len(yaml_result) == 1
    for result in (text_result[0], yaml_result[0]):
        # No routing tag was derived from the URL
        assert not result.tags
        # The plugin kept its own tags
        assert "tags=devops" in result.url()

    # A `tag` key in the YAML sets the routing tag and leaves the plugin's
    # ?tags= alone
    yaml_result, _ = ConfigBase.config_parse_yaml(
        f"urls:\n  - {url}:\n      tag: local\n"
    )
    assert len(yaml_result) == 1
    assert yaml_result[0].tags == {"local"}
    assert "tags=devops" in yaml_result[0].url()

    # The list form behaves the same way for every expanded entry
    yaml_result, _ = ConfigBase.config_parse_yaml(
        f"urls:\n  - {url}:\n    - tag: one\n    - tag: two\n"
    )
    assert len(yaml_result) == 2
    assert {frozenset(r.tags) for r in yaml_result} == {
        frozenset({"one"}),
        frozenset({"two"}),
    }
    assert all("tags=devops" in r.url() for r in yaml_result)

    # Global tags are applied as routing tags only
    yaml_result, _ = ConfigBase.config_parse_yaml(
        f"tag: global\nurls:\n  - {url}\n"
    )
    assert len(yaml_result) == 1
    assert yaml_result[0].tags == {"global"}
    assert "tags=devops" in yaml_result[0].url()


def test_config_base_yaml_tags_key_still_alias():
    """
    API: ConfigBase.config_parse_yaml

    A `tags` key written in the YAML remains an alias of `tag`, even for a
    plugin that has its own `tags` argument.
    """
    yaml_result, _ = ConfigBase.config_parse_yaml(
        "urls:\n  - apprise://localhost/mykey:\n      tags: local\n"
    )
    assert len(yaml_result) == 1
    assert yaml_result[0].tags == {"local"}
    assert "tags=" not in yaml_result[0].url()


def test_yaml_sibling_token_overrides_basic():
    """
    API: ConfigBase - YAML sibling-key token overrides (basic cases).

    Keys at the same indentation level as the schema URL key
    (sibling form) must behave identically to child-indented tokens.
    Both of these forms must load the same plugin with the same attrs:

      # sibling form (same indentation)
      - mailtos://_:
        smtp: smtp.example.com
        from: sender@example.com

      # child form (one level deeper)
      - mailtos://_:
          smtp: smtp.example.com
          from: sender@example.com
    """
    # --- sibling form (the historically broken form) ---
    result_sibling, _ = ConfigBase.config_parse_yaml("""
urls:
  - mailtos://_:
    user: sender@example.com
    password: secret
    smtp: smtp.example.com
    from: sender@example.com
    to: recipient@example.com
    tag: myteam
""")

    # --- child form (always worked) ---
    result_child, _ = ConfigBase.config_parse_yaml("""
urls:
  - mailtos://_:
      user: sender@example.com
      password: secret
      smtp: smtp.example.com
      from: sender@example.com
      to: recipient@example.com
      tag: myteam
""")

    # Both forms must load exactly one plugin instance
    assert len(result_sibling) == 1
    assert len(result_child) == 1

    # Both results must be NotifyEmail instances
    assert isinstance(result_sibling[0], NotifyEmail)
    assert isinstance(result_child[0], NotifyEmail)

    for obj in (result_sibling[0], result_child[0]):
        # SMTP server from sibling/child token
        assert obj.smtp_host == "smtp.example.com"

        # from: maps to from_addr via template_args
        assert obj.from_addr[1] == "sender@example.com"

        # to: maps to targets
        assert any(t[1] == "recipient@example.com" for t in obj.targets)

        # password: sets the credential directly
        assert obj.password == "secret"

        # tag: applies correctly
        assert "myteam" in obj.tags


def test_yaml_sibling_token_priority_over_url():
    """
    API: ConfigBase - sibling tokens override URL-embedded values.

    Priority order (lowest to highest):
      3 - URL path (user:pass@host:port)
      2 - URL query string (?smtp=...)
      1 - YAML sibling/child tokens (highest)
    """
    # URL embeds one smtp server; sibling token overrides it
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - mailtos://sender@example.com?smtp=old.smtp.example.com:
    smtp: new.smtp.example.com
    to: recipient@example.com
    tag: priority-test
""")

    assert len(result) == 1
    assert isinstance(result[0], NotifyEmail)

    # Sibling token must win over the URL query-string value
    assert result[0].smtp_host == "new.smtp.example.com"
    assert "priority-test" in result[0].tags


def test_yaml_child_token_priority_over_sibling():
    """
    API: ConfigBase - child tokens (indented) override sibling tokens.

    When a URL entry has BOTH a child value (indented under the key)
    AND sibling keys, child tokens take priority on a per-key basis.
    """
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - mailtos://sender@example.com:
      smtp: child.smtp.example.com
    smtp: sibling.smtp.example.com
    to: recipient@example.com
""")

    assert len(result) == 1
    assert isinstance(result[0], NotifyEmail)

    # Child token (child.smtp.example.com) must beat sibling token
    assert result[0].smtp_host == "child.smtp.example.com"


def test_yaml_sibling_token_with_multiple_targets():
    """
    API: ConfigBase - multiple targets via sibling 'to:' token.

    'to:' in YAML tokens is a kwarg equivalent to ?to= in a URL.
    Multiple recipients must be expressed as a comma-separated string
    or as a YAML list under the 'to:' key -- NOT as multiple YAML
    entries each containing a separate 'to:' (that would create
    multiple plugin instances rather than one plugin with many targets).

    Both the comma-separated and YAML-list forms should resolve to a
    single plugin instance whose 'targets' list contains all recipients.
    """
    # Comma-separated form: equivalent to ?to=user1,user2 in the URL
    result_csv, _ = ConfigBase.config_parse_yaml("""
urls:
  - mailtos://sender@example.com:
    smtp: smtp.example.com
    to: user1@example.com, user2@example.com
    tag: shared
""")

    # YAML list form: same semantics, different syntax
    result_list, _ = ConfigBase.config_parse_yaml("""
urls:
  - mailtos://sender@example.com:
    smtp: smtp.example.com
    to:
      - user1@example.com
      - user2@example.com
    tag: shared
""")

    # Each form must load exactly one plugin instance
    assert len(result_csv) == 1
    assert len(result_list) == 1

    for obj in (result_csv[0], result_list[0]):
        assert isinstance(obj, NotifyEmail)

        # Sibling smtp: applies to the single instance
        assert obj.smtp_host == "smtp.example.com"

        # Both recipients must appear in targets
        assert any(t[1] == "user1@example.com" for t in obj.targets)
        assert any(t[1] == "user2@example.com" for t in obj.targets)

        # Sibling tag: applies correctly
        assert "shared" in obj.tags


def test_yaml_sibling_token_shared_across_list_expansion():
    """
    API: ConfigBase - sibling tokens propagate to every list-expansion entry.

    When the URL key has a YAML list as its child value (each list item
    becomes a separate plugin instance) AND sibling keys supply shared
    settings, the sibling tokens are applied as a base to every instance
    before per-entry overrides are merged.

    This is distinct from 'to: email1, email2' (multiple targets for one
    instance) -- here each list entry is an independent plugin instance
    with its own per-entry settings, all sharing the sibling tokens.
    """
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - mailtos://sender@example.com:
      - to: manager@example.com
        tag: boss
      - to: coworker@example.com
        tag: team
    smtp: smtp.example.com
""")

    # One plugin instance per list entry
    assert len(result) == 2
    assert all(isinstance(r, NotifyEmail) for r in result)

    # Sibling smtp: must be applied to every instance
    assert result[0].smtp_host == "smtp.example.com"
    assert result[1].smtp_host == "smtp.example.com"

    # Per-entry tags must be respected
    assert "boss" in result[0].tags
    assert "team" in result[1].tags


def test_yaml_sibling_token_per_entry_overrides_sibling():
    """
    API: ConfigBase - per-entry tokens override sibling tokens for same key.

    When a list-expansion entry defines the same key as a sibling token,
    the per-entry value wins for that instance only.  Other instances with
    no per-entry value for that key still receive the sibling fallback.

    Scenario:
      - sibling smtp: smtp1.example.com   (shared fallback for all entries)
      - entry 1: to=manager, tag=boss     (no per-entry smtp -> uses sibling)
      - entry 2: to=coworker, smtp=smtp2, tag=team  (overrides sibling smtp)

    Expected result: 2 instances, each with correct smtp and tags.
    """
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - mailtos://sender@example.com:
      - to: manager@example.com
        tag: boss
      - to: coworker@example.com
        smtp: smtp2.example.com
        tag: team
    smtp: smtp1.example.com
""")

    # One instance per list entry
    assert len(result) == 2
    assert all(isinstance(r, NotifyEmail) for r in result)

    # Instance 0: no per-entry smtp, so sibling smtp1 is used
    assert any(t[1] == "manager@example.com" for t in result[0].targets)
    assert result[0].smtp_host == "smtp1.example.com"
    assert "boss" in result[0].tags

    # Instance 1: per-entry smtp2 overrides the sibling smtp1
    assert any(t[1] == "coworker@example.com" for t in result[1].targets)
    assert result[1].smtp_host == "smtp2.example.com"
    assert "team" in result[1].tags


def test_yaml_sibling_alias_does_not_overwrite_child_canonical():
    """
    API: ConfigBase - child alias key wins over sibling canonical key.

    When a sibling provides a canonical key ('password') and the child dict
    provides the URL_TOKEN_ALIASES shorthand for the same key ('pass'), the
    child value must win.

    Before the fix, both dicts were merged raw before _special_token_handler()
    ran the URL_TOKEN_ALIASES step.  The combined dict contained both 'pass'
    and 'password', so the alias-conflict branch discarded 'pass' and kept
    the sibling's 'password' -- the wrong winner.

    The fix normalizes sibling and child token dicts separately first, so
    each alias is resolved in the context of its own dict only.  After
    normalization both dicts carry 'password', and the priority merge
    (sibling as base, child overrides) produces the correct winner.
    """
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - mailtos://sender@example.com:
      pass: child_pass
      to: recipient@example.com
    password: sibling_pass
""")

    # One instance created
    assert len(result) == 1
    assert isinstance(result[0], NotifyEmail)

    # Child 'pass' (alias) must win over sibling 'password' (canonical)
    assert result[0].password == "child_pass"


def test_yaml_alias_populates_null_canonical():
    """
    API: ConfigBase - alias populates canonical when canonical is null.

    """
    # canonical 'password:' is null (no value) + alias 'pass: secret'
    # alias must win because null == not provided
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - json://user@localhost:
      pass: secret
      password:
""")
    assert len(result) == 1
    assert result[0].password == "secret"

    # Canonical with a real value still wins over the alias
    result2, _ = ConfigBase.config_parse_yaml("""
urls:
  - json://user@localhost:
      pass: alias_val
      password: real_val
""")
    assert len(result2) == 1
    assert result2[0].password == "real_val"


def test_yaml_sibling_token_order_independent():
    """
    API: ConfigBase - sibling tokens are captured regardless of YAML key order.

    YAML does not guarantee mapping key order.  If a sibling token appears
    before the URL key in the mapping dict (e.g. due to editor or template
    quirks), it must still be captured.  The old dict(it) approach only
    captured items *after* the URL key in the iterator; the fix uses the
    full url.items() dict so all non-URL-key items are included.
    """
    # Write the YAML directly so the key order is explicit and no
    # yaml.dump call is required.  smtp appears BEFORE the URL key,
    # to appears AFTER -- both must be captured as sibling tokens.
    content = """
urls:
  - smtp: smtp.example.com
    mailtos://sender@example.com:
    to: recipient@example.com
"""

    result, _ = ConfigBase.config_parse_yaml(content)

    # Both pre-URL (smtp) and post-URL (to) siblings must be applied
    assert len(result) == 1
    assert isinstance(result[0], NotifyEmail)
    assert result[0].smtp_host == "smtp.example.com"
    assert any(t[1] == "recipient@example.com" for t in result[0].targets)


def test_yaml_sibling_password_token():
    """
    API: ConfigBase - 'password' and 'pass' keys both set plugin password.

    YAML tokens bypass parse_url(), so the URL-path shorthand 'pass' must
    be normalized to 'password' by URL_TOKEN_ALIASES inside
    _special_token_handler.  Verify that both spellings work in sibling
    and child indentation forms.
    """
    # --- 'password:' sibling form ---
    result_sibling, _ = ConfigBase.config_parse_yaml("""
urls:
  - json://testhost:
    user: alice
    password: s3cr3t
    tag: pw-test
""")

    # --- 'password:' child form ---
    result_child, _ = ConfigBase.config_parse_yaml("""
urls:
  - json://testhost:
      user: alice
      password: s3cr3t
      tag: pw-test
""")

    # --- 'pass:' sibling form (alias normalization) ---
    result_pass_sibling, _ = ConfigBase.config_parse_yaml("""
urls:
  - json://testhost:
    user: alice
    pass: s3cr3t
    tag: pw-test
""")

    # --- 'pass:' child form (alias normalization) ---
    result_pass_child, _ = ConfigBase.config_parse_yaml("""
urls:
  - json://testhost:
      user: alice
      pass: s3cr3t
      tag: pw-test
""")

    for result in (
        result_sibling,
        result_child,
        result_pass_sibling,
        result_pass_child,
    ):
        assert len(result) == 1

    for obj in (
        result_sibling[0],
        result_child[0],
        result_pass_sibling[0],
        result_pass_child[0],
    ):
        assert obj.user == "alice"
        assert obj.password == "s3cr3t"
        assert "pw-test" in obj.tags

    # When both 'pass:' and 'password:' appear, 'password:' (canonical) wins
    result_both, _ = ConfigBase.config_parse_yaml("""
urls:
  - json://testhost:
      user: alice
      password: canonical
      pass: shorthand
""")
    assert len(result_both) == 1
    assert result_both[0].password == "canonical"


def test_yaml_sibling_no_silent_drop_on_null_child():
    """
    API: ConfigBase - sibling tokens are never silently discarded.

    Previously, when the URL key had a null child value (the common
    case when users used same-level indentation), all sibling keys
    were silently ignored and the URL failed to instantiate.  Confirm
    that the failure mode described in issue #1635 no longer occurs.
    """
    # Mirrors the bug-report YAML (correcting 'rom' typo to 'from')
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - mailtos://_:
    user: sender@example.com
    password: secret
    smtp: smtp.example.com
    from: sender@example.com
    to: recipient@example.com
    tag:
      - dev
      - prod
""")

    # Must load successfully (previously raised TypeError and returned [])
    assert len(result) == 1
    assert isinstance(result[0], NotifyEmail)

    obj = result[0]
    assert obj.smtp_host == "smtp.example.com"
    assert obj.from_addr[1] == "sender@example.com"
    assert any(t[1] == "recipient@example.com" for t in obj.targets)
    assert "dev" in obj.tags
    assert "prod" in obj.tags


def test_yaml_sibling_token_unknown_schema():
    """
    API: ConfigBase - sibling tokens with an unregistered schema.

    When the schema is not in N_MGR the _special_token_handler call
    inside the 'elif sibling_tokens' branch is skipped (the False arm
    of 'if schema in N_MGR').  The branch still executes fully; it
    just applies sibling tokens as-is.  Because the schema is unknown
    no plugin is instantiated and the result list is empty.
    """
    # 'xyzunknown' is not a registered Apprise plugin, so the
    # 'if schema in N_MGR' guard evaluates to False.
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - xyzunknown://placeholder:
    mytoken: value
    otherkey: data
""")

    # The sibling branch ran (no exception), but no plugin loaded
    assert isinstance(result, list)
    assert len(result) == 0


def test_yaml_child_dict_schema_key_ignored():
    """
    API: ConfigBase - 'schema' key in a child dict token is stripped.

    The schema that determines which plugin is instantiated comes from the
    URL key itself.  Allowing a child dict to override 'schema' via a
    token would cause the wrong plugin constructor to be called with
    fields parsed for a different URL type, leading to silent failures.

    The list-expansion branch explicitly strips 'schema' from each entry.
    This test verifies the single-child-dict branch does the same.
    """
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - mailtos://sender@example.com:
      schema: json
      to: recipient@example.com
""")

    # The email plugin must load; the child 'schema: json' must be ignored
    assert len(result) == 1
    assert isinstance(result[0], NotifyEmail)


def test_yaml_sibling_before_url_no_spurious_warning():
    """
    API: ConfigBase - sibling tokens before the URL key emit no warning.

    YAML mappings do not guarantee key order.  A sibling token (e.g.
    'smtp:') may appear before the URL key in the serialised YAML.  The
    scan loop that finds the URL key must skip non-schema keys silently;
    it must NOT emit an 'Ignored entry' warning because those keys are
    collected later as valid sibling tokens.
    """
    from unittest import mock as _mock

    with _mock.patch("apprise.config.base.ConfigBase.logger") as mock_log:
        result, _ = ConfigBase.config_parse_yaml("""
urls:
  - smtp: smtp.example.com
    mailtos://sender@example.com:
    to: recipient@example.com
""")

    # Both siblings are applied; no spurious "Ignored entry" warning fired
    assert len(result) == 1
    assert isinstance(result[0], NotifyEmail)
    assert result[0].smtp_host == "smtp.example.com"
    assert any(t[1] == "recipient@example.com" for t in result[0].targets)

    # Confirm no "Ignored entry" warning was logged
    for call_args in mock_log.warning.call_args_list:
        assert "Ignored entry" not in str(call_args)


def test_yaml_token_priority_over_qsd():
    """
    API: ConfigBase - YAML tokens take priority over URL query-string params.

    The documented priority is: YAML tokens > ?key=value qsd > URL path.
    A second call to post_process_parse_url_results() runs after YAML tokens
    are merged.  Without stripping qsd first, that call would re-apply qsd
    overrides and silently overwrite YAML-token values, breaking the
    documented priority.
    """
    # The URL embeds ?pass= in the query string; the YAML sibling token
    # 'password:' should take priority and survive to the plugin.
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - json://user:urlpass@localhost?pass=qsdpass:
    password: yamlpass
""")
    assert len(result) == 1
    # YAML token must win over qsd ?pass= and URL-path password
    assert result[0].password == "yamlpass"


def test_yaml_token_priority_over_qsd_non_credential_fields():
    """
    API: ConfigBase - YAML tokens take priority over qsd for non-credential
    fields (verify, redirect, etc.).

    post_process_parse_url_results() processes not only user/password but
    also verify, redirect, rto, cto, and port from qsd.  All of these
    must honour the same YAML > qsd > URL-path priority rule.

    The fix strips ALL qsd (not just credential keys) before the second
    post_process call for URLBase-based plugins, so qsd can never
    overwrite any YAML-token value regardless of which field it sets.
    """
    # URL has ?verify=no but the YAML sibling says verify: yes --
    # YAML token must win; the plugin should have verify_certificate=True
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - json://user:pass@localhost?verify=no:
    verify: yes
""")
    assert len(result) == 1
    assert result[0].verify_certificate is True


def test_yaml_reapply_preserves_tags_and_asset():
    """The final YAML pass must not undo values assembled by ConfigBase.

    Both spellings of tags are normalized into one set and combined with the
    global tags. The asset is supplied by the caller and cannot be replaced by
    a same-named YAML option.
    """
    asset = AppriseAsset()
    result, _ = ConfigBase.config_parse_yaml(
        "tag: global\n"
        "urls:\n"
        "  - json://localhost/:\n"
        "      tags: local\n"
        "      asset: untrusted-value\n",
        asset=asset,
    )

    assert len(result) == 1
    assert result[0].tags == {"global", "local"}
    assert result[0].asset is asset


def test_yaml_priority_all_urlbase_globals_via_plugin_details():
    """
    API: ConfigBase - YAML priority verified dynamically for every
    URLBase-level global arg via plugin.details().

    Verify that the priority sequence (YAML > qsd > URL path)
    is respected for every global arg defined.
    """
    from apprise import plugins
    from apprise.config.base import N_MGR
    from apprise.url import URLBase

    # Discover args via plugin.details() for a minimal URLBase plugin.
    # json:// has no required service credentials and is always available.
    details = plugins.details(N_MGR["json"])

    # Type-driven conflict pairs: (qsd_str, yaml_str).
    # YAML should win -- expected value is derived from yaml_str.
    type_conflict = {
        "bool": ("no", "yes"),
        "float": ("5.0", "10.0"),
        "int": ("5", "10"),
    }

    # Intersect plugin.details() args with URLBase.template_args to
    # isolate the globals shared by every URLBase plugin.
    # _lookup_default is the URLBase instance attribute name for the arg.
    urlbase_meta = URLBase.template_args
    test_cases = []
    for name, arg_meta in details["args"].items():
        if name not in urlbase_meta:
            continue
        arg_type = arg_meta.get("type", "string")
        if arg_type not in type_conflict:
            continue
        attr_name = urlbase_meta[name].get("_lookup_default")
        if not attr_name:
            continue
        qsd_val, yaml_val = type_conflict[arg_type]
        test_cases.append((name, attr_name, arg_type, qsd_val, yaml_val))

    # Guard: the 4 known URLBase globals must always be discovered.
    # If URLBase.template_args loses an entry this fires immediately.
    found = {t[0] for t in test_cases}
    assert found >= {"cto", "redirect", "rto", "verify"}, (
        "Expected URLBase globals cto/redirect/rto/verify in "
        "plugin.details(); got: {}".format(sorted(found))
    )

    # Build a YAML config that sets every global in both qsd AND as a
    # YAML sibling token with a conflicting value so the winner is
    # unambiguous.
    qsd_str = "&".join("{}={}".format(n, qv) for n, _, _, qv, _ in test_cases)
    siblings = "\n    ".join(
        "{}: {}".format(n, yv) for n, _, _, _, yv in test_cases
    )
    yaml_cfg = (
        "urls:\n  - json://user:pass@localhost?{qsd}:\n    {siblings}\n"
    ).format(qsd=qsd_str, siblings=siblings)

    result, _ = ConfigBase.config_parse_yaml(yaml_cfg)
    assert len(result) == 1
    inst = result[0]

    # Verify YAML wins for every global.
    for name, attr_name, arg_type, qsd_val, yaml_val in test_cases:
        actual = getattr(inst, attr_name)
        if arg_type == "bool":
            expected = True  # yaml_val is always "yes"
        elif arg_type == "float":
            expected = float(yaml_val)
        elif arg_type == "int":
            expected = int(yaml_val)
        else:
            expected = yaml_val
        assert actual == expected, (
            "YAML token '{}' should override qsd "
            "(YAML={!r}, qsd={!r}) but got {!r} for '{}'".format(
                name, yaml_val, qsd_val, actual, attr_name
            )
        )


def test_yaml_url_token_map_to():
    """ConfigBase maps named URL parts used as YAML keys."""
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - discord://1234567890/abcdefghijklmnopqrstuvwxyz/:
      - tag: test1
        botname: App 1
        avatar_url: https://localhost/app1.png
      - tag: test2
        botname: App 2
        avatar_url: https://localhost/app2.png
""")

    assert len(result) == 2
    assert result[0].user == "App 1"
    assert result[0].avatar_url == "https://localhost/app1.png"
    assert result[1].user == "App 2"
    assert result[1].avatar_url == "https://localhost/app2.png"

    # The sibling (non-indented) form works the same way
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - discord://1234567890/abcdefghijklmnopqrstuvwxyz/:
    botname: App 3
""")

    assert len(result) == 1
    assert result[0].user == "App 3"

    # A YAML key that is neither an argument nor a URL token is left alone
    tokens = ConfigBase._special_token_handler(
        "discord", {"botname": "App 4", "not-a-token": "ignored"}
    )
    assert tokens["user"] == "App 4"
    assert "botname" not in tokens
    assert tokens["not-a-token"] == "ignored"


def test_yaml_token_alias_chains():
    """ConfigBase follows YAML aliases to constructor arguments."""
    # sogs `key` -> `user` (URL token) -> `public_key` (constructor arg)
    tokens = ConfigBase._special_token_handler("sogs", {"key": "abc"})
    assert tokens == {"public_key": "abc"}

    # The URL token name itself resolves to the same place
    tokens = ConfigBase._special_token_handler("sogs", {"user": "abc"})
    assert tokens == {"public_key": "abc"}

    # ringcentral `from_phone` (URL token) -> `source` (constructor arg)
    tokens = ConfigBase._special_token_handler(
        "ringc", {"from_phone": "+15551234567"}
    )
    assert tokens == {"source": "+15551234567"}


def test_yaml_token_multi_alias():
    """ConfigBase skips shortcuts that represent several URL values."""
    tokens = ConfigBase._special_token_handler(
        "slack", {"token": "T1JJ3T3L2/A1BRTD4JD/TIiajkdnlazkcOXrIdevi7FQ"}
    )
    assert tokens == {}

    # The same key in a real configuration does not break the parse
    result, _ = ConfigBase.config_parse_yaml("""
urls:
  - slack://T1JJ3T3L2/A1BRTD4JD/TIiajkdnlazkcOXrIdevi7FQ/#general:
      token: ignored
""")

    assert len(result) == 1
caronc-apprise-dfec414/tests/test_config_file.py000066400000000000000000000077061526720371000221500ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
import logging
from unittest import mock

from apprise import AppriseAsset
from apprise.config.file import ConfigFile
from apprise.plugins import NotifyBase

logging.disable(logging.CRITICAL)


def test_config_file(tmpdir):
    """
    API: ConfigFile() object

    """

    assert ConfigFile.parse_url("garbage://") is None

    # Test cases where our URL is invalid
    t = tmpdir.mkdir("testing").join("apprise")
    t.write("gnome://")

    assert ConfigFile.parse_url("file://?") is None

    # Create an Apprise asset we can reference
    asset = AppriseAsset()

    # Initialize our object
    cf = ConfigFile(path=str(t), format="text", asset=asset)

    # one entry added
    assert len(cf) == 1

    assert isinstance(cf.url(), str) is True

    # Verify that we're using the same asset
    assert cf[0].asset is asset

    # Testing of pop
    cf = ConfigFile(path=str(t), format="text")

    ref = cf[0]
    assert isinstance(ref, NotifyBase) is True

    ref_popped = cf.pop(0)
    assert isinstance(ref_popped, NotifyBase) is True

    assert ref == ref_popped

    assert len(cf) == 0

    # reference to calls on initial reference
    cf = ConfigFile(path=str(t), format="text")
    assert isinstance(cf.pop(0), NotifyBase) is True

    cf = ConfigFile(path=str(t), format="text")
    assert isinstance(cf[0], NotifyBase) is True
    # Second reference actually uses cache
    assert isinstance(cf[0], NotifyBase) is True

    cf = ConfigFile(path=str(t), format="text")
    # Itereator creation (nothing needed to assert here)
    iter(cf)
    # Second reference actually uses cache
    iter(cf)

    # Cache Handling; cache each request for 30 seconds
    results = ConfigFile.parse_url(f"file://{t!s}?cache=30")
    assert isinstance(results, dict)
    cf = ConfigFile(**results)
    assert isinstance(cf.url(), str) is True
    assert isinstance(cf.read(), str) is True


def test_config_file_exceptions(tmpdir):
    """
    API: ConfigFile() i/o exception handling

    """

    # Test cases where our URL is invalid
    t = tmpdir.mkdir("testing").join("apprise")
    t.write("gnome://")

    # Initialize our object
    cf = ConfigFile(path=str(t), format="text")

    # Internal Exception would have been thrown and this would fail
    with mock.patch("builtins.open", side_effect=OSError):
        assert cf.read() is None

    # handle case where the file is to large for what was expected:
    max_buffer_size = cf.max_buffer_size
    cf.max_buffer_size = 1
    assert cf.read() is None

    # Restore default value
    cf.max_buffer_size = max_buffer_size
caronc-apprise-dfec414/tests/test_config_http.py000066400000000000000000000300001526720371000221670ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
import logging
import time
from typing import ClassVar
from unittest import mock

import pytest
import requests

from apprise import NotificationManager
from apprise.common import ConfigFormat
from apprise.config.http import ConfigHTTP
from apprise.exception import AppriseImproperlyConfigured
from apprise.plugins import NotifyBase

logging.disable(logging.CRITICAL)

# Grant access to our Notification Manager Singleton
N_MGR = NotificationManager()

# Some exception handling we'll use
REQUEST_EXCEPTIONS = (
    requests.ConnectionError(0, "requests.ConnectionError() not handled"),
    requests.RequestException(0, "requests.RequestException() not handled"),
    requests.HTTPError(0, "requests.HTTPError() not handled"),
    requests.ReadTimeout(0, "requests.ReadTimeout() not handled"),
    requests.TooManyRedirects(0, "requests.TooManyRedirects() not handled"),
)


@mock.patch("requests.post")
def test_config_http(mock_post):
    """
    API: ConfigHTTP() object

    """

    # Define our good:// url
    class GoodNotification(NotifyBase):
        def __init__(self, *args, **kwargs):
            super().__init__(*args, **kwargs)

        def notify(self, *args, **kwargs):
            # Pretend everything is okay
            return True

        def url(self, **kwargs):
            # Support url() function
            return ""

    # Store our good notification in our schema map
    N_MGR["good"] = GoodNotification

    # Our default content
    default_content = """taga,tagb=good://server01"""

    class DummyResponse:
        """A dummy response used to manage our object."""

        status_code = requests.codes.ok
        headers: ClassVar[dict[str, str]] = {
            "Content-Length": str(len(default_content)),
            "Content-Type": "text/plain",
        }

        text = default_content

        # Pointer to file
        ptr = None

        def close(self):
            return

        def raise_for_status(self):
            return

        def __enter__(self):
            return self

        def __exit__(self, *args, **kwargs):
            return

    # Prepare Mock
    dummy_response = DummyResponse()
    mock_post.return_value = dummy_response

    assert ConfigHTTP.parse_url("garbage://") is None

    results = ConfigHTTP.parse_url("http://user:pass@localhost?+key=value")
    assert isinstance(results, dict)
    ch = ConfigHTTP(**results)
    assert isinstance(ch.url(), str) is True
    assert isinstance(ch.read(), str) is True

    # one entry added
    assert len(ch) == 1

    # Password-only administrator credentials preserve the empty username.
    results = ConfigHTTP.parse_url("http://:pass@localhost/path/")
    assert isinstance(results, dict)
    ch = ConfigHTTP(**results)
    assert ch.url(privacy=False).startswith("http://:pass@localhost/path/")
    assert isinstance(ch.read(), str) is True
    assert mock_post.call_args.kwargs["auth"] == ("", "pass")

    results = ConfigHTTP.parse_url("http://localhost:8080/path/")
    assert isinstance(results, dict)
    ch = ConfigHTTP(**results)
    assert isinstance(ch.url(), str) is True
    assert isinstance(ch.read(), str) is True

    # one entry added
    assert len(ch) == 1

    # Clear all our mock counters
    mock_post.reset_mock()

    # Cache Handling; cache each request for 30 seconds
    results = ConfigHTTP.parse_url("http://localhost:8080/path/?cache=30")
    assert mock_post.call_count == 0
    assert isinstance(ch.url(), str) is True

    assert isinstance(results, dict)
    ch = ConfigHTTP(**results)
    assert mock_post.call_count == 0

    assert isinstance(ch.url(), str) is True
    assert mock_post.call_count == 0

    assert isinstance(ch.read(), str) is True
    assert mock_post.call_count == 1

    # Clear all our mock counters
    mock_post.reset_mock()

    # Behind the scenes we haven't actually made a fetch yet. We can consider
    # our content expired at this point
    assert ch.expired() is True

    # Test using boolean check; this will force a remote fetch
    assert ch

    # Now a call was made
    assert mock_post.call_count == 1
    mock_post.reset_mock()

    # Our content hasn't expired yet (it's good for 30 seconds)
    assert ch.expired() is False
    assert len(ch) == 1
    assert mock_post.call_count == 0

    # Test using boolean check; we will re-use our cache and not
    # make another remote request
    mock_post.reset_mock()
    assert ch
    assert len(ch.services()) == 1
    assert len(ch) == 1

    # No remote post has been made
    assert mock_post.call_count == 0

    with mock.patch("time.time", return_value=time.time() + 10):
        # even with 10 seconds elapsed, no fetch will be made
        assert ch.expired() is False
        assert ch
        assert len(ch.services()) == 1
        assert len(ch) == 1

    # No remote post has been made
    assert mock_post.call_count == 0

    with mock.patch("time.time", return_value=time.time() + 31):
        # but 30+ seconds from now is considered expired
        assert ch.expired() is True
        assert ch
        assert len(ch.services()) == 1
        assert len(ch) == 1

    # Our content would have been renewed with a single new fetch
    assert mock_post.call_count == 1

    # one entry added
    assert len(ch) == 1

    # Invalid cache
    results = ConfigHTTP.parse_url("http://localhost:8080/path/?cache=False")
    assert isinstance(results, dict)
    assert isinstance(ch.url(), str) is True

    results = ConfigHTTP.parse_url("http://localhost:8080/path/?cache=-10")
    assert isinstance(results, dict)
    with pytest.raises(AppriseImproperlyConfigured):
        ch = ConfigHTTP(**results)

    results = ConfigHTTP.parse_url("http://user@localhost?format=text")
    assert isinstance(results, dict)
    ch = ConfigHTTP(**results)
    assert isinstance(ch.url(), str) is True
    assert isinstance(ch.read(), str) is True

    # one entry added
    assert len(ch) == 1

    results = ConfigHTTP.parse_url("https://localhost")
    assert isinstance(results, dict)
    ch = ConfigHTTP(**results)
    assert isinstance(ch.url(), str) is True
    assert isinstance(ch.read(), str) is True

    # one entry added
    assert len(ch) == 1

    # Testing of pop
    ch = ConfigHTTP(**results)

    ref = ch[0]
    assert isinstance(ref, NotifyBase) is True

    ref_popped = ch.pop(0)
    assert isinstance(ref_popped, NotifyBase) is True

    assert ref == ref_popped

    assert len(ch) == 0

    # reference to calls on initial reference
    ch = ConfigHTTP(**results)
    assert isinstance(ch.pop(0), NotifyBase) is True

    ch = ConfigHTTP(**results)
    assert isinstance(ch[0], NotifyBase) is True
    # Second reference actually uses cache
    assert isinstance(ch[0], NotifyBase) is True

    ch = ConfigHTTP(**results)
    # Itereator creation (nothing needed to assert here)
    iter(ch)
    # Second reference actually uses cache
    iter(ch)

    # Test a buffer size limit reach
    ch.max_buffer_size = len(dummy_response.text)
    assert isinstance(ch.read(), str) is True

    # Test YAML detection
    yaml_supported_types = (
        "text/yaml",
        "text/x-yaml",
        "application/yaml",
        "application/x-yaml",
    )

    for st in yaml_supported_types:
        dummy_response.headers["Content-Type"] = st
        ch.default_config_format = None
        assert isinstance(ch.read(), str) is True
        # Set to YAML
        assert ch.default_config_format == ConfigFormat.YAML

    # Test TEXT detection
    text_supported_types = ("text/plain", "text/html")

    for st in text_supported_types:
        dummy_response.headers["Content-Type"] = st
        ch.default_config_format = None
        assert isinstance(ch.read(), str) is True
        # Set to TEXT
        assert ch.default_config_format == ConfigFormat.TEXT

    # The type is never adjusted to mime types we don't understand
    ukwn_supported_types = ("text/css", "application/zip")

    for st in ukwn_supported_types:
        dummy_response.headers["Content-Type"] = st
        ch.default_config_format = None
        assert isinstance(ch.read(), str) is True
        # Remains unchanged
        assert ch.default_config_format is None

    # When the entry is missing; we handle this too
    del dummy_response.headers["Content-Type"]
    ch.default_config_format = None
    assert isinstance(ch.read(), str) is True
    # Remains unchanged
    assert ch.default_config_format is None

    # Restore our content type object for lower tests
    dummy_response.headers["Content-Type"] = "text/plain"

    # Take a snapshot
    max_buffer_size = ch.max_buffer_size

    ch.max_buffer_size = len(dummy_response.text) - 1
    assert ch.read() is None

    # Restore buffer size count
    ch.max_buffer_size = max_buffer_size

    # Test erroneous Content-Length
    # Our content is still within the limits, so we're okay
    dummy_response.headers["Content-Length"] = "garbage"

    assert isinstance(ch.read(), str) is True

    dummy_response.headers["Content-Length"] = "None"
    # Our content is still within the limits, so we're okay
    assert isinstance(ch.read(), str) is True

    # Handle cases where the content length is exactly at our limit
    dummy_response.text = "a" * ch.max_buffer_size
    # This is acceptable
    assert isinstance(ch.read(), str) is True

    # If we are over our limit though..
    dummy_response.text = "b" * (ch.max_buffer_size + 1)
    assert ch.read() is None

    # Test an invalid return code
    dummy_response.status_code = 400
    assert ch.read() is None
    ch.max_error_buffer_size = 0
    assert ch.read() is None

    # Test that a 3xx redirect is rejected when redirect=no is set; a
    # status-code range guard (300-399) catches what raise_for_status() misses.
    class RedirectResponse:
        """Simulates a 301 response returned when allow_redirects=False."""

        status_code = requests.codes.moved_permanently
        headers: ClassVar[dict[str, str]] = {}
        text = ""

        def raise_for_status(self):
            return

        def __enter__(self):
            return self

        def __exit__(self, *args, **kwargs):
            return

    mock_post.return_value = RedirectResponse()
    results = ConfigHTTP.parse_url("http://localhost/?redirect=no")
    assert isinstance(results, dict)
    ch_no_redir = ConfigHTTP(**results)
    assert ch_no_redir.redirects is False
    # read() must return None -- returning redirect HTML as config is wrong
    assert ch_no_redir.read() is None
    # Restore for downstream tests
    mock_post.return_value = dummy_response

    # Exception handling
    for exception in REQUEST_EXCEPTIONS:
        mock_post.side_effect = exception
        assert ch.read() is None

    # Restore buffer size count
    ch.max_buffer_size = max_buffer_size
caronc-apprise-dfec414/tests/test_config_memory.py000066400000000000000000000043711526720371000225340ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

# Disable logging for a cleaner testing output
import logging

from apprise.config.memory import ConfigMemory

logging.disable(logging.CRITICAL)


def test_config_memory():
    """
    API: ConfigMemory() object

    """

    assert ConfigMemory.parse_url("garbage://") is None

    # Initialize our object
    cm = ConfigMemory(content="json://localhost", format="text")

    # one entry added
    assert len(cm) == 1

    # Test general functions
    assert isinstance(cm.url(), str)
    assert isinstance(cm.read(), str)

    # Test situation where an auto-detect is required:
    cm = ConfigMemory(content="json://localhost")

    # one entry added
    assert len(cm) == 1

    # Test general functions
    assert isinstance(cm.url(), str)
    assert isinstance(cm.read(), str)

    # Test situation where we can not detect the data
    assert len(ConfigMemory(content="garbage")) == 0
caronc-apprise-dfec414/tests/test_conversion.py000066400000000000000000005133501526720371000220660ustar00rootroot00000000000000# BSD 2-Clause License
#
# Apprise - Push Notification Library.
# Copyright (c) 2026, Chris Caron 
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# 1. Redistributions of source code must retain the above copyright notice,
#    this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright notice,
#    this list of conditions and the following disclaimer in the documentation
#    and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.

from inspect import cleandoc

# Disable logging for a cleaner testing output
import logging
from timeit import default_timer
from unittest import mock

import pytest

from apprise import NotifyFormat
from apprise.conversion import (
    BLOCKQUOTE_DEPTH_MAX,
    LIST_DEPTH_MAX,
    MAX_FRAME_DEPTH,
    HTMLMarkdownConverter,
    HTMLTagReducer,
    commonmark as commonmark_module,
    commonmark_can_close_emphasis,
    commonmark_can_open_emphasis,
    commonmark_decode_backslash_escapes,
    commonmark_emphasis_run,
    commonmark_find_backtick_run,
    commonmark_headings_to_bold,
    commonmark_index_backtick_runs,
    commonmark_match_emphasis,
    commonmark_materialize_repair,
    commonmark_pick_emphasis_sentinel,
    commonmark_render_emphasis_events,
    commonmark_render_emphasis_markers,
    commonmark_repair_chunk,
    commonmark_scan_autolink_dest,
    commonmark_scan_closer_runs,
    commonmark_scan_delimiter_run,
    commonmark_scan_paren_dest,
    commonmark_scan_repair_region,
    commonmark_sections,
    convert_between,
    html_to_markdown,
    markdown_to_html,
    split_dialect_chunk,
    truncate_dialect_chunk,
)
from apprise.plugins.google_chat import NotifyGoogleChat
from apprise.plugins.pushover import PushoverHTMLReducer
from apprise.plugins.slack import NotifySlack
from apprise.plugins.telegram import TelegramHTMLReducer

logging.disable(logging.CRITICAL)


def test_conversion_html_to_text():
    """conversion: Test HTML to plain text"""

    def to_html(body):
        """A function to simply html conversion tests."""
        return convert_between(NotifyFormat.HTML, NotifyFormat.TEXT, body)

    assert to_html("No HTML code here.") == "No HTML code here."

    clist = to_html("
    • Lots and lots
    • of lists.
    ")
    assert "Lots and lots" in clist
    assert "of lists." in clist

    assert "To be or not to be." in to_html(
        "
    To be or not to be.
    "
    )

    cspace = to_html(
        "
    Fancy heading
    And a paragraph too.
    Plus line break.
    "
    )
    assert "Fancy heading" in cspace
    assert "And a paragraph too.\nPlus line break." in cspace

    assert (
        to_html(
            ""
            "
    Some obnoxious text here.
    "
        )
        == "Some obnoxious text here."
    )

    assert (
        to_html("
    line 1
    line 2
    line 3
    ")
        == "line 1\nline 2\nline 3"
    )

    # Case sensitivity
    assert (
        to_html("
    line 1
    line 2
    line 3
    ")
        == "line 1\nline 2\nline 3"
    )

    # double new lines (testing 
     and 
    )
    assert (
        to_html("some information

    and more information")
        == "some information\n\nand more information"
    )

    #
    # Test bad tags
    #

    # first 2 entries are okay, but last will do as best as it can
    assert (
        to_html("
    line 1
    line 2
    line 3>")
        == "line 1\nline 2\nline 3>"
    )

    # Make sure we ignore fields that aren't important to us
    assert (
        to_html(
            ""
            "
    line 1
    "
            "Another line without being enclosed"
        )
        == "line 1\nAnother line without being enclosed"
    )

    # Test cases when there are no new lines (we're dealing with just inline
    # entries); an empty entry as well
    assert (
        to_html("test my link")
        == "test my link"
    )

    # 
     missing
    assert (
        to_html(
            "
    line 1 bold
      "
            " my link"
            "
    3rd line"
        )
        == "line 1 bold\nmy link\n3rd line"
    )

    # 
     on it's own
    assert to_html("
    ") == "---"
    assert to_html("
    ") == "---"

    # We need to handle HTML Encodings
    assert (
        to_html("""
        
            ignore this entry
        
          Let's handle special html encoding
          
    
        
        """)
        == "Let's handle special html encoding\n---"
    )

    # If you give nothing, you get nothing in return
    assert to_html("") == ""

    # Special case on HR tag
    assert (
        to_html("""
        
            
            
                
    FROM: apprise-test@mydomain.yyy
                
    
                Hi!
    
                How are you?
    
red font
link you wanted.
    
            
        
        """)
        == "FROM: apprise-test@mydomain.yyy\nHi!\n How are you?\n red font"
        " link you wanted."
    )

    assert (
        to_html("""
        
            
            
                
    FROM: apprise-test@mydomain.yyy
                    
    
                Hi!
    
                How are you?
    
red font
link you wanted.
    
            
        
        """)
        == "FROM: apprise-test@mydomain.yyy\n---\nHi!\n How are you?\n red"
        " font link you wanted."
    )

    # Special case on HR if text is sorrunded by HR tags
    # its created a dict element
    assert (
        to_html("""
        
            
            
                
    FROM: apprise-test@mydomain.yyy
                    
    
                Hi!
    
                How are you?
    
red font
link you wanted.
    
            
        
        """)
        == "---\nFROM: apprise-test@mydomain.yyy\n---\nHi!\n How are you?\n"
        " red font link you wanted."
    )

    assert (
        to_html("""
        
            
            
                
    
                    
    TEST
    
                
    
                Hi!
    
                How are you?
    
red font
link you wanted.
    
            
            
        """)
        == "---\nTEST\n---\nHi!\n How are you?\n red font link you wanted."
    )

    with pytest.raises(TypeError):
        # Invalid input
        assert to_html(None)

    with pytest.raises(TypeError):
        # Invalid input
        assert to_html(42)

    with pytest.raises(TypeError):
        # Invalid input
        assert to_html(object)


def test_conversion_html_to_text_pre():
    """conversion: Test HTML to plain text keeps 
     formatting"""

    def to_html(body):
        """A function to simply html conversion tests."""
        return convert_between(NotifyFormat.HTML, NotifyFormat.TEXT, body)

    # Line breaks inside 
     are kept
    assert to_html("
    a\nb
    ") == "a\nb"

    # Line breaks and indentation of the lines after the first are kept
    trace = (
        "Traceback (most recent call last):\n"
        '  File "x.py", line 1\n'
        "    raise E\n"
        "E: boom"
    )
    assert to_html(f"
    {trace}
    ") == trace
    assert to_html(f"
    {trace}
    ") == trace

    # Text around the block is converted as before
    assert (
        to_html("
    intro
    x\n  y
    outro
    ")
        == "intro\nx\n  y\noutro"
    )

    # Tags nested in 
     stay part of the preformatted region
    assert to_html("
    a\n  b
    ") == "a\n  b"
    assert to_html("
    a\n  b\n    c\n  d
    ") == (
        "a\n  b\n    c\n  d"
    )

    # Windows line breaks are normalized
    assert to_html("
    a\r\n  b\r\n    c
    ") == "a\n  b\n    c"

    # Whitespace outside of 
     is still condensed
    assert to_html("
    x  \n  y
    a
      b \n  c") == "x y\na\nb c"
    assert to_html("
    a\n b
    c\n  d
    ") == "a\n b\nc d"

    # The Markdown conversion is not affected
    assert html_to_markdown("
    a\n  b
    ") == "```\na\n  b\n```"


def test_conversion_html_to_markdown():
    """Test basic HTML-to-Markdown conversion."""

    def to_md(body):
        """Wrapper to simplify html-to-markdown conversion tests."""
        return convert_between(NotifyFormat.HTML, NotifyFormat.MARKDOWN, body)

    # Plain text with no HTML passes through unchanged
    assert to_md("No HTML code here.") == "No HTML code here."

    # Empty string in, empty string out
    assert to_md("") == ""

    # Paragraphs need a full blank line between them.
    assert (
        to_md("
    line 1
    line 2
    line 3
    ")
        == "line 1\n\nline 2\n\nline 3"
    )

    # Case sensitivity -- tag names are case-insensitive in HTML
    assert (
        to_md("
    line 1
    line 2
    line 3
    ")
        == "line 1\n\nline 2\n\nline 3"
    )

    # HTMLParser lowercases ALL tag names -- inline tags included
    assert to_md("bold text") == "**bold text**"
    assert to_md("italic") == "*italic*"

    # Uppercase self-closing 
     tags also produce CommonMark hard breaks.
    assert (
        to_md("line one
    line two
    line three")
        == "line one  \nline two  \nline three"
    )

    # 
     and self-closing 
     both emit a hard break
    assert (
        to_md("some information

    and more information")
        == "some information  \n  \nand more information"
    )

    # Each heading level maps to the correct number of # characters
    assert to_md("
    Heading 1
    ") == "# Heading 1"
    assert to_md("
    Heading 2
    ") == "## Heading 2"
    assert to_md("
    Heading 3
    ") == "### Heading 3"
    assert to_md("
    Heading 4
    ") == "#### Heading 4"
    assert to_md("
    Heading 5
    ") == "##### Heading 5"
    assert to_md("
    Heading 6
    ") == "###### Heading 6"

    # Multiple headings and paragraphs together
    assert to_md(
        "
    Heading 1
    "
        "
    Heading 2
    "
        "
    Heading 3
    "
        "
    Heading 4
    "
        "
    Heading 5
    "
        "
    Heading 6
    "
        "
    line 1"
        "
    line 2"
        "
    line 3>"
    ) == (
        "# Heading 1\n## Heading 2\n### Heading 3\n"
        "#### Heading 4\n##### Heading 5\n###### Heading 6\n\n"
        "line 1\n\n*line 2*\n\nline 3\\>"
    )

    #  and  both produce bold markers
    assert to_md("bold text") == "**bold text**"
    assert to_md("bold text") == "**bold text**"

    #  and  both produce italic markers
    assert to_md("italic") == "*italic*"
    assert to_md("italic") == "*italic*"

    # Angle destinations prevent parentheses in an href from ending links.
    assert (
        to_md(
            "
    line 1 bold
     "
            " my link"
            "
    3rd line"
        )
        == "line 1 **bold**\n\n[my link]()\n\n3rd line"
    )

    #  produces Markdown link syntax
    assert (
        to_md("test my link")
        == "test [my link](<#>)"
    )

    #  with nested inline markup -- the href must survive the child tags
    assert to_md("hello world") == (
        "[**hello** world]()"
    )
    assert to_md("label") == (
        "[**label**]()"
    )
    assert (
        to_md("italic and plain")
        == "[*italic* and plain]()"
    )

    # Nested  -- inner href wins for its own span; outer wraps the rest
    assert (
        to_md("text link")
        == "[text [link]()]()"
    )

    #  with no href attribute -- content rendered as plain text
    assert to_md("test no link") == "test no link"

    # Bare  anchor (no href) -- text passes through unchanged
    assert to_md("jump target") == "jump target"

    #  is inline -- it passes text through without a newline; 
     is
    # block-level and paragraph-like, so it adds a blank line.
    assert to_md("
    block
    inline") == "block\n\ninline"

    # HTML comments are stripped entirely; surrounding text is preserved
    assert to_md(" text") == "text"
    assert to_md("abc") == "abc"

    #  sections are gracefully ignored (content is dropped, text
    # outside the CDATA boundary is kept)
    assert to_md("text here") == "text here"
    assert to_md("text") == "text"

    # Inline  wraps in backticks without a block boundary
    assert to_md("func()") == "`func()`"

    # Markdown special characters inside  are NOT escaped -- backtick
    # delimiters already make content literal
    assert to_md("x*2 and #tag") == "`x*2 and #tag`"

    # 
     produces a fenced code block
    assert to_md("
    line a\nline b
    ") == "```\nline a\nline b\n```"

    #  is treated the same as 
     (fenced block)
    assert to_md("output\nhere") == "```\noutput\nhere\n```"

    # Inline code followed immediately by a pre block
    assert to_md(
        "multi-line 1\nmulti-line 2more content"
        "
    multi-line 1\nmulti-line 2
    more content"
    ) == (
        "`multi-line 1\nmulti-line 2`more content"
        "\n```\nmulti-line 1\nmulti-line 2\n```\nmore content"
    )

    # Unordered lists produce "- " prefixed items
    result = to_md("
    • Lots and lots
    • of lists.
    ")
    assert "- Lots and lots" in result
    assert "- of lists." in result

    assert (
        to_md("
    To be or not to be.
    ")
        == "> To be or not to be."
    )

    # Standalone 
     produces just "---"
    assert to_md("
    ") == "---"
    assert to_md("
    ") == "---"

    # "
            "
    Some obnoxious text here.
    "
        )
        == "Some obnoxious text here."
    )

    # "
            "
    line 1
    "
            "Another line without being enclosed"
        )
        == "line 1\n\nAnother line without being enclosed"
    )

    # '*' outside code is escaped so it does not trigger emphasis
    assert to_md("
    price: 5 * 3
    ") == r"price: 5 \* 3"

    # '#' outside code is escaped so it does not trigger a heading
    assert to_md("
    Tag #1
    ") == r"Tag \#1"

    # Backtick outside code is escaped
    assert to_md("
    Use `func`
    ") == r"Use \`func\`"

    assert (
        to_md(
            """
        
            ignore this entry
        
          Let's handle special html encoding
          
    
        
        """
        )
        == "Let's handle special html encoding\n\n---"
    )

    # Missing 
     is handled gracefully
    assert (
        to_md(
            "
    Heading
    And a paragraph too.
    Plus line break.
    "
        )
        == "## Heading\n\nAnd a paragraph too.  \nPlus line break."
    )

    with pytest.raises(TypeError):
        to_md(None)

    with pytest.raises(TypeError):
        to_md(42)

    with pytest.raises(TypeError):
        to_md(object)


def test_conversion_html_to_markdown_lists():
    """Test list nesting and numbering."""

    def to_md(body):
        """Wrapper to simplify html-to-markdown conversion tests."""
        return convert_between(NotifyFormat.HTML, NotifyFormat.MARKDOWN, body)

    # Flat unordered list

    assert (
        to_md("
    • alpha
    • beta
    • gamma
    ")
        == "- alpha\n- beta\n- gamma"
    )

    # Flat ordered list with auto-incrementing counter

    assert (
        to_md("
    1. first
    2. second
    3. third
    ")
        == "1. first\n2. second\n3. third"
    )

    # 
       shifts where the auto-incrementing counter begins
    assert to_md('
      1. a
      2. b
      ') == "4. a\n5. b"
    assert to_md('
      1. a
      ') == "0. a"

    # CommonMark list markers cannot represent negative starting values.
    assert to_md('
      1. a
      2. b
      ') == "0. a\n1. b"

    # A non-numeric start is ignored, same as no attribute at all
    assert to_md('
      1. a
      ') == "1. a"

    # 
    1.  resets the counter for that item and every sibling after it
    assert to_md('
      1. a
      2. b
      ') == "5. a\n6. b"
    assert (
        to_md('
      1. a
      2. b
      3. c
      ')
        == "1. a\n10. b\n11. c"
    )
    assert to_md('
      1. a
      2. b
      ') == "0. a\n1. b"

    # A non-numeric value is ignored too -- the counter just keeps incrementing
    # normally, same as if the attribute weren't there
    assert to_md('
      1. a
      2. b
      ') == "1. a\n2. b"

    # Nested unordered lists (2 levels)

    assert (
        to_md(
            "
      • top A
        • nested A
      • top B
      "
        )
        == "- top A\n  - nested A\n- top B"
    )

    # Nested unordered lists (3 levels)

    assert (
        to_md("
      • L1
        • L2
          • L3
      ")
        == "- L1\n  - L2\n    - L3"
    )

    # Mixed nesting: ol inside ul

    assert (
        to_md(
            "
        "
            "
      • intro
          "
            "
        1. step one
          2. "
            "
        2. step two
          3. "
            "
        • "
            "
      "
        )
        == "- intro\n  1. step one\n  2. step two"
    )

    # Mixed nesting: ul inside ol

    assert (
        to_md(
            "
        "
            "
      1. first
          "
            "
        • sub A
          • "
            "
        • sub B
          • "
            "
        2. "
            "
      2. second
        3. "
            "
      "
        )
        == "1. first\n  - sub A\n  - sub B\n2. second"
    )

    # Malformed HTML: missing 
      2.  in a 
         HTMLParser does not synthesize
    # implicit close events; each missing  is simply absent, but the next.
    assert (
        to_md("
        • item A
        • item B
        • item C
        ")
        == "- item A\n- item B\n- item C"
    )

    # Without , ordered-list counters cannot advance.
    assert (
        to_md("
        1. one
        2. two
        3. three
        ") == "1. one\n1. two\n1. three"
    )

    # Malformed HTML: missing closing 
      

    assert to_md("
      • item A
      • item B
        • ") == "- item A\n- item B"

    # Malformed HTML: missing  AND missing 
      

    assert to_md("
      • item A
      • item B") == "- item A\n- item B"

    # Malformed HTML: bare text inside 
           (no 
        •  wrapper) 
             is in
    # IGNORE_TAGS so unwrapped text is suppressed entirely
    assert to_md("
              bare text
            ") == ""

    #  inside 
          • : inline code preserved with backticks

    assert (
        to_md("
            • run cmd --flag now
            ")
        == "- run `cmd --flag` now"
    )

    # Markdown special characters inside  are NOT escaped
    assert (
        to_md("
            • see x*2 #tag
            ")
        == "- see `x*2 #tag`"
    )

    # Fenced blocks retain content and list indentation.
    assert (
        to_md("
            • code:
                indented\n  here
            ")
        == "- code:\n  ```\n    indented\n    here\n  ```"
    )

    # Nested fenced blocks combine content indentation with list indentation.
    assert (
        to_md(
            "
            • outer
              • inner:
                  x = 1
            "
        )
        == "- outer\n  - inner:\n    ```\n      x = 1\n    ```"
    )

    # A first-child block shares the list marker's line.

    # Single item with a 
             first child
    assert to_md("
            • alpha
            ") == "- alpha"

    # Multiple items each with a 
             first child.
    assert (
        to_md("
            • alpha
            • beta
            ")
        == "- alpha\n\n- beta"
    )

    # Multiple 
             children inside one 
          • 
    assert to_md("
            • one
              two
            ") == "- one\n\n  two"

    # Mixed: direct text for first item, 
             for second.
    assert (
        to_md("
            • direct
            • wrapped
            ")
        == "- direct\n- wrapped"
    )

    # Numbered list with 
             children
    assert (
        to_md("
            1. first
            2. second
            ")
        == "1. first\n\n2. second"
    )

    #  link as first child of 
          •  -- the marker must share the line
    assert to_md("") == "- [link]()"

    #  with nested markup as first (and only) child of 
          • 
    assert (
        to_md("")
        == "- [**bold link**]()"
    )

    #  link followed by a 
             sibling inside the same 
          • .
    assert (
        to_md("")
        == "- [link]()\n\n  more"
    )


def test_conversion_html_to_markdown_escaping():
    """Test Markdown escaping."""

    def to_md(body):
        """Wrapper to simplify html-to-markdown conversion tests."""
        return convert_between(NotifyFormat.HTML, NotifyFormat.MARKDOWN, body)

    # Embedded backticks widen code delimiters.
    assert to_md("a`b") == "``a`b``"

    # Content starting or ending with a backtick gets a padding space, per
    # CommonMark's code-span disambiguation rule
    assert to_md("`x") == "`` `x ``"
    assert to_md("x`") == "`` x` ``"

    # A run of 3 backticks inside 
             widens the fence past 3
    assert to_md("
            boom```
            ") == "````\nboom```\n````"

    # Plain content with no backticks still uses the minimal delimiter
    assert to_md("
            x
            ") == "```\nx\n```"

    # Ignored containers suppress both text and Markdown markers.
    assert (
        to_md(
            "ignore
            keep
            "
        )
        == "keep"
    )

    # A heading marker ("# ") must not leak from a suppressed container
    assert (
        to_md("
            hidden heading
            text")
        == "text"
    )

    # A list marker ("- ") must not leak from a 
          •  nested inside a suppressed
    # container, even though 
          •  normally re-enables storage
    assert (
        to_md("
            • hidden item
            text")
        == "text"
    )

    # 
            keep
            ") == "keep"

    # A 
             block fully inside a suppressed container emits nothing, not even
    # an empty fence
    assert to_md("
            keep
            ") == "keep"

    # Angle destinations preserve whitespace in link targets.
    assert to_md("link") == "[link]()"

    # Nested tags are inert inside preformatted content.
    assert (
        to_md("
            before link after
            ")
        == "```\nbefore link after\n```"
    )
    assert (
        to_md("before bold after") == "`before bold after`"
    )

    # Stray code/pre/samp close tags
    assert to_md("            text") == "text"
    assert to_md("
            text") == "text"
    assert to_md("text") == "text"

    # Markdown/HTML injection via plain text content
    assert (
        to_md("
            Click [here](https://evil.example.com) now
            ")
        == r"Click \[here\]\(https://evil.example.com\) now"
    )
    assert (
        to_md("
            An image ![x](https://evil.example.com/x.png) too
            ")
        == r"An image \!\[x\]\(https://evil.example.com/x.png\) too"
    )

    # A literal backslash must itself be escaped
    assert to_md("
            back\\*slash
            ") == r"back\\\*slash"

    # '_' (CommonMark's other emphasis delimiter) and '~' (GFM/chat- dialect
    # strikethrough) are escaped unconditionally, the same as '*'.
    assert to_md("
            _literal_
            ") == r"\_literal\_"
    assert to_md("
            my_variable_name
            ") == r"my\_variable\_name"
    assert to_md("
            ~strikethrough~
            ") == r"\~strikethrough\~"

    # Entity-encoded HTML (decoded to literal "<"/">" text by the parser) must
    # not survive into the Markdown output unescaped
    assert (
        to_md("
            previously <script>alert(1)</script>
            ")
        == r"previously \alert\(1\)\"
    )

    # href cannot break out of the link destination
    assert to_md(
        ''
        "legit link"
    ) == (
        "[legit link]"
        "()"
    )

    # A '<' or '>' inside the href itself must be escaped, since both are
    # meaningful within the angle-bracket destination form.
    assert to_md('y') == (
        r"[y](>)"
    )

    # Strip line endings before placing a URL in an angle-bracket destination.
    assert (
        to_md('click')
        == "[click]()"
    )

    # Neutralize schemes that can execute content or expose local files.
    assert to_md('click me') == (
        "[click me](<#>)"
    )
    assert to_md('click') == "[click](<#>)"
    assert to_md('click') == "[click](<#>)"
    assert to_md('click') == "[click](<#>)"
    assert to_md('click') == "[click](<#>)"

    # Leading or trailing whitespace must not defeat scheme detection.
    assert to_md('click') == (
        "[click](<#>)"
    )
    assert to_md('click') == (
        "[click](<#>)"
    )
    assert to_md('click') == (
        "[click](<#>)"
    )

    # BiDi override/embedding characters must not defeat scheme detection.
    assert to_md('click') == ("[click](<#>)")
    assert to_md('click') == ("[click](<#>)")
    # U+2066 (LEFT-TO-RIGHT ISOLATE) must also be stripped.
    assert to_md('click') == ("[click](<#>)")

    # Keep legitimate app-specific schemes that are not explicitly unsafe.
    assert to_md('x') == (
        "[x]()"
    )
    assert to_md('x') == (
        "[x]()"
    )
    assert to_md('x') == (
        "[x]()"
    )
    assert to_md('x') == (
        "[x]()"
    )
    assert to_md('x') == (
        "[x]()"
    )
    assert to_md('x') == (
        "[x]()"
    )
    assert to_md('x') == (
        "[x]()"
    )
    assert to_md('x') == ("[x]()")
    assert to_md('x') == "[x](<#anchor>)"


def test_conversion_html_to_markdown_line_start_escaping():
    """Test block syntax escaping."""

    def to_md(body):
        """Wrapper to simplify html-to-markdown conversion tests."""
        return convert_between(NotifyFormat.HTML, NotifyFormat.MARKDOWN, body)

    # Escape ordered-list-shaped text only at the start of a line.
    assert to_md("
            1. Apples
            2. Oranges
            ") == (
        "1\\. Apples\n\n2\\. Oranges"
    )
    assert to_md("
            23. done
            ") == "23\\. done"

    # Match bullet markers at the start of a line.
    assert to_md("
            - not a bullet, just a dash
            ") == (
        "\\- not a bullet, just a dash"
    )
    assert to_md("
            + plus sign list?
            ") == "\\+ plus sign list?"

    # Escape repeated dashes that could become a thematic break.
    assert to_md("
            Some text
            ---
            more text
            ") == (
        "Some text\n\n\\---\n\nmore text"
    )

    # Escaping the first dash is enough to prevent a thematic break.
    rendered = convert_between(
        NotifyFormat.MARKDOWN,
        NotifyFormat.HTML,
        to_md("
            Some text
            ---
            more text
            "),
    )
    assert "***
            ") == "\\*\\*\\*"
    assert to_md("
            ___
            ") == "\\_\\_\\_"
    assert to_md("
            - - -
            ") == "\\- - -"
    assert to_md("
            Hello world
            ===
            ") == "Hello world  \n\\==="
    assert to_md("
            Heading
            ---
            ") == "Heading  \n\\---"

    # None of this is ambiguous -- and so isn't escaped -- anywhere other than
    # a true line start
    assert to_md("
            well-known v1.2 it is not - really
            ") == (
        "well-known v1.2 it is not - really"
    )
    assert to_md("
            price is $5.00
            ") == "price is $5.00"
    assert to_md("
            a-b-c
            ") == "a-b-c"
    assert to_md("
            5 - 3 = 2
            ") == "5 - 3 = 2"


def test_conversion_html_to_markdown_hardening():
    """Test malformed stack input."""

    def to_md(body):
        """Wrapper to simplify html-to-markdown conversion tests."""
        return convert_between(NotifyFormat.HTML, NotifyFormat.MARKDOWN, body)

    # Stray close tags before any matching open tag

    # 
           and 
     take the early-return path in handle_endtag
    assert to_md("text") == "text"
    assert to_md("text") == "text"

    #  finds no open 
  •  anywhere on the stack and is a no-op -- the
    # text that follows is unindented and stored normally
    assert to_md("
    • text") == "text"

    # Multiple stray close tags in a row must not crash or corrupt state
    assert to_md("preamble") == "preamble"

    # A valid list after a stray close must still render correctly
    assert to_md("
    • A
    • B
    ") == "- A\n- B"

    # A stray close tag with content on BOTH sides must be a complete no-op,
    # not just absorbed because nothing preceded it.
    assert to_md("ab") == "ab"
    assert to_md("ab") == "ab"
    assert to_md("ab") == "ab"
    assert to_md("a
    b") == "ab"
    assert to_md("ab") == "ab"
    assert to_md("ab") == "ab"

    # A stray / close still falls through cleanly when content follows.
    assert to_md("
    ab
    ") == "ab"

    # _make_frame() empty-stack guard
    conv = HTMLMarkdownConverter()

    # Force the stack empty -- this can only happen via direct attribute
    # manipulation, never through the public parsing API
    conv._stack = []
    frame = conv._make_frame("div")

    # The fallback defaults must match the root sentinel values
    assert frame["tag"] == "div"
    assert frame["do_store"] is True
    assert frame["preserve_cr"] is False
    assert frame["list_type"] is None
    assert frame["depth"] == 0
    assert frame["counter"] is None
    assert frame["list_do_store"] is True

    # A stale open-tag count must not corrupt the stack.
    conv = HTMLMarkdownConverter()
    conv._tag_open_counts["nonexistent"] = 1
    conv._pop_to("nonexistent")  # must not raise or corrupt state
    assert len(conv._stack) == 1  # only the root sentinel remains

    # ignore content found in head
    assert (
        to_md(
            ""
            + "
      " * 50
            + "
    • hidden
      • "
            + "
    " * 50
            + "text"
        )
        == "text"
    )

    # deep 
       nesting still resolve correctly.
    assert (
        to_md("
        " * 50 + "
      • visible
        • " + "
      " * 50) == "- visible"
    )

    # List indentation is capped at LIST_DEPTH_MAX ---
    assert LIST_DEPTH_MAX == 4

    one_per_level = "
      • x" * 10 + "
      " * 10
    out = to_md(one_per_level)
    lines = out.split("\n")
    assert len(lines) == 10
    # Indent grows for the first LIST_DEPTH_MAX levels...
    assert lines[0] == "- x"
    assert lines[1] == "  - x"
    assert lines[2] == "    - x"
    assert lines[3] == "      - x"
    # ...then holds steady for every level beyond the cap
    for line in lines[4:]:
        assert line == "      - x"

    # Performance: same shape, large enough that the old O(N^2)
    n = 20000
    deep = "
      • x" * n + "
      " * n
    start = default_timer()
    out = to_md(deep)
    elapsed = default_timer() - start
    assert len(out) < 20 * n
    # Generous bound: this must catch a real return to quadratic
    # behavior, not just run fast on a quiet dev machine -- shared or
    # emulated build infrastructure (e.g. a busy Koji builder) can be
    # many times slower.
    assert elapsed < 15.0

    # Performance: many UNCLOSED 
    •  tags nested directly inside one another.
    n = 20000
    html = "
    • x" * n
    start = default_timer()
    out = to_md(html)
    elapsed = default_timer() - start
    assert len(out) < 10 * n  # output itself is linear, not quadratic
    # Generous bound -- see the note on the equivalent check above.
    assert elapsed < 30.0

    # Performance: many open 
       tags followed by many closing tags of
    # a *different* kind that's never actually open ("