typer-invoke 0.2.0

Simplified invokation of typer apps from any directory.

typer-invoke

Simplified invocation of typer apps from any directory.

The idea is that you place typer apps in a directory in your project and then you can invoke them from any directory.

Why?

The main use case is for project management that require custom scripts for various tasks. Wrapping those scripts as typer apps makes them easier to use. Making typer easier to use makes those scripts even easier to use.

An alternative to:

• Make
• Invoke

Versus Invoke

The main driver for this project is as a replacement for Invoke, which I've been using for a while and found the following limitations:

• --help and --list options are clunky, in that they need to be placed right after the inv command, ex:

  inv --help some.task
  

  Here a more common pattern is used and --help acts as both help and list:

  inv some task --help
  

• Lack of support. Some issues and features have been piling up for a while, and I'm not sure if they will ever be addressed. Seems like the project has had new development recently, though.
  Typer is widely used and has a lot of support.

Other advantages (in my opinion):

• Prettier Developer experience counts. Other than more common usage patterns, Typer supports rich and Markdown formatting.
  Including using rich for logging, which is done in this project.
• No dot . namespace Invoke uses a dot . namespace for tasks, which is not very common when running scripts.
  Typer follows a normal CLI pattern. Namespaces are Typer apps and are separated by a space.

Invoke is the inspiration for this project, hence the name typer-invoke and keeping the inv command name.

Cool things about Invoke

Invoke concepts and features I was using that are not native to this project, but the workarounds work well:

• Task dependencies.
  In Invoke, it's easy to declare a task dependent on others and they will be executed in the correct order.
  While we don't have this feature, it's very easy to simply call other functions and end up with the same functionality.
• Namespaces (task groups)
  You can declare namespaces and whatever tasks you want in them.
  The same is done in Typer by with apps. Each app added is the equivalent of a namespace.
  Usually, one app is in one file, but it's not a requirement.
• Dry runs
  The --dry option in Invoke is very useful and available to all tasks.
  Typer doesn't have this feature, but it's easy to add. See the examples in this project, under the admin directory.