compose/internal/e2e/pull_test.go
Nicolas De Loof 8c67b155ea refactor(e2e): move the e2e framework and tests out of pkg/
The e2e framework (framework.go, scenario.go, checks.go, assert.go) and
the e2e tests lived under pkg/e2e, so the framework was published as part
of the public /v5 API although it is only test support code. Move it to
internal/e2e.

This is a pure move: the files keep their content, only the references to
the old path (Makefile, .golangci.yml, codecov.yml, .gitignore, AGENTS.md
and SCENARIO.md) are updated. internal/e2e is at the same depth as
pkg/e2e, so the relative paths to bin/, relay/ and testdata keep working.

Signed-off-by: Nicolas De Loof <nicolas.deloof@gmail.com>
2026-11-16 15:21:04 +01:00

72 lines
2.5 KiB
Go

//go:build e2e
/*
Copyright 2020 Docker Compose CLI authors
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package e2e
import (
"testing"
)
// The pull command's report — Pulled vs Skipped — is the CLI's decision, so
// these scenarios legitimately observe the output.
func TestComposePull(t *testing.T) {
NewScenario(t, "pull must always pull, whether or not the image is present locally").
Step("start without the images in the local store",
ComposeCmd("down", "--rmi", "all")).
Step("pull fetches every service image",
ComposeCmd("pull"),
OutputContains("Image alpine:3.14 Pulled"),
OutputContains("Image alpine:3.15 Pulled")).
Step("pull again still pulls: the command's default policy is always",
ComposeCmd("pull"),
OutputContains("Image alpine:3.14 Pulled"),
OutputContains("Image alpine:3.15 Pulled"))
}
func TestPullImagePresentLocally(t *testing.T) {
NewScenario(t, "with pull_policy missing, a present image is skipped but a :latest tag is still pulled").
Step("warm the local store",
ComposeCmd("pull")).
Step("a second pull skips the pinned tag and refreshes latest",
ComposeCmd("pull"),
OutputContains("alpine:3.13.12 Skipped Image is already present locally"),
OutputContains("alpine:latest Pulled"))
}
func TestPullNoImageNameGiven(t *testing.T) {
NewScenario(t, "pull must skip a build-only service instead of failing").
Step("pull reports there is nothing to pull",
ComposeCmd("pull"),
OutputContains("Skipped No image to be pulled"))
}
func TestPullFailure(t *testing.T) {
NewScenario(t, "pull must fail when a service image cannot be pulled").
Step("pull reports the denied image and fails",
ComposeCmd("pull").MayFail(),
ExitCode(1),
StderrContains("does_not_exists"))
}
func TestPullIgnoreFailures(t *testing.T) {
NewScenario(t, "pull --ignore-pull-failures must succeed and point at the services to build").
Step("pull succeeds despite the missing image",
ComposeCmd("pull", "--ignore-pull-failures"),
OutputContains("Some service image(s) must be built from source by running:"))
}