/suchwow

Functions and behaviors not present in Clojure core. Support for creating and using your own "favorite functions" namespace. Better docstrings for clojure.core functions. More expansive versions of clojure.core functions.

Primary LanguageClojureThe UnlicenseUnlicense

Such Wow

The API documentation index gives an overview of what this library offers.

Snippets from serious work, wrapped in a whimsical container. A bit of a tribute to the spirit of _why, but with a Shiba Inu instead of foxes.

This package offers three types of functions:

  • clojure.core functions, but with better documentation (including examples).
  • Variants of clojure.core functions that accept more kinds of inputs.
  • A grab-bag of useful functions that, importantly, you can copy into your own code without worrying about licenses or giving credit or any of that. As a programmer trying to get work done, I use this library and others to create a "favorite functions" namespace that I use everywhere.

By Euterpia (Own work, CC0), via Wikimedia Commons
via Euterpia

Build Status

Such Usage

Available via clojars for Clojure 1.7+
For lein: [marick/suchwow "6.0.0"]

Much API doc

Copy the source if you want, do the normal (:require [such.types :as wow]) thing, or create your own commons.clojure.core namespace with all the things you think should be packaged with Clojure.

The files test/such/clojure/f_immigration.clj and commons.clojure.core show how to arrange for that last.

Such License

This software is covered by the Unlicense and, as such, is in the public domain.

Such Contributors

  • Alex Miller
  • Bahadir Cambel
  • Børge Svingen
  • Brian Marick

Such Contributing

Pull requests accepted, provided:

  1. Your contribution has tests. In keeping with the spirit of the library, they don't even have to be written with Midje, since Midje can run clojure.test tests.

  2. Your contribution doesn't depend on anything other than Clojure itself.

  3. You have the right to put your contribution into the public domain.

    To allow me to be a teensy bit scrupulous, please include the following text in the comment of your pull request:

    I dedicate any and all copyright interest in this software to the public domain. I make this dedication for the benefit of the public at large and to the detriment of my heirs and successors. I intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.