rb-appscript 0.2.0 → 0.2.1

data/CHANGES

@@ -1,3 +1,20 @@
+2006-11-29 -- 0.2.1
+
+- renamed AS module to Appscript. An 'AS' alias is temporarily provided for backwards compatibility but this will be removed in a future release. Users should update their scripts accordingly.
+
+- _appscript/referencerenderer.rb no longer prefixes 'AS.' to reference representation strings
+
+- added #app, #con and #its instance methods to Appscript module to allow clients to include appscript methods and classes in other modules via 'include Appscript'; updated sample scripts and documentation to show this
+
+- OSAX.scripting_additions now returns unique sorted names
+
+- added MacTypes::Alias.url, MacTypes::Alias#url, MacTypes::File_URL.url, MacTypes::File_URL#url methods for working with file url strings
+
+- OSAX::ScriptingAddition#to_s and #inspect now render scripting addition's name correctly
+
+- removed unused AE.pid_to_psn method
+
+
 2006-11-20 -- 0.2.0
 
 - removed path expansion in FindApp#byName, MacFile::Alias#at, MacFile::FileURL#at

data/README

@@ -27,7 +27,7 @@ Please note that the version of Ruby included with Mac OS X 10.4 is missing the
 ======================================================================
 NOTES
 
-- rb-appscript 0.2.0 contains a number of API changes from rb-appscript 0.1.x; see the CHANGES file and documentation for details
+- rb-appscript 0.2.x contains a number of API changes from rb-appscript 0.1.x; see the CHANGES file and documentation for details
 
 ======================================================================
 AUTHOR

data/TODO

@@ -2,8 +2,6 @@ TO DO
 
 - pack/unpack support for application types (note: packing would be a bit tricky, since app('foo') could also indicate a reference, in which case it should be packed as a null desc; unpacking might be a bit clumsy, and would (at least in theory) require a by_desc/by_aem_application method to be added to AS::Application to handle typeMachPort, other types could be converted to paths/creator codes/urls/etc. ok though)
 
-- remove rbAE_pidToPsn from rbae.c? (no longer used by connect.rb)
-
 - allow users to extract a generic ref from a real ref (to_generic) for comparison purposes. Or vice-versa?
 
 - implement built-in help system by bridging to py-appscript
@@ -12,8 +10,6 @@ TO DO
 
 - ae/aem/appscript-defined exception classes aren't quite idiomatic Ruby
 
-- finish commenting source code
-
 - would be nice if MacFile::FileNotFoundError always showed the failed path (this'd need a bit of Alias Manager glue added to the ae extension)
 
 - include an example project (or source for) that uses ruby2exe to build a standalone 'applet'

data/doc/appscript-manual/01_introduction.html

@@ -26,7 +26,7 @@
 
 <p>For example, to get the value of the first paragraph of the topmost document in TextEdit:</p>
 
-<pre><code>AS.app('TextEdit').documents[1].paragraphs[1].get</code></pre>
+<pre><code>app('TextEdit').documents[1].paragraphs[1].get</code></pre>
 
 <p>This is equivalent to the AppleScript statement:</p>
 
@@ -53,8 +53,9 @@ end tell</code></pre>
 <pre><code>#!/usr/bin/env ruby
 
 require "appscript"
+include Appscript
 
-AS.app('TextEdit').documents.end.make(
+app('TextEdit').documents.end.make(
     :new => :document,
     :with_properties => {:text => "Hello World!\n"}
     )</code></pre>

data/doc/appscript-manual/02_aboutappscripting.html

@@ -52,11 +52,11 @@
 
 <p><img src="finder_to_textedit_event.gif" alt="Sending Apple event from Finder to TextEdit" /></p>
 
-<p>With suitable bindings, scripting languages can also create and send Apple events. For example, when the code <code>AS.app('iTunes').play</code> is executed in a Ruby interpreter, a <code>hook/Play</code> event is sent from the interpreter to iTunes, instructing it to start playing:</p>
+<p>With suitable bindings, scripting languages can also create and send Apple events. For example, when the code <code>app('iTunes').play</code> is executed in a Ruby interpreter, a <code>hook/Play</code> event is sent from the interpreter to iTunes, instructing it to start playing:</p>
 
 <p><img src="ruby_to_itunes_event.gif" alt="Sending Apple event from Ruby to iTunes"/></p>
 
-<p>Applications may respond to an incoming Apple event by sending a reply event back to the client application. The reply event may contain either a return value, if there is one, or an error description if it was unable to handle the event as requested. For example, executing the command <code>AS.app('TextEdit').name.get</code> in a Ruby interpreter sends TextEdit a <code>code/getd</code> event containing an object specifier identifying the <code>name</code> property of its root <code>application</code> object. TextEdit processes this event, then sends a reply event containing the string '<tt>TextEdit</tt>' back to the Ruby interpreter, where it is displayed as the command's result. This exchange is usually performed synchronously, appearing to the user as a simple remote procedure call. Asynchronous messaging is also supported, though is not normally used in application scripting.</p>
+<p>Applications may respond to an incoming Apple event by sending a reply event back to the client application. The reply event may contain either a return value, if there is one, or an error description if it was unable to handle the event as requested. For example, executing the command <code>app('TextEdit').name.get</code> in a Ruby interpreter sends TextEdit a <code>code/getd</code> event containing an object specifier identifying the <code>name</code> property of its root <code>application</code> object. TextEdit processes this event, then sends a reply event containing the string '<tt>TextEdit</tt>' back to the Ruby interpreter, where it is displayed as the command's result. This exchange is usually performed synchronously, appearing to the user as a simple remote procedure call. Asynchronous messaging is also supported, though is not normally used in application scripting.</p>
 
 
 <h2>What is a scriptable application?</h2>
@@ -203,8 +203,8 @@ app('TextEdit').documents[1].text.paragraphs</code></pre>
 
 <li>using appscript:
 
-<pre><code>AS.app('TextEdit').documents.text.paragraphs[
-    AS.its.ne("\n")].characters[1].size.set(24)</code></pre>
+<pre><code>app('TextEdit').documents.text.paragraphs[
+    its.ne("\n")].characters[1].size.set(24)</code></pre>
 </li>
 </ul>
 

data/doc/appscript-manual/03_quicktutorial.html

@@ -35,15 +35,17 @@ irb(main):001:0&gt;</code></pre>
 
 <h3>Target TextEdit</h3>
 
-<p>The first step is to import the appscript module, <code>AS</code>, which exports the following functions and classes: <code>app</code>, <code>con</code>, <code>its</code>, <code>CommandError</code> and <code>ApplicationNotFoundError</code>.</p>
+<p>The first step is to import the appscript module, <code>Appscript</code>, which provides the following functions and classes: <code>app</code>, <code>con</code>, <code>its</code>, <code>CommandError</code> and <code>ApplicationNotFoundError</code>.</p>
 
 <pre><code>irb&gt; require "appscript"
-=&gt; true</code></pre>
+=&gt; true
+irb&gt; include Appscript
+=&gt; Object</code></pre>
 
 <p>Once appscript is imported, the first thing to do is to create new <code>app</code> object, identifying the application to be manipulated, and assign it to a variable, <code>te</code>, for easy reuse:</p>
 
-<pre><code>irb&gt; te = AS.app('TextEdit')
-=&gt; AS.app("/Applications/TextEdit.app")</code></pre>
+<pre><code>irb&gt; te = app('TextEdit')
+=&gt; app("/Applications/TextEdit.app")</code></pre>
 
 <p>The application may be identified by name, path, bundle ID, creator type, Unix process id, or, if running remotely, URL. If the application is identified by name, path, bundle ID or creator type and is not already running, it will be launched automatically for you.</p>
 
@@ -52,7 +54,7 @@ irb(main):001:0&gt;</code></pre>
 <p>First, create a new TextEdit document by making a new <code>document</code> object. This is done using the <code>make</code> command, passing it a single keyword parameter, <code>:new =&gt; :document</code>, indicating the type of object to create:</p>
 
 <pre><code>irb&gt; te.make(:new =&gt; :document)
-=&gt; AS.app("/Applications/TextEdit.app").documents[1]</code></pre>
+=&gt; app("/Applications/TextEdit.app").documents[1]</code></pre>
 
 <p>Notice that keyword parameters are specified as an inline Hash with symbols as keys. The <a href="11_applicationcommands.html">Application Commands</a> chapter will discuss appscript's command syntax in more detail.</p>
 
@@ -61,7 +63,7 @@ irb(main):001:0&gt;</code></pre>
 <p>As you can see, the <code>make</code> command returns a reference identifying the newly-created object. This reference can be assigned to a variable for easy reuse. Use the <code>make</code> command to create another document, this time assigning its result to a variable, <code>doc</code>:</p>
 
 <pre><code>irb&gt; doc = te.make(:new =&gt; :document)
-=&gt; AS.app("/Applications/TextEdit.app").documents[1]</code></pre>
+=&gt; app("/Applications/TextEdit.app").documents[1]</code></pre>
 
 <h3>Set the document's content</h3>
 
@@ -91,7 +93,7 @@ irb(main):001:0&gt;</code></pre>
 
 <pre><code>te.documents[1].text</code></pre>
 
-<p>the result is another reference, <code>AS.app("/Applications/TextEdit.app").documents[1].text</code>, not the value being referenced (<tt>'Hello World'</tt>). To get the value being referenced, you have to pass the reference as the direct argument to TextEdit's <code>get</code> command:</p>
+<p>the result is another reference, <code>app("/Applications/TextEdit.app").documents[1].text</code>, not the value being referenced (<tt>'Hello World'</tt>). To get the value being referenced, you have to pass the reference as the direct argument to TextEdit's <code>get</code> command:</p>
 
 <pre><code>irb&gt; te.get(doc.text)
 =&gt; "Hello World!"</code></pre>
@@ -106,10 +108,10 @@ irb(main):001:0&gt;</code></pre>
 <pre><code>irb&gt; doc.text.get
 =&gt; "Hello World!"
 irb&gt; te.documents[1].get
-=&gt; AS.app("/Applications/TextEdit.app").documents[1]
+=&gt; app("/Applications/TextEdit.app").documents[1]
 irb&gt; te.documents.get
-=&gt; [AS.app("/Applications/TextEdit.app").documents[1], 
-    AS.app("/Applications/TextEdit.app").documents[2]]
+=&gt; [app("/Applications/TextEdit.app").documents[1], 
+    app("/Applications/TextEdit.app").documents[2]]
 irb&gt; te.documents.text.get
 =&gt; ["Hello World", ""]</code></pre>
 
@@ -120,9 +122,9 @@ irb&gt; te.documents.text.get
 <p>The above exercise uses two commands to create a new TextEdit document containing the text '<tt>Hello World</tt>'. It is also possible to perform both operations using the <code>make</code> command alone by passing the value for the new document's <code>text</code> property via the <code>make</code> command's optional <code>with_properties</code> parameter:</p> 
 
 <pre><code>irb&gt; te.make(:new =&gt; :document, :with_properties =&gt; {:text =&gt; 'Hello World'})
-=&gt; AS.app('/Applications/TextEdit.app').documents[1]</code></pre>
+=&gt; app('/Applications/TextEdit.app').documents[1]</code></pre>
 
-<p>Incidentally, you might note that every time the <code>make</code> command is used, it returns a reference to document <em>1</em>. TextEdit identifies its <code>document</code> objects according to the stacking order of their windows, with document 1 being frontmost. When the window stacking order changes, whether as a result of a script command or GUI-based interaction, so does the order of their corresponding <code>document</code> objects. This means that a previously created reference such as <code>AS.app('/Applications/TextEdit.app').documents[1]</code> may now identify a different <code>document</code> object to before! Some applications prefer to return references that identify objects by name or unique ID rather than index to reduce or eliminate the potential for confusion, but it's an issue you should be aware of, particularly with long-running scripts where there is greater opportunity for unexpected third-party interactions to throw a spanner in the works.</p>
+<p>Incidentally, you might note that every time the <code>make</code> command is used, it returns a reference to document <em>1</em>. TextEdit identifies its <code>document</code> objects according to the stacking order of their windows, with document 1 being frontmost. When the window stacking order changes, whether as a result of a script command or GUI-based interaction, so does the order of their corresponding <code>document</code> objects. This means that a previously created reference such as <code>app('/Applications/TextEdit.app').documents[1]</code> may now identify a different <code>document</code> object to before! Some applications prefer to return references that identify objects by name or unique ID rather than index to reduce or eliminate the potential for confusion, but it's an issue you should be aware of, particularly with long-running scripts where there is greater opportunity for unexpected third-party interactions to throw a spanner in the works.</p>
 
 
 <h3>More on manipulating <code>text</code></h3>

data/doc/appscript-manual/04_gettinghelp.html

@@ -52,7 +52,7 @@
 
 <p>Examples</p>
 
-<pre><code>te = AS.app('TextEdit')
+<pre><code>te = app('TextEdit')
 
 p te.commands
 # ["activate", "close", "count", "delete", "duplicate", "exists", ...]

data/doc/appscript-manual/06_classesandenums.html

@@ -67,8 +67,8 @@ AEM::AEEnum.new('xyz ')</code></pre>
 <tr><td><code>typeFileURL</code></td><td><code>:file_url</code></td><td><code>MacTypes::FileURL</code></td></tr>
 <tr><td><code>typeFSRef</code></td><td><code>:file_ref</code></td><td><code>MacTypes::FileURL</code></td></tr>
 <tr><td><code>typeFSS</code> *</td><td><code>:file_specification</code></td><td><code>MacTypes::FileURL</code></td></tr>
-<tr><td><code>typeObjectSpecifier</code></td><td><code>:reference</code></td><td><code>AS::Reference</code></td></tr>
-<tr><td><code>typeInsertionLoc</code></td><td><code>:location_reference</code></td><td><code>AS::Reference</code></td></tr>
+<tr><td><code>typeObjectSpecifier</code></td><td><code>:reference</code></td><td><code>Appscript::Reference</code></td></tr>
+<tr><td><code>typeInsertionLoc</code></td><td><code>:location_reference</code></td><td><code>Appscript::Reference</code></td></tr>
 <tr><td><code>typeType</code></td><td><code>:type_class</code></td><td><code>Symbol</code></td></tr>
 <tr><td><code>typeEnumerated</code></td><td><code>:enumerator</code></td><td><code>Symbol</code></td></tr>
 <tr><td><small>unit types; e.g. </small> <code>typeFeet</code></td><td><small>unit names; e.g.</small> <code>:feet</code></td><td><code>MacTypes::Units</code></td></tr>
@@ -114,7 +114,7 @@ $KCODE = "UTF8"</code></pre>
 
 <p>When asking an application to coerce a return value into a file type you must specify the exact type (<code>:alias</code>, <code>:file_url</code>, <code>:file_ref</code>, or <code>:file_specification</code>) in the <code>get</code> command. e.g. To get a <code>MacTypes::FileURL</code> object for the current user's home folder, you would usually use:</p>
 
-<pre><code>AS.app('Finder').home.get(:result_type=&gt;:file_url)</code></pre>
+<pre><code>app('Finder').home.get(:result_type=&gt;:file_url)</code></pre>
 
 <p>Also be aware that some applications may not support coercions to all AE file types; you'll need to experiment to find out which coercions are supported.</p>
 

data/doc/appscript-manual/07_applicationobjects.html

@@ -25,21 +25,21 @@
 
 <p>Before you can communicate with a scriptable application you must call one of the following methods to create an application object:</p>
 
-<pre><code>AS.app.by_name(name) # name or POSIX path of local application
+<pre><code>app.by_name(name) # name or POSIX path of local application
 
-AS.app.by_id(id) # bundle ID for a local application
+app.by_id(id) # bundle ID for a local application
 
-AS.app.by_creator(creator) # 4-character creator type for a local application
+app.by_creator(creator) # 4-character creator type for a local application
 
-AS.app.by_pid(pid) # Unix process id for a local process
+app.by_pid(pid) # Unix process id for a local process
 
-AS.app.by_url(url) # eppc URL for a remote process
+app.by_url(url) # eppc URL for a remote process
 
-AS.app.current # the host process</code></pre>
+app.current # the host process</code></pre>
 
-<p>For convenience, the most commonly used form, <code>AS.app.by_name(name)</code>, can be shortened to:</p>
+<p>For convenience, the most commonly used form, <code>app.by_name(name)</code>, can be shortened to:</p>
 
-<pre><code>AS.app(name)</code></pre>
+<pre><code>app(name)</code></pre>
 
 
 <p>To target an application you must supply one of the following arguments:</p>
@@ -65,20 +65,21 @@ AS.app.current # the host process</code></pre>
 <p>Examples:</p>
 
 <pre><code>require "appscript"
+include Appscript
 
-ical = AS.app('iCal')
+ical = app('iCal')
 
-textedit = AS.app('TextEdit.app')
+textedit = app('TextEdit.app')
 
-safari = AS.app('/Applications/Safari')
+safari = app('/Applications/Safari')
 
-addressbook = AS.app.by_id('com.apple.addressbook')
+addressbook = app.by_id('com.apple.addressbook')
 
-quicktimeplayer = AS.app.by_creator('TVOD')
+quicktimeplayer = app.by_creator('TVOD')
 
-finder = AS.app.by_url('eppc://192.168.10.1/Finder')
+finder = app.by_url('eppc://192.168.10.1/Finder')
 
-itunes = AS.app.by_url('eppc://Jan%20Smith@G4.local/iTunes')</code></pre>
+itunes = app.by_url('eppc://Jan%20Smith@G4.local/iTunes')</code></pre>
 
 
 <h2>Basic commands</h2>
@@ -146,7 +147,7 @@ set(reference, :to =&gt; value) -- Set an object's data.
 
 <p>When appscript launches a non-running application, it normally sends it a <code>run</code> command as part of the launching process. If you wish to avoid this, you should start the application by sending it a <code>launch</code> command before doing anything else. For example:</p>
 
-<pre><code>te = AS.app('TextEdit')
+<pre><code>te = app('TextEdit')
 te.launch
 # other TextEdit-related code goes here...</code></pre>
 

data/doc/appscript-manual/08_realvsgenericreferences.html

@@ -27,45 +27,45 @@
 
 <p>A real reference begins with an <code>app</code> call, followed by a <code>by_name</code>, <code>by_id</code>, <code>by_creator</code>, <code>by_pid</code>, <code>by_url</code> call that identifies the application whose object(s) it refers to, e.g.:</p>
 
-<pre><code>AS.app.by_name('TextEdit').documents.end
-AS.app.by_url('eppc://my-mac.local/Finder').home.folders.name</code></pre>
+<pre><code>app.by_name('TextEdit').documents.end
+app.by_url('eppc://my-mac.local/Finder').home.folders.name</code></pre>
 
-<p>(Remember than <code>AS.app.by_name('TextEdit')</code> can be shortened to <code>AS.app('TextEdit')</code> for convenience.</p>
+<p>(Remember than <code>app.by_name('TextEdit')</code> can be shortened to <code>app('TextEdit')</code> for convenience.</p>
 
 <p>A generic reference begins with <code>app</code>, <code>con</code> or <code>its</code> and does not identify the application to which it relates, e.g.:</p>
 
-<pre><code>AS.app.documents.end
-AS.con.word[3]
-AS.its.name.starts_with('d')</code></pre>
+<pre><code>app.documents.end
+con.word[3]
+its.name.starts_with('d')</code></pre>
 
 <p>Generic references are only evaluated when used used within real references, either as selectors:</p>
 
-<pre><code>AS.app('Finder').home.folders[<em>AS.its.name.starts_with('d')</em>].get
+<pre><code>app('Finder').home.folders[<em>its.name.starts_with('d')</em>].get
 
-AS.app('Tex-Edit Plus').windows[1].text[<em>AS.con.words[2]</em>, <em>AS.con.words[-2]</em>].get</code></pre>
+app('Tex-Edit Plus').windows[1].text[<em>con.words[2]</em>, <em>con.words[-2]</em>].get</code></pre>
 
 <p>or as command parameters:</p>
 
-<pre><code>AS.app('TextEdit').make(
+<pre><code>app('TextEdit').make(
     :new =&gt; :word, 
-    :at =&gt; <em>AS.app.documents[1].words.end</em>, 
+    :at =&gt; <em>app.documents[1].words.end</em>, 
     :with_data =&gt; 'Hello')
 
-AS.app('Finder').desktop.duplicate(
-    :to =&gt; <em>AS.app.home.folders['Desktop Copy']</em>)</code></pre>
+app('Finder').desktop.duplicate(
+    :to =&gt; <em>app.home.folders['Desktop Copy']</em>)</code></pre>
 
 
 <h2>Comparing and hashing references</h2>
 
 <p>Application references can be compared for equality and are hashable (so can be used as dictionary keys). For two real references to be considered equal, both must have the same application path or url and reference structure. Examples:</p>
 
-<pre><code>puts AS.app('TextEdit').documents[1] == \
-    AS.app.by_id('com.apple.textedit').documents[1].get
+<pre><code>puts app('TextEdit').documents[1] == \
+    app.by_id('com.apple.textedit').documents[1].get
 # Result: true; both references evaluate to the same
 #     application path and reference
 
-puts AS.app('Finder').home == AS.app('Finder').home.get
-# Result: false; AS.app('Finder').home.get returns a
+puts app('Finder').home == app('Finder').home.get
+# Result: false; app('Finder').home.get returns a
 #     different reference to the same location</code></pre>
 
 <p>For two generic references to be equal, both must have the same reference structure. Note that comparing generic references to real references will always return a false result.</p>

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

@@ -117,11 +117,11 @@ paragraphs[-1].previous(:character)</code></pre>
 
 <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>
+<pre><code>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>
+<pre><code>ref.paragraphs[con.paragraphs[3], con.paragraphs[-1]]</code></pre>
 
 <p>can also be written as:</p>
 
@@ -129,7 +129,7 @@ paragraphs[-1].previous(:character)</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>
+<pre><code>ref.words[con.characters[5], con.paragraphs[-2]]</code></pre>
 
 <p>Syntax:</p>
 <pre><code>elements[start, end]
@@ -139,7 +139,7 @@ paragraphs[-1].previous(:character)</code></pre>
 <p>Examples:</p>
 <pre><code>folders['Documents', 'Movies']
 documents[1, 3]
-text[AS.con.characters[5], AS.con.words[-2]]</code></pre>
+text[con.characters[5], 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>
 
@@ -154,9 +154,9 @@ text[AS.con.characters[5], AS.con.words[-2]]</code></pre>
 <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>
+<pre><code>its
+its.size
+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>
 
@@ -178,12 +178,12 @@ 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>
+<pre><code>its.eq('')
+its.size.gt(1024)
+its.words.first.starts_with('A')
+its.characters.first.eq(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>
+<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[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>
 
@@ -193,9 +193,9 @@ 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(
+<pre><code>its.eq('').not
+its.size.gt(1024).and(its.size.lt(10240))
+its.words[1].starts_with('A').or(
     its.words[2].contains('ce'),
     its.words[1].eq('Foo'))</code></pre></li>
 </ul>

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

@@ -23,108 +23,109 @@
 <h2>Application objects</h2>
 
 <pre><code>require "appscript"
+include Appscript
 
 # application &quot;Finder&quot;
-AS.app('Finder')
+app('Finder')
 
 # application &quot;Macintosh HD:Applications:TextEdit.app:&quot;
-AS.app('/Applications/TextEdit.app')</code></pre>
+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
+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
+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
+app('Finder').home.items.name
 
 # a reference to text of every document of application &quot;TextEdit&quot;
-AS.app('TextEdit').documents.text
+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>
+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
+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>
+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]
+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']
+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]
+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
+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>
+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)
+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>
+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]
+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]
+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']
+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>
+app('Tex-Edit Plus').documents[1].text[con.words[3], 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")]
+app('TextEdit').documents[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)]
+app('Tex-Edit Plus').documents[1].paragraphs[
+    its.characters.first.eq(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>
+app('Finder').home.folders['Documents'].files[
+    its.name_extension.eq('txt').AND(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
+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>
+app('TextEdit').documents[1].text.paragraphs[1].before</code></pre>