extractsagecode: add option for extracting only environments

Also, use a different comment prefix for comments output by the
extraction tool.

Author: pv

scripts.dtx

@@ -238,6 +238,8 @@ def argparser():
     p.add_argument('outputfile', nargs='?', default=None, help="Output file name")
     p.add_argument('-o', '--overwrite', action="store_true", default=False,
                    help="Overwrite output file if it exists")
+    p.add_argument('--no-inline', action="store_true", default=False,
+                   help="Extract code only from Sage environments")
     return p
 
 def run(args):
@@ -249,9 +251,9 @@ def run(args):
         sys.exit(1)
 
     src, ext = os.path.splitext(src)
-    sagecode = SageCodeExtractor(src + '.tex')
-    header = ("# This file contains Sage code extracted from %s%s.\n"
-              "# Processed %s.\n"
+    sagecode = SageCodeExtractor(src + '.tex', inline=not args.no_inline)
+    header = ("#> This file contains Sage code extracted from %s%s.\n"
+              "#> Processed %s.\n"
               "" % (src, ext, time.strftime('%a %d %b %Y %H:%M:%S', time.localtime())))
 
     if dst is not None:
@@ -470,7 +472,7 @@ class DeSageTex():
 % Sage.
 %    \begin{macrocode}
 class SageCodeExtractor():
-  def __init__(self, texfn):
+  def __init__(self, texfn, inline=True):
     smacro = sagemacroparser
     smacro.setParseAction(self.macroout)
 
@@ -497,7 +499,10 @@ class SageCodeExtractor():
     sunpause = sagetexunpause
     sunpause.setParseAction(self.unpause)
 
-    doit = smacro | splot | senv | spause | sunpause
+    if inline:
+        doit = smacro | splot | senv | spause | sunpause
+    else:
+        doit = senv | spause | sunpause
     doit.ignore('%' + restOfLine)
 
     str = ''.join(open(texfn, 'r').readlines())
@@ -506,26 +511,26 @@ class SageCodeExtractor():
     doit.transformString(str)
 
   def macroout(self, s, l, t):
-    self.result += '# \\sage{} from line %s\n' % lineno(l, s)
+    self.result += '#> \\sage{} from line %s\n' % lineno(l, s)
     self.result += t.code[1:-1] + '\n\n'
 
   def plotout(self, s, l, t):
-    self.result += '# \\sageplot{} from line %s:\n' % lineno(l, s)
+    self.result += '#> \\sageplot{} from line %s:\n' % lineno(l, s)
     if t.format != '':
-      self.result += '# format: %s' % t.format[0][1:-1] + '\n'
+      self.result += '#> format: %s' % t.format[0][1:-1] + '\n'
     self.result += t.code[1:-1] + '\n\n'
 
   def envout(self, s, l, t):
-    self.result += '# %s environment from line %s:' % (t.env,
+    self.result += '#> %s environment from line %s:' % (t.env,
       lineno(l, s))
     self.result += ''.join(t.code) + '\n'
 
   def pause(self, s, l, t):
-    self.result += ('# SageTeX (probably) paused on input line %s.\n\n' %
+    self.result += ('#> SageTeX (probably) paused on input line %s.\n\n' %
                     (lineno(l, s)))
 
   def unpause(self, s, l, t):
-    self.result += ('# SageTeX (probably) unpaused on input line %s.\n\n' %
+    self.result += ('#> SageTeX (probably) unpaused on input line %s.\n\n' %
                     (lineno(l, s)))
 %    \end{macrocode}
 % \end{macro}