shogi_server/util.rb

   1 ## $Id$
   2
   3 ## Copyright (C) 2004 NABEYA Kenichi (aka nanami@2ch)
   4 ## Copyright (C) 2007-2012 Daigo Moriwaki (daigo at debian dot org)
   5 ##
   6 ## This program is free software; you can redistribute it and/or modify
   7 ## it under the terms of the GNU General Public License as published by
   8 ## the Free Software Foundation; either version 2 of the License, or
   9 ## (at your option) any later version.
  10 ##
  11 ## This program is distributed in the hope that it will be useful,
  12 ## but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 ## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 ## GNU General Public License for more details.
  15 ##
  16 ## You should have received a copy of the GNU General Public License
  17 ## along with this program; if not, write to the Free Software
  18 ## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  19
  20 require 'date'
  21 require 'fileutils'
  22 require 'pathname'
  23 require 'thread'
  24
  25 module ShogiServer
  26
  27   # Generate a random number such as i<=n<max
  28   def random(i, max)
  29     return i if i >= max
  30     return rand(max-i)+i
  31   end
  32   module_function :random
  33
  34   def shuffle(array)
  35     return if array.size < 2
  36     for i in 0...(array.size-1)
  37       r = random(i, array.size)
  38       a = array[i]
  39       array[i] = array[r]
  40       array[r] = a
  41     end
  42   end
  43   module_function :shuffle
  44
  45   # See if the file is writable. The file will be created if it does not exist
  46   # yet.
  47   # Return true if the file is writable, otherwise false.
  48   #
  49   def is_writable_file?(file)
  50     if String === file
  51       file = Pathname.new file
  52     end
  53     if file.exist?
  54       if file.file?
  55         return file.writable_real?
  56       else
  57         return false
  58       end
  59     end
  60
  61     begin
  62       file.open("w") {|fh| }
  63       file.delete
  64     rescue
  65       return false
  66     end
  67
  68     return true
  69   end
  70   module_function :is_writable_file?
  71
  72   # Convert a DateTime insntace to a Time instance.
  73   #
  74   def datetime2time(dt)
  75     return Time.mktime dt.year, dt.month, dt.day, dt.hour, dt.min, dt.sec
  76   end
  77   module_function :datetime2time
  78
  79   # Convert a Time instance to a DateTime instance
  80   #
  81   def time2datetime(time)
  82     return DateTime.new(time.year, time.mon, time.mday,
  83                         time.hour, time.min, time.sec)
  84   end
  85   module_function :time2datetime
  86
  87   # Parse string representing a day-of-week and return a coresponding
  88   # integer value: 1 (Monday) - 7 (Sunday)
  89   #
  90   def parse_dow(str)
  91     index = Date::DAYNAMES.index(str) || Date::ABBR_DAYNAMES.index(str)
  92     return nil if index.nil?
  93     return index == 0 ? 7 : index
  94   end
  95   module_function :parse_dow
  96
  97   # Mkdir in a thread-safe way.
  98   #
  99   class Mkdir
 100     @@mutex = Mutex.new
 101
 102     # Return true if a directory is successfully created or a directory
 103     # exists already; false otherwise.
 104     #
 105     # @param path a directory name of a path to be created. For example,
 106     # given /hoge/hoo/foo.txt, aim to create /hoge/hoo.
 107     def Mkdir.mkdir_for(path)
 108       unless FileTest.directory?(File.dirname(path))
 109         @@mutex.synchronize do
 110           unless FileTest.directory?(File.dirname(path))
 111             begin
 112               FileUtils.mkdir_p File.dirname(path)
 113             rescue
 114               return false
 115             end
 116           end
 117         end # mutex
 118       end
 119       return true
 120     end
 121   end # class Mkdir
 122 end