Fella

Fella is an expressive HTTP log handler for Crystal.

Installation

1. Add the dependency to your shard.yml:

   dependencies:
     fella:
       github: GrottoPress/fella

2. Run shards update

3. Require Fella:

   # ...
   require "fella"
   # ...

Usage

Pass an instance of Fella::Handler to the web server:

# ...
require "http/server"
require "fella"

Fella.configure do |settings|
  settings.request_id_header = "X-Request-ID"

  # Uses substring matching, so `token` would match `access_token`
  settings.filter_params = {"code", "password", "secret", "token"}
end

server = HTTP::Server.new([
  Fella::Handler.new(log: Log.for(MyApp)),
  # ...
])

server.bind_tcp("127.0.0.1", 8080)
server.listen
# ...

Development

Run tests with crystal spec.

Contributing

1. Fork it
2. Switch to the master branch: git checkout master
3. Create your feature branch: git checkout -b my-new-feature
4. Make your changes, updating changelog and documentation as appropriate.
5. Commit your changes: git commit
6. Push to the branch: git push origin my-new-feature
7. Submit a new Pull Request against the GrottoPress:master branch.