nxt_python API change - rename vs break?

[Martin Langhoff]

Hello list,

Fedora currently ships nxt_python 0.7 (packaged by John McLean) -- a
library to generate Lego NXT bytecode from python.

The upstream library has moved forward under a new lead developer
(Marcus Wanner, cc'd). The current code - nxt 2.0.1 - uses the same
name, but breaks API.

Upstream is unlikely to rename the lib to nxt2 (at least within this
release series, hopefully the next API break brings a name change :-)
).

What is the recommended path of action? The options I can see are

 - Package it as nxt2_python - patching the src where needed. Allows
parallel installation, but breaks upstream documentation and
expectations of users that have been using the lib from src or egg.
Maybe Marcus can add "when under Fedora, use "import nxt2 as nxt".

 - Work with John to upgrade nxt_python from 0.7 to 2.0.1, break with
the past. Unclear whether it is widely used (do we have anything like
popcon?)

The Python packaging wikipage doesn't seem to cover this case -- are
there any good past experiences with hold any strong recommendation.

Background: there is an fantastic integration of nxt_python 2.0.1 with
TurtleArt -- controlling these robots from XO laptops (or Sugar
desktop, or any Fedora desktop) with TurtleArt is a lot of fun. Trying
to tidy up and package all the components so that it's part of our
builds.

cheers,


m
--
 martin(a)laptop.org -- Software Architect - OLPC
 - ask interesting questions
 - don't get distracted with shiny stuff  - working code first
 - http://wiki.laptop.org/go/User:Martinlanghoff

[Jonathan Dieter]

On Mon, 2011-01-31 at 11:50 -0700, Martin Langhoff wrote:
>  Hello list,
>  
>  Fedora currently ships nxt_python 0.7 (packaged by John McLean) -- a
>  library to generate Lego NXT bytecode from python. 
<snip>
>   - Work with John to upgrade nxt_python from 0.7 to 2.0.1, break
> with
>  the past. Unclear whether it is widely used (do we have anything like
>  popcon?) 
I'd vote for this one with the proviso that the API break is only done
for Rawhide.  Having said that, I'll probably rebuild it locally for
Fedora 13 as that's what's deployed at our school.

Jonathan

[Martin Langhoff]

On Mon, Jan 31, 2011 at 12:55 PM, Jonathan Dieter <jdieter(a)lesbg.com&gt; wrote:
> >  - Work with John to upgrade nxt_python from 0.7 to 2.0.1, break
> with
> > the past. Unclear whether it is widely used (do we have anything like
> > popcon?)
>
>  I'd vote for this one with the proviso that the API break is only done
>  for Rawhide.  Having said that, I'll probably rebuild it locally for
>  Fedora 13 as that's what's deployed at our school. 
Sample packages that do exactly that (upgrade, breaking API), at

   http://dev.laptop.org/~martin/nxt/

Also interesting for anyone playing with NXT - NBC package:

   http://dev.laptop.org/~martin/nbc/



m
-- 
 martin.langhoff(a)gmail.com
 martin(a)laptop.org -- Software Architect - OLPC
 - ask interesting questions
 - don't get distracted with shiny stuff  - working code first
 - http://wiki.laptop.org/go/User:Martinlanghoff