nette/tester 2.5.6

Author: dg

tester/cs/assertions.texy

@@ -227,6 +227,11 @@ Assert::match('Error in file %a% on line %i%', $errorMessage);
 ```
 
 
+Assert::notMatch(string $pattern, $actual, ?string $description=null) .[method]{data-version:2.5.6}
+---------------------------------------------------------------------------------------------------
+Opak `Assert::match()`.
+
+
 Assert::matchFile(string $file, $actual, ?string $description=null) .[method]
 -----------------------------------------------------------------------------
 Aserce je totožná s [#Assert::match()], ale vzor se načítá ze souboru `$file`. To je užitečné pro testování velmi dlouhých řetězců. Soubor s testem zůstane přehledný.

tester/cs/helpers.texy

@@ -2,6 +2,84 @@ Pomocné třídy
 *************
 
 
+HttpAssert .{data-version:2.5.6}
+----------
+Třída `Tester\HttpAssert` slouží k testování HTTP serveru. Umožňuje jednoduše provádět HTTP požadavky a ověřovat jejich stavové kódy, hlavičky i obsah odpovědi.
+
+Metoda `fetch()` provede HTTP požadavek a vrátí instanci `HttpAssert` pro následné ověřování pomocí fluent interface.
+
+```php
+# Základní HTTP požadavek a ověření odpovědi
+$response = Tester\HttpAssert::fetch('https://example.com/api/users');
+$response
+	->expectCode(200)
+	->expectHeader('Content-Type', contains: 'json')
+	->expectBody(contains: 'users');
+```
+
+Metoda `fetch()` standarně vytváří GET požadavek, ale metodu lze snadno změnit:
+
+```php
+# POST s obsahem požadavku
+HttpAssert::fetch(
+	'https://api.example.com/users',
+	method: 'POST',
+	body: '{"name": "John", "email": "[email protected]"}'
+)
+	->expectCode(201)
+	->expectBody(contains: 'created');
+```
+
+Stavové kódy můžete ověřovat metodami `expectCode()` a `denyCode()`. Jako parametr předáte buď konkrétní číslo, nebo validační funkci:
+
+```php
+$response
+	->expectCode(200)                           # přesný kód
+	->expectCode(fn($code) => $code < 400)      # vlastní validace
+	->denyCode(404)                             # nesmí být 404
+	->denyCode(fn($code) => $code >= 500);      # nesmí být chyba serveru
+```
+
+Pro práci s hlavičkami slouží metody `expectHeader()` a `denyHeader()`. Můžete kontrolovat existenci hlavičky, její přesnou hodnotu nebo jen část obsahu:
+
+```php
+$response
+	->expectHeader('Content-Type')                     # hlavička musí existovat
+	->expectHeader('Content-Type', 'application/json') # přesná hodnota
+	->expectHeader('Content-Type', contains: 'json')   # obsahuje text
+	->expectHeader('Server', matches: 'nginx %a%')     # odpovídá vzoru
+	->denyHeader('X-Powered-By');                      # hlavička nesmí existovat
+```
+
+Obdobně funguje ověřování těla odpovědi prostřednictvím metod `expectBody()` a `denyBody()`:
+
+```php
+$response
+	->expectBody(contains: '"status": "success"')      # obsahuje část JSON
+	->expectBody(matches: '%A% hello %A%')             # odpovídá vzoru
+	->expectBody(fn($body) => json_decode($body))      # vlastní validace
+	->denyBody(contains: 'error')                      # nesmí obsahovat text
+	->denyBody(matches: '~exception|fatal~i');         # nesmí odpovídat vzoru
+```
+
+Při vytváření požadavků můžete nastavit vlastní hlavičky a cookies:
+
+```php
+HttpAssert::fetch(
+	'https://api.example.com/protected',
+	headers: [
+		'Authorization' => 'Bearer token123',
+		'Accept' => 'application/json',
+	],
+	cookies: [
+		'session' => 'abc123',
+		'preferences' => 'dark-mode',
+	]
+)
+	->expectCode(200);
+```
+
+
 DomQuery
 --------
 `Tester\DomQuery` je třída rozšiřující `SimpleXMLElement` o snadné vyhledávání v HTML nebo XML pomocí CSS selektorů.

tester/en/assertions.texy

@@ -227,6 +227,11 @@ Assert::match('Error in file %a% on line %i%', $errorMessage);
 ```
 
 
+Assert::notMatch(string $pattern, $actual, ?string $description=null) .[method]{data-version:2.5.6}
+---------------------------------------------------------------------------------------------------
+Opposite of `Assert::match()`.
+
+
 Assert::matchFile(string $file, $actual, ?string $description=null) .[method]
 -----------------------------------------------------------------------------
 This assertion is identical to [#Assert::match()], but the pattern is loaded from the file `$file`. This is useful for testing very long strings. The test file remains clear.

tester/en/helpers.texy

@@ -2,6 +2,84 @@ Helpers
 *******
 
 
+HttpAssert .{data-version:2.5.6}
+----------
+The `Tester\HttpAssert` class provides tools for testing HTTP responses. It allows you to perform HTTP requests and verify status codes, headers, and response body content using a fluent interface.
+
+The `fetch()` method makes an HTTP request and returns an HttpAssert instance for chaining verification methods:
+
+```php
+# Basic HTTP request and response verification
+$response = Tester\HttpAssert::fetch('https://example.com/api/users');
+$response
+	->expectCode(200)
+	->expectHeader('Content-Type', contains: 'json')
+	->expectBody(contains: 'users');
+```
+
+By default, `fetch()` performs a GET request, but you can specify different HTTP methods:
+
+```php
+# POST with request body
+HttpAssert::fetch(
+	'https://api.example.com/users',
+	method: 'POST',
+	body: '{"name": "John", "email": "[email protected]"}'
+)
+	->expectCode(201)
+	->expectBody(contains: 'created');
+```
+
+Status codes can be verified using `expectCode()` and `denyCode()` methods. You can pass either a specific number or a validation function:
+
+```php
+$response
+	->expectCode(200)                           # exact code
+	->expectCode(fn($code) => $code < 400)      # custom validation
+	->denyCode(404)                             # must not be 404
+	->denyCode(fn($code) => $code >= 500);      # must not be server error
+```
+
+For header verification, use `expectHeader()` and `denyHeader()` methods. You can check whether a header exists, verify its exact value, or match part of its content:
+
+```php
+$response
+	->expectHeader('Content-Type')                     # header must exist
+	->expectHeader('Content-Type', 'application/json') # exact value
+	->expectHeader('Content-Type', contains: 'json')   # contains text
+	->expectHeader('Server', matches: 'nginx %a%')     # matches pattern
+	->denyHeader('X-Powered-By');                      # header must not exist
+```
+
+Response body verification works similarly with `expectBody()` and `denyBody()` methods:
+
+```php
+$response
+	->expectBody(contains: '"status": "success"')      # contains JSON fragment
+	->expectBody(matches: '%A% hello %A%')             # matches pattern
+	->expectBody(fn($body) => json_decode($body))      # custom validation
+	->denyBody(contains: 'error')                      # must not contain text
+	->denyBody(matches: '~exception|fatal~i');         # must not match pattern
+```
+
+You can customize requests by setting headers and cookies:
+
+```php
+HttpAssert::fetch(
+	'https://api.example.com/protected',
+	headers: [
+		'Authorization' => 'Bearer token123',
+		'Accept' => 'application/json',
+	],
+	cookies: [
+		'session' => 'abc123',
+		'preferences' => 'dark-mode',
+	]
+)
+	->expectCode(200);
+```
+
+
 DomQuery
 --------
 `Tester\DomQuery` is a class extending `SimpleXMLElement` with easy querying in HTML or XML using CSS selectors.