File upload handling in Selenium Python - Framework Patterns

Framework Mode - File upload handling

Folder Structure

file_upload_project/
├── src/
│   ├── pages/
│   │   └── upload_page.py
│   ├── tests/
│   │   └── test_file_upload.py
│   ├── utils/
│   │   └── helpers.py
│   └── config.py
├── resources/
│   └── test_files/
│       └── sample_upload.txt
├── reports/
│   └── report.html
├── requirements.txt
└── pytest.ini

Test Framework Layers

• Driver Layer: Manages Selenium WebDriver setup and teardown (in conftest.py or fixtures).
• Page Objects: upload_page.py contains methods to interact with file upload elements using best locator practices.
• Tests: test_file_upload.py holds test cases that use page objects to perform file upload and verify results.
• Utilities: Helper functions in helpers.py for common tasks like file path resolution.
• Configuration: config.py stores environment variables, URLs, and test data paths.

Configuration Patterns

• Use config.py to define environment URLs, browser options, and file paths.
• Use environment variables or command line options to switch browsers or environments.
• Store test files in resources/test_files/ to keep test data separate from code.
• Use pytest fixtures in conftest.py to initialize WebDriver with desired capabilities.

Test Reporting and CI/CD Integration

• Use pytest with plugins like pytest-html to generate readable HTML reports in reports/.
• Integrate tests into CI pipelines (GitHub Actions, Jenkins) to run on each commit.
• Configure CI to upload reports as artifacts for easy access.
• Use clear assertion messages to help diagnose file upload failures.

Best Practices

1. Use Page Object Model: Encapsulate file upload element locators and actions in page classes.
2. Use Absolute File Paths: Resolve file paths dynamically to avoid issues across environments.
3. Explicit Waits: Wait for upload elements to be visible and ready before interacting.
4. Keep Test Data Separate: Store upload files outside code folders for easy maintenance.
5. Clear Assertions: Verify upload success by checking UI messages or file presence after upload.

Self Check

Where in this folder structure would you add a new page object for a "Profile Picture Upload" feature?

Key Result

Organize Selenium Python tests with clear layers: page objects for upload, config for environments, and separate test data for reliable file upload handling.