Hiroba is a minimalistic Clojure client for the Foursquare REST API.
This is not the first Clojure client for Foursquare, but it strives to be the best documented and most complete. The other pre-existing Clojure Foursquare clients available are:
trentonstrong/foursquare-clj- Seems to be abandoned, does not implement all endpoints, and is undocumented.transistorize/foursquare-clj- This is an abandoned project that implements a single endpoint, is not a library, and has no documentation.
- Be feature complete with the Foursquare API
- Be well documented
- Be well tested
- Be Clojuric, relying on Clojure idioms without introducing unnecessary abstractions
- Don't be subject to NIH Syndrome
- Be up-to-date with the latest Foursquare API changes
Hiroba is in its infancy. It is a new project, with only minimal use in production and testing environments at this point. The API is subject to change at any time, but will stabilize over time.
Please see the most recent changelog.
Hiroba artifacts are released to Clojars. If you are using Maven, add the following repository
definition to your pom.xml:
<repository>
<id>clojars.org</id>
<url>http://clojars.org/repo</url>
</repository>With Leiningen:
[com.mochify/hiroba "0.1.0-alpha"]
With Maven:
<dependency>
<groupId>com.mochify</groupId>
<artifactId>hiroba</artifactId>
<version>0.1.0-SNAPSHOT</version>
</dependency>
For the latest documentation, please see Hiroba's documentation site.
Hiroba is developed against Clojure 1.5.0 and newer. Use of the latest version is recommended.
Hiroba uses Leiningen 2. Make sure you have it installed and then run tests against supported Clojure versions using
lein2 test
Then create a branch and make your changes on it. Once you are done with your changes and all tests pass, submit a pull request on GitHub.
Copyright (C) 2014 William Lee, Alex Kuang, and The Mochify Team.
Licensed under the Apache Public License 2.0.