Scripts to improve QoL at FdI UCM
Keep a series of useful scripts for FdI UCM teachers. Currently oriented towards two workflows:
-
wrangling with Moodle submissions, generating feedback for students in markdown files, and generating pretty pdfs from those files to upload as feedback into Moodle:
- normalize-cv-subs handles uncompressing and, uh, normalizing the submissions; and can create a grading template for you.
- split-by-headers can split the grading template into individual files, so that you can easily convert them to individual feedback pdfs, one per student
- markdown-to-pdf can generate those individual feedback pdfs for you
-
generating nice-looking pdfs and slides from markdown, for use as class notes and slides:
- markdown-to-pdf generates nice class-notes style pdfs from markdown
- markdown-to-beamer generates beamer slides (as pdfs) from markdown
Why use all this markdown-centric workflow? Because many of the subjects and assignments at FdI UCM deal with writing code, and placing code into documents and slides is generally much harder (and looks uglier) than it should be. These scripts can generate beautiful, syntax-highlighted code from snippets:
~~~ {.java}
try {
assertTrue("Tests basicos pasan", mainBasico.test("src/test/resources/basic"));
assertTrue( "Tests avanzados pasan", mainBasico.test("src/test/resources/advanced"));
mainBasico.test("src/test/resources/err");
fail("no da error con una entrada mala");
} // ...
~~~
Output:
(note wrapped long lines; this is very useful when displaying code copied from somewhere without either clipping or tedious manual reformatting).
Python 2.7 script that normalizes Moodle (Campus Virtual) submission names, uncompresses them where you choose, and optionally creates a grading template in Markdown to provide feedback to the students. For example, a submission named
ALFREDO JAVIER BLÁZQUEZ LÓPEZ_2413645_assignsubmission_file_Entrega Práctica 1.7z
would be extracted into a folder named
alfredo_javier_blázquez_lópez-entrega-práctica-1/
python-magic, pyunpack, patool, unzip, unrar, p7zip-full
You can install these in a typical Ubuntu / Debian system running:
sudo apt-get unrar p7zip-full
sudo pip install python-magic pyunpack patool
(output of ./normalize-cv-subs -h)
usage: normalize-cv-subs [-h] [--md MD] [--template TEMPLATE]
source output_dir
Normalize names of Moodle submissions and, if possible, uncompress them into
folders
positional arguments:
source Either a zip-file OR a directory with compressed files
from Moodle
output_dir Output directory, for normalized, extracted submissions
optional arguments:
-h, --help show this help message and exit
--md MD Name of markdown file to add to output, with a top-
level #<name_of_submission> line per submission
--template TEMPLATE If --md specified, file with markdown snippet to append
after each submission-line
## entrega
## funcionalidad
## claridad
## diseño
## nota
alfredo_javier_blázquez_lópez-entrega-práctica-1/
héctor_gómez_ejémplez-p1/
with an extra markdown file thrown in, but only if --md specified (eg.: --md grading.md).
Only written if --md specified (eg.: --md grading.md).
# alfredo_javier_blázquez_lópez-entrega-práctica-1
<template content goes here>
# héctor_gómez_ejémplez-p1
<template content goes here>
Python 2.7 script that splits a Markdown file by top-level headers (# header text), creating one file per such header, with all contents until either the next header or the end of the file. This is useful when splitting a grading output file such as the ones created by normalize_cv_subs
as reported with the -h option:
usage: split-by-headers [-h] input_file
Split a markdown file into subfiles, one per top-level header
positional arguments:
input_file A markdown file to split
optional arguments:
-h, --help show this help message and exit
Python 2.7 script that generates a plain pdf document from a markdown input file. You can call pandoc directly instead of using it.
You will need both pandoc and a latex back-end for this to work. You can instal the latest pandoc from its releases page, and I personally use texlive as a latex back-end. Both have packages for major linux distributions, and windows installers for the linux-unenlightened.
as reported with the -h option:
usage: markdown-to-pdf [-h] input_file
Make a call to pandoc to create a nice pdf file from markdown
positional arguments:
input_file A markdown file to convert to pdf
optional arguments:
-h, --help show this help message and exit
Python 2.7 script that generates a plain pdf document from a markdown input file. You can call pandoc directly instead of using it, and then call pdflatex on the result. However, this script simplifies these steps, and generally takes care of housekeeping for you (deleting unwanted auxiliary pdflatex files, supressing pdflatex output, ...).
You will need both pandoc and a latex back-end for this to work. You can instal the latest pandoc from its releases page, and I personally use texlive as a latex back-end. Both have packages for major linux distributions, and windows installers for the linux-unenlightened.
as reported with the -h option:
usage: markdown-to-beamer [-h] [--v] input_file
Make a call to pandoc & pdflatex to create a nice beamer pdf file from
markdown
positional arguments:
input_file A markdown file to convert to pdf
optional arguments:
-h, --help show this help message and exit
--v Show full pdflatex output; otherwise silence it