1.0.4 • Published 4 months ago

emoxy v1.0.4

Weekly downloads
-
License
MIT
Repository
github
Last release
4 months ago

EMOXY👀 - A Javascript API wrapper for Emojihub

Emoxy is a Javascript library for interacting with the Emojihub API.

Installation

npm install emoxy

Usage

Import the library:

//using require() syntax 
const emoxy = require("emoxy");

//using imports
import {} from 'emoxy'

getAllEmojis()

import {getAllEmojis} from 'emoxy'
const allEmojis = await getAllEmojis();

/* returns an object
{
    code:200,
    emojis:[...],
    message:success
}
*/

getAllCategories

import {getAllCategories} from 'emoxy';
const categories = getAllCategories()
/*returns an array
  
   [
     {
       name:'',
       group:[...]
     },
     ...
  ]
  
  
*/

getSpecificGroups

Returns the group names that are found that said category. can be used to get arguments to be used with getAllEmojisInGroup() or getRandomEmojiInGroup

import {getSpecificGroups} from 'emoxy';
const group = getSpecificGroups('category')

getAllEmojisInCategory

import {getAllEmojisInCategories} from 'emoxy';
const emojis = getAllEmojisInCategories('category')

/* returns an object
{
    code:200,
    emojis:[...],
    message:success
}
*/
  

getRandomEmojiInCategory

import {getRandomEmojiInCategory} from 'emoxy';
const emoji = getRandomEmojiInCategory('category')

/* returns an object
{
    code:200,
    emoji:{...},
    message:success
}
*/
  

getAllEmojisInGroup

import {getAllEmojisInGroup} from 'emoxy';
const emojis = getAllEmojisInGroup('group')

/* returns an object
{
    code:200,
    emojis:[...],
    message:success
}
*/
  

getRandomEmojiInGroup

import {getRandomEmojiInGroup} from 'emoxy';
const emoji = getRandomEmojiInGroup('group')

/* returns an object
{
    code:200,
    emoji:{...},
    message:success
}
*/
  

Types definitions (for typescript users)

 type EmoxyEmojiCategory =
	| "smileys-and-people"
	| "animals-and-nature"
	| "food-and-drink"
	| "travel-and-places"
	| "activichties"
	| "objects"
	| "symbols"
	| "flags";

 type EmoxyEmoji = {
	name: string;
	category: string;
	group: string;
	htmlCode: string[];
	unicode: string[];
};



 type EmoxyResponseGroup = {
	code: number;
	message: string;
	emojis: EmoxyEmoji[] | null;
};
 type EmoxyResponse = {
	code: number;
	message: string;
	emoji: EmoxyEmoji | null;
};

This project was built using:

  • Typescript
  • Bun

Appreciation

Thanks to the original API from Emojihub

Contributing

  1. CLone the repo
git clone https://github.com/michaelnji/emoxy.git
  1. install dependencies
bun install
  1. To run the server
bun dev
  1. To run tests
bun run test
  1. To build for production
bun run build
1.0.4

4 months ago

1.0.3

4 months ago

1.0.2

4 months ago

1.0.0

4 months ago