tsf0x13/nc_py_api

Nextcloud Python Framework

Nextcloud Python Framework

Python library that provides a robust and well-documented API that allows developers to interact with and extend Nextcloud's functionality.

The key features are:

• Fast: High performance, and as low-latency as possible.
• Intuitive: Fast to code, easy to use.
• Reliable: Minimum number of incompatible changes.
• Robust: All code is covered with tests as much as possible.
• Easy: Designed to be easy to use with excellent documentation.

Capabilities

Capability	Nextcloud 26	Nextcloud 27	Nextcloud 28
File System & Tags	✅	✅	✅
Nextcloud Talk**	✅	✅	✅
Notifications	✅	✅	✅
Shares	✅	✅	✅
Users & Groups	✅	✅	✅
User & Weather status	✅	✅	✅
Weather status	✅	✅	✅
Talk Bot API*	N/A	✅	✅
Text Processing*	N/A	❌	❌
SpeechToText*	N/A	❌	❌

*available only for NextcloudApp
** work is in progress, not all API's is described, yet.

Differences between the Nextcloud and NextcloudApp classes

The Nextcloud class functions as a standard Nextcloud client, enabling you to make API requests using a username and password.

On the other hand, the NextcloudApp class is designed for creating applications for Nextcloud.
It uses the AppAPI to allow applications to impersonate users through a separate authentication mechanism.

Both classes offer most of the same APIs, but NextcloudApp has a broader selection since applications typically require access to more APIs.

Any code written for the Nextcloud class can easily be adapted for use with the NextcloudApp class, as long as it doesn't involve calls that require user password verification.

Support

You can support us in several ways:

• ⭐️ Star our work (it really motivates)
• ❗️ Create an Issue or feature request (bring to us an excellent idea)
• 💁 Resolve some Issue or create a Pull Request (contribute to this project)
• 🙏 Write an example of its use or correct a typo in the documentation.

More Information

• Documentation
  • First steps
  • More APIs
  • Writing a simple Nextcloud Application
  • Using Nextcloud Talk Bot API in Application
  • Using Language Models In Application
  • Writing a Nextcloud System Application
• Examples
• Contribute
  • Discussions
  • Issues
  • Setting up dev environment
• Changelog

Motivation

Python's language, elegant and clear,
Weaves logic's threads without fear,
And in the sky, where clouds take form,
Nextcloud emerges, a digital norm.

Together they stand, a duo bright,
Python and Nextcloud, day and night,
In a digital dance, they guide and sail,
Shaping tomorrow, where new ideas prevail.

Know that we are always here to support and assist you on your journey.

P.S: Good luck, and we hope you have fun!