[Bf-committers] Can we please stop breaking APIs?

Campbell Barton ideasman42 at gmail.com
Fri Jul 15 08:14:43 CEST 2011


Nope, the api is not stable and probably wont be until blender
development ceases.

Instead we document what changes/breaks between releases, and try to
keep *reasonably* stable.
http://www.blender.org/documentation/blender_python_api_2_58_release/change_log.html

As for this change, I didn't think this module was in wide use (the
buffer part especially),
'bgl' was quickly patched to work with python3, this module got left
behind with the initial api update/rewrite, still needs to be finished
porting to py3 (slicing) and only got docs working again recently.

While I'm not totally against deprecation in some cases I suspect
you're one of the few people using this part of the API.

A quick workaround to allow running with both versions.

ls = buf.to_list() if hasattr(buf, "to_list") else getattr(buf, "list")

On Fri, Jul 15, 2011 at 1:41 PM, Mitchell Stokes <mogurijin at gmail.com> wrote:
> Hello devs,
>
> I thought the 2.5 Python API was supposed to be considered "stable",
> but lo and behold, a recent commit once again broke my scripts. The
> commit in question changes BGL.Buffer.list to BGL.Buffer.to_list()
> [1]. Bgui[2] makes use of BGL and is now broken. Furthermore, if I fix
> Bgui to work with Blender trunk and I release a version of Bgui before
> Blender 2.59 (which is possible), then Bgui would have a requirement
> of needing an "in development" version of Blender. If we're going to
> be changing APIs, can we at least keep old things around as
> "deprecated" for a release or two?
>
> [1] http://lists.blender.org/pipermail/bf-blender-cvs/2011-July/037581.html
> [2] https://code.google.com/p/bgui/
>
> Thank you,
> Mitchell Stokes
> _______________________________________________
> Bf-committers mailing list
> Bf-committers at blender.org
> http://lists.blender.org/mailman/listinfo/bf-committers
>



-- 
- Campbell


More information about the Bf-committers mailing list