Index: tools/md_browser/md_browser.py |
diff --git a/tools/md_browser/md_browser.py b/tools/md_browser/md_browser.py |
new file mode 100644 |
index 0000000000000000000000000000000000000000..7fb51eb2e8e0de5e19298e5016162d99303048db |
--- /dev/null |
+++ b/tools/md_browser/md_browser.py |
@@ -0,0 +1,102 @@ |
+# Copyright 2015 The Chromium Authors. All rights reserved. |
+# Use of this source code is governed by a BSD-style license that can be |
+# found in the LICENSE file. |
+ |
+"""Simple Markdown browser for a Git checkout.""" |
+from __future__ import print_function |
+ |
+import SimpleHTTPServer |
+import SocketServer |
+import argparse |
+import codecs |
+import os |
+import socket |
+import sys |
+ |
+ |
+THIS_DIR = os.path.abspath(os.path.dirname(__file__)) |
+SRC_DIR = os.path.dirname(os.path.dirname(THIS_DIR)) |
+sys.path.append(os.path.join(SRC_DIR, 'third_party', 'Python-Markdown')) |
+import markdown |
+ |
+ |
+def main(argv): |
+ parser = argparse.ArgumentParser(prog='md_browser') |
+ parser.add_argument('-p', '--port', type=int, default=8080, |
+ help='port to run on (default = %(default)s)') |
+ args = parser.parse_args(argv) |
+ |
+ try: |
+ s = Server(args.port, SRC_DIR) |
+ print("Listening on http://localhost:%s/" % args.port) |
+ s.serve_forever() |
+ s.shutdown() |
+ return 0 |
+ except KeyboardInterrupt: |
+ return 130 |
+ |
+ |
+class Server(SocketServer.TCPServer): |
+ def __init__(self, port, top_level): |
+ SocketServer.TCPServer.__init__(self, ('0.0.0.0', port), Handler) |
+ self.port = port |
+ self.top_level = top_level |
+ |
+ def server_bind(self): |
+ self.socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) |
+ self.socket.bind(self.server_address) |
+ |
+ |
+class Handler(SimpleHTTPServer.SimpleHTTPRequestHandler): |
+ def do_GET(self): |
+ full_path = os.path.abspath(os.path.join(self.server.top_level, |
+ self.path[1:])) |
+ if not full_path.startswith(SRC_DIR): |
+ self._DoUnknown() |
+ elif self.path == '/doc.css': |
+ self._WriteTemplate('doc.css') |
+ elif not os.path.exists(full_path): |
+ self._DoNotFound() |
+ elif self.path.lower().endswith('.md'): |
+ self._DoMD() |
+ else: |
+ self._DoUnknown() |
+ |
+ def _DoMD(self): |
+ extensions = [ |
+ 'markdown.extensions.fenced_code', |
+ 'markdown.extensions.tables', |
+ 'markdown.extensions.toc', |
+ ] |
+ |
+ contents = self._Read(self.path[1:]) |
+ md_fragment = markdown.markdown(contents, |
+ extensions=extensions, |
+ output_format='html4').encode('utf-8') |
+ try: |
+ self._WriteTemplate('header.html') |
+ self.wfile.write(md_fragment) |
+ self._WriteTemplate('footer.html') |
+ except: |
+ raise |
+ |
+ def _DoNotFound(self): |
+ self.wfile.write('<html><body>%s not found</body></html>' % self.path) |
+ |
+ def _DoUnknown(self): |
+ self.wfile.write('<html><body>I do not know how to serve %s.</body>' |
+ '</html>' % self.path) |
+ |
+ def _Read(self, relpath): |
+ assert not relpath.startswith(os.sep) |
+ path = os.path.join(self.server.top_level, relpath) |
+ with codecs.open(path, encoding='utf-8') as fp: |
+ return fp.read() |
+ |
+ def _WriteTemplate(self, template): |
+ contents = self._Read(os.path.join('tools', 'md_browser', template)) |
+ self.wfile.write(contents.encode('utf-8')) |
+ |
+ |
+if __name__ == '__main__': |
+ sys.exit(main(sys.argv[1:])) |