Examples

# Getting the newest posts on Repl Talk and printing their titles
async for post in client.boards.all.get_posts():
	print(post.title)

API Reference

How to use the repltalk lib for Python. The functions are pretty self explanatory but I've added a short description for each of them.

The following functions are all coroutines unless specifically specified because asyncio is cool

Client

class repltalk.Client()

await login(username, password) Logs in to Repl.it with your username and password. Your bot must be verified in order to use this function.
await get_post(post_id) Gets the post with that id. returns Post
await get_comment(comment_id) Gets the comment with that id. returns Comment
await post_exists(post_id) Returns whether or not the post exists.
await get_leaderboard(limit=30) Gets the top users from the Repl Talk leaderboard. returns list of Users
await get_all_comments() Gets all the recent comments from Repl Talk. *returns list of Comments
await get_user(username) Gets the user with that username. returns User
await get_reports(resolved=False) Gets a list of reports. Only works for moderators or admins. See Report List
boards See Board.

Board

class client.boards

all The All board on Repl Talk.
share The Share board on Repl Talk.
ask The Ask board on Repl Talk.
announcements The Announcements board on Repl Talk.
challenge The Challenge board on Repl Talk.
learn The Learn board on Repl Talk.

async for post in get_posts(sort='top', search='') Gets the most recent posts from that board. Sort is the sorting order (top|hot|new) and search is the search query. returns AsyncPostList

RichBoard

A board that contains all the information from Board, and more. You can get this by doing await client.boards.get(board_name) (NOT YET ADDED)

name The name of the board.
title_cta Title call to action
body_cta Body call to action
button_cta Button call to action
repl_required Whether a Repl is required to be submitted.

Post

id The post ID.
title The post title.
content The post content.
board The board the post was made on.
votes The amount of upvotes the post has.
author The post author. Will be a User object.
timestamp The time the post was created at. (datetime.datetime object)
url The post url in Repl Talk.
repl The repl attached to the post.
language The Language that the Repl attached to the post uses.
show_hosted Indicates whether the post has a hosted repl linked to it.
is_announcement Whether the post is marked as an announcement.
pinned Whether the post has been pinned to the top of the board.
can_edit Indicates if the user can edit the post. This will be False unless you created the post.
can_comment If the user can comment on the post.
can_vote Indicates if the user can upvote the post.
has_voted Indicates if the user has already voted on the post.
is_locked Indicates if the post is locked.
can_answer Whether or not the user can answer the post.
answered If the post has been answered (will always be False if it's not a question).
comment_count The amount of comments the post has
await get_comments() Gets the comments on the post.
await post_comment(content) Posts a comment on the post.
await report(reason) Report the post
await delete() Delete the Post

Comment

id The comment ID.
content The comment body.
timestamp The time the comment was created at. (datetime.datetime object)
can_edit Indicates if the user can edit the comment.
can_comment Whether or not the user can post a comment.
url The comment's url.
votes Gets the amount of upvotes the comment has.
can_vote Indicates if the user can vote on the comment.
has_voted Indicates if the user has already upvoted the post.
author The User for the author of the post.
post The post that the comment was made on.
replies A list of replies that the comment received.
parent The parent comment, if any.
await reply(content) Replies to the comment with the content.
await report(reason) Report the comment
await delete() Delete the comment

User

id The user ID. Pretty useless since you can't get the user from their id.
name The user's username.
avatar The user's avatar url.
url The user's profile link.
cycles The amount of cycles/karma that user has.
roles The roles the user has set on their profile.
bio The short description written by a user on their profile.
first_name What the user set as their first name in their profile
last_name What the user set as their last name in their profile
languages The Languages that the user uses most often.
timestamp The time when the user account was created. (datetime.datetime object)
is_hacker Whether the user has the hacker plan
await get_comments(limit=30, order='new') Get a list of up to 1100 of the users comments. See Comment
await get_posts(limit=30, order='new') Get a list of up to 100 of the user's posts. See Post
await ban(reason) Ban the user

PostList/AsyncPostList

Acts like a normal list, except you can iterate over it

await next() Gets the next page of posts. Not present in AsyncPostList because it's done automatically.
board Gets the board of the repls it's getting from

Repl

id The Repl ID.
embed_url The url for embedding the Repl on a web page.
url The url of the Repl.
title The title of the Repl.
language The Language of the Repl.

Language

Represents a programming language on Repl.it.

id Gets the ID of the language (ie python3).
display_name Gets the display name of the language (ie Python).
icon Gets the url for the language icon.
category Gets the category that the language is listed as.
is_new Whether the language was recently added to Repl.it.
tagline A short description of the language.

Report List

List of reports. see Report If linked post/comment is deleted is lazy report, See lazyReport

for report in get_reports Cycles through the reports, with lazy posts/comments.
async for report in get_reports Cycles through the reports with full posts, if there is a post.

Report

A report on a comment or post

id The report id
type The type of the report. ('post' or 'comment')
reason Why the report was made
timestamp When the report was created
creator Who created the report
await get_attached() Get the attached post/comment

Lazy Report

A less complete report

id The report id
reason Why the report was made
creator Who created the report

Lazy Post

A less complete post

url The url to the post
id The post's id
author The post's author
content The post's content
title The post's title
await delete() Delete the post
await get_full_post() Returns the full post

Lazy Comment

A less complete comment

url The url to the comment
id The comment's id
author The comment's author
content The comment's content
await delete() Delete the comment
await get_full_comment() Returns the full comment

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

mat-1 / repl-talk-api

Programming Languages

Labels

Projects that are alternatives of or similar to repl-talk-api