v8.4.2

Compare Source

Released 2026-06-24

• Fix Fish shell completion broken in 8.4.0 by {pr}3126. Newlines and
  tabs in option help text are now escaped, keeping the original completion
  format while still supporting multi-line help. {issue}3502
  {issue}3043 {pr}3504 {pr}3508
• Deprecated commands and options with empty or missing help text no longer
  render a stray leading space before the (DEPRECATED) label. {pr}3509
• A {class}Group with invoke_without_command=True marks its subcommand as
  optional in the usage help, showing [COMMAND] instead of COMMAND.
  {issue}3059 {pr}3507
• echo_via_pager flushes after each write, so passing a generator streams
  output to the pager incrementally instead of staying hidden until the pipe
  buffer fills. {issue}3242 {issue}2542 {pr}3534
• echo_via_pager and get_pager_file no longer close a borrowed stdout
  stream when no external pager runs, completing the partial
  I/O operation on closed file fix from {pr}3482. {issue}3449
  {pr}3533
• Fix CLI usage symopsis for optional arguments producing double square brackets
  [[a|b|c]]... whose type already brackets their metavar. {pr}3578
• {func}version_option resolves a package_name that does not match an
  installed distribution as an import (top-level module) name via
  {func}importlib.metadata.packages_distributions. Packages whose
  top-level module name differs from their distribution name (PIL vs
  Pillow, jwt vs PyJWT) no longer raise RuntimeError out of the
  box. {issue}2331 {issue}1884 {issue}3125 {pr}3582

v8.4.1

Compare Source

Released 2026-05-21

• get_parameter_source() is available during eager callbacks and type
  conversion again. :issue:3458 :issue:3484
• Zsh completion scripts parse correctly on Windows. :issue:3277 :pr:3466
• Shell completion of Choice Enum values produces a valid completion
  result. :issue:3015
• Fix empty byte-string handling in echo. :issue:3487
• Fix closed file error with echo_via_pager. :issue:3449

v8.4.0

Compare Source

Released 2026-05-17

• :class:ParamType typing improvements. :pr:3371

  • :class:ParamType is now a generic abstract base class,
    parameterized by its converted value type.
  • :meth:~ParamType.convert return types are narrowed on all
    concrete types (str for :class:STRING, int for
    :class:INT, etc.).
  • :meth:~ParamType.to_info_dict returns specific
    :class:~typing.TypedDict subclasses instead of
    dict[str, Any].
  • :class:CompositeParamType and the number-range base are now
    generic with abstract methods.

• Refactor convert_type to extract type inference into a private
  _guess_type helper, and add :func:typing.overload signatures.
  :pr:3372

• :class:Parameter typing improvements. :pr:2805

  • :class:Parameter is now an abstract base class, making explicit
    that it cannot be instantiated directly.
  • :attr:Parameter.name is now str instead of str | None.
    When expose_value=False, the name is set to "" instead
    of None.
  • The ctx parameter of :meth:Parameter.get_error_hint is now
    typed as Context | None, matching the runtime behavior.

• Split string values from default_map for parameters with nargs > 1
  or :class:Tuple type, matching environment variable behavior.
  :issue:2745 :pr:3364

• Auto-detect type=UNPROCESSED for flag_value of non-basic types
  (not str, int, float, or bool), so programmer-provided
  Python objects like classes and enum members are passed through unchanged
  instead of being stringified. Previously type=click.UNPROCESSED had
  to be set explicitly. :issue:2012 :pr:3363

• The error hint now uses :meth:Command.get_help_option_names to pick
  non-shadowed help option names, so Try '... -h' no longer points to a
  subcommand option that shadows -h. The longest surviving name is
  shown (--help over -h) for readability. :issue:2790 :pr:3208

• Fix readline functionality on non-Windows platforms. Prompt text is now
  passed directly to readline instead of being printed separately, allowing
  proper backspace, line editing, and line wrapping behavior. :issue:2968
  :pr:2969

• Use :func:os.startfile on Windows to open URLs in :func:open_url,
  replacing the start built-in which cannot be invoked without
  shell=True. :issue:3164 :pr:3186

• Fix Fish shell completion errors when option help text contains newlines.
  :issue:3043 :pr:3126

• Add :class:NoSuchCommand exception with suggestions for misspelled
  commands. :issue:3107 :pr:3228

• Use :class:ValueError message when conversion in :class:FuncParamType would
  fail. :issue:3105 :pr:3211

• Add click.get_pager_file for file-like access to an output
  pager. :pr:1572 :pr:3405

• :func:~click.formatting.wrap_text now measures line width in visible
  characters, ignoring ANSI escape sequences. :pr:3420

• Fix :meth:HelpFormatter.write_usage emitting only a blank line when
  called without args. The usage prefix and program name are now
  written even when no arguments follow, and the trailing separator
  space is stripped so the line ends at the program name.
  :issue:3360 :pr:3434

• Show custom error messages from types when :func:prompt with
  hide_input=True fails validation, instead of always showing a
  generic message. Built-in type messages mask the input value.
  :issue:2809 :pr:3256

• Add capture parameter to :class:CliRunner with two modes: sys
  (default) and fd. fd redirects file descriptors 1 and 2
  via :func:os.dup2 so output that bypasses sys.stdout (stale stream
  references, C extensions, subprocesses, faulthandler) is captured
  with proper isolation. :issue:854 :issue:2412 :issue:2468
  :issue:2497 :issue:2761 :issue:2827 :issue:2865 :pr:3391

• Revert the 8.3.3 change that exposed the original file descriptor
  via fileno() on the redirected CliRunner streams in the default
  capture mode. os.dup2(w, sys.stdout.fileno()) calls inside a CLI no
  longer mutate the host runner's stdout, which broke Pytest's fd-level
  capture teardown. C-level consumers that need a real fd should use
  capture="fd". :issue:3384 :pr:3391

• Mark additional built-in strings with gettext() to extend translation
  coverage. :pr:2902

• Fix feature switch groups (several flag_value options sharing one
  parameter name) silently dropping an explicit default when a sibling
  option without an explicit default was declared first. Arbitration is now
  source-aware: a more explicit :class:ParameterSource always wins, and
  within ParameterSource.DEFAULT, an option that received an explicit
  default= keyword wins over a sibling whose default was auto-derived.
  The 8.3.x first-wins fallback for remaining ties was reverted to the
  pre-8.3.x last-wins fallback. :issue:3403 :pr:3404

• Fix missing space between option help text and the (DEPRECATED)
  label, and localize the option label so it matches the command label.
  The label and the DeprecationWarning reason suffix are now produced
  by shared helpers. :pr:3423

• Document short option stacking (-abc is parsed as -a -b -c) and
  clarify that multi-character short option names are not supported.
  :issue:2779 :pr:3431

v8.3.3

Compare Source

v8.3.2

Compare Source

Released 2026-04-02

• Fix handling of flag_value when is_flag=False to allow such options to be
  used without an explicit value. :issue:3084 :pr:3152
• Hide Sentinel.UNSET values as None when using lookup_default().
  :issue:3136 :pr:3199 :pr:3202 :pr:3209 :pr:3212 :pr:3224
• Prevent _NamedTextIOWrapper from closing streams owned by StreamMixer.
  :issue:824 :issue:2991 :issue:2993 :issue:3110 :pr:3139 :pr:3140
• Add comprehensive tests for CliRunner stream lifecycle, covering
  logging interaction, multi-threaded safety, and sequential invocation
  isolation. Add high-iteration stress tests behind a stress marker
  with a dedicated CI job. :pr:3139
• Fix callable flag_value being instantiated when used as a default via
  default=True. :issue:3121 :pr:3201 :pr:3213 :pr:3225

v8.3.1

Compare Source

This is the Click 8.3.1 fix release, which fixes bugs but does not otherwise change behavior and should not result in breaking changes compared to the latest feature release.

PyPI: https://pypi.org/project/click/8.3.1/
Changes: https://click.palletsprojects.com/page/changes/#version-8-3-1
Milestone: https://github.com/pallets/click/milestone/28

• Don't discard pager arguments by correctly using subprocess.Popen. #​3039 #​3055
• Replace Sentinel.UNSET default values by None as they're passed through the Context.invoke() method. #​3066 #​3065 #​3068
• Fix conversion of Sentinel.UNSET happening too early, which caused incorrect behavior for multiple parameters using the same name. #​3071 #​3079
• Fix rendering when prompt and confirm parameter prompt_suffix is empty. #​3019 #​3021
• When Sentinel.UNSET is found during parsing, it will skip calls to type_cast_value. #​3069 #​3090
• Hide Sentinel.UNSET values as None when looking up for other parameters through the context inside parameter callbacks. #​3136 #​3137

v8.3.0

Compare Source

Released 2025-09-17

• Improved flag option handling: Reworked the relationship between flag_value
  and default parameters for better consistency:

  • The default parameter value is now preserved as-is and passed directly
    to CLI functions (no more unexpected transformations)
  • Exception: flag options with default=True maintain backward compatibility
    by defaulting to their flag_value
  • The default parameter can now be any type (bool, None, etc.)
  • Fixes inconsistencies reported in: :issue:1992 :issue:2514 :issue:2610
    :issue:3024 :pr:3030

• Allow default to be set on Argument for nargs = -1. :issue:2164
  :pr:3030

• Show correct auto complete value for nargs option in combination with flag
  option :issue:2813

• Fix handling of quoted and escaped parameters in Fish autocompletion. :issue:2995 :pr:3013

• Lazily import shutil. :pr:3023

• Properly forward exception information to resources registered with
  click.core.Context.with_resource(). :issue:2447 :pr:3058

• Fix regression related to EOF handling in CliRunner. :issue:2939 :pr:2940

v8.2.2

Compare Source

Released 2025-07-31

• Fix reconciliation of default, flag_value and type parameters for
  flag options, as well as parsing and normalization of environment variables.
  :issue:2952 :pr:2956
• Fix typing issue in BadParameter and MissingParameter exceptions for the
  parameter param_hint that did not allow for a sequence of string where the
  underlying function _join_param_hints allows for it. :issue:2777 :pr:2990
• Use the value of Enum choices to render their default value in help
  screen. Refs :issue:2911 :pr:3004
• Fix completion for the Z shell (zsh) for completion items containing
  colons. :issue:2703 :pr:2846
• Don't include envvar in error hint when not configured. :issue:2971 :pr:2972
• Fix a rare race in click.testing.StreamMixer's finalization that manifested
  as a ValueError on close in a multi-threaded test session.
  :issue:2993 :pr:2991

v8.2.1

Compare Source

Released 2025-05-20

• Fix flag value handling for flag options with a provided type. :issue:2894
  :issue:2897 :pr:2930
• Fix shell completion for nested groups. :issue:2906 :pr:2907
• Flush sys.stderr at the end of CliRunner.invoke. :issue:2682
• Fix EOF handling for stdin input in CliRunner. :issue:2787

v8.2.0

Compare Source

Released 2025-05-10

• Drop support for Python 3.7, 3.8, and 3.9. :pr:2588 :pr:2893

• Use modern packaging metadata with pyproject.toml instead of setup.cfg.
  :pr:2438

• Use flit_core instead of setuptools as build backend. :pr:2543

• Deprecate the __version__ attribute. Use feature detection, or
  importlib.metadata.version("click"), instead. :issue:2598

• BaseCommand is deprecated. Command is the base class for all
  commands. :issue:2589

• MultiCommand is deprecated. Group is the base class for all group
  commands. :issue:2590

• The current parser and related classes and methods, are deprecated.
  :issue:2205

  • OptionParser and the parser module, which is a modified copy of
    optparse in the standard library.
  • Context.protected_args is unneeded. Context.args contains any
    remaining arguments while parsing.
  • Parameter.add_to_parser (on both Argument and Option) is
    unneeded. Parsing works directly without building a separate parser.
  • split_arg_string is moved from parser to shell_completion.

• Enable deferred evaluation of annotations with
  from __future__ import annotations. :pr:2270

• When generating a command's name from a decorated function's name, the
  suffixes _command, _cmd, _group, and _grp are removed.
  :issue:2322

• Show the types.ParamType.name for types.Choice options within
  --help message if show_choices=False is specified.
  :issue:2356

• Do not display default values in prompts when Option.show_default is
  False. :pr:2509

• Add get_help_extra method on Option to fetch the generated extra
  items used in get_help_record to render help text. :issue:2516
  :pr:2517

• Keep stdout and stderr streams independent in CliRunner. Always
  collect stderr output and never raise an exception. Add a new
  output stream to simulate what the user sees in its terminal. Removes
  the mix_stderr parameter in CliRunner. :issue:2522 :pr:2523

• Option.show_envvar now also shows environment variable in error messages.
  :issue:2695 :pr:2696

• Context.close will be called on exit. This results in all
  Context.call_on_close callbacks and context managers added via
  Context.with_resource to be closed on exit as well. :pr:2680

• Add ProgressBar(hidden: bool) to allow hiding the progressbar. :issue:2609

• A UserWarning will be shown when multiple parameters attempt to use the
  same name. :issue:2396

• When using Option.envvar with Option.flag_value, the flag_value
  will always be used instead of the value of the environment variable.
  :issue:2746 :pr:2788

• Add Choice.get_invalid_choice_message method for customizing the
  invalid choice message. :issue:2621 :pr:2622

• If help is shown because no_args_is_help is enabled (defaults to True
  for groups, False for commands), the exit code is 2 instead of 0.
  :issue:1489 :pr:1489

• Contexts created during shell completion are closed properly, fixing
  a ResourceWarning when using click.File. :issue:2644 :pr:2800
  :pr:2767

• click.edit(filename) now supports passing an iterable of filenames in
  case the editor supports editing multiple files at once. Its return type
  is now also typed: AnyStr if text is passed, otherwise None.
  :issue:2067 :pr:2068

• Specialized typing of progressbar(length=...) as ProgressBar[int].
  :pr:2630

• Improve echo_via_pager behaviour in face of errors.
  :issue:2674

  • Terminate the pager in case a generator passed to echo_via_pager
    raises an exception.
  • Ensure to always close the pipe to the pager process and wait for it
    to terminate.
  • echo_via_pager will not ignore KeyboardInterrupt anymore. This
    allows the user to search for future output of the generator when
    using less and then aborting the program using ctrl-c.

• deprecated: bool | str can now be used on options and arguments. This
  previously was only available for Command. The message can now also be
  customised by using a str instead of a bool. :issue:2263 :pr:2271

  • Command.deprecated formatting in --help changed from
    (Deprecated) help to help (DEPRECATED).
  • Parameters cannot be required nor prompted or an error is raised.
  • A warning will be printed when something deprecated is used.

• Add a catch_exceptions parameter to CliRunner. If
  catch_exceptions is not passed to CliRunner.invoke, the value
  from CliRunner is used. :issue:2817 :pr:2818

• Option.flag_value will no longer have a default value set based on
  Option.default if Option.is_flag is False. This results in
  Option.default not needing to implement __bool__. :pr:2829

• Incorrect click.edit typing has been corrected. :pr:2804

• Choice is now generic and supports any iterable value.
  This allows you to use enums and other non-str values. :pr:2796
  :issue:605

• Fix setup of help option's defaults when using a custom class on its
  decorator. Removes HelpOption. :issue:2832 :pr:2840

v0.101

Compare Source

Released July 20, 2026

• Add SIX Swiss Exchange (SIX) holidays (#​3692 by @​pareshjoshij)
• Add Toronto Stock Exchange (TSX) holidays (#​3680 by @​pareshjoshij, @​KJhellico)
• Update Canada holidays: add observed rule for National Day for Truth and Reconciliation in BC (#​3695 by @​uttam12331)
• Update Canada holidays: update Ontario (ON) holidays (#​3689 by @​KJhellico)
• Update Kazakhstan holidays: 2026 constitutional law changes (#​3690 by @​stetat)
• Update Monaco holidays (#​3678 by @​KJhellico)
• Update PR template (#​3707 by @​KJhellico)
• Update HolidayBase::get_closest_holiday method (#​3651 by @​gaoflow, @​KJhellico)
• Update iCalendar generation tool: add output filename template support (#​3679 by @​KJhellico)
• Update l10n: synchronize Hindi and Gujarati translations (#​3681 by @​pareshjoshij)

v0.100

Compare Source

Released July 6, 2026

• Refactor Zambia holidays and tests (#​3635 by @​PPsyrius)
• Add Chicago Mercantile Exchange (XCME) holidays (#​3617 by @​pareshjoshij, @​arkid15r, @​KJhellico)
• Add Bolsa Mexicana de Valores (BMV) holidays (#​3639 by @​pareshjoshij)
• Change standard name of "Whit Sunday" holiday to "Pentecost" (#​3657 by @​KJhellico)
• Update India holidays: national holidays significant improvement (#​3578 by @​ankushhKapoor)
• Update Saudi Arabia holidays (#​3624 by @​pareshjoshij)
• Update Singapore holidays: add 2027 public holidays (#​3632 by @​PPsyrius)
• Update calendar download page (#​3626 by @​pareshjoshij)
• Update documentation: enhance iCalendar export examples (#​3641 by @​davidhedlund, @​KJhellico)
• Update iCalendar generation tool (#​3640 by @​KJhellico)
• Update some holidays Ukrainian translations (#​3667 by @​KJhellico)
• Migrate Malawi tests to new test case standards (#​3633 by @​VaishnaviBardapure)
• Migrate Mexico tests to new test case standards (#​3648 by @​VaishnaviBardapure, @​KJhellico)
• Migrate Norway tests to new test case standards (#​3671 by @​eeshsaxena)
• Migrate Zimbabwe tests to new test case standards (#​3653 by @​eeshsaxena)

v0.99

Compare Source

Released June 15, 2026

• Refactor Australia holidays and tests (#​3623 by @​KJhellico)
• Refactor holiday names translation (#​3606 by @​KJhellico)
• Fix documentation tests (#​3612 by @​KJhellico)
• Update .py files formatting (#​3622 by @​KJhellico)
• Update Algeria holidays: add Kabyle language support (#​3507 by @​shaonahamed0, @​mhamedmok404, @​PPsyrius)
• Update Bangladesh holidays, improve Islamic calendar (#​3599 by @​KJhellico)
• Update Colombia holidays: add new Jul 9 holiday (#​3607 by @​healarconr, @​arkid15r)
• Update Indonesia holidays: add 2026 special holidays (#​3604 by @​KJhellico)
• Update Maldives holidays: add l10n support (#​3605 by @​aadesh-shrivastava)
• Update United States holidays: fix special holiday names with format labels (#​3618 by @​KJhellico)
• Update XNYS holidays: add l10n support (#​3600 by @​pareshjoshij)
• Update assets generation and processing (#​3598 by @​KJhellico)
• Update pre-commit config (#​3619 by @​KJhellico, @​arkid15r)
• Add CLI tool for generating iCalendar (.ics) files (#​3593 by @​KJhellico, @​Ebed-Iberico)
• Migrate Mozambique tests to new test case standards (#​3621 by @​VaishnaviBardapure)

v0.98

Compare Source

Released June 1, 2026

• Add NASDAQ (XNAS) holidays (#​3586 by @​pareshjoshij)
• Update United Arab Emirates holidays: fix Thai localization (#​3596 by @​KJhellico)
• Update Bhutan holidays (#​3590 by @​KJhellico)
• Update l10n test: check .po files for missing entries comments (#​3594 by @​KJhellico)
• Add 2025-2026 Islamic holidays exact dates for Indonesia and Philippines (#​3591 by @​akshiDhi)
• Add Tibetan calendar generator (#​3330 by @​Abiram08, @​KJhellico)
• Add pre-commit cache (#​3589 by @​arkid15r)

v0.97

Compare Source

Released May 18, 2026

• Refactor calendar generators (#​3565 by @​KJhellico)
• Update Bangladesh holidays: add Islamic holidays (#​3531 by @​shaonahamed0, @​KJhellico, @​PPsyrius)
• Update CI/CD workflows: set default Python and uv versions (#​3581 by @​KJhellico)
• Update China holidays: update official reference links (#​3569 by @​nuomi1)
• Update European Central Bank holidays: correct historical closures for 1999-2001 (#​3572 by @​pareshjoshij)
• Update India holidays: add Maharishi Valmiki Jayanti holiday (#​3485 by @​vanshika05-ai, @​KJhellico)
• Update Islamic generator: add support for holidays of "n-th weekday of Hijri month" type (#​3573 by @​KJhellico)
• Update Makefile and make script (#​3582 by @​KJhellico)
• Update Nepal holidays: add Kannada language support (#​3560 by @​Poornesh-codes, @​KJhellico)
• Update PO generator: fix .po files refresh (#​3570 by @​KJhellico)
• Update HolidayBase::__repr__ method (#​3575 by @​KJhellico)

v0.96

Compare Source

Released May 4, 2026

• Add static type checking support for countries and financial aliases (#​3549 by @​PPsyrius, @​arkid15r)
• Refactor India holidays testcases (#​3524 by @​PPsyrius, @​arkid15r)
• Update .po files generator: use git user identity for "Last-Translator" field (#​3553 by @​KJhellico)
• Update Arabic localization: fix "estimated" and "observed" labels translation (#​3551 by @​dimssu)
• Update Brazil holidays (#​3558 by @​KJhellico)
• Update Germany holidays: add school holidays support (#​3533 by @​dtretyakov, @​arkid15r)
• Update Mongolia holidays (#​3532 by @​KJhellico, @​arkid15r)
• Update Nepal holidays: fix some holiday names (#​3545 by @​Ritik-tech731)
• Update Switzerland holidays: split Zürich canton and city holidays (#​3548 by @​PPsyrius)
• Update United States holidays: fix Georgia's State Holiday observance (#​3557 by @​PPsyrius)
• Add pinned version comment after GitHub Actions Commit Hashes (#​3554 by @​PPsyrius, @​arkid15r)
• Pre-Commit Check for Normalized Unicode (#​3544 by @​PPsyrius)
• Scope Warning handling in tests to DeprecationWarning (#​3541 by @​PPsyrius)

v0.95

Compare Source

Released April 20, 2026

• Refactor PO generator for robust metadata and improved class discovery (#​3204 by @​pareshjoshij, @​arkid15r, @​KJhellico, @​PPsyrius)
• Refactor conditional logic using structural pattern matching (PEP 636) (#​3518 by @​PPsyrius)
• Fix typography: replace U+2019 with "'" and U+2013 with '-' (#​3539 by @​KJhellico)
• Update .pre-commit-config.yaml: use SHA for versions (#​3516 by @​arkid15r)
• Update Austria holidays (#​3513 by @​PPsyrius, @​arkid15r)
• Update Bhutan holidays: add l10n support (#​3389 by @​Devika9705)
• Update Egypt holidays: add Eid al-Fitr 2026 exact date (#​3474 by @​aziamimoh, @​PPsyrius)
• Update Hebrew calendar generator (#​3512 by @​KJhellico)
• Update India holidays: add Bonalu holiday in Telangana (TS) (#​3426 by @​Vikash-Kumar-23, @​arkid15r)
• Update India holidays: change 2026 Holi date in Maharashtra (MH) (#​3379 by @​Devika9705, @​KJhellico, @​PPsyrius)
• Update India holidays: improve Tamil translations (#​3437 by @​2024yuva, @​KJhellico, @​PPsyrius)
• Update India holidays: update Andaman and Nicobar Islands (AN) holidays (#​3476 by @​Saahi30, @​KJhellico, @​PPsyrius)
• Update National Stock Exchange of India holidays: correct Hindi translations for some holidays (#​3457 by @​Ritik-tech731, @​KJhellico)
• Update Romania holidays (#​3526 by @​KJhellico)
• Update documentation: surface API for ObservedHolidayBase and NoHolidayBase (#​3511 by @​PPsyrius, @​arkid15r)
• Update languages list in site assets generator (#​3540 by @​KJhellico)
• Add tests for site assets generator (#​3543 by @​KJhellico)
• Standardize and fix docstring references (#​3509 by @​PPsyrius, @​arkid15r)

v0.94

Compare Source

Released April 6, 2026

• Refactor WM archiver script (#​3356 by @​KJhellico)
• Add Hong Kong Stock Exchange holidays (#​3440 by @​mengChengxi, @​arkid15r)
• Add Shanghai Stock Exchange (SSE) holidays (#​3403 by @​mengChengxi, @​arkid15r, @​KJhellico)
• Add Shenzhen Stock Exchange (SZSE) holidays (#​3453 by @​mengChengxi)
• Update Armenia holidays: add ASCII-safe subdivision aliases (#​3371 by @​Devika9705)
• Update Australia holidays: change ANZAC Day holiday in 2026 (ACT) (#​3395 by @​simongreen-net, @​PPsyrius)
• Update Bangladesh holidays: add Arabic language support (#​3480 by @​shaonahamed0)
• Update CI/CD workflows (#​3431 by @​KJhellico)
• Update CONTRIBUTING.md localization section (#​3406 by @​arkid15r)
• Update CONTRIBUTING.md with cross-platform command equivalents for Windows (#​3374 by @​Dhruv716-stack)
• Update China and Taiwan holidays: refine and standardize holiday terminology (#​3411 by @​m0cal)
• Update German Exchange holidays: add Thai, Ukrainian language support (#​3354 by @​PPsyrius)
• Update Hong Kong holidays: standardize Simplified Chinese l10n with China implementation (#​3503 by @​KJhellico)
• Update India holidays: add Bengali language support (#​3381 by @​sai-ganesh003, @​arkid15r)
• Update India holidays: add Kannada language support (#​3428 by @​Kartheekmurala)
• Update India holidays: add Malayalam language support (#​3448 by @​hito98, @​arkid15r, @​PPsyrius)
• Update India holidays: add Marathi language support (#​3444 by @​ankushhKapoor)
• Update India holidays: add Parsi New Year holiday (GJ, MH) (#​3446 by @​pratikpanda2006)
• Update India holidays: add Punjabi language support (#​3442 by @​ankushhKapoor)
• Update India holidays: add TG as subdivision alias for Telangana (#​3376 by @​Vikash-Kumar-23)
• Update India holidays: correct Hindi translations for some holidays (#​3413 by @​sai-ganesh003)
• Update India holidays: improve Telugu translation (#​3401 by @​Kartheekmurala, @​arkid15r)
• Update Laos holidays: fix en_US typo (#​3467 by @​sourav-2023)
• Update Latvia holidays (#​3349 by @​KJhellico)
• Update Latvia holidays: add substituted holidays (#​3499 by @​KJhellico)
• Update Lebanon holidays: add French language support (#​3407 by @​osamaajr)
• Update Marshall Islands holidays (#​3335 by @​KJhellico)
• Update Marshall Islands holidays: fix General Election Day (#​3337 by @​PPsyrius, @​arkid15r)
• Update National Stock Exchange of India holidays: add Marathi language support (#​3484 by @​pareshjoshij)
• Update Nigeria holidays: add Eid al-Fitr 2026 exact date (#​3385 by @​yazidcodes, @​PPsyrius)
• Update README.md: add documentation badges (#​3504 by @​arkid15r)
• Update Russia holidays: add Simplified Chinese language support (#​3386 by @​m0cal)
• Update Saudi Arabia holidays: add Bengali language support (#​3500 by @​shaonahamed0)
• Update Syria holidays: add Liberation Day holiday (#​3391 by @​Muhannad-eb, @​PPsyrius)
• Update United States holidays: add American Citizenship Day in Puerto Rico (PR) (#​3230 by @​kouta-kun, @​PPsyrius)
• Update United States holidays: add Good Friday, Christmas Eve, New Year's Eve to UNOFFICIAL category (#​3324 by @​PPsyrius)
• Update United States holidays: update Massachusetts (MA) state holidays (#​3338 by @​KJhellico)
• Update dependabot configuration (#​3493 by @​arkid15r)
• Update documentation build: proper notes rendering on GitHub and ReadTheDocs (#​3506 by @​KJhellico)
• Update documentation: add example script for generating .ics calendars (#​3414 by @​Kartheekmurala, @​KJhellico)
• Update documentation: clarify subdivisions_aliases note (#​3205 by @​VaishnaviBardapure, @​arkid15r)
• Update holiday categories docs; remove unused CHINESE constant (#​3347 by @​PPsyrius)
• Update pyproject.toml: bump setuptools minimal version (#​3422 by @​KJhellico)
• Update release notes generator (#​3501 by @​KJhellico)
• Add interactive .ics calendar download page into documentation (#​3282 by @​pareshjoshij, @​arkid15r, @​KJhellico)
• Add markdownlint as a pre-commit step (#​3408 by @​arkid15r)
• Cleanup .readthedocs.yaml (#​3360 by @​KJhellico)
• Let dependabot handle pre-commit version updates (#​3497 by @​arkid15r)
• Migrate from MkDocs to ProperDocs (#​3346 by @​PPsyrius, @​arkid15r)
• Simplify XJPX inheritance: remove ChildEntity from the parents (#​3405 by @​arkid15r)
• Standardize existing l10n files (#​3430 by @​PPsyrius)
• Unify Good Friday holiday name Arabic translation (#​3387 by @​Mustapha-Nkhili)

v0.93

Compare Source

Released March 16, 2026

• Add Germany Stock Exchange holidays (#​3271 by @​priak388, @​krisitachhetry25-hue)
• Add Japan Exchange Group (JPX) holidays (#​3270 by @​adityaanand05, @​arkid15r)
• Add Kosovo holidays (#​3327 by @​bleendd, @​arkid15r)
• Fix l10n tests (#​3313 by @​KJhellico)
• Update CONTRIBUTORS (#​3325 by @​PPsyrius)
• Update Gabon holidays (#​3317 by @​KJhellico)
• Update Gabon holidays: add l10n support (#​3178 by @​aman-coder03, @​KJhellico)
• Update India holidays: add Telugu language support (#​3303 by @​Abiram08)
• Update Italy holidays: add Bolzano Half-Day holidays, Easter Sunday, Thai language support (#​3318 by @​PPsyrius)

v0.92

Compare Source

Released March 2, 2026

• Add observed holidays substitution support (#​3289 by @​KJhellico)
• Update Burkina Faso holidays: add l10n support (#​3177 by @​aman-coder03, @​KJhellico)
• Update China holidays: add additional substituted holidays in 2019 (#​3294 by @​KJhellico)
• Update India holidays: add Tamil language support (#​3278 by @​Abiram08)
• Update Iran holidays: add special holidays support (#​3304 by @​PPsyrius)
• Update Kyrgyzstan holidays: add l10n support (#​3301 by @​KJhellico)
• Update South Korea holidays: add Constitution Day back for 2026 onwards (#​3284 by @​kawai10)
• Update iCal exporter (#​3290 by @​KJhellico, @​arkid15r)
• Update l10n test: check .po files for mandatory metadata fields (#​3279 by @​KJhellico, @​arkid15r)

v0.91

Compare Source

Released February 16, 2026

• Refactor United Kingdom holidays ([#​3262](https://redirect.github.com/vacanza/holidays

✂ Note

PR body was truncated to here.