Skip to content

Release Notes

Latest Changes

  • ✨ Add callable support to show_default
  • 🐛 Fix type hint for show_default parameter of Option
  • ⬆️ Upgrade analytics. PR #557 by @tiangolo.
  • 🔧 Update gitignore
  • 🔧 Update pre-commit, Python version, isort version. PR #542 by @tiangolo.

0.11.0

Features

  • ✨ Allow manual specification of Click ParamType for parameters
  • ✨ Add VersionOption function for creating --version option
  • ✨ Remove support for installation of shell completion

Fixes

  • 🐛 Fix initializer of Context class
  • 🐛 Fix minor issues with resolving and displaying of parameter env vars
  • 🐛 Fix name attribute of ShellQuotedList class

Docs

  • 📝 Add more API docs
  • 📝 Miscellaneous improvements to docs
  • 🎨 Adjust spacing after ellipses in documentation

Internal

  • 📝 Update Security policy

0.10.0

Features

  • ✨ Improve handling of environment variables for parameters
  • ✨ Use Click shell completion scripts
  • ✨ Remove support for PowerShell completion
  • ✨ Add support for shell-quoted list parameter type
  • ✨ Add support for unprocessed parameters

Docs

  • 📝 Add note about this fork to main page / README
  • 📝 Add more API docs

Internal

0.9.1

Internal

  • 📝 Miscellaneous improvements to docs
  • ✨ Fix Flake8 issues in codebase
  • ⬆️ Update dependency pytest-xdist
  • ✏ Fix comment in scripts/test.sh
  • ⬆ pre-commit autoupdate

0.9.0

Features

  • ✨ Rename Typer.add_typer to Typer.add_sub
  • ✨ Apply convertors to Context.params
  • ✨ Rename get_cloup_param to get_click_param and fix type hints

Fixes

  • 🐛 Reorder positional args of add_typer, callback, command methods of Typer
  • 🐛 Make TyperGroup inherit TyperCommand

Docs

  • ✏ Fix links to GitHub repo in docs

Internal

  • 📝 Reformat project metadata

0.8.0

Features

  • 🔧 Rename package module to typer_cloup

Docs

  • 🐛 Fix links in docs

Internal

  • 👷 Fix definitions of manual inputs in GitHub workflows
  • ⬆️ Update dependency cloup to 2.0.0
  • 🔧 Update scripts

0.7.0

Fixes

  • ✏ Improve error messages
  • ✨ Improve efficiency of Typer.invoke and Typer.forward methods
  • 🐛 Use typer.Context as command context class
  • 🔧 Fix type hints
  • 🐛 Restore accidentally removed test test_others::test_autocompletion_too_many_parameters
  • 🐛 Fix get_param_completion function

Docs

  • ✏️ Fix typo in datetime docs. PR #495 by @huxuan.
  • ✏️ Add quotes to package name that includes brackets in docs. PR #475 by @gjolga.

Internal

  • ⬆ Bump dawidd6/action-download-artifact from 2.24.1 to 2.24.2. PR #494 by @dependabot[bot].
  • ⬆ Bump dawidd6/action-download-artifact from 2.9.0 to 2.24.1. PR #491 by @dependabot[bot].
  • 👷‍♂️ Ensure the PYTHONPATH is set properly when testing the tutorial scripts. PR #407 by @theMarix.
  • ✅ Add tests for complete coverage
  • ⬆️ Update dependency cloup to 1.0.0
  • 🔥 Remove tests/test_compat
  • 🔧 Remove "Commit to Help" section from issue templates
  • ✅ Add pragma: no cover to various lines
  • 👷 Fix formatting of GitHub workflows

0.6.0

Features

  • ✨ Make typer.run() not add completion scripts by default, it only makes sense in installed apps. PR #488 by @tiangolo.
  • ✨ Add support for Python 3.11, tests in CI and official marker. PR #487 by @tiangolo.

Docs

  • 📝 Add note about how subcommands with function names using underscores are converted to dashes. PR #403 by @targhs.
  • ✏ Fix link in docs to datetime.strptime(). PR #464 by @Kobu.
  • ✏ Update first-steps.md, clarify distinction between parameter and argument. PR #176 by @mccarthysean.

Internal

  • ✅ Add extra tests just for coverage because monkeypatching with strange imports confuses coverage. PR #490 by @tiangolo.
  • 📝 Add docs for deprecating commands (tiangolo/typer#419)
  • 🔧 Tweak pytest coverage. PR #485 by @tiangolo.
  • ➕ Bring back pytest-cov because coverage can't detect pytest-xdist. PR #484 by @tiangolo.
  • ⬆ [pre-commit.ci] pre-commit autoupdate. PR #411 by @pre-commit-ci[bot].
  • ⬆ Bump nwtgck/actions-netlify from 1.1.5 to 1.2.4. PR #479 by @dependabot[bot].
  • ⬆ Bump tiangolo/issue-manager from 0.2.0 to 0.4.0. PR #481 by @dependabot[bot].
  • 👷 Move from pytest-cov to coverage and Codecov to Smokeshow. PR #483 by @tiangolo.
  • ➕ Add extra Material for MkDocs deps for docs. PR #482 by @tiangolo.
  • 🔧 Update Dependabot config. PR #476 by @tiangolo.

0.5.1

Fixes

  • 🐛 Allow docutils dependency to be absent

Docs

  • 📝 Do not prefix calls with python -m when unnecessary
  • 📝 Update copyright in license
  • ✏ Remove hyphen in main page / README
  • ✏ Fix indentation in main page / README

Internal

  • 🔧 Sort gitignore entries
  • 👷 Update versions of actions in GitHub workflows
  • 📝 Update project metadata
  • 🔧 Replace pragma: nocover with pragma: no cover
  • ✨ Use docstring-parser package to parse help text
  • 📝 Update package name in main page / README

0.5.0

Features

  • ✨ Add support for Cloup sections
  • ✨ Add support for Cloup aliases
  • ✨ Add support for Cloup decorator & manual constraints
  • ✨ Add support for Cloup option groups
  • ✨ Get help for params from docstrings
  • ✨ Add Typer.invoke and Typer.forward methods.
  • ✨ Drop support for Python 3.6.
  • ✨ Drop support for Click 7.

Fixes

  • 🐛 Fix type signature of typer.main.get_group
  • 🐛 Fix type annotation of run function

Docs

  • 📝 Update docs to point to own site
  • ✏ Fix broken plac link. PR #275 by @mgielda.
  • ✏ Fix typo, "ASCII codes" to "ANSI escape sequences". PR #308 by @septatrix.

Internal

  • 📝 Update project metadata
  • 🔧 Fix type checking
  • ✨ Use Cloup subclasses of Click types where appropriate
  • 👷 Fix building docs
  • 👷 Fix formatting of GitHub workflows
  • 👷 Fix build-docs GitHub workflow
  • ✨ Add test for issue tiangolo/typer#365
  • ✨ Add test for issue tiangolo/typer#208
  • ⬆️ Update dependencies
  • ⬆️ Upgrade codecov GitHub Action. PR #420 by @tiangolo.

0.4.2

Fixes

  • 🐛 Fix type conversion for List and Tuple and their internal types. PR #143 by @hellowhistler.
  • 🐛 Fix context_settings for a Typer app with a single command. PR #210 by @daddycocoaman.

Docs

  • 📝 Clarify testing documentation about checking stderr. PR #335 by @cgabard.
  • ✏ Fix typo in docs for CLI Option autocompletion. PR #288 by @graue70.
  • 🎨 Fix header format for "Standard Input" in docs/tutorial/printing.md. PR #386 by @briancohan.
  • ✏ Fix typo in docs/tutorial/terminating.md. PR #382 by @kianmeng.
  • ✏ Fix syntax typo in docs/tutorial/package.md. PR #333 by @ryanstreur.
  • ✏ Fix typo, duplicated word in docs/tutorial/options/required.md.. PR #316 by @michaelriri.
  • ✏ Fix minor typo in index.md. PR #274 by @RmStorm.
  • ✏ Fix double "and" typo in first-steps tutorial. PR #225 by @softwarebloat.
  • 🎨 Fix format in docs explaining datetime parameter type. PR #220 by @DiegoPiloni.

Internal

0.4.1

Fixes

  • 🐛 Fix import of get_terminal_size for Click 8.1.0 support and upgrade Black to fix CI. PR #380 by @tiangolo based on original PR #375 by @madkinsz.

Internal

  • 📝 Add Jina's QA Bot to the docs to help people that want to ask quick questions. PR #368 by @tiangolo.
  • 💚 Only test on push when on master, avoid duplicate CI runs from PRs. PR #358 by @tiangolo.
  • ✨ Add support for previewing docs in PRs from forks and enable MkDocs Insiders. PR #357 by @tiangolo.
  • ⬆️ Upgrade MkDocs Material, MDX-Include, and MkDocs structure. PR #356 by @tiangolo.
  • 👷 Update publish GitHub action. PR #325 by @tiangolo.

0.4.0

Features

  • ✨ Add support for Click 8 while keeping compatibility with Click 7. PR #317 by @tiangolo.

Internal

0.3.2

Features

Docs

  • Update docs with new --help showing default values. PR #135 by @victorphoenix3.
  • Add Optional to docs for CLI Arguments and Options with a default of None. PR #131 by @rkbeatss.
  • Add valid date formats to docs. PR #122 by @IamCathal.

Internal

  • Report coverage in XML to support GitHub Actions. PR #146.
  • Update badges and remove Travis, now that GitHub Actions is the main CI. PR #145.

0.3.1

  • Add GitHub Actions, move from Travis. PR #144.
  • Pin dependencies. PR #138.
  • Add Dependabot. PR #136.
  • Upgrade Isort to version 5.x.x. PR #137.

0.3.0

0.2.1

  • Add support for forward references (types declared inside of strings). PR #93.

0.2.0

  • Add support for completion for commands/programs not available on startup.
    • This allows installing a Typer program/script in a virtual environment and still have completion globally installed.
    • PR #92.
  • Add note about typer.echo() and print() for colors in Windows. PR #89.
  • Upgrade Mkdocs-Material version, update contributing guide style. PR #90.

0.1.1

  • Fix completion evaluation for Bash and Zsh when the program is not installed/found. PR #83.
  • Fix completion script for Fish. PR #82.
  • Fix shell installation for Bash to ~/.bashrc and update Windows development docs. PR #81.
  • Update coverage badge. PR #78.

0.1.0

0.0.11

  • Re-implement completion system:
    • Remove optional dependency click-completion (with its sub-dependencies, like Jinja).
    • Add optional dependency shellingham to auto detect shell to install (it was used by click-completion).
    • Completion now doesn't require a third party library.
      • If shellingham is not installed/added as a dependency, --install-completion and --show-completion take a value with the name of the shell.
    • Fix support for user provided completion in CLI Parameters.
    • Fix completion for files in Bash, Zsh, and Fish.
    • Add support for modern versions of PowerShell, 5, 6, and 7 (e.g. in Windows 10).
    • Add support for pwsh (PowerShell Core).
      • PowerShell support includes help strings for commands and CLI Parameters.
    • Several bug fixes.
    • Tests for the completion logic/code.
    • Tested in all the shells in Linux and Windows.
    • PR #66.
  • Fix format in docs with highlighted lines. PR #65.
  • Add docs about Typer CLI - completion for small scripts. PR #64.
  • Add docs about Alternatives, Inspiration and Comparisons. PR #62.
  • Add Development - Contributing Guide. PR #61.

0.0.10

  • Add support for Click version 7.1.1. PR #60.

0.0.9

  • Add support for PEP 561, to allow mypy to type check applications built with Typer. PR #58.
  • Upgrade deploy docs to Netlify GitHub action. PR #57.
  • Add support for Mermaid JS for visualizations. PR #56.
  • Update CI to run docs deployment in GitHub actions. PR #50.
  • Update format for internal links. PR #38.
  • Tweak external links' format. PR #36.

0.0.8

0.0.7

0.0.6

0.0.5

  • Clean exports from typer_cloup. Remove unneeded components from Click and add needed Exit exception. PR #11.
  • Fix and document extracting help from a function's docstring First Steps: Document your CLI app. PR #10.
  • Update references to --install-completion and --show-completion in docs. PR #9.
  • Fix testing utilities, add tests for First Steps examples. PR #8.
  • Add auto completion options by default when click-completion is installed: --install-completion and --show-completion. PR #7.
  • Update Termynal to have fixed sizes, add "fast" button, and use it in First Steps. PR #6.
  • Add custom automatic Termynal for docs. PR #5.

0.0.4

  • Update short descriptions and assets.
  • Docs rewording and fix typos. PR #1 by @mariacamilagl.

0.0.3

  • Fix group creation without name.

0.0.2

  • Add initial version of code, docs, etc.

0.0.1

  • First commit. Publish to PyPI to reserve package name.
You can ask questions about Typer. Try:
How can I terminate a program?
How to launch applications?
How to add help to CLI argument?