https://github.com/hudsonbrendon/ingresso.com
Um wrapper em python para o ingresso.com
https://github.com/hudsonbrendon/ingresso.com
Last synced: about 2 months ago
JSON representation
Um wrapper em python para o ingresso.com
- Host: GitHub
- URL: https://github.com/hudsonbrendon/ingresso.com
- Owner: hudsonbrendon
- License: mit
- Created: 2022-08-10T03:54:11.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-12-30T23:32:56.000Z (5 months ago)
- Last Synced: 2025-03-23T19:12:11.905Z (2 months ago)
- Language: Python
- Size: 174 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ingresso.com
Um wrapper em python para o ingresso.com
[](https://github.com/hudsonbrendon/ingresso.com/actions/workflows/python-package.yml)
[](https://github.com/hudsonbrendon/ingresso.com/issues?sort=updated&state=open)
# Recursos Disponíveis
- [x] Cinemas de uma cidade
- [x] Sessões de um cinema
- [x] Filmes em destaques
- [x] Filmes em cartaz
- [x] Filmes que serão lançados em brevve
# Instalação
```bash
$ pip install ingresso
```
ou
```bash
$ poetry build
```
# Modo de usar
Para utilizar a classe Ingresso, primeiro você precisa pegar o ID da cidade em questão, o ingresso.com disponibiliza um endpoint que lista as cidades e seus respectivos ids. Comece acessando o endpoint abaixo passando a UF do estado:
[https://api-content.ingresso.com/v0/states/UF](https://api-content.ingresso.com/v0/states/UF)
## Tabela de UFs:
| UF | Estate |
| --------- |:-----:|
| AC | Acre |
| AL | Alagoas |
| AP | Amapá |
| AM | Amazonas |
| BA | Bahia |
| CE | Ceará |
| DF | Distrito Federal |
| ES | Espírito Santo |
| GO | Goiás |
| MT | Mato Grosso |
| MA | Maranhão |
| MS | Mato Grosso do Sul |
| MG | Minas Gerais |
| PA | Pará |
| PB | Paraíba |
| PR | Paraná |
| PE | Pernambuco |
| PI | Piauí |
| RJ | Rio de Janeiro |
| RN | Rio Grande do Norte |
| RS | Rio Grande do Sul |
| RO | Rondônia |
| RR | Roraima |
| SC | Santa Catarina |
| SP | São Paulo |
| SE | Sergipe |
| TO | Tocantins |
## Exemplo:
https://api-content.ingresso.com/v0/states/RN
Será retornado algo semelhante a isso:
```json
{
"name": "Rio Grande do Norte",
"uf": "RN",
"cities": [
{
"id": "48",
"name": "Natal",
"uf": "RN",
"state": "Rio Grande do Norte",
"urlKey": "natal",
"timeZone": "America/Fortaleza"
}
]
}
```
No exemplo acima, o ID da cidade é o 48, é ele que deve ser usado no parâmetro **city_id**.
O parâmetro **partnership** é o nome do cinema, por exemplo: cinepolis, cinemark, knoplex, moviecom, etc.
## Cinemas
```python
ingresso = Ingresso(48, 'cinepolis')
ingresso.theaters()
```
ou
```python
ingresso = Ingresso(48, 'cinepolis')
ingresso.theaters(1005)
```
## Cinemas por cidade
```python
ingresso = Ingresso(48, 'cinepolis')
ingresso.teathers_by_city()
```
## Sessões por cinema
```python
ingresso = Ingresso(48, 'cinepolis')
ingresso.sessions_by_theater(1005)
```
## Destaques por cinema
```python
ingresso = Ingresso(48, 'cinepolis')
ingresso.highlights()
```
## Filmes em cartaz
```python
ingresso = Ingresso(48, 'cinepolis')
ingresso.now_playing()
```
## Filmes em breve
```python
ingresso = Ingresso(48, 'cinepolis')
ingresso.soon()
```
# Contribua
Clone o projeto repositório:
```bash
$ git clone https://github.com/hudsonbrendon/ingresso.com.git
```
Certifique-se de que o [Poetry](https://python-poetry.org/) está instalado, caso contrário:
```bash
$ pip install -U poetry
```
Instale as dependências:
```bash
$ poetry install
```
```bash
$ poetry shell
```
Para executar os testes:
```bash
$ pytest
```
# Dependências
- [Python >=3.8](https://www.python.org/downloads/release/python-3813/)
# Licença
[MIT](http://en.wikipedia.org/wiki/MIT_License)