diff options
| author | umarcor <unai.martinezcorral@ehu.eus> | 2021-02-01 09:08:00 +0100 |
|---|---|---|
| committer | umarcor <unai.martinezcorral@ehu.eus> | 2021-02-01 09:08:00 +0100 |
| commit | bcaadc4e36307110e203661b1300822be8e90373 (patch) | |
| tree | 26c4453cd408a43a36caa67be52f12761e8a3b55 /pyGHDL/__init__.py | |
| parent | 9c421e8524668f9ee06f5e9c2e3aa7c8e7dd7519 (diff) | |
| download | ghdl-bcaadc4e36307110e203661b1300822be8e90373.tar.gz ghdl-bcaadc4e36307110e203661b1300822be8e90373.tar.bz2 ghdl-bcaadc4e36307110e203661b1300822be8e90373.zip | |
doc: move pyGHDL intro to __init__.py
Diffstat (limited to 'pyGHDL/__init__.py')
| -rw-r--r-- | pyGHDL/__init__.py | 17 |
1 files changed, 16 insertions, 1 deletions
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 <https://github.com/VHDL/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 <https://en.wikipedia.org/wiki/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. +""" |