#mldong/moon-obs

moon add mldong/moon-obs

#最小用法

/// `sign_v4` 会 raise（时间戳形状、空密钥这两类本地就能判死的输入），文档块里把它兜住：
/// 这一块演示的是"本地算得出"的那一半，兜住不等于演示失败路径。
fn sign(
  access_key : String,
  secret_key : String,
  region : String,
  timestamp : String,
  req : @obsauth.RequestToSign,
) -> @obsauth.Signature {
  try {
    @obsauth.sign_v4(access_key, secret_key, region, timestamp, req)
  } catch {
    err => abort("最小用法只演示本地可算的一档，签名件不该在这里红：" + err.text())
  }
}

test "寻址、编码与签名串全在本地算得出，抄这一块不打网络" {
  // 基址按区域派生；虚主机那一档由桶名打头，Config::host_of 是唯一出口
  assert_eq(
    @obsconfig.native_endpoint_host("cn-north-4"),
    "obs.cn-north-4.myhuaweicloud.com",
  )
  // 对象键编码：斜杠保留、空格 %20、加号 %2B——签名侧与请求行用同一条规则
  assert_eq(
    @obsauth.uri_encode("articles/03 state+machine.png", keep_slash=true),
    "articles/03%20state%2Bmachine.png",
  )
  // 查询串：键、值各自编码，再按编码后的串整体排序，空值写 `acl=`（等号不能省）
  assert_eq(
    @obsauth.canonical_query_string([("prefix", "a b"), ("acl", "")]),
    "acl=&prefix=a%20b",
  )
  // 头值归一（首尾去掉、中间连续空白压成一个空格）＋头名字典序分号拼
  assert_eq(@obsauth.normalize_header_value("  padded   value  "), "padded value")
  assert_eq(@obsauth.signed_header_list(["x-amz-date", "host"]), "host;x-amz-date")
  // scope 的服务名写死 `s3`，算法串与 AWS 逐字相同——这两格错了不会报错，只会一直 403
  assert_eq(
    @obsauth.scope_of("20261016", "cn-north-4"),
    "20261016/cn-north-4/s3/aws4_request",
  )
  assert_eq(@obsauth.algorithm, "AWS4-HMAC-SHA256")
  assert_eq(@obsauth.unsigned_payload, "UNSIGNED-PAYLOAD")
  // 头名前缀：原生端点上 V4 这一族只认 x-amz-*，所以默认档就是 Amz
  assert_eq(@obsauth.HeaderPrefix::Amz.date_header(), "x-amz-date")
  // 用 AWS 官方 SigV4 测试凭据签一发（公开测试值，不是任何真密钥）。
  // Authorization 的拼法是"逗号后不带空格"——AWS SDK 发的是带空格那一形，两家服务端都收，
  // 但这里钉的是 OBS 官方 SDK 那串逐字形状。
  let signed = sign(
    "AKIDEXAMPLE",
    "wJalrXUtnFEMI/K7MDENG+bPxRfiCYEXAMPLEKEY",
    "us-east-1",
    "20261016T010203Z",
    @obsauth.RequestToSign::new(
      "GET",
      "/examplebucket/plain.txt",
      headers=[
        ("host", "examplebucket.obs.us-east-1.myhuaweicloud.com"),
        ("x-amz-content-sha256", @obsauth.unsigned_payload),
        ("x-amz-date", "20261016T010203Z"),
      ],
      payload_hash=@obsauth.unsigned_payload,
    ),
  )
  assert_eq(signed.signed_headers, "host;x-amz-content-sha256;x-amz-date")
  let want_head = "AWS4-HMAC-SHA256 Credential=AKIDEXAMPLE/20261016/us-east-1/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature="
  assert_true(signed.authorization.has_prefix(want_head))
  // 密钥本体不许出现在签出来的任何一段里
  assert_eq(signed.string_to_sign.find("wJalrXUtnFEMI/K7MDENG+bPxRfiCYEXAMPLEKEY"), None)
}

#传输层死亡的重发纪律（行为，不是内部实现细节）

[moon-obs] resending exactly once: GET /<bucket>/<key> -- response headers had not arrived (...); the resend is safe because ...
[moon-obs] NOT resending: POST /<bucket>/<key> -- POST ?uploads mints a new uploadId, ...

平台能力读数（原生面收不收 list-type=2、分片最小段尺寸、ACL 取值面与 grant 拼法、 预签名免凭据可否取回等）都由仓内的真桶实测档裁决，判据与打印口径见 obs/live_test.mbt 与 obs/retry_live_test.mbt；本文件不抄那些数字。