Metadata-Version: 2.1
Name: django-radicale
Version: 0.0.17
Summary: Integration of Radicale with Django
Home-page: https://github.com/kyokenn/djradicale
Author: Kyoken
Author-email: Kyoken <kyoken@kyoken.ninja>
License: GPLv3
Project-URL: Source, https://github.com/kyokenn/djradicale
Keywords: django radicale carddav caldav
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Django >=4.0.1
Requires-Dist: Radicale >=3.1.2

DjRadicale
==========

[Radicale](http://radicale.org/) is a free and open-source CalDAV and CardDAV server.

DjRadicale is an Django Application for integration Radicale with a Django.


Features
========

With all features that Radicale have you will also get:

* Django Models as a storage backend (it's possible to use any database supported by Django)
* Django Admin web interface for browsing/editing stored data
* Django Authentication as an authentication backend
* Django Settings as a Radicale config


Requirements
============

* Python >= 3.0
* Django >= 4.0.1
* Radicale >= 3.1.2, < 4.0.0


Installation
============

Install using PIP
-----------------

```
$ pip install djradicale
```

Configuration
=============

Modify your settings.py
-----------------------

```python
INSTALLED_APPS = (
    ...
    'djradicale',
    ...
)

DJRADICALE_PREFIX = '/radicale/'
DJRADICALE_CONFIG = {
    'auth': {
        'type': 'djradicale.auth',
    },
    'rights': {
        'type': 'djradicale.rights',
    },
    'storage': {
        'type': 'djradicale.storage',
    },
}

```

Modify you urls.py
------------------

```python
urlpatterns = [
    ...
    path("" + settings.DJRADICALE_PREFIX.lstrip("/"),
         include(("djradicale.urls", "djradicale-caldav"), namespace="djradicale")),
    ...
]
```

well-known urls configuration
=============================

You need to choose an implementation for handling of the "well-known" urls

External DjRadicale implementation
----------------------------------

Add this to your urls'py:
```python
from djradicale.views import WellKnownView

urlpatterns = [
    ...
    path(".well-known/caldav",
         WellKnownView.as_view(type="caldav"), name="well-known-caldav"),
    path(".well-known/carddav",
         WellKnownView.as_view(type="carddav"), name="well-known-carddav"),
    ...
]
```
