From dbac9aa8ec859b15b6844a1090df0b1b9bb38ab4 Mon Sep 17 00:00:00 2001
From: Takeshi KOMIYA <i.tkomiya@gmail.com>
Date: Fri, 19 Aug 2016 20:16:02 +0900
Subject: [PATCH] Add compile_grammar command to setup.py (ref: #2765)

---
 setup.py                | 31 ++++++++++++++++++++++++++-----
 utils/release-checklist |  1 +
 2 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/setup.py b/setup.py
index ef7f5da09..1b5517917 100644
--- a/setup.py
+++ b/setup.py
@@ -4,9 +4,9 @@ from setuptools import setup, find_packages
 import os
 import sys
 from distutils import log
+from distutils.cmd import Command
 
 import sphinx
-from sphinx.pycode.pgen2.driver import compile_grammar
 
 long_desc = '''
 Sphinx is a tool that makes it easy to create intelligent and beautiful
@@ -73,10 +73,6 @@ extras_require = {
 if sys.platform == 'win32':
     requires.append('colorama>=0.3.5')
 
-# Compile grammars before packaging
-compile_grammar('sphinx/pycode/Grammar-py2.txt')
-compile_grammar('sphinx/pycode/Grammar-py3.txt')
-
 # Provide a "compile_catalog" command that also creates the translated
 # JavaScript files if Babel is available.
 
@@ -173,6 +169,31 @@ else:
     cmdclass['compile_catalog'] = compile_catalog_plusjs
 
 
+class CompileGrammarCommand(Command):
+    description = 'Compile python grammar file for pycode'
+    user_options = []
+
+    def initialize_options(self):
+        pass
+
+    def finalize_options(self):
+        pass
+
+    def run(self):
+        from sphinx.pycode.pgen2.driver import compile_grammar
+
+        compile_grammar('sphinx/pycode/Grammar-py2.txt')
+        print('sphinx/pycode/Grammar-py2.txt ... done')
+
+        compile_grammar('sphinx/pycode/Grammar-py3.txt')
+        print('sphinx/pycode/Grammar-py3.txt ... done')
+
+    def sub_commands(self):
+        pass
+
+cmdclass['compile_grammar'] = CompileGrammarCommand
+
+
 setup(
     name='Sphinx',
     version=sphinx.__version__,
diff --git a/utils/release-checklist b/utils/release-checklist
index 3dd52158c..b73a191f9 100644
--- a/utils/release-checklist
+++ b/utils/release-checklist
@@ -9,6 +9,7 @@ Release checklist
 * Update release date in CHANGES
 * `git commit -am 'Bump to x.y.z final'`
 * `make clean`
+* `python setup.py compile_grammar`
 * `python setup.py release bdist_wheel sdist upload --identity=[your key]`
 * Check PyPI release page for obvious errors
 * `git tag` with version number