Hello all!
We are now publishing a bunch of documentation / reports on the code behind Wikidata Query Service [1]. All this is very developer oriented, so skip the rest of this email if you just want to use the service.
All the reports are generated via Maven, and reflect the current state of the master branch of the project [2]. Reports are organized by modules. Feel free to browse through them and see if you find anything interesting. A few pointers to get started (links provided to the "tools" module, the same reports are available for other modules as well):
* JaCoCo code coverage [3]: line and branch unit test coverage * JDepend [4]: a few slightly obscure code metrics. Package cycles and "distance" are interesting ones. * Dependency updates [5]: which of our dependencies could be upgraded (yes, we have some work to do on that side)
If you know about other interesting reports that could be added to that collection, feel free to reach out to me. And if you want to start addressing some of those issues, patches are always welcomed!
Thanks for your time...
Guillaume
[1] https://doc.wikimedia.org/wikidata-query-rdf/parent/ [2] https://github.com/wikimedia/wikidata-query-rdf/ [3] https://doc.wikimedia.org/wikidata-query-rdf/parent/tools/jacoco/index.html [4] https://doc.wikimedia.org/wikidata-query-rdf/parent/tools/jdepend-report.htm... [5] https://doc.wikimedia.org/wikidata-query-rdf/parent/dependency-updates-repor...
Hi,
On 01/04/2018 01:27 AM, Guillaume Lederrey wrote:
Hello all!
We are now publishing a bunch of documentation / reports on the code behind Wikidata Query Service [1]. All this is very developer oriented, so skip the rest of this email if you just want to use the service.
Yay, except it seems like all the links on [1] in the main table are broken because they link to /index.html. :(
- JaCoCo code coverage [3]: line and branch unit test coverage
Is it possible to get this in a machine-readable form for publishing on [6]? We typically use the clover.xml format for JavaScript and PHP.
[1] https://doc.wikimedia.org/wikidata-query-rdf/parent/ [3] https://doc.wikimedia.org/wikidata-query-rdf/parent/tools/jacoco/index.html
[6] https://doc.wikimedia.org/cover/
-- Legoktm
On Thu, Jan 4, 2018 at 11:24 AM, Kunal Mehta legoktm@member.fsf.org wrote:
Hi,
On 01/04/2018 01:27 AM, Guillaume Lederrey wrote:
Hello all!
We are now publishing a bunch of documentation / reports on the code behind Wikidata Query Service [1]. All this is very developer oriented, so skip the rest of this email if you just want to use the service.
Yay, except it seems like all the links on [1] in the main table are broken because they link to /index.html. :(
Interesting... I missed that. The links in the menu on the left are working. I'll see if I can correct the other ones.
- JaCoCo code coverage [3]: line and branch unit test coverage
Is it possible to get this in a machine-readable form for publishing on [6]? We typically use the clover.xml format for JavaScript and PHP.
The jacoco.xml reports are available (but not linked directly from the report) [7]. There are also CSV [8]. I'm pretty sure we can find a way to convert jacoco.xml to clover.xml... I'll have a look when I have some more free cycles.
[1] https://doc.wikimedia.org/wikidata-query-rdf/parent/ [3] https://doc.wikimedia.org/wikidata-query-rdf/parent/tools/jacoco/index.html
[7] https://doc.wikimedia.org/wikidata-query-rdf/parent/tools/jacoco/jacoco.xml [8] https://doc.wikimedia.org/wikidata-query-rdf/parent/tools/jacoco/jacoco.csv
-- Legoktm
Discovery mailing list Discovery@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/discovery