A convenient Ruby wrapper around the GoodData RESTful API. The gem comes in two flavors. It has a CLI client and it is a library which you can integrate into your application.
The best documentation for the GoodData API can be found using these resources:
- https://sdk.gooddata.com/gooddata-ruby-doc
- http://developer.gooddata.com/api
- https://secure.gooddata.com/gdc
- http://rubydoc.info/gems/gooddata/frames
Feel free to check out the GoodData community website if you have any questions about the GoodData Analytics platform, our API, or this library.
In order to make the user experience with integrating GoodData Ruby SDK as smooth and secure as possible and to ensure that the SDK is using the latest features of the platform, we only provide support to the two most recent major versions of Ruby SDK.
The most recent majors will be supported in the following modes:
-
The latest major version will receive all new functionality and all bug fixes.
-
The previous major version will only receive fixes to critical issues and security fixes. These fixes will be applied on top of last released version of the previous major.
-
GoodData customer support will provide support for the latest major and previous major version only.
-
The customers are encouraged to always use the latest version of the Ruby SDK.
-
In case of using older versions, the user might face API incompatibility, performance or security issues.
Please follow the installation instructions in the repository to update to the newest version.
If you are using bundler, add
gem "gooddata"
into Gemfile
and run
bundle install
If you are using gems just
gem install gooddata
- Fork the project.
- Make your feature addition or bug fix.
- Add tests for it. This is important so I don't break it in a future version unintentionally.
- Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself we can ignore when we pull)
- run
rake testand make sure all tests pass - run
rake copand make sure you did not introduce any new coding rules issues - Send us a pull request. Bonus points for topic branches.
See our contribution guidelines.
Originally started by
Pavel Kolesnikov [ mailto:pavel@gooddata.com / @koles ]
Actively developed and maintained by
- Jan Zdráhal [ mailto:jan.zdrahal@gooddata.com ]
- Jakub Mahnert [ mailto:jakub.mahnert@gooddata.com ]
- Petr Gaďorek [ mailto:petr.gadorek@gooddata.com ]
Contributors
- Tomas Korcak [ mailto:korczis@gmail.com / @korczis ]
- Tomas Svarovsky [ mailto:svarovsky.tomas@gmail.com / @fluke777 ]
- Patrick McConlogue
- Petr Cvengros
For full contributor info see contributors page.
Special thanks to
- Thomas Watson Steen [ mailto:w@tson.dk / @wa7son ].
Copyright (c) 2010 - 2018 GoodData Corporation and Thomas Watson Steen. See LICENSE for details.