nette/utils 4.0.2

Author: dg

utils/bg/filesystem.texy

@@ -2,7 +2,7 @@
 ****************************
 
 .[perex]
-[api:Nette\Utils\FileSystem] е статичен клас, който съдържа полезни функции за работа с файлова система. Едно от предимствата им пред нативните функции на PHP е, че те хвърлят изключения в случай на грешки.
+[api:Nette\Utils\FileSystem] е клас, който съдържа полезни функции за работа с файлова система. Едно от предимствата им пред нативните функции на PHP е, че те хвърлят изключения в случай на грешки.
 
 
 Ако трябва да търсите файлове на диска, използвайте [Finder |finder].
@@ -176,3 +176,27 @@ platformSlashes(string $path): string .[method]
 ```php
 $path = FileSystem::platformSlashes($path);
 ```
+
+
+Статичен срещу нестатичен подход .[#toc-static-vs-non-static-approach]
+======================================================================
+
+За да замените лесно класа `FileSystem` с друг клас, например за целите на тестването, използвайте го нестатично:
+
+```php
+class AnyClassUsingFileSystem
+{
+	public function __construct(
+		private FileSystem $fileSystem,
+	) {
+	}
+
+
+	public function readConfig(): string
+	{
+		return $this->fileSystem->read(/* ... */);
+	}
+
+	...
+}
+```

utils/bg/finder.texy

@@ -61,6 +61,8 @@ Finder::findDirectories('vendor') // всички директории
 
 Можете да използвате [заместващи символи |#wildcards] `*`, `**`, `?` and `[...]` в маската. Можете дори да посочите директории, например `src/*.php` ще търси всички PHP файлове в директорията `src`.
 
+Симлинковете също се считат за директории или файлове.
+
 
 Къде да търсим? .[#toc-where-to-search]
 ---------------------------------------

utils/cs/filesystem.texy

@@ -2,7 +2,7 @@ Souborový systém
 ****************
 
 .[perex]
-[api:Nette\Utils\FileSystem] je statická třída s užitečnými funkcemi pro práci se souborovým systémem. Jednou z výhod oproti nativním PHP funkcím je, že v případě chyby vyhazují výjimky.
+[api:Nette\Utils\FileSystem] je třída s užitečnými funkcemi pro práci se souborovým systémem. Jednou z výhod oproti nativním PHP funkcím je, že v případě chyby vyhazují výjimky.
 
 
 Pokud potřebujete hledat soubory na disku, použijte [Finder|finder].
@@ -176,3 +176,27 @@ Převede lomítka na znaky specifické pro aktuální platformu, tj. `\` ve Wind
 ```php
 $path = FileSystem::platformSlashes($path);
 ```
+
+
+Statický vs nestatický přístup
+==============================
+
+Abyste kupříkladu pro účely testování mohli třídu snadno nahradit jinou (mockem), používejte ji nestaticky:
+
+```php
+class AnyClassUsingFileSystem
+{
+	public function __construct(
+		private FileSystem $fileSystem,
+	) {
+	}
+
+
+	public function readConfig(): string
+	{
+		return $this->fileSystem->read(/* ... */);
+	}
+
+	...
+}
+```

utils/cs/finder.texy

@@ -61,6 +61,8 @@ Alternativou statických metod je vytvoření instance pomocí `new Finder` (tak
 
 V masce můžete používat [zástupné znaky|#Zástupné znaky] `*`, `**`, `?` a `[...]`. Dokonce můžete specifikovat i v adresáře, například `src/*.php` vyhledá všechny PHP soubory v adresáři `src`.
 
+Symlinky jsou také považovány za adresáře nebo soubory.
+
 
 Kde se má hledat?
 -----------------

utils/de/filesystem.texy

@@ -2,7 +2,7 @@ Dateisystem-Funktionen
 **********************
 
 .[perex]
-[api:Nette\Utils\FileSystem] ist eine statische Klasse, die nützliche Funktionen für die Arbeit mit einem Dateisystem enthält. Ein Vorteil gegenüber nativen PHP-Funktionen ist, dass sie im Fehlerfall Ausnahmen auslösen.
+[api:Nette\Utils\FileSystem] ist eine Klasse, die nützliche Funktionen für die Arbeit mit einem Dateisystem enthält. Ein Vorteil gegenüber nativen PHP-Funktionen ist, dass sie im Fehlerfall Ausnahmen auslösen.
 
 
 Wenn Sie nach Dateien auf dem Datenträger suchen müssen, verwenden Sie den [Finder |finder].
@@ -176,3 +176,27 @@ Konvertiert Schrägstriche in Zeichen, die für die aktuelle Plattform spezifisc
 ```php
 $path = FileSystem::platformSlashes($path);
 ```
+
+
+Statischer vs. nicht-statischer Ansatz .[#toc-static-vs-non-static-approach]
+============================================================================
+
+Um die Klasse `FileSystem` einfach durch eine andere Klasse zu ersetzen, z. B. zu Testzwecken, verwenden Sie sie nicht-statisch:
+
+```php
+class AnyClassUsingFileSystem
+{
+	public function __construct(
+		private FileSystem $fileSystem,
+	) {
+	}
+
+
+	public function readConfig(): string
+	{
+		return $this->fileSystem->read(/* ... */);
+	}
+
+	...
+}
+```

utils/de/finder.texy

@@ -61,6 +61,8 @@ Eine Alternative zu statischen Methoden besteht darin, mit `new Finder` eine Ins
 
 Sie können [Wildcards |#wildcards] `*`, `**` verwenden, `?` and `[...]` in der Maske verwenden. Sie können sogar Verzeichnisse angeben, z. B. `src/*.php` sucht nach allen PHP-Dateien im Verzeichnis `src`.
 
+Symlinks werden auch als Verzeichnisse oder Dateien betrachtet.
+
 
 Wo soll gesucht werden? .[#toc-where-to-search]
 -----------------------------------------------

utils/el/filesystem.texy

@@ -2,7 +2,7 @@
 ******************************
 
 .[perex]
-[api:Nette\Utils\FileSystem] είναι μια στατική κλάση, η οποία περιέχει χρήσιμες συναρτήσεις για την εργασία με ένα σύστημα αρχείων. Ένα πλεονέκτημα σε σχέση με τις εγγενείς συναρτήσεις της PHP είναι ότι πετάνε εξαιρέσεις σε περίπτωση σφαλμάτων.
+[api:Nette\Utils\FileSystem] είναι μια κλάση, η οποία περιέχει χρήσιμες λειτουργίες για την εργασία με ένα σύστημα αρχείων. Ένα πλεονέκτημα σε σχέση με τις εγγενείς συναρτήσεις της PHP είναι ότι σε περίπτωση σφαλμάτων πετάνε εξαιρέσεις.
 
 
 Αν θέλετε να αναζητήσετε αρχεία στο δίσκο, χρησιμοποιήστε το [Finder |finder].
@@ -176,3 +176,27 @@ platformSlashes(string $path): string .[method]
 ```php
 $path = FileSystem::platformSlashes($path);
 ```
+
+
+Στατική έναντι μη στατικής προσέγγισης .[#toc-static-vs-non-static-approach]
+============================================================================
+
+Για να αντικαταστήσετε εύκολα την κλάση `FileSystem` με μια άλλη κλάση, για παράδειγμα για σκοπούς δοκιμών, χρησιμοποιήστε τη μη στατική:
+
+```php
+class AnyClassUsingFileSystem
+{
+	public function __construct(
+		private FileSystem $fileSystem,
+	) {
+	}
+
+
+	public function readConfig(): string
+	{
+		return $this->fileSystem->read(/* ... */);
+	}
+
+	...
+}
+```

utils/el/finder.texy

@@ -61,6 +61,8 @@ Finder::findDirectories('vendor') // όλοι οι κατάλογοι
 
 Μπορείτε να χρησιμοποιήσετε [μπαλαντέρ |#wildcards] `*`, `**`, `?` and `[...]` στη μάσκα. Μπορείτε ακόμη και να καθορίσετε σε καταλόγους, για παράδειγμα, το `src/*.php` θα αναζητήσει όλα τα αρχεία PHP στον κατάλογο `src`.
 
+Οι συμβολικοί σύνδεσμοι θεωρούνται επίσης κατάλογοι ή αρχεία.
+
 
 Πού να ψάξετε; .[#toc-where-to-search]
 --------------------------------------

utils/en/filesystem.texy

@@ -2,7 +2,7 @@ Filesystem Functions
 ********************
 
 .[perex]
-[api:Nette\Utils\FileSystem] is a static class, which contains useful functions for working with a filesystem. One advantage over native PHP functions is that they throw exceptions in case of errors.
+[api:Nette\Utils\FileSystem] is a class, which contains useful functions for working with a filesystem. One advantage over native PHP functions is that they throw exceptions in case of errors.
 
 
 If you need to search for files on the disk, use the [Finder |finder].
@@ -176,3 +176,27 @@ Converts slashes to characters specific to the current platform, i.e. `\` on Win
 ```php
 $path = FileSystem::platformSlashes($path);
 ```
+
+
+Static vs Non-static Approach
+=============================
+
+To easily replace the `FileSystem` class with another class for example for testing purposes, use it non-statically:
+
+```php
+class AnyClassUsingFileSystem
+{
+	public function __construct(
+		private FileSystem $fileSystem,
+	) {
+	}
+
+
+	public function readConfig(): string
+	{
+		return $this->fileSystem->read(/* ... */);
+	}
+
+	...
+}
+```

utils/en/finder.texy

@@ -61,6 +61,8 @@ An alternative to static methods is to create an instance using `new Finder` (th
 
 You can use [#wildcards] `*`, `**`, `?` and `[...]` in the mask. You can even specify in directories, for example `src/*.php` will search for all PHP files in the `src` directory.
 
+Symlinks are also considered directories or files.
+
 
 Where to Search?
 ----------------