summaryrefslogtreecommitdiff
path: root/python-openfisca-country-template.spec
diff options
context:
space:
mode:
Diffstat (limited to 'python-openfisca-country-template.spec')
-rw-r--r--python-openfisca-country-template.spec692
1 files changed, 692 insertions, 0 deletions
diff --git a/python-openfisca-country-template.spec b/python-openfisca-country-template.spec
new file mode 100644
index 0000000..daa5878
--- /dev/null
+++ b/python-openfisca-country-template.spec
@@ -0,0 +1,692 @@
+%global _empty_manifest_terminate_build 0
+Name: python-OpenFisca-Country-Template
+Version: 5.0.0
+Release: 1
+Summary: OpenFisca tax and benefit system for Country-Template
+License: http://www.fsf.org/licensing/licenses/agpl-3.0.html
+URL: https://github.com/openfisca/country-template
+Source0: https://mirrors.nju.edu.cn/pypi/web/packages/d5/e3/bffe0add9488c4d75607c6d345fbfadf77af1c497b3729e9e98e467fae4a/OpenFisca-Country-Template-5.0.0.tar.gz
+BuildArch: noarch
+
+Requires: python3-openfisca-core[web-api]
+Requires: python3-autopep8
+Requires: python3-flake8
+Requires: python3-flake8-bugbear
+Requires: python3-flake8-builtins
+Requires: python3-flake8-coding
+Requires: python3-flake8-commas
+Requires: python3-flake8-comprehensions
+Requires: python3-flake8-docstrings
+Requires: python3-flake8-import-order
+Requires: python3-flake8-print
+Requires: python3-flake8-quotes
+Requires: python3-flake8-simplify
+Requires: python3-flake8-use-fstring
+Requires: python3-importlib-metadata
+Requires: python3-pycodestyle
+Requires: python3-pylint
+
+%description
+# OpenFisca Country-Template
+
+This repository helps you quickly bootstrap and use your own OpenFisca country package.
+
+**You should NOT fork it but [download a copy](https://github.com/openfisca/country-template/archive/master.zip) of it** and follow the bootstrapping instructions below.
+
+> Otherwise, you will have to clean up all tags when you deploy your own country package.
+
+
+## Bootstrapping your Country Package
+
+This set of instructions will create your own copy of this boilerplate directory and customise it to the country you want to work on. You will need to have [Git](https://git-scm.com) installed.
+
+1. [Download a copy](https://github.com/openfisca/country-template/archive/master.zip) of this repository, unzip it and `cd` into it in a Terminal window.
+
+2. Create a new repository on your favourite git host (Github, Bitbucket, GitLab, etc) with the name openfisca-your_country_name. For example, `openfisca-france`.
+
+3. Set up the two following variables and execute the `bootstrap.sh` script to initialise the git repository and replace all references to `openfisca_country_template` with references to your new country package in the code base:
+
+```sh
+export COUNTRY_NAME=France # set the name of your country here; you should keep all capitals, and replace any spaces in the name by underscores
+export REPOSITORY_URL=https://github.com/YOUR_ORGANISATION/OpenFisca-$COUNTRY_NAME # set here the URL of the repository you created in step 2.
+./bootstrap.sh
+```
+
+4. Push your changes to your git host:
+
+```sh
+git push origin master
+```
+
+That's it, you're all set!
+
+## Writing the Legislation
+
+The country whose law is modelled here has a very simple tax and benefit system.
+
+- It has a flat rate tax whose rates increase every year.
+- On the first of December, 2015, it introduced a basic income for all its citizens of age who have no income.
+- On the first of December, 2016, it removed the income condition, providing all its adult citizens with a basic income.
+
+These elements are described in different folders. All the modelling happens within the `openfisca_country_template` folder.
+
+- The rates are in the `parameters` folder.
+- The formulas are in the `variables` folder.
+- This country package comes also with *reforms* in the `reforms` folder. This is optional: your country may exist without defining any reform.
+ - In this country, there is [a reform project](./openfisca_country_template/reforms/modify_social_security_taxation.py) aiming to modify the social security taxation, deleting the first bracket, raising the intermediary ones and adding a new bracket with a higher tax rate of `40 %` for people earning more than `40000`. This reform project would apply starting from `2017-01-01`.
+
+The files that are outside from the `openfisca_country_template` folder are used to set up the development environment.
+
+## Packaging your Country Package for Distribution
+
+Country packages are python distributions. To distribute your package via `pip`, follow the steps given by the [Python Packaging Authority](https://python-packaging-user-guide.readthedocs.io/tutorials/distributing-packages/#packaging-your-project).
+
+## Install Instructions for Users and Contributors
+
+This package requires [Python 3.7](https://www.python.org/downloads/release/python-370/). More recent versions should work, but are not tested.
+
+All platforms that can execute Python are supported, which includes GNU/Linux, macOS and Microsoft Windows (in which case we recommend using [ConEmu](https://conemu.github.io/) instead of the default console).
+
+### Setting-up a Virtual Environment with venv
+
+In order to limit dependencies conflicts, we recommend using a [virtual environment](https://www.python.org/dev/peps/pep-0405/) with [venv](https://docs.python.org/3/library/venv.html).
+
+- A [venv](https://docs.python.org/3/library/venv.html) is a project specific environment created to suit the needs of the project you are working on.
+
+To create a virtual environment, launch a terminal on your computer, `cd` into your directory and follow these instructions:
+
+```sh
+python3 -m venv openfisca # create a new venv called “openfisca”
+source openfisca/bin/activate # activate the venv
+```
+
+You can now operate in the venv you just created.
+
+You can deactivate that venv at any time with `deactivate`.
+
+:tada: You are now ready to install this OpenFisca Country Package!
+
+Two install procedures are available. Pick procedure A or B below depending on how you plan to use this Country Package.
+
+### A. Minimal Installation (Pip Install)
+
+Follow this installation if you wish to:
+- run calculations on a large population;
+- create tax & benefits simulations;
+- write an extension to this legislation (e.g. city specific tax & benefits);
+- serve your Country Package with the OpenFisca Web API.
+
+For more advanced uses, head to the [Advanced Installation](#advanced-installation-git-clone).
+
+#### Install this Country Package with Pip Install
+
+Inside your venv, check the prerequisites:
+
+```sh
+python --version # should print "Python 3.7.xx".
+```
+
+```sh
+pip --version # should print at least 9.0.
+# if not, run "pip install --upgrade pip"
+```
+Install the Country Package:
+
+```sh
+pip install openfisca_country_template
+```
+
+:warning: Please beware that installing the Country Package with `pip` is dependent on its maintainers publishing said package.
+
+:tada: This OpenFisca Country Package is now installed and ready!
+
+#### Next Steps
+
+- To learn how to use OpenFisca, follow our [tutorials](https://openfisca.org/doc/).
+- To serve this Country Package, serve the [OpenFisca web API](#serve-your-country-package-with-the-openFisca-web-api).
+
+Depending on what you want to do with OpenFisca, you may want to install yet other packages in your venv:
+- To install extensions or write on top of this Country Package, head to the [Extensions documentation](https://openfisca.org/doc/contribute/extensions.html).
+- To plot simulation results, try [matplotlib](http://matplotlib.org/).
+- To manage data, check out [pandas](http://pandas.pydata.org/).
+
+### B. Advanced Installation (Git Clone)
+
+Follow this tutorial if you wish to:
+- create or change this Country Package's legislation;
+- contribute to the source code.
+
+#### Clone this Country Package with Git
+
+First, make sure [Git](https://www.git-scm.com/) is installed on your machine.
+
+Set your working directory to the location where you want this OpenFisca Country Package cloned.
+
+Inside your venv, check the prerequisites:
+
+```sh
+python --version # should print "Python 3.7.xx".
+```
+
+```sh
+pip --version # should print at least 9.0.
+# if not, run "pip install --upgrade pip"
+```
+Clone this Country Package on your machine:
+
+```sh
+git clone https://github.com/openfisca/openfisca-country-template.git
+cd openfisca-country-template
+pip install --editable .[dev]
+```
+
+You can make sure that everything is working by running the provided tests with `make test`.
+
+> [Learn more about tests](https://openfisca.org/doc/coding-the-legislation/writing_yaml_tests.html)
+
+:tada: This OpenFisca Country Package is now installed and ready!
+
+#### Next Steps
+
+- To write new legislation, read the [Coding the legislation](https://openfisca.org/doc/coding-the-legislation/index.html) section to know how to write legislation.
+- To contribute to the code, read our [Contribution Guidebook](https://openfisca.org/doc/contribute/index.html).
+
+## Serve this Country Package with the OpenFisca Web API
+
+If you are considering building a web application, you can use the packaged OpenFisca Web API with your Country Package.
+
+To serve the Openfisca Web API locally, run:
+
+```sh
+openfisca serve --port 5000
+```
+
+Or use the quick-start Make command:
+
+```
+make serve-local
+```
+
+To read more about the `openfisca serve` command, check out its [documentation](https://openfisca.org/doc/openfisca-python-api/openfisca_serve.html).
+
+You can make sure that your instance of the API is working by requesting:
+
+```sh
+curl "http://localhost:5000/spec"
+```
+
+This endpoint returns the [Open API specification](https://www.openapis.org/) of your API.
+
+:tada: This OpenFisca Country Package is now served by the OpenFisca Web API! To learn more, go to the [OpenFisca Web API documentation](https://openfisca.org/doc/openfisca-web-api/index.html).
+
+You can test your new Web API by sending it example JSON data located in the `situation_examples` folder.
+
+Substitute your package's country name for `openfisca_country_template` below:
+
+```sh
+curl -X POST -H "Content-Type: application/json" \
+ -d @./openfisca_country_template/situation_examples/couple.json \
+ http://localhost:5000/calculate
+```
+
+
+%package -n python3-OpenFisca-Country-Template
+Summary: OpenFisca tax and benefit system for Country-Template
+Provides: python-OpenFisca-Country-Template
+BuildRequires: python3-devel
+BuildRequires: python3-setuptools
+BuildRequires: python3-pip
+%description -n python3-OpenFisca-Country-Template
+# OpenFisca Country-Template
+
+This repository helps you quickly bootstrap and use your own OpenFisca country package.
+
+**You should NOT fork it but [download a copy](https://github.com/openfisca/country-template/archive/master.zip) of it** and follow the bootstrapping instructions below.
+
+> Otherwise, you will have to clean up all tags when you deploy your own country package.
+
+
+## Bootstrapping your Country Package
+
+This set of instructions will create your own copy of this boilerplate directory and customise it to the country you want to work on. You will need to have [Git](https://git-scm.com) installed.
+
+1. [Download a copy](https://github.com/openfisca/country-template/archive/master.zip) of this repository, unzip it and `cd` into it in a Terminal window.
+
+2. Create a new repository on your favourite git host (Github, Bitbucket, GitLab, etc) with the name openfisca-your_country_name. For example, `openfisca-france`.
+
+3. Set up the two following variables and execute the `bootstrap.sh` script to initialise the git repository and replace all references to `openfisca_country_template` with references to your new country package in the code base:
+
+```sh
+export COUNTRY_NAME=France # set the name of your country here; you should keep all capitals, and replace any spaces in the name by underscores
+export REPOSITORY_URL=https://github.com/YOUR_ORGANISATION/OpenFisca-$COUNTRY_NAME # set here the URL of the repository you created in step 2.
+./bootstrap.sh
+```
+
+4. Push your changes to your git host:
+
+```sh
+git push origin master
+```
+
+That's it, you're all set!
+
+## Writing the Legislation
+
+The country whose law is modelled here has a very simple tax and benefit system.
+
+- It has a flat rate tax whose rates increase every year.
+- On the first of December, 2015, it introduced a basic income for all its citizens of age who have no income.
+- On the first of December, 2016, it removed the income condition, providing all its adult citizens with a basic income.
+
+These elements are described in different folders. All the modelling happens within the `openfisca_country_template` folder.
+
+- The rates are in the `parameters` folder.
+- The formulas are in the `variables` folder.
+- This country package comes also with *reforms* in the `reforms` folder. This is optional: your country may exist without defining any reform.
+ - In this country, there is [a reform project](./openfisca_country_template/reforms/modify_social_security_taxation.py) aiming to modify the social security taxation, deleting the first bracket, raising the intermediary ones and adding a new bracket with a higher tax rate of `40 %` for people earning more than `40000`. This reform project would apply starting from `2017-01-01`.
+
+The files that are outside from the `openfisca_country_template` folder are used to set up the development environment.
+
+## Packaging your Country Package for Distribution
+
+Country packages are python distributions. To distribute your package via `pip`, follow the steps given by the [Python Packaging Authority](https://python-packaging-user-guide.readthedocs.io/tutorials/distributing-packages/#packaging-your-project).
+
+## Install Instructions for Users and Contributors
+
+This package requires [Python 3.7](https://www.python.org/downloads/release/python-370/). More recent versions should work, but are not tested.
+
+All platforms that can execute Python are supported, which includes GNU/Linux, macOS and Microsoft Windows (in which case we recommend using [ConEmu](https://conemu.github.io/) instead of the default console).
+
+### Setting-up a Virtual Environment with venv
+
+In order to limit dependencies conflicts, we recommend using a [virtual environment](https://www.python.org/dev/peps/pep-0405/) with [venv](https://docs.python.org/3/library/venv.html).
+
+- A [venv](https://docs.python.org/3/library/venv.html) is a project specific environment created to suit the needs of the project you are working on.
+
+To create a virtual environment, launch a terminal on your computer, `cd` into your directory and follow these instructions:
+
+```sh
+python3 -m venv openfisca # create a new venv called “openfisca”
+source openfisca/bin/activate # activate the venv
+```
+
+You can now operate in the venv you just created.
+
+You can deactivate that venv at any time with `deactivate`.
+
+:tada: You are now ready to install this OpenFisca Country Package!
+
+Two install procedures are available. Pick procedure A or B below depending on how you plan to use this Country Package.
+
+### A. Minimal Installation (Pip Install)
+
+Follow this installation if you wish to:
+- run calculations on a large population;
+- create tax & benefits simulations;
+- write an extension to this legislation (e.g. city specific tax & benefits);
+- serve your Country Package with the OpenFisca Web API.
+
+For more advanced uses, head to the [Advanced Installation](#advanced-installation-git-clone).
+
+#### Install this Country Package with Pip Install
+
+Inside your venv, check the prerequisites:
+
+```sh
+python --version # should print "Python 3.7.xx".
+```
+
+```sh
+pip --version # should print at least 9.0.
+# if not, run "pip install --upgrade pip"
+```
+Install the Country Package:
+
+```sh
+pip install openfisca_country_template
+```
+
+:warning: Please beware that installing the Country Package with `pip` is dependent on its maintainers publishing said package.
+
+:tada: This OpenFisca Country Package is now installed and ready!
+
+#### Next Steps
+
+- To learn how to use OpenFisca, follow our [tutorials](https://openfisca.org/doc/).
+- To serve this Country Package, serve the [OpenFisca web API](#serve-your-country-package-with-the-openFisca-web-api).
+
+Depending on what you want to do with OpenFisca, you may want to install yet other packages in your venv:
+- To install extensions or write on top of this Country Package, head to the [Extensions documentation](https://openfisca.org/doc/contribute/extensions.html).
+- To plot simulation results, try [matplotlib](http://matplotlib.org/).
+- To manage data, check out [pandas](http://pandas.pydata.org/).
+
+### B. Advanced Installation (Git Clone)
+
+Follow this tutorial if you wish to:
+- create or change this Country Package's legislation;
+- contribute to the source code.
+
+#### Clone this Country Package with Git
+
+First, make sure [Git](https://www.git-scm.com/) is installed on your machine.
+
+Set your working directory to the location where you want this OpenFisca Country Package cloned.
+
+Inside your venv, check the prerequisites:
+
+```sh
+python --version # should print "Python 3.7.xx".
+```
+
+```sh
+pip --version # should print at least 9.0.
+# if not, run "pip install --upgrade pip"
+```
+Clone this Country Package on your machine:
+
+```sh
+git clone https://github.com/openfisca/openfisca-country-template.git
+cd openfisca-country-template
+pip install --editable .[dev]
+```
+
+You can make sure that everything is working by running the provided tests with `make test`.
+
+> [Learn more about tests](https://openfisca.org/doc/coding-the-legislation/writing_yaml_tests.html)
+
+:tada: This OpenFisca Country Package is now installed and ready!
+
+#### Next Steps
+
+- To write new legislation, read the [Coding the legislation](https://openfisca.org/doc/coding-the-legislation/index.html) section to know how to write legislation.
+- To contribute to the code, read our [Contribution Guidebook](https://openfisca.org/doc/contribute/index.html).
+
+## Serve this Country Package with the OpenFisca Web API
+
+If you are considering building a web application, you can use the packaged OpenFisca Web API with your Country Package.
+
+To serve the Openfisca Web API locally, run:
+
+```sh
+openfisca serve --port 5000
+```
+
+Or use the quick-start Make command:
+
+```
+make serve-local
+```
+
+To read more about the `openfisca serve` command, check out its [documentation](https://openfisca.org/doc/openfisca-python-api/openfisca_serve.html).
+
+You can make sure that your instance of the API is working by requesting:
+
+```sh
+curl "http://localhost:5000/spec"
+```
+
+This endpoint returns the [Open API specification](https://www.openapis.org/) of your API.
+
+:tada: This OpenFisca Country Package is now served by the OpenFisca Web API! To learn more, go to the [OpenFisca Web API documentation](https://openfisca.org/doc/openfisca-web-api/index.html).
+
+You can test your new Web API by sending it example JSON data located in the `situation_examples` folder.
+
+Substitute your package's country name for `openfisca_country_template` below:
+
+```sh
+curl -X POST -H "Content-Type: application/json" \
+ -d @./openfisca_country_template/situation_examples/couple.json \
+ http://localhost:5000/calculate
+```
+
+
+%package help
+Summary: Development documents and examples for OpenFisca-Country-Template
+Provides: python3-OpenFisca-Country-Template-doc
+%description help
+# OpenFisca Country-Template
+
+This repository helps you quickly bootstrap and use your own OpenFisca country package.
+
+**You should NOT fork it but [download a copy](https://github.com/openfisca/country-template/archive/master.zip) of it** and follow the bootstrapping instructions below.
+
+> Otherwise, you will have to clean up all tags when you deploy your own country package.
+
+
+## Bootstrapping your Country Package
+
+This set of instructions will create your own copy of this boilerplate directory and customise it to the country you want to work on. You will need to have [Git](https://git-scm.com) installed.
+
+1. [Download a copy](https://github.com/openfisca/country-template/archive/master.zip) of this repository, unzip it and `cd` into it in a Terminal window.
+
+2. Create a new repository on your favourite git host (Github, Bitbucket, GitLab, etc) with the name openfisca-your_country_name. For example, `openfisca-france`.
+
+3. Set up the two following variables and execute the `bootstrap.sh` script to initialise the git repository and replace all references to `openfisca_country_template` with references to your new country package in the code base:
+
+```sh
+export COUNTRY_NAME=France # set the name of your country here; you should keep all capitals, and replace any spaces in the name by underscores
+export REPOSITORY_URL=https://github.com/YOUR_ORGANISATION/OpenFisca-$COUNTRY_NAME # set here the URL of the repository you created in step 2.
+./bootstrap.sh
+```
+
+4. Push your changes to your git host:
+
+```sh
+git push origin master
+```
+
+That's it, you're all set!
+
+## Writing the Legislation
+
+The country whose law is modelled here has a very simple tax and benefit system.
+
+- It has a flat rate tax whose rates increase every year.
+- On the first of December, 2015, it introduced a basic income for all its citizens of age who have no income.
+- On the first of December, 2016, it removed the income condition, providing all its adult citizens with a basic income.
+
+These elements are described in different folders. All the modelling happens within the `openfisca_country_template` folder.
+
+- The rates are in the `parameters` folder.
+- The formulas are in the `variables` folder.
+- This country package comes also with *reforms* in the `reforms` folder. This is optional: your country may exist without defining any reform.
+ - In this country, there is [a reform project](./openfisca_country_template/reforms/modify_social_security_taxation.py) aiming to modify the social security taxation, deleting the first bracket, raising the intermediary ones and adding a new bracket with a higher tax rate of `40 %` for people earning more than `40000`. This reform project would apply starting from `2017-01-01`.
+
+The files that are outside from the `openfisca_country_template` folder are used to set up the development environment.
+
+## Packaging your Country Package for Distribution
+
+Country packages are python distributions. To distribute your package via `pip`, follow the steps given by the [Python Packaging Authority](https://python-packaging-user-guide.readthedocs.io/tutorials/distributing-packages/#packaging-your-project).
+
+## Install Instructions for Users and Contributors
+
+This package requires [Python 3.7](https://www.python.org/downloads/release/python-370/). More recent versions should work, but are not tested.
+
+All platforms that can execute Python are supported, which includes GNU/Linux, macOS and Microsoft Windows (in which case we recommend using [ConEmu](https://conemu.github.io/) instead of the default console).
+
+### Setting-up a Virtual Environment with venv
+
+In order to limit dependencies conflicts, we recommend using a [virtual environment](https://www.python.org/dev/peps/pep-0405/) with [venv](https://docs.python.org/3/library/venv.html).
+
+- A [venv](https://docs.python.org/3/library/venv.html) is a project specific environment created to suit the needs of the project you are working on.
+
+To create a virtual environment, launch a terminal on your computer, `cd` into your directory and follow these instructions:
+
+```sh
+python3 -m venv openfisca # create a new venv called “openfisca”
+source openfisca/bin/activate # activate the venv
+```
+
+You can now operate in the venv you just created.
+
+You can deactivate that venv at any time with `deactivate`.
+
+:tada: You are now ready to install this OpenFisca Country Package!
+
+Two install procedures are available. Pick procedure A or B below depending on how you plan to use this Country Package.
+
+### A. Minimal Installation (Pip Install)
+
+Follow this installation if you wish to:
+- run calculations on a large population;
+- create tax & benefits simulations;
+- write an extension to this legislation (e.g. city specific tax & benefits);
+- serve your Country Package with the OpenFisca Web API.
+
+For more advanced uses, head to the [Advanced Installation](#advanced-installation-git-clone).
+
+#### Install this Country Package with Pip Install
+
+Inside your venv, check the prerequisites:
+
+```sh
+python --version # should print "Python 3.7.xx".
+```
+
+```sh
+pip --version # should print at least 9.0.
+# if not, run "pip install --upgrade pip"
+```
+Install the Country Package:
+
+```sh
+pip install openfisca_country_template
+```
+
+:warning: Please beware that installing the Country Package with `pip` is dependent on its maintainers publishing said package.
+
+:tada: This OpenFisca Country Package is now installed and ready!
+
+#### Next Steps
+
+- To learn how to use OpenFisca, follow our [tutorials](https://openfisca.org/doc/).
+- To serve this Country Package, serve the [OpenFisca web API](#serve-your-country-package-with-the-openFisca-web-api).
+
+Depending on what you want to do with OpenFisca, you may want to install yet other packages in your venv:
+- To install extensions or write on top of this Country Package, head to the [Extensions documentation](https://openfisca.org/doc/contribute/extensions.html).
+- To plot simulation results, try [matplotlib](http://matplotlib.org/).
+- To manage data, check out [pandas](http://pandas.pydata.org/).
+
+### B. Advanced Installation (Git Clone)
+
+Follow this tutorial if you wish to:
+- create or change this Country Package's legislation;
+- contribute to the source code.
+
+#### Clone this Country Package with Git
+
+First, make sure [Git](https://www.git-scm.com/) is installed on your machine.
+
+Set your working directory to the location where you want this OpenFisca Country Package cloned.
+
+Inside your venv, check the prerequisites:
+
+```sh
+python --version # should print "Python 3.7.xx".
+```
+
+```sh
+pip --version # should print at least 9.0.
+# if not, run "pip install --upgrade pip"
+```
+Clone this Country Package on your machine:
+
+```sh
+git clone https://github.com/openfisca/openfisca-country-template.git
+cd openfisca-country-template
+pip install --editable .[dev]
+```
+
+You can make sure that everything is working by running the provided tests with `make test`.
+
+> [Learn more about tests](https://openfisca.org/doc/coding-the-legislation/writing_yaml_tests.html)
+
+:tada: This OpenFisca Country Package is now installed and ready!
+
+#### Next Steps
+
+- To write new legislation, read the [Coding the legislation](https://openfisca.org/doc/coding-the-legislation/index.html) section to know how to write legislation.
+- To contribute to the code, read our [Contribution Guidebook](https://openfisca.org/doc/contribute/index.html).
+
+## Serve this Country Package with the OpenFisca Web API
+
+If you are considering building a web application, you can use the packaged OpenFisca Web API with your Country Package.
+
+To serve the Openfisca Web API locally, run:
+
+```sh
+openfisca serve --port 5000
+```
+
+Or use the quick-start Make command:
+
+```
+make serve-local
+```
+
+To read more about the `openfisca serve` command, check out its [documentation](https://openfisca.org/doc/openfisca-python-api/openfisca_serve.html).
+
+You can make sure that your instance of the API is working by requesting:
+
+```sh
+curl "http://localhost:5000/spec"
+```
+
+This endpoint returns the [Open API specification](https://www.openapis.org/) of your API.
+
+:tada: This OpenFisca Country Package is now served by the OpenFisca Web API! To learn more, go to the [OpenFisca Web API documentation](https://openfisca.org/doc/openfisca-web-api/index.html).
+
+You can test your new Web API by sending it example JSON data located in the `situation_examples` folder.
+
+Substitute your package's country name for `openfisca_country_template` below:
+
+```sh
+curl -X POST -H "Content-Type: application/json" \
+ -d @./openfisca_country_template/situation_examples/couple.json \
+ http://localhost:5000/calculate
+```
+
+
+%prep
+%autosetup -n OpenFisca-Country-Template-5.0.0
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+ find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+ find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+ find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+ find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+ find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-OpenFisca-Country-Template -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Fri May 05 2023 Python_Bot <Python_Bot@openeuler.org> - 5.0.0-1
+- Package Spec generated