การส่งเซสชันพร็อกซีไปยัง Dropbox Python SDK

Dropbox Python SDK ยอมรับเซสชัน HTTP ที่กำหนดค่าไว้แล้ว ฟังก์ชันช่วยเหลือสาธารณะ create_session มีพารามิเตอร์ proxies:

import dropbox

session = dropbox.create_session(proxies={
    'https': 'http://proxy.example:8080',
})
client = dropbox.Dropbox(access_token, session=session)

ฟังก์ชันช่วยเหลือของ SDK ส่งคืนเซสชัน Requests พร้อมการตั้งค่าพูลการเชื่อมต่อของ SDK การส่งออบเจ็กต์นั้นไปยัง Dropbox จะเชื่อมมันเข้ากับชั้นการรับส่ง API ของไคลเอนต์ ไม่จำเป็นต้องแก้ไข dropbox/rest.py หรือแทนที่คลาส pool-manager ส่วนตัว

คีย์ของพจนานุกรมเลือกปลายทาง HTTPS HTTP URL อธิบายตัวรับฟังของพร็อกซีตัวอย่างนี้ จัดหา access token ปกติของแอปพลิเคชันแยกต่างหากผ่านคอนสตรักเตอร์ของไคลเอนต์ รายการพร็อกซี HTTP มีตัวเลือกปลายทางสำหรับเส้นทาง Dropbox API สาธารณะที่ได้รับอนุญาตโดยไม่ต้องยืนยันตัวตนพร็อกซี แต่ไม่ได้จัดหา access token นั้น

การรวมสภาพแวดล้อมของ Requests ยังคงใช้กับเซสชัน หากแอปพลิเคชันเป็นเจ้าของเส้นทางทั้งหมดโดยเจตนา ให้ตั้ง session.trust_env เป็น false และจัดหาการกำหนดค่าความเชื่อถือที่ขึ้นกับสภาพแวดล้อมอย่างชัดเจน มิฉะนั้นให้คงพฤติกรรมสภาพแวดล้อมที่การติดตั้งต้องการ

ฟังก์ชันช่วยเหลือยังยอมรับ ca_certs สำหรับชุด CA ที่เลือก เก็บการสร้างเซสชันไว้ที่เดียวและนำไคลเอนต์ที่ได้กลับมาใช้สำหรับการดำเนินการที่ตั้งใจไว้ เพื่อให้คำขอเมทาดาทาและการถ่ายโอนไฟล์ใช้ชั้นการรับส่งที่กำหนดค่าไว้นั้นร่วมกัน