Struct Ghac 

pub struct Ghac { /* private fields */ }

GitHub Action Cache Services support.

Capabilities

This service can be used to:

• stat
• read
• write
• create_dir
• delete
• copy
• rename
• list
• presign
• blocking

Notes

This service is mainly provided by GitHub actions.

Refer to Caching dependencies to speed up workflows for more information.

To make this service work as expected, please make sure to either call endpoint and token to configure the URL and credentials, or that the following environment has been setup correctly:

• ACTIONS_CACHE_URL
• ACTIONS_RUNTIME_TOKEN

They can be exposed by following action:

- name: Configure Cache Env
  uses: actions/github-script@v6
  with:
    script: |
      core.exportVariable('ACTIONS_CACHE_URL', process.env.ACTIONS_CACHE_URL || '');
      core.exportVariable('ACTIONS_RUNTIME_TOKEN', process.env.ACTIONS_RUNTIME_TOKEN || '');

To make delete work as expected, GITHUB_TOKEN should also be set via:

env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Limitations

Unlike other services, ghac doesn’t support create empty files. We provide a enable_create_simulation() to support this operation but may result unexpected side effects.

Also, ghac is a cache service which means the data store inside could be automatically evicted at any time.

Configuration

• root: Set the work dir for backend.

Refer to GhacBuilder’s public API docs for more information.

Example

Via Builder

use std::sync::Arc;

use anyhow::Result;
use opendal::services::Ghac;
use opendal::Operator;

#[tokio::main]
async fn main() -> Result<()> {
    // Create ghac backend builder.
    let mut builder = Ghac::default()
        // Set the root for ghac, all operations will happen under this root.
        //
        // NOTE: the root must be absolute path.
        .root("/path/to/dir");

    let op: Operator = Operator::new(builder)?.finish();

    Ok(())
}

Implementations

impl GhacBuilder

pub fn root(self, root: &str) -> Self

Available on crate feature services-ghac only.

set the working directory root of backend

pub fn version(self, version: &str) -> Self

Available on crate feature services-ghac only.

set the version that used by cache.

The version is the unique value that provides namespacing. It’s better to make sure this value is only used by this backend.

If not set, we will use opendal as default.

pub fn endpoint(self, endpoint: &str) -> Self

Available on crate feature services-ghac only.

Set the endpoint for ghac service.

For example, this is provided as the ACTIONS_CACHE_URL environment variable by the GHA runner.

Default: the value of the ACTIONS_CACHE_URL environment variable.

pub fn runtime_token(self, runtime_token: &str) -> Self

Available on crate feature services-ghac only.

Set the runtime token for ghac service.

For example, this is provided as the ACTIONS_RUNTIME_TOKEN environment variable by the GHA runner.

Default: the value of the ACTIONS_RUNTIME_TOKEN environment variable.

pub fn http_client(self, client: HttpClient) -> Self

👎Deprecated since 0.53.0: Use Operator::update_http_client instead

Available on crate feature services-ghac only.

Specify the http client that used by this service.

Notes

This API is part of OpenDAL’s Raw API. HttpClient could be changed during minor updates.

Trait Implementations

impl Builder for GhacBuilder

Available on crate feature services-ghac only.

type Config = GhacConfig

Associated configuration for this builder.

fn build(self) -> Result<impl Access>

Consume the accessor builder to build a service.

impl Debug for GhacBuilder

Available on crate feature services-ghac only.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for GhacBuilder

Available on crate feature services-ghac only.

fn default() -> GhacBuilder

Returns the “default value” for a type.