v4.0

What's Changed

• package the API source as a composer library for autoload functionality
• move the endpoints from PHP scripts to resource paths, and create a router
• add YAML as a response media type
• use JSON resource files for the Tests server in place of PHP Unit defs (remove dependency on PHP Unit)
• fix bug where liturgical commons were not getting localized correctly
• fix XML response, implement XML and ICS validation
• update the OpenAPI schema
• add timing to response output and to response headers
• refactor responses to use snake_case properties and collections (this also fixes SaintAndrewAp bug for year_type=LITURGICAL in year=2023, see issue #249)
• add Calendars for Netherlands and for Canada, kudos to Steven van Roode and to Fr. @chrissherren for the contributions
• add a Dockerfile to easily spin up a Docker container with a local instance of the API
• fix for cases in which Immaculate Heart of Mary is suppressed, see commit 6f16f13
• fix calculation of weekdays between Epiphany and Baptism of the Lord, see issue #237
• fix Chritmas weekdays should not be created when there is an obligatory memorial, see commit a8ca477
• fix moving of celebrations by a National Calendar that were suppressed in the General Roman Calendar, see issue #271
• add abbreviated form of the liturgical rank / grade to the Festivity output, see issue #251
• use ISO 3166-1 Alpha-2 codes to identify nations, see issue #231
• created an interface that allows to create Unit Tests, see issue #205
• added an index of all dioceses of Latin rite, kudos to Gabriel Chow of gcatholic.org for the contribution
• add Decree of the Congregation for Divine Worship for Italy: Immaculate Heart suppresses 2nd Sunday of Advent, see commit 191d324
• add Decree of the Congregation for Divine Worship for Italy: Saint Nicholas obligatory memorial since 2020, see issue #248
• feature: discoverability of supported locales, see issue #240
• feature: all national and diocesan calendars are now multilingual by default, see issue #150
• and a number of other bugfixes, features, and improvements

Full Changelog: v3.9...v4.0

Version 3.9

• update PHP dependencies (swaggest/json-schema, phpunit/phpunit)
• add swagger validation badge to README
• remove deprecated LitLocale enums
• better locale handling (implement Locale::getPrimaryLanguage, simplify locale validity check, fix Locale class letter case )
• fix: wrong liturgical color for feast of Our Lord Jesus Christ King of the Universe
• add liturgicalSeason to Festivity output, and DateTime and Timestamp to the Metadata output
• remove unneeded request headers from Metadata output
• avoid defining year cycle for holy week and octave easter
• make sure sat mem BVM only Ordinary Time
• add isVigilFor key to vigil Masses
• implement CalendarType with types LITURGICAL and CIVIL
• output Liturgical Calendar as default (from first Sunday of Advent until Saturday of the 34th Week of Ordinary Time)
• track timing of calculations or read operations for pre-calculated / cached calendars, and add headers to Response: add X-LitCal-ExecutionTime header, add X-LitCal-Startime and -Endtime headers, add X-LitCal-Generated header
• fix rank Dedication Lateran Basilica
• allow national calendars to adhere to Feast of Jesus Christ Eternal Hight Priest fix issue #96 enable Feast Eternal High Priest, update EternalHighPriest setting based on national calendar
• update schemas to account for new settings and new properties in response output

New Contributors

• @dependabot made their first contribution in #156

Full Changelog: v3.8...v3.9

Version 3.8

What's Changed

• Translations update from Weblate by @JohnRDOrazio in #148
• Translations update from Weblate by @JohnRDOrazio in #151
• Translations update from Weblate by @JohnRDOrazio in #153
• Development by @JohnRDOrazio in #154
• Development by @JohnRDOrazio in #155

Full Changelog: v3.7...v3.8

Version 3.7

• fix support for correct ordinal number spelling for any language
• fix "Year I", "Year II" references which should only concern weekdays of Ordinary Time
• fix: in cases where the diocesancalendar parameter was set, but the nationalcalendar parameter was not, the national calendar settings were not being picked up correctly
• fix for Netherlands national calendar data (Ascension on Thursday)

What's Changed

• Translations update from Weblate by @JohnRDOrazio in #144
• Translations update from Weblate by @JohnRDOrazio in #145
• Translations update from Weblate by @JohnRDOrazio in #146
• Prepare v3.7 by @JohnRDOrazio in #147

Full Changelog: v3.6...v3.7

Version 3.6

• allow Diocesan calendars to define mobile festivities
• allow Diocesan calendars to define untilYear properties for festivities that may have changes after a given year
• remove hardcoding of English and the 5 main European languages and allow for any possible language
• allow geographic locales, in order to better identify source data for a given national or diocesan calendar
• remove hardcoding of supported national calendars, and automate the scan for existing calendars

What's Changed

• Translations update from Weblate by @JohnRDOrazio in #137
• Translations update from Weblate by @JohnRDOrazio in #138
• Translations update from Weblate by @JohnRDOrazio in #139
• Translations update from Weblate by @JohnRDOrazio in #140
• Translations update from Weblate by @JohnRDOrazio in #141
• Translations update from Weblate by @JohnRDOrazio in #143
• Development for v3.6 by @JohnRDOrazio in #142

Full Changelog: v3.5...v3.6

Version 3.5

• Fixes days before / after Epiphany
• Adds Dutch translation for Netherlands, thanks to Steven van Roode

What's Changed

• Translations update from Weblate by @JohnRDOrazio in #121
• Translations update from Weblate by @JohnRDOrazio in #122
• Translations update from Weblate by @JohnRDOrazio in #125
• Translations update from Weblate by @JohnRDOrazio in #126
• Development by @JohnRDOrazio in #127
• Translations update from Weblate by @JohnRDOrazio in #128
• Translations update from Weblate by @JohnRDOrazio in #130
• Translations update from Weblate by @JohnRDOrazio in #131
• Translations update from Weblate by @JohnRDOrazio in #135
• Development by @JohnRDOrazio in #136

Full Changelog: v3.4...v3.5

Version 3.4

What's Changed

• Fix issue with Saint Vincent deacon in national calendar for USA c27289f
• simplify calculation of Vigil Masses 0afa39b
• add cache-control headers to the Metadata enpoint 3d77f60
• complete move from MySQL tables to JSON source files d9c7344
• add DiocesanGroups info to the Metadata endpoint a378f16
• move National Calendar data and Wider Region calendar data to JSON source files 1716486, 4e29877, 15f16c3, 5b27417, 1247b98, cdf8bdb, 62ad946, 7395ef4, e5d010f, 9ada5aa, c9646a6, 25aa01a, ea5beac, b81b868, a837f7b, 7e9e894, 4d1eca2, e86ccda, 445d22c, a0e693f,
• add cache-control headers to the Main endpoint d2ae04d and df7e17d
• add WiderRegions info to the Metadata endpoint b3f567f
• add methods to FestivityCollection a9e1760
• add year limits to Roman Missals 0f939ba
• fix enum validations 4c595c1, c3d2492
• various fixes 8330fa0, 6cf80da, a7e85de, 4e0a597, 8ee7065, 44df76f, 5638ec6, 4f7c11f, 4decc12, 5450010, e2c1f6c, fcb1108, ec772a0, d804c7e, a52019e, 8eadab7
• add Roman Missal info to the Metadata endpoint 715c28a
• output 404 error for unavailable resources 0bcbd3b
• define JSON schemas b66f4d2, 0db16a7, 1574c01, a70f383, a9ac10e, bd2ba8b, fabf7b6, 8b8ae2a, 85066b8, 8a66bf4, 3f79b05, 5e82f30, 552eaa3, f682300, b48bb72, 289f4c2, 1245cfc, a4d8bc4, 1257b9b, baef32b, 09edca1, 228af9c
• create JSON schema validation 3938a27, 85702b0, a296cc5, 21f2540, 765bac9, 10d7619, 4828724, 9cbb8e6, 16809cb, a1de05c
• add more data for National Calendars to the Metadata endpoint 34ef54f
• update translations

Full Changelog: v3.3...v3.4

Version 3.3

What's Changed

• Translations update from Weblate by @JohnRDOrazio in #83
• Translations update from Weblate by @JohnRDOrazio in #84
• Translations update from Weblate by @JohnRDOrazio in #85
• Translations update from Weblate by @JohnRDOrazio in #86
• Translations update from Weblate by @JohnRDOrazio in #87
• Translations update from Weblate by @JohnRDOrazio in #89
• Translations update from Weblate by @JohnRDOrazio in #91
• Translations update from Weblate by @JohnRDOrazio in #93
• prepare v3.3 by @JohnRDOrazio in #92

Full Changelog: v3.2...v3.3

Version 3.2

What's Changed

• Translations update from Weblate by @JohnRDOrazio in #74
• Allow full CORS requests by @JohnRDOrazio in #79
• Allow diocesan overrides by @JohnRDOrazio in #80

Full Changelog: v3.1...v3.2

Version 3.1

• all calendar data moved from a MySQL database to JSON files, that can be tracked in the repository
• the Calendar data for the Universal Calendar, as contained in the JSON files, is now translatable to other languages through a Weblate project
• the frontend and any implementations of the API have been moved to their own separate repositories,
  only the API code remains in this repository
• the PHP source code for the API has been pretty much completely rewritten, using classes and enum type classes
• all translatable strings in the PHP source code have been ported to gettext, and are now managed in a Weblate project
• parameters diocesanpreset and nationalpreset have been renamed to diocesancalendar and nationalcalendar
• API now supports POST requests that send JSON in the body instead of Form Data
• Data type can be set through the Accept header rather than the returntype parameter
• Language can be set through the Accept-Language header rather than the locale parameter
• Same as tag/release v3.0 with the addition of a single typo fix, an enum that was in camelcase instead of uppercase. This bug was preventing iCal feeds from being generated correctly.