Metadata-Version: 2.1
Name: kedro-lsp
Version: 0.2.0
Summary: Kedro Language Server
Home-page: https://github.com/Kedro-Zero-to-Hero/kedro-lsp
License: MIT
Keywords: python,kedro,lsp,language-server-protocol
Author: Lim Hoang
Author-email: limdauto@gmail.com
Requires-Python: >=3.6.2,<3.9
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Editors :: Integrated Development Environments (IDE)
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Dist: kedro (>=0.17.3,<0.18.0)
Requires-Dist: pygls (>=0.10.3,<0.11.0)
Project-URL: Repository, https://github.com/Kedro-Zero-to-Hero/kedro-lsp
Description-Content-Type: text/markdown

# kedro-lsp

A [Language Server](https://microsoft.github.io/language-server-protocol/) for the latest version(s) of [Kedro](https://kedro.readthedocs.io/en/latest/). It provides features to enable IDE support for Kedro. For example, you can jump to dataset and parameter definition when constructing the pipeline.

![](./assets/demo.gif)

**Note**: This is pre-alpha software.

## Features

* [x] Provide dataset and parameter definition when constructing the pipeline.

> **Note**: I need your help! If you think this project is a good idea, please submit features request via Github Issue.

## Compatibility

Kedro Language Server aims to be compatible with Kedro 0.17.x and above. Currently it is restricted to 0.17.3 and above during pre-alpha phase.

## Installation

```shell
pip install kedro-lsp
```

## Usage

### Standlone

```
usage: kedro-lsp [-h] [--version] [--tcp] [--host HOST] [--port PORT] [--log-file LOG_FILE] [-v]

Kedro Language Server: an LSP wrapper for Kedro.

optional arguments:
  -h, --help           show this help message and exit
  --version            display version information and exit
  --tcp                use TCP server instead of stdio
  --host HOST          host for TCP server (default 127.0.0.1)
  --port PORT          port for TCP server (default 2087)
  --log-file LOG_FILE  redirect logs to the given file instead of writing to stderr
  -v, --verbose        increase verbosity of log output

Examples:
    Run from stdio: kedro-lsp
```

### Visual Studio Code

To use it with visual studio code, install the Kedro extension from Visual Studio Code Marketplace.

### Pycharm

TBD

### nvim

To use it with nvim, install [lspconfig](https://github.com/neovim/nvim-lspconfig).
```
:Plug 'neovim/nvim-lspconfig'
```

Then add the following config to your vimrc.

``` vim
lua <<EOF
local configs = require 'lspconfig/configs'

configs.kedro = {
    default_config = {
        cmd = {"kedro-lsp"};
        filetypes = {"python"};
        root_dir = function(fname)
            return vim.fn.getcwd()
        end;
    };
};
EOF
```

> 🗒️ Note, you must have the `kedro-lsp` installed and on your `PATH`

There are a number of plugins that will help setup lsp functionality in nvim, but if you want a bare minimum go-to-definition add this to your `.vimrc` as well.

``` vim
nnoremap <leader>n <cmd>lua vim.lsp.buf.definition()<CR>
```

If you are having any issues with `kedro-lsp` not working in nvim try running `:LspInfo` or looking into your `~/.cache/nvim/lsp.log` file.

## Todos

* [ ] Provide diagnostic when there is a typo in dataset or parameter name in the pipeline.
* [ ] Be Kedro environment-aware

## License

MIT

