io-extra 1.2.8 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 418b72ff17a0099e8172b269e8fdef1641e59351
-  data.tar.gz: 6f228294bde48cace55a4885833a38f4f212144e
+SHA256:
+  metadata.gz: e110a14a9b41e4ae67f06a04338ebba468ae3731b1ed8d940606cfc50f56fa11
+  data.tar.gz: 90bc28cf009765f3cdefdeb4fa6028b4269a2b58067ceb9272f58fdfd75e5352
 SHA512:
-  metadata.gz: 82a2590fc4e9b84f3a785fd5939782b97b0110c19d8950c689526a95aee9297e99dd6bcaf456f90d1b0cab056de692cb065f5bcb00bd9aa1584100c1e8094a52
-  data.tar.gz: eb0bf873f28143449957af7c383e7e3cc2b12750eebf232d4c3a87d2f593707aaf26297a0ceed3f323920c30aadf871e695427452fa6128669691d245c355018
+  metadata.gz: 6dbb68585d84b9e0fde2b4e508749500eb86993157aeff7ce830e7b86676ac96027ef6ba18bac8ec1258f16f5b1331a97d5187de90237858828361928c888bc2
+  data.tar.gz: 66beb1736b6ca2d846aa0eeca812dcf317b90463b260a18f439197090df1de51d4117c9ae233ddcc9c687e84967af30446a270ec8e8ffd229636f9413ae70d6f

data.tar.gz.sig

@@ -0,0 +1 @@
+���$��d�/�56?�����I�π�T2�F������v3��wscmk

data/CHANGES

@@ -1,3 +1,14 @@
+== 1.3.0 - 19-Oct-2018
+* Now assumes Ruby 2.1 or later. This has no effect on the external API, but
+  it does allow for lots of internal cleanup.
+* License changed to Apache-2.0.
+* The EXTRA_VERSION constant is now frozen.
+* Added the io-extra.rb file for convenience.
+* Updates to the gemspec, including the addition of metadata.
+* The Rakefile now assumes Rubygems 2.0 or later.
+* Added a cert.
+* Removed the .gemtest file.
+
 == 1.2.8 - 29-Dec-2014
 * Updated for compatibility with Ruby 2.2.x.
 

data/MANIFEST

@@ -3,9 +3,10 @@
 * CHANGES
 * Rakefile
 * io-extra.gemspec
+* certs/djberg96_pub.pem
 * doc/io_extra.txt
 * examples/example_io_extra.rb
 * ext/extconf.rb
 * ext/io/extra.c
+* lib/io-extra.rb
 * test/test_io_extra.rb
-*.gemtest

data/README

@@ -11,7 +11,7 @@
   gem install io-extra
 
 = Synopsis
-  require 'io/extra'
+  require 'io/extra' # or 'io-extra'
 
   # Close all file descriptors from 3 up.
   IO.closefrom(3)
@@ -45,9 +45,9 @@
   of IO.fdwalk and a pure Ruby version that looks something like this:
 
    def IO.fdwalk(n)
-      ObjectSpace.each_object(File){ |f|
-         yield f if f.fileno >= n
-      }
+     ObjectSpace.each_object(File){ |f|
+       yield f if f.fileno >= n
+     }
    end
 
   The primary difference is that this only closes Ruby file objects, not
@@ -67,21 +67,25 @@
   The IO.writev tests fail on Solaris. Short test scripts seem to work,
   however. We're not sure what the issue is yet. Help wanted.
 
+  Update: As of 2018 Solaris is basically dead, so I'm not going to worry
+  about supporting Solaris unless there's an outcry.
+
   Please file any bug reports on the project page at
   https://github.com/djberg96/io-extra
 
 = Future Plans
-  * Switch from C extension to FFI.
+  * Switch from C extension to FFI (maybe).
+  * Add the IO.pselect method.
 
 = Acknowledgements
   Eric Wong for some great work on Linux compatibility and other fixes, as
   well as the code for the IO.writev method.
 
 = License
-  Artistic 2.0
+  Apache-2.0
 
 = Copyright
-  (C) 2003-2013 Daniel J. Berger
+  (C) 2003-2018 Daniel J. Berger
   All Rights Reserved
     
 = Warranty

data/ext/extconf.rb

@@ -13,11 +13,7 @@ have_func('directio')
 have_func('pread')
 have_func('pwrite')
 have_func('writev')
-have_func('rb_str_set_len', 'ruby.h')
-have_func('rb_thread_blocking_region')
 have_func('ttyname')
-have_func('rb_reserved_fd_p')
-have_func('rb_thread_call_without_gvl', 'ruby/thread.h')
 
 case RbConfig::CONFIG['host_os']
 when /darwin/i

data/ext/io/extra.c

@@ -1,10 +1,7 @@
 /* Extra methods for the IO class */
 #include "ruby.h"
-#ifdef HAVE_RUBY_IO_H
 #include "ruby/io.h"
-#else
-#include "rubyio.h"
-#endif
+#include "ruby/thread.h"
 
 #include <unistd.h>
 #include <stdlib.h>
@@ -26,69 +23,11 @@
 #if defined(_SC_IOV_MAX)
 #define IOV_MAX (sysconf(_SC_IOV_MAX))
 #else
-/* assume infinity, or let the syscall return with error ... */
+// Assume infinity, or let the syscall return with error
 #define IOV_MAX INT_MAX
 #endif
 #endif
 
-#ifdef HAVE_RB_THREAD_CALL_WITHOUT_GVL
-#include <ruby/thread.h>
-#endif
-
-#if ! defined(HAVE_RB_THREAD_BLOCKING_REGION) && \
-    ! defined(HAVE_RB_THREAD_CALL_WITHOUT_GVL)
-/*
- * Partial emulation of the 1.9 rb_thread_blocking_region under 1.8,
- * this is enough to ensure signals are processed safely when doing I/O
- * to a slow device, but doesn't actually ensure threads can be
- * scheduled fairly in 1.8.
- */
-#include <rubysig.h>
-#define RUBY_UBF_IO ((rb_unblock_function_t *)-1)
-typedef void rb_unblock_function_t(void *);
-typedef VALUE rb_blocking_function_t(void *);
-static VALUE
-rb_thread_blocking_region(
-   rb_blocking_function_t *fn, void *data1,
-   rb_unblock_function_t *ubf, void *data2)
-{
-   VALUE rv;
-
-   TRAP_BEG;
-   rv = fn(data1);
-   TRAP_END;
-
-   return rv;
-}
-#endif
-
-#ifndef RSTRING_PTR
-#define RSTRING_PTR(v) (RSTRING(v)->ptr)
-#define RSTRING_LEN(v) (RSTRING(v)->len)
-#endif
-
-#ifndef HAVE_RB_STR_SET_LEN
-/* this is taken from Ruby 1.8.7, 1.8.6 may not have it */
-static void rb_18_str_set_len(VALUE str, long len)
-{
-   RSTRING(str)->len = len;
-   RSTRING(str)->ptr[len] = '\0';
-}
-#define rb_str_set_len(str,len) rb_18_str_set_len(str,len)
-#endif
-
-/*
- * Matz Ruby 1.9.3 has rb_reserved_fd_p() because it uses an internal
- * timer thread + pipe to communicate signal wakeups (1.9.0 - 1.9.2
- * wokeup every 10ms to check for signals).   Accidentally closing this
- * pipe breaks the VM completely, so we use this function to avoid it.
- * This can be safely made a no-op for Ruby implementations that do
- * not have this function (since it implies the VM does not reserve FDs)
- */
-#ifndef RB_RESERVED_FD_P
-#define RB_RESERVED_FD_P(fd) (0)
-#endif
-
 #ifdef PROC_SELF_FD_DIR
 #include <dirent.h>
 #endif
@@ -147,20 +86,16 @@ static int open_max(void){
  * The manual approach was copied from the closefrom() man page on Solaris 9.
  */
 static VALUE io_closefrom(VALUE klass, VALUE v_low_fd){
-#if defined(HAVE_CLOSEFROM) && !defined(HAVE_RB_RESERVED_FD_P)
-   /* we can't safely use closefrom() if the RubyVM reserves FDs */
-   closefrom(NUM2INT(v_low_fd));
-#else
-   int i, lowfd;
-   int maxfd = open_max();
-   lowfd = NUM2INT(v_low_fd);
+  int i, lowfd;
+  int maxfd = open_max();
+  lowfd = NUM2INT(v_low_fd);
 
-   for(i = lowfd; i < maxfd; i++) {
-      if(!RB_RESERVED_FD_P(i))
-         close(i);
-   }
-#endif
-   return klass;
+  for(i = lowfd; i < maxfd; i++) {
+    if(!RB_RESERVED_FD_P(i))
+      close(i);
+  }
+
+  return klass;
 }
 
 #ifndef HAVE_FDWALK
@@ -226,6 +161,7 @@ static int close_func(void* lowfd, int fd){
   if(fd >= *(int*)lowfd){
     if (RB_RESERVED_FD_P(fd))
       return 0;
+
     v_args[0] = UINT2NUM(fd);
     rb_yield(rb_class_new_instance(1, v_args, rb_cFile));
   }
@@ -242,15 +178,15 @@ static int close_func(void* lowfd, int fd){
  * Not supported on all platforms.
  */
 static VALUE io_fdwalk(int argc, VALUE* argv, VALUE klass){
-   VALUE v_low_fd, v_block;
-   int lowfd;
+  VALUE v_low_fd, v_block;
+  int lowfd;
 
-   rb_scan_args(argc, argv, "1&", &v_low_fd, &v_block);
-   lowfd = NUM2INT(v_low_fd);
+  rb_scan_args(argc, argv, "1&", &v_low_fd, &v_block);
+  lowfd = NUM2INT(v_low_fd);
 
-   fdwalk(close_func, &lowfd);
+  fdwalk(close_func, &lowfd);
 
-   return klass;
+  return klass;
 }
 #endif
 
@@ -264,20 +200,20 @@ static VALUE io_fdwalk(int argc, VALUE* argv, VALUE klass){
  */
 static VALUE io_get_directio(VALUE self){
 #if defined(HAVE_DIRECTIO) || defined(F_NOCACHE)
-   VALUE v_advice = rb_iv_get(self, "@directio");
+  VALUE v_advice = rb_iv_get(self, "@directio");
 
-   if(NIL_P(v_advice))
-      v_advice = Qfalse;
+  if(NIL_P(v_advice))
+    v_advice = Qfalse;
 
-   return v_advice;
+  return v_advice;
 #elif defined(O_DIRECT)
-   int fd = NUM2INT(rb_funcall(self, rb_intern("fileno"), 0, 0));
-   int flags = fcntl(fd, F_GETFL);
+  int fd = NUM2INT(rb_funcall(self, rb_intern("fileno"), 0, 0));
+  int flags = fcntl(fd, F_GETFL);
 
-   if(flags < 0)
-      rb_sys_fail("fcntl");
+  if(flags < 0)
+    rb_sys_fail("fcntl");
 
-   return (flags & O_DIRECT) ? Qtrue : Qfalse;
+  return (flags & O_DIRECT) ? Qtrue : Qfalse;
 #endif /* O_DIRECT */
 }
 
@@ -350,17 +286,16 @@ static VALUE io_set_directio(VALUE self, VALUE v_advice){
 
 #ifdef HAVE_PREAD
 struct pread_args {
-   int fd;
-   void *buf;
-   size_t nbyte;
-   off_t offset;
+  int fd;
+  void *buf;
+  size_t nbyte;
+  off_t offset;
 };
 
 static VALUE nogvl_pread(void *ptr)
 {
-   struct pread_args *args = ptr;
-
-   return (VALUE)pread(args->fd, args->buf, args->nbyte, args->offset);
+  struct pread_args *args = ptr;
+  return (VALUE)pread(args->fd, args->buf, args->nbyte, args->offset);
 }
 
 /*
@@ -371,28 +306,25 @@ static VALUE nogvl_pread(void *ptr)
  * the +fd+, +length+ and +offset+ arguments are all mandatory.
  */
 static VALUE s_io_pread(VALUE klass, VALUE fd, VALUE nbyte, VALUE offset){
-   struct pread_args args;
-   VALUE str;
-   ssize_t nread;
-
-   args.fd = NUM2INT(fd);
-   args.nbyte = NUM2ULONG(nbyte);
-   args.offset = NUM2OFFT(offset);
-   str = rb_str_new(NULL, args.nbyte);
-   args.buf = RSTRING_PTR(str);
-
-#ifdef HAVE_RB_THREAD_CALL_WITHOUT_GVL
-   nread = (ssize_t)rb_thread_call_without_gvl((void*)nogvl_pread, &args, RUBY_UBF_IO, 0);
-#else
-   nread = (ssize_t)rb_thread_blocking_region(nogvl_pread, &args, RUBY_UBF_IO, 0);
-#endif
+  struct pread_args args;
+  VALUE str;
+  ssize_t nread;
+
+  args.fd = NUM2INT(fd);
+  args.nbyte = NUM2ULONG(nbyte);
+  args.offset = NUM2OFFT(offset);
+  str = rb_str_new(NULL, args.nbyte);
+  args.buf = RSTRING_PTR(str);
+
+  nread = (ssize_t)rb_thread_call_without_gvl((void*)nogvl_pread, &args, RUBY_UBF_IO, 0);
+
+  if(nread == -1)
+    rb_sys_fail("pread");
 
-   if (nread == -1)
-      rb_sys_fail("pread");
-   if ((size_t)nread != args.nbyte)
-      rb_str_set_len(str, nread);
+  if((size_t)nread != args.nbyte)
+    rb_str_set_len(str, nread);
 
-   return str;
+  return str;
 }
 
 /*
@@ -422,17 +354,16 @@ static VALUE s_io_pread_ptr(VALUE klass, VALUE v_fd, VALUE v_nbyte, VALUE v_offs
 
 #ifdef HAVE_PWRITE
 struct pwrite_args {
-   int fd;
-   const void *buf;
-   size_t nbyte;
-   off_t offset;
+  int fd;
+  const void *buf;
+  size_t nbyte;
+  off_t offset;
 };
 
 static VALUE nogvl_pwrite(void *ptr)
 {
-   struct pwrite_args *args = ptr;
-
-   return (VALUE)pwrite(args->fd, args->buf, args->nbyte, args->offset);
+  struct pwrite_args *args = ptr;
+  return (VALUE)pwrite(args->fd, args->buf, args->nbyte, args->offset);
 }
 
 /*
@@ -447,24 +378,20 @@ static VALUE nogvl_pwrite(void *ptr)
  * Returns the number of bytes written.
  */
 static VALUE s_io_pwrite(VALUE klass, VALUE fd, VALUE buf, VALUE offset){
-   ssize_t result;
-   struct pwrite_args args;
+  ssize_t result;
+  struct pwrite_args args;
 
-   args.fd = NUM2INT(fd);
-   args.buf = RSTRING_PTR(buf);
-   args.nbyte = RSTRING_LEN(buf);
-   args.offset = NUM2OFFT(offset);
+  args.fd = NUM2INT(fd);
+  args.buf = RSTRING_PTR(buf);
+  args.nbyte = RSTRING_LEN(buf);
+  args.offset = NUM2OFFT(offset);
 
-#ifdef HAVE_RB_THREAD_CALL_WITHOUT_GVL
-   result = (ssize_t)rb_thread_call_without_gvl((void*)nogvl_pwrite, &args, RUBY_UBF_IO, 0);
-#else
-   result = (ssize_t)rb_thread_blocking_region(nogvl_pwrite, &args, RUBY_UBF_IO, 0);
-#endif
+  result = (ssize_t)rb_thread_call_without_gvl((void*)nogvl_pwrite, &args, RUBY_UBF_IO, 0);
 
-   if(result == -1)
-      rb_sys_fail("pwrite");
+  if(result == -1)
+    rb_sys_fail("pwrite");
 
-   return ULL2NUM(result);
+  return ULL2NUM(result);
 }
 #endif
 
@@ -494,16 +421,15 @@ static VALUE s_io_pwrite(VALUE klass, VALUE fd, VALUE buf, VALUE offset){
 
 #if defined(HAVE_WRITEV)
 struct writev_args {
-   int fd;
-   struct iovec *iov;
-   int iovcnt;
+  int fd;
+  struct iovec *iov;
+  int iovcnt;
 };
 
 static VALUE nogvl_writev(void *ptr)
 {
-   struct writev_args *args = ptr;
-
-   return (VALUE)writev(args->fd, args->iov, args->iovcnt);
+  struct writev_args *args = ptr;
+  return (VALUE)writev(args->fd, args->iov, args->iovcnt);
 }
 
 /*
@@ -518,75 +444,68 @@ static VALUE nogvl_writev(void *ptr)
  * Returns the number of bytes written.
  */
 static VALUE s_io_writev(VALUE klass, VALUE fd, VALUE ary) {
-   ssize_t result = 0;
-   ssize_t left;
-   struct writev_args args;
-
-   args.fd = NUM2INT(fd);
-   ARY2IOVEC(args.iov, args.iovcnt, left, ary);
-
-   for(;;) {
-#ifdef HAVE_RB_THREAD_CALL_WITHOUT_GVL
-      ssize_t w = (ssize_t)rb_thread_call_without_gvl(
-        (void*)nogvl_writev, &args, RUBY_UBF_IO, 0
-      );
-#else
-      ssize_t w = (ssize_t)rb_thread_blocking_region(
-        nogvl_writev, &args, RUBY_UBF_IO, 0
-      );
-#endif
+  ssize_t result = 0;
+  ssize_t left;
+  struct writev_args args;
 
-      if(w == -1) {
-         if (rb_io_wait_writable(args.fd)) {
-            continue;
-         } else {
-            if (result > 0) {
-               /*
-                * unlikely to hit this case, return the already written bytes,
-                * we'll let the next write (or close) fail instead
-                */
-               break;
-            }
-            rb_sys_fail("writev");
-         }
+  args.fd = NUM2INT(fd);
+  ARY2IOVEC(args.iov, args.iovcnt, left, ary);
+
+  for(;;) {
+    ssize_t w = (ssize_t)rb_thread_call_without_gvl(
+      (void*)nogvl_writev, &args, RUBY_UBF_IO, 0
+    );
+
+    if(w == -1){
+      if(rb_io_wait_writable(args.fd)){
+        continue;
+      }
+      else{
+        if(result > 0){
+          /* unlikely to hit this case, return the already written bytes,
+           * we'll let the next write (or close) fail instead */
+          break;
+        }
+        rb_sys_fail("writev");
       }
+    }
 
-      result += w;
-      if(w == left) {
-         break;
-      } else { /* partial write, this can get tricky */
-         int i;
-         struct iovec *new_iov = args.iov;
-
-         left -= w;
-
-         /* skip over iovecs we've already written completely */
-         for (i = 0; i < args.iovcnt; i++, new_iov++) {
-            if (w == 0)
-               break;
-
-            /*
-             * partially written iov,
-             * modify and retry with current iovec in front
-             */
-            if (new_iov->iov_len > (size_t)w) {
-               VALUE base = (VALUE)new_iov->iov_base;
-
-               new_iov->iov_len -= w;
-               new_iov->iov_base = (void *)(base + w);
-               break;
-            }
-
-            w -= new_iov->iov_len;
-         }
+    result += w;
+
+    if(w == left){
+      break;
+    }
+    else{
+      // Partial write, this can get tricky
+      int i;
+      struct iovec *new_iov = args.iov;
 
-         /* retry without the already-written iovecs */
-         args.iovcnt -= i;
-         args.iov = new_iov;
+      left -= w;
+
+      // Skip over iovecs we've already written completely
+      for(i = 0; i < args.iovcnt; i++, new_iov++){
+        if (w == 0)
+          break;
+
+        // Partially written iov, modify and retry with current iovec in front
+        if(new_iov->iov_len > (size_t)w){
+          VALUE base = (VALUE)new_iov->iov_base;
+
+          new_iov->iov_len -= w;
+          new_iov->iov_base = (void *)(base + w);
+          break;
+        }
+
+        w -= new_iov->iov_len;
       }
-   }
 
-   return LONG2NUM(result);
+      // Retry without the already-written iovecs
+      args.iovcnt -= i;
+      args.iov = new_iov;
+    }
+  }
+
+  return LONG2NUM(result);
 }
 #endif
 
@@ -617,47 +536,47 @@ static VALUE io_get_ttyname(VALUE self){
  * and IO#directio? instance methods (if supported on your platform).
  */
 void Init_extra(){
-   rb_define_singleton_method(rb_cIO, "closefrom", io_closefrom, 1);
+  rb_define_singleton_method(rb_cIO, "closefrom", io_closefrom, 1);
 
 #ifdef HAVE_FDWALK
-   rb_define_singleton_method(rb_cIO, "fdwalk", io_fdwalk, -1);
+  rb_define_singleton_method(rb_cIO, "fdwalk", io_fdwalk, -1);
 #endif
 
 #if defined(HAVE_DIRECTIO) || defined(O_DIRECT) || defined(F_NOCACHE)
-   rb_define_method(rb_cIO, "directio?", io_get_directio, 0);
-   rb_define_method(rb_cIO, "directio=", io_set_directio, 1);
+  rb_define_method(rb_cIO, "directio?", io_get_directio, 0);
+  rb_define_method(rb_cIO, "directio=", io_set_directio, 1);
 
-   /* 0: Applications get the default system behavior when accessing file data. */
-   rb_define_const(rb_cIO, "DIRECTIO_OFF", UINT2NUM(DIRECTIO_OFF));
+  /* 0: Applications get the default system behavior when accessing file data. */
+  rb_define_const(rb_cIO, "DIRECTIO_OFF", UINT2NUM(DIRECTIO_OFF));
 
-   /* 1: File data is not cached in the system's memory pages. */
-   rb_define_const(rb_cIO, "DIRECTIO_ON", UINT2NUM(DIRECTIO_ON));
+  /* 1: File data is not cached in the system's memory pages. */
+  rb_define_const(rb_cIO, "DIRECTIO_ON", UINT2NUM(DIRECTIO_ON));
 #endif
 
 #ifdef O_DIRECT
-   /* 040000: direct disk access (in Linux) */
-   rb_define_const(rb_cIO, "DIRECT", UINT2NUM(O_DIRECT));
+  /* 040000: direct disk access (in Linux) */
+  rb_define_const(rb_cIO, "DIRECT", UINT2NUM(O_DIRECT));
 #endif
 
-   rb_define_const(rb_cIO, "IOV_MAX", LONG2NUM(IOV_MAX));
+  rb_define_const(rb_cIO, "IOV_MAX", LONG2NUM(IOV_MAX));
 
 #ifdef HAVE_PREAD
-   rb_define_singleton_method(rb_cIO, "pread", s_io_pread, 3);
-   rb_define_singleton_method(rb_cIO, "pread_ptr", s_io_pread_ptr, 3);
+  rb_define_singleton_method(rb_cIO, "pread", s_io_pread, 3);
+  rb_define_singleton_method(rb_cIO, "pread_ptr", s_io_pread_ptr, 3);
 #endif
 
 #ifdef HAVE_PWRITE
-   rb_define_singleton_method(rb_cIO, "pwrite", s_io_pwrite, 3);
+  rb_define_singleton_method(rb_cIO, "pwrite", s_io_pwrite, 3);
 #endif
 
 #ifdef HAVE_WRITEV
-   rb_define_singleton_method(rb_cIO, "writev", s_io_writev, 2);
+  rb_define_singleton_method(rb_cIO, "writev", s_io_writev, 2);
 #endif
 
 #ifdef HAVE_TTYNAME
   rb_define_method(rb_cIO, "ttyname", io_get_ttyname, 0);
 #endif
 
-   /* 1.2.8: The version of this library. This a string. */
-   rb_define_const(rb_cIO, "EXTRA_VERSION", rb_str_new2("1.2.8"));
+  /* 1.3.0: The version of this library. */
+  rb_define_const(rb_cIO, "EXTRA_VERSION", rb_str_freeze(rb_str_new2("1.3.0")));
 }

data/lib/io-extra.rb

@@ -0,0 +1 @@
+require 'io/extra'

data/test/test_io_extra.rb

@@ -17,7 +17,8 @@ class TC_IO_Extra < Test::Unit::TestCase
   end
 
   def test_version
-    assert_equal('1.2.8', IO::EXTRA_VERSION)
+    assert_equal('1.3.0', IO::EXTRA_VERSION)
+    assert_true(IO::EXTRA_VERSION.frozen?)
   end
 
   def test_direct_constant

metadata

@@ -1,14 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: io-extra
 version: !ruby/object:Gem::Version
-  version: 1.2.8
+  version: 1.3.0
 platform: ruby
 authors:
 - Daniel J. Berger
 autorequire: 
 bindir: bin
-cert_chain: []
-date: 2014-12-29 00:00:00.000000000 Z
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEcDCCAtigAwIBAgIBATANBgkqhkiG9w0BAQsFADA/MREwDwYDVQQDDAhkamJl
+  cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+  MB4XDTE4MDMxODE1MjIwN1oXDTI4MDMxNTE1MjIwN1owPzERMA8GA1UEAwwIZGpi
+  ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
+  bTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBALgfaroVM6CI06cxr0/h
+  A+j+pc8fgpRgBVmHFaFunq28GPC3IvW7Nvc3Y8SnAW7pP1EQIbhlwRIaQzJ93/yj
+  u95KpkP7tA9erypnV7dpzBkzNlX14ACaFD/6pHoXoe2ltBxk3CCyyzx70mTqJpph
+  75IB03ni9a8yqn8pmse+s83bFJOAqddSj009sGPcQO+QOWiNxqYv1n5EHcvj2ebO
+  6hN7YTmhx7aSia4qL/quc4DlIaGMWoAhvML7u1fmo53CYxkKskfN8MOecq2vfEmL
+  iLu+SsVVEAufMDDFMXMJlvDsviolUSGMSNRTujkyCcJoXKYYxZSNtIiyd9etI0X3
+  ctu0uhrFyrMZXCedutvXNjUolD5r9KGBFSWH1R9u2I3n3SAyFF2yzv/7idQHLJJq
+  74BMnx0FIq6fCpu5slAipvxZ3ZkZpEXZFr3cIBtO1gFvQWW7E/Y3ijliWJS1GQFq
+  058qERadHGu1yu1dojmFRo6W2KZvY9al2yIlbkpDrD5MYQIDAQABo3cwdTAJBgNV
+  HRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUFZsMapgzJimzsbaBG2Tm8j5e
+  AzgwHQYDVR0RBBYwFIESZGpiZXJnOTZAZ21haWwuY29tMB0GA1UdEgQWMBSBEmRq
+  YmVyZzk2QGdtYWlsLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAW2tnYixXQtKxgGXq
+  /3iSWG2bLwvxS4go3srO+aRXZHrFUMlJ5W0mCxl03aazxxKTsVVpZD8QZxvK91OQ
+  h9zr9JBYqCLcCVbr8SkmYCi/laxIZxsNE5YI8cC8vvlLI7AMgSfPSnn/Epq1GjGY
+  6L1iRcEDtanGCIvjqlCXO9+BmsnCfEVehqZkQHeYczA03tpOWb6pon2wzvMKSsKH
+  ks0ApVdstSLz1kzzAqem/uHdG9FyXdbTAwH1G4ZPv69sQAFAOCgAqYmdnzedsQtE
+  1LQfaQrx0twO+CZJPcRLEESjq8ScQxWRRkfuh2VeR7cEU7L7KqT10mtUwrvw7APf
+  DYoeCY9KyjIBjQXfbj2ke5u1hZj94Fsq9FfbEQg8ygCgwThnmkTrrKEiMSs3alYR
+  ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
+  WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
+  -----END CERTIFICATE-----
+date: 2018-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: test-unit
@@ -38,22 +65,17 @@ extra_rdoc_files:
 - MANIFEST
 - ext/io/extra.c
 files:
-- ".gemtest"
-- CHANGES
-- MANIFEST
-- README
-- Rakefile
-- doc/io_extra.txt
-- examples/example_io_extra.rb
-- examples/example_pread.rb
-- ext/extconf.rb
-- ext/io/extra.c
-- io-extra.gemspec
-- test/test_io_extra.rb
-homepage: http://www.rubyforge.org/projects/shards
+- lib/io-extra.rb
+homepage: https://github.com/djberg96/io-extra
 licenses:
-- Artistic 2.0
-metadata: {}
+- Apache-2.0
+metadata:
+  homepage_uri: https://github.com/djberg96/io-extra
+  bug_tracker_uri: https://github.com/djberg96/io-extra/issues
+  changelog_uri: https://github.com/djberg96/io-extra/blob/master/CHANGES
+  documentation_uri: https://github.com/djberg96/io-extra/wiki
+  source_code_uri: https://github.com/djberg96/io-extra
+  wiki_uri: https://github.com/djberg96/io-extra/wiki
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -62,17 +84,17 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.8.6
+      version: 2.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: shards
-rubygems_version: 2.4.5
+rubyforge_project: 
+rubygems_version: 2.7.6
 signing_key: 
 specification_version: 4
-summary: Adds extra methods to the IO class.
+summary: Adds extra methods to the IO class
 test_files:
 - test/test_io_extra.rb

data/Rakefile

@@ -1,98 +0,0 @@
-require 'rake'
-require 'rake/clean'
-require 'rake/testtask'
-require 'rbconfig'
-include RbConfig
-
-CLEAN.include(
-  '**/*.gem',               # Gem files
-  '**/*.rbc',               # Rubinius
-  '**/*.o',                 # C object file
-  '**/*.log',               # Ruby extension build log
-  '**/Makefile',            # C Makefile
-  '**/conftest.dSYM',       # OS X build directory
-  "**/*.#{CONFIG['DLEXT']}" # C shared object
-)
-
-if File::ALT_SEPARATOR
-  STDERR.puts 'Not supported on this platform. Exiting.'
-  exit(-1)
-end
-
-desc "Build the io-extra library (but don't install it)"
-task :build => [:clean] do
-  Dir.chdir('ext') do
-    ruby 'extconf.rb'
-    sh 'make'
-    build_file = File.join(Dir.pwd, 'extra.' + CONFIG['DLEXT'])
-    Dir.mkdir('io') unless File.exists?('io')
-    FileUtils.cp(build_file, 'io')
-  end
-end
-
-namespace :gem do
-  desc 'Create the io-extra gem'
-  task :create => [:clean] do
-    spec = eval(IO.read('io-extra.gemspec'))
-    if Gem::VERSION.to_f >= 2.0
-      require 'rubygems/package'
-      Gem::Package.build(spec)
-    else
-      Gem::Builder.new(spec).build
-    end
-  end
-
-  desc "Install the io-extra library as a gem"
-  task :install => [:create] do
-    file = Dir["io-extra*.gem"].last
-    sh "gem install -l #{file}"
-  end
-end
-
-namespace :archive do
-  spec = eval(IO.read('io-extra.gemspec'))
-  file = "io-extra-#{spec.version}"
-
-  desc 'Create an io-extra tarball.'
-  task :tar do
-    file = file + ".tar"
-    cmd  = "git archive --format=tar --prefix=#{file}/ -o #{file} HEAD"
-    sh cmd
-  end
-
-  desc 'Create a gzipped tarball for io-extra'
-  task :gz => [:tar] do
-    sh "gzip #{file}"
-  end
-
-  desc 'Create a bzip2 tarball for io-extra'
-  task :bz2 => [:tar] do
-    sh "bzip2 #{file}"
-  end
-
-  desc 'Create a zipped tarball for io-extra'
-  task :zip do
-    sh "git archive --format=zip --prefix=#{file}/ -o #{file}.zip HEAD"
-  end
-end
-
-desc "Run the example io-extra program"
-task :example => [:build] do
-  ruby '-Iext examples/example_io_extra.rb'
-end
-
-namespace :example do
-  desc "Run the IO.pread example program."
-  task :pread do
-    ruby '-Iext examples/example_io_extra.rb'
-  end
-end
-
-Rake::TestTask.new do |t|
-  task :test => :build
-  t.libs << 'ext'
-  t.verbose = true
-  t.warning = true
-end
-
-task :default => :test

data/doc/io_extra.txt

@@ -1,85 +0,0 @@
-= Description
-   The io-extra library provides a few extra IO methods that you may find
-   handy.
-	
-= Supported Platforms
-   Works on most Unix platforms.
-
-   Not supported on MS Windows or OS X.
-
-= Synopsis
-   require "io/extra"
-   
-   # Print the fileno of each file handle and then close it
-   IO.fdwalk(0){ |fh|
-      p fh.fileno
-      fh.close
-   }
-   
-   # Close all file handles with a fileno greater than or equal to 2.
-   IO.closefrom(2)
-   
-= Class Methods
-IO.closefrom(low_fd)
-   Closes all open file descriptors greater than or equal to 'low_fd'.
-   
-   This uses your systems native closefrom() function, if supported. If not,
-   this method uses a slightly less efficient manual approach that uses
-   getrlimit() behind the scenes.
-   
-IO.fdwalk(low_fd){ |fh| ... }
-   Iterates over each open file descriptor and yields back a File object.
-   Note that it is up to you to close file handles, if desired, when this
-   method is used.
-	
-   Not supported on all platforms.
-
-IO.pread(fd, length, offset)
-   Reads +length+ bytes of data from the given +fd+, starting at +offset.
-   The primary advantage of this method over Ruby's IO#read method is that
-   it performs the read without changing the file pointer.
-
-   Not supported on all platforms.
-
-IO.pwrite(fd, buf, offset)
-   Writes +buf+ to the given +fd+, starting at +offset. The primary advantage
-   of this method over a standard seek & write approach is that it performs
-   the write without changing the file pointer.
-
-   Not supported on all platforms.
-
-= Instance methods
-IO#directio?
-   Returns true or false, based on whether directio has been set for the
-   current handle. The default is false.
-   
-   Note supported on all platforms.
-   
-IO#directio=(io_const)
-   Sets the advice for the current file descriptor using directio().  Valid
-   values are IO::DIRECTIO_ON and IO::DIRECTIO_OFF.
-   
-   All file descriptors start at DIRECTIO_OFF, unless your filesystem has
-   been mounted using 'forcedirectio' (and supports that option).
-   
-   Not supported on all platforms
-   
-= Constants
-IO::DIRECTIO_ON
-   This value can be passed to IO#directio= in order to turn directio on for
-   the given file handle.
-   
-   This value is only defined if your platform supports the directio()
-   function.
-IO::DIRECTIO_OFF
-   This value can be passed to IO#directio= in order to turn directio off for
-   the given file handle.
-   
-   This value is only defined if your platform supports the directio()
-   function.
-   
-IO::EXTRA_VERSION
-   Returns the current version number of this library as a String.
-
-= Other documentation
-See the README for more documentation.

data/examples/example_io_extra.rb

@@ -1,42 +0,0 @@
-##############################################################################
-# test.rb
-#
-# This is a small test program for the io-extra library. Modify as you see
-# fit. You can run this via the 'rake example' task.
-##############################################################################
-require "io/extra"
-p IO::EXTRA_VERSION
-
-fh = File.open("foo.txt","w+")
-
-=begin
-p fh.directio?
-
-fh.directio = IO::DIRECTIO_ON
-p fh.directio?
-
-fh.close
-=end
-
-IO.fdwalk(0){ |handle|
-   p handle
-   p handle.fileno
-   puts
-}
-
-=begin
-STDIN.close
-
-# Should print "Hello" 2 times
-IO.fdwalk(0){ |fd|
-   puts "Hello #{fd}"
-}
-
-
-IO.closefrom(0)
-
-puts "Done" # Shouldn't see this
-=end
-
-fh.close
-File.delete("foo.txt") if File.exists?("foo.txt")

data/examples/example_pread.rb

@@ -1,24 +0,0 @@
-########################################################################
-# example_pread.rb
-#
-# Example program demonstrating the use of IO.pread.
-########################################################################
-require 'io/extra'
-require 'tmpdir'
-
-# Create a temporary file with a little data in it.
-file = File.join(Dir.tmpdir, 'pread_test.txt')
-File.open(file, 'w'){ |fh| 100.times{ |n| fh.puts "Hello: #{n}" } }
-
-# Read from the file using pread.
-begin
-  fh = File.open(file)
-
-  puts "Handle position before read: #{fh.pos}"
-  puts IO.pread(fh.fileno, 18, 0)
-
-  puts "Handle position after read: #{fh.pos}"
-  puts IO.pread(fh.fileno, 18, 0)
-ensure
-  fh.close
-end

data/io-extra.gemspec

@@ -1,38 +0,0 @@
-require 'rubygems'
-require 'rbconfig'
-
-Gem::Specification.new do |spec|
-  if File::ALT_SEPARATOR
-    STDERR.puts 'Not supported on this platform. Exiting.'
-    exit(-1)
-  end
-   
-  spec.name       = 'io-extra'
-  spec.version    = '1.2.8'
-  spec.author     = 'Daniel J. Berger'
-  spec.license    = 'Artistic 2.0'
-  spec.email      = 'djberg96@gmail.com'
-  spec.homepage   = 'http://www.rubyforge.org/projects/shards'
-  spec.summary    = 'Adds extra methods to the IO class.'
-  spec.test_file  = 'test/test_io_extra.rb'
-  spec.extensions = ['ext/extconf.rb']
-  spec.files      = Dir['**/*'] << '.gemtest'
-
-  spec.extra_rdoc_files = [
-    'CHANGES',
-    'README',
-    'MANIFEST',
-    'ext/io/extra.c'
-  ]
-
-  spec.rubyforge_project = 'shards'
-  spec.required_ruby_version = '>= 1.8.6'
-
-  spec.add_development_dependency('test-unit', '>= 2.5.0')
-   
-  spec.description = <<-EOF
-    Adds the IO.closefrom, IO.fdwalk, IO.pread, IO.pread_ptr, IO.pwrite, and
-    IO.writev singleton methods as well as the IO#directio, IO#directio? and
-    IO#ttyname instance methods (for those platforms that support them).
-  EOF
-end