!docs error: image == null!

[taqtiqa-mark]

Description

I observe this error:

workspace.dsl: Error importing documentation from /usr/local/structurizr/docs: image == null! at line 7: !docs docs

when using this workspace

workspace "W" "WW" {

    model {
        user = person "User" "A" "Customer"
        soft = softwareSystem "S" "SS" "SSS" {
            !adrs adrs
            !docs docs
        }

        user -> soft "Uses"
    }

    views {
        systemContext soft "Fig-0" {
            include *
        }

        styles {
            element "Software System" {
                background  white
                strokeWidth 10
                stroke black

            }
            element "Person" {
                shape person
                background white
                stroke black
                strokeWidth 10
            }
        }
    }
}

Steps to reproduce

1. Copy the adr and docs files from the financial-risk-system example
2. Add the workspace file reproduced above
3. View the image using structurizr-lite docker container

Screenshot

Code sample

workspace "W" "WW" {

    model {
        user = person "User" "A" "Customer"
        soft = softwareSystem "S" "SS" "SSS" {
            !adrs adrs
            !docs docs
        }

        user -> soft "Uses"
    }

    views {
        systemContext soft "Fig-0" {
            include *
        }

        styles {
            element "Software System" {
                background  white
                strokeWidth 10
                stroke black

            }
            element "Person" {
                shape person
                background white
                stroke black
                strokeWidth 10
            }
        }
    }
}

Configuration

latest Docker container.

Severity

Minor

Priority

Low

Resolution

I have no budget, please fix this for free

More information

No response

[simonbrowndotje]

I'm unable to reproduce this I'm afraid ... it works for me.

[taqtiqa-mark]

Hmmm. Is there anything from .structurizr that could shed additional light?

[taqtiqa-mark]

Adding the following cointainer stdout/err output:

2023-05-22T05:38:17.700Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : ***********************************************************************************
2023-05-22T06:50:39.153Z ERROR 1 --- [io-8080-exec-10] s.l.c.w.FileSystemWorkspaceComponentImpl : com.structurizr.dsl.StructurizrDslParserException: Error importing documentation from /usr/local/structurizr/docs: image == null! at line 6: !docs docs

Also adding container version information:

2023-05-23T01:27:23.106Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : Starting StructurizrLite using Java 17.0.5 with PID 1 (/usr/local/structurizr-lite.war started by root in /)
2023-05-23T01:27:23.129Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : No active profile set, falling back to 1 default profile: "default"
2023-05-23T01:27:34.384Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : Started StructurizrLite in 12.765 seconds (process running for 15.846)
2023-05-23T01:27:34.393Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : ***********************************************************************************
2023-05-23T01:27:34.394Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     :   _____ _                   _              _          
2023-05-23T01:27:34.394Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     :  / ____| |                 | |            (_)         
2023-05-23T01:27:34.395Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : | (___ | |_ _ __ _   _  ___| |_ _   _ _ __ _ _____ __ 
2023-05-23T01:27:34.395Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     :  \___ \| __| '__| | | |/ __| __| | | | '__| |_  / '__|
2023-05-23T01:27:34.397Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     :  ____) | |_| |  | |_| | (__| |_| |_| | |  | |/ /| |   
2023-05-23T01:27:34.398Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : |_____/ \__|_|   \__,_|\___|\__|\__,_|_|  |_/___|_|   
2023-05-23T01:27:34.398Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     :                                                       
2023-05-23T01:27:34.399Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : Structurizr Lite
2023-05-23T01:27:34.402Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     :  - build: 3070 (2023-05-15T19:09:28Z
2023-05-23T01:27:34.404Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     :  - structurizr-java: v1.24.1
2023-05-23T01:27:34.462Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     :  - structurizr-dsl: v1.30.1
2023-05-23T01:27:34.465Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     :  - structurizr-import: v1.4.1
2023-05-23T01:27:34.466Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : 
2023-05-23T01:27:34.466Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : Workspace path: /usr/local/structurizr
2023-05-23T01:27:34.471Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : Workspace filename: workspace[.dsl|.json]
2023-05-23T01:27:34.475Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : URL: 
2023-05-23T01:27:34.476Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : Auto-save interval: 5000ms
2023-05-23T01:27:34.478Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : Auto-refresh interval: 0ms
2023-05-23T01:27:34.515Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : dot: available
2023-05-23T01:27:34.516Z  INFO 1 --- [           main] com.structurizr.lite.StructurizrLite     : ***********************************************************************************

[simonbrowndotje]

Perhaps you could zip up the whole folder (workspace.dsl, docs, etc) and attach it to the issue?

[taqtiqa-mark]

I've had to move on. Will reopen if I encounter this again.