boto3 را به Endpoint پارس‌پک وصل کنید

python3 --version
python3 -m pip --version

examples/python/
├── .env                 # پس از کپی‌کردن فایل نمونه ساخته می‌شود
├── .venv/               # محیط مجازی پس از نصب
├── requirements.txt     # بازه نسخه boto3
├── requirements.lock    # نسخه‌های دقیق تست‌شده
└── parspack_s3.py       # Client و هفت فرمان مدیریت فایل

python3 -m venv examples/python/.venv
examples/python/.venv/bin/pip install -r examples/python/requirements.txt

cp examples/.env.example examples/python/.env

PARSPACK_S3_ENDPOINT=https://c123456.parspack.net
PARSPACK_S3_BUCKET=c123456
PARSPACK_S3_REGION=us-east-1
PARSPACK_S3_ACCESS_KEY=YOUR_ACCESS_KEY
PARSPACK_S3_SECRET_KEY=YOUR_SECRET_KEY

def load_dot_env(path: Path) -> None:
  for raw_line in path.read_text(encoding="utf-8").splitlines():
      line = raw_line.strip()
      if not line or line.startswith("#") or "=" not in line:
          continue
      name, value = line.split("=", 1)
      os.environ.setdefault(name.strip(), value.strip().strip('"\''))


load_dot_env(Path(__file__).with_name(".env"))

s3 = boto3.client(
  "s3",
  endpoint_url=os.environ["PARSPACK_S3_ENDPOINT"].rstrip("/"),
  region_name=os.environ["PARSPACK_S3_REGION"],
  aws_access_key_id=os.environ["PARSPACK_S3_ACCESS_KEY"],
  aws_secret_access_key=os.environ["PARSPACK_S3_SECRET_KEY"],
  config=Config(
      signature_version="s3v4",
      s3={"addressing_style": "path"},
      retries={"max_attempts": 3, "mode": "standard"},
  ),
)

local_file = Path("./hello.txt")
object_key = "tutorial/hello.txt"
content_type = mimetypes.guess_type(local_file.name)[0] or "application/octet-stream"

with local_file.open("rb") as body:
  result = s3.put_object(
      Bucket=bucket,
      Key=object_key,
      Body=body,
      ContentType=content_type,
  )

print(result["ETag"])

printf 'hello ParsPack\n' > hello.txt
PY=examples/python/.venv/bin/python
$PY examples/python/parspack_s3.py upload ./hello.txt tutorial/hello.txt

paginator = s3.get_paginator("list_objects_v2")

for page in paginator.paginate(Bucket=bucket, Prefix="tutorial/"):
  for item in page.get("Contents", []):
      print(item["Key"], item["Size"], item["LastModified"])

info = s3.head_object(
  Bucket=bucket,
  Key="tutorial/hello.txt",
)

print(info["ContentLength"])
print(info.get("ContentType"))
print(info["ETag"])

$PY examples/python/parspack_s3.py list tutorial/

$PY examples/python/parspack_s3.py head tutorial/hello.txt

result = s3.get_object(
  Bucket=bucket,
  Key="tutorial/hello.txt",
)
try:
  with open("./downloads/hello.txt", "wb") as destination:
      shutil.copyfileobj(result["Body"], destination)
finally:
  result["Body"].close()

$PY examples/python/parspack_s3.py download tutorial/hello.txt ./downloads/hello.txt

url = s3.generate_presigned_url(
  "get_object",
  Params={"Bucket": bucket, "Key": "tutorial/hello.txt"},
  ExpiresIn=900,
)

$PY examples/python/parspack_s3.py presign-get tutorial/hello.txt 900

curl --output invoice.pdf "$SIGNED_DOWNLOAD_URL"

content_type = "text/plain"
upload_url = s3.generate_presigned_url(
  "put_object",
  Params={
      "Bucket": bucket,
      "Key": "tutorial/upload.txt",
      "ContentType": content_type,
  },
  ExpiresIn=900,
)

$PY examples/python/parspack_s3.py presign-put tutorial/upload.txt text/plain 900

curl -X PUT -H 'Content-Type: text/plain' \
--upload-file ./hello.txt "$SIGNED_UPLOAD_URL"

await fetch(signed.url, {
method: "PUT",
headers: { "Content-Type": signed.headers["Content-Type"] },
body: file,
});

s3.delete_object(
  Bucket=bucket,
  Key="tutorial/hello.txt",
)

PY=examples/python/.venv/bin/python
$PY examples/python/parspack_s3.py delete tutorial/hello.txt

try:
  s3.put_object(Bucket=bucket, Key=key, Body=body)
except ClientError as error:
  detail = error.response.get("Error", {})
  print(detail.get("Code"), detail.get("Message"))
except BotoCoreError as error:
  print(f"SDK or network error: {error}")

python3 -m venv examples/python/.venv
examples/python/.venv/bin/pip install -r examples/python/requirements.txt
cp examples/.env.example examples/python/.env

# مقدارهای examples/python/.env را کامل کنید
printf 'hello ParsPack\n' > hello.txt
PY=examples/python/.venv/bin/python
$PY examples/python/parspack_s3.py upload ./hello.txt tutorial/hello.txt
$PY examples/python/parspack_s3.py list tutorial/
$PY examples/python/parspack_s3.py head tutorial/hello.txt
$PY examples/python/parspack_s3.py download tutorial/hello.txt ./downloads/hello.txt
$PY examples/python/parspack_s3.py presign-get tutorial/hello.txt 900
$PY examples/python/parspack_s3.py presign-put tutorial/upload.txt text/plain 900
$PY examples/python/parspack_s3.py delete tutorial/hello.txt