Iet uz failu
Bertrand Benjamin 3c39a42562
continuous-integration/drone/push Build is passing Papildu informācija
Fix: correct README according to simple example
2022-08-06 20:29:02 +02:00
bopytex Fix: run pre-commit hooks 2022-07-28 09:39:51 +02:00
documentation Fix: run pre-commit hooks 2022-07-28 09:39:51 +02:00
example Feat: produce joined_example.pdf for the two examples 2022-08-06 18:04:46 +02:00
test Fix: run pre-commit hooks 2022-07-28 09:39:51 +02:00
.drone.yml Fix: add latexmk 2022-07-29 15:20:30 +02:00
.gitignore core: remove tests from .gitignore 2022-04-14 11:29:39 +02:00
.pre-commit-config.yaml Core: add pre-commit config 2022-07-28 09:39:20 +02:00
Dockerfile.simple Feat: move Dockerfile to Dockerfile.simple 2022-07-19 17:28:19 +02:00
Dockerfile.usecase Feat: rename dockerfile from mapytex to usecase 2022-07-19 17:13:23 +02:00
MANIFEST.in spelling and wrong arg 2015-05-16 10:50:03 +02:00
Makefile Feat: produce joined_example.pdf for the two examples 2022-08-06 18:04:46 +02:00
README.md Fix: correct README according to simple example 2022-08-06 20:29:02 +02:00
poetry.lock Core: add pytest in dev-dependencies 2022-07-28 15:02:27 +02:00
pyproject.toml Core: add pytest in dev-dependencies 2022-07-28 15:02:27 +02:00
requirements.txt Feat: Create dockerfile to test in new env 2022-05-04 18:03:58 +02:00
setup.py Feat: dockerfile to test bopytex in new environment 2022-05-08 09:15:13 +02:00
tox.ini Core: add tox for testing 2022-07-28 10:07:21 +02:00

README.md

Bopytex

Build Status

Bopytex is a command line tool which embed python into latex. It uses jinja2 to do so with a modified environnement to match with latex syntax.

Installing

Bopytex depends on texlive and textlive-extra-utils (for latexmk and pdfjoin)

Install and update using pip

pip install -U bopytex

Simple example

% save this as tpl_simple.tex
\documentclass[12pt]{article}

\title{Bopytex example -- {{ number }}}

\begin{document}

\maketitle
%- set a = 10
%- set n = 2
We have two variables
\begin{itemize}
    \item a: \Var{a}
    \item n: \Var{n}
\end{itemize}

\section{Variables}
\subsection{subject}
\begin{itemize}
%- for k,v in subject.items()
    \item
\begin{verbatim}
    \Var{k}: \Var{v}
\end{verbatim}
%- endfor
\end{itemize}
\subsection{options}
\begin{itemize}
%- for k,v in options.items()
    \item
\begin{verbatim}
    \Var{k}: \Var{v}
\end{verbatim}
%- endfor
\end{itemize}

\end{document}

The following command produces the joined_example.pdf document

$ bopytex tpl_simple.tex

How I use it

I build this program to produce individual exams subjects for each of my student with the correction associated. I write a template, and bopytex build subject and correction.

To produce formulas and values, I use an another tool I an developing: mapytex <https://git.opytex.org/lafrite/Mapytex. I am importing it through bopytex_config.py.

# bopytex_config.py
from mapytex import Expression

random.seed(0) # Controlling the seed allows to make subject reproductible

direct_access = {
    "Expression": Expression,
}

Every variables, objects or function inside this file will be available inside the template.

% tpl_example.tpl
\documentclass[12pt]{article}

\title{Bopytex with Mapytex example -- \Var{ subject.name }}

\begin{document}

\maketitle

%- set e = Expression.random("{a} + {b}")
\Var{e}

\Var{e.simplify()}


\section{Variables}
\subsection{subject}
\begin{itemize}
%- for k,v in subject.items()
    \item
\begin{verbatim}
    \Var{k}: \Var{v}
\end{verbatim}
%- endfor
\end{itemize}
\subsection{options}
\begin{itemize}
%- for k,v in options.items()
    \item
\begin{verbatim}
    \Var{k}: \Var{v}
\end{verbatim}
%- endfor
\end{itemize}

\end{document}

Information about my students are stored in a csv file (here students.csv)

"Name","Age","Email","fraction level","calculus level"
"Spike Tucker","22","s.tucker@randatmail.com","7","3"
"Martin Payne","21","m.payne@randatmail.com","7","3"
"Kimberly Baker","20","k.baker@randatmail.com","1","8"
"Emma Bailey","29","e.bailey@randatmail.com","2","5"
"Nicholas Taylor","28","n.taylor@randatmail.com","3","3"

Then I can produce a subject for each of my student

$ bopytex tpl_simple.tex -s students.csv -c bopytex_config.py

Running examples

I build two examples base of the simple example and how I use it. They are playable through dockerfiles with make commands.

For the simple example

make docker-simple

For how I use it

make docker-usecase