Buckets.Location.NotConfigured (buckets v1.0.0-rc.2)

Represents an object that hasn't been assigned a storage location yet.

This struct is used as the default location for newly created Buckets.Object instances that haven't been uploaded to any storage backend. It serves as a marker to indicate that the object exists only in memory or as a local file, but hasn't been persisted to cloud storage.

Usage

Objects with a NotConfigured location:

  • Cannot be read from remote storage
  • Cannot generate signed URLs
  • Must be inserted into a Cloud module before remote operations

Examples

# New objects start with NotConfigured location
object = Buckets.Object.new("123", "document.pdf")
# object.location == %Buckets.Location.NotConfigured{}

# After insertion, location is configured
{:ok, stored} = MyApp.Cloud.insert(object)
# stored.location == %Buckets.Location{path: "...", config: ...}