https://github.com/sematre/tg-api
Unofficial TG-Timetable API for Java
https://github.com/sematre/tg-api
api java tg timetable
Last synced: 2 months ago
JSON representation
Unofficial TG-Timetable API for Java
- Host: GitHub
- URL: https://github.com/sematre/tg-api
- Owner: Sematre
- License: mit
- Created: 2019-01-26T14:36:58.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-09-03T13:13:14.000Z (about 3 years ago)
- Last Synced: 2025-01-02T20:36:29.640Z (9 months ago)
- Topics: api, java, tg, timetable
- Language: Java
- Size: 53.7 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TG-API
[![Release Version][release-image]][release-url]
[![Maven Version][maven-image]][maven-url]
[![Build Status][travis-image]][travis-url]
[![License][license-image]][license-url]
> Unofficial TG-Timetable API for Java.
A Java library to get the current timetable from your DSBmobile account.
## Code example
A very simple example to get the timetable.
```java
TG tg = new TG("username", "password");
TimeTable timeTable = tg.getTimeTable();
Date lastChange = timeTable.getDate();
for (Table table : timeTable.getTables()) {
Date targetDate = table.getDate();
for (TableEntry tableEntry : table.getTableEntries()) {
String schoolClass = tableEntry.getSchoolClass();
String time = tableEntry.getTime();
String type = tableEntry.getType();
String subject = tableEntry.getSubject();
String replacementSubject = tableEntry.getReplacementSubject();
String room = tableEntry.getRoom();
String replacementRoom = tableEntry.getReplacementRoom();
String text = tableEntry.getText();
}
}
```
Some options:
- If you like to summarize the timetable, you can appand ``.summarize()`` behind ``tg.getTimeTable()``. Would look like this:
``TimeTable timeTable = tg.getTimeTable().summarize();``
- Another option is the ``.split()`` methode, witch also appand behind ``tg.getTimeTable()``. It splits the TableEntry, if there are more then one classes in the ``schoolClass`` field.
- The third option is the ``.sort()`` methode. It sorts the time table alphabetic (0-9, A-Z) by the class name.
News:
```java
TG tg = new TG("username", "password");
ArrayList newsList = tg.getNews();
for (News news : newsList) {
UUID uuid = news.getUUID();
Date date = news.getDate();
String title = news.getTitle();
String text = news.getText();
}
```
## Implementation
Gradle:
```gradle
dependencies {
implementation 'de.sematre.tg:TG-API:1.12'
}
```
Maven:
```xml
de.sematre.tg
TG-API
1.12
```
## Release History
* 1.12
* News implementation
* 1.7 / 1.8 / 1.9 / 1.10 / 1.11
* DSBmobile-API update
* 1.6
* Add ``sort()`` function to TimeTable
* Remove non ASCII character 0xA0 from input
* 1.5
* Add ``sort()`` function
* 1.4
* Dependencies update
* Charset fix
* 1.3
* Maven implementation
* 1.2
* DSBmobile-API update
* 1.1
* Java 7 compatibility
* ``toString()`` update
* 1.0
* Initial version
## Dependencies
- [Google Gson](https://github.com/google/gson) ([Apache 2 license](https://github.com/google/gson/blob/master/LICENSE)).
- [Jsoup](https://jsoup.org/) ([MIT License](https://jsoup.org/license)).
## Info
© Sematre 2019
Distributed under the **MIT License**. See ``LICENSE`` for more information.
[release-image]: https://img.shields.io/github/release/Sematre/TG-API.svg?style=flat-square
[release-url]: https://github.com/Sematre/TG-API/releases/latest
[maven-image]: https://img.shields.io/maven-central/v/de.sematre.tg/TG-API.svg?style=flat-square
[maven-url]: https://search.maven.org/artifact/de.sematre.tg/TG-API/
[travis-image]: https://img.shields.io/travis/com/Sematre/TG-API.svg?style=flat-square
[travis-url]: https://travis-ci.com/Sematre/TG-API
[license-image]: https://img.shields.io/github/license/Sematre/TG-API.svg?style=flat-square
[license-url]: https://github.com/Sematre/TG-API/blob/master/LICENSE