feat: add Teams (Circles) async API

.github/workflows/analysis-coverage.yml

@@ -213,6 +213,13 @@ jobs:
           ref: ${{ matrix.nextcloud }}
           path: apps/files_lock
 
+      - name: Checkout Circles
+        uses: actions/checkout@v6
+        with:
+          repository: nextcloud/circles
+          ref: ${{ matrix.nextcloud }}
+          path: apps/circles
+
       - name: Set up & run Nextcloud
         env:
           DB_PORT: 4444
@@ -224,6 +231,7 @@ jobs:
           ./occ config:system:set loglevel --value=0 --type=integer
           ./occ config:system:set debug --value=true --type=boolean
           ./occ config:system:set ratelimit.protection.enabled --value=false --type=boolean
+          ./occ config:system:set overwrite.cli.url --value="http://localhost:8080"
           ./occ app:enable notifications
           PHP_CLI_SERVER_WORKERS=2 php -S localhost:8080 &
 
@@ -233,6 +241,9 @@ jobs:
       - name: Enable Notes
         run: ./occ app:enable notes
 
+      - name: Enable Circles
+        run: php occ app:enable circles
+
       - name: Checkout NcPyApi
         uses: actions/checkout@v6
         with:
@@ -379,6 +390,13 @@ jobs:
           ref: ${{ matrix.nextcloud }}
           path: apps/activity
 
+      - name: Checkout Circles
+        uses: actions/checkout@v6
+        with:
+          repository: nextcloud/circles
+          ref: ${{ matrix.nextcloud }}
+          path: apps/circles
+
       - name: Set up & run Nextcloud
         env:
           DB_PORT: 4444
@@ -390,10 +408,14 @@ jobs:
           ./occ config:system:set loglevel --value=0 --type=integer
           ./occ config:system:set debug --value=true --type=boolean
           ./occ config:system:set ratelimit.protection.enabled --value=false --type=boolean
+          ./occ config:system:set overwrite.cli.url --value="http://localhost:8080"
           ./occ app:enable notifications
           ./occ app:enable activity
           PHP_CLI_SERVER_WORKERS=2 php -S localhost:8080 &
 
+      - name: Enable Circles
+        run: php occ app:enable circles
+
       - name: Checkout NcPyApi
         uses: actions/checkout@v6
         with:

nc_py_api/__init__.py

@@ -11,3 +11,4 @@
 from .files import FilePermissions, FsNode, LockType, SystemTag
 from .files.sharing import ShareType
 from .nextcloud import AsyncNextcloud, AsyncNextcloudApp, Nextcloud, NextcloudApp
+from .teams import Circle, CircleConfig, Member, MemberLevel, MemberType

nc_py_api/nextcloud.py

@@ -39,6 +39,7 @@
 from .loginflow_v2 import _AsyncLoginFlowV2API, _LoginFlowV2API
 from .notes import _AsyncNotesAPI
 from .notifications import _AsyncNotificationsAPI, _NotificationsAPI
+from .teams import _AsyncTeamsAPI
 from .user_status import _AsyncUserStatusAPI
 from .users import _AsyncUsersAPI, _UsersAPI
 from .users_groups import _AsyncUsersGroupsAPI, _UsersGroupsAPI
@@ -155,6 +156,8 @@ class _AsyncNextcloudBasic(ABC):  # pylint: disable=too-many-instance-attributes
     """Nextcloud API for managing user notifications"""
     talk: _AsyncTalkAPI
     """Nextcloud Talk API"""
+    teams: _AsyncTeamsAPI
+    """Nextcloud API for managing Teams (Circles)"""
     users: _AsyncUsersAPI
     """Nextcloud API for managing users."""
     users_groups: _AsyncUsersGroupsAPI
@@ -176,6 +179,7 @@ def __init__(self, session: AsyncNcSessionBasic):
         self.notes = _AsyncNotesAPI(session)
         self.notifications = _AsyncNotificationsAPI(session)
         self.talk = _AsyncTalkAPI(session)
+        self.teams = _AsyncTeamsAPI(session)
         self.users = _AsyncUsersAPI(session)
         self.users_groups = _AsyncUsersGroupsAPI(session)
         self.user_status = _AsyncUserStatusAPI(session)