Create benchmark for fluent.runtime (fixes #85)

Author: Pike

fluent.runtime/tools/benchmarks/README.md

@@ -0,0 +1,15 @@
+To run the benchmarks, do:
+
+    $ pip install -r tools/benchmarks/requirements.txt
+    $ py.test ./tools/benchmarks/fluent_benchmark.py --benchmark-warmup=on -k test_benchmark
+
+To profile the benchmark suite, we recommend py-spy as a
+good tool. Install py-spy: https://github.com/benfred/py-spy
+
+Then do something like this to profile the benchmark. Depending on your
+platform, you might need to use `sudo`.
+
+    $ py-spy -f prof.svg -- py.test ./tools/benchmarks/fluent_benchmark.py -k test_fluent
+
+And look at prof.svg in a browser. Note that this diagram includes the fixture
+setup, warmup and calibration phases which you should ignore.

fluent.runtime/tools/benchmarks/fluent_benchmark.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python
+# This should be run using pytest
+
+from __future__ import unicode_literals
+
+import pytest
+import six
+
+from fluent.runtime import FluentBundle
+
+
+FTL_CONTENT = """
+one = One
+two = Two
+three = Three
+four = Four
+five = Five
+six = Six
+seven = Seven ways to { $destination }
+eight = Eight
+nine = Nine
+ten = Ten
+"""
+
+@pytest.fixture
+def fluent_bundle():
+    ctx = FluentBundle(['pl'], use_isolating=False)
+    ctx.add_messages(FTL_CONTENT)
+    return ctx
+
+
+def fluent_template(bundle):
+    return (
+        "preface" +
+        bundle.format("one")[0] +
+        bundle.format("two")[0] +
+        bundle.format("three")[0] +
+        bundle.format("four")[0] +
+        bundle.format("five")[0] +
+        bundle.format("six")[0] +
+        bundle.format("seven", {"destination": "Mars"})[0] +
+        bundle.format("eight")[0] +
+        bundle.format("nine")[0] +
+        bundle.format("ten")[0] +
+        "tail"
+    )
+
+
+def test_benchmark(fluent_bundle, benchmark):
+    result = benchmark(lambda: fluent_template(fluent_bundle))
+
+
+def test_fluent(fluent_bundle):
+    for _ in range(10000):
+        result = fluent_template(fluent_bundle)

fluent.runtime/tools/benchmarks/requirements.txt

@@ -0,0 +1,2 @@
+pytest
+pytest-benchmark