Spanish article selector

kyclark · kyclark · commit 5bd9b68ac760 · 2020-02-04T13:25:53.000-07:00
diff --git a/extra/03_spanish/Makefile b/extra/03_spanish/Makefile
@@ -0,0 +1,7 @@
+.PHONY: test pdf
+
+pdf:
+	asciidoctor-pdf -o README.pdf README.adoc
+
+test:
+	pytest -xv test.py
diff --git a/extra/03_spanish/README.adoc b/extra/03_spanish/README.adoc
@@ -0,0 +1,66 @@
+= Spanish article selector
+
+Write a Python program called `article.py` that will choose the correct article for word given as a single positional argument. 
+Although there are exceptions, Spanish tends to use "el" for words ending in "o" and "la" otherwise.
+The entire output will be in the form:
+
+----
+Me gusto {article} {word}.
+----
+
+For example, if the input is "chico", the article should be "el":
+
+----
+$ ./article.py chico
+Me gusto el chico.
+----
+
+And "la" for "chica":
+
+----
+$ ./article.py chica
+Me gusto la chica.
+----
+
+It should print a brief usage if provided with no arguments:
+
+----
+$ ./article.py
+usage: article.py [-h] str
+article.py: error: the following arguments are required: str
+----
+
+And a longer usage for the `-h` or `--help` flags:
+
+----
+$ ./article.py -h
+usage: article.py [-h] str
+
+Choose the correct Spanish article
+
+positional arguments:
+  str         Input text
+
+optional arguments:
+  -h, --help  show this help message and exit
+----
+
+
+It should pass all the tests:
+
+----
+$ make test
+pytest -xv test.py
+============================= test session starts ==============================
+...
+collected 6 items
+
+test.py::test_exists PASSED                                              [ 16%]
+test.py::test_usage PASSED                                               [ 33%]
+test.py::test_masculine_lower PASSED                                     [ 50%]
+test.py::test_masculine_upper PASSED                                     [ 66%]
+test.py::test_feminine_lower PASSED                                      [ 83%]
+test.py::test_feminine_upper PASSED                                      [100%]
+
+============================== 6 passed in 0.33s ===============================
+----
diff --git a/extra/03_spanish/README.pdf b/extra/03_spanish/README.pdf
diff --git a/extra/03_spanish/test.py b/extra/03_spanish/test.py
@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+"""tests for article.py"""
+
+import os
+import random
+import re
+import string
+from subprocess import getstatusoutput
+
+prg = './article.py'
+
+
+# --------------------------------------------------
+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_masculine_lower():
+    """masculine_lower"""
+
+    word = random.choice('chico teatro cartero'.split())
+    rv, out = getstatusoutput(f'{prg} {word}')
+    assert rv == 0
+    assert out == f'Me gusto el {word}.'
+
+
+# --------------------------------------------------
+def test_masculine_upper():
+    """masculine_upper"""
+
+    word = random.choice('CHICO TEATRO CARTERO'.split())
+    rv, out = getstatusoutput(f'{prg} {word}')
+    assert rv == 0
+    assert out == f'Me gusto el {word}.'
+
+
+# --------------------------------------------------
+def test_feminine_lower():
+    """feminine_lower"""
+
+    word = random.choice('chica gata abuela'.split())
+    rv, out = getstatusoutput(f'{prg} {word}')
+    assert rv == 0
+    assert out == f'Me gusto la {word}.'
+
+
+# --------------------------------------------------
+def test_feminine_upper():
+    """feminine_upper"""
+
+    word = random.choice('CHICA GATA ABUELA'.split())
+    rv, out = getstatusoutput(f'{prg} {word}')
+    assert rv == 0
+    assert out == f'Me gusto la {word}.'
