一个简单且用户友好的Python-to-trelloapi

trello.p的Python项目详细描述


Python Trello API

在特雷洛.py是一个简单的Python API,用于与Trello通信。它是一个面向对象的API,使用Trello Rest API。在

此API由LisaF854的Roblox-Trello | Object Oriented Trello API编写。它使用与该API相似的结构,因此您会注意到许多函数都应用于该API。在

这个API具有简单且用户友好的函数,可以完成许多通常由您自己完成的任务。将来会增加更多的功能,以备需要。在

入门

要使用此API,请首先使用pip从PyPI安装它:

pip install trello.py

或者从GitHub页面下载并运行目录中的代码:

^{pr2}$

此API需要应用程序密钥和令牌才能工作。要获取应用程序密钥,只需转到https://trello.com/app-key并获取生成的应用程序密钥。暂时将其保存在某个地方,因为以后需要访问它。在

一旦你有了你的应用程序密钥,你也需要获得你的应用程序令牌。您可以访问https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=Trello.py%20Access&key=YOUR_KEY_HERE以获取令牌。请确保将YOUR_KEY_HERE替换为应用程序密钥。一旦你授权了它,它会给你你的令牌。把代币也放在什么地方。在

WARNING: You should only share your token with people that you trust. Your token is like the password of your account and the app key is the username. If your app key is ever leaked, it should not cause many issues, but it is recommended that you change it. On the other hand, if your token is in fact leaked, make sure to remove access to it immediately and generate a new one. If a person has your token, then they have access to your account (via code) and have the ability to do anything that you can do. Make sure it is always kept in a safe place and hidden from the public.

下面的代码是一个导入trelloapi(作为Trello)、按名称检索board并获取board数据的示例。在

fromtrelloimportTrelloAPIasTrelloMyTrello=Trello("YOUR_APP_KEY","YOUR_TOKEN")Board=MyTrello.GetBoardByName("Your Board Name")BoardData=Board.GetData()
注意:Trello确实支持OAuth,但是pythonapi还没有对它的任何支持。

基本信息

您可以将Trello类看作帐户。您应该只在脚本中初始化Trello的一个实例。尽管这是允许的,但不建议有一个以上的Trello实例。在

Trello实例具有三个基本函数:

  • GetBoardByName(StringBoardName)-按名称获取板
  • GetBoardById(StringBoardId)-通过板的ID获取板
  • new(StringTypeStringNameObjectParent)-创建具有给定名称的新对象(BoardListCard)。如果它是一个List对象,那么父对象必须是Board对象,即列表所在的电路板。如果它是一个Card对象,那么父对象必须是List对象,该对象就是列表所在的列表。如果是一块板,十块你可以留空

目前,有五种类型的对象,TrelloBoardListCard,和{}。每个对象都有它自己的与之相关的函数,所有这些函数(除了Trello)都有一些共同的函数,它们是

  • GetId()—获取对象的ID
  • GetData(StringParam(可选))-以JSON格式获取对象的数据。Param参数是可选的。它基本上是对预先制作的URL的扩展,用于特殊请求,如卡片或标签列表
  • SetProperty(StringPropertyStringValue)-将对象的Property的值设置为Value。不建议您使用此函数。仅在需要时使用
  • ClassName()-返回对象的类名(BoardListCard,或{})

错误、报告和建议

请记住,这个API还处于早期阶段。它有bug,这是早期版本中常见的情况。如果您发现任何错误或有任何建议,请通过Discord直接发送给我,或在GitHub页(W.I.P.)上创建错误报告或建议。如果你通过不和与我联系,我的用户名是Batman212369#5703。在

NOTE: Yes, I know that currently there aren't any checkings (doesn't check for errors nor if the input is the correct type) when calling methods. This will be added soon, but for now just use the API responsibly and you should not get any errors.

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
java为引用变量指定默认值   java在2D数组中旋转innersquare   java将hashmap键值与int进行比较   java程序中的并发监视器陷入死锁   安卓 java。lang.NoClassDefFoundError:java。awt。光标   java有没有更好的方法来引用包含对象的对象?   如何在Java编程中循环代码块   java如何在Junit5中使用Serenity?   java使用ANTLR识别JavaScript文件中的全局变量声明   EJB查询对象生成的java视图SQL?   java查找股票报价的范围   java错误:(453,69)不允许使用字符串类型(在值为“”的“活动\u水平\u边距”处)   java安装的环境变量   amazon web服务在使用awssdkjava上载到S3存储桶时发生直接错误   java在Android的ArrayList中添加相等的值   尝试打开MyEclipse Enterprise Workbench时出现ide“无法创建java虚拟机”错误   java如何使用单元格指定的行和列更改jTable的单元格颜色?   java如何等待文件从系统目录复制到具有根访问权限的外部存储