Skip to main content

Tools to help with running a semester based course

Project description

A package of scripts and tools to make running a class or lab easier.

Description

This 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.

Installation

This is a standard python package and can be installed using pip. From PyPI, this is pip install semster, and from the repository, simply use pip install -e . to install (will still be editable). The requirements.txt file contains the Python requirements, like plumbum. The easiest way to get the requirements on Mac, Linux, or Windows is to install Anaconda. If you are familiar with Conda’s env tool, you can use the environment.yml file to prepare a virtual environment for semester.

Other requirements: this needs pandoc (for creating different output formats) and ImageMagick (for the figure conversion). Currently these are required. Optional components include PyQT (for some of the GUIs).

Tools

The main program is a command line launcher for the scripts. Simply run semester or python -m semester to 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 the python -m runnable module syntax can be used).

Assignments

This can be run as semester assignments or semester.assignments. Makes assignments from markdown files using Pandoc. Processes all *.mkd files if no file given. Options include -a to make an answer key, -o to set the output format(s), and -p to prepend a file to each markdown file. Will try to prepend prepend.rst if no file given.

The format of the .rst files should be as follows:

  • A numbered list indicating questions

  • A stared sublist denoting answers, with values in parenthesis

For 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 files postlab1.mkd or homework1.mkd, they will be nicely typeset here.

Figures

The problem with these assignments, while they support latex math and markdown formating, putting images in can be hard. The semester figures command allows you to create the required copies of a .tex image written in Tikz to insert into an assignment. See the examples folder.

Roster

This 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.

Init

A package for creating new semester files, such as syllabi, teaching guidelines, schedule handouts. Has an optional GUI.

Grades

This 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.

Canvas

A small utility to assist grading in Canvas when yo set a 0 point question (for just in time teaching style, for example).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

semester-0.1.1.zip (28.7 kB view details)

Uploaded Source

semester-0.1.1.tar.gz (19.9 kB view details)

Uploaded Source

File details

Details for the file semester-0.1.1.zip.

File metadata

  • Download URL: semester-0.1.1.zip
  • Upload date:
  • Size: 28.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for semester-0.1.1.zip
Algorithm Hash digest
SHA256 d3a5f65b7ce014710f932d930e9d847e040a8b6ac759d915586ee08156d37d63
MD5 1a93e39a3800c8238949930ad3882e84
BLAKE2b-256 dfb85614935c6961f0c385a5673a017a7fdc58e2a6178a0bec22aceb34703f48

See more details on using hashes here.

File details

Details for the file semester-0.1.1.tar.gz.

File metadata

  • Download URL: semester-0.1.1.tar.gz
  • Upload date:
  • Size: 19.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for semester-0.1.1.tar.gz
Algorithm Hash digest
SHA256 20fbb8d33c94614629e1bd63d009cba30175a9b2320d7024d27dbee101313af2
MD5 8c66fb3cd2b4caef9172a1310734cd26
BLAKE2b-256 919808ebc4ccadadc4342106fdb612bf0cb3603076abd376667f3f1e9ba652f6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page