# editorconfig-core-lua

**Repository Path**: mirrors_editorconfig/editorconfig-core-lua

## Basic Information

- **Project Name**: editorconfig-core-lua
- **Description**: EditorConfig Core bindings for Lua
- **Primary Language**: Unknown
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-02-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EditorConfig Lua Core

EditorConfig Lua Core provides the same functionality as the
[EditorConfig C Core][1] library.

## EditorConfig Project

EditorConfig makes it easy to maintain the correct coding style when switching
between different text editors and between different projects. The EditorConfig
project maintains a file format and plugins for various text editors which
allow this file format to be read and used by those editors. For information
on the file format and supported text editors, see the [EditorConfig][2]
website.

## Installation

#### Build using CMake

```
mkdir build
cd build
cmake ..
make
sudo make install
```

Or just copy the `editorconfig.so` binary module to somewhere in
your `LUA_CPATH`.

#### Install using LuaRocks

You can also install the latest release using [LuaRocks][3]:

```
luarocks [--local] install editorconfig-core
```

## Usage

The `parse` module function returns a name/value property table. Typical usage
by plugins would be:

```lua
ec = require("editorconfig")

for name, value in pairs(ec.parse("/full/path/to/file")) do
    configure_property[name](value)
end
```

Sometimes it is useful to have the same stable order for each `parse`
invocation that the EditorConfig C Core library provides. For that the property
names are available as an array in a second return value:

```lua
prop, names = ec.parse("/full/path/to/file")
print(#names .. " properties:")
for idx, name in ipairs(names) do
  print(string.format("%s: %s=%s", idx, name, prop[name]))
end
```

Note also the use of the length operator to retrieve the EditorConfig
property count for a given file.

#### Note on API stability

Version 0.3.0 introduced major backward incompatibilities.

* The `open`function was removed.
* Every EditorConfig value has the Lua type `string`.
* Lua module renamed to `editorconfig`. 

Please update accordingly.

[1]: https://github.com/editorconfig/editorconfig-core-c
[2]: https://editorconfig.org
[3]: https://luarocks.org