Difference between revisions of "Winezeug"

From WineHQ Wiki
Jump to: navigation, search
(Give Winezeug it's own page for now)
 
(Add condensed BuildBot notes from old wiki)
Line 14: Line 14:
  
 
== Preliminary Observations ==
 
== Preliminary Observations ==
From a very cursory glance, the code in the repo seems to fall into a few categories:
+
From a very cursory glance, the code in the repo seems to fall into several categories:
 
* Random simple tests and cruft (the easy stuff to clear out)
 
* Random simple tests and cruft (the easy stuff to clear out)
* Helper / Installer tools, including variations of winetricks (probably already been merged some, though checking would be good)
+
* Helper / Installer scripts, including early versions of winetricks and related tools
* Explorations of the "jug" concept (a standard for wine-prefix management)
+
* Some basic prototypes of an approach to prefix management
* Various web-tools for data-mining or automating parts of WineHQ
+
* A couple of web-scrapers to mine the AppDB and report on popular titles (according to gamerankings.com)
 
* Shims for using different testing tools on Wine
 
* Shims for using different testing tools on Wine
 +
* A collection of examples for trying out the Cmake build tool
 +
* Alternative versions of a possible testbot
  
Also be sure not to overlook the ''wiki'' branch of the repo; it has a few (yet seemingly detailed) markdown pages from the repo's wiki on Google Code.
+
When the repo was exported to Github from Google Code, the few wiki pages were loaded into a distinct ''wiki'' branch of the repo. However, only the ConvergedFrontends file was not entirely obsolete or superseded by the winetricks wiki, and it has now been merged into the [[Bottling Standards]] page on this wiki.
 +
 
 +
== BuildBot & Patchwatcher ==
 +
{{Warning}} For now, this info makes sense here. Once these parts of winezeug have been thoroughly digested though, the paragraphs below (with updates) probably belong more on some part of the [[Wine TestBot]] page.
 +
 
 +
[http://buildbot.net/ BuildBot] is a mature, open-source continuous integration (build-and-test) service written in Python. It can be operated as a distributed installation, with a master server automatically pushing jobs out to slave servers. Dan Kegel and Jeremy White setup a BuildBot farm at WineHQ several years ago for feasiblity tests, before we settled on our current [[Wine_TestBot]]. It would monitor the wine-patches mailing list, automatically sending errors to Dan, who would personally filter out the false positives, then email the submitter and wine-devel about any legitimate errors.
 +
 
 +
Prior to the BuildBot test instance, Wine relied on Patchwatcher, a custom testbot whipped up by Dan to automatically check submitted patches against Wine [[Conformance Tests]]. After all these bespoke scripts became too much of a hassle to maintain though, the wine team decided to try other options, including existing projects like BuildBot or [https://jenkins-ci.org/ Jenkins].
 +
 
 +
Our current Wine TestBot gets the job done fine, but if we ever decide to transition to BuildBot, the groundwork done by Dan & Jeremy could give us a nice headstart.
  
 
[[Category:Data]] [[Category:Development]] [[Category:Quality Assurance]] [[Category:ToDo]]
 
[[Category:Data]] [[Category:Development]] [[Category:Quality Assurance]] [[Category:ToDo]]

Revision as of 21:32, 7 March 2016

Over the years, Wine contributor Dan Kegel built up a veritable steamer-trunk of interesting scripts for testing, tweaking, and otherwise teaching Wine and WineHQ to do all kinds of tricks (even the early versions of Winetricks). For those interested in sorting through all his tools, keep on reading.

Tango-style info icon.svg This page is not intended to be permanent. The goal is to keep hints and major notes here while doing some code archaeology on the Winezeug repo, a project that probably has at most a time-horizon of a few years (and much shorter if someone prioritizes it).

Getting Winezeug

Winezeug was originally hosted on Google Code, but when Google began unwinding their code hosting service, it was automatically exported to Github. As of this writing, winezeug was last updated a year and a half ago by Austin English and there's no sign that Dan's repo will be actively maintained.

Still if you're interested in downloading it as Dan left it on Google Code, you can clone it through git:

git clone https://github.com/dankegel/winezeug.git

Austin has also mentioned his fork, which is currently (March 2016) synced with Dan's:

git clone https://github.com/austin987/winezeug.git

Kyle Auble has also forked Dan's repo on his Bitbucket account and plans to dig through it from time to time, pushing any changes back to Bitbucket:

git clone https://bitbucket.org/kauble/winezeug-archaeology.git

Preliminary Observations

From a very cursory glance, the code in the repo seems to fall into several categories:

  • Random simple tests and cruft (the easy stuff to clear out)
  • Helper / Installer scripts, including early versions of winetricks and related tools
  • Some basic prototypes of an approach to prefix management
  • A couple of web-scrapers to mine the AppDB and report on popular titles (according to gamerankings.com)
  • Shims for using different testing tools on Wine
  • A collection of examples for trying out the Cmake build tool
  • Alternative versions of a possible testbot

When the repo was exported to Github from Google Code, the few wiki pages were loaded into a distinct wiki branch of the repo. However, only the ConvergedFrontends file was not entirely obsolete or superseded by the winetricks wiki, and it has now been merged into the Bottling Standards page on this wiki.

BuildBot & Patchwatcher

Dialog-warning.svg For now, this info makes sense here. Once these parts of winezeug have been thoroughly digested though, the paragraphs below (with updates) probably belong more on some part of the Wine TestBot page.

BuildBot is a mature, open-source continuous integration (build-and-test) service written in Python. It can be operated as a distributed installation, with a master server automatically pushing jobs out to slave servers. Dan Kegel and Jeremy White setup a BuildBot farm at WineHQ several years ago for feasiblity tests, before we settled on our current Wine_TestBot. It would monitor the wine-patches mailing list, automatically sending errors to Dan, who would personally filter out the false positives, then email the submitter and wine-devel about any legitimate errors.

Prior to the BuildBot test instance, Wine relied on Patchwatcher, a custom testbot whipped up by Dan to automatically check submitted patches against Wine Conformance Tests. After all these bespoke scripts became too much of a hassle to maintain though, the wine team decided to try other options, including existing projects like BuildBot or Jenkins.

Our current Wine TestBot gets the job done fine, but if we ever decide to transition to BuildBot, the groundwork done by Dan & Jeremy could give us a nice headstart.