From cce638a8adf4e045ca5505afea4bda57753c31dd Mon Sep 17 00:00:00 2001
From: Micah Anderson <micah@riseup.net>
Date: Mon, 11 Aug 2014 16:33:29 -0400
Subject: initial import of debian package

---
 docs/autogen_api.py | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100755 docs/autogen_api.py

(limited to 'docs/autogen_api.py')

diff --git a/docs/autogen_api.py b/docs/autogen_api.py
new file mode 100755
index 0000000..004c461
--- /dev/null
+++ b/docs/autogen_api.py
@@ -0,0 +1,48 @@
+#!/usr/bin/env python
+"""Script to auto-generate our API docs.
+"""
+# stdlib imports
+import os
+import sys
+
+# local imports
+sys.path.append(os.path.abspath('sphinxext'))
+# import sphinx_cython
+from apigen import ApiDocWriter
+
+#*****************************************************************************
+if __name__ == '__main__':
+    pjoin = os.path.join
+    package = 'zmq'
+    outdir = pjoin('source','api','generated')
+    docwriter = ApiDocWriter(package,rst_extension='.rst')
+    # You have to escape the . here because . is a special char for regexps.
+    # You must do make clean if you change this!
+    docwriter.package_skip_patterns += [
+        r'\.tests$',
+        r'\.backend$',
+        r'\.auth$',
+        r'\.eventloop\.minitornado$',
+        r'\.green\.eventloop$',
+        r'\.sugar$',
+        r'\.devices$',
+    ]
+
+    docwriter.module_skip_patterns += [
+        r'\.eventloop\.stack_context$',
+        r'\.error$',
+        r'\.green\..+$',
+        r'\.utils\.initthreads$',
+        r'\.utils\.constant_names$',
+        r'\.utils\.garbage$',
+        r'\.utils\.rebuffer$',
+        r'\.utils\.strtypes$',
+        ]
+    
+    # Now, generate the outputs
+    docwriter.write_api_docs(outdir)
+    docwriter.write_index(outdir, 'gen',
+                          relative_to = pjoin('source','api')
+                          )
+    
+    print('%d files written' % len(docwriter.written_modules))
-- 
cgit v1.2.3