qapytest 0.2.0__tar.gz → 0.3.0__tar.gz

{qapytest-0.2.0 → qapytest-0.3.0}/CHANGELOG.md

@@ -5,9 +5,30 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2025-10-24
+
+### Added
+
+- 🎭 **Playwright integration** - pytest-playwright support with cross-browser testing (Chromium, Firefox, WebKit)
+- 🌐 **Browser automation** - video recording, screenshots, traces, and mobile device emulation
+- 🎲 **Faker integration** - built-in test data generation
+- 🏷️ **Logger naming** - added ability to provide custom names for client loggers
+
+### Changed
+
+- 📚 **Documentation updates** - CLI and API docs
+- 📚 **Third-party notices** - added Playwright and Faker licenses
+- 🔧 **Project structure** - enhanced with browser testing capabilities
+- 🧪 **Demo examples** - enhanced demo.py with comprehensive test scenarios
+
+### Fixed
+
+- 🔧 **Internal fixes** - resolved internal bugs and improved stability
+
 ## [0.2.0] - 2025-10-06
 
 ### 🔧 Refactoring
+
 - **Refactored public methods** - updated SqlClient API structure
 - **Updated documentation** - aligned with current SqlClient implementation
 - **Fixed tests** - updated test cases to match current SqlClient implementation
@@ -15,6 +36,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.6] - 2025-09-30
 
 ### Fixed
+
 - 🔴 **RedisClient** - improved connection handling and management
 - 🔧 **Configuration** - fixed Redis client configuration and connection parameters
 - 🔇 **HTTP library logging** - suppressed verbose logging from httpx, httpcore, and urllib3 to WARNING level to reduce noise in test output
@@ -22,18 +44,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.5] - 2025-09-25
 
 ### Fixed
+
 - 🔒 **HTTP request logging** - fixed data masking in HTTP request/response logging to properly sanitize sensitive information
 - 🌐 **Response headers logging** - improved logging of response headers with enhanced data sanitization
 
 ## [0.1.4] - 2025-09-25
 
 ### Enhanced
+
 - 🔒 **Sensitive data masking** - comprehensive masking for headers, JSON fields, and text patterns in HTTP/GraphQL clients
 - 🌐 **HttpClient & GraphQLClient** - unified BaseHttpClient architecture with enhanced logging and data sanitization
 - 📝 **Documentation** - updated API documentation with complete parameter descriptions and sensitive data masking features
 - 🔗 **README links** - fixed GitHub documentation links to use absolute URLs
 
 ### Added
+
 - 🛡️ **New configuration options** for HttpClient and GraphQLClient:
   - `sensitive_headers` - set of header names to mask in logs
   - `sensitive_json_fields` - set of JSON field names to mask
@@ -41,6 +66,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `mask_sensitive_data` - toggle for sensitive data masking
 
 ### Fixed
+
 - 🧪 **Test improvements** - enhanced test coverage for logging assertions and header sanitization
 - 📊 **GraphQL client** - removed unnecessary mocks and improved test assertions
 - 🔧 **Import organization** - refactored client imports for better maintainability
@@ -48,6 +74,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.3] - 2025-09-24
 
 ### Fixed
+
 - 🌐 **HTTP request logging** - improved logging format and sensitive data sanitization in HTTP requests/responses
 - 📊 **GraphQL client** - enhanced logging and data masking capabilities for GraphQL operations
 - 🧪 **Internal testing improvements** - updated test suite to align with current HttpClient and GraphQLClient implementations
@@ -55,11 +82,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.2] - 2025-09-22
 
 ### Fixed
+
 - 🌐 **Unicode support in HTML reports** - fixed display of Cyrillic and other non-ASCII characters in parametrized test names
 - 📊 **Parameter display** - test parameters with Unicode characters now show properly instead of escape sequences
 - 🔧 **NodeID formatting** - improved Unicode handling in test identification strings
 
 ### Added
+
 - ✅ **Unicode decoding functions** - added `decode_unicode_escapes()` utility for proper character rendering
 - 📝 **Enhanced parameter parsing** - improved `parse_params_from_nodeid()` with Unicode escape sequence support
 - 🧪 **Comprehensive tests** - added test coverage for Unicode handling functions
@@ -67,6 +96,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.1] - 2025-09-19
 
 ### Changed
+
 - 🔧 **Internal improvements** - enhanced project structure and configuration
 - 📝 **Documentation updates** - improved README with badges and better formatting
 - ⚙️ **Build configuration** - optimized pyproject.toml for PyPI publishing
@@ -76,6 +106,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.1.0] - 2025-09-19
 
 ### Added
+
 - 🚀 **Initial release** of QaPyTest - powerful testing framework for QA engineers
 - 📊 **HTML report generation** with customizable themes (light/dark/auto)
 - 🎯 **Soft assertions** - collect multiple failures in single test run
@@ -92,6 +123,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 📚 **Comprehensive documentation** - API reference and CLI guide
 
 ### Features
+
 - Python 3.10+ support
 - Pytest plugin architecture
 - Self-contained HTML reports
@@ -99,6 +131,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Configurable attachment size limits
 - Professional report styling with responsive design
 
+[0.3.0]: https://github.com/o73k51i/qapytest/releases/tag/v0.3.0
+[0.3.0]: https://github.com/o73k51i/qapytest/releases/tag/v0.3.0
 [0.2.0]: https://github.com/o73k51i/qapytest/releases/tag/v0.2.0
 [0.1.6]: https://github.com/o73k51i/qapytest/releases/tag/v0.1.6
 [0.1.5]: https://github.com/o73k51i/qapytest/releases/tag/v0.1.5
@@ -106,4 +140,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [0.1.3]: https://github.com/o73k51i/qapytest/releases/tag/v0.1.3
 [0.1.2]: https://github.com/o73k51i/qapytest/releases/tag/v0.1.2
 [0.1.1]: https://github.com/o73k51i/qapytest/releases/tag/v0.1.1
-[0.1.0]: https://github.com/o73k51i/qapytest/releases/tag/v0.1.0
+[0.1.0]: https://github.com/o73k51i/qapytest/releases/tag/v0.1.0

qapytest-0.3.0/NOTICE

@@ -0,0 +1,23 @@
+This project includes components licensed under the Apache License, Version 2.0.
+
+Specifically:
+
+- Playwright for Python
+  Copyright (c) Microsoft Corporation
+  Licensed under the Apache License, Version 2.0
+  https://github.com/microsoft/playwright-python
+
+- pytest-playwright
+  Copyright (c) Microsoft Corporation
+  Licensed under the Apache License, Version 2.0
+  https://github.com/microsoft/playwright-pytest
+
+You may obtain a copy of the Apache License at:
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

{qapytest-0.2.0 → qapytest-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qapytest
-Version: 0.2.0
+Version: 0.3.0
 Summary: A powerful testing framework based on pytest, specifically designed for QA engineers
 Project-URL: Homepage, https://github.com/o73k51i/qapytest
 Project-URL: Repository, https://github.com/o73k51i/qapytest
@@ -29,6 +29,7 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
 License-File: LICENSE
+License-File: NOTICE
 Keywords: automation,graphql,http,pytest,qa,redis,soft-assert,sql,test,testing
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: Pytest
@@ -42,9 +43,11 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Software Development :: Testing
 Requires-Python: <3.14,>=3.10
+Requires-Dist: faker>=37.11.0
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: jinja2>=3.1.6
 Requires-Dist: jsonschema>=4.25.1
+Requires-Dist: pytest-playwright>=0.7.1
 Requires-Dist: pytest>=8.4.2
 Requires-Dist: python-dotenv>=1.1.1
 Requires-Dist: redis>=6.4.0
@@ -54,40 +57,53 @@ Description-Content-Type: text/markdown
 # QaPyTest
 
 [![PyPI version](https://img.shields.io/pypi/v/qapytest.svg)](https://pypi.org/project/qapytest/)
+[![PyPI Downloads](https://static.pepy.tech/personalized-badge/qapytest?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLUE&right_color=YELLOW&left_text=downloads)](https://pepy.tech/projects/qapytest)
 [![Python versions](https://img.shields.io/pypi/pyversions/qapytest.svg)](https://pypi.org/project/qapytest/)
 [![License](https://img.shields.io/github/license/o73k51i/qapytest.svg)](https://github.com/o73k51i/qapytest/blob/main/LICENSE)
 [![GitHub stars](https://img.shields.io/github/stars/o73k51i/qapytest.svg?style=social)](https://github.com/o73k51i/qapytest)
 
-`QaPyTest` — a powerful testing framework based on pytest, specifically designed for QA engineers.
-Turn your ordinary tests into detailed, structured reports with built-in HTTP, SQL, Redis and GraphQL clients.
+`QaPyTest` — a powerful testing framework based on pytest, specifically
+designed for QA engineers. Turn your ordinary tests into detailed, structured
+reports with built-in HTTP, SQL, Redis and GraphQL clients.
 
-🎯 **QA made for QA** — every feature is designed for real testing and debugging needs.
+🎯 **QA made for QA** — every feature is designed for real testing and
+debugging needs.
 
 ## ⚡ Why QaPyTest?
 
 - **🚀 Ready to use:** Install → run → get a beautiful report
 - **🔧 Built-in clients:** HTTP, SQL, Redis, GraphQL — all in one package
 - **📊 Professional reports:** HTML reports with attachments and logs
-- **🎯 Soft assertions:** Collect multiple failures in one run instead of stopping at the first
+- **🎯 Soft assertions:** Collect multiple failures in one run instead of
+  stopping at the first
 - **📝 Structured steps:** Make your tests self-documenting
 - **🔍 Debugging friendly:** Full traceability of every action in the test
 
 ## ⚙️ Key features
 
 - **HTML report generation:** simple report at `report.html`.
-- **Soft assertions:** allow collecting multiple failures in a single run without immediately ending the test.
-- **Advanced steps:** structured logging of test steps for better report readability.
+- **Soft assertions:** allow collecting multiple failures in a single run
+  without immediately ending the test.
+- **Advanced steps:** structured logging of test steps for better report
+  readability.
 - **Attachments:** ability to add files, logs and screenshots to test reports.
 - **HTTP client:** client for performing HTTP requests.
 - **SQL client:** client for executing raw SQL queries.
 - **Redis client:** client for working with Redis.
 - **GraphQL client:** client for executing GraphQL requests.
-- **JSON Schema validation:** function to validate API responses or test artifacts with support for soft-assert and strict mode.
+- **Browser automation:** seamless integration with pytest-playwright for
+  end-to-end web testing.
+- **Test data generation:** built-in Faker support for creating realistic test
+  data.
+- **JSON Schema validation:** function to validate API responses or test
+  artifacts with support for soft-assert and strict mode.
 
 ## 👥 Ideal for
 
-- **QA Engineers** — automate testing of APIs, databases and web services
-- **Test Automation specialists** — get a ready toolkit for comprehensive testing
+- **QA Engineers** — automate testing of APIs, databases, web services and
+  browser interfaces
+- **Test Automation specialists** — get a ready toolkit for comprehensive
+  testing including web automation
 
 ## 🚀 Quick start
 
@@ -100,27 +116,38 @@ pip install qapytest
 ### 2️⃣ Your first powerful test
 
 ```python
-from qapytest import step, attach, soft_assert, HttpClient, SqlClient
+from qapytest import step, attach, soft_assert, HttpClient, SqlClient, Faker
 
 def test_comprehensive_api_validation():
+    fake = Faker()
+
+    # Generate realistic test data
+    user_data = {"name": fake.name(), "email": fake.email()}
+
     # Structured steps for readability
     with step('🌐 Testing API endpoint'):
         client = HttpClient(base_url="https://api.example.com")
-        response = client.get("/users/1")
-        assert response.status_code == 200
-    
+        response = client.post("/users", json=user_data)
+        assert response.status_code == 201
+
     # Add artifacts for debugging
     attach(response.text, 'api_response.json')
-    
+
     # Soft assertions - collect all failures
-    soft_assert(response.json()['id'] == 1, 'User ID check')
-    soft_assert(response.json()['active'], 'User is active')
-    
+    soft_assert(response.json()['id'] > 0, 'User ID check')
+    soft_assert(
+      response.json()['email'] == user_data['email'],
+      'Email matches'
+    )
+
     # Database integration
     with step('🗄️ Validate data in DB'):
-        db = SqlClient("postgresql://user:pass@localhost/db")
-        user_data = db.fetch_data("SELECT * FROM users WHERE id = 1")
-        assert len(user_data) == 1
+        db = SqlClient("sqlite:///:memory:")
+        user_db_data = db.fetch_data(
+            "SELECT * FROM users WHERE email = :email",
+            params={"email": user_data['email']}
+        )
+        assert len(user_db_data) == 1
 ```
 
 ### 3️⃣ Run with beautiful reports
@@ -133,36 +160,51 @@ pytest --report-html
 ## 🔌 Built-in clients — everything QA needs
 
 ### 🌐 HttpClient — HTTP testing on steroids
+
 ```python
-client = HttpClient(base_url="https://api.example.com", timeout=30)
-response = client.post("/auth/login", json={"username": "test"})
-# Automatic logging of requests/responses + timing + headers
+client = HttpClient(base_url="https://api.example.com")
+response = client.post("/auth/login", json={"foo": "bar"})
 ```
 
-### 🗄️ SqlClient — Direct DB access  
+### 📊 GraphQL client — Modern APIs with minimal effort
+
 ```python
-db = SqlClient("postgresql://localhost/testdb")
-users = db.fetch_data("SELECT * FROM users WHERE active = true")
+gql = GraphQLClient("https://api.github.com/graphql")
+result = gql.execute("query { viewer { foo } }")
 ```
 
-### 📊 GraphQL client — Modern APIs with minimal effort
+### 🗄️ SqlClient — Direct DB access
+
 ```python
-gql = GraphQLClient("https://api.github.com/graphql", 
-                   headers={"Authorization": "Bearer token"})
-result = gql.execute("query { viewer { login } }")
+db = SqlClient("sqlite:///:memory:")
+users = db.fetch_data("SELECT foo FROM bar")
 ```
 
 ### 🔴 RedisClient — Enhanced Redis operations with logging
+
+```python
+redis_client = RedisClient(host="localhost")
+redis_client.set("foo", "bar")
+foo = redis_client.get("foo")
+```
+
+### 🎭 Browser automation — powered by Playwright
+
 ```python
-import json
-redis_client = RedisClient(host="localhost", port=6379, db=0)
-redis_client.set("session:123", json.dumps({"user_id": 1, "expires": "2024-01-01"}))
-session_data = json.loads(redis_client.get("session:123"))
+def test_web_app(page):
+    fake = Faker()
+    # Navigate to login page
+    page.goto("https://example.com/login")
+    # Generate and fill test data
+    page.get_by_label("Username").fill(fake.user_name())
+    page.get_by_label("Password").fill(fake.password())
+    page.get_by_role("button", name="Log in").click()
 ```
 
 ## 🎛️ Core testing tools
 
 ### 📝 Structured steps
+
 ```python
 with step('🔍 Check authorization'):
     with step('Send login request'):
@@ -171,28 +213,37 @@ with step('🔍 Check authorization'):
         assert "token" in response.json()
 ```
 
-### 🎯 Soft Assertions — collect all failures  
+### 🎯 Soft Assertions — collect all failures
+
 ```python
-soft_assert(user.id == 1, 'User ID')
-soft_assert(user.active, 'Active status')
-soft_assert('admin' == user.roles, 'Access rights')
+soft_assert(user.id == 1, "Check user ID")
+soft_assert(user.active, 'Check status')
 # The test will continue and show all failures together!
 ```
 
 ### 📎 Attachments — full context
+
 ```python
 attach(response.json(), 'server response')
-attach(screenshot_bytes, 'error page') 
+attach(screenshot_bytes, 'error page')
 attach(content, 'application', mime='text/plain')
 ```
 
 ### ✅ JSON Schema validation
+
 ```python
 # Strict validation — stop the test on schema validation error
 validate_json(api_response, schema_path="user_schema.json", strict=True)
-
 # Soft mode — collect all schema errors and continue test execution
-validate_json(api_response, schema=user_schema, strict=False)
+validate_json(api_response, schema=user_schema)
+```
+
+### 🎲 Faker — Realistic test data generation
+
+```python
+fake = Faker()
+fake.text(max_nb_chars=200)  # Random text
+fake.random_int(min=1, max=100)  # Random numbers
 ```
 
 More about the API on the [documentation page](https://github.com/o73k51i/qapytest/blob/main/docs/API.md).
@@ -201,8 +252,10 @@ More about the API on the [documentation page](https://github.com/o73k51i/qapyte
 
 QaPyTest also supports custom pytest markers to improve reporting:
 
-- **`@pytest.mark.title("Custom Test Name")`** : sets a custom test name in the HTML report
-- **`@pytest.mark.component("API", "Database")`** : adds component tags to the test
+- **`@pytest.mark.title("Custom Test Name")`** : sets a custom test name in
+  the HTML report
+- **`@pytest.mark.component("API", "Database")`** : adds component tags to
+  the test
 
 ### Example usage of markers
 
@@ -212,18 +265,20 @@ import pytest
 @pytest.mark.title("User authorization check")
 @pytest.mark.component("Auth", "API")
 def test_user_login():
-    # test code
     pass
 ```
 
 ## ⚙️ CLI options
 
-- **`--env-file`** : path to an `.env` file with environment settings (default — `./.env`).
-- **`--env-override`** : if set, values from the `.env` file will override existing environment variables.
-- **`--report-html [PATH]`** : create a self-contained HTML report; optionally specify a path (default — `report.html`).
+- **`--env-file`** : path to an `.env` file with environment settings
+  (default — `./.env`).
+- **`--env-override`** : if set, values from the `.env` file will override
+  existing environment variables.
+- **`--report-html [PATH]`** : create a self-contained HTML report; optionally
+  specify a path (default — `report.html`).
 - **`--report-title NAME`** : set the HTML report title.
-- **`--report-theme {light,dark,auto}`** : choose the report theme: `light`, `dark` or `auto` (default).
-- **`--max-attachment-bytes N`** : maximum size of an attachment (in bytes) that will be inlined in the HTML; larger files will be truncated.
+- **`--report-theme {light,dark,auto}`** : choose the report theme: `light`,
+  `dark` or `auto` (default).
 
 More about CLI options on the [documentation page](https://github.com/o73k51i/qapytest/blob/main/docs/CLI.md).