README.md in kurento_rails-0.1.0 vs README.md in kurento_rails-0.1.1

- old
+ new

@@ -1,11 +1,9 @@ # KurentoRails -Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/kurento_rails`. To experiment with that code, run `bin/console` for an interactive prompt. +KurentoRails is a gem designed to make integrating kurento media server and rails applications easier. We provide a javascript library to provide easy access to kurento's video streaming functionality. -TODO: Delete this and the text above, and describe your gem - ## Installation Add this line to your application's Gemfile: ```ruby @@ -18,23 +16,39 @@ Or install it yourself as: $ gem install kurento_rails + +For reasons that I'm not entirely sure about and don't have time to investigate just yet, the gem isn't correctly bundling websocket-rails in as well on some systems. If your app won't launch after you complete the steps listed below in usage, try fixing it by just adding websocket-rails to your gemfile as well, then re-running bundle. + ## Usage -TODO: Write usage instructions here +After installation, run the following command -## Development +```ruby +rails g kurento_rails:install +``` -After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment. +This will copy a number of files into your project. These are: +- config/events.rb: This file is responsible for routing websockets events to the correct controller and action +- app/controllers/kurento_controller.rb: This controller is used for serving html pages that interact with kurento. It should at least be a step in the right direction for you. +- app/controllers/kurento_websockets_controller.rb: This controller is responsible for most of the internal streaming logic. The javascript client library interacts heavily with this controller +- app/assets/javascripts/kurento-rails-js: This is the javascript client library. kurento-rails.js is the main code for the library. The other libraries included here are dependencies and should also be included. +- db/migrations/{timestamp}-create_video_streams.rb: This is the active record migration for the video stream model. +- app/models/kurento_rails_video_stream.rb: This is the video stream model +- app/views/kurento: This folder contains the views associated with the kurento controller. I assume that you're using slim, because slim is fantastic, but if you're not, you can just edit the extensions on these. -To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org). +finally, you'll need to migrate the database +```ruby +rake db:migrate +``` +After this, the installation process should be complete. + ## Contributing -Bug reports and pull requests are welcome on GitHub at https://github.com/andrewls/kurento-rails. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct. - +Bug reports and pull requests are welcome on GitHub at https://github.com/andrewls/kurento-rails. ## License The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).