Use the "sphinx-copybutton" extension in documentation

chaco/__init__.py

@@ -15,6 +15,6 @@
 
 
 __extras_require__ = {
-    "docs": ["enthought-sphinx-theme", "sphinx"],
+    "docs": ["enthought-sphinx-theme", "sphinx", "sphinx-copybutton"],
     'examples': ['encore', 'scipy', 'pandas']
 }

ci/edmtool.py

@@ -95,6 +95,8 @@
     "swig",
 }
 
+pypi_dependencies = {"sphinx-copybutton"}
+
 # Dependencies we install from source for cron tests
 # Order from packages with the most dependencies to one with the least
 # dependencies. Packages are forced re-installed in this order.
@@ -215,6 +217,12 @@ def install(runtime, toolkit, environment, editable, source):
          " --no-dependencies"),
     ]
 
+    if pypi_dependencies:
+        commands.extend([
+            "edm run -e {environment} -- python -m pip install " + dep
+            for dep in pypi_dependencies
+        ])
+
     click.echo("Creating environment '{environment}'".format(**parameters))
     execute(commands, parameters)
 

docs/source/conf.py

@@ -34,6 +34,7 @@ def get_build_docset():
   'sphinx.ext.graphviz',
   'sphinx.ext.intersphinx',
   'sphinx.ext.todo',
+  'sphinx_copybutton',
   'traits.util.trait_documenter',
 ]
 
@@ -94,6 +95,12 @@ def get_build_docset():
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = 'sphinx'
 
+# Options for Sphinx copybutton extension
+# ---------------------------------------
+
+# Matches prompts - "$ ", ">>>" and "..."
+copybutton_prompt_text = r">>> |\.\.\. |\$ "
+copybutton_prompt_is_regexp = True
 
 # Options for HTML output
 # -----------------------