Skip to main content

drawcal

Python library for drawing simple monthly calendar images with events.

drwacal clendar image

Installation

Install from PyPI:

$ pip install -U drawcal

Quickstart

Generate a calendar image for a given events file:

$ drawcal --events events.json --month 3 --year 2025

Python:

>>> from drawcal import draw_calendar
>>> draw_calendar(month, year, events=events, outfile=outfile)

Events format

drawcal uses a structured event object format:

[
  {
    "start_date": "3/1/2025",
    "end_date": "3/3/2025",
    "color": "#ee2233",
    "style": "rounded",
    "markers": ["3/3/2025"]
  },
  {
    "start_date": "3/14/2025",
    "end_date": "3/15/2025",
    "style": "filled",
    "markers": ["3/14/2025", "3/15/2025"]
  }
]

Supported style values are filled, rounded, and diagonal. Use markers to draw green marker indicators on specific dates within the event range, or use marker-only events when you only want calendar annotations.

Legacy list-based events are still supported for backward compatibility and are documented in docs/events.md.

Documentation

Additional docs:

Metadata

Release files for drawcal 0.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for drawcal 0.6.1
File Size Uploaded
drawcal-0.6.1.tar.gz 554.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for drawcal 0.6.1
File Interpreter ABI Platform
drawcal-0.6.1-py3-none-any.whl Python 3 none any Details

Total release size: 1.1 MB

Release files / drawcal-0.6.1.tar.gz

Download URL drawcal-0.6.1.tar.gz
Size 554.7 kB
Tags Source
SHA-256 checksum
How to use checksums
a73f032c7ac610dee00b0b3866a109e2af598e3b06dcfa3d37daa264a685b75a
BLAKE2b-256 checksum
How to use checksums
c30163dbe31c9bf533dae0b892008c64113b4162cb25c375b0100c833bccdca4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.8.10

Release files / drawcal-0.6.1-py3-none-any.whl

Download URL drawcal-0.6.1-py3-none-any.whl
Size 556.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e067a26a80e3d88251cca65f33c8aa28a83819ba86428f2d7ea996aeb76fc49d
BLAKE2b-256 checksum
How to use checksums
6a43d8f95772f8608867147455410521aaeb5df666c99c8e14fd04ce94d84807
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.8.10

Release history Release notifications | RSS feed

This release

0.6.1 This release

2 release files

0.6.0

2 release files

0.5.9

2 release files

0.5.8

2 release files

0.0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page