{"id":16260714,"url":"https://github.com/dargmuesli/plm-jar-builder","last_synced_at":"2026-04-24T16:06:10.023Z","repository":{"id":72843331,"uuid":"108180418","full_name":"dargmuesli/PLM-Jar-Builder","owner":"dargmuesli","description":"Creates .jar files for university Kassel eecs/plm Java projects.","archived":false,"fork":false,"pushed_at":"2020-10-05T01:23:34.000Z","size":223,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-08T14:14:00.300Z","etag":null,"topics":["builder","java","module","powershell","project","university"],"latest_commit_sha":null,"homepage":null,"language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dargmuesli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-24T20:33:37.000Z","updated_at":"2020-10-05T01:23:33.000Z","dependencies_parsed_at":"2023-07-21T10:16:43.028Z","dependency_job_id":null,"html_url":"https://github.com/dargmuesli/PLM-Jar-Builder","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/dargmuesli/PLM-Jar-Builder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dargmuesli%2FPLM-Jar-Builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dargmuesli%2FPLM-Jar-Builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dargmuesli%2FPLM-Jar-Builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dargmuesli%2FPLM-Jar-Builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dargmuesli","download_url":"https://codeload.github.com/dargmuesli/PLM-Jar-Builder/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dargmuesli%2FPLM-Jar-Builder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32230437,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["builder","java","module","powershell","project","university"],"created_at":"2024-10-10T16:20:53.238Z","updated_at":"2026-04-24T16:06:10.008Z","avatar_url":"https://github.com/dargmuesli.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build status](https://ci.appveyor.com/api/projects/status/ba8i29gqp62lw4rp/branch/master?svg=true)](https://ci.appveyor.com/project/Dargmuesli/plm-jar-builder/branch/master)\n\n# PLM-Jar-Builder\nErstellt .jar-Dateien für EECS/PLM Java-Projekte an der Universität Kassel.\n\n## Inhaltsverzeichnis\n1. **[Disclaimer](#Disclaimer)**\n2. **[Hintergrund](#Background)**\n3. **[Installation](#Installation)**\n4. **[Benutzung](#Usage)**\n5. **[Funktion](#Functionality)**\n6. **[Konfiguration](#Configuration)**\n7. **[Hinweise](#Hints)**\n8. **[Module](#Modules)**\n\n\u003ca name=\"Disclaimer\"\u003e\u003c/a\u003e\n\n## Disclaimer\nDieses PowersShell-Tool ist weder die Lösung einer Aufgabe selbst, noch soll es dem/der Studierenden das Erlernen des Umgangs mit der Konsole verhindern. Der Einsatz ist eigenverantwortlich.\n\n\u003ca name=\"Background\"\u003e\u003c/a\u003e\n\n## Hintergrund\nIm Rahmen der Lehrveranstaltung \"Einführung in die Programmierung\" im Fachbereich 16 (Elektrotechnik/Informatik) der Universität Kassel müssen Übungen bearbeitet und abgegeben werden.\nDie Bearbeitung umfasst das Anfertigen von Dokumenten und Java-Programmen, die nur als jar-Archiv zusammengefasst hochgeladen/abgegeben werden können.\nDaraus entstand die Idee für einen Assistenten, der einem beim Erstellen, Hoch- und Herunterladen von .jar-Dateien hilft.\n\n\u003ca name=\"Installation\"\u003e\u003c/a\u003e\n\n## Installation\nZu Installation müssen in einem PowerShell-Fenster die zwei folgenden Befehle ausgeführt werden:\n\n```PowerShell\nInstall-Module \"PSDepend\" -Scope \"CurrentUser\" -Force\nInvoke-PSDepend -InputObject @{\"dargmuesli/PLM-Jar-Builder\" = \"latest\"} -Install -Force\n```\n\n\u003ca name=\"Usage\"\u003e\u003c/a\u003e\n\n## Benutzung\nIn erster Linie sollte der Assistent verwendet werden, der durch die möglichen Funktionen des Moduls führt.\nDazu in einem PowerShell-Fenster einfach folgenden Befehl eingeben:\n\n```PowerShell\nInvoke-PlmJarBuilder\n```\n\n### Screenshot\n![Screenshot](Resources/Screenshot.png \"Screenshot\")\n\nAlternativ können auch [einzelne Module](#Module) direkt angesprochen werden.\n\n\u003ca name=\"Functionality\"\u003e\u003c/a\u003e\n\n## Funktion\nEs wird eine Ordnerstruktur ähnlich zur folgenden vorausgesetzt:\n\n```\nÜbungen\\\n├── Aufgabenblatt 1\\\n│   ├── Lösung\\\n│   │   ├── Teilaufgabe\\\n│   │   │   ├── Teilaufgabe.class\n│   │   │   ├── Teilaufgabe.java\n|   |   |   ⇣\n│   │   ├── 123456789_01.jar\n│   │   ├── Lösung 1.odt\n│   │   ├── Lösung 1.pdf\n│   │   ├── Teilaufgabe.odg\n│   │   ├── Teilaufgabe.pdf\n|   |   ⇣\n│   ├── Aufgabenblatt 1.pdf\n|   ⇣\n├── Aufgabenblatt 2\\\n⇣\n```\n\nDie `.jar`-Datei wird standardmäßig beim Generieren überschrieben.\nDabei werden gewisse Dateitypen (`.odt`, `.class`), sowie IDE-abhängige Ordner (`.idea\\`) ignoriert.\n\n\u003ca name=\"Configuration\"\u003e\u003c/a\u003e\n\n## Konfiguration\nDie Standardwerte, die bei der Ausführung vom PLM-Jar-Builder genutzt werden, können in einer Konfigurationsdatei angepasst werden.\nDie Konfigurationsdatei befindet sich im Modul-Ordner, meist hier: `%USERPROFILE%\\Documents\\WindowsPowerShell\\Modules\\plm-jar-builder\\PLM-Jar-Builder\\Config\\PLM-Jar-Builder.json`\n\nFolgende Einstellungsmöglichkeiten gibt es:\n\n\n### Custom\nEinstellungen, die dem Benutzer die Eingabe von Funktionsparametern ersparen, aber die Programmfunktion nicht grundlegend ändern.\n\n- **ExerciseRootPath**\nDer Pfad zum Ordner, in dem sich die Aufgabenordner (`Aufgabenblatt 1`, ...) befinden.\nStandardwert: `%MyDocuments%\\Universität\\Informatik\\Semester 1\\Einführung in die Programmierung\\Übungen`\n\n- **DownloadPath**\nDer Pfad zum Ordner, in den .jar-Dateien heruntergeladen werden.\nStandardwert: `%Downloads%` (Registry-Schlüssel)\n\n- **Exclude**\nDateiendungen als Regex, die nicht in die .jar-Datei gepackt werden sollen.\nStandardwert: `\".*\\.class\", \".*\\.eml\", \".*\\.iml\", \".*\\.jar\", \".*\\.odt\", \".*\\.odg\", \".*\\.ods\", \".*\\.old\", \"[^\\\\]+\\\\\\.idea\\\\.*\", \".*\\\\In\\.java\", \"[^\\\\]+\\\\out\\\\.*\", \".*\\\\Out\\.java\"`\n\n- **NoNote**\nFestlegen, ob eine Markdown-Notiz bezüglich dieses Moduls mit in die .jar-Datei gepackt werden soll.\nStandardwert: `false`\n\n\n#### PLM\nDaten, die im Browser-Authentifizierungsfenster angegeben werden müssen, bevor man die PLM-Seite überhaupt sieht.\n\n- **Username**\nDer PLM-Benutzername.\nStandardwert: `\"\"`\n\n- **EncryptedPassword**\nEine [verschlüsselte Version](#verschlüsselte-passwörter) des PLM-Passworts.\nStandardwert: `\"\"`\n\n\n#### User\nDaten, die zur Anmeldung direkt auf der PLM-Seite genutzt werden.\n\n- **MatriculationNumber**\nDie Matrikelnummer, die als Benutzername für die PLM-Seite im Dateinamen der .jar-Datei vorkommen soll.\nStandardwert: `\"\"`\n\n- **EncryptedPassword**\nEine [verschlüsselte Version](#verschlüsselte-passwörter) des Benutzerpassworts.\nStandardwert: `\"\"`\n\n\n### Default\nEinstellungen, die die Funktion des Moduls grundlegend ändern, weil sie Änderungen an der vorgegebenen Ordnerhierarchie darstellen.\n\n- **SolutionPath**\nDer Pfad zum Order innerhalb des Aufgabenordners, der die Lösung enthält.\nDarin sollten alle Dateien sein, die in die .jar-Datei gepackt werden sollen.\nStandardwert: `\"Lösung\"`\n\n- **ExerciseSheetRegex**\nDer reguläre Ausdruck, nach dem Aufgabenordner und Übungsnummern gefunden werden.\nStandardwert: `\"^Aufgabenblatt (\\\\d{1,2})$\"`\n\n- **JarFileRegex**\nDer reguläre Ausdruck, nach dem .jar-Dateien, Matrikelnummern und Übungsnummern gefunden werden.\nStandardwert: `\"^(\\\\d+|.*)_(\\\\d{2}).jar$\"`\n\n\u003ca name=\"Hints\"\u003e\u003c/a\u003e\n\n## Hinweise\n\n### Verschlüsselte Passwörter\nDer Wert für das verschlüsselte Passwort kann über folgendes Kommando erstellt werden:\n\n```PowerShell\n'passwort' | ConvertTo-SecureString -AsPlainText -Force | ConvertFrom-SecureString\n```\n\nDass Apostrophe das Passwort einschließen ist notwendig, um gewisse Sonderzeichen im Passwort zu ermöglichen.\nDas Passwort kann nur vom selben Windows-Account wieder entschlüsselt werden, mit dem es verschlüsselt wurde.\n\n\n### Installation von Abhängigkeiten\nDie Installation von Abhängigkeiten wird über das PowerShell-Modul [PSDepend](https://github.com/RamblingCookieMonster/PSDepend) realisiert. Die dortige, aktuelle Implementierung der Abhängigkeitsauflösung von GitHub-Projekten nicht wirklich ausgefeilt ist, dauert es oft lange bis alle Abhängigkeiten installiert sind. Besonders bei der Ausführung des Assistenten (`Invoke-PlmJarBuilder`) stört dies, sodass die Option `-SkipDependencyCheck` eingerichtet wurde, die die Abhängigkeitsauflösung verhindert. Gleichzeitig wird aber auch die Suche nach Updates übersprungen.\n\nDer PLM-Jar-Builder nutzt u.a. das Projekt [Dargmuesli/PowerShell-Lib](https://github.com/Dargmuesli/PowerShell-Lib) von GitHub, das mit der derzeitigen Implementierung bei jeder Ausführung des Assistenten neu heruntergeladen wird. Es gibt bereits [einen neue Version](https://github.com/RamblingCookieMonster/PSDepend/pull/46) der GitHub-Installationsmethode über PSDepend, aber diese wurde dem Projekt noch nicht offiziell hinzugefügt.\n\n\u003ca name=\"Modules\"\u003e\u003c/a\u003e\n\n## Modules\n- **Assistant**\n  - [Invoke-PlmJarBuilder](PLM-Jar-Builder/Docs/Invoke-PlmJarBuilder.md)\n- **Config**\n  - [Get-PlmJarBuilderConfig](PLM-Jar-Builder/Docs/Get-PlmJarBuilderConfig.md)\n  - [Get-PlmJarBuilderConfigProperty](PLM-Jar-Builder/Docs/Get-PlmJarBuilderConfigProperty.md)\n  - [Get-PlmJarBuilderConfigPropertyPath](PLM-Jar-Builder/Docs/Get-PlmJarBuilderConfigPropertyPath.md)\n  - [Get-PlmJarBuilderVariable](PLM-Jar-Builder/Docs/Get-PlmJarBuilderVariable.md)\n  - [New-PlmJarConfig](PLM-Jar-Builder/Docs/New-PlmJarConfig.md)\n  - [Set-PlmJarBuilderConfigProperty](PLM-Jar-Builder/Docs/Set-PlmJarBuilderConfigProperty.md)\n  - [Set-PlmJarBuilderVariable](PLM-Jar-Builder/Docs/Set-PlmJarBuilderVariable.md)\n- **JAR**\n  - [Find-MatriculationNumber](PLM-Jar-Builder/Docs/Find-MatriculationNumber.md)\n  - [Get-ExerciseFolder](PLM-Jar-Builder/Docs/Get-ExerciseFolder.md)\n  - [New-PlmJar](PLM-Jar-Builder/Docs/New-PlmJar.md)\n- **PLM**\n  - [Get-PlmJar](PLM-Jar-Builder/Docs/Get-PlmJar.md)\n  - [Get-PlmUri](PLM-Jar-Builder/Docs/Get-PlmUri.md)\n  - [Initialize-PlmSession](PLM-Jar-Builder/Docs/Initialize-PlmSession.md)\n  - [Publish-PlmJar](PLM-Jar-Builder/Docs/Publish-PlmJar.md)\n  - [Test-PlmUploadAvailable](PLM-Jar-Builder/Docs/Test-PlmUploadAvailable.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdargmuesli%2Fplm-jar-builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdargmuesli%2Fplm-jar-builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdargmuesli%2Fplm-jar-builder/lists"}