RubyGems - rb-appscript - Versions diffs - 0.2.0 - Mend

rb-appscript 0.2.0

Files changed (83) hide show

data/CHANGES +243 -0
data/LICENSE +1 -0
data/README +42 -0
data/TODO +31 -0
data/doc/aem-manual/01_introduction.html +48 -0
data/doc/aem-manual/02_apioverview.html +89 -0
data/doc/aem-manual/03_packingandunpackingdata.html +98 -0
data/doc/aem-manual/04_references.html +401 -0
data/doc/aem-manual/05_targettingapplications.html +133 -0
data/doc/aem-manual/06_buildingandsendingevents.html +175 -0
data/doc/aem-manual/07_findapp.html +54 -0
data/doc/aem-manual/08_examples.html +85 -0
data/doc/aem-manual/09_notes.html +41 -0
data/doc/aem-manual/aemreferenceinheritance.gif +0 -0
data/doc/aem-manual/full.css +21 -0
data/doc/aem-manual/index.html +43 -0
data/doc/appscript-manual/01_introduction.html +82 -0
data/doc/appscript-manual/02_aboutappscripting.html +244 -0
data/doc/appscript-manual/03_quicktutorial.html +154 -0
data/doc/appscript-manual/04_gettinghelp.html +101 -0
data/doc/appscript-manual/05_keywordconversion.html +91 -0
data/doc/appscript-manual/06_classesandenums.html +174 -0
data/doc/appscript-manual/07_applicationobjects.html +181 -0
data/doc/appscript-manual/08_realvsgenericreferences.html +86 -0
data/doc/appscript-manual/09_referenceforms.html +232 -0
data/doc/appscript-manual/10_referenceexamples.html +142 -0
data/doc/appscript-manual/11_applicationcommands.html +204 -0
data/doc/appscript-manual/12_commandexamples.html +129 -0
data/doc/appscript-manual/13_performanceissues.html +115 -0
data/doc/appscript-manual/14_problemapps.html +193 -0
data/doc/appscript-manual/15_notes.html +84 -0
data/doc/appscript-manual/application_architecture.gif +0 -0
data/doc/appscript-manual/application_architecture2.gif +0 -0
data/doc/appscript-manual/finder_to_textedit_event.gif +0 -0
data/doc/appscript-manual/full.css +21 -0
data/doc/appscript-manual/index.html +49 -0
data/doc/appscript-manual/relationships_example.gif +0 -0
data/doc/appscript-manual/ruby_to_itunes_event.gif +0 -0
data/doc/index.html +30 -0
data/doc/mactypes-manual/index.html +216 -0
data/doc/osax-manual/index.html +169 -0
data/extconf.rb +54 -0
data/misc/adobeunittypes.rb +14 -0
data/misc/dump.rb +72 -0
data/rb-appscript.gemspec +20 -0
data/sample/AB_list_people_with_emails.rb +8 -0
data/sample/Create_daily_iCal_todos.rb +72 -0
data/sample/Hello_world.rb +9 -0
data/sample/List_iTunes_playlist_names.rb +7 -0
data/sample/Make_Mail_message.rb +29 -0
data/sample/Open_file_in_TextEdit.rb +9 -0
data/sample/Organize_Mail_messages.rb +57 -0
data/sample/Print_folder_tree.rb +12 -0
data/sample/Select_all_HTML_files.rb +8 -0
data/sample/Set_iChat_status.rb +20 -0
data/sample/Simple_Finder_GUI_Scripting.rb +14 -0
data/sample/Stagger_Finder_windows.rb +21 -0
data/sample/TextEdit_demo.rb +126 -0
data/sample/iTunes_top40_to_html.rb +64 -0
data/src/lib/_aem/aemreference.rb +1006 -0
data/src/lib/_aem/codecs.rb +617 -0
data/src/lib/_aem/connect.rb +100 -0
data/src/lib/_aem/findapp.rb +83 -0
data/src/lib/_aem/mactypes.rb +228 -0
data/src/lib/_aem/send.rb +257 -0
data/src/lib/_aem/typewrappers.rb +57 -0
data/src/lib/_appscript/defaultterminology.rb +245 -0
data/src/lib/_appscript/referencerenderer.rb +132 -0
data/src/lib/_appscript/reservedkeywords.rb +107 -0
data/src/lib/_appscript/terminology.rb +314 -0
data/src/lib/aem.rb +216 -0
data/src/lib/appscript.rb +830 -0
data/src/lib/kae.rb +1484 -0
data/src/lib/osax.rb +171 -0
data/src/rbae.c +766 -0
data/test/README +1 -0
data/test/test_aemreference.rb +112 -0
data/test/test_appscriptreference.rb +102 -0
data/test/test_codecs.rb +159 -0
data/test/test_findapp.rb +24 -0
data/test/test_mactypes.rb +67 -0
data/test/testall.sh +9 -0
metadata +143 -0

data/doc/appscript-manual/09_referenceforms.html ADDED Viewed

@@ -0,0 +1,232 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<title>appscript | 9. Reference Forms</title>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+<style type="text/css" media="all"><!--@import url(full.css);--></style>
+</head>
+<body>
+<h1>9. Reference Forms</h1>
+<!-- top navigation -->
+<div class="navbar">
+	<a href="08_realvsgenericreferences.html">Previous</a> | <a href="index.html">Up</a> | <a href="10_referenceexamples.html">Next</a>
+</div>
+<!-- content -->
+<div id="content">
+<h2>Property Reference</h2>
+<p>A property either contains a simple value or represents a one-to-one relationship between two application objects. Properties either describe the application object (its name, class, size, color, preferences, etc.) or provide a convenient reference to other object(s) of interest to users (e.g. home, current_track).</p>
+<p>Syntax:</p>
+<pre><code>reference.property</code></pre>
+<p>Examples:</p>
+<pre><code>textedit.<em>name</em>
+textedit.documents[1].<em>text</em>
+finder.<em>home</em>.files.<em>name</em></code></pre>
+<h2>Element References</h2>
+<p>Elements represent a one-to-many relationship between application objects. Elements usually reflect the containment structure of the application object model and generally provide multiple ways of referencing some or all of those objects (e.g. characters/words/paragraphs of documents by index/relative-position/range/filter).</p>
+<h3>All Elements</h3>
+<p>Syntax:</p>
+<pre><code>reference.elements</code></pre>
+<p>Examples:</p>
+<pre><code>finder.home.<em>folders</em>
+textedit.<em>windows</em>
+textedit.<em>documents</em>.<em>paragraphs</em>.<em>words</em></code></pre>
+<h3>by Name</h3>
+<p>Syntax:</p>
+<pre><code>elements[specifier]
+        specifier : String -- name of object (as matches its 'name' property)</code></pre>
+<p>Examples:</p>
+<pre><code>disks['Macintosh HD']
+files['index.html']</code></pre>
+<p class="hilitebox">Note: applications usually treat object names as case-insensitive. Where multiple element have the same name, a by-name reference only identifies the first element found with that name. (Tip: to identify <em>all</em> elements with a particular name, use a by-filter reference instead.)</p>
+<h3>by Index</h3>
+<p>Syntax:</p>
+<pre><code>elements[specifier]
+        specifier : Fixnum | Bignum -- index of object</code></pre>
+<p>Examples:</p>
+<pre><code>words[3]
+items[-1]</code></pre>
+<p class="hilitebox">Note: elements are <em>one-indexed</em> (AEM-style indexing), not zero-indexed (Ruby-style indexing).</p>
+<h3>by ID</h3>
+<p>Syntax:</p>
+<pre><code>elements.ID(specifier)
+        specifier : anything -- object's id</code></pre>
+<p>Examples:</p>
+<pre><code>windows.ID(4321)</code></pre>
+<h3>by Absolute Position</h3>
+<p>Syntax:</p>
+<pre><code>elements.first -- first element
+elements.middle -- middle element
+elements.last -- last element
+elements.any -- random element</code></pre>
+<p>Examples:</p>
+<pre><code>documents.first
+paragraphs.last
+files.any</code></pre>
+<h3>by Relative Position</h3>
+<p>Syntax:</p>
+<pre><code>elements[specifier].previous(class) -- nearest element of a given class to appear
+                                       before the specified element
+elements[specifier].next(class) -- nearest element of a given class to appear
+                                   after the specified element
+        class : Symbol -- class of element (see <a href="4_classesandenums.html">Classes and Enumerated Types</a>)</code></pre>
+<p>Examples:</p>
+<pre><code>words[3].next(:word)
+paragraphs[-1].previous(:character)</code></pre>
+<h3>by Range</h3>
+<p>Range references select all elements between and including two references indicating the start and end of the range. The start and end references are normally declared relative to the container of the elements being selected. Appscript defines an object, <code>con</code> (short for 'container'), to indicate this container; for example, to indicate the third paragraph of the currrent container object:</p>
+<pre><code>AS.con.paragraphs[3]</code></pre>
+<p>For convenience, the range reference also allows start and end references to be written in shorthand form where their element class is the same as the elements being selected; thus:</p>
+<pre><code>ref.paragraphs[AS.con.paragraphs[3], AS.con.paragraphs[-1]]</code></pre>
+<p>can also be written as:</p>
+<pre><code>ref.paragraphs[3:-1]</code></pre>
+<p>Some applications can handle more complex range references. For example, the following will work in Tex-Edit Plus:</p>
+<pre><code>ref.words[AS.con.characters[5], AS.con.paragraphs[-2]]</code></pre>
+<p>Syntax:</p>
+<pre><code>elements[start, end]
+        start : Fixnum | Bignum | String | Reference -- start of range
+        end : Fixnum | Bignum | String | Reference -- end of range</code></pre>
+<p>Examples:</p>
+<pre><code>folders['Documents', 'Movies']
+documents[1, 3]
+text[AS.con.characters[5], AS.con.words[-2]]</code></pre>
+<p class="hilitebox">Note: ranges are specified as [start-position, <em>end-position</em>] (AEM-style ranges), not [start-position, <em>length</em>] (Ruby-style ranges).</p>
+<h3>by Filter</h3>
+<p>A reference to each element that satisfies one or more conditions specified by a test expression:</p>
+<pre><code>elements[testExpression]</code></pre>
+<p>Test expressions consist of the following:</p>
+<ul>
+<li><p>A reference to each element being tested, represented by appscript's <code>its</code> object. This object supports all valid reference forms, allowing you to construct references to its properties and elements. For example:</p>
+<pre><code>AS.its
+AS.its.size
+AS.its.words.first</code></pre></li>
+<li><p>One or more conditional tests, implemented as methods on the reference being tested. Each method takes a test reference or a value as their sole argument.</p>
+<p>Syntax:</p>
+<pre><code>reference.lt(value) # &lt;
+reference.le(value) # &lt;=
+reference.eq(value) # ==
+reference.ne(value) # !=
+reference.gt(value) # &gt;
+reference.ge(value) # &gt;=
+reference.starts_with(value)
+reference.ends_with(value)
+reference.contains(value)
+reference.is_in(value)
+reference.does_not_start_with(value)
+reference.does_not_end_with(value)
+reference.does_not_contain(value)
+reference.is_not_in(value)
+        value : reference or value</code></pre>
+<p>Examples:</p>
+<pre><code>AS.its.eq('')
+AS.its.size.gt(1024)
+AS.its.words.first.starts_with('A')
+AS.its.characters.first.eq(AS.its.characters.last)</code></pre>
+<p>Note that Boolean comparison tests can be written as either <code>reference.eq(true)</code> or just <code>reference</code>, e.g. <code>folderRef.files[AS.its.locked]</code></p></li>
+<li><p>Zero or more logical tests, implemented as properties/methods on conditional tests. The <code>and</code> and <code>or</code> methods take one or more conditional or logic tests as arguments.</p>
+<p>Syntax:</p>
+<pre><code>test.and(test, ...)
+test.or(test, ...)
+test.not</code></pre>
+<p>Examples:</p>
+<pre><code>AS.its.eq('').not
+AS.its.size.gt(1024).and(its.size.lt(10240))
+AS.its.words[1].starts_with('A').or(
+    its.words[2].contains('ce'),
+    its.words[1].eq('Foo'))</code></pre></li>
+</ul>
+<h2>Insertion Location</h2>
+<p>Insertion locations can be specified at the beginning or end of all elements, or before or after a specified element or element range.</p>
+<p>Syntax:</p>
+<pre><code>elements.start
+elements.end
+elements[specifier].before
+elements[specifier].after</code></pre>
+<p>Examples:</p>
+<pre><code>documents.end
+paragraphs[1].before</code></pre>
+</div>
+<!-- bottom navigation -->
+<div class="navbar">
+	<a href="08_realvsgenericreferences.html">Previous</a> | <a href="index.html">Up</a> | <a href="10_referenceexamples.html">Next</a>
+</div>
+<!--footer-->
+<p class="footer">&copy; 2006 HAS</p>
+</body>
+</html>

data/doc/appscript-manual/10_referenceexamples.html ADDED Viewed

@@ -0,0 +1,142 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<title>appscript | 10. Reference Examples</title>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+<style type="text/css" media="all"><!--@import url(full.css);--></style>
+</head>
+<body>
+<h1>10. Reference Examples</h1>
+<!-- top navigation -->
+<div class="navbar">
+	<a href="09_referenceforms.html">Previous</a> | <a href="index.html">Up</a> | <a href="11_applicationcommands.html">Next</a>
+</div>
+<!-- content -->
+<div id="content">
+<h2>Application objects</h2>
+<pre><code>require "appscript"
+# application &quot;Finder&quot;
+AS.app('Finder')
+# application &quot;Macintosh HD:Applications:TextEdit.app:&quot;
+AS.app('/Applications/TextEdit.app')</code></pre>
+<h2>Property References</h2>
+<pre><code># a reference to startup disk of application &quot;Finder&quot;
+AS.app('Finder').startup_disk
+# a reference to name of folder 1 of home of application &quot;Finder&quot;
+AS.app('Finder').home.folders[1].name
+# a reference to name of every item of home of application &quot;Finder&quot;
+AS.app('Finder').home.items.name
+# a reference to text of every document of application &quot;TextEdit&quot;
+AS.app('TextEdit').documents.text
+# a reference to color of character 1 of every paragraph of text &not;
+#     of document 1 of application &quot;TextEdit&quot;
+AS.app('TextEdit').documents[1].text.paragraphs.characters[1].color</code></pre>
+<h2>All Elements References</h2>
+<pre><code># a reference to disks of application &quot;Finder&quot;
+AS.app('Finder').disks
+# a reference to every word of every paragraph of text of every document &not;
+#     of application &quot;TextEdit&quot;
+AS.app('TextEdit').documents.text.paragraphs.words</code></pre>
+<h2>Single Element References</h2>
+<pre><code># a reference to disk 1 of application &quot;Finder&quot;
+AS.app('Finder').disks[1]
+# a reference to file &quot;ReadMe.txt&quot; of folder &quot;Documents&quot; of home of application &quot;Finder&quot;
+AS.app('Finder').home.folders['Documents'].files['ReadMe.txt']
+# a reference to paragraph -1 of text of document 1 of application &quot;TextEdit&quot;
+AS.app('TextEdit').documents[1].text.paragraphs[-1]
+# a reference to middle paragraph of text of last document of application &quot;TextEdit&quot;
+AS.app('TextEdit').documents.last.text.paragraphs.middle
+# a reference to any file of home of application &quot;Finder&quot;
+AS.app('Finder').home.files.any</code></pre>
+<h2>Relative References</h2>
+<pre><code># a reference to paragraph before paragraph 6 of text of document 1 of application &quot;TextEdit&quot;
+AS.app('TextEdit').documents[1].text.paragraphs[6].previous(:paragraph)
+# a reference to paragraph after character 30 of document 1 of application &quot;Tex-Edit Plus&quot;
+AS.app('Tex-Edit Plus').documents[1].characters[30].next(:paragraph)</code></pre>
+<h2>Element Range References</h2>
+<pre><code># a reference to words 1 thru 4 of text of document 1 of application &quot;TextEdit&quot;
+AS.app('TextEdit').documents[1].text.words[1, 4]
+# a reference to paragraphs 2 thru -1 of text of document 1 of application &quot;TextEdit&quot;
+AS.app('TextEdit').documents[1].text.paragraphs[2, -1]
+# a reference to folders &quot;Documents&quot; thru &quot;Music&quot; of home of application &quot;Finder&quot;
+AS.app('Finder').home.folders['Documents', 'Music']
+# a reference to text (word 3) thru (paragraph 7) of document 1 of application &quot;Tex-Edit Plus&quot;
+AS.app('Tex-Edit Plus').documents[1].text[AS.con.words[3], AS.con.paragraphs[7]]</code></pre>
+<h2>Filter References</h2>
+<pre><code># a reference to every document of application &quot;TextEdit&quot; whose text is &quot;\n&quot;
+AS.app('TextEdit').documents[AS.its.text.eq("\n")]
+# a reference to every paragraph of document 1 of application &quot;Tex-Edit Plus&quot; &not;
+#     whose first character is last character
+AS.app('Tex-Edit Plus').documents[1].paragraphs[
+    AS.its.characters.first.eq(AS.its.characters.last)]
+# a reference to every file of folder &quot;Documents&quot; of home of application &quot;Finder&quot; &not;
+#     whose name extension is &quot;txt&quot; and size < 10240
+AS.app('Finder').home.folders['Documents'].files[
+    AS.its.name_extension.eq('txt').AND(AS.its.size.lt(10240))]</code></pre>
+<h2>Insertion Location References</h2>
+<pre><code># a reference to end of documents of application &quot;TextEdit&quot;
+AS.app('TextEdit').documents.end
+# a reference to before paragraph 1 of text of document 1 of application &quot;TextEdit&quot;
+AS.app('TextEdit').documents[1].text.paragraphs[1].before</code></pre>
+</div>
+<!-- bottom navigation -->
+<div class="navbar">
+	<a href="09_referenceforms.html">Previous</a> | <a href="index.html">Up</a> | <a href="11_applicationcommands.html">Next</a>
+</div>
+<!--footer-->
+<p class="footer">&copy; 2006 HAS</p>
+</body>
+</html>

data/doc/appscript-manual/11_applicationcommands.html ADDED Viewed

@@ -0,0 +1,204 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<title>appscript | 11. Application Commands</title>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+<style type="text/css" media="all"><!--@import url(full.css);--></style>
+</head>
+<body>
+<h1>11. Application Commands</h1>
+<!-- top navigation -->
+<div class="navbar">
+	<a href="10_referenceexamples.html">Previous</a> | <a href="index.html">Up</a> | <a href="12_commandexamples.html">Next</a>
+</div>
+<!-- content -->
+<div id="content">
+<h2>Command syntax</h2>
+<p>Appscript commands have the following syntax:</p>
+<pre><code>application.command_name([direct_parameter][, keyword_parameters])</code></pre>
+<p>Both direct and keyword parameters are optional.</p>
+<p>Application commands are implemented by the application's top-level <code>application</code> object (represented by an <code>AS::Application</code> instance). For convenience, appscript also makes application commands available as methods on every reference. If a command is called upon a reference rather than an Application object, that reference will be taken as the application's direct parameter (with one or two caveats; see the Special Cases section below).</p>
+<p>The command's direct parameter can be any value; the application's dictionary will (usually) indicate the appropriate types. A command can have a maximum of one direct parameter; if more than one is given, an error will occur. Keyword parameters are specified as a <code>Hash</code> object whose keys are symbols representing the parameter names:</p>
+<pre><code>application.command_name(direct_parameter, {:name1 =&gt; value1, :name2 =&gt; value2, ...})</code></pre>
+<p>Note that Ruby allows the hash to be written without the enclosing <code>{</code> and <code>}</code> for appearance's sake:</p>
+<pre><code>application.command_name(direct_parameter, :name1 =&gt; value1, :name2 =&gt; value2, ...)</code></pre>
+<p>Each command can have zero or more keyword parameters as defined in the application dictionary. In addition, appscript provides the following default parameters for indicating how the command should be handled:</p>
+<table summary="Default appscript parameters">
+<thead>
+<tr><th>Name</th><th>Class</th><th>Description</th></tr>
+</thead>
+<tbody>
+<tr><td><code>:wait_reply</code></td><td><code>Boolean</code></td><td>Wait for application to return a result/error?</td></tr>
+<tr><td><code>:timeout</code></td><td><code>Integer</code></td><td>Number of seconds to wait for a reply (no timeout = 0)</td></tr>
+<tr><td><code>:result_type</code></td><td><code>nil</code> | <code>Symbol</code></td><td>AE type to coerce return value to (e.g. <code>:FSRef</code>)</td></tr>
+<tr><td><code>:ignore</code></td><td><code>nil</code> | <code>Array of Symbol</code></td><td>String characteristics to ignore when evaluating references. The array should contain zero or more of the following enumerators: <code>:case</code>, <code>:diacriticals</code>, <code>:expansion</code>, <code>:hyphens</code>, <code>:punctuation</code>, <code>:whitespace</code></td></tr>
+</tbody>
+</table>
+<p>(Note that most applications currently ignore the <code>:ignore</code> parameter and use the default behaviour, i.e. ignore case.)</p>
+<p>For convenience, appscript allows the direct parameter and/or keyword parameters arguments to be omitted from the method's argument list if unused. For example, a command that has no direct or keyword parameters would be written as:</p>
+<pre><code>application.command_name</code></pre>
+<p>If the command takes only keyword parameters, or the direct parameter is the reference upon which the command is called, it can be written as:</p>
+<pre><code>application.command_name(:name1 =&gt; value1, :name2 =&gt; value2, ...)</code></pre>
+<p>If the command takes only a direct parameter <em>and</em> the value given is not a hash, then it can be written as follows:
+<pre><code>application.command_name(direct_parameter)</code></pre>
+<p>If the direct parameter is a Ruby hash, you <em>must</em> provide an empty keyword parameters hash as the second argument to the call:</p>
+<pre><code>application.command_name(direct_hash_parameter, {})</code></pre>
+<p>If you forget, appscript will treat this hash value as the command's keyword parameters, resulting in an error or other unexpected behaviour.</p>
+<p>See the Special cases section below for additional rules.</p>
+<h2>Examples</h2>
+<pre><code># tell application &quot;TextEdit&quot; to activate
+AS.app('TextEdit').activate
+# tell application &quot;TextEdit&quot; to open fileRefList
+AS.app('TextEdit').open(fileRefList)
+# tell application &quot;Finder&quot; to get version
+AS.app('Finder').version.get
+# tell application &quot;Finder&quot; to set name of file &quot;foo.txt&quot; of home to &quot;bar.txt&quot;
+AS.app('Finder').home.files['foo.txt'].name.set('bar.txt')
+# tell application &quot;TextEdit&quot; to count (text of first document) each paragraph
+AS.app('TextEdit').documents.first.text.count(:each =&gt; :paragraph)
+# tell application &quot;TextEdit&quot; to make new document at end of documents
+AS.app('TextEdit').documents.end.make(:new =&gt; :document)
+# tell application &quot;Finder&quot; to get items of home as alias list
+AS.app('Finder').home.items.get(:result_type =&gt; :alias)</code></pre>
+<h2>Special cases</h2>
+<p>The following special-case behaviours are implemented for convenience:</p>
+<ol>
+<li><p>Commands that take a reference to one or more application objects as a direct parameter may be written in the following form:</p>
+<pre><code>reference.command(keyword_parameters)</code></pre>
+<p>The conventional  form is also supported should you ever wish (or need) to use it:</p>
+<pre><code>application.command(keyword_parameters)</code></pre>
+<p>The two forms are equivalent (appscript converts the first form to the second behind the scenes) although the first form is preferred for conciseness.</p></li>
+<li><p>If a command that already has a direct parameter is called on a reference, i.e.:</p>
+<pre><code>reference.command(direct_parameter[, keyword_parameters])</code></pre>
+<p>the reference upon which it is called will be packed as a 'subject' attribute. For example, if the <code>make</code> command is called on a reference, the application will use that reference as its insertion location if there is no <code>at</code> keyword parameter given; i.e.:</p>
+<pre><code>insertion_location.make(:new =&gt; some_class)</code></pre>
+<p>instead of:</p>
+<pre><code>application.make(:new =&gt; some_class, :at =&gt; insertion_location)</code></pre></li>
+<li><p>When the <code>set</code> command is called on a reference, its <code>to</code> parameter can be written as a direct parameter; i.e.:</p>
+<pre><code>reference.set(value)</code></pre>
+<p>instead of:</p>
+<pre><code>reference.set(:to =&gt; value)</code></pre>
+<p>or:</p>
+<pre><code>application.set(reference, :to =&gt; value)</code></pre>
+<p>The first form is preferred, although all three are supported.</p></li>
+</ol>
+<h2>Note to AppleScript users</h2>
+<p>Unlike AppleScript, which implicitly sends a <code>get</code> command to any unresolved application object references at the end of evaluating an expression, appscript only resolves a reference when it receives an appropriate command. For example:</p>
+<pre><code>foo = AS.app('Finder').disks</code></pre>
+<p>is <em>not</em> equivalent to:</p>
+<pre><code>set foo to disks of application &quot;Finder&quot;</code></pre>
+<p>even though the two may look similar. In the first case, the value assigned to variable <code>foo</code> is a reference, <code>AS.app('Finder').disks</code>. In the second, AppleScript evaluates the <code>disks of application &quot;Finder&quot;</code> reference by performing an implicit <code>get</code> command before assigning the result, a <em>list</em> containing one or more references (one to each disk currently mounted), to variable <code>foo</code>. To assign an unresolved reference to a variable in AppleScript, the reference must be preceded by the <code>a reference to</code> operator. For example:</p>
+<ul>
+<li><p>Getting a reference to all disks:</p>
+<pre><code>set foo to a reference to every disk of application &quot;Finder&quot;
+return foo
+--&gt; a reference to every disk of application &quot;Finder&quot;</code></pre>
+<pre><code>foo = AS.app('Finder').disks
+print foo
+--&gt; AS.app('Finder').disks</code></pre></li>
+<li><p>Getting a list of references to each disk:</p>
+<pre><code>set foo to get every disk of application &quot;Finder&quot; -- (the 'get' is optional here)
+return foo
+--&gt; {disk &quot;Mac HD&quot; of application &quot;Finder&quot;, disk &quot;ZIP-100&quot; of application &quot;Finder&quot;}</code></pre>
+<pre><code>foo = AS.app('Finder').disks.get
+print foo
+--&gt; [AS.app('Finder').disks['Mac HD'], AS.app('Finder').disks['ZIP-100']]</code></pre>
+</li>
+</ul>
+</div>
+<!-- bottom navigation -->
+<div class="navbar">
+	<a href="10_referenceexamples.html">Previous</a> | <a href="index.html">Up</a> | <a href="12_commandexamples.html">Next</a>
+</div>
+<!--footer-->
+<p class="footer">&copy; 2006 HAS</p>
+</body>
+</html>