XModules

ModuleLoader

ModuleLoader is a module loading system. It allows you to load a module with spcifing only its name.

The standard way to load a module/libray in AppleScript may be using load script command. But in the case of this command, you must give a full path to a module. And the path is maintain by your self. ModuleLoader can search the module from predefined locations and update dpendencies by only its name.

• Mac OS X 10.5 - 10.6

AppleScriptDoc

AppleScriptDoc is a formatter of reference manual of AppleScript modules.

AppleScriptDoc generates HTML files from markuped comments in the source code. The markup rules of comments are similar to JavaDoc or HeaderDoc. The reference manual can be setup into a script bundle as Help Book which can be shown in HelpViewer.

• Mac OS X 10.4
  • Version 1.2.3

• Mac OS X 10.5 - 10.6
• HelpBook.osax

XList

XList provides a wapper object to treat AppleScript's list as iterator, stack and queue.

XList will fill many missing features of AppleScript's list.

• XText
• ShowHelpBook

XDict

XDict is a module of AppleScript to provides associative list type data collection. The associateve list is a collection of pairs of keys and values.

• XList
• ShowHelpBook

XText

XText is a wrapper object of AppleScript's text object. XText provides object oriented interface to manipulate text and some advanced features.

The parent of instances of XText is AppleScript's text object. Therefore ...

• Properties of AppleScript's text can be obtained form a XText instance in same way to normal AppleScript's text object (string and Unicode text).
• An instance of XText is immutable like string or Unicode class object.

• ShowHelpBook

XCharacterSet

XCharacterSet is an AppleScript module to provids a object which represent a character set. You can build a character set object using variety methods to specify a group of characters and passing a list of characters to the object.

You can check whether characters of a text are members of the XCharacterSet instance or not.

• ShowHelpBook

XFile

XFile is a module of AppleScript to provides unified object oriented interface to file operation (moving, removing, geting attributes and so on).

Functions of file operations of AppleScript world is given by Scrpting Additions, Finder, System Events and shell commnads. Functions is distributed and cumbersome. XFile wraps these components and introduces a file object for unified object oriented interface.

• PathAnalyzer
• XText
• ShowHelpBook

PathAnalyzer

PathAnalyzer is an AppleScript module to obtain various infomation with analyzing a path to a file or a folder.

Without asking Finder, following infomation can be obtain from various reference types（alias, file specification, path string, furl class and Finder's object specifier).

• a reference to the folder containing the item
• a name of the folder
• a reference to the disk containing the item
• file name
• path extension
• whether the item is a folder or not

• XText
• ShowHelpBook

PathConverter

PathConverter is an AppleScript module to convet path forms between a relative path and an absolute path each other. Both path styles of POSIX and HFS can be dealt with PathConverter.

• XText
• ShowHelpBook

FileSorter

FileSorter is an AppleScript module to sort a list of files of folders according to their view sorting order in the Finder.

• ShowHelpBook
• SortEngine

InsertionLocator

InsertionLocator is an AppleScript module to obtain insertion/selected location in Finder with smarter way than Finder does.

Finder's insertion location property always means the top level folder of Finder window. This behavior is not enough in same cases, for example expanded subfolder shown in a list view window can not be the insertion location.

InsertionLocator allow following behaviors.

• If a file is selected, the container of the file can be insertion location.
• The selected folder can be insertion location.
• The only selected folder which is expanded subfolder in the list view window can be insertion location.

These behaivor can be customizable to meet your application.

• ShowHelpBook

FrontAccess

• URI Escape.osax

• ShowHelpBook

GUIScriptingChecker

GUIScriptingChecker is an AppleScript module to check availability of "GUI Scripting".

To enable "GUI Scripting", the status of access for assitive devices in System Preferences must be ON. But default status is OFF. Therefore you should check availability of "GUI Scriting" at the beginning of the script which depends on "GUI Scripting".

"GUIScriptingChecker" take on boring routine task instead of you.

• Mac OS X 10.4
• HelpBook.osax
• ModuleLoader

ShowHelpBook

ShowHelpBook is an AppleScript module to register/display a help book of current bundle in Help Viewer. The porpose of ShowHelpBook provide a function to display a help book in own bundle to AppleScript applets, droplets and script bundles.

About setting up a help book into a bundle, see Apple's developer documents or HelpBook.osax's manual.

Main tasks are dealt with HelpBook.osax. ShowHelpBook provides error handling and recovering Info.plist.

• Mac OS X 10.4
• HelpBook.osax
• ModuleLoader

XAccessor

XAccessor is an AppleScript module to generate an accessor object to access properties of script object or record and global variable with specifing its name with a text.

• get/set a value of a propety of script object or record specifed with its name with a text.
• get/set a global variable specified with its name with a text.

• ShowHelpBook

XHandler

XHandler is an AppleScript module to execute a handler with specifying its name with a text. This module allows to change a handler to execute at run time

Also XHandler can be used for chain of responder pattern and method forwarding.

• ShowHelpBook

SortEngine

SortEngine is a sort routine which have the quick sort and the bubble sort algorithm. And the behaivoir can be coustomied with object oriented interface.

• XList
• ShowHelpBook

UniqueNamer

UniqueNamer is an AppleScript module to obtain a unique file name in a specified folder.

If an item which have same name to given candidate exists, UniqueNamer generates a name to which numbers is appended at the end of the base name. For example:

hello.1.text、hello.2.text . . .

Also UniqueNamer can generate a compatible name to the classic enviroment (Mac OS 9 or before). The length of file name is limited under 31 bytes in the classic enviroment.

UniqueNamer is useful for following purposes :

• Generating a name of temporary files
• Copying or Making a file without asking a user enter a file name.
• Avoid opening a save-dialog, which interrupts workflows.

• ShowHelpBook

StringEngine

StringEngine is a collection of text handling routines of AppleScript. Almost routines for usual tasks are included as follows.

• replacing text
• splitting text with a delimiter
• joinning as a list of texts with a delimiters
• Converting styled text into plain text
• exchanging new line characters
• stripping blank spaces
• formatting text
• managing AppleScript's text item delimiters

• XCharacterSet
• ShowHelpBook