kalente/README.md
Kumi 1e9430c2e7
All checks were successful
Python Package CI/CD / Publish to PyPI (push) Successful in 42s
feat: add programmatic usage example to README
Added an example in README for generating a weekly calendar
programmatically using Kalente. This assists developers by
demonstrating how to integrate Kalente into their projects.

fix: default options parameter in convert_html_to_pdf

Updated the `options` parameter in `convert_html_to_pdf` to
default to an empty dictionary. This prevents potential NoneType
errors and ensures consistent behavior.

chore: bump version to 0.2.1

Updated version in pyproject.toml to reflect the new features
and bug fixes.
2024-06-14 07:24:46 +02:00

2.7 KiB

Kalente

Kalente logo

Kalente is a simple Python script for generating PDF calendars.

It can be used to generate weekly and monthly calendars at the moment, and it will be extended to support yearly calendars as well.

Currently, Kalente can only generate calendars in English, but support for other languages will be added in the future. Also, calendars are currently generated in A4 landscape format, but support for other formats will be added in the future. If you can help with any of these, please feel free to open a pull request.

Requirements

Kalente should work with any Python version from 3.8 onwards.

It also requires wkhtmltopdf to be installed on your system. You can find instructions on how to install it on your system on the project's website.

Installation

First, set up a virtual environment for Kalente:

python -m venv venv

Then, activate the virtual environment:

source venv/bin/activate

You can install Kalente using pip:

pip install kalente

Usage

Kalente can be used as a command line tool to generate calendars. You can generate weekly calendars using the following command:

kalente --type weekly --date 2021-01-01 --output weekly.pdf

This will generate a weekly calendar for the week of January 1st, 2021. The calendar will be saved to the file weekly.pdf.

You can also generate monthly calendars using the following command:

kalente --type monthly --date 2021-08-01 --output monthly.pdf

This will generate a monthly calendar for August 2021 and save it to the file monthly.pdf.

You can also use the --help option to get more information about the available options:

kalente --help

For example, you may want to look into the --end-date and --count options to generate calendars for multiple weeks or months.

Programmatic Usage

Kalente can also be used programmatically. Here's an example of how you can generate a weekly calendar using Kalente:

from kalente import Calendar
from datetime import date

# Create a Calendar object, optionally specifying the country to use
# for holidays, and a date format.
calendar = Calendar(country_code="AT", date_format="%d %B %Y")

# Get week data for the week of January 1st, 2021.
data = calendar.get_week(date(2021, 1, 1))

# Generate HTML for the week.
html = Calendar.generate_html(data, type="weekly")

# Generate a PDF file for the week.
Calendar.convert_html_to_pdf(html, "weekly.pdf")

License

Kalente is licensed under the MIT license. See the LICENSE file for more information.