#cp.dev

A set of handy developer tools for CommandPost.


#API Overview

Functions - API calls offered directly by the extension


#API Documentation

#Functions

Signaturecp.dev.elementAtMouse() -> axuielementObject
TypeFunction
DescriptionGets the AX element under the current mouse position.
Parameters
  • None
Returns
  • None
NotesNone
ExamplesNone
Sourcesrc/extensions/cp/dev/init.lua line 146

Signaturecp.dev.findUnusedLanguageStrings() -> string
TypeFunction
DescriptionSearches for any unused language strings in English.json.
Parameters
  • None
Returns
  • A string with the results of the search.
NotesNone
ExamplesNone
Sourcesrc/extensions/cp/dev/init.lua line 66

Signaturecp.dev.highlight(element) -> axuielementObject
TypeFunction
DescriptionHighlights an AX element on the screen.
Parameters
  • element - The AX element to highlight.
Returns
  • The element.
NotesNone
ExamplesNone
Sourcesrc/extensions/cp/dev/init.lua line 277

Signaturecp.dev.highlightFrame(frame) -> none
TypeFunction
DescriptionHighlights aa frame on the screen.
Parameters
  • frame - A hs.geometry frame object.
Returns
  • None
NotesNone
ExamplesNone
Sourcesrc/extensions/cp/dev/init.lua line 319

Signaturecp.dev.highlightPoint(point) -> none
TypeFunction
DescriptionHighlights a point on the screen.
Parameters
  • point - A hs.geometry point object.
Returns
  • None
NotesNone
ExamplesNone
Sourcesrc/extensions/cp/dev/init.lua line 352

Signaturecp.dev.hotkey(fn) -> none
TypeFunction
DescriptionAssigns a function to the CONTROL+OPTION+COMMAND+SHIFT+Q keyboard combination.
Parameters
  • fn - A function to execute when the hotkey is triggered.
Returns
  • None
NotesNone
ExamplesNone
Sourcesrc/extensions/cp/dev/init.lua line 53

Signaturecp.dev.inspect(item, options) -> string
TypeFunction
DescriptionInspect an item.
Parameters
  • item - The object to inspect.
  • options - Any additional options to pass along to cp.dev.inspectElement.
Returns
  • A results as a string.
NotesNone
ExamplesNone
Sourcesrc/extensions/cp/dev/init.lua line 195

Signaturecp.dev.inspectAtMouse(options) -> none
TypeFunction
DescriptionInspects an AX element under the current mouse position. Writes results to Debug Console.
Parameters
  • options - Any additional options to pass along to cp.dev.inspectElement.
Returns
  • None
NotesNone
ExamplesNone
Sourcesrc/extensions/cp/dev/init.lua line 159

Signaturecp.dev.inspectElement(element[, options]) -> none
TypeFunction
DescriptionInspect an AX element. Writes results to Debug Console.
Parameters
  • element - The element to inspect.
  • options - A table containing any optional values.
Returns
  • None.
Notes
  • The options table accepts the following parameters:
  • depth - A number representing the maximum depth to recurse into variable.
ExamplesNone
Sourcesrc/extensions/cp/dev/init.lua line 234

Signaturecp.dev.inspectElementAtMousePath(options) -> none
TypeFunction
DescriptionInspects an AX element at the mouse path.
Parameters
  • options - A table containing any optional values.
Returns
  • None
NotesNone
ExamplesNone
Sourcesrc/extensions/cp/dev/init.lua line 393

Signaturecp.dev.test(id) -> cp.test
TypeFunction
DescriptionThis function will return a cp.test.
Parameters
  • id - the id to test.
Returns
  • A [cp.test] to execute.
Notes
  • This function will return a cp.test with either the name <id>_test or <id>._test if the <id> is pointing at a folder.
  • For example, you have an extensions called foo.bar, and you want to create a test for it.
  • Option 1: <id>_test
  • File: /src/tests/foo/bar_test.lua
  • Option 2: <id>._test
  • File: /src/tests/foo/bar/_test.lua
  • You could then run all the contained tests like so:
  • lua</li><li>_test("foo.bar")()</li><li>
ExamplesNone
Sourcesrc/extensions/cp/dev/init.lua line 406

Signaturecp.dev.which(cmd) -> none
TypeFunction
DescriptionThe which utility takes a list of command names and searches the path for each executable file that would be run had these commands actually been invoked.
Parameters
  • cmd - The parameters to pass along to the which executable.
Returns
  • The path or nil and the error message if an error occurs.
NotesNone
ExamplesNone
Sourcesrc/extensions/cp/dev/init.lua line 122