CORE modely

Definice modelů.

Třídy

class AntivirusCheckResult

Implementuje komponentu AntivirusCheckResult v rámci aplikace.

class SouborVazby

Model pro relační tabulku mezi souborem a záznamem.

Obsahuje typ vazby podle typu záznamu.

Metody:

navazany_objekt()

Vrátí navázaný objekt podle typu vazby.

Vrací:

Navázaný objekt (Projekt, Dokument nebo SamostatnyNalez).

class Soubor

Model pro soubor. Obsahuje jeho základné data, vazbu na historii a souborovů vazbu.

Metody:

url()

Vrátí URL pro přístup k souboru.

Vrací:

URL souboru nebo prázdný řetězec.

repository_uuid()

Vrátí UUID souboru v repozitáři.

Vrací:

Vrací vybranou hodnotu z kolekce.

calculate_sha_512()

Vrátí SHA-512 hash souboru uloženého v Fedora repozitáři.

Vrací:

Haš souboru ze skladiště nebo prázdný řetězec, pokud soubor neexistuje.

delete()

Odstraní záznam objektu.

Parametry:

• using – Alias databázového spojení použitý při operaci.

• keep_parents – Parametr keep_parents se předává do volání delete().

__init__()

Inicializuje instanci třídy.

Parametry:

• args – Parametr args se předává do volání __init__().

• kwargs – Parametr kwargs se předává do volání __init__().

__str__()

Vrací textovou reprezentaci objektu.

Textová reprezentace objektu.

Vrací:

Vrací atribut objektu.

create_soubor_vazby()

Metoda pro vytvoření vazby na historii.

vytvoreno()

Vrátí záznam historie s typem zmény „Nahrání SBR“ (prvního nahrání souboru).

Vrací:

Záznam historie nebo None, pokud soubor nevlastní historii.

get_repository_content()

Vrací repository content.

Parametry:

• ident_cely_old – Identifikátor ident_cely_old používaný pro dohledání cílového záznamu.

• thumb_small – Parametr thumb_small se předává do volání get_binary_file().

• thumb_large – Parametr thumb_large se předává do volání get_binary_file().

• timestamp – Časový údaj použitý při filtrování nebo výpočtu.

Vrací:

Načtená data odpovídající zadaným vstupům.

zaznamenej_nahrani()

Metoda pro zapsáni vytvoření souboru do historie.

Parametry:

• user – Parametr user se předává do volání Historie().

• file_name – Parametr file_name se předává do volání Historie().

zaznamenej_nahrani_nove_verze()

Metoda pro zapsáni nahrání nové verze souboru do historie.

Parametry:

• user – Parametr user se předává do volání Historie().

• nazev – Parametr nazev se předává do volání Historie(), ovlivňuje větvení podmínek.

get_file_extension_by_mime()

Vrací file extension by mime.

Parametry:

file – Soubor nebo cesta k souboru používaná při operaci.

Vrací:

Vrací výsledek volání get().

_detect_mime()

Detekuje MIME typ souboru pomocí libmagic s workaroundem pro regresi v libmagic >= 5.46, kde běžný ZIP s obsahem je vrácen jako application/octet-stream.

Parametry:

file – File-like objekt s podporou seek a read.

Vrací:

Detekovaný MIME typ.

get_thumb_icon()

Vrací thumb icon.

Parametry:

file – Soubor nebo cesta k souboru používaná při operaci.

Vrací:

Vrací n-tici.

get_mime_types()

Vrací mime types.

Parametry:

• file – Soubor nebo cesta k souboru používaná při operaci.

• check_archive – Parametr check_archive předává se do volání debug(), ovlivňuje větvení podmínek.

Vrací:

Načtená data odpovídající zadaným vstupům.

remove_gps_data()

Odstraní GPS metadata z fotografie uložené v paměti.

Funkce načte EXIF data z obrázku, odstraní GPS informace a pokusí se znovu uložit EXIF. Pokud narazí na nevalidní nebo nekompatibilní EXIF tagy (např. UserComment, MakerNote apod.), automaticky je odstraní, aby bylo možné obrázek úspěšně uložit.

V případě jakékoli chyby vrací původní vstupní soubor beze změny.

Parametry:

bytes_io – Obsah souboru připravený ke kontrole antivirem.

Vrací:

Vrací výsledek operace odstranění.

check_mime_for_url()

Ověří, zda detekovaný MIME typ souboru spadá do whitelistu pro danou upload URL.

Whitelisty per větev musí odpovídat seznamům v static/js/dz.js.

Parametry:

• file – Soubor nebo cesta k souboru používaná při operaci.

• source_url – URL uploadu — určuje, který whitelist se použije (pas, dokument, model3d nebo výchozí projekt).

Vrací:

True/False podle výsledku kontroly, případně řetězec "encrypted" u zaheslovaných archivů.

check_antivirus()

Zkontroluje soubor na přítomnost virů pomocí ClamAV.

Parametry:

bytes_io – Obsah souboru připravený ke kontrole antivirem.

Vrací:

Výsledek antivirové kontroly (PASSES, VIRUS_FOUND, CHECK_FAILED nebo SKIPPED).

_create_file_response()

Vytvoří file response.

Parametry:

rep_bin_file – Parametr rep_bin_file pracuje se s atributy content.

Vrací:

Nově vytvořená hodnota připravená touto funkcí.

large_thumbnail()

Vrátí větší náhled obrázku.

Vrací:

FileResponse s náhledem nebo None.

small_thumbnail()

Vrátí menší náhled obrázku.

Vrací:

FileResponse s náhledem nebo None.

content_file_response()

Vrátí soubor jako HTTP response.

Vrací:

FileResponse se souborem nebo None.

getMock()

Vrátí mock reprezentaci souboru.

Vrací:

Slovník s daty souboru.

get_historicke_verze()

Metoda k získání údajů o historických verzích ve Fedoře pro tabulku historie

Vrací:

Vrací proměnná results.

get_soubor_historicky()

Metoda k získání vlastního souboru dané verze z Fedory

Parametry:

timestamp – Časový údaj použitý při filtrování nebo výpočtu.

Vrací:

Vrací výsledek operace.

class ProjektSekvence

Model pro tabulku se sekvencemi projektu.

class OdstavkaSystemu

Model pro tabulku s odstávkami systému.

Metody:

clean()

Metoda clean, kde se navíc kontrolu, jestli už není jedna odstávka uložena.

Vyvolá:

ValidationError – Vyvolá se při splnění podmínky odstavky.first().pk != self.pk.

__str__()

Vrací textovou reprezentaci objektu.

Vrací:

Textová reprezentace odstávky systému.

class Permissions

Implementuje komponentu Permissions v rámci aplikace.

Metody:

check_concrete_permission()

Ověří, zda má uživatel konkrétní oprávnění na daný záznam a typ.

Parametry:

• user – Uživatel, pro kterého se kontroluje oprávnění.

• ident – Identifikátor archeologického záznamu (např. C-XX-YYYYNNNNN).

• typ – Typ objektu, pro který se kontroluje oprávnění (např. projekt, lokalita).

• skip_status – Pokud True, přeskočí stavovou podmínku oprávnění a vyhodnotí pouze základ, vlastnictví a přístupnost.

Vrací:

True pokud má uživatel oprávnění, False jinak.

check_base()

Ověří base. v aplikaci.

Vrací:

Vrací True nebo False podle vyhodnocení podmínek.

check_status()

Ověří status. v aplikaci.

Vrací:

Vrací True nebo False podle vyhodnocení podmínek.

check_ownership()

Ověří ownership. v aplikaci.

Parametry:

ownership – Uživatel nebo osoba ownership, v jejímž kontextu se operace provádí.

Vrací:

Vrací True nebo False podle vyhodnocení podmínek.

check_accessibility()

Ověří accessibility. v aplikaci.

Vrací:

Vrací True nebo False podle vyhodnocení podmínek.

check_permission_skip()

Ověří permission skip.

Vrací:

Vrací True nebo False podle vyhodnocení podmínek.

get_permission_object()

Vrací permission object.

permission_override()

Metoda pro uplatneni specifickych obejiti opravneni podle nazvu akce.

Vrací:

Vrací True nebo False podle vyhodnocení podmínek.

class PermissionsSkip

Implementuje komponentu PermissionsSkip v rámci aplikace.

class ApiRequestLog

Zaznamenává každý požadavek na API včetně stavu a výsledku.

Funkce

get_upload_to(instance, filename)

Určí cestu pro uložení souboru.

Parametry:

• instance – Instance souboru.

• filename – Název souboru.

Vrací:

Cesta pro uložení souboru.

check_permissions(action, user, ident, skip_status)

Ověří permissions. v aplikaci.

Parametry:

• action – Identifikátor akce, která se má provést.

• user – Parametr user se předává do volání filter(), append(), pracuje se s atributy hlavni_role.

• ident – Identifikátor ident používaný pro dohledání cílového záznamu.

• skip_status – Pokud True, přeskočí stavovou podmínku při vyhodnocení konkrétního oprávnění.

Vrací:

Vrací True nebo False podle vyhodnocení podmínek.