# Brazil Municipal Holidays
A Python library to manage municipal holidays in the cities of Juiz de Fora, Coronel Fabriciano, Ipatinga and Governador Valadares. This library allows users to check, create, delete and manipulate holidays, including marking non-mandatory holidays as mandatory and vice versa.
## Functionalities
- Check holidays: Retrieve holidays for specific cities.
- Create holidays: Add new holidays to the city's list of holidays.
- Delete Holidays: Remove holidays from the city's holiday list.
- Check optional holidays: Identify which holidays are optional.
- Manipulate holidays: Change the status of holidays from non-mandatory to mandatory and vice versa.
## Installation
You can install the library using pip:
```pip install feriados-municipios```
## How to use
Here are some examples to get you started:
Importing the Library
```from feriados_municipios import *```
## Initialize Variables
```
import feriados_municipios
from datetime import date
hoje = date.today()
feriados_municipios.FeriadosBrasil(hoje)
feriados_municipios.FeriadosBrasil.Ipatinga.init()
print(feriados_municipios.FeriadosBrasil.Ipatinga.get_feriados_regionais())
```
## Add a New Holiday to the List for a Specified City
```FeriadosBrasil.Ipatinga.new_feriado_personalizado(day=1, month=2, name="Example Holiday", facultativo=False)```
## Check if the Date and Holiday
```FeriadosBrasil.Ipatinga.is_feriado()```
## Set a Holiday as Optional
```FeriadosBrasil.Ipatinga.set_feriado_as_facultativo_by_date(20, 7)```
## Get Optional Holidays from a Municipality
```FeriadosBrasil.Ipatinga.get_feriados_facultativos()```
## Remove a Holiday
```FeriadosBrasil.Ipatinga.del_feriado_by_date(20, 7)```
## Contributions
We accept contributions! Please read our contributing guidelines for more information.
## License
This project is licensed under the MIT License - see the LICENSE file for more details.
Feel free to modify this template to better suit the specifics and structure of your library.
Raw data
{
"_id": null,
"home_page": null,
"name": "feriados-municipios",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "feriados br municipais brasil",
"author": "Luiz Fernando Teles Rodrigues",
"author_email": "euluizfernando2001@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3c/3e/0cd4c3a954c4073daac1bafc63acc69995d27fc2dfa2142ef50aec9b3d77/feriados_municipios-0.0.1.tar.gz",
"platform": null,
"description": "# Brazil Municipal Holidays\r\n\r\nA Python library to manage municipal holidays in the cities of Juiz de Fora, Coronel Fabriciano, Ipatinga and Governador Valadares. This library allows users to check, create, delete and manipulate holidays, including marking non-mandatory holidays as mandatory and vice versa.\r\n\r\n## Functionalities\r\n- Check holidays: Retrieve holidays for specific cities.\r\n- Create holidays: Add new holidays to the city's list of holidays.\r\n- Delete Holidays: Remove holidays from the city's holiday list.\r\n- Check optional holidays: Identify which holidays are optional.\r\n- Manipulate holidays: Change the status of holidays from non-mandatory to mandatory and vice versa.\r\n\r\n## Installation\r\nYou can install the library using pip:\r\n```pip install feriados-municipios```\r\n\r\n## How to use\r\nHere are some examples to get you started:\r\n\r\nImporting the Library\r\n```from feriados_municipios import *```\r\n\r\n## Initialize Variables\r\n\r\n```\r\nimport feriados_municipios\r\nfrom datetime import date\r\n\r\nhoje = date.today()\r\n\r\nferiados_municipios.FeriadosBrasil(hoje)\r\nferiados_municipios.FeriadosBrasil.Ipatinga.init()\r\n\r\nprint(feriados_municipios.FeriadosBrasil.Ipatinga.get_feriados_regionais())\r\n```\r\n\r\n## Add a New Holiday to the List for a Specified City\r\n```FeriadosBrasil.Ipatinga.new_feriado_personalizado(day=1, month=2, name=\"Example Holiday\", facultativo=False)```\r\n\r\n## Check if the Date and Holiday\r\n```FeriadosBrasil.Ipatinga.is_feriado()```\r\n\r\n## Set a Holiday as Optional\r\n```FeriadosBrasil.Ipatinga.set_feriado_as_facultativo_by_date(20, 7)```\r\n\r\n## Get Optional Holidays from a Municipality\r\n```FeriadosBrasil.Ipatinga.get_feriados_facultativos()```\r\n\r\n## Remove a Holiday\r\n```FeriadosBrasil.Ipatinga.del_feriado_by_date(20, 7)```\r\n\r\n## Contributions\r\nWe accept contributions! Please read our contributing guidelines for more information.\r\n\r\n## License\r\nThis project is licensed under the MIT License - see the LICENSE file for more details.\r\n\r\nFeel free to modify this template to better suit the specifics and structure of your library.\r\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Vers\u00e3o beta da biblioteca de feriados municipais.",
"version": "0.0.1",
"project_urls": null,
"split_keywords": [
"feriados",
"br",
"municipais",
"brasil"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fd3979fac57b9a2cc98fbc60cbb6d8ffca6fcf1436655ac1b2d315b5a0cec140",
"md5": "d7ed503eae94a219534102c6ce907129",
"sha256": "6feeec6fc2282cce98dbc4db98fb5311cec1ea21296c8fd009c5580fb585e42f"
},
"downloads": -1,
"filename": "feriados_municipios-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d7ed503eae94a219534102c6ce907129",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 7438,
"upload_time": "2024-07-23T00:17:36",
"upload_time_iso_8601": "2024-07-23T00:17:36.200169Z",
"url": "https://files.pythonhosted.org/packages/fd/39/79fac57b9a2cc98fbc60cbb6d8ffca6fcf1436655ac1b2d315b5a0cec140/feriados_municipios-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3c3e0cd4c3a954c4073daac1bafc63acc69995d27fc2dfa2142ef50aec9b3d77",
"md5": "16a8fa233968200a0403892d110819af",
"sha256": "9a3bf6e6ece75ef1220456d942b67261a5260a7d1f2e29f9fd92a4a3adf99c8b"
},
"downloads": -1,
"filename": "feriados_municipios-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "16a8fa233968200a0403892d110819af",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 7064,
"upload_time": "2024-07-23T00:17:37",
"upload_time_iso_8601": "2024-07-23T00:17:37.883660Z",
"url": "https://files.pythonhosted.org/packages/3c/3e/0cd4c3a954c4073daac1bafc63acc69995d27fc2dfa2142ef50aec9b3d77/feriados_municipios-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-23 00:17:37",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "feriados-municipios"
}
JSON