X.nim

A X(Formally known as Twitter) API wrapper library for Nim. Inspired by Tweepy and twitter.nim.

Be aware I only free-tier API access to the X API so I will only develop for those endpoints.

This uses OAuth 1.0a.

Endpoints supported:

• POST v2/tweets
• POST media/upload

Install

git clone https://github.com/aspiring-aster/x.nim.git
cd x.nim
nimble install

Example

import xnim

when isMainModule:

  # This is API Key
  const CONSUMER_KEY: string = "CONSUMERKEY"

  # This is the API secret key
  const CONSUMER_SECRET: string = "CONSUMERSECRET"

  # This is the Authentication Access Token
  const ACCESS_TOKEN: string = "ACCESSTOKEN"

  # This is the Authentication Access Secret
  const TOKEN_SECRET: string = "TOKENSECRET"

  const xCli: XAPI = newXAPI(CONSUMER_KEY, CONSUMER_SECRET, ACCESS_TOKEN, TOKEN_SECRET)
  let res: string = xCli.PostTextTweet("Hello from X.nim!")
  echo res

Look at the OMORI upscale bot as an example for how to use this API to deploy a bot on Twitter.

Dependencies

• nimcrypto - For SHA1-HMAC encoding to encode signature

RoadMap:

• Add a better way to read credentials
• Expand POST /v2/tweets
• Maybe look into basic tier endpoints