updates

Author: kyclark

11_bottles_of_beer/solution.py

@@ -27,6 +27,14 @@ def get_args():
     return args
 
 
+# --------------------------------------------------
+def main():
+    """Make a jazz noise here"""
+
+    args = get_args()
+    print('\n\n'.join(map(verse, range(args.num, 0, -1))))
+
+
 # --------------------------------------------------
 def verse(bottle):
     """Sing a verse"""
@@ -61,14 +69,6 @@ def test_verse():
     ])
 
 
-# --------------------------------------------------
-def main():
-    """Make a jazz noise here"""
-
-    args = get_args()
-    print('\n\n'.join(map(verse, range(args.num, 0, -1))))
-
-
 # --------------------------------------------------
 if __name__ == '__main__':
     main()

extra/06_head/Makefile

@@ -0,0 +1,7 @@
+.PHONY: test pdf
+
+pdf:
+	asciidoctor-pdf -o README.pdf README.adoc
+
+test:
+	pytest -xv test.py

extra/06_head/README.adoc

@@ -0,0 +1,112 @@
+= Python implementation of `head`
+
+In this exercise, we'll write a Python program to emulate the Unix `head` command.
+If you read `man head`, you will see that this program (probably) defaults to showing the first 10 lines of a given file:
+
+----
+NAME
+     head -- display first lines of a file
+
+SYNOPSIS
+     head [-n count | -c bytes] [file ...]
+
+DESCRIPTION
+     This filter displays the first count lines or bytes of each of the speci-
+     fied files, or of the standard input if no files are specified.  If count
+     is omitted it defaults to 10.
+
+     If more than a single file is specified, each file is preceded by a
+     header consisting of the string ``==> XXX <=='' where ``XXX'' is the name
+     of the file.
+
+EXIT STATUS
+     The head utility exits 0 on success, and >0 if an error occurs.
+----
+
+The program should handle a _single_ file provided as a positional argument:
+
+----
+$ ./head.py inputs/the-bustle.txt
+The bustle in a house
+The morning after death
+Is solemnest of industries
+Enacted upon earth,--
+
+The sweeping up the heart,
+And putting love away
+We shall not want to use again
+Until eternity.
+----
+
+The program should accept a `-n` or `--num` option for the number of lines to show (default 10):
+
+----
+$ ./head.py -n 5 inputs/sonnet-29.txt
+Sonnet 29
+William Shakespeare
+
+When, in disgrace with fortune and men’s eyes,
+I all alone beweep my outcast state,
+----
+
+The program should reject any argument that is not a readable file:
+
+----
+$ ./head.py blargh
+usage: head.py [-h] [-n int] FILE
+head.py: error: argument FILE: can't open 'blargh': \
+[Errno 2] No such file or directory: 'blargh'
+----
+
+The program should reject a `--num` argument less than 1:
+
+----
+$ ./head.py -n 0 inputs/gettysburg.txt
+usage: head.py [-h] [-n int] FILE
+head.py: error: --num "0" must be greater than 0
+----
+
+Given no arguments, it should print a short usage:
+
+----
+$ ./head.py
+usage: head.py [-h] [-n int] FILE
+head.py: error: the following arguments are required: FILE
+----
+
+Or a longer usage for `-h` or `--help`:
+
+----
+$ ./head.py -h
+usage: head.py [-h] [-n int] FILE
+
+Rock the Casbah
+
+positional arguments:
+  FILE               Input file
+
+optional arguments:
+  -h, --help         show this help message and exit
+  -n int, --num int  Number of lines (default: 10)
+----
+
+The program should pass all tests:
+
+----
+$ make test
+pytest -xv test.py
+============================= test session starts ==============================
+...
+collected 8 items
+
+test.py::test_exists PASSED                                              [ 12%]
+test.py::test_usage PASSED                                               [ 25%]
+test.py::test_bad_file PASSED                                            [ 37%]
+test.py::test_bad_num PASSED                                             [ 50%]
+test.py::test_default PASSED                                             [ 62%]
+test.py::test_num_1 PASSED                                               [ 75%]
+test.py::test_n_2 PASSED                                                 [ 87%]
+test.py::test_num_3 PASSED                                               [100%]
+
+============================== 8 passed in 0.54s ===============================
+----

extra/06_head/inputs/gettysburg.txt

@@ -0,0 +1,25 @@
+Four score and seven years ago our fathers brought forth on this
+continent, a new nation, conceived in Liberty, and dedicated to the
+proposition that all men are created equal.
+
+Now we are engaged in a great civil war, testing whether that nation,
+or any nation so conceived and so dedicated, can long endure. We are
+met on a great battle-field of that war. We have come to dedicate a
+portion of that field, as a final resting place for those who here
+gave their lives that that nation might live. It is altogether fitting
+and proper that we should do this.
+
+But, in a larger sense, we can not dedicate -- we can not consecrate
+-- we can not hallow -- this ground. The brave men, living and dead,
+who struggled here, have consecrated it, far above our poor power to
+add or detract. The world will little note, nor long remember what we
+say here, but it can never forget what they did here. It is for us the
+living, rather, to be dedicated here to the unfinished work which they
+who fought here have thus far so nobly advanced. It is rather for us
+to be here dedicated to the great task remaining before us -- that
+from these honored dead we take increased devotion to that cause for
+which they gave the last full measure of devotion -- that we here
+highly resolve that these dead shall not have died in vain -- that
+this nation, under God, shall have a new birth of freedom -- and that
+government of the people, by the people, for the people, shall not
+perish from the earth.

extra/06_head/inputs/sonnet-29.txt

@@ -0,0 +1,17 @@
+Sonnet 29
+William Shakespeare
+
+When, in disgrace with fortune and men’s eyes,
+I all alone beweep my outcast state,
+And trouble deaf heaven with my bootless cries,
+And look upon myself and curse my fate,
+Wishing me like to one more rich in hope,
+Featured like him, like him with friends possessed,
+Desiring this man’s art and that man’s scope,
+With what I most enjoy contented least;
+Yet in these thoughts myself almost despising,
+Haply I think on thee, and then my state,
+(Like to the lark at break of day arising
+From sullen earth) sings hymns at heaven’s gate;
+For thy sweet love remembered such wealth brings
+That then I scorn to change my state with kings.

extra/06_head/inputs/the-bustle.txt

@@ -0,0 +1,9 @@
+The bustle in a house
+The morning after death
+Is solemnest of industries
+Enacted upon earth,--
+
+The sweeping up the heart,
+And putting love away
+We shall not want to use again
+Until eternity.

extra/06_head/test.py

@@ -0,0 +1,116 @@
+#!/usr/bin/env python3
+"""tests for days.py"""
+
+import os
+import random
+import re
+import string
+from subprocess import getstatusoutput
+
+prg = './head.py'
+sonnet = './inputs/sonnet-29.txt'
+bustle = './inputs/the-bustle.txt'
+gettysburg = './inputs/gettysburg.txt'
+
+
+# --------------------------------------------------
+def test_exists():
+    """exists"""
+
+    assert os.path.isfile(prg)
+
+
+# --------------------------------------------------
+def test_usage():
+    """usage"""
+
+    for flag in ['-h', '--help']:
+        rv, out = getstatusoutput(f'{prg} {flag}')
+        assert rv == 0
+        assert out.lower().startswith('usage')
+
+
+# --------------------------------------------------
+def test_bad_file():
+    """Bad file"""
+
+    bad = random_string()
+    rv, out = getstatusoutput(f'{prg} {bad}')
+    assert rv != 0
+    assert re.search(f"No such file or directory: '{bad}'", out)
+
+
+# --------------------------------------------------
+def test_bad_num():
+    """Bad num"""
+
+    for bad in random.sample(range(-10, 1), 3):
+        rv, out = getstatusoutput(f'{prg} -n {bad} {sonnet}')
+        assert rv != 0
+        assert re.search(f'--num "{bad}" must be greater than 0', out)
+
+
+# --------------------------------------------------
+def test_default():
+    """Default --num"""
+
+    rv, out = getstatusoutput(f'{prg} {sonnet}')
+    assert rv == 0
+    assert len(out.splitlines()) == 10
+    expected = """
+Sonnet 29
+William Shakespeare
+
+When, in disgrace with fortune and men’s eyes,
+I all alone beweep my outcast state,
+And trouble deaf heaven with my bootless cries,
+And look upon myself and curse my fate,
+Wishing me like to one more rich in hope,
+Featured like him, like him with friends possessed,
+Desiring this man’s art and that man’s scope,
+    """.strip()
+    assert out.strip() == expected
+
+
+# --------------------------------------------------
+def test_num_1():
+    """--num 1"""
+
+    rv, out = getstatusoutput(f'{prg} --num 1 {gettysburg}')
+    assert rv == 0
+    assert len(out.splitlines()) == 1
+    assert out.strip(
+    ) == 'Four score and seven years ago our fathers brought forth on this'
+
+
+# --------------------------------------------------
+def test_n_2():
+    """-n 2"""
+
+    rv, out = getstatusoutput(f'{prg} -n 2 {sonnet}')
+    assert rv == 0
+    assert len(out.splitlines()) == 2
+    expected = 'Sonnet 29\nWilliam Shakespeare'
+    assert out.strip() == expected
+
+
+# --------------------------------------------------
+def test_num_3():
+    """--num 2"""
+
+    rv, out = getstatusoutput(f'{prg} --num 3 {bustle}')
+    assert rv == 0
+    assert len(out.splitlines()) == 3
+    expected = '\n'.join([
+        'The bustle in a house', 'The morning after death',
+        'Is solemnest of industries'
+    ])
+    assert out.strip() == expected
+
+
+# --------------------------------------------------
+def random_string():
+    """generate a random string"""
+
+    k = random.randint(5, 10)
+    return ''.join(random.choices(string.ascii_letters + string.digits, k=k))