README.md

package-calendars

A proof of concept data about upstream release schedules of Fedora packages.

Each calendar has a yaml config file in the calendars directory. The yaml has several options.

  • ical_url: mandatory URL of the iCal
  • calendar_name: optional name of the calendar that the Dashboard will display if ical doesn't have X-WR-CALNAME
  • package_names: list if names of Fedora packages this calendar applies to
  • package_name_regex: a regular expression to match Fedora package names

Either package_name_regex or at least one name in package_names needs to be set. Calendars without packages are considered invalid. If both package_name_regex and package_names is set, the affected packages are considered as union.

Package names always mean the component (SRPM) name.

In case you want more fields, let us know. However any metadata about the calendars should be loaded from the iCals themselves.

Examples

A calendar for a single package:

ical_url: https://github.com/fedora-python/python-release-schedule-ical/raw/master/python-releases.ics
package_names:
- python3.10

A calendar for multiple packages:

ical_url: https://github.com/fedora-python/python-release-schedule-ical/raw/master/python-releases.ics
package_names:
- python3.8
- python3.9
- python3.10

A calendar without name specified in ical:

ical_url: https://www.gnome.org/start/unstable/schedule.ics
calendar_name: GNOME releases schedule
package_names:
- gnome-shell

A calendar for multiple packages matching a regular expression:

ical_url: https://github.com/fedora-python/python-release-schedule-ical/raw/master/python-releases.ics
package_name_regex: ^python3\.\d+$

A calendar that combines both:

ical_url: https://github.com/fedora-python/python-release-schedule-ical/raw/master/python-releases.ics
package_name_regex: ^python3\.\d+$
package_names:
- python3

Copyright

The data here is placed in the public domain or under the CC0-1.0-Universal license, whichever is more permissive.