Klasická funkce open() otevírá přístup právě k jednomu fyzickému souboru, ať už textovému či binárnímu. Knihovní funkce fileinput.input() je jejím velmi výrazným zobecněním (převážně pro čtení dat, ale viz parametr inplace), protože umožňuje:

• otevřít více souborů postupně za sebou;
• číst data ze standardního vstupu (tedy třebas i z pajpy!).

Navíc dokáže automaticky zpracovat soubory komprimované pomocí gzip (přípona .gz) a bzip2 (přípona .bz2), jakož i poradit si s chybami v kódování.

Kromě toho je solidně konfigurovatelná a je možno si dopsat vlastní handlery pro další typy souborů.

V úplně nejjednodušší podobě stačí napsat:

Blíže neurčený vstup je pak zpracován následujícím způsobem:

• následují-li za skriptem jako parametry příkazové řádky soubory (tj. v sys.argv[1:]), jsou postupně čteny řádku po řádce jedem po druhém;
• nejsou-li takto zadány – nebo-je li zadán znak '-' – žádné soubory, jsou řádky načítány ze standardního vstupu sys.stdin (tedy z pajpy).

Výchozí nastavení je stejné jako u funkce open(), tj. textové soubory pro čtení ('r'), přičemž jediný další povolený způsob je binární soubor pro čtení ('rb'). Nicméně je možné otevřené soubory přepisovat, případně ukládat záložní kopie.

Plný konstruktor funkce input() odhaluje, že toho lze nastavit mnohem více:

fileinput.input(files=None, inplace=False, backup='', mode='r', openhook=None)

Především tedy můžete:

• zadat soubory k otevření pomocí parametru files (typicky jako n-tice nebo seznam řetězců);
• změnit způsob práce s proudy pomocí parametru mode (povolené jsou tedy pouze 'r' a 'rb');
• přesměrovat standardní výstup do právě otevřeného souboru nastavením inplace=True, přičemž nastavením backup='.přípona' zachováte originál v příslušně pojmenované záloze; Pro vstup ze standardního vstupu toto samozřejmě nejde použít.
• provést s otevíranými soubory dodatečnou operaci na základě hodnoty parametru openhook. Prozměnu zase pochopitelně nejde kombinovat s parametrem inplace.

K dispozici jsou dva připravené openhooky:

• fileinput.hook_compressed dokáže otevřít soubory zkomprimované pomocí metod gzip (pouze přípona .gz!), respektive bzip2 (pouze přípona .bz2!);
• fileinput.hook_encoded předepisuje kódování pro otevírané textové soubory a způsob řešení chyb při jejich dekódování zadaným algoritmem. # příklad pro UTF-8 s přemapováním problematických znaků fileinput.hook_encoded("utf-8", "surrogateescape")

Kromě těchto dvou předpřipravených je možno si napsat vlastní. Jedná se totiž o funkce, které přebírají právě dva vstupní parametry – jméno/cestu k souboru a způsob jeho otevření (tedy 'r'/'rb') – a mají za úkol vrátit příslušným způsobem otevřený tento soubor.

Jelikož primárním účelem modulu fileinput je načítání vícero proudů najednou, nepřekvapí, že máme k dispozici funkce, které nám v načítaných souborech pomohou udělat trochu pořádek:

• filename() a fileno() vrací jméno a „celočíselný deskriptor“ právě zpracovávaného souboru;
• filelineno(), resp. lineno() vrací pořadové číslo řádky v aktuálním souboru, resp. akumulovaně přes všechny dosud načtené řádky ze všech již zpracovaných souborů;
• isfirstline() vrací True, pokud právě zpracovávaná řádka je první řádkou aktuálního souboru;
• isstdin() vrací True jen a pouze v tom případě, kdy poslední načtená řádka pochází ze sys.stdin;
• nextfile() uzavírá aktuální otevřený proud a přechází na další (případné nedočtené řádky se do celkových nepřekvapivě nezapočítávají); Tato funkce je v provozu až po načtení první řádky souboru, takže ji nemůžete použít kupříkladu pro přeskočení prvního z proudů.
• close() uzavírá kontext (nezávisle na tom, zda byl již vyčerpán nebo ne).