Easier method for documenting and setting gestures for global plugin scripts #6266

ctoth · 2016-08-15T23:33:53Z

I propose and will implement the following:

class GlobalPlugin(GlobalPlugin):

    @document(__("""Short description in gesture editor"""))
    @gesture("kb:NVDA+shift+g")
    def script_do_something(self, gesture):
        pass #script contents here

josephsl · 2016-08-15T23:41:48Z

CC @jcsteh, @camlorn, @derekriemer, @nvdaes

jcsteh · 2016-08-16T00:55:28Z

In general, I like this idea. A few comments:

Tiny correction: NVDA doesn't do lazy gettext at this stage, so __( should just be _(.
We'd want support for multiple gestures. Perhaps it could take a list. If you want, it could take either a list or a string to make it easier for the majority case, though that does make it difficult to know whether to use gesture/gestures (singular/plural).

Any reason not to combine this into one decorator?

  # Translators: Describes a command.
  @script(doc=_("Short desc"),
      gestures=["kb:NVDA+shift+g"])
  def script_foo(self, gesture):
      ...

This should not be specific to global plugins. If you implement it on baseObject.ScriptableObject, it should work everywhere (tm).

nvdaes · 2016-08-16T09:23:06Z

I'm wondering if this can cover the assignment of sequential gestures
too, for instance: kb:NVDA`+g c, kb:NVDA+g d, as done for some add-ons
currently.
Also, should be script categories cover too? Thanks.

2016-08-16 2:55 GMT+02:00, James Teh notifications@github.com:

In general, I like this idea. A few comments:
Tiny correction: NVDA doesn't do lazy gettext at this stage, so __(
should just be _(.

We'd want support for multiple gestures. Perhaps it could take a list. If
you want, it could take either a list or a string to make it easier for the
majority case, though that does make it difficult to know whether to use
gesture/gestures (singular/plural).
Any reason not to combine this into one decorator?
# Translators: Describes a command.
@script(doc=_("Short desc"),
    gestures=["kb:NVDA+shift+g"])
def script_foo(self, gesture):
    ...
This should not be specific to global plugins. If you implement it on
baseObject.ScriptableObject, it should work everywhere (tm).
You are receiving this because you were mentioned.
Reply to this email directly or view it on GitHub:
#6266 (comment)

ahicks92 · 2016-08-17T20:08:05Z

I think it should also work on plane old functions.

I think that you can detect the difference with isinstance. As I discussed on IRC we should really move toward some sort of simpler, class-free, single-file script API. Unfortunately, I'd be willing to bet this needs some sort of changes in core to work.

jcsteh · 2016-08-17T22:21:37Z

There are very good reasons I don't think a non-OO model is going to work for us. However, that is off topic for this issue. Let's not scope bloat.

jcsteh · 2016-08-17T22:26:37Z

I'm wondering if this can cover the assignment of sequential gestures
too, for instance: kb:NVDA`+g c, kb:NVDA+g d, as done for some add-ons
currently.

This is a different issue: #3687. Note that if that gets implemented, this should just work for the decorator being discussed here too (or at least it should be fairly easy to tweak).

Also, should be script categories cover too?

Definitely. if we go with the @script decorator, it can just be an additional keyword argument (category=SCRCAT_FOO).

ctoth · 2016-08-17T22:31:02Z

Currently categories appear to be set on the class level, So if you were
to define multiple @scripts it would set the last one as the category,
assuming we don't instead move the category attribute to the function
itself.
Should I leave this as is? Modify inputCore to check the function for a
scriptCategory attribute before the class? Something else entirely?

On 8/17/2016 4:26 PM, James Teh wrote:

I'm wondering if this can cover the assignment of sequential gestures
too, for instance: kb:NVDA`+g c, kb:NVDA+g d, as done for some add-ons
currently.
This is a different issue: #3687
#3687. Note that if that gets
implemented, this should just work for the decorator being discussed
here too (or at least it should be fairly easy to tweak).
Also, should be script categories cover too?
Definitely. if we go with the |@script| decorator, it can just be an
additional keyword argument (|category=SCRCAT_FOO|).

—
You are receiving this because you authored the thread.
Reply to this email directly, view it on GitHub
#6266 (comment),
or mute the thread
https://github.com/notifications/unsubscribe-auth/AAOcCHDSzgMReMHOlGFDthrmJ1sLjMJAks5qg4qhgaJpZM4Jk39r.

    -Q

Accessible Software for the Blind

http://GetAccessibleApps.com

jcsteh · 2016-08-17T22:33:11Z

There are two levels of category: class and method. For a method, there is a .category attribute. See globalCommands for an example of where this is used. The class category is used as the default if a method doesn't explicitly specify a category.

ctoth · 2016-08-17T22:34:51Z

Woof. I just grepped for scriptCategory assuming it would be the same
attribute everywhere. @script will just set the .category of the method
then. I should have enough to make this happen now.

On 8/17/2016 4:33 PM, James Teh wrote:

There are two levels of category: class and method. For a method, there
is a .category attribute. See globalCommands for an example of where
this is used. The class category is used as the default if a method
doesn't explicitly specify a category.

—
You are receiving this because you authored the thread.
Reply to this email directly, view it on GitHub
#6266 (comment),
or mute the thread
https://github.com/notifications/unsubscribe-auth/AAOcCFUyZREW70yIYMNBWsM1FJ6M0vi9ks5qg4wrgaJpZM4Jk39r.

    -Q

Accessible Software for the Blind

http://GetAccessibleApps.com

nvdaes · 2016-08-18T00:56:35Z

Thanks.

2016-08-18 0:26 GMT+02:00, James Teh notifications@github.com:

I'm wondering if this can cover the assignment of sequential gestures
too, for instance: kb:NVDA`+g c, kb:NVDA+g d, as done for some add-ons
currently.

This is a different issue: #3687. Note that if that gets implemented, this
should just work for the decorator being discussed here too (or at least it
should be fairly easy to tweak).

Also, should be script categories cover too?

Definitely. if we go with the @script decorator, it can just be an
additional keyword argument (category=SCRCAT_FOO).

You are receiving this because you were mentioned.
Reply to this email directly or view it on GitHub:
#6266 (comment)

…andler module added a metaclass for collecting gestures on ScriptableObjects, this now supports getting from .gesture and .gestures set on script_ functions by the @script decorator. Fixes nvaccess#6266

…ta (#8236) * added an @script decorator for setting script metadata to the scriptHandler module added a metaclass for collecting gestures on ScriptableObjects, this now supports getting from .gesture and .gestures set on script_ functions by the @script decorator. Fixes #6266 * Removed gesture attribute from script functions Now passing gesture to the ```@script``` decorator will append the gesture to the list of gestures, rather than setting both gesture and gestures attributes on the function. * Removed unused getScripts method from BaseObject * Address review comment and rename GestureCollector to ScriptableType * Make the script decorator gestures work both for normal and dynamic NVDAObjects. Provide a working example for Excel * First baceObject tests * Fix decorated scripts not properly being added when subclassing objects * Finish unit tests * Add bypasInputHelp and resumeSayAllMode to the script decorator * Review actions * Add unit tests for the script decorator itself * Update developer guide * Review actions * Review actions regarding devGuide and comments * Only use the per class __gestures dictionary, also for decorated scripts * Last review action * Revert NVDAObjects/__init__.py to master, as in the end, this hasn't been touched by this change * Also revert changes to test suite objectProvider * Split of lines in devGuide * Rename the scripts in test_baseObject to follow the phonetic alphabet, to fix a bug in baseObject that used only the first character of a script name. * Log warnings when using the script decorator in a wrong way, either by decorating a non method or a method which name doesn't start with script_

ctoth mentioned this issue Aug 18, 2016

added an @script decorator for setting script metadata to the scriptH… #6276

Closed

mohdshara mentioned this issue Sep 27, 2017

Individual keys to find comments and changes #7538

Open

leonardder added the feature label Feb 10, 2018

leonardder mentioned this issue May 4, 2018

added an @script decorator to scriptHandler for setting script metadata #8236

Merged

michaelDCurran closed this as completed in #8236 Jun 13, 2018

nvaccessAuto modified the milestone: 2018.3 Jun 13, 2018

josephsl mentioned this issue Dec 22, 2020

Global commands (2021.1): replace gestures map with script decorator #11964

Closed

Easier method for documenting and setting gestures for global plugin scripts #6266

Easier method for documenting and setting gestures for global plugin scripts #6266

ctoth commented Aug 15, 2016 •

edited

josephsl commented Aug 15, 2016

jcsteh commented Aug 16, 2016

nvdaes commented Aug 16, 2016

ahicks92 commented Aug 17, 2016

jcsteh commented Aug 17, 2016 via email

jcsteh commented Aug 17, 2016

ctoth commented Aug 17, 2016

jcsteh commented Aug 17, 2016 via email

ctoth commented Aug 17, 2016

nvdaes commented Aug 18, 2016

Easier method for documenting and setting gestures for global plugin scripts #6266

Easier method for documenting and setting gestures for global plugin scripts #6266

Comments

ctoth commented Aug 15, 2016 • edited

josephsl commented Aug 15, 2016

jcsteh commented Aug 16, 2016

nvdaes commented Aug 16, 2016

ahicks92 commented Aug 17, 2016

jcsteh commented Aug 17, 2016 via email

jcsteh commented Aug 17, 2016

ctoth commented Aug 17, 2016

jcsteh commented Aug 17, 2016 via email

ctoth commented Aug 17, 2016

nvdaes commented Aug 18, 2016

ctoth commented Aug 15, 2016 •

edited