parseapi 1.9.0__tar.gz → 1.9.2__tar.gz

{parseapi-1.9.0 → parseapi-1.9.2}/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 1.9.1 — 2026-10-12
+
+- Add Emoji search/browse, categories, catalog, metadata, parsing and conversion; keep existing lookup calls and response decoding compatible.
+- Support optional SVG/PNG artwork and translated names. Preserve API 2.0.0 selection, plans and existing non-Emoji behavior.
+
 ## 1.9.0 — 2026-09-29
 
 - Add Company stable-ID lookup, candidate search and coverage for the current public-company cohort.

{parseapi-1.9.0 → parseapi-1.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: parseapi
-Version: 1.9.0
+Version: 1.9.2
 Summary: Official ParseAPI client for Python. One key, minimal JSON, fast.
 Project-URL: Homepage, https://parseapi.com
 Project-URL: Documentation, https://parseapi.com/docs
@@ -260,6 +260,8 @@ units = parse.measure.units(unit="m")
 
 `amount` is a decimal string, such as `"180.34"`. Without `to`, the API returns the canonical unit for the measurement type. Pass `locale` for number formatting and `system` (`us` or `imperial`) when a customary unit needs context. Ambiguous input returns `valid: false`, a `reason`, and available `choices`. Invalid or incompatible target units use the normal API error.
 
+Successful HTTP JSON contains `measure`, `valid`, `type`, `amount`, and `unit`. Invalid input adds `reason`. `choices` appears only when unit alternatives are available.
+
 Unit discovery accepts optional `query`, `type`, and `unit` filters. `unit` selects compatible targets. Omit the filters for the reviewed catalog. Both operations use pooled requests.
 
 ## Place statistics and optional detail
@@ -448,3 +450,35 @@ Successful checks may be reused for up to 24 hours. `pretty` optionally formats
 Stack defaults to a 35-second transport timeout so a first scan has time to finish. Other lookups retain their 10-second default. An explicit client timeout takes precedence.
 
 Vehicle lookups use `vin` as the input and response field. Existing VIN methods remain available for compatibility.
+
+## Emoji catalog additions
+
+Resolve Unicode emoji or a named shortcode, search or browse a bounded catalog,
+parse emoji positions in text, and convert between Unicode and a selected shortcode source.
+The ordinary lookup remains four fields:
+
+```http
+GET /emoji/rocket
+```
+
+```json
+{"emoji":"🚀","name":"Rocket","shortcodes":[":rocket:","rocket"],"category":"Travel & Places"}
+```
+
+Use `deep=true` for Unicode facts, keywords, tone families and available artwork.
+Artwork is keyed by style: `deep.artwork.openmoji.svg` is the SVG URL, and
+`deep.artwork.openmoji.png["72"]` is the 72×72 PNG URL (use your language’s map
+access syntax). The same shape applies to `noto` and `twemoji`. Missing styles
+and formats are omitted. URLs pin immutable artwork editions and retain their bytes.
+Core values stay unchanged. Text parsing returns `emojis` with UTF-16 `positions`;
+conversion returns `text` and unresolved tokens with positions and reasons.
+
+The compact JSON catalog contains offline identity, qualification-form and
+shortcode indexes. Request `profile=full` when artwork is needed and `lang` when
+localized names and keywords are needed. `/emoji/metadata` carries dataset
+coverage and shared source notices once. Artwork supports Google Noto, Twemoji
+and OpenMoji, with real SVG/PNG availability and immutable first-party URLs.
+A device's emoji font remains the ordinary display.
+
+These additions are a local release candidate until the matching SDK and
+backend are published. Existing lookup and search contracts are preserved.

{parseapi-1.9.0 → parseapi-1.9.2}/README.md

@@ -241,6 +241,8 @@ units = parse.measure.units(unit="m")
 
 `amount` is a decimal string, such as `"180.34"`. Without `to`, the API returns the canonical unit for the measurement type. Pass `locale` for number formatting and `system` (`us` or `imperial`) when a customary unit needs context. Ambiguous input returns `valid: false`, a `reason`, and available `choices`. Invalid or incompatible target units use the normal API error.
 
+Successful HTTP JSON contains `measure`, `valid`, `type`, `amount`, and `unit`. Invalid input adds `reason`. `choices` appears only when unit alternatives are available.
+
 Unit discovery accepts optional `query`, `type`, and `unit` filters. `unit` selects compatible targets. Omit the filters for the reviewed catalog. Both operations use pooled requests.
 
 ## Place statistics and optional detail
@@ -429,3 +431,35 @@ Successful checks may be reused for up to 24 hours. `pretty` optionally formats
 Stack defaults to a 35-second transport timeout so a first scan has time to finish. Other lookups retain their 10-second default. An explicit client timeout takes precedence.
 
 Vehicle lookups use `vin` as the input and response field. Existing VIN methods remain available for compatibility.
+
+## Emoji catalog additions
+
+Resolve Unicode emoji or a named shortcode, search or browse a bounded catalog,
+parse emoji positions in text, and convert between Unicode and a selected shortcode source.
+The ordinary lookup remains four fields:
+
+```http
+GET /emoji/rocket
+```
+
+```json
+{"emoji":"🚀","name":"Rocket","shortcodes":[":rocket:","rocket"],"category":"Travel & Places"}
+```
+
+Use `deep=true` for Unicode facts, keywords, tone families and available artwork.
+Artwork is keyed by style: `deep.artwork.openmoji.svg` is the SVG URL, and
+`deep.artwork.openmoji.png["72"]` is the 72×72 PNG URL (use your language’s map
+access syntax). The same shape applies to `noto` and `twemoji`. Missing styles
+and formats are omitted. URLs pin immutable artwork editions and retain their bytes.
+Core values stay unchanged. Text parsing returns `emojis` with UTF-16 `positions`;
+conversion returns `text` and unresolved tokens with positions and reasons.
+
+The compact JSON catalog contains offline identity, qualification-form and
+shortcode indexes. Request `profile=full` when artwork is needed and `lang` when
+localized names and keywords are needed. `/emoji/metadata` carries dataset
+coverage and shared source notices once. Artwork supports Google Noto, Twemoji
+and OpenMoji, with real SVG/PNG availability and immutable first-party URLs.
+A device's emoji font remains the ordinary display.
+
+These additions are a local release candidate until the matching SDK and
+backend are published. Existing lookup and search contracts are preserved.

{parseapi-1.9.0 → parseapi-1.9.2}/api/public.json

@@ -888,6 +888,180 @@
           "name": "deep",
           "type": "bool"
         },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "lang",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "shortcode_source",
+          "type": "Optional[str]"
+        }
+      ],
+      "returns": "Json"
+    },
+    "emoji.browse": {
+      "async": true,
+      "parameters": [
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "limit",
+          "type": "Optional[int]"
+        },
+        {
+          "default": false,
+          "kind": "KEYWORD_ONLY",
+          "name": "deep",
+          "type": "bool"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "lang",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "category",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "subcategory",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "version",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "max_version",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "include_skin_tones",
+          "type": "Optional[bool]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "offset",
+          "type": "Optional[int]"
+        }
+      ],
+      "returns": "Json"
+    },
+    "emoji.catalog": {
+      "async": true,
+      "parameters": [
+        {
+          "default": true,
+          "kind": "KEYWORD_ONLY",
+          "name": "deep",
+          "type": "bool"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "lang",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "category",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "subcategory",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "version",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "max_version",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "include_skin_tones",
+          "type": "Optional[bool]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "profile",
+          "type": "Optional[str]"
+        }
+      ],
+      "returns": "Json"
+    },
+    "emoji.categories": {
+      "async": true,
+      "parameters": [],
+      "returns": "Json"
+    },
+    "emoji.convert": {
+      "async": true,
+      "parameters": [
+        {
+          "kind": "POSITIONAL_OR_KEYWORD",
+          "name": "text",
+          "type": "str"
+        },
+        {
+          "kind": "KEYWORD_ONLY",
+          "name": "direction",
+          "type": "str"
+        },
+        {
+          "kind": "KEYWORD_ONLY",
+          "name": "shortcode_source",
+          "type": "str"
+        }
+      ],
+      "returns": "Json"
+    },
+    "emoji.metadata": {
+      "async": true,
+      "parameters": [],
+      "returns": "Json"
+    },
+    "emoji.parse": {
+      "async": true,
+      "parameters": [
+        {
+          "kind": "POSITIONAL_OR_KEYWORD",
+          "name": "text",
+          "type": "str"
+        },
+        {
+          "default": false,
+          "kind": "KEYWORD_ONLY",
+          "name": "deep",
+          "type": "bool"
+        },
         {
           "default": null,
           "kind": "KEYWORD_ONLY",
@@ -922,6 +1096,42 @@
           "kind": "KEYWORD_ONLY",
           "name": "lang",
           "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "category",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "subcategory",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "version",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "max_version",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "include_skin_tones",
+          "type": "Optional[bool]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "offset",
+          "type": "Optional[int]"
         }
       ],
       "returns": "Json"
@@ -2880,6 +3090,180 @@
           "name": "deep",
           "type": "bool"
         },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "lang",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "shortcode_source",
+          "type": "Optional[str]"
+        }
+      ],
+      "returns": "Json"
+    },
+    "emoji.browse": {
+      "async": false,
+      "parameters": [
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "limit",
+          "type": "Optional[int]"
+        },
+        {
+          "default": false,
+          "kind": "KEYWORD_ONLY",
+          "name": "deep",
+          "type": "bool"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "lang",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "category",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "subcategory",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "version",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "max_version",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "include_skin_tones",
+          "type": "Optional[bool]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "offset",
+          "type": "Optional[int]"
+        }
+      ],
+      "returns": "Json"
+    },
+    "emoji.catalog": {
+      "async": false,
+      "parameters": [
+        {
+          "default": true,
+          "kind": "KEYWORD_ONLY",
+          "name": "deep",
+          "type": "bool"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "lang",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "category",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "subcategory",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "version",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "max_version",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "include_skin_tones",
+          "type": "Optional[bool]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "profile",
+          "type": "Optional[str]"
+        }
+      ],
+      "returns": "Json"
+    },
+    "emoji.categories": {
+      "async": false,
+      "parameters": [],
+      "returns": "Json"
+    },
+    "emoji.convert": {
+      "async": false,
+      "parameters": [
+        {
+          "kind": "POSITIONAL_OR_KEYWORD",
+          "name": "text",
+          "type": "str"
+        },
+        {
+          "kind": "KEYWORD_ONLY",
+          "name": "direction",
+          "type": "str"
+        },
+        {
+          "kind": "KEYWORD_ONLY",
+          "name": "shortcode_source",
+          "type": "str"
+        }
+      ],
+      "returns": "Json"
+    },
+    "emoji.metadata": {
+      "async": false,
+      "parameters": [],
+      "returns": "Json"
+    },
+    "emoji.parse": {
+      "async": false,
+      "parameters": [
+        {
+          "kind": "POSITIONAL_OR_KEYWORD",
+          "name": "text",
+          "type": "str"
+        },
+        {
+          "default": false,
+          "kind": "KEYWORD_ONLY",
+          "name": "deep",
+          "type": "bool"
+        },
         {
           "default": null,
           "kind": "KEYWORD_ONLY",
@@ -2914,6 +3298,42 @@
           "kind": "KEYWORD_ONLY",
           "name": "lang",
           "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "category",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "subcategory",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "version",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "max_version",
+          "type": "Optional[str]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "include_skin_tones",
+          "type": "Optional[bool]"
+        },
+        {
+          "default": null,
+          "kind": "KEYWORD_ONLY",
+          "name": "offset",
+          "type": "Optional[int]"
         }
       ],
       "returns": "Json"

{parseapi-1.9.0 → parseapi-1.9.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "parseapi"
-version = "1.9.0"
+version = "1.9.2"
 description = "Official ParseAPI client for Python. One key, minimal JSON, fast."
 readme = "README.md"
 license = "MIT"

{parseapi-1.9.0 → parseapi-1.9.2}/src/parseapi/__init__.py

@@ -2,5 +2,5 @@
 
 from ._client import AsyncParseAPI, ParseAPI, ParseAPIError
 
-__version__ = "1.9.0"
+__version__ = "1.9.2"
 __all__ = ["ParseAPI", "AsyncParseAPI", "ParseAPIError", "__version__"]

{parseapi-1.9.0 → parseapi-1.9.2}/src/parseapi/_client.py

@@ -549,11 +549,33 @@ class _EmojiSync:
     def __init__(self, client: ParseAPI):
         self._client = client
 
-    def __call__(self, emoji: str, *, deep: bool = False, lang: Optional[str] = None) -> Json:
-        return self._client._get(f"/emoji/{_seg(emoji)}", {"deep": deep, "lang": lang})
+    def __call__(self, emoji: str, *, deep: bool = False, lang: Optional[str] = None, shortcode_source: Optional[str] = None) -> Json:
+        return self._client._get(f"/emoji/{_seg(emoji)}", {"deep": deep, "lang": lang, "shortcode_source": shortcode_source})
+
+    def search(self, query: str, *, limit: Optional[int] = None, deep: bool = False, lang: Optional[str] = None, category: Optional[str] = None, subcategory: Optional[str] = None, version: Optional[str] = None, max_version: Optional[str] = None, include_skin_tones: Optional[bool] = None, offset: Optional[int] = None) -> Json:
+        return self._client._get("/emoji", {"q": query, **{"limit": limit, "deep": deep, "lang": lang, "category": category, "subcategory": subcategory, "version": version, "max_version": max_version, "include_skin_tones": None if include_skin_tones is None else str(include_skin_tones).lower(), "offset": offset}})
+
+    def browse(self, *, limit: Optional[int] = None, deep: bool = False, lang: Optional[str] = None, category: Optional[str] = None, subcategory: Optional[str] = None, version: Optional[str] = None, max_version: Optional[str] = None, include_skin_tones: Optional[bool] = None, offset: Optional[int] = None) -> Json:
+        return self._client._get("/emoji", {"limit": limit, "deep": deep, "lang": lang, "category": category, "subcategory": subcategory, "version": version, "max_version": max_version, "include_skin_tones": None if include_skin_tones is None else str(include_skin_tones).lower(), "offset": offset})
+
+    def catalog(self, *, deep: bool = True, lang: Optional[str] = None, category: Optional[str] = None, subcategory: Optional[str] = None, version: Optional[str] = None, max_version: Optional[str] = None, include_skin_tones: Optional[bool] = None, profile: Optional[str] = None) -> Json:
+        """Download the complete filtered JSON inventory and offline resolution maps."""
+        return self._client._get("/emoji/catalog", {"profile": profile, "deep": str(deep).lower(), "lang": lang, "category": category, "subcategory": subcategory, "version": version, "max_version": max_version, "include_skin_tones": None if include_skin_tones is None else str(include_skin_tones).lower()})
+
+    def metadata(self) -> Json:
+        return self._client._get("/emoji/metadata")
+
+    def categories(self) -> Json:
+        return self._client._get("/emoji/categories")
+
+    def parse(self, text: str, *, deep: bool = False, lang: Optional[str] = None) -> Json:
+        """Extract complete emoji sequences. Positions are UTF-16 code units; end is exclusive."""
+        return self._client._get("/emoji/parse", {"deep": deep, "lang": lang}, json={"text": text})
+
+    def convert(self, text: str, *, direction: str, shortcode_source: str) -> Json:
+        """Convert complete sequences; unresolved codes stay literal. Offsets refer to input UTF-16."""
+        return self._client._get("/emoji/convert", {"direction": direction, "shortcode_source": shortcode_source}, json={"text": text})
 
-    def search(self, query: str, *, limit: Optional[int] = None, deep: bool = False, lang: Optional[str] = None) -> Json:
-        return self._client._get("/emoji", {"q": query, "limit": limit, "deep": deep, "lang": lang})
 
 
 class _IndustrySync:
@@ -971,11 +993,33 @@ class _EmojiAsync:
     def __init__(self, client: AsyncParseAPI):
         self._client = client
 
-    async def __call__(self, emoji: str, *, deep: bool = False, lang: Optional[str] = None) -> Json:
-        return await self._client._get(f"/emoji/{_seg(emoji)}", {"deep": deep, "lang": lang})
+    async def __call__(self, emoji: str, *, deep: bool = False, lang: Optional[str] = None, shortcode_source: Optional[str] = None) -> Json:
+        return await self._client._get(f"/emoji/{_seg(emoji)}", {"deep": deep, "lang": lang, "shortcode_source": shortcode_source})
+
+    async def search(self, query: str, *, limit: Optional[int] = None, deep: bool = False, lang: Optional[str] = None, category: Optional[str] = None, subcategory: Optional[str] = None, version: Optional[str] = None, max_version: Optional[str] = None, include_skin_tones: Optional[bool] = None, offset: Optional[int] = None) -> Json:
+        return await self._client._get("/emoji", {"q": query, **{"limit": limit, "deep": deep, "lang": lang, "category": category, "subcategory": subcategory, "version": version, "max_version": max_version, "include_skin_tones": None if include_skin_tones is None else str(include_skin_tones).lower(), "offset": offset}})
+
+    async def browse(self, *, limit: Optional[int] = None, deep: bool = False, lang: Optional[str] = None, category: Optional[str] = None, subcategory: Optional[str] = None, version: Optional[str] = None, max_version: Optional[str] = None, include_skin_tones: Optional[bool] = None, offset: Optional[int] = None) -> Json:
+        return await self._client._get("/emoji", {"limit": limit, "deep": deep, "lang": lang, "category": category, "subcategory": subcategory, "version": version, "max_version": max_version, "include_skin_tones": None if include_skin_tones is None else str(include_skin_tones).lower(), "offset": offset})
+
+    async def catalog(self, *, deep: bool = True, lang: Optional[str] = None, category: Optional[str] = None, subcategory: Optional[str] = None, version: Optional[str] = None, max_version: Optional[str] = None, include_skin_tones: Optional[bool] = None, profile: Optional[str] = None) -> Json:
+        """Download the complete filtered JSON inventory and offline resolution maps."""
+        return await self._client._get("/emoji/catalog", {"profile": profile, "deep": str(deep).lower(), "lang": lang, "category": category, "subcategory": subcategory, "version": version, "max_version": max_version, "include_skin_tones": None if include_skin_tones is None else str(include_skin_tones).lower()})
+
+    async def metadata(self) -> Json:
+        return await self._client._get("/emoji/metadata")
+
+    async def categories(self) -> Json:
+        return await self._client._get("/emoji/categories")
+
+    async def parse(self, text: str, *, deep: bool = False, lang: Optional[str] = None) -> Json:
+        """Extract complete emoji sequences. Positions are UTF-16 code units; end is exclusive."""
+        return await self._client._get("/emoji/parse", {"deep": deep, "lang": lang}, json={"text": text})
+
+    async def convert(self, text: str, *, direction: str, shortcode_source: str) -> Json:
+        """Convert complete sequences; unresolved codes stay literal. Offsets refer to input UTF-16."""
+        return await self._client._get("/emoji/convert", {"direction": direction, "shortcode_source": shortcode_source}, json={"text": text})
 
-    async def search(self, query: str, *, limit: Optional[int] = None, deep: bool = False, lang: Optional[str] = None) -> Json:
-        return await self._client._get("/emoji", {"q": query, "limit": limit, "deep": deep, "lang": lang})
 
 
 class _IndustryAsync:
@@ -1132,6 +1176,7 @@ class _MeasureSync:
     def __call__(self, measure: str, *, to: Optional[str] = None, locale: Optional[str] = None, system: Optional[str] = None) -> Json:
         """Parse or convert a measurement. Amount is a decimal string. Without to, use the
         type's canonical unit. Locale and system (us or imperial) resolve explicit ambiguity.
+        Successful JSON omits reason and choices. Invalid input adds reason and alternatives add choices.
         Invalid measurements return valid=False and a reason. Invalid targets raise an API error.
         """
         return self._client._get(f"/measure/{_seg(measure)}", {"to": to, "locale": locale, "system": system})
@@ -1148,6 +1193,7 @@ class _MeasureAsync:
     async def __call__(self, measure: str, *, to: Optional[str] = None, locale: Optional[str] = None, system: Optional[str] = None) -> Json:
         """Parse or convert a measurement. Amount is a decimal string. Without to, use the
         type's canonical unit. Locale and system (us or imperial) resolve explicit ambiguity.
+        Successful JSON omits reason and choices. Invalid input adds reason and alternatives add choices.
         Invalid measurements return valid=False and a reason. Invalid targets raise an API error.
         """
         return await self._client._get(f"/measure/{_seg(measure)}", {"to": to, "locale": locale, "system": system})

parseapi-1.9.2/tests/fixtures/emoji-artwork.json

@@ -0,0 +1,184 @@
+{
+  "metadata": {
+    "edition": "2e6b8d9c0d972f6e04e2252b55dc8fb57c3967b52c16cb5d91fceb51dcd27660",
+    "source_version": "18.0",
+    "max_version": "18.0",
+    "total": 3963,
+    "completeness": {
+      "missing_count": 0,
+      "unexpected_count": 0
+    },
+    "shortcode_sources": {
+      "cldr": {
+        "records": 3963,
+        "missing_records": 0,
+        "ambiguous_aliases": 1
+      },
+      "github": {
+        "records": 1870,
+        "missing_records": 2093,
+        "ambiguous_aliases": 0
+      },
+      "slack": {
+        "records": 1906,
+        "missing_records": 2057,
+        "ambiguous_aliases": 0
+      },
+      "discord": {
+        "records": 3773,
+        "missing_records": 190,
+        "ambiguous_aliases": 0
+      }
+    },
+    "sources": [
+      {
+        "id": "unicode",
+        "version": "18.0",
+        "source_url": "https://unicode.org/Public/18.0.0/emoji/emoji-test.txt",
+        "license": "Unicode-3.0",
+        "license_url": "https://www.unicode.org/license.txt"
+      },
+      {
+        "id": "cldr",
+        "version": null,
+        "source_url": "https://raw.githubusercontent.com/unicode-org/cldr/7cdeb9e7fac52c59f22fc7248b05f989ee5689c2/common/annotations/en.xml",
+        "license": "Unicode-3.0",
+        "license_url": "https://raw.githubusercontent.com/unicode-org/cldr/7cdeb9e7fac52c59f22fc7248b05f989ee5689c2/LICENSE"
+      },
+      {
+        "id": "emojibase",
+        "version": "17.0.0",
+        "source_url": "https://cdn.jsdelivr.net/npm/emojibase-data@17.0.0/en/data.json",
+        "license": "MIT",
+        "license_url": "https://cdn.jsdelivr.net/npm/emojibase-data@17.0.0/LICENSE"
+      }
+    ],
+    "notices": [
+      {
+        "id": "unicode",
+        "license": "Unicode-3.0",
+        "notice": "COPYRIGHT AND PERMISSION NOTICE\n\nCopyright © 2001–2026 Unicode, Inc.\n\nUnicode Technical Standard #35, Unicode Locale Data Markup Language\n(LDML) made available in this repository is protected by copyright, and\npermission must be obtained from Unicode, Inc. prior to any\nreproduction, modification, or other use not permitted by the Unicode\nTerms of Use <https://www.unicode.org/copyright.html>. Specifically, you\nmay make copies of this publication and may annotate and translate it\nsolely for personal or internal business purposes and not for public\ndistribution, provided that any such permitted copies and modifications\nfully reproduce all copyright and other legal notices contained in the\noriginal. You may not make copies of or modifications to this\npublication for public distribution, or incorporate it in whole or in\npart into any product or publication without the express written\npermission of Unicode. Notwithstanding the foregoing, you may within\nthis repository provide comments and propose changes to this standard\nand may make copies/forks solely for such purposes provided that you\nreproduce this copyright notice and these terms of use in any such\ncopy/fork.\n\nAll other content in this repo is released under UNICODE LICENSE V3\n\nNOTICE TO USER: Carefully read the following legal agreement. BY\nDOWNLOADING, INSTALLING, COPYING OR OTHERWISE USING DATA FILES, AND/OR\nSOFTWARE, YOU UNEQUIVOCALLY ACCEPT, AND AGREE TO BE BOUND BY, ALL OF THE\nTERMS AND CONDITIONS OF THIS AGREEMENT. IF YOU DO NOT AGREE, DO NOT\nDOWNLOAD, INSTALL, COPY, DISTRIBUTE OR USE THE DATA FILES OR SOFTWARE.\n\nPermission is hereby granted, free of charge, to any person obtaining a\ncopy of data files and any associated documentation (the \"Data Files\") or\nsoftware and any associated documentation (the \"Software\") to deal in the\nData Files or Software without restriction, including without limitation\nthe rights to use, copy, modify, merge, publish, distribute, and/or sell\ncopies of the Data Files or Software, and to permit persons to whom the\nData Files or Software are furnished to do so, provided that either (a)\nthis copyright and permission notice appear with all copies of the Data\nFiles or Software, or (b) this copyright and permission notice appear in\nassociated Documentation.\n\nTHE DATA FILES AND SOFTWARE ARE PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY\nKIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF\nTHIRD PARTY RIGHTS.\n\nIN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE\nBE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES,\nOR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,\nWHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,\nARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THE DATA\nFILES OR SOFTWARE.\n\nExcept as contained in this notice, the name of a copyright holder shall\nnot be used in advertising or otherwise to promote the sale, use or other\ndealings in these Data Files or Software without prior written\nauthorization of the copyright holder.\n\nSPDX-License-Identifier: Unicode-3.0\n"
+      },
+      {
+        "id": "emojibase",
+        "license": "MIT",
+        "notice": "MIT License\n\nCopyright (c) 2017-2019 Miles Johnson\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n"
+      }
+    ],
+    "artwork_sources": [
+      {
+        "style": "noto",
+        "version": "v2026-09-24-unicode18_0",
+        "unicode_version": "18.0",
+        "source_url": "https://github.com/googlefonts/noto-emoji/tree/e20cbc2bbec1926686be9f9bee7d1d2cfa1fea0e",
+        "license": "Apache-2.0",
+        "license_url": "https://www.apache.org/licenses/LICENSE-2.0",
+        "attribution": "Noto Emoji by Google and contributors.",
+        "notices": [
+          "https://cdn.parseapi.com/emoji/noto/18.0.0/notices/2D/svg/LICENSE",
+          "https://cdn.parseapi.com/emoji/noto/18.0.0/notices/LICENSE",
+          "https://cdn.parseapi.com/emoji/noto/18.0.0/notices/LICENSE-ARTWORK.txt",
+          "https://cdn.parseapi.com/emoji/noto/18.0.0/notices/NOTICE.txt",
+          "https://cdn.parseapi.com/emoji/noto/18.0.0/notices/third_party/region-flags/LICENSE"
+        ],
+        "flag_license": {
+          "license": "LicenseRef-Noto-Region-Flags",
+          "license_url": "https://github.com/googlefonts/noto-emoji/blob/e20cbc2bbec1926686be9f9bee7d1d2cfa1fea0e/third_party/region-flags/LICENSE",
+          "description": "Noto's retained flag-source notice records public-domain or copyright-exempt origins, including national-law exemptions."
+        },
+        "loaded_coverage": {
+          "svg": 3963,
+          "png": 3701
+        }
+      },
+      {
+        "style": "twemoji",
+        "version": "v17.0.3",
+        "unicode_version": "17.0",
+        "source_url": "https://github.com/jdecked/twemoji/tree/b6b55fef1e8636b540a6d016a4729ca8cdf2e60b",
+        "license": "CC-BY-4.0",
+        "license_url": "https://creativecommons.org/licenses/by/4.0/",
+        "attribution": "Twemoji graphics by Twitter, Inc. and other contributors, maintained by the Twemoji community.",
+        "notices": [
+          "https://cdn.parseapi.com/emoji/twemoji/17.0.3/notices/LICENSE",
+          "https://cdn.parseapi.com/emoji/twemoji/17.0.3/notices/LICENSE-ARTWORK.txt",
+          "https://cdn.parseapi.com/emoji/twemoji/17.0.3/notices/LICENSE-GRAPHICS",
+          "https://cdn.parseapi.com/emoji/twemoji/17.0.3/notices/NOTICE.txt"
+        ],
+        "loaded_coverage": {
+          "svg": 3944,
+          "png": 3944
+        }
+      },
+      {
+        "style": "openmoji",
+        "version": "17.0.0",
+        "unicode_version": "17.0",
+        "source_url": "https://github.com/hfg-gmuend/openmoji/tree/f9fc506a3f913be9897ab0181d611d4c910a4104",
+        "license": "CC-BY-SA-4.0",
+        "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+        "attribution": "All emojis designed by OpenMoji – the open-source emoji and icon project. License: CC BY-SA 4.0.",
+        "notices": [
+          "https://cdn.parseapi.com/emoji/openmoji/17.0.0/notices/LICENSE-ARTWORK.txt",
+          "https://cdn.parseapi.com/emoji/openmoji/17.0.0/notices/LICENSE.txt",
+          "https://cdn.parseapi.com/emoji/openmoji/17.0.0/notices/NOTICE.txt"
+        ],
+        "loaded_coverage": {
+          "svg": 3944,
+          "png": 3944
+        }
+      }
+    ]
+  },
+  "emoji": {
+    "emoji": "🚀",
+    "name": "Rocket",
+    "shortcodes": [
+      ":rocket:",
+      "rocket"
+    ],
+    "category": "Travel & Places",
+    "deep": {
+      "codepoints": [
+        "U+1F680"
+      ],
+      "hex": "1F680",
+      "status": "fully-qualified",
+      "version": "0.6",
+      "keywords": [
+        "rocket",
+        "launch",
+        "rockets",
+        "space",
+        "travel",
+        "ship"
+      ],
+      "skins": [],
+      "subcategory": "transport-air",
+      "artwork": {
+        "noto": {
+          "svg": "https://cdn.parseapi.com/emoji/noto/18.0.0/1f680.svg",
+          "png": {
+            "32": "https://cdn.parseapi.com/emoji/noto/18.0.0/32/1f680.png",
+            "72": "https://cdn.parseapi.com/emoji/noto/18.0.0/72/1f680.png",
+            "128": "https://cdn.parseapi.com/emoji/noto/18.0.0/128/1f680.png",
+            "512": "https://cdn.parseapi.com/emoji/noto/18.0.0/512/1f680.png"
+          }
+        },
+        "twemoji": {
+          "svg": "https://cdn.parseapi.com/emoji/twemoji/17.0.3/1f680.svg",
+          "png": {
+            "72": "https://cdn.parseapi.com/emoji/twemoji/17.0.3/72/1f680.png"
+          }
+        },
+        "openmoji": {
+          "svg": "https://cdn.parseapi.com/emoji/openmoji/17.0.0/1f680.svg",
+          "png": {
+            "72": "https://cdn.parseapi.com/emoji/openmoji/17.0.0/72/1f680.png",
+            "618": "https://cdn.parseapi.com/emoji/openmoji/17.0.0/618/1f680.png"
+          }
+        }
+      }
+    }
+  }
+}

parseapi-1.9.2/tests/fixtures/emoji-catalog.json

@@ -0,0 +1,95 @@
+{
+  "metadata": {
+    "edition": "test-edition",
+    "max_version": "18.0",
+    "source_version": "18.0",
+    "completeness": {
+      "missing_count": 1,
+      "unexpected_count": 0
+    },
+    "sources": [
+      {
+        "id": "unicode",
+        "version": "18.0",
+        "source_url": "https://unicode.org/emoji",
+        "license": "Unicode-3.0",
+        "license_url": "https://unicode.org/license"
+      }
+    ],
+    "notices": [
+      {
+        "id": "unicode",
+        "license": "Unicode-3.0",
+        "notice": "Full source notice"
+      }
+    ],
+    "artwork_sources": [],
+    "total": 1
+  },
+  "total": 1,
+  "emojis": [
+    {
+      "emoji": "❤️",
+      "name": "red heart",
+      "shortcodes": [
+        ":heart:",
+        "heart"
+      ],
+      "category": "Smileys & Emotion",
+      "deep": {
+        "version": "0.6",
+        "keywords": [
+          "heart",
+          "love"
+        ],
+        "subcategory": "emotion",
+        "artwork": {}
+      }
+    }
+  ],
+  "forms": {
+    "❤": "❤️",
+    "❤️": "❤️"
+  },
+  "shortcodes": {
+    "cldr": {
+      "red_heart": [
+        "❤️"
+      ]
+    },
+    "github": {
+      "heart": [
+        "❤️"
+      ]
+    },
+    "slack": {},
+    "discord": {}
+  },
+  "legacy": {
+    "heart": "❤️"
+  },
+  "scope": {
+    "filters": {},
+    "complete_inventory": true
+  },
+  "search": {
+    "native": {
+      "❤️": {
+        "name": "Heart",
+        "keywords": [
+          "love"
+        ],
+        "order": null
+      }
+    },
+    "localized_keywords": []
+  },
+  "localization": {
+    "requested_locale": "fr",
+    "resolved_locale": "fr",
+    "translated_names": 1,
+    "translated_keywords": 0,
+    "fallback_names": 0,
+    "fallback_keywords": 1
+  }
+}

parseapi-1.9.2/tests/fixtures/measure-response.json

@@ -0,0 +1,51 @@
+[
+  {
+    "measure": "0 m",
+    "valid": true,
+    "type": "length",
+    "amount": "0",
+    "unit": "m"
+  },
+  {
+    "measure": "1.00000000000000000001 m",
+    "valid": true,
+    "type": "length",
+    "amount": "1",
+    "unit": "m"
+  },
+  {
+    "measure": "180",
+    "valid": false,
+    "type": null,
+    "amount": null,
+    "unit": null,
+    "reason": "missing_unit"
+  },
+  {
+    "measure": "1 gallon",
+    "valid": false,
+    "type": null,
+    "amount": null,
+    "unit": null,
+    "reason": "ambiguous_unit",
+    "choices": [
+      {
+        "unit": "gal_us",
+        "name": "US gallon"
+      },
+      {
+        "unit": "gal_imp",
+        "name": "imperial gallon"
+      }
+    ]
+  },
+  {
+    "measure": "0 m",
+    "valid": true,
+    "type": "length",
+    "amount": "0",
+    "unit": "m",
+    "reason": null,
+    "choices": []
+  }
+]

parseapi-1.9.2/tests/test_emoji.py

@@ -0,0 +1,101 @@
+import asyncio
+import json
+
+import httpx
+import pytest
+from parseapi import AsyncParseAPI, ParseAPI
+
+
+def test_sync_and_async_emoji_catalog_and_text_body():
+    async def run(async_mode):
+        calls = []
+        payload = {"total": 2, "emojis": [{"emoji": "👍🏿", "name": "thumbs up", "shortcodes": [], "category": None, "occurrences": 2, "positions": [{"start": 2, "end": 6}, {"start": 7, "end": 11}], "deep": {"base": "👍", "variants": [{"emoji": "👍🏿", "tones": ["dark"]}]} }], "future": True}
+        def handle(request):
+            calls.append(request)
+            return httpx.Response(200, json=payload)
+        client_type = AsyncParseAPI if async_mode else ParseAPI
+        client = client_type("test", transport=httpx.MockTransport(handle))
+        async def call(method, *args, **kwargs):
+            value = method(*args, **kwargs)
+            return await value if async_mode else value
+        assert await call(client.emoji, ":cat:", shortcode_source="github") == payload
+        await call(client.emoji.search, "face", category="Smileys & Emotion", version="17.0", max_version="18.0", include_skin_tones=False, offset=0)
+        await call(client.emoji.browse, category="People & Body", include_skin_tones=False, offset=2)
+        await call(client.emoji.categories)
+        assert await call(client.emoji.parse, "x 👍🏿 👍🏿", deep=True, lang="fr") == payload
+        assert calls[0].url.path == "/emoji/:cat:"
+        assert dict(calls[0].url.params) == {"shortcode_source": "github"}
+        assert dict(calls[1].url.params) == {"q": "face", "category": "Smileys & Emotion", "version": "17.0", "max_version": "18.0", "include_skin_tones": "false", "offset": "0"}
+        assert dict(calls[2].url.params) == {"category": "People & Body", "include_skin_tones": "false", "offset": "2"}
+        assert calls[3].url.path == "/emoji/categories" and not calls[3].url.params
+        assert calls[4].url.path == "/emoji/parse" and calls[4].method == "POST"
+        assert json.loads(calls[4].content) == {"text": "x 👍🏿 👍🏿"}
+        assert dict(calls[4].url.params) == {"deep": "true", "lang": "fr"}
+        assert calls[4].headers["Parse-Version"] == "2.0.0"
+        if async_mode:
+            await client.close()
+        else:
+            client.close()
+    asyncio.run(run(False))
+    asyncio.run(run(True))
+
+def test_sync_async_emoji_download_and_metadata():
+    from pathlib import Path
+    bundle = json.loads((Path(__file__).parent / 'fixtures/emoji-catalog.json').read_text())
+    async def run(async_mode):
+        calls = []
+        def handle(request):
+            calls.append(request)
+            return httpx.Response(200, json=bundle['metadata'] if request.url.path == '/emoji/metadata' else bundle)
+        client = (AsyncParseAPI if async_mode else ParseAPI)('test', transport=httpx.MockTransport(handle))
+        async def call(method, **kwargs):
+            value = method(**kwargs)
+            return await value if async_mode else value
+        result = await call(client.emoji.catalog, deep=False, include_skin_tones=False, lang='fr', max_version='17.0')
+        assert result['forms']['❤'] == '❤️'
+        assert result['emojis'][0]['deep']['artwork'] == {}
+        assert dict(calls[0].url.params) == {'deep':'false','include_skin_tones':'false','lang':'fr','max_version':'17.0'}
+        await call(client.emoji.catalog)
+        assert dict(calls[1].url.params) == {'deep':'true'}
+        assert (await call(client.emoji.metadata))['total'] == 1
+        assert calls[2].url.path == '/emoji/metadata' and not calls[2].url.params
+        if async_mode: await client.close()
+        else: client.close()
+    asyncio.run(run(False))
+    asyncio.run(run(True))
+
+
+
+def test_sync_async_private_conversion():
+    async def run(async_mode):
+        calls=[]
+        def handle(request):
+            calls.append(request)
+            return httpx.Response(200,json={"text":"🚀","unresolved":[]})
+        client=(AsyncParseAPI if async_mode else ParseAPI)('test',transport=httpx.MockTransport(handle))
+        result=client.emoji.convert(':rocket:',direction='to_emoji',shortcode_source='github')
+        if async_mode: result=await result
+        assert result['text']=='🚀'
+        assert len(calls)==1 and calls[0].method=='POST'
+        assert json.loads(calls[0].content)=={'text':':rocket:'}
+        assert dict(calls[0].url.params)=={'direction':'to_emoji','shortcode_source':'github'}
+        if async_mode: await client.close()
+        else: client.close()
+    asyncio.run(run(False));asyncio.run(run(True))
+
+
+def test_actual_keyed_artwork_sync_and_async():
+    from pathlib import Path
+    fixture = json.loads((Path(__file__).parent / 'fixtures/emoji-artwork.json').read_text())
+    async def run():
+        for mode in (False, True):
+            cls = AsyncParseAPI if mode else ParseAPI
+            client = cls('test', transport=httpx.MockTransport(lambda request: httpx.Response(200, json=fixture['emoji'])))
+            result = await client.emoji('rocket', deep=True) if mode else client.emoji('rocket', deep=True)
+            artwork = result['deep']['artwork']
+            assert list(artwork) == ['noto', 'twemoji', 'openmoji']
+            assert artwork['openmoji']['svg'] == 'https://cdn.parseapi.com/emoji/openmoji/17.0.0/1f680.svg'
+            assert artwork['openmoji']['png']['72'] == 'https://cdn.parseapi.com/emoji/openmoji/17.0.0/72/1f680.png'
+            if mode: await client.close()
+            else: client.close()
+    asyncio.run(run())

parseapi-1.9.2/tests/test_measure_response.py

@@ -0,0 +1,18 @@
+import asyncio
+import json
+from pathlib import Path
+
+import httpx
+from parseapi import AsyncParseAPI, ParseAPI
+
+CASES = json.loads((Path(__file__).parent / 'fixtures/measure-response.json').read_text())
+
+def test_clean_and_legacy_measure_responses_sync_and_async():
+    for body in CASES:
+        transport = httpx.MockTransport(lambda request: httpx.Response(200, json=body))
+        with ParseAPI('fixture', transport=transport) as client:
+            assert client.measure(body['measure']) == body
+        async def check():
+            async with AsyncParseAPI('fixture', transport=transport) as client:
+                assert await client.measure(body['measure']) == body
+        asyncio.run(check())