pynvest


Namepynvest JSON
Version 0.1.2 PyPI version JSON
download
home_pagehttps://pynvest.readthedocs.io/pt/latest/
SummaryUma forma fácil de extrair indicadores de ativos da bolsa B3
upload_time2024-02-29 21:49:43
maintainer
docs_urlNone
authorThiago Panini
requires_python>=3.0.0
licenseMIT
keywords b3 ativos fundos imobiliários mercado financeiro
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <div align="center">
    <br><img src="https://github.com/ThiagoPanini/pynvest/blob/v0.1.x/docs/assets/imgs/logo/logo-com-nome.png?raw=true" width=200 alt="pynvest-logo">
</div>

<div align="center">  
  <br>

  <a href="https://pypi.org/project/pynvest/">
    <img src="https://img.shields.io/pypi/v/pynvest?style=flate&logo=python&logoColor=FFFFFF&color=22C7FF" alt="PyPi shield">
  </a>

  <a href="">
    <img src="https://img.shields.io/pypi/dm/pynvest?logo=pypi&logoColor=FFFFFF&color=B252D0">
  </a>
  
  <a href="">
    <img src="https://img.shields.io/github/actions/workflow/status/ThiagoPanini/pynvest/ci-main.yml?label=ci&logo=github&logoColor=FFFFFF">
  </a>

  <a href="https://codecov.io/github/ThiagoPanini/pynvest">
    <img src="https://codecov.io/github/ThiagoPanini/pynvest/branch/main/graph/badge.svg?token=L4KO1RM63H">
  </a>

  <a href="https://pynvest.readthedocs.io/en/latest/?badge=latest">
    <img src="https://readthedocs.org/projects/pynvest/badge/?version=latest">
  </a>

  <br>

  <a href="https://www.python.org/">
    <img src="https://img.shields.io/badge/python-grey?style=for-the-badge&logo=python&logoColor=22C7FF">
  </a>

  <a href="https://docs.pytest.org/">
    <img src="https://img.shields.io/badge/pytest-grey?style=for-the-badge&logo=pytest&logoColor=22C7FF">
  </a>

  <a href="https://www.mkdocs.org/">
    <img src="https://img.shields.io/badge/mkdocs-grey?style=for-the-badge&logo=markdown&logoColor=22C7FF">
  </a>

  <a href="https://readthedocs.org/">
    <img src="https://img.shields.io/badge/readthedocs-grey?style=for-the-badge&logo=readthedocs&logoColor=22C7FF">
  </a>

  <a href="https://github.com/">
    <img src="https://img.shields.io/badge/github-grey?style=for-the-badge&logo=github&logoColor=22C7FF">
  </a>

</div>

___

<div align="center">
  <br>
</div>


## Visão Geral

A biblioteca `pynvest` foi criada para facilitar o processo de extração e análise de indicadores financeiros da bolsa de valores brasileira (B3). Isto é obtido através de *web scrappings* aplicados a plataformas/sites financeiros para extração de atributos e valores capazes de proporcionar, aos usuários, uma jornada interessante de análise de dados.

## Quickstart

A instalação da biblioteca pode ser feita através de qualquer gerenciador de pacotes Python, como o [pip](https://pip.pypa.io/en/stable/), por exemplo:

```python
pip install pynvest
```

A partir deste ponto, os usuários poderão utilizar *scrappers* capazes de entregar indicadores financeiros em formatos amigáveis (como DataFrames do [pandas](https://pandas.pydata.org/docs/index.html), por exemplo).

```python
# Importando classe
from pynvest.scrappers.fundamentus import Fundamentus

# Instanciando objeto da classe
pynvest_scrapper = Fundamentus()

# Obtendo indicadores financeiros de uma Ação
df_itub3 = pynvest_scrapper.coleta_indicadores_de_ativo("itub3")
```

<details>
  <summary>📽️ Demonstração de método de extração de indicadores financeiros</summary>

  [![Um GIF mostrando a execução do método coleta_indicadores_de_ativo() com o parâmetro "ticker" igual a uma ação (ex: "itub3")](https://github.com/ThiagoPanini/pynvest/blob/docs/atualizacao-de-documentacao/docs/assets/gifs/pynvest-coleta_indicadores_de_ativo_acao.gif?raw=true)](https://github.com/ThiagoPanini/pynvest/blob/docs/atualizacao-de-documentacao/docs/assets/gifs/pynvest-coleta_indicadores_de_ativo_acao.gif?raw=true)
  
</details>

## Readthedocs

📚 Para saber mais sobre essa iniciativa, acesse a [página oficial de documentação da biblitoeca](https://pynvest.readthedocs.io/pt/latest/) criada com carinho e dedicação para todos os interessados na solução. Viva o open source!


## Entre em Contato

- GitHub: [@ThiagoPanini](https://github.com/ThiagoPanini)
- LinkedIn: [Thiago Panini](https://www.linkedin.com/in/thiago-panini/)
- Hashnode: [panini-tech-lab](https://panini.hashnode.dev/)
- DevTo: [thiagopanini](https://dev.to/thiagopanini)

            

Raw data

            {
    "_id": null,
    "home_page": "https://pynvest.readthedocs.io/pt/latest/",
    "name": "pynvest",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.0.0",
    "maintainer_email": "",
    "keywords": "B3,Ativos,Fundos Imobili\u00e1rios,Mercado Financeiro",
    "author": "Thiago Panini",
    "author_email": "panini.development@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/e7/bd/755c29328520737247b7a513f105019d5b536c8a4f192309ae4cbce1ace5/pynvest-0.1.2.tar.gz",
    "platform": null,
    "description": "<div align=\"center\">\n    <br><img src=\"https://github.com/ThiagoPanini/pynvest/blob/v0.1.x/docs/assets/imgs/logo/logo-com-nome.png?raw=true\" width=200 alt=\"pynvest-logo\">\n</div>\n\n<div align=\"center\">  \n  <br>\n\n  <a href=\"https://pypi.org/project/pynvest/\">\n    <img src=\"https://img.shields.io/pypi/v/pynvest?style=flate&logo=python&logoColor=FFFFFF&color=22C7FF\" alt=\"PyPi shield\">\n  </a>\n\n  <a href=\"\">\n    <img src=\"https://img.shields.io/pypi/dm/pynvest?logo=pypi&logoColor=FFFFFF&color=B252D0\">\n  </a>\n  \n  <a href=\"\">\n    <img src=\"https://img.shields.io/github/actions/workflow/status/ThiagoPanini/pynvest/ci-main.yml?label=ci&logo=github&logoColor=FFFFFF\">\n  </a>\n\n  <a href=\"https://codecov.io/github/ThiagoPanini/pynvest\">\n    <img src=\"https://codecov.io/github/ThiagoPanini/pynvest/branch/main/graph/badge.svg?token=L4KO1RM63H\">\n  </a>\n\n  <a href=\"https://pynvest.readthedocs.io/en/latest/?badge=latest\">\n    <img src=\"https://readthedocs.org/projects/pynvest/badge/?version=latest\">\n  </a>\n\n  <br>\n\n  <a href=\"https://www.python.org/\">\n    <img src=\"https://img.shields.io/badge/python-grey?style=for-the-badge&logo=python&logoColor=22C7FF\">\n  </a>\n\n  <a href=\"https://docs.pytest.org/\">\n    <img src=\"https://img.shields.io/badge/pytest-grey?style=for-the-badge&logo=pytest&logoColor=22C7FF\">\n  </a>\n\n  <a href=\"https://www.mkdocs.org/\">\n    <img src=\"https://img.shields.io/badge/mkdocs-grey?style=for-the-badge&logo=markdown&logoColor=22C7FF\">\n  </a>\n\n  <a href=\"https://readthedocs.org/\">\n    <img src=\"https://img.shields.io/badge/readthedocs-grey?style=for-the-badge&logo=readthedocs&logoColor=22C7FF\">\n  </a>\n\n  <a href=\"https://github.com/\">\n    <img src=\"https://img.shields.io/badge/github-grey?style=for-the-badge&logo=github&logoColor=22C7FF\">\n  </a>\n\n</div>\n\n___\n\n<div align=\"center\">\n  <br>\n</div>\n\n\n## Vis\u00e3o Geral\n\nA biblioteca `pynvest` foi criada para facilitar o processo de extra\u00e7\u00e3o e an\u00e1lise de indicadores financeiros da bolsa de valores brasileira (B3). Isto \u00e9 obtido atrav\u00e9s de *web scrappings* aplicados a plataformas/sites financeiros para extra\u00e7\u00e3o de atributos e valores capazes de proporcionar, aos usu\u00e1rios, uma jornada interessante de an\u00e1lise de dados.\n\n## Quickstart\n\nA instala\u00e7\u00e3o da biblioteca pode ser feita atrav\u00e9s de qualquer gerenciador de pacotes Python, como o [pip](https://pip.pypa.io/en/stable/), por exemplo:\n\n```python\npip install pynvest\n```\n\nA partir deste ponto, os usu\u00e1rios poder\u00e3o utilizar *scrappers* capazes de entregar indicadores financeiros em formatos amig\u00e1veis (como DataFrames do [pandas](https://pandas.pydata.org/docs/index.html), por exemplo).\n\n```python\n# Importando classe\nfrom pynvest.scrappers.fundamentus import Fundamentus\n\n# Instanciando objeto da classe\npynvest_scrapper = Fundamentus()\n\n# Obtendo indicadores financeiros de uma A\u00e7\u00e3o\ndf_itub3 = pynvest_scrapper.coleta_indicadores_de_ativo(\"itub3\")\n```\n\n<details>\n  <summary>\ud83d\udcfd\ufe0f Demonstra\u00e7\u00e3o de m\u00e9todo de extra\u00e7\u00e3o de indicadores financeiros</summary>\n\n  [![Um GIF mostrando a execu\u00e7\u00e3o do m\u00e9todo coleta_indicadores_de_ativo() com o par\u00e2metro \"ticker\" igual a uma a\u00e7\u00e3o (ex: \"itub3\")](https://github.com/ThiagoPanini/pynvest/blob/docs/atualizacao-de-documentacao/docs/assets/gifs/pynvest-coleta_indicadores_de_ativo_acao.gif?raw=true)](https://github.com/ThiagoPanini/pynvest/blob/docs/atualizacao-de-documentacao/docs/assets/gifs/pynvest-coleta_indicadores_de_ativo_acao.gif?raw=true)\n  \n</details>\n\n## Readthedocs\n\n\ud83d\udcda Para saber mais sobre essa iniciativa, acesse a [p\u00e1gina oficial de documenta\u00e7\u00e3o da biblitoeca](https://pynvest.readthedocs.io/pt/latest/) criada com carinho e dedica\u00e7\u00e3o para todos os interessados na solu\u00e7\u00e3o. Viva o open source!\n\n\n## Entre em Contato\n\n- GitHub: [@ThiagoPanini](https://github.com/ThiagoPanini)\n- LinkedIn: [Thiago Panini](https://www.linkedin.com/in/thiago-panini/)\n- Hashnode: [panini-tech-lab](https://panini.hashnode.dev/)\n- DevTo: [thiagopanini](https://dev.to/thiagopanini)\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Uma forma f\u00e1cil de extrair indicadores de ativos da bolsa B3",
    "version": "0.1.2",
    "project_urls": {
        "Homepage": "https://pynvest.readthedocs.io/pt/latest/"
    },
    "split_keywords": [
        "b3",
        "ativos",
        "fundos imobili\u00e1rios",
        "mercado financeiro"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b860c7772cce6c9a37a9b8b147a4c655c2b3eb16a390be8cd2329dc0a8bc22cb",
                "md5": "efda66c88c37452dcd41d3b58397eb58",
                "sha256": "84625fd66d599ee1d308ce6c654ea507671cdf3d4b69fe43c97db8527adc8366"
            },
            "downloads": -1,
            "filename": "pynvest-0.1.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "efda66c88c37452dcd41d3b58397eb58",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.0.0",
            "size": 16502,
            "upload_time": "2024-02-29T21:49:41",
            "upload_time_iso_8601": "2024-02-29T21:49:41.747392Z",
            "url": "https://files.pythonhosted.org/packages/b8/60/c7772cce6c9a37a9b8b147a4c655c2b3eb16a390be8cd2329dc0a8bc22cb/pynvest-0.1.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e7bd755c29328520737247b7a513f105019d5b536c8a4f192309ae4cbce1ace5",
                "md5": "6b87958d02979199415f50fcb2075162",
                "sha256": "d586c8ee5822c9135557c2f3e9f8b163f9045a2e3d9344facf65d028fb3acf11"
            },
            "downloads": -1,
            "filename": "pynvest-0.1.2.tar.gz",
            "has_sig": false,
            "md5_digest": "6b87958d02979199415f50fcb2075162",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.0.0",
            "size": 16668,
            "upload_time": "2024-02-29T21:49:43",
            "upload_time_iso_8601": "2024-02-29T21:49:43.431255Z",
            "url": "https://files.pythonhosted.org/packages/e7/bd/755c29328520737247b7a513f105019d5b536c8a4f192309ae4cbce1ace5/pynvest-0.1.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-29 21:49:43",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "pynvest"
}
        
Elapsed time: 0.44972s