{"id":17855357,"url":"https://github.com/arubacao/stager","last_synced_at":"2026-04-20T14:02:05.911Z","repository":{"id":57579090,"uuid":"134562900","full_name":"arubacao/stager","owner":"arubacao","description":"Stager is a tool designed to help ls1intum tutors streamline code homework correction submitted to ArTEMiS","archived":false,"fork":false,"pushed_at":"2018-11-12T18:01:46.000Z","size":772,"stargazers_count":2,"open_issues_count":2,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-08-23T19:30:47.945Z","etag":null,"topics":["artemis","git","tum"],"latest_commit_sha":null,"homepage":"https://artemis.ase.in.tum.de/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arubacao.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}},"created_at":"2018-05-23T11:59:12.000Z","updated_at":"2021-05-30T17:04:34.000Z","dependencies_parsed_at":"2022-09-26T19:11:56.979Z","dependency_job_id":null,"html_url":"https://github.com/arubacao/stager","commit_stats":null,"previous_names":["arubacao/git-bulk-dl"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/arubacao/stager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arubacao%2Fstager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arubacao%2Fstager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arubacao%2Fstager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arubacao%2Fstager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arubacao","download_url":"https://codeload.github.com/arubacao/stager/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arubacao%2Fstager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32050451,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["artemis","git","tum"],"created_at":"2024-10-28T02:03:59.658Z","updated_at":"2026-04-20T14:02:05.859Z","avatar_url":"https://github.com/arubacao.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# stager\n[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE.md)\n[![Travis](https://img.shields.io/travis/arubacao/stager.svg?style=flat-square)](https://travis-ci.org/arubacao/stager)\n[![Go Report Card](https://goreportcard.com/badge/github.com/arubacao/stager?style=flat-square)](https://goreportcard.com/report/github.com/arubacao/stager)\n[![Godoc](https://godoc.org/github.com/arubacao/stager?status.svg\u0026style=flat-square)](http://godoc.org/github.com/arubacao/stager)\n\n`stager` is a tool designed to help [ls1intum](https://wwwbruegge.in.tum.de/lehrstuhl_1/) tutors streamline code homework correction submitted to [ArTEMiS](https://artemis.ase.in.tum.de).\nIt downloads and prepares a selected list of student repositories to your local machine.\n\n## Features\n- Download selected list of student repositories\n- Append student names to folder names\n- Remove code committed after the deadline \n- Squash student commits into a single commit \n- Rename project names for better overview in Eclipse \n- Dead-simple and reusable configuration\n- Automatic build pipeline for cross-platform executables [(see here)](http://github.com/arubacao/stager/releases)\n\n### More Info\n\n_Note: We do not collect or process any information. Displayed student names and identifiers are fake. We are compliant with the General Data Protection Regulation (GDPR)._\n\n#### Append student names to repo folders\n\n![Rename Repos](/assets/rename-folders.png?raw=true \"rename repos\")\n\n#### Enforce deadline\n\nSome students try to add more commits after the deadline.  \n`stager` removes late commits.  \n_Note: This is not bullet proof, since git timestamps can be manipulated!_  \n![Enforce deadline](/assets/due-date.png?raw=true \"Enforce deadline\")\n\n#### Squash student commits\n\nStudents add code to an existing codebase provided from the instructors.\nIt is a lot easier to correct their homework, if the changes made by the students are immediately visible.\nTherefore, the tools squashes commits after a giving SHA hash. The original history is still available.  \n![Squash commits](/assets/squash.png?raw=true \"Squash student commits\")  \n\n#### Rename Eclipse project names\n\nIt is confusing when you open 10 projects with identical names in Eclipse.\nTherefore, the tools renames each project and appends the students name and identifier.  \n![Rename projects](/assets/rename-project.png?raw=true \"Rename eclipse project name\")  \n\n## Install\n### Pre-compiled executables (recommended)\nGet them [here](http://github.com/arubacao/stager/releases).\n\n### Source\nYou need `go` installed and `GOBIN` in your `PATH`. Once that is done, run the\ncommand from the repos root folder:\n```shell\n$ go get -d -t -v ./...\n$ go run main.go\n```\n\n## Configuration\n### config.json\n\nRename `example.config.json` to `config.json`\n```$shell\ncp example.config.json config.json\n```\n\n```$json\n{\n  // Copy \u0026 paste the url for the repo from https://artemis.ase.in.tum.de\n  // The first 2 %s are placeholders for your TUM credentials\n  // The last %s is a placeholder for the students LRZ id\n  \"url\": \"https://%s:%s@repobruegge.in.tum.de/scm/eist2018l02bumperss03/eist2018-l02-bumpers-sprint03-exercise-%s.git\",\n  // Your LRZ id\n  \"username\": \"tutor-lrz-idga12dub\",\n  // Your TUM password\n  \"password\": \"my-secret-password\",\n  // The homework deadline in 'Y-m-d H:i:s' (DateTime)  \n  \"deadline\": \"2018-29-04 23:59:59\",\n  // The SHA hash of Stephan Krusches last commit\n  \"squash_after\": \"47ad218377d8b2509c6293823cc6ff2f87ca770a\"\n}\n```\n\n### students.csv\n\nRename `example.students.csv` to `students.csv`\n```$shell\ncp example.students.csv students.csv\n```\n\nOpen the first and add your students LRZ ids and names \n\n```$csv\nname,id\nJohn Doe,ga77ugu\n...\n```\n\n## Usage\n\n1. Place the executable, `config.json` and `students.csv` into a desired folder.\n2. a) double click the executable or b) execute from terminal (recommended)\n    ```$bash\n    $ cd ~/homework3correction\n    $ ./stager\n    ```\n3. ...\n4. Profit\n\n## Implementation\n\nThe different operations have been implement with the help of the strategy pattern (s. illustration below).\n\u003cp\u003e\u003ca href=\"https://commons.wikimedia.org/wiki/File:W3sDesign_Strategy_Design_Pattern_UML.jpg#/media/File:W3sDesign_Strategy_Design_Pattern_UML.jpg\"\u003e\u003cimg src=\"https://upload.wikimedia.org/wikipedia/commons/4/45/W3sDesign_Strategy_Design_Pattern_UML.jpg\" alt=\"W3sDesign Strategy Design Pattern UML.jpg\"\u003e\u003c/a\u003e\u003cbr\u003eBy \u003ca href=\"//commons.wikimedia.org/wiki/User:Vanderjoe\" title=\"User:Vanderjoe\"\u003eVanderjoe\u003c/a\u003e - \u003cspan class=\"int-own-work\" lang=\"en\"\u003eOwn work\u003c/span\u003e, \u003ca href=\"https://creativecommons.org/licenses/by-sa/4.0\" title=\"Creative Commons Attribution-Share Alike 4.0\"\u003eCC BY-SA 4.0\u003c/a\u003e, \u003ca href=\"https://commons.wikimedia.org/w/index.php?curid=60733582\"\u003eLink\u003c/a\u003e\u003c/p\u003e\n\nThe different operations/strategies are:\n1. PullOperation  \n    PullOperation ensures that each accessible repository is up-to-date \n    and in a clean state. This is useful for already locally available repo folders.\n2. DeadlineOperation  \n    DeadlineOperation ensures that commits after a given deadline are not applied in the local repository.\n    This is useful, since BitBucket does not enforce any deadline whatsoever.\n3. SquashOperation  \n    SquashOperation squashes all commits after a given SHA hash.\n    This is useful to visualise all changes a student made in a single commit.\n4. RenameProjectOperation  \n    RenameProjectOperation renames the project name for better overview in Eclipse.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farubacao%2Fstager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farubacao%2Fstager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farubacao%2Fstager/lists"}