class Client(object):
"""接口封装类
该类封装了SDK提供的全部API，用户在开发时只需要实例化这个类就可以调用SDK提供的全部接口，而不需要根据不同的API实例化不同的类
Attributes:
auth: 上传&管理token计算实例
simpleupload: 普通上传实例
streamupload: 流地址上传实例
multiupload: 分片上传实例
bmgr: 资源管理实例
fmgr: 高级资源管理实例
pfops: 音视频持久化操作实例
wsl: 直播录制文件列举实例
cfg: 配置文件管理实例
"""
def __init__(self, config):
self.auth = Auth(config.access_key, config.secret_key)
self.simpleupload = SimpleUpload(config.put_url)
self.streamupload = StreamUpload(config.put_url)
self.multiupload = MultipartUpload(config.put_url)
self.bmgr = BucketManager(self.auth, config.mgr_url)
self.fmgr = Fmgr(self.auth, config.mgr_url)
self.pfops = PersistentFop(self.auth, config.mgr_url)
self.wsl = WsLive(self.auth, config.mgr_url)
self.cfg = config
def simple_upload(self, path, bucket, key):
policy = PutPolicy()
policy.set_conf('scope', '%s:%s' % (bucket, key))
policy.dump_policy(self.cfg)
token = self.auth.uploadtoken(policy.putpolicy)
return self.simpleupload.upload(path, token, key)
def stream_upload(self, stream, bucket, key):
policy = PutPolicy()
policy.set_conf('scope', '%s:%s' % (bucket, key))
policy.dump_policy(self.cfg)
token = self.auth.uploadtoken(policy.putpolicy)
return self.streamupload.upload(stream, token, key)
def multipart_upload(self, path, bucket, key, tmp_upload_id=None):
policy = PutPolicy()
policy.set_conf('scope', '%s:%s' % (bucket, key))
policy.dump_policy(self.cfg)
token = self.auth.uploadtoken(policy.putpolicy)
upload_id = tmp_upload_id or self.cfg.upload_id
return self.multiupload.upload(path, token, upload_id)
def smart_upload(self,
path,
bucket,
key,
tmp_upload_id=None,
multi_size=20):
policy = PutPolicy()
policy.set_conf('scope', '%s:%s' % (bucket, key))
policy.dump_policy(self.cfg)
token = self.auth.uploadtoken(policy.putpolicy)
file_size = 1024 * 1024 * int(multi_size)
upload_id = tmp_upload_id or self.cfg.upload_id
if os.path.getsize(path) <= file_size and not upload_id:
upload_result = self.simpleupload.upload(path, token, key)
if 200 <= upload_result[0] < 400:
return upload_result
else:
raise WcsSeriveError(
'Upload file fail,erorr info:{0}'.format(upload_result))
else:
return self.multiupload.smart_upload(path, token, upload_id)
def bucket_list(self,
bucket,
prefix=None,
marker=None,
limit=None,
mode=None,
starttime=None,
endtime=None):
try:
pre = prefix or str(self.cfg.prefix)
except Exception:
pre = ''
try:
# m = mode or int(self.cfg.mode)
if mode == None:
m = int(self.cfg.mode)
else:
m = int(mode)
except Exception:
m = ''
try:
mar = marker or str(self.cfg.marker)
except Exception:
mar = ''
try:
l = limit or int(self.cfg.limit)
except Exception:
l = ''
return self.bmgr.bucketlist(bucket, pre, mar, l, m, starttime, endtime)
def list_buckets(self):
return self.bmgr.bucket_list()
def bucket_stat(self, name, startdate, enddate):
return self.bmgr.bucket_stat(name, startdate, enddate)
def bucket_statistics(self,
name,
stype,
startdate,
enddate,
isListDetails='false'):
return self.bmgr.bucket_statistics(name, stype, startdate, enddate,
isListDetails)
def image_detect(self, image, dtype, bucket):
return self.bmgr.image_detect(image, dtype, bucket)
def stat(self, bucket, key):
return self.bmgr.stat(bucket, key)
def delete(self, bucket, key):
return self.bmgr.delete(bucket, key)
def move(self, srcbucket, srckey, dstbucket, dstkey=''):
if dstkey:
pass
else:
dstkey = srckey
return self.bmgr.move(srcbucket, srckey, dstbucket, dstkey)
def copy(self, srcbucket, srckey, dstbucket, dstkey=''):
if dstkey:
pass
else:
dstkey = srckey
return self.bmgr.copy(srcbucket, srckey, dstbucket, dstkey)
def setdeadline(self, bucket, key, deadline):
return self.bmgr.setdeadline(bucket, key, deadline)
def _parse_fops(self, fops):
data = [fops]
if self.cfg.notifyurl:
data.append('notifyURL=%s' %
urlsafe_base64_encode(self.cfg.notifyurl))
if self.cfg.separate:
data.append('separate=%s' % self.cfg.separate)
if self.cfg.force:
data.append('force=%s' % self.cfg.force)
return 'fops=' + '&'.join(data)
def fmgr_move(self, fops):
return self.fmgr.fmgr_move(self._parse_fops(fops))
def fmgr_copy(self, fops):
return self.fmgr.fmgr_copy(self._parse_fops(fops))
def fmgr_fetch(self, fops):
return self.fmgr.fmgr_fetch(self._parse_fops(fops))
def fmgr_delete(self, fops):
return self.fmgr.fmgr_delete(self._parse_fops(fops))
def prefix_delete(self, fops):
return self.fmgr.prefix_delete(self._parse_fops(fops))
def m3u8_delete(self, fops):
return self.fmgr.m3u8_delete(self._parse_fops(fops))
def fmgr_compress(self, fops):
return self.fmgr.fmgr_compress(self._parse_fops(fops))
def fmgr_status(self, persistentId):
return self.fmgr.status(persistentId)
def ops_execute(self, fops, bucket, key):
f = int(self.cfg.force)
if self.cfg.separate:
separate = int(self.cfg.separate)
else:
separate = 0
notifyurl = self.cfg.notifyurl or ''
return self.pfops.execute(fops, bucket, key, f, separate, notifyurl)
def ops_status(self, persistentId):
return self.pfops.fops_status(persistentId)
def wslive_list(self,
channelname,
startTime,
endTime,
bucket,
start=None,
limit=None):
return self.wsl.wslive_list(channelname, startTime, endTime, bucket,
start, limit)
def fmgr_compress(self, fops):
fmgr = Fmgr(self.auth, self.cfg.mgr_url)
return fmgr.fmgr_compress(self._parse_fops(fops))