Merge pull request #13 from gjbex/development

Development

Author: gjbex

environment.yml

@@ -1,7 +1,8 @@
 name: python_for_systems_programming
 channels:
-  - defaults
+  - conda-forge
 dependencies:
+  - click
   - paramiko
   - matplotlib
   - jinja2
@@ -10,6 +11,10 @@ dependencies:
   - fabric
   - numpy
   - jupyterlab
-pip:
-  - schedule
-prefix: /home/gjb/miniconda3/envs/python_for_systems_programming
+  - uvicorn
+  - ca-certificates
+  - certifi
+  - openssl
+  - fastapi
+  - fire
+prefix: /home/gjb/mambaforge/envs/python_for_systems_programming

python_for_systems_programming.pptx

@@ -44,3 +44,4 @@ to create it.  There is some material not covered in the presentation as well.
 1. `subprocess`: illustrates executing a shell command from a Python script
     using the `subprocess` module.
 1. `xml-generator`: code to generate a random XML documents.
+1. `fastapi`: simple illustrations of using FastAPI for webservices.

python_for_systems_programming_linux64_conda_specs.txt

@@ -1,5 +1,2 @@
 def fac(n):
-    if n < 2:
-        return 1
-    else:
-        return n*fac(n-1)
+    return 1 if n < 2 else n*fac(n-1)

source-code/README.md

@@ -1,5 +1,2 @@
 def fib(n):
-    if n == 0 or n == 1:
-        return 1
-    else:
-        return fib(n-1) + fib(n-2)
+    return 1 if n in [0, 1] else fib(n-1) + fib(n-2)

source-code/code-evaluation/fac.py

@@ -23,3 +23,4 @@ $ ./generate_gaussian.py -h
    ./options_in_file.py --foo something @file_options.txt
    ```
 1. `file_options.txt`: file containing options for `options_in_file.py`.
+1. `Rerun`: experiment with file options.

source-code/code-evaluation/fib.py

@@ -0,0 +1,33 @@
+# Rerunnable
+
+Toy application to explore the possibilities created by
+using argparse options stored in a file.
+
+
+## What is it?
+1.  rerunnable.py`: script to explore the possibilities.
+
+
+## How to use?
+
+```bash
+$ ./rerunnable.py  --verbose  --number 5  --type bye  gjb
+$ ./rerunnable.py @rerunnable_cla.txt
+```
+
+This will rerun the application with all the settings specified for the
+previous run.
+
+To override options:
+```bash
+$ ./rerunnable.py  @rerunnable_cla.txt --number 3
+```
+
+
+## Conclusions
+
+This approach works well for command line options, e.g., `--number 5`.
+
+It is not flexibile for flags, e.g., `--verbose` since they can not be "unset".
+
+It is not flexible either for positional arguments since they can not be modified.

source-code/command-line-arguments/ArgParse/README.md

@@ -0,0 +1,39 @@
+#!/usr/bin/env python
+
+import argparse
+
+
+def dump_options(options, pos_args=None, exclude=None):
+    options_dict = vars(options)
+    with open('rerunnable_cla.txt', 'w') as file:
+        for key, value in options_dict.items():
+            if ((exclude is None or key not in exclude) and
+                (pos_args is None or key not in pos_args)):
+                if isinstance(value, bool):
+                    if value:
+                        print(f'--{key}', file=file)
+                else:
+                    print(f'--{key}\n{value}', file=file)
+        if pos_args is not None:
+            for key in pos_args:
+                print(options_dict[key], file=file)
+
+
+if __name__ == '__main__':
+    arg_parser = argparse.ArgumentParser(
+        fromfile_prefix_chars='@',
+        description='application that saves its command line options and can be rerun'
+    )
+    arg_parser.add_argument('--number', type=int, default=1,
+                            help='number of messages to write')
+    arg_parser.add_argument('--type', choices=('hello', 'bye'), default='hello',
+                            help='message type')
+    arg_parser.add_argument('--verbose', action='store_true',
+                            help='verbose output')
+    arg_parser.add_argument('name', help='person to message')
+    options = arg_parser.parse_args()
+    dump_options(options, pos_args=('name', ))
+    if options.verbose:
+        print(f'printing {options.number} messages')
+    for _ in range(options.number):
+        print(f'{options.type} {options.name}')

source-code/command-line-arguments/ArgParse/Rerun/README.md

@@ -3,14 +3,14 @@
 import argparse
 
 
-def amin():
+def main():
     arg_parser = argparse.ArgumentParser(fromfile_prefix_chars='@')
     arg_parser.add_argument('--foo', help='foo option')
-    arg_parser.add_argument('--bar', help='bar optoin')
+    arg_parser.add_argument('--bar', help='bar option')
     arg_parser.add_argument('--flag', action='store_true',
                             help='flag option')
     options = arg_parser.parse_args()
     print(options)
 
 if __name__ == '__main__':
-    amin()
+    main()