|
@@ -312,7 +312,7 @@ class Feishu:
|
|
|
rows_count = len(cls.get_values_batch("twitter", "db114c"))
|
|
rows_count = len(cls.get_values_batch("twitter", "db114c"))
|
|
|
body = {
|
|
body = {
|
|
|
"find_condition": {
|
|
"find_condition": {
|
|
|
- "range": sheetid+"!A1:A"+str(rows_count),
|
|
+ "range": sheetid + "!A1:A" + str(rows_count),
|
|
|
"match_case": True,
|
|
"match_case": True,
|
|
|
"match_entire_cell": False,
|
|
"match_entire_cell": False,
|
|
|
"search_by_regex": False,
|
|
"search_by_regex": False,
|
|
@@ -329,10 +329,569 @@ class Feishu:
|
|
|
except Exception as e:
|
|
except Exception as e:
|
|
|
Common.logger().error("查找单元格异常:{}", e)
|
|
Common.logger().error("查找单元格异常:{}", e)
|
|
|
|
|
|
|
|
|
|
+
|
|
|
|
|
+ @classmethod
|
|
|
|
|
+ def filter_created_at(cls):
|
|
|
|
|
+ filter_created_at_url = "https://open.feishu.cn/open-apis/sheets/v3/spreadsheets/" \
|
|
|
|
|
+ "shtcn8fFzDhCFHpB6vzf51s2xbf/sheets/48cfb0/filter"
|
|
|
|
|
+ headers = {
|
|
|
|
|
+ "Authorization": "Bearer " + cls.get_token(),
|
|
|
|
|
+ "Content-Type": "application/json; charset=utf-8"
|
|
|
|
|
+ }
|
|
|
|
|
+ body = {
|
|
|
|
|
+ "col": "A",
|
|
|
|
|
+ "condition": {
|
|
|
|
|
+ "filter_type": "number",
|
|
|
|
|
+ "compare_type": "less",
|
|
|
|
|
+ "expected": [
|
|
|
|
|
+ "6"
|
|
|
|
|
+ ]
|
|
|
|
|
+ }
|
|
|
|
|
+ }
|
|
|
|
|
+ try:
|
|
|
|
|
+ urllib3.disable_warnings()
|
|
|
|
|
+ r = requests.put(url=filter_created_at_url, headers=headers, json=body, proxies=proxies, verify=False)
|
|
|
|
|
+ print(r.json())
|
|
|
|
|
+ except Exception as e:
|
|
|
|
|
+ Common.logger().error("查找单元格异常:{}", e)
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+class Bitable:
|
|
|
|
|
+ """
|
|
|
|
|
+ 多维表格 API
|
|
|
|
|
+ 文档地址:https://w42nne6hzg.feishu.cn/base/bascnpAYvIA0B1hBtNJlriZceUV?table=tblqMbXrpqFbDLNE&view=vewsMtek0O
|
|
|
|
|
+ app_token:bascnpAYvIA0B1hBtNJlriZceUV
|
|
|
|
|
+ """
|
|
|
|
|
+ app_token = "bascnpAYvIA0B1hBtNJlriZceUV"
|
|
|
|
|
+ table_id = "tblqMbXrpqFbDLNE"
|
|
|
|
|
+ page_token = ""
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ @classmethod
|
|
|
|
|
+ def tenant_access_token(cls):
|
|
|
|
|
+ """
|
|
|
|
|
+ 获取飞书api token
|
|
|
|
|
+ :return:
|
|
|
|
|
+ """
|
|
|
|
|
+ time.sleep(1)
|
|
|
|
|
+ url = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal/"
|
|
|
|
|
+ post_data = {"app_id": "cli_a13ad2afa438d00b",
|
|
|
|
|
+ "app_secret": "4tK9LY9VbiQlY5umhE42dclBFo6t4p5O"}
|
|
|
|
|
+
|
|
|
|
|
+ try:
|
|
|
|
|
+ urllib3.disable_warnings()
|
|
|
|
|
+ response = requests.post(url=url, data=post_data, proxies=proxies, verify=False)
|
|
|
|
|
+ tenant_access_token = response.json()["tenant_access_token"]
|
|
|
|
|
+ return tenant_access_token
|
|
|
|
|
+ except Exception as e:
|
|
|
|
|
+ Common.logger().error("获取tenant_access_token异常:{}", e)
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ @classmethod
|
|
|
|
|
+ def get_apps(cls):
|
|
|
|
|
+ """
|
|
|
|
|
+ 获取多维表格元数据
|
|
|
|
|
+ 该接口支持调用频率上限为 20 QPS
|
|
|
|
|
+ https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app/get
|
|
|
|
|
+ """
|
|
|
|
|
+ url = "https://open.feishu.cn/open-apis/bitable/v1/apps/" + cls.app_token
|
|
|
|
|
+ headers = {
|
|
|
|
|
+ "Authorization": "Bearer " + cls.tenant_access_token(),
|
|
|
|
|
+ "Content-Type": "application/json; charset=utf-8"
|
|
|
|
|
+ }
|
|
|
|
|
+ try:
|
|
|
|
|
+ urllib3.disable_warnings()
|
|
|
|
|
+ r = requests.get(url=url, headers=headers, proxies=proxies, verify=False)
|
|
|
|
|
+ Common.logger().info("获取多维表格元数据,code:{},msg:{}", r.json()["code"], r.json()["msg"])
|
|
|
|
|
+ except Exception as e:
|
|
|
|
|
+ Common.logger().error("获取多维表格元数据异常:{}", e)
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ @classmethod
|
|
|
|
|
+ def get_tables(cls):
|
|
|
|
|
+ """
|
|
|
|
|
+ 列出数据表
|
|
|
|
|
+ 该接口支持调用频率上限为 20 QPS
|
|
|
|
|
+ https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/list
|
|
|
|
|
+ """
|
|
|
|
|
+ url = "https://open.feishu.cn/open-apis/bitable/v1/apps/" + cls.app_token + "/tables"
|
|
|
|
|
+ headers = {
|
|
|
|
|
+ "Authorization": "Bearer " + cls.tenant_access_token(),
|
|
|
|
|
+ "Content-Type": "application/json; charset=utf-8"
|
|
|
|
|
+ }
|
|
|
|
|
+ params = {
|
|
|
|
|
+ "page_token": "",
|
|
|
|
|
+ "page_size": ""
|
|
|
|
|
+ }
|
|
|
|
|
+ try:
|
|
|
|
|
+ urllib3.disable_warnings()
|
|
|
|
|
+ r = requests.get(url=url, headers=headers, params=params, proxies=proxies, verify=False)
|
|
|
|
|
+ Common.logger().info("列出数据表,code:{},msg:{}", r.json()["code"], r.json()["msg"])
|
|
|
|
|
+ except Exception as e:
|
|
|
|
|
+ Common.logger().error("列出数据表异常:{}", e)
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ @classmethod
|
|
|
|
|
+ def list_records(cls, count):
|
|
|
|
|
+ """
|
|
|
|
|
+ 该接口用于列出数据表中的现有记录,单次最多列出 100 行记录,支持分页获取。
|
|
|
|
|
+ 该接口支持调用频率上限为 1000 次/分钟
|
|
|
|
|
+ https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/list
|
|
|
|
|
+ """
|
|
|
|
|
+ url = "https://open.feishu.cn/open-apis/bitable/v1/apps/" \
|
|
|
|
|
+ + cls.app_token + "/tables/" + cls.table_id + "/records"
|
|
|
|
|
+ headers = {
|
|
|
|
|
+ "Authorization": "Bearer " + cls.tenant_access_token(),
|
|
|
|
|
+ "Content-Type": "application/json; charset=utf-8"
|
|
|
|
|
+ }
|
|
|
|
|
+ params = {
|
|
|
|
|
+ "view_id": "",
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ "filter": "",
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ "sort": "",
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ "field_names": "[]",
|
|
|
|
|
+ "text_field_as_array": True,
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ "display_formula_ref": "",
|
|
|
|
|
+ "automatic_fields": "",
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ "page_token": "",
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ "page_size": count
|
|
|
|
|
+ }
|
|
|
|
|
+ try:
|
|
|
|
|
+ urllib3.disable_warnings()
|
|
|
|
|
+ r = requests.get(url=url, headers=headers, params=params, proxies=proxies, verify=False)
|
|
|
|
|
+ cls.page_token = r.json()["data"]["page_token"]
|
|
|
|
|
+ items = r.json()["data"]["items"]
|
|
|
|
|
+ for item in items:
|
|
|
|
|
+ print(item)
|
|
|
|
|
+ Common.logger().info("列出记录,code:{},msg:{}", r.json()["code"], r.json()["msg"])
|
|
|
|
|
+ except Exception as e:
|
|
|
|
|
+ Common.logger().error("列出记录异常:{}", e)
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ @classmethod
|
|
|
|
|
+ def search_records(cls, record_id):
|
|
|
|
|
+ """
|
|
|
|
|
+ 该接口用于根据 record_id 的值检索现有记录
|
|
|
|
|
+ 该接口支持调用频率上限为 20 QPS
|
|
|
|
|
+ https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/get
|
|
|
|
|
+ """
|
|
|
|
|
+ url = "https://open.feishu.cn/open-apis/bitable/v1/apps/" \
|
|
|
|
|
+ + cls.app_token + "/tables/" + cls.table_id + "/records/" + record_id
|
|
|
|
|
+ headers = {
|
|
|
|
|
+ "Authorization": "Bearer " + cls.tenant_access_token(),
|
|
|
|
|
+ "Content-Type": "application/json; charset=utf-8"
|
|
|
|
|
+ }
|
|
|
|
|
+ params = {
|
|
|
|
|
+ "text_field_as_array": True,
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ "display_formula_ref": True,
|
|
|
|
|
+ "automatic_fields": True,
|
|
|
|
|
+
|
|
|
|
|
+ }
|
|
|
|
|
+ try:
|
|
|
|
|
+ urllib3.disable_warnings()
|
|
|
|
|
+ r = requests.get(url=url, headers=headers, params=params, proxies=proxies, verify=False)
|
|
|
|
|
+ Common.logger().info("检索记录,code:{},msg:{}", r.json()["code"], r.json()["msg"])
|
|
|
|
|
+ except Exception as e:
|
|
|
|
|
+ Common.logger().error("检索记录异常:{}", e)
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ @classmethod
|
|
|
|
|
+ def create_record(cls, fields):
|
|
|
|
|
+ """
|
|
|
|
|
+ 该接口用于在数据表中新增一条记录
|
|
|
|
|
+ 该接口支持调用频率上限为 10 QPS
|
|
|
|
|
+ https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/create
|
|
|
|
|
+ """
|
|
|
|
|
+ url = "https://open.feishu.cn/open-apis/bitable/v1/apps/" \
|
|
|
|
|
+ + cls.app_token + "/tables/" + cls.table_id + "/records"
|
|
|
|
|
+ headers = {
|
|
|
|
|
+ "Authorization": "Bearer " + cls.tenant_access_token(),
|
|
|
|
|
+ "Content-Type": "application/json; charset=utf-8"
|
|
|
|
|
+ }
|
|
|
|
|
+ body = fields
|
|
|
|
|
+ try:
|
|
|
|
|
+ urllib3.disable_warnings()
|
|
|
|
|
+ r = requests.post(url=url, headers=headers, json=body, proxies=proxies, verify=False)
|
|
|
|
|
+ Common.logger().info("新增记录,code:{},msg:{}", r.json()["code"], r.json()["msg"])
|
|
|
|
|
+ except Exception as e:
|
|
|
|
|
+ Common.logger().error("新增记录异常:{}", e)
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ @classmethod
|
|
|
|
|
+ def create_records(cls, records):
|
|
|
|
|
+ """
|
|
|
|
|
+ 该接口用于在数据表中新增多条记录
|
|
|
|
|
+ 该接口支持调用频率上限为 10 QPS
|
|
|
|
|
+ https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/batch_create
|
|
|
|
|
+ """
|
|
|
|
|
+ url = "https://open.feishu.cn/open-apis/bitable/v1/apps/" \
|
|
|
|
|
+ + cls.app_token + "/tables/" + cls.table_id + "/records/batch_create"
|
|
|
|
|
+ headers = {
|
|
|
|
|
+ "Authorization": "Bearer " + cls.tenant_access_token(),
|
|
|
|
|
+ "Content-Type": "application/json; charset=utf-8"
|
|
|
|
|
+ }
|
|
|
|
|
+ body = {
|
|
|
|
|
+ "records": records
|
|
|
|
|
+ }
|
|
|
|
|
+ try:
|
|
|
|
|
+ urllib3.disable_warnings()
|
|
|
|
|
+ r = requests.post(url=url, headers=headers, json=body, proxies=proxies, verify=False)
|
|
|
|
|
+ Common.logger().info("新增多条记录,code:{},msg:{}", r.json()["code"], r.json()["msg"])
|
|
|
|
|
+ except Exception as e:
|
|
|
|
|
+ Common.logger().error("新增多条记录异常:{}", e)
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ @classmethod
|
|
|
|
|
+ def update_record(cls, record_id, fields):
|
|
|
|
|
+ """
|
|
|
|
|
+ 该接口用于更新数据表中的一条记录
|
|
|
|
|
+ 该接口支持调用频率上限为 10 QPS
|
|
|
|
|
+ https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/update
|
|
|
|
|
+ """
|
|
|
|
|
+ url = "https://open.feishu.cn/open-apis/bitable/v1/apps/" \
|
|
|
|
|
+ + cls.app_token + "/tables/" + cls.table_id + "/records/" + record_id
|
|
|
|
|
+ headers = {
|
|
|
|
|
+ "Authorization": "Bearer " + cls.tenant_access_token(),
|
|
|
|
|
+ "Content-Type": "application/json; charset=utf-8"
|
|
|
|
|
+ }
|
|
|
|
|
+ body = fields
|
|
|
|
|
+ try:
|
|
|
|
|
+ urllib3.disable_warnings()
|
|
|
|
|
+ r = requests.put(url=url, headers=headers, json=body, proxies=proxies, verify=False)
|
|
|
|
|
+ Common.logger().info("更新记录,code:{},msg:{}", r.json()["code"], r.json()["msg"])
|
|
|
|
|
+ except Exception as e:
|
|
|
|
|
+ Common.logger().error("更新记录异常:{}", e)
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ @classmethod
|
|
|
|
|
+ def update_records(cls, records):
|
|
|
|
|
+ """
|
|
|
|
|
+ 该接口用于更新数据表中的多条记录
|
|
|
|
|
+ 该接口支持调用频率上限为 10 QPS
|
|
|
|
|
+ https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/batch_update
|
|
|
|
|
+ """
|
|
|
|
|
+ url = "https://open.feishu.cn/open-apis/bitable/v1/apps/" \
|
|
|
|
|
+ + cls.app_token + "/tables/" + cls.table_id + "/records/batch_update"
|
|
|
|
|
+ headers = {
|
|
|
|
|
+ "Authorization": "Bearer " + cls.tenant_access_token(),
|
|
|
|
|
+ "Content-Type": "application/json; charset=utf-8"
|
|
|
|
|
+ }
|
|
|
|
|
+ body = records
|
|
|
|
|
+ try:
|
|
|
|
|
+ urllib3.disable_warnings()
|
|
|
|
|
+ r = requests.post(url=url, headers=headers, json=body, proxies=proxies, verify=False)
|
|
|
|
|
+ Common.logger().info("更新多条记录,code:{},msg:{}", r.json()["code"], r.json()["msg"])
|
|
|
|
|
+ except Exception as e:
|
|
|
|
|
+ Common.logger().error("更新多条记录异常:{}", e)
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ @classmethod
|
|
|
|
|
+ def del_record(cls, record_id):
|
|
|
|
|
+ """
|
|
|
|
|
+ 该接口用于删除数据表中的一条记录
|
|
|
|
|
+ 该接口支持调用频率上限为 10 QPS
|
|
|
|
|
+ https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/delete
|
|
|
|
|
+ """
|
|
|
|
|
+ url = "https://open.feishu.cn/open-apis/bitable/v1/apps/" \
|
|
|
|
|
+ + cls.app_token + "/tables/" + cls.table_id + "/records/" + record_id
|
|
|
|
|
+ headers = {
|
|
|
|
|
+ "Authorization": "Bearer " + cls.tenant_access_token(),
|
|
|
|
|
+ "Content-Type": "application/json; charset=utf-8"
|
|
|
|
|
+ }
|
|
|
|
|
+ try:
|
|
|
|
|
+ urllib3.disable_warnings()
|
|
|
|
|
+ r = requests.delete(url=url, headers=headers, proxies=proxies, verify=False)
|
|
|
|
|
+ Common.logger().info("删除记录,code:{},msg:{}", r.json()["code"], r.json()["msg"])
|
|
|
|
|
+ except Exception as e:
|
|
|
|
|
+ Common.logger().error("删除记录异常:{}", e)
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ @classmethod
|
|
|
|
|
+ def del_records(cls, record_ids):
|
|
|
|
|
+ """
|
|
|
|
|
+ 该接口用于删除数据表中现有的多条记录
|
|
|
|
|
+ 该接口支持调用频率上限为 10 QPS
|
|
|
|
|
+ https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/batch_delete
|
|
|
|
|
+ """
|
|
|
|
|
+ url = "https://open.feishu.cn/open-apis/bitable/v1/apps/" \
|
|
|
|
|
+ + cls.app_token + "/tables/" + cls.table_id + "/records/batch_delete"
|
|
|
|
|
+ headers = {
|
|
|
|
|
+ "Authorization": "Bearer " + cls.tenant_access_token(),
|
|
|
|
|
+ "Content-Type": "application/json; charset=utf-8"
|
|
|
|
|
+ }
|
|
|
|
|
+ body = {
|
|
|
|
|
+ "records": record_ids
|
|
|
|
|
+ }
|
|
|
|
|
+ try:
|
|
|
|
|
+ urllib3.disable_warnings()
|
|
|
|
|
+ r = requests.post(url=url, headers=headers, json=body, proxies=proxies, verify=False)
|
|
|
|
|
+ Common.logger().info("删除多条记录,code:{},msg:{}", r.json()["code"], r.json()["msg"])
|
|
|
|
|
+ except Exception as e:
|
|
|
|
|
+ Common.logger().error("删除多条记录异常:{}", e)
|
|
|
|
|
+
|
|
|
|
|
|
|
|
if __name__ == "__main__":
|
|
if __name__ == "__main__":
|
|
|
- feishu = Feishu()
|
|
+
|
|
|
- print(feishu.find_cell("twitter", "db114c", "956929025645035522"))
|
|
+
|
|
|
- print(type(feishu.find_cell("twitter", "db114c", "956929025645035522")))
|
|
+
|
|
|
|
|
+ 'reck6nLiZV'
|
|
|
|
|
+ 'recHcfJZnG'
|
|
|
|
|
+ 'recxdSMhzE'
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+ bitable = Bitable()
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
+
|
|
|
|
|
|
|
|
- pass
|
|
+
|
|
|
|
|
+
|