mirror of
https://github.com/lnbits/lnbits-legend.git
synced 2024-11-19 18:11:30 +01:00
588 lines
19 KiB
Python
588 lines
19 KiB
Python
import hashlib
|
|
import json
|
|
import os
|
|
import shutil
|
|
import sys
|
|
import urllib.request
|
|
import zipfile
|
|
from http import HTTPStatus
|
|
from pathlib import Path
|
|
from typing import Any, List, NamedTuple, Optional, Tuple
|
|
|
|
import httpx
|
|
from fastapi.exceptions import HTTPException
|
|
from fastapi.responses import JSONResponse
|
|
from loguru import logger
|
|
from pydantic import BaseModel
|
|
from starlette.types import ASGIApp, Receive, Scope, Send
|
|
|
|
from lnbits.settings import settings
|
|
|
|
|
|
class Extension(NamedTuple):
|
|
code: str
|
|
is_valid: bool
|
|
is_admin_only: bool
|
|
name: Optional[str] = None
|
|
short_description: Optional[str] = None
|
|
tile: Optional[str] = None
|
|
contributors: Optional[List[str]] = None
|
|
hidden: bool = False
|
|
migration_module: Optional[str] = None
|
|
db_name: Optional[str] = None
|
|
upgrade_hash: Optional[str] = ""
|
|
|
|
@property
|
|
def module_name(self):
|
|
return (
|
|
f"lnbits.extensions.{self.code}"
|
|
if self.upgrade_hash == ""
|
|
else f"lnbits.upgrades.{self.code}-{self.hash}.{self.code}"
|
|
)
|
|
|
|
@classmethod
|
|
def from_installable_ext(cls, ext_info: "InstallableExtension") -> "Extension":
|
|
return Extension(
|
|
code=ext_info.id,
|
|
is_valid=True,
|
|
is_admin_only=False, # todo: is admin only
|
|
name=ext_info.name,
|
|
upgrade_hash=ext_info.hash if ext_info.module_installed else "",
|
|
)
|
|
|
|
|
|
class ExtensionManager:
|
|
def __init__(self, include_disabled_exts=False):
|
|
self._disabled: List[str] = settings.lnbits_disabled_extensions
|
|
self._admin_only: List[str] = settings.lnbits_admin_extensions
|
|
self._extension_folders: List[str] = [
|
|
x[1] for x in os.walk(os.path.join(settings.lnbits_path, "extensions"))
|
|
][0]
|
|
|
|
@property
|
|
def extensions(self) -> List[Extension]:
|
|
output: List[Extension] = []
|
|
|
|
if "all" in self._disabled:
|
|
return output
|
|
|
|
for extension in [
|
|
ext for ext in self._extension_folders if ext not in self._disabled
|
|
]:
|
|
try:
|
|
with open(
|
|
os.path.join(
|
|
settings.lnbits_path, "extensions", extension, "config.json"
|
|
)
|
|
) as json_file:
|
|
config = json.load(json_file)
|
|
is_valid = True
|
|
is_admin_only = True if extension in self._admin_only else False
|
|
except Exception:
|
|
config = {}
|
|
is_valid = False
|
|
is_admin_only = False
|
|
|
|
output.append(
|
|
Extension(
|
|
extension,
|
|
is_valid,
|
|
is_admin_only,
|
|
config.get("name"),
|
|
config.get("short_description"),
|
|
config.get("tile"),
|
|
config.get("contributors"),
|
|
config.get("hidden") or False,
|
|
config.get("migration_module"),
|
|
config.get("db_name"),
|
|
)
|
|
)
|
|
|
|
return output
|
|
|
|
|
|
class ExtensionRelease(BaseModel):
|
|
name: str
|
|
version: str
|
|
archive: str
|
|
source_repo: str
|
|
hash: Optional[str]
|
|
html_url: Optional[str]
|
|
description: Optional[str]
|
|
details_html: Optional[str] = None
|
|
|
|
@classmethod
|
|
def from_github_release(
|
|
cls, source_repo: str, r: "GitHubRepoRelease"
|
|
) -> "ExtensionRelease":
|
|
return ExtensionRelease(
|
|
name=r.name,
|
|
description=r.name,
|
|
version=r.tag_name,
|
|
archive=r.zipball_url,
|
|
source_repo=source_repo,
|
|
# description=r.body, # bad for JSON
|
|
html_url=r.html_url,
|
|
)
|
|
|
|
@classmethod
|
|
async def all_releases(cls, org: str, repo: str) -> List["ExtensionRelease"]:
|
|
try:
|
|
github_releases = await fetch_github_releases(org, repo)
|
|
return [
|
|
ExtensionRelease.from_github_release(f"{org}/{repo}", r)
|
|
for r in github_releases
|
|
]
|
|
except Exception as e:
|
|
logger.warning(e)
|
|
return []
|
|
|
|
|
|
class ExplicitRelease(BaseModel):
|
|
id: str
|
|
name: str
|
|
version: str
|
|
archive: str
|
|
hash: str
|
|
dependencies: List[str] = []
|
|
icon: Optional[str]
|
|
short_description: Optional[str]
|
|
html_url: Optional[str]
|
|
details: Optional[str]
|
|
info_notification: Optional[str]
|
|
critical_notification: Optional[str]
|
|
|
|
|
|
class GitHubRelease(BaseModel):
|
|
id: str
|
|
organisation: str
|
|
repository: str
|
|
|
|
|
|
class Manifest(BaseModel):
|
|
featured: List[str] = []
|
|
extensions: List["ExplicitRelease"] = []
|
|
repos: List["GitHubRelease"] = []
|
|
|
|
|
|
class GitHubRepoRelease(BaseModel):
|
|
name: str
|
|
tag_name: str
|
|
zipball_url: str
|
|
html_url: str
|
|
|
|
|
|
class GitHubRepo(BaseModel):
|
|
stargazers_count: str
|
|
html_url: str
|
|
default_branch: str
|
|
|
|
|
|
class ExtensionConfig(BaseModel):
|
|
name: str
|
|
short_description: str
|
|
tile: str
|
|
|
|
|
|
class InstallableExtension(BaseModel):
|
|
id: str
|
|
name: str
|
|
short_description: Optional[str] = None
|
|
icon: Optional[str] = None
|
|
icon_url: Optional[str] = None
|
|
dependencies: List[str] = []
|
|
is_admin_only: bool = False
|
|
stars: int = 0
|
|
featured = False
|
|
latest_release: Optional[ExtensionRelease]
|
|
installed_release: Optional[ExtensionRelease]
|
|
|
|
@property
|
|
def hash(self) -> str:
|
|
if self.installed_release:
|
|
if self.installed_release.hash:
|
|
return self.installed_release.hash
|
|
m = hashlib.sha256()
|
|
m.update(f"{self.installed_release.archive}".encode())
|
|
return m.hexdigest()
|
|
return "not-installed"
|
|
|
|
@property
|
|
def zip_path(self) -> str:
|
|
extensions_data_dir = os.path.join(settings.lnbits_data_folder, "extensions")
|
|
os.makedirs(extensions_data_dir, exist_ok=True)
|
|
return os.path.join(extensions_data_dir, f"{self.id}.zip")
|
|
|
|
@property
|
|
def ext_dir(self) -> str:
|
|
return os.path.join("lnbits", "extensions", self.id)
|
|
|
|
@property
|
|
def ext_upgrade_dir(self) -> str:
|
|
return os.path.join("lnbits", "upgrades", f"{self.id}-{self.hash}")
|
|
|
|
@property
|
|
def module_name(self) -> str:
|
|
return f"lnbits.extensions.{self.id}"
|
|
|
|
@property
|
|
def module_installed(self) -> bool:
|
|
return self.module_name in sys.modules
|
|
|
|
@property
|
|
def has_installed_version(self) -> bool:
|
|
if not Path(self.ext_dir).is_dir():
|
|
return False
|
|
config_file = os.path.join(self.ext_dir, "config.json")
|
|
if not Path(config_file).is_file():
|
|
return False
|
|
with open(config_file, "r") as json_file:
|
|
config_json = json.load(json_file)
|
|
return config_json.get("is_installed") == True
|
|
|
|
def download_archive(self):
|
|
ext_zip_file = self.zip_path
|
|
if os.path.isfile(ext_zip_file):
|
|
os.remove(ext_zip_file)
|
|
try:
|
|
download_url(self.installed_release.archive, ext_zip_file)
|
|
except Exception as ex:
|
|
logger.warning(ex)
|
|
raise HTTPException(
|
|
status_code=HTTPStatus.NOT_FOUND,
|
|
detail="Cannot fetch extension archive file",
|
|
)
|
|
|
|
archive_hash = file_hash(ext_zip_file)
|
|
if self.installed_release.hash and self.installed_release.hash != archive_hash:
|
|
# remove downloaded archive
|
|
if os.path.isfile(ext_zip_file):
|
|
os.remove(ext_zip_file)
|
|
raise HTTPException(
|
|
status_code=HTTPStatus.NOT_FOUND,
|
|
detail="File hash missmatch. Will not install.",
|
|
)
|
|
|
|
def extract_archive(self):
|
|
os.makedirs(os.path.join("lnbits", "upgrades"), exist_ok=True)
|
|
shutil.rmtree(self.ext_upgrade_dir, True)
|
|
with zipfile.ZipFile(self.zip_path, "r") as zip_ref:
|
|
zip_ref.extractall(self.ext_upgrade_dir)
|
|
generated_dir_name = os.listdir(self.ext_upgrade_dir)[0]
|
|
os.rename(
|
|
os.path.join(self.ext_upgrade_dir, generated_dir_name),
|
|
os.path.join(self.ext_upgrade_dir, self.id),
|
|
)
|
|
|
|
# Pre-packed extensions can be upgraded
|
|
# Mark the extension as installed so we know it is not the pre-packed version
|
|
with open(
|
|
os.path.join(self.ext_upgrade_dir, self.id, "config.json"), "r+"
|
|
) as json_file:
|
|
config_json = json.load(json_file)
|
|
config_json["is_installed"] = True
|
|
json_file.seek(0)
|
|
json.dump(config_json, json_file)
|
|
json_file.truncate()
|
|
|
|
self.name = config_json.get("name")
|
|
self.short_description = config_json.get("short_description")
|
|
self.icon = config_json.get("icon")
|
|
if self.installed_release and config_json.get("tile"):
|
|
self.icon_url = icon_to_github_url(
|
|
self.installed_release.source_repo, config_json.get("tile")
|
|
)
|
|
|
|
shutil.rmtree(self.ext_dir, True)
|
|
shutil.copytree(
|
|
os.path.join(self.ext_upgrade_dir, self.id),
|
|
os.path.join("lnbits", "extensions", self.id),
|
|
)
|
|
|
|
def nofiy_upgrade(self) -> None:
|
|
"""Update the list of upgraded extensions. The middleware will perform redirects based on this"""
|
|
|
|
clean_upgraded_exts = list(
|
|
filter(
|
|
lambda old_ext: not old_ext.endswith(f"/{self.id}"),
|
|
settings.lnbits_upgraded_extensions,
|
|
)
|
|
)
|
|
settings.lnbits_upgraded_extensions = clean_upgraded_exts + [
|
|
f"{self.hash}/{self.id}"
|
|
]
|
|
|
|
def clean_extension_files(self):
|
|
# remove downloaded archive
|
|
if os.path.isfile(self.zip_path):
|
|
os.remove(self.zip_path)
|
|
|
|
# remove module from extensions
|
|
shutil.rmtree(self.ext_dir, True)
|
|
|
|
shutil.rmtree(self.ext_upgrade_dir, True)
|
|
|
|
@classmethod
|
|
def from_row(cls, data: dict) -> "InstallableExtension":
|
|
meta = json.loads(data["meta"])
|
|
ext = InstallableExtension(**data)
|
|
if "installed_release" in meta:
|
|
ext.installed_release = ExtensionRelease(**meta["installed_release"])
|
|
return ext
|
|
|
|
@classmethod
|
|
async def from_github_release(
|
|
cls, github_release: GitHubRelease
|
|
) -> Optional["InstallableExtension"]:
|
|
try:
|
|
repo, latest_release, config = await fetch_github_repo_info(
|
|
github_release.organisation, github_release.repository
|
|
)
|
|
|
|
return InstallableExtension(
|
|
id=github_release.id,
|
|
name=config.name,
|
|
short_description=config.short_description,
|
|
version="0",
|
|
stars=repo.stargazers_count,
|
|
icon_url=icon_to_github_url(
|
|
f"{github_release.organisation}/{github_release.repository}",
|
|
config.tile,
|
|
),
|
|
latest_release=ExtensionRelease.from_github_release(
|
|
repo.html_url, latest_release
|
|
),
|
|
)
|
|
except Exception as e:
|
|
logger.warning(e)
|
|
return None
|
|
|
|
@classmethod
|
|
def from_explicit_release(cls, e: ExplicitRelease) -> "InstallableExtension":
|
|
return InstallableExtension(
|
|
id=e.id,
|
|
name=e.name,
|
|
archive=e.archive,
|
|
hash=e.hash,
|
|
short_description=e.short_description,
|
|
icon=e.icon,
|
|
dependencies=e.dependencies,
|
|
)
|
|
|
|
@classmethod
|
|
async def get_installable_extensions(
|
|
cls,
|
|
) -> List["InstallableExtension"]:
|
|
extension_list: List[InstallableExtension] = []
|
|
extension_id_list: List[str] = []
|
|
|
|
for url in settings.lnbits_extensions_manifests:
|
|
try:
|
|
manifest = await fetch_manifest(url)
|
|
|
|
for r in manifest.repos:
|
|
if r.id in extension_id_list:
|
|
continue
|
|
ext = await InstallableExtension.from_github_release(r)
|
|
if ext:
|
|
ext.featured = ext.id in manifest.featured
|
|
extension_list += [ext]
|
|
extension_id_list += [ext.id]
|
|
|
|
for e in manifest.extensions:
|
|
if e.id in extension_id_list:
|
|
continue
|
|
ext = InstallableExtension.from_explicit_release(e)
|
|
ext.featured = ext.id in manifest.featured
|
|
extension_list += [ext]
|
|
extension_id_list += [e.id]
|
|
except Exception as e:
|
|
logger.warning(f"Manifest {url} failed with '{str(e)}'")
|
|
|
|
return extension_list
|
|
|
|
@classmethod
|
|
async def get_extension_releases(cls, ext_id: str) -> List["ExtensionRelease"]:
|
|
extension_releases: List[ExtensionRelease] = []
|
|
|
|
for url in settings.lnbits_extensions_manifests:
|
|
try:
|
|
manifest = await fetch_manifest(url)
|
|
for r in manifest.repos:
|
|
if r.id == ext_id:
|
|
repo_releases = await ExtensionRelease.all_releases(
|
|
r.organisation, r.repository
|
|
)
|
|
extension_releases += repo_releases
|
|
|
|
for e in manifest.extensions:
|
|
if e.id == ext_id:
|
|
extension_releases += [
|
|
ExtensionRelease(
|
|
name=e.name,
|
|
version=e.version,
|
|
archive=e.archive,
|
|
hash=e.hash,
|
|
source_repo=url,
|
|
description=e.short_description,
|
|
details_html=e.details,
|
|
html_url=e.html_url,
|
|
)
|
|
]
|
|
|
|
except Exception as e:
|
|
logger.warning(f"Manifest {url} failed with '{str(e)}'")
|
|
|
|
return extension_releases
|
|
|
|
@classmethod
|
|
async def get_extension_release(
|
|
cls, ext_id: str, source_repo: str, archive: str
|
|
) -> Optional["ExtensionRelease"]:
|
|
all_releases: List[
|
|
ExtensionRelease
|
|
] = await InstallableExtension.get_extension_releases(ext_id)
|
|
selected_release = [
|
|
r
|
|
for r in all_releases
|
|
if r.archive == archive and r.source_repo == source_repo
|
|
]
|
|
|
|
return selected_release[0] if len(selected_release) != 0 else None
|
|
|
|
|
|
class InstalledExtensionMiddleware:
|
|
# This middleware class intercepts calls made to the extensions API and:
|
|
# - it blocks the calls if the extension has been disabled or uninstalled.
|
|
# - it redirects the calls to the latest version of the extension if the extension has been upgraded.
|
|
# - otherwise it has no effect
|
|
def __init__(self, app: ASGIApp) -> None:
|
|
self.app = app
|
|
|
|
async def __call__(self, scope: Scope, receive: Receive, send: Send) -> None:
|
|
if not "path" in scope:
|
|
await self.app(scope, receive, send)
|
|
return
|
|
|
|
path_elements = scope["path"].split("/")
|
|
if len(path_elements) > 2:
|
|
_, path_name, path_type, *rest = path_elements
|
|
else:
|
|
_, path_name = path_elements
|
|
path_type = None
|
|
|
|
# block path for all users if the extension is disabled
|
|
if path_name in settings.lnbits_deactivated_extensions:
|
|
response = JSONResponse(
|
|
status_code=HTTPStatus.NOT_FOUND,
|
|
content={"detail": f"Extension '{path_name}' disabled"},
|
|
)
|
|
await response(scope, receive, send)
|
|
return
|
|
|
|
# re-route API trafic if the extension has been upgraded
|
|
if path_type == "api":
|
|
upgraded_extensions = list(
|
|
filter(
|
|
lambda ext: ext.endswith(f"/{path_name}"),
|
|
settings.lnbits_upgraded_extensions,
|
|
)
|
|
)
|
|
if len(upgraded_extensions) != 0:
|
|
upgrade_path = upgraded_extensions[0]
|
|
tail = "/".join(rest)
|
|
scope["path"] = f"/upgrades/{upgrade_path}/{path_type}/{tail}"
|
|
|
|
await self.app(scope, receive, send)
|
|
|
|
|
|
class CreateExtension(BaseModel):
|
|
ext_id: str
|
|
archive: str
|
|
source_repo: str
|
|
|
|
|
|
def get_valid_extensions() -> List[Extension]:
|
|
return [
|
|
extension for extension in ExtensionManager().extensions if extension.is_valid
|
|
]
|
|
|
|
|
|
def download_url(url, save_path):
|
|
with urllib.request.urlopen(url) as dl_file:
|
|
with open(save_path, "wb") as out_file:
|
|
out_file.write(dl_file.read())
|
|
|
|
|
|
def file_hash(filename):
|
|
h = hashlib.sha256()
|
|
b = bytearray(128 * 1024)
|
|
mv = memoryview(b)
|
|
with open(filename, "rb", buffering=0) as f:
|
|
while n := f.readinto(mv):
|
|
h.update(mv[:n])
|
|
return h.hexdigest()
|
|
|
|
|
|
def icon_to_github_url(source_repo: str, path: Optional[str]) -> str:
|
|
if not path:
|
|
return ""
|
|
_, _, *rest = path.split("/")
|
|
tail = "/".join(rest)
|
|
return f"https://github.com/{source_repo}/raw/main/{tail}"
|
|
|
|
|
|
async def fetch_github_repo_info(
|
|
org: str, repository: str
|
|
) -> Tuple[GitHubRepo, GitHubRepoRelease, ExtensionConfig]:
|
|
repo_url = f"https://api.github.com/repos/{org}/{repository}"
|
|
error_msg = "Cannot fetch extension repo"
|
|
repo = await gihub_api_get(repo_url, error_msg)
|
|
github_repo = GitHubRepo.parse_obj(repo)
|
|
|
|
lates_release_url = (
|
|
f"https://api.github.com/repos/{org}/{repository}/releases/latest"
|
|
)
|
|
error_msg = "Cannot fetch extension releases"
|
|
latest_release: Any = await gihub_api_get(lates_release_url, error_msg)
|
|
|
|
config_url = f"https://raw.githubusercontent.com/{org}/{repository}/{github_repo.default_branch}/config.json"
|
|
error_msg = "Cannot fetch config for extension"
|
|
config = await gihub_api_get(config_url, error_msg)
|
|
|
|
return (
|
|
github_repo,
|
|
GitHubRepoRelease.parse_obj(latest_release),
|
|
ExtensionConfig.parse_obj(config),
|
|
)
|
|
|
|
|
|
async def fetch_manifest(url) -> Manifest:
|
|
error_msg = "Cannot fetch extensions manifest"
|
|
manifest = await gihub_api_get(url, error_msg)
|
|
return Manifest.parse_obj(manifest)
|
|
|
|
|
|
async def fetch_github_releases(org: str, repo: str) -> List[GitHubRepoRelease]:
|
|
releases_url = f"https://api.github.com/repos/{org}/{repo}/releases"
|
|
error_msg = "Cannot fetch extension releases"
|
|
releases = await gihub_api_get(releases_url, error_msg)
|
|
return [GitHubRepoRelease.parse_obj(r) for r in releases]
|
|
|
|
|
|
async def gihub_api_get(url: str, error_msg: Optional[str]) -> Any:
|
|
async with httpx.AsyncClient() as client:
|
|
headers = (
|
|
{"Authorization": "Bearer " + settings.lnbits_ext_github_token}
|
|
if settings.lnbits_ext_github_token
|
|
else None
|
|
)
|
|
resp = await client.get(
|
|
url,
|
|
headers=headers,
|
|
)
|
|
if resp.status_code != 200:
|
|
logger.warning(f"{error_msg} ({url}): {resp.text}")
|
|
resp.raise_for_status()
|
|
return resp.json()
|