arrow-left

Only this pageAll pages
gitbookPowered by GitBook
1 of 10

main

Loading...

Examples

Loading...

Loading...

Documentation

Loading...

Loading...

Loading...

Misc

Loading...

Introduction

arrow-up-right

This is the official documentation for some-random-cat. Docs version (v2.0)

hashtag
Installation

To install the package, you would have to make sure that node.js is installed on your machine. After that, you can simply do npm i some-random-cat in the terminal where you want to install the package or npm i some-random-cat -g to install it globally.

hashtag
About

I saw that there were not many good packages for generating random stuff. So I decided to make one. A very suitable API to generate random images of cats, dogs and random jokes, facts... A lot more!

hashtag
Why?

  • Object-oriented

  • Speedy and efficient

  • Feature-rich

hashtag
Example

Generate a random cat image:

hashtag
Statistics

  • 200 weekly downloads

  • and... growing!

Random Cat Image

An example of how to generate a random cat image!

hashtag
Code

hashtag
Output

Easy
  • Beginner-Friendly

  • Flexible

  • Randomchevron-right
    // This snippet uses some-random-cat version 2.0
    
    const somethingRandom = require('some-random-cat').Random
    somethingRandom.getCat()
    .then(res => {
        console.log(res)
        return
    }) // Get the result
    .catch(e => {
        console.error(e)
        return
    }) // Catch the error
    const somethingRandom = require('some-random-cat').Random //Import the package
    somethingRandom.getCat()
    .then(res => {
        console.log(res)
        return
    }) // Get the result
    .catch(e => {
        console.error(e)
        return
    }) // Catch the error

    Util

    The class for getting information on the package or testing it.

    triangle-exclamation

    Please make sure you do not instantiate this class. You can access it though const something = require('some-random-cat').Random

    hashtag
    Properties

    hashtag
    .info STATIC

    The general information for the package.

    circle-check

    Type: ?

    hashtag
    Methods

    hashtag
    .test() STATIC

    Random method to generate an advice.

    circle-check

    Returns: ``

    repo

    Object

    Current repository(s) of the package.

    version

    String

    The version of the package.

    PARAMETER

    TYPE

    DESCRIPTION

    author

    String

    The author(s) of the package.

    description

    String

    Type

    Description

    any

    Tests the package and retrieves an error(if any).

    Objectarrow-up-right
    Promise<Pending>arrow-up-right

    The description of the package.

    Reading Notation

    Gives basic information on how to read the classes and stuff.

    Throughout the whole SomeRandomCat documentation or in the support server, you may see notation very often. To help you understand those, we will be going over a few common types of them.

    circle-check

    Always keep in mind that notation is not always rigorous. There will be typos, misunderstandings, or context that will cause notation to differ from the usual meanings.

    hashtag
    Classes

    Some common notations are used to refer to a class or the properties, methods, or events of a class. There are many variations on these notations, and they are very flexible depending on the person, so use your best judgement when reading them. For example, if you are given a text <Random>, it means an instance of the class Random. It is telling you to replace it with your own instance that you have made, but in our case, it is STATIC which means there is no hustle and bustle of instantiating it.

    The notation Class#foo refers to a property called foo in the class Class. However in the case of STATIC properties you write it as Class.foo

    To write an event, you can write it as <Class>#<property>:<event>

    circle-exclamation

    Remember that this notation is not valid JavaScript, it is a shorthand to refer to a certain piece of code.

    Classes

    All the classes available for the current version.

    hashtag
    Available Classes

    • Random - The random class includes all random things from advice to topic.

    • Util - The pacakge basic info and testing.

    hashtag
    Go to

    Random

    The class for generating random things such as cat images, dog images, jokes and much more!

    triangle-exclamation

    Please make sure you do not instantiate this class. You can access it though const something = require('some-random-cat').Random

    hashtag

    Methods

    hashtag
    .getAdvice() STATIC

    Random method to generate an advice.

    Type

    Description

    any

    The string with the advice.

    circle-check

    Returns: Promise<Pending>arrow-up-right``

    hashtag
    .getCat() STATIC

    Random method to generate a random cat image.

    Type

    Description

    any

    URL for the image.

    circle-check

    Returns: Promise<Pending>arrow-up-right

    hashtag
    .getDog() STATIC

    Random method to generate a random dog image.

    Type

    Description

    any

    URL for the image.

    circle-check

    Returns: Promise<Pending>arrow-up-right

    hashtag
    .getFact() STATIC

    Random method to generate a random fact.

    Type

    Description

    any

    The string for the fact.

    circle-check

    Returns: Promise<Pending>arrow-up-right``

    hashtag
    .getJoke() STATIC

    Random method to generate a random joke.

    Type

    Description

    any

    An object with the title, description and URL

    circle-check

    Returns: Promise<Pending>arrow-up-right

    hashtag
    .getMeme(sub) STATIC

    Random method to generate a meme.

    Parameters

    Type

    Optional

    Description

    sub

    String

    ❌

    The subreddit to get the meme from.

    circle-check

    Returns: Promise<Pending>arrow-up-right``

    hashtag
    .getString(number) STATIC

    Parameters

    Type

    Optional

    Description

    number

    Number

    ❌

    The length of the string.

    circle-check

    Returns: Promise<Pending>arrow-up-right``

    hashtag
    .getTopic() STATIC

    Random method to generate a topic.

    Type

    Description

    any

    The string with the topic.

    circle-check

    Returns:Promise<Pending>arrow-up-right``

    Randomchevron-right
    NPM

    Random Joke

    An example of how to generate a random joke!

    hashtag
    Code

    // This snippet uses some-random-cat version 2.0
    
    const somethingRandom = require('some-random-cat').Random
    somethingRandom.getJoke()
    .then(res => {
        console.log(res)
        return
    }) // Get the result
    .catch(e => {
        console.error(e)
        return
    }) // Catch the error

    hashtag
    Output

    Note: This returns a default JavaScript Object.
    Discord
    GitHub Repo stars
    npm
    Total Downloads
    NPM