devart-dl 4.3.3__tar.gz → 4.4.0__tar.gz

{devart_dl-4.3.3/devart_dl.egg-info → devart_dl-4.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devart-dl
-Version: 4.3.3
+Version: 4.4.0
 Summary: 专业的 DeviantArt 作品批量下载工具 - Professional DeviantArt batch downloader with anti-ban features
 Author: DeviantArt Downloader Team
 License-Expression: MIT
@@ -89,11 +89,13 @@ devart-dl login browser   # 打开你的 Chrome 登录，自动保存 Cookie，
 
 - **官方 API（OAuth）优先**：登录一次即可下载原图，无需导出 Cookie，也无需防封延时。
 - **URL 优先**：直接粘贴作品 / 画廊 / 收藏夹 / 标签链接即可下载。
+- **文本作品**：文学 / 日志型 deviation 在响应内直接提取正文，保存为 UTF-8 `.txt`；媒体与文本自动分流。
 - **下载可靠**：HTTP Range 断点续传、自动重试、429 退避、原子落盘。
 - **下载档案**：`--archive` 用 SQLite 记住已下载，跨会话自动跳过。
 - **路径模板 + 元数据 sidecar**：`--directory`/`--filename` 模板与 `--write-info-json`。
 - **代理与降级**：支持 `--proxy`；未登录 OAuth 时自动回退 Cookie。
 - **Resolve 模式**：`devart-dl resolve URL` 输出 `ResolvedDeviation`/`MediaAsset` 的 JSON 契约，不写文件。
+- **付费/订阅锁定识别**：官方 API 返回 `premium_folder_data` / `tier_access`，或网页端非成熟作品的模糊主图（`blur_`），都会识别为「需要订阅/购买」：网页通道跳过，官方通道明确报错，不再把打码图当原图保存。
 
 ## 文档
 

{devart_dl-4.3.3 → devart_dl-4.4.0}/README.en.md

@@ -20,11 +20,13 @@ See [CHANGELOG.md](CHANGELOG.md) for release notes.
 
 - **Official API first (OAuth)** — log in once to download originals; no cookie export, no anti-ban delays.
 - **URL-first** — `devart-dl URL` downloads artworks / galleries / favourites / tags / fav.me links directly.
+- **Literature support** — extracts inline literature/journal bodies and saves them as UTF-8 `.txt`, with media and text handled by the same pipeline.
 - **Reliable downloads** — HTTP Range resume, automatic retry, 429 backoff, HTML/empty-file validation, atomic finalize.
 - **Download archive** — `--archive` remembers what you've downloaded in SQLite, skipping it across sessions.
 - **Path templates** — `--directory` / `--filename` support `{id}` `{title}` `{author}` `{published}` `{ext}` and more, with safe sanitization.
 - **Metadata sidecars** — `--write-info-json` writes a `.json` next to each file.
 - **Proxy & fallback** — `--proxy` or proxy environment variables; falls back to cookies when not logged in via OAuth.
+- **Paid / subscription-lock detection** — official API `premium_folder_data` / `tier_access`, or a blurred (`blur_`) non-mature main on the web path, is recognised as subscription/purchase-gated: the web path skips it and the official path fails with a clear message instead of saving a censored placeholder.
 
 ---
 

{devart_dl-4.3.3 → devart_dl-4.4.0}/README.md

@@ -55,11 +55,13 @@ devart-dl login browser   # 打开你的 Chrome 登录，自动保存 Cookie，
 
 - **官方 API（OAuth）优先**：登录一次即可下载原图，无需导出 Cookie，也无需防封延时。
 - **URL 优先**：直接粘贴作品 / 画廊 / 收藏夹 / 标签链接即可下载。
+- **文本作品**：文学 / 日志型 deviation 在响应内直接提取正文，保存为 UTF-8 `.txt`；媒体与文本自动分流。
 - **下载可靠**：HTTP Range 断点续传、自动重试、429 退避、原子落盘。
 - **下载档案**：`--archive` 用 SQLite 记住已下载，跨会话自动跳过。
 - **路径模板 + 元数据 sidecar**：`--directory`/`--filename` 模板与 `--write-info-json`。
 - **代理与降级**：支持 `--proxy`；未登录 OAuth 时自动回退 Cookie。
 - **Resolve 模式**：`devart-dl resolve URL` 输出 `ResolvedDeviation`/`MediaAsset` 的 JSON 契约，不写文件。
+- **付费/订阅锁定识别**：官方 API 返回 `premium_folder_data` / `tier_access`，或网页端非成熟作品的模糊主图（`blur_`），都会识别为「需要订阅/购买」：网页通道跳过，官方通道明确报错，不再把打码图当原图保存。
 
 ## 文档
 

{devart_dl-4.3.3 → devart_dl-4.4.0}/da_downloader/manager.py

@@ -73,9 +73,17 @@ class DownloadManager:
             return DownloadOutcome(item.artwork_id, "planned", path=path)
 
         try:
-            result: TransferResult = self.downloader.download(
-                item.media_url, path, overwrite=self.overwrite
-            )
+            if item.content is not None:
+                path.parent.mkdir(parents=True, exist_ok=True)
+                part = path.with_name(path.name + ".part")
+                with part.open("w", encoding="utf-8", newline="\n") as stream:
+                    stream.write(item.content)
+                part.replace(path)
+                result = TransferResult(path, len(item.content.encode("utf-8")))
+            else:
+                result = self.downloader.download(
+                    item.media_url, path, overwrite=self.overwrite
+                )
         except DeviantArtError as exc:
             return DownloadOutcome(item.artwork_id, "failed", path=path, reason=str(exc))
 

{devart_dl-4.3.3 → devart_dl-4.4.0}/da_downloader/models.py

@@ -3,9 +3,12 @@ DownloadItem contract that crosses the provider/downloader boundary."""
 
 from __future__ import annotations
 
+import json
+import re
 from dataclasses import dataclass, field
 from datetime import datetime
 from enum import Enum
+from html import unescape
 from typing import Any, Dict, Mapping, Optional
 
 
@@ -29,6 +32,8 @@ class Deviation:
     is_downloadable: bool
     is_mature: bool
     deviation_type: str
+    premium: bool = False
+    text_content: Dict[str, Any] = field(default_factory=dict)
 
     @classmethod
     def from_api_response(cls, data: Dict[str, Any]) -> "Deviation":
@@ -45,6 +50,9 @@ class Deviation:
         media = data.get("media") or {}
         if not isinstance(media, dict):
             media = {}
+        text_content = data.get("textContent") or data.get("text_content") or {}
+        if not isinstance(text_content, dict):
+            text_content = {}
 
         deviation_type = data.get("type", "unknown")
         if data.get("isVideo"):
@@ -63,6 +71,8 @@ class Deviation:
             ),
             is_mature=bool(data.get("isMature", data.get("is_mature", False))),
             deviation_type=str(deviation_type),
+            premium=_is_locked(data),
+            text_content=text_content,
         )
 
     def _extract_extension_from_media(self, media: Dict[str, Any]) -> str:
@@ -91,12 +101,73 @@ class Deviation:
         flags = []
         if self.is_mature:
             flags.append("MATURE")
+        if self.premium:
+            flags.append("PREMIUM")
         if self.is_downloadable:
             flags.append("DOWNLOADABLE")
         flag_str = f" [{', '.join(flags)}]" if flags else ""
         return f"{self.title} by {self.author}{flag_str}"
 
 
+def literature_text(payload: Mapping[str, Any]) -> str:
+    """Extract plain UTF-8 text from a DeviantArt literature DTO.
+
+    DeviantArt currently stores tiptap JSON in ``textContent.html.markup``;
+    older journal payloads use HTML. Both are accepted, while non-literature
+    DTOs return an empty string.
+    """
+    html = payload.get("textContent") or payload.get("text_content") or {}
+    if not isinstance(html, dict):
+        return ""
+    markup = (html.get("html") or {}).get("markup")
+    if markup is None:
+        return ""
+    if isinstance(markup, dict):
+        return _tiptap_text(markup).strip()
+    if not isinstance(markup, str) or not markup.strip():
+        return ""
+    try:
+        return _tiptap_text(json.loads(markup)).strip()
+    except (TypeError, ValueError):
+        text = re.sub(r"<br\s*/?>", "\n", markup, flags=re.IGNORECASE)
+        text = re.sub(r"</p\s*>", "\n", text, flags=re.IGNORECASE)
+        text = re.sub(r"<[^>]+>", "", text)
+        return re.sub(r"\n{3,}", "\n\n", unescape(text)).strip()
+
+
+def _tiptap_text(node: Any) -> str:
+    if not isinstance(node, dict):
+        return ""
+    parts: list[str] = []
+    if isinstance(node.get("text"), str):
+        parts.append(node["text"])
+    if node.get("type") == "hardBreak":
+        parts.append("\n")
+    content = node.get("content")
+    if isinstance(content, list):
+        parts.extend(_tiptap_text(child) for child in content)
+    if node.get("type") in {
+        "paragraph",
+        "bulletList",
+        "orderedList",
+        "blockquote",
+        "codeBlock",
+    }:
+        parts.append("\n")
+    return "".join(parts)
+
+
+def _is_locked(data: Dict[str, Any]) -> bool:
+    """True for premium/subscription-locked works (official/web DTO shapes)."""
+    premium = data.get("premium_folder_data") or data.get("premiumFolderData")
+    if isinstance(premium, dict):
+        access = premium.get("has_access", premium.get("hasAccess"))
+        if access is False:
+            return True
+    tier = data.get("tier_access") or data.get("tierAccess")
+    return tier in ("locked", "locked-subscribed")
+
+
 @dataclass(frozen=True)
 class DownloadItem:
     """A single resolved media file, produced by a provider and consumed by the
@@ -108,14 +179,16 @@ class DownloadItem:
     url: str  # deviation page URL (for metadata / archive identity)
     title: str
     author: str
-    media_url: str  # the actual file to download
+    media_url: str  # the actual file to download (empty for inline literature)
     extension: Optional[str] = None  # without leading dot, e.g. "jpg"
+    content: Optional[str] = None  # inline UTF-8 payload (literature); no HTTP download
     published_at: Optional[datetime] = None
     mature: bool = False
     metadata: Mapping[str, Any] = field(default_factory=dict)
 
 
 _MIME_BY_EXT = {
+    "txt": "text/plain",
     "jpg": "image/jpeg",
     "jpeg": "image/jpeg",
     "png": "image/png",
@@ -130,7 +203,7 @@ _MIME_BY_EXT = {
 
 _VIDEO_EXTS = frozenset({"mp4", "webm", "mov", "m4v"})
 
-_DEFAULT_MIME = {"image": "image/jpeg", "video": "video/mp4"}
+_DEFAULT_MIME = {"image": "image/jpeg", "video": "video/mp4", "document": "text/plain"}
 
 
 @dataclass(frozen=True)
@@ -199,7 +272,10 @@ def make_media_asset(
     mature: bool = False,
 ) -> MediaAsset:
     ext = (extension or "").lstrip(".").lower() or None
-    kind = "video" if ext in _VIDEO_EXTS else "image"
+    if ext == "txt":
+        kind = "document"
+    else:
+        kind = "video" if ext in _VIDEO_EXTS else "image"
     return MediaAsset(
         id=f"deviantart:{deviation_id}:p{index}",
         deviation_id=deviation_id,

{devart_dl-4.3.3 → devart_dl-4.4.0}/da_downloader/official_api.py

@@ -316,6 +316,26 @@ def deviation_uuid(init_data: dict) -> str:
     return uuid
 
 
+def is_locked(deviation: dict) -> bool:
+    """Premium/paid works the current account cannot access.
+
+    The official DTO marks these with ``premium_folder_data.has_access ==
+    False`` or ``tier_access`` locked states (matching DAKit); the web DTO may
+    use the camelCase pair ``premiumFolderData.hasAccess`` / ``tierAccess``.
+    """
+    premium = deviation.get("premium_folder_data") or deviation.get(
+        "premiumFolderData"
+    )
+    if isinstance(premium, dict) and premium.get("has_access", premium.get("hasAccess")) is False:
+        return True
+    tier = deviation.get("tier_access") or deviation.get("tierAccess")
+    return tier in ("locked", "locked-subscribed")
+
+
+def is_blurred(url: str) -> bool:
+    """True when the URL is a censored ``blur_`` Wix transform (mature/paid)."""
+    return "blur_" in url
+
 def additional_media_urls(init_data: dict) -> list:
     """Original-file URLs of a multimedia deviation's extra pages
     (``deviation.extended.additionalMedia``, each entry nests its Wix
@@ -336,7 +356,7 @@ def additional_media_urls(init_data: dict) -> list:
         if not isinstance(media, dict):
             continue
         url = _descriptor_media_url(media)
-        if url and "blur_" not in url:
+        if url and not is_blurred(url):
             urls.append(url)
     return urls
 

{devart_dl-4.3.3 → devart_dl-4.4.0}/da_downloader/provider.py

@@ -14,12 +14,14 @@ from typing import Any, Callable, Iterator, Optional, Protocol
 from .api import ActionType, DeviantArtAPI
 from .errors import MediaUnavailableError, ParseError
 from .errors import AuthenticationError, NetworkError
-from .models import Deviation, DownloadItem
+from .models import Deviation, DownloadItem, literature_text
 from .official_api import (
     OfficialApiClient,
     additional_media_urls,
     deviation_init,
     deviation_uuid,
+    is_blurred,
+    is_locked,
 )
 from .targets import DownloadTarget, TargetKind
 
@@ -114,12 +116,34 @@ class WebProvider:
                 break
 
     def _to_item(self, deviation: Deviation) -> Optional[DownloadItem]:
+        if deviation.deviation_type == "literature":
+            text = literature_text({"textContent": deviation.text_content})
+            if text:
+                return DownloadItem(
+                    artwork_id=deviation.deviation_id,
+                    url=deviation.url,
+                    title=deviation.title,
+                    author=deviation.author,
+                    media_url="",
+                    extension="txt",
+                    content=text,
+                    mature=deviation.is_mature,
+                    metadata={"kind": "literature"},
+                )
+            logger.warning("empty literature payload for %r; skipping", deviation.title)
+            return None
+
         media_url = self.api.get_download_url(deviation, self.quality)
         if media_url is None and self.quality == "o":
             media_url = self.api.get_download_url(deviation, "f")
         if media_url is None:
             logger.warning("no media URL for %r; skipping", deviation.title)
             return None
+        # 付费/订阅锁定：非成熟作品的模糊主图 = 当前账号拿不到原图，跳过而不是把
+        # 打码图当成作品保存（成熟打码由 official provider / additional pages 处理）。
+        if deviation.premium or (not deviation.is_mature and is_blurred(media_url)):
+            logger.warning("premium/subscription-locked %r; skipping", deviation.title)
+            return None
         return DownloadItem(
             artwork_id=deviation.deviation_id,
             url=deviation.url,
@@ -207,6 +231,24 @@ class OfficialProvider:
         identifier = target.identifier or ""
         init_data = deviation_init(identifier, target.username)
         uuid = deviation_uuid(init_data)
+        init_deviation = init_data.get("deviation") if isinstance(init_data, dict) else {}
+        if isinstance(init_deviation, dict) and init_deviation.get("type") == "literature":
+            text = literature_text(init_deviation)
+            if text:
+                author = init_deviation.get("author") or {}
+                yield DownloadItem(
+                    artwork_id=uuid,
+                    url=str(init_deviation.get("url") or ""),
+                    title=str(init_deviation.get("title") or "Untitled"),
+                    author=str(author.get("username") or "unknown"),
+                    media_url="",
+                    extension="txt",
+                    content=text,
+                    published_at=_parse_published(init_deviation.get("published_time")),
+                    mature=bool(init_deviation.get("is_mature", False)),
+                    metadata={"kind": "literature", "quality": self.quality},
+                )
+                return
         main = self._item(self.client.deviation(uuid))
         yield main
         for index, url in enumerate(additional_media_urls(init_data), start=1):
@@ -244,6 +286,21 @@ class OfficialProvider:
         if not uuid:
             raise ParseError("a deviation is missing its id")
         author = deviation.get("author") or {}
+        if deviation.get("type") == "literature":
+            text = literature_text(deviation)
+            if text:
+                return DownloadItem(
+                    artwork_id=uuid,
+                    url=str(deviation.get("url") or ""),
+                    title=str(deviation.get("title") or "Untitled"),
+                    author=str(author.get("username") or "unknown"),
+                    media_url="",
+                    extension="txt",
+                    content=text,
+                    published_at=_parse_published(deviation.get("published_time")),
+                    mature=bool(deviation.get("is_mature", False)),
+                    metadata={"kind": "literature", "quality": self.quality},
+                )
         media_url, ext = self._media(deviation, uuid)
         return DownloadItem(
             artwork_id=uuid,
@@ -262,6 +319,8 @@ class OfficialProvider:
             original = self.client.original_download(uuid)
             ext = _ext_from_url(original.filename)
             return original.url, ext
+        url: Optional[str] = None
+        ext: Optional[str] = None
         content = deviation.get("content") or {}
         # `content.src` is a poster for video works; only videos[].src is playable.
         videos = deviation.get("videos") or []
@@ -269,16 +328,27 @@ class OfficialProvider:
             for video in videos:
                 src = video.get("src") if isinstance(video, dict) else None
                 if src:
-                    return str(src), _ext_from_url(str(src))
-        if content.get("src"):
-            return str(content["src"]), _ext_from_url(str(content["src"]))
-        preview = deviation.get("preview") or {}
-        if preview.get("src"):
-            return str(preview["src"]), _ext_from_url(str(preview["src"]))
-        thumbs = deviation.get("thumbs") or []
-        if thumbs and isinstance(thumbs[0], dict) and thumbs[0].get("src"):
-            return str(thumbs[0]["src"]), _ext_from_url(str(thumbs[0]["src"]))
-        raise MediaUnavailableError(f"no media available for deviation {uuid}")
+                    url, ext = str(src), _ext_from_url(str(src))
+                    break
+        if url is None and content.get("src"):
+            url, ext = str(content["src"]), _ext_from_url(str(content["src"]))
+        if url is None:
+            preview = deviation.get("preview") or {}
+            if preview.get("src"):
+                url, ext = str(preview["src"]), _ext_from_url(str(preview["src"]))
+        if url is None:
+            thumbs = deviation.get("thumbs") or []
+            if thumbs and isinstance(thumbs[0], dict) and thumbs[0].get("src"):
+                url, ext = str(thumbs[0]["src"]), _ext_from_url(str(thumbs[0]["src"]))
+        if url is None:
+            raise MediaUnavailableError(f"no media available for deviation {uuid}")
+        # 付费/订阅锁定：非成熟作品的模糊主图（或显式 premium 字段）＝拿不到原图，
+        # 明确报错而不是保存一张打码占位图。成熟作品由 mature_content=true 提供未打码源。
+        if is_locked(deviation) or (not deviation.get("is_mature") and is_blurred(url)):
+            raise MediaUnavailableError(
+                f"deviation {uuid} requires a subscription/purchase (premium)"
+            )
+        return url, ext
 
 
 def _ext_from_url(url: str) -> Optional[str]:

{devart_dl-4.3.3 → devart_dl-4.4.0/devart_dl.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devart-dl
-Version: 4.3.3
+Version: 4.4.0
 Summary: 专业的 DeviantArt 作品批量下载工具 - Professional DeviantArt batch downloader with anti-ban features
 Author: DeviantArt Downloader Team
 License-Expression: MIT
@@ -89,11 +89,13 @@ devart-dl login browser   # 打开你的 Chrome 登录，自动保存 Cookie，
 
 - **官方 API（OAuth）优先**：登录一次即可下载原图，无需导出 Cookie，也无需防封延时。
 - **URL 优先**：直接粘贴作品 / 画廊 / 收藏夹 / 标签链接即可下载。
+- **文本作品**：文学 / 日志型 deviation 在响应内直接提取正文，保存为 UTF-8 `.txt`；媒体与文本自动分流。
 - **下载可靠**：HTTP Range 断点续传、自动重试、429 退避、原子落盘。
 - **下载档案**：`--archive` 用 SQLite 记住已下载，跨会话自动跳过。
 - **路径模板 + 元数据 sidecar**：`--directory`/`--filename` 模板与 `--write-info-json`。
 - **代理与降级**：支持 `--proxy`；未登录 OAuth 时自动回退 Cookie。
 - **Resolve 模式**：`devart-dl resolve URL` 输出 `ResolvedDeviation`/`MediaAsset` 的 JSON 契约，不写文件。
+- **付费/订阅锁定识别**：官方 API 返回 `premium_folder_data` / `tier_access`，或网页端非成熟作品的模糊主图（`blur_`），都会识别为「需要订阅/购买」：网页通道跳过，官方通道明确报错，不再把打码图当原图保存。
 
 ## 文档
 

{devart_dl-4.3.3 → devart_dl-4.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devart-dl"
-version = "4.3.3"
+version = "4.4.0"
 description = "专业的 DeviantArt 作品批量下载工具 - Professional DeviantArt batch downloader with anti-ban features"
 readme = "README.md"
 requires-python = ">=3.10"

{devart_dl-4.3.3 → devart_dl-4.4.0}/tests/test_manager.py

@@ -156,3 +156,18 @@ def test_dry_run_plans_without_writing(tmp_path: Path) -> None:
     assert not outcome.path.exists()
     assert downloader.calls == []  # never touched the network or disk
 
+
+
+def test_inline_literature_writes_text_without_http(tmp_path: Path) -> None:
+    downloader = FakeDownloader()
+    manager = make_manager(tmp_path, downloader=downloader)
+    item = make_item(media_url="", extension="txt", content="Chapter\n\nText")
+
+    outcome = manager.run(item)
+
+    assert outcome.status == "downloaded"
+    assert outcome.path is not None
+    assert outcome.path.read_bytes() == "Chapter\n\nText".encode("utf-8")
+    assert outcome.size == len("Chapter\n\nText".encode("utf-8"))
+    assert downloader.calls == []
+    assert not outcome.path.with_name(outcome.path.name + ".part").exists()

{devart_dl-4.3.3 → devart_dl-4.4.0}/tests/test_official_provider.py

@@ -274,6 +274,33 @@ def test_no_media_raises(monkeypatch) -> None:
         list(provider.resolve(TargetParser.parse("123456")))
 
 
+def test_blurred_non_mature_main_raises_premium(monkeypatch) -> None:
+    monkeypatch.setattr(provider_mod, "deviation_init", lambda identifier, username=None, **_: {"deviation": {"extended": {"deviationUuid": "uuid-1", "additionalMedia": []}}})
+    client = FakeClient()
+    client.deviations["uuid-1"] = make_deviation(
+        uuid="uuid-1",
+        content_src="https://images.test/blur_40/full.jpg",
+        is_downloadable=False,
+        mature=False,
+    )
+    provider = OfficialProvider(client, quality="f")
+
+    with pytest.raises(MediaUnavailableError, match="subscription/purchase"):
+        list(provider.resolve(TargetParser.parse("123456")))
+
+
+def test_premium_folder_without_access_raises_premium(monkeypatch) -> None:
+    monkeypatch.setattr(provider_mod, "deviation_init", lambda identifier, username=None, **_: {"deviation": {"extended": {"deviationUuid": "uuid-1", "additionalMedia": []}}})
+    client = FakeClient()
+    deviation = make_deviation(uuid="uuid-1", is_downloadable=False)
+    deviation["premium_folder_data"] = {"has_access": False}
+    client.deviations["uuid-1"] = deviation
+    provider = OfficialProvider(client, quality="f")
+
+    with pytest.raises(MediaUnavailableError, match="subscription/purchase"):
+        list(provider.resolve(TargetParser.parse("123456")))
+
+
 def test_tag_target() -> None:
     client = FakeClient()
     client.pages[("browse_tags", "landscape", 0)] = {
@@ -306,3 +333,48 @@ def test_resolve_short_id_follows_redirect() -> None:
             return FakeResponse()
 
     assert _resolve_short_id("abc123", FakeHttp(), 30) == "123456"
+
+
+def test_artwork_literature_uses_init_text_and_skips_media_api(monkeypatch) -> None:
+    markup = "{\"type\":\"doc\",\"content\":[{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"Once upon a time.\"}]}]}"
+    init = {
+        "deviation": {
+            "extended": {"deviationUuid": "uuid-1", "additionalMedia": []},
+            "type": "literature",
+            "title": "Story",
+            "author": {"username": "alice"},
+            "url": "https://www.deviantart.com/alice/art/story-123456",
+            "textContent": {"html": {"markup": markup}},
+        }
+    }
+    monkeypatch.setattr(provider_mod, "deviation_init", lambda identifier, username=None, **_: init)
+    provider = OfficialProvider(FakeClient(), quality="o")
+
+    items = list(provider.resolve(TargetParser.parse("123456")))
+
+    assert items[0].content == "Once upon a time."
+    assert items[0].media_url == ""
+    assert items[0].extension == "txt"
+    assert items[0].metadata == {"kind": "literature", "quality": "o"}
+
+
+def test_gallery_literature_is_inline_text() -> None:
+    client = FakeClient()
+    client.pages[("gallery_all", "alice", 0)] = {
+        "results": [{
+            "deviationid": "uuid-1",
+            "title": "Story",
+            "author": {"username": "alice"},
+            "url": "https://www.deviantart.com/alice/art/story-1",
+            "type": "literature",
+            "textContent": {"html": {"markup": "{\"type\":\"doc\",\"content\":[{\"type\":\"text\",\"text\":\"Text\"}]}"}},
+        }],
+        "has_more": False,
+    }
+    provider = OfficialProvider(client, quality="o")
+
+    items = list(provider.resolve(TargetParser.parse("https://www.deviantart.com/alice/gallery")))
+
+    assert items[0].content == "Text"
+    assert items[0].media_url == ""
+    assert items[0].extension == "txt"

{devart_dl-4.3.3 → devart_dl-4.4.0}/tests/test_provider.py

@@ -74,6 +74,31 @@ def test_gallery_yields_items_with_media_url_and_extension() -> None:
     assert items[0].extension == "png"
 
 
+def test_blurred_non_mature_item_is_skipped() -> None:
+    dev = make_deviation()
+    provider = make_provider(
+        pages=[([dev], False, 1, "")],
+        media_urls={"123": "https://images.test/blur_40/123.jpg"},
+    )
+
+    items = list(provider.resolve(TargetParser.parse("https://www.deviantart.com/alice/gallery")))
+
+    assert items == []
+
+
+def test_premium_locked_item_is_skipped() -> None:
+    dev = make_deviation()
+    dev.premium = True
+    provider = make_provider(
+        pages=[([dev], False, 1, "")],
+        media_urls={"123": "https://images.test/123.jpg"},
+    )
+
+    items = list(provider.resolve(TargetParser.parse("https://www.deviantart.com/alice/gallery")))
+
+    assert items == []
+
+
 def test_pagination_across_two_pages() -> None:
     first = make_deviation("1")
     second = make_deviation("2")
@@ -224,3 +249,21 @@ def test_composite_tag_without_official_requires_official() -> None:
     router = CompositeProvider(official=None, web=web)
     with pytest.raises(MediaUnavailableError):
         list(router.resolve(TargetParser.parse("https://www.deviantart.com/tag/landscape")))
+
+
+def test_literature_item_is_delivered_as_inline_text() -> None:
+    dev = make_deviation("123", title="Story")
+    dev.deviation_type = "literature"
+    dev.media = {}
+    dev.text_content = {
+        "html": {"markup": "{\"type\":\"doc\",\"content\":[{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"Chapter one\"}]},{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"Chapter two\"}]}]}"}
+    }
+    provider = make_provider(pages=[([dev], False, 1, "")])
+
+    items = list(provider.resolve(TargetParser.parse("https://www.deviantart.com/alice/gallery")))
+
+    assert len(items) == 1
+    assert items[0].content == "Chapter one\nChapter two"
+    assert items[0].media_url == ""
+    assert items[0].extension == "txt"
+    assert items[0].metadata == {"kind": "literature"}