README

PHP 8.5+ deterministic generator of coherent synthetic browser User-Agent profiles for tests, fixtures, and controlled client configuration.

Features

• Checksummed bundled dataset with provenance on every result
• Seeded, weighted, uniform, and round-robin profile selection
• Immutable fluent request builder and bounded unique batch generation
• generatePool() for a list of ready-to-use User-Agent strings
• Stable profile identity for logs and fixtures
• Non-interactive CLI with JSON and NDJSON output

Requirements

• PHP >= 8.5
• ext-json
• jooservices/dto ^3.0

Installation

composer require jooservices/useragent:^4.0

Quick start

use JOOservices\UserAgent\Generator;

$generator = Generator::create();
$pool = $generator->builder()
    ->chrome()
    ->windows()
    ->desktop()
    ->seed(42)
    ->generatePool(10);

Design notes

• Reuse one Generator instance in long-running processes; it loads and validates the bundled dataset once.
• A User-Agent string is synthetic metadata, not browser emulation.
• The package performs no network access and does not accept a caller-provided dataset path.

Documentation

• Changelog
• Upgrade guide
• Contributing
• Workflows

Development

make build
make install
make lint
make test
make ci

Community

• Security policy
• Support
• Code of Conduct
• Governance

License

MIT — see LICENSE.