Rollcage

A Clojure client for Rollbar

Installation

Rollcage is available on Clojars.

Leiningen/Boot

[nedap/rollcage "1.0.0"]

Clojure CLI/deps.edn

nedap/rollcage {:mvn/version "1.0.0"}

Quickstart

You can send exceptions like this:

user=> (require '[nedap.rollcage.core :as rollcage])

user=> (def r (rollcage/client "access-token" {:environment "staging"}))

user=> (try
  #_=>   (/ 0)
  #_=>   (catch Exception e
  #_=>     (rollcage/error r e)))
{:err 0, :result {:id nil, :uuid "420cfa6e-40d1-431d-80ef-575520c40dd7"}}

You can also setup handler for all UncaughtExceptions. Call this fn during start-up procedure to ensure all uncaught exceptions will be sent to Rollbar.

user=> (rollcage/setup-uncaught-exception-handler r)

Contributing

If you would like to contibute to the project, please log an issue to discuss the feature/bug before submitting a pull request.

Testing

A full CI suite is run on CircleCI. You can run the unit-test suite locally by running lein test. Some tests require access to Rollbar, with a valid access token that has permission to post server items. The token should be specified in the ROLLBAR_ACCESS_TOKEN environment variable.

$ ROLLBAR_ACCESS_TOKEN=<your token> lein test

The tests that require access to Rollbar are annotated with the :integration metadata tag. You can exclude these by using the :unit test selector.

$ lein test :unit

Releasing

Releases are published to Clojars under the Nedap organisation. You can release a new version of Rollcage by editing the version string in project.clj according to semver. Then run

$ git tag v<version>
$ git push --tags

License

Distributed under the Eclipse Public License.