forth: add README and add to config.json

cmccandless · cmccandless · commit 4b9a2d37afa4 · 2017-10-06T14:54:31.000-05:00
diff --git a/config.json b/config.json
@@ -834,6 +834,17 @@
         "mathematics"
       ]
     },
+    {
+      "uuid": "e348a307-078c-5280-65af-a159283d4e79438b755",
+      "slug": "forth",
+      "core": false,
+      "unlocked_by": null,
+      "difficulty": 10,
+      "topics": [
+        "Parsing",
+        "Stacks"
+      ]
+    }
     {
       "uuid": "e7351e8e-d3ff-4621-b818-cd55cf05bffd",
       "slug": "accumulate",
diff --git a/exercises/forth/README.md b/exercises/forth/README.md
@@ -0,0 +1,43 @@
+# Forth
+
+Implement an evaluator for a very simple subset of Forth.
+
+[Forth](https://en.wikipedia.org/wiki/Forth_%28programming_language%29)
+is a stack-based programming language. Implement a very basic evaluator
+for a small subset of Forth.
+
+Your evaluator has to support the following words:
+
+- `+`, `-`, `*`, `/` (integer arithmetic)
+- `DUP`, `DROP`, `SWAP`, `OVER` (stack manipulation)
+
+Your evaluator also has to support defining new words using the
+customary syntax: `: word-name definition ;`.
+
+To keep things simple the only data type you need to support is signed
+integers of at least 16 bits size.
+
+You should use the following rules for the syntax: a number is a
+sequence of one or more (ASCII) digits, a word is a sequence of one or
+more letters, digits, symbols or punctuation that is not a number.
+(Forth probably uses slightly different rules, but this is close
+enough.)
+
+Words are case-insensitive.
+
+## Hints
+- To parse the text, you could try to use the [Sprache](https://github.com/sprache/Sprache/blob/develop/README.md) library. You can also find a good tutorial [here](https://www.thomaslevesque.com/2017/02/23/easy-text-parsing-in-c-with-sprache/).
+
+
+### Submitting Exercises
+
+Note that, when trying to submit an exercise, make sure the solution is in the `exercism/python/<exerciseName>` directory.
+
+For example, if you're submitting `bob.py` for the Bob exercise, the submit command would be something like `exercism submit <path_to_exercism_dir>/python/bob/bob.py`.
+
+
+For more detailed information about running tests, code style and linting,
+please see the [help page](http://exercism.io/languages/python).
+
+## Submitting Incomplete Solutions
+It's possible to submit an incomplete solution so you can see how others have completed the exercise.
diff --git a/exercises/forth/example.py b/exercises/forth/example.py
@@ -0,0 +1,2 @@
+def evaluate(input):
+    pass
diff --git a/exercises/forth/forth.py b/exercises/forth/forth.py
@@ -0,0 +1,2 @@
+def evaluate(input):
+    pass
diff --git a/exercises/forth/forth_test.py b/exercises/forth/forth_test.py
@@ -0,0 +1,6 @@
+import unittest
+
+from forth import evaluate
+
+class ForthTest(unittest.TestCase):
+    pass
