Package: semester
A package of scripts and tools to make running a class or lab easier.DescriptionThis package contains several tools that greatly ease starting a new semester. It
was written for a lab course at the University of Texas at Austin, but most of the
components should be general enough to use for other systems. Contributions
to generalize the system are welcome.InstallationThis is a standard python package and can be installed using pip. From
PyPI, this ispip install semster, and from the repository, simply
usepip install -e .to install (will still be editable). Therequirements.txtfile contains the Python requirements, likeplumbum. The easiest way to
get the requirements on Mac, Linux, or Windows is to install Anaconda.
If you are familiar with Conda’senvtool, you can use theenvironment.ymlfile to prepare a virtual
environment for semester.Other requirements: this needspandoc(for creating different output formats) andImageMagick(for the figure conversion). Currently these are required. Optional
components includePyQT(for some of the GUIs).ToolsThe main program is a command line launcher for the scripts. Simply runsemesterorpython -m semesterto
see a list of the programs. All the programs have a shortcut, too, so this is just for
convenience. Shortcuts are added to the python path for the programs (or thepython -mrunnable module syntax can be used).AssignmentsThis can be run assemester assignmentsorsemester.assignments. Makes assignments
from markdown files using Pandoc. Processes all*.mkdfiles if no file given. Options include-ato make an answer key,-oto set the output format(s), and-pto prepend a file to each
markdown file. Will try to prependprepend.rstif no file given.The format of the.rstfiles should be as follows:A numbered list indicating questionsA stared sublist denoting answers, with values in parenthesisFor example:1. First question
    * First part of answer (2)
    * Answers can have multiple parts(3)The prepend file goes at the beginning, and can contain{name}, which will be based on the filename.
If you name your filespostlab1.mkdorhomework1.mkd, they will be nicely typeset here.FiguresThe problem with these assignments, while they support latex math and markdown formating, putting images in can be hard. Thesemester figurescommand allows you to create the required copies of a .tex image written in Tikz to insert into an assignment. See the examples folder.RosterThis allows you to take a CLIPs roster and make a printable roster that you can use to grade with.A gui.roster option allows simple usage from a GUI.InitA package for creating new semester files, such as syllabi, teaching guidelines, schedule handouts. Has an optional GUI.NoteComing soon!GradesThis allows you to grade a set of canvas classes (1 or more) with a powerful GUI. Download the file(s) from Canvas export and then open them
with this program (if you open the program without an argument, it will ask you for a file with a GUI).Once open, you can drag to set grades and there are buttons to save files in different formats.CanvasA small utility to assist grading in Canvas when yo set a 0 point question (for just in time teaching style, for example).NoteComing soon!