gcs
API
Generated with
gcs/blobstore.gcs/GcsStore

GcsStore

blobstore.gcs.GcsStore
See theGcsStore companion object
class GcsStore[F[_]](storage: Storage, acls: List[Acl], defaultTrailingSlashFiles: Boolean, defaultDirectDownload: Boolean)(using evidence$1: Async[F]) extends Store[F, GcsBlob]

Value parameters

acls

list of Access Control List objects to be set on all uploads.

defaultDirectDownload

use direct download. When enabled the whole media content is downloaded in a single request (but still streamed). Otherwise use the resumable media download protocol to download in data chunks. This controls behaviour of get method from Store trait. Use getUnderlying to control on per-invocation basis.

defaultTrailingSlashFiles

test if folders returned by list are files with trailing slashes in their names. This controls behaviour of list method from Store trait. Use listUnderlying to control on per-invocation basis.

storage

configured instance of GCS Storage

Attributes

Companion
object
Graph
Supertypes
trait Store[F, GcsBlob]
class Object
trait Matchable
class Any

Members list

Value members

Concrete methods

override def copy[A, B](src: Url[A], dst: Url[B]): F[Unit]

Copies bytes from srcPath to dstPath. Stores should optimize to use native copy functions to avoid data transfer.

Copies bytes from srcPath to dstPath. Stores should optimize to use native copy functions to avoid data transfer.

Value parameters

dst

path

src

path

Attributes

Returns

F[Unit]

Definition Classes
Store
override def get[A](url: Url[A], chunkSize: Int): Stream[F, Byte]

Value parameters

chunkSize

bytes to read in each chunk.

url

to get

Attributes

Returns

stream of bytes

Definition Classes
Store
def get[A](url: Url[A], chunkSize: Int, options: List[BlobGetOption]): Stream[F, Byte]
def getUnderlying[A](url: Url[A], chunkSize: Int, direct: Boolean, options: BlobGetOption*): Stream[F, Byte]
override def list[A](url: Url[A], recursive: Boolean): Stream[F, Url[GcsBlob]]

Value parameters

recursive

when true returned list would contain files at given path and all sub-folders but no folders, otherwise – return files and folder at given path.

url

to list

Attributes

Returns

stream of Paths. Implementing stores must guarantee that returned Paths have correct values for size, isDir and lastModified.

Example

Given Path pointing at folder: folder/a folder/b folder/c folder/sub-folder/d folder/sub-folder/sub-sub-folder/e list(folder, recursive = true) -> [a, b, c, d, e] list(folder, recursive = false) -> [a, b, c, sub-folder]

Definition Classes
Store
def list[A](url: Url[A], recursive: Boolean, options: List[BlobListOption]): Stream[F, Url[GcsBlob]]
def listUnderlying[A](url: Url[A], expectTrailingSlashFiles: Boolean, recursive: Boolean, inputOptions: BlobListOption*): Stream[F, Url[GcsBlob]]
override def move[A, B](src: Url[A], dst: Url[B]): F[Unit]

Moves bytes from srcPath to dstPath. Stores should optimize to use native move functions to avoid data transfer.

Moves bytes from srcPath to dstPath. Stores should optimize to use native move functions to avoid data transfer.

Value parameters

dst

path

src

path

Attributes

Returns

F[Unit]

Definition Classes
Store
override def put[A](url: Url[A], overwrite: Boolean, size: Option[Long]): (F, Byte) => Unit

Value parameters

overwrite

when true putting to path with pre-existing file would overwrite the content, otherwise – fail with error.

url

to put

Attributes

Returns

sink of bytes

Definition Classes
Store
def put[A](url: Url[A], overwrite: Boolean, options: List[BlobWriteOption]): (F, Byte) => Unit
def put[A](path: Path[GcsBlob], options: List[BlobWriteOption]): (F, Byte) => Unit
override def putRotate[A](computeUrl: F[Url[A]], limit: Long): (F, Byte) => Unit

Writes all data to a sequence of blobs/files, each limited in size to limit.

Writes all data to a sequence of blobs/files, each limited in size to limit.

The computeUrl operation is used to compute the path of the first file and every subsequent file. Typically, the next file should be determined by analyzing the current state of the filesystem -- e.g., by looking at all files in a directory and generating a unique name.

Value parameters

computeUrl

operation to compute the url of the first file and all subsequent files.

limit

maximum size in bytes for each file.

Attributes

Returns

sink of bytes

Note

Put of all files uses overwrite semantic, i.e. if path returned by computeUrl already exists content will be overwritten. If that doesn't suit your use case use computeUrl to guard against overwriting existing files.

Definition Classes
Store
override def remove[A](url: Url[A], recursive: Boolean): F[Unit]

Remove bytes for given path. Call should succeed even if there is nothing stored at that path.

Remove bytes for given path. Call should succeed even if there is nothing stored at that path.

Value parameters

url

to remove

Attributes

Returns

F[Unit]

Definition Classes
Store
override def stat[A](url: Url[A]): Stream[F, Url[GcsBlob]]

Attributes

Definition Classes
Store

Inherited methods

def get[A](url: Url[A]): Stream[F, Byte]

Attributes

Inherited from:
Store
Generated with