OSDN Git Service

Merge branch '201407-abnormal'
[shogi-server/shogi-server.git] / 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