trilium-client

This is an auto-generated client for Trilium Notes. It builds an API client using the etapi.openapi.yaml provided by Trilium.

The generated trilium_client, docs, and README.md artifacts are packaged and many unused files are ignored.

To install, run:

pip install trilium-client

To build, activate a shell: (recommended)

poetry shell

Then run:

poetry install --with=dev
scons

To clean, run:

scons --clean

Following is the README produced by the generator.

trilium-client

External Trilium API

This Python package is automatically generated by the OpenAPI Generator project:

• API version: 1.0.0
• Package version: 1.0.0
• Generator version: 7.24.0-SNAPSHOT
• Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://triliumnotes.org

Requirements.

Python 3.10+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/mm21/trilium-client.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/mm21/trilium-client.git)

Then import the package:

import trilium_client

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import trilium_client

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import trilium_client
from trilium_client.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to http://localhost:37740/etapi
# See configuration.py for a list of all supported configuration parameters.
configuration = trilium_client.Configuration(
    host = "http://localhost:37740/etapi"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure API key authorization: EtapiTokenAuth
configuration.api_key['EtapiTokenAuth'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['EtapiTokenAuth'] = 'Bearer'

# Configure HTTP basic authorization: EtapiBasicAuth
configuration = trilium_client.Configuration(
    username = os.environ["USERNAME"],
    password = os.environ["PASSWORD"]
)


# Enter a context with an instance of the API client
with trilium_client.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = trilium_client.DefaultApi(api_client)
    backup_name = 'backup_name_example' # str | If the backupName is e.g. \"now\", then the backup will be written to \"backup-now.db\" file

    try:
        api_instance.create_backup(backup_name)
    except ApiException as e:
        print("Exception when calling DefaultApi->create_backup: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to http://localhost:37740/etapi

Documentation For Models

• AppInfo
• Attachment
• Attribute
• Branch
• CreateAttachment
• CreateNoteDef
• Error
• Login201Response
• LoginRequest
• Note
• NoteWithBranch
• RecentChange
• Revision
• SearchResponse
• UndeleteNote200Response

Documentation For Authorization

Authentication schemes defined for the API:

EtapiTokenAuth

• Type: API key
• API key parameter name: Authorization
• Location: HTTP header

EtapiBasicAuth

• Type: HTTP basic authentication

Author

contact@eliandoran.me