#mldong/moon-kodo

#最小用法

fn block_size_reading(size : Int32, last~ : Bool) -> String {
  @kodo.check_block_size(size, last~) catch {
    _ => return "refused"
  }
  "ok"
}

test "签名、URL 与边界都在本地算得出，不依赖网络" {
  let auth = @kodoauth.Auth::new("ak-example", "sk-example")
  let token = auth.upload_token("demo-bucket", key=Some("2026/10/note.txt"))
  let decoded = @kodoauth.decode_upload_token(token)
  assert_eq(decoded.0, "ak-example")
  assert_true(!decoded.1.is_empty())
  // 私有下载 URL 的次序承重：先把 `e=<过期时刻>` 拼上，对整串签，最后才拼 `&token=`
  let url = auth.private_download_url(
    "https://cdn.example.invalid/2026/10/note.txt",
    expires=120,
  )
  assert_true(url.has_prefix("https://cdn.example.invalid/2026/10/note.txt?e="))
  assert_true(url.contains("&token=ak-example:"))
  // 分块上传路径里的 key 段是 URL-safe Base64（带填充），与 rs 系的 entry 不是同一串
  assert_eq(@kodo.v2_key_segment("2026/10/note.txt"), "MjAyNi8xMC9ub3RlLnR4dA==")
  assert_eq(
    @kodo.encoded_entry("demo-bucket", Some("2026/10/note.txt")),
    "ZGVtby1idWNrZXQ6MjAyNi8xMC9ub3RlLnR4dA==",
  )
  // 除最后一片外每片必须满 1MB：这一档在任何请求发出之前就拒掉，末片不限长
  assert_eq(block_size_reading(1024, last=false), "refused")
  assert_eq(block_size_reading(1048576, last=false), "ok")
  assert_eq(block_size_reading(1, last=true), "ok")
}

#装法

moon add mldong/moon-kodo

#用之前要知道的几件事

• 端点靠探测：@kodo.query_region(transport, access_key, bucket) 打官方 UC 的 v4/query，把回包里的区域与主机表换成 @kodoconfig.Region；区域常量表也在 @kodoconfig.Region::with_region_id("z0") 这一族里，两种给法都不把某台主机名写死。
• 上传令牌不是预签名 URL：令牌是给表单与分块接口换一次上传机会的凭据串 （Authorization: UpToken …），私有下载 URL 才是能交给无凭据客户端的那条链接。
• 块级校验是开关，不是默认：check_crc 默认关；开着时表单侧带整份 crc32， 分块侧逐片比服务端回的 md5，不等就在合并之前抛。
• 对象不存在是 612：stat 抛出的 Service 里状态码 612 表示"没有这个对象"， delete 对同一档返回 false。
• 回包里的数字字段一律不走 derive(@json.FromJson)：那件 derive 读不进 JSON 数字， 而 fsize / putTime / partNumber 恰恰都是数字。

#开发进度

#它服务于谁

#许可