Skip to content

docs-bug: endless loop of docs:live_preview #298

Closed

Description

@AlexanderLanin

When I run bazel run //docs:live_preview it keeps running in an endless loop.

Feels like it's detecting it's own output as a change in the inputs, and restarts.

Hint: sphinx-autobuild has an --ignore parameter. And I believe it has an option which will print why it restarts. Example:

  sphinx-autobuild \
    . \
    ./$SPHINX_BUILDDIR/html \
    --port $SPHINX_PORT \
    --ignore "*.tmp" \
    --ignore "*.toml" \
    --ignore "*/.mypy_cache/*" \
    --pre-build "python3 ./.devcontainer/md_file_puml.py" \
    -t json \
    -q $*

Activity

  1. nicu1989 commented on Feb 14, 2025

    @nicu1989
    Member

    I tried reproducing the issue on my machine, both local and dev env and could not reproduce. I also tried reproducing it in a vanilla docker ubuntu container:

    docker run -it --name test_container ubuntu bash -c "
      apt update && apt install -y sudo build-essential gpg curl wget unzip git &&
      useradd -m -s /bin/bash bazeluser &&
      echo 'bazeluser ALL=(ALL) NOPASSWD:ALL' >> /etc/sudoers &&
      su - bazeluser -c '
        mkdir -p \$HOME/bin &&
        curl -fsSL https://github.com/bazelbuild/bazelisk/releases/latest/download/bazelisk-linux-amd64 -o \$HOME/bin/bazel &&
        chmod +x \$HOME/bin/bazel &&
        export PATH=\$HOME/bin:\$PATH &&
        bazel --version &&
        git clone https://github.com/eclipse-score/score.git &&
        cd score &&
        bazel run //docs:live_preview
      '
    "
    
    • Live preview built once. After I run in separate terminal:

    docker exec -it --user bazeluser test_container sh -c 'cd /home/bazeluser/score/docs && echo "trigger rebuild text" > index.rst'

    • Live preview re-built once.

    Can you add some more details, if you figure something specific? Or maybe someone else from the team can test also.

  2. AlexanderLanin commented on Feb 14, 2025

    @AlexanderLanin
    MemberAuthor

    Thanks, I'll try mself as well.

  3. AlexanderLanin commented on Mar 13, 2025

    @AlexanderLanin
    MemberAuthor

    not reproducible anymore

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Type

No type

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions