herald 0.2 → 0.3

data/.gitignore

@@ -1,5 +1,6 @@
 *.gem
 .bundle
 .rvmrc
+.herald.pids
 Gemfile.lock
 pkg/*

data/History.txt

@@ -0,0 +1,18 @@
+=== HEAD (unreleased as a gem)
+
+* None
+
+=== 0.3 / 2011-05-09
+
+* Major Enhancements
+  * Added Herald::Daemon, Herald#daemonize! and Herald#kill
+  * Added herald executable
+
+* Minor Enhancements
+  * Added Herald#delete, Herald#size, updated Herald#heralds
+
+=== 0.2 / 2011-05-02
+
+* Major Enhancements
+  * Added Ping, Post Notifiers
+  * Added Webite Watcher

data/README.md

@@ -1,7 +1,7 @@
 Herald
 ====
 
-Herald is a simple notifier for Twitter and RSS.
+Herald is a simple and flexible notifier for Twitter and RSS.
 
 Pass Herald some keywords and sources to watch, and Herald will notify you using Growl, pinging or posting to a site, or running Ruby code as soon as those keywords appear.
 
@@ -16,7 +16,7 @@ Installation
 
     git clone git://github.com/lukes/herald.git
     gem build herald.gemspec
-    gem install herald-0.2.gem
+    gem install herald-0.3.gem
 
 Usage
 -----
@@ -60,7 +60,7 @@ Watching two RSS feeds and Twitter for two keywords
 Or, if sources should have different keywords
 
     Herald.watch do    
-      check :rss, :from => "http://earthquake.usgs.gov/earthquakes/catalogs/eqs1day-M0.xml"
+      check :rss, :from => "http://earthquake.usgs.gov/earthquakes/catalogs/eqs1day-M0.xml" do
         _for "christchurch"
       end
       check :twitter do
@@ -102,7 +102,7 @@ To post information about what Herald finds to a URI, pass Herald `action :post,
       _for "vanity", "tweeting"
       action :post, :uri => "http://twitter-loves-me.com/post"
     end
-    
+
 #### Callbacks
 
 If you'd like to do your own thing entirely each time a keyword appears, pass a callback in the form of a Ruby block
@@ -113,7 +113,6 @@ If you'd like to do your own thing entirely each time a keyword appears, pass a
         `say "Viva!"`
       end
     end
-    
 
 Pass the callback a parameter to be given a `Herald::Item` object within your block. The object makes available everything Herald could find in the source.
 
@@ -124,6 +123,15 @@ Pass the callback a parameter to be given a `Herald::Item` object within your bl
       end
     end
 
+#### Stdout
+
+To print information about what Herald finds, pass Herald `action :stdout`. To save results to a file, include the parameter `:file => "log.txt"`
+
+    Herald.watch_twitter do
+      _for "newsworthy", "topic"
+      action :stdout, :file => "log.txt"
+    end
+        
 ### Timer
 
 By default Herald will sleep for 1 minute after checking each of the sources independently. 
@@ -161,11 +169,21 @@ Start a second herald
 
 Use the `Herald` class methods to inspect and edit your heralds as a batch
 
-    Herald.heralds # prints all running heralds
-    Herald.stop # all heralds stopped
-    Herald.alive? # => false
+    Herald.heralds # prints all heralds (running and stopped)
+    Herald.heralds(:alive) # prints all running heralds
+    Herald.heralds(:stopped) # prints all stopped heralds
+    
+    Herald.stop # stop all heralds
+    Herald.alive? # => true if any heralds are running
     Herald.start # all heralds restarted
-            
+    
+    Herald.delete(herald) # remove this herald from the Herald.heralds list
+    Herald.delete(:stopped) # remove stopped heralds from Herald.heralds list
+    
+    Herald.size # prints number of heralds
+    Herald.size(:alive) # prints number of running heralds
+    Herald.size(:stopped) # prints number of stopped heralds
+                
 ### Look once
 
 Rather than watching, if you just want to get a single poll of keywords, use `once()`. All the same parameters as with `watch()` can be used (`every` will be ignored)
@@ -180,7 +198,7 @@ As with watching, Herald will fork a new process (or one for every source you're
     herald.start # waiting ... process ends at the same time you receive your notifications
     herald.alive? # => false
 
-### A bit about callback scope and Herald metaprogramming
+### Callback scope and Herald metaprogramming
 
 Callbacks allow a great deal of reflection into the internals of Herald.
 
@@ -203,12 +221,25 @@ If passed in within the scope of `Herald::Watcher` (`action` agents), it will ha
         end
       end
     end
+    
+### Running Herald as a script
+
+Herald cleans up after itself by killing any running herald processes on exit. 
+
+To instead have Herald run forever, add this to the end of your script
+
+    Herald.daemonize!
+
+`daemonize!` cuts the apron strings, and once set, your heralds will run forever. 
 
-### Herald binary [Not Implemented]
+Use the Herald executable below when you wish to stop your free-spirited heralds.
 
-    herald -watch twitter -for #eqnz
-    herald -once twitter -for #herald
-    herald -show-heralds
-    herald -modify 1 -watch rss -from http://example.com/.rss
-    herald -pause 1
-    herald -kill 1
+### Herald executable
+
+Print IDs of any running heralds
+
+    sudo herald --show-heralds
+    
+Pass the ID to the `kill` command to stop it running
+    
+    sudo herald --kill 1

data/TODO.txt

@@ -1,14 +1,11 @@
-- Catch and report on exceptions in @@subprocess, or thread, when exception has killed a @@subprocess, remove it from @@subprocess
-
-- Best way to require gems? Can I vendorise crack gem?
-
 - Comment in RDOC
 
 - Handle exceptions in processes, by reporting the error, then set the @subprocess to nil
 
-- Look at Gemspec
-  - Show dependency on ruby-growl if installed for mac
-  
 - Growl icon
 
-- Custom Error classes
+- Custom Error classes
+
+- Serialize heralds in Herald::Daemon as YAML herald.to_s: pid
+
+- Add support for linux and windows versions of growl

data/bin/herald

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+
+lib = File.expand_path(File.dirname(__FILE__) + '/../lib')
+$LOAD_PATH.unshift(lib) if File.directory?(lib) && !$LOAD_PATH.include?(lib)
+
+require 'herald'
+require 'herald/version'
+require 'herald/command'
+require 'slop'
+
+class Herald
+  extend Herald::Daemon
+end
+  
+opts = Slop.parse do
+  on :V, :version, 'Print the version' do
+    puts "Version #{Herald::VERSION}"
+  end
+  on :s, :"show-heralds", 'Show all running heralds'
+  on :k, :kill, 'Kill the herald', :as => :integer, :optional => true
+  on :h, :help, "Show this message"
+end
+
+opts.banner = "Usage: herald [options]"
+
+if opts[:help] || ARGV.empty?
+  puts opts.help
+  exit
+end
+
+Herald::Command.run(opts)

data/herald.gemspec

@@ -9,18 +9,19 @@ Gem::Specification.new do |s|
   s.authors     = ["Luke Duncalfe"]
   s.email       = ["lduncalfe@eml.cc"]
   s.homepage    = "http://github.com/lukes/herald"
-  s.summary     = %q{A simple notifier for Twitter, RSS, or email}
+  s.summary     = %q{A simple and flexible notifier for Twitter, RSS, or email}
   s.description = %q{A simple and flexible notifier for Twitter, RSS, or email}
 
 #  s.required_rubygems_version = ">= 1.3.6" # TODO test earliest dependency
   s.add_development_dependency("minitest")
   s.add_dependency("crack")
-  s.add_dependency("hpricot", "~> 0.8")
+  s.add_dependency("slop")
+  s.add_dependency("hpricot", ">= 0.8")
   # if gem is being installed on a mac, add a dependency on ruby-growl.
   # note, this is not a fool-proof method of detecting the OS,
   # apparently if return "java" if platform is JRuby
   if RUBY_PLATFORM.downcase.include?("darwin")
-    s.add_dependency("ruby-growl", "~> 3.0")
+    s.add_dependency("ruby-growl", ">= 2.1")
   end
 
   s.rubyforge_project = "herald"
@@ -28,7 +29,6 @@ Gem::Specification.new do |s|
 
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- test/*`.split("\n")
-#  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
-# s.default_executable = "herald"
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
 end

data/lib/herald.rb

@@ -4,12 +4,17 @@ require 'herald/watcher'
 require 'herald/notifier'
 require 'herald/notifiers/stdout'
 require 'herald/item'
+require 'herald/batch'
+require 'herald/daemon'
 
 class Herald
 
   @@heralds = []
+  @@daemon = false
   
   attr_accessor :watchers, :keep_alive, :subprocess
+  extend Herald::Batch
+  extend Herald::Daemon
 
   def self.watch(&block)
     new(&block).start
@@ -32,45 +37,32 @@ class Herald
   def self.watch_website(options = {}, &block)
     watch() { check(:website, options, &block) }
   end
-
-  # batch methods
-  def self.start
-    return false if @@heralds.empty?
-    @@heralds.each do |herald|
-      herald.start
+  
+  # returns @@heralds
+  # can optionally take :alive or :stopped
+  def self.heralds(obj = nil)
+    if !obj.nil? && obj.respond_to?(:to_sym)
+      case obj.to_sym
+      when :stopped 
+        return @@heralds.select { |h| !h.alive? }
+      when :alive 
+        return @@heralds.select { |h| h.alive? }
+      end
+      # if obj is not :stopped or :alive
+      raise ArgumentError.new("Unknown parameter #{obj}")
     end
-    true
+    @@heralds
   end
 
-  def self.stop
-    return false unless Herald.alive?
-    @@heralds.each do |herald|
-      herald.stop
-    end
-    true
-  end
-  
-  # stop all heralds, and remove them
-  # from list of herald instances. mostly
-  # useful for clearing @@heralds when testing
-  def self.clear
-    stop()
-    @@heralds.clear
-    true
-  end
-  
-  # just walk away, leaving whatever strays to themselves
-  def self.demonize!
-    @@heralds.clear
-    true
-  end
-    
-  def self.alive?
-    @@heralds.any? { |h| h.alive? }
+  def self.daemonize!
+    @@daemon = true
+    serialize_daemons()
+    puts "(Herald is now running in the background)\n"
+    self
   end
   
-  def self.heralds
-    @@heralds
+  def self.is_daemon?
+    @@daemon
   end
   
   #
@@ -135,6 +127,8 @@ class Herald
       Thread.list.each do |thread| 
         thread.join unless thread == Thread.main
       end
+      # give this process a name
+      $0 = "ruby herald"
     }
     # if herald process is persistant
     if @keep_alive
@@ -153,6 +147,7 @@ class Herald
       end
       @subprocess = nil # signal unalive state
     end
+    Herald.serialize_daemons
     self # return instance object
   end
 
@@ -161,20 +156,18 @@ class Herald
   # look at GOD
   def stop
     if @subprocess
-      begin
-        Process.kill("TERM", @subprocess)
-      # if @subprocess PID does not exist, 
-      # this will be due to an error in the subprocess
-      # which has terminated it
-      rescue Errno::ESRCH => e
-        # do nothing
-      end
+      Herald.kill(@subprocess)
     end
     @subprocess = nil
     self
   end
   alias :end :stop
-  alias :kill :stop
+  
+  def delete
+    stop if alive?
+    @@heralds.delete(self)
+    true
+  end
   
   def alive?
     !!@subprocess
@@ -194,5 +187,5 @@ end
 
 # queue a block to always stop all forked processes on exit
 at_exit do
-  Herald.stop 
+  Herald.stop unless Herald.is_daemon?
 end

data/lib/herald/batch.rb

@@ -0,0 +1,55 @@
+class Herald
+
+  # batch methods   
+  module Batch
+
+    def start
+      heralds.each do |herald|
+        herald.start
+      end
+      self
+    end
+
+    def stop
+      heralds.each do |herald|
+        herald.stop
+      end
+      self
+    end
+
+    # stop all heralds, and remove them
+    # from list of herald instances. mostly
+    # useful for clearing @@heralds when testing
+    def clear
+      stop()
+      heralds.clear
+      self
+    end
+
+    def alive?
+      heralds.any? { |h| h.alive? }
+    end
+
+    # returns size of @@heralds
+    # can optionally take :alive or :stopped
+    def size(obj = nil)
+      heralds(obj).size
+    end
+
+    # can optionally take a herald object or :stopped
+    def delete(obj = nil)
+      case
+      when obj.is_a?(Herald)
+        Array(obj)
+      else
+        heralds(obj)
+      # with the selected array of heralds
+      end.each do |h| 
+        h.delete # call each herald's delete method
+      end
+      self
+    end
+    
+  end
+  
+end

data/lib/herald/command.rb

@@ -0,0 +1,21 @@
+class Herald
+  
+  class Command
+    
+    def self.run(opts)
+      # show running heralds and exit
+      if opts[:"show-heralds"]
+        puts Herald.running_daemons
+        exit
+      end
+      # kill a herald and exit
+      if pid = opts[:kill]
+        Herald.kill(pid)
+        puts "Herald #{pid} killed"
+        exit
+      end
+    end
+    
+  end
+  
+end

data/lib/herald/daemon.rb

@@ -0,0 +1,122 @@
+class Herald
+  
+  module Daemon
+
+    #
+    # module methods:
+    #
+
+    # TODO turn this into pid_file and initialize on extended
+    @@pid_dir = nil
+
+    def self.extended(base)
+      unless File.exists?(pid_file)
+        require 'fileutils'
+        FileUtils.touch(pid_file)
+        File.chmod(0777, pid_file)
+      end
+    end
+
+    # returns location of writable .herald.pids file
+    # used to serialize daemons
+    def self.pid_file
+      @@pid_dir ||= begin
+        # select lastest installed herald gem location
+        if herald_gem_dir = Dir["#{Gem.dir}/gems/herald*"].last
+          "#{herald_gem_dir}/"
+        else
+          ""
+        end
+      end
+      "#{@@pid_dir}.herald.pids"
+    end
+
+    #
+    # mixin methods:
+    #
+
+    # kill can be passed :all, a pid, an array of pids, or a herald
+    def kill(obj)
+      pids = case
+      when obj == :all
+        serialized_daemons
+      when obj.is_a?(String) || obj.is_a?(Fixnum)
+        Array(obj)
+      when obj.is_a?(Array)
+        obj
+      when obj.is_a?(Herald)
+        Array(obj.subprocess)
+      else
+        nil
+      end
+      if pids.nil?
+        raise ArgumentError.new("Unknown parameter #{obj}")
+      end
+      pids.each do |pid|
+        begin
+          Process.kill("TERM", pid.to_i)
+        # if @subprocess PID does not exist, 
+        # this will be due to an error in the subprocess
+        # which has terminated it
+        rescue Errno::ESRCH => e
+          # do nothing
+        end
+      end
+      delete_daemons(pids)
+      self
+    end
+
+    # returns serialized daemons in .herald.pids and any unserialized ones
+    def running_daemons
+      daemons = (heralds.map{ |h| h.subprocess } + serialized_daemons).uniq
+      # whittle out any process that no longer exist
+      daemons.delete_if do |pid|
+        begin
+          Process.getpgid(pid.to_i)
+          false
+        rescue Errno::ESRCH => e
+          true
+        end
+      end
+    end
+
+    # will serialize all daemons (running in this Ruby session
+    # plus any existing ones in the file). 
+    # optionally can be passed a list of pids, in which case
+    # only these will be serialize
+    def serialize_daemons(daemons = nil)
+      # write file, truncating existing file to zero length
+      string = running_daemons.join("\n")
+      File.open(Herald::Daemon.pid_file, 'w') do |f|
+        f.write(string)
+      end
+      self
+    end
+
+    # returns pids from .herald.pids file
+    # TODO make this thread safe
+    def serialized_daemons
+      # open pid_file
+      File.open(Herald::Daemon.pid_file, 'r') do |f|
+        # read file, and map to an array of integers
+        f.read.split("\n").map do |d| 
+          next unless d.match(/^\d+\Z/)
+          d.to_i
+        end.compact
+      end
+    end
+    
+    # deletes given pids from file
+    def delete_daemons(pids)
+      pids.map! { |pid| pid.to_i }
+      lines = File.readlines(Herald::Daemon.pid_file)
+      lines.delete_if { |line| pids.include?(line.to_i) }
+      File.open(Herald::Daemon.pid_file, 'w') do |f|
+        f.write(lines)
+      end
+      self
+    end
+    
+  end
+  
+end

data/lib/herald/notifiers/stdout.rb

@@ -7,7 +7,7 @@ class Herald
         def parse_options(options)
           # option to send stdout to file
           if file = options.delete(:file)
-            $stdout = File.new(file, 'w')
+            $stdout = File.new(file, 'a')
           end
         end
         

data/lib/herald/version.rb

@@ -1,3 +1,3 @@
 class Herald
-  VERSION = "0.2"
+  VERSION = "0.3"
 end

data/lib/herald/watcher.rb

@@ -48,6 +48,9 @@ class Herald
     # parse a hash like { 120 => "seconds" }
     def every(time); 
       quantity = time.keys.first.to_i
+      if quantity < 1
+        raise ArgumentError.new("Quantity must be greater than 0")
+      end
       unit = case time.values.first
       when /^second/
         1

data/test/herald_test.rb

@@ -8,7 +8,7 @@ describe Herald do
   after do
     Herald.clear
   end
-  
+
   describe "initialisation with watchers" do
     it "must throw an acception if no 'check' param is given" do
       assert_raises(RuntimeError) do
@@ -61,6 +61,13 @@ describe Herald do
       herald.watchers.first.keywords.to_s.must_equal(keywords.to_s)
     end
   end
+  
+  describe "delete herald" do
+    it "should allow itself to be deleted" do
+      @herald.delete
+      Herald.size.must_equal(0)
+    end
+  end
 
   describe "initialisation with actions" do
     it "should assign stdout as the default Notifier" do
@@ -70,27 +77,43 @@ describe Herald do
   end
   
   describe "Herald class methods (stop, start, alive?) must allow batch operations" do
-    it "must return array of running heralds" do
+    it "must return array of heralds" do
       Herald.heralds.must_be_kind_of(Array)
       Herald.heralds.size.must_equal(1)
       Herald.heralds.first.must_be_kind_of(Herald)
       herald_2 = Herald.watch { check :twitter; _for "test" }
+      herald_2.stop
       Herald.heralds.size.must_equal(2)
+      Herald.heralds(:stopped).size.must_equal(1)
+      Herald.heralds(:alive).size.must_equal(1)
     end
-    it "must report on if there are any heralds alive" do
-      Herald.alive?.must_equal(true)
+    it "must allow heralds to be deleted by passing delete and herald object" do
+      Herald.heralds.size.must_equal(1)
+      Herald.delete(@herald)
+      Herald.size.must_equal(0)
     end
-    it "must allow heralds to be stopped" do
-      Herald.stop.must_equal(true)
+    it "must allow all stopped heralds to be deleted" do
+      Herald.size.must_equal(1)
+      Herald.delete(:stopped).size.must_equal(1)
+      @herald.stop
+      Herald.delete(:stopped).size.must_equal(0)
     end
-    it "alive? must report false if heralds exist, but none are running" do
-      Herald.stop
+    it "size() must return size of @@heralds" do
       Herald.heralds.size.must_equal(1)
-      Herald.alive?.must_equal(false)
+      herald_2 = Herald.watch { check :twitter; _for "test" }
+      herald_2.stop
+      Herald.size.must_equal(2)
+      Herald.size(:stopped).must_equal(1)
+      Herald.size(:alive).must_equal(1)
     end
-    it "must report false if heralds are told to stop, and no herald are alive" do
-      Herald.stop
-      Herald.stop.must_equal(false)
+    it "must report on if there are any heralds alive" do
+      Herald.alive?.must_equal(true)
+    end
+    it "must allow heralds to be stopped" do
+      Herald.size(:alive).must_equal(1)
+      Herald.stop.must_equal(Herald)
+      Herald.size(:alive).must_equal(0)
+      Herald.size(:stopped).must_equal(1)
     end
     it "must allow heralds to be restarted" do
       Herald.stop
@@ -100,5 +123,30 @@ describe Herald do
     
   end
 
+  describe "Must allow running as a daemon, with methods to control processes" do
+    it "must determine a location to write the pid file to" do
+      Herald::Daemon.pid_file.must_match(/\.herald\.pids\Z/)
+      File.writable?(Herald::Daemon.pid_file).must_equal(true)
+    end
+    it "must allow Herald to be daemonized" do
+      Herald.is_daemon?.must_equal(false)      
+      Herald.daemonize!.must_equal(Herald)
+      Herald.is_daemon?.must_equal(true)
+    end
+    it "must keep track of running heralds" do
+      Herald.running_daemons.size.must_equal(1)
+      Herald.watch_twitter { _for "test" }
+      Herald.running_daemons.size.must_equal(2)
+    end
+    it "Herald:#clear must delete all processes" do
+      Herald.clear.must_equal(Herald)
+      Herald.running_daemons.size.must_equal(0)
+    end
+    it "must allow you to delete pids" do
+      Herald.serialized_daemons.size.must_equal(1)
+      Herald.delete_daemons(Herald.running_daemons).must_equal(Herald)
+      Herald.serialized_daemons.size.must_equal(0)
+    end
+  end
   
 end

metadata

@@ -2,7 +2,7 @@
 name: herald
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: "0.2"
+  version: "0.3"
 platform: ruby
 authors: 
 - Luke Duncalfe
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-05-03 00:00:00 +12:00
+date: 2011-05-09 00:00:00 +12:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -36,46 +36,63 @@ dependencies:
   type: :runtime
   version_requirements: *id002
 - !ruby/object:Gem::Dependency 
-  name: hpricot
+  name: slop
   prerelease: false
   requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
-        version: "0.8"
+        version: "0"
   type: :runtime
   version_requirements: *id003
 - !ruby/object:Gem::Dependency 
-  name: ruby-growl
+  name: hpricot
   prerelease: false
   requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
-        version: "3.0"
+        version: "0.8"
   type: :runtime
   version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: ruby-growl
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "2.1"
+  type: :runtime
+  version_requirements: *id005
 description: A simple and flexible notifier for Twitter, RSS, or email
 email: 
 - lduncalfe@eml.cc
-executables: []
-
+executables: 
+- herald
 extensions: []
 
 extra_rdoc_files: 
 - README.md
 - LICENSE
 files: 
+- .gemtest
 - .gitignore
 - Gemfile
+- History.txt
 - LICENSE
 - README.md
 - Rakefile
 - TODO.txt
+- bin/herald
 - herald.gemspec
 - lib/herald.rb
+- lib/herald/batch.rb
+- lib/herald/command.rb
+- lib/herald/daemon.rb
 - lib/herald/item.rb
 - lib/herald/notifier.rb
 - lib/herald/notifiers/callback.rb
@@ -83,7 +100,6 @@ files:
 - lib/herald/notifiers/ping.rb
 - lib/herald/notifiers/post.rb
 - lib/herald/notifiers/stdout.rb
-- lib/herald/untitled.txt
 - lib/herald/version.rb
 - lib/herald/watcher.rb
 - lib/herald/watchers/rss.rb
@@ -129,7 +145,7 @@ rubyforge_project: herald
 rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
-summary: A simple notifier for Twitter, RSS, or email
+summary: A simple and flexible notifier for Twitter, RSS, or email
 test_files: 
 - test/herald_test.rb
 - test/mocks/rss.xml

data/lib/herald/untitled.txt

@@ -1,5 +0,0 @@
-require 'herald'
-herald = Herald.watch do
-  check :website, :from => "http://www.google.co.nz", :within_tags => ["#some_id", #another_id]
-  _for "search"
-end