tm_client

TwineMedia API client library for Nim

Pure Nim score 15/100 · tests present · no docs generated

Summary

Latest Version	Unknown
License	MIT
CI Status	Failing
Downloads	0
Last Indexed	2026-07-21 05:24

Installation

nimble install tm_client

choosenim install tm_client

git clone https://github.com/termermc/nim-tm-client

OS Compatibility

Platform	Linux	macOS	Windows	FreeBSD	OpenBSD	NetBSD	Android	iOS	WASM	Embedded
tm_client	✓	✓	✓	-	-	-	-	-	-	-

Source

Repository	https://github.com/termermc/nim-tm-client
Homepage	https://github.com/termermc/nim-tm-client
Registry Source	nimble_official

README

nim-tm-client

Asychronous API client library for TwineMedia for Nim

Include in your project by importing "tm_client".

Examples

Authenticate with a token:

import tm_client
import asyncdispatch
import strformat

const root = "https://your.tm.instance"
const token = "YOUR_TOKEN_HERE"

proc main() {.async.} =
    # Create client
    let client = newClientFromToken(root, token)

    # Optionally fetch client account info
    let info = await client.fetchSelfAccountInfo()

    echo fmt"Account name is: {info.name}, and email is: {info.email}"

# Wait for async code
waitFor main()

Authenticate with email and password:

import tm_client
import asyncdispatch
import strformat

const root = "https://your.tm.instance"
const email = "me@example.com"
const password = "drowssap"

proc main() {.async.} =
    # Create client with credentials
    let client = await newClientFromCredentials(root, email, password)

    # Optionally fetch client account info
    let info = await client.fetchSelfAccountInfo()

    echo fmt"Account name is: {info.name}, and email is: {info.email}"

# Wait for async code
waitFor main()

Fetch first 3 uploaded files:

import tm_client
import tm_client/enum
import asyncdispatch
import strformat

# ...Client creation code, etc...

let media = await client.fetchMedia(limit = 3, order = MediaCreatedOnAsc)

for file in media:
    echo fmt"Name: {file.name}, size: {file.size}"