compiler-explorer/test/statenormalisation-tests.ts

// Copyright (c) 2018, Compiler Explorer Authors
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
//
//     * Redistributions of source code must retain the above copyright notice,
//       this list of conditions and the following disclaimer.
//     * Redistributions in binary form must reproduce the above copyright
//       notice, this list of conditions and the following disclaimer in the
//       documentation and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.

import {describe, expect, it} from 'vitest';

import {ClientStateGoldenifier, ClientStateNormalizer} from '../lib/clientstate-normalizer.js';
import {ClientState} from '../lib/clientstate.js';

import {fs} from './utils.js';

describe('Normalizing clientstate', () => {
    it('Should translate 2 compilers GL layout to clientstate', () => {
        const normalizer = new ClientStateNormalizer();

        const data = JSON.parse(fs.readFileSync('test/state/twocompilers.json', {encoding: 'utf8'}));
        normalizer.fromGoldenLayout(data);

        const resultdata = JSON.parse(fs.readFileSync('test/state/twocompilers.json.normalized', {encoding: 'utf8'}));

        // note: this trick is to get rid of undefined parameters
        const normalized = JSON.parse(JSON.stringify(normalizer.normalized));

        expect(normalized).toEqual(resultdata);
    });

    it('Should recognize everything and kitchensink as well', () => {
        const normalizer = new ClientStateNormalizer();

        const data = JSON.parse(fs.readFileSync('test/state/andthekitchensink.json', {encoding: 'utf8'}));

        normalizer.fromGoldenLayout(data);

        const resultdata = JSON.parse(
            fs.readFileSync('test/state/andthekitchensink.json.normalized', {encoding: 'utf8'}),
        );

        const normalized = JSON.parse(JSON.stringify(normalizer.normalized));

        expect(normalized).toEqual(resultdata);
    });

    it('Should support conformanceview', () => {
        const normalizer = new ClientStateNormalizer();

        const data = JSON.parse(fs.readFileSync('test/state/conformanceview.json', {encoding: 'utf8'}));

        normalizer.fromGoldenLayout(data);

        const resultdata = JSON.parse(
            fs.readFileSync('test/state/conformanceview.json.normalized', {encoding: 'utf8'}),
        );

        const normalized = JSON.parse(JSON.stringify(normalizer.normalized));

        expect(normalized).toEqual(resultdata);
    });

    it('Should support executors', () => {
        const normalizer = new ClientStateNormalizer();

        const data = JSON.parse(fs.readFileSync('test/state/executor.json', {encoding: 'utf8'}));

        normalizer.fromGoldenLayout(data);

        const resultdata = JSON.parse(fs.readFileSync('test/state/executor.json.normalized', {encoding: 'utf8'}));

        const normalized = JSON.parse(JSON.stringify(normalizer.normalized));

        expect(normalized).toEqual(resultdata);
    });

    it('Should support newer features', () => {
        const normalizer = new ClientStateNormalizer();

        const data = JSON.parse(fs.readFileSync('test/state/executorwrap.json', {encoding: 'utf8'}));

        normalizer.fromGoldenLayout(data);

        const resultdata = JSON.parse(fs.readFileSync('test/state/executorwrap.json.normalized', {encoding: 'utf8'}));

        const normalized = JSON.parse(JSON.stringify(normalizer.normalized));

        expect(normalized).toEqual(resultdata);
    });

    it('Allow output without editor id', () => {
        const normalizer = new ClientStateNormalizer();
        const data = JSON.parse(fs.readFileSync('test/state/output-editor-id.json', {encoding: 'utf8'}));
        normalizer.fromGoldenLayout(data);

        const resultdata = JSON.parse(
            fs.readFileSync('test/state/output-editor-id.normalized.json', {encoding: 'utf8'}),
        );

        const normalized = JSON.parse(JSON.stringify(normalizer.normalized));

        expect(normalized).toEqual(resultdata);
    });
});

describe('ClientState parsing', () => {
    it('Should work without executors', () => {
        const state = new ClientState({
            sessions: [
                {id: 1, language: 'c++', source: 'int main() {}', compilers: [{id: 'g91', options: '-O3 -std=c++2a'}]},
            ],
        });

        expect(state.sessions[0].compilers.length).toEqual(1);
        expect(state.sessions[0].executors.length).toEqual(0);
    });

    it('Should work with executor', () => {
        const state = new ClientState({
            sessions: [
                {
                    id: 1,
                    language: 'c++',
                    source: 'int main() {}',
                    compilers: [],
                    executors: [
                        {
                            compiler: {id: 'g91', options: '-O3 -std=c++2a'},
                        },
                    ],
                },
            ],
        });

        expect(state.sessions[0].compilers.length).toEqual(0);
        expect(state.sessions[0].executors.length).toEqual(1);
    });

    it('Should not contain id-less compilers', () => {
        const jsonStr = fs.readFileSync('test/state/bug-2231.json', {encoding: 'utf8'});
        const state = new ClientState(JSON.parse(jsonStr));
        expect(state.sessions[0].compilers.length).toEqual(1);
    });
});

describe('Trees', () => {
    it('ClientState to GL', () => {
        const jsonStr = fs.readFileSync('test/state/tree.json', {encoding: 'utf8'});
        const state = new ClientState(JSON.parse(jsonStr));
        expect(state.trees.length).toEqual(1);

        const gl = new ClientStateGoldenifier();
        gl.fromClientState(state);

        const golden = JSON.parse(JSON.stringify(gl.golden));

        const resultdata = JSON.parse(fs.readFileSync('test/state/tree.goldenified.json', {encoding: 'utf8'}));
        expect(golden).toEqual(resultdata);
    });

    it('GL to ClientState', () => {
        const jsonStr = fs.readFileSync('test/state/tree-gl.json', {encoding: 'utf8'});
        const gl = JSON.parse(jsonStr);

        const normalizer = new ClientStateNormalizer();
        normalizer.fromGoldenLayout(gl);

        const normalized = JSON.parse(JSON.stringify(normalizer.normalized));

        const resultdata = JSON.parse(fs.readFileSync('test/state/tree.normalized.json', {encoding: 'utf8'}));

        expect(normalized).toEqual(resultdata);
    });

    it('GL to ClientState with correct output pane', () => {
        const jsonStr = fs.readFileSync('test/state/tree-gl-outputpane.json', {encoding: 'utf8'});
        const gl = JSON.parse(jsonStr);

        const normalizer = new ClientStateNormalizer();
        normalizer.fromGoldenLayout(gl);

        const normalized = JSON.parse(JSON.stringify(normalizer.normalized));

        const resultdata = JSON.parse(
            fs.readFileSync('test/state/tree-gl-outputpane.normalized.json', {encoding: 'utf8'}),
        );

        expect(normalized).toEqual(resultdata);
    });

    it('ClientState to Mobile GL', () => {
        const jsonStr = fs.readFileSync('test/state/tree-mobile.json', {encoding: 'utf8'});
        const state = new ClientState(JSON.parse(jsonStr));
        expect(state.trees.length).toEqual(1);

        const gl = new ClientStateGoldenifier();
        const slides = gl.generatePresentationModeMobileViewerSlides(state);

        const golden = JSON.parse(JSON.stringify(slides));
        //fs.writeFileSync('test/state/tree-mobile.goldenified.json', JSON.stringify(golden));

        const resultdata = JSON.parse(fs.readFileSync('test/state/tree-mobile.goldenified.json', {encoding: 'utf8'}));
        expect(golden).toEqual(resultdata);
    });
});