public class TreeVisitor<T> {
    /**
     * Visits a node of the tree.
     */
    public void node(T node) {
    }

    /**
     * Starts visiting the children of the most recently visited node.
     */
    public void startChildren() {
    }

    /**
     * Finishes visiting the children of the most recently started node.
     */
    public void endChildren() {
    }

env GO111MODULE=off
cd example.com

# Without -e, listing an otherwise-valid package with an unsatisfied direct import should fail.
# BUG: Today it succeeds.
go list -f '{{if .Error}}error{{end}} {{if .Incomplete}}incomplete{{end}} {{range .DepsErrors}}bad dep: {{.Err}}{{end}}' example.com/direct
! stdout ^error
stdout 'incomplete'
stdout 'bad dep: .*example.com[/\\]notfound'

# Listing with -deps should also fail.

 */
public interface FileSystemSnapshotHierarchyVisitor {

    /**
     * Called before visiting the contents of a directory.
     */
    default void enterDirectory(DirectorySnapshot directorySnapshot) {}

    /**
     * Called for each regular file/directory/missing/unavailable file.
     *
     * @return how to continue visiting the rest of the snapshot hierarchy.
     */

# If issue is not in the current repo, specify its full URL instead.
issue:

# releaseNotes is a markdown listing of any user facing changes. This will appear in the
# release notes.
releaseNotes:

# upgradeNotes is a markdown listing of any changes that will affect the upgrade
# process. This will appear in the release notes.
upgradeNotes:
  - title:
    content:

     */
    void visitFile(File file);

    /**
     * Called when some problem occurs visiting some element of the set. Visiting may continue.
     */
    void visitFailure(Throwable failure);

    /**
     * Called after a set of artifacts has been visited.
     */

- Kube-up: defaults to limiting critical pods to the kube-system namespace to match behavior prior to 1.17 ([#93121](https://github.com/kubernetes/kubernetes/pull/93121), [@liggitt](https://github.com/liggitt)) [SIG Cloud Provider and Scheduling]

     *
     * @param path Path of the file
     * @param relativePath RelativePath of the file
     * @param attrs attributes of the path, null if not available
     * @param stopFlag transient flag to stop visiting
     * @param fileSystem for Chmod and Stat
     * @return FileVisitDetails
     */
    public static FileVisitDetails getRootFileVisitDetails(
        Path path,
        RelativePath relativePath,

    enum State {
        /**
         * Listing has succeeded.
         */
        Listed,
        /**
         * Listing has failed.
         */
        Failed,
        /**
         * Listing hasn't been performed yet, or another attempt can be made.
         */
        Unknown
    }

    /**

		// Its to test ListObjects on an empty bucket.
		2: "empty-bucket",
		// Listing the case where the marker > last object.
		3: "test-bucket-single-object",
		// Listing uncommon delimiter.
		4: "test-bucket-delimiter",
		// Listing prefixes > maxKeys
		5: "test-bucket-max-keys-prefixes",
		// Listing custom delimiters
		6: "test-bucket-custom-delimiter",
	}
	for _, bucket := range testBuckets {

        'root/SNAPSHOT'  | 'SNAPSHOT'
        'root/SNAPSHOT/' | 'SNAPSHOT'
    }

    def "should extract file name from s3 listing"() {
        ObjectListing objectListing = Mock()
        S3ObjectSummary objectSummary = Mock()
        objectSummary.getKey() >> listing
        objectListing.getObjectSummaries() >> [objectSummary]

        S3ResourceResolver resolver = new S3ResourceResolver()

        when: