readme.md topic

Factorio-Stdlib

Factorio Standard Library Project

About

The Factorio Standard Library is a project to bring Factorio modders high-quality, commonly-required utilities and tools that developers have been often copying around, remixing, and rewriting poor quality copies of. Factorio mods often re-implement basic tools like logging, math calculations, and position or area manipulation. These common operations can be a subtle source of errors and their regular occurance has encouraged the creation of the Factorio Stdlib, as a toolbox and set of utilities for modders. Factorio Standard Library APIs are all unit-tested, documented, and high quality, and written to be simple and straightforward for the earliest beginners and seasoned developers alike.

Usage

  1. Install the Factorio Standard Library mod from the mod portal latest release
  2. In your info.json add stdlib as a dependency.
  3. In your control.lua or other lua modules, you can import the stdlib modules you need.

Documentation

See the wiki for an introduction and usage/examples.

See the github pages for the latest generated documentation of the Factorio-stdlib

Unit Tests

The codebase is tested with busted. Test specifications are located under spec/

Contributing

Contributions are welcome! Please follow general lua coding standards and include ldoc-compatible comments.

Circle CI