Add filename option to code-block

Prepend the given filename to the code block

sphinx/directives/code.py

@@ -57,6 +57,7 @@ class CodeBlock(Directive):
     option_spec = {
         'linenos': directives.flag,
         'emphasize-lines': directives.unchanged_required,
+        'filename': directives.unchanged_required,
     }
 
     def run(self):
@@ -75,6 +76,9 @@ class CodeBlock(Directive):
 
         literal = nodes.literal_block(code, code)
         literal['language'] = self.arguments[0]
+        filename = self.options.get('filename')
+        if filename:
+            literal['filename'] = filename
         literal['linenos'] = 'linenos' in self.options
         if hl_lines is not None:
             literal['highlight_args'] = {'hl_lines': hl_lines}

sphinx/themes/agogo/static/agogo.css_t

@@ -462,3 +462,17 @@ div.viewcode-block:target {
     border-top: 1px solid #ac9;
     border-bottom: 1px solid #ac9;
 }
+
+div.code-block-filename {
+    background-color: #ddd;
+    color: #333;
+    padding: 2px 5px;
+    font-family: monospace;
+    font-size: small;
+}
+
+div.code-block-filename + pre,
+div.code-block-filename + div.highlight,
+div.code-block-filename + div.highlight > pre {
+    margin-top: 0;
+}

sphinx/themes/default/static/default.css_t

@@ -308,3 +308,16 @@ div.viewcode-block:target {
     border-top: 1px solid #ac9;
     border-bottom: 1px solid #ac9;
 }
+
+div.code-block-filename {
+    background-color: #1c4e63;
+    color: #efefef;
+    padding: 2px 5px;
+    font-family: monospace;
+    font-size: small;
+}
+
+div.code-block-filename + pre,
+div.code-block-filename + div.highlight > pre {
+    margin-top: 0;
+}

sphinx/themes/haiku/static/haiku.css_t

@@ -369,3 +369,7 @@ div.viewcode-block:target {
     margin: -1px -10px;
     padding: 0 12px;
 }
+
+div.code-block-filename {
+    font-family: monospace;
+}

sphinx/themes/nature/static/nature.css_t

@@ -243,3 +243,17 @@ div.viewcode-block:target {
     border-top: 1px solid #ac9;
     border-bottom: 1px solid #ac9;
 }
+
+div.code-block-filename {
+    background-color: #ddd;
+    color: #222;
+    border: 1px solid #C6C9CB;
+    padding: 2px 5px;
+    font-family: monospace;
+    font-size: small;
+}
+
+div.code-block-filename + pre,
+div.code-block-filename + div.highlight > pre {
+    margin-top: 0;
+}

sphinx/themes/pyramid/static/pyramid.css_t

@@ -340,3 +340,16 @@ tt.xref {
     font-weight: normal;
     font-style: normal;
 }
+
+div.code-block-filename {
+    background-color: #ddd;
+    color: #222;
+    padding: 2px 5px;
+    font-family: monospace;
+    font-size: small;
+}
+
+div.code-block-filename + pre,
+div.code-block-filename + div.highlight > pre {
+    margin-top: 0;
+}

sphinx/themes/sphinxdoc/static/sphinxdoc.css_t

@@ -337,3 +337,17 @@ div.viewcode-block:target {
     border-top: 1px solid #ac9;
     border-bottom: 1px solid #ac9;
 }
+
+div.code-block-filename {
+    background-color: #ddd;
+    color: #222;
+    border: 1px solid #ccc;
+    padding: 2px 5px;
+    font-family: monospace;
+    font-size: small;
+}
+
+div.code-block-filename + pre,
+div.code-block-filename + div.highlight > pre {
+    margin-top: 0;
+}

sphinx/themes/traditional/static/traditional.css_t

@@ -702,3 +702,15 @@ div.viewcode-block:target {
     margin: -1px -10px;
     padding: 0 10px;
 }
+
+div.code-block-filename {
+    background-color: #cceeff;
+    padding: 2px 5px;
+    font-family: monospace;
+    font-size: small;
+}
+
+div.code-block-filename + pre,
+div.code-block-filename + div.highlight > pre {
+    margin-top: 0;
+}

sphinx/writers/html.py

@@ -256,6 +256,9 @@ class HTMLTranslator(BaseTranslator):
             **highlight_args)
         starttag = self.starttag(node, 'div', suffix='',
                                  CLASS='highlight-%s' % lang)
+        if node.has_key('filename'):
+            starttag += '<div class="code-block-filename">%s</div>' % (
+                node['filename'],)
         self.body.append(starttag + highlighted + '</div>\n')
         raise nodes.SkipNode
 

sphinx/writers/latex.py

@@ -1333,6 +1333,11 @@ class LaTeXTranslator(nodes.NodeVisitor):
             highlight_args['force'] = True
         if 'linenos' in node:
             linenos = node['linenos']
+        filename = node.get('filename')
+        if filename:
+            self.body.append('\n{\\colorbox[rgb]{0.9,0.9,0.9}'
+                             '{\\makebox[\\textwidth][l]'
+                             '{\\small\\texttt{%s}}}}\n' % (filename,))
         def warner(msg):
             self.builder.warn(msg, (self.curfilestack[-1], node.line))
         hlcode = self.highlighter.highlight_block(code, lang, warn=warner,