nc_py_api

Added

• CalendarAPI with the help of caldav package. #136
• NotesAPI #137
• TalkAPI: list_participants method to list conversation participants. #142

Fixed

• TalkAPI: In One-to-One conversations the status_message and status_icon fields were always empty.
• Missing CSS styles in the documentation. #143

Added

• TalkAPI:
  • send_file to easy send FsNode to Talk chat.
  • receive_messages can return the TalkFileMessage subclass of usual TalkMessage with additional functionality.
• NextcloudApp: The ex_app.verify_version function to simply check whether the application has been updated.

Changed

• NextcloudApp: Updated info.xml in examples to reflect upcoming changes in the AppStore

Added

• FilesAPI: Chunked v2 upload support, enabled by default.
• New option to disable chunked v2 upload if there is a need for that: CHUNKED_UPLOAD_V2
• TalkAPI: Poll API support(create_poll, get_poll, vote_poll, close_poll).
• TalkAPI: Conversation avatar API(get_conversation_avatar, set_conversation_avatar, delete_conversation_avatar)

Changed

• Default chunk_size argument is now 5Mb instead of 4Mb.

Added

• NextcloudApp: ex_app.persistent_storage function that returns path for the Application persistent storage.
• NextcloudApp: from nc_py_api.ex_app import persist_transformers_cache - automatic use of persistent app directory for the AI models caching.

Added

• FilesAPI: FsNode.info added mimetype property.

Changed

• AppEcosystem_V2 Project was renamed to App_API, adjust all routes, examples, and docs for this.
• The Application Authentication mechanism was changed to a much simple one.

Added

• ActivityAPI: get_filters and get_activities. #112
• FilesAPI: added tags support. #115

Changed

• FilesAPI: removed listfav method, use new more powerful list_by_criteria method. #115

Fixed

• NotificationInfo.time - was always incorrectly parsed and equal to datetime(1970,1,1)

Added

• Basic APIs for Nextcloud Talk(Part 2) #111

Fixed

• makedirs correctly work with paths started with /
• listdir correctly handles exclude_self=True when input path starts with /

Added

• TrashBin API:
  • trashbin_list
  • trashbin_restore
  • trashbin_delete
  • trashbin_cleanup
• File Versions API: get_versions and restore_version.

Fixed

• Created FsNode from UiActionFileInfo now have the file_id with the NC instance ID as from the DAV requests.

Added

• Nextcloud Talk API for bots + example

Added

• Basic APIs for Nextcloud Talk(Part 1)

Changed

• require_capabilities/check_capabilities can accept value with dot: like files_sharing.api_enabled and check for sub-values.
• Refactored all API(except Files) again.

Fixed

• options.NPA_NC_CERT bug, when setting throw .env file.

Added

• FsNode can be created from Nextcloud UiActionFileInfo reply.

Fixed

• files.find error when searching by "name". Thanks to @CooperGerman

Added

• Nextcloud.response_headers property, to get headers from last response.

Changed

• Reworked skeleton for the applications, added skeleton to examples.

Added

• Finished Share API.

Fixed

• options error when setting timeouts with the .env file.
• ShareAPI.create wrong handling of share_with parameter.

Added

• APIs for enabling\disabling External Applications.
• FileAPI: download_directory_as_zip method.

Changed

• Much more documentation.
• Regroup APIs, hopes for the last time.

Fixed

• Assign groups in user creation

Added

• Notifications API
• options now independent in each Nextcloud class. They can be specified in kwargs, environment or .env files.

Changed

• Switched to hatching as a build system, now correct install optional dependencies.
• Renamed methods, attributes that was shadowing a Python builtins. Enabled additional Ruff linters checks.
• Regroup APIs, now Users related stuff starts with user, file related stuff with file, UI stuff with gui.

Added

• More documentation.

Changed

• Reworked User Status API, Users Group API
• Reworked return type for weather_status.get_location
• Reworked Files API: mkdir, upload, copy, move return new FsNode object
• Reworked listdir: added depth parameter
• Reworked FsNode: changed info from TypedDict to dataclass, correct fields names with correct descriptions.
• FsNode now allows comparison for equality.

Added

• First Files Sharing APIs.

Changed

• Updated documentation, description.
• Updated FsNode class with properties for parsing permissions.

Added

• VERIFY_NC_CERTIFICATE option.
• apps.ex_app_get_list and apps.ex_app_get_info methods.
• files.download2stream and files.upload_stream methods.
• most of FileAPI can accept FsNode as a path.

Changed

• License changed to BSD-3 Clause

Fixed

• nextcloud_url can contain / at the end.
• work of logs during enable/disable events.

Added

• heartbeat endpoint support for AppEcosystemV2.