Dev.to has a pretty awesome community for sharing coding knowledge. I wanted to republish my posts to them (and also link to the comments) so I made this library, and in the interest of sharing decided to opensource it for anyone to use.
PyDevTo is a a wrapper around the dev.to api endoints, with a few helper functions to help with the distribution of articles.
Features
Implements all endpoints from https://docs.dev.to/api/
Implements a few other api endpoints not documented but available in the source, such as users and follow_suggestions.
Includes a helper method to convert html to dev.to specific markdown, including support for dev.to specific embeds such as YouTube.
Installation
Use the package manager pip to install pydevto.
pip install pydevto
Usage
Make sure you have an api key to use the authenticated endpoints. You can get your key from https://dev.to/settings/account (You can use pydevto without an api key for some functions, such as the public articles)
import pydevto api = pydevto.PyDevTo(api_key='MY_KEY') api.articles() # returns list of your own published articles Methods
import pydevto api = pydevto.PyDevTo(api_key='MY_KEY') api.public_articles(page=None, tag=None, username=None, state=None, top=None) # Return list of public (published) articles api.public_article(id) # Return a single public (published) article given its id api.articles(page=None, per_page=None, state="published") # Return a list of user articles api.create_article(...) # Create an article api.update_article(id, ...) # Update an article api.user(id=None, username=None) # Return user information api.follow_suggestions(page=None) # Return list of follow suggestions api.tags(page=None) # Return list of tags api.webhooks() # Return list of webhooks api.webhook(id) # Return single webhook with id api.create_webhook(source, target_url, events) # Create a new webhook api.delete_webhook(id) # Delete a webhook with id PyDevTo contains a helper function to convert html to dev.to specific markdown. (https://dev.to/p/editor_guide) It supports images with captions using the HTML figcaption tag, and converts embeds such as YouTube to dev.to specific liquid tags.
>>> import pydevto >>> pydevto.html_to_markdown('<h1>Heading</h1') >>> '# Heading\n\n' >>> pydevto.html_to_markdown('<iframe src="https://www.youtube.com/embed/kmjiUVEMvI4"></iframe>') >>> '\n{% youtube kmjiUVEMvI4 %}\n' 
PyDevTo
Unofficial dev.to api for python.
Features
- Implements all endpoints from https://docs.dev.to/api/
- Implements a few other api endpoints not documented but available in the source, such as users and follow_suggestions
- Includes a helper method to convert html to dev.to specific markdown, including support for dev.to specific embeds such as YouTube.
Installation
Use the package manager pip to install pydevto.
pip install pydevtoUsage
Make sure you have an api key to use the authenticated endpoints. You can get your key from https://dev.to/settings/account (You can use pydevto without an api key for some functions, such as the public articles)
import pydevto api = pydevto.PyDevTo(api_key='MY_KEY') api.articles() # returns list of your own published articlesMethods
import pydevto api = pydevto.PyDevTo(api_key='MY_KEY') api.public_articles(page=None, tag=None, username=None…
Let me know if you run into any issues.
PS I originally published this post at https://loftie.com/post/pydevto-unofficial-devto-api and used this very library to make this post :)
Top comments (5)
Looks cool @lpellis !
What led you to integrate the markdown converter? Interesting approach to revert embeds to their own liquid tag original.
ps. I've recently started switching my projects from requests to httpx, mostly because it's more modern, supports async and doesn't have the weird aura of its author around it :D
The motivation for this library is being able to publish posts from my blog to dev.to. My posts are html, and while dev.to kinda supports some html it didn't really work good enough for me, hence the markdown conversion. I figured this type of syndication might be a common use case and is actually tricky to get right, so hope others can find it useful.
httpx looks very promising, does it work as basically a drop-in replacement for you? I have yet to really use asyncio, I've looked at aiohttp but found it quite a bit more complicated.
yeah, for the most part, the only drawback is that httpx requires Python 3.6, it doesn't work with 3.5, but I see your library is already asking for 3.6.
I just switched my prototype client to httpx, you can see here: github.com/rhymes/devto-py/commit/...
I've kinda given up on
asyncio/aiohttpdirectly, they are really complicated. I'd like to try trio and/or starlette. But async, in general, is not easy :D".. and used this very library to make this post"
Best part of the article ever.
Cool stuff, do you know if there is a similar thing but for JS? If not, I might give it a go! Or might create a post on how to create an API library for JS...