Napíšte si vlastný skript

Táto funkcionalita môže byť užitočná pre znalcov jazyka Python, ktorým nestačia preddefinované operácie a potrebujú si špecifikovať vlastnú.

Pri písaní skriptu je potrebné dodržiavať rovnaké syntaktické pravidlá aké má Python vo verzií 2.7. Je potrebné dodržiavať odsek (4 medzery pre vnorený blok), pričom sa začína hneď od kraja.

Skript ktorý napíšete sa spustí pre každý súbor v zozname osobitne, čiže definuje proces akým sa z dostupných informácií o súbore určí nové meno.

Nové meno súboru uložte do premennej new_name. ID súboru ktorý sa spracováva sa nachádza v premenej file_id. Názov súboru ako aj všetky ostatné dostupné informácie o súbore získate prostredníctvom metód lokálnych inštancií tried. Nastavenia zmeníte pomocou lokálnych metód na to určených.

Lokálne metódy

Skript ktorý píšete sa spúšťa v rámci triedy RenameAction. Podrobná špecifikácia tejto triedy vás nemusí zaujímať, podstatné sú pre vás len niektoré metódy. S výnimkou prvých dvoch sa jedná o setter-funkcie ktoré vám umožnia meniť nastavenia v rámci skriptu. Hodnoty ktoré nastavíte prekryjú nastavenia zvolené v grafickom rozhraní.

Pozn.: Pred názvy funkcií nemusíte písať kľúčové slovo self pretože tieto identifikátory už sú definované ako odkazy na metódy triedy.

Lokálne inštancie

V rámci triedy RenameAction v ktorej sa skript spúšťa máte k dispozícií sériu inštancií tried, ktorých rozhranie umožňuje získať dáta konkrétnej kategórie o súbore ktorý sa v danej iterácií spracováva. Jedná sa o nasledovné inštancie:

Pozn.: Pred názvy inštancií nemusíte písať kľúčové slovo self pretože tieto identifikátory už sú definované ako odkazy na inštancie vytvorené v inicializačnej sekcií triedy RenameAction.

File

Inštancia trieda ktorá umožňuje prístup k základným vlastnostiam súboru. Všetky funkcie majú jeden nepovinný vstupný parameter _file, typu string, ktorý predstavuje celý názov súboru (vrátane cesty). Pokiaľ sa nezadá explicitne, použije sa názov aktuálne spracovávaného súboru.

Current_time

Inštancia umožňuje prístup k položkám aktuálneho času.

Current_date

Inštancia umožňuje prístup k položkám aktuálneho dátumu.

Image

Inštancia ktorá umožňuje prístup k základným vlastnostiam obrázku. Všetky funkcie majú jeden nepovinný vstupný parameter _file, typu string, ktorý predstavuje celý názov súboru (vrátane cesty). Pokiaľ sa nezadá explicitne, použije sa názov aktuálne spracovávaného súboru.

Exif

Inštancia ktorá umožňuje prístup k základným položkám EXIF štruktúry obrázku. Všetky funkcie majú jeden nepovinný vstupný parameter _file, typu string, ktorý predstavuje celý názov súboru (vrátane cesty). Pokiaľ sa nezadá explicitne, použije sa názov aktuálne spracovávaného súboru.

ID3

Inštancia ktorá umožňuje prístup k položkám ID3 štruktúry zvukového súboru. Všetky funkcie majú jeden nepovinný vstupný parameter _file, typu string, ktorý predstavuje celý názov súboru (vrátane cesty). Pokiaľ sa nezadá explicitne, použije sa názov aktuálne spracovávaného súboru.

MusicBrainz

Táto inštancia slúži pre prístup k dátam z hudobnej metadatabázy MusicBrainz.org. Dáta vyhľadáva na základe explicitne zadaných informácií(Explicit_data), ID3 informácií a z výsledkov AutoParser-u. Všetky funkcie majú jeden nepovinný vstupný parameter _file, typu string, ktorý predstavuje celý názov súboru (vrátane cesty). Pokiaľ sa nezadá explicitne, použije sa názov aktuálne spracovávaného súboru.

Pre správnu funkčnosť samozrejme vyžaduje pripojenie do internetu. Je dôležité si tiež uvedomiť že vykonanie metódy na získanie konkrétnych dát z internetovej databázy zaberá väčšie množstvo času. Preto každá metóda obsahuje nepovinný parameter timeout, ktorý v prípade že sa nezadá metódy nebudú obmedzené časom. V opačnom prípade ich vykonanie nezaberie dlhší čas ako je nastavené v parametre timeout(v sekundách). Ďalšími voliteľnými parametrami sú urls a only_url. Urls je zoznam preddefinovaných url albumov z MusicBrainz.com, z ktorých sa majú dáta získavať prednostne. Only_url špecifikuje či sa majú použiť len tieto preddefinované adresy, alebo má program prípadne vyhľadať ďalšie.

Explicit_data

Inštancia slúži na prácu s explicitne zadanými informáciami. Pod explicitne zadanými inf. sa rozumejú dáta vložené konečným užívateľom (nie programátorom), ktoré sú mu známe, avšak nie sú v názve súboru alebo v jeho metadátach dostupné. Používať setter-funkcie v rámci skriptu preto nie je doporučené, ani zmysluplné.

Všetky funkcie majú jeden nepovinný vstupný parameter _file, typu string, ktorý predstavuje celý názov súboru (vrátane cesty). Pokiaľ sa nezadá explicitne, použije sa názov aktuálne spracovávaného súboru.

Auto_parser

Inštancia umožňuje prístup k dátam získaných automatickým parsovaním názvu súboru. Je to experimentálna funkcia a jej výsledky nie sú zaručene presné. Táto funkcionalita sa vzťahuje na súbory so zvukovými stopami, video súbory a súbory s titulkami. All functions have one optional input argument _file (string type), representing whole file name (including path). If it is not set, than the name of the file which is currently being processed will be used.