Overview ======== What is Open Spending --------------------- `Open Spending`_ is about mapping the money - Where it comes from and where it goes to It's a project that aims to track every (public) government and corporate financial transaction across the world and present it in useful and engaging forms for everyone from a school-child to a data geek. We're exploring, structuring and mapping out different kinds of public finance from all around the world - state budgets, spending reports, grants and subsidy data. .. _Open Spending: http://openspending.org/ What's wdmmg ------------ (`wdmmg`) is the pylons application that drives th `Open Spending`_ website. It queries the database and serves it as websites or json. The project started out as `Where does my money go`_, which is the reason for the name :mod:`wdmmg`. Add-Ons for wdmmg ----------------- Some functionality is moved into external packages. Unless noted these packages are available from the Open Knowledge Foundation `bitbucket repositories`_ `wdmmg-ext` Data loaders - extract and clean up datasets and load them into a wdmmg database. `wdmmg-datatables` Display data tables for view breakdowns, using some deep JS magic. `wdmmg-disqus` Disqus commenting for Where does my Money go? Derived from ckanext-disqus. `wdmmg-flash` Flash visualizations used on the original "Where does my money go" `dashboard <http://wheredoesmymoneygo.org/dashboard>` `wdmmg-js` Javascript-based 'rich internet applications' for Where Does My Money Go? `wdmmg-treemap` Plugin for WhereDoesMyMoneyGo to display view breakdowns as treemaps, using theJit Related repositories '''''''''''''''''''' * Flash sources Sources for the bubble charts on `Where does my money go`_ http://www.iconomical.com/svnrepos/wdmmg/ More Information ---------------- Read the wdmmg in the /doc subdirectory. This is a Sphinx_ project, so you can create other formats, e.g. html. You can find more information about the project and the community on the `Open Spending`_ homepage and in the `Open Spending wiki`_ Maybe some information .. _Open Spending wiki: http://wiki.openspending.org/Main_Page Where to get help ----------------- Feel free to catch us * on the Open Spending mailing lists * `wdmmg-discuss <http://lists.okfn.org/mailman/listinfo/wdmmg-discuss>` * `wdmmg-dev <http://lists.okfn.org/mailman/listinfo/wdmmg-dev>` * `wdmmg-announce <http://lists.okfn.org/mailman/listinfo/wdmmg-discuss>` * or in the irc channel: `#wdmmg on irc.oftc.net <irc://irc.oftc.net/%23wdmmg>` * or use our Q&A forum: http://ask.wheredoesmymoneygo.org/ Hacking on Open Spending ------------------------ There are different fields where you can get active. * You can find, collect, prepare and publish data. A related project, `CKAN <http://ckan.net>` is dedicated to get, use and share these data. * You can help with the :mod:`wdmmg` pylons application that drives the website. See the :doc:`install` documentation. * If you have interesting data this data needs to be loaded into `wdmmg`. You can write a loader, either in :mod:`wdmmg-ext` which provides some infrastructure too, or your own package. Let us know on the mailing lists. All our packages are available in the `Open Knowledge Foundation`_ `bitbucket repositories`_ . We use trac to track bugs and other tickets at http://trac.openspending.org/ For reference: There is an `**old** trac site`_ that is no longer used. Generally development is in Python. Currently Pylons 1 is used to present a web interface. You'll likely need to use virtualenv to manage the ad hoc dependencies (of which there are many). To get started installing the WDMMG app see doc/install.rst Mercurial Crib sheet '''''''''''''''''''' All of our repositories are Mercurial_ repositories. The following is fairly standard Mercurial stuff, but still useful] You can get started with the following command: hg clone https://bitbucket.org/okfn/wdmmg This will download a copy of the repository, and put it inside a newly-created wdmmg directory. To check-in your changes: hg ci hg push To get other people's changes: hg pull hg up To avoid typing in your password every time you push, edit the file wdmmg/.hg/hgrc . You should see a line giving the URL from which you cloned the repository. Add your username and password to the line as follows: [paths] default = https://username:password@bitbucket.org/okfn/wdmmg License ------- Copyright (and Database Rights) (c) 2010 the Open Knowledge Foundation, <info@okfn.org>. Unless otherwise stated: * Any rights in code are licensed under the `GNU Affero GPL`_ v3 * Any rights in content are licensed under a `Creative Commons Attribution-ShareAlike`_ license (all jurisdictions) * Any rights in data(bases) are licensed under a the `Open Data Commons ODbL`_ (Open Database License) .. _GNU Affero GPL: http://www.fsf.org/licensing/licenses/agpl-3.0.html .. _Creative Commons Attribution-ShareAlike: http://creativecommons.org/licenses/by-sa/3.0/ .. _Open Data Commons ODbL: http://www.opendatacommons.org/licenses/odbl/1.0/ .. _Open Knowledge Foundation: http://okfn.org .. _Where does my money go: http://wheredoesmymoneygo.org/ .. _bitbucket repositories: https://bitbucket.org/okfn .. _**old** trac site: http://knowledgeforge.net/okfn/tasks/query?component=projects.wdmmg .. _Sphinx: http://sphinx.pocoo.org .. _Mercurial: http://mercurial.selenic.com/