Skip to main content

An OpenFisca extension that adds some variables to an already-existing tax and benefit system.

Project description

OpenFisca Extension-Template

This repository is here to help you bootstrap your own OpenFisca extension package.

You should NOT fork it but download a copy of its source code and

  • change the name openfisca_extension_template to reflect your extension's name, e.g. openfisca_shangrila
  • empty out CHANGELOG.md
  • replace the placeholders variables and parameters to suit your own purposes

Installing

We recommend you to use an isolated environment manager to manage build and extension dependencies separately:

pipx install poetry
pipx install tox

Virtualenv

Poetry will automatically manage a virtual environment for you. Nonetheless, if you need to have more control over your dependencies, we recommend you to use a virtualenv:

manager to install OpenFisca:

poetry config settings.virtualenvs.create false
pyenv install 3.9.16
pyenv virtualenv 3.9.16 my-super-duper-extension-3.9.16
cd ~/path/where/is/my-super-duper-extension-3.9.16
pyenv local my-super-duper-extension-3.9.16

To install your extension for development, run:

poetry install --all-extras --sync

Testing

You can make sure that everything is working by running the provided tests:

poetry run openfisca test --country-package=openfisca_country_template --extensions=openfisca_extension_template openfisca_extension_template/tests

Learn more about tests.

Your extension package is now installed and ready!

Cleanup

To completely clean up your environment, run:

poetry env remove --all
pip freeze | grep -v "^-e" | sed "s/@.*//" | xargs pip uninstall -y

This will remove all pip package from current environment and remove all Poetry environment in OpenFisca Extension-Template.

Project details


Download files

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

Source Distribution

openfisca_extension_template-2.0.1.tar.gz (16.9 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file openfisca_extension_template-2.0.1.tar.gz.

File metadata

File hashes

Hashes for openfisca_extension_template-2.0.1.tar.gz
Algorithm Hash digest
SHA256 7f60eb7eeb7860814b5fc2b2c8d5c81b0c0df79b522488939211d2117a22c7dc
MD5 b3d3b6eedbe82c296e9a4c3a9fdc7d69
BLAKE2b-256 1e486d4a5edf146bb1023e3aa0f352a3ddc5e019d403cf91d8132ec3797f5b9b

See more details on using hashes here.

File details

Details for the file openfisca_extension_template-2.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for openfisca_extension_template-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 04b45a2e9172b92f3206d7edf8c9a5217fd44efb79198793c84cdcae8b6636b4
MD5 7d267e5f380ad0c290bf0b94aa288f48
BLAKE2b-256 83095b6cb0b31c8f3ebe85e83f4d27f07ae79f30b1e5ff09f67ae235f831cf9b

See more details on using hashes here.

Supported by

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