1 set up scaffold

pyproject.toml

@@ -0,0 +1,18 @@
+#how the project is built
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+#project's metadata
+[project]
+name = "githelp"
+version = "0.1.0"
+description = "example CLI using Click."
+authors = [{ name = "Jimmy Zhang", email = "jimmy_zhang@uri.edu" }]
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = ["click>=8.1"]
+
+#this creates the 'githelp' command
+[project.scripts]
+githelp = "githelp.cli:githelp_cli"

src/githelp/_init_.py

@@ -0,0 +1,2 @@
+__all__ = ["__version__"]
+__version__ = "0.1.0"

src/githelp/cli.py

@@ -0,0 +1,12 @@
+import click
+from .greeter import make_greeting
+
+#declare the click command
+#the text in help show up in the githelp --help
+@click.command(help="Say hello from githelp.")
+@click.option("--name", "-n", default="World", show_default=False, help="Who to greet.")
+#here there is a boolean flag pair --shout/--no-shout"
+@click.option("--shout/--no-shout", default=False, show_default=False, help="End with an exclamation mark.")
+#click auto parse the value
+def githelp_cli(name: str, shout: bool) -> None:
+    click.echo(make_greeting(name, shout))

src/githelp/greeter.py

@@ -0,0 +1,6 @@
+def make_greeting(name, shout = False):
+    if(shout):
+        suffix = "!"
+    else:
+        suffix = "."
+    return f"Hello, {name}{suffix}"