Metadata-Version: 2.1
Name: dinky-calendar
Version: 0.1.1
Summary: Calendar widget for the dinky dashboard
Author: Julian Prester
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: dinky
Requires-Dist: pluggy
Requires-Dist: Pillow
Requires-Dist: caldav
Requires-Dist: setuptools
Provides-Extra: test
Requires-Dist: pytest; extra == "test"

# dinky-calendar

CalDAV-based calendar widget for the [dinky](https://github.com/get-dinky/dinky) dashboard generator

## Installation

Install this plugin using `pip`:

```bash
pip install dinky-calendar
```

## Usage

`dinky-calendar` is a plugin for the `dinky` dashboard generator. You can simply register the calendar widget with your DashboardManager:

```python
from dinky_calendar import DinkyCalendarPlugin

dm.register(
    DinkyCalendarPlugin(
        url="CalDAV calendar",
        username="your_username",
        password="your_password",
        timezone="your_timezone"
    ), zone="A")
```

Then draw your dashboard as usual:

```python
dm.draw_dashboard()
```

## Development

To contribute to this library, first checkout the code. Then create a new virtual environment:

```bash
cd dinky-calendar
python -m venv .venv
source .venv/bin/activate
```

Now install the dependencies and test dependencies:

```bash
pip install -e '.[test]'
```

To run the tests:

```bash
python -m pytest
```
