searx.engines.lemmy Namespace Reference

Functions
	request (query, params)
	_get_communities (json)
	_get_users (json)
	_get_posts (json)
	_get_comments (json)
	response (resp)

Variables
dict	about
bool	paging = True
list	categories = ['social media']
str	base_url = "https://lemmy.ml/"
str	lemmy_type = "Communities"

Detailed Description

This engine uses the Lemmy API (https://lemmy.ml/api/v3/search), which is
documented at `lemmy-js-client`_ / `Interface Search`_.  Since Lemmy is
federated, results are from many different, independent lemmy instances, and not
only the official one.

.. _lemmy-js-client: https://join-lemmy.org/api/modules.html
.. _Interface Search: https://join-lemmy.org/api/interfaces/Search.html

Configuration
=============

The engine has the following additional settings:

- :py:obj:`base_url`
- :py:obj:`lemmy_type`

This implementation is used by different lemmy engines in the :ref:`settings.yml
<settings engine>`:

.. code:: yaml

  - name: lemmy communities
    lemmy_type: Communities
    ...
  - name: lemmy users
    lemmy_type: Users
    ...
  - name: lemmy posts
    lemmy_type: Posts
    ...
  - name: lemmy comments
    lemmy_type: Comments
    ...

Implementations
===============

Function Documentation

_get_comments()

searx.engines.lemmy._get_comments ( json )

protected

Definition at line 152 of file lemmy.py.

def _get_comments(json):
    results = []
 
    for result in json["comments"]:
        user = result['creator'].get('display_name', result['creator']['name'])
 
        content = result['comment'].get('content', '').strip()
        if content:
            content = markdown_to_text(content)
 
        metadata = (
            f"▲ {result['counts']['upvotes']} ▼ {result['counts']['downvotes']}"
            f" | {gettext('user')}: {user}"
            f" | {gettext('community')}: {result['community']['title']}"
        )
 
        results.append(
            {
                'url': result['comment']['ap_id'],
                'title': result['post']['name'],
                'content': markdown_to_text(result['comment']['content']),
                'publishedDate': datetime.strptime(result['comment']['published'][:19], '%Y-%m-%dT%H:%M:%S'),
                'metadata': metadata,
            }
        )
 
    return results
 
 

Referenced by searx.engines.lemmy.response().

Here is the caller graph for this function:

_get_communities()

searx.engines.lemmy._get_communities ( json )

protected

Definition at line 79 of file lemmy.py.

def _get_communities(json):
    results = []
 
    for result in json["communities"]:
        counts = result['counts']
        metadata = (
            f"{gettext('subscribers')}: {counts.get('subscribers', 0)}"
            f" | {gettext('posts')}: {counts.get('posts', 0)}"
            f" | {gettext('active users')}: {counts.get('users_active_half_year', 0)}"
        )
        results.append(
            {
                'url': result['community']['actor_id'],
                'title': result['community']['title'],
                'content': markdown_to_text(result['community'].get('description', '')),
                'thumbnail': result['community'].get('icon', result['community'].get('banner')),
                'publishedDate': datetime.strptime(counts['published'][:19], '%Y-%m-%dT%H:%M:%S'),
                'metadata': metadata,
            }
        )
    return results
 
 

Referenced by searx.engines.lemmy.response().

Here is the caller graph for this function:

_get_posts()

searx.engines.lemmy._get_posts ( json )

protected

Definition at line 117 of file lemmy.py.

def _get_posts(json):
    results = []
 
    for result in json["posts"]:
        user = result['creator'].get('display_name', result['creator']['name'])
 
        thumbnail = None
        if result['post'].get('thumbnail_url'):
            thumbnail = result['post']['thumbnail_url'] + '?format=webp&thumbnail=208'
 
        metadata = (
            f"▲ {result['counts']['upvotes']} ▼ {result['counts']['downvotes']}"
            f" | {gettext('user')}: {user}"
            f" | {gettext('comments')}: {result['counts']['comments']}"
            f" | {gettext('community')}: {result['community']['title']}"
        )
 
        content = result['post'].get('body', '').strip()
        if content:
            content = markdown_to_text(content)
 
        results.append(
            {
                'url': result['post']['ap_id'],
                'title': result['post']['name'],
                'content': content,
                'thumbnail': thumbnail,
                'publishedDate': datetime.strptime(result['post']['published'][:19], '%Y-%m-%dT%H:%M:%S'),
                'metadata': metadata,
            }
        )
 
    return results
 
 

Referenced by searx.engines.lemmy.response().

Here is the caller graph for this function:

_get_users()

searx.engines.lemmy._get_users ( json )

protected

Definition at line 102 of file lemmy.py.

def _get_users(json):
    results = []
 
    for result in json["users"]:
        results.append(
            {
                'url': result['person']['actor_id'],
                'title': result['person']['name'],
                'content': markdown_to_text(result['person'].get('bio', '')),
            }
        )
 
    return results
 
 

Referenced by searx.engines.lemmy.response().

Here is the caller graph for this function:

request()

searx.engines.lemmy.request	(		query,
			params )

Definition at line 68 of file lemmy.py.

def request(query, params):
    args = {
        'q': query,
        'page': params['pageno'],
        'type_': lemmy_type,
    }
 
    params['url'] = f"{base_url}api/v3/search?{urlencode(args)}"
    return params
 
 

response()

searx.engines.lemmy.response

(

resp

)

Definition at line 181 of file lemmy.py.

def response(resp):
    json = resp.json()
 
    if lemmy_type == "Communities":
        return _get_communities(json)
 
    if lemmy_type == "Users":
        return _get_users(json)
 
    if lemmy_type == "Posts":
        return _get_posts(json)
 
    if lemmy_type == "Comments":
        return _get_comments(json)
 
    raise ValueError(f"Unsupported lemmy type: {lemmy_type}")

References searx.engines.lemmy._get_comments(), searx.engines.lemmy._get_communities(), searx.engines.lemmy._get_posts(), and searx.engines.lemmy._get_users().

Here is the call graph for this function:

Variable Documentation

about

dict searx.engines.lemmy.about

Initial value:

=  {
    "website": 'https://lemmy.ml/',
    "wikidata_id": 'Q84777032',
    "official_api_documentation": "https://join-lemmy.org/api/",
    "use_official_api": True,
    "require_api_key": False,
    "results": 'JSON',
}

Definition at line 48 of file lemmy.py.

base_url

str searx.engines.lemmy.base_url = "https://lemmy.ml/"

Definition at line 59 of file lemmy.py.

categories

list searx.engines.lemmy.categories = ['social media']

Definition at line 57 of file lemmy.py.

lemmy_type

str searx.engines.lemmy.lemmy_type = "Communities"

Definition at line 64 of file lemmy.py.

paging

bool searx.engines.lemmy.paging = True

Definition at line 56 of file lemmy.py.