Initial project import

tools/v/vlib/net/s3/s3.v

@@ -0,0 +1,40 @@
+// Copyright (c) 2019-2026 Alexander Medvednikov. All rights reserved.
+// Use of this source code is governed by an MIT license
+// that can be found in the LICENSE file.
+// Module s3 is an S3-compatible client for V.
+//
+// Quick start:
+//
+//   import s3
+//
+//   client := s3.new_client(s3.Credentials{
+//       endpoint:          'https://s3.example.com'
+//       access_key_id:     '...'
+//       secret_access_key: '...'
+//       bucket:            'my-bucket'
+//   })
+//   client.put('hello.txt', 'Hi from V!'.bytes())!
+//   text := client.get_string('hello.txt')!
+//   url  := client.presign('hello.txt', expires_in: 3600)!
+//
+//   // s3:// fetch helper:
+//   resp := s3.fetch('s3://my-bucket/hello.txt')!
+//
+// Construct credentials from the environment (S3_*, AWS_*, CELLAR_ADDON_*,
+// SCW_*, B2_*, R2_*, SPACES_* — first non-empty wins per field):
+//
+//   client := s3.new_client(s3.Credentials.from_env())
+//
+// Multipart for large files:
+//
+//   client.upload_file('big.bin', '/path/to/big.bin', s3.PutOptions{ content_type: 'application/octet-stream' })!
+module s3
+
+// version is the module version, kept in sync with v.mod.
+pub const version = '0.1.0'
+
+// info_string returns a one-line build-time identification, useful in
+// User-Agent strings or `--version` output.
+pub fn info_string() string {
+	return 's3/${version}'
+}