simon/gaza-stats
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
gaza-stats/README.md

2.8 KiB
Raw Blame History

gaza-stats

A Clojure library designed to explore donations data for people in Gaza whose accounts have been verified by the Gaza Verified volunteers.

Graph of donations between April 2024 and today

Dependencies

Usage

This is a very experimental, unfinished and unpolished library designed for use with leiningen. To use, clone this repository, connect to the directory into which you cloned it, and type lein repl.

At present two useful functions are implemented:

(total-donations-by-weeks start-date end-date)

Return a list of pairs [java.time.LocalDate date, float amount] representing the total of donations made between start-date and end-date. Arguments may be supplied as java.time.LocalDate objects, or as strings in the format yyyy-mm-dd. If end-date is not supplied, data for a single week will be returned.

(chart-total-donations-by-weeks start-date end-date)

Create and return an XY chart of data on total donations made between start-date and end-date. Arguments may be supplied as java.time.LocalDate objects, or as strings in the format yyyy-mm-dd.

Viewing charts

In your REPL, invoke (require '[com.hypirion.clj-xchart :refer [view]]). You can then invoke view on a chart returned by the above function, for example:

(view (chart-total-donations-by-weeks "2024-04-01" "2026-09-20"))

NOTE: Data

This code is designed to explore data in a SQLite database which it expects to be called app.db and find in its resources directory. This database is not included in this repository but may be downloaded from here.

NOTE: Use of SQL Korma

I used SQL Korma in this project because I know it and I like it, but it is no longer maintained and its website is no longer online. The last version I could find on the Internet Archive is here. The source code is on Github. It might be better to rewrite so as not to use it, especially given that (at present) the SQL usage is trivial.

License

Copyright © 2026 Simon Brooke.

This program and the accompanying materials are made available under the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version, with the GNU Classpath Exception which is available at https://www.gnu.org/software/classpath/license.html.