moovatom 0.2.0 → 0.3.0

data/README.md

@@ -10,30 +10,33 @@ This gem provides access to the Moovatom online video processing and streaming s
 2. Getting the status of a current encoding
 3. Getting the details of a completed encoding
 4. Canceling an encoding job
-5. Editing the attributes of your video player
+5. Deleting an encoding job
+6. Editing the attributes of your video player
+7. Searching for videos you've already encoded
 
 Installing the gem is done through the usual `gem install moovatom` command, or by adding the following line to your project's Gemfile:
 
 ```
-gem "moovatom", "~> 0.2.0"
+gem "moovatom"
 ```
 
-The entire library is wrapped in a module named MoovAtom. Inside that module is a single class named MoovEngine. This class defines one constant, 12 instance variables and five action methods that interact with Moovatom's RESTful API. The constant `API_URL` defines the URL to which the JSON or XML requests must be POST'd. The 12 instance variables are:
+The entire library is wrapped in a module named MoovAtom. Inside that module is a single class named MoovEngine. This class defines one constant, 13 instance variables and seven action methods that interact with Moovatom's RESTful API. The constant `API_URL` defines the URL to which the JSON or XML requests must be POST'd. The 13 instance variables are:
 
 1. `@uuid`
 2. `@username`
 3. `@userkey`
 4. `@content_type`
-5. `@title`
-6. `@blurb`
-7. `@sourcefile`
-8. `@callbackurl`
-9. `@format`
-10. `@player`
-11. `@action`
-12. `@response`
-
-The last 2 are readable only. `@response` will always contain the last response received from the Moovatom servers and `@action` will be set by each of the action methods explained below. `@player` is a struct object (technically an OpenStruct) that provides access to the player attributes for your video. The remaining nine instance variables are writeable and correspond to the attributes of the video you want to control as well as your specific Moovatom account credentials. These attributes can be set in a number of ways depending upon the needs of your specific application.
+5. `@search_term`
+6. `@title`
+7. `@blurb`
+8. `@sourcefile`
+9. `@callbackurl`
+10. `@format`
+11. `@player`
+12. `@action`
+13. `@response`
+
+The last 2 are readable only. `@response` will always contain the last response received from the Moovatom servers and `@action` will be set by each of the action methods explained below. `@player` is a struct object (technically an OpenStruct) that provides access to the player attributes for your video. The remaining ten instance variables are writable and correspond to the attributes of the video you want to control as well as your specific Moovatom account credentials. These attributes can be set in a number of ways depending upon the needs of your specific application.
 
 Instantiating a new (empty) object to communicate with the MoovAtom API is as simple as:
 
@@ -61,15 +64,12 @@ me3 = MoovEngine.new
 etc...
 ```
 
-The object created in the code above isn't very useful though. A MoovEngine object created without any arguments will, however, receive a few default values. `@content_type` will be initialized with a value of 'video', `@format` will be set to 'json' and `@player` will be initialized as an empty struct if no argument or block parameters are provided. The remaining nine instance variables need to be set with the credentials for your Moovatom account and the specifics about the video you wish to control. Aside from creating an empty object, as we did above, I've tried to include as much flexibility as I could when it comes to creating a new MoovEngine object. You can pass one or two hashes to the initialize method containing the values you wish to be set for either player or video attributes. The first hash will be used to setup video attributes and your Moovatom account credentials. The second hash is used to initialize an OpenStruct object of player attributes.
+The object created in the code above isn't very useful though. A MoovEngine object created without any arguments will, however, receive a few default values. `@content_type` will be initialized with a value of 'video', `@format` will be set to 'json' and `@player` will be initialized as an empty struct if no argument or block parameters are provided. The remaining ten instance variables need to be set with the credentials for your Moovatom account and the specifics about the video you wish to control. Aside from creating an empty object, as we did above, I've tried to include as much flexibility as I could when it comes to creating a new MoovEngine object. You can pass one or two hashes to the initialize method containing the values you wish to be set for either player or video attributes. The first hash will be used to setup video attributes and your Moovatom account credentials. The second hash is used to initialize an OpenStruct object of player attributes.
 
 ```ruby
-You can pass literal hashes:
-me = MoovAtom::MoovEngine.new({uuid: 'j9i8h7g6f5e4d3c2b1a'}, {height: '480'})
-
-But it may be more readable to create the hashes first and then pass them:
 vattrs = {uuid: 'j9i8h7g6f5e4d3c2b1a', username: 'USERNAME', etc...}
 pattrs = {width: "720", height: "480", etc...}
+
 me = MoovAtom::MoovEngine.new(vattrs, pattrs)
 ```
 
@@ -103,15 +103,17 @@ The gem has been designed to be highly customizable. You are free to create a si
 
 # Action Methods
 
-The MoovEngine class has five methods that have been designed to interact directly with the RESTful API implemented by Moovatom's servers:
+The MoovEngine class has seven methods that have been designed to interact directly with the RESTful API implemented by Moovatom's servers:
 
 1. `get_details()` will return details about an encoded video
 2. `get_status()` will return the status of a video (e.g. - whether or not encoding has completed)
 3. `encode()` will start a new encoding job
 4. `cancel()` will cancel an __unfinished__ encoding job
-5. `edit_player()` changes the attributes of your video's online player
+5. `delete()` will delete a __finished__ encoding job
+6. `edit_player()` changes the attributes of your video's online player
+7. `media_search()` returns videos based on the search terms you've provided
 
-Each of these methods are almost identical. They all accept a hash/block argument syntax similar to the initialize method. The main difference is that the action methods will accept only one hash and a block. This allows you to easily reuse a MoovEngine object to request information about different videos. The five action methods are able to be used and reused because they share a method that handles the heavy lifting when building and sending the request to Moovatom: `send_request()`. The `send_request()` method takes every instance variable (including player attributes) and creates a hash of the key/value attributes for your video. It then uses the `@format` and `@action` instance variables to build and POST the appropriate request to the Moovatom servers. If the response is successful it will parse it into either JSON or XML and store it in the `@response` instance variable. If the response is anything other than "200 OK" the raw Net::HTTPResponse object will be passed through and stored in `@response`. This allows you and your app to determine how best to handle the specific error response.
+Each of these methods are almost identical. They all accept a hash/block argument syntax similar to the initialize method. The main difference is that the action methods will accept only one hash and a block. This allows you to easily reuse a MoovEngine object to request information about different videos. The seven action methods are able to be used and reused because they share a method that handles the heavy lifting when building and sending the request to Moovatom: `send_request()`. The `send_request()` method takes every instance variable (including player attributes) and creates a hash of the key/value attributes for your video. It then uses the `@format` and `@action` instance variables to build and POST the appropriate request to the Moovatom servers. If the response is successful it will parse it into either JSON or XML and store it in the `@response` instance variable. If the response is anything other than "200 OK" the raw Net::HTTPResponse object will be passed through and stored in `@response`. This allows you and your app to determine how best to handle the specific error response.
 
 For more specific information about the Moovatom API please see the [documentation](http://moovatom.com/support/v2/api.html).
 
@@ -135,17 +137,21 @@ else
 end
 ```
 
-A details request will POST the __uuid__, __username__ and __userkey__ instance variables from your MoovEngine object using the `send_request()` method. If successful `@response` will contain either a JSON or XML formatted object (depending on the value of `@format`) ready to be queried and used. The example above shows how you can pass a hash, a block or both to the method. The remaining four action methods all accept the same style of argument passing.
+A details request will POST the __uuid__, __username__ and __userkey__ instance variables from your MoovEngine object. If successful `@response` will contain either a JSON or XML formatted object (depending on the value of `@format`) ready to be queried and used. The example above shows how you can pass a hash, a block or both to the method. The remaining six action methods all accept the same style of argument passing.
 
 *Successful get_details() JSON Response:*
 
 ```
 {
     "uuid": "UUID",
+    "title": "Video Title",
+    "summary": "A short description about the media.",
+    "duration": "45.347",
     "media_type": "video",
     "embed_code": "EMBED CODE SMART SWITCHING FOR AUTOMATIC MOBILE AND WEB SUPPORT.",
     "iframe_target": "http://www.moovatom.com/media/embed/ID",
-    "original_download": "http://www.moovatom.com/media/download/orig/UUID",
+    "http_live_streaming_playlist": "http://media.moovatom.com:1935/PATH_TO_FILE",
+    "original_download": "http://static.moovatom.com/PATH_TO_FILE",
     "versions": [
         {
             "name": "mobile",
@@ -211,7 +217,6 @@ A details request will POST the __uuid__, __username__ and __userkey__ instance
 }
 ```
 
-
 ## Status
 
 The `get_status()` method allows you to query a video that has begun encoding to check its progress.
@@ -236,7 +241,7 @@ unless me.response["processing"]
 end
 ```
 
-A status request will POST the __uuid__, __username__ and __userkey__ instance variables from your MoovEngine object using the `send_request()` method. The `@response` variable will contain either a success or error response:
+A status request will POST the __uuid__, __username__ and __userkey__ instance variables from your MoovEngine object. The `@response` variable will contain either a success or error response:
 
 *Status Success Response:*
 
@@ -276,7 +281,7 @@ end
 me.encode
 ```
 
-An encode request will POST the __username__, __userkey__, __content type__, __title__, __blurb__, __sourcefile__ and __callbackurl__ instance variables from your MoovEngine object using the `send_request()` method. The body of the Moovatom response will contain the uuid assigned by Moovatom's servers to this new video as well as a message stating whether or not your job was started successfully:
+An encode request will POST the __username__, __userkey__, __content type__, __title__, __blurb__, __sourcefile__ and __callbackurl__ instance variables from your MoovEngine object. The body of the Moovatom response will contain the uuid assigned by Moovatom's servers to this new video as well as a message stating whether or not your job was started successfully:
 
 *Encode Started Response:*
 
@@ -287,7 +292,7 @@ An encode request will POST the __username__, __userkey__, __content type__, __t
 }
 ```
 
-After a successful response the `@uuid` variable of your MoovEngine object will be set to the uuid assigned by Moovatom. The encode action implemented on Moovatom's servers differs slightly from the other four actions. Once the encoding is complete Moovatom's servers will send a response to the call back URL you set in the `@callbackurl` instance variable. Your app should define a controller (or url handler if it's a [Sinatra](http://www.sinatrarb.com/) app) that will process these callbacks to save/update the video's details in your database. The body of the callback sent by Moovatom looks exactly like the response from a `get_details()` request.
+After a successful response the `@uuid` variable of your MoovEngine object will be set to the uuid assigned by Moovatom. The encode action implemented on Moovatom's servers differs slightly from the other six actions. Once the encoding is complete Moovatom's servers will send a response to the callback URL you set in the `@callbackurl` instance variable. Your app should define a controller (or url handler if it's a [Sinatra](http://www.sinatrarb.com/) app) that will process these callbacks to save/update the video's details in your database. The body of the callback sent by Moovatom looks exactly like the response from a `get_details()` request.
 
 Additionally, the video you are uploading to Moovatom must be in a __publicly accessibly location__. Moovatom will attempt to transfer that video from the url you define in the `@sourcefile` instance variable. The ability to upload a video directly is planned for a future version of the API and this gem.
 
@@ -295,7 +300,7 @@ For more specific information about the Moovatom API please see the [documentati
 
 ## Cancel
 
-If you decide, for whatever reason, that you no longer need or want a specific video on Moovatom you can cancel its encoding anytime __before it finishes__ using the `cancel()` method. A cancel request will POST the __uuid__, __username__ and __userkey__ instance variables from your MoovEngine object using the `send_request()` method. The body of the Moovatom response will contain a message telling you whether or not you successfully cancelled your video:
+If you decide, for whatever reason, that you no longer need or want a specific video on Moovatom you can cancel its encoding anytime __before it finishes__ using the `cancel()` method. A cancel request will POST the __uuid__, __username__ and __userkey__ instance variables from your MoovEngine object. The body of the Moovatom response will contain a message telling you whether or not you've successfully cancelled your video:
 
 ```ruby
 me = MoovAtom::MoovEngine.new(uuid: 'j9i8h7g6f5e4d3c2b1a') do |me|
@@ -321,7 +326,33 @@ end
 }
 ```
 
-*__NOTE:__ There is currently no way to delete a video from your Moovatom account that has completed encoding without manually logging in and deleting it yourself. The ability to delete through the API will be available in the future.*
+## Delete
+
+If you decide, for whatever reason, that you no longer need or want a specific video on Moovatom you can delete its encoding anytime __after it finishes__ using the `delete()` method. A delete request will POST the __uuid__, __username__ and __userkey__ instance variables from your MoovEngine object. The body of the Moovatom response will contain a message telling you whether or not you've successfully deleted your video:
+
+```ruby
+me = MoovAtom::MoovEngine.new(uuid: 'j9i8h7g6f5e4d3c2b1a') do |me|
+  me.username = 'USERNAME'
+  me.userkey = 'a1b2c3d4e5f6g7h8i9j'
+end
+
+me.get_status
+
+unless me.response['processing']
+  me.delete
+else
+  "...gracefully fail or raise an exception here..."
+end
+```
+
+*Example delete request response:*
+
+```
+{
+    "uuid": "UUID",
+    "message": "Your media was successfully deleted."
+}
+```
 
 ## Edit Player
 
@@ -347,11 +378,9 @@ button_over_color: #92B2BD
 time_color: #01DAFF
 ```
 
-The `edit_player()` method accepts the same hash/block argument syntax as the first four action methods, however, it takes the hash you pass and merges those attributes into any previous ones supplied in the second hash passed to the initialize method. Since the `@player` instance variable is just an OpenStruct object you can set any of the attributes above manually or through a block as well.
+The `edit_player()` method accepts the same hash/block argument syntax as the other six action methods, however, it takes the hash you pass and merges those attributes into any previous ones supplied in the second hash passed to the initialize method. Since the `@player` instance variable is just an OpenStruct object you can set any of the attributes above manually, in a hash or through a block.
 
 ```ruby
-Variables can be set manually, with a hash or a block or both:
-
 me.player.watermark = "http://www.example.com/path/to/watermark.png"
 me.player.watermark_url = "http://www.example.com"
 me.player.show_watermark = true
@@ -361,37 +390,137 @@ me.edit_player(width: "800", height: "500") do |me|
 end
 ```
 
-You can always add an attribute to your player struct by calling into it through the player instance variable:
+Since `@player` is implemented an an OpenStruct object it will create the attributes dynamically as you need them. This way only the attributes you wish to alter will be sent in your requests.
+
+## Media Search
+
+The `media_search()` action method allows you to query the videos you've uploaded to and encoded on Moovatom's servers using search terms entered into the `@search_terms` instance variable. A media_search request will POST the __username__, __userkey__ and __search_term__ instance variables from your MoovEngine object. The body of the Moovatom response will be similar to a details request:
 
 ```ruby
-me = MoovAtom::MoovEngine.new
-me.player.height = "480"
-me.player.width = "720"
-me.player.auto_play = false
-me.player.sharing_enabled = true
-me.player.watermark_opacity = "0.8"
-me.player.background_color = "#000000"
-me.player.duration_color = "#FFFFFF"
-me.player.volume_color = "#000000"
-me.player.button_color = "#889AA4"
-me.player.time_color = "#01DAFF"
+me = MoovAtom::MoovEngine.new(username: 'USERNAME') do |me|
+  me.userkey = 'a1b2c3d4e5f6g7h8i9j'
+  me.search_term = 'dolphin'
+end
+
+me.media_search
 ```
 
-Since `@player` is implemented an an OpenStruct object it will create the attributes dynamically as you need them. This way only the attributes you wish to alter will be sent in your requests.
+*Example media search request response:*
+
+```
+{
+    "result_count": "1",
+    "user": "USERNAME",
+    "results": [
+        {
+            "uuid": "UUID",
+            "title": "Dolphin Training",
+            "summary": "How to train your dolphin like a pro.",
+            "duration": "45.347",
+            "media_type": "video",
+            "embed_code": "EMBED CODE IFRAME FOR SMART SWITCHING",
+            "iframe_target": "http://www.moovatom.com/media/embed/ID",
+            "original_download": "http://www.moovatom.com/media/download/orig/UUID",
+            "versions": [
+                {
+                    "name": "sample",
+                    "type": "video/mp4",
+                    "holdframe_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "holdframe_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "rtmp_stream": "rtmp://media.moovatom.com/PATH_TO_FILE",
+                    "http_stream": "http://media.moovatom.com:1935/PATH_TO_FILE",
+                    "rtsp_stream": "rtsp://media.moovatom.com:1935/PATH_TO_FILE",
+                    "download": "http://www.moovatom.com/PATH_TO_FILE"
+                },
+                {
+                    "name": "mobile",
+                    "type": "video/mp4",
+                    "holdframe_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "holdframe_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "rtmp_stream": "rtmp://media.moovatom.com/PATH_TO_FILE",
+                    "http_stream": "http://media.moovatom.com:1935/PATH_TO_FILE",
+                    "rtsp_stream": "rtsp://media.moovatom.com:1935/PATH_TO_FILE",
+                    "download": "http://www.moovatom.com/PATH_TO_FILE"
+                },
+                {
+                    "name": "mobile_large",
+                    "type": "video/mp4",
+                    "holdframe_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "holdframe_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "rtmp_stream": "rtmp://media.moovatom.com/PATH_TO_FILE",
+                    "http_stream": "http://media.moovatom.com:1935/PATH_TO_FILE",
+                    "rtsp_stream": "rtsp://media.moovatom.com:1935/PATH_TO_FILE",
+                    "download": "http://www.moovatom.com/PATH_TO_FILE"
+                },
+                {
+                    "name": "small",
+                    "type": "video/mp4",
+                    "holdframe_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "holdframe_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "rtmp_stream": "rtmp://media.moovatom.com/PATH_TO_FILE",
+                    "http_stream": "http://media.moovatom.com:1935/PATH_TO_FILE",
+                    "rtsp_stream": "rtsp://media.moovatom.com:1935/PATH_TO_FILE",
+                    "download": "http://www.moovatom.com/PATH_TO_FILE"
+                },
+                {
+                    "name": "medium",
+                    "type": "video/mp4",
+                    "holdframe_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "holdframe_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "rtmp_stream": "rtmp://media.moovatom.com/PATH_TO_FILE",
+                    "http_stream": "http://media.moovatom.com:1935/PATH_TO_FILE",
+                    "rtsp_stream": "rtsp://media.moovatom.com:1935/PATH_TO_FILE",
+                    "download": "http://www.moovatom.com/PATH_TO_FILE"
+                },
+                {
+                    "name": "large",
+                    "type": "video/mp4",
+                    "holdframe_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "holdframe_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "rtmp_stream": "rtmp://media.moovatom.com/PATH_TO_FILE",
+                    "http_stream": "http://media.moovatom.com:1935/PATH_TO_FILE",
+                    "rtsp_stream": "rtsp://media.moovatom.com:1935/PATH_TO_FILE",
+                    "download": "http://www.moovatom.com/PATH_TO_FILE"
+                }
+            ]
+        }
+    ]
+}
+```
 
 For more specific information about the Moovatom API please see the [documentation](http://moovatom.com/support/v2/api.html).
 
 # Testing
 
-Development of this gem was done on Ruby 1.9.2-p290. There should be no problems on 1.9.3. I haven't tried it on Ruby 1.8.7, but you shouldn't be using 1.8.7 anyways.  :-)
+Development of this gem was done on Ruby 1.9.2-p290, and has been tested up to 1.9.3-p286. I haven't tried it on Ruby 1.8.7, but you shouldn't be using 1.8.7 anyways.  :-)
 
 This gem uses [Minitest](https://github.com/seattlerb/minitest), [Turn](https://github.com/TwP/turn) and [Fakeweb](https://github.com/chrisk/fakeweb) to implement specs for each of the above request methods, pretty colorized output and for mocking up a connection to the API.
 
-The entire test suite is under the spec directory. The `spec_helper.rb` file contains the common testing code and gets required by each `*_spec.rb` file. There is one spec file (`init_spec.rb`) that tests the expected functionality related to initializing a new MoovEngine object. Each of the five action methods also has a single spec file dedicated to testing its expected functionality. All API requests are mocked through [Fakeweb](https://github.com/chrisk/fakeweb) and the responses come from the files in the fixtures directory.
+The entire test suite is under the spec directory. The `spec_helper.rb` file contains the common testing code and gets required by each `*_spec.rb` file. There is one spec file (`init_spec.rb`) that tests the expected functionality related to initializing a new MoovEngine object. Each of the six action methods also has a single spec file dedicated to testing its expected functionality. All API requests are mocked through [Fakeweb](https://github.com/chrisk/fakeweb) and the responses come from the files in the fixtures directory.
 
 The Rakefile's default task is 'minitest', which will load and execute all the `*_spec.rb` files in the spec directory. So a simple call to `rake` on the command line from the project's root directory will run the entire test suite.
 
-This is the first Ruby project in which I started from a TDD/BDD design perspective. If anyone has a problem with the tests or sees areas where I can improve please [open an issue](https://github.com/humanshell/moovatom/issues) here so it can be discussed and everyone can learn a little. I really enjoyed creating tests that helped drive the design of the code. I'm sure there are *PLENTY* of areas in which I can improve.
+This is the first Ruby project in which I started from a TDD/BDD design perspective. If anyone has a problem with the tests or sees areas where I can improve please [open an issue](https://github.com/humanshell/moovatom-ruby/issues) here so it can be discussed and everyone can learn a little. I really enjoyed creating tests that helped drive the design of the code. I'm sure there are *PLENTY* of areas in which I can improve.
+
+# Changelog
+
+## v0.3.0
+
+* Added support for the delete action method
+* Added support for the media_search action method
+* Updated documentation
 
 # Moovatom
 

data/lib/moovatom.rb

@@ -19,8 +19,8 @@ module MoovAtom
   
   class MoovEngine
     attr_reader   :response, :action
-    attr_accessor :uuid, :username, :userkey, :content_type, :title, :blurb,
-                  :sourcefile, :callbackurl, :format, :player
+    attr_accessor :uuid, :username, :userkey, :content_type, :search_term, :title,
+                  :blurb, :sourcefile, :callbackurl, :format, :player
     
     ##
     # The initializer populates the class' instance variables to hold all the
@@ -138,7 +138,37 @@ module MoovAtom
       @player.instance_variable_get("@table").merge! attrs
       yield self if block_given?
       send_request
-    end #-- edit method
+    end #-- edit_player method
+
+    ##
+    # The delete() method allows you to delete a video that's finished encoding
+    # on the Moovatom servers. It is almost identical to the get_details() and
+    # get_status() methods. You can pass the same type/combination of arguments
+    # and it also sets the @action instance variable to 'delete' for you.
+    #
+    # See README for specific examples
+
+    def delete(attrs={}, &block)
+      @action = 'delete'
+      attrs.each {|k,v| instance_variable_set "@#{k}", v}
+      yield self if block_given?
+      send_request
+    end #-- delete method
+
+    ##
+    # The media_search() method allows you to search for a video on the
+    # Moovatom servers. It is almost identical to the get_details() and
+    # get_status() methods. You can pass the same type/combination of arguments
+    # and it also sets the @action instance variable to 'media_search' for you.
+    #
+    # See README for specific examples
+
+    def media_search(attrs={}, &block)
+      @action = 'media_search'
+      attrs.each {|k,v| instance_variable_set "@#{k}", v}
+      yield self if block_given?
+      send_request
+    end #-- media_search method
 
     private
 
@@ -216,6 +246,7 @@ module MoovAtom
       puts "Blurb:        #{@blurb}"
       puts "Source File:  #{@sourcefile}"
       puts "Callback URL: #{@callbackurl}"
+      puts "Search Term:  #{@search_term}"
       puts "Action:       #{@action}"
       puts "Format:       #{@format}"
       puts "Response:     #{@response.class}"

data/lib/moovatom/version.rb

@@ -1,3 +1,3 @@
 module MoovAtom
-  VERSION = "0.2.0"
+  VERSION = '0.3.0'
 end

data/moovatom.gemspec

@@ -1,24 +1,24 @@
 # -*- encoding: utf-8 -*-
-$:.push File.expand_path("../lib", __FILE__)
-require "moovatom/version"
+$:.push File.expand_path('../lib', __FILE__)
+require 'moovatom/version'
 
 Gem::Specification.new do |s|
   
   #-- author info
-  s.authors           = ["Dominic Giglio"]
-  s.email             = ["humanshell@gmail.com"]
-  s.homepage          = "http://moovatom.com"
+  s.authors           = ['Dominic Giglio']
+  s.email             = ['humanshell@gmail.com']
+  s.homepage          = 'http://moovatom.com'
   
   #-- gem info
-  s.name              = "moovatom"
+  s.name              = 'moovatom'
   s.version           = MoovAtom::VERSION
   s.summary           = %q{Access MoovAtom API}
   s.description       = %q{This gem defines methods for controlling your videos on MoovAtom using the MoovEngine API.}
-  s.rubyforge_project = "moovatom"
+  s.rubyforge_project = 'moovatom'
   s.files             = `git ls-files`.split("\n")
   s.test_files        = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.executables       = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-  s.require_paths     = ["lib"]
+  s.require_paths     = ['lib']
 
   #-- release dependencies
   s.add_dependency('json')

data/spec/delete_spec.rb

@@ -0,0 +1,106 @@
+require "spec_helper"
+
+# this file contains all the tests associated with deleting
+# a video on Moovatom's servers.
+
+describe MoovAtom::MoovEngine, "Delete Request Unit Tests" do
+
+  before do
+    @vars1 = {
+      uuid: '123',
+      username: 'jsmith',
+      userkey: '987654321',
+      title: 'My Greatest Movie',
+      blurb: 'The greatest movie ever made',
+      sourcefile: 'http://example.com/greatest.mp4',
+      callbackurl: 'http://example.com/callback'
+    }
+
+    @vars2 = {
+      uuid: '321',
+      username: 'asmith',
+      userkey: '123456789',
+      title: 'My Best Movie',
+      blurb: 'The bestest movie ever made',
+      sourcefile: 'http://example.com/best.mp4',
+      callbackurl: 'http://example.com/callback_url'
+    }
+
+    # mock up the connection to moovatom.com
+    @me = MoovAtom::MoovEngine.new @vars1
+    @url = "#{MoovAtom::API_URL}/delete"
+    json = File.join(File.dirname(__FILE__), 'fixtures', 'delete.json')
+    FakeWeb.register_uri(:post, "#{@url}.json", :body => json)
+    xml = File.join(File.dirname(__FILE__), 'fixtures', 'delete.xml')
+    FakeWeb.register_uri(:post, "#{@url}.xml", :body => xml)
+  end
+
+  after do
+    # clean up the registry after each test
+    FakeWeb.clean_registry
+
+    # enable all real requests after testing
+    FakeWeb.allow_net_connect = true
+  end
+
+  it "accepts a hash to update attributes" do
+
+    # create a MoovEngine object using the values from the @vars1 hash
+    me = MoovAtom::MoovEngine.new @vars1
+
+    # call delete() passing the hash of values from @vars2
+    me.delete @vars2
+
+    # the instance 'me' should now contain the values from the @vars2 hash
+    @vars2.each {|k,v| me.instance_variable_get("@#{k}").must_equal v}
+
+  end
+
+  it "accepts a block to update attributes" do
+
+    # create a new MoovEngine object with a block using the values from @vars1
+    me = MoovAtom::MoovEngine.new do |me|
+      @vars1.each {|k,v| me.instance_variable_set "@#{k}", v}
+    end
+
+    # call delete() passing a block that sets instance variables to the
+    # values in the @vars2 hash
+    me.delete do |me|
+      @vars2.each {|k,v| me.instance_variable_set "@#{k}", v}
+    end
+
+    # the instance 'me' should now contain the values from the @vars2 hash
+    @vars2.each {|k,v| me.instance_variable_get("@#{k}").must_equal v}
+
+  end
+
+  it "sets the action attribute to delete" do
+
+    # create a new MoovEngine object
+    me = MoovAtom::MoovEngine.new @vars1
+
+    # call the delete() method
+    me.delete
+
+    # after calling delete() @action should be 'delete'
+    me.action.must_equal 'delete'
+
+  end
+
+  # tests for the api call to delete an existing video
+  describe "API Requests" do
+
+    it "deletes a video using json" do
+      @me.delete
+      @me.response["uuid"].must_equal @vars1[:uuid]
+    end
+
+    it "deletes a video using xml" do
+      @me.format = 'xml'
+      @me.delete
+      @me.response.root.elements["uuid"].text.must_equal @vars1[:uuid]
+    end
+
+  end
+
+end

data/spec/fixtures/delete.json

@@ -0,0 +1,4 @@
+{
+    "uuid": "123",
+    "message": "Your media was successfully deleted."
+}

data/spec/fixtures/delete.xml

@@ -0,0 +1,4 @@
+<response>
+    <uuid>123</uuid>
+    <message>Your media was successfully deleted.</message>
+</response>

data/spec/fixtures/media_search.json

@@ -0,0 +1,90 @@
+{
+    "result_count": "1",
+    "user": "USERNAME",
+    "results": [
+        {
+            "uuid": "123",
+            "title": "Video Title",
+            "summary": "A short description about the media.",
+            "duration": "45.347",
+            "media_type": "video",
+            "embed_code": "EMBED CODE IFRAME FOR SMART SWITCHING",
+            "iframe_target": "http://www.moovatom.com/media/embed/ID",
+            "original_download": "http://www.moovatom.com/media/download/orig/UUID",
+            "versions": [
+                {
+                    "name": "sample",
+                    "type": "video/mp4",
+                    "holdframe_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "holdframe_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "rtmp_stream": "rtmp://media.moovatom.com/PATH_TO_FILE",
+                    "http_stream": "http://media.moovatom.com:1935/PATH_TO_FILE",
+                    "rtsp_stream": "rtsp://media.moovatom.com:1935/PATH_TO_FILE",
+                    "download": "http://www.moovatom.com/PATH_TO_FILE"
+                },
+                {
+                    "name": "mobile",
+                    "type": "video/mp4",
+                    "holdframe_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "holdframe_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "rtmp_stream": "rtmp://media.moovatom.com/PATH_TO_FILE",
+                    "http_stream": "http://media.moovatom.com:1935/PATH_TO_FILE",
+                    "rtsp_stream": "rtsp://media.moovatom.com:1935/PATH_TO_FILE",
+                    "download": "http://www.moovatom.com/PATH_TO_FILE"
+                },
+                {
+                    "name": "mobile_large",
+                    "type": "video/mp4",
+                    "holdframe_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "holdframe_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "rtmp_stream": "rtmp://media.moovatom.com/PATH_TO_FILE",
+                    "http_stream": "http://media.moovatom.com:1935/PATH_TO_FILE",
+                    "rtsp_stream": "rtsp://media.moovatom.com:1935/PATH_TO_FILE",
+                    "download": "http://www.moovatom.com/PATH_TO_FILE"
+                },
+                {
+                    "name": "small",
+                    "type": "video/mp4",
+                    "holdframe_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "holdframe_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "rtmp_stream": "rtmp://media.moovatom.com/PATH_TO_FILE",
+                    "http_stream": "http://media.moovatom.com:1935/PATH_TO_FILE",
+                    "rtsp_stream": "rtsp://media.moovatom.com:1935/PATH_TO_FILE",
+                    "download": "http://www.moovatom.com/PATH_TO_FILE"
+                },
+                {
+                    "name": "medium",
+                    "type": "video/mp4",
+                    "holdframe_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "holdframe_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "rtmp_stream": "rtmp://media.moovatom.com/PATH_TO_FILE",
+                    "http_stream": "http://media.moovatom.com:1935/PATH_TO_FILE",
+                    "rtsp_stream": "rtsp://media.moovatom.com:1935/PATH_TO_FILE",
+                    "download": "http://www.moovatom.com/PATH_TO_FILE"
+                },
+                {
+                    "name": "large",
+                    "type": "video/mp4",
+                    "holdframe_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_download": "http://www.moovatom.com/PATH_TO_FILE",
+                    "holdframe_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "thumbnail_serve": "http://static.moovatom.com/PATH_TO_FILE",
+                    "rtmp_stream": "rtmp://media.moovatom.com/PATH_TO_FILE",
+                    "http_stream": "http://media.moovatom.com:1935/PATH_TO_FILE",
+                    "rtsp_stream": "rtsp://media.moovatom.com:1935/PATH_TO_FILE",
+                    "download": "http://www.moovatom.com/PATH_TO_FILE"
+                }
+            ]
+        }
+    ]
+}

data/spec/fixtures/media_search.xml

@@ -0,0 +1,91 @@
+<?xml version="1.0"?>
+<response>
+    <result_count>1</result_count>
+    <user>USERNAME</user>
+    <results>
+        <result>
+            <uuid>123</uuid>
+            <title>Video Title</title>
+            <summary>A short description about the media.</summary>
+            <duration>45.347</duration>
+            <media_type>video</media_type>
+            <embed_code>EMBED CODE IFRAME FOR SMART SWITCHING</embed_code>
+            <iframe_target>http://www.moovatom.com/media/embed/ID</iframe_target>
+            <original_download>http://PATH_TO_FILE</original_download>
+            <versions>
+                <version>
+                    <name>sample</name>
+                    <type>video/mp4</type>
+                    <holdframe_download>http://PATH_TO_FILE</holdframe_download>
+                    <thumbnail_download>http://PATH_TO_FILE</thumbnail_download>
+                    <holdframe_serve>http://PATH_TO_FILE</holdframe_serve>
+                    <thumbnail_serve>http://PATH_TO_FILE</thumbnail_serve>
+                    <rtmp_stream>rtmp://PATH_TO_FILE</rtmp_stream>
+                    <http_stream>http://PATH_TO_FILE</http_stream>
+                    <rtsp_stream>rtsp://PATH_TO_FILE</rtsp_stream>
+                    <download>http://PATH_TO_FILE</download>
+                </version>
+                <version>
+                    <name>mobile</name>
+                    <type>video/mp4</type>
+                    <holdframe_download>http://PATH_TO_FILE</holdframe_download>
+                    <thumbnail_download>http://PATH_TO_FILE</thumbnail_download>
+                    <holdframe_serve>http://PATH_TO_FILE</holdframe_serve>
+                    <thumbnail_serve>http://PATH_TO_FILE</thumbnail_serve>
+                    <rtmp_stream>rtmp://PATH_TO_FILE</rtmp_stream>
+                    <http_stream>http://PATH_TO_FILE</http_stream>
+                    <rtsp_stream>rtsp://PATH_TO_FILE</rtsp_stream>
+                    <download>http://PATH_TO_FILE</download>
+                </version>
+                <version>
+                    <name>mobile_large</name>
+                    <type>video/mp4</type>
+                    <holdframe_download>http://PATH_TO_FILE</holdframe_download>
+                    <thumbnail_download>http://PATH_TO_FILE</thumbnail_download>
+                    <holdframe_serve>http://PATH_TO_FILE</holdframe_serve>
+                    <thumbnail_serve>http://PATH_TO_FILE</thumbnail_serve>
+                    <rtmp_stream>rtmp://PATH_TO_FILE</rtmp_stream>
+                    <http_stream>http://PATH_TO_FILE</http_stream>
+                    <rtsp_stream>rtsp://PATH_TO_FILE</rtsp_stream>
+                    <download>http://PATH_TO_FILE</download>
+                </version>
+                <version>
+                    <name>small</name>
+                    <type>video/mp4</type>
+                    <holdframe_download>http://PATH_TO_FILE</holdframe_download>
+                    <thumbnail_download>http://PATH_TO_FILE</thumbnail_download>
+                    <holdframe_serve>http://PATH_TO_FILE</holdframe_serve>
+                    <thumbnail_serve>http://PATH_TO_FILE</thumbnail_serve>
+                    <rtmp_stream>rtmp://PATH_TO_FILE</rtmp_stream>
+                    <http_stream>http://PATH_TO_FILE</http_stream>
+                    <rtsp_stream>rtsp://PATH_TO_FILE</rtsp_stream>
+                    <download>http://PATH_TO_FILE</download>
+                </version>
+                <version>
+                    <name>medium</name>
+                    <type>video/mp4</type>
+                    <holdframe_download>http://PATH_TO_FILE</holdframe_download>
+                    <thumbnail_download>http://PATH_TO_FILE</thumbnail_download>
+                    <holdframe_serve>http://PATH_TO_FILE</holdframe_serve>
+                    <thumbnail_serve>http://PATH_TO_FILE</thumbnail_serve>
+                    <rtmp_stream>rtmp://PATH_TO_FILE</rtmp_stream>
+                    <http_stream>http://PATH_TO_FILE</http_stream>
+                    <rtsp_stream>rtsp://PATH_TO_FILE</rtsp_stream>
+                    <download>http://PATH_TO_FILE</download>
+                </version>
+                <version>
+                    <name>large</name>
+                    <type>video/mp4</type>
+                    <holdframe_download>http://PATH_TO_FILE</holdframe_download>
+                    <thumbnail_download>http://PATH_TO_FILE</thumbnail_download>
+                    <holdframe_serve>http://PATH_TO_FILE</holdframe_serve>
+                    <thumbnail_serve>http://PATH_TO_FILE</thumbnail_serve>
+                    <rtmp_stream>rtmp://PATH_TO_FILE</rtmp_stream>
+                    <http_stream>http://PATH_TO_FILE</http_stream>
+                    <rtsp_stream>rtsp://PATH_TO_FILE</rtsp_stream>
+                    <download>http://PATH_TO_FILE</download>
+                </version>
+            </versions>
+        </result>
+    </results>
+</response>

data/spec/search_spec.rb

@@ -0,0 +1,105 @@
+require "spec_helper"
+
+# this file contains all the tests associated with searching for
+# videos on Moovatom's servers.
+
+describe MoovAtom::MoovEngine, "Media Search Request Unit Tests" do
+
+  before do
+    @vars1 = {
+      uuid: '123',
+      username: 'jsmith',
+      userkey: '987654321',
+      search_term: 'Example Query',
+      title: 'My Greatest Movie',
+      blurb: 'The greatest movie ever made',
+      sourcefile: 'http://example.com/greatest.mp4',
+      callbackurl: 'http://example.com/callback'
+    }
+
+    @vars2 = {
+      uuid: '321',
+      username: 'asmith',
+      userkey: '123456789',
+      search_term: 'Example Query',
+      title: 'My Best Movie',
+      blurb: 'The bestest movie ever made',
+      sourcefile: 'http://example.com/best.mp4',
+      callbackurl: 'http://example.com/callback_url'
+    }
+
+    # mock up the connection to moovatom.com
+    @me = MoovAtom::MoovEngine.new @vars1
+    @url = "#{MoovAtom::API_URL}/media_search"
+    json = File.join(File.dirname(__FILE__), 'fixtures', 'media_search.json')
+    FakeWeb.register_uri(:post, "#{@url}.json", :body => json)
+    xml = File.join(File.dirname(__FILE__), 'fixtures', 'media_search.xml')
+    FakeWeb.register_uri(:post, "#{@url}.xml", :body => xml)
+  end
+
+  after do
+    # clean up the registry after each test
+    FakeWeb.clean_registry
+
+    # enable all real requests after testing
+    FakeWeb.allow_net_connect = true
+  end
+
+  it "accepts a hash to update attributes" do
+
+    # create a MoovEngine object using the values from the @vars1 hash
+    me = MoovAtom::MoovEngine.new @vars1
+
+    # call get_details() passing the hash of values from @vars2
+    me.media_search @vars2
+
+    # the instance 'me' should now contain the values from the @vars2 hash
+    @vars2.each {|k,v| me.instance_variable_get("@#{k}").must_equal v}
+  end
+
+  it "accepts a block to update attributes" do
+
+    # create a new MoovEngine object with a block using the values from @vars1
+    me = MoovAtom::MoovEngine.new do |me|
+      @vars1.each {|k,v| me.instance_variable_set "@#{k}", v}
+    end
+
+    # call get_details() passing a block that sets instance variables to the
+    # values in the @vars2 hash
+    me.media_search do |me|
+      @vars2.each {|k,v| me.instance_variable_set "@#{k}", v}
+    end
+
+    # the instance 'me' should now contain the values from the @vars2 hash
+    @vars2.each {|k,v| me.instance_variable_get("@#{k}").must_equal v}
+  end
+
+  it "sets the action attribute to media_search" do
+
+    # create a new MoovEngine object
+    me = MoovAtom::MoovEngine.new @vars1
+
+    # call the get_details() method
+    me.media_search
+
+    # after calling get_details() @action should be 'detail'
+    me.action.must_equal 'media_search'
+  end
+
+  # tests for the api call to get details about an existing video
+  describe "API Requests" do
+
+    it "searches for a video using json" do
+      @me.media_search
+      @me.response["user"].must_equal "USERNAME"
+    end
+
+    it "searches for a video using xml" do
+      @me.format = 'xml'
+      @me.media_search
+      @me.response.root.elements["user"].text.must_equal "USERNAME"
+    end
+
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: moovatom
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-20 00:00:00.000000000Z
+date: 2012-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
-  requirement: &70226432833540 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,15 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70226432833540
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
-  requirement: &70226432833120 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +37,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70226432833120
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: turn
-  requirement: &70226432832700 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +53,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70226432832700
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: fakeweb
-  requirement: &70226432832280 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,7 +69,12 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70226432832280
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: This gem defines methods for controlling your videos on MoovAtom using
   the MoovEngine API.
 email:
@@ -73,14 +93,19 @@ files:
 - lib/moovatom/version.rb
 - moovatom.gemspec
 - spec/cancel_spec.rb
+- spec/delete_spec.rb
 - spec/details_spec.rb
 - spec/encode_spec.rb
 - spec/fixtures/cancel.json
 - spec/fixtures/cancel.xml
+- spec/fixtures/delete.json
+- spec/fixtures/delete.xml
 - spec/fixtures/detail.json
 - spec/fixtures/detail.xml
 - spec/fixtures/encode.json
 - spec/fixtures/encode.xml
+- spec/fixtures/media_search.json
+- spec/fixtures/media_search.xml
 - spec/fixtures/player_error.json
 - spec/fixtures/player_error.xml
 - spec/fixtures/player_success.json
@@ -91,6 +116,7 @@ files:
 - spec/fixtures/status_success.xml
 - spec/init_spec.rb
 - spec/player_spec.rb
+- spec/search_spec.rb
 - spec/spec_helper.rb
 - spec/status_spec.rb
 homepage: http://moovatom.com
@@ -113,20 +139,25 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: moovatom
-rubygems_version: 1.8.10
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: Access MoovAtom API
 test_files:
 - spec/cancel_spec.rb
+- spec/delete_spec.rb
 - spec/details_spec.rb
 - spec/encode_spec.rb
 - spec/fixtures/cancel.json
 - spec/fixtures/cancel.xml
+- spec/fixtures/delete.json
+- spec/fixtures/delete.xml
 - spec/fixtures/detail.json
 - spec/fixtures/detail.xml
 - spec/fixtures/encode.json
 - spec/fixtures/encode.xml
+- spec/fixtures/media_search.json
+- spec/fixtures/media_search.xml
 - spec/fixtures/player_error.json
 - spec/fixtures/player_error.xml
 - spec/fixtures/player_success.json
@@ -137,5 +168,6 @@ test_files:
 - spec/fixtures/status_success.xml
 - spec/init_spec.rb
 - spec/player_spec.rb
+- spec/search_spec.rb
 - spec/spec_helper.rb
 - spec/status_spec.rb