ronin-support 0.5.2 → 1.0.0.beta1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (505) hide show
  1. checksums.yaml +4 -4
  2. data/.github/workflows/ruby.yml +5 -6
  3. data/.gitignore +7 -6
  4. data/.mailmap +1 -0
  5. data/.ruby-version +1 -1
  6. data/.yardopts +0 -1
  7. data/ChangeLog.md +516 -148
  8. data/Gemfile +17 -16
  9. data/README.md +105 -50
  10. data/Rakefile +28 -8
  11. data/data/text/homoglyphs/ascii.txt +8 -0
  12. data/data/text/homoglyphs/cyrillic.txt +33 -0
  13. data/data/text/homoglyphs/full_width.txt +81 -0
  14. data/data/text/homoglyphs/greek.txt +21 -0
  15. data/data/text/homoglyphs/latin_numbers.txt +14 -0
  16. data/data/text/homoglyphs/punctuation.txt +7 -0
  17. data/data/text/patterns/network/public_suffix.rb.erb +44 -0
  18. data/examples/ssl_proxy.rb +38 -0
  19. data/examples/tcp_proxy.rb +41 -0
  20. data/gemspec.yml +14 -13
  21. data/lib/ronin/support/archive/core_ext/file.rb +118 -0
  22. data/lib/ronin/{formatting/sql.rb → support/archive/core_ext.rb} +3 -4
  23. data/lib/ronin/support/archive/mixin.rb +213 -0
  24. data/lib/ronin/support/archive/tar/reader.rb +135 -0
  25. data/lib/ronin/support/archive/tar/writer.rb +197 -0
  26. data/lib/ronin/support/archive/tar.rb +155 -0
  27. data/lib/ronin/support/archive/zip/reader/entry.rb +134 -0
  28. data/lib/ronin/support/archive/zip/reader/statistics.rb +76 -0
  29. data/lib/ronin/support/archive/zip/reader.rb +273 -0
  30. data/lib/ronin/support/archive/zip/writer.rb +175 -0
  31. data/lib/ronin/support/archive/zip.rb +105 -0
  32. data/lib/ronin/support/archive.rb +211 -0
  33. data/lib/ronin/support/binary/array.rb +255 -0
  34. data/lib/ronin/support/binary/bit_flip.rb +147 -0
  35. data/lib/ronin/support/binary/buffer.rb +2027 -0
  36. data/lib/ronin/support/binary/byte_slice.rb +324 -0
  37. data/lib/ronin/{formatting/extensions/binary → support/binary/core_ext}/array.rb +25 -11
  38. data/lib/ronin/support/binary/core_ext/float.rb +80 -0
  39. data/lib/ronin/support/binary/core_ext/integer.rb +305 -0
  40. data/lib/ronin/support/binary/core_ext/io.rb +38 -0
  41. data/lib/ronin/support/binary/core_ext/string.rb +115 -0
  42. data/lib/ronin/{formatting/extensions/text.rb → support/binary/core_ext.rb} +6 -6
  43. data/lib/ronin/support/binary/cstring.rb +259 -0
  44. data/lib/ronin/support/binary/ctypes/aggregate_type.rb +98 -0
  45. data/lib/ronin/support/binary/ctypes/arch/arm/big_endian.rb +77 -0
  46. data/lib/ronin/support/binary/ctypes/arch/arm.rb +75 -0
  47. data/lib/ronin/support/binary/ctypes/arch/arm64/big_endian.rb +77 -0
  48. data/lib/ronin/support/binary/ctypes/arch/arm64.rb +75 -0
  49. data/lib/ronin/support/binary/ctypes/arch/mips/little_endian.rb +77 -0
  50. data/lib/ronin/support/binary/ctypes/arch/mips.rb +75 -0
  51. data/lib/ronin/support/binary/ctypes/arch/mips64/little_endian.rb +77 -0
  52. data/lib/ronin/support/binary/ctypes/arch/mips64.rb +75 -0
  53. data/lib/ronin/support/binary/ctypes/arch/ppc.rb +75 -0
  54. data/lib/ronin/support/binary/ctypes/arch/ppc64.rb +75 -0
  55. data/lib/ronin/support/binary/ctypes/arch/x86.rb +75 -0
  56. data/lib/ronin/support/binary/ctypes/arch/x86_64.rb +75 -0
  57. data/lib/ronin/support/binary/ctypes/arch.rb +30 -0
  58. data/lib/ronin/support/binary/ctypes/array_object_type.rb +164 -0
  59. data/lib/ronin/support/binary/ctypes/array_type.rb +232 -0
  60. data/lib/ronin/support/binary/ctypes/big_endian.rb +195 -0
  61. data/lib/ronin/support/binary/ctypes/char_type.rb +59 -0
  62. data/lib/ronin/support/binary/ctypes/char_types.rb +39 -0
  63. data/lib/ronin/support/binary/ctypes/enum_type.rb +181 -0
  64. data/lib/ronin/support/binary/ctypes/float32_type.rb +50 -0
  65. data/lib/ronin/support/binary/ctypes/float64_type.rb +50 -0
  66. data/lib/ronin/support/binary/ctypes/float_type.rb +62 -0
  67. data/lib/ronin/support/binary/ctypes/int16_type.rb +50 -0
  68. data/lib/ronin/support/binary/ctypes/int32_type.rb +50 -0
  69. data/lib/ronin/support/binary/ctypes/int64_type.rb +50 -0
  70. data/lib/ronin/support/{support.rb → binary/ctypes/int8_type.rb} +20 -21
  71. data/lib/ronin/support/binary/ctypes/int_type.rb +62 -0
  72. data/lib/ronin/support/binary/ctypes/little_endian.rb +195 -0
  73. data/lib/ronin/support/binary/ctypes/mixin.rb +135 -0
  74. data/lib/ronin/support/binary/ctypes/native.rb +205 -0
  75. data/lib/ronin/support/binary/ctypes/network.rb +29 -0
  76. data/lib/ronin/support/binary/ctypes/object_type.rb +55 -0
  77. data/lib/ronin/support/binary/ctypes/os/bsd.rb +65 -0
  78. data/lib/ronin/support/binary/ctypes/os/freebsd.rb +215 -0
  79. data/lib/ronin/support/binary/ctypes/os/linux.rb +193 -0
  80. data/lib/ronin/support/binary/ctypes/os/macos.rb +151 -0
  81. data/lib/ronin/support/binary/ctypes/os/netbsd.rb +147 -0
  82. data/lib/ronin/support/binary/ctypes/os/openbsd.rb +168 -0
  83. data/lib/ronin/support/binary/ctypes/os/unix.rb +78 -0
  84. data/lib/ronin/support/binary/ctypes/os/windows.rb +125 -0
  85. data/lib/ronin/support/binary/ctypes/os.rb +125 -0
  86. data/lib/ronin/support/binary/ctypes/scalar_type.rb +200 -0
  87. data/lib/ronin/support/binary/ctypes/string_type.rb +143 -0
  88. data/lib/ronin/support/binary/ctypes/struct_object_type.rb +173 -0
  89. data/lib/ronin/support/binary/ctypes/struct_type.rb +359 -0
  90. data/lib/ronin/support/binary/ctypes/type.rb +193 -0
  91. data/lib/ronin/support/binary/ctypes/type_resolver.rb +206 -0
  92. data/lib/ronin/support/binary/ctypes/uint16_type.rb +50 -0
  93. data/lib/ronin/support/binary/ctypes/uint32_type.rb +50 -0
  94. data/lib/ronin/support/binary/ctypes/uint64_type.rb +50 -0
  95. data/lib/ronin/support/binary/ctypes/uint8_type.rb +41 -0
  96. data/lib/ronin/support/binary/ctypes/uint_type.rb +59 -0
  97. data/lib/ronin/support/binary/ctypes/unbounded_array_type.rb +258 -0
  98. data/lib/ronin/support/binary/ctypes/union_object_type.rb +173 -0
  99. data/lib/ronin/support/binary/ctypes/union_type.rb +261 -0
  100. data/lib/ronin/support/binary/ctypes.rb +462 -0
  101. data/lib/ronin/support/binary/hexdump/core_ext/file.rb +118 -0
  102. data/lib/ronin/support/binary/hexdump/core_ext/string.rb +115 -0
  103. data/lib/ronin/support/binary/hexdump/core_ext.rb +20 -0
  104. data/lib/ronin/support/binary/hexdump/parser.rb +492 -0
  105. data/lib/ronin/support/binary/hexdump.rb +20 -0
  106. data/lib/ronin/support/binary/memory.rb +268 -0
  107. data/lib/ronin/support/binary/packet.rb +33 -0
  108. data/lib/ronin/support/binary/stack.rb +256 -0
  109. data/lib/ronin/support/binary/stream/methods.rb +1755 -0
  110. data/lib/ronin/support/binary/stream.rb +151 -0
  111. data/lib/ronin/support/binary/struct/member.rb +86 -0
  112. data/lib/ronin/support/binary/struct.rb +830 -0
  113. data/lib/ronin/support/binary/template.rb +284 -0
  114. data/lib/ronin/support/binary/union.rb +162 -0
  115. data/lib/ronin/{formatting/extensions → support}/binary.rb +10 -10
  116. data/lib/ronin/support/cli/ansi.rb +330 -0
  117. data/lib/ronin/support/cli/io_shell/core_ext/io.rb +67 -0
  118. data/lib/ronin/{extensions/meta.rb → support/cli/io_shell/core_ext.rb} +3 -4
  119. data/lib/ronin/support/cli/io_shell.rb +161 -0
  120. data/lib/ronin/support/cli/printing.rb +216 -0
  121. data/lib/ronin/support/cli.rb +20 -0
  122. data/lib/ronin/support/compression/core_ext/file.rb +70 -0
  123. data/lib/ronin/support/compression/core_ext/string.rb +101 -0
  124. data/lib/ronin/{fuzzing/extensions.rb → support/compression/core_ext.rb} +3 -4
  125. data/lib/ronin/support/compression/gzip/reader.rb +70 -0
  126. data/lib/ronin/support/compression/gzip/writer.rb +74 -0
  127. data/lib/ronin/support/compression/gzip.rb +105 -0
  128. data/lib/ronin/support/compression/mixin.rb +180 -0
  129. data/lib/ronin/{network/extensions/esmtp/net.rb → support/compression/zlib.rb} +6 -7
  130. data/lib/ronin/support/compression.rb +174 -0
  131. data/lib/ronin/{extensions → support/core_ext}/enumerable.rb +2 -3
  132. data/lib/ronin/{extensions → support/core_ext}/file.rb +2 -31
  133. data/lib/ronin/support/core_ext/integer.rb +37 -0
  134. data/lib/ronin/support/core_ext/ipaddr.rb +65 -0
  135. data/lib/ronin/{extensions → support/core_ext}/kernel.rb +7 -6
  136. data/lib/ronin/{extensions → support/core_ext}/resolv.rb +2 -25
  137. data/lib/ronin/{extensions → support/core_ext}/string.rb +114 -54
  138. data/lib/ronin/support/core_ext.rb +33 -0
  139. data/lib/ronin/support/crypto/cert.rb +522 -0
  140. data/lib/ronin/support/crypto/cert_chain.rb +204 -0
  141. data/lib/ronin/support/crypto/cipher/aes.rb +71 -0
  142. data/lib/ronin/support/crypto/cipher/aes128.rb +54 -0
  143. data/lib/ronin/support/crypto/cipher/aes256.rb +54 -0
  144. data/lib/ronin/support/crypto/cipher.rb +194 -0
  145. data/lib/ronin/support/crypto/core_ext/file.rb +660 -0
  146. data/lib/ronin/support/crypto/core_ext/string.rb +548 -0
  147. data/lib/ronin/{binary.rb → support/crypto/core_ext.rb} +4 -5
  148. data/lib/ronin/{network/mixins/mixin.rb → support/crypto/hmac.rb} +18 -28
  149. data/lib/ronin/support/crypto/key/dh.rb +122 -0
  150. data/lib/ronin/support/crypto/key/dsa.rb +103 -0
  151. data/lib/ronin/support/crypto/key/ec.rb +99 -0
  152. data/lib/ronin/support/crypto/key/methods.rb +163 -0
  153. data/lib/ronin/support/crypto/key/rsa.rb +169 -0
  154. data/lib/ronin/support/crypto/key.rb +105 -0
  155. data/lib/ronin/support/crypto/mixin.rb +620 -0
  156. data/lib/ronin/{network/extensions/http/net.rb → support/crypto/openssl.rb} +6 -7
  157. data/lib/ronin/support/crypto.rb +779 -0
  158. data/lib/ronin/support/encoding/base16/core_ext/string.rb +63 -0
  159. data/lib/ronin/{formatting/binary.rb → support/encoding/base16/core_ext.rb} +3 -4
  160. data/lib/ronin/support/encoding/base16.rb +82 -0
  161. data/lib/ronin/support/encoding/base32/core_ext/string.rb +63 -0
  162. data/lib/ronin/support/encoding/base32/core_ext.rb +19 -0
  163. data/lib/ronin/support/encoding/base32.rb +164 -0
  164. data/lib/ronin/support/encoding/base64/core_ext/string.rb +76 -0
  165. data/lib/ronin/support/encoding/base64/core_ext.rb +19 -0
  166. data/lib/ronin/support/encoding/base64.rb +78 -0
  167. data/lib/ronin/support/encoding/c/core_ext/integer.rb +82 -0
  168. data/lib/ronin/support/encoding/c/core_ext/string.rb +125 -0
  169. data/lib/ronin/support/encoding/c/core_ext.rb +20 -0
  170. data/lib/ronin/support/encoding/c.rb +277 -0
  171. data/lib/ronin/support/encoding/core_ext/string.rb +107 -0
  172. data/lib/ronin/support/encoding/core_ext.rb +33 -0
  173. data/lib/ronin/support/encoding/hex/core_ext/integer.rb +82 -0
  174. data/lib/ronin/support/encoding/hex/core_ext/string.rb +133 -0
  175. data/lib/ronin/support/encoding/hex/core_ext.rb +22 -0
  176. data/lib/ronin/support/encoding/hex.rb +248 -0
  177. data/lib/ronin/support/encoding/html/core_ext/integer.rb +106 -0
  178. data/lib/ronin/support/encoding/html/core_ext/string.rb +130 -0
  179. data/lib/ronin/support/encoding/html/core_ext.rb +20 -0
  180. data/lib/ronin/support/encoding/html.rb +233 -0
  181. data/lib/ronin/support/encoding/http/core_ext/integer.rb +95 -0
  182. data/lib/ronin/support/encoding/http/core_ext/string.rb +129 -0
  183. data/lib/ronin/support/encoding/http/core_ext.rb +20 -0
  184. data/lib/ronin/support/encoding/http.rb +241 -0
  185. data/lib/ronin/support/encoding/js/core_ext/integer.rb +67 -0
  186. data/lib/ronin/support/encoding/js/core_ext/string.rb +125 -0
  187. data/lib/ronin/support/encoding/js/core_ext.rb +20 -0
  188. data/lib/ronin/support/encoding/js.rb +279 -0
  189. data/lib/ronin/support/encoding/powershell/core_ext/integer.rb +87 -0
  190. data/lib/ronin/support/encoding/powershell/core_ext/string.rb +145 -0
  191. data/lib/ronin/support/encoding/powershell/core_ext.rb +20 -0
  192. data/lib/ronin/support/encoding/powershell.rb +297 -0
  193. data/lib/ronin/{formatting/extensions/http/integer.rb → support/encoding/punycode/core_ext/string.rb} +23 -29
  194. data/lib/ronin/support/encoding/punycode/core_ext.rb +19 -0
  195. data/lib/ronin/support/encoding/punycode.rb +76 -0
  196. data/lib/ronin/support/encoding/quoted_printable/core_ext/string.rb +75 -0
  197. data/lib/ronin/support/encoding/quoted_printable/core_ext.rb +19 -0
  198. data/lib/ronin/support/encoding/quoted_printable.rb +102 -0
  199. data/lib/ronin/support/encoding/ruby/core_ext/string.rb +129 -0
  200. data/lib/ronin/support/encoding/ruby/core_ext.rb +19 -0
  201. data/lib/ronin/support/encoding/ruby.rb +235 -0
  202. data/lib/ronin/support/encoding/shell/core_ext/integer.rb +89 -0
  203. data/lib/ronin/support/encoding/shell/core_ext/string.rb +134 -0
  204. data/lib/ronin/support/encoding/shell/core_ext.rb +20 -0
  205. data/lib/ronin/support/encoding/shell.rb +293 -0
  206. data/lib/ronin/{network/extensions → support/encoding}/smtp.rb +4 -4
  207. data/lib/ronin/support/encoding/sql/core_ext/string.rb +114 -0
  208. data/lib/ronin/{formatting/html.rb → support/encoding/sql/core_ext.rb} +3 -4
  209. data/lib/ronin/support/encoding/sql.rb +124 -0
  210. data/lib/ronin/support/encoding/uri/core_ext/integer.rb +149 -0
  211. data/lib/ronin/support/encoding/uri/core_ext/string.rb +195 -0
  212. data/lib/ronin/support/encoding/uri/core_ext.rb +20 -0
  213. data/lib/ronin/support/encoding/uri.rb +424 -0
  214. data/lib/ronin/support/encoding/uuencoding/core_ext/string.rb +73 -0
  215. data/lib/ronin/support/encoding/uuencoding/core_ext.rb +19 -0
  216. data/lib/ronin/support/encoding/uuencoding.rb +70 -0
  217. data/lib/ronin/support/encoding/xml/core_ext/integer.rb +100 -0
  218. data/lib/ronin/support/encoding/xml/core_ext/string.rb +124 -0
  219. data/lib/ronin/support/encoding/xml/core_ext.rb +20 -0
  220. data/lib/ronin/support/encoding/xml.rb +328 -0
  221. data/lib/ronin/support/encoding.rb +46 -0
  222. data/lib/ronin/support/home.rb +88 -0
  223. data/lib/ronin/{network/network.rb → support/mixin.rb} +17 -20
  224. data/lib/ronin/support/network/asn/dns_record.rb +112 -0
  225. data/lib/ronin/support/network/asn/list.rb +269 -0
  226. data/lib/ronin/support/network/asn/record.rb +164 -0
  227. data/lib/ronin/support/network/asn/record_set.rb +226 -0
  228. data/lib/ronin/support/network/asn.rb +88 -0
  229. data/lib/ronin/{binary/hexdump.rb → support/network/core_ext.rb} +3 -4
  230. data/lib/ronin/support/network/dns/idn.rb +38 -0
  231. data/lib/ronin/support/network/dns/mixin.rb +941 -0
  232. data/lib/ronin/support/network/dns/resolver.rb +707 -0
  233. data/lib/ronin/support/network/dns.rb +1109 -0
  234. data/lib/ronin/support/network/domain.rb +70 -0
  235. data/lib/ronin/support/network/email_address.rb +574 -0
  236. data/lib/ronin/support/network/esmtp/mixin.rb +115 -0
  237. data/lib/ronin/support/network/exceptions.rb +43 -0
  238. data/lib/ronin/support/network/ftp/mixin.rb +106 -0
  239. data/lib/ronin/support/network/host.rb +1473 -0
  240. data/lib/ronin/support/network/http/cookie.rb +245 -0
  241. data/lib/ronin/support/network/http/core_ext/uri/http.rb +63 -0
  242. data/lib/ronin/support/network/http/core_ext.rb +19 -0
  243. data/lib/ronin/support/network/http/mixin.rb +890 -0
  244. data/lib/ronin/support/network/http/request.rb +215 -0
  245. data/lib/ronin/support/network/http/set_cookie.rb +210 -0
  246. data/lib/ronin/support/network/http/user_agents.rb +115 -0
  247. data/lib/ronin/support/network/http.rb +2582 -0
  248. data/lib/ronin/support/network/imap/mixin.rb +133 -0
  249. data/lib/ronin/support/network/ip/mixin.rb +114 -0
  250. data/lib/ronin/support/network/ip.rb +540 -0
  251. data/lib/ronin/support/network/ip_range/cidr.rb +252 -0
  252. data/lib/ronin/support/network/ip_range/glob.rb +309 -0
  253. data/lib/ronin/support/network/ip_range/range.rb +249 -0
  254. data/lib/ronin/support/network/ip_range.rb +284 -0
  255. data/lib/ronin/support/network/mixin.rb +58 -0
  256. data/lib/ronin/support/network/packet.rb +27 -0
  257. data/lib/ronin/support/network/pop3/mixin.rb +113 -0
  258. data/lib/ronin/support/network/proxy.rb +602 -0
  259. data/lib/ronin/support/network/public_suffix/list.rb +339 -0
  260. data/lib/ronin/support/network/public_suffix/suffix.rb +118 -0
  261. data/lib/ronin/support/network/public_suffix/suffix_set.rb +150 -0
  262. data/lib/ronin/support/network/public_suffix.rb +41 -0
  263. data/lib/ronin/support/network/smtp/email.rb +190 -0
  264. data/lib/ronin/support/network/smtp/mixin.rb +290 -0
  265. data/lib/ronin/support/network/smtp.rb +19 -0
  266. data/lib/ronin/support/network/ssl/local_cert.rb +114 -0
  267. data/lib/ronin/support/network/ssl/local_key.rb +84 -0
  268. data/lib/ronin/support/network/ssl/mixin.rb +740 -0
  269. data/lib/ronin/{network/extensions/imap/net.rb → support/network/ssl/openssl.rb} +6 -7
  270. data/lib/ronin/support/network/ssl/proxy.rb +296 -0
  271. data/lib/ronin/support/network/ssl.rb +173 -0
  272. data/lib/ronin/support/network/tcp/mixin.rb +400 -0
  273. data/lib/ronin/support/network/tcp/proxy.rb +435 -0
  274. data/lib/ronin/support/network/tcp.rb +443 -0
  275. data/lib/ronin/support/network/telnet/mixin.rb +150 -0
  276. data/lib/ronin/support/network/telnet.rb +90 -0
  277. data/lib/ronin/support/network/tld/list.rb +266 -0
  278. data/lib/ronin/support/network/tld.rb +41 -0
  279. data/lib/ronin/support/network/tls/mixin.rb +670 -0
  280. data/lib/ronin/support/network/tls/proxy.rb +135 -0
  281. data/lib/ronin/{network/mixins/dns.rb → support/network/tls.rb} +23 -25
  282. data/lib/ronin/support/network/udp/mixin.rb +389 -0
  283. data/lib/ronin/support/network/udp/proxy.rb +192 -0
  284. data/lib/ronin/support/network/udp.rb +435 -0
  285. data/lib/ronin/support/network/unix/mixin.rb +273 -0
  286. data/lib/ronin/support/network.rb +37 -0
  287. data/lib/ronin/support/path.rb +136 -0
  288. data/lib/ronin/{network/extensions/dns/net.rb → support/text/core_ext/regexp.rb} +5 -6
  289. data/lib/ronin/support/text/core_ext/string.rb +46 -0
  290. data/lib/ronin/{formatting.rb → support/text/core_ext.rb} +7 -9
  291. data/lib/ronin/support/text/entropy/core_ext/string.rb +45 -0
  292. data/lib/ronin/{formatting/http.rb → support/text/entropy/core_ext.rb} +3 -4
  293. data/lib/ronin/support/text/entropy.rb +66 -0
  294. data/lib/ronin/support/text/erb/mixin.rb +44 -0
  295. data/lib/ronin/support/text/erb.rb +19 -0
  296. data/lib/ronin/support/text/homoglyph/core_ext/string.rb +108 -0
  297. data/lib/ronin/{formatting/digest.rb → support/text/homoglyph/core_ext.rb} +3 -4
  298. data/lib/ronin/{network/http/exceptions/unknown_request.rb → support/text/homoglyph/exceptions.rb} +7 -6
  299. data/lib/ronin/support/text/homoglyph/table.rb +228 -0
  300. data/lib/ronin/support/text/homoglyph.rb +142 -0
  301. data/lib/ronin/support/text/mixin.rb +31 -0
  302. data/lib/ronin/support/text/patterns/credentials.rb +75 -0
  303. data/lib/ronin/support/text/patterns/crypto.rb +67 -0
  304. data/lib/ronin/support/text/patterns/file_system.rb +93 -0
  305. data/lib/ronin/support/text/patterns/language.rb +37 -0
  306. data/lib/ronin/support/text/patterns/network/public_suffix.rb +44 -0
  307. data/lib/ronin/support/text/patterns/network.rb +140 -0
  308. data/lib/ronin/support/text/patterns/numeric.rb +52 -0
  309. data/lib/ronin/support/text/patterns/pii.rb +105 -0
  310. data/lib/ronin/support/text/patterns/source_code.rb +148 -0
  311. data/lib/ronin/{extensions.rb → support/text/patterns.rb} +9 -13
  312. data/lib/ronin/support/text/random/mixin.rb +437 -0
  313. data/lib/ronin/support/text/random.rb +419 -0
  314. data/lib/ronin/support/text/typo/core_ext/string.rb +123 -0
  315. data/lib/ronin/support/text/typo/core_ext.rb +19 -0
  316. data/lib/ronin/support/text/typo/exceptions.rb +28 -0
  317. data/lib/ronin/support/text/typo/generator.rb +161 -0
  318. data/lib/ronin/support/text/typo.rb +260 -0
  319. data/lib/ronin/{formatting → support}/text.rb +10 -4
  320. data/lib/ronin/support/version.rb +3 -4
  321. data/lib/ronin/support.rb +17 -12
  322. data/ronin-support.gemspec +2 -1
  323. metadata +340 -289
  324. data/lib/ronin/binary/hexdump/parser.rb +0 -403
  325. data/lib/ronin/binary/struct.rb +0 -567
  326. data/lib/ronin/binary/template.rb +0 -454
  327. data/lib/ronin/extensions/ip_addr.rb +0 -216
  328. data/lib/ronin/extensions/meta/object.rb +0 -24
  329. data/lib/ronin/extensions/regexp.rb +0 -157
  330. data/lib/ronin/formatting/extensions/binary/base64.rb +0 -106
  331. data/lib/ronin/formatting/extensions/binary/file.rb +0 -77
  332. data/lib/ronin/formatting/extensions/binary/float.rb +0 -65
  333. data/lib/ronin/formatting/extensions/binary/integer.rb +0 -180
  334. data/lib/ronin/formatting/extensions/binary/string.rb +0 -345
  335. data/lib/ronin/formatting/extensions/digest/file.rb +0 -129
  336. data/lib/ronin/formatting/extensions/digest/string.rb +0 -86
  337. data/lib/ronin/formatting/extensions/digest.rb +0 -21
  338. data/lib/ronin/formatting/extensions/html/integer.rb +0 -142
  339. data/lib/ronin/formatting/extensions/html/string.rb +0 -194
  340. data/lib/ronin/formatting/extensions/html.rb +0 -21
  341. data/lib/ronin/formatting/extensions/http/string.rb +0 -110
  342. data/lib/ronin/formatting/extensions/http.rb +0 -21
  343. data/lib/ronin/formatting/extensions/sql/string.rb +0 -130
  344. data/lib/ronin/formatting/extensions/sql.rb +0 -20
  345. data/lib/ronin/formatting/extensions/text/array.rb +0 -137
  346. data/lib/ronin/formatting/extensions/text/string.rb +0 -297
  347. data/lib/ronin/formatting/extensions.rb +0 -24
  348. data/lib/ronin/fuzzing/extensions/string.rb +0 -209
  349. data/lib/ronin/fuzzing/fuzzer.rb +0 -110
  350. data/lib/ronin/fuzzing/fuzzing.rb +0 -360
  351. data/lib/ronin/fuzzing/mutator.rb +0 -161
  352. data/lib/ronin/fuzzing/repeater.rb +0 -81
  353. data/lib/ronin/fuzzing/template.rb +0 -133
  354. data/lib/ronin/fuzzing.rb +0 -21
  355. data/lib/ronin/mixin.rb +0 -89
  356. data/lib/ronin/network/dns.rb +0 -201
  357. data/lib/ronin/network/esmtp.rb +0 -113
  358. data/lib/ronin/network/extensions/dns.rb +0 -20
  359. data/lib/ronin/network/extensions/esmtp.rb +0 -20
  360. data/lib/ronin/network/extensions/http/uri/http.rb +0 -228
  361. data/lib/ronin/network/extensions/http.rb +0 -21
  362. data/lib/ronin/network/extensions/imap.rb +0 -20
  363. data/lib/ronin/network/extensions/pop3/net.rb +0 -24
  364. data/lib/ronin/network/extensions/pop3.rb +0 -20
  365. data/lib/ronin/network/extensions/smtp/net.rb +0 -24
  366. data/lib/ronin/network/extensions/ssl/net.rb +0 -24
  367. data/lib/ronin/network/extensions/ssl.rb +0 -20
  368. data/lib/ronin/network/extensions/tcp/net.rb +0 -24
  369. data/lib/ronin/network/extensions/tcp.rb +0 -20
  370. data/lib/ronin/network/extensions/telnet/net.rb +0 -24
  371. data/lib/ronin/network/extensions/telnet.rb +0 -20
  372. data/lib/ronin/network/extensions/udp/net.rb +0 -24
  373. data/lib/ronin/network/extensions/udp.rb +0 -20
  374. data/lib/ronin/network/extensions.rb +0 -29
  375. data/lib/ronin/network/ftp.rb +0 -149
  376. data/lib/ronin/network/http/exceptions.rb +0 -20
  377. data/lib/ronin/network/http/http.rb +0 -1122
  378. data/lib/ronin/network/http/proxy.rb +0 -330
  379. data/lib/ronin/network/http.rb +0 -22
  380. data/lib/ronin/network/imap.rb +0 -158
  381. data/lib/ronin/network/mixins/esmtp.rb +0 -164
  382. data/lib/ronin/network/mixins/ftp.rb +0 -155
  383. data/lib/ronin/network/mixins/http.rb +0 -227
  384. data/lib/ronin/network/mixins/imap.rb +0 -156
  385. data/lib/ronin/network/mixins/pop3.rb +0 -149
  386. data/lib/ronin/network/mixins/smtp.rb +0 -159
  387. data/lib/ronin/network/mixins/ssl.rb +0 -148
  388. data/lib/ronin/network/mixins/tcp.rb +0 -368
  389. data/lib/ronin/network/mixins/telnet.rb +0 -208
  390. data/lib/ronin/network/mixins/udp.rb +0 -381
  391. data/lib/ronin/network/mixins/unix.rb +0 -279
  392. data/lib/ronin/network/mixins.rb +0 -29
  393. data/lib/ronin/network/pop3.rb +0 -124
  394. data/lib/ronin/network/proxy.rb +0 -578
  395. data/lib/ronin/network/smtp/email.rb +0 -174
  396. data/lib/ronin/network/smtp/smtp.rb +0 -230
  397. data/lib/ronin/network/smtp.rb +0 -22
  398. data/lib/ronin/network/ssl.rb +0 -186
  399. data/lib/ronin/network/tcp/proxy.rb +0 -417
  400. data/lib/ronin/network/tcp/tcp.rb +0 -452
  401. data/lib/ronin/network/tcp.rb +0 -21
  402. data/lib/ronin/network/telnet.rb +0 -266
  403. data/lib/ronin/network/udp/proxy.rb +0 -191
  404. data/lib/ronin/network/udp/udp.rb +0 -452
  405. data/lib/ronin/network/udp.rb +0 -21
  406. data/lib/ronin/network/unix.rb +0 -286
  407. data/lib/ronin/network.rb +0 -31
  408. data/lib/ronin/path.rb +0 -133
  409. data/lib/ronin/spec/ui/output.rb +0 -22
  410. data/lib/ronin/support/inflector.rb +0 -92
  411. data/lib/ronin/templates/erb.rb +0 -78
  412. data/lib/ronin/templates/template.rb +0 -169
  413. data/lib/ronin/templates.rb +0 -21
  414. data/lib/ronin/ui/output/helpers.rb +0 -296
  415. data/lib/ronin/ui/output/output.rb +0 -142
  416. data/lib/ronin/ui/output/terminal/color.rb +0 -124
  417. data/lib/ronin/ui/output/terminal/raw.rb +0 -103
  418. data/lib/ronin/ui/output/terminal.rb +0 -21
  419. data/lib/ronin/ui/output.rb +0 -21
  420. data/lib/ronin/ui/shell.rb +0 -286
  421. data/lib/ronin/wordlist.rb +0 -287
  422. data/spec/binary/hexdump/helpers/hexdumps/ascii.bin +0 -0
  423. data/spec/binary/hexdump/helpers/hexdumps/hexdump_decimal_shorts.txt +0 -17
  424. data/spec/binary/hexdump/helpers/hexdumps/hexdump_hex_bytes.txt +0 -17
  425. data/spec/binary/hexdump/helpers/hexdumps/hexdump_hex_shorts.txt +0 -17
  426. data/spec/binary/hexdump/helpers/hexdumps/hexdump_octal_bytes.txt +0 -17
  427. data/spec/binary/hexdump/helpers/hexdumps/hexdump_octal_shorts.txt +0 -17
  428. data/spec/binary/hexdump/helpers/hexdumps/hexdump_repeated.txt +0 -6
  429. data/spec/binary/hexdump/helpers/hexdumps/od_decimal_bytes.txt +0 -17
  430. data/spec/binary/hexdump/helpers/hexdumps/od_decimal_ints.txt +0 -17
  431. data/spec/binary/hexdump/helpers/hexdumps/od_decimal_quads.txt +0 -17
  432. data/spec/binary/hexdump/helpers/hexdumps/od_decimal_shorts.txt +0 -17
  433. data/spec/binary/hexdump/helpers/hexdumps/od_doubles.txt +0 -17
  434. data/spec/binary/hexdump/helpers/hexdumps/od_floats.txt +0 -17
  435. data/spec/binary/hexdump/helpers/hexdumps/od_hex_bytes.txt +0 -17
  436. data/spec/binary/hexdump/helpers/hexdumps/od_hex_ints.txt +0 -17
  437. data/spec/binary/hexdump/helpers/hexdumps/od_hex_quads.txt +0 -17
  438. data/spec/binary/hexdump/helpers/hexdumps/od_hex_shorts.txt +0 -17
  439. data/spec/binary/hexdump/helpers/hexdumps/od_named_chars.txt +0 -17
  440. data/spec/binary/hexdump/helpers/hexdumps/od_octal_bytes.txt +0 -17
  441. data/spec/binary/hexdump/helpers/hexdumps/od_octal_ints.txt +0 -17
  442. data/spec/binary/hexdump/helpers/hexdumps/od_octal_quads.txt +0 -17
  443. data/spec/binary/hexdump/helpers/hexdumps/od_octal_shorts.txt +0 -17
  444. data/spec/binary/hexdump/helpers/hexdumps/od_repeated.txt +0 -6
  445. data/spec/binary/hexdump/helpers/hexdumps/repeated.bin +0 -1
  446. data/spec/binary/hexdump/helpers/hexdumps.rb +0 -13
  447. data/spec/binary/hexdump/parser_spec.rb +0 -302
  448. data/spec/binary/struct_spec.rb +0 -496
  449. data/spec/binary/template_spec.rb +0 -416
  450. data/spec/extensions/enumerable_spec.rb +0 -24
  451. data/spec/extensions/file_spec.rb +0 -61
  452. data/spec/extensions/ip_addr_spec.rb +0 -203
  453. data/spec/extensions/kernel_spec.rb +0 -30
  454. data/spec/extensions/regexp_spec.rb +0 -482
  455. data/spec/extensions/resolv_spec.rb +0 -18
  456. data/spec/extensions/string_spec.rb +0 -180
  457. data/spec/formatting/binary/array_spec.rb +0 -26
  458. data/spec/formatting/binary/base64_spec.rb +0 -50
  459. data/spec/formatting/binary/float_spec.rb +0 -36
  460. data/spec/formatting/binary/integer_spec.rb +0 -166
  461. data/spec/formatting/binary/string_spec.rb +0 -199
  462. data/spec/formatting/digest/string_spec.rb +0 -82
  463. data/spec/formatting/html/integer_spec.rb +0 -66
  464. data/spec/formatting/html/string_spec.rb +0 -103
  465. data/spec/formatting/http/integer_spec.rb +0 -42
  466. data/spec/formatting/http/string_spec.rb +0 -76
  467. data/spec/formatting/sql/string_spec.rb +0 -77
  468. data/spec/formatting/text/array_spec.rb +0 -105
  469. data/spec/formatting/text/string_spec.rb +0 -162
  470. data/spec/fuzzing/extensions/string_spec.rb +0 -87
  471. data/spec/fuzzing/fuzzer_spec.rb +0 -109
  472. data/spec/fuzzing/fuzzing_spec.rb +0 -24
  473. data/spec/fuzzing/mutator_spec.rb +0 -112
  474. data/spec/fuzzing/repeater_spec.rb +0 -57
  475. data/spec/fuzzing/template_spec.rb +0 -54
  476. data/spec/mixin_spec.rb +0 -51
  477. data/spec/network/dns_spec.rb +0 -203
  478. data/spec/network/ftp_spec.rb +0 -81
  479. data/spec/network/http/http_spec.rb +0 -559
  480. data/spec/network/http/proxy_spec.rb +0 -148
  481. data/spec/network/network_spec.rb +0 -8
  482. data/spec/network/proxy_spec.rb +0 -121
  483. data/spec/network/shared/unix_server.rb +0 -31
  484. data/spec/network/smtp/email_spec.rb +0 -100
  485. data/spec/network/ssl_spec.rb +0 -70
  486. data/spec/network/tcp/proxy_spec.rb +0 -118
  487. data/spec/network/tcp/tcp_spec.rb +0 -316
  488. data/spec/network/telnet_spec.rb +0 -67
  489. data/spec/network/udp/udp_spec.rb +0 -298
  490. data/spec/network/unix_spec.rb +0 -182
  491. data/spec/path_spec.rb +0 -111
  492. data/spec/spec_helper.rb +0 -8
  493. data/spec/support/inflector_spec.rb +0 -22
  494. data/spec/support_spec.rb +0 -8
  495. data/spec/templates/classes/example_erb.rb +0 -11
  496. data/spec/templates/classes/example_template.rb +0 -35
  497. data/spec/templates/erb_spec.rb +0 -21
  498. data/spec/templates/helpers/data/includes/_relative.erb +0 -1
  499. data/spec/templates/helpers/data/templates/example.erb +0 -1
  500. data/spec/templates/helpers/data.rb +0 -9
  501. data/spec/templates/template_spec.rb +0 -54
  502. data/spec/ui/classes/test_shell.rb +0 -22
  503. data/spec/ui/output_spec.rb +0 -32
  504. data/spec/ui/shell_spec.rb +0 -83
  505. data/spec/wordlist_spec.rb +0 -151
@@ -1,208 +0,0 @@
1
- #
2
- # Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
3
- #
4
- # This file is part of ronin-support.
5
- #
6
- # ronin-support is free software: you can redistribute it and/or modify
7
- # it under the terms of the GNU Lesser General Public License as published
8
- # by the Free Software Foundation, either version 3 of the License, or
9
- # (at your option) any later version.
10
- #
11
- # ronin-support 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 Lesser General Public License for more details.
15
- #
16
- # You should have received a copy of the GNU Lesser General Public License
17
- # along with ronin-support. If not, see <https://www.gnu.org/licenses/>.
18
- #
19
-
20
- require 'ronin/network/mixins/mixin'
21
- require 'ronin/network/telnet'
22
-
23
- module Ronin
24
- module Network
25
- module Mixins
26
- #
27
- # Adds Telnet convenience methods and connection parameters to a
28
- # class.
29
- #
30
- # Defines the following parameters:
31
- #
32
- # * `host` (`String`) - Telnet host.
33
- # * `port` (`Integer`) - Telnet port.
34
- # * `telnet_user` (`String`) - Telnet user to login as.
35
- # * `telnet_password` (`String`) - Telnet password to login with.
36
- # * `telnet_proxy` (`String`) - Telnet proxy.
37
- # * `telnet_ssl` (`Boolean`) - Enable Telnet over SSL. Defaults to `true`.
38
- #
39
- module Telnet
40
- include Mixin, Network::Telnet
41
-
42
- # Telnet host
43
- parameter :host, :type => String,
44
- :description => 'Telnet host'
45
-
46
- # Telnet port
47
- parameter :port, :type => Integer,
48
- :description => 'Telnet port'
49
-
50
- # Telnet user
51
- parameter :telnet_user, :type => String,
52
- :description => 'Telnet user to login as'
53
-
54
- # Telnet password
55
- parameter :telnet_password, :type => String,
56
- :description => 'Telnet password to login with'
57
-
58
- # Telnet proxy
59
- parameter :telnet_proxy, :description => 'Telnet proxy'
60
-
61
- # Enable Telnet SSL
62
- parameter :telnet_ssl, :type => true,
63
- :description => 'Enable Telnet over SSL'
64
-
65
- protected
66
-
67
- #
68
- # Creates a connection to a Telnet server. The `host`, `port`,
69
- # `telnet_user`, `telnet_password`, `telnet_proxy` and
70
- # `telnet_ssl` parameters will also be used to connect to the
71
- # Telnet server.
72
- #
73
- # @param [Hash] options
74
- # Additional options.
75
- #
76
- # @option options [Integer] :port (Network::Telnet.default_port)
77
- # The port to connect to.
78
- #
79
- # @option options [Boolean] :binmode
80
- # Indicates that newline substitution shall not be performed.
81
- #
82
- # @option options [String] :output_log
83
- # The name of the file to write connection status messages
84
- # and all received traffic to.
85
- #
86
- # @option options [String] :dump_log
87
- # Similar to the `:output_log` option, but connection output
88
- # is also written in hexdump format.
89
- #
90
- # @option options [Regexp] :prompt (Network::Telnet.default_prompt)
91
- # A regular expression matching the host command-line prompt
92
- # sequence, used to determine when a command has finished.
93
- #
94
- # @option options [Boolean] :telnet (true)
95
- # Indicates that the connection shall behave as a telnet
96
- # connection.
97
- #
98
- # @option options [Boolean] :plain
99
- # Indicates that the connection shall behave as a normal TCP
100
- # connection.
101
- #
102
- # @option options [Integer] :timeout (Network::Telnet.default_timeout)
103
- # The number of seconds to wait before timing out both the
104
- # initial attempt to connect to host, and all attempts to read
105
- # data from the host.
106
- #
107
- # @option options [Integer] :wait_time
108
- # The amount of time to wait after seeing what looks like
109
- # a prompt.
110
- #
111
- # @option options [Net::Telnet, IO] :proxy (Network::Telnet.proxy)
112
- # A proxy object to used instead of opening a direct connection
113
- # to the host.
114
- #
115
- # @option options [String] :user
116
- # The user to login as.
117
- #
118
- # @option options [String] :password
119
- # The password to login with.
120
- #
121
- # @yield [connection]
122
- # If a block is given, it will be passed the newly created
123
- # Telnet connection.
124
- #
125
- # @yieldparam [Net::Telnet] connection
126
- # The newly created Telnet connection.
127
- #
128
- # @return [Net::Telnet]
129
- # The Telnet session
130
- #
131
- # @example
132
- # telnet_connect
133
- # # => Net::Telnet
134
- #
135
- # @see Network::Telnet#telnet_connect
136
- #
137
- # @api public
138
- #
139
- def telnet_connect(options={},&block)
140
- print_info "Connecting to #{host_port} ..."
141
-
142
- return super(self.host,telnet_merge_options(options),&block)
143
- end
144
-
145
- #
146
- # Starts a session with a Telnet server. The `host`, `port`,
147
- # `telnet_user`, `telnet_password`, `telnet_proxy` and
148
- # `telnet_ssl` parameters will also be used to connect to the
149
- # Telnet server.
150
- #
151
- # @yield [session]
152
- # If a block is given, it will be passed the newly created
153
- # Telnet session. After the block has returned, the Telnet
154
- # session will be closed.
155
- #
156
- # @yieldparam [Net::Telnet] session
157
- # The newly created Telnet session.
158
- #
159
- # @example
160
- # telnet_session do |movie|
161
- # movie.each_line { |line| puts line }
162
- # end
163
- #
164
- # @see Network::Telnet#telnet_session
165
- #
166
- # @api public
167
- #
168
- def telnet_session(options={},&block)
169
- super(telnet_merge_options(options)) do |sess|
170
- yield sess if block_given?
171
-
172
- print "Logging out ..."
173
- end
174
-
175
- print_info "Disconnected to #{host_port}"
176
- return nil
177
- end
178
-
179
- private
180
-
181
- #
182
- # Merges the Telnet parameters into the options for {Network::Telnet}
183
- # methods.
184
- #
185
- # @param [Hash] options
186
- # The original options.
187
- #
188
- # @return [Hash]
189
- # The merged options.
190
- #
191
- # @since 0.4.0
192
- #
193
- # @api private
194
- #
195
- def telnet_merge_options(options={})
196
- options[:port] ||= self.port
197
- options[:user] ||= self.telnet_user
198
- options[:password] ||= self.telnet_password
199
-
200
- options[:proxy] ||= self.telnet_proxy
201
- options[:ssl] ||= self.telnet_ssl
202
-
203
- return options
204
- end
205
- end
206
- end
207
- end
208
- end
@@ -1,381 +0,0 @@
1
- #
2
- # Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
3
- #
4
- # This file is part of ronin-support.
5
- #
6
- # ronin-support is free software: you can redistribute it and/or modify
7
- # it under the terms of the GNU Lesser General Public License as published
8
- # by the Free Software Foundation, either version 3 of the License, or
9
- # (at your option) any later version.
10
- #
11
- # ronin-support 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 Lesser General Public License for more details.
15
- #
16
- # You should have received a copy of the GNU Lesser General Public License
17
- # along with ronin-support. If not, see <https://www.gnu.org/licenses/>.
18
- #
19
-
20
- require 'ronin/network/mixins/mixin'
21
- require 'ronin/network/udp'
22
-
23
- module Ronin
24
- module Network
25
- module Mixins
26
- #
27
- # Adds UDP convenience methods and connection parameters to a class.
28
- #
29
- # Defines the following parameters:
30
- #
31
- # * `host` (`String`) - UDP host.
32
- # * `port` (`Integer`) - UDP port.
33
- # * `local_host` (`String`) - UDP local host.
34
- # * `local_port` (`Integer`) - UDP local port.
35
- # * `server_host` (`String`) - UDP server host.
36
- # * `server_port` (`Integer`) - UDP server port.
37
- #
38
- module UDP
39
- include Mixin, Network::UDP
40
-
41
- # UDP host
42
- parameter :host, :type => String,
43
- :description => 'UDP host'
44
-
45
- # UDP port
46
- parameter :port, :type => Integer,
47
- :description => 'UDP port'
48
-
49
- # UDP local host
50
- parameter :local_host, :type => String,
51
- :description => 'UDP local host'
52
-
53
- # UDP local port
54
- parameter :local_port, :type => Integer,
55
- :description => 'UDP local port'
56
-
57
- # UDP server host
58
- parameter :server_host, :type => String,
59
- :description => 'UDP server host'
60
-
61
- # UDP server port
62
- parameter :server_port, :type => Integer,
63
- :description => 'UDP server port'
64
-
65
- protected
66
-
67
- #
68
- # Tests whether the UDP port, specified by the `host` and `port`
69
- # parameters, is open.
70
- #
71
- # @param [Integer] timeout (5)
72
- # The maximum time to attempt connecting.
73
- #
74
- # @return [Boolean, nil]
75
- # Specifies whether the remote UDP port is open.
76
- # If no data or ICMP error were received, `nil` will be returned.
77
- #
78
- # @api public
79
- #
80
- # @since 0.5.0
81
- #
82
- def udp_open?(timeout=nil)
83
- print_info "Testing if #{host_port} is open ..."
84
-
85
- super(self.host,self.port,self.local_host,self.local_port,timeout)
86
- end
87
-
88
- #
89
- # Opens a UDP connection to the host and port specified by the
90
- # `host` and `port` parameters. If the `local_host` and
91
- # `local_port` parameters are set, they will be used for
92
- # the local host and port of the UDP connection.
93
- #
94
- # @yield [socket]
95
- # If a block is given, it will be passed the newly created socket.
96
- #
97
- # @yieldparam [UDPsocket] socket
98
- # The newly created UDPSocket object.
99
- #
100
- # @return [UDPSocket]
101
- # The newly created UDPSocket object.
102
- #
103
- # @example
104
- # udp_connect
105
- # # => UDPSocket
106
- #
107
- # @example
108
- # udp_connect do |socket|
109
- # puts socket.readlines
110
- # end
111
- #
112
- # @see Network::UDP#udp_connect
113
- #
114
- # @api public
115
- #
116
- def udp_connect(&block)
117
- print_info "Connecting to #{host_port} ..."
118
-
119
- return super(self.host,self.port,self.local_host,self.local_port,&block)
120
- end
121
-
122
- #
123
- # Connects to the host and port specified by the `host` and `port`
124
- # parameters, then sends the given data. If the `local_host` and
125
- # `local_port` instance methods are set, they will be used for the
126
- # local host and port of the UDP connection.
127
- #
128
- # @param [String] data
129
- # The data to send through the connection.
130
- #
131
- # @yield [socket]
132
- # If a block is given, it will be passed the newly created socket.
133
- #
134
- # @yieldparam [UDPsocket] socket
135
- # The newly created UDPSocket object.
136
- #
137
- # @return [UDPSocket]
138
- # The newly created UDPSocket object.
139
- #
140
- # @see Network::UDP#udp_connect_and_send
141
- #
142
- # @api public
143
- #
144
- def udp_connect_and_send(data,&block)
145
- print_info "Connecting to #{host_port} ..."
146
- print_debug "Sending data: #{data.inspect}"
147
-
148
- return super(data,self.host,self.port,self.local_host,self.local_port,&block)
149
- end
150
-
151
- #
152
- # Creates a UDP session to the host and port specified by the
153
- # `host` and `port` parameters. If the `local_host` and `local_port`
154
- # parameters are set, they will be used for the local host and port
155
- # of the UDP connection.
156
- #
157
- # @yield [socket]
158
- # If a block is given, it will be passed the newly created socket.
159
- # After the block has returned, the socket will then be closed.
160
- #
161
- # @yieldparam [UDPsocket] socket
162
- # The newly created UDPSocket object.
163
- #
164
- # @return [nil]
165
- #
166
- # @see Network::UDP#udp_session
167
- #
168
- # @api public
169
- #
170
- def udp_session(&block)
171
- print_info "Connecting to #{host_port} ..."
172
-
173
- super(self.host,self.port,self.local_host,self.local_port,&block)
174
-
175
- print_info "Disconnected from #{host_port}"
176
- return nil
177
- end
178
-
179
- #
180
- # Connects to the host and port specified by the `host` and `port`
181
- # parameters, sends the given data and then disconnects.
182
- #
183
- # @return [true]
184
- # The data was successfully sent.
185
- #
186
- # @example
187
- # buffer = "GET /" + ('A' * 4096) + "\n\r"
188
- # udp_send(buffer)
189
- # # => true
190
- #
191
- # @see Network::UDP#udp_send
192
- #
193
- # @api public
194
- #
195
- # @since 0.4.0
196
- #
197
- def udp_send(data)
198
- print_info "Connecting to #{host_port} ..."
199
- print_debug "Sending data: #{data.inspect}"
200
-
201
- super(data,self.host,self.port,self.local_host,self.local_port)
202
-
203
- print_info "Disconnected from #{host_port}"
204
- return true
205
- end
206
-
207
- #
208
- # Creates a new UDPServer object listening on `server_host` and
209
- # `server_port` parameters.
210
- #
211
- # @yield [server]
212
- # The given block will be passed the newly created server.
213
- #
214
- # @yieldparam [UDPServer] server
215
- # The newly created server.
216
- #
217
- # @return [UDPServer]
218
- # The newly created server.
219
- #
220
- # @example
221
- # udp_server
222
- #
223
- # @see Network::UDP#udp_server
224
- #
225
- # @api public
226
- #
227
- def udp_server(&block)
228
- print_info "Listening on #{server_host_port} ..."
229
-
230
- return super(self.server_port,self.server_host,&block)
231
- end
232
-
233
- #
234
- # Creates a new temporary UDPServer object listening on the
235
- # `server_host` and `server_port` parameters.
236
- #
237
- # @yield [server]
238
- # The given block will be passed the newly created server.
239
- # When the block has finished, the server will be closed.
240
- #
241
- # @yieldparam [UDPServer] server
242
- # The newly created server.
243
- #
244
- # @return [nil]
245
- #
246
- # @example
247
- # udp_server_session do |server|
248
- # data, sender = server.recvfrom(1024)
249
- # end
250
- #
251
- # @see Network::UDP#udp_server_session
252
- #
253
- # @api public
254
- #
255
- def udp_server_session(&block)
256
- print_info "Listening on #{self.server_host_port} ..."
257
-
258
- super(self.server_port,self.server_host,&block)
259
-
260
- print_info "Closed #{self.server_host_port}"
261
- return nil
262
- end
263
-
264
- #
265
- # Creates a new UDPServer listening on the `server_host` and
266
- # `server_port` parameters, accepting messages from clients in a loop.
267
- #
268
- # @yield [server, (client_host, client_port), mesg]
269
- # The given block will be passed the client host/port and the received
270
- # message.
271
- #
272
- # @yieldparam [UDPServer] server
273
- # The UDPServer.
274
- #
275
- # @yieldparam [String] client_host
276
- # The source host of the mesg.
277
- #
278
- # @yieldparam [Integer] client_port
279
- # The source port of the mesg.
280
- #
281
- # @yieldparam [String] mesg
282
- # The received message.
283
- #
284
- # @return [nil]
285
- #
286
- # @example
287
- # udp_server_loop do |server,(host,port),mesg|
288
- # server.send('hello',host,port)
289
- # end
290
- #
291
- # @see Network::UDP#udp_server_loop
292
- #
293
- # @api public
294
- #
295
- # @since 0.5.0
296
- #
297
- def udp_server_loop(&block)
298
- print_info "Listening on #{self.server_host_port} ..."
299
-
300
- super(self.server_port,self.server_host,&block)
301
-
302
- print_info "Closed #{self.server_host_port}"
303
- return nil
304
- end
305
-
306
- #
307
- # Creates a new UDPServer listening on the `server_host` and
308
- # `server_port` parameters, accepts only one message from a client.
309
- #
310
- # @yield [server, (client_host, client_port), mesg]
311
- # The given block will be passed the client host/port and the received
312
- # message.
313
- #
314
- # @yieldparam [UDPServer] server
315
- # The UDPServer.
316
- #
317
- # @yieldparam [String] client_host
318
- # The source host of the mesg.
319
- #
320
- # @yieldparam [Integer] client_port
321
- # The source port of the mesg.
322
- #
323
- # @yieldparam [String] mesg
324
- # The received message.
325
- #
326
- # @return [nil]
327
- #
328
- # @example
329
- # udp_recv do |server,(host,port),mesg|
330
- # server.send('hello',host,port)
331
- # end
332
- #
333
- # @see Network::UDP#udp_recv
334
- #
335
- # @api public
336
- #
337
- # @since 0.5.0
338
- #
339
- def udp_recv(&block)
340
- print_info "Listening on #{self.server_host_port} ..."
341
-
342
- super(self.server_port,self.server_host) do |server,(host,port),mesg|
343
- print_info "Received message from #{host}:#{port}"
344
- print_debug mesg
345
-
346
- yield server, [host, port], mesg if block_given?
347
- end
348
-
349
- print_info "Closed #{self.server_host_port}"
350
- return nil
351
- end
352
-
353
- #
354
- # @deprecated
355
- # Deprecated as of 0.5.0. Use {#udp_recv} instead.
356
- #
357
- # @since 0.5.0
358
- #
359
- def udp_single_server(&block)
360
- udp_recv(&block)
361
- end
362
-
363
- private
364
-
365
- #
366
- # The server host/port parameters.
367
- #
368
- # @return [String]
369
- # The server host/port parameters in String form.
370
- #
371
- # @since 0.4.0
372
- #
373
- # @api private
374
- #
375
- def server_host_port
376
- "#{self.server_host}:#{self.server_port}"
377
- end
378
- end
379
- end
380
- end
381
- end