Get Started ########### .. article-info:: :avatar: ../assets/f.svg :avatar-link: https://github.com/gnikit :author: `gnikit `__ :date: |today| :read-time: 1 min read :class-avatar: sd-animate-grow50-rot20 ``fortls`` is a tool known as a language server that interfaces with your code editor (VS Code, Vim, etc.) to provide features like code completion, code navigation, hover messages, and many more. Download ******** The project is available for download through the **PyPi** and **Anaconda** package managers .. tab-set:: .. tab-item:: PyPi .. code-block:: sh pip install fortls For more information see `pypi/fortls`_ .. _pypi/fortls: https://pypi.python.org/pypi/fortls .. tab-item:: Anaconda .. code-block:: sh conda install -c conda-forge fortls For more installation instructions, see `conda-forge/fortls`_. .. _conda-forge/fortls: https://github.com/conda-forge/fortls-feedstock#about-fortls .. tab-item:: Brew .. code-block:: sh brew install fortls For more installation instructions, see `brew/fortls`_. .. _brew/fortls: https://formulae.brew.sh/formula/fortls .. tab-item:: Source Alternatively, one can install the development version from **GitHub** via .. code-block:: sh pip install --user --upgrade git+git://github.com/fortran-lang/fortls .. warning:: It is **NOT** possible having ``fortls`` and ``fortran-language-server`` simultaneously installed, since they use the same executable name. If you are having trouble getting ``fortls`` to work try uninstalling ``fortran-language-server`` and reinstalling ``fortls``. Usage ***** To make full use of ``fortls`` in your workflow you need to - integrate it into your code editor, see: :doc:`editor_integration` - (Optional) configure any additional settings to ``fortls``, see: :doc:`options` Integration =========== Depending on the code editor used, different steps will have to be followed to integrate ``fortls``. Luckily, we support numerous code editors and have detailed instructions in the :doc:`editor_integration` section. .. card:: Example: VS Code Setting up ``fortls`` with `VS Code`_ is as simple as installing the `Modern Fortran`_ extension. .. _VS Code: https://code.visualstudio.com .. _Modern Fortran: https://marketplace.visualstudio.com/items?itemName=fortran-lang.linter-gfortran Configuration ============= The Language Server by default is configured with reasonable settings however, depending on the project additional settings might need to be configured, such as source file paths, or additional preprocessor definitions. Instructions on how to do this and much more can be found in the :doc:`options` section.