diff options
author | SHIBATA Hiroshi <hsbt@ruby-lang.org> | 2016-11-03 15:38:58 +0900 |
---|---|---|
committer | GitHub <noreply@github.com> | 2016-11-03 15:38:58 +0900 |
commit | 067dea3ea517003af07354c0f9b9a4a95f725e29 (patch) | |
tree | 5559534245aec9d8d9bfe1bb2b178a88020e67bc /README.md | |
parent | 6ac8b34dac9f8736be7cb937726e5d8902a8f815 (diff) | |
download | psych-067dea3ea517003af07354c0f9b9a4a95f725e29.tar.gz |
convert markdown format from rdoc (#294)
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 70 |
1 files changed, 70 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..627f34d --- /dev/null +++ b/README.md @@ -0,0 +1,70 @@ +# Psych + +* https://github.com/ruby/psych + +## Description + +Psych is a YAML parser and emitter. Psych leverages +[libyaml](http://pyyaml.org/wiki/LibYAML) for its YAML parsing and emitting +capabilities. In addition to wrapping libyaml, Psych also knows how to +serialize and de-serialize most Ruby objects to and from the YAML format. + +## Examples + + # Load YAML in to a Ruby object + Psych.load('--- foo') # => 'foo' + + # Emit YAML from a Ruby object + Psych.dump("foo") # => "--- foo\n...\n" + +## Dependencies + +* libyaml + +## Installation + +Psych has been included with MRI since 1.9.2, and is the default YAML parser +in 1.9.3. + +If you want a newer gem release of Psych, you can use rubygems: + + gem install psych + +In order to use the gem release in your app, and not the stdlib version, +you'll need the following: + + gem 'psych' + require 'psych' + +Or if you use Bundler add this to your `Gemfile`: + + gem 'psych' + +JRuby ships with a pure Java implementation of Psych. + +If you're on Rubinius, Psych is available in 1.9 mode, please refer to the +Language Modes section of the [Rubinius +README](https://github.com/rubinius/rubinius#readme) for more information on +building and 1.9 mode. + +## License + +Copyright 2009 Aaron Patterson, et al. + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the 'Software'), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. |