Discussion
##########

The following are various topics...

.. warning:: The content of this page is incomplete!

.. FIXME complete the page content

Motivation
**********

Discuss why!

* Easy transition from argparse
* Lightweight as possible
* Customizable integration of of argparse-based and other CLI packages
* Class based vs decorators
* Well-defined initial scope, suitable for practice at producing a high-quality package

Design Goals
************

Discuss...

* Include discussion of related non-[initial-]goal topics
* Use of Decree/Tree by themselves?

Known Limitations & Issues
**************************

Discuss...

* Argparse problems...
* Known TODO/FIXME/ISSUES...
* No explicit support for late binding

..
    Note that ``argparse`` does not allow multiple subparsers for a
    command, so commands that intersperse subcommand names with
    options and other positional arguments are not easily
    constructed with ``decree-tree``.

    FIXME check on the accuracy statement above; add a reference?

Future Plans
************

Discuss...

* Support for `argcomplete <https://github.com/kislyuk/argcomplete>`__
* Possibly optional logging configuration and verbosity
* Full test coverage
* Improved automation for package test, upload, and docs
* Others...

Alternatives
************

.. FIXME describe each option, as compared to decree-tree

There are a variety of other excellent Python CLI packages, from
both the standard library and third-parties.

The Python standard library provides the following CLI packages:

* `argparse <https://docs.python.org/3/library/argparse.html>`__
* `getopt <https://docs.python.org/3/library/getopt.html>`__
* `optparse <https://docs.python.org/3/library/optparse.html>`__

Some third party CLI packages are summarized here. There are others. See
`awesome-cli-frameworks <https://github.com/shadawck/awesome-cli-frameworks?tab=readme-ov-file#python>`__
and
`awesome-python <https://github.com/vinta/awesome-python?tab=readme-ov-file#command-line-interface-development>`__
for expanded lists. Many of these tools have goals that go beyond the
scope of ``decree-tree``, or use different design paradigms than the goals
of this package.

* `Cleo <https://github.com/python-poetry/cleo>`__
* `Click <https://github.com/pallets/click>`__
* `docopt <https://github.com/docopt/docopt>`__
* `duckargs <https://github.com/eriknyquist/duckargs>`__
* `Python Fire <https://github.com/google/python-fire>`__
* `Tap <https://github.com/swansonk14/typed-argument-parser>`__
* `Typer <https://github.com/fastapi/typer>`__

Refer to `Packaging guide <https://packaging.python.org/en/latest/guides/creating-command-line-tools/>`__