/gmod-wiki-scraper

Extract GLua API documentation from the new Garry's Mod wiki

Primary LanguageTypeScriptMIT LicenseMIT

GMod Wiki Scraper

This application allows you to scrape the new Garry's Mod wiki which can be accessed via https://wiki.facepunch.com/gmod/.

Prerequisites

  • Node.js >= 12.9
  • npm >= 5

npm often comes bundled with Node.js so you probably won't need to install that separately.

Installation

npm install -g gmod-wiki-scraper

Usage

gmod-wiki-scraper

This will retrieve all functions, hooks, enums, etc. from the wiki and save them as JSON files into an output directory in your current working directory.

gmod-wiki-scraper features a rudimentary cli:

$ gmod-wiki-scraper --help

Usage: gmod-wiki-scraper [OPTIONS]

Options:
  --help                   Show help                                   [boolean]
  --version, -v            Print the version of gmod-wiki-scraper      [boolean]
  --skip-global-functions  Do not retrieve global functions            [boolean]
  --skip-classes           Do not retrieve classes                     [boolean]
  --skip-libraries         Do not retrieve libraries                   [boolean]
  --skip-hooks             Do not retrieve hooks                       [boolean]
  --skip-panels            Do not retrieve panels                      [boolean]
  --skip-enums             Do not retrieve enums                       [boolean]
  --skip-structs           Do not retrieve structs                     [boolean]

API

Documentation

WIP

Examples

Retrieving a single page

This will retrieve the content of Global.Entity and parse it.

import { WikiApiClient, WikiScraper } from 'gmod-wiki-scraper';

(async (): Promise<void> => {
  const client = new WikiApiClient();
  const scraper = new WikiScraper(client);

  const page = await client.retrievePage('Global.Entity')
  const parsedFunctionPage = scraper.parseFunctionPage(page.content);

  console.log(parsedFunctionPage);
})();

Output:

{
  name: 'Entity',
  parent: 'Global',
  realms: [ 'client', 'server' ],
  description: 'Returns the entity with the matching <page>Entity:EntIndex</page>.\n' +
    '\n' +
    'Indices 1 through <page>game.MaxPlayers</page>() are always reserved for players.\n' +
    '\n' +
    "<note>In examples on this wiki, **Entity( 1 )** is used when a player entity is needed (see ). In singleplayer and listen servers, **Entity( 1 )** will always be the first player. In dedicated servers, however, **Entity( 1 )** won't always be a valid player.</note>",
  arguments: [
    {
      name: 'entityIndex',
      type: 'number',
      description: 'The entity index.'
    }
  ],
  returnValues: [
    {
      type: 'Entity',
      description: "The entity if it exists, or NULL if it doesn't."
    }
  ]
}