Module: Flores::Random
- Defined in:
- lib/flores/random.rb
Overview
A collection of methods intended for use in randomized testing.
Constant Summary collapse
- CHARACTERS =
A selection of UTF-8 characters
I’d love to generate this, but I don’t yet know enough about how unicode blocks are allocated to do that. For now, hardcode a set of possible characters.
[ # Basic Latin *(32..126).map(&:chr).map { |c| c.force_encoding(Encoding.default_external) }, # hand-selected CJK Unified Ideographs Extension A "㐤", "㐨", "㐻", "㑐", # hand-selected Hebrew "א", "ב", "ג", "ד", "ה", # hand-selected Cyrillic "Є", "Б", "Р", "н", "я" ]
Class Method Summary collapse
-
.character ⇒ String
Generates a random character (A string of length 1).
-
.integer(range) ⇒ Object
Return a random integer value within a given range.
-
.ipv4 ⇒ Object
Return a random IPv4 address as a string.
-
.ipv6 ⇒ Object
Return a random IPv6 address as a string.
-
.item(array) ⇒ Object
Return a random element from an array.
-
.iterations(range, &block) ⇒ Object
Run a block a random number of times.
-
.number(range) ⇒ Object
Return a random number within a given range.
-
.tcp_listener(host = "127.0.0.1") ⇒ Object
Get a TCP socket bound and listening on a random port.
-
.text(length) ⇒ String
Generates text with random characters of a given length (or within a length range).
-
.text_range(range) ⇒ String
Generate text with random characters of a length within the given range.
-
.udp_listener(host = "127.0.0.1") ⇒ Object
Get a UDP socket bound and listening on a random port.
Class Method Details
.character ⇒ String
Generates a random character (A string of length 1)
69 70 71 |
# File 'lib/flores/random.rb', line 69 def self.character return CHARACTERS[integer(0...CHARACTERS.length)] end |
.integer(range) ⇒ Object
Return a random integer value within a given range.
76 77 78 79 |
# File 'lib/flores/random.rb', line 76 def self.integer(range) raise ArgumentError, "Range not given, got #{range.class}: #{range.inspect}" if !range.is_a?(Range) rand(range) end |
.ipv4 ⇒ Object
Return a random IPv4 address as a string
110 111 112 113 114 |
# File 'lib/flores/random.rb', line 110 def self.ipv4 # TODO(sissel): Support CIDR range restriction? # TODO(sissel): Support netmask restriction? [integer(0..IPV4_MAX)].pack("N").unpack("C4").join(".") end |
.ipv6 ⇒ Object
Return a random IPv6 address as a string
The address may be in abbreviated form (ABCD::01EF):w
119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 |
# File 'lib/flores/random.rb', line 119 def self.ipv6 # TODO(sissel): Support CIDR range restriction? # TODO(sissel): Support netmask restriction? length = integer(2..8) if length == 8 # Full address; nothing to abbreviate ipv6_pack(length) else abbreviation = ipv6_abbreviation(length) if length == 2 first = 1 second = 1 else first = integer(2...length) second = length - first end ipv6_pack(first) + abbreviation + ipv6_pack(second) end end |
.item(array) ⇒ Object
Return a random element from an array
105 106 107 |
# File 'lib/flores/random.rb', line 105 def self.item(array) array[integer(0...array.size)] end |
.iterations(range, &block) ⇒ Object
Run a block a random number of times.
94 95 96 97 98 99 100 101 102 |
# File 'lib/flores/random.rb', line 94 def self.iterations(range, &block) range = 0..range if range.is_a?(Numeric) if block_given? integer(range).times(&block) nil else integer(range).times end end |
.number(range) ⇒ Object
Return a random number within a given range.
84 85 86 87 88 89 |
# File 'lib/flores/random.rb', line 84 def self.number(range) raise ArgumentError, "Range not given, got #{range.class}: #{range.inspect}" if !range.is_a?(Range) # Ruby 1.9.3 and below do not have Enumerable#size, so we have to compute the size of the range # ourselves. rand * (range.end - range.begin) + range.begin end |
.tcp_listener(host = "127.0.0.1") ⇒ Object
Get a TCP socket bound and listening on a random port.
You are responsible for closing the socket.
Returns [socket, address, port]
144 145 146 |
# File 'lib/flores/random.rb', line 144 def self.tcp_listener(host = "127.0.0.1") socket_listener(Socket::SOCK_STREAM, host) end |
.text(length) ⇒ String
Generates text with random characters of a given length (or within a length range)
-
The length can be a number or a range ‘x..y`. If a range, it must be ascending (x < y)
-
Negative lengths are not permitted and will raise an ArgumentError
49 50 51 52 53 54 |
# File 'lib/flores/random.rb', line 49 def self.text(length) return text_range(length) if length.is_a?(Range) raise ArgumentError, "A negative length is not permitted, I received #{length}" if length < 0 length.times.collect { character }.join end |
.text_range(range) ⇒ String
Generate text with random characters of a length within the given range.
60 61 62 63 64 |
# File 'lib/flores/random.rb', line 60 def self.text_range(range) raise ArgumentError, "Requires ascending range, you gave #{range}." if range.end < range.begin raise ArgumentError, "A negative range values are not permitted, I received range #{range}" if range.begin < 0 text(integer(range)) end |
.udp_listener(host = "127.0.0.1") ⇒ Object
Get a UDP socket bound and listening on a random port.
You are responsible for closing the socket.
Returns [socket, address, port]
153 154 155 |
# File 'lib/flores/random.rb', line 153 def self.udp_listener(host = "127.0.0.1") socket_listener(Socket::SOCK_DGRAM, host) end |