1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361
#![allow(deprecated)]
#![allow(clippy::module_inception)]
#![allow(clippy::upper_case_acronyms)]
#![allow(clippy::large_enum_variant)]
#![allow(clippy::wrong_self_convention)]
#![allow(clippy::should_implement_trait)]
#![allow(clippy::blacklisted_name)]
#![allow(clippy::vec_init_then_push)]
#![allow(clippy::type_complexity)]
#![allow(clippy::needless_return)]
#![allow(rustdoc::bare_urls)]
#![warn(missing_docs)]
//! <p> CodeArtifact is a fully managed artifact repository compatible with language-native
//! package managers and build tools such as npm, Apache Maven, pip, and dotnet. You can use CodeArtifact to
//! share packages with development teams and pull packages. Packages can be pulled from both
//! public and CodeArtifact repositories. You can also create an upstream relationship between a CodeArtifact
//! repository and another repository, which effectively merges their contents from the point of
//! view of a package manager client. </p>
//! <p>
//! <b>CodeArtifact Components</b>
//! </p>
//! <p>Use the information in this guide to help you work with the following CodeArtifact components:</p>
//! <ul>
//! <li>
//! <p>
//! <b>Repository</b>: A CodeArtifact repository contains a set of <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/welcome.html#welcome-concepts-package-version">package
//! versions</a>, each of which maps to a set of assets, or files. Repositories are
//! polyglot, so a single repository can contain packages of any supported type. Each
//! repository exposes endpoints for fetching and publishing packages using tools like the
//! <b>
//! <code>npm</code>
//! </b> CLI, the Maven CLI (<b>
//! <code>mvn</code>
//! </b>), Python CLIs (<b>
//! <code>pip</code>
//! </b> and <code>twine</code>), and NuGet CLIs (<code>nuget</code> and <code>dotnet</code>).</p>
//! </li>
//! <li>
//! <p>
//! <b>Domain</b>: Repositories are aggregated into a higher-level entity known as a
//! <i>domain</i>. All package assets and metadata are stored in the domain,
//! but are consumed through repositories. A given package asset, such as a Maven JAR file, is
//! stored once per domain, no matter how many repositories it's present in. All of the assets
//! and metadata in a domain are encrypted with the same customer master key (CMK) stored in
//! Key Management Service (KMS).</p>
//! <p>Each repository is a member of a single domain and can't be moved to a
//! different domain.</p>
//! <p>The domain allows organizational policy to be applied across multiple
//! repositories, such as which accounts can access repositories in the domain, and
//! which public repositories can be used as sources of packages.</p>
//! <p>Although an organization can have multiple domains, we recommend a single production
//! domain that contains all published artifacts so that teams can find and share packages
//! across their organization.</p>
//! </li>
//! <li>
//! <p>
//! <b>Package</b>: A <i>package</i> is a bundle of software and the metadata required to
//! resolve dependencies and install the software. CodeArtifact supports <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-npm.html">npm</a>, <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-python.html">PyPI</a>, <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-maven">Maven</a>, and <a href="https://docs.aws.amazon.com/codeartifact/latest/ug/using-nuget">NuGet</a> package formats.</p>
//! <p>In CodeArtifact, a package consists of:</p>
//! <ul>
//! <li>
//! <p>A <i>name</i> (for example, <code>webpack</code> is the name of a
//! popular npm package)</p>
//! </li>
//! <li>
//! <p>An optional namespace (for example, <code>@types</code> in <code>@types/node</code>)</p>
//! </li>
//! <li>
//! <p>A set of versions (for example, <code>1.0.0</code>, <code>1.0.1</code>,
//! <code>1.0.2</code>, etc.)</p>
//! </li>
//! <li>
//! <p> Package-level metadata (for example, npm tags)</p>
//! </li>
//! </ul>
//! </li>
//! <li>
//! <p>
//! <b>Package version</b>: A version of a package, such as <code>@types/node 12.6.9</code>. The version number
//! format and semantics vary for different package formats. For example, npm package versions
//! must conform to the <a href="https://semver.org/">Semantic Versioning
//! specification</a>. In CodeArtifact, a package version consists of the version identifier,
//! metadata at the package version level, and a set of assets.</p>
//! </li>
//! <li>
//! <p>
//! <b>Upstream repository</b>: One repository is <i>upstream</i> of another when the package versions in
//! it can be accessed from the repository endpoint of the downstream repository, effectively
//! merging the contents of the two repositories from the point of view of a client. CodeArtifact
//! allows creating an upstream relationship between two repositories.</p>
//! </li>
//! <li>
//! <p>
//! <b>Asset</b>: An individual file stored in CodeArtifact associated with a package version, such as an npm
//! <code>.tgz</code> file or Maven POM and JAR files.</p>
//! </li>
//! </ul>
//! <p>CodeArtifact supports these operations:</p>
//! <ul>
//! <li>
//! <p>
//! <code>AssociateExternalConnection</code>: Adds an existing external
//! connection to a repository.
//! </p>
//! </li>
//! <li>
//! <p>
//! <code>CopyPackageVersions</code>: Copies package versions from one
//! repository to another repository in the same domain.</p>
//! </li>
//! <li>
//! <p>
//! <code>CreateDomain</code>: Creates a domain</p>
//! </li>
//! <li>
//! <p>
//! <code>CreateRepository</code>: Creates a CodeArtifact repository in a domain. </p>
//! </li>
//! <li>
//! <p>
//! <code>DeleteDomain</code>: Deletes a domain. You cannot delete a domain that contains
//! repositories. </p>
//! </li>
//! <li>
//! <p>
//! <code>DeleteDomainPermissionsPolicy</code>: Deletes the resource policy that is set on a domain.</p>
//! </li>
//! <li>
//! <p>
//! <code>DeletePackageVersions</code>: Deletes versions of a package. After a package has
//! been deleted, it can be republished, but its assets and metadata cannot be restored
//! because they have been permanently removed from storage.</p>
//! </li>
//! <li>
//! <p>
//! <code>DeleteRepository</code>: Deletes a repository.
//! </p>
//! </li>
//! <li>
//! <p>
//! <code>DeleteRepositoryPermissionsPolicy</code>: Deletes the resource policy that is set on a repository.</p>
//! </li>
//! <li>
//! <p>
//! <code>DescribeDomain</code>: Returns a <code>DomainDescription</code> object that
//! contains information about the requested domain.</p>
//! </li>
//! <li>
//! <p>
//! <code>DescribePackage</code>: Returns a <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageDescription.html">PackageDescription</a>
//! object that contains details about a package. </p>
//! </li>
//! <li>
//! <p>
//! <code>DescribePackageVersion</code>: Returns a <a href="https://docs.aws.amazon.com/codeartifact/latest/APIReference/API_PackageVersionDescription.html">PackageVersionDescription</a>
//! object that contains details about a package version. </p>
//! </li>
//! <li>
//! <p>
//! <code>DescribeRepository</code>: Returns a <code>RepositoryDescription</code> object
//! that contains detailed information about the requested repository. </p>
//! </li>
//! <li>
//! <p>
//! <code>DisposePackageVersions</code>: Disposes versions of a package. A package version
//! with the status <code>Disposed</code> cannot be restored because they have been
//! permanently removed from storage.</p>
//! </li>
//! <li>
//! <p>
//! <code>DisassociateExternalConnection</code>: Removes an existing external connection from a repository.
//! </p>
//! </li>
//! <li>
//! <p>
//! <code>GetAuthorizationToken</code>: Generates a temporary authorization token for accessing repositories in the domain. The token expires the authorization period has passed.
//! The default authorization period is 12 hours and can be customized to any length with a maximum of 12 hours.</p>
//! </li>
//! <li>
//! <p>
//! <code>GetDomainPermissionsPolicy</code>: Returns the policy of a resource
//! that is attached to the specified domain. </p>
//! </li>
//! <li>
//! <p>
//! <code>GetPackageVersionAsset</code>: Returns the contents of an asset that is in a package version. </p>
//! </li>
//! <li>
//! <p>
//! <code>GetPackageVersionReadme</code>: Gets the readme file or descriptive text for a package version.</p>
//! </li>
//! <li>
//! <p>
//! <code>GetRepositoryEndpoint</code>: Returns the endpoint of a repository for a specific package format. A repository has one endpoint for each
//! package format:
//! </p>
//! <ul>
//! <li>
//! <p>
//! <code>maven</code>
//! </p>
//! </li>
//! <li>
//! <p>
//! <code>npm</code>
//! </p>
//! </li>
//! <li>
//! <p>
//! <code>nuget</code>
//! </p>
//! </li>
//! <li>
//! <p>
//! <code>pypi</code>
//! </p>
//! </li>
//! </ul>
//! </li>
//! <li>
//! <p>
//! <code>GetRepositoryPermissionsPolicy</code>: Returns the resource policy that is set on a repository.
//! </p>
//! </li>
//! <li>
//! <p>
//! <code>ListDomains</code>: Returns a list of <code>DomainSummary</code> objects. Each
//! returned <code>DomainSummary</code> object contains information about a domain.</p>
//! </li>
//! <li>
//! <p>
//! <code>ListPackages</code>: Lists the packages in a repository.</p>
//! </li>
//! <li>
//! <p>
//! <code>ListPackageVersionAssets</code>: Lists the assets for a given package version.</p>
//! </li>
//! <li>
//! <p>
//! <code>ListPackageVersionDependencies</code>: Returns a list of the direct dependencies for a
//! package version. </p>
//! </li>
//! <li>
//! <p>
//! <code>ListPackageVersions</code>: Returns a list of package versions for a specified
//! package in a repository.</p>
//! </li>
//! <li>
//! <p>
//! <code>ListRepositories</code>: Returns a list of repositories owned by the Amazon Web Services account that called this method.</p>
//! </li>
//! <li>
//! <p>
//! <code>ListRepositoriesInDomain</code>: Returns a list of the repositories in a domain.</p>
//! </li>
//! <li>
//! <p>
//! <code>PutDomainPermissionsPolicy</code>: Attaches a resource policy to a domain.</p>
//! </li>
//! <li>
//! <p>
//! <code>PutPackageOriginConfiguration</code>: Sets the package origin configuration for a package, which determine
//! how new versions of the package can be added to a specific repository.</p>
//! </li>
//! <li>
//! <p>
//! <code>PutRepositoryPermissionsPolicy</code>: Sets the resource policy on a repository
//! that specifies permissions to access it. </p>
//! </li>
//! <li>
//! <p>
//! <code>UpdatePackageVersionsStatus</code>: Updates the status of one or more versions of a package.</p>
//! </li>
//! <li>
//! <p>
//! <code>UpdateRepository</code>: Updates the properties of a repository.</p>
//! </li>
//! </ul>
//!
//! # Crate Organization
//!
//! The entry point for most customers will be [`Client`]. [`Client`] exposes one method for each API offered
//! by the service.
//!
//! Some APIs require complex or nested arguments. These exist in [`model`](crate::model).
//!
//! Lastly, errors that can be returned by the service are contained within [`error`]. [`Error`] defines a meta
//! error encompassing all possible errors that can be returned by the service.
//!
//! The other modules within this crate are not required for normal usage.
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use error_meta::Error;
#[doc(inline)]
pub use config::Config;
/// Client and fluent builders for calling the service.
pub mod client;
/// Configuration for the service.
pub mod config;
/// Endpoint resolution functionality
pub mod endpoint;
/// All error types that operations can return. Documentation on these types is copied from the model.
pub mod error;
mod error_meta;
/// Input structures for operations. Documentation on these types is copied from the model.
pub mod input;
/// Data structures used by operation inputs/outputs. Documentation on these types is copied from the model.
pub mod model;
/// All operations that this crate can perform.
pub mod operation;
/// Output structures for operations. Documentation on these types is copied from the model.
pub mod output;
/// Data primitives referenced by other data types.
pub mod types;
pub mod middleware;
mod no_credentials;
mod operation_deser;
mod operation_ser;
/// Paginators for the service
pub mod paginator;
mod http_serde;
mod json_deser;
mod json_ser;
/// Generated accessors for nested fields
mod lens;
/// Endpoints standard library functions
mod endpoint_lib;
mod json_errors;
/// Crate version number.
pub static PKG_VERSION: &str = env!("CARGO_PKG_VERSION");
pub use aws_smithy_http::endpoint::Endpoint;
static API_METADATA: aws_http::user_agent::ApiMetadata =
aws_http::user_agent::ApiMetadata::new("codeartifact", PKG_VERSION);
pub use aws_credential_types::Credentials;
pub use aws_types::app_name::AppName;
pub use aws_types::region::Region;
#[doc(inline)]
pub use client::Client;