from appscript import *

indd = app("Adobe InDesign CC 2019")
# print(indd.version())
doc = indd.active_document
# print(doc.name())
tfs = doc.text_frames
# print(len(tfs()))
first_tf = tfs[1] # 1-based indexing
characters = first_tf.characters

# syntax: parent_object.make(new=k.type)
indd.make(new=k.document) # add a new document
doc.make(new=k.page) # add a new page to doc
doc.pages[1].make(new=k.text_frame) # add a new text frame to page 1
first_tf.make(new=k.table) # add a new talbe to first_tf

doc.class_() # k.document
first_tf.class_() # k.text_frame

# same to python keyword arguments
doc.close(saving=k.ask, saving_in="path/to/file.indd")

doc.name()
first_tf.contents()

doc.name.get()
first_tf.contents.get()

first_tf.contents.set("sample contents")
first_tf.fill_color.set("Cyan")
first_tf.geometric_bounds.set([0,0,50,100])

# set properties at one time (this is faster)
first_tf.properties_.set({
        k.contents: "sample contents",
        k.fill_color: "Cyan",
        k.geometric_bounds: [0,0,50,100]
    })

tfs["abc"] # return the 1st text frame whose name is "abc"
# javascript: tfs.itemByName("abc")

tfs.ID(1234) # return text frame whose ID is 1234
# javascript: tfs.itemByID(1234)

characters[1:3] # note: include the 3rd item !!!!!
# javascript: characters.itemByRange(0, 2)

# This doesn't speed up processing
indd.script_preferences.enable_redraw.set(False)