Skip to content

mebe/birdmonger

Repository files navigation

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.