bloom-api v1.0.0
Getting started
Bloom API
How to Build
The generated SDK relies on Node Package Manager (NPM) being available to resolve dependencies. If you don't already have NPM installed, please go ahead and follow instructions to install NPM from here. The SDK also requires Node to be installed. If Node isn't already installed, please install it from here
NPM is installed by default when Node is installed
To check if node and npm have been successfully installed, write the following commands in command prompt:
node --version
npm -version
Now use npm to resolve all dependencies by running the following command in the root directory (of the SDK folder):
npm install
This will install all dependencies in the node_modules
folder.
Once dependencies are resolved, you will need to move the folder Bloom
in to your node_modules
folder.
How to Use
The following section explains how to use the library in a new project.
1. Open Project Folder
Open an IDE/Text Editor for JavaScript like Sublime Text. The basic workflow presented here is also applicable if you prefer using a different editor or IDE.
Click on File
and select Open Folder
.
Select the folder of your SDK and click on Select Folder
to open it up in Sublime Text. The folder will become visible in the bar on the left.
2. Creating a Test File
Now right click on the folder name and select the New File
option to create a new test file. Save it as index.js
Now import the generated NodeJS library using the following lines of code:
var lib = require('lib');
Save changes.
3. Running The Test File
To run the index.js
file, open up the command prompt and navigate to the Path where the SDK folder resides. Type the following command to run the file:
node index.js
How to Test
These tests use Mocha framework for testing, coupled with Chai for assertions. These dependencies need to be installed for tests to run. Tests can be run in a number of ways:
Method 1 (Run all tests)
- Navigate to the root directory of the SDK folder from command prompt.
- Type
mocha --recursive
to run all the tests.
Method 2 (Run all tests)
- Navigate to the
../test/Controllers/
directory from command prompt. - Type
mocha *
to run all the tests.
Method 3 (Run specific controller's tests)
- Navigate to the
../test/Controllers/
directory from command prompt. - Type
mocha BloomController
to run all the tests in that controller file.
To increase mocha's default timeout, you can change the
TEST_TIMEOUT
parameter's value inTestBootstrap.js
.
Initialization
API client can be initialized as following:
const lib = require('lib');
Class Reference
List of Controllers
HinaController
Get singleton instance
The singleton instance of the HinaController
class can be accessed from the API Client.
var controller = lib.HinaController;
getResize
Gets Resized image of album from db
function getResize(width, height, id, num, callback)
Parameters
Parameter | Tags | Description |
---|---|---|
width | Required | Output Width (Optional) |
height | Required | Output Height (Optional) |
id | Required | Path param id of the album |
num | Required | Which Image to resize |
Example Usage
var width = 215;
var height = 215;
var id = 'id';
var num = 215;
controller.getResize(width, height, id, num, function(error, response, context) {
});
getAlbum
Gets Album from db
function getAlbum(id, callback)
Parameters
Parameter | Tags | Description |
---|---|---|
id | Required | Id of the album |
Example Usage
var id = 'OQl0Cp';
controller.getAlbum(id, function(error, response, context) {
});
getPagination
Get's Pagination data from db
function getPagination(op, page, source, idol, callback)
Parameters
Parameter | Tags | Description |
---|---|---|
op | Required | Number of items per page |
page | Required | Page |
source | Optional | Source filter, use comma to use multiple source as filter |
idol | Optional | idol Filter, use comma to use multiple idol as filter |
Example Usage
var op = 30;
var page = 1;
var source = 'source';
var idol = 'idol';
controller.getPagination(op, page, source, idol, function(error, response, context) {
});
search
Gets Text query data from db
Strict Termed Searches are to be made with a double quote
eg: "Skinny"
Exclusion are to be made in this format after any prefilter
eg: "thick" ~"skinny"
function search(page, query, op, source, idol, callback)
Parameters
Parameter | Tags | Description |
---|---|---|
page | Required | Page number |
query | Required | search term |
op | Optional | Number of items per page |
source | Optional | Source filter, use comma to use multiple source as filter |
idol | Optional | idol Filter, use comma to use multiple idol as filter |
Example Usage
var page = 1;
var query = 'blonde';
var op = 50;
var source = 'source';
var idol = 'idol';
controller.search(page, query, op, source, idol, function(error, response, context) {
});
getSources
Gets a List of sources Hina Supports
function getSources(callback)
Example Usage
controller.getSources(function(error, response, context) {
});
getIdol
Get List of Idols/Artists
function getIdol(callback)
Example Usage
controller.getIdol(function(error, response, context) {
});
getThumb
Gets Thumb of the album
function getThumb(id, callback)
Parameters
Parameter | Tags | Description |
---|---|---|
id | Required | TODO: Add a parameter description |
Example Usage
var id = 'id';
controller.getThumb(id, function(error, response, context) {
});
getRandom
Gets Random Album/s
function getRandom(many, callback)
Parameters
Parameter | Tags | Description |
---|---|---|
many | Required DefaultValue | gets many albums |
Example Usage
var many = true;
controller.getRandom(many, function(error, response, context) {
});
3 years ago