<div dir="ltr"><div class="gmail_default" style="font-family:arial,helvetica,sans-serif;font-size:small">Hi</div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif;font-size:small"><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif;font-size:small">Nice stuff!</div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif;font-size:small">Regards</div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif;font-size:small"><br></div><div class="gmail_default" style="font-family:arial,helvetica,sans-serif;font-size:small">Tim</div><br><div class="gmail_quote"><div dir="ltr">On Wed, Dec 19, 2018 at 7:30 PM Denis Rouzaud <<a href="mailto:denis.rouzaud@gmail.com" target="_blank">denis.rouzaud@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Dear PSC,<div><br></div><div>A small mail to announce that phase 3 of the PyQGIS API doc has reached its goal.</div><div>Mainly, the docs are automatically build and published on Travis using the docker images also built on Travis.</div><div>Former sub-categories has been removed and all classes lie in their package (core/gui/server/analysis).</div><div>The docs are pushed daily for master: <a href="https://qgis.org/pyqgis/master" target="_blank">https://qgis.org/pyqgis/master</a></div><div><br></div><div>Best wishes to you all,</div><div><br></div><div>Denis</div><div><br><div class="gmail_quote"><div dir="ltr">Le jeu. 12 avr. 2018 à 11:20, Denis Rouzaud <<a href="mailto:denis.rouzaud@gmail.com" target="_blank">denis.rouzaud@gmail.com</a>> a écrit :<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div>Dear PSC,</div><div><br></div><div>Finally, I have finalized phase 2 of PyQGIS API docs project.</div><div>It was again a tedious job with again unexpected issues.</div><div><br></div><div>Here is what has been done:</div><div><br></div><div>1) Automatic building of QGIS docker images in Travis</div><div>These are used to later build the PyQGIS doc in another Travis job in QGISPythonAPIDocumentation repo.</div><div><br></div><div>2) Multi-version support</div><div>To enable support several API versions on a custom website (not readthedocs, but we use readthedocs theme), it was required to fork the theme since support of multiple version was rejected in main repo [0]. The fork is here [1].</div><div><br></div><div>3) Support for signal signatures</div><div>Support for signal signatures in SIP was missing [2] and I provided a patch [3]. This patch is in the upstream SIP library (maintained by Phil Thomson) and jumping into this code is really not an easy task.</div><div><br></div><div>4) Table of contents and grouping</div><div>In previous version, table of content was full of inherited class methods which were not bringing useful info (all methods from Qt parent classes).</div><div>Now, these are removed. </div><div>Moreover, there is a fine tuning in grouping and signals have their own dedicated category.</div><div>These is made possible by using a custom version of autoautosummary [4,5]</div><div><br></div><div>5) Online building of the Python API Docs</div><div>Everything has been setup in Travis to automatically build the docs using QGIS docker image (see pt 1).</div><div>Sadly, I was not able to set the dev version of SIP (upcoming 4.19.9) in the main docker. That means missing the nice signatures for signals. So, this is on hold (it's pushing to a temp folder) until new SIP is released (probably along new Qt version in may).</div><div>Hence last published version of the docs has been built on my computer, and server API is missing.</div><div>The logic is ass follows:</div><div>- master docs follows QGIS master branch and is built once a day</div><div>- release versions docs are built using tags on the main repo and hence will strictly correspond to the last point release of each branch</div><div><br></div><div>Original allocated time has again been largely overrun (mainly due to SIP modifications and trying to bring them in the build chain).</div><div>Since I considered signal for signatures was a first priority feature (although not mentionned before Gary's mail [6]), some were again left apart:</div><div>- Adapt sipify to move /Out/ parameters from parameters list to returns group</div><div>- Sipify doc</div><div><br></div><div>I think that the documentation is now in a much more accomplished state.</div><div><br></div><div>As far as I see it, here are the main remaining issues:</div><div><br></div><div>I1) as pointed by Richard [7], we need to fix redirections properly</div><div><br></div><div>I2) also mentionned [7], the categorization of classes originally thought by Tim can be improved by creating categories on our own (instead of automatically by class names). Maybe take it down to 10-20 sucategories for each module (core, gui, analysis, server).</div><div><br></div><div>I3) list of parameters still showing output only parameters, and the /Out/ arguments are not mentionned as output. This is a sipify enhancement.</div><div><br></div><div>I4) Finalizing the auto build toolchain (integrate coming SIP version in dependency docker image, automatic triggering of API docs build from main QGIS travis jobs).</div><div><br></div><div>I think someone from the PSC holding the info of the provider can easily handle I1.</div><div><br></div><div>I would propose QGIS.org to sponsor a phase 3 for the remaining issues with the following estimate:</div><div>I2) 8h</div><div>I3) 16h</div><div>i4) 24h</div><div><br></div><div>At the usual rate for QGIS.org sponsored project, the proposal is of 6 days.</div><div><br></div><div>Would you like to have this as grant proposal or shall we proceed similarly to the 2 previous phases?</div><div><br></div><div>I'd like to thanks again QGIS.org for sponsoring this. It is worth mentioning though that a lot of time has been freely invested there, on behalf of Opengis, roughly doubling the time.</div><div><br></div><div>And last, but definitely not least, here are the docs!!!!</div><div><a href="http://python.qgis.org/master" target="_blank">http://python.qgis.org/master</a></div><div><br></div><div>Best regards,</div><div>Denis</div><div><br></div><div><br></div><div>[0] <a href="https://github.com/rtfd/sphinx_rtd_theme/pull/574" target="_blank">https://github.com/rtfd/sphinx_rtd_theme/pull/574</a></div><div>[1] <a href="https://github.com/3nids/sphinx_rtd_theme.git" target="_blank">https://github.com/3nids/sphinx_rtd_theme.git</a></div><div>[2] <a href="https://www.riverbankcomputing.com/pipermail/pyqt/2018-February/040036.html" target="_blank">https://www.riverbankcomputing.com/pipermail/pyqt/2018-February/040036.html</a></div><div>[3] <a href="https://www.riverbankcomputing.com/hg/sip/rev/34a94ca0260d" target="_blank">https://www.riverbankcomputing.com/hg/sip/rev/34a94ca0260d</a></div><div>[4] <a href="https://github.com/qgis/QGISPythonAPIDocumentation/blob/master/autoautosummary.py" target="_blank">https://github.com/qgis/QGISPythonAPIDocumentation/blob/master/autoautosummary.py</a></div><div>[5] <a href="https://stackoverflow.com/a/30783465/1548052" target="_blank">https://stackoverflow.com/a/30783465/1548052</a></div><div>[6] <a href="https://lists.osgeo.org/pipermail/qgis-developer/2018-February/052148.html" target="_blank">https://lists.osgeo.org/pipermail/qgis-developer/2018-February/052148.html</a></div><div>[7] <a href="https://lists.osgeo.org/pipermail/qgis-developer/2018-April/052976.html" target="_blank">https://lists.osgeo.org/pipermail/qgis-developer/2018-April/052976.html</a></div><div><br></div></div></blockquote></div></div></div>-- <br><div dir="ltr" class="m_1858046484762264945gmail-m_3640679595548874576gmail_signature"><div dir="ltr">
<p class="m_1858046484762264945gmail-m_3640679595548874576inbox-inbox-inbox-inbox-p1"><span style="color:rgb(0,0,0);font-family:Verdana,sans-serif;font-size:10pt">Denis Rouzaud</span><br style="color:rgb(0,0,0);font-family:Times;font-size:medium"><a href="mailto:denis@opengis.ch" style="font-family:Times;font-size:medium" target="_blank"><span style="color:rgb(0,0,0);font-family:Verdana,sans-serif;font-size:8pt">denis@opengis.ch</span> </a><br style="color:rgb(0,0,0);font-family:Times;font-size:medium"><span style="color:rgb(0,0,0);font-family:Verdana,sans-serif;font-size:8pt"><a>+41 76 370 21 22</a></span></p><p class="m_1858046484762264945gmail-m_3640679595548874576inbox-inbox-inbox-inbox-p1"><span style="color:rgb(0,0,0);font-family:Verdana,sans-serif;font-size:8pt"><a><br></a></span></p></div></div>
_______________________________________________<br>
Qgis-psc mailing list<br>
<a href="mailto:Qgis-psc@lists.osgeo.org" target="_blank">Qgis-psc@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/qgis-psc" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/qgis-psc</a></blockquote></div><br clear="all"><div><br></div>-- <br><div dir="ltr" class="m_1858046484762264945gmail_signature"><div dir="ltr"><div><div dir="ltr"><div style="text-align:center">------------------------------------------------------------------------------------------</div><div style="text-align:center"><div style="color:rgb(0,0,0);font-family:arial,helvetica,sans-serif;font-size:small;display:inline"></div><img src="https://mail.google.com/mail/u/0/?ui=2&ik=7ebbf93252&view=fimg&th=15a9e43c0bbf93ca&attid=0.1&disp=emb&realattid=9436e64174762963_0.1.1&attbid=ANGjdJ-WL_J24nvBiYidJ0V0xpdsYqRwswi5nq5oywcJEHC7twYVMrxG0y-GNPu_ahJthV8ktXwYuHoVm5DI2FrRAtPzelTRHrsE2wweR9uu8wT-zz2hNRqFwi4SorQ&sz=s0-l75-ft&ats=1488721675176&rm=15a9e43c0bbf93ca&atsh=1" style="color:rgb(0,0,0);font-family:Helvetica;font-size:12px"><br></div><div style="text-align:center">Tim Sutton</div><div style="text-align:center"><span style="text-align:start">Visit </span><a href="http://kartoza.com/" style="text-align:start" target="_blank">http://kartoza.com</a><span style="text-align:start"> to find out about open source:</span><br style="text-align:start"><span style="text-align:start"> * Desktop GIS programming services</span><br style="text-align:start"><span style="text-align:start"> * Geospatial web development</span></div><div style="text-align:center"><span style="text-align:start">* GIS Training</span></div><div style="text-align:center"><span style="text-align:start">* Consulting Services</span></div><div style="text-align:center"><div style="text-align:center">Skype: timlinux Irc: timlinux on #qgis at <a href="http://freenode.net/" target="_blank">freenode.net</a></div><div style="text-align:start"><div style="text-align:center">Tim is a member of the QGIS Project Steering Committee</div><div style="text-align:center">-------------------------------------------------------------------------------------------</div><div style="text-align:center">Kartoza is a merger between Linfiniti and Afrispatial</div></div></div></div></div></div></div></div>