https://github.com/cumbucadev/cinemaempoa

Site que agrega filmes em cartaz em algumas das diversas salas de cinema de Porto Alegre.
https://github.com/cumbucadev/cinemaempoa

flask hacktoberfest movies python3 scraping

Last synced: about 1 year ago
JSON representation

Site que agrega filmes em cartaz em algumas das diversas salas de cinema de Porto Alegre.

• Host: GitHub
• URL: https://github.com/cumbucadev/cinemaempoa
• Owner: cumbucadev
• License: gpl-3.0
• Created: 2023-08-27T23:54:48.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-11-08T23:13:00.000Z (over 1 year ago)
• Last Synced: 2025-04-14T11:09:03.318Z (about 1 year ago)
• Topics: flask, hacktoberfest, movies, python3, scraping
• Language: CSS
• Homepage: https://cinemaempoa.com.br
• Size: 40.1 MB
• Stars: 34
• Watchers: 4
• Forks: 16
• Open Issues: 37
• Metadata Files:
  • Readme: README.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# CINEMA EM POA

CINEMA EM POA é um portal agregador de filmes das casas de cinema de Porto Alegre.

Está rodando em .

![Home page do site - b4252b9c824a4ba5d068e40144ea8d7d6c79a74f](README/b4252b9c824a4ba5d068e40144ea8d7d6c79a74f.png)

O conteúdo é agregado realizando _web scrapping_ em quatro diferentes sites:

- [CineBancários](http://cinebancarios.blogspot.com/?view=classic)

- [Cinemateca Paulo Amorim](https://www.cinematecapauloamorim.com.br)

- [Cinemateca Capitólio](http://www.capitolio.org.br)

- [Sala Redenção](https://www.ufrgs.br/difusaocultural/salaredencao/)

O projeto encoraja contribuições (veja [Contribuições](#contribuicoes)).

## Desenvolvimento

O projeto é composto de dois módulos: `scrapers/`, que contém a lógica para coleção de dados e `flask_backend/`, onde fica o código do portal.

O projeto foi desenvolvido em Python 3.10 e funciona com qualquer versão superior.

A instalação recomendada é usando um [ambiente virtual (venv)](https://docs.python.org/3/library/venv.html).

    python3 -m venv .venv

    source .venv/bin/activate

    pip3 install -r requirements.txt

O banco de dados utilizado é o [sqlite3](https://www.sqlite.org/).

Após fazer suas alterações, rode os comandos abaixo no seu terminal para validar e formatar o código:

```bash

ruff check # roda o linter para código python

ruff format # roda o formatter para código python

djlint flask_backend/templates --lint --profile=jinja # roda o linter para os arquivos .html

djlint --reformat flask_backend/templates --format-css --format-js # roda o formatter para os arquivos .html

```

Opcionalmente, o [pre-commit](https://pre-commit.com/) pode automatizar a formatação do código quando você rodar um `git commit`.

Para utilizá-lo, instale com:

    pre-commit install

### Rodando o projeto

Para rodar o portal, você vai precisar de três comando (todos rodados a partir da raíz do projeto):

    flask --app flask_backend init-db # inicializa as tabelas no banco de dados

    flask --app flask_backend seed-db # optional: popula o banco com dados iniciais

    flask --app flask_backend run --debug # inicia o projeto em modo desenvolvimento

O projeto vai rodar em .

Se você rodou o comando para popular o banco de dados, vai ter um usuário admin criado com login: cinemaempoa e senha: 123123.

Você pode fazer login via .

### Utilizando os scrappers

Os scrappers podem ser disparados através da interface web na URL , clicando no botão "Fazer Scrapping dos cinemas selecionados".

Alternativamente, os scrappers também podem ser rodados via linha de comandos, com o script

    ./cinemaempoa.py -h

    usage: cinemaempoa [-h] [-b] [--deploy] [--date DATE] [-r ROOMS [ROOMS ...] | -j JSON]

    Grab the schedule for Porto Alegre's finest features

    options:

    -h, --help            show this help message and exit

    -b, --build           Builds scrapped json as an html file

    --deploy              Saves generated html at docs/index.html - saves the old index file in YYYY-MM-DD.html format

    --date DATE           Runs the scrapper as if the current date is the given YYYY-MM-DD value

    -r ROOMS [ROOMS ...], --rooms ROOMS [ROOMS ...]

                            Filter specific rooms. Available: capitolio, sala-redencao, cinebancarios, paulo-amorim

    -j JSON, --json JSON  JSON filepath to build index.html from

Para disparar os scrappers e conseguir os filmes em cartaz em formato json (que pode ser importado no portal), rode o comando com a flag `r`, listando as salas de cinema desejadas, e direcione a saída para um arquivo.

    ./cinemaempoa.py -r capitolio sala-redencao cinebancarios paulo-amorim > import.json

Você pode inspecionar o arquivo `import.json` resultante para entender melhor a estrutura de saída dos scrappers.

### Importando dados no portal

Caso você tenha rodado os scrappers via linha de comando, você vai precisar importar o arquivo .json resultante no portal.

Após logar, vá para a página .

Lá, selecione o arquivo gerado na etapa anterior e clique em **Enviar**.

As sessões importadas vão estar disponíveis na home.

Contribuições


Veja nossos [issues](https://github.com/guites/cinemaempoa/issues) pra entender o que está sendo feito no projeto.

Implementações mais simples estão marcadas com [good first issue](https://github.com/guites/cinemaempoa/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22).

## Deploy (produção)

Atualmente o projeto (em ) está hospedado em uma máquina virtual no [hetzner](https://www.hetzner.com/).

Os arquivos usados para o deployment são:

- .env (deve ser criado a partir do example.env).

- docker-compose.production.yml

- Dockerfile.prod

A cada novo merge no branch principal, eu entro na máquina virtual, puxo as alterações e depois reinicio o servidor.