Add initial benchmark suite

.gitignore

@@ -112,3 +112,7 @@ venv.bak/
 
 # mypy
 .mypy_cache/
+
+# airspeed velocity
+benchmarks/env/
+benchmarks/html/

.pre-commit-config.yaml

@@ -29,8 +29,10 @@ repos:
     rev: 22.1.0
     hooks:
       - id: black
+        exclude: ^benchmarks/
   - repo: https://github.com/PyCQA/isort
     rev: 5.10.1
     hooks:
       - id: isort
+        exclude: ^benchmarks/
         args: ["--profile", "black"]

asv.conf.json

@@ -0,0 +1,34 @@
+{
+  "version": 1,
+  "project": "rich",
+  "project_url": "https://github.com/Textualize/rich",
+  "repo": ".",
+  "repo_subdir": "",
+  "install_command": [
+    "in-dir={env_dir} python -mpip install {wheel_file}"
+  ],
+  "uninstall_command": [
+    "return-code=any python -mpip uninstall -y {project}"
+  ],
+  "build_command": [
+    "pip install poetry",
+    "python setup.py build",
+    "PIP_NO_BUILD_ISOLATION=false python -mpip wheel --no-deps --no-index -w {build_cache_dir} {build_dir}"
+  ],
+  "branches": [
+    "master"
+  ],
+  "html_dir": "./benchmarks/html",
+  "results_dir": "./benchmarks/results",
+  "env_dir": "./benchmarks/env",
+  "dvcs": "git",
+  "environment_type": "virtualenv",
+  "install_timeout": 180,
+  "show_commit_url": "http://github.com/Textualize/rich/commit/",
+  "pythons": [
+    "3.10"
+  ],
+  "matrix": {
+    "req": {}
+  }
+}

benchmarks/README.md

@@ -0,0 +1,17 @@
+# Benchmarking Rich
+
+This directory contains benchmarks, for monitoring the performance of Rich over time.
+
+The benchmarks use a tool called [Airspeed Velocity](https://asv.readthedocs.io/en/stable) (`asv`),
+and we've configured it in [asv.conf.json](../asv.conf.json).
+
+## Running Benchmarks
+
+We strongly recommend running `asv run --help` for a full list of options, but
+here are some common actions:
+
+* You can run the benchmarks against the `master` branch with `asv run`.
+* To test the most recent commit on your branch `asv run HEAD^!`.
+* To generate a static website for browsing the results, run `asv publish`. The resulting HTML can be found in `benchmarks/html`.
+
+The asv docs have some more examples [here](https://asv.readthedocs.io/en/stable/using.html#benchmarking).

benchmarks/benchmarks.py

@@ -0,0 +1,193 @@
+from io import StringIO
+
+from benchmarks import snippets
+from rich.color import Color, ColorSystem
+from rich.console import Console
+from rich.pretty import Pretty
+from rich.style import Style
+from rich.syntax import Syntax
+from rich.table import Table
+from rich.text import Text
+
+
+class TextSuite:
+    def setup(self):
+        self.console = Console(
+            file=StringIO(), color_system="truecolor", legacy_windows=False
+        )
+        self.len_lorem_ipsum = len(snippets.LOREM_IPSUM)
+
+    def time_wrapping(self):
+        Text(snippets.LOREM_IPSUM).wrap(self.console, 12, overflow="fold")
+
+    def time_indent_guides(self):
+        Text(snippets.PYTHON_SNIPPET).with_indent_guides()
+
+    def time_fit(self):
+        Text(snippets.LOREM_IPSUM).fit(12)
+
+    def time_split(self):
+        Text(snippets.LOREM_IPSUM).split()
+
+    def time_divide(self):
+        Text(snippets.LOREM_IPSUM).divide(range(20, 100, 4))
+
+    def time_align_center(self):
+        Text(snippets.LOREM_IPSUM).align("center", width=self.len_lorem_ipsum * 3)
+
+    def time_render(self):
+        Text(snippets.LOREM_IPSUM).render(self.console)
+
+    def time_wrapping_unicode_heavy(self):
+        Text(snippets.UNICODE_HEAVY_TEXT).wrap(self.console, 12, overflow="fold")
+
+    def time_fit_unicode_heavy(self):
+        Text(snippets.UNICODE_HEAVY_TEXT).fit(12)
+
+    def time_split_unicode_heavy(self):
+        Text(snippets.UNICODE_HEAVY_TEXT).split()
+
+    def time_divide_unicode_heavy(self):
+        Text(snippets.UNICODE_HEAVY_TEXT).divide(range(20, 100, 4))
+
+    def time_align_center_unicode_heavy(self):
+        Text(snippets.UNICODE_HEAVY_TEXT).align(
+            "center", width=self.len_lorem_ipsum * 3
+        )
+
+    def time_render_unicode_heavy(self):
+        Text(snippets.UNICODE_HEAVY_TEXT).render(self.console)
+
+
+class SyntaxWrappingSuite:
+    def setup(self):
+        self.console = Console(
+            file=StringIO(), color_system="truecolor", legacy_windows=False
+        )
+        self.syntax = Syntax(
+            code=snippets.PYTHON_SNIPPET, lexer="python", word_wrap=True
+        )
+
+    def time_text_thin_terminal_heavy_wrapping(self):
+        self._print_with_width(20)
+
+    def time_text_thin_terminal_medium_wrapping(self):
+        self._print_with_width(60)
+
+    def time_text_wide_terminal_no_wrapping(self):
+        self._print_with_width(100)
+
+    def _print_with_width(self, width):
+        self.console.print(self.syntax, width)
+
+
+class TableSuite:
+    def time_table_no_wrapping(self):
+        self._print_table(width=100)
+
+    def time_table_heavy_wrapping(self):
+        self._print_table(width=30)
+
+    def _print_table(self, width):
+        table = Table(title="Star Wars Movies")
+        console = Console(
+            file=StringIO(), color_system="truecolor", legacy_windows=False, width=width
+        )
+        table.add_column("Released", justify="right", style="cyan", no_wrap=True)
+        table.add_column("Title", style="magenta")
+        table.add_column("Box Office", justify="right", style="green")
+        table.add_row(
+            "Dec 20, 2019", "[b]Star Wars[/]: The Rise of Skywalker", "$952,110,690"
+        )
+        table.add_row(
+            "May 25, 2018", "Solo: A [red][b]Star Wars[/] Story[/]", "$393,151,347"
+        )
+        table.add_row(
+            "Dec 15, 2017",
+            "[b red]Star Wars[/] Ep. V111: The Last Jedi",
+            "$1,332,539,889",
+        )
+        table.add_row(
+            "Dec 16, 2016", "Rogue One: A [blue]Star Wars[/] Story", "$1,332,439,889"
+        )
+        console.print(table)
+
+
+class PrettySuite:
+    def setup(self):
+        self.console = Console(
+            file=StringIO(), color_system="truecolor", legacy_windows=False, width=100
+        )
+
+    def time_pretty(self):
+        pretty = Pretty(snippets.PYTHON_DICT)
+        self.console.print(pretty)
+
+    def time_pretty_indent_guides(self):
+        pretty = Pretty(snippets.PYTHON_DICT, indent_guides=True)
+        self.console.print(pretty)
+
+    def time_pretty_justify_center(self):
+        pretty = Pretty(snippets.PYTHON_DICT, justify="center")
+        self.console.print(pretty)
+
+
+class StyleSuite:
+    def setup(self):
+        self.console = Console(
+            file=StringIO(), color_system="truecolor", legacy_windows=False, width=100
+        )
+
+    def time_parse_ansi(self):
+        Style.parse("red on blue")
+
+    def time_parse_hex(self):
+        Style.parse("#f0f0f0 on #e2e28a")
+
+    def time_parse_mixed_complex_style(self):
+        Style.parse("dim bold reverse #00ee00 on rgb(123,12,50)")
+
+
+class ColorSuite:
+    def setup(self):
+        self.console = Console(
+            file=StringIO(), color_system="truecolor", legacy_windows=False, width=100
+        )
+        self.color = Color.parse("#0d1da0")
+
+    def time_downgrade_to_eight_bit(self):
+        self.color.downgrade(ColorSystem.EIGHT_BIT)
+
+    def time_downgrade_to_standard(self):
+        self.color.downgrade(ColorSystem.STANDARD)
+
+    def time_downgrade_to_windows(self):
+        self.color.downgrade(ColorSystem.WINDOWS)
+
+
+class ColorSuiteCached:
+    def setup(self):
+        self.console = Console(
+            file=StringIO(), color_system="truecolor", legacy_windows=False, width=100
+        )
+        self.color = Color.parse("#0d1da0")
+        # Warm cache
+        self.color.downgrade(ColorSystem.EIGHT_BIT)
+        self.color.downgrade(ColorSystem.STANDARD)
+        self.color.downgrade(ColorSystem.WINDOWS)
+
+    def time_downgrade_to_eight_bit(self):
+        self.color.downgrade(ColorSystem.EIGHT_BIT)
+
+    def time_downgrade_to_standard(self):
+        self.color.downgrade(ColorSystem.STANDARD)
+
+    def time_downgrade_to_windows(self):
+        self.color.downgrade(ColorSystem.WINDOWS)
+
+
+class SegmentSuite:
+    def setup(self):
+        self.console = Console(
+            file=StringIO(), color_system="truecolor", legacy_windows=False, width=100
+        )