Skip to main content

A Language Server for zc.buildout.

This language server is implemented using pygls.

Installation

Standalone

Needs a python >= 3.6.

python -m pip install zc.buildout.languageserver

Then configure your editor to run buildoutls ( or python3 -m buildoutls ).

From vscode extension

On activation, the extension automatically installs the extension on the python configured in the extension preferences.

The automatic installation does not seem to work with theia and the python egg has to be installed beforehand.

Features

Completions

  • ${ complete sections.
  • ${section: complete section's options. If section uses a known recipe, dynamic options from the recipe are also completed.
  • ${buildout:extends} completes filenames.
  • ${buildout:parts} and <= option completes parts.

Diagnostics

  • non existant section and options in ${section:option} references.
  • required options not defined for a a few "known recipes".

Symbols

  • Sections and options are shown are displayed in outline as symbols.
  • ${buildout:extends} are links.

Go to definitions

  • from ${section:options} we can go to the location where option is defined in section, or to section header if it's not defined.
  • from <= section we can go to section.
  • from ${buildout:extends} we can go to the extended profile.

Hover

  • Hover on an option show the option value.

Find references

  • Find references of the current symbol. A bit simple, it only look for references and does not check if profiles really extends each other. It does not look in templates either.

Template support

  • "current" buildout profile is guessed, then completions and diagnostics should work on any files.

Jinja2 support

  • Jinja syntax is syntax highlighted and jinja syntax markers are ignored when parsing buildout.

SlapOS support

  • SlapOS instance buildout (ie. buildout generated by buildout) is understood, ${ and $${ are treated separatly for completions and diagnostics.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.3.0 - 2020-02-23

Added:

  • support http URLs in ${buildout:extends}

0.2.1 - 2020-04-25

Fixed

  • references: consider listing a section in ${buildout:parts} as a reference.
  • completions: use textEdit to properly overwrite exiting text.
  • all: debounce protocol functions to accept cancellations.
  • all: fix errors when opening profiles outside of workspace.

0.2.0 - 2020-02-12

Added:

  • support running with buildout < 2.9.3
  • initial support of instance.cfg defined using slapos.recipe.template:jinja2

Fixed

  • fixed broken v0.1.1 release, it could not be installed from pypi.
  • diagnostics: prevent "missing required options" false positive on sections used only as macros.
  • diagnostic: Correctly analyze sections with . or - in their names
  • diagnostic: Fix false positives on ${buildout:parts} with extended sections
  • diagnostic: Fix false positives on ${buildout:parts} when dynamically adding parts with jinja.

0.1.1 - 2020-01-30

Added

  • definitions: paths from ${buildout:extends} can also be opened with jump to definition.
  • completions: fix insertText with -.
  • diagnostics: detect missing non existant sections listed in ${buildout:parts}.
  • diagnostics: detect sections without recipe listed in ${buildout:parts}.

0.1.0 - 2020-01-04

  • Initial Version

Release files for zc.buildout.languageserver 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zc.buildout.languageserver 0.3.0
File Size Uploaded
zc.buildout.languageserver-0.3.0.tar.gz 31.0 kB Details

Release files / zc.buildout.languageserver-0.3.0.tar.gz

Download URL zc.buildout.languageserver-0.3.0.tar.gz
Size 31.0 kB
Tags Source
SHA-256 checksum
How to use checksums
73118ff5d1caaa7ad4c225f28e92b70c9fe23bb033f8c6b61d1ea5ad387d0e9a
BLAKE2b-256 checksum
How to use checksums
7902543e8fef6a7c2c4bf5e5ebc4d8177f07d4b389b1532a09e523f208731350
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.8.0 tqdm/4.45.0 CPython/3.7.5

Release history Release notifications | RSS feed

0.17.2

2 release files

0.17.1

2 release files

0.17.0

2 release files

0.16.1

2 release files

0.16.0

2 release files

0.15.0

2 release files

0.14.0

2 release files

0.10.1

2 release files

0.10.0

2 release files

0.9.3

2 release files

0.9.2

2 release files

0.9.0

2 release files

0.8.3

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

1 release file

0.4.0

1 release file

This release

0.3.0 This release

1 release file

0.2.1

1 release file

0.2.0

1 release file

0.1.1

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page