Re: [Stellarium-pubdevel] scripting api / time functions

[Matthew G. <mat...@gm...>]

For now I've implemented some fairly flexible functions in the 
StelMainScriptAPI class.  

Let's do it like this: where there is any doubt about suitability of 
classes / slots from the core & modules being visible to the script engine, 
I will implement a member in StelMainScriptAPI .  

This way we can take some more time to smooth out the API for the core and 
modules.  Until we make a release with the new scripting engine, no 
promises should be made about changes to the API.  After we have made a 
release with the new scripting engine we should maintain the scripting 
compatibility up to major releases (so 0.10.2 and 0.10.3 should support all 
the scripting commands of 0.10.1, for example).  

At Major releases, scripting API changes should be well documented, e.g.  
when releasing 0.11.0 we might say:

 core.setDate is deprecated, use MovementMgr.setDate from now on.

We can drop deprecated StelMainScriptAPI members in the following major 
release.  When we finally get to version 1.0.0, we should have a nice clean 
stable scripting API.  

I wonder what the version before 1.0.0 will be, and when it will be.  

As for the specific decision about Navigator or MovementMgr for those time 
functions, I don't know.  I don't have a complete understand of what 
Navigator actually does, so I can't really express an informed opinion.

Matthew

On Friday 31 October 2008, Fabien Chéreau wrote:
> I was thinking about that yesterday, and I thought that maybe we could
> move those methods API into the MovementMgr class, which is already
> exposed. I am not 100% sure though, what do you think?
> Fab
>
> On Fri, Oct 31, 2008 at 6:03 AM, Matthew Gates <mat...@gm...> 
wrote:
> > Hi Fabien,
> >
> > There are a number of time-based functions which will be useful for
> > scripting - setting the simulation time to system time;
> > adding/subtracting days, weeks etc.  i.e. the public slots in
> > Navigator.
> >
> > Would you like to expose Navigator to scripting, or would you prefer
> > that we
> > mediate it all through StelMainScriptAPI?   I would guess that you
> > prefer to keep Navigator hidden (at least for now), and I will work on
> > that assumption.  Tell me if you think differently.
> >
> > Matthew
> >
> >
> >
> > -----------------------------------------------------------------------
> >-- This SF.Net email is sponsored by the Moblin Your Move Developer's
> > challenge
> > Build the coolest Linux based applications with Moblin SDK & win great
> > prizes
> > Grand prize is a trip for two to an Open Source event anywhere in the
> > world http://moblin-contest.org/redirect.php?banner_id=100&url=/
> > _______________________________________________
> > Stellarium-pubdevel mailing list
> > Ste...@li...
> > https://lists.sourceforge.net/lists/listinfo/stellarium-pubdevel