// Copyright 2019 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

// Package artifacts controls how files generated by Fuchsia's CI tasks are written to and
// read from Cloud Storage.  The directory layout is defined below:
//
// gs://BUCKET/
//     builds/
//         BUILD/
//             tests/
//                 TEST/
//                     ENVIRONMENT/
//
// BUCKET
//     The Cloud Storage bucket used to store CI artifacts. Multiple buckets can exist
//     exist using this scheme.
// BUILD
//     Contains all artifacts for a build. The directory's name is the unique BuildBucket
//     build ID.
// TEST
//     Contains all artifacts relevant to a particular test.  The directory's name is the
//     canonical name of the test - which is usually a test "suite".
// ENVIRONMENT
//     Contains all test artifacts relevant to a particular test environment. The
//     directory's name is the canonical name of the test environment. Tests will often
//     have multiple environment directories, because they often run in multiple
//     environments per build.
package artifacts