https://github.com/presidentbeef/ffi-gdbm
gdbm library using Ruby-FFI, particularly for JRuby
https://github.com/presidentbeef/ffi-gdbm
Last synced: 4 months ago
JSON representation
gdbm library using Ruby-FFI, particularly for JRuby
- Host: GitHub
- URL: https://github.com/presidentbeef/ffi-gdbm
- Owner: presidentbeef
- Created: 2009-09-23T08:28:56.000Z (over 15 years ago)
- Default Branch: master
- Last Pushed: 2019-02-05T23:09:53.000Z (about 6 years ago)
- Last Synced: 2024-12-24T00:13:56.057Z (4 months ago)
- Language: Ruby
- Homepage:
- Size: 58.6 KB
- Stars: 6
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## ffi-gdbm
An attempt to make [gdbm](http://www.vivtek.com/gdbm/) available beyond the C Ruby implementation.
Faithfully mimics MRI's standard library and is compatible with gdbm files produced by that version.
## Installing
You can download and use `gdbm.rb` anyhow you would like.
You can also install it using Ruby Gems:
`gem install ffi-gdbm`
or, if using JRuby:
`jgem install ffi-gdbm`
JRuby does not require further installation, but other implementations may need the FFI gem:
`gem install ffi`
## Notes
* Conforms to tests from MRI 1.8.7, 1.9.1, 2.6.1 and follows the C library for MRI if there are contradictions with the documentation
* Should be compatible with gdbm files created with MRI's standard library
* Certainly works with JRuby, may work with other alternative Ruby implementations
## Status
Tests passing on 64 bit Linux with
* JRuby 1.7.21 and 9.1.7.0
Tests passing on OSX (High Sierra) with
* JRuby 9.2.5.0
### Older Tests
Passing all tests with JRuby 1.4, 1.5.3, 1.6 on 32-bit Linux.
Passing all tests with MRI Ruby 1.8.7, 1.9.1, 1.9.2 with Ruby-FFI 0.5.4, 0.6.3, 1.0.7 on 32-bit Linux.
Further testing on other systems is welcome!
## Testing
Three sets of tests are included, copied straight from the MRI distribution. However, they do require the use of ObjectSpace, so this is how to run them with JRuby:
`jruby --1.8 -X+O -r lib/gdbm test/test_gdbm-1.8.7.rb` (Note: these tests only work with JRuby prior to 9.0.0.0)
`jruby -X+O -r ./lib/gdbm test/test_gdbm-1.9.1.rb`
`jruby -X+O -r ./lib/gdbm test/test_gdbm-2.6.rb`
## License
Copyright (c), Justin Collins
This library is released under the same tri-license (GPL/LGPL/CPL) as JRuby.
Please see the COPYING file distributed with JRuby for details.