pulumi/cmd/pulumi-test-language
Fraser Waters 4516fbce89
Add a test of sending primitive values for a resource (#16718)
We already had the "simple" provider test that just checked we could
make a resource with a single simple bool field. This adds a new
"primitive' provider and checks we can send strings, numbers, integers,
arrays and maps from the program.
2024-07-22 21:13:11 +00:00
..
providers Add a test of sending primitive values for a resource (#16718) 2024-07-22 21:13:11 +00:00
testdata Add a test of sending primitive values for a resource (#16718) 2024-07-22 21:13:11 +00:00
README.md Add sequence diagram about pulumi-test-language (#15289) 2024-01-29 22:08:14 +00:00
go.mod Changelog and go.mod updates for v3.125.0 (#16716) 2024-07-19 12:58:37 +00:00
go.sum Bump the go_modules group across 2 directories with 1 update (#16464) 2024-06-28 22:17:40 +00:00
interface.go Enable the l1-empty test for Go (#16686) 2024-07-17 13:15:07 +00:00
interface_test.go Add a test of sending primitive values for a resource (#16718) 2024-07-22 21:13:11 +00:00
internal_test.go Run pulumi-test-language tests in parallel (#16060) 2024-04-25 21:32:39 +00:00
l1empty_test.go Run pulumi-test-language tests in parallel (#16060) 2024-04-25 21:32:39 +00:00
l1main_test.go Add asset/archive to conformance tests and fix engine working dir issues (#16100) 2024-05-02 11:32:54 +00:00
l2continue_on_error_test.go Run pulumi-test-language tests in parallel (#16060) 2024-04-25 21:32:39 +00:00
l2destroy_test.go Run pulumi-test-language tests in parallel (#16060) 2024-04-25 21:32:39 +00:00
l2large_test.go Refactor: move plugin kind to apitype (#15946) 2024-04-25 17:30:30 +00:00
l2resourceasset_test.go Add conformance tests for remote assets (#16467) 2024-07-03 09:03:24 +00:00
l2resourcesimple_test.go Run pulumi-test-language tests in parallel (#16060) 2024-04-25 21:32:39 +00:00
main.go Add matrix testing (#13705) 2023-09-13 15:17:46 +00:00
runtime_options_test.go Run pulumi-test-language tests in parallel (#16060) 2024-04-25 21:32:39 +00:00
snapshot_test.go Add asset/archive to conformance tests and fix engine working dir issues (#16100) 2024-05-02 11:32:54 +00:00
snapshots.go Add asset/archive to conformance tests and fix engine working dir issues (#16100) 2024-05-02 11:32:54 +00:00
testing.go Use mapset in pulumi-test-language (#14738) 2023-12-04 20:49:34 +00:00
tests.go Add a test of sending primitive values for a resource (#16718) 2024-07-22 21:13:11 +00:00

README.md

pulumi-language-test runs a gRPC interface that language plugins can use to run a suite of standard tests.

Architecture

pulumi-language-test is used to run a standard suite of tests against any compliant language plugin.

The diagram below shows the main interactions and data flows for how this system works.

There are three main actors involved. Firstly test which is a test function coordinating the language plugin and pulumi-language-test. Secondly ptl which is the pulumi-language-test process. Finally uut which is the language plugin actually being tested. This will generally be a grpc server running in the same process as the test method.


sequenceDiagram
    test->>ptl: Start ptl process
    ptl-->>test: Read stdout for ptl address to connect to

    Note right of test: All future calls to ptl are via grpc

    test->>+ptl: GetLanguageTests()
    ptl-->>-test: Returns list of test names

    test->>+uut: Serve
    uut-->>-test: Returns uut server address

    test->>+ptl: PrepareLanguageTests(uut)
    ptl->>+uut: Pack(core)
    uut-->>-ptl: Returns name of core artifact
    ptl-->>-test: Returns `token`

    loop for each test
        test->>+ptl: RunLanguageTest(token, test)
        loop for each sdk used in test
            ptl->>+uut: GeneratePackage(sdk)
            uut-->>-ptl: Write package code to temporary directory
            ptl->>ptl: Verify sdk snapshot
            ptl->>+uut: Pack(sdk)
            uut-->>-ptl: Returns name of sdk artifact
        end

        ptl->>+uut: GenerateProject(test)
        uut-->>-ptl: Write project code to temporary directory
        ptl->>ptl: Verify project snapshot

        ptl->>+uut: InstallDependencies(project)
        uut-->>-ptl: 

        note right of ptl: Execute test with engine
        activate ptl
        ptl->>+uut: Run(project)
        uut-->>-ptl: Return run result
        ptl->>ptl: Run test asserts against run result and snapshot
        deactivate ptl

        ptl-->>-test: Returns test result from asserts
    end

    test->>ptl: sigkill

Meta tests

This module contains a number of _test.go files. These are tests of the conformance test system itself. The actual conformance tests are all defined in tests.go.