Skip to main content

A data model for anti corruption data modeling and analysis.

Project description

Follow the Money

ftm-build

This repository contains a pragmatic data model for the entities most commonly used in investigative reporting and financial crime investigations: people, companies, assets, payments, ownership relations, court cases, etc.

The purpose of this is not to model reality in an ideal data model, but rather to have a working data structure for researchers. Complex legal considerations are simplified to allow for efficient data processing.

followthemoney also contains code used to validate and normalize many of the elements of data, and to map tabular data into the model.

Documentation

For a general introduction to followthemoney, check the high-level introduction:

Part of this package is a command-line tool that can be used to process and transform data in various ways. You can find a tutorial here:

Besides the introductions, there is also a full reference documentation for the library and the contained ontology:

There's also a number of viewers for the RDF schema definitions generated from FollowTheMoney, eg:

Development environment

For local development with a virtualenv:

python3 -mvenv .env
source .env/bin/activate
pip install -e ".[dev]"

Now you can run the tests with

make test

Releasing

We release a lot of version of followthemoney because even small changes to the code base require a pypi release to begin being used in aleph. To this end, here's the steps for making a release:

git pull --rebase
make build
make test
git add . && git commit -m "Updating translation files"
bumpversion patch
git push --atomic origin main $(git describe --tags --abbrev=0)

This will create a new patch release and upload a distribution of it. If the changes are more significant, you can run bumpversion with the minor or major arguments.

When the schema is updated, please update the docs, ideally including the diagrams. For the RDF namespace and JavaScript version of the model, run make generate.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

followthemoney-3.8.5-py3-none-any.whl (464.7 kB view details)

Uploaded Python 3

File details

Details for the file followthemoney-3.8.5-py3-none-any.whl.

File metadata

  • Download URL: followthemoney-3.8.5-py3-none-any.whl
  • Upload date:
  • Size: 464.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for followthemoney-3.8.5-py3-none-any.whl
Algorithm Hash digest
SHA256 6db2c39db40d2c2ecc82352d518133a018ca0ebcad1941fdca5088b6b02a211f
MD5 dded236276a5a6b78088941d7b05406a
BLAKE2b-256 112b98ed47a7402ef7bafd729166d0b093da2a7a4bc6e96714fd5ffb6fa82dd9

See more details on using hashes here.

Provenance

The following attestation bundles were made for followthemoney-3.8.5-py3-none-any.whl:

Publisher: build.yml on opensanctions/followthemoney

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page