v3.5.0

Author: bodrovis

.github/workflows/ci.yml

@@ -16,7 +16,7 @@ jobs:
       matrix:
         os: [ubuntu-latest]
         python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
-        poetry-version: ["2.1.2"]
+        poetry-version: ["2.1.3"]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5

docs/additional_info/changelog.rst

@@ -3,6 +3,12 @@
 Changelog
 =========
 
+3.5.0 (08-May-2025)
+-------------------
+
+* Added support for `Current contributor <https://developers.lokalise.com/reference/retrieve-me-as-a-contributor>`_ endpoint
+* Added support for `Fetch team <https://developers.lokalise.com/reference/get-team-details>`_ endpoint
+
 3.4.0 (30-Apr-2025)
 -------------------
 

docs/api/contributors.rst

@@ -36,6 +36,24 @@ Example:
   contributor.email == "test@example.com"
   contributor.fullname == "John Doe"
 
+Fetch current contributor
+-------------------------
+
+This endpoint returns contributor in the given project based on the user whose token is used to send the request. In other words, it returns information about self in scope of a project.
+
+.. py:function:: current_contributor(project_id)
+
+  :param str project_id: ID of the project
+  :return: Contributor model
+
+Example:
+
+.. code-block:: python
+
+  contributor = client.current_contributor('123.abc')
+  
+  contributor.fullname == "John Doe"
+
 Create one or multiple contributors
 -----------------------------------
 

docs/api/teams.rst

@@ -17,3 +17,22 @@ Example:
 
   teams = client.teams({"page": 2, "limit": 3})
   teams.items[0].team_id # => 156123
+
+
+Fetch a single team
+-------------------
+
+.. py:function:: team(team_id)
+
+  :param team_id: ID of the team to fetch
+  :type team_id: int or str
+  :return: Team model
+
+Example:
+
+.. code-block:: python
+
+  team = client.team(12345)
+  
+  team.team_id # => 12345
+  team.name # => "My Team"

lokalise/_version.py

@@ -4,4 +4,4 @@
 This module contains plugin metadata.
 """
 
-__version__: str = "3.4.0"
+__version__: str = "3.5.0"

lokalise/client_methods/contributors.py

@@ -41,6 +41,17 @@ def contributor(self,
             find(parent_id=project_id, resource_id=contributor_id)
         return ContributorModel(raw_contributor)
 
+    def current_contributor(self,
+                            project_id: str) -> ContributorModel:
+        """Fetches current contributor (on per-token basis).
+
+        :param str project_id: ID of the project
+        :return: Contributor model
+        """
+        raw_contributor = self.get_endpoint("contributors"). \
+            find(parent_id=project_id, resource_id="me")
+        return ContributorModel(raw_contributor)
+
     def create_contributors(self,
                             project_id: str,
                             params: Union[Dict[str, Any], List[Dict]]

lokalise/client_methods/teams.py

@@ -3,8 +3,9 @@
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 This module contains API client definition for teams.
 """
-from typing import Optional, Dict
+from typing import Optional, Dict, Union
 from lokalise.collections.teams import TeamsCollection
+from lokalise.models.team import TeamModel
 from .endpoint_provider import EndpointProviderMixin
 
 
@@ -21,3 +22,14 @@ def teams(self, params: Optional[Dict] = None) -> TeamsCollection:
         """
         raw_teams = self.get_endpoint("teams").all(params=params)
         return TeamsCollection(raw_teams)
+
+    def team(self, team_id: Union[str, int]) -> TeamModel:
+        """Fetches a single team by ID.
+
+        :param team_id: ID of the team to fetch
+        :type team_id: int or str
+        :return: Team model
+        """
+        raw_project = self.get_endpoint("teams"). \
+            find(parent_id=team_id)
+        return TeamModel(raw_project)

lokalise/endpoints/teams_endpoint.py

@@ -9,4 +9,4 @@
 class TeamsEndpoint(BaseEndpoint):
     """Describes teams endpoint.
     """
-    PATH = "teams"
+    PATH = "teams/$parent_id"

lokalise/models/team.py

@@ -11,6 +11,8 @@ class TeamModel(BaseModel):
     """Describes team model.
     """
 
+    DATA_KEY = 'team'
+
     ATTRS = [
         'team_id',
         'name',