Search code, repositories, users, issues, pull requests...

To view the changes, please see the Changelog. This release can be installed from PyPI.

`v6.3.1`

Bug fixes:

Remove forced quoting from parameters with space and single quote. See Issue 836 <https://github.com/collective/icalendar/issues/836>_.

`v6.3.0`

Minor changes:

Deprecate icalendar.UIDGenerator. See Issue 816 <https://github.com/collective/icalendar/issues/816>_.

New features:

Add the uid property to Alarm, Event, Calendar, Todo, and Journal components. See Issue 740 <https://github.com/collective/icalendar/issues/740>_.

Bug fixes:

Fix component equality where timezones differ for the datetimes but the times are actually equal. See Issue 828 <https://github.com/collective/icalendar/issues/828>_.
Test that we can add an RRULE as a string. See Issue 301 <https://github.com/collective/icalendar/issues/301>_.
Test that we support dateutil timezones as outlined in Issue 336 <https://github.com/collective/icalendar/issues/336>_.
Build documentation on Read the Docs with the version identifier. See Issue 826 <https://github.com/collective/icalendar/issues/826>_.

`v6.2.0`

Minor changes:

Use ruff to format the source code.
Update project metadata to use License-Expression.
Use tzp.localize(dt, None) to remove the timezone from a datetime.
Remove the HTML documentation when building with tox to force rebuild.
Switch to PyData Sphinx Theme for documentation. See Issue 803 <https://github.com/collective/icalendar/issues/804>_.

New features:

Add getters rrules, rdates, and exdates for unified and simple access to these properties. See Discussion 662_.
Add attributes to the calendar for properties NAME, DESCRIPTION, and COLOR. See Issue 655 <https://github.com/collective/icalendar/issues/655>_.
Add a color attribute to Event, Todo, and Journal components. See Issue 655_.
Add sequence attribute to Event, Todo, and Journal components. See Issue 802 <https://github.com/collective/icalendar/issues/802>_.
Add categories attribute to Calendar, Event, Todo, and Journal components. See Issue 655 <https://github.com/collective/icalendar/issues/655>_.
Add compatibility to :rfc:6868. See Issue 652 <https://github.com/collective/icalendar/issues/652>_.
Add freebusy property to the Calendar to get this type of subcomponents easier.
Add parameters from :rfc:5545 to properties ALTREP, CN, CUTYPE, DELEGATED_FROM, DELEGATED_TO, DIR, FBTYPE, LANGUAGE, MEMBER, PARTSTAT, RANGE, RELATED, ROLE, RSVP, SENT_BY, TZID, and RELTYPE. See Issue 798 <https://github.com/collective/icalendar/issues/798>_.
New properties from :rfc:7986 can occur multiple times in VCALENDAR. See PR 808_.

Bug fixes:

Fix STANDARD and DAYLIGHT components that have a date as DTSTART. See Issue 218 <https://github.com/collective/icalendar/issues/218>_
Move import at the end of icalendar.parser into a function to mitigate import errors, see Issue 781 <https://github.com/collective/icalendar/issues/781>_.
ALTREP, DELEGATED-FROM, DELEGATED-TO, DIR, MEMBER, and SENT-BY require double quotes. These are now always added.
Classify CATEGORIES as multiple in VEVENT. See PR 808 <https://github.com/collective/icalendar/pull/808>_.

`v6.1.3`

Bug fixes:

Fix to permit TZID forward references to VTIMEZONE\ s
Stabelize timezone id lookup, see Issue 780 <https://github.com/collective/icalendar/issues/780>_.

`v6.1.2`

Minor changes:

Add funding link to Tidelift.
Link to related package.
Shorten first example in documentation.
Add name and email properties to vCalAddress.
Add type hint for property params in icalendar.prop.
Set default value for params as params={} in mulitple constructors in icalendar.prop to improve usability.
Improve object initialization performance in icalendar.prop.
Add type hint for params in multiple constructors in icalendar.prop.

Bug fixes:

Restrict timezones tested, see Issue 763 <https://github.com/collective/icalendar/issues/763>_

`v6.1.1`

Minor changes:

Add a weekday attribute to :class:icalendar.prop.vWeekday components. See Issue 749 <https://github.com/collective/icalendar/issues/749>_.
Document :class:icalendar.prop.vRecur property. See Issue 758 <https://github.com/collective/icalendar/issues/758>_.
Print failure of doctest to aid debugging.
Improve documentation of :class:icalendar.prop.vGeo
Fix tests, improve code readability, fix typing. See Pull request 766 <https://github.com/collective/icalendar/pull/766>_ and Pull request 765 <https://github.com/collective/icalendar/pull/765>_.

Breaking changes:

The relative attribute of vWeekday components has the correct sign now. See Issue 749 <https://github.com/collective/icalendar/issues/749>_.

New features:

Add Security Policy <https://github.com/collective/icalendar/blob/main/SECURITY.md>_
Python types in documentation now link to their documentation pages using intersphinx.

`v6.1.0`

Minor changes:

Add end, start, duration, DTSTART, DUE, and DURATION attributes to Todo components. See Discussion 662_.
Add DTSTART, TZOFFSETTO and TZOFFSETFROM properties to TimezoneStandard and TimezoneDaylight. See Discussion 662_.
Format test code with Ruff. See Issue 672 <https://github.com/collective/icalendar/issues/672>_.
Document the Debian package. See Issue 701 <https://github.com/collective/icalendar/issues/701>_.
Document vDatetime.from_ical
Allow passing a datetime.date to TZP.localize_utc and TZP.localize methods.
Document component classes with description from :rfc:5545.
Merge "File Structure" and "Overview" sections in the docs. See Issue 626 <https://github.com/collective/icalendar/issues/626>_.
Update code blocks in usage.rst with the correct lexer.
Tidy up the docstring for icalendar.prop.vPeriod.
Improve typing and fix typing issues

New features:

Add VALARM properties for :rfc:9074. See Issue 657 <https://github.com/collective/icalendar/issues/657>_
Test compatibility with Python 3.13
Add Timezone.from_tzinfo() and Timezone.from_tzid() to create a Timezone component from a datetime.tzinfo timezone. See Issue 722_.
Add icalendar.prop.tzid_from_tzinfo.
Add icalendar.alarms module to calculate alarm times. See Issue 716 <https://github.com/collective/icalendar/issues/716>_.
Add Event.alarms and Todo.alarms to access alarm calculation.
Add Component.DTSTAMP and Component.LAST_MODIFIED properties for datetime in UTC.
Add Component.is_thunderbird() to check if the component uses custom properties by Thunderbird.
Add X_MOZ_SNOOZE_TIME and X_MOZ_LASTACK properties to Event and Todo.
Add Alarm.ACKNOWLEDGED, Alarm.TRIGGER, Alarm.REPEAT, and Alarm.DURATION properties
as well as Alarm.triggers to calculate alarm triggers.
Add __doc__ string documentation for vDate, vBoolean, vCalAddress, vDuration, vFloat, vGeo, vInt, vPeriod, vTime, vUTCOffset and vUri. See Issue 742 <https://github.com/collective/icalendar/issues/742>_.
Add DTSTART, TZOFFSETTO, and TZOFFSETFROM to TimezoneStandard and TimezoneDaylight
Use example methods of components without arguments.
Add events, timezones, and todos property to Calendar for nicer access.
To calculate which timezones are in use and add them to the Calendar when needed these methods are added: get_used_tzids, get_missing_tzids, and add_missing_timezones().
Identify the TZID of more timezones from dateutil.
Identify totally unknown timezones using a UTC offset lookup tree generated in icalendar.timezone.equivalent_timezone_ids and stored in icalendar.timezone.equivalent_timezone_ids.
Add icalendar.timezone.tzid to identify a timezone's TZID.

Bug fixes:

Add icalendar.timezone to the documentation.

.. _Issue 722: #722

`v6.0.1`

New features:

Added end, start, duration, DTSTART, DUE, and DURATION attributes to Event components. See Discussion 662_.
Added end, start, duration, and DTSTART attributes to Journal components. See Discussion 662_.

Bug fixes:

Fix a few __all__ variables.
Added missing docs folder to distribution packages. See Issue 712 <https://github.com/collective/icalendar/issues/712>_.

.. _Discussion 662: https://redirect.github.com/collective/icalendar/discussions/662

`v6.0.0`

Minor changes:

Add __all__ variable to each modules in icalendar package
Improve test coverage.
Adapt test_with_doctest.py to correctly run on Windows.
Measure branch coverage when running tests.
Export Component base class for typing

New features:

Use pyproject.toml file instead of setup.py

Bug fixes:

Fix link to stable release of tox in documentation.
Fix a bad bytes replace in unescape_char.
Handle ValueError in vBinary.from_ical.
Ignore the BOM character in incorrectly encoded ics files.

`v5.0.14`

Minor changes


- Add PyData Theme version switcher to documentation. See `Issue 825`_.

4.1.2 (2025-11-03)
------------------

Minor changes

Add PyData Theme version switcher to documentation. See Issue 825_.

`v5.0.13`

Minor changes:

Guide to delete the build folder before running tests
Add funding information
Make documentation build with Python 3.12
Update windows to olson conversion for Greenland Standard Time
Extend examples in Usage with alarm and recurrence
Document how to serve the built documentation to view with the browser
Improve test coverage

New features:

Create GitHub releases for each tag.

Bug fixes:

Parse calendars with X-COMMENT properties at the end the file by ignoring these properites

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

If you want to rebase/retry this PR, check this box

This PR was generated by Mend Renovate. View the repository job log.

sonarqubecloud · 2025-01-19T09:04:16Z

Quality Gate passed

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

sonarqubecloud · 2025-03-28T12:04:13Z

Quality Gate passed

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

sonarqubecloud · 2025-05-20T13:34:52Z

Quality Gate passed

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

sonarqubecloud · 2025-08-24T14:09:58Z

Quality Gate passed

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

sonarqubecloud · 2025-11-10T13:52:21Z

Quality Gate passed

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code