From aacfbe993d55df54937749e0d1ccd07701c13919 Mon Sep 17 00:00:00 2001
From: ReenigneArcher <42013603+ReenigneArcher@users.noreply.github.com>
Date: Thu, 21 Sep 2023 20:51:25 -0400
Subject: [PATCH] ci(tests): bootstrap plex server (#153)
---
.github/workflows/CI.yml | 164 +++++-
.github/workflows/python-tests.yml | 40 --
Contents/Code/__init__.py | 3 -
Contents/Code/general_helper.py | 20 +-
Contents/Code/tmdb_helper.py | 1 -
README.rst | 4 +
codecov.yml | 15 +
docs/Makefile | 2 +-
docs/make.bat | 5 +-
docs/source/contributing/testing.rst | 21 +
requirements-dev.txt | 3 +
requirements.txt | 2 +-
scripts/plex-bootstraptest.py | 712 ++++++++++++++++++++++++
tests/__init__.py | 0
tests/conftest.py | 167 ++++++
tests/data/video_stub.mp4 | Bin 0 -> 18184197 bytes
tests/functional/test_docs.py | 72 +++
tests/functional/test_plex_plugin.py | 55 ++
tests/functional/test_webapp.py | 1 +
tests/unit/test_code.py | 17 +-
tests/unit/test_general_helper.py | 122 ++++
tests/unit/test_lizardbyte_db_helper.py | 44 ++
tests/unit/test_tmdb_helper.py | 41 ++
tests/unit/test_youtube_dl_helper.py | 4 +
24 files changed, 1441 insertions(+), 74 deletions(-)
delete mode 100644 .github/workflows/python-tests.yml
create mode 100644 codecov.yml
create mode 100644 scripts/plex-bootstraptest.py
create mode 100644 tests/__init__.py
create mode 100644 tests/data/video_stub.mp4
create mode 100644 tests/functional/test_docs.py
create mode 100644 tests/functional/test_plex_plugin.py
create mode 100644 tests/unit/test_general_helper.py
create mode 100644 tests/unit/test_lizardbyte_db_helper.py
create mode 100644 tests/unit/test_tmdb_helper.py
diff --git a/.github/workflows/CI.yml b/.github/workflows/CI.yml
index 01cebce1..221c4d17 100644
--- a/.github/workflows/CI.yml
+++ b/.github/workflows/CI.yml
@@ -47,6 +47,7 @@ jobs:
uses: LizardByte/.github/actions/setup_python2@nightly
- name: Set up Python 2.7 Dependencies
+ shell: bash
working-directory: Themerr-plex.bundle
run: |
echo "Installing Requirements"
@@ -66,35 +67,15 @@ jobs:
mv ./node_modules ./Contents/Resources/web
- name: Build plist
+ shell: bash
working-directory: Themerr-plex.bundle
env:
BUILD_VERSION: ${{ needs.check_changelog.outputs.next_version }}
run: |
python ./scripts/build_plist.py
- - name: Upload Artifacts
- if: ${{ github.event_name == 'pull_request' || github.event_name == 'workflow_dispatch' }}
- uses: actions/upload-artifact@v3
- with:
- name: Themerr-plex.bundle
- if-no-files-found: error # 'warn' or 'ignore' are also available, defaults to `warn`
- path: |
- ${{ github.workspace }}
- !**/*.git*
- !**/*.pyc
- !**/__pycache__
- !**/plexhints*
- !**/Themerr-plex.bundle/.*
- !**/Themerr-plex.bundle/cache.sqlite
- !**/Themerr-plex.bundle/DOCKER_README.md
- !**/Themerr-plex.bundle/Dockerfile
- !**/Themerr-plex.bundle/docs
- !**/Themerr-plex.bundle/scripts
- !**/Themerr-plex.bundle/tests
-
- name: Package Release
shell: bash
- if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/master' }}
run: |
7z \
"-xr!*.git*" \
@@ -103,6 +84,7 @@ jobs:
"-xr!plexhints*" \
"-xr!Themerr-plex.bundle/.*" \
"-xr!Themerr-plex.bundle/cache.sqlite" \
+ "-xr!Themerr-plex.bundle/crowdin.yml" \
"-xr!Themerr-plex.bundle/DOCKER_README.md" \
"-xr!Themerr-plex.bundle/Dockerfile" \
"-xr!Themerr-plex.bundle/docs" \
@@ -113,6 +95,14 @@ jobs:
mkdir artifacts
mv ./Themerr-plex.bundle.zip ./artifacts/
+ - name: Upload Artifacts
+ uses: actions/upload-artifact@v3
+ with:
+ name: Themerr-plex.bundle
+ if-no-files-found: error # 'warn' or 'ignore' are also available, defaults to `warn`
+ path: |
+ ${{ github.workspace }}/artifacts
+
- name: Create Release
if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/master' }}
uses: LizardByte/.github/actions/create_release@master
@@ -121,3 +111,135 @@ jobs:
next_version: ${{ needs.check_changelog.outputs.next_version }}
last_version: ${{ needs.check_changelog.outputs.last_version }}
release_body: ${{ needs.check_changelog.outputs.release_body }}
+
+ pytest:
+ needs: [build]
+ strategy:
+ fail-fast: false
+ matrix:
+ os: [windows-latest, ubuntu-latest, macos-latest]
+
+ runs-on: ${{ matrix.os }}
+ env:
+ PLEXAPI_AUTH_SERVER_BASEURL: http://127.0.0.1:32400
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v3
+
+ - name: Download artifacts
+ uses: actions/download-artifact@v3
+ with:
+ name: Themerr-plex.bundle
+
+ - name: Extract artifacts zip
+ shell: bash
+ run: |
+ # extract zip
+ 7z x Themerr-plex.bundle.zip -o.
+
+ # move all files from "Themerr-plex.bundle" to root, with no target directory
+ cp -r ./Themerr-plex.bundle/. .
+
+ # remove zip
+ rm Themerr-plex.bundle.zip
+
+ - name: Set up Python
+ uses: LizardByte/.github/actions/setup_python2@nightly
+
+ - name: Install python dependencies
+ shell: bash
+ run: |
+ python -m pip --no-python-version-warning --disable-pip-version-check install --upgrade \
+ pip setuptools wheel
+ python -m pip --no-python-version-warning --disable-pip-version-check install -r requirements-dev.txt
+
+ - name: Install Plex Media Server
+ shell: bash
+ run: |
+ if [[ "${{ matrix.os }}" == "windows-latest" ]]; then
+ choco install plexmediaserver
+ elif [[ "${{ matrix.os }}" == "macos-latest" ]]; then
+ brew install --cask plex-media-server
+
+ # starting with pms 1.29.2 servers must be claimed... disable that
+ # https://forums.plex.tv/t/new-server-claiming-requirement-for-macos/816337
+ defaults write com.plexapp.plexmediaserver enableLocalSecurity -bool FALSE
+
+ # copy plugin before starting plex server
+ mkdir -p "${HOME}/Library/Application Support/Plex Media Server/Plug-ins"
+ cp -r ./Themerr-plex.bundle "${HOME}/Library/Application Support/Plex Media Server/Plug-ins/"
+
+ open "/Applications/Plex Media Server.app"
+ elif [[ "${{ matrix.os }}" == "ubuntu-latest" ]]; then
+ curl https://downloads.plex.tv/plex-keys/PlexSign.key | sudo apt-key add -
+ echo deb https://downloads.plex.tv/repo/deb public main | \
+ sudo tee /etc/apt/sources.list.d/plexmediaserver.list
+ sudo apt-get update
+ sudo apt-get install plexmediaserver
+
+ # stop service
+ sudo systemctl stop plexmediaserver
+
+ # debug
+ cat /lib/systemd/system/plexmediaserver.service
+
+ # do not edit service directly, use override
+ override=/etc/systemd/system/plexmediaserver.service.d/override.conf
+ sudo mkdir -p $(dirname ${override})
+ sudo touch ${override}
+ echo "[Service]" | sudo tee ${override}
+ echo "User=$USER" | sudo tee -a ${override}
+
+ # take ownership
+ sudo chown -R $USER:$USER "/var/lib/plexmediaserver/Library/Application Support/Plex Media Server"
+
+ # reload service
+ sudo systemctl daemon-reload
+
+ # start
+ sudo systemctl start plexmediaserver
+ else
+ echo "Unknown OS: ${{ matrix.os }}"
+ exit 1
+ fi
+
+ - name: Update Plex registry settings
+ if: ${{ matrix.os == 'windows-latest' }}
+ run: |
+ # starting with pmps 1.32.2 servers must be claimed... disable that
+ # https://forums.plex.tv/t/new-claiming-requirement-for-windows/839096
+ REG ADD "HKCU\Software\Plex, Inc.\Plex Media Server" /v enableLocalSecurity /t REG_DWORD /d 0 /f
+
+ - name: Bootstrap Plex server
+ id: boostrap
+ shell: bash
+ run: |
+ python \
+ -u scripts/plex-bootstraptest.py \
+ --destination plex \
+ --advertise-ip 127.0.0.1 \
+ --bootstrap-timeout 540 \
+ --no-docker \
+ --server-name plex-test-${{ matrix.os }}-${{ github.run_id }} \
+ --without-shows \
+ --without-music \
+ --without-photos \
+ --unclaimed
+
+ - name: Test with pytest
+ id: test
+ shell: bash
+ run: |
+ python -m pytest \
+ -rXs \
+ --tb=native \
+ --verbose \
+ --cov=Contents/Code \
+ tests
+
+ - name: Upload coverage
+ # any except cancelled or skipped
+ if: always() && (steps.test.outcome == 'success' || steps.test.outcome == 'failure')
+ uses: codecov/codecov-action@v3
+ with:
+ flags: ${{ runner.os }}
diff --git a/.github/workflows/python-tests.yml b/.github/workflows/python-tests.yml
deleted file mode 100644
index 36d56a25..00000000
--- a/.github/workflows/python-tests.yml
+++ /dev/null
@@ -1,40 +0,0 @@
----
-name: Python Tests
-
-on:
- pull_request:
- branches: [master, nightly]
- types: [opened, synchronize, reopened]
-
-jobs:
- pytest:
- strategy:
- fail-fast: false
- matrix:
- os: [windows-latest, ubuntu-latest, macos-latest]
-
- runs-on: ${{ matrix.os }}
- steps:
- - name: Checkout
- uses: actions/checkout@v3
-
- - name: Set up Python
- uses: LizardByte/.github/actions/setup_python2@nightly
-
- - name: Install python dependencies
- shell: bash
- run: |
- python -m pip --no-python-version-warning --disable-pip-version-check install --upgrade \
- pip setuptools wheel
- python -m pip --no-python-version-warning --disable-pip-version-check install -r requirements-dev.txt
- python -m pip --no-python-version-warning --disable-pip-version-check install -r requirements.txt
-
- - name: Build plist
- shell: bash
- run: |
- python ./scripts/build_plist.py
-
- - name: Test with pytest
- shell: bash # our Python 2.7 setup action doesn't support PowerShell
- run: |
- python -m pytest -v
diff --git a/Contents/Code/__init__.py b/Contents/Code/__init__.py
index adc88603..eafcb87a 100644
--- a/Contents/Code/__init__.py
+++ b/Contents/Code/__init__.py
@@ -23,9 +23,6 @@
# imports from Libraries\Shared
from typing import Optional
-# we need to import youtube_dl.compat to prevent plexapi-backport from screwing with the standard library
-# this needs to occur before any plexapi import
-from youtube_dl import compat # noqa: F401
# local imports
from default_prefs import default_prefs
diff --git a/Contents/Code/general_helper.py b/Contents/Code/general_helper.py
index 048ee8cb..615d5fd1 100644
--- a/Contents/Code/general_helper.py
+++ b/Contents/Code/general_helper.py
@@ -20,6 +20,11 @@
# local imports
from constants import metadata_base_directory, metadata_type_map, themerr_data_directory
+# constants
+legacy_keys = [
+ 'downloaded_timestamp'
+]
+
def get_media_upload_path(item, media_type):
# type: (any, str) -> str
@@ -40,6 +45,11 @@ def get_media_upload_path(item, media_type):
str
The path to the theme upload directory.
+ Raises
+ ------
+ ValueError
+ If the ``media_type`` is not one of 'art', 'posters', or 'themes'.
+
Examples
--------
>>> get_media_upload_path(item=..., media_type='art')
@@ -49,6 +59,13 @@ def get_media_upload_path(item, media_type):
>>> get_media_upload_path(item=..., media_type='themes')
"...bundle/Uploads/themes..."
"""
+ allowed_media_types = ['art', 'posters', 'themes']
+ if media_type not in allowed_media_types:
+ raise ValueError(
+ 'This error should be reported to https://github.com/LizardByte/Themerr-plex/issues;'
+ 'media_type must be one of: {}'.format(allowed_media_types)
+ )
+
guid = item.guid
full_hash = hashlib.sha1(guid).hexdigest()
theme_upload_path = os.path.join(
@@ -202,9 +219,6 @@ def update_themerr_data_file(item, new_themerr_data):
themerr_data = get_themerr_json_data(item=item)
# remove legacy keys
- legacy_keys = [
- 'downloaded_timestamp'
- ]
for key in legacy_keys:
try:
del themerr_data[key]
diff --git a/Contents/Code/tmdb_helper.py b/Contents/Code/tmdb_helper.py
index 86abaa31..0b2515ca 100644
--- a/Contents/Code/tmdb_helper.py
+++ b/Contents/Code/tmdb_helper.py
@@ -85,7 +85,6 @@ def get_tmdb_id_from_collection(search_query):
645
"""
# /search/collection?query=James%20Bond%20Collection&include_adult=false&language=en-US&page=1"
-
query_url = 'search/collection?query={}'
# Plex returns 500 error if spaces are in collection query, same with `_`, `+`, and `%20`... so use `-`
diff --git a/README.rst b/README.rst
index db36e819..339a8b28 100644
--- a/README.rst
+++ b/README.rst
@@ -26,6 +26,10 @@ Integrations
:alt: Read the Docs
:target: http://themerr-plex.readthedocs.io/
+.. image:: https://img.shields.io/codecov/c/gh/LizardByte/Themerr-plex?token=1LYYVYWY9D&style=for-the-badge&logo=codecov&label=codecov
+ :alt: Codecov
+ :target: https://codecov.io/gh/LizardByte/Themerr-plex
+
Downloads
---------
diff --git a/codecov.yml b/codecov.yml
new file mode 100644
index 00000000..c9d3a1ab
--- /dev/null
+++ b/codecov.yml
@@ -0,0 +1,15 @@
+---
+codecov:
+ branch: master
+
+coverage:
+ status:
+ project:
+ default:
+ target: auto
+ threshold: 10%
+
+comment:
+ layout: "diff, flags, files"
+ behavior: default
+ require_changes: false # if true: only post the comment if coverage changes
diff --git a/docs/Makefile b/docs/Makefile
index d0c3cbf1..8b6275ab 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -3,7 +3,7 @@
# You can set these variables from the command line, and also
# from the environment for the first two.
-SPHINXOPTS ?=
+SPHINXOPTS ?= -W --keep-going
SPHINXBUILD ?= sphinx-build
SOURCEDIR = source
BUILDDIR = build
diff --git a/docs/make.bat b/docs/make.bat
index dc1312ab..08ca2232 100644
--- a/docs/make.bat
+++ b/docs/make.bat
@@ -9,6 +9,7 @@ if "%SPHINXBUILD%" == "" (
)
set SOURCEDIR=source
set BUILDDIR=build
+set "SPHINXOPTS=-W --keep-going"
%SPHINXBUILD% >NUL 2>NUL
if errorlevel 9009 (
@@ -25,11 +26,11 @@ if errorlevel 9009 (
if "%1" == "" goto help
-%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% || exit /b %ERRORLEVEL%
goto end
:help
-%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% || exit /b %ERRORLEVEL%
:end
popd
diff --git a/docs/source/contributing/testing.rst b/docs/source/contributing/testing.rst
index 66fdd335..e6770893 100644
--- a/docs/source/contributing/testing.rst
+++ b/docs/source/contributing/testing.rst
@@ -39,6 +39,11 @@ Test with Sphinx
cd docs
sphinx-build -b html source build
+Lint with rstcheck
+ .. code-block:: bash
+
+ rstcheck -r .
+
pytest
------
Themerr-plex uses `pytest `__ for unit testing. pytest is included in the
@@ -46,7 +51,23 @@ Themerr-plex uses `pytest `__ for unit testing
No config is required for pytest.
+.. attention::
+ A locally installed Plex server is required to run some of the tests. The server must be running locally so that the
+ plugin logs can be parsed for exceptions. It is not recommended to run the tests against a production server.
+
+A script is provided that allows you to prepare the Plex server for testing. Use the help argument to see the options.
+
+Bootstrap the Plex server for testing
+.. code-block:: bash
+
+ python scripts/plex-bootstraptest.py --help
+
Test with pytest
.. code-block:: bash
python -m pytest
+
+.. tip::
+ Due to the complexity of setting up the environment for testing, it is recommended to run the tests in GitHub
+ Actions. This will ensure that the tests are run in a clean environment and will not be affected by any local
+ changes.
diff --git a/requirements-dev.txt b/requirements-dev.txt
index 3820f502..0faabf42 100644
--- a/requirements-dev.txt
+++ b/requirements-dev.txt
@@ -3,7 +3,10 @@ flake8==3.9.2;python_version<"3"
m2r2==0.3.2;python_version<"3"
numpydoc==0.9.2;python_version<"3"
git+https://github.com/LizardByte/plexhints.git#egg=plexhints # type hinting library for plex development
+plexapi-backport[alert]==4.15.2
pytest==4.6.11;python_version<"3"
+pytest-cov==2.12.1;python_version<"3"
rstcheck==3.5.0;python_version<"3"
Sphinx==1.8.6;python_version<"3"
sphinx-rtd-theme==1.2.0;python_version<"3"
+tqdm==4.64.1;python_version<"3"
diff --git a/requirements.txt b/requirements.txt
index 8117043a..4151f54f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -3,7 +3,7 @@
flask==1.1.4;python_version<"3"
flask-babel==1.0.0;python_version<"3"
future==0.18.3
-plexapi-backport[alert]==4.15.1 # custom python-plexapi supporting python 2.7
+plexapi-backport[alert]==4.15.2 # custom python-plexapi supporting python 2.7
polib==1.2.0;python_version<"3"
requests==2.27.1;python_version<"3" # 2.27 is last version supporting Python 2.7
schedule==0.6.0;python_version<"3"
diff --git a/scripts/plex-bootstraptest.py b/scripts/plex-bootstraptest.py
new file mode 100644
index 00000000..0d09da31
--- /dev/null
+++ b/scripts/plex-bootstraptest.py
@@ -0,0 +1,712 @@
+# -*- coding: utf-8 -*-
+"""
+The script is used to bootstrap a the test environment for plexapi
+with all the libraries required for testing.
+
+By default this uses a docker.
+
+It can be used manually using:
+python plex-bootraptest.py --no-docker --server-name name_of_server --account Hellowlol --password yourpassword
+
+Borrowed from python-plexapi and python-plexapi-backport... then modified.
+"""
+from __future__ import absolute_import
+from __future__ import division
+from builtins import dict
+from builtins import input
+from builtins import range
+import argparse
+import os
+import platform
+import shutil
+import socket
+import time
+from plexapi.backports import glob
+from plexapi.backports import makedirs
+from shutil import copyfile
+try:
+ from shutil import which
+except ImportError:
+ from backports.shutil_which import which
+import subprocess
+from uuid import uuid4
+
+import plexapi
+from plexapi.exceptions import BadRequest, NotFound
+from plexapi.myplex import MyPlexAccount
+from plexapi.server import PlexServer
+from plexapi.utils import SEARCHTYPES
+from tqdm import tqdm
+
+DOCKER_CMD = [
+ "docker",
+ "run",
+ "-d",
+ "--name",
+ "plex-test-%(container_name_extra)s%(image_tag)s",
+ "--restart",
+ "on-failure",
+ "-p",
+ "32400:32400/tcp",
+ "-p",
+ "3005:3005/tcp",
+ "-p",
+ "8324:8324/tcp",
+ "-p",
+ "32469:32469/tcp",
+ "-p",
+ "1900:1900/udp",
+ "-p",
+ "32410:32410/udp",
+ "-p",
+ "32412:32412/udp",
+ "-p",
+ "32413:32413/udp",
+ "-p",
+ "32414:32414/udp",
+ "-e",
+ "PLEX_CLAIM=%(claim_token)s",
+ "-e",
+ "ADVERTISE_IP=http://%(advertise_ip)s:32400/",
+ "-e",
+ "TZ=%(timezone)s",
+ "-e",
+ "LANG=%(language)s",
+ "-h",
+ "%(hostname)s",
+ "-v",
+ "%(destination)s/db:/config",
+ "-v",
+ "%(destination)s/transcode:/transcode",
+ "-v",
+ "%(destination)s/media:/data",
+ "plexinc/pms-docker:%(image_tag)s",
+]
+
+
+BASE_DIR_PATH = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+STUB_MOVIE_PATH = os.path.join(BASE_DIR_PATH, "tests", "data", "video_stub.mp4")
+STUB_MP3_PATH = os.path.join(BASE_DIR_PATH, "tests", "data", "audio_stub.mp3")
+STUB_IMAGE_PATH = os.path.join(BASE_DIR_PATH, "tests", "data", "cute_cat.jpg")
+
+
+def check_ext(path, ext):
+ """I hate glob so much."""
+ result = []
+ for root, dirs, fil in os.walk(path):
+ for f in fil:
+ fp = os.path.join(root, f)
+ if fp.endswith(ext):
+ result.append(fp)
+
+ return result
+
+
+class ExistingSection(Exception):
+ """This server has sections, exiting"""
+
+ def __init__(self, *args):
+ raise SystemExit("This server has sections exiting")
+
+
+def clean_pms(server, path):
+ for section in server.library.sections():
+ print("Deleting %s" % section.title)
+ section.delete()
+
+ server.library.cleanBundles()
+ server.library.optimize()
+ print("optimized db and removed any bundles")
+
+ shutil.rmtree(path, ignore_errors=False, onerror=None)
+ print("Deleted %s" % path)
+
+
+def setup_music(music_path, docker=False):
+ print("Setup files for the Music section..")
+ makedirs(music_path, exist_ok=True)
+
+ all_music = {
+
+ "Broke for free": {
+ "Layers": [
+ "1 - As Colorful As Ever.mp3",
+ # "02 - Knock Knock.mp3",
+ # "03 - Only Knows.mp3",
+ # "04 - If.mp3",
+ # "05 - Note Drop.mp3",
+ # "06 - Murmur.mp3",
+ # "07 - Spellbound.mp3",
+ # "08 - The Collector.mp3",
+ # "09 - Quit Bitching.mp3",
+ # "10 - A Year.mp3",
+ ]
+ },
+
+ }
+
+ m3u_file = open(os.path.join(music_path, "playlist.m3u"), "w")
+
+ for artist, album in all_music.items():
+ for k, v in album.items():
+ artist_album = os.path.join(music_path, artist, k)
+ makedirs(artist_album, exist_ok=True)
+ for song in v:
+ trackpath = os.path.join(artist_album, song)
+ copyfile(STUB_MP3_PATH, trackpath)
+
+ if docker:
+ reltrackpath = os.path.relpath(trackpath, os.path.dirname(music_path))
+ m3u_file.write(os.path.join("/data", reltrackpath) + "\n")
+ else:
+ m3u_file.write(trackpath + "\n")
+
+ m3u_file.close()
+
+ return len(check_ext(music_path, (".mp3")))
+
+
+def setup_movies(movies_path):
+ print("Setup files for the Movies section..")
+ makedirs(movies_path, exist_ok=True)
+
+ if len(glob(movies_path + "/*.mkv", recursive=True)) == 4:
+ return 4
+
+ required_movies = {
+ "Elephants Dream": 2006,
+ "Sita Sings the Blues": 2008,
+ "Big Buck Bunny": 2008,
+ "Sintel": 2010,
+ }
+ expected_media_count = 0
+ for name, year in required_movies.items():
+ expected_media_count += 1
+ if not os.path.isfile(get_movie_path(movies_path, name, year)):
+ copyfile(STUB_MOVIE_PATH, get_movie_path(movies_path, name, year))
+
+ return expected_media_count
+
+
+def setup_images(photos_path):
+ print("Setup files for the Photos section..")
+
+ makedirs(photos_path, exist_ok=True)
+ # expected_photo_count = 0
+ folders = {
+ ("Cats",): 3,
+ ("Cats", "Cats in bed"): 7,
+ ("Cats", "Cats not in bed"): 1,
+ ("Cats", "Not cats in bed"): 1,
+ }
+ has_photos = 0
+ for folder_path, required_cnt in folders.items():
+ folder_path = os.path.join(photos_path, *folder_path)
+ makedirs(folder_path, exist_ok=True)
+ photos_in_folder = len(glob(os.path.join(folder_path, "/*.jpg")))
+ while photos_in_folder < required_cnt:
+ # Dunno why this is need got permission error on photo0.jpg
+ photos_in_folder += 1
+ full_path = os.path.join(folder_path, "photo%d.jpg" % photos_in_folder)
+ copyfile(STUB_IMAGE_PATH, full_path)
+ has_photos += photos_in_folder
+
+ return len(check_ext(photos_path, (".jpg")))
+
+
+def setup_show(tvshows_path):
+ print("Setup files for the TV-Shows section..")
+ makedirs(tvshows_path, exist_ok=True)
+ makedirs(os.path.join(tvshows_path, "Game of Thrones"), exist_ok=True)
+ makedirs(os.path.join(tvshows_path, "The 100"), exist_ok=True)
+ required_tv_shows = {
+ "Game of Thrones": [list(range(1, 11)), list(range(1, 11))],
+ "The 100": [list(range(1, 14)), list(range(1, 17))],
+ }
+ expected_media_count = 0
+ for show_name, seasons in required_tv_shows.items():
+ for season_id, episodes in enumerate(seasons, start=1):
+ for episode_id in episodes:
+ expected_media_count += 1
+ episode_path = get_tvshow_path(
+ tvshows_path, show_name, season_id, episode_id
+ )
+ if not os.path.isfile(episode_path):
+ copyfile(STUB_MOVIE_PATH, episode_path)
+
+ return expected_media_count
+
+
+def get_default_ip():
+ """ Return the first IP address of the current machine if available. """
+ available_ips = list(
+ set(
+ [
+ i[4][0]
+ for i in socket.getaddrinfo(socket.gethostname(), None)
+ if i[4][0] not in ("127.0.0.1", "::1")
+ and not i[4][0].startswith("fe80:")
+ ]
+ )
+ )
+ return available_ips[0] if len(available_ips) else None
+
+
+def get_plex_account(opts):
+ """ Authenticate with Plex using the command line options. """
+ if not opts.unclaimed:
+ if opts.token:
+ return MyPlexAccount(token=opts.token)
+ return plexapi.utils.getMyPlexAccount(opts)
+ return None
+
+
+def get_movie_path(movies_path, name, year):
+ """ Return a movie path given its title and year. """
+ return os.path.join(movies_path, "%s (%d).mp4" % (name, year))
+
+
+def get_tvshow_path(tvshows_path, name, season, episode):
+ """ Return a TV show path given its title, season, and episode. """
+ return os.path.join(tvshows_path, name, "S%02dE%02d.mp4" % (season, episode))
+
+
+def add_library_section(server, section):
+ """ Add the specified section to our Plex instance. This tends to be a bit
+ flaky, so we retry a few times here.
+ """
+ start = time.time()
+ runtime = 0
+ while runtime < 60:
+ try:
+ server.library.add(**section)
+ return True
+ except BadRequest as err:
+ if "server is still starting up. Please retry later" in str(err):
+ time.sleep(1)
+ continue
+ raise
+ runtime = time.time() - start
+ raise SystemExit("Timeout adding section to Plex instance.")
+
+
+def create_section(server, section, opts): # noqa: C901
+ processed_media = 0
+ expected_media_count = section.pop("expected_media_count", 0)
+ expected_media_type = (section["type"],)
+ if section["type"] == "show":
+ expected_media_type = ("show", "season", "episode")
+ if section["type"] == "artist":
+ expected_media_type = ("artist", "album", "track")
+ expected_media_type = tuple(SEARCHTYPES[t] for t in expected_media_type)
+
+ def alert_callback(data):
+ """ Listen to the Plex notifier to determine when metadata scanning is complete. """
+ global processed_media
+ if data["type"] == "timeline":
+ for entry in data["TimelineEntry"]:
+ if (
+ entry.get("identifier", "com.plexapp.plugins.library")
+ == "com.plexapp.plugins.library"
+ ):
+ # Missed mediaState means that media was processed (analyzed & thumbnailed)
+ if (
+ "mediaState" not in entry
+ and entry["type"] in expected_media_type
+ ):
+ # state=5 means record processed, applicable only when metadata source was set
+ if entry["state"] == 5:
+ cnt = 1
+ if entry["type"] == SEARCHTYPES["show"]:
+ show = server.library.sectionByID(
+ entry["sectionID"]
+ ).get(entry["title"])
+ cnt = show.leafCount
+ bar.update(cnt)
+ processed_media += cnt
+ # state=1 means record processed, when no metadata source was set
+ elif (
+ entry["state"] == 1
+ and entry["type"] == SEARCHTYPES["photo"]
+ ):
+ bar.update()
+ processed_media += 1
+
+ runtime = 0
+ start = time.time()
+ bar = tqdm(desc="Scanning section " + section["name"], total=expected_media_count)
+ notifier = server.startAlertListener(alert_callback)
+ time.sleep(3)
+ add_library_section(server, section)
+ while bar.n < bar.total:
+ if runtime >= 120:
+ print("Metadata scan taking too long, but will continue anyway..")
+ break
+ time.sleep(3)
+ runtime = int(time.time() - start)
+ bar.close()
+ notifier.stop()
+
+
+if __name__ == "__main__": # noqa: C901
+ default_ip = get_default_ip()
+ parser = argparse.ArgumentParser(description=__doc__)
+ # Authentication arguments
+ mg = parser.add_mutually_exclusive_group()
+ g = mg.add_argument_group()
+ g.add_argument("--username", help="Your Plex username")
+ g.add_argument("--password", help="Your Plex password")
+ mg.add_argument(
+ "--token",
+ help="Plex.tv authentication token",
+ default=plexapi.CONFIG.get("auth.server_token"),
+ )
+ mg.add_argument(
+ "--unclaimed",
+ help="Do not claim the server",
+ default=False,
+ action="store_true",
+ )
+ # Test environment arguments
+ parser.add_argument(
+ "--no-docker", help="Use docker", default=False, action="store_true"
+ )
+ parser.add_argument(
+ "--timezone", help="Timezone to set inside plex", default="UTC"
+ ) # noqa
+ parser.add_argument(
+ "--language", help="Language to set inside plex", default="en_US.UTF-8"
+ ) # noqa
+ parser.add_argument(
+ "--destination",
+ help="Local path where to store all the media",
+ default=os.path.join(os.getcwd(), "plex"),
+ ) # noqa
+ parser.add_argument(
+ "--plugin-bundle-destination",
+ help="Local path where to copy the plugin bundle to",
+ default="auto"
+ ) # noqa
+ parser.add_argument(
+ "--plugin-bundle-source",
+ help="Local path where bundle is located",
+ default=os.path.join(os.getcwd(), "Themerr-plex.bundle"),
+ ) # noqa
+ parser.add_argument(
+ "--advertise-ip",
+ help="IP address which should be advertised by new Plex instance",
+ required=default_ip is None,
+ default=default_ip,
+ ) # noqa
+ parser.add_argument(
+ "--docker-tag", help="Docker image tag to install", default="latest"
+ ) # noqa
+ parser.add_argument(
+ "--bootstrap-timeout",
+ help="Timeout for each step of bootstrap, in seconds (default: %(default)s)",
+ default=180,
+ type=int,
+ ) # noqa
+ parser.add_argument(
+ "--server-name",
+ help="Name for the new server",
+ default="plex-test-docker-%s" % str(uuid4()),
+ ) # noqa
+ parser.add_argument(
+ "--accept-eula", help="Accept Plex's EULA", default=False, action="store_true"
+ ) # noqa
+ parser.add_argument(
+ "--without-movies",
+ help="Do not create Movies section",
+ default=True,
+ dest="with_movies",
+ action="store_false",
+ ) # noqa
+ parser.add_argument(
+ "--without-shows",
+ help="Do not create TV Shows section",
+ default=True,
+ dest="with_shows",
+ action="store_false",
+ ) # noqa
+ parser.add_argument(
+ "--without-music",
+ help="Do not create Music section",
+ default=True,
+ dest="with_music",
+ action="store_false",
+ ) # noqa
+ parser.add_argument(
+ "--without-photos",
+ help="Do not create Photos section",
+ default=True,
+ dest="with_photos",
+ action="store_false",
+ ) # noqa
+ parser.add_argument(
+ "--show-token",
+ help="Display access token after bootstrap",
+ default=False,
+ action="store_true",
+ ) # noqa
+ opts, _ = parser.parse_known_args()
+
+ account = get_plex_account(opts)
+ path = os.path.realpath(os.path.expanduser(opts.destination))
+ media_path = os.path.join(path, "media")
+ makedirs(media_path, exist_ok=True)
+
+ APP_DATA_PATH = dict(
+ Darwin="{}/Library/Application Support/Plex Media Server".format(os.getenv('HOME')),
+ Linux="/var/lib/plexmediaserver/Library/Application Support/Plex Media Server",
+ Windows="{}\\Plex Media Server".format(os.getenv('LOCALAPPDATA'))
+ )
+
+ # copy the plugin
+ if opts.plugin_bundle_destination == "auto":
+ opts.plugin_bundle_destination = os.path.join(
+ path, "db", "Library", "Application Support", "Plex Media Server", "Plug-ins", "Themerr-plex.bundle") if \
+ opts.no_docker is False else os.path.join(
+ APP_DATA_PATH[platform.system()], "Plug-ins", "Themerr-plex.bundle")
+
+ try:
+ shutil.copytree(opts.plugin_bundle_source, opts.plugin_bundle_destination)
+ except OSError as e:
+ if 'file exists' in str(e).lower():
+ print("Warning: Skipping copy, plugin already exists at %s" % opts.plugin_bundle_destination)
+ else:
+ print("Warning: %s" % e)
+ else:
+ print("Copied plugin bundle to %s" % opts.plugin_bundle_destination)
+
+ # copy the plugin plist file back to Contents
+ # this is necessary to get elevated policy with plexhints
+ try:
+ shutil.copyfile(os.path.join(opts.plugin_bundle_source, "Contents", "Info.plist"),
+ os.path.join(os.getcwd(), "Contents", "Info.plist"))
+ except OSError as e:
+ if 'file exists' in str(e).lower():
+ print("Warning: Skipping copy, plugin plist already exists at %s" % os.path.join(
+ os.getcwd(), "Contents", "Info.plist"))
+ else:
+ print("Warning: %s" % e)
+ else:
+ print("Copied plugin plist to %s" % os.path.join(os.getcwd(), "Contents", "Info.plist"))
+
+ # Download the Plex Docker image
+ if opts.no_docker is False:
+ print(
+ "Creating Plex instance named %s with advertised ip %s"
+ % (opts.server_name, opts.advertise_ip)
+ )
+ if which("docker") is None:
+ print("Docker is required to be available")
+ exit(1)
+ if subprocess.call(["docker", "pull", "plexinc/pms-docker:%s" % opts.docker_tag]) != 0:
+ print("Got an error when executing docker pull!")
+ exit(1)
+
+ # Start the Plex Docker container
+
+ arg_bindings = {
+ "destination": path,
+ "hostname": opts.server_name,
+ "claim_token": account.claimToken() if account else "",
+ "timezone": opts.timezone,
+ "language": opts.language,
+ "advertise_ip": opts.advertise_ip,
+ "image_tag": opts.docker_tag,
+ "container_name_extra": "" if account else "unclaimed-",
+ }
+ docker_cmd = [c % arg_bindings for c in DOCKER_CMD]
+ exit_code = subprocess.call(docker_cmd)
+ if exit_code != 0:
+ raise SystemExit(
+ "Error %s while starting the Plex docker container" % exit_code
+ )
+
+ # Wait for the Plex container to start
+ print("Waiting for the Plex to start..")
+ start = time.time()
+ runtime = 0
+ server = None
+ while not server and (runtime < opts.bootstrap_timeout):
+ try:
+ if account:
+ server = account.device(opts.server_name).connect()
+ else:
+ server = PlexServer("http://%s:32400" % opts.advertise_ip)
+
+ except KeyboardInterrupt:
+ break
+
+ except Exception as err:
+ print(err)
+ time.sleep(1)
+
+ runtime = time.time() - start
+
+ if not server:
+ raise SystemExit(
+ "Server didn't appear in your account after %ss" % opts.bootstrap_timeout
+ )
+
+ print("Plex container started after %ss" % int(runtime))
+ print("Plex server version %s" % server.version)
+
+ if opts.accept_eula:
+ server.settings.get("acceptedEULA").set(True)
+ # Disable settings for background tasks when using the test server.
+ # These tasks won't work on the test server since we are using fake media files
+ if not opts.unclaimed and account and account.subscriptionActive:
+ server.settings.get("GenerateIntroMarkerBehavior").set("never")
+ server.settings.get("GenerateCreditsMarkerBehavior").set("never")
+ server.settings.get("GenerateBIFBehavior").set("never")
+ server.settings.get("GenerateChapterThumbBehavior").set("never")
+ server.settings.get("LoudnessAnalysisBehavior").set("never")
+ server.settings.save()
+
+ sections = []
+
+ # Lets add a check here do somebody don't mess up
+ # there normal server if they run manual tests.
+ # Like i did....
+ if len(server.library.sections()) and opts.no_docker is True:
+ ans = input(
+ "The server has %s sections, do you wish to remove it?\n> "
+ % len(server.library.sections())
+ )
+ if ans in ("y", "Y", "Yes"):
+ ans = input(
+ "Are you really sure you want to delete %s libraries? There is no way back\n> "
+ % len(server.library.sections())
+ )
+ if ans in ("y", "Y", "Yes"):
+ clean_pms(server, path)
+ else:
+ raise ExistingSection()
+ else:
+ raise ExistingSection()
+
+ # Prepare Movies section
+ if opts.with_movies:
+ movies_path = os.path.join(media_path, "Movies")
+ num_movies = setup_movies(movies_path)
+
+ sections.append(
+ dict(
+ name="Movies-new-agent",
+ type="movie",
+ location="/data/Movies" if opts.no_docker is False else movies_path,
+ agent="tv.plex.agents.movie",
+ scanner="Plex Movie",
+ language="en-US",
+ expected_media_count=num_movies,
+ )
+ )
+ sections.append(
+ dict(
+ name="Movies-imdb-agent",
+ type="movie",
+ location="/data/Movies" if opts.no_docker is False else movies_path,
+ agent="com.plexapp.agents.imdb",
+ scanner="Plex Movie Scanner",
+ # language="en-US",
+ expected_media_count=num_movies,
+ )
+ )
+ sections.append(
+ dict(
+ name="Movies-themoviedb-agent",
+ type="movie",
+ location="/data/Movies" if opts.no_docker is False else movies_path,
+ agent="com.plexapp.agents.themoviedb",
+ scanner="Plex Movie Scanner",
+ # language="en-US",
+ expected_media_count=num_movies,
+ )
+ )
+
+ # Prepare TV Show section
+ if opts.with_shows:
+ tvshows_path = os.path.join(media_path, "TV-Shows")
+ num_ep = setup_show(tvshows_path)
+
+ sections.append(
+ dict(
+ name="TV Shows",
+ type="show",
+ location="/data/TV-Shows" if opts.no_docker is False else tvshows_path,
+ agent="tv.plex.agents.series",
+ scanner="Plex TV Series",
+ language="en-US",
+ expected_media_count=num_ep,
+ )
+ )
+
+ # Prepare Music section
+ if opts.with_music:
+ music_path = os.path.join(media_path, "Music")
+ song_c = setup_music(music_path, docker=not opts.no_docker)
+
+ sections.append(
+ dict(
+ name="Music",
+ type="artist",
+ location="/data/Music" if opts.no_docker is False else music_path,
+ agent="tv.plex.agents.music",
+ scanner="Plex Music",
+ language="en-US",
+ expected_media_count=song_c,
+ )
+ )
+
+ # Prepare Photos section
+ if opts.with_photos:
+ photos_path = os.path.join(media_path, "Photos")
+ has_photos = setup_images(photos_path)
+
+ sections.append(
+ dict(
+ name="Photos",
+ type="photo",
+ location="/data/Photos" if opts.no_docker is False else photos_path,
+ agent="com.plexapp.agents.none",
+ scanner="Plex Photo Scanner",
+ expected_media_count=has_photos,
+ )
+ )
+
+ # enable plugin for supported agents
+ legacy_agents = [
+ 'com.plexapp.agents.imdb',
+ 'com.plexapp.agents.themoviedb',
+ ]
+ for agent in legacy_agents:
+ server.query(
+ key='/system/agents/{agent}/config/1?order={agent}%2C{plugin_agent}'.format(
+ agent=agent,
+ plugin_agent='dev.lizardbyte.themerr-plex',
+ ), method=server._session.put)
+
+ # Create the Plex library in our instance
+ if sections:
+ print("Creating the Plex libraries on %s" % server.friendlyName)
+ for section in sections:
+ create_section(server, section, opts)
+
+ # Share this instance with the specified username
+ if account:
+ shared_username = os.environ.get("SHARED_USERNAME", "PKKid")
+ try:
+ user = account.user(shared_username)
+ account.updateFriend(user, server)
+ print("The server was shared with user %s" % shared_username)
+ except NotFound:
+ pass
+
+ # Finished: Display our Plex details
+ print("Base URL is %s" % server.url("", False))
+ if account and opts.show_token:
+ print("Auth token is %s" % account.authenticationToken)
+ print("Server %s is ready to use!" % opts.server_name)
diff --git a/tests/__init__.py b/tests/__init__.py
new file mode 100644
index 00000000..e69de29b
diff --git a/tests/conftest.py b/tests/conftest.py
index 100b5ccb..3fccc57c 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -1,22 +1,96 @@
+# -*- coding: utf-8 -*-
# standard imports
+from functools import partial
import os
import sys
+import time
# lib imports
+import plexapi
+from plexapi.exceptions import NotFound
+from plexapi.myplex import MyPlexAccount
+from plexapi.server import PlexServer
from plexhints.agent_kit import Agent
+from plexhints.core_kit import PLUGIN_LOGS_PATH
import pytest
+import requests
# add Contents directory to the system path
if os.path.isdir('Contents'):
sys.path.append('Contents')
# local imports
+ from Code import constants
from Code import Themerr
from Code import webapp
else:
raise Exception('Contents directory not found')
+# plex server setup
+SERVER_BASEURL = plexapi.CONFIG.get("auth.server_baseurl")
+MYPLEX_USERNAME = plexapi.CONFIG.get("auth.myplex_username")
+MYPLEX_PASSWORD = plexapi.CONFIG.get("auth.myplex_password")
+SERVER_TOKEN = plexapi.CONFIG.get("auth.server_token")
+TEST_AUTHENTICATED = "authenticated"
+TEST_ANONYMOUSLY = "anonymously"
+ANON_PARAM = pytest.param(TEST_ANONYMOUSLY, marks=pytest.mark.anonymous)
+AUTH_PARAM = pytest.param(TEST_AUTHENTICATED, marks=pytest.mark.authenticated)
+
+
+BASE_DIR_PATH = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+
+def pytest_generate_tests(metafunc):
+ if "plex" in metafunc.fixturenames:
+ if (
+ "account" in metafunc.fixturenames
+ or TEST_AUTHENTICATED in metafunc.definition.keywords
+ ):
+ metafunc.parametrize("plex", [AUTH_PARAM], indirect=True)
+ else:
+ metafunc.parametrize("plex", [ANON_PARAM, AUTH_PARAM], indirect=True)
+ elif "account" in metafunc.fixturenames:
+ metafunc.parametrize("account", [AUTH_PARAM], indirect=True)
+
+
+def pytest_runtest_setup(item):
+ if "client" in item.keywords and not item.config.getvalue("client"):
+ return pytest.skip("Need --client option to run.")
+ if TEST_AUTHENTICATED in item.keywords and not (MYPLEX_USERNAME and MYPLEX_PASSWORD or SERVER_TOKEN):
+ return pytest.skip(
+ "You have to specify MYPLEX_USERNAME and MYPLEX_PASSWORD or SERVER_TOKEN to run authenticated tests"
+ )
+ if TEST_ANONYMOUSLY in item.keywords and (MYPLEX_USERNAME and MYPLEX_PASSWORD or SERVER_TOKEN):
+ return pytest.skip(
+ "Anonymous tests should be ran on unclaimed server, without providing MYPLEX_USERNAME and "
+ "MYPLEX_PASSWORD or SERVER_TOKEN"
+ )
+
+
+def wait_for_themes(movies):
+ # ensure library is not refreshing
+ while movies.refreshing:
+ time.sleep(1)
+
+ # wait for themes to be uploaded
+ timer = 0
+ with_themes = 0
+ total = len(movies.all())
+ while timer < 180 and with_themes < total:
+ with_themes = 0
+ try:
+ for item in movies.all():
+ if item.theme:
+ with_themes += 1
+ except requests.ReadTimeout:
+ time.sleep(10) # try to recover from ReadTimeout (hit api limit?)
+ else:
+ time.sleep(3)
+ timer += 3
+
+
+# basic fixtures
@pytest.fixture
def agent():
# type: () -> Agent
@@ -36,3 +110,96 @@ def test_client(scope='function'):
# Establish an application context
with app.app_context():
yield test_client # this is where the testing happens!
+
+
+# plex server fixtures
+@pytest.fixture(scope="session")
+def plugin_logs():
+ # list contents of the plugin logs directory
+ plugin_logs = os.listdir(PLUGIN_LOGS_PATH)
+
+ yield plugin_logs
+
+
+# plex server fixtures
+@pytest.fixture(scope="session")
+def plugin_log_file():
+ # the primary plugin log file
+ plugin_log_file = os.path.join(PLUGIN_LOGS_PATH, "{}.log".format(constants.plugin_identifier))
+
+ yield plugin_log_file
+
+
+@pytest.fixture(scope="session")
+def sess():
+ session = requests.Session()
+ session.request = partial(session.request, timeout=120)
+ return session
+
+
+@pytest.fixture(scope="session")
+def plex(request, sess):
+ assert SERVER_BASEURL, "Required SERVER_BASEURL not specified."
+
+ if request.param == TEST_AUTHENTICATED:
+ token = MyPlexAccount(session=sess).authenticationToken
+ else:
+ token = None
+ return PlexServer(SERVER_BASEURL, token, session=sess)
+
+
+@pytest.fixture()
+def movies_new_agent(plex):
+ movies = plex.library.section("Movies-new-agent")
+ wait_for_themes(movies=movies)
+ return movies
+
+
+@pytest.fixture()
+def movies_imdb_agent(plex):
+ movies = plex.library.section("Movies-imdb-agent")
+ wait_for_themes(movies=movies)
+ return movies
+
+
+@pytest.fixture()
+def movies_themoviedb_agent(plex):
+ movies = plex.library.section("Movies-themoviedb-agent")
+ wait_for_themes(movies=movies)
+ return movies
+
+
+@pytest.fixture()
+def collection_new_agent(plex, movies_new_agent, movie_new_agent):
+ try:
+ return movies_new_agent.collection("Test Collection")
+ except NotFound:
+ return plex.createCollection(
+ title="Test Collection",
+ section=movies_new_agent,
+ items=movie_new_agent
+ )
+
+
+@pytest.fixture()
+def collection_imdb_agent(plex, movies_imdb_agent, movie_imdb_agent):
+ try:
+ return movies_imdb_agent.collection("Test Collection")
+ except NotFound:
+ return plex.createCollection(
+ title="Test Collection",
+ section=movies_imdb_agent,
+ items=movie_imdb_agent
+ )
+
+
+@pytest.fixture()
+def collection_themoviedb_agent(plex, movies_themoviedb_agent, movie_themoviedb_agent):
+ try:
+ return movies_themoviedb_agent.collection("Test Collection")
+ except NotFound:
+ return plex.createCollection(
+ title="Test Collection",
+ section=movies_themoviedb_agent,
+ items=movie_themoviedb_agent
+ )
diff --git a/tests/data/video_stub.mp4 b/tests/data/video_stub.mp4
new file mode 100644
index 0000000000000000000000000000000000000000..d9a10e3101d96c6dbd570b2e189bd7dc59cbeba7
GIT binary patch
literal 18184197
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 #XlnaAHp0J=9nVKB~
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