librelist archives

« back to archive

[ANN] mahoro 0.4 - documentation updates and concurrency

[ANN] mahoro 0.4 - documentation updates and concurrency

Eric Wong
2013-04-05 @ 22:51
All public API methods are now documented, using "ri" documentation
(built during the RubyGems install) is recommended for users.
Plain-text API documentation is also available online:

On Ruby 1.9 and 2.0, Mahoro now releases the GVL for all operations
which may touch the filesystem.  This allows several threads with
thread-local Mahoro objects to simultaneously work on multiple files at

Since libmagic is not thread-safe, neither is Mahoro (by default).  An
optional Mahoro::ThreadSafe module now exists for applications which may
spawn many short-lived threads.  Applications using long-lived threads
and needing real concurrency should use thread-local Mahoro objects
instead of the ThreadSafe module.

Eric Wong (10):
      INSTALL: improve documentation for deb/rpm-based distros
      gemspec: cleanup and update rdoc options
      add RDoc documentation
      test: be more flexible with Mahoro::NONE matches
      release GVL if filesystem I/O is required
      Mahoro#file supports objects with #to_path support
      split out nogvl_compat header
      cleanup: make cMahoro an automatic variable
      add optional thread-safety module
      tree reorganization + various maint fixes

source: git clone git://
cgit web viewer:
mailing list: (plain-text only, please)
maintainer: Eric Wong <>

Eric Wong