##// END OF EJS Templates
command.extend in pandoc
MinRK -
Show More
@@ -1,56 +1,56 b''
1 """Utility for calling pandoc"""
1 """Utility for calling pandoc"""
2 #-----------------------------------------------------------------------------
2 #-----------------------------------------------------------------------------
3 # Copyright (c) 2013 the IPython Development Team.
3 # Copyright (c) 2013 the IPython Development Team.
4 #
4 #
5 # Distributed under the terms of the Modified BSD License.
5 # Distributed under the terms of the Modified BSD License.
6 #
6 #
7 # The full license is in the file COPYING.txt, distributed with this software.
7 # The full license is in the file COPYING.txt, distributed with this software.
8 #-----------------------------------------------------------------------------
8 #-----------------------------------------------------------------------------
9
9
10 #-----------------------------------------------------------------------------
10 #-----------------------------------------------------------------------------
11 # Imports
11 # Imports
12 #-----------------------------------------------------------------------------
12 #-----------------------------------------------------------------------------
13
13
14 from __future__ import print_function
14 from __future__ import print_function
15
15
16 # Stdlib imports
16 # Stdlib imports
17 import sys
17 import sys
18 import subprocess
18 import subprocess
19
19
20 # IPython imports
20 # IPython imports
21 from IPython.utils.py3compat import cast_bytes
21 from IPython.utils.py3compat import cast_bytes
22
22
23 #-----------------------------------------------------------------------------
23 #-----------------------------------------------------------------------------
24 # Classes and functions
24 # Classes and functions
25 #-----------------------------------------------------------------------------
25 #-----------------------------------------------------------------------------
26
26
27 def pandoc(source, fmt, to, extra_args=None, encoding='utf-8'):
27 def pandoc(source, fmt, to, extra_args=None, encoding='utf-8'):
28 """Convert an input string in format `from` to format `to` via pandoc.
28 """Convert an input string in format `from` to format `to` via pandoc.
29
29
30 This function will raise an error if pandoc is not installed.
30 This function will raise an error if pandoc is not installed.
31 Any error messages generated by pandoc are printed to stderr.
31 Any error messages generated by pandoc are printed to stderr.
32
32
33 Parameters
33 Parameters
34 ----------
34 ----------
35 source : string
35 source : string
36 Input string, assumed to be valid format `from`.
36 Input string, assumed to be valid format `from`.
37 fmt : string
37 fmt : string
38 The name of the input format (markdown, etc.)
38 The name of the input format (markdown, etc.)
39 to : string
39 to : string
40 The name of the output format (html, etc.)
40 The name of the output format (html, etc.)
41
41
42 Returns
42 Returns
43 -------
43 -------
44 out : unicode
44 out : unicode
45 Output as returned by pandoc.
45 Output as returned by pandoc.
46 """
46 """
47 command = ['pandoc', '-f', fmt, '-t', to]
47 command = ['pandoc', '-f', fmt, '-t', to]
48 if extra_args:
48 if extra_args:
49 command = command + extra_args
49 command.extend(extra_args)
50 p = subprocess.Popen(command,
50 p = subprocess.Popen(command,
51 stdin=subprocess.PIPE, stdout=subprocess.PIPE
51 stdin=subprocess.PIPE, stdout=subprocess.PIPE
52 )
52 )
53 out, _ = p.communicate(cast_bytes(source, encoding))
53 out, _ = p.communicate(cast_bytes(source, encoding))
54 out = out.decode(encoding, 'replace')
54 out = out.decode(encoding, 'replace')
55 return out[:-1]
55 return out[:-1]
56
56
General Comments 0
You need to be logged in to leave comments. Login now