Package: new-py
new.pyPython program to write new Python programsDescriptionThe "new.py" program is intended to automate the creation of a program that uses argparse to handle command-line arguments.
Run with-h|--helpfor the documentation:usage: new.py [-h] [-n NAME] [-e EMAIL] [-p PURPOSE] [-t] [-f] program

Create Python argparse program

positional arguments:
  program               Program name

optional arguments:
  -h, --help            show this help message and exit
  -n NAME, --name NAME  Name for docstring (default: Ken Youens-Clark)
  -e EMAIL, --email EMAIL
                        Email for docstring (default: kyclark@gmail.com)
  -p PURPOSE, --purpose PURPOSE
                        Purpose for docstring (default: Rock the Casbah)
  -t, --write_test      Create basic test.py (default: False)
  -f, --force           Overwrite existing (default: False)The only required argument is the "program" name:$ new.py foo.py
Done, see new script "foo.py."Now you will have a program that will accept the following parameters:$ ./foo.py -h
usage: foo.py [-h] [-a str] [-i int] [-f FILE] [-o] str

Rock the Casbah

positional arguments:
  str                   A positional argument

optional arguments:
  -h, --help            show this help message and exit
  -a str, --arg str     A named string argument (default: )
  -i int, --int int     A named integer argument (default: 0)
  -f FILE, --file FILE  A readable file (default: None)
  -o, --on              A boolean flag (default: False)Edit the "get_args()" function to whatever your program's requirements may be.If you run this same command again, the "foo.py" file will be detected, and you will be prompted to see if you wish to overwrite it.
Unless you answer "yes," the program will exit:$ new.py foo.py
"foo.py" exists.  Overwrite? [yN] n
Will not overwrite. Bye!If you do wish to overwrite the program, you can use the-f|--forceflag:$ new.py foo.py -f
Done, see new script "foo.py."You can indicate the name and email address you wish to appear in the program's docstrings, or you can write a "~/.new.py" configuration file with these parameters, e.g.:$ cat ~/.new.py
name=Ken Youens-Clark
email=kyclark@gmail.com
purpose=Look out, you rock-and-rollers!The-p|--purposeoption will also become part of the program docstring/argparse documentation.
You can also add a "purpose" option to your "~/.new.py" file to override the default "Rock the Casbah" value.Use the-t|--testoption to create a "{prg}_test.py" file and a "Makefile":$ new.py -t foo.py
Done, see new script "foo.py."Now you should have the following files:$ find . -type f
./Makefile
./tests/foo_test.py
./foo.pyYou can run "make test" to execute "python3 -m pytest -xv":$ make test
python3 -m pytest -xv
============================= test session starts ==============================
...

tests/foo_test.py::test_exists PASSED                                    [ 33%]
tests/foo_test.py::test_usage PASSED                                     [ 66%]
tests/foo_test.py::test_ok PASSED                                        [100%]

============================== 3 passed in 0.27s ===============================InstallationYou can copy thenew.pyprogram to any directory currently in your$PATH.
It's common to place programs into a directory like/usr/local/bin, but this often will require root priviliges.
A common workaround is to create a writable directory in your$HOMEwhere you can place programs.
I like to use$HOME/.localas the "prefix" for local software installations.
This means that$HOME/.local/binwill usually the be location where binaries will be placed; therefore I will add this to my.bash_profile(or.bashrc) file:export PATH=$HOME/.local/bin:$PATHSee AlsoI first created a version of this program forTiny Python Projects:https://github.com/kyclark/tiny_python_projects/blob/master/bin/new.pyThis version is different in that it incorporates type hints and uses structures like named tuples as records/structs to represent complex, typed objects such as the program "Args".Chapter 1of the book covers how to use "new.py" to start a new program.
Theappendixcovers argparse in greater detail.AuthorKen Youens-Clarkkyclark@gmail.com