Skip to main content

Trace.moe python wrapper

Project description

TraceMoePY

Codacy Badge PyPI version Downloads Code style

Install

  • Install using pip: pip install tracemoepy

Examples

  • All the examples below are after this piece of code:
import tracemoepy
tracemoe = tracemoepy.tracemoe.TraceMoe()
  • Search image using url:
resp = tracemoe.search('https://trace.moe/img/flipped-good.jpg', is_url = True)
print(resp.prettify())
print(f"Match: {resp.result[0].anilist.title.romaji}\nSimilarity: {resp.result[0].similarity*100}")
  • Or just file path:
print(tracemoe.search('image.jpg', upload_file=True))
  • Save Video Preview:
output = tracemoe.search('https://trace.moe/img/flipped-good.jpg', is_url = True)
output.result[0].save('preview.mp4', mute = False) # True for silent
  • Save Video preview (2)
output = tracemoe.search('https://trace.moe/img/flipped-good.jpg', is_url = True)
video = tracemoe.natural_preview(output)
with open('preview.mp4', 'wb') as f:
  f.write(video)
  • Save Image Preview
output = tracemoe.search('https://trace.moe/img/flipped-good.jpg', is_url = True)
output.result[0].save(save_path = 'preview.png', preview_type="image")
  • Image Preview (Method 2)
output = tracemoe.search('https://trace.moe/img/flipped-good.jpg', is_url = True)
tracemoe.image_preview(output) # Gives content
  • You can do help(method_name) to get more info about the given method
help(tracemoe.search)

Asyncio

All the examples below assume you are running this inside a async function

  • Basic search (AioHttp session is not closed, You can access it as .aio_session)
import tracemoepy
tracemoe = tracemoepy.AsyncTrace()
resp = await tracemoe.search('https://trace.moe/img/flipped-good.jpg', is_url = True)
print(f"Match: {resp.result[0].anilist.title.romaji}\nSimilarity: {resp.result[0].similarity*100}")
  • Auto close session
import tracemoepy
async with tracemoepy.AsyncTrace() as tracemoe:
  resp = await tracemoe.search('https://trace.moe/img/flipped-good.jpg', is_url = True)
  print(f"Match: {resp.result[0].anilist.title.romaji}\nSimilarity: {resp.result[0].similarity*100}")

Errors

  • TooManyRequests: Raised when API Limit is reached or Too many requests in short period of time.
  • EntityTooLarge: Raised when image size is greater than max size of 10MB.
  • ServerError: Raised when Something wrong with the trace.moe server or Image provided was malformed.
  • InvalidToken: Raised when Invalid token was provided.
  • EmptyImage: Raised when Image provided was empty.
  • InvalidPath: Invalid path was given, This is only raised by .save(...) method
  • All these errors are located at tracemoepy.errors, Example of handling Exception:
from tracemoepy.errors import TooManyRequests

try:
  # Do something
except TooManyRequests as t:
  print(t)
  # Do something if error

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tracemoepy, version 4.1
Filename, size File type Python version Upload date Hashes
Filename, size tracemoepy-4.1.tar.gz (9.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page