my-lib 0.0.1.6 → 0.0.1.7

data/TAGS

@@ -10,19 +10,19 @@ class MyJobAnisokuMyJobAnisoku
18,554
   def tokkakaritokkakari
40,1167
   def secondsecond
61,1648
   def kobetukobetu
83,2229
-  def thirdthird
117,3586
-  def fc2fc2
154,4592
-  def videovideo
170,5064
-  def runrun
198,5957
-class MyJobDojinMyJobDojin
220,6269
-  def initialize(args = { })initialize
222,6287
-  def runrun
245,7028
-  def do_connectdo_connect
251,7073
-  def save_content(content)save_content
280,7852
-  def checkdircheckdir
288,8047
-  def file_already_saved?file_already_saved?
296,8163
-class MyJobDojinEventMachine < MyJobDojinMyJobDojinEventMachine
304,8296
-  def do_connectdo_connect
308,8354
+  def thirdthird
117,3588
+  def fc2fc2
153,4589
+  def videovideo
169,5061
+  def runrun
197,5956
+class MyJobDojinMyJobDojin
219,6268
+  def initialize(args = { })initialize
221,6286
+  def runrun
244,7027
+  def do_connectdo_connect
250,7072
+  def save_content(content)save_content
279,7851
+  def checkdircheckdir
287,8046
+  def file_already_saved?file_already_saved?
295,8162
+class MyJobDojinEventMachine < MyJobDojinMyJobDojinEventMachine
303,8295
+  def do_connectdo_connect
307,8353
 
 ,1352
 module MyMachineMyMachine
7,106
@@ -125,19 +125,19 @@ class MyJobAnisokuMyJobAnisoku
18,554
   def tokkakaritokkakari
40,1167
   def secondsecond
61,1648
   def kobetukobetu
83,2229
-  def thirdthird
117,3586
-  def fc2fc2
154,4592
-  def videovideo
170,5064
-  def runrun
198,5957
-class MyJobDojinMyJobDojin
220,6269
-  def initialize(args = { })initialize
222,6287
-  def runrun
245,7028
-  def do_connectdo_connect
251,7073
-  def save_content(content)save_content
280,7852
-  def checkdircheckdir
288,8047
-  def file_already_saved?file_already_saved?
296,8163
-class MyJobDojinEventMachine < MyJobDojinMyJobDojinEventMachine
304,8296
-  def do_connectdo_connect
308,8354
+  def thirdthird
117,3588
+  def fc2fc2
153,4589
+  def videovideo
169,5061
+  def runrun
197,5956
+class MyJobDojinMyJobDojin
219,6268
+  def initialize(args = { })initialize
221,6286
+  def runrun
244,7027
+  def do_connectdo_connect
250,7072
+  def save_content(content)save_content
279,7851
+  def checkdircheckdir
287,8046
+  def file_already_saved?file_already_saved?
295,8162
+class MyJobDojinEventMachine < MyJobDojinMyJobDojinEventMachine
303,8295
+  def do_connectdo_connect
307,8353
 
 ,1352
 module MyMachineMyMachine
7,106

data/VERSION

@@ -1 +1 @@
-0.0.1.6
+0.0.1.7

data/lib/lib/job.rb

@@ -48,10 +48,10 @@ class MyJobAnisoku
     targs.each_with_index do |link,i|
       break if i >= @a[:recent]
       job = MyJobAnisoku.new(
-        @a.merge({
-          :url => link,
-          :status => :second
-          }) )
+                             @a.merge({
+                                        :url => link,
+                                        :status => :second
+                                      }) )
       @a[:machine].retry job
     end
     
@@ -71,10 +71,10 @@ class MyJobAnisoku
     # make job for each links_kobetu
     links_kobetu.each do |link|
       job = MyJobAnisoku.new(
-        @a.merge({
-          :url => link,
-          :status => :kobetu
-        } ))
+                             @a.merge({
+                                        :url => link,
+                                        :status => :kobetu
+                                      } ))
       @a[:machine].retry job
     end
   end
@@ -86,28 +86,28 @@ class MyJobAnisoku
     title = @agent.page.title.gsub(' ★ You Tube アニ速 ★','')
     # acume url
     htmlA = @agent.page/"/html/body/table/tr[2]/td/table/tr/td[2]/div[4]/div[@class='kijisub']"
-require 'pp'
+    require 'pp'
     targsHTMLs = htmlA.inner_html.toutf8.split(/ランキング/)[0].split(/\n第/).reverse!
-#http://posterous.com/getfile/files.posterous.com/temp-2011-08-21/eolunzlwwwFopCnhszaBwJlFEJEnHcloqkoyaFuhdezmdgipcyyiyzdpqcpG/cro08nyoutube.doc
+    #http://posterous.com/getfile/files.posterous.com/temp-2011-08-21/eolunzlwwwFopCnhszaBwJlFEJEnHcloqkoyaFuhdezmdgipcyyiyzdpqcpG/cro08nyoutube.doc
     require 'digest' 
     targsHTMLs.each_with_index do |html,i|
       break if i >= @a[:limit]
       key = title + html.to_s
       unless @a[:machine].episode_exists?( Digest::MD5.hexdigest(key)  )
-#        puts "NOW 2 PROCEED FETCH".green.bold + html[0..20].yellow.bold
+        #        puts "NOW 2 PROCEED FETCH".green.bold + html[0..20].yellow.bold
         indi = Nokogiri::HTML.fragment(html).css("a")
         indi.each do |va|
           if va[:href] =~ /(http:\/\/say-move\.org\/comeplay\.php.*)/
             job = MyJobAnisoku.new(
-              @a.merge({
-                  :url => $1,
-                  :title => title + '第' + html.split('<').first.gsub(' ','').gsub('　',''),
-                  :status => :third}))
+                                   @a.merge({
+                                              :url => $1,
+                                              :title => title + '第' + html.split('<').first.gsub(' ','').gsub('　',''),
+                                              :status => :third}))
             @a[:machine].retry job
           end
         end
       else
-#        puts "CANCELL FETCH".cyan.bold + html[0..20].yellow.bold
+        #        puts "CANCELL FETCH".cyan.bold + html[0..20].yellow.bold
       end
       key = nil
     end
@@ -130,12 +130,12 @@ require 'pp'
       fc2 = set[0].value.split('&')[1].split('=')[1]
       unless fc2.nil?
         job = MyJobAnisoku.new(
-          @a.merge({
-          :url => sm[:url],
-          :fc2 => fc2,
-          :title => sm[:title],
-          :status => :fc2
-            }))
+                               @a.merge({
+                                          :url => sm[:url],
+                                          :fc2 => fc2,
+                                          :title => sm[:title],
+                                          :status => :fc2
+                                        }))
         @a[:machine].retry job
         return
       else
@@ -143,12 +143,12 @@ require 'pp'
     end
     
     job = MyJobAnisoku.new(
-      @a.merge({
-      :url => sm[:videourl],
-      :title => sm[:title],
-      :status => :video
-        }))
-     @a[:machine].retry job
+                           @a.merge({
+                                      :url => sm[:videourl],
+                                      :title => sm[:title],
+                                      :status => :video
+                                    }))
+    @a[:machine].retry job
   end
 
   def fc2
@@ -159,11 +159,11 @@ require 'pp'
     url =  url.split('&')[0].split('=')[1] + '?' + url.split('&')[1]
     puts url.red.bold
     job = MyJobAnisoku.new(
-      @a.merge({
-          :url => url,
-          :status => :video
-        }))
-     @a[:machine].retry job
+                           @a.merge({
+                                      :url => url,
+                                      :status => :video
+                                    }))
+    @a[:machine].retry job
   end
 
   #fetch video
@@ -188,9 +188,9 @@ require 'pp'
     uri = "http://#{@a[:url].host}#{@a[:url].path}"
     uri += "?#{@a[:url].query}" if @a[:url].query
     command = "curl -# -L -R -o '#{filename}' '#{uri}' "
-#    command += "&& growlnotify -t '#{filename}' -m '#{uri}' "
+    #    command += "&& growlnotify -t '#{filename}' -m '#{uri}' "
 
-#    puts command
+    #    puts command
     system command
   end
 
@@ -213,19 +213,20 @@ require 'pp'
       end
     end
   end
-  
 end
 
 
 class MyJobDojin
 
+  attr_accessor :args
+  
   def initialize(args = { })
     require 'net/http'
     @args = args
 
     #sample http://1patu.net/data/20591/preview/000.jpg
     @args[:path]   = "/data/#{@args[:book].to_s}/preview/" +
-                     sprintf("%0#{3}d", @args[:page]) + ".jpg"
+      sprintf("%0#{3}d", @args[:page]) + ".jpg"
     @args[:cookie] ||= { 'Cookie' => '1patu_view=1'}
     @args[:status] = :new
     @args[:try]    = 0
@@ -234,18 +235,20 @@ class MyJobDojin
     @args[:savebookdir] = "#{@args[:savedir].to_s}/#{@args[:book].to_s}"
     checkdir
     @args[:savepath] = "#{@args[:savebookdir]}/" +
-                       sprintf("%0#{3}d", @args[:page]) + ".jpg"
+      sprintf("%0#{3}d", @args[:page]) + ".jpg"
     @machine = @args[:machine]
 
     #debug
     @args[:debug]  ||= false
-    @args[:savepath] = '/dev/null' if @args[:debug]
+    @args[:savepath] = '/dev/null' if @args[:dryrun]
   end
 
   def run
     do_connect
   end
 
+  
+
   private
   
   def do_connect
@@ -282,6 +285,7 @@ class MyJobDojin
       io.write(content)
     end
     print "fetched:".green.bold + @args[:path]
+    @machine.savecontent(@args[:savepath])
   end
 
   # ダウンロード保存先を作る
@@ -289,7 +293,7 @@ class MyJobDojin
     begin
       Dir::mkdir(@args[:savebookdir], 0777)
     rescue => ex
-#      warn ex
+      #      warn ex
     end
   end
 
@@ -306,42 +310,50 @@ class MyJobDojinEventMachine < MyJobDojin
   private
   
   def do_connect
-    return if @machine.bookended?(@args[:book])
-    return if file_already_saved?
+      return if file_already_saved?
 
-    if @machine.connection_exceed? #コネクション限界を超えていないか？
-      @machine.retry(self)
-      return
-    end
+#      if @machine.connection_exceed? #コネクション限界を超えていないか？
+#        @machine.retry(self)
+#        print "E".red.bold
+#        return
+#      end
 
-    @machine.connection_count!
-
-    @http = EventMachine::Protocols::HttpClient.request(
-      :host => @args[:server],
-      :port => @args[:port],
-      :request => @args[:path],
-      :cookie => @args[:cookie]['Cookie']
-    )
+      @http = EventMachine::Protocols::HttpClient.
+        request(
+                :host => @args[:server],
+                :port => @args[:port],
+                :request => @args[:path],
+                :cookie => @args[:cookie]['Cookie']
+                )
+      @machine.connection_count!
+      @http.errback{
+        begin
+        ensure
+          @machine.connection_end!
+        end
+      }
 
-    @http.callback {|response|
-      @machine.connection_end!
-      if response[:status] == 200
-        # 200 はレスポンスの中身を保存する
-        save_content(response[:content])
-      elsif response[:status] == 503 ||
-            response[:status] == 500 ||
-            response[:status] == 403
-        # 503/500/403はリトライする
-        @args[:try] += 1
-        @machine.retry(self) if @args[:try] < 6
-      elsif response[:status] == 404
-        # 404は終了する
-        @machine.bookend(@args[:book])
-      else 
-        puts response[:status].to_s.red.bold
-        puts response[:headers].to_s.red.bold
-      end
-    }
+      @http.callback {|response|
+        begin
+          if response[:status] == 200
+            # 200 はレスポンスの中身を保存する
+            save_content(response[:content])
+          elsif response[:status] == 503 ||
+              response[:status] == 500 ||
+              response[:status] == 403
+            # 503/500/403はリトライする
+            @args[:try] += 1
+            @machine.retry(self) if @args[:try] < 6
+          elsif response[:status] == 404
+            # 404は終了する
+          else 
+            puts response[:status].to_s.red.bold
+            puts response[:headers].to_s.red.bold
+          end
+        ensure
+          @machine.connection_end!
+        end
+      }
   end
 end
 

data/lib/lib/machine.rb

@@ -6,10 +6,6 @@
 # this class has queue of jobs.controll jobs and run jobs
 module MyMachine
 
-  Version = "0.0.1"    
-
-  attr_accessor :queue
-
   def initialize
     require 'thread'
     @queue = Queue.new
@@ -21,7 +17,7 @@ module MyMachine
   end
 
   def go
-    puts "You need write the go method!"
+    raise "You need write the go method!"
   end
 
   def retry(job)
@@ -31,17 +27,16 @@ module MyMachine
   private
 
   def setupjobs
-    puts "You need write the setupjobs method!" 
+    puts "iF need, write the setupjobs method!" 
   end
   
   def setupmachine
-    puts "You need write the setupmachine method!"
+    puts "if need, write the setupmachine method!"
   end
 
 end
 
-
-module MyMachineDojin
+class MyEventMachineDojin
   include MyMachine
 
   def initialize(args={ })
@@ -52,83 +47,62 @@ module MyMachineDojin
     @args[:concurrency] ||= 10
     @args[:savedir] ||= "#{ENV['HOME']}/Downloads/jpg"
     @endbooks = []
-  end
-
-  def bookend(booknum)
-    @endbooks << booknum
-  end
-
-  def bookended?(booknum)
-    @endbooks.index(booknum)
-  end
-
-  private
-
-  def setupjobs
-    (0..100).each do |p|
-      (@args[:start]..@args[:stop]).each do |b|
-        job = MyDojinJob.new(
-          :server => '1patu.net',
-          :book => b,
-          :page => p,
-          :machine => self,
-          :debug  => @args[:debug] ||= false
-          )
-        @queue.push job
-      end
-    end
-  end
-end
-
-
-class MyEventMachineDojin
-  include MyMachineDojin
-
-  def initialize(args={ })
-    super args
-    # queをEventMachineで再定義
     require 'rubygems'
     require 'eventmachine'
     @connection_count = 0
+    require 'thread'
+    @connection_que = Queue.new
+    @list = []
+    @gaman = 0
   end
 
   # EventMachine用の定義
   def go
-    @a=1;@b=0;@c=0;@d=0;
     EM.run do
       EM.add_periodic_timer(0.00001) do
-        @a-@b;@b-@c;@c-@d;@d-@a
-        print 1>@a? "l".green: "l".yellow
-        print 1>@b? "o".red: "o".white
-        print 1>@c? "o".cyan: "o".green
-        print 1>@d? "o".red: "o".green
+        print "."
         EM.stop if should_stop_machine?
         if !connection_exceed?
-           @queue.pop.run unless @queue.empty?
+          unless @queue.empty?
+            job = @queue.pop
+            job.run if job
+          end
         end
       end
     end
-    p @endbooks
-    @endbooks = []
+#    p @endbooks.uniq!.sort
     puts "End of fetch".green.bold
   end
 
   def connection_exceed?
-    @args[:concurrency] <= @connection_count 
+#    @args[:concurrency] <= @connection_count 
+    @args[:concurrency] <= @connection_que.size
   end
 
   def connection_count!
-    @connection_count += 1
-    
+#    @connection_count += 1
+    @connection_que.push(:t)
   end
 
   def connection_end!
-    @connection_count -= 1
+    @connection_que.pop
+#    @connection_count -= 1
+  end
+  
+  def savecontent(path)
+    @list <<  path
   end
 
+  def write
+    open("#{@args[:savedir]}/emit.txt" ,"w") do |io|
+      io.write('["')
+      io.write(@list.sort.join('","'))
+      io.write('"]')
+    end
+  end
+  
   private
 
-  # EventMachine用に再定義
   def setupjobs
     (0..100).each do |p|
       (@args[:start]..@args[:stop]).each do |b|
@@ -145,14 +119,13 @@ class MyEventMachineDojin
     end
   end
 
-  # 何もしない
-  def setupmachine
-  end
-
   # Machineは終了すべきか？
   def should_stop_machine?
-    print " q:"+ @queue.size.to_s + "/c:" + @connection_count.to_s + " "
-      return @queue.size == 0 && @connection_count == 0
+    @gaman += 1  if @queue.size < 10
+    if @gaman > 200
+      write if @queue.size == 0
+      return true
+    end
   end
 
 end
@@ -168,8 +141,6 @@ end
 class MyMachineAnisoku
   include MyMachine
 
-  Version = "0.0.1"    
-
   # directory of save video files default "#{ENV['HOME']}/Desktop/video"
   attr_accessor :savedir
   
@@ -271,12 +242,13 @@ class MyMachineAnisoku
     puts "End of fetch".green.bold
   end
 
-
   # delete tiny fail files 
   def finalize_files
     del_small_files
     command = "find #{@savedir} -size -1000k -type f -print0| xargs -0 rm -v "
-    exec(command)
+    exec command
+    command = "find /Users/seijiro/Desktop/video -type f > ~/Desktop/video.m3u && open ~/Desktop/video.m3u "
+    exec command
   end
 
   private

data/my-lib.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{my-lib}
-  s.version = "0.0.1.6"
+  s.version = "0.0.1.7"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = [%q{modeverv}]
-  s.date = %q{2011-09-05}
+  s.date = %q{2011-09-12}
   s.description = %q{longer description of your gem}
   s.email = %q{modeverv@gmail.com}
   s.extra_rdoc_files = [

data/spec/my-lib_spec.rb

@@ -1,15 +1,16 @@
+# -*- coding:utf-8 -*-
 require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
 
 describe "MyLib" do
   it "fails" do
-#    fail "hey buddy, you should probably rename this file and start specing for real"
+#        fail "hey buddy, you should probably rename this file and start specing for real"
   end
 
   it "success" do
     ####################################################
     machine = MyMachineAnisoku.new(:savepath => "/Users/seijiro/Desktop/video")
     machine.setup
-#    machine.go
+    #    machine.go
   end
 
   it "success get syslog" do
@@ -35,9 +36,49 @@ describe "MyConfig" do
 
   it "set config file failue" do
     proc { 
-    MyConfig.dispose
-    MyConfig.set "aaaaaaaaaaa.yml"
-    p MyConfig.get
+      MyConfig.dispose
+      MyConfig.set "aaaaaaaaaaa.yml"
+      p MyConfig.get
     }.should raise_error
   end
 end
+
+
+describe "MyJobAnisoku" do
+
+  before(:each) do
+    @machine = MyMachineAnisoku.new
+    @machine.setup
+    @job = MyJobAnisoku.new(:machine => @machine)
+  end
+  
+  it "check new" do
+    #    fail
+    a = @job.a
+    fail unless a[:url] 
+    fail unless a[:status] 
+    fail unless a[:recent] 
+    fail unless a[:limit] 
+    fail unless a[:fc2magick] 
+  end
+
+  it "tokkakariを実行するとjobが増える" do
+    jobqsize = @machine.instance_eval("@queue.size")
+    p jobqsize
+    @machine.instance_eval("@queue.pop.tokkakari")
+    jobqsize2 = @machine.instance_eval("@queue.size")
+    p jobqsize2
+    fail unless jobqsize < jobqsize2
+  end
+
+  it "tokkakariを実行するとjobが増える" do
+    jobqsize = @machine.instance_eval("@queue.size")
+    p jobqsize
+    @machine.instance_eval("@queue.pop.tokkakari")
+    jobqsize2 = @machine.instance_eval("@queue.size")
+    p jobqsize2
+    fail unless jobqsize < jobqsize2
+  end
+
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: my-lib
 version: !ruby/object:Gem::Version
-  version: 0.0.1.6
+  version: 0.0.1.7
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-09-05 00:00:00.000000000Z
+date: 2011-09-12 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: term-ansicolor
-  requirement: &2157204260 !ruby/object:Gem::Requirement
+  requirement: &2151817660 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2157204260
+  version_requirements: *2151817660
 - !ruby/object:Gem::Dependency
   name: eventmachine
-  requirement: &2157201660 !ruby/object:Gem::Requirement
+  requirement: &2151816280 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2157201660
+  version_requirements: *2151816280
 - !ruby/object:Gem::Dependency
   name: mechanize
-  requirement: &2157200560 !ruby/object:Gem::Requirement
+  requirement: &2151812380 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2157200560
+  version_requirements: *2151812380
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2157186540 !ruby/object:Gem::Requirement
+  requirement: &2151810780 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>'
@@ -54,10 +54,10 @@ dependencies:
         version: 2.3.0
   type: :development
   prerelease: false
-  version_requirements: *2157186540
+  version_requirements: *2151810780
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &2157185400 !ruby/object:Gem::Requirement
+  requirement: &2151808960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>'
@@ -65,10 +65,10 @@ dependencies:
         version: 0.6.0
   type: :development
   prerelease: false
-  version_requirements: *2157185400
+  version_requirements: *2151808960
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &2157184400 !ruby/object:Gem::Requirement
+  requirement: &2151807120 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>'
@@ -76,10 +76,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *2157184400
+  version_requirements: *2151807120
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &2157183720 !ruby/object:Gem::Requirement
+  requirement: &2151805840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -87,10 +87,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2157183720
+  version_requirements: *2151805840
 - !ruby/object:Gem::Dependency
   name: rcov
-  requirement: &2157183020 !ruby/object:Gem::Requirement
+  requirement: &2151804200 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -98,10 +98,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2157183020
+  version_requirements: *2151804200
 - !ruby/object:Gem::Dependency
   name: guard
-  requirement: &2157182260 !ruby/object:Gem::Requirement
+  requirement: &2151803220 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -109,10 +109,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2157182260
+  version_requirements: *2151803220
 - !ruby/object:Gem::Dependency
   name: guard-spork
-  requirement: &2157181480 !ruby/object:Gem::Requirement
+  requirement: &2151801740 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -120,7 +120,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *2157181480
+  version_requirements: *2151801740
 description: longer description of your gem
 email: modeverv@gmail.com
 executables: []
@@ -168,7 +168,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 954184079252278975
+      hash: -1576979100048753674
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: