forked from platypush/platypush
Merge pull request 'Wallabag integration' (#225) from 222-wallabag-integration into master
Reviewed-on: platypush/platypush#225
This commit is contained in:
commit
3ed10092ae
6 changed files with 567 additions and 0 deletions
|
@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
|
||||||
Given the high speed of development in the first phase, changes are being
|
Given the high speed of development in the first phase, changes are being
|
||||||
reported only starting from v0.20.2.
|
reported only starting from v0.20.2.
|
||||||
|
|
||||||
|
## [Unreleased]
|
||||||
|
|
||||||
|
### Added
|
||||||
|
|
||||||
|
- Added [Wallabag integration](https://git.platypush.tech/platypush/platypush/issues/224).
|
||||||
|
|
||||||
## [0.23.6] - 2022-09-19
|
## [0.23.6] - 2022-09-19
|
||||||
|
|
||||||
### Fixed
|
### Fixed
|
||||||
|
|
5
docs/source/platypush/plugins/wallabag.rst
Normal file
5
docs/source/platypush/plugins/wallabag.rst
Normal file
|
@ -0,0 +1,5 @@
|
||||||
|
``wallabag``
|
||||||
|
============
|
||||||
|
|
||||||
|
.. automodule:: platypush.plugins.wallabag
|
||||||
|
:members:
|
|
@ -138,6 +138,7 @@ Plugins
|
||||||
platypush/plugins/user.rst
|
platypush/plugins/user.rst
|
||||||
platypush/plugins/utils.rst
|
platypush/plugins/utils.rst
|
||||||
platypush/plugins/variable.rst
|
platypush/plugins/variable.rst
|
||||||
|
platypush/plugins/wallabag.rst
|
||||||
platypush/plugins/weather.buienradar.rst
|
platypush/plugins/weather.buienradar.rst
|
||||||
platypush/plugins/weather.darksky.rst
|
platypush/plugins/weather.darksky.rst
|
||||||
platypush/plugins/weather.openweathermap.rst
|
platypush/plugins/weather.openweathermap.rst
|
||||||
|
|
405
platypush/plugins/wallabag/__init__.py
Normal file
405
platypush/plugins/wallabag/__init__.py
Normal file
|
@ -0,0 +1,405 @@
|
||||||
|
import json
|
||||||
|
import os
|
||||||
|
import pathlib
|
||||||
|
import requests
|
||||||
|
import time
|
||||||
|
|
||||||
|
from datetime import datetime, timedelta
|
||||||
|
from typing import Iterable, List, Optional
|
||||||
|
from urllib.parse import urljoin
|
||||||
|
|
||||||
|
from platypush.config import Config
|
||||||
|
from platypush.plugins import Plugin, action
|
||||||
|
from platypush.schemas.wallabag import WallabagEntrySchema
|
||||||
|
|
||||||
|
|
||||||
|
class WallabagPlugin(Plugin):
|
||||||
|
"""
|
||||||
|
Plugin to interact with Wallabag (https://wallabag.it),
|
||||||
|
an open-source alternative to Instapaper and Pocket.
|
||||||
|
"""
|
||||||
|
|
||||||
|
_default_credentials_file = os.path.join(
|
||||||
|
str(Config.get('workdir')), 'wallabag', 'credentials.json'
|
||||||
|
)
|
||||||
|
|
||||||
|
def __init__(
|
||||||
|
self,
|
||||||
|
client_id: str,
|
||||||
|
client_secret: str,
|
||||||
|
server_url: str = 'https://wallabag.it',
|
||||||
|
username: Optional[str] = None,
|
||||||
|
password: Optional[str] = None,
|
||||||
|
credentials_file: str = _default_credentials_file,
|
||||||
|
**kwargs,
|
||||||
|
):
|
||||||
|
"""
|
||||||
|
:param client_id: Client ID for your application - you can create one
|
||||||
|
at ``<server_url>/developer``.
|
||||||
|
:param client_secret: Client secret for your application - you can
|
||||||
|
create one at ``<server_url>/developer``.
|
||||||
|
:param server_url: Base URL of the Wallabag server (default: ``https://wallabag.it``).
|
||||||
|
:param username: Wallabag username. Only needed for the first login,
|
||||||
|
you can remove it afterwards. Alternatively, you can provide it
|
||||||
|
on the :meth:`.login` method.
|
||||||
|
:param password: Wallabag password. Only needed for the first login,
|
||||||
|
you can remove it afterwards. Alternatively, you can provide it
|
||||||
|
on the :meth:`.login` method.
|
||||||
|
:param credentials_file: Path to the file where the OAuth session
|
||||||
|
parameters will be stored (default:
|
||||||
|
``<WORKDIR>/wallabag/credentials.json``).
|
||||||
|
"""
|
||||||
|
super().__init__(**kwargs)
|
||||||
|
self._client_id = client_id
|
||||||
|
self._client_secret = client_secret
|
||||||
|
self._server_url = server_url
|
||||||
|
self._username = username
|
||||||
|
self._password = password
|
||||||
|
self._credentials_file = os.path.expanduser(credentials_file)
|
||||||
|
self._session = {}
|
||||||
|
|
||||||
|
def _oauth_open_saved_session(self):
|
||||||
|
try:
|
||||||
|
with open(self._credentials_file, 'r') as f:
|
||||||
|
data = json.load(f)
|
||||||
|
except Exception as e:
|
||||||
|
self.logger.warning('Could not load %s: %s', self._credentials_file, e)
|
||||||
|
return
|
||||||
|
|
||||||
|
self._session = {
|
||||||
|
'username': data['username'],
|
||||||
|
'client_id': data.get('client_id', self._client_id),
|
||||||
|
'client_secret': data.get('client_secret', self._client_secret),
|
||||||
|
'access_token': data['access_token'],
|
||||||
|
'refresh_token': data['refresh_token'],
|
||||||
|
}
|
||||||
|
|
||||||
|
if data.get('expires_at') and time.time() > data['expires_at']:
|
||||||
|
self.logger.info('OAuth token expired, refreshing it')
|
||||||
|
self._oauth_refresh_token()
|
||||||
|
|
||||||
|
def _oauth_refresh_token(self):
|
||||||
|
url = urljoin(self._server_url, '/oauth/v2/token')
|
||||||
|
rs = requests.post(
|
||||||
|
url,
|
||||||
|
json={
|
||||||
|
'grant_type': 'refresh_token',
|
||||||
|
'client_id': self._client_id,
|
||||||
|
'client_secret': self._client_secret,
|
||||||
|
'access_token': self._session['access_token'],
|
||||||
|
'refresh_token': self._session['refresh_token'],
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
rs.raise_for_status()
|
||||||
|
rs = rs.json()
|
||||||
|
self._session.update(
|
||||||
|
{
|
||||||
|
'access_token': rs['access_token'],
|
||||||
|
'refresh_token': rs['refresh_token'],
|
||||||
|
'expires_at': (
|
||||||
|
int(
|
||||||
|
(
|
||||||
|
datetime.now() + timedelta(seconds=rs['expires_in'])
|
||||||
|
).timestamp()
|
||||||
|
)
|
||||||
|
if rs.get('expires_in')
|
||||||
|
else None
|
||||||
|
),
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
self._oauth_flush_session()
|
||||||
|
|
||||||
|
def _oauth_create_new_session(self, username: str, password: str):
|
||||||
|
url = urljoin(self._server_url, '/oauth/v2/token')
|
||||||
|
rs = requests.post(
|
||||||
|
url,
|
||||||
|
json={
|
||||||
|
'grant_type': 'password',
|
||||||
|
'client_id': self._client_id,
|
||||||
|
'client_secret': self._client_secret,
|
||||||
|
'username': username,
|
||||||
|
'password': password,
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
rs.raise_for_status()
|
||||||
|
rs = rs.json()
|
||||||
|
self._session = {
|
||||||
|
'client_id': self._client_id,
|
||||||
|
'client_secret': self._client_secret,
|
||||||
|
'username': username,
|
||||||
|
'access_token': rs['access_token'],
|
||||||
|
'refresh_token': rs['refresh_token'],
|
||||||
|
'expires_at': (
|
||||||
|
int((datetime.now() + timedelta(seconds=rs['expires_in'])).timestamp())
|
||||||
|
if rs.get('expires_in')
|
||||||
|
else None
|
||||||
|
),
|
||||||
|
}
|
||||||
|
|
||||||
|
self._oauth_flush_session()
|
||||||
|
|
||||||
|
def _oauth_flush_session(self):
|
||||||
|
pathlib.Path(self._credentials_file).parent.mkdir(parents=True, exist_ok=True)
|
||||||
|
|
||||||
|
pathlib.Path(self._credentials_file).touch(mode=0o600, exist_ok=True)
|
||||||
|
with open(self._credentials_file, 'w') as f:
|
||||||
|
f.write(json.dumps(self._session))
|
||||||
|
|
||||||
|
@action
|
||||||
|
def login(self, username: Optional[str] = None, password: Optional[str] = None):
|
||||||
|
"""
|
||||||
|
Create a new user session if not logged in.
|
||||||
|
|
||||||
|
:param username: Default ``username`` override.
|
||||||
|
:param password: Default ``password`` override.
|
||||||
|
"""
|
||||||
|
self._oauth_open_saved_session()
|
||||||
|
if self._session:
|
||||||
|
return
|
||||||
|
|
||||||
|
username = username or self._username
|
||||||
|
password = password or self._password
|
||||||
|
assert (
|
||||||
|
username and password
|
||||||
|
), 'No stored user session and no username/password provided'
|
||||||
|
|
||||||
|
self._oauth_create_new_session(username, password)
|
||||||
|
|
||||||
|
def _request(self, url: str, method: str, *args, as_json=True, **kwargs):
|
||||||
|
url = urljoin(self._server_url, f'api/{url}')
|
||||||
|
func = getattr(requests, method.lower())
|
||||||
|
self.login()
|
||||||
|
kwargs['headers'] = {
|
||||||
|
**kwargs.get('headers', {}),
|
||||||
|
'Authorization': f'Bearer {self._session["access_token"]}',
|
||||||
|
}
|
||||||
|
|
||||||
|
rs = func(url, *args, **kwargs)
|
||||||
|
rs.raise_for_status()
|
||||||
|
return rs.json() if as_json else rs.text
|
||||||
|
|
||||||
|
@action
|
||||||
|
def list(
|
||||||
|
self,
|
||||||
|
archived: bool = True,
|
||||||
|
starred: bool = False,
|
||||||
|
sort: str = 'created',
|
||||||
|
descending: bool = False,
|
||||||
|
page: int = 1,
|
||||||
|
limit: int = 30,
|
||||||
|
tags: Optional[Iterable[str]] = None,
|
||||||
|
since: Optional[int] = None,
|
||||||
|
full: bool = True,
|
||||||
|
) -> List[dict]:
|
||||||
|
"""
|
||||||
|
List saved links.
|
||||||
|
|
||||||
|
:param archived: Include archived items (default: ``True``).
|
||||||
|
:param starred: Include only starred items (default: ``False``).
|
||||||
|
:param sort: Timestamp sort criteria. Supported: ``created``,
|
||||||
|
``updated``, ``archived`` (default: ``created``).
|
||||||
|
:param descending: Sort in descending order (default: ``False``).
|
||||||
|
:param page: Results page to be retrieved (default: ``1``).
|
||||||
|
:param limit: Maximum number of entries per page (default: ``30``).
|
||||||
|
:param tags: Filter by a list of tags.
|
||||||
|
:param since: Return entries created after this timestamp (as a UNIX
|
||||||
|
timestamp).
|
||||||
|
:param full: Include the full parsed body of the saved entry.
|
||||||
|
:return: .. schema:: wallabag.WallabagEntrySchema(many=True)
|
||||||
|
"""
|
||||||
|
rs = self._request(
|
||||||
|
'/entries.json',
|
||||||
|
method='get',
|
||||||
|
params={
|
||||||
|
'archived': int(archived),
|
||||||
|
'starred': int(starred),
|
||||||
|
'sort': sort,
|
||||||
|
'order': 'desc' if descending else 'asc',
|
||||||
|
'page': page,
|
||||||
|
'perPage': limit,
|
||||||
|
'tags': ','.join(tags or []),
|
||||||
|
'since': since or 0,
|
||||||
|
'detail': 'full' if full else 'metadata',
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
return WallabagEntrySchema().dump(
|
||||||
|
rs.get('_embedded', {}).get('items', []), many=True
|
||||||
|
)
|
||||||
|
|
||||||
|
@action
|
||||||
|
def search(
|
||||||
|
self,
|
||||||
|
term: str,
|
||||||
|
page: int = 1,
|
||||||
|
limit: int = 30,
|
||||||
|
) -> List[dict]:
|
||||||
|
"""
|
||||||
|
Search links by some text.
|
||||||
|
|
||||||
|
:param term: Term to be searched.
|
||||||
|
:param page: Results page to be retrieved (default: ``1``).
|
||||||
|
:param limit: Maximum number of entries per page (default: ``30``).
|
||||||
|
:return: .. schema:: wallabag.WallabagEntrySchema(many=True)
|
||||||
|
"""
|
||||||
|
rs = self._request(
|
||||||
|
'/search.json',
|
||||||
|
method='get',
|
||||||
|
params={
|
||||||
|
'term': term,
|
||||||
|
'page': page,
|
||||||
|
'perPage': limit,
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
return WallabagEntrySchema().dump(
|
||||||
|
rs.get('_embedded', {}).get('items', []), many=True
|
||||||
|
)
|
||||||
|
|
||||||
|
@action
|
||||||
|
def get(self, id: int) -> Optional[dict]:
|
||||||
|
"""
|
||||||
|
Get the content and metadata of a link by ID.
|
||||||
|
|
||||||
|
:param id: Entry ID.
|
||||||
|
:return: .. schema:: wallabag.WallabagEntrySchema
|
||||||
|
"""
|
||||||
|
rs = self._request(f'/entries/{id}.json', method='get')
|
||||||
|
return WallabagEntrySchema().dump(rs) # type: ignore
|
||||||
|
|
||||||
|
@action
|
||||||
|
def export(self, id: int, file: str, format: str = 'txt'):
|
||||||
|
"""
|
||||||
|
Export a saved entry to a file in the specified format.
|
||||||
|
|
||||||
|
:param id: Entry ID.
|
||||||
|
:param file: Output filename.
|
||||||
|
:param format: Output format. Supported: ``txt``, ``xml``, ``csv``,
|
||||||
|
``pdf``, ``epub`` and ``mobi`` (default: ``txt``).
|
||||||
|
"""
|
||||||
|
rs = self._request(
|
||||||
|
f'/entries/{id}/export.{format}', method='get', as_json=False
|
||||||
|
)
|
||||||
|
|
||||||
|
if isinstance(rs, str):
|
||||||
|
rs = rs.encode()
|
||||||
|
with open(os.path.expanduser(file), 'wb') as f:
|
||||||
|
f.write(rs)
|
||||||
|
|
||||||
|
@action
|
||||||
|
def save(
|
||||||
|
self,
|
||||||
|
url: str,
|
||||||
|
title: Optional[str] = None,
|
||||||
|
content: Optional[str] = None,
|
||||||
|
tags: Optional[Iterable[str]] = None,
|
||||||
|
authors: Optional[Iterable[str]] = None,
|
||||||
|
archived: bool = False,
|
||||||
|
starred: bool = False,
|
||||||
|
public: bool = False,
|
||||||
|
language: Optional[str] = None,
|
||||||
|
preview_picture: Optional[str] = None,
|
||||||
|
) -> Optional[dict]:
|
||||||
|
"""
|
||||||
|
Save a link to Wallabag.
|
||||||
|
|
||||||
|
:param url: URL to be saved.
|
||||||
|
:param title: Entry title (default: parsed from the page content).
|
||||||
|
:param content: Entry content (default: parsed from the entry itself).
|
||||||
|
:param tags: List of tags to attach to the entry.
|
||||||
|
:param authors: List of authors of the entry (default: parsed from the
|
||||||
|
page content).
|
||||||
|
:param archived: Whether the entry should be created in the archive
|
||||||
|
(default: ``False``).
|
||||||
|
:param starred: Whether the entry should be starred (default:
|
||||||
|
``False``).
|
||||||
|
:param public: Whether the entry should be publicly available. If so, a
|
||||||
|
public URL will be generated (default: ``False``).
|
||||||
|
:param language: Language of the entry.
|
||||||
|
:param preview_picture: URL of a picture to be used for the preview
|
||||||
|
(default: parsed from the page itself).
|
||||||
|
:return: .. schema:: wallabag.WallabagEntrySchema
|
||||||
|
"""
|
||||||
|
rs = self._request(
|
||||||
|
'/entries.json',
|
||||||
|
method='post',
|
||||||
|
json={
|
||||||
|
'url': url,
|
||||||
|
'title': title,
|
||||||
|
'content': content,
|
||||||
|
'tags': ','.join(tags or []),
|
||||||
|
'authors': ','.join(authors or []),
|
||||||
|
'archive': int(archived),
|
||||||
|
'starred': int(starred),
|
||||||
|
'public': int(public),
|
||||||
|
'language': language,
|
||||||
|
'preview_picture': preview_picture,
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
return WallabagEntrySchema().dump(rs) # type: ignore
|
||||||
|
|
||||||
|
@action
|
||||||
|
def update(
|
||||||
|
self,
|
||||||
|
id: int,
|
||||||
|
title: Optional[str] = None,
|
||||||
|
content: Optional[str] = None,
|
||||||
|
tags: Optional[Iterable[str]] = None,
|
||||||
|
authors: Optional[Iterable[str]] = None,
|
||||||
|
archived: bool = False,
|
||||||
|
starred: bool = False,
|
||||||
|
public: bool = False,
|
||||||
|
language: Optional[str] = None,
|
||||||
|
preview_picture: Optional[str] = None,
|
||||||
|
) -> Optional[dict]:
|
||||||
|
"""
|
||||||
|
Update a link entry saved to Wallabag.
|
||||||
|
|
||||||
|
:param id: Entry ID.
|
||||||
|
:param title: New entry title.
|
||||||
|
:param content: New entry content.
|
||||||
|
:param tags: List of tags to attach to the entry.
|
||||||
|
:param authors: List of authors of the entry.
|
||||||
|
:param archived: Archive/unarchive the entry.
|
||||||
|
:param starred: Star/unstar the entry.
|
||||||
|
:param public: Mark the entry as public/private.
|
||||||
|
:param language: Change the language of the entry.
|
||||||
|
:param preview_picture: Change the preview picture URL.
|
||||||
|
:return: .. schema:: wallabag.WallabagEntrySchema
|
||||||
|
"""
|
||||||
|
rs = self._request(
|
||||||
|
f'/entries/{id}.json',
|
||||||
|
method='patch',
|
||||||
|
json={
|
||||||
|
'title': title,
|
||||||
|
'content': content,
|
||||||
|
'tags': ','.join(tags or []),
|
||||||
|
'authors': ','.join(authors or []),
|
||||||
|
'archive': int(archived),
|
||||||
|
'starred': int(starred),
|
||||||
|
'public': int(public),
|
||||||
|
'language': language,
|
||||||
|
'preview_picture': preview_picture,
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
return WallabagEntrySchema().dump(rs) # type: ignore
|
||||||
|
|
||||||
|
@action
|
||||||
|
def delete(self, id: int) -> Optional[dict]:
|
||||||
|
"""
|
||||||
|
Delete an entry by ID.
|
||||||
|
|
||||||
|
:param id: Entry ID.
|
||||||
|
:return: .. schema:: wallabag.WallabagEntrySchema
|
||||||
|
"""
|
||||||
|
rs = self._request(
|
||||||
|
f'/entries/{id}.json',
|
||||||
|
method='delete',
|
||||||
|
)
|
||||||
|
|
||||||
|
return WallabagEntrySchema().dump(rs) # type: ignore
|
3
platypush/plugins/wallabag/manifest.yaml
Normal file
3
platypush/plugins/wallabag/manifest.yaml
Normal file
|
@ -0,0 +1,3 @@
|
||||||
|
manifest:
|
||||||
|
package: platypush.plugins.wallabag
|
||||||
|
type: plugin
|
147
platypush/schemas/wallabag.py
Normal file
147
platypush/schemas/wallabag.py
Normal file
|
@ -0,0 +1,147 @@
|
||||||
|
from marshmallow import Schema, fields
|
||||||
|
|
||||||
|
from platypush.schemas import DateTime
|
||||||
|
|
||||||
|
|
||||||
|
class WallabagSchema(Schema):
|
||||||
|
pass
|
||||||
|
|
||||||
|
|
||||||
|
class WallabagAnnotationSchema(WallabagSchema):
|
||||||
|
id = fields.Integer(
|
||||||
|
required=True,
|
||||||
|
dump_only=True,
|
||||||
|
metadata={'example': 2345},
|
||||||
|
)
|
||||||
|
|
||||||
|
text = fields.String(
|
||||||
|
attribute='quote',
|
||||||
|
metadata={
|
||||||
|
'example': 'Some memorable quote',
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
comment = fields.String(
|
||||||
|
attribute='text',
|
||||||
|
metadata={
|
||||||
|
'example': 'My comment on this memorable quote',
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
ranges = fields.Function(
|
||||||
|
lambda data: [
|
||||||
|
[int(r['startOffset']), int(r['endOffset'])] for r in data.get('ranges', [])
|
||||||
|
],
|
||||||
|
metadata={
|
||||||
|
'example': [[100, 180]],
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
created_at = DateTime(
|
||||||
|
metadata={
|
||||||
|
'description': 'When the annotation was created',
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
updated_at = DateTime(
|
||||||
|
metadata={
|
||||||
|
'description': 'When the annotation was last updated',
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
class WallabagEntrySchema(WallabagSchema):
|
||||||
|
id = fields.Integer(
|
||||||
|
required=True,
|
||||||
|
dump_only=True,
|
||||||
|
metadata={'example': 1234},
|
||||||
|
)
|
||||||
|
|
||||||
|
url = fields.URL(
|
||||||
|
required=True,
|
||||||
|
metadata={
|
||||||
|
'description': 'Original URL',
|
||||||
|
'example': 'https://example.com/article/some-title',
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
preview_picture = fields.URL(
|
||||||
|
metadata={
|
||||||
|
'description': 'Preview picture URL',
|
||||||
|
'example': 'https://example.com/article/some-title.jpg',
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
is_archived = fields.Boolean()
|
||||||
|
is_starred = fields.Boolean()
|
||||||
|
is_public = fields.Boolean()
|
||||||
|
mimetype = fields.String(
|
||||||
|
metadata={
|
||||||
|
'example': 'text/html',
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
title = fields.String(
|
||||||
|
metadata={
|
||||||
|
'description': 'Title of the saved page',
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
content = fields.String(
|
||||||
|
metadata={
|
||||||
|
'description': 'Parsed content',
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
language = fields.String(
|
||||||
|
metadata={
|
||||||
|
'example': 'en',
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
annotations = fields.List(fields.Nested(WallabagAnnotationSchema))
|
||||||
|
|
||||||
|
published_by = fields.List(
|
||||||
|
fields.String,
|
||||||
|
metadata={
|
||||||
|
'example': ['Author 1', 'Author 2'],
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
tags = fields.Function(
|
||||||
|
lambda data: [tag['label'] for tag in data.get('tags', [])],
|
||||||
|
metadata={
|
||||||
|
'example': ['tech', 'programming'],
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
reading_time = fields.Integer(
|
||||||
|
metadata={
|
||||||
|
'description': 'Estimated reading time, in minutes',
|
||||||
|
'example': 10,
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
created_at = DateTime(
|
||||||
|
metadata={
|
||||||
|
'description': 'When the entry was created',
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
updated_at = DateTime(
|
||||||
|
metadata={
|
||||||
|
'description': 'When the entry was last updated',
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
starred_at = DateTime(
|
||||||
|
metadata={
|
||||||
|
'description': 'If the entry is starred, when was it last marked',
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
published_at = DateTime(
|
||||||
|
metadata={
|
||||||
|
'description': 'When the entry was initially published',
|
||||||
|
},
|
||||||
|
)
|
Loading…
Reference in a new issue