<div dir="ltr"><div><div><div><div><div>Manu, </div>I just added the __init__.py file. </div>About the StopButton, I added the function add_stopbutton in order to be called when the activity developer finish its toolbar, because SimpleActivity can't know where it's ready, I think the only way to do this is when the user adds any item to the toolbar, move (actually, remove and insert again) the stopbutton with its separator to the end of the toolbar, but we would doing that every time an item is added and I think it doesn't make sense. </div>If there is a way to fix an item position, please let me know. </div>About new signals style: </div>They look nicer, when I want to define a signal without a function, I can do <div><div><div><div><div> <div> my_signal = GObject.Signal('my_signal', arg_types=(int)) as you said, then where I should put that? </div><div>self.mysignal = GObject.Signal(.... ? </div><div>Regards, </div><div>aguz </div> </div></div></div></div></div></div><div class="gmail_extra"> <div class="gmail_quote">2013/11/23 Manuel Quiñones <<a href="mailto:manuq@laptop.org" target="_blank">manuq@laptop.org</a>> <blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Nice! I will try to use it in Browse. We should aim to zero code duplication and make activities code easier. I gave a quick look at the code. I think SimpleActivity should take care of adding the Stop button. All activities will (must) have it. Please add an empty __init__.py file so we can use it as a module. A minor implementation thing: we started to use "new style" signals. They are more pythonic. So instead of adding a class attribute __gsignals__ you do: my_signal = GObject.Signal('my_signal', arg_types=(int,)) other_gobject.connect('my_signal', my_signal_handler) my_signal.emit(42) Example: <a href="https://git.gnome.org/browse/pygobject/tree/examples/signal.py" target="_blank">https://git.gnome.org/browse/pygobject/tree/examples/signal.py</a> Docstrings: <a href="https://git.gnome.org/browse/pygobject/tree/gi/_gobject/signalhelper.py" target="_blank">https://git.gnome.org/browse/pygobject/tree/gi/_gobject/signalhelper.py</a> 2013/11/21 Agustin Zubiaga Sanchez <<a href="mailto:aguz@sugarlabs.org">aguz@sugarlabs.org</a>>: <div><div class="h5">> = English (Español debajo) = > > Hi everyone, > > I am writing to show you what I was developing those last days, in order to > make simpler the developing of Sugar Activities, this module, micro library > or whatever you want to call it, makes much more easier the processes that > every activity does, for example create ToolButtons, add them to a Toolbar > or implement collaboration which is difficult for any starter developer. > The main idea is include SimpleAcivity in our toolkit, but thinking about > all the review processes it takes, you can add it to your activity for now > or you can take a look about how it works in the Demo activity I did [1], > where you can see how easy is to implement sharing or create the toolbar. > > * SimpleActivity classes * > > simpleactivity.SimpleActivity: > The activities which doesn't want to implement collaboration, can derive > from this class (instead of sugar3.activity.activity.Activity), this class > automatically adds the toolbar to the activity with his > ActivityToolbarButton and it makes easier some processes related to the > design, e.g. add buttons, separators, or whatever to the toolbar in only one > line and also other things related to the operation for example any number, > string, dictionary or list that is saved into the self.data variable will be > auto kept in the journal, and when the instance runs again, in self.data > will be what you leaved when the activity was closed. > Among these there are many other simple features, that after all, they do > everything much easier. > > simpleactivity.SharedActivity (derives from SimpleActivity, you can use all > its methods): : > From this class should derive every activity which needs to be shared, the > process is greatly simplified cause the communication is done automatically > and the "system" works with something like an event manager, so we only need > to worry about register our events in a python dict, where the keys are the > names of the events and the values are the functions to call when we receive > an event, and when we want to "emit" an event with the values we need or > not, all we have to do is to call send_event(event_name, data)... And that's > all, we don't have to worry about telepathy, dbus or anything like that, > SimpleActivity does everything for you :) > Also it includes an option to send files in a very easy way, using the > method send_file(file_path, data) that notifies every peer that a file is > available, and it can be downloaded just calling the download_file method, > and then SharedActivity will start emiting signals with information related > to the download progress, etc. > The process of downloading is done using another independent tube, then > nothing gets blocked while the file is sent/downloaded, we can continue > sending events while, and everything will continue working. > > Notes: > - Both classes derives from the "natives" classes of sugar, so we can > continue using every method of sugar.activity.activity.Activity or whatever, > without any problem. > - Whole SimpleActivity (module) is only one .py file, then we can put it > into our activity directory easily as we do with HelpButton or FontComboBox, > even if it isn't in sugar toolkit. > - It only supports GTK3, I think it is not necessary to make it compatible > with GTK2, because nowadays the new activities should be did in GTK3. > - I advice everyone who is interested to take a look of the documentation > that you can found in the docstrings in the file for now (I will create a > cleaner documentation with sphinx), to learn about all you can do with > SimpleActivity. > > Also I started a Feature wiki page [2], but is not ready yet. Could anyone > help me with that? > I need some documentation experts ;) > > I hope you find it useful, as I always say, I love developing for Sugar, > because it causes a great feeling to know that the lines of code I wrote > will be used directly or indirectly by millions of children around the > world. > > [1] <a href="https://git.sugarlabs.org/simpleactivity/" target="_blank">https://git.sugarlabs.org/simpleactivity/</a> > [2] <a href="http://wiki.sugarlabs.org/go/Features/SimpleActivity" target="_blank">http://wiki.sugarlabs.org/go/Features/SimpleActivity</a> > > Thank you very much, > aguz > > - > = Español = > > Hola a todos, > > Les escribo para presentarles lo que he estado desarrollando estos últimos > días, con el fin de hacer más simple la creación de actividades para Sugar, > este modulo, micro librería, o como quieran llamarle, hace mucho más fácil > los procesos que todas las actividades hacen, como crear ToolButtons, > agregarlos a una Toolbar o implementar colaboración para cualquier > desarrollador que esté comenzando. > La idea principal es incluir SimpleActivity en la toolkit de sugar, pero > tomando en cuenta todos los procesos de revisados que lleva, pueden ver como > funciona en el repositorio de la actividad de ejemplo HelloSimpleActivity > [1], que implementa un montón de características, y donde pueden ver lo > fácil que es implementar la colaboración o hacer la barra de herramientas. > > * Clases de simpleactivity * > > simpleactivity.SimpleActivity: > Las actividades que NO deseen implementar colaboración, pueden simplemente > heredar de esta clase (en lugar de sugar3.activity.activity.Activity), esta > clase agrega automáticamente la toolbar a la actividad con su > ActivityToolButton, y simplifica varios procesos relacionados con el diseño > por ejemplo agregar botones, separadores (o lo que sea) a la toolbar en una > sola linea y también otros de funcionamiento como por ejemplo cualquier > numero, string, diccionario o lista que se guarde, en la variable self.data, > al cerrar la actividad esta lo guardará automáticamente en el journal y al > abrir otra vez esta instancia de nuestra actividad, en self.data estará lo > que allí dejamos. > Entre estas hay muchas otras características simples, que al fin y al cabo, > hacen todo mucho más fácil. > > simpleactivity.SharedActivity (hereda de SimpleActivity, puedes usar támbien > todos sus metodos): > De esta clase deben heredar todas las actividades que deseen implementar > colaboración, el proceso se simplifica enormemente, ya que la comunicación > la hace toda automática, el "sistema" funciona con una especie de manejador > de eventos, por lo que solo debemos de preocuparnos por registrar nuestros > eventos en un diccionario de python, donde las claves son los nombres de los > eventos y los valores son las funciones a llamar cuando alguien nos envie > ese evento, y cuando deseamos emitirlos con los valores que necesitemos o no > (simpleactivity se encargara de notificar a cada maquina y enviar a todos > los datos) simplemente llamamos a una función send_event(nombre_evento, > datos)... Y listo! No debemos preocuparnos por telepathy, dbus ni nada por > el estilo, SimpleActivity hace todo por ti :) > Además incluye la opción de enviar archivos de una manera muy fácil, > utilizando un metodo send_file que avisa a todas las demás maquinas, que hay > un archivo disponible y podemos acceder a descargarlo simplemente llamando > la función download_file y SharedActivity comenzará a emitir señales con > información acerca del progreso de descarga, etc. > El proceso de descarga de archivos se hace por un tubo aparte por lo cual, > nada se bloquea mientras el archivo se envia/descarga, podemos seguir > enviando eventos sin problemas mientras lo hacemos, y todo seguirá > funcionando. > > Notas: > - Ambas clases heredan de las clases nativas de sugar, por lo cual podemos > utilizar todos los métodos de sugar3.activity.activity.Activity o lo que > sea que deseemos, sin ningún problema. > - SimpleActivity (módulo) es en su totalidad un solo archivo .py por lo que > podemos incorporarlo en nuestra actividad muy fácilmente, así como lo > hacemos con HelpButton o FontComboBox, aunque aún no esten en sugar toolkit. > - Soporta solo GTK3, creo que no es necesario dedicarnos a hacer una versión > compatible con GTK2, porque hoy en día las actividades nuevas se deben hacer > desde el inicio con GTK3. > - Recomiendo a todos los interesados revisar la documentación que está en > docstrings en el archivo por ahora, (proximamente armaré una documentación > más prolija con sphinx), para enterarse de todo lo que se puede hacer con > simpleactivity. > > Además comencé con una pagina en la wiki [2], pero todavía no está lista. > ¿Alguien quiere ayudarme con eso? > Necesito ayuda de los expertos en documentación ;) > > Espero que les sea útil, como siempre digo, me encanta desarrollar para > Sugar, porque me provoca un sentimiento inexplicable saber que las lineas de > código que escribo van a ser utilizadas directa o indirectamente por > millones de chicos al rededor del mundo. > > [1] <a href="https://git.sugarlabs.org/simpleactivity/" target="_blank">https://git.sugarlabs.org/simpleactivity/</a> > [2] <a href="http://wiki.sugarlabs.org/go/Features/SimpleActivity" target="_blank">http://wiki.sugarlabs.org/go/Features/SimpleActivity</a> > > Muchas gracias, > aguz > > > > </div></div>> _______________________________________________ > Sugar-devel mailing list > <a href="mailto:Sugar-devel@lists.sugarlabs.org">Sugar-devel@lists.sugarlabs.org</a> > <a href="http://lists.sugarlabs.org/listinfo/sugar-devel" target="_blank">http://lists.sugarlabs.org/listinfo/sugar-devel</a> > -- .. manuq .. _______________________________________________ Lista olpc-Sur <a href="mailto:olpc-Sur@lists.laptop.org">olpc-Sur@lists.laptop.org</a> <a href="http://lists.laptop.org/listinfo/olpc-sur" target="_blank">http://lists.laptop.org/listinfo/olpc-sur</a> </blockquote></div> </div>