`/usr/local/bin/webservice` is a Python application used by #toolforge members to start and stop [[https://wikitech.wikimedia.org/wiki/Help:Toolforge/Web|web services]] for their tools.
There are a number of outstanding bugs and feature requests to make this widely used command nicer:
* {T156626}
* {T164245}
* {T140415}
* {T122515}
* {T158244}
* {T148872}
* {T107878}
* {T95097}
* {T159892}
* {T154506}
* {T154504}
* {T141572}
* {T169695}
* {T174769}
We are looking for someone who is familiar with Python development to help fix these issues. Familiarity with #toolforge and/or the Wikimedia movement is a plus!
* Source code: {rOSTW}
* Code review: [[https://gerrit.wikimedia.org/r/#/projects/operations/software/tools-webservice,dashboards/default:recent|Gerrit]]
* Chat: [[https://webchat.freenode.net/?channels=#wikimedia-cloud|#wikimedia-cloud]] freenode IRC channel
* Mentors: @Andrew, @bd808, @madhuvishy
* Skills needed: Python
== Microtask ==
Here is a series of things that you can do to become familiar with our tools and demonstrate interest in this project:
* [[https://www.mediawiki.org/wiki/Phabricator/Help#Creating_a_task|Create a new Phabricator task]] that is a subtask of this task titled "GSOC webservvice microtask for <your Phabricator username>"
* Add a checklist of these steps as the description of the new task:
```
[] Register for [[https://www.mediawiki.org/wiki/Special:MyLanguage/Developer_access|Developer access]]
[] Read the [[https://www.mediawiki.org/wiki/Special:MyLanguage/Gerrit/Tutorial|Gerrit tutorial]]
[] Clone [[https://gerrit.wikimedia.org/r/#/admin/projects/operations/software/tools-webservice|the project repository from Gerrit]]
[] Read over the source code and try to understand what `scripts/webservice` does when a user runs it as:
* `webservice --backend kubernetes start`
* `webservice --backend kubernetes stop`
[] [[https://www.mediawiki.org/wiki/Gerrit/Tutorial#How_to_submit_a_patch|Submit a patch]] to Gerrit adding a "GSOC-task.<your shell username>.txt" file that describes your understanding of the `webservice --backend kubernetes {start,stop}` commands from the previous step.
[] Add `BryanDavis`, `Madhuvishy`, and `Andrew Bogott` as reviewers for your new Gerrit patch.
```
* Claim the new task you created.
* Do the steps described in the task and mark each step as done "[x]" as you complete it.