|
9 | 9 |
|
10 | 10 | :Author: Geoffrey Poore |
11 | 11 |
|
12 | | -:Version: 0.9beta3 |
| 12 | +:Version: 0.10beta |
13 | 13 |
|
14 | 14 | :License: LPPL_ (LaTeX code) and `BSD 3-Clause`_ (Python code) |
15 | 15 |
|
|
20 | 20 |
|
21 | 21 | PythonTeX provides fast, user-friendly access to Python from within LaTeX. It allows Python code entered within a LaTeX document to be executed, and the results to be included within the original document. It also provides syntax highlighting for code within LaTeX documents via the Pygments package. |
22 | 22 |
|
23 | | -See pythontex.pdf for installation instructions. See pythontex_gallery.pdf for examples of what is possible with PythonTeX. |
| 23 | +See ``pythontex.pdf`` for installation instructions. See ``pythontex_gallery.pdf`` for examples of what is possible with PythonTeX. |
24 | 24 |
|
25 | 25 |
|
26 | 26 | Current status |
27 | 27 | -------------- |
28 | 28 |
|
29 | | -The 0.9 release has been delayed due to the addition of features that were originally intended for a later release (such as Unicode support). PythonTeX will remain in beta for at least the rest of the summer. But it should already be stable enough for most applications. |
| 29 | +The 0.10beta release will become the first full release with only minor tweaks |
| 30 | +by the end of January, unless major bugs are discovered. As soon as the full |
| 31 | +release is out, PythonTeX will be submitted to CTAN. |
| 32 | + |
| 33 | +Upcoming development will focus on ``depythontex``. |
| 34 | + |
| 35 | + |
| 36 | +Version History |
| 37 | +--------------- |
| 38 | + |
| 39 | +v0.10beta (2013/01/09) |
| 40 | + |
| 41 | +* Backward-incompatible: Redid treatment of command-line options for |
| 42 | + ``pythontex*.py``, using Python's ``argparse`` module. Run |
| 43 | + ``pythontex*.py`` with option ``-h`` to see new command line options. |
| 44 | +* Deprecated: ``\setpythontexcustomcode`` is deprecated in favor of the |
| 45 | + ``\pythontexcustomc`` command and ``pythontexcustomcode`` |
| 46 | + environment. These allow entry of pure code, unlike |
| 47 | + ``\setpythontexcustomcode``. These also allow custom code to be |
| 48 | + added to the beginning or end of a session, via an optional argument. |
| 49 | + Improved treatment of errors and warnings associated with custom |
| 50 | + code. |
| 51 | +* The summary of errors and warnings now correctly differentiates |
| 52 | + errors and warnings produced by user code, rather than treating all |
| 53 | + of them as errors. By default, ``pythontex*.py`` now returns an |
| 54 | + exit code of 1 if there were errors. |
| 55 | +* The PythonTeX utilities class now allows external file dependencies |
| 56 | + to be specified via ``pytex.add_dependencies()``, so that sessions |
| 57 | + are automatically re-executed when external dependencies are |
| 58 | + modified (modification is determined via either hash or mtime; this |
| 59 | + is governed by the new ``hashdependencies`` option). |
| 60 | +* The PythonTeX utilities class now allows created files to be |
| 61 | + specified via ``pytex.add_created()``, so that created files may be |
| 62 | + automatically cleaned up (deleted) when the code that created them |
| 63 | + is modified (for example, name change for a saved plot). |
| 64 | +* Added the following package options. |
| 65 | + |
| 66 | + - ``stdout`` (or ``print``): Allows input of stdout to be disabled. |
| 67 | + Useful for debugging. |
| 68 | + - ``runall``: Executes everything. Useful when code depends on |
| 69 | + external data. |
| 70 | + - ``rerun``: Determines when code is re-executed. Code may be set |
| 71 | + to always run (same as ``runall`` option), or only run when it is |
| 72 | + modified or when it produces errors or warnings. By default, |
| 73 | + code is always re-executed if there are errors or modifications, |
| 74 | + but not re-executed if there are warnings. |
| 75 | + - ``hashdependencies``: Determines whether external dependencies |
| 76 | + (data, external code files highlighted with Pygments, etc.) are |
| 77 | + checked for modification via hashing or modification time. |
| 78 | + Modification time is default for performance reasons. |
| 79 | + |
| 80 | +* Added the following new command line options. The options that are |
| 81 | + equivalent to package options are overridden by the package options |
| 82 | + when present. |
| 83 | + |
| 84 | + - ``--error-exit-code``: Determines whether an exit code of 1 is |
| 85 | + returned if there were errors. On by default, but can be turned |
| 86 | + off since it is undesirable when working with some editors. |
| 87 | + - ``--runall``: Equivalent to new package option. |
| 88 | + - ``--rerun``: Equivalent to new package option. |
| 89 | + - ``--hashdependencies``: Equivalent to new package option. |
| 90 | + |
| 91 | +* Modified the ``fixlr`` option, so that it only patches commands if |
| 92 | + they have not already been patched (avoids package conflicts). |
| 93 | +* Added ``\setpythontexautoprint`` command for toggling autoprint |
| 94 | + on/off within the body of the document. |
| 95 | +* Installer now attempts to create symlinks under OS X and Linux with |
| 96 | + TeX Live, and under OS X with MacPorts Tex Live. |
| 97 | +* Performed compatibility testing under lualatex and xelatex |
| 98 | + (previously, had only tested with pdflatex). Added documentation |
| 99 | + for using these TeX engines; at most, slightly different preambles |
| 100 | + are needed. Modified the PythonTeX gallery to support all three |
| 101 | + engines. |
| 102 | +* Code commands and environments may now be used in the preamble. |
| 103 | + This, combined with the new treatment of custom code, allows |
| 104 | + PythonTeX to be used in creating LaTeX packages. |
| 105 | +* Added documentation for using PythonTeX in LaTeX programming. |
| 106 | +* Fixed a bug that sometimes caused incorrect line numbers with |
| 107 | + ``stderr`` content. Improved processing of stderr. |
| 108 | +* Fixed a bug in automatic detection of pre-existing listings |
| 109 | + environment. |
| 110 | +* Improved the detection of imports from ``__future__``. Detection |
| 111 | + should now be stricter, faster, and more accurate. |
30 | 112 |
|
31 | 113 |
|
32 | | -Change log |
33 | | ----------- |
34 | | - |
35 | 114 | v0.9beta3 (2012/07/17) |
36 | 115 |
|
37 | 116 | * Added Unicode support, which required the Python code to be split into |
|
0 commit comments