You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
103 lines
2.8 KiB
Plaintext
103 lines
2.8 KiB
Plaintext
5 years ago
|
Metadata-Version: 2.1
|
||
|
|
Name: click
|
||
|
|
Version: 7.1.1
|
||
|
|
Summary: Composable command line interface toolkit
|
||
|
|
Home-page: https://palletsprojects.com/p/click/
|
||
|
|
Maintainer: Pallets
|
||
|
|
Maintainer-email: contact@palletsprojects.com
|
||
|
|
License: BSD-3-Clause
|
||
|
|
Project-URL: Documentation, https://click.palletsprojects.com/
|
||
|
|
Project-URL: Code, https://github.com/pallets/click
|
||
|
|
Project-URL: Issue tracker, https://github.com/pallets/click/issues
|
||
|
|
Platform: UNKNOWN
|
||
|
|
Classifier: Development Status :: 5 - Production/Stable
|
||
|
|
Classifier: Intended Audience :: Developers
|
||
|
|
Classifier: License :: OSI Approved :: BSD License
|
||
|
|
Classifier: Operating System :: OS Independent
|
||
|
|
Classifier: Programming Language :: Python
|
||
|
|
Classifier: Programming Language :: Python :: 2
|
||
|
|
Classifier: Programming Language :: Python :: 3
|
||
|
|
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
|
||
|
|
|
||
|
|
\$ click\_
|
||
|
|
==========
|
||
|
|
|
||
|
|
Click is a Python package for creating beautiful command line interfaces
|
||
|
|
in a composable way with as little code as necessary. It's the "Command
|
||
|
|
Line Interface Creation Kit". It's highly configurable but comes with
|
||
|
|
sensible defaults out of the box.
|
||
|
|
|
||
|
|
It aims to make the process of writing command line tools quick and fun
|
||
|
|
while also preventing any frustration caused by the inability to
|
||
|
|
implement an intended CLI API.
|
||
|
|
|
||
|
|
Click in three points:
|
||
|
|
|
||
|
|
- Arbitrary nesting of commands
|
||
|
|
- Automatic help page generation
|
||
|
|
- Supports lazy loading of subcommands at runtime
|
||
|
|
|
||
|
|
|
||
|
|
Installing
|
||
|
|
----------
|
||
|
|
|
||
|
|
Install and update using `pip`_:
|
||
|
|
|
||
|
|
.. code-block:: text
|
||
|
|
|
||
|
|
$ pip install -U click
|
||
|
|
|
||
|
|
.. _pip: https://pip.pypa.io/en/stable/quickstart/
|
||
|
|
|
||
|
|
|
||
|
|
A Simple Example
|
||
|
|
----------------
|
||
|
|
|
||
|
|
.. code-block:: python
|
||
|
|
|
||
|
|
import click
|
||
|
|
|
||
|
|
@click.command()
|
||
|
|
@click.option("--count", default=1, help="Number of greetings.")
|
||
|
|
@click.option("--name", prompt="Your name", help="The person to greet.")
|
||
|
|
def hello(count, name):
|
||
|
|
"""Simple program that greets NAME for a total of COUNT times."""
|
||
|
|
for _ in range(count):
|
||
|
|
click.echo(f"Hello, {name}!")
|
||
|
|
|
||
|
|
if __name__ == '__main__':
|
||
|
|
hello()
|
||
|
|
|
||
|
|
.. code-block:: text
|
||
|
|
|
||
|
|
$ python hello.py --count=3
|
||
|
|
Your name: Click
|
||
|
|
Hello, Click!
|
||
|
|
Hello, Click!
|
||
|
|
Hello, Click!
|
||
|
|
|
||
|
|
|
||
|
|
Donate
|
||
|
|
------
|
||
|
|
|
||
|
|
The Pallets organization develops and supports Click and other popular
|
||
|
|
packages. In order to grow the community of contributors and users, and
|
||
|
|
allow the maintainers to devote more time to the projects, `please
|
||
|
|
donate today`_.
|
||
|
|
|
||
|
|
.. _please donate today: https://palletsprojects.com/donate
|
||
|
|
|
||
|
|
|
||
|
|
Links
|
||
|
|
-----
|
||
|
|
|
||
|
|
- Website: https://palletsprojects.com/p/click/
|
||
|
|
- Documentation: https://click.palletsprojects.com/
|
||
|
|
- Releases: https://pypi.org/project/click/
|
||
|
|
- Code: https://github.com/pallets/click
|
||
|
|
- Issue tracker: https://github.com/pallets/click/issues
|
||
|
|
- Test status: https://dev.azure.com/pallets/click/_build
|
||
|
|
- Official chat: https://discord.gg/t6rrQZH
|
||
|
|
|
||
|
|
|