semvec/pypi-packages huggingface dataset:
turberfield-punchline 0.8.0
A static blog engine with great comedy timing.

Punchline
:::::::::

What worried me recently
++++++++++++++++++++++++

There aren't enough jokes on the web. I'd like to see more satire. Urgently.

There is indeed, on the web a lot of poetry. But poetry web sites are not poetic places. Or even happy spaces.

Also the traditions of personal web sites, `web rings`_, and `web feeds`_ are no longer common practice.
And I felt sad about that.

What I did about it
+++++++++++++++++++

I wrote *Punchline*.

Punchline is a static blogging framework. It treats your words as speech, and delivers them as dialogue with
measured timing. It supports multimedia too.

Punchline was designed from the ground up to generate `JSON Feed`_. So you can publish your blog as a feed
under the topics you choose.

Usage
+++++

:code:`punchline [-h] [--config CONFIG] [--output OUTPUT] inputs [inputs ...]`

  *inputs*         One or more search paths.

  -h, --help       Show a help message and exit.
  --config CONFIG  Specify a site configuration file.
  --output OUTPUT  Set directory for output.

There is full `documentation online`_.

.. _JSON Feed: https://jsonfeed.org/version/1.1
.. _web rings: https://www.mic.com/p/how-geocities-webrings-made-the-90s-internet-a-cozier-place-19638198
.. _web feeds: https://en.wikipedia.org/wiki/Web_feed
.. _Git Bash: https://gitforwindows.org/
.. _reStructuredText: https://docutils.sourceforge.io/rst.html
.. _Turberfield dialogue library: https://turberfield-dialogue.readthedocs.io/en/latest/
.. _documentation online: https://turberfield-punchline.readthedocs.io/en/latest/
ibge-parser 1.0.2
IBGE Parser is a Python library to get microdata from IBGE - (Instituto Brasileiro de Geografia e Estatística) census and convert the data to readable CSV files.
Requires Python: >=3.6

# IBGE Parser

## Visão Geral
---------------

**IBGE Parser** é uma biblioteca para a linguagem Python que tem por objetivo coletar os microdados do censo do IBGE - Instituto Brasileiro de Geografia e Estatística, disponibilizado em [Microdados IBGE](https://www.ibge.gov.br/estatisticas/sociais/populacao/25089-censo-1991-6.html?=&t=microdados) e convertê-los em arquivos CSV, facilitando o manuseio dos dados.

## Instalação

```
pip install ibge-parser
```

## Exemplos de uso

### Importando a biblioteca

`import ibgeparser`

### Obter os dados

```python
# import da classe principal
from ibgeparser.microdados import Microdados
# import dos enums para facilitar as buscas
from ibgeparser.enums import Anos, Estados, Modalidades

if __name__ == "__main__":
    # usando os unums
    ano = Anos.DEZ    
    estados = [Estados.SANTA_CATARINA, Estados.RONDONIA]
    modalidades = [Modalidades.EMIGRACAO]
    
    # instanciando a classe
    ibgeparser = Microdados()
    # obeter dados
    ibgeparser.obter_dados_ibge(ano, estados, modalidades)
```
O método `obter_dados_ibge` retorna os dados do censo no formato `.csv` das modalidades e estados solicitados. Utitlize os `enums` para selecionar corretamente as opções desejadas. Os arquivos `csv` são salvos na pasta `microdados-ibge` dentro do projeto.

#### Parâmetros
- ano: Enum.Ano
- estados: list(Enum.Estados)
- modalidades: list(Enum.Modalidades)
- (opcional: True) header: bool

### Obter especificação das colunas

```python

# import da classe principal
from ibgeparser.microdados import Microdados
# import dos enums para facilitar as buscas
from ibgeparser.enums import Modalidades

if __name__ == "__main__":
    # usando os unums
    modalidades = [Modalidades.EMIGRACAO]
    
    # instanciando a classe
    ibgeparser = Microdados()
    # especificação de coluna
    ibgeparser.obter_especificacao_coluna('palavra-chave', modalidades)
```

O método `obter_especificacao_coluna` retorna a especificação da coluna das modalidades solicitadas. Utitlize os `enums` para selecionar corretamente as opções desejadas.

#### Parâmetros
- palavra_de_busca: str
- modalidades: list(Enum.Modalidades)

## Contribuindo

O projeto IBGE Parser é mantido pela Senior Sistemas e disponibilizado como código-aberto à comunidade, estando sob a licença Apache 2.0.

### Requisitos

- Git
- Python 3

### Configuração

Configurar a _Python VirtualEnv_ e instalar as bibliotecas necessárias com o comando abaixo:

`pip install -r requirements.txt`

Mais informações sobre contribuição, como criação de _pull requests_, abertura de _issues_, etc. consultar [aqui](./CONTRIBUTING.md).