Vai al contenuto

Advanced Usage

Eccezioni

La libreria solleva diverse eccezioni, le principali sono: AnimeNotAvailable, Error404 e DeprecatedLibrary.
Per maggiori informazioni consultare la documentazione.

DeprecatedLibrary

L'eccezione DeprecatedLibrary viene sollevata quando viene rivelato un mutamento del sito di AnimeWorld non piú supportato dalla libreria.

Questa eccezione può essere sollevata praticamente da qualsiasi metodo della libreria, quindi è consigliato gestirla in modo globale.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
try:
    res = aw.find("...")
    anime = aw.Anime("https://www.animeworld.so/play/...")
    episodi = anime.getEpisodes()

    for x in episodi:
        x.download()

except aw.DeprecatedLibrary as e:
    # Gestione dell'eccezione
    print("Aprire un issue su GitHub :(")

Error404

L'eccezione Error404 viene sollevata quando l'URL passato alla creazione dell'oggetto Anime punta ad una pagina 404.

Visto che questa eccezione viene sollevata solo dalla classe Anime, è consigliato gestirla solo se effettivamente si sta istanziando un oggetto di quella classe.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
try:
    res = aw.find("...")

    try:
        anime = aw.Anime("https://www.animeworld.so/play/...")

    except aw.Error404 as e:
        # Gestione dell'eccezione
        print("Anime non trovato :(")

    else:
        episodi = anime.getEpisodes()
        for x in episodi:
            x.download()

except aw.DeprecatedLibrary as e:
    # Gestione dell'eccezione
    print("Aprire un issue su GitHub :(")

AnimeNotAvailable

L'eccezione AnimeNotAvailable viene sollevata quando la pagina dell'anime esiste ma gli episodi non sono ancora disponibili. Questo accade ad esempio quando inizia una nuova stagione.

L'eccezione si verifica soltanto alla chiamata del metodo getEpisodes.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
try:
    res = aw.find("...")

    try:
        anime = aw.Anime("https://www.animeworld.so/play/...")

    except aw.Error404 as e:
        # Gestione dell'eccezione
        print("Anime non trovato :(")

    else:
        try:
            episodi = anime.getEpisodes()

        except aw.AnimeNotAvailable as e:
            # Gestione dell'eccezione
            print("Anime non ancora disponibile :(")

        else:
            for x in episodi:
                x.download()

except aw.DeprecatedLibrary as e:
    # Gestione dell'eccezione
    print("Aprire un issue su GitHub :(")

Server

Per scarica un episodio è possibile selezione manualmente il server da cui scaricare il video. Per farlo è ottenere prima la lista dei server utilizzando l'attributo Episodio.links e poi sceglierne uno tra quelli supportati.

Warning

Non consiglio di utilizzare questo metodo per scaricare un episodio, è molto piú semplice e sicuro utilizzare il metodo Episodio.download, perchè:

  1. Viene scelto sempre il server più veloce al momento del download.
  2. Se si sceglie un server non supportato, verrà sollevata l'eccezione ServerNotSupported.
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
anime = aw.Anime("...")

# Scelgo il primo episodio
episodio = anime.getEpisodes()[0]

# Ottengo la lista dei server
servers = episodio.links

# Scelgo il server AnimeWorld_Server ad esempio
server = [x for x in servers if isinstance(x.name, AnimeWorld_Server)][0]

# Scarico il video
server.download()

Server supportati

I server supportati sono indicati di seguito, se vuoi contribuire per aggiungerne altri puoi dare un occhiata alla sezione Contributing.

Server
✔️ AnimeWorld_Server ❌ StreamHide ❌ Doodstream
✔️ Streamtape ❌ FileMoon ❌ StreamSB
✔️ YouTube ❌ Streamtape ❌ Streamlare

Download

Warning

Se ci sono dei caratteri non ammessi nel nome del file (#%&{}<>*?/$!'":@+\``|=), questi verranno rimossi automaticamente. Per ottenere il nome del file effettivamente scritto su disco è possibile ottenerlo dal ritorno del metodo Episodio.download.

Per ottenere un episodio, consiglio di utilizzare il metodo Episodio.download, il quale recupera il video utilizzando il server più veloce disponibile al momento del download.

È possibile impostare il nome del file utilizzando il parametro title e la cartella di destinazione utilizzando il parametro folder.

hook

Il parametro hook è più interessante, questo è un riferimento ad una funzione che poi verrà chiamata ogni volta che viene scaricato un chunk del video (~524 Kb). Questo è utile per mostrare a schermo il progresso del download. La funzione deve avere un singolo parametro di tipo Dict[str, Any].

def my_hook(data):
    print(data)

episodi = anime.getEpisodes()
for x in episodi:
    x.download(hook=my_hook)

Un esempio di un possibile dizionario passato alla funzione hook è il seguente:

{
    "total_bytes": 234127340, # Dimensione totale del video in byte
    "downloaded_bytes": 524288, # Dimensione scaricata in byte
    "percentage": 0.0022393283928310126, # Percentuale scaricata [0, 1]
    "speed": 3048288.673006227, # Velocità di download in byte/s
    "elapsed": 0.17199420928955078, # Tempo trascorso in secondi
    "filename": "1 - AnimeWorld Server.mp4", # Nome del file
    "eta": 76.63416331551707, # Tempo rimanente stimato in secondi
    "status": "downloading", # Stato del download ('downloading' | 'finished' | 'aborted')
}

opt

È anche possibile fermare forzatamente il download utilizzando il parametro opt. Questo parametro è una lista di stringhe, ogni stringa rappresenta un'opzione. Attualmente l'unica opzione possibile è abort, che ferma il download.

Se in opt compare, durante il download, la stringa abort allora il download viene fermato e il file parzialmente scaricato viene eliminato.

Un esempio di utilizzo del parametro opt è il seguente:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
import animeworld as aw
import time
from threading import Thread

anime = aw.Anime("...")
episodio = anime.getEpisodes()[0]

# Definisco la funzione per il thread
def gestioneDownload(lista_opzioni):
    time.sleep(5)
    lista_opzioni.append("abort")


opt = [] # Array per le opzioni dinamiche
t = Thread(target=gestioneDownload, args=(opt,)) # Creo il thread

t.start() # Avvio il thread

episodio.download(opt=opt) # Avvio il download

In questo esempio il download viene fermato dopo 5 secondi.

I/O Buffer

È possibile scaricare un episodio usando direttamente un descrittore di file invece che una stringa per la directory. Basta passare al parametro folder un tipo IOBase.

1
2
3
4
5
6
7
8
9
import animeworld as aw
import io

anime = aw.Anime("...")
episodio = anime.getEpisodes()[0]

buffer = io.BytesIO() # Alloco un buffer in memoria

episodio.download(folder=buffer) # Avvio il download

In questo esempio l'episodio scaricato viene scritto in memoria senza essere salvato come file.

Esempio completo

example.py
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
import animeworld as aw
from datetime import datetime


def my_hook(d):
    """
    Stampa una ProgressBar con tutte le informazioni di download.
    """
    if d['status'] == 'downloading':
        out = "{filename}:\n[{bar}][{percentage:^6.1%}]\n{downloaded_bytes}/{total_bytes} in {elapsed:%H:%M:%S} (ETA: {eta:%H:%M:%S})\x1B[3A"

        width = 70 # grandezza progressbar

        d['elapsed'] = datetime.utcfromtimestamp(d['elapsed'])
        d['eta'] = datetime.utcfromtimestamp(d['eta'])
        d['bar'] = '#'*int(width*d['percentage']) + ' '*(width-int(width*d['percentage']))

        print(out.format(**d))

    elif d['status'] == 'finished':
        print('\n\n\n')


try:
    anime = aw.Anime(link="https://www.animeworld.so/play/tokyo-revengers-seiya-kessen-hen.tzgly")

    print("Titolo:", anime.getName()) # Titolo dell'anime

    print("\n----------------------------------\n")

    print("Trama:", anime.getTrama()) # Trama

    print("\n----------------------------------\n")

    print("Info:")
    info = anime.getInfo()
    for x in info: print(f"{x}: {info[x]}") # Informazioni presenti su Animeworld riguardanti l'anime

    print("\n----------------------------------\n")

    print("Episodi:")
    try:
        episodi = anime.getEpisodes()
    except aw.AnimeNotAvailable as error:
        print("Errore:", error)
    else:
        for x in episodi:
            print(f"\n-> Ep. {x.number}")
            for k in x.links:
                print(f"\t{k.name} - {k.link}")

            if x.number == '1':
                print("\n\tFile info: {\n\t\t" + "\n\t\t".join("{}: {}".format(k, v) for k, v in x.fileInfo().items()) + "\n\t}")
                x.download(hook=my_hook)
                break
except (aw.DeprecatedLibrary, aw.Error404, aw.ServerNotSupported) as error:
    print(error)
Ultimo aggiornamento: November 18, 2023