sleepy_penguin.git  about / heads / tags
Linux I/O events for Ruby
$ git log --pretty=format:'%h %s (%cs)%d' v1.0.0 --
97e9a7e update documentation and build (2010-09-26)
	(tag: v1.0.0)
29bbb05 test_epoll: workaround less aggressive GC in rbx (2010-09-26)
43124e7 provide rb_io_close() for Rubinius (2010-09-26)
f3fd444 epoll: fix typo for rb_memerror() (2010-09-26)
63b5fa1 misc documentation updates (2010-09-26)
1ad58cb wire up EventFD class (2010-09-26)
2d58866 add TimerFD class (2010-09-26)
4a9ce03 epoll: add cross-thread test/example (2010-09-26)
96dad99 epoll: fix MRI 1.8 build (2010-09-26)
a226d23 Epoll#dup and Epoll#clone inherit close-on-exec (2010-09-26)
...

$ git cat-file blob v1.0.0:README
= sleepy_penguin - Ruby I/O events for Linux

sleepy_penguin provides access to newer, Linux-only system calls to wait
on events from traditionally non-I/O sources.  Bindings to the eventfd,
timerfd, and epoll interfaces are provided.

== Features

* Thread-safe blocking operations under both Ruby 1.8 and 1.9.

* Mostly working under Rubinius

* IO-like objects are backwards-compatible with IO.select.

* Epoll interface is fork-safe

* Unlike portable event frameworks, the Linux-only Epoll interface
  allows using edge-triggered I/O for possibly improved performance

== Install

If you're using a packaged Ruby distribution, make sure you have a C
compiler and the matching Ruby development libraries and headers.

If you use RubyGems:

    gem install sleepy_penguin

Otherwise grab the latest tarball from:

http://bogomips.org/sleepy_penguin/files/

Unpack it, and run "ruby setup.rb"

== Development

You can get the latest source via git from the following locations:

  git://git.bogomips.org/sleepy_penguin.git
  git://repo.or.cz/sleepy_penguin.git (mirror)

You may browse the code from the web and download the latest snapshot
tarballs here:

* http://git.bogomips.org/cgit/sleepy_penguin.git (cgit)
* http://repo.or.cz/w/sleepy_penguin.git (gitweb)

Inline patches (from "git format-patch") to the mailing list are
preferred because they allow code review and comments in the reply to
the patch.

We will adhere to mostly the same conventions for patch submissions as
git itself.  See the Documentation/SubmittingPatches document
distributed with git on on patch submission guidelines to follow.  Just
don't email the git mailing list or maintainer with sleepy_penguin patches.

== Contact

All feedback (bug reports, user/development discussion, patches, pull
requests) go to the mailing list: mailto:sleepy.penguin@librelist.com

* http://bogomips.org/sleepy_penguin/archives/

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master       sleepy_penguin 3.5.2 (2020-02-01)
  pu           favor require_relative over require (2017-03-17)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
v3.5.2       sleepy_penguin 3.5.2 (2020-02-01) tar.gz
v3.5.1       sleepy_penguin 3.5.1 (2018-12-15) tar.gz
v3.5.0       sleepy_penguin 3.5.0 (2017-03-22) tar.gz
v3.4.1       sleepy_penguin 3.4.1 - minor updates (2015-01-11) tar.gz
v3.4.0       sleepy_penguin 3.4.0 - minor updates (2015-01-11) tar.gz
v3.3.0       sleepy_penguin 3.3.0 - fixes and compatibility improvements (2013-12-30) tar.gz
v3.2.0       sleepy_penguin 3.2.0 - minor bug fixes, preliminary kqueue support (2013-07-16) tar.gz
v3.1.0       sleepy_penguin 3.1.0 - minor fixes and features (2012-05-02) tar.gz
v3.0.1       sleepy_penguin 3.0.1 - really avoids EINTR (2011-05-20) tar.gz
v3.0.0       sleepy_penguin 3.0.0 (2011-05-20) tar.gz
...

# associated public inboxes:
# (number on the left is used for dev purposes)
            https://yhbt.net/sleepy-penguin

git clone https://yhbt.net/sleepy_penguin.git