From bcaadc4e36307110e203661b1300822be8e90373 Mon Sep 17 00:00:00 2001 From: umarcor Date: Mon, 1 Feb 2021 09:08:00 +0100 Subject: doc: move pyGHDL intro to __init__.py --- pyGHDL/__init__.py | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) (limited to 'pyGHDL/__init__.py') diff --git a/pyGHDL/__init__.py b/pyGHDL/__init__.py index 90376f5f3..97ae27a03 100644 --- a/pyGHDL/__init__.py +++ b/pyGHDL/__init__.py @@ -31,4 +31,19 @@ # # SPDX-License-Identifier: GPL-2.0-or-later # ============================================================================ -# + +""" +.. _python_interface: + +GHDL offers two Python interfaces and a language server protocol service. All +this is provided from a ``pyGHDL`` packages with four sub-packages: + +* ``pyGHDL.cli`` - Command line interface (CLI) applications. +* ``pyGHDL.dom`` - A high-level API offering a document object model (DOM). The underlying abstract VHDL language model is + provided by `pyVHDLModel `__. The DOM is using ``libghdl`` for file analysis and + parsing. +* ``pyGHDL.libghdl`` - A low-level API directly interacting with the shared library ``libghdl....so``/``libghdl....dll``. + This is a procedural and C-like interface. It comes with some Python generators for easier iterating linked lists. +* ``pyGHDL.lsp`` - A `language server protocol `__ (LSP) + written in Python. The implementation offers an HTTPS service that can be used e.g. by editors and IDEs supporting LSP. +""" -- cgit v1.2.3