rb-appscript 0.5.0 → 0.5.1

data/CHANGES

@@ -1,3 +1,22 @@
+2008-02-18 -- 0.5.1
+
+- fixed bug in Appscript::Application#launch where calling it on an application specified by_pid/by_url/by_aem_app would raise error -1708
+
+- aem by-range specifiers now accept non-reference values (these are expanded to con-based references when packed)
+
+- fixed bug in Appscript::Reference#_send_command method's auto-reconnection code where a re-sent event that fails now raises the correct CommandError (previously re-raised the original 'invalid connection' error)
+
+- fixed bug when packing Fixnums in 64-bit Ruby
+
+- fixed a memory leak in AE.get_app_terminology
+
+- fixed minor bug and improved error reporting in Appscript::Reference#[]
+
+- removed AEMReference::PositionSpecifier's #and, #or, #not methods as these shortcuts are no longer supported
+
+- basic Ruby 1.9 compatibility
+
+
 2007-12-18 -- 0.5.0 (beta 2)
 
 - OSAX module no longer errors on import in 10.5 if a ScriptingAdditions folder (e.g. ~/Library/ScriptingAdditions) doesn't exist

data/LICENSE

@@ -7,7 +7,7 @@ All code is released under the MIT License, except for the following:
 ======================================================================
 MIT LICENSE
 
-Copyright (C) 2006 - 2007 HAS
+Copyright (C) 2006-2008 HAS
 
 ======================================================================
 THE RUBY LICENSE

data/README

@@ -22,16 +22,16 @@ $ sudo make install
 
 -------
 
-Please note that the version of Ruby included with Mac OS X 10.4 is missing the header files needed to build appscript on PPC-based Macs. You can avoid this issue by installing the latest version of Ruby from <http://www.ruby-lang.org/en/downloads/> and updating your shell login profiles to suit.
+Please note that the version of Ruby included with Mac OS X 10.4 (Tiger) is missing the header files needed to build appscript on PPC-based Macs. Tiger users can avoid this issue by installing the latest version of Ruby from <http://www.ruby-lang.org/en/downloads/> and updating their shell login profiles to suit.
 
 ======================================================================
 NOTES
 
-- rb-appscript 0.5.0 is the second beta release. Please file bug reports if you encounter any problems.
+- This is a beta release. Please file bug reports if you encounter any problems.
 
-- rb-appscript 0.5.0 contains bug fixes, minor API changes and requested enhancements; see the CHANGES file and documentation for details.
+- rb-appscript 0.5.1 contains bug and compatibility fixes; see the CHANGES file and documentation for details.
 
-- rb-appscript 0.5.0  provides 64-bit support for OS X 10.5 in the following modules: AE, AEM, Appscript. The OSAX module provides partial 64-bit support; see the osax manual for details.
+- rb-appscript currently provides 64-bit support for OS X 10.5 in the following modules: AE, AEM, Appscript. The OSAX module provides partial 64-bit support; see the osax manual for details.
 
 - ASDictionary 0.9.0 or later is required to use rb-appscript's built-in #help method. If ASDictionary isn't installed, interactive help won't be available but appscript will continue to operate as normal.
 
@@ -44,6 +44,6 @@ AUTHOR
 ======================================================================
 COPYRIGHT
 
-Copyright (C) 2006 - 2007 HAS 
+Copyright (C) 2006-2008 HAS 
 
 Appscript is released under the MIT License. See the LICENSE file for more information.

data/TODO

@@ -8,4 +8,6 @@ TO DO
 
 - _aem/connect.rb module refers directly to Send::Event instead of going via the AEM::Application::Event hook, which might cause problems when used in an OSA component or other situation where client needs to customise all event creation and/or dispatch.
 
-- #== and #hash methods in MacTypes::Alias, MacTypes::FileURL lack robustness; see notes in mactypes manual for details. Could these be improved? (Note: some mactypes unit tests may fail in some situations due to 'dumb' nature of these methods.)
+- #== and #hash methods in MacTypes::Alias, MacTypes::FileURL lack robustness; see notes in mactypes manual for details. Could these be improved? (Note: some mactypes unit tests may fail in some situations due to 'dumb' nature of these methods.)
+
+- support string encodings in Ruby 1.9

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

@@ -5,7 +5,7 @@
 <title>aem | 1. Introduction</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -43,6 +43,6 @@
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

data/doc/aem-manual/02_apioverview.html

@@ -5,7 +5,7 @@
 <title>aem | 2. API overview</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -84,6 +84,6 @@
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

data/doc/aem-manual/03_packingandunpackingdata.html

@@ -5,7 +5,7 @@
 <title>aem | 3. Packing and unpacking data</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -93,6 +93,6 @@ AEKey &lt; AETypeBase -- represents an AE object of typeKeyword</code></pre>
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

data/doc/aem-manual/04_references.html

@@ -5,7 +5,7 @@
 <title>aem | 4. References</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -232,18 +232,7 @@ TO DO: finish
     
         is_in(val) -- self is in value
             val : anything
-            Result : Test
-
-        and(*operands) -- equivalent to self.eq(True).and(*operands)
-            operands : Test/Test
-            Result : Test
-        
-        or(*operands) -- equivalent to self.eq(True).or(*operands)
-            operands : Test/Test
-            Result : Test
-    
-        not
-            Result : Test -- equivalent to self.eq(True).not</code></pre>
+            Result : Test</code></pre>
 
 
 <h3>Methods for all multi-element specifiers</h3>
@@ -362,12 +351,11 @@ ElementByRelativePosition &lt; SingleElement -- refers to the previous or next e
 
 ElementsByFilter &lt; MultipleElements -- refers to all elements in the
         referenced container object(s) that fulfill a given condition; 
-        e.g. ref.by_filter(AEM.its.name.begins_with('a'))
+        e.g. ref.by_filter(AEM.its.property('pnam').begins_with('a'))
 
 
-AllElements(MultipleElements) -- refers to all elements of 
-        the given class in the referenced container object(s); 
-        e.g. ref.elements('docu')</code></pre>
+AllElements &lt; MultipleElements -- refers to all elements of the given class
+        in the referenced container object(s); e.g. ref.elements('docu')</code></pre>
 
 
 <h3>Tests</h3>
@@ -379,13 +367,13 @@ AllElements(MultipleElements) -- refers to all elements of
 
 <h3>Reference Roots</h3>
 
-<pre><code>ApplicationRoot &lt; PropertySpecifier -- AEM.app returns an instance of
+<pre><code>ApplicationRoot &lt; PositionSpecifier -- AEM.app returns an instance of
        this class
 
-CurrentContainer &lt; PropertySpecifier -- AEM.con returns an instance of
+CurrentContainer &lt; PositionSpecifier -- AEM.con returns an instance of
        this class
 
-ObjectBeingExamined &lt; PropertySpecifier -- AEM.its returns an instance
+ObjectBeingExamined &lt; PositionSpecifier -- AEM.its returns an instance
        of this class</code></pre>
 
 
@@ -401,6 +389,6 @@ ObjectBeingExamined &lt; PropertySpecifier -- AEM.its returns an instance
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

data/doc/aem-manual/05_targettingapplications.html

@@ -5,7 +5,7 @@
 <title>aem | 5. Targetting Applications</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -103,7 +103,7 @@
 
 <p>When targetting a local application by path, the full path to the application (or application bundle) must be given, including a <code>.app</code> suffix if present. Note that aem identifies local applications by process serial number for reliability. If the target application is not already running when a new <code>Application</code> instance is created, it will be started automatically so that a PSN can be acquired. If the application can't be launched for some reason (e.g. if it's in the Trash), an <code>AEM::CantLaunchApplicationError</code> error will be raised.</p>
 
-<p>If the <code>by_url</code> constructor is used, its <code>url</code> argument should be an eppc URL string. Aem will pack this as an <code>AEDesc</code> of <code>typeApplSignature</code>. The target machine must have Remote Apple Events enabled in its Sharing preferences.</p>
+<p>If the <code>by_url</code> constructor is used, its <code>url</code> argument should be an eppc URL string. Aem will pack this as an <code>AEDesc</code> of <code>typeApplicationURL</code>. The target machine must have Remote Apple Events enabled in its Sharing preferences.</p>
 
 <p>Clients can also supply their own <code>AEAddressDesc</code> if they prefer. This should be an <code>AE::AEDesc</code> of one of the following types:</p>
 
@@ -150,6 +150,6 @@ KAE::TypeProcessSerialNumber</code></pre>
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

data/doc/aem-manual/06_buildingandsendingevents.html

@@ -5,7 +5,7 @@
 <title>aem | 6. Building and sending events</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -170,6 +170,6 @@ KAE::KAECanSwitchLayer</code></pre>
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

data/doc/aem-manual/07_findapp.html

@@ -5,7 +5,7 @@
 <title>aem | 7. Locating applications</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -49,6 +49,6 @@ by_creator(creator) -- Find the application with the given creator type.
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

data/doc/aem-manual/08_examples.html

@@ -5,7 +5,7 @@
 <title>aem | 8. 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>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -56,7 +56,7 @@ AEM.app.elements('docu').by_index(1).elements('cpar').by_filter(AEM.its.ne("\n")
 <h2>Sending events</h2>
 
 <pre><code># quit TextEdit
-textedit.event('corequit').send
+textedit.event('aevtquit').send
 
 # name of TextEdit
 p textedit.event('coregetd', {'----' =&gt; AEM.app.property('pnam')}).send
@@ -80,6 +80,6 @@ textedit.event('corecrel', {
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

data/doc/aem-manual/index.html

@@ -5,7 +5,7 @@
 <title>appscript | Contents</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -37,6 +37,6 @@
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

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

@@ -5,7 +5,7 @@
 <title>appscript | 1. Introduction</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -78,6 +78,6 @@ app('TextEdit').documents.end.make(
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

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

@@ -5,7 +5,7 @@
 <title>appscript | 2. About Application Scripting</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -231,6 +231,6 @@ app('TextEdit').documents[1].text.paragraphs</code></pre>
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

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

@@ -5,7 +5,7 @@
 <title>appscript | 3. Quick Tutorial</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -151,6 +151,6 @@ irb&gt; te.documents.text.get
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

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

@@ -5,7 +5,7 @@
 <title>appscript | 4. Getting Help</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -155,6 +155,6 @@ p te.parameters('make')
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html> 

data/doc/appscript-manual/05_keywordconversion.html

@@ -5,7 +5,7 @@
 <title>appscript | 5. Keyword Conversion</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -86,6 +86,6 @@ id                            wait_reply</code></pre>
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

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

@@ -5,7 +5,7 @@
 <title>appscript | 6. Classes and Enumerated Types</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -150,6 +150,6 @@ $KCODE = "UTF8"</code></pre>
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

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

@@ -5,7 +5,7 @@
 <title>appscript | 7. Application Objects</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -204,6 +204,6 @@ te.launch
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

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

@@ -5,7 +5,7 @@
 <title>appscript | 8. Real vs. Generic References</title>
 
 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-<style type="text/css" media="all"><!--@import url(full.css);--></style>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -81,6 +81,6 @@ puts app('Finder').home == app('Finder').home.get
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>

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

@@ -5,7 +5,7 @@
 <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>
+<style type="text/css" media="all"><!--@import url(../full.css);--></style>
 
 </head>
 <body>
@@ -158,7 +158,7 @@ text[con.characters[5], con.words[-2]]</code></pre>
 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>
+<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 its sole argument.</p>
 
 <p>Syntax:</p>
 <pre><code>reference.lt(value) # &lt;
@@ -225,6 +225,6 @@ paragraphs[1].before</code></pre>
 </div>
 
 <!--footer-->
-<p class="footer">&copy; 2007 HAS</p>
+<p class="footer">&copy; 2006-2008 HAS</p>
 </body>
 </html>