pict-url
v0.3.0
Published
A basic package in order to get random image from a subreddit using imgur. Everything is entirely customisable, from the source URL to the image link formater. More explanations are available on GitHub.
Downloads
6
Readme
Pict-URL
What is it ?
Pict-URL
is a basic package in order to get random image from a subreddit using imgur. Everything is entirely customisable, from the source URL to the image link formater.
Table of Contents
Installation
You can install it using Node Package Manager :
npm install pict-url
How to use Pict-URL
Pict-URL
should normally be fully JS-Doc-ed in your editor, for ease and convenience.
Here is a short example :
// Importing pict-url's module
const pictURL = require('pict-url');
// Getting the default Provider
const Imgur = pictURL.Provider.Imgur;
// Creating a basic new Client instance
const Client = new pictURL.Client(Imgur);
// Get an image by tag
let category = "doggos";
let imageLink = "";
Client.getImage(category).then((image) => {
// Image is a basic object
imageLink = image.url;
});
You can switch a Client's Provider in real time. To do so, take this as an example :
// Importing pict-url's module
const pictURL = require('pict-url');
// Setting our own Provider
const categoriesURL = "https://imgur.com/r/{{category}}/hot.json";
const urlGetter = function (resp) {
let res = JSON.parse(resp);
let img = res.data[Math.round(Math.random() * res.data.length)];
let url = `http://imgur.com/${img.hash}${img.ext.replace(/\?.*/, '')}`;
return url;
};
const myAwesomeProvider = new pictURL.Provider(categoriesURL, urlGetter);
// Getting the default Provider
const Imgur = pictURL.Provider.Imgur;
// Creating a basic new Client instance using Imgur
const Client = new pictURL.Client(Imgur);
// Saving our tag as a variable
let category = "doggos";
let imageLink = "";
// Getting an image on the first provider
Client.getImage(category).then((image) => {
// Image is a basic object
imageLink = image.url;
});
// Changing Provider
Client.provider = myAwesomeProvider;
// Getting an image on the second provider
Client.getImage(category).then((image) => {
// Image is a basic object
imageLink = image.url;
});
A more advanced use of Pict-URL
will be shown in Customisation
Examples :
Customization
As you create a new Pict-URL Client instance, you must provide it a Provider to use. Providers are instance-sensitive : it means that each Client instance uses its own Provider independently of others instances running in the process.
These Providers are based on options called ProviderOptions
, which is basically an object, represented by these properties :
categoriesURL? : string;
urlGetter? : (response : CategoriesURLResponse) => string;
It makes you able to change all the images's source easily but keep in mind that it can break fastly if you're not aware of what to do with these properties.
If you want to change image's source using this feature, you can go to this file for more explanation.