add instance languages support

2025-02-15 20:15:28 +02:00 · 2025-02-15 20:15:28 +02:00 · 861d1c68d5
commit 861d1c68d5
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@ -42,6 +42,7 @@ v2.0.0 (IN PROGRESS)
 * Add admin IP block functions (`admin_ip_blocks`, `admin_ip_block`, `admin_ip_block_create`, `admin_ip_block_delete`)
 * Add `instance_domain_blocks`
 * Add notification policy and requests (`notifications_policy`, `update_notifications_policy`, `notifications_requests`, `notification_request`, `accept_notification_request`, `reject_notification_request`, `notifications_merged`, `accept_multiple_notification_requests`, `dismiss_multiple_notification_requests`)
+* Add `instance_languages`

 v1.8.1
 ------
--- a/docs/08_instances.rst
+++ b/docs/08_instances.rst
@ -66,4 +66,5 @@ Domain blocks

 Translation support
 -------------------
+.. authomedod:: Mastodon.instance_languages
 .. automethod:: Mastodon.instance_translation_languages
--- a/mastodon/instance.py
+++ b/mastodon/instance.py
@ -4,7 +4,7 @@ from mastodon.utility import api_version
 from mastodon.compat import urlparse

 from mastodon.internals import Mastodon as Internals
-from mastodon.return_types import Instance, InstanceV2, NonPaginatableList, Activity, Nodeinfo, AttribAccessDict, Rule, Announcement, CustomEmoji, Account, IdType, ExtendedDescription, DomainBlock
+from mastodon.return_types import Instance, InstanceV2, NonPaginatableList, Activity, Nodeinfo, AttribAccessDict, Rule, Announcement, CustomEmoji, Account, IdType, ExtendedDescription, DomainBlock, SupportedLocale

 from typing import Union, Optional, Dict, List

@ -227,3 +227,11 @@ class Mastodon(Internals):
        Returns a MastodonAPIError if the admin has chosen to not make the list public, or to now show it at all.
        """
        return self.__api_request('GET', '/api/v1/instance/domain_blocks')
+
+    @api_version("4.2.0", "4.2.0")
+    def instance_languages(self) -> NonPaginatableList[SupportedLocale]:
+        """
+        Fetch a list of languages that the instance supports.
+        """
+        return self.__api_request('GET', '/api/v1/instance/languages')
+    
--- a/mastodon/return_types.py
+++ b/mastodon/return_types.py
@ -6124,7 +6124,7 @@ class NotificationPolicy(AttribAccessDict):
    .. code-block:: python

        # Returns a NotificationPolicy object
-        TODO_TO_BE_IMPLEMENTED
+        mastodon.notification_policy()

    See also (Mastodon API documentation): https://docs.joinmastodon.org/entities/NotificationPolicy
    """
@ -6188,7 +6188,7 @@ class NotificationPolicySummary(AttribAccessDict):
    .. code-block:: python

        # Returns a NotificationPolicySummary object
-        TODO_TO_BE_IMPLEMENTED
+        mastodon.notification_policy().summary

    See also (Mastodon API documentation): https://docs.joinmastodon.org/entities/NotificationPolicy
    """
@ -6710,6 +6710,38 @@ class NotificationRequest(AttribAccessDict):

    _version = "4.3.0"

+class SupportedLocale(AttribAccessDict):
+    """
+    A locale supported by the instance.
+
+    Example:
+
+    .. code-block:: python
+
+        # Returns a SupportedLocale object
+        mastodon.languages()
+
+    See also (Mastodon API documentation): https://docs.joinmastodon.org/entities/Instance
+    """
+
+    code: "str"
+    """
+    The locale code.
+
+    Version history:
+      * 4.2.0: added
+    """
+
+    name: "str"
+    """
+    The name of the locale.
+
+    Version history:
+      * 4.2.0: added
+    """
+
+    _version = "4.2.0"
+
 ENTITY_NAME_MAP = {
    "Account": Account,
    "AccountField": AccountField,
@ -6821,6 +6853,7 @@ ENTITY_NAME_MAP = {
    "UnreadNotificationsCount": UnreadNotificationsCount,
    "Appeal": Appeal,
    "NotificationRequest": NotificationRequest,
+    "SupportedLocale": SupportedLocale,
 }
 __all__ = [
    "Account",
@ -6933,5 +6966,6 @@ __all__ = [
    "UnreadNotificationsCount",
    "Appeal",
    "NotificationRequest",
+    "SupportedLocale",
 ]

--- a/mastodon/types_base.py
+++ b/mastodon/types_base.py
@ -163,7 +163,7 @@ if sys.version_info < (3, 9):
            DomainBlock, ExtendedDescription, FilterKeyword, FilterStatus, IdentityProof, StatusSource, \
            Suggestion, Translation, AccountCreationError, AccountCreationErrorDetails, AccountCreationErrorDetailsField, NotificationPolicy, \
            NotificationPolicySummary, RelationshipSeveranceEvent, GroupedNotificationsResults, PartialAccountWithAvatar, NotificationGroup, AccountWarning, \
-            UnreadNotificationsCount, Appeal, TrendingLinkHistory, NotificationRequest
+            UnreadNotificationsCount, Appeal, TrendingLinkHistory, NotificationRequest, SupportedLocale
        if isinstance(t, ForwardRef):
            try:
                t = t._evaluate(globals(), locals(), frozenset())
--- a/srcgen/return_types.json
+++ b/srcgen/return_types.json
@ -9925,6 +9925,40 @@
                "is_nullable": false
            }
        }
+    },
+    {
+        "name": "Supported Locale",
+        "python_name": "SupportedLocale",
+        "func_call": "mastodon.languages()",
+        "func_call_real": null,
+        "func_call_additional": null,
+        "func_alternate_acc": null,
+        "manual_update": false,
+        "masto_doc_link": "https://docs.joinmastodon.org/entities/Instance",
+        "description": "A locale supported by the instance.",
+        "fields": {
+            "code": {
+                "description": "The locale code.",
+                "enum": null,
+                "version_history": [["4.2.0", "added"]],
+                "field_type": "str",
+                "field_subtype": null,
+                "field_structuretype": null,
+                "is_optional": false,
+                "is_nullable": false
+            },
+            "name": {
+                "description": "The name of the locale.",
+                "enum": null,
+                "version_history": [["4.2.0", "added"]],
+                "field_type": "str",
+                "field_subtype": null,
+                "field_structuretype": null,
+                "is_optional": false,
+                "is_nullable": false
+            }
+        }
+
    }
    
 ]
--- a/tests/cassettes/test_instance_languages.yaml
+++ b/tests/cassettes/test_instance_languages.yaml
@ -0,0 +1,162 @@
+interactions:
+- request:
+    body: null
+    headers:
+      Accept:
+      - '*/*'
+      Accept-Encoding:
+      - gzip, deflate
+      Authorization:
+      - Bearer __MASTODON_PY_TEST_ACCESS_TOKEN
+      Connection:
+      - keep-alive
+      User-Agent:
+      - tests/v311
+    method: GET
+    uri: http://localhost:3000/api/v1/instance/languages
+  response:
+    body:
+      string: "[{\"code\":\"aa\",\"name\":\"Afar\"},{\"code\":\"ab\",\"name\":\"Abkhaz\"},{\"code\":\"ae\",\"name\":\"Avestan\"},{\"code\":\"af\",\"name\":\"Afrikaans\"},{\"code\":\"ak\",\"name\":\"Akan\"},{\"code\":\"am\",\"name\":\"Amharic\"},{\"code\":\"an\",\"name\":\"Aragonese\"},{\"code\":\"ar\",\"name\":\"Arabic\"},{\"code\":\"as\",\"name\":\"Assamese\"},{\"code\":\"av\",\"name\":\"Avaric\"},{\"code\":\"ay\",\"name\":\"Aymara\"},{\"code\":\"az\",\"name\":\"Azerbaijani\"},{\"code\":\"ba\",\"name\":\"Bashkir\"},{\"code\":\"be\",\"name\":\"Belarusian\"},{\"code\":\"bg\",\"name\":\"Bulgarian\"},{\"code\":\"bh\",\"name\":\"Bihari\"},{\"code\":\"bi\",\"name\":\"Bislama\"},{\"code\":\"bm\",\"name\":\"Bambara\"},{\"code\":\"bn\",\"name\":\"Bengali\"},{\"code\":\"bo\",\"name\":\"Tibetan\"},{\"code\":\"br\",\"name\":\"Breton\"},{\"code\":\"bs\",\"name\":\"Bosnian\"},{\"code\":\"ca\",\"name\":\"Catalan\"},{\"code\":\"ce\",\"name\":\"Chechen\"},{\"code\":\"ch\",\"name\":\"Chamorro\"},{\"code\":\"co\",\"name\":\"Corsican\"},{\"code\":\"cr\",\"name\":\"Cree\"},{\"code\":\"cs\",\"name\":\"Czech\"},{\"code\":\"cu\",\"name\":\"Old
+        Church Slavonic\"},{\"code\":\"cv\",\"name\":\"Chuvash\"},{\"code\":\"cy\",\"name\":\"Welsh\"},{\"code\":\"da\",\"name\":\"Danish\"},{\"code\":\"de\",\"name\":\"German\"},{\"code\":\"dv\",\"name\":\"Divehi\"},{\"code\":\"dz\",\"name\":\"Dzongkha\"},{\"code\":\"ee\",\"name\":\"Ewe\"},{\"code\":\"el\",\"name\":\"Greek\"},{\"code\":\"en\",\"name\":\"English\"},{\"code\":\"eo\",\"name\":\"Esperanto\"},{\"code\":\"es\",\"name\":\"Spanish\"},{\"code\":\"et\",\"name\":\"Estonian\"},{\"code\":\"eu\",\"name\":\"Basque\"},{\"code\":\"fa\",\"name\":\"Persian\"},{\"code\":\"ff\",\"name\":\"Fula\"},{\"code\":\"fi\",\"name\":\"Finnish\"},{\"code\":\"fj\",\"name\":\"Fijian\"},{\"code\":\"fo\",\"name\":\"Faroese\"},{\"code\":\"fr\",\"name\":\"French\"},{\"code\":\"fy\",\"name\":\"Western
+        Frisian\"},{\"code\":\"ga\",\"name\":\"Irish\"},{\"code\":\"gd\",\"name\":\"Scottish
+        Gaelic\"},{\"code\":\"gl\",\"name\":\"Galician\"},{\"code\":\"gu\",\"name\":\"Gujarati\"},{\"code\":\"gv\",\"name\":\"Manx\"},{\"code\":\"ha\",\"name\":\"Hausa\"},{\"code\":\"he\",\"name\":\"Hebrew\"},{\"code\":\"hi\",\"name\":\"Hindi\"},{\"code\":\"ho\",\"name\":\"Hiri
+        Motu\"},{\"code\":\"hr\",\"name\":\"Croatian\"},{\"code\":\"ht\",\"name\":\"Haitian\"},{\"code\":\"hu\",\"name\":\"Hungarian\"},{\"code\":\"hy\",\"name\":\"Armenian\"},{\"code\":\"hz\",\"name\":\"Herero\"},{\"code\":\"ia\",\"name\":\"Interlingua\"},{\"code\":\"id\",\"name\":\"Indonesian\"},{\"code\":\"ie\",\"name\":\"Interlingue\"},{\"code\":\"ig\",\"name\":\"Igbo\"},{\"code\":\"ii\",\"name\":\"Nuosu\"},{\"code\":\"ik\",\"name\":\"Inupiaq\"},{\"code\":\"io\",\"name\":\"Ido\"},{\"code\":\"is\",\"name\":\"Icelandic\"},{\"code\":\"it\",\"name\":\"Italian\"},{\"code\":\"iu\",\"name\":\"Inuktitut\"},{\"code\":\"ja\",\"name\":\"Japanese\"},{\"code\":\"jv\",\"name\":\"Javanese\"},{\"code\":\"ka\",\"name\":\"Georgian\"},{\"code\":\"kg\",\"name\":\"Kongo\"},{\"code\":\"ki\",\"name\":\"Kikuyu\"},{\"code\":\"kj\",\"name\":\"Kwanyama\"},{\"code\":\"kk\",\"name\":\"Kazakh\"},{\"code\":\"kl\",\"name\":\"Kalaallisut\"},{\"code\":\"km\",\"name\":\"Khmer\"},{\"code\":\"kn\",\"name\":\"Kannada\"},{\"code\":\"ko\",\"name\":\"Korean\"},{\"code\":\"kr\",\"name\":\"Kanuri\"},{\"code\":\"ks\",\"name\":\"Kashmiri\"},{\"code\":\"ku\",\"name\":\"Kurmanji
+        (Kurdish)\"},{\"code\":\"kv\",\"name\":\"Komi\"},{\"code\":\"kw\",\"name\":\"Cornish\"},{\"code\":\"ky\",\"name\":\"Kyrgyz\"},{\"code\":\"la\",\"name\":\"Latin\"},{\"code\":\"lb\",\"name\":\"Luxembourgish\"},{\"code\":\"lg\",\"name\":\"Ganda\"},{\"code\":\"li\",\"name\":\"Limburgish\"},{\"code\":\"ln\",\"name\":\"Lingala\"},{\"code\":\"lo\",\"name\":\"Lao\"},{\"code\":\"lt\",\"name\":\"Lithuanian\"},{\"code\":\"lu\",\"name\":\"Luba-Katanga\"},{\"code\":\"lv\",\"name\":\"Latvian\"},{\"code\":\"mg\",\"name\":\"Malagasy\"},{\"code\":\"mh\",\"name\":\"Marshallese\"},{\"code\":\"mi\",\"name\":\"M\u0101ori\"},{\"code\":\"mk\",\"name\":\"Macedonian\"},{\"code\":\"ml\",\"name\":\"Malayalam\"},{\"code\":\"mn\",\"name\":\"Mongolian\"},{\"code\":\"mr\",\"name\":\"Marathi\"},{\"code\":\"ms\",\"name\":\"Malay\"},{\"code\":\"ms-Arab\",\"name\":\"Jawi
+        Malay\"},{\"code\":\"mt\",\"name\":\"Maltese\"},{\"code\":\"my\",\"name\":\"Burmese\"},{\"code\":\"na\",\"name\":\"Nauru\"},{\"code\":\"nb\",\"name\":\"Norwegian
+        Bokm\xE5l\"},{\"code\":\"nd\",\"name\":\"Northern Ndebele\"},{\"code\":\"ne\",\"name\":\"Nepali\"},{\"code\":\"ng\",\"name\":\"Ndonga\"},{\"code\":\"nl\",\"name\":\"Dutch\"},{\"code\":\"nn\",\"name\":\"Norwegian
+        Nynorsk\"},{\"code\":\"no\",\"name\":\"Norwegian\"},{\"code\":\"nr\",\"name\":\"Southern
+        Ndebele\"},{\"code\":\"nv\",\"name\":\"Navajo\"},{\"code\":\"ny\",\"name\":\"Chichewa\"},{\"code\":\"oc\",\"name\":\"Occitan\"},{\"code\":\"oj\",\"name\":\"Ojibwe\"},{\"code\":\"om\",\"name\":\"Oromo\"},{\"code\":\"or\",\"name\":\"Oriya\"},{\"code\":\"os\",\"name\":\"Ossetian\"},{\"code\":\"pa\",\"name\":\"Punjabi\"},{\"code\":\"pi\",\"name\":\"P\u0101li\"},{\"code\":\"pl\",\"name\":\"Polish\"},{\"code\":\"ps\",\"name\":\"Pashto\"},{\"code\":\"pt\",\"name\":\"Portuguese\"},{\"code\":\"qu\",\"name\":\"Quechua\"},{\"code\":\"rm\",\"name\":\"Romansh\"},{\"code\":\"rn\",\"name\":\"Kirundi\"},{\"code\":\"ro\",\"name\":\"Romanian\"},{\"code\":\"ru\",\"name\":\"Russian\"},{\"code\":\"rw\",\"name\":\"Kinyarwanda\"},{\"code\":\"sa\",\"name\":\"Sanskrit\"},{\"code\":\"sc\",\"name\":\"Sardinian\"},{\"code\":\"sd\",\"name\":\"Sindhi\"},{\"code\":\"se\",\"name\":\"Northern
+        Sami\"},{\"code\":\"sg\",\"name\":\"Sango\"},{\"code\":\"si\",\"name\":\"Sinhala\"},{\"code\":\"sk\",\"name\":\"Slovak\"},{\"code\":\"sl\",\"name\":\"Slovenian\"},{\"code\":\"sn\",\"name\":\"Shona\"},{\"code\":\"so\",\"name\":\"Somali\"},{\"code\":\"sq\",\"name\":\"Albanian\"},{\"code\":\"sr\",\"name\":\"Serbian\"},{\"code\":\"ss\",\"name\":\"Swati\"},{\"code\":\"st\",\"name\":\"Southern
+        Sotho\"},{\"code\":\"su\",\"name\":\"Sundanese\"},{\"code\":\"sv\",\"name\":\"Swedish\"},{\"code\":\"sw\",\"name\":\"Swahili\"},{\"code\":\"ta\",\"name\":\"Tamil\"},{\"code\":\"te\",\"name\":\"Telugu\"},{\"code\":\"tg\",\"name\":\"Tajik\"},{\"code\":\"th\",\"name\":\"Thai\"},{\"code\":\"ti\",\"name\":\"Tigrinya\"},{\"code\":\"tk\",\"name\":\"Turkmen\"},{\"code\":\"tl\",\"name\":\"Tagalog\"},{\"code\":\"tn\",\"name\":\"Tswana\"},{\"code\":\"to\",\"name\":\"Tonga\"},{\"code\":\"tr\",\"name\":\"Turkish\"},{\"code\":\"ts\",\"name\":\"Tsonga\"},{\"code\":\"tt\",\"name\":\"Tatar\"},{\"code\":\"tw\",\"name\":\"Twi\"},{\"code\":\"ty\",\"name\":\"Tahitian\"},{\"code\":\"ug\",\"name\":\"Uyghur\"},{\"code\":\"uk\",\"name\":\"Ukrainian\"},{\"code\":\"ur\",\"name\":\"Urdu\"},{\"code\":\"uz\",\"name\":\"Uzbek\"},{\"code\":\"ve\",\"name\":\"Venda\"},{\"code\":\"vi\",\"name\":\"Vietnamese\"},{\"code\":\"vo\",\"name\":\"Volap\xFCk\"},{\"code\":\"wa\",\"name\":\"Walloon\"},{\"code\":\"wo\",\"name\":\"Wolof\"},{\"code\":\"xh\",\"name\":\"Xhosa\"},{\"code\":\"yi\",\"name\":\"Yiddish\"},{\"code\":\"yo\",\"name\":\"Yoruba\"},{\"code\":\"za\",\"name\":\"Zhuang\"},{\"code\":\"zh\",\"name\":\"Chinese\"},{\"code\":\"zu\",\"name\":\"Zulu\"},{\"code\":\"zh-CN\",\"name\":\"Chinese
+        (China)\"},{\"code\":\"zh-HK\",\"name\":\"Chinese (Hong Kong)\"},{\"code\":\"zh-TW\",\"name\":\"Chinese
+        (Taiwan)\"},{\"code\":\"zh-YUE\",\"name\":\"Cantonese\"},{\"code\":\"ast\",\"name\":\"Asturian\"},{\"code\":\"chr\",\"name\":\"Cherokee\"},{\"code\":\"ckb\",\"name\":\"Sorani
+        (Kurdish)\"},{\"code\":\"cnr\",\"name\":\"Montenegrin\"},{\"code\":\"csb\",\"name\":\"Kashubian\"},{\"code\":\"jbo\",\"name\":\"Lojban\"},{\"code\":\"kab\",\"name\":\"Kabyle\"},{\"code\":\"ldn\",\"name\":\"L\xE1adan\"},{\"code\":\"lfn\",\"name\":\"Lingua
+        Franca Nova\"},{\"code\":\"moh\",\"name\":\"Mohawk\"},{\"code\":\"nds\",\"name\":\"Low
+        German\"},{\"code\":\"pdc\",\"name\":\"Pennsylvania Dutch\"},{\"code\":\"sco\",\"name\":\"Scots\"},{\"code\":\"sma\",\"name\":\"Southern
+        Sami\"},{\"code\":\"smj\",\"name\":\"Lule Sami\"},{\"code\":\"szl\",\"name\":\"Silesian\"},{\"code\":\"tok\",\"name\":\"Toki
+        Pona\"},{\"code\":\"vai\",\"name\":\"Vai\"},{\"code\":\"xal\",\"name\":\"Kalmyk\"},{\"code\":\"zba\",\"name\":\"Balaibalan\"},{\"code\":\"zgh\",\"name\":\"Standard
+        Moroccan Tamazight\"}]"
+    headers:
+      Cache-Control:
+      - max-age=300, public, stale-while-revalidate=30, stale-if-error=86400
+      Content-Length:
+      - '6650'
+      Content-Security-Policy:
+      - default-src 'none'; frame-ancestors 'none'; form-action 'none'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Sat, 15 Feb 2025 18:13:34 GMT
+      ETag:
+      - W/"193fed564e570e646c1fa671db28318a"
+      Referrer-Policy:
+      - strict-origin-when-cross-origin
+      Server-Timing:
+      - cache_read.active_support;dur=0.02, sql.active_record;dur=0.98, cache_generate.active_support;dur=1.39,
+        cache_write.active_support;dur=0.07, instantiation.active_record;dur=0.25,
+        start_processing.action_controller;dur=0.01, render.active_model_serializers;dur=5.85,
+        process_action.action_controller;dur=27.32
+      X-Content-Type-Options:
+      - nosniff
+      X-Frame-Options:
+      - SAMEORIGIN
+      X-Permitted-Cross-Domain-Policies:
+      - none
+      X-RateLimit-Limit:
+      - '300'
+      X-RateLimit-Remaining:
+      - '299'
+      X-RateLimit-Reset:
+      - '2025-02-15T18:15:00.694748Z'
+      X-Request-Id:
+      - d545c957-8fb9-48fc-84aa-ef4ebc804fc8
+      X-Runtime:
+      - '0.062112'
+      X-XSS-Protection:
+      - '0'
+      vary:
+      - Accept, Origin
+    status:
+      code: 200
+      message: OK
+- request:
+    body: null
+    headers:
+      Accept:
+      - '*/*'
+      Accept-Encoding:
+      - gzip, deflate
+      Authorization:
+      - Bearer __MASTODON_PY_TEST_ACCESS_TOKEN
+      Connection:
+      - keep-alive
+      User-Agent:
+      - tests/v311
+    method: GET
+    uri: http://localhost:3000/api/v1/instance/languages
+  response:
+    body:
+      string: "[{\"code\":\"aa\",\"name\":\"Afar\"},{\"code\":\"ab\",\"name\":\"Abkhaz\"},{\"code\":\"ae\",\"name\":\"Avestan\"},{\"code\":\"af\",\"name\":\"Afrikaans\"},{\"code\":\"ak\",\"name\":\"Akan\"},{\"code\":\"am\",\"name\":\"Amharic\"},{\"code\":\"an\",\"name\":\"Aragonese\"},{\"code\":\"ar\",\"name\":\"Arabic\"},{\"code\":\"as\",\"name\":\"Assamese\"},{\"code\":\"av\",\"name\":\"Avaric\"},{\"code\":\"ay\",\"name\":\"Aymara\"},{\"code\":\"az\",\"name\":\"Azerbaijani\"},{\"code\":\"ba\",\"name\":\"Bashkir\"},{\"code\":\"be\",\"name\":\"Belarusian\"},{\"code\":\"bg\",\"name\":\"Bulgarian\"},{\"code\":\"bh\",\"name\":\"Bihari\"},{\"code\":\"bi\",\"name\":\"Bislama\"},{\"code\":\"bm\",\"name\":\"Bambara\"},{\"code\":\"bn\",\"name\":\"Bengali\"},{\"code\":\"bo\",\"name\":\"Tibetan\"},{\"code\":\"br\",\"name\":\"Breton\"},{\"code\":\"bs\",\"name\":\"Bosnian\"},{\"code\":\"ca\",\"name\":\"Catalan\"},{\"code\":\"ce\",\"name\":\"Chechen\"},{\"code\":\"ch\",\"name\":\"Chamorro\"},{\"code\":\"co\",\"name\":\"Corsican\"},{\"code\":\"cr\",\"name\":\"Cree\"},{\"code\":\"cs\",\"name\":\"Czech\"},{\"code\":\"cu\",\"name\":\"Old
+        Church Slavonic\"},{\"code\":\"cv\",\"name\":\"Chuvash\"},{\"code\":\"cy\",\"name\":\"Welsh\"},{\"code\":\"da\",\"name\":\"Danish\"},{\"code\":\"de\",\"name\":\"German\"},{\"code\":\"dv\",\"name\":\"Divehi\"},{\"code\":\"dz\",\"name\":\"Dzongkha\"},{\"code\":\"ee\",\"name\":\"Ewe\"},{\"code\":\"el\",\"name\":\"Greek\"},{\"code\":\"en\",\"name\":\"English\"},{\"code\":\"eo\",\"name\":\"Esperanto\"},{\"code\":\"es\",\"name\":\"Spanish\"},{\"code\":\"et\",\"name\":\"Estonian\"},{\"code\":\"eu\",\"name\":\"Basque\"},{\"code\":\"fa\",\"name\":\"Persian\"},{\"code\":\"ff\",\"name\":\"Fula\"},{\"code\":\"fi\",\"name\":\"Finnish\"},{\"code\":\"fj\",\"name\":\"Fijian\"},{\"code\":\"fo\",\"name\":\"Faroese\"},{\"code\":\"fr\",\"name\":\"French\"},{\"code\":\"fy\",\"name\":\"Western
+        Frisian\"},{\"code\":\"ga\",\"name\":\"Irish\"},{\"code\":\"gd\",\"name\":\"Scottish
+        Gaelic\"},{\"code\":\"gl\",\"name\":\"Galician\"},{\"code\":\"gu\",\"name\":\"Gujarati\"},{\"code\":\"gv\",\"name\":\"Manx\"},{\"code\":\"ha\",\"name\":\"Hausa\"},{\"code\":\"he\",\"name\":\"Hebrew\"},{\"code\":\"hi\",\"name\":\"Hindi\"},{\"code\":\"ho\",\"name\":\"Hiri
+        Motu\"},{\"code\":\"hr\",\"name\":\"Croatian\"},{\"code\":\"ht\",\"name\":\"Haitian\"},{\"code\":\"hu\",\"name\":\"Hungarian\"},{\"code\":\"hy\",\"name\":\"Armenian\"},{\"code\":\"hz\",\"name\":\"Herero\"},{\"code\":\"ia\",\"name\":\"Interlingua\"},{\"code\":\"id\",\"name\":\"Indonesian\"},{\"code\":\"ie\",\"name\":\"Interlingue\"},{\"code\":\"ig\",\"name\":\"Igbo\"},{\"code\":\"ii\",\"name\":\"Nuosu\"},{\"code\":\"ik\",\"name\":\"Inupiaq\"},{\"code\":\"io\",\"name\":\"Ido\"},{\"code\":\"is\",\"name\":\"Icelandic\"},{\"code\":\"it\",\"name\":\"Italian\"},{\"code\":\"iu\",\"name\":\"Inuktitut\"},{\"code\":\"ja\",\"name\":\"Japanese\"},{\"code\":\"jv\",\"name\":\"Javanese\"},{\"code\":\"ka\",\"name\":\"Georgian\"},{\"code\":\"kg\",\"name\":\"Kongo\"},{\"code\":\"ki\",\"name\":\"Kikuyu\"},{\"code\":\"kj\",\"name\":\"Kwanyama\"},{\"code\":\"kk\",\"name\":\"Kazakh\"},{\"code\":\"kl\",\"name\":\"Kalaallisut\"},{\"code\":\"km\",\"name\":\"Khmer\"},{\"code\":\"kn\",\"name\":\"Kannada\"},{\"code\":\"ko\",\"name\":\"Korean\"},{\"code\":\"kr\",\"name\":\"Kanuri\"},{\"code\":\"ks\",\"name\":\"Kashmiri\"},{\"code\":\"ku\",\"name\":\"Kurmanji
+        (Kurdish)\"},{\"code\":\"kv\",\"name\":\"Komi\"},{\"code\":\"kw\",\"name\":\"Cornish\"},{\"code\":\"ky\",\"name\":\"Kyrgyz\"},{\"code\":\"la\",\"name\":\"Latin\"},{\"code\":\"lb\",\"name\":\"Luxembourgish\"},{\"code\":\"lg\",\"name\":\"Ganda\"},{\"code\":\"li\",\"name\":\"Limburgish\"},{\"code\":\"ln\",\"name\":\"Lingala\"},{\"code\":\"lo\",\"name\":\"Lao\"},{\"code\":\"lt\",\"name\":\"Lithuanian\"},{\"code\":\"lu\",\"name\":\"Luba-Katanga\"},{\"code\":\"lv\",\"name\":\"Latvian\"},{\"code\":\"mg\",\"name\":\"Malagasy\"},{\"code\":\"mh\",\"name\":\"Marshallese\"},{\"code\":\"mi\",\"name\":\"M\u0101ori\"},{\"code\":\"mk\",\"name\":\"Macedonian\"},{\"code\":\"ml\",\"name\":\"Malayalam\"},{\"code\":\"mn\",\"name\":\"Mongolian\"},{\"code\":\"mr\",\"name\":\"Marathi\"},{\"code\":\"ms\",\"name\":\"Malay\"},{\"code\":\"ms-Arab\",\"name\":\"Jawi
+        Malay\"},{\"code\":\"mt\",\"name\":\"Maltese\"},{\"code\":\"my\",\"name\":\"Burmese\"},{\"code\":\"na\",\"name\":\"Nauru\"},{\"code\":\"nb\",\"name\":\"Norwegian
+        Bokm\xE5l\"},{\"code\":\"nd\",\"name\":\"Northern Ndebele\"},{\"code\":\"ne\",\"name\":\"Nepali\"},{\"code\":\"ng\",\"name\":\"Ndonga\"},{\"code\":\"nl\",\"name\":\"Dutch\"},{\"code\":\"nn\",\"name\":\"Norwegian
+        Nynorsk\"},{\"code\":\"no\",\"name\":\"Norwegian\"},{\"code\":\"nr\",\"name\":\"Southern
+        Ndebele\"},{\"code\":\"nv\",\"name\":\"Navajo\"},{\"code\":\"ny\",\"name\":\"Chichewa\"},{\"code\":\"oc\",\"name\":\"Occitan\"},{\"code\":\"oj\",\"name\":\"Ojibwe\"},{\"code\":\"om\",\"name\":\"Oromo\"},{\"code\":\"or\",\"name\":\"Oriya\"},{\"code\":\"os\",\"name\":\"Ossetian\"},{\"code\":\"pa\",\"name\":\"Punjabi\"},{\"code\":\"pi\",\"name\":\"P\u0101li\"},{\"code\":\"pl\",\"name\":\"Polish\"},{\"code\":\"ps\",\"name\":\"Pashto\"},{\"code\":\"pt\",\"name\":\"Portuguese\"},{\"code\":\"qu\",\"name\":\"Quechua\"},{\"code\":\"rm\",\"name\":\"Romansh\"},{\"code\":\"rn\",\"name\":\"Kirundi\"},{\"code\":\"ro\",\"name\":\"Romanian\"},{\"code\":\"ru\",\"name\":\"Russian\"},{\"code\":\"rw\",\"name\":\"Kinyarwanda\"},{\"code\":\"sa\",\"name\":\"Sanskrit\"},{\"code\":\"sc\",\"name\":\"Sardinian\"},{\"code\":\"sd\",\"name\":\"Sindhi\"},{\"code\":\"se\",\"name\":\"Northern
+        Sami\"},{\"code\":\"sg\",\"name\":\"Sango\"},{\"code\":\"si\",\"name\":\"Sinhala\"},{\"code\":\"sk\",\"name\":\"Slovak\"},{\"code\":\"sl\",\"name\":\"Slovenian\"},{\"code\":\"sn\",\"name\":\"Shona\"},{\"code\":\"so\",\"name\":\"Somali\"},{\"code\":\"sq\",\"name\":\"Albanian\"},{\"code\":\"sr\",\"name\":\"Serbian\"},{\"code\":\"ss\",\"name\":\"Swati\"},{\"code\":\"st\",\"name\":\"Southern
+        Sotho\"},{\"code\":\"su\",\"name\":\"Sundanese\"},{\"code\":\"sv\",\"name\":\"Swedish\"},{\"code\":\"sw\",\"name\":\"Swahili\"},{\"code\":\"ta\",\"name\":\"Tamil\"},{\"code\":\"te\",\"name\":\"Telugu\"},{\"code\":\"tg\",\"name\":\"Tajik\"},{\"code\":\"th\",\"name\":\"Thai\"},{\"code\":\"ti\",\"name\":\"Tigrinya\"},{\"code\":\"tk\",\"name\":\"Turkmen\"},{\"code\":\"tl\",\"name\":\"Tagalog\"},{\"code\":\"tn\",\"name\":\"Tswana\"},{\"code\":\"to\",\"name\":\"Tonga\"},{\"code\":\"tr\",\"name\":\"Turkish\"},{\"code\":\"ts\",\"name\":\"Tsonga\"},{\"code\":\"tt\",\"name\":\"Tatar\"},{\"code\":\"tw\",\"name\":\"Twi\"},{\"code\":\"ty\",\"name\":\"Tahitian\"},{\"code\":\"ug\",\"name\":\"Uyghur\"},{\"code\":\"uk\",\"name\":\"Ukrainian\"},{\"code\":\"ur\",\"name\":\"Urdu\"},{\"code\":\"uz\",\"name\":\"Uzbek\"},{\"code\":\"ve\",\"name\":\"Venda\"},{\"code\":\"vi\",\"name\":\"Vietnamese\"},{\"code\":\"vo\",\"name\":\"Volap\xFCk\"},{\"code\":\"wa\",\"name\":\"Walloon\"},{\"code\":\"wo\",\"name\":\"Wolof\"},{\"code\":\"xh\",\"name\":\"Xhosa\"},{\"code\":\"yi\",\"name\":\"Yiddish\"},{\"code\":\"yo\",\"name\":\"Yoruba\"},{\"code\":\"za\",\"name\":\"Zhuang\"},{\"code\":\"zh\",\"name\":\"Chinese\"},{\"code\":\"zu\",\"name\":\"Zulu\"},{\"code\":\"zh-CN\",\"name\":\"Chinese
+        (China)\"},{\"code\":\"zh-HK\",\"name\":\"Chinese (Hong Kong)\"},{\"code\":\"zh-TW\",\"name\":\"Chinese
+        (Taiwan)\"},{\"code\":\"zh-YUE\",\"name\":\"Cantonese\"},{\"code\":\"ast\",\"name\":\"Asturian\"},{\"code\":\"chr\",\"name\":\"Cherokee\"},{\"code\":\"ckb\",\"name\":\"Sorani
+        (Kurdish)\"},{\"code\":\"cnr\",\"name\":\"Montenegrin\"},{\"code\":\"csb\",\"name\":\"Kashubian\"},{\"code\":\"jbo\",\"name\":\"Lojban\"},{\"code\":\"kab\",\"name\":\"Kabyle\"},{\"code\":\"ldn\",\"name\":\"L\xE1adan\"},{\"code\":\"lfn\",\"name\":\"Lingua
+        Franca Nova\"},{\"code\":\"moh\",\"name\":\"Mohawk\"},{\"code\":\"nds\",\"name\":\"Low
+        German\"},{\"code\":\"pdc\",\"name\":\"Pennsylvania Dutch\"},{\"code\":\"sco\",\"name\":\"Scots\"},{\"code\":\"sma\",\"name\":\"Southern
+        Sami\"},{\"code\":\"smj\",\"name\":\"Lule Sami\"},{\"code\":\"szl\",\"name\":\"Silesian\"},{\"code\":\"tok\",\"name\":\"Toki
+        Pona\"},{\"code\":\"vai\",\"name\":\"Vai\"},{\"code\":\"xal\",\"name\":\"Kalmyk\"},{\"code\":\"zba\",\"name\":\"Balaibalan\"},{\"code\":\"zgh\",\"name\":\"Standard
+        Moroccan Tamazight\"}]"
+    headers:
+      Cache-Control:
+      - max-age=300, public, stale-while-revalidate=30, stale-if-error=86400
+      Content-Length:
+      - '6650'
+      Content-Security-Policy:
+      - default-src 'none'; frame-ancestors 'none'; form-action 'none'
+      Content-Type:
+      - application/json; charset=utf-8
+      Date:
+      - Sat, 15 Feb 2025 18:13:34 GMT
+      ETag:
+      - W/"193fed564e570e646c1fa671db28318a"
+      Referrer-Policy:
+      - strict-origin-when-cross-origin
+      Server-Timing:
+      - cache_read.active_support;dur=0.02, sql.active_record;dur=0.80, cache_generate.active_support;dur=1.12,
+        cache_write.active_support;dur=0.08, instantiation.active_record;dur=0.23,
+        start_processing.action_controller;dur=0.00, render.active_model_serializers;dur=5.66,
+        process_action.action_controller;dur=24.30
+      X-Content-Type-Options:
+      - nosniff
+      X-Frame-Options:
+      - SAMEORIGIN
+      X-Permitted-Cross-Domain-Policies:
+      - none
+      X-RateLimit-Limit:
+      - '300'
+      X-RateLimit-Remaining:
+      - '299'
+      X-RateLimit-Reset:
+      - '2025-02-15T18:15:00.770164Z'
+      X-Request-Id:
+      - 62cc479e-713b-43c1-95a9-0da3844054f9
+      X-Runtime:
+      - '0.039428'
+      X-XSS-Protection:
+      - '0'
+      vary:
+      - Accept, Origin
+    status:
+      code: 200
+      message: OK
+version: 1
--- a/tests/test_instance.py
+++ b/tests/test_instance.py
@ -109,4 +109,9 @@ def test_translation_languages(api):
 def test_instance_domain_blocks(api):
    # Unforatuntely, default is to show no one, so this raises an error
    with pytest.raises(MastodonAPIError):
-        assert api.instance_domain_blocks() is not None
+        assert api.instance_domain_blocks() is not None
+
+@pytest.mark.vcr()
+def test_instance_languages(api):
+    assert api.instance_languages() is not None
+    assert len(api.instance_languages()) > 0