https://github.com/jdenen/jsos
JSON as OpenStruct
https://github.com/jdenen/jsos
Last synced: 3 months ago
JSON representation
JSON as OpenStruct
- Host: GitHub
- URL: https://github.com/jdenen/jsos
- Owner: jdenen
- License: mit
- Created: 2015-12-31T14:45:37.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2016-02-08T21:08:53.000Z (over 9 years ago)
- Last Synced: 2024-10-29T08:24:20.697Z (8 months ago)
- Language: Ruby
- Homepage:
- Size: 18.6 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# JSOS
[](https://travis-ci.org/jdenen/jsos)
[](https://badge.fury.io/rb/jsos)
Use Ruby's OpenStruct object to represent JSON strings, making nested data a method call away.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'jsos'
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install jsos
## Usage
JSOS turns a JSON string into an OpenStruct. It also allows you to construct JSON strings from scratch. Setter methods are turned into JSON keys and their arguments become the values. Getter methods return those values.
```ruby
# parsing JSON into OpenStruct
jsos = JSOS.new("{\"foo\":\"bar\"}")
jsos.foo
#=> "bar"
# parsing Hash into OpenStruct
jsos = JSOS.new({foo: "bar"})
jsos.foo
#=> "bar"
# creating an empty object and converting to JSON
jsos = JSOS.new
jsos.to_json
#=> "{}"
# adding to the empty JSON
jsos.foo = "bar"
jsos.to_json
#=> "{\"foo\":\"bar\"}"
```
A missing getter method is created with an empty JSOS object as its value. This allows you to chain methods to created nested JSON strings.
```ruby
# nesting empty JSON objects
jsos = JSOS.new
jsos.foo
jsos.to_json
#=> "{\"foo\":{}}"
# chaining methods to create nested JSON strings
jsos = JSOS.new
jsos.abc.foo = "bar"
jsos.xyz.foo = "baz"
jsos.to_json
#=> "{\"abc\":{\"foo\":\"bar\"}, \"xyz\":{\"foo\":\"baz\"}}"
```
You can grab object level keys and values like a normal Ruby Hash. These do not return nested keys/values.
```ruby
jsos = JSOS.new("{\"abc\":{\"foo\":\"bar\"}, \"xyz\":{\"foo\":\"baz\"}}")
jsos.keys
#=> ["abc", "xyz"]
jsos.values
#=> ["#", "#"]
```
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/jdenen/jsos.
## License
The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).