Metadata-Version: 2.1
Name: dingsdk
Version: 2.0.0
Summary: DingTalk Mini SDK
Author-email: "Mr.LLT" <lltemail@dingtalk.com>
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 5 - Production/Stable
Classifier: Topic :: Office/Business :: Office Suites
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE-APACHE
License-File: LICENSE-MIT
Requires-Dist: requests (==2.28.*)

# Ding SDK

> 钉钉企业内部应用使用的钉钉SDK，为更贴合个人编码习惯，由个人自主开发和维护的钉钉SDK的 Python 模块。

1. 安装

   ```python
   pip install dingsdk
   ```

2. 使用

   ```python
   from dingsdk import DingSDK
   
   sdk = DingSDK()
   sdk.appkey = 'your appkey'
   sdk.agentid = 'your agentid'
   sdk.appsecret = 'your appsecret'
   sdk.access_token = sdk.get_token()		# 获取企业内部应用的 AccessToken
   ```

3. 清洗审批实例

   ```python
   from dingsdk.utils import InstanceCleaner
   
   instid = "approval process instance id"
   instance = sdk.get_instance_detail(instid)
   cleaner = InstanceCleaner(instance)
   cleaner.cleaned_data		# 已清洗的审批实例数据
   cleaner.cleaned_formvs		# 已清洗的实例表单数据
   ```

## 版本进程

**1.0.0_2023.2.2**

- 发布钉钉接口方法十四个，见接口检索；
- 钉钉审批实例数据清洗，`InstanceCleaner()`；

**2.0.0_2023.3.8**

- 重构部分代码，使创建新接口变得容易且清晰;
- 取消了部分接口的调用限制, 在方法内自动处理;
- 将 InstanceCleaner 移动到 utils 包中;
- 新增了钉钉接口方法，并创建了 DingSDK 文档说明进行接口检索;
