Merge branch 'main' into main

pull/894/head
Nicco Kunzmann 2025-09-16 22:03:45 +02:00 zatwierdzone przez GitHub
commit 11c06c3102
Nie znaleziono w bazie danych klucza dla tego podpisu
ID klucza GPG: B5690EEEBB952194
9 zmienionych plików z 181 dodań i 94 usunięć

Wyświetl plik

@ -0,0 +1,21 @@
## Closes issue
Replace `ISSUE_NUMBER` with the issue number that your pull request fixes. Then GitHub will link and automatically close the related issue.
- [ ] Closes #ISSUE_NUMBER
## Description
Write a description of the fixes or improvements.
## Checklist
- [ ] I've added a change log entry to `CHANGES.rst`.
- [ ] I've added or updated tests if applicable.
- [ ] I've run and ensured all tests pass locally by following [Running Tests](https://icalendar.readthedocs.io/en/latest/install.html#running-tests).
- [ ] I've added or edited documentation, both as docstrings to be rendered in the API documentation and narrative documentation, as necessary.
- [ ] I've added myself to `docs/credits.rst` as a contributor in this pull request or have done so previously.
## Additional information
Upload screenshots, videos, links to documentation, or any other relevant information.

Wyświetl plik

@ -32,7 +32,7 @@ jobs:
steps:
- uses: actions/checkout@v5
- name: Set up Python
uses: actions/setup-python@v5
uses: actions/setup-python@v6
with:
python-version: ${{ matrix.config[0] }}
# for caching, see
@ -80,7 +80,7 @@ jobs:
steps:
- uses: actions/checkout@v5
- name: Set up Python
uses: actions/setup-python@v5
uses: actions/setup-python@v6
with:
python-version: "3.13"
- name: Install dependencies
@ -112,7 +112,7 @@ jobs:
steps:
- uses: actions/checkout@v5
- name: Set up Python
uses: actions/setup-python@v5
uses: actions/setup-python@v6
with:
python-version: "3.13"
- name: Install dependencies

Wyświetl plik

@ -27,6 +27,9 @@ Minor changes:
- Refactor ``set_duration`` methods in ``Event`` and ``Todo`` classes to eliminate code duplication by extracting common logic into shared ``set_duration_with_locking()`` function in ``icalendar.attr``. See `Issue 886 <https://github.com/collective/icalendar/issues/886>`_.
- Make coverage submission optional for CI
- Accept and ignore non-standard empty ``RDATE`` fields when parsing ICS files.
- Improve contributing documentation by adding a change log requirement, adding a pull request template, adding clear CI enforcement warnings, and updating ``README.rst``. See `Issue 890 <https://github.com/collective/icalendar/issues/890>`_.
- Make coverage submission optional for CI.
- Bump ``actions/setup-python`` version from 5 to 6 for CI.
Breaking changes:
@ -113,7 +116,7 @@ Bug fixes:
Bug fixes:
- Fix to permit TZID forward references to ``VTIMEZONE``s
- Fix to permit TZID forward references to ``VTIMEZONE``\ s
- Stabelize timezone id lookup, see `Issue 780 <https://github.com/collective/icalendar/issues/780>`_.
6.1.2 (2025-03-19)
@ -720,7 +723,7 @@ New features:
Bug fixes:
- Fix ``VTIMEZONE``s including RDATEs #234. [geier]
- Fix ``VTIMEZONE``\ s including RDATEs #234. [geier]
3.11.5 (2017-07-03)
@ -731,7 +734,7 @@ Bug fixes:
- added an assertion that ``VTIMEZONE`` sub-components' DTSTART must be of type
DATETIME [geier]
- Fix handling of ``VTIMEZONE``s with subcomponents with the same DTSTARTs and
- Fix handling of ``VTIMEZONE``\ s with subcomponents with the same DTSTARTs and
OFFSETs but which are of different types [geier]
@ -743,7 +746,7 @@ Bug fixes:
- Don't break on parameter values which contain equal signs, e.g. base64 encoded
binary data [geier]
- Fix handling of ``VTIMEZONE``s with subcomponents with the same DTSTARTs.
- Fix handling of ``VTIMEZONE``\ s with subcomponents with the same DTSTARTs.
[geier]

3
CONTRIBUTING.md 100644
Wyświetl plik

@ -0,0 +1,3 @@
# Contributing
See our [contributing guide](https://icalendar.readthedocs.io/en/latest/contributing.html) for complete information on how to contribute to icalendar.

Wyświetl plik

@ -1,31 +0,0 @@
You want to help and contribute? Perfect!
=========================================
These are some contribution examples
------------------------------------
- Reporting issues to the bugtracker.
- Submitting pull requests from a forked icalendar repo.
- Extending the documentation.
- Sponsor a Sprint (https://plone.org/events/sprints/whatis).
For pull requests, keep this in mind
------------------------------------
- Add a test which proves your fix and make it pass.
- Describe your change in ``CHANGES.rst``
- Add yourself to the ``docs/credits.rst``
Setup for Development
---------------------
If you would like to setup icalendar to
contribute changes, the `Installation Section
<https://icalendar.readthedocs.io/en/latest/install.html>`_
should help you further.

Wyświetl plik

@ -1,5 +1,60 @@
------------------
Contributing
------------------
============
.. include:: ../CONTRIBUTING.rst
This guide describes how to contribute to icalendar.
Examples of how to contribute
-----------------------------
- Report issues to the bugtracker.
- Submit pull requests from your fork of the icalendar repository.
- Extend the documentation.
- Sponsor development of icalendar through [Open Collective](https://opencollective.com/python-icalendar).
Pull request requirements
-------------------------
Before submitting your pull request, ensure you have met the following requirements.
#. Add a changelog entry to :file:`CHANGES.rst`.
This is required and enforced by CI.
See :ref:`change-log` for details.
#. Add a test which proves your fix and passes.
#. Run all tests to ensure your changes don't break any existing functionality.
#. Add or edit documentation, both as docstrings to be rendered in the API documentation and narrative documentation, as necessary.
#. Add yourself to :file:`docs/credits.rst`, if you haven't already done so.
.. _change-log:
Change log entry format
```````````````````````
Add your entry under the appropriate section in :file:`CHANGES.rst`.
Minor changes
For small improvements, refactoring, and documentation updates.
Breaking changes
For changes that break the existing API.
New features
For new functionality.
Bug fixes
For bug fixes and error corrections.
Example:
.. code-block:: rst
Minor changes:
- Fix issue with timezone parsing in special cases. See `Issue XXX <link>`_.
Set up for development
----------------------
If you would like to set up icalendar to contribute changes, :doc:`install` should help you further.

Wyświetl plik

@ -1,24 +1,66 @@
icalendar contributors
======================
Credits
=======
- Johannes Raggam <johannes@raggam.co.at> (Maintainer)
- Max M <maxm@mxm.dk> (Original author)
When you contribute to icalendar, please add your name to this list of contributors.
Please use the format of your public identity as either your name or GitHub username, followed by the URL to your GitHub profile.
Do not use an email address, as those may get harvested or become invalid in the future.
.. code-block:: rst
- GivenName Surname <https://github.com/github_username>_
- github_username <https://github.com/github_username>_
The following people have made contributions to icalendar.
We're grateful for their support.
Maintainers
-----------
- `@geier <https://github.com/geier>`_
- `@jacadzaca <https://github.com/jacadzaca>`_
- `Nicco Kunzmann <https://github.com/niccokunzmann>`_
Original author
---------------
- Max M <maxm@mxm.dk>
Contributors
------------
- Abe Hanoka <abe@habet.dev>
- Alexander Pitkin <peleccom@gmail.com>
- Andreas Zeidler <az@zitc.de>
- Andreas Ruppen <andreas.ruppen@gmail.com>
- Andrey Nikolaev <nikolaeff@gmail.com>
- Barak Michener <me@barakmich.com>
- Bastian Wegge <wegge@crossbow.de>
- Christian Geier <contact@lostpackets.de>
- Christophe de Vienne <cdevienne@gmail.com>
- cillianderoiste <cillian.deroiste@gmail.com>
- Clive Stevens <clivest2@gmail.com>
- Dai MIKURUBE <dmikurube@acm.org>
- Dalton Durst <github@daltondur.st>
- Dan Stovall <dbstovall@gmail.com>
- David Venhoff <https://github.com/david-venhoff>
- Eric Hanchrow <erich@cozi.com>
- Eric Wieser <wieser.eric@gmail.com>
- Erik Simmler <tgecho@gmail.com>
- Felix Stupp <felix.stupp@banananet.work>
- `fitnr <https://github.com/fitnr>`_
- George V. Reilly <george@reilly.org>
- hajdbo <boris@hajduk.org>
- ilya <ilya@boltnev-pc.(none)>
- Jannis Leidel <jannis@leidel.info>
- Jeffrey Whewhetu <jeffwhewhetu@gmail.com>
- Jeroen F.J. Laros <jlaros@fixedpoint.nl>
- Jeroen van Meeuwen (Kolab Systems) <vanmeeuwen@kolabsys.com>
- Jochen Sprickerhof <icalendar@jochen.sprickerhof.de>
- Johannes Raggam <johannes@raggam.co.at>
- Jordan Kiang <jordan@cozi.com>
- Kamil Mańkowski <kam193@wp.pl>
- Klaus Klein <kleink+github@kleink.org>
- Laurent Lasudry <lasudry@gmail.com>
- Lennart Regebro <lregebro@nuxeo.com>
@ -27,61 +69,55 @@ icalendar contributors
- Markus Unterwaditzer <markus@unterwaditzer.net>
- Martijn Faassen <faassen@infrae.com>
- Martin Melin <git@martinmelin.com>
- Matt Lewis <git@semiprime.com>
- Maurits van Rees <maurits@vanrees.org>
- Mauro Amico <mauro.amico@gmail.com>
- Michael Smith <msmith@fluendo.com>
- Michał Górny <mgorny@gentoo.org>
- Mikael Frykholm <mikael@frykholm.com>
- `Natasha Mattson <https://github.com/natashamm>`_
- `NikEasY <https://github.com/NikEasY>`_
- Olivier Grisel <ogrisel@nuxeo.com>
- Pavel Repin <prepin@gmail.com>
- Pedro Ferreira <jose.pedro.ferreira@cern.ch>
- Pronoy <lukex9442@gmail.com>
- Rembane <andeke@gmail.com>
- Robert Niederreiter <rnix@squarewave.at>
- Robert Spralja <robert.spralja@gmail.com>
- Rok Garbas <rok@garbas.si>
- Ronan Dunklau <ronan@dunklau.fr>
- Russ <russ@rw.id.au>
- `Sashank Bhamidi <https://github.com/SashankBhamidi>`_
- `Serif OZ <https://github.com/SerifOZ>`_
- Sidnei da Silva <sidnei@enfoldsystems.com>
- Simon Ruderich <simon@ruderich.org>
- `Soham Dutta <https://github.com/NP-compete>`_
- spanktar <spanky@kapanka.com>
- Stanislav Láznička <slaznick@redhat.com>
- Stanislav Ochotnicky <sochotnicky@redhat.com>
- Stefan Schwarzer <sschwarzer@sschwarzer.net>
- `Steve Piercy <https://github.com/stevepiercy>`_
- `Tariq <https://github.com/Horisyre>`_
- tgecho <tgecho@gmail.com>
- Thomas Bruederli <thomas@roundcube.net>
- Thomas Weißschuh <thomas@t-8ch.de>
- tisto <tisto@plone.org>
- Tobias Brox <tobias@redpill-linpro.com>
- TomTry <tom.try@gmail.com>
- Victor Varvaryuk <victor.varvariuc@gmail.com>
- Ville Skyttä <ville.skytta@iki.fi>
- Wichert Akkerman <wichert@wiggy.net>
- cillianderoiste <cillian.deroiste@gmail.com>
- fitnr <fitnr@fakeisthenewreal>
- hajdbo <boris@hajduk.org>
- ilya <ilya@boltnev-pc.(none)>
- spanktar <spanky@kapanka.com>
- tgecho <tgecho@gmail.com>
- tisto <tisto@plone.org>
- TomTry <tom.try@gmail.com>
- Andreas Ruppen <andreas.ruppen@gmail.com>
- Clive Stevens <clivest2@gmail.com>
- Dalton Durst <github@daltondur.st>
- Kamil Mańkowski <kam193@wp.pl>
- Tobias Brox <tobias@redpill-linpro.com>
- `Nicco Kunzmann <https://github.com/niccokunzmann>`_
- Robert Spralja <robert.spralja@gmail.com>
- Maurits van Rees <maurits@vanrees.org>
- jacadzaca <vitouejj@gmail.com>
- Mauro Amico <mauro.amico@gmail.com>
- Alexander Pitkin <peleccom@gmail.com>
- Michał Górny <mgorny@gentoo.org>
- Pronoy <lukex9442@gmail.com>
- Abe Hanoka <abe@habet.dev>
- `Natasha Mattson <https://github.com/natashamm>`_
- `NikEasY <https://github.com/NikEasY>`_
- Matt Lewis <git@semiprime.com>
- Felix Stupp <felix.stupp@banananet.work>
- Bastian Wegge <wegge@crossbow.de>
- `Steve Piercy <https://github.com/stevepiercy>`_
- Jeffrey Whewhetu <jeffwhewhetu@gmail.com>
- `Soham Dutta <https://github.com/NP-compete>`_
- `Serif OZ <https://github.com/SerifOZ>`_
- David Venhoff <https://github.com/david-venhoff>
- `Tariq <https://github.com/Horisyre>`_
Find out who contributed::
$ git shortlog -s -e
Complete list
-------------
Although this list might not be complete, as some contributors either didn't know that they could add their name to this file or didn't want to be added, you can find out who contributed to icalendar.
On GitHub, from the icalendar home page, click the link [Contributors](https://github.com/collective/icalendar/graphs/contributors).
Alternatively from your local git checkout, issue the following command, which prints a list of all contributors sorted by their name and commit email address, and the count of commits for each one.
.. code-block:: shell
git shortlog -s -e

Wyświetl plik

@ -4,17 +4,16 @@ Maintenance
The goal of this section is to make sure that the ``icalendar`` library receives a
clear maintenance structure with it that is transparent.
icalendar Maintainers
---------------------
Maintainers
-----------
Currently, the maintainers are
Currently the maintainers are the following people.
- `@geier <https://github.com/geier>`_
- `@jacadzaca <https://github.com/jacadzaca>`_
- `@niccokunzmann <https://github.com/niccokunzmann>`_
Maintainers need this:
Maintainers need the following.
- ``Admin`` access to the `repository <https://github.com/collective/icalendar>`_.
These can be enabled by a current maintainer or an GitHub organisation administrator

Wyświetl plik

@ -554,16 +554,17 @@ class Component(CaselessDict):
CREATED = single_utc_property(
"CREATED",
"""CREATED specifies the date and time that the calendar
information was created by the calendar user agent in the calendar
store.
"""
CREATED specifies the date and time that the calendar
information was created by the calendar user agent in the calendar
store.
Conformance:
The property can be specified once in "VEVENT",
"VTODO", or "VJOURNAL" calendar components. The value MUST be
specified as a date with UTC time.
""",
Conformance:
The property can be specified once in "VEVENT",
"VTODO", or "VJOURNAL" calendar components. The value MUST be
specified as a date with UTC time.
""",
)
_validate_new = True