Vai al contenuto

QuickStart

Per prima cosa importiamo la libreria:

1
import animeworld as aw

Sessione (Opzionale)

Potrebbe essere necessario cambiare il base_url di tutti i link se il sito di animeworld cambia da https://www.animeworld.ac a qualcos'altro.

Per fare ciò è necessario cambiare il base_url della sessione (SES)

2
aw.SES.base_url = "https://www.animeworld.ac"

Find

Adesso proviamo a cercare un anime:

3
4
res = aw.find("Sword Art Online")
print(res)
Output 
[
    {
        "id": 1717,
        "name": "Sword Art Online",
        "jtitle": "Sword Art Online",
        "studio": "A-1 Pictures",
        "release": "05 Luglio 2014",
        "episodes": 25,
        "state": "1",
        "story": 'Kazuto "Kirito" Kirigaya, un genio della programmazione, entra in una realtà  virtuale interattiva con pluralità  di giocatori (una realtà  "massively multi-player online" o "MMO") denominata "Sword Art Online". Il problema sta nel fatto che, una volta entrati, se ne può uscire solo vincitori, completando il gioco, perché il game over equivale a morte certa del giocatore.',
        "categories": [...],
        "image": "https://img.animeworld.ac/locandine/36343l.jpg",
        "durationEpisodes": "23",
        "link": "https://www.animeworld.ac/play/sword-art-online.N0onT",
        "createdAt": "2020-08-02T15:42:44.000Z",
        "language": "jp",
        "year": "2012",
        "dub": False,
        "season": "summer",
        "totViews": 461576,
        "dayViews": 204,
        "weekViews": 459,
        "monthViews": 6416,
        "malId": 11757,
        "anilistId": 11757,
        "mangaworldId": None,
        "malVote": 7.35,
        "trailer": "https://www.youtube.com/embed/6ohYYtxfDCg?enablejsapi=1&wmode=opaque",
    },
    ...
]

La funzione find restituisce una lista di dizionari, uno per ogni anime trovato. Ogni dizionario contiene molte informazioni, tra cui: il nome, il numero di episodi, la data di uscita, il link, ecc.

Anime

La classe Anime è l'oggetto che stà alla base di questa libreria. Per istanziarla è necessario passare il link dell'anime, ottenuto direttamente dal sito di AnimeWorld o dalla funzione find vista prima.

5
6
# https://www.animeworld.ac/play/sword-art-online.N0onT
anime = aw.Anime("/play/sword-art-online.N0onT")

Warning

È possibile passare il link completo alla classe Anime come ad esempio: 

anime = aw.Anime("https://www.animeworld.ac/play/sword-art-online.N0onT")
Ma il base_url (https://www.animeworld.ac) verrà rimpiazzato con quello definito nella Sessione (SES).

Warning

Se il link passato punta ad una pagina 404 verrannà sollevata l'eccezione Error404.

Con questa classe è possibile ottenere informazioni sull'anime: 

 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# Il titolo
print("Titolo:", anime.getName())
print("----------------------------------\n")

# La trama
print("Trama:", anime.getTrama())
print("----------------------------------\n")

# La locandina
print("Cover: ", anime.getCover())
print("----------------------------------\n")

# Informazioni generali
info = anime.getInfo()
print("Informazioni generali:\n", "\n".join(
    [f"{x}: {info[x]}" for x in info]
))
print("----------------------------------\n")
Output 
Titolo: Sword Art Online
----------------------------------

Trama: Kazuto "Kirito" Kirigaya, un genio della programmazione, entra in una realtà  virtuale interattiva con pluralità  di giocatori (una realtà  "massively multi-player online" o "MMO") denominata "Sword Art Online". Il problema sta nel fatto che, una volta entrati, se ne può uscire solo vincitori, completando il gioco, perché il game over equivale a morte certa del giocatore.
----------------------------------

Informazioni generali:
Categoria: Anime
Audio: Giapponese
Data di Uscita: 08 Luglio 2012
Stagione: Estate 2012
Studio: A-1 Pictures
Genere: ['Avventura', 'Azione', 'Fantasy', 'Gioco', 'Romantico', 'Sentimentale']
Voto: 8.36 / 10
Durata: 23 min/ep
Episodi: 25
Stato: Finito
Visualizzazioni: 461.733
----------------------------------

Ma soprattutto scaricare gli episodi:

Info

Se al metodo getEpisodes() non viene passato nessun argomento, verranno ottenuti TUTTI gli episodi dell'anime.

Warning

ep.number è un attributo di tipo str, maggiori informazioni qui.

20
21
22
23
24
25
26
27
28
29
30
31
32
33
# Ottengo una lista di Episodi
# che mi interessano
episodi = anime.getEpisodes([1, 2, 4])


# E li scarico
for ep in episodi:

    print(f"Scarico l'episodio {ep.number}.")

    # Uno alla volta...
    ep.download() 

    print(f"Download completato.")
Output 
Scarico l'episodio 1.
Download completato.
Scarico l'episodio 2.
Download completato.
Scarico l'episodio 4.
Download completato.