rocketchat-API 3.4.0__tar.gz → 3.6.0__tar.gz

{rocketchat_api-3.4.0 → rocketchat_api-3.6.0}/.github/workflows/release.yml

@@ -29,10 +29,10 @@ jobs:
       - name: Publish package distributions to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
       - name: Announce release
-        uses: jadolg/rocketchat-notification-action@v2.0.0
+        uses: jadolg/rocketchat-notification-action@v3.0.0
         with:
           server: https://open.rocket.chat
           message: A new version (${{ github.event.release.tag_name }}) has been released! ${{ github.event.release.html_url }}
-          user: ${{ secrets.ROCKETCHAT_USER }}
-          password: ${{ secrets.ROCKETCHAT_PASSWORD }}
+          user-id: ${{ secrets.ROCKETCHAT_USER_ID }}
+          auth-token: ${{ secrets.ROCKETCHAT_AUTH_TOKEN }}
           channel: "#python_rocketchat_api"

{rocketchat_api-3.4.0 → rocketchat_api-3.6.0}/.github/workflows/test.yml

@@ -15,7 +15,7 @@ jobs:
       fail-fast: false
       matrix:
         python-version: [ '3.10', '3.11', '3.12', '3.13', '3.14' ]
-        rocket-chat-version: [ '7.10.7', '7.11.3', '7.12.4', '7.13.3' , '8.0.1', '8.1.0']
+        rocket-chat-version: [ '7.11.6', '7.12.6', '7.13.5' , '8.0.3', '8.1.2', '8.2.1', '8.3.1']
     steps:
       - name: Checkout
         uses: actions/checkout@v6.0.2

{rocketchat_api-3.4.0 → rocketchat_api-3.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rocketchat_API
-Version: 3.4.0
+Version: 3.6.0
 Summary: Python API wrapper for Rocket.Chat
 Author-email: "Jorge Alberto Díaz Orozco (Akiel)" <diazorozcoj@gmail.com>
 Maintainer-email: "Jorge Alberto Díaz Orozco (Akiel)" <diazorozcoj@gmail.com>

rocketchat_api-3.6.0/rocketchat_API/APISections/custom_sounds.py

@@ -0,0 +1,12 @@
+from rocketchat_API.APISections.base import RocketChatBase, paginated
+
+
+class RocketChatCustomSounds(RocketChatBase):
+    @paginated("sounds")
+    def custom_sounds_list(self, **kwargs):
+        """Retrieves all custom sounds."""
+        return self.call_api_get("custom-sounds.list", kwargs=kwargs)
+
+    def custom_sounds_get_one(self, sound_id, **kwargs):
+        """Retrieves a single custom sound by its _id."""
+        return self.call_api_get("custom-sounds.getOne", _id=sound_id, kwargs=kwargs)

rocketchat_api-3.6.0/rocketchat_API/APISections/custom_user_status.py

@@ -0,0 +1,41 @@
+from rocketchat_API.APISections.base import RocketChatBase, paginated
+
+
+class RocketChatCustomUserStatus(RocketChatBase):
+    @paginated("statuses")
+    def custom_user_status_list(self, **kwargs):
+        """Lists all available custom user's status."""
+        return self.call_api_get("custom-user-status.list", kwargs=kwargs)
+
+    def custom_user_status_create(self, name, status_type, **kwargs):
+        """Creates custom user status.
+
+        :param name: The name of the custom status.
+        :param status_type: The statusType of the custom status. Valid status type includes: Online, Busy, Away, Offline.
+        """
+        return self.call_api_post(
+            "custom-user-status.create",
+            name=name,
+            statusType=status_type,
+            kwargs=kwargs,
+        )
+
+    def custom_user_status_delete(self, custom_user_status_id, **kwargs):
+        """Deletes a custom user status."""
+        return self.call_api_post(
+            "custom-user-status.delete",
+            customUserStatusId=custom_user_status_id,
+            kwargs=kwargs,
+        )
+
+    def custom_user_status_update(
+        self, custom_user_status_id, name, status_type, **kwargs
+    ):
+        """Updates a custom user status."""
+        return self.call_api_post(
+            "custom-user-status.update",
+            _id=custom_user_status_id,
+            name=name,
+            statusType=status_type,
+            kwargs=kwargs,
+        )

{rocketchat_api-3.4.0 → rocketchat_api-3.6.0}/rocketchat_API/APISections/licenses.py

@@ -6,3 +6,7 @@ class RocketChatLicenses(RocketChatBase):
     def licenses_info(self, **kwargs):
         """Retrieves a list of all registered licenses in the workspace."""
         return self.call_api_get("licenses.info", kwargs=kwargs)
+
+    def licenses_max_active_users(self, **kwargs):
+        """Retrieves a list of the maximum active users."""
+        return self.call_api_get("licenses.maxActiveUsers", kwargs=kwargs)

{rocketchat_api-3.4.0 → rocketchat_api-3.6.0}/rocketchat_API/APISections/rooms.py

@@ -69,11 +69,22 @@ class RocketChatRooms(RocketChatBase):
         """Upload media files to a room."""
         files = {
             "file": (
-                os.path.basename(file),
-                open(file, "rb"),
-                mimetypes.guess_type(file)[0],
+                file
+                if isinstance(file, (list, tuple))
+                else (
+                    os.path.basename(file),
+                    open(file, "rb"),
+                    mimetypes.guess_type(file)[0],
+                )
             ),
         }
         return self.call_api_post(
             "rooms.media/" + room_id, kwargs=kwargs, use_json=False, files=files
         )
+
+    def rooms_media_confirm(self, room_id, file_id, **kwargs):
+        """Confirm a previously uploaded media file in a room."""
+        return self.call_api_post(
+            "rooms.mediaConfirm/" + room_id + "/" + file_id,
+            kwargs=kwargs,
+        )

{rocketchat_api-3.4.0 → rocketchat_api-3.6.0}/rocketchat_API/rocketchat.py

@@ -6,6 +6,8 @@ from rocketchat_API.APISections.channels import RocketChatChannels
 from rocketchat_API.APISections.chat import RocketChatChat
 from rocketchat_API.APISections.dm import RocketChatDM
 from rocketchat_API.APISections.custom_emoji import RocketChatCustomEmoji
+from rocketchat_API.APISections.custom_sounds import RocketChatCustomSounds
+from rocketchat_API.APISections.custom_user_status import RocketChatCustomUserStatus
 from rocketchat_API.APISections.groups import RocketChatGroups
 from rocketchat_API.APISections.integrations import RocketChatIntegrations
 from rocketchat_API.APISections.invites import RocketChatInvites
@@ -31,6 +33,8 @@ class RocketChat(
     RocketChatChat,
     RocketChatDM,
     RocketChatCustomEmoji,
+    RocketChatCustomSounds,
+    RocketChatCustomUserStatus,
     RocketChatGroups,
     RocketChatIntegrations,
     RocketChatInvites,

{rocketchat_api-3.4.0 → rocketchat_api-3.6.0}/rocketchat_API.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rocketchat_API
-Version: 3.4.0
+Version: 3.6.0
 Summary: Python API wrapper for Rocket.Chat
 Author-email: "Jorge Alberto Díaz Orozco (Akiel)" <diazorozcoj@gmail.com>
 Maintainer-email: "Jorge Alberto Díaz Orozco (Akiel)" <diazorozcoj@gmail.com>

{rocketchat_api-3.4.0 → rocketchat_api-3.6.0}/rocketchat_API.egg-info/SOURCES.txt

@@ -34,6 +34,8 @@ rocketchat_API/APISections/base.py
 rocketchat_API/APISections/channels.py
 rocketchat_API/APISections/chat.py
 rocketchat_API/APISections/custom_emoji.py
+rocketchat_API/APISections/custom_sounds.py
+rocketchat_API/APISections/custom_user_status.py
 rocketchat_API/APISections/dm.py
 rocketchat_API/APISections/groups.py
 rocketchat_API/APISections/integrations.py
@@ -58,6 +60,8 @@ tests/test_banners.py
 tests/test_channels.py
 tests/test_chat.py
 tests/test_custom_emoji.py
+tests/test_custom_sounds.py
+tests/test_custom_user_status.py
 tests/test_dms.py
 tests/test_exceptions.py
 tests/test_groups.py

{rocketchat_api-3.4.0 → rocketchat_api-3.6.0}/tests/conftest.py

@@ -78,6 +78,18 @@ def secondary_user(logged_rocket):
     logged_rocket.users_delete(_testuser_id)
 
 
+@pytest.fixture
+def skip_if_version_under(rocket):
+    import semver
+
+    def _skip_if_version_under(minimum_version):
+        parse = lambda v: semver.Version.parse(v, optional_minor_and_patch=True)
+        if parse(rocket.info()["version"]) < parse(minimum_version):
+            pytest.skip(f"Requires Rocket.Chat >= {minimum_version}")
+
+    return _skip_if_version_under
+
+
 @pytest.fixture
 def skip_if_no_license(logged_rocket):
     try:

rocketchat_api-3.6.0/tests/test_custom_sounds.py

@@ -0,0 +1,79 @@
+import json
+import uuid
+
+
+def _sound_name():
+    return "test_sound_" + str(uuid.uuid1()).replace("-", "")[:12]
+
+
+def _create_sound(logged_rocket, name):
+    """Create a custom sound entry via method.call and return its _id."""
+    result = logged_rocket.call_api_post(
+        "method.call/insertOrUpdateSound",
+        message=json.dumps(
+            {
+                "msg": "method",
+                "id": "1",
+                "method": "insertOrUpdateSound",
+                "params": [{"name": name, "extension": "mp3", "newFile": True}],
+            }
+        ),
+    )
+    return json.loads(result["message"])["result"]
+
+
+def _delete_sound(logged_rocket, sound_id):
+    """Delete a custom sound entry via method.call."""
+    logged_rocket.call_api_post(
+        "method.call/deleteCustomSound",
+        message=json.dumps(
+            {
+                "msg": "method",
+                "id": "1",
+                "method": "deleteCustomSound",
+                "params": [sound_id],
+            }
+        ),
+    )
+
+
+def test_custom_sounds_list(logged_rocket):
+    result = list(logged_rocket.custom_sounds_list())
+    assert isinstance(result, list)
+
+
+def test_custom_sounds_list_structure(logged_rocket):
+    name = _sound_name()
+    sound_id = _create_sound(logged_rocket, name)
+    try:
+        sounds = list(logged_rocket.custom_sounds_list())
+        assert any(s["_id"] == sound_id for s in sounds)
+        sound = next(s for s in sounds if s["_id"] == sound_id)
+        assert "name" in sound
+        assert "extension" in sound
+    finally:
+        _delete_sound(logged_rocket, sound_id)
+
+
+def test_custom_sounds_list_filter_by_name(logged_rocket):
+    name = _sound_name()
+    sound_id = _create_sound(logged_rocket, name)
+    try:
+        sounds = list(logged_rocket.custom_sounds_list(name=name))
+        assert len(sounds) >= 1
+        assert all(name.lower() in s["name"].lower() for s in sounds)
+    finally:
+        _delete_sound(logged_rocket, sound_id)
+
+
+def test_custom_sounds_get_one(logged_rocket, skip_if_version_under):
+    skip_if_version_under("8.3.0")
+    name = _sound_name()
+    sound_id = _create_sound(logged_rocket, name)
+    try:
+        result = logged_rocket.custom_sounds_get_one(sound_id)
+        assert "sound" in result
+        assert result["sound"]["_id"] == sound_id
+        assert result["sound"]["name"] == name
+    finally:
+        _delete_sound(logged_rocket, sound_id)

rocketchat_api-3.6.0/tests/test_custom_user_status.py

@@ -0,0 +1,69 @@
+import uuid
+
+import pytest
+
+
+@pytest.fixture
+def status_name():
+    return "test_status_" + str(uuid.uuid1()).replace("-", "")[:12]
+
+
+@pytest.fixture
+def created_status(logged_rocket, status_name):
+    result = logged_rocket.custom_user_status_create(
+        name=status_name, status_type="online"
+    )
+    status = result.get("customUserStatus")
+    assert status is not None
+
+    yield status
+
+    logged_rocket.custom_user_status_delete(custom_user_status_id=status["_id"])
+
+
+def test_custom_user_status_list(logged_rocket, created_status):
+    statuses = list(logged_rocket.custom_user_status_list())
+    assert any(s["_id"] == created_status["_id"] for s in statuses)
+
+
+def test_custom_user_status_create_delete(logged_rocket):
+    name = "test_status_" + str(uuid.uuid1()).replace("-", "")[:12]
+    result = logged_rocket.custom_user_status_create(name=name, status_type="busy")
+    status = result.get("customUserStatus")
+    assert status is not None
+    assert status["name"] == name
+    assert status["statusType"] == "busy"
+
+    logged_rocket.custom_user_status_delete(custom_user_status_id=status["_id"])
+
+    statuses = list(logged_rocket.custom_user_status_list())
+    assert not any(s["_id"] == status["_id"] for s in statuses)
+
+
+def test_custom_user_status_update(logged_rocket, created_status):
+    new_name = created_status["name"] + "_upd"
+    result = logged_rocket.custom_user_status_update(
+        custom_user_status_id=created_status["_id"],
+        name=new_name,
+        status_type="away",
+    )
+    updated = result.get("customUserStatus")
+    assert updated is not None
+    assert updated["name"] == new_name
+    assert updated["statusType"] == "away"
+
+
+def test_custom_user_status_create_all_types(logged_rocket):
+    created_ids = []
+    for status_type in ("online", "busy", "away", "offline"):
+        name = "test_" + status_type + "_" + str(uuid.uuid1()).replace("-", "")[:8]
+        result = logged_rocket.custom_user_status_create(
+            name=name, status_type=status_type
+        )
+        status = result.get("customUserStatus")
+        assert status is not None
+        assert status["statusType"] == status_type
+        created_ids.append(status["_id"])
+
+    for sid in created_ids:
+        logged_rocket.custom_user_status_delete(custom_user_status_id=sid)

rocketchat_api-3.6.0/tests/test_licenses.py

@@ -0,0 +1,22 @@
+def test_licenses_info_works_without_license(logged_rocket):
+    licenses_info = logged_rocket.licenses_info()
+    assert "license" in licenses_info
+
+
+def test_licenses_info(logged_rocket, skip_if_no_license, skip_if_version_under):
+    skip_if_version_under("8.1.0")
+    licenses_info = logged_rocket.licenses_info()
+    assert "license" in licenses_info
+    license_data = licenses_info["license"]
+    assert "activeModules" in license_data
+    assert "hasValidLicense" in license_data
+    assert "tags" in license_data
+    assert "limits" in license_data
+    assert isinstance(license_data["activeModules"], list)
+    assert isinstance(license_data["tags"], list)
+
+
+def test_licenses_max_active_users(logged_rocket, skip_if_no_license):
+    result = logged_rocket.licenses_max_active_users()
+    assert "maxActiveUsers" in result
+    assert "activeUsers" in result

{rocketchat_api-3.4.0 → rocketchat_api-3.6.0}/tests/test_rooms.py

@@ -15,6 +15,47 @@ def test_rooms_media(logged_rocket):
     assert str(rooms_media.get("file").get("url")).endswith("avatar.png")
 
 
+def test_rooms_media_array_file(logged_rocket):
+    with open("tests/assets/avatar.png", "rb") as avatar_file:
+        avatar_bytes = avatar_file.read()
+
+    rooms_media = logged_rocket.rooms_media(
+        "GENERAL",
+        file=("avatar.png", avatar_bytes, "image/png"),
+        description="hey there",
+    )
+    assert str(rooms_media.get("file").get("url")).endswith("avatar.png")
+
+
+def test_rooms_media_array_file_with_list(logged_rocket):
+    with open("tests/assets/avatar.png", "rb") as avatar_file:
+        avatar_bytes = avatar_file.read()
+
+    rooms_media = logged_rocket.rooms_media(
+        "GENERAL",
+        file=["avatar.png", avatar_bytes, "image/png"],  # list instead of tuple
+        description="hey there",
+    )
+
+    assert str(rooms_media.get("file").get("url")).endswith("avatar.png")
+
+
+def test_rooms_media_confirm(logged_rocket):
+    uploaded_media = logged_rocket.rooms_media(
+        "GENERAL", file="tests/assets/avatar.png"
+    )
+    file_id = str(uploaded_media.get("file").get("_id"))
+    assert file_id
+
+    confirmed_media = logged_rocket.rooms_media_confirm(
+        room_id="GENERAL",
+        file_id=file_id,
+        msg="confirmed upload",
+    )
+
+    assert confirmed_media.get("message").get("_id")
+
+
 def test_rooms_get(logged_rocket):
     rooms_get = logged_rocket.rooms_get()
     assert "update" in rooms_get

rocketchat_api-3.4.0/tests/test_licenses.py

@@ -1,3 +0,0 @@
-def test_licenses_info(logged_rocket):
-    licenses_info = logged_rocket.licenses_info()
-    assert "license" in licenses_info