https://github.com/rycus86/ghost-client
Unofficial Ghost API client
https://github.com/rycus86/ghost-client
Last synced: 10 months ago
JSON representation
Unofficial Ghost API client
- Host: GitHub
- URL: https://github.com/rycus86/ghost-client
- Owner: rycus86
- License: mit
- Created: 2017-12-30T00:22:48.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-06-19T01:08:18.000Z (almost 2 years ago)
- Last Synced: 2024-12-06T22:18:26.752Z (over 1 year ago)
- Language: Python
- Size: 43.9 KB
- Stars: 20
- Watchers: 3
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Unofficial Ghost API client
[](https://travis-ci.org/rycus86/ghost-client)
[](https://pypi.python.org/pypi/ghost-client)
[](https://pypi.python.org/pypi/ghost-client)
[](https://coveralls.io/github/rycus86/ghost-client?branch=master)
[](https://codeclimate.com/github/rycus86/ghost-client/maintainability)
This is a client library for the [Ghost blogging platform API](https://api.ghost.org).
## Installation
```shell
$ pip install ghost-client
```
## Usage
See [https://api.ghost.org](https://api.ghost.org/) for documentation on the REST endpoints and available fields and parameters.
```python
from ghost_client import Ghost
# to read the client ID and secret from the database
ghost = Ghost.from_sqlite(
'/var/lib/ghost/content/data/ghost.db',
'http://localhost:2368'
)
# or to use a specific client ID and secret
ghost = Ghost(
'http://localhost:2368',
admin_key=='admin API key'
)
# print the server's version
print(ghost.version)
# create a new tag
tag = ghost.tags.create(name='API sample')
# create a new post using it
post = ghost.posts.create(
title='Example post', slug='custom-slug',
markdown='', # yes, even on v1.+
custom_excerpt='An example post created from Python',
tags=[tag]
)
# list posts, tags and users
posts = ghost.posts.list(
status='all',
fields=('id', 'title', 'slug'),
formats=('html', 'mobiledoc', 'plaintext'),
)
tags = ghost.tags.list(fields='name', limit='all')
users = ghost.users.list(include='count.posts')
# use pagination
while posts:
for post in posts:
print(post)
posts = posts.next_page()
print(posts.total)
print(posts.pages)
# update a post & tag
updated_post = ghost.posts.update(post.id, title='Updated title')
updated_tag = ghost.tags.update(tag.id, name='Updated tag')
# note: creating, updating and deleting a user is not allowed by the API
# access fields as properties
print(post.title)
print(post.markdown) # needs formats='mobiledoc'
print(post.author.name) # needs include='author'
# delete a post & tag
ghost.posts.delete(post.id)
ghost.tags.delete(tag.id)
# upload an image
ghost.upload(file_obj=open('sample.png', 'rb'))
ghost.upload(file_path='/path/to/image.jpeg', 'rb')
ghost.upload(name='image.gif', data=open('local.gif', 'rb').read())
```
The logged in credentials will be saved in memory and on HTTP 401 errors the client will attempt to re-authenticate once automatically.
Responses are wrapped in `models.ModelList` and `models.Model` types to allow pagination and retrieving fields as properties.
## License
MIT