blob: 3165301bd89f34f7fd9c8b2e2c807434aeb8d6c7 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
# PyLuaTeX
**Execute Python code on the fly in your LaTeX documents**
PyLuaTeX allows you to execute Python code and to include the resulting output in your LaTeX documents in a *single compilation run*.
LaTeX documents must be compiled with LuaLaTeX for this to work.
## Example
1\. LaTeX document `example.tex`
**Note:** PyLuaTeX starts Python 3 using the command `python3` by default.
If `python3` does not start Python 3 on your system, find the correct command
and replace `\usepackage{pyluatex}` with `\usepackage[executable={your python command}]{pyluatex}`.
For example, `\usepackage[executable=python.exe]{pyluatex}`.
```latex
\documentclass{article}
\usepackage{pyluatex}
\begin{python}
import math
import random
random.seed(0)
greeting = 'Hello PyLuaTeX!'
\end{python}
\newcommand{\randint}[2]{\py{random.randint(#1, #2)}}
\begin{document}
\py{greeting}
$\sqrt{371} = \py{math.sqrt(371)}$
\randint{2}{5}
\end{document}
```
2\. Compile using LuaLaTeX (shell escape is required)
```
lualatex -shell-escape example.tex
```
**Note:** Running LaTeX with the shell escape option enabled allows arbitrary code to be
executed. For this reason, it is recommended to compile trusted documents only.
## Requirements
* LuaLaTeX
* Python 3
* Linux, macOS or Windows
Our automated tests currently use TeX Live 2021 and Python 3.7+ on
Ubuntu 20.04, macOS Catalina 10.15 and Windows Server 2019.
## License
[LPPL 1.3c](http://www.latex-project.org/lppl.txt) for LaTeX code and
[MIT license](https://opensource.org/licenses/MIT) for Python and Lua code.
We use the great [json.lua](https://github.com/rxi/json.lua) library under the terms
of the [MIT license](https://opensource.org/licenses/MIT).
## Further Information
Author: Tobias Enderle
Development: https://github.com/tndrle/PyLuaTeX
|
