Re: [g-a-devel] my atspi examples available

[Alejandro Piñeiro <apinheiro igalia com>]

On 12/11/14 17:17, Magdalen Berns wrote:

Hi Alejandro,

Great idea! I'm happy to clone that and add some _javascript_ and python work, if this is useful. From my end, I would be keen to see some C examples on there as I feel this would be very informative.

Ok. As I mentioned, right now there are more C examples that other languages examples. So a first task could be port those C examples (and functionality) to other language. Until they became somewhat mature, I prefer to maintain it as a private github repository. Anyone can use github issues and pull request to propose new code, instead of GNOME bugzilla.

I suspect emphasising good documentation practice for this module will increase it's usefulness to those wishing to learn from the examples themselves. Perhaps it is worth taking some time to establish some sort of "documentation practices" guide for the module so that developers wishing to add code examples in for each of the relevant languages concerned, are prompted to mind to that stuff when submitting new examples?

Ok, but I don't think that something really complex or formal are needed. Eventually I will write a informal guide. In general, I think that the more important aspect is keep in mind that those are examples, not full programs, so they should be small, and probably focused on specific features/API of the libatspi library.

Regards,

Magdalen

On Wed, Nov 12, 2014 at 3:24 PM, Alejandro Piñeiro <apinheiro igalia com> wrote:

Hello,

recently Joanmarie asked me if I had any atspi example written in _javascript_, and I started to search my disorganized folder of custom scripts, and I also found several examples most of them written in C (libatspi), and one in _javascript_ (libatspi with gobject introspection).

Right now there aren't any similar thing on any official repository, so I cleaned them up and uploaded on a private github repository:
https://github.com/infapi00/atspi-examples

They are basic stuff like list the available accessible applications, dump the accessibility hierarchy of a given app and print out the current selected/focused accessible object on each state change.

The next immediate tasks would be have equivalent examples of the current C ones written in _javascript_ and python examples (both using pyatspi2 and gobject introspection). Then we could think on adding more examples.

Although they need some more cleaning, I think that it would be worth to eventually move them to a gnome repository. Initially I was thinking on putting them directly at at-spi2-core repository, but that would prevent to add non-C examples without complicating too much the configure. So I think that if they become part of a gnome repository, it should be also independent of at-spi2 repository. Would be somewhat similar to gnome-shell and gnome-shell extensions. Opinions?

BR

--
Alejandro Piñeiro (apinheiro igalia com)

_______________________________________________
gnome-accessibility-devel mailing list
gnome-accessibility-devel gnome org
https://mail.gnome.org/mailman/listinfo/gnome-accessibility-devel

-- 
Alejandro Piñeiro (apinheiro igalia com)