pysupuesto


Namepysupuesto JSON
Version 0.2.3 PyPI version JSON
download
home_pageNone
SummaryMódulo para descargar bases de diferentes ejercicios (o series temporales) del presupuesto público nacional argentino desde el Ministerio de Economía
upload_time2024-04-07 17:31:20
maintainerNone
docs_urlNone
author@Mato
requires_pythonNone
licenseMIT
keywords presupuesto budget
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Pysupuesto
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) 
 [![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/) 
 [![PyPI version](https://badge.fury.io/py/pysupuesto.svg)](https://pypi.org/project/pysupuesto/) 
 [![Fork](https://img.shields.io/github/forks/matog/pysupuesto?style=social)](https://github.com/login?return_to=%2Fmatog%2Fpysupuesto) 
 [![Twitter](https://img.shields.io/twitter/follow/matog?style=social)](https://twitter.com/mato)

 
Modulo de python que permite descargar información presupuestaria de [Presupuesto Abierto](https://www.presupuestoabierto.gob.ar/sici/datos-abiertos). El sitio contiene diversa información presupuestaria desde el ejercicio 1995 a la actualidad.

La motivación para programar este modulo fue la necesidad de contar, de forma sencilla, con series temporales de información presupuestaria. El 'Sitio del ciudadano' permite descargar año por año, pero no una base con una serie temporal que incluya varios ejercicios.

Pysupuesto, mediante ``get_data`` descarga, por el momento, información de crédito y su ejecución, y de recursos. De periodicidad anual, mensual y diaria (según el periodo). 

Tambien, utilizando ``get_docs``, muestra los recursos (en términos de información) disponibles para cada año, por si es necesario descargar manualmente información complementaria.

## Requerimientos

- Python 3.8
- beautifulsoup4=>4.10.0
- bs4=>0.0.1
- pandas=>1.3.3

## Modo de uso

### Instalación

	pip install pysupuesto

### Import

	import pysupuesto
	
### Sintaxis GET_DATA
 
	df = pysupuesto.get_data('tipo', 'periodicidad', ejercicio inicio, ejercicio cierre)
	
Donde:

- ``tipo``: Por el momento, sólo toma dos valores
    - ``recursos``: Devuelve los recursos presupeustarios.
	- ``credito``: Devuelve la ejecución presupuestaria.
- ``periodicidad``: Dependiendo el año, puede ser:
	- ``a``: Anual (desde 1995 a 2021)
	- ``m``: Mensual (desde 1995 a 2021)
	- ``d``: Diaria (desde 2017 a 2021)
- ``ejercicio inicio``: Ejercicio desde el cual se quiere descargar la información
- ``ejercicio cierre``: Hasta el ejercicio hasta el cual se quiere descargar información. Puede omitirse para sólo descargar 'ejercicio inicio'.

La información es descargada a un dataframe (llamado ``df`` en el ejemplo).

![imagen](https://user-images.githubusercontent.com/660448/133935451-02c52268-383d-4ee9-b2a9-e19cd2cc201f.png)

### Ejemplos

#### Crédito y ejecución

Descargar la información del crédito presupuestario y su ejecución del ejercicio 2018, con periodicidad diaria:

	df = pysupuesto.get_data('credito','d', 2018)
	
Descargar la información del crédito presupuestario y su ejecución desde el ejercicio 1995 al 2021, con periodicidad anual:

	df = pysupuesto.get_data('credito','a', 1995,2021)

#### Recursos 

Descargar la información de recursos presupuestarios del ejercicio 1997, con periodicidad mensual:

	df = pysupuesto.get_data('recursos','m', 1997)
	
Descargar la información de recursos presupuestarios desde el ejercicio 2001 al ejercicio 2005, con periodicidad anual:

	df = pysupuesto.get_data('recursos','a', 2001, 2005)
	
### Sintaxis GET_DOCS

	pysupuesto.get_docs(ejercicio)

Devuelve un print con todos los archivos disponibles para ese ejercicio.

![imagen](https://user-images.githubusercontent.com/660448/133935782-8763d117-0d48-4a26-bba2-f713781e1cd0.png)

## ToDo:

- ~~Empaquetar y compartir en [pypi](https://pypi.org/) para que esté disponible mediante ``pip install``~~
- Mejorar el sistema de logs.
- Intentar analizar toda la información disponible (para eso cree ``get_docs``) para expandir el modulo y poner a disposición mayor cantidad descargas.


	


CHANGELOG

VERSION 0.2.2:
- Update url for downloading data from years 2019-2023
- Change 'append' (now deprecated) package for 'concat'.
VERSION 0.2.2:
- Change url for downloading data from years 1995-2018

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "pysupuesto",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "presupuesto, budget",
    "author": "@Mato",
    "author_email": "no@email.org",
    "download_url": "https://files.pythonhosted.org/packages/5c/8c/dc2b99a90f59c65333db165ef5d483f84ab71ccc229a1872af1ab7ec0ab3/pysupuesto-0.2.3.tar.gz",
    "platform": null,
    "description": "# Pysupuesto\n [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) \n [![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/) \n [![PyPI version](https://badge.fury.io/py/pysupuesto.svg)](https://pypi.org/project/pysupuesto/) \n [![Fork](https://img.shields.io/github/forks/matog/pysupuesto?style=social)](https://github.com/login?return_to=%2Fmatog%2Fpysupuesto) \n [![Twitter](https://img.shields.io/twitter/follow/matog?style=social)](https://twitter.com/mato)\n\n \nModulo de python que permite descargar informaci\u00f3n presupuestaria de [Presupuesto Abierto](https://www.presupuestoabierto.gob.ar/sici/datos-abiertos). El sitio contiene diversa informaci\u00f3n presupuestaria desde el ejercicio 1995 a la actualidad.\n\nLa motivaci\u00f3n para programar este modulo fue la necesidad de contar, de forma sencilla, con series temporales de informaci\u00f3n presupuestaria. El 'Sitio del ciudadano' permite descargar a\u00f1o por a\u00f1o, pero no una base con una serie temporal que incluya varios ejercicios.\n\nPysupuesto, mediante ``get_data`` descarga, por el momento, informaci\u00f3n de cr\u00e9dito y su ejecuci\u00f3n, y de recursos. De periodicidad anual, mensual y diaria (seg\u00fan el periodo). \n\nTambien, utilizando ``get_docs``, muestra los recursos (en t\u00e9rminos de informaci\u00f3n) disponibles para cada a\u00f1o, por si es necesario descargar manualmente informaci\u00f3n complementaria.\n\n## Requerimientos\n\n- Python 3.8\n- beautifulsoup4=>4.10.0\n- bs4=>0.0.1\n- pandas=>1.3.3\n\n## Modo de uso\n\n### Instalaci\u00f3n\n\n\tpip install pysupuesto\n\n### Import\n\n\timport pysupuesto\n\t\n### Sintaxis GET_DATA\n \n\tdf = pysupuesto.get_data('tipo', 'periodicidad', ejercicio inicio, ejercicio cierre)\n\t\nDonde:\n\n- ``tipo``: Por el momento, s\u00f3lo toma dos valores\n    - ``recursos``: Devuelve los recursos presupeustarios.\n\t- ``credito``: Devuelve la ejecuci\u00f3n presupuestaria.\n- ``periodicidad``: Dependiendo el a\u00f1o, puede ser:\n\t- ``a``: Anual (desde 1995 a 2021)\n\t- ``m``: Mensual (desde 1995 a 2021)\n\t- ``d``: Diaria (desde 2017 a 2021)\n- ``ejercicio inicio``: Ejercicio desde el cual se quiere descargar la informaci\u00f3n\n- ``ejercicio cierre``: Hasta el ejercicio hasta el cual se quiere descargar informaci\u00f3n. Puede omitirse para s\u00f3lo descargar 'ejercicio inicio'.\n\nLa informaci\u00f3n es descargada a un dataframe (llamado ``df`` en el ejemplo).\n\n![imagen](https://user-images.githubusercontent.com/660448/133935451-02c52268-383d-4ee9-b2a9-e19cd2cc201f.png)\n\n### Ejemplos\n\n#### Cr\u00e9dito y ejecuci\u00f3n\n\nDescargar la informaci\u00f3n del cr\u00e9dito presupuestario y su ejecuci\u00f3n del ejercicio 2018, con periodicidad diaria:\n\n\tdf = pysupuesto.get_data('credito','d', 2018)\n\t\nDescargar la informaci\u00f3n del cr\u00e9dito presupuestario y su ejecuci\u00f3n desde el ejercicio 1995 al 2021, con periodicidad anual:\n\n\tdf = pysupuesto.get_data('credito','a', 1995,2021)\n\n#### Recursos \n\nDescargar la informaci\u00f3n de recursos presupuestarios del ejercicio 1997, con periodicidad mensual:\n\n\tdf = pysupuesto.get_data('recursos','m', 1997)\n\t\nDescargar la informaci\u00f3n de recursos presupuestarios desde el ejercicio 2001 al ejercicio 2005, con periodicidad anual:\n\n\tdf = pysupuesto.get_data('recursos','a', 2001, 2005)\n\t\n### Sintaxis GET_DOCS\n\n\tpysupuesto.get_docs(ejercicio)\n\nDevuelve un print con todos los archivos disponibles para ese ejercicio.\n\n![imagen](https://user-images.githubusercontent.com/660448/133935782-8763d117-0d48-4a26-bba2-f713781e1cd0.png)\n\n## ToDo:\n\n- ~~Empaquetar y compartir en [pypi](https://pypi.org/) para que est\u00e9 disponible mediante ``pip install``~~\n- Mejorar el sistema de logs.\n- Intentar analizar toda la informaci\u00f3n disponible (para eso cree ``get_docs``) para expandir el modulo y poner a disposici\u00f3n mayor cantidad descargas.\n\n\n\t\n\n\nCHANGELOG\n\nVERSION 0.2.2:\n- Update url for downloading data from years 2019-2023\n- Change 'append' (now deprecated) package for 'concat'.\nVERSION 0.2.2:\n- Change url for downloading data from years 1995-2018\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "M\u00f3dulo para descargar bases de diferentes ejercicios (o series temporales) del presupuesto p\u00fablico nacional argentino desde el Ministerio de Econom\u00eda",
    "version": "0.2.3",
    "project_urls": null,
    "split_keywords": [
        "presupuesto",
        " budget"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "cccd5f34574359f4b0148dd3dc58884c4669d2b4ee7f55980332187e7d0ea8a8",
                "md5": "2075cb74ce4b7d741a705ad6ee312ca3",
                "sha256": "445e6462763efee94591e381de1c9af063ce7c8b05f15f2d1c004f7013f606aa"
            },
            "downloads": -1,
            "filename": "pysupuesto-0.2.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2075cb74ce4b7d741a705ad6ee312ca3",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 4826,
            "upload_time": "2024-04-07T17:31:18",
            "upload_time_iso_8601": "2024-04-07T17:31:18.955508Z",
            "url": "https://files.pythonhosted.org/packages/cc/cd/5f34574359f4b0148dd3dc58884c4669d2b4ee7f55980332187e7d0ea8a8/pysupuesto-0.2.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5c8cdc2b99a90f59c65333db165ef5d483f84ab71ccc229a1872af1ab7ec0ab3",
                "md5": "9eac354dab505caf6982c07f794c6f8c",
                "sha256": "6183665cfa6323102efc259ab0cc2aec1e874d96d956c37df0a791deb7afa3e0"
            },
            "downloads": -1,
            "filename": "pysupuesto-0.2.3.tar.gz",
            "has_sig": false,
            "md5_digest": "9eac354dab505caf6982c07f794c6f8c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 5019,
            "upload_time": "2024-04-07T17:31:20",
            "upload_time_iso_8601": "2024-04-07T17:31:20.729403Z",
            "url": "https://files.pythonhosted.org/packages/5c/8c/dc2b99a90f59c65333db165ef5d483f84ab71ccc229a1872af1ab7ec0ab3/pysupuesto-0.2.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-07 17:31:20",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "pysupuesto"
}
        
Elapsed time: 0.51129s