Python API for interacting with a TimeAndPlace server
Project description
TimeAndPlace API & CLI Application
This repo contains both a Python3 API, and a command-line application for interacting with @salamander2's TimeAndPlace service over a network. The main reason behind this package is for use in another project I have planned for room occupancy tracking.
What kind of data can be accessed?
Currently, this is mostly a Read-Only API. The following data can be accessed when logged in:
- List of all student IDs
- A particular student's info
- Student location tracking *
* This data can be written via the API
CLI usage
The command-line app uses "action commands" in the format of:
timeandplace --username <username> --password <password> <action> [optional: --endpoint <url>]
A list of possible actions can be viewed by running:
timeandplace help
API usage
All interaction is done via the TimeAndPlace
object. It has the following methods:
client = TimeAndPlace()
client.login(str, str)
# These require login to be called
client.getStudentInfo(int) -> StudentInfo
client.getAllStudents() -> List[int]
client.getAllCourses() -> List[CourseInfo]
client.signInStudentToTerminal(int, int)
client.signOutStudentFromTerminal(int, int)
I recommend taking a look at the single source file for more info on the API.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.