DEV.co
Open-Source Testing · SeldomQA

seldom

Seldom is a Python-based test automation framework built on unittest that supports web UI, API, and mobile app testing. It provides scaffolding, data-driven testing, rich assertions, and HTML reporting via XTestRunner.

Source: GitHub — github.com/SeldomQA/seldom
854
GitHub stars
332
Forks
Python
Primary language
Apache-2.0
License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

FieldValue
RepositorySeldomQA/seldom
OwnerSeldomQA
Primary languagePython
LicenseApache-2.0 — OSI-approved
Stars854
Forks332
Open issues13
Latest releaseUnknown
Last updated2026-02-25
Sourcehttps://github.com/SeldomQA/seldom

What seldom is

Seldom extends unittest with Selenium/Appium/Requests integration, offering CLI-driven test generation, HAR/Swagger conversion, parameterized test data loading, and modern HTML report generation. It runs via command-line tools rather than IDE execution.

Quickstart

Get the seldom source

Clone the repository and explore it locally.

terminalbash
git clone https://github.com/SeldomQA/seldom.gitcd seldom# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Multi-channel test automation (Web/API/App)

Single framework for coordinated UI, HTTP, and mobile app testing with unified assertion and reporting layers.

Data-driven test scenarios with external datasources

Built-in support for JSON/Excel test data files and parameterized execution, reducing test code duplication.

Rapid test project scaffolding

CLI generates project structure (test_dir, test_data, reports, config) in seconds; useful for teams standardizing test organization.

Implementation considerations

  • Runs via CLI (seldom -p path), not IDE plugins; requires shell/script integration for test execution.
  • Inheritance of unittest means Python developers familiar with unittest will recognize patterns, but Seldom-specific APIs differ.
  • Data-driven tests load from JSON/Excel files; ensure test data is managed separately and version-controlled.
  • HAR/Swagger import features reduce manual test writing for API/HTTP scenarios but require valid input format.
  • HTML reports are generated automatically; define reports/ directory and monitor disk usage in long-running suites.

When to avoid it — and what to weigh

  • Require active upstream maintenance & issue response — Latest release is marked 'none (n/a)' and 13 open issues exist; no visible release cadence. Consider if your team needs timely bug fixes or feature support.
  • Need out-of-the-box CI/CD integration — No mention of native Jenkins, GitHub Actions, or other CI platform support; may require custom wrappers.
  • Enterprise-grade reporting & analytics — XTestRunner provides HTML reports but no integration with centralized test management platforms or metrics aggregation.
  • Require comprehensive official English documentation — README is primarily in Chinese; English examples and docs are limited. Non-Chinese teams may face onboarding friction.

License & commercial use

Licensed under Apache License 2.0 (Apache-2.0), an OSI-approved permissive license permitting commercial use, modification, and distribution with attribution and liability disclaimer.

Apache-2.0 permits commercial use. No proprietary or open-source restrictions on using Seldom in production test automation. However, consult your legal team if integrating third-party drivers or dependencies under different licenses.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

SignalAssessment
MaintenanceModerate
DocumentationAdequate
License clarityClear
Deployment complexityLow
DEV.co fitGood
Assessment confidenceMedium
Security considerations

No explicit security audit or vulnerability disclosure policy mentioned. Seldom wraps Selenium/Appium/Requests; inherited security depends on those libraries. Avoid embedding credentials in test code or test data files; use environment variables or secrets management. No secure logging or data masking features mentioned.

Alternatives to consider

Robot Framework

Keyword-driven, language-agnostic, mature ecosystem, strong documentation. Better for non-Python teams and complex test orchestration.

Pytest + pytest-selenium/requests

More modular, larger plugin ecosystem, stronger community support. Preferred if you need flexibility and extensive integrations.

TestNG (Java) or NUnit (C#)

Better for polyglot teams or enterprises already invested in JVM/CLR. Offer mature reporting and CI/CD integration.

Software development agency

Build on seldom with DEV.co software developers

Seldom suits teams automating multi-channel QA (UI, API, mobile) in Python. Assess maintenance cadence, language barrier, and CI/CD fit before adoption. Contact us to discuss test automation strategy.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

seldom FAQ

Can I run Seldom tests in parallel?
Not explicitly documented. Seldom inherits unittest; unittest's default runner is serial. Parallel execution requires third-party runners (e.g., pytest-xdist) or custom integration.
Does Seldom support cloud/remote testing (BrowserStack, Sauce Labs)?
Unknown. No mention in README. Custom Selenium/Appium remote URL support is likely possible via base_url config, but official integration is not documented.
What Python versions are supported?
Badge shown: 'PyPI - Python Version'. Specific versions not listed. Check PyPI page or setup.py for python_requires.
Can I integrate Seldom with my existing unittest test suite?
Yes. Seldom extends unittest.TestCase. Existing unittest tests can adopt Seldom's APIs incrementally, or run Seldom tests alongside unittest tests.

Software development & web development with DEV.co

From first prototype to production, DEV.co delivers software development services around tools like seldom. Our software development agency staffs experienced software developers and web developers for custom software development, web development, integrations, and ongoing support across open-source testing and beyond.

Evaluate Seldom for Your Test Automation Needs

Seldom suits teams automating multi-channel QA (UI, API, mobile) in Python. Assess maintenance cadence, language barrier, and CI/CD fit before adoption. Contact us to discuss test automation strategy.