# STRling Perl adapter STRling 4.0.1 is not publicly published. Public installation commands describe the proposed separately authorized release. Candidate tests use staged artifacts. See the [support matrix](../../docs/support-matrix.md) for exact supported scopes. This distribution is a thin Perl projection of the canonical STRling compiler. `FFI::Platypus` carries strict JSON over a caller-selected `strling.c-abi` version 1 library. The distribution no longer owns parsing, semantics, validation, target selection, or regex emission. The adapter is a provisional Preview candidate during the Fourth Edition migration. This is not a publication or permanent support-tier promise. ## Requirements - Perl `>= 5.10, < 6.0` - `FFI::Platypus >= 2.10` and `JSON::PP >= 4.00` - a compatible native STRling library chosen by the application ## Use Pass the authenticated absolute native-library path as the first program argument. The example requires an installed package and its declared dependencies. ```perl use STRling qw(load_native source_compile_request simply_builder_request email); my $client = load_native($ARGV[0] // die 'pass the authenticated absolute native path'); my $result = $client->compile(source_compile_request('semantic strling 1.0; case sensitive; pattern text "hello";')); die 'canonical compile failed' unless $result->{outcome} eq 'succeeded'; my $builder = simply_builder_request([email('root')], 'root'); my $simply_result = $client->simply_compile($builder); die 'Simply compile failed' unless $simply_result->{status} eq 'success' && $simply_result->{compile_result}{outcome} eq 'succeeded'; $client->close(); ``` Generated helpers are lexical-shape recipes, not semantic validators. Native loading is absolute and explicit; ABI, symbol, encoding, JSON, duplicate-property, size, ownership, and closed-client failures stop execution. No ambient lookup or alternate compiler route exists. See the [canonical interop contract](../../spec/interop/1.0/README.md) and the [migration record](../../docs/migration/dynamic-language-adapter-migration.md). ## Proposed public installation After separately authorized publication, the exact proposed coordinate is: ```bash cpanm STRling@4.0.1 ``` The exact approved PAUSE owner and release archive must be reconciled in the protected publication handoff. Dependency-locking limits remain Preview.