framework_gem 0.1.0 → 0.2.0

data/lib/User_Lib/screen/stb/spectrum/spectrum_tv_shows.rb

@@ -1,1532 +0,0 @@
-require './lib/screen/stb/spectrum/spectrum_screen'
-# DO NOT ADD DSL REQUIRES HERE. Load them in methods that need them, otherwise syntax completion will be slow.
-# Defines Spectrum-specific methods on the TV Shows screen.
-class SpectrumTvShows < SpectrumScreen
-  # Public: Navigates to TV Shows from Live TV.
-  #
-  # Returns nothing.
-  def navigate_from_live_tv
-    dut.press_key.MENU(:sleep_time => 10.sec)
-    dut.press_key.ARROW_DOWN(:sleep_time => 5.sec)
-    dut.press_key.SELECT(:sleep_time => 3.sec)
-  end
-  # Public: Check if the TV Shows page is displayed.
-  #
-  # Returns Boolean true/false if TV Shows page is/is not displayed
-  def displayed?(args={})
-    return false unless dut.roi.text.tv_shows_title.displayed?(args)
-    return true
-  end
-  # Public: Navigates to TV Shows
-  #
-  #  - Type argument has some purpose.
-  #
-  # Returns nothing.
-  def nav_to_tvshow(args={})
-   dut.press_key('menu', :sleep_time=>3.sec)
-   dut.press_key('down_arrow',:sleep_time=>5.sec)
-      return dut.roi.text.tvshow_label.displayed? 
-  end
-  # Public: Navigates to a TV Shows category
-  #
-  #  category: the given name of a category
-  #  roi_text: optional. It can be a roi.text
-  #    instance or a hash with x,y,width,height
-  #    given. default: 
-  #           {:x =>65, :y =>366, :width =>721, 
-  #           :height =>66}
-  #
-  #  
-  # Notes: 
-  # ARROW_DOWN is used to navigate through
-  # all categories after selecting a menu. 
-  # Before calling this function, make sure
-  # starting from the first category.
-  #
-  # Returns true if navagate to the given 
-  # category, false if the given category
-  # is not found.
-  def nav_to_category(args={})
-    # navagate to the given category
-    result = true
-    
-    # fetch your given category
-    if args.has_key?(:category)
-      category_given = args.fetch(:category)
-    elsif args.has_key?("category")
-      category_given = args.fetch("category")
-    else
-      category_given = "All Networks"
-    end
-    # fetch your given roi.text
-    if args.has_key?(:roi_text)
-      roi_given = args.fetch(:roi_text)
-    elsif args.has_key?("roi_text")
-      roi_given = args.fetch("roi_text")
-    else
-      roi_given = nil
-    end
-    loginfo "Given category: #{category_given} given roi_text: #{roi_given}"
-    
-    # check what roi_text is
-    roi_text = {:x => 65, :y => 366, :width => 721, :height => 66}
-    if roi_given.respond_to?("info")
-      if roi_given.info.inclues?("Roi")
-        roi_text = roi_given.rectangle
-      end
-    elsif roi_given.is_a?(Hash)
-      roi_text = roi_given
-    end
-    
-    # saved_label: used to check if search is over.
-    saved_label = ""
-    con_search = true
-    while con_search do
-      category_roi = dut.roi.text.new(:rectangle=>roi_text, :text => category_given, :similarity => 80)
-      # get the current category
-      category_label = category_roi.retrieve
-      # check if the given category is found
-      con_search = !category_roi.displayed?
-      if con_search
-        if category_label != saved_label
-          con_search = !category_label.include?(category_given)
-          dut.press_key.ARROW_DOWN(:sleep_time => 3.sec)
-          saved_label = category_label
-        else
-          result = false
-          con_search = false
-        end
-      end
-    end
-  end
-  # Public: This function will format the episode and season information
-  #
-  # epi_num - info extarcted from screen
-  #
-  # Returns episode and season info .
-  def epinfo_format(epi_num) 
-  	epi_num=epi_num.to_s  
-  	loginfo"inside epinfo_format code"+epi_num
-      epi_num=epi_num.gsub("i","1")
-      epi_num=epi_num.gsub("I","1")
-      epi_num=epi_num.gsub("l","1")
-      epi_num=epi_num.gsub(" ","")
-      ind1=epi_num.index("(")
-      ind2=epi_num.index(")")
-      epi_num=epi_num[ind1+1..ind2-1]
-      inde=epi_num.index("E")
-      if inde==nil
-  	loginfo"episode index nil"	
-  	season=epi_num.delete("^0-9\s")
-  	episode="NA"
-  	
-      else
-      season=epi_num[0..inde-1]
-  	if !season.include?("S")
-  		season="S"+season[1..-1]
-  	end
-      season=season.delete("^0-9\s")
-      #chars=["51","52","53","54,","55","56","57","58","59"]
-      #chars.each do |ele|
-  	#if ele==season
-  	#   season=season.sub("5","")
-  	#end
-      #end
-      episode=epi_num[inde+1..ind2-1]
-      end 
-      loginfo " season number is "+season
-      loginfo"episode number is "+episode
-  	return season,episode
-  end
-  # Public: extract information of an episode in tv shows.
-  #
-  # Args:
-  #   pbox: poster art box of an asset. It is used to check if the asset
-  #     has a poster art present. default:
-  #     {:x=>121,:y=>498,:width=>210,:height=>122}
-  #
-  #   tbox: A rectangle used to retrieve the asset title. default:
-  #     {:x=>454,:y=>145,:width=>1380,:height=>144}
-  #
-  #   bbox: A rectangle used to retrieve the BROWSE EPISODES button. 
-  #     default:
-  #     {:x=>480,:y=>551,:width=>1044,:height=>514}
-  #
-  #   abox: A rectangle used to retrieve "Available" on the page after click
-  #     OK on asset page. default:
-  #     {:x=>604,:y=>400,:width=>698,:height=>180}
-  #
-  #
-  # Note:
-  #   All box should contain ':x', ':y', ':width', and ':height'
-  #
-  # Returns Hash. An hash for an asset information, which consists of 
-  #   the following factors:
-  #     asset_info = {
-  #            :poster=>nil,
-  #            :title=>nil,
-  #            :viewoption=>nil
-  #    }
-  def vod_tvshows_assetinfo_extract(args={})
-    # set default return and parameters
-    asset_info = {
-          :poster=>nil,
-          :title=>nil,
-          :viewoption=>nil
-          }
-    poster_box = {:x=>121,:y=>498,:width=>210,:height=>122}
-    title_box = {:x=>454,:y=>145,:width=>1380,:height=>144}
-    browse_box = {:x=>480,:y=>551,:width=>1044,:height=>514}
-    # used to check if page goes to episode availability after press OK on asset page
-    avail_box = {:x=>604,:y=>400,:width=>698,:height=>180}
-    
-    # get required parameters
-    if ! args.any?
-      loginfo "Function 'vod_tvshows_assetinfo_extract' uses default settings."
-    else
-      if args.include?(:pbox)
-        poster_box = args[:pbox]
-      end
-      if args.include?(:tbox)
-        title_box = args[:tbox]
-      end
-      if args.include?(:bbox)
-        browse_box = args[:bbox]
-      end
-      if args.include?(:abox)
-        avail_box = args[:abox]
-      end
-    end
-    
-    # check if each box is valid
-    boxes = [poster_box, title_box, browse_box, avail_box]
-    boxes.each {|bx|
-      if ! dut.screens.tv_shows.is_a_box(:box=>bx)
-        return asset_info
-      end
-    }
-    
-    # check if current page is episode availability page. 
-    # If it is, click last to be back to asset page
-    avail_text = dut.screens.tv_shows.text_in_box(:box=>avail_box)
-    if avail_text.include?("Watch")
-      dut.press_key('last', :sleep_time=>5.sec)
-    end
-    # update asset information
-    
-    # check if poster is there or not
-    background = dut.roi.black.new(:rectangle=>poster_box)
-    if background.displayed?
-      asset_info[:poster] = "NA"
-    else
-      asset_info[:poster] = "PRESENT"
-    end
-    # extract the title
-    title = dut.screens.tv_shows.text_in_box(:box=>title_box)
-    if ! title.nil?
-      title = title.delete("^A-Za-z0-9\s")
-    end
-    asset_info[:title] = title
-    
-    browse_text = dut.screens.tv_shows.text_in_box(:box=>browse_box)
-    if ! browse_text.nil?
-      browse_text = browse_text.delete("^A-Za-z0-9\s")
-    end
-    if browse_text.include?("ROW")
-      asset_info[:viewoption] = "BROWSE EPISODES"
-    elsif browse_text.include?("ATC")
-      asset_info[:viewoption] = "WATCH"
-    else
-      asset_info[:viewoption] = "NA"
-    end
-    return asset_info
-  end
-  # Public: extract provider and category of tv shows.
-  #
-  # Args:
-  #   pbox: provider box. default:
-  #     {:x=>42,:y=>334,:width=>593,:height=>117}
-  #
-  #   cbox: A rectangle used to retrieve the category. default:
-  #     {:x=>92,:y=>443,:width=>267,:height=>380}
-  #
-  # Note:
-  #   All box should contain ':x', ':y', ':width', and ':height'
-  #
-  # Returns String. Provider + category if available
-  def vod_tvshows_category_extract(args={})
-    # set default return and parameters
-    result = ""
-    # pbox: a rectangle to retrieve provider
-    pbox = {:x=>42,:y=>334,:width=>593,:height=>117}
-    # cbox: a rectangle to retrieve category
-    cbox = {:x=>92,:y=>443,:width=>267,:height=>380}
-    # get required parameters
-    if ! args.any?
-      loginfo "'vod_tvshows_category_extract' uses default settings."
-    else
-      if args.include?(:pbox)
-        pbox = args[:pbox]
-      end
-      if args.include?(:cbox)
-        cbox = args[:cbox]
-      end
-    end
-    
-    # check if each box is valid
-    boxes = [pbox, cbox]
-    boxes.each {|bx|
-      if ! dut.screens.library.is_a_box(:box=>bx)
-        return result
-      end
-    }
-    # retrieve providers and category
-    provider = dut.screens.library.text_in_box(:box=>pbox)
-    # remove special chars.
-    if (! provider.empty?) and (! provider.nil?)
-      loc = provider.include?("(") ? provider.index("(") : -1
-      if loc == 0
-        provider = "NA"
-      elsif loc > 0
-          provider = provider[0..loc-1].rstrip
-      end
-    else
-      provider = "NA"
-    end
-    # check if the first asset is a banner or a category.
-    category = ""
-    category_check = dut.screens.library.if_box_color(:similarity=>95)
-    if category_check.nil?
-      raise Exception.new("Somnething wrong when checking color.")
-    end
-    if category_check
-      category = dut.screens.library.text_in_box(:box=>cbox)
-    end
-    # remove special chars.
-    if (! category.nil?) and (! category.empty?)
-      category = category.delete("()0-9")
-    end
-    # concat provider and category with "/"
-    if  (! category.nil?) and (! category.empty?)
-      result = provider + "/"+ category
-    else
-      result = provider
-    end
-    
-    return result
-    
-  end
-  # Public: extract aaset information for asset page in tv shows.
-  #
-  # Args:
-  #   nassets: Integer. The number of assets on a row. default: 7
-  #   option : Integer. 1 = 'continuity', 0 = 'audit'. default: 0
-  #
-  # Notes:
-  #   This function needs to be called on all asset page, maybe just 
-  #   under the category page if it exists, or just the page under 
-  #   provider page if the category page does not exist.
-  #
-  # Returns Integer. The number of assets extracted
-  def vod_tvshow_assets_extract(args={})
-   
-    # default number of assets per row
-    nassets = 7
-    option = 0
-    # get required parameters
-    if ! args.any?
-      loginfo "Function 'vod_tvshow_assets_extract' uses default settings."
-    else
-      if args.include?(:nassets)
-        nassets = args[:nassets]
-      end
-      if args.include?(:option)
-        option = args[:option]
-      end
-    end
-    # validate nassets
-    if !nassets.is_a?(Integer)
-      raise ArgumentError.new("'nassets' should be an integer.")
-    end
-    # get the number of rows and number of colums of last row
-    nrows = dut.screens.library.count_assets_one_dir(:nassets=>1,:similarity=>85)
-    ncols_last_row = dut.screens.library.count_assets_one_dir(:nassets=>1,:nav_key=>"right_arrow", :similarity=>85) + 1
-    loginfo "On asset page, there are #{nrows} rows and #{ncols_last_row} cols on last row."
-    # go back to all assets page under a category
-    dut.press_key('last', :sleep_time=>5.sec)
-    dut.press_key('select', :sleep_time=>5.sec)
-   
-    # the number of assets scanned
-    ncount = 0
-    # loop for each row
-    col_nav_key = "right_arrow"
-    (0..nrows).each {|row|
-      col_nav_key = row%2==1 ? "left_arrow" : "right_arrow"
-      # for the last row of assets
-      if (row == nrows) and (ncols_last_row > 0)
-        nassets = ncols_last_row
-      end
-   
-      ntmp = dut.screens.tv_shows.vod_tvshow_assets_extract_one_row(:nav_key=>col_nav_key, :nassets=>nassets, :option=>option) rescue ntmp=0
-      ncount += ntmp
-      # got to next row.
-      if row < nrows
-        dut.press_key('down_arrow', :sleep_time=>5.sec)
-      end
-      
-    }
-    
-    return ncount
-   
-  end
-
-  # Public: check if a given rectangle area is valid which should contain ':x', ':y', ':width', and ':height'
-  #
-  # Args:
-  #   box: Hash. It should contain ':x', ':y', ':width', and ':height'
-  #
-  # Returns Bool. If invalid, return false, otherwise return true
-  def is_a_box(args={})
-      # get required parameters
-      if ! args.any?
-        loginfo "Invalid parameters, should have ':box'"
-        return false
-      else
-        if args.include?(:box)
-          box = args[:box]
-        else
-          return false
-        end
-      end
-      # check given area
-      if !box.is_a?(Hash)
-        return false
-      end
-      if !(box.include?(:x) and box.include?(:y) and box.include?(:width) and box.include?(:height))
-        loginfo "Invalid box format, which must set ':x', ':y', ':width', and ':height'"
-        return false
-      end
-      return true
-  end
-  # Public: Check if a given box is black.
-  #
-  # Args:
-  #   box: 
-  #            the rectangle area used to check if it is black
-  #            {:x=>112,:y=>702,:width=>234,:height=>112}
-  #   similarity: Integer color similarity threshold 0 - 100 (default: 90).
-  #
-  # Returns Bool. true if the box is black, otherwise false
-  #         nil if the given 'box' or 'similarity' is invalid.
-  def if_box_black(args={})
-    # set default return and parameters
-    result = nil
-    
-    # box: a rectangle to check if it fills with banner
-    box = {:x=>112,:y=>702,:width=>234,:height=>112}
-    similarity = 90
-    
-    # get required parameters
-    if ! args.any?
-      loginfo "Function 'if_box_black' uses default settings."
-    else
-      if args.include?(:box)
-        box = args[:box]
-      end
-      if args.include?(:similarity)
-        similarity = args[:similarity]
-      end
-    end
-    
-    # check if each box is valid
-    if ! dut.screens.tv_shows.is_a_box(:box=>box)
-        return result
-    end
-    # validate similarity
-    if ! (similarity.is_a?(Integer) and similarity>=0 and similarity<=100)
-      return result
-    end
-    # check if poster is there or not
-    background = dut.roi.black.new(:rectangle=>box, :blackness=>similarity)
-    if background.displayed?
-      result = true
-    else
-      result = false
-    end
-    return result
-  end
-  # Public: Check if a given box matches the given rgb color.
-  #
-  # Args:
-  #   box: 
-  #        the rectangle area used to check if it fills with a banner
-  #        {:x=>163,:y=>768,:width=>125,:height=>74}
-  #   rgb: Integer Array of 3 values (0 - 255) for red, green, blue (default: [0,41,61]).
-  #   similarity: Integer color similarity threshold 0 - 100 (default: 90).
-  #
-  # Returns Bool. true if the box is black, otherwise false
-  #         nil if the given 'box' or 'rgb' or 'similarity' is invalid
-  def if_box_color(args={})
-    # set default return and parameters
-    result = nil
-    # box: a rectangle to check if it fills with a banner
-    box = {:x=>163,:y=>768,:width=>125,:height=>74}
-    rgb = [0,41,61]
-    similarity = 90
-    # get required parameters
-    if ! args.any?
-      loginfo "Function 'if_box_color' uses default settings."
-    else
-      if args.include?(:box)
-        box = args[:box]
-      end
-      if args.include?(:rgb)
-        rgb = args[:rgb]
-      end
-      if args.include?(:similarity)
-        similarity = args[:similarity]
-      end
-    end
-    
-    # check if each box is valid
-    if ! dut.screens.tv_shows.is_a_box(:box=>box)
-        return result
-    end
-    # check if 'rgb' is valid
-    if ! dut.screens.tv_shows.rgb_validate(:rgb=>rgb)
-      return result
-    end
-    # validate similarity
-    if ! (similarity.is_a?(Integer) and similarity>=0 and similarity<=100)
-      return result
-    end
-    # check if poster is there or not
-    background = dut.roi.color.new(:rectangle=>box, :rgb=>rgb, :similarity=>similarity)
-    if background.displayed?
-      result = true
-    else
-      result = false
-    end
-    return result
-  end
-  # Public: Check if a given text is in a given box.
-  #
-  # Args:
-  #   box: Hash.
-  #        the rectangle area used to check if the
-  #        given text is in the box. default:
-  #        {:x=>63, :y=>355, :width=>308, :height=>691}
-  #
-  #   text:  String. The given string to be checked
-  #
-  # Returns Bool. If the given text is in the given area, return true, 
-  #          otherwise, return false
-  def include_in_box(args={})
-      # set default parameters
-      box={:x=>63, :y=>355, :width=>308, :height=>691}
-      text=""
-        
-      # get required parameters
-      if ! args.any?
-        loginfo "Function 'include_in_box' uses default settings."
-        return false
-      else
-        if args.include?(:text)
-          text = args[:text]
-        end
-        if args.include?(:box)
-          box = args[:box]
-        end
-      end
-      # check the given text
-      if !(text.is_a?(String) and (!text.empty?))
-        loginfo("'text' must be non-empty string.")
-        return false
-      end
-      # check given box
-      if ! dut.screens.tv_shows.is_a_box(:box=>box)
-        return false
-      end
-      # create a text roi
-      text_roi = dut.roi.text.new(:rectangle=>box)
-      retrieved_text = text_roi.retrieve
-      return retrieved_text.include?(text)
-  end
-  # Public: Retrieve text in a given box.
-  #
-  # Args:
-  #   box: Hash.
-  #            the rectangle area used to retrieve contained text.
-  #            default:
-  #            {:x=>63, :y=>355, :width=>308, :height=>691}
-  #   preprocessing: Integer or Integer Array of preprocessing options (default: 9).
-  #   similarity: Integer text similarity threshold 0 - 100 (default: 70).
-  #
-  # Returns String. The text in a given box
-  def text_in_box(args={})
-      # set default parameters
-      box={:x=>63, :y=>355, :width=>308, :height=>691}
-      similarity = 70
-      preprocessing = 8
-      # get required parameters
-      if ! args.any?
-        loginfo "Function 'text_in_box' uses default settings."
-        return ""
-      else
-        if args.include?(:box)
-          box = args[:box]
-        end
-        if args.include?(:similarity)
-          similarity = args[:similarity]
-        end
-        if args.include?(:preprocessing)
-          preprocessing = args[:preprocessing]
-        end
-      end
-      # check given box
-      if ! dut.screens.tv_shows.is_a_box(:box=>box)
-        return ""
-      end
-      # create a text roi
-      sleep 5.sec
-      text_roi = dut.roi.text.new(:rectangle=>box, :preprocessing=>preprocessing, :similarity=>similarity)
-      retrieved_text = text_roi.retrieve.gsub(/[^[:print:]]/i, " ")  rescue retrieved_text = ""
-      retrieved_text = dut.screens.tv_shows.rm_spaces(:raw_str=>retrieved_text)
-      return retrieved_text
-  end
-  # Public: Check if a given rgb is valid.
-  #
-  # Args:
-  #   rgb: Integer Array of 3 values (0 - 255) for red, green, blue.
-  #
-  # Returns Bool. true if rgb meets the requirement, otherwise false
-  def rgb_validate(args={})
-    # get required parameters
-    if ! args.any?
-      loginfo "Function 'rgb_validate' uses default settings."
-      return false
-    else
-      if args.include?(:rgb)
-        rgb = args[:rgb]
-      end
-    end
-    
-    # check if 'rgb' is valid
-    if ! rgb.is_a?(Array)
-      loginfo "Given ':rgb' should be an array with 3 integers from 0-255."
-      return false
-    else
-      if rgb.length != 3
-        loginfo "Given ':rgb' should be an array with 3 integers from 0-255."
-        return false
-      else
-        rgb.each{|aa|
-          if ! aa.is_a?(Integer)
-            loginfo "Given ':rgb' should be an array with 3 integers from 0-255."
-            return false
-          else
-            if aa<0 or aa>255
-              loginfo "Given ':rgb' should be an array with 3 integers from 0-255."
-              return false
-            end
-          end
-        }
-      end
-    end
-    return true
-  end
-
-  # Public: Count the number of assets in an asset page along one direction.
-  #
-  # Args:
-  #   nav_key: the navigation key pressed for counting. It must one 
-  #            of the navigation keys. default: "down_arrow"
-  #   box: 
-  #            the rectangle area used to check if the
-  #            image in the area changes as a key is pressed. If not 
-  #            changing, it means we are already at the buttom. default:
-  #            {:x=>75,:y=>439,:width=>1700,:height=>622}
-  #
-  #   nassets:  integer. It's the number of assets passed
-  #            when pressing the given key each time. default: 7
-  #
-  #   similarity: integer.
-  #
-  # Notes:
-  #   When counting vertically from row 0, it returns the number of assets 
-  #   where every row is fully filled. When counting horizontally from
-  #   column 0 and set nassets 1 and set the box cover the whole row, it
-  #
-  # Returns Integer. The number of assets counted when can not move.
-  #         nil if the given 'nassets' is not an integer or 'box' is invalid
-  def count_assets_one_dir(args={})
-      # set default parameters
-      nav_key="down_arrow"
-      box={:x=>75,:y=>439,:width=>1700,:height=>622}
-      nassets=7
-      similarity=95
-        
-      # get required parameters
-      if ! args.any?
-        loginfo "Function 'count_assets_one_dir' uses default settings."
-      else
-        if args.include?(:nav_key)
-          nav_key = args[:nav_key]
-        end
-        if args.include?(:box)
-          box = args[:box]
-        end
-        if args.include?(:nassets)
-          nassets = args[:nassets]
-        end
-        if args.include?(:similarity)
-          similarity = args[:similarity]
-        end
-      end
-      # check given area
-      if !dut.screens.tv_shows.is_a_box(:box=>box)
-        raise ArgumentError.new("'box' is invalid.")
-      end
-      # check if nassets is an integer
-      if !nassets.is_a?(Integer)
-        raise ArgumentError.new("'nassets' should be an integer.")
-      end
-      
-      # check if similarity is an integer
-      if !similarity.is_a?(Integer)
-        raise ArgumentError.new("'similarity' should be an integer.")
-      end
-      # count the number of time the key is pressed
-      ncount = 0
-      con_check = true
-      img_args = {
-                  :rectangle=>box, 
-                  :similarity=>similarity,
-                  :img_x=>box[:x],
-                  :img_y=>box[:y],
-                  :img_width=>box[:width],
-                  :img_height=>box[:height]
-      }
-      while con_check do
-        snap_img = dut.capture_screen
-        img_args[:ref_img] = snap_img
-        dut.press_key(nav_key, :sleep_time=>5.sec)
-        check_img = dut.roi.image.new(img_args)
-        con_check = !check_img.displayed?
-        if con_check
-          ncount = ncount + 1
-        end
-       end
-      result = ncount*nassets
-      return result
-  end
-  # Public: extract aaset information for a given row in tv shows.
-  #
-  # Args:
-  #   nassets: Integer. The number of assets on a row. default: 7
-  #   nav_key: String. The navigation key used to move to next asset.
-  #   option : Integer. 1 = 'continuity', 0 = 'audit'. default: 0
-  #
-  # Notes:
-  #   This function needs to be called on all asset page, maybe just 
-  #   under the category page if it exists, or just the page under 
-  #   provider page if the category page does not exist.
-  #
-  # Returns Integer. The number of assets extracted.
-  def vod_tvshow_assets_extract_one_row(args={})
-    
-    # default number of assets per row
-    nassets = 7
-    nav_key = "right_arrow"
-    option = 0
-    # get required parameters
-    if ! args.any?
-      loginfo "Function 'vod_tvshow_assets_extract_one_row' uses default settings."
-    else
-      if args.include?(:nassets)
-        nassets = args[:nassets]
-      end
-      if args.include?(:nav_key)
-        nav_key = args[:nav_key]
-      end
-      if args.include?(:option)
-        option = args[:option]
-      end
-    end
-    # validate nassets
-    if (!nassets.is_a?(Integer)) or (nassets<1)
-      loginfo "'nassets' should be a positive integer."
-      return 0
-    end
-    # validate the given nav_key
-    if (! nav_key.is_a?(String)) or (! ['right_arrow', 'left_arrow'].include?(nav_key))
-      loginfo "'nav_key' can only be one of ['right_arrow', 'left_arrow']."
-      return 0
-    end
-    # validate option
-    if ! [0,1].include?(option)
-      loginfo "'option' should be either 0 or 1."
-      return 0
-    end
-    # count the number of assets scanned
-    ncount = 0
-    
-    # used to check if page goes to episode availability after press OK on asset page
-    avail_box = {:x=>604,:y=>400,:width=>698,:height=>180}
-    (1..nassets).each { |ii|
-      loginfo "Processing Asset #{ii}"
-      # extract one asset info
-      dut.press_key('select', :sleep_time=>5.sec)
-      asset_info = dut.screens.tv_shows.vod_tvshows_assetinfo_extract()
-      episode_info = []
-      # if have "BROWSE EPISODES"
-      if asset_info[:viewoption].include?("BROWSE")
-        # go to episode page
-        dut.press_key('select', :sleep_time=>5.sec)
-        # check if current page is episode availability page after click OK on asset page
-        avail_text = dut.screens.tv_shows.text_in_box(:box=>avail_box)
-        # if current page is still asset, click OK to go to availability page 
-        if ! avail_text.include?("Watch")
-          dut.press_key('select', :sleep_time=>5.sec)
-        end
-        # Todo, will add  Parental Pin Lock/Onedemand PIN /Purchase Pin handling
-        dut.press_key('select', :sleep_time=>5.sec)
-        # extract episode info
-        episode_info = dut.screens.tv_shows.vod_tvshows_epinfo_extract() rescue episode_info=[]
-        # go back to the asset page
-        dut.press_key('last', :sleep_time=>5.sec)
-        
-        # check if current page is episode availability page after click LAST on episode page
-        avail_text = dut.screens.tv_shows.text_in_box(:box=>avail_box)
-        # if current page is for availability, click LAST one more time to go to asset page 
-        if avail_text.include?("Watch")
-          dut.press_key('last', :sleep_time=>5.sec)
-        end
-      end
-      # report result to twb
-      if option==0
-        dut.screens.tv_shows.vod_tvshows_assets_info_format(:asset_info=>asset_info, :episode_info=>episode_info) rescue loginfo "Asset #{ii} formatting failed."
-      elsif option==1
-        dut.screens.tv_shows.vod_tvshows_assets_info_missing_format(:asset_info=>asset_info, :episode_info=>episode_info) rescue loginfo "Asset #{ii} formatting failed."
-      end
-        
-      # go back to all assets page
-      dut.press_key('last', :sleep_time=>5.sec)
-      # move to next asset
-      if ii < nassets
-        dut.press_key(nav_key, :sleep_time=>5.sec)
-      end
-      # update ncount
-      ncount += 1
-    }
-    return ncount
-  end
-  # Public: Remove spaces in a given string.
-  #
-  # Args:
-  #   raw_str: String. The raw string requiring space removing
-  #   pattn:
-  #
-  # Returns String. A string with space removed or nil if no raw string is given.
-  def rm_spaces(args={})
-    raw_str = nil
-    # get required parameters
-    if ! args.any?
-      loginfo "Require a string."
-      return
-    else
-      if args.include?(:raw_str)
-        raw_str = args[:raw_str]
-      end
-    end
-    # remove spaces
-    raw_str = raw_str.gsub(/\s+/," ").strip
-    return raw_str
-  end
-  # Public: Check if the current page is for category
-  #
-  # Args:
-  #   box1: 
-  #            the rectangle area used to check if the
-  #            image in the area changes as a key is pressed. If not 
-  #            changing, it means we are already at the right. default:
-  #            {:x=>75,:y=>439,:width=>1700,:height=>622}
-  #   similarity: integer.
-  #   box2: 
-  #        the rectangle area used to check if it fills with a banner
-  #        {:x=>163,:y=>768,:width=>125,:height=>74}
-  #
-  #   rgb: Integer Array of 3 values (0 - 255) for red, green, blue (default: [0,41,61]).
-  #
-  #   bwidth: Integer. Banner width in pixels. default: 230 pixels
-  #
-  # Returns Boolean. true if it's category page, false otherwise
-  def vod_tvshows_category_check(args={})
-    # set default parameters
-    similarity=95
-    box1={:x=>75,:y=>439,:width=>1700,:height=>622}
-    bwidth=230
-   
-    # box: a rectangle to check if it fills with banner
-    box2 = {:x=>163,:y=>768,:width=>125,:height=>74}
-    rgb = [0,41,61]
-    
-    # get required parameters
-    if ! args.any?
-      loginfo "Function 'vod_tvshows_category_check' uses default settings."
-    else
-      if args.include?(:box1)
-        box1 = args[:box1]
-      end
-      if args.include?(:box2)
-        box2 = args[:box2]
-      end
-      if args.include?(:similarity)
-        similarity = args[:similarity]
-      end
-      if args.include?(:rgb)
-        rgb = args[:rgb]
-      end
-      if args.include?(:bwidth)
-        bwidth = args[:bwidth]
-      end
-    end
-    # check given area
-    if !dut.screens.tv_shows.is_a_box(:box=>box1)
-      raise ArgumentError.new("Invalid rectangle given.")
-    end
-    # validate similarity
-    if ! (bwidth.is_a?(Integer) and bwidth>=0)
-      raise ArgumentError.new("Asset width should be positive inetger.")
-    end
-    
-    # check if any asset in a row is a category
-    result = true
-    con_check = true
-    img_args = {
-                :rectangle=>box1, 
-                :similarity=>similarity,
-                :img_x=>box1[:x],
-                :img_y=>box1[:y],
-                :img_width=>box1[:width],
-                :img_height=>box1[:height]
-    }
-    while con_check do
-      snap_img = dut.capture_screen
-      img_args[:ref_img] = snap_img
-      category_check = dut.screens.tv_shows.if_box_color(:similarity=>similarity, :box=>box2, :rgb=>rgb)
-      # check if any asset is not a category
-      if ! category_check
-        result = category_check
-        break
-      else
-        dut.press_key("right_arrow", :sleep_time=>5.sec)
-        check_img = dut.roi.image.new(img_args)
-        con_check = !check_img.displayed?
-        box2[:x] += bwidth
-      end
-    end
-    # make sure it goes back to the first asset
-    dut.press_key("last", :sleep_time=>5.sec)
-    dut.press_key("select", :sleep_time=>5.sec)
-    return result
-    
-  end
-  # Public: check the missing episodes from test records, mainly from episode records.
-  #
-  # Args:
-  #   records: test result from function 'vod_tvshow_assets_extract'. Basically, it's 
-  #     an Array. [number of episodes, hash for episode1, hash for episdeX...]
-  #
-  # Returns Hash. key = season number, value = list of missing episodes
-  def vod_tvshows_missing_episode_extract(args={})
-    result = {}
-    records = []
-    # get required parameters
-    if ! args.any?
-      raise Exception.new("No episode records given.")
-    else
-      if args.include?(:records)
-        records = args[:records]
-      end
-    end
-    if records.empty?
-      raise Exception.new("No episode records given.")
-    end
-    nepisodes = records[0]
-    data = {}
-    # convert episode info to hash, where season number is the key, 
-    # and episode numbers are the value
-    records[1..-1].each{|rec|
-      begin
-        season = Float(rec[:season]).to_i
-        episode = Float(rec[:number]).to_i
-      rescue
-        next
-      end
-      if ! data.include?(season)
-        data[season] = [episode]
-      else
-        data[season].push(episode)
-      end
-    }
-    result = Hash[
-      data.map{|kkk,vvv|
-        # if ! (Float(kkk)!=nil rescue false)
-        #   next
-        # end
-        # vvv = vvv.grep(Numeric)
-        if vvv.length > 1
-          minv = vvv.compact.min
-          maxv = vvv.compact.max
-          missing_episodes = []
-          loginfo "Min episode #{minv}, Max episode #{maxv}"
-          all_episodes = (minv..maxv).to_a
-          all_episodes.each {|vv|
-            if ! vvv.include?(vv)
-              missing_episodes.push(vv.to_s)
-            end
-          }
-          
-          if ! missing_episodes.empty?
-            [kkk.to_s, missing_episodes]
-          end
-          
-        end
-      }
-    ]
-    return result
-  end
-  # Public: Play TV Shows
-  #
-  # Returns boolean
-  def play_tv_shows?
-  begin
-  5.times{dut.press_key('select', :sleep_time=>5.sec)}
-
-  #####################
-  ##Handles Exception##
-  #####################
-  rescue=>exception
-  loginfo "play_tv_shows :: failed"
-  loginfo exception.message
-  loginfo exception.backtrace
-  return false
-  end
-  return true
-  end
-  # Public: Audit all assets under "All Network" page and report the results
-  #
-  # Args:
-  #   name    : String. The report name twb requests. default: "TVSHOWS_AuditReport"
-  #   nassets : Integer. The number of assets per row except the last one. default: 7
-  #   networks: An array of given netwroks. default: []
-  #   option  : Integer. 1 = 'continuity', 0 = 'audit'. default: 0
-  #   
-  # Notes:
-  #   This function needs to be called aftern enter "TV Shows"
-  #
-  # Returns NA
-  def vod_tvshow_scan(args={})
-    begin
-      require "time"
-      require "fileutils"
-      
-      # set default parameters
-      ftail       = Time.new.to_s.gsub(/[\s:-]/,"_").strip.gsub(/_+/,"_")
-      start_time  = Time.now
-      option = 0
-      # default number of assets per row
-      nassets     = 7
-      # default networks
-      networks    = []
-      # default report name
-      report_name = "TVSHOWS_AuditReport"
-      
-      # get required parameters
-      if ! args.any?
-        loginfo "Default settings used."
-      else
-        if args.include?(:name)
-          report_name = args[:name]
-        end
-        if args.include?(:nassets)
-          nassets = args[:nassets]
-        end
-        if args.include?(:networks)
-          networks = args[:networks]
-        end
-        if args.include?(:option)
-          option = args[:option]
-        end
-      end
-      # validate nassets
-      if !nassets.is_a?(Integer)
-        ArgumentError.new("'nassets' should be an integer.")
-      end
-      # validate option
-      if ![0,1].include?(option)
-        ArgumentError.new("'option' should be either 0 or 1.")
-      end
-      # validate report name
-      if ! report_name.is_a?(String)
-        raise ArgumentError.new("'report_name' should be a string")
-      end
-      report_name = report_name+"_"+ftail
-      report_name.gsub!("Audit", "Contintuity") if option==1
-      
-      # twb report structure
-      $fmt = {
-        "report_name"=>report_name,
-        "progress"=> 0
-      }
-      # go to "All Networks"
-      dut.screens.tv_shows.nav_to_category
-      dut.press_key('left_arrow', :sleep_time=>5.sec)
-      dut.press_key('select', :sleep_time=>5.sec)
-      
-      # get the number of rows and number of colums of last row
-      nrows = dut.screens.tv_shows.count_assets_one_dir(:nassets=>1,:similarity=>85)
-      ncols_last_row = dut.screens.tv_shows.count_assets_one_dir(:nassets=>1,:nav_key=>"right_arrow", :similarity=>85) + 1
-      loginfo "*******************************************************"
-      loginfo "Providers. Rows: #{nrows}, ncols last row: #{ncols_last_row}"
-      loginfo "*******************************************************"
-      
-      # go back to "ALL Networks"
-      dut.press_key('last', :sleep_time=>5.sec)
-      dut.press_key('left_arrow', :sleep_time=>5.sec)
-      dut.press_key('select', :sleep_time=>5.sec)
-     
-      col_nav_key = "right_arrow"
-      # the number of assets scanned
-      ncount = 0
-      # loop for each network
-      (0..nrows).each {|row|
-        col_nav_key = row%2==1 ? "left_arrow" : "right_arrow"
-        # for the last row of providers
-        if (row == nrows) and (ncols_last_row > 0)
-          nassets = ncols_last_row
-        end
-      
-        (1..nassets).each {|inet|
-          begin
-            # set continue flag
-            continue_flag = true
-            start_time_per_network = Time.now
-            dut.press_key('select', :sleep_time=>5.sec)
-            # check if an asset is a category
-            category_check = dut.screens.tv_shows.vod_tvshows_category_check(:similarity=>95)
-            category = dut.screens.tv_shows.vod_tvshows_category_extract
-            
-            # if given networks, check if the current network name is in the given array
-            # if not, skip the current provider
-            if networks.is_a?(Array) and (! networks.empty?)
-              log_info "Given netwroks: "
-              log_info networks
-              continue_flag = false if ! networks.include?(category.split('/')[0].gsub(/\s/,'')) rescue continue_flag = false
-              continue_flag = networks.include?([row, inet]) if !continue_flag
-            end
-            loginfo "Checking (#{row}, #{inet}) network."
-            if (!category_check.nil?) and continue_flag
-              loginfo "working on network #{category}(#{row}, #{inet}), be patient..."
-              $fmt["category"] = category
-              if category_check
-                dut.press_key('select', :sleep_time=>5.sec)
-              end
-              ntmp = dut.screens.tv_shows.vod_tvshow_assets_extract(:option=>option) rescue ntmp=0
-              # ncount update
-              ncount += ntmp
-              if category_check
-                dut.press_key('last', :sleep_time=>5.sec)
-              end
-            end
-              
-            # go back to all provider page
-            dut.press_key('last', :sleep_time=>5.sec)
-            
-            if inet < nassets
-              dut.press_key(col_nav_key, :sleep_time=>5.sec)
-            end
-            loginfo "Time took for this network(sec): #{Time.now - start_time_per_network}, #{ntmp} assets scanned."
-          rescue
-            next
-          end
-        }
-        # go to next row
-        if row < nrows
-          dut.press_key('down_arrow', :sleep_time=>5.sec)
-        end
-      }
-     
-      loginfo "Total time took (hours): #{(Time.now - start_time)/60/60}, #{ncount} assets scanned."
-    rescue =>e
-      loginfo "'vod_tvshow_audit' exception: #{e.message}"
-      return false
-    end
-    return true
-  end
-
-  # Public: extract information of an episode in tv shows.
-  #
-  # Args:
-  #   lbox: list_box of episodes. It covers the episode list area and is used 
-  #     to count the number of episodes. default:
-  #     {:x=>68,:y=>417,:width=>655,:height=>658}
-  #
-  #   nbox: A rectangle used to retrieve episode name. default:
-  #     {:x=>773,:y=>492,:width=>864,:height=>74}
-  #
-  #   nbbox: A rectangle used to retrieve episode number and season number. 
-  #     default:
-  #     {:x=>773,:y=>546,:width=>178,:height=>74}
-  #
-  #   wbox: A rectangle covers the buttons. It is used to check if WATCH button
-  #     is there. default:
-  #     watch_box = {:x=>765,:y=>729,:width=>562,:height=>341}
-  #
-  #   vbox: A window to check if the episode is playable.
-  #
-  # Note:
-  #   All box should contain ':x', ':y', ':width', and ':height'
-  #
-  # Returns Array. An array for episode information. Each element of the array
-  #   is a hash, which consists of the following factors:
-  #     epi_info = {
-  #            :name=>nil,
-  #            :number=>0,
-  #            :playable=>false,
-  #            :status=>nil
-  #    }
-  def vod_tvshows_epinfo_extract(args={})
-    require '../../../../Program Files/Time Warner Cable/TMCExecutionService/rubylocation/test_cases/sandbox/log_info'
-    # set default return
-    result = []
-    list_box = {:x=>68,:y=>417,:width=>655,:height=>658}
-    name_box = {:x=>773,:y=>492,:width=>864,:height=>74}
-    numb_box = {:x=>773,:y=>546,:width=>178,:height=>74}
-    watch_box = {:x=>765,:y=>729,:width=>562,:height=>341}
-    video_box = {:x=>240,:y=>142,:width=>713,:height=>412}
-    # get required parameters
-    if ! args.any?
-      log_info "Function 'vod_tvshows_epinfo_extract' uses default settings."
-    else
-      if args.include?(:lbox)
-        list_box = args[:lbox]
-      end
-      if args.include?(:nbox)
-        name_box = args[:nbox]
-      end
-      if args.include?(:nbbox)
-        numb_box = args[:nbbox]
-      end
-      if args.include?(:wbox)
-        watch_box = args[:wbox]
-      end
-      if args.include?(:vbox)
-        video_box = args[:vbox]
-      end
-    end
-    
-    # check if each box is valid
-    boxes = [list_box, name_box, numb_box, watch_box, video_box]
-    boxes.each {|bx|
-      if ! dut.screens.tv_shows.is_a_box(:box=>bx)
-        return []
-      end
-    }
-    
-    # check if current page is in play mode
-    is_playing = dut.screens.tv_shows.text_in_box(:box=>name_box)
-    if is_playing.empty?
-      dut.press_key('stop', :sleep_time=>5.sec)
-    else
-          # take care "Unable play" prompt if any
-          unable_play = dut.screens.tv_shows.text_in_box(:box=>video_box)
-          if unable_play.include?("Unable") and unable_play.include?("sorry")
-            dut.press_key('select', :sleep_time=>5.sec)
-          end
-    end
-    
-    # get the number of episodes
-    nepisodes = dut.screens.tv_shows.count_assets_one_dir(
-      :nassets=>1,
-      :box=>list_box,
-      :similarity=>85)
-    if nepisodes>=0
-      result[0] = nepisodes + 1
-    else
-      return []
-    end
-    log_info "Total #{nepisodes+1} episodes found."
-    (0..nepisodes).each {|ii|
-      # init info for each episode
-      epi_info = {
-              :name=>nil,     
-              :number=>0,
-              :playable=>false,
-              :season=>0,
-              :status=>nil
-      }
-      # update episode information for each one
-      
-      # check if WATCH button is there
-      watch_btn = dut.screens.tv_shows.include_in_box(:text=>"WATCH", :box=>watch_box)
-      if watch_btn
-        dut.press_key.SELECT(:sleep_time=>5.sec)
-        # handle pins
-        pin_text = dut.screens.video_store.vod_handle_pin rescue pint_text=''
-        
-        # check if 'Menu is not available' show up
-        if pin_text.include?('Not Available')
-          epi_info[:playable] = 'NA'
-          epi_info[:status] = 'NA'
-          dut.press_key('last', :sleep_time=>5.sec)
-        else
-          # check if episode is playable
-          video_win = dut.roi.video.new(:rectangle=>video_box)
-          playable = video_win.displayed?(:timeout => 10000)
-          if playable
-            epi_info[:playable] = 'PLAYABLE'
-            epi_info[:status] = 'PRESENT'
-            dut.press_key('stop', :sleep_time=>5.sec)
-          else
-            epi_info[:playable] = 'NA'
-            epi_info[:status] = 'NA'
-            # take care "Unable play" prompt if any
-            unable_play = dut.screens.tv_shows.include_in_box(:text=>"Unable", :box=>video_box)
-            if unable_play
-              dut.press_key('select', :sleep_time=>5.sec)
-            end
-          end
-        end
-      else
-        # check if 'restart' is there
-        restart = dut.screens.tv_shows.include_in_box(:text=>"RESTART", :box=>watch_box)  
-        if restart
-          epi_info[:playable] = 'PLAYABLE'
-          epi_info[:status] = 'PRESENT'
-        else
-          epi_info[:playable] = 'NA'
-          epi_info[:status] = 'NA'
-        end
-      end
-      # get episode name
-      epi_name = dut.screens.tv_shows.text_in_box(:box=>name_box)
-      if ! epi_name.nil?
-        epi_name = epi_name.delete("^A-Za-z0-9\s")
-      end
-      if epi_name.empty?
-        epi_info[:name] = "NA"
-      else
-        epi_info[:name] = epi_name
-      end
-      # check episode number for each one
-      epi_num = dut.screens.tv_shows.text_in_box(:box=>numb_box).gsub(/[ilI]/,'1')
-      epi_num = epi_num.gsub(/[\s.]/,',').gsub(/,+/,',').gsub(/[Ss]/,'5')
-      if ! epi_num.nil?
-        epi_num = epi_num.delete("^0-9,")
-      end
-      
-      log_info "Retrieved episode number text #{ epi_num }"
-   
-      if (! epi_num.nil?) and (! epi_num.empty?)
-        epi_num = epi_num.split(',')
-        if epi_num.length>1
-          epi_info[:number] = epi_num[1]
-        end
-        epi_info[:season] = epi_num[0][1..-1]
-      else
-        epi_info[:number] = "NA"
-        epi_info[:season] = "NA"
-      end
-      log_info "Episode info:"
-      log_info epi_info
-      result[nepisodes+1-ii] = epi_info
-      if ii < nepisodes
-        dut.press_key.ARROW_UP(:sleep_time=>5.sec)
-      end
-    }
-    return result
-  end
-
-  # Public: Convert the test records saved in an array to the report format twb requests.
-  #
-  # Args:
-  #   images      : String. default: "{\"images\":[]}"
-  #   asset_info  : A hash kept asset information. default: {}
-  #   episode_info: An array containing episode information. deault: []
-  #
-  # Returns NA
-  def vod_tvshows_assets_info_format(args={})
-    require '../../../../Program Files/Time Warner Cable/TMCExecutionService/rubylocation/test_cases/sandbox/twb_upload_lib'
-    begin
-      # set default parameters
-      images       = "{\"images\":[]}"
-      asset_info   = {}
-      episode_info = []
-      
-      
-      # get required parameters
-      if ! args.any?
-        loginfo "Default settings used."
-        return
-      else
-        if args.include?(:asset_info)
-          asset_info = args[:asset_info]
-        end
-        if args.include?(:episode_info)
-          episode_info = args[:episode_info]
-        end
-        if args.include?(:images)
-          images = args[:images]
-        end
-      end
-      
-      # create twb upload connection
-      begin
-        twb_handler = RecordsReport.new
-        twb_handler.verbose = true
-      rescue => e
-        loginfo "TWB Connection Creating error: #{e.message}. No TWB upload."
-        twb_handler = nil
-      end
-      
-      # start formatting the data
-      $fmt["screenshots"] = images
-      $fmt["title"] = asset_info[:title]
-      $fmt["view_option"] = asset_info[:viewoption]
-      $fmt["banner_presence"] = asset_info[:poster]
-      # check if episode information is available
-      if episode_info.empty? or episode_info.length<2
-        nloop = 1
-        $fmt["quantity"] = 1
-      else
-        nloop = episode_info.length-1
-        $fmt["quantity"] = episode_info[0]
-      end
-      # loop through episode info.
-      (1..nloop).each{|inx|
-        begin
-          # if episode info is available
-          if !(episode_info.empty? or episode_info.length<2)
-            $fmt["season_number"] = episode_info[inx][:season]
-            $fmt["episode_number"] = episode_info[inx][:number]
-            $fmt["episode_name"] = episode_info[inx][:name]
-            $fmt["status"] = episode_info[inx][:status]
-            $fmt["playback_status"] = episode_info[inx][:playable]
-          end
-          # prepare the output string for the csv file
-          record = $fmt.values.join(",")+"\n"
-          append_to_file "vod_reports/"+$fmt["report_name"]+".csv", record rescue loginfo "vod_reports csv writing failed."
-          loginfo "Record #{inx}: #{record}"
-          # twb report
-          if !twb_handler.nil?
-            loginfo "Reporting to twb..."
-            twb_handler.send_one_record($fmt)
-          end
-          # update progress
-          $fmt["progress"] = 50 if $fmt["progress"]==0
-        
-        rescue => e
-          loginfo "Record formatting error. #{e.message}"
-          next
-        end
-      }
-    rescue  => e 
-      loginfo "Test record formatting error: #{e.message}."
-      return
-    end
-  end
-
-  # Public: Convert the test records saved in an array to the report format twb requests.
-  #
-  # Args:
-  #   images      : String. default: "{\"images\":[]}"
-  #   asset_info  : A hash kept asset information. default: {}
-  #   episode_info: An array containing episode information. deault: []
-  #
-  # Returns NA
-  def vod_tvshows_assets_info_missing_format(args={})
-    require '../../../../Program Files/Time Warner Cable/TMCExecutionService/rubylocation/test_cases/sandbox/twb_upload_lib'
-    # set default parameters
-    images       = "{\"images\":[]}"
-    asset_info   = {}
-    episode_info = []
-    
-    
-    # get required parameters
-    if ! args.any?
-      loginfo "Default settings used."
-      return
-    else
-      if args.include?(:asset_info)
-        asset_info = args[:asset_info]
-      end
-      if args.include?(:episode_info)
-        episode_info = args[:episode_info]
-      end
-      if args.include?(:images)
-        images = args[:images]
-      end
-    end
-    
-    # create twb upload connection
-    begin
-      twb_handler = RecordsReport.new
-      twb_handler.verbose = true
-    rescue => e
-      loginfo "TWB Connection Creating error: #{e}. No TWB upload."
-      twb_handler = nil
-    end
-    
-    $fmt["screenshots"] = images
-    $fmt["title"] = asset_info[:title]
-    $fmt["view_option"] = asset_info[:viewoption]
-    $fmt["banner_presence"] = asset_info[:poster]
-    nloop = 0
-    # check the number of available episodes
-    if ! episode_info.empty? 
-      nloop = episode_info[0]
-    else
-      loginfo "#{asset_info[:title]} has no episode information, ignored."
-      return
-    end
-    $fmt["quantity"] = nloop
-    # check the missing episodes
-    episode_info = dut.screens.tv_shows.vod_tvshows_missing_episode_extract(:records=>episode_info) rescue episode_info={}
-    # check if episode information is available
-    if episode_info.is_a?(Hash) and episode_info.any?
-      loginfo "Missing episodes: "
-      loginfo "#{episode_info}"
-    else
-      raise RuntimeError.new("Formatting error, ignored.")
-    end
-    # loop through episode info.
-    episode_info.each{|kkk, vvv|
-      if ! vvv.any?
-        next
-      end
-      vvv.each{|epi|
-        $fmt["season_number"] = kkk
-        $fmt["episode_number"] = epi
-        $fmt["status"] = "Missing"
-        # prepare the output string for the csv file
-        record = $fmt.values.join(",")+"\n"
-        append_to_file "vod_reports/"+$fmt["report_name"]+".csv", record rescue loginfo "vod_reports csv writing failed."
-        # twb report
-        if !twb_handler.nil?
-          loginfo "Reporting to twb..."
-          twb_handler.send_one_record($fmt)
-        end
-        # update progress
-        $fmt["progress"] = 50 if $fmt["progress"]==0
-      }
-    }
-  rescue => e 
-      loginfo "Test record formatting error: #{e.message}."
-      return
-  end
-
-end
- 
-