Birdmonger
A Finagle-based (via TwitterServer) Rack server for JRuby. Includes all the benefits of Finagle and TwitterServer. Requires no legacy war stuff, so no Warbler.
Specs are forked from Fishwife, which in turn is forked from Mizuno.
Installation
Add this line to your application's Gemfile:
gem 'birdmonger'
And then execute:
$ bundle
Or install it yourself as:
$ gem install birdmonger
Usage
$ rackup -s Birdmonger
Or with e.g. Rails
$ RACK_HANDLER=Birdmonger rails s
Development
After checking out the repo, run bundle install
to install dependencies. Compile Scala code with sbt clean compile
. Run tests: bundle exec rspec
. Package a new gem with bundle exec rake build
.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/mebe/birdmonger.
Ruby code should roughly follow https://github.com/bbatsov/ruby-style-guide.
Acknowledgements
Development is being sponsored by RELEX Solutions. Go check them out!
TODO
- Add CLI to start Birdmonger
- Support HTTPS
- Support H2
- Support hijacks?
- Fix sleep in spec before(:all)
- Add a script that updates the NOTICE file and licenses/ files automatically
License
The Gem packaged release of this software bundles some of its dependencies. See NOTICE for all attribution notices. See licenses/ subdirectory for the individual licenses of components without specific NOTICE policies.
Birdmonger
Copyright (c) 2018 Iikka Niinivaara, RELEX Solutions
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at:
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Fishwife
Copyright (c) 2011-2017 David Kellum
Licensed under the Apache Public License, version 2.0.
Mizuno
Copyright (c) 2010-2011 Don Werve
Licensed under the Apache Public License, version 2.0.