Re: [QGIS-Developer] Python API for 3D
On Sat, 29 Sep 2018 at 09:36, Nyall Dawson wrote: > > On Sat, 29 Sep 2018 at 00:21, Martin Dobias wrote: > > > > > I think for the time being we should still treat the 3D library as > > having unstable API - so I wanted to check how others would feel about > > having Python API for qgis_3d that would be marked as unstable, i.e. > > there may be changes between 3.x releases? I think with big warnings > > in the docs that the API may change we can get others to experiment > > with 3D functionality while not offending anyone too much if we break > > it later. The idea is that the API would get frozen at some point > > later in 3.x release cycle or for QGIS 4. > > I don't see an issue with this -- there's other parts of code exposed > to PyQGIS which is also clearly marked as non-stable. Some processing > classes for instance. Note this touches on discussion at https://github.com/qgis/QGIS/pull/8054 too. Quoting: "Maybe we should do qt approach and have "technology preview" classes, before classes mature? We could even do this as a general rule - new classes are tech previews for 2 minor releases." Nyall ___ QGIS-Developer mailing list QGIS-Developer@lists.osgeo.org List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Re: [QGIS-Developer] Python API for 3D
On Sat, 29 Sep 2018 at 00:21, Martin Dobias wrote: > > I think for the time being we should still treat the 3D library as > having unstable API - so I wanted to check how others would feel about > having Python API for qgis_3d that would be marked as unstable, i.e. > there may be changes between 3.x releases? I think with big warnings > in the docs that the API may change we can get others to experiment > with 3D functionality while not offending anyone too much if we break > it later. The idea is that the API would get frozen at some point > later in 3.x release cycle or for QGIS 4. I don't see an issue with this -- there's other parts of code exposed to PyQGIS which is also clearly marked as non-stable. Some processing classes for instance. Nyall ___ QGIS-Developer mailing list QGIS-Developer@lists.osgeo.org List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Re: [QGIS-Developer] Python API for 3D
Hi Matthias On Fri, Sep 28, 2018 at 4:47 PM Matthias Kuhn wrote: > Hi Martin, > I think that's a good move. Having an experimental Python 3D API is better > than not having a Python 3D API. And if it's communicated clearly, it's > every developers choice to build something on top of an unstable API. > Just to ask, do you have clear plans for API changes or is it more a move > to keep the door for API modifications open in case it turns out it is > required? > I don't really have any concrete plans for API changes within the 3D library - I just feel that it may easily happen in the future as we will be adding more functionality or refactoring existing code :-) Anyway I would try to keep the changes in API break docs so that devs have some guidance in case there are some breaks. Cheers Martin ___ QGIS-Developer mailing list QGIS-Developer@lists.osgeo.org List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
Re: [QGIS-Developer] Python API for 3D
On Fri, Sep 28, 2018 at 4:21 PM Martin Dobias wrote: > Hi all > > I have been thinking it would be good to finally have Python API also > for qgis_3d library. Until now I have kept the 3D library > intentionally without Python bindings so that it is possible to move > the code around without being blocked by the API stability > requirement. > > I think for the time being we should still treat the 3D library as > having unstable API - so I wanted to check how others would feel about > having Python API for qgis_3d that would be marked as unstable, i.e. > there may be changes between 3.x releases? I think with big warnings > in the docs that the API may change we can get others to experiment > with 3D functionality while not offending anyone too much if we break > it later. The idea is that the API would get frozen at some point > later in 3.x release cycle or for QGIS 4. > > Cheers > Martin > Hi Martin, I think it's a good idea! ... if the warning is big enough and not light gray over a white background ;) -- Alessandro Pasotti w3: www.itopen.it ___ QGIS-Developer mailing list QGIS-Developer@lists.osgeo.org List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer