How to inspect AI object properties? about illustrator-scripting-python

[lohriialo]

There's not a straight forward way, have to read the documentation to understand what properties/attributes are available for a scripting object, or possibly a COM browser. For example, I've extracted the Python scripting object reference for Illustrator CC 2018 at doc_reference

Example: app.Documents object has properties like Add AddDocument AddDocumentWithDialogOption Arrange Index Item

[GlassGruber]

Thanks a lot for your answer and sorry for the very late reply.

I've searched a bit and found that basically what you say is true, but there are margin of improvements based on the working setup. For example this definition will ensure that the client object will generate a library file that will be used as a reference:

import win32com.client
# Get the Application object and ensure there is a library file generated 
# via makepy.py from win32com with COM class definitions and methods
APP = win32com.client.gencache.EnsureDispatch("InDesign.Application")

This way the autocomplete mechanism should find the methods available for the object.

Unfortunately normal autocomplete mechanisms won't display the properties of the object, buried inside the _prop_map_get_ dict.

Related to this, I found a nice addition for IPython allowing auto complete for objects too.

# from https://stackoverflow.com/a/47613008/1262357
from IPython.utils.generics import complete_object

@complete_object.when_type(win32com.client.DispatchBaseClass)
def complete_dispatch_base_class(obj, prev_completions):
    try:
        ole_props = set(obj._prop_map_get_).union(set(obj._prop_map_put_))
        return list(ole_props) + prev_completions
    except AttributeError:
        pass

Hope this can be useful, and that some one can improve and suggest more on this matter!