motion-accessibility 2.2 → 3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0fda7b42011a96176aceec7228a2e39709678ffb
-  data.tar.gz: 1ecf5a331e9f478340c90c487b3d4a74ce97c36b
+  metadata.gz: 3c821b39f3467d6525a96b0a695bed9b4450ee98
+  data.tar.gz: e6abe481288ab71e3b52d18dd9ff8ffc0856dc11
 SHA512:
-  metadata.gz: 2500c41291c52741eb0393ca50cf845e5914674fe53ce64a8a66eec443338fabf0239a5fb1e7377f9b986fc19a2cf25c3ca20521ec35cfeadd4d329e26d78b03
-  data.tar.gz: 1c43feb40d9621ca49f5c5551d4e6b87d396a4f89ad1fb019469717f0f7c7d3a9623ea89df9b136f4cb58e06a52346a306d6100d5bcf85e85ab15a8ffe93239e
+  metadata.gz: 92fda9f928f534f81fc2f45bf1d7b834c60927a7ec51880b79f15fcdbcb7775c8ec27d1ad9e5eb37435b196d78dbe5f8858ca4add557ceb2b97777611efbfe14
+  data.tar.gz: 9c61a401a1ccb1fcef1b0d02140cc3be343981e9f7f265609e9cd12de1883bc5d93ecc0d7c8cc04aeca2901c19713e68a3c9875700b732f40fc94277e8f59119

data/README.md

@@ -4,9 +4,7 @@
 
 https://github.com/austinseraphin/motion-accessibility
 
-Motion-Accessibility wraps the UIAccessibility protocols in nice
-ruby. I hope that making them easier will encourage developers to use it
-more and make their apps accessible. The gem also includes an accessibility inspector and a text console to aide blind iOS developers.
+Motion-accessibility provides the tools needed for sighted and blind iOS RubyMotion developers to make their apps more accessible. It wraps Apple’s UIAccessibility protocols in Ruby, and provides an accessibility inspector. It has a console for blind developers, since the iOS simulator doesn’t work well with VoiceOver. It also has automated accessibility testing for your views, and the accessibility doctor will help diagnose your problems and tell you how to fix them. You can build accessibility testing into your specs, so you will never break VoiceOver compatibility!
 
 ## Installation
 
@@ -38,24 +36,23 @@ The `browse` or `b` command lets you examine the view hierarchy in a speech-frie
 The following examples come from the sample app included with motion-accessibility.
 
 ```
-(main)>	browse                                                                  
-Browsing  UIWindow                                                              
-1 UILabel Hello!                                                                
-2 Touchable UITextField                                                         
-3 Touchable UIRoundedRectButton Update                                          
-4 UINavigationBar                                                               
-5 UITabBar with 2 subviews                                                      
+(main)> browse
+Browsing  UIWindow
+1 UIView with 3 subviews
+2 UINavigationBar with 2 subviews
+3 UITabBar with 3 subviews
 => nil
 ```
 
 If a view has subviews, you can browse that view.
 
 ```
-(main)>	b 5                                                                     
-Browsing  UITabBar                                                              
-0 Superview UIWindow                                                            
-1 Touchable UITabBarButton Test App                                             
-2 Touchable UITabBarButton Table                                                
+((main)> b 1
+Browsing  UIView
+0 Superview UIWindow 
+1 UILabel Hello! 
+2 Touchable UITextField  
+3 Touchable UIButton Update 
 => nil
 ```
 
@@ -63,71 +60,152 @@ You can  refresh the browser by passing the `:refresh` or `:top` keyword.
 
 You may pass the `:scroll` keyword to scroll a UIScrollView or descendants, such as a UITableView. This still has some minor issues .
 
-You may pass any view as an argument to browse it. Use the `:refresh` or `:top` keywords to switch back to the running application.
-
 #### `view` or `v`
 
 The `view` or `v` command simply returns the current view. If you have just browsed a view, it will return that. Otherwise, you may specify the view you wish to browse. Note that for all the commands, you may either use its number or accessibility label.
 
 ```
-(main)>	v 1                                                                     
-=> #<UITabBarButton:0x9380560>
+(main)> v 1
+=> #<UILabel:0x8feda00>
 ```
 
 #### `touch`
 The `touch` command lets you interact with the various controls. It works on all standard UIControls. `touch` can accept an argument depending on the type of control. For example, you can pass a UITextField a string to set its value.
 
 ```
-(main)>	touch 2,"motion-accessibility rocks!"                                   
-Browsing  UIWindow                                                              
-1 UILabel Hello!                                                                
-2 Touchable UITextField motion-accessibility rocks!                             
-3 Touchable UIRoundedRectButton Update                                          
-4 UINavigationBar                                                               
-5 UITabBar with 2 subviews                                                      
+(main)> touch 2,"Motion-accessibility rocks!"
+Browsing  UIView
+0 Superview UIWindow 
+1 UILabel Hello! 
+2 Touchable UITextField Motion-accessibility rocks! 
+3 Touchable UIButton Update 
 => nil
 ```
 
 UIButtons can take a UIControlEvent, but default to `UIControlEventTouchUpInside`. Note here the use of an accessibility label to reference the view.
 
 ```
-(main)>	touch "update"                                                          
-Browsing  UIWindow                                                              
-1 UILabel motion-accessibility rocks!                                           
-2 Touchable UITextField motion-accessibility rocks!                             
-3 Touchable UIRoundedRectButton Update                                          
-4 UINavigationBar                                                               
-5 UITabBar with 2 subviews                                                      
+(main)> touch "update"
+Browsing  UIView
+0 Superview UIWindow 
+1 UILabel Motion-accessibility rocks! 
+2 Touchable UITextField Motion-accessibility rocks! 
+3 Touchable UIButton Update 
 => nil
 ```
 
 ### The Accessibility Inspector
 
-You can easily see the state of any of the following attributes and methods by using the accessibility inspector. Just call the `inspect_accessibility` method on any object.
+You can easily see the state of any of the following attributes and methods by using the accessibility inspector. Just call `Accessibility.inspect` and pass any object as an argument.
 
 ```
-main)>	label=UILabel.alloc.initWithFrame(CGRectMake(0, 0, 100, 100))           
-=> #<UILabel:0xb062870>                                                         
-(main)> label.text="Hello!"                                                     
-=> "Hello!"                                                                     
-(main)> label.inspect_accessibility                                             
+(main)> label=UILabel.alloc.initWithFrame(CGRect.new([0,0], [100,100]))
+=> #<UILabel:0x103b8c40>
+(main)> label.text="Hello!"
+=> "Hello!"
+(main)> Accessibility.inspect label
+#<UILabel:0x103b8c40>
 Accessibility label: Hello!
 Accessibility hint: nil
 Accessibility traits: Static text
 Accessibility value: nil
 Accessibility language: nil
-Accessibility frame: x=0.0 y=20.0 width=320.0 height=189.3
-Accessibility activation point: x=160.0 y=114.7
+Accessibility frame: x=0.0 y=0.0 width=100.0 height=100.0
+Accessibility activation point: x=50.0 y=50.0
 Accessibility path: nil
 Accessibility view is modal: false
 Should group accessibility children: false
 Accessibility elements hidden: false
 Is accessibility element: true
 Accessibility identifier: nil
+Accessible: true
 => nil
 ```
 
-By the way, `a11y` stands for `accessibility`, because it has a, then 11 letters, then y. Hence, you can use `inspect_a11y` as a shortcut. You can also use this abreviation when referring to the Accessibility class, for instance `A11y::Element`.
+By the way, `a11y` stands for `accessibility`, because it has a, then 11 letters, then y. Hence, you can use `A11y.inspect` as a shortcut.
+
+### Automated Accessibility Testing
+
+Below  you will find detailed documentation about all of the accessibility protocols. Don’t feel overwhelmed. The accessibility inspector will tell you exactly what you have to do. Let’s start by creating an unlabeled button, the bane of all VOiceOver users.
+
+```
+(main)> button=UIButton.new
+=> #<UIButton:0xd7831a0>
+(main)> A11y.inspect button
+#<UIButton:0xd7831a0>
+Accessibility label: nil
+Accessibility hint: nil
+Accessibility traits: Button
+Accessibility value: nil
+Accessibility language: nil
+Accessibility frame: x=0.0 y=0.0 width=0.0 height=0.0
+Accessibility activation point: x=0.0 y=0.0
+Accessibility path: nil
+Accessibility view is modal: false
+Should group accessibility children: false
+Accessibility elements hidden: false
+Is accessibility element: false
+Accessibility identifier: nil
+Accessible: false
+2014-05-27 19:02:50.209 motion-accessibility[8851:70b] #<UIButton:0xd7831a0>: You must set the accessibility_label. You can use the setTitle:forState method to do this on a button.
+2014-05-27 19:02:50.223 motion-accessibility[8851:70b] #<UIButton:0xd7831a0>: You must set is_accessibility_element=true to make VoiceOver aware of it. This will often happen automatically when a view becomes visible by giving it a frame and adding it to a subview.
+=> #<UIButton:0xd7831a0>
+```
+
+This incorporates two features discussed below.
+
+#### `accessible?`
+Call the `accessible?` predicate on any object to determine its accessibility. Like all predicates it returns true or false. You can include this in your specs. If you build in accessibility testing you will never break accessibility, something even worse than no accessibility at all. For example, if you have a variable `@label` which contains a label, you could write:
+```
+@label.should.be.accessible
+```
+So simple! This works recursively. Say you run some functional tests on a view controller.
+
+```
+tests Test_Controller
+it “#accessible?`
+controller.should.be.accessible
+end
+```
+
+Or for the ultimate in laziness:
+
+```
+before do
+@app=UIApplication.sharedApplication
+end
+
+it “accessible?” do
+@app.should.be.accessible
+end
+```
+You may not want to do this however, because it can get confusing navigating down subview hierarchies, though it will report the path taken. Still, better to do that then nothing at all.
+
+#### `Accessibility.doctor`
+The accessibility doctor will report on what you have to do. It writes this to the NSLog. If given no arguments it will report on the last object called with the `accessible?` predicate. It returns the object with the problem, or nil if it finds nothing wrong. The accessibility inspector returns this as well. If a spec fails remember to put this before the test.
+
+#### `accessibility_test`
+Finally, you can specify which accessibility test applies to an object by setting this value. You may do this in the same way you set other attributes. You can use a setter:
+
+```
+view=UIView.new
+view.accessibility_test=:UILabel
+```
+
+Or you may define it in a class. If you do this make sure that it returns a symbol of the class you want to test against, since it has no error checking unlike the setter.
+```
+class Custom_View < UIView
+
+def accessibility_test
+:UILabel
+end
+
+end
+```
+
+### Accessibility vs. Usability
+
+A difference exists between accessibility and usability, though often the two get lumped together under the umbrella of the former. Accessibility refers to whether or not a user can view and interact with something in a meaningful way. In this case, this means making VoiceOver aware of the different elements of your app. Usability gets into more intangible realms, and has to do with whether or not it actually makes sense to a user. In this case this means a blind human using VoiceOver, and only a blind human using VoiceOver can tell you this. A computer can test for accessibility, but only a human can test for usability.
 
 ### UIAccessibility Informal Protocol
 
@@ -171,15 +249,15 @@ Hints describe the results of performing an action. Only provide one when not ob
 #### `accessibility_traits`
 
 Traits describe an element's state, behavior, or usage. They tell
-VoiceOver how to respond to a view. To combine them, use the single vertical bar  `|` binary or operator.
+VoiceOver how to respond to a view. To combine them, use the single vertical bar  `|` binary or operator. Remember to call `super.accessibility_traits` if defining them in a method.
 
-The `accessibility_attribute=` method accepts a symbol or array of symbols, and applies the accessibility_attribute method to them. For example, if a view displays an image  that opens a link, you can do this.
+The `accessibility_traits=` method also accepts a symbol or array of symbols, and applies the accessibility_traits method to them. For example, if a view displays an image  that opens a link, you can do this.
 
 ```
 class ImageLinkView < UIView
 # ....  
 def accessibility_traits
-:image.accessibility_trait|:link.accessibility_trait
+super.accessibility_traits|:image.accessibility_trait|:link.accessibility_trait
 end
 end
 ```
@@ -252,7 +330,7 @@ Ignores elements within views which are siblings of the receiver. If you present
 
 ####  `group_accessibility_children?` or `should_group_accessibility_children`
 
-VoiceOver gives two ways to browse the screen. The user can drag their finger around the screen and hear the contents. They can also swipe right or left with one finger to hear the next or previous element. Normally, VoiceOver reads from left to right, and from top to bottom. Sometimes this can get confusing, depending on the layout of the screen. Setting this to true tells VoiceOver to read the views in the order defined in the subviews array.
+VoiceOver gives two ways to browse the screen. The user can drag their finger around the screen and hear the contents. They can also swipe right or left with one finger to hear the next or previous element. When swiping to the next element, VoiceOver reads the elements from left to right, and from top to bottom. Sometimes this can get confusing, depending on the layout of the screen. Setting this to true tells VoiceOver to read the views in the order defined in the subviews array.
 
 #### `accessibility_elements_hidden?` or `accessibility_elements_hidden`
 
@@ -313,9 +391,9 @@ Increments the value of the accessibility element. Make sure to have the :adjust
 
 Decrements the value of the accessibility element. Make sure to have the :adjustable accessibility trait set for this to work.
 
-### UIAccessibilityElement
+### Accessibility::Element
 
-If you have something in your view that does not inherit from UIView or UIControl and you want to make it accessible, you need to define it as an accessibility element. Accessibility elements belong to an accessibility container, in other words the view which contains them. To create one, just call `Accessibility::Element.new` with the container, usually self. Like a UIView, an accessibility element has attributes, and you get and set them in exactly the same way.
+If you have something in your view that does not inherit from UIView or UIControl and you want to make it accessible, you need to define it as an accessibility element. Accessibility elements belong to an accessibility container, in other words the view which contains them. To create one, just call `Accessibility::Element.init_with_accessibility_container` with the container, usually self. Like a UIView, an accessibility element has attributes, and you get and set them in exactly the same way.
 
 ```
 class CustomView < UIView
@@ -325,6 +403,7 @@ super
 # …
 accessibility=Accessibility::Element.new(self)
 accessibility.label="Hello."
+accessibility.hint=“Presses the magic button”
 accessibility.frame=view.frame
 accessibility.traits=:button
 end
@@ -458,3 +537,7 @@ iOS 7 adds some speech attributes to use in attributed strings. To get them, jus
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
+
+## A Special Offer for You
+
+I do [freelance accessibility consulting.](austinseraphin.com) If you use my gem I will give you a discount. Contact me for more information.

data/lib/project/constants.rb

@@ -42,22 +42,19 @@ Attributes = {
 Element_Attributes = {
 :container => :accessibilityContainer,
 :container= => :setAccessibilityContainer,
-:frame => :accessibilityFrame,
-:frame= => :setAccessibilityFrame,
-:hint => :accessibilityHint,
-:hint= => :setAccessibilityHint,
 :label => :accessibilityLabel,
 :label= => :setAccessibilityLabel,
+:hint => :accessibilityHint,
+:hint= => :setAccessibilityHint,
 :traits => :accessibilityTraits,
 :value => :accessibilityValue,
 :value= => :setAccessibilityValue,
+:frame => :accessibilityFrame,
+:frame= => :setAccessibilityFrame,
 :did_become_focused => :accessibilityElementDidBecomeFocused,
 :did_lose_focus => :accessibilityElementDidLoseFocus,
 :is_focused => :accessibilityElementIsFocused,
-:focused? => :accessibilityElementIsFocused,
-:is_accessibility_element => :isAccessibilityElement,
-:is_accessibility_element= => :setIsAccessibilityElement,
-:accessibility_element? => :isAccessibilityElement
+:focused? => :accessibilityElementIsFocused
 }
 
 Traits = {
@@ -204,7 +201,7 @@ Touchable_Types = ["UITextField", "UIButton", "UIPickerView", "UIDatePicker",
 "UISegmentedControl", "UISlider", "UIStepper", "UISwitch",
 "UITableViewCell", "UITabBarButton","UINavigationItemButtonView"]
 
-Ignored_Views = ["UIView", "UILayoutContainerView", "UITransitionView", "UINavigationTransitionView", "UIViewControllerWrapperView", "UITableViewCellContentView", "UINavigationItemView", "UITableViewWrapperView"]
+Ignored_Views = ["UILayoutContainerView", "UITransitionView", "UINavigationTransitionView", "UIViewControllerWrapperView", "UITableViewCellContentView", "UINavigationItemView", "UITableViewWrapperView"]
 
 Ignored_ImageViews = ["UINavigationBar", "UITabBar", "UITableView"]
 

data/lib/project/element.rb

@@ -1,12 +1,9 @@
 class UIAccessibilityElement
 
-def initialize(container)
-raise "Please initialize with a container, usually self." unless container
-UIAccessibilityElement.alloc.initWithAccessibilityContainer(self)
+def self.init_with_accessibility_container(container)
+	UIAccessibilityElement.alloc.initWithAccessibilityContainer(container)
 end
 
-alias :init_with_accessibility_container :initialize
-
 Accessibility::Element_Attributes.each do |ruby,ios|
 if ruby=~/=$/
 define_method(ruby) {|value| self.send(ios,value)}
@@ -22,18 +19,8 @@ define_method(ruby) {self.send(ios)}
 end
 end
 
-def accessibility_traits=(traits)
-bits=0
-if traits.kind_of?(Fixnum)
-bits=traits
-elsif traits.kind_of?(Symbol)
-bits=traits.accessibility_trait
-elsif traits.kind_of?(Array)
-traits.each {|trait| bits|=trait.accessibility_trait}
-else
-raise "Pass a bitmask, a symbol, or an array to accessibility_traits="
-end
-OAself.accessibilityTraits=bits
+def traits=(traits)
+	self.accessibility_traits=traits
 end
 
 if self.respond_to?(:method_added)
@@ -61,6 +48,20 @@ define_method(ruby) { self.send(ios)}
 end
 end
 
+def self.container?(obj)
+	!obj.accessibility_element_at_index(0).nil?
+end
+
 end
 
 Accessibility::Element=UIAccessibilityElement
+
+class NSObject
+
+	def each_accessibility_element
+		return unless A11y::Element.container?(self)
+		self.accessibility_element_count.times {|n| yield(self.accessibility_element_at_index(n))}
+	end
+
+end
+

data/lib/project/inspector.rb

@@ -1,33 +1,36 @@
 # Accessibility Inspector
 
-class Object
+module Accessibility
 
-def inspect_accessibility
+def self.inspect(obj)
 displayed=[]
+if obj.class==Accessibility::Element
+attributes=A11y::Element_Attributes.dup
+else
 attributes=Accessibility::All_Attributes.dup
-attributes.merge(Accessibility::PickerView_Attributes) if self.class==UIPickerView
-puts self.inspect
+attributes.merge(Accessibility::PickerView_Attributes) if obj.class==UIPickerView
+end
+puts obj.inspect
 attributes.each do |ruby,ios|
 next if ios=~/^set/
 next if displayed.member?(ios)
-self.inspect_accessibility_attribute(ios)
+self.inspect_accessibility_attribute(obj,ios)
 displayed<<ios
 end
-nil
+puts "Accessibility test: #{obj.accessibility_test}" if obj.accessibility_test
+puts "Accessibility container: #{obj.accessibility_element_count} elements" if A11y::Element.container?(obj)
+puts "Accessible: #{obj.accessible?}"
+A11y.doctor
 end
 
-alias :inspect_a11y :inspect_accessibility
-
-protected
-
-def inspect_accessibility_attribute(attribute)
+def self.inspect_accessibility_attribute(obj,attribute)
 name=attribute.gsub(/(.)([A-Z])/,'\1 \2').capitalize
 if Accessibility::Attribute_Types.member?(attribute)
 begin
 case attribute
-when :accessibilityTraits then value=inspect_accessibility_traits
+when :accessibilityTraits then value=self.inspect_accessibility_traits(obj)
 else
-value=self.send(attribute)
+value=obj.send(attribute)
 end
 if value
 case Accessibility.attribute_type(attribute)
@@ -50,4 +53,17 @@ puts "#{name}: Defined"
 end
 end 
 
+def self.inspect_accessibility_traits(obj)
+	return obj.accessibility_traits if obj.accessibility_traits>Accessibility::Traits.values.max
+traits=[]
+Accessibility::Traits.each do |trait, bitmask|
+if obj.accessibility_traits&bitmask>0
+name=trait.gsub(/_/,' ').capitalize
+traits<<name
+end
+end
+traits=["None"] if traits.empty?
+	traits.join(', ')
+end
+
 end

data/lib/project/motion-accessibility-console/browser.rb

@@ -70,7 +70,7 @@ found=$browser_current.find(request)
 if found
 if found.subviews.empty?
 $browser_cursor=found
-return found.view.inspect_a11y
+return A11y.inspect found.view
 end
 A11y::Console.init unless A11y::Data[:refresh]
 $browser_current=found

data/lib/project/motion-accessibility-console/tree.rb

@@ -27,6 +27,12 @@ self.subviews.each_index {|index| return false unless self.subviews[index]==othe
 return true
 end
 
+def [](n)
+	a=[@view]
+	a+=@subviews if @subviews
+	a[n]
+end
+
 def browsable_nodes
 nodes=[@superview]
 if @subviews
@@ -80,11 +86,12 @@ display.join(" ")
 end
 
 def self.accessible_view?(view)
-return view.accessibility_element?||view.accessibility_label||view.accessibility_value||view.accessibility_traits
+result= view.accessibility_element?||view.accessibility_label||view.accessibility_value||view.accessibility_traits
+(result)?true:false
 end
 
 def self.ignore_view?(view)
-return true if view.subviews.empty?&&!self.accessible_view?(view)
+return true if view.subviews.empty?&&!view.accessible?
 if view.superview
 sv=view.superview
 while sv&&self.ignore_view?(sv)
@@ -102,6 +109,13 @@ def self.build(view=nil, superview=nil)
 tree=self.new
 view=UIApplication.sharedApplication.keyWindow if view.nil?
 subviews=[]
+if A11y::Element.container?(view)
+	view.each_accessibility_element do |element|
+subview_tree=self.build(element, tree)
+subviews<<subview_tree
+	end
+end
+if view.respond_to?(:subviews)
 view.subviews.each do |subview|
 subview_tree=self.build(subview, tree)
 if self.ignore_view?(subview)
@@ -111,6 +125,7 @@ else
 subviews<<subview_tree
 end
 end
+end
 tree.view=view
 tree.subviews=subviews
 tree.superview=superview

data/lib/project/object.rb

@@ -50,18 +50,6 @@ self.accessibilityTraits=bits
 self
 end
 
-def inspect_accessibility_traits
-traits=[]
-Accessibility::Traits.each do |trait, bitmask|
-if self.accessibility_traits&bitmask>0
-name=trait.gsub(/_/,' ').capitalize
-traits<<name
-end
-end
-traits=["None"] if traits.empty?
-	traits.join(', ')
-end
-
 if self.respond_to?(:method_added)
 class << self
 alias :method_added_motion_accessibility :method_added

data/lib/project/test.rb

@@ -0,0 +1,456 @@
+module Accessibility
+	module Test
+
+			Path=Array.new
+			Data= {
+				depth: 0,
+				debug: false
+			}
+
+			Options = {
+				recurse: true
+			}
+
+			Tests = {
+				NSObject: {
+				accessibility_label: [String, "You must set an accessibility label to tell VoiceOver what to read."],
+				accessibility_traits: [UIAccessibilityTraitNone, "You must set accessibility_trait to :none.accessibility_trait"],
+				accessibility_value: nil,
+				accessibility_frame: [CGRect, "You must set an accessibility_frame to tell VoiceOver the bounds of the view." ],
+				accessibility_activation_point: [CGPoint, "You must set an accessibility_activation_point so VoiceOver knows where to touch."],
+				accessibility_path: nil,
+				accessibility_view_is_modal: false,
+				should_group_accessibility_children: false,
+				accessibility_elements_hidden: false,
+				is_accessibility_element: [true, "You must set is_accessibility_element=true to make VoiceOver aware of it. This will often happen automatically when a view becomes visible by giving it a frame and adding it to a subview."]
+			},
+				UIActionSheet: {
+				accessibility_label: nil,
+				is_accessibility_element: false,
+				accessibility_view_is_modal: true
+			},
+				UIActivityIndicatorView: {
+				accessibility_label: [String, "You must set the accessibility_label to the title of the activity indicator."],
+				accessibility_value: [String, "You must set the accessibility_value to the value of the indicator."],
+				accessibility_elements_hidden: true,
+				is_accessibility_element: false
+			},
+				UIApplication: {
+				accessibility_label: [String,"You must set the accessibility_label. Setting the app's title will do this."],
+				is_accessibility_element: false,
+				options: {
+				test: :application
+			}
+			},
+				UIBarItem: {
+				title: [String, "Set the title to tell VoiceOver what to say."],
+				accessibility_label: nil,
+				is_accessibility_element: false,
+			},
+			UIButton: {
+				accessibility_label: [String,"You must set the accessibility_label. You can use the setTitle:forState method to do this on a button."],
+				accessibility_traits: UIAccessibilityTraitButton,
+			},
+			UICollectionReusableView: {
+				accessibility_label: nil,
+				is_accessibility_element: false},
+				UIDatePicker: {
+				accessibility_label: nil,
+				is_accessibility_element: false,
+				options: {
+				recurse: false
+			}
+			},
+				UIImageView: {
+				accessibility_label: nil,
+				accessibility_traits: [UIAccessibilityTraitImage, "You must set accessibility_trait to :image"],
+				is_accessibility_element: false
+			},
+				UILabel: {
+				accessibility_label: [String, "You must set the accessibility_label. You can use the text method to do this."],
+				accessibility_traits: [UIAccessibilityTraitStaticText, "You must set accessibility_traits to :static_text"]
+			},
+				UINavigationBar: {
+				accessibility_label: nil,
+				accessibility_traits: ->(t){A11y::Test.nonstandard(t)},
+				accessibility_elements_hidden: false,
+				should_group_accessibility_children: true,
+				accessibility_identifier: [String, "You must set the accessibility_identifier to the title of the view. You can set the title of the view controller or of the navigation item."],
+				is_accessibility_element: false,
+				options: {
+				recurse: false,
+				test: :bar
+			}
+			},
+				UINavigationController: {
+				accessibility_label: nil,
+				is_accessibility_element: false,
+				options: {
+				recurse: false,
+				test: :navigationViewController
+			}
+			},
+				UINavigationTransitionView: {
+				accessibility_label: nil,
+				should_group_accessibility_children: true,
+				is_accessibility_element: false
+			},
+				UIPageControl: {
+				accessibility_label: nil,
+				is_accessibility_element: false,
+				accessibility_value: [String, "You must set the accessibility_value to something meaningful, for example 'Page 1 of 1'"],
+				accessibility_traits: UIAccessibilityTraitUpdatesFrequently
+			},
+				UIPickerView: {
+				accessibility_label: nil,
+				is_accessibility_element: false,
+				options: {
+				recurse: false,
+				test: :pickerView
+			}
+			},
+				UIAccessibilityPickerComponent: {
+				accessibility_label: nil,
+				accessibility_traits: Fixnum,
+			accessibility_value: String
+			},
+				UIProgressView: {
+				accessibility_label: String,
+				accessibility_traits: UIAccessibilityTraitUpdatesFrequently,
+				accessibility_value: [String, "The accessibility_value should contain a textual representation of the progress, for instance \"50%\""],
+				is_accessibility_element: false
+			},
+				UISegment: {
+				accessibility_label: String,
+				accessibility_traits: [UIAccessibilityTraitButton, "You must make this a button by setting accessibility_trait to :button"],
+				accessibility_value: String
+			},
+				UISegmentedControl: {
+				accessibility_label: nil,
+				is_accessibility_element: false,
+				should_group_accessibility_children: true
+			},
+				UISlider: {
+				accessibility_label: nil,
+				accessibility_value: String,
+				accessibility_traits: UIAccessibilityTraitAdjustable,
+				options: {recurse: false}
+			},
+				UIStepper: {
+				accessibility_label: nil,
+				is_accessibility_element: false,
+				options: {recurse: false}
+			},
+				UISwitch: {
+				accessibility_label: nil,
+				accessibility_traits: ->(t){A11y::Test.nonstandard(t, custom: UIAccessibilityTraitButton, message: "You can use :button.")},
+					accessibility_value: [String, "You must set the accessibility_value to \"1\" or \"0\""]
+			},
+				UITabBar: {
+				accessibility_label: nil,
+				accessibility_traits: ->(t){A11y::Test.nonstandard(t)},
+				should_group_accessibility_children: true,
+				is_accessibility_element: false,
+				options: {
+				recurse: false,
+				test: :bar
+			}
+			},
+				UITabBarButton: {
+				accessibility_label: [String, "You must set the title of this button. You can se tthe title of the UITabBarItem."],
+				accessibility_traits: ->(t){A11y::Test.nonstandard(t, apple: Bignum, custom: UIAccessibilityTraitButton, message: "You can use :button.")},
+			},
+				UITabBarController: {
+				accessibility_label: nil,
+				is_accessibility_element: false,
+				options: {
+				recurse: false,
+				test: :tabBarViewController
+			}
+			},
+				UITableView: {
+				accessibility_label: [String, "You must set the accessibility_label to the default contents of the table view, for example \"Empty List\""],
+				accessibility_traits: ->(t){A11y::Test.nonstandard(t)},
+				should_group_accessibility_children: true,
+				is_accessibility_element: false
+			},
+				UITableViewCell: {
+				accessibility_label: :ignore,
+				accessibility_value: :ignore,
+				is_accessibility_element: false,
+				options: {
+				recurse: false,
+				test: :tableViewCell
+			}
+			},
+				UITableViewCellAccessibilityElement: {
+				accessibility_label: :ignore,
+				accessibility_traits: :ignore,
+				accessibility_value: String,
+				should_group_accessibility_children: :ignore,
+			is_accessibility_element: :ignore
+			},
+				UITableTextAccessibilityElement: {
+				accessibility_label: [String, "Set the accessibility_label to the text of the view."],
+				accessibility_traits: UIAccessibilityTraitStaticText,
+				accessibility_value: String,
+			},
+				UITableViewHeaderFooterView: {
+				accessibility_label: [String, "Set the accessibility_label to tell VoiceOver what to read. You can do this with the textLabel.text property."]
+			},
+				UITextField: {
+				accessibility_label: nil,
+				accessibility_traits: ->(t){A11y::Test.nonstandard(t, apple: Fixnum)},
+				accessibility_value: [:something, "You must set the text of the textfield."],
+				is_accessibility_element: false
+			},
+				UIAccessibilityTextFieldElement: {
+				accessibility_label: nil,
+				accessibility_traits: ->(t){A11y::Test.nonstandard(t, apple: Fixnum)},
+				accessibility_value: [:something, "You must set the text of the textfield."],
+				is_accessibility_element: true
+			},
+				UIToolbar: {
+				accessibility_label: nil,
+				accessibility_traits: ->(t){A11y::Test.nonstandard(t)},
+				should_group_accessibility_children: true,
+				is_accessibility_element:false,
+				options: {
+				test: :bar
+			}
+			},
+				UIToolbarButton: {
+				accessibility_label: [String, "You must set the accessibility_label. You can do this by setting the UIBarButtonItem's title with the setTItle:style:target:action: method."],
+				accessibility_traits: UIAccessibilityTraitButton
+			},
+				UIView: {
+				accessibility_label: nil,
+				is_accessibility_element: false
+			},
+				UIViewController: {
+				accessibility_label: nil,
+				is_accessibility_element: false,
+				options: {
+				test: :viewController
+			}
+			},
+				UIViewControllerWrapperView: {
+				accessibility_label: nil,
+				should_group_accessibility_children: true,
+				is_accessibility_element: false
+			},
+				UIWebView: {
+				accessibility_label: nil,
+				is_accessibility_element: false,
+				options: {
+				recurse: false
+			}
+			},
+				UIWindow: {
+				accessibility_label: nil,
+				is_accessibility_element: false,
+				options: {
+				test: :window
+			}
+			}
+			}
+
+			def self.debug
+				Data[:debug]
+			end
+			def self.debug=(d)
+				Data[:debug]=d
+			end
+
+			def self.nonstandard(value, options={})
+				options[:apple]||=Bignum
+				options[:custom]||=:none.accessibility_trait
+				return true if value.class==options[:apple]||value==options[:custom]
+				options[:attribute]||=:accessibility_traits
+				message="Apple has this set to a non-standard value."
+options[:message]||="Hopefully you can get away with using :none."
+				options[:message]="#{options[:attribute]}: #{message} #{options[:message]}"
+A11y::Test::Log.add(Path, options[:message])
+false
+			end
+
+			def self.application(app)
+				self.run_tests(app.keyWindow)
+			end
+
+			def self.bar(obj)
+				result=true
+				obj.items {|item| result=result&&self.run_tests(item)}
+			result
+		end
+
+			def self.container(container)
+				container.accessibility_element_count.times {|n| return false unless container.accessibility_element_at_index(n).accessible?}
+				true
+			end
+
+		def self.navigationViewController(controller)
+			result=true
+			result&&self.run_tests(controller.navigationBar)
+controller.viewControllers.each {|c| result=result&&self.run_tests(c)}
+result
+		end
+
+		def self.pickerView(picker)
+			result=true
+picker.numberOfComponents.times do |component|
+picker.numberOfRowsInComponent(component).times do |row|
+title=picker.delegate.pickerView(picker, titleForRow: row, forComponent: component)
+view=picker.	viewForRow(row, forComponent: component)
+if !title&&!self.run_tests(view)
+	A11y::Test::Log(Path, picker.inspect+": component #{component} row #{row} not accessible. You can use the pickerView:titleForRow:forComponent or pickerView:accessibility_label_for_component methods to do this.")
+	result=false
+end
+end
+end
+			      result
+		end
+
+		def self.tabBarViewController(controller)
+			result=true
+			result&&self.run_tests(controller.tabBar)
+controller.viewControllers.each {|c| result=result&&self.run_tests(c)}
+result
+		end
+
+		def self.tableViewCell(cell)
+			return true if cell.accessibility_label||cell.textLabel.text
+			A11y::Test::Log.add(Path, "Please set the accessibility_label of the UITableViewCell. You can do this by setting the textLabel.text property.")
+			false
+		end
+
+		def self.viewController(controller)
+			self.run_tests(controller.view)
+		end
+
+		def self.window(window)
+			self.run_tests(window.rootViewController)
+		end
+
+		def self.find_tests(obj)
+			return Tests[obj] if obj.kind_of?(Symbol)
+			obj_tests=A11y::Test::Tests[:NSObject].clone
+cl=obj.class
+class_name=cl.to_s.to_sym
+if obj.accessibility_test
+	tests=Tests[obj.accessibility_test]
+else
+	tests=Tests[class_name]
+until tests do
+	cl=cl.superclass
+class_name=cl.to_s.to_sym
+	tests=Tests[class_name]
+end
+end
+return self.find_tests(tests) if tests.kind_of?(Symbol)
+			tests.each do |attribute, test|
+				obj_tests[attribute]=test
+			end
+obj_tests
+		end
+
+		def self.run_test(obj, attribute, expected, message=nil)
+			return true if expected==:ignore
+	value=obj.send(attribute) if obj.respond_to?(attribute)
+	return value if expected==:something
+	result=true
+	if expected.class==Class
+if value.class!=expected
+	result=false
+message||="#{attribute} must have an object of type #{expected} instead of #{value}"
+end
+	elsif expected.kind_of?(Proc)
+		r=expected.call(value)
+		unless r
+			result=false
+			message||="The test function for #{attribute} failed."
+		end
+	else
+		unless expected==value
+result=false
+message||="#{attribute} must have the value \"#{expected}\" instead of \"#{value}\""
+		end
+	end
+	A11y::Test::Log.add(Path, message) unless result
+	puts "Testing #{attribute}... #{result}" if Data[:debug]
+	result
+		end
+
+		def self.run_tests(obj)
+			puts "Entering run_tests: #{obj.inspect}" if Data[:debug]
+			if Data[:depth]==0
+			A11y::Test::Log::Events.clear
+			Path.clear
+			end
+			Path<<obj
+			tests=self.find_tests(obj)
+	tests[:options]||={}
+	tests[:options]=self::Options.merge(tests[:options])
+result=true
+tests.each do |attribute, test|
+	next if attribute==:options
+	if test.kind_of?(Array)
+	(expected, message)=test
+	this_result=self.run_test(obj, attribute, expected, message)
+	else
+	this_result=self.run_test(obj, attribute, test)
+	end
+	result=result&&this_result
+end
+after=tests[:options][:test]
+ if after&&self.respond_to?(after)
+	 puts "Running the after test: #{after}" if Data[:debug]
+			Data[:depth]=Data[:depth]+1
+	 this_result=self.send(after, obj)
+	 result=result&&this_result
+			Data[:depth]=Data[:depth]-1
+ end
+ if result&&A11y::Element.container?(obj)
+	 result=result&&self.container(obj)
+ end
+if result&&tests[:options][:recurse]&&obj.respond_to?(:subviews)&&obj.subviews
+	puts "Recursing..." if Data[:debug]
+	Data[:depth]=Data[:depth]+1
+obj.subviews.each {|view| result=result&&A11y::Test.run_tests(view)}	
+Data[:depth]=Data[:depth]-1
+end
+Path.pop
+puts "Returning #{result}" if Data[:debug]
+	result
+		end
+
+	end
+
+def self.doctor(view=nil)
+view.accessible? if view
+return if A11y::Test::Log::Events.empty?
+	A11y::Test::Log::Events.each do |event|
+	       NSLog(event.to_s)
+	end
+	A11y::Test::Log::Events.last.path.last
+end
+
+end
+
+	class NSObject
+
+		attr_reader :accessibility_test
+
+		def accessibility_test=(t)
+			t=t.to_s.to_sym if t.kind_of?(Class)
+			@accessibility_test=t if A11y::Test::Tests[t]
+			@accessibility_test
+		end
+
+		def accessible?
+			A11y::Test::Data[:depth]=0
+			A11y::Test.run_tests(self)
+		end
+
+	end
+

data/lib/project/test_log.rb

@@ -0,0 +1,25 @@
+class Accessibility
+	class Test
+		class Log
+
+			Events=Array.new
+			attr_reader :path, :message
+
+			def initialize(path, message)
+				@path=path||Array.new
+				@message=message
+			end
+
+			def to_s
+				@path.join(" -> ")+": "+@message
+			end
+
+			def self.add(path, name)
+				event=self.new(path.clone, name)
+				Events<<event
+			end
+
+		end
+	end
+end
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: motion-accessibility
 version: !ruby/object:Gem::Version
-  version: '2.2'
+  version: '3.0'
 platform: ruby
 authors:
 - Austin Seraphin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-02-20 00:00:00.000000000 Z
+date: 2014-05-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -24,7 +24,8 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: AA RubyMotion wrapper around the UIAccessibility procotols
+description: A RubyMotion gem to make iOS accessibility easier for the sighted and
+  blind developer
 email:
 - austin@austinseraphin.com
 executables: []
@@ -44,6 +45,8 @@ files:
 - lib/project/object.rb
 - lib/project/picker.rb
 - lib/project/status.rb
+- lib/project/test.rb
+- lib/project/test_log.rb
 homepage: https://github.com/austinseraphin/motion-accessibility
 licenses:
 - GPL
@@ -64,9 +67,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.0.6
 signing_key: 
 specification_version: 4
 summary: This gem provides easy ruby-like wrappers around the protocols which interact
-  with VoiceOver and other assistive technologies. Making accessibility accessible!
+  with VoiceOver and other assistive technologies. It has an accessibiity inspector,
+  a text console, and automated testing. Making accessibility accessible!
 test_files: []