Skip to content

Commit 6f8741e

Browse files
authored
Merge pull request #100 from gnikit/gnikit/issue99
Update README and peripherals
2 parents d73fc67 + 7d0cd42 commit 6f8741e

14 files changed

+186
-28
lines changed

CHANGELOG.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,17 @@
11
# CHANGELONG
22

3+
## 2.3.0
4+
5+
### Added
6+
7+
- Added keywords to the PyPi manifest
8+
([#99](https://github.com/gnikit/fortls/issues/99))
9+
10+
### Changed
11+
12+
- Updated `README` to include logo and animations
13+
- Updated `README` to include conda-forge installation instructions
14+
315
## 2.2.14
416

517
### Added

README.md

Lines changed: 54 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
![alt](https://raw.githubusercontent.com/gnikit/fortls/master/assets/logo.png)
2+
13
# fortls - Fortran Language Server
24

35
![PyPI](https://img.shields.io/pypi/v/fortls)
@@ -8,6 +10,11 @@
810
[![GitHub license](https://img.shields.io/github/license/gnikit/fortls)](https://github.com/gnikit/fortls/blob/dev/LICENSE)
911
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
1012

13+
[![GitHub Sponsor](https://img.shields.io/static/v1?style=social&label=Sponsor&message=%E2%9D%A4&logo=GitHub&color&link=%3Curl%3E)](https://github.com/sponsors/gnikit)
14+
[![PayPal](https://img.shields.io/static/v1?style=social&label=Donate&message=%E2%9D%A4&logo=Paypal&color&link=%3Curl%3E)](https://paypal.me/inikit)
15+
16+
![alt](https://raw.githubusercontent.com/gnikit/fortls/master/assets/animations/intro-demo.gif)
17+
1118
`fortls` is an implementation of the [Language Server Protocol](https://github.com/Microsoft/language-server-protocol)
1219
(LSP) for Fortran using Python (3.7+).
1320

@@ -16,24 +23,10 @@ All code editors that support LSP can integrate with `fortls` see the section
1623
Some supported code editors include:
1724
[Visual Studio Code](https://gnikit.github.io/fortls/editor_integration.html#visual-studio-code),
1825
[Atom](https://gnikit.github.io/fortls/editor_integration.html#atom),
19-
[Sublime Text](https://gnikit.github.io/fortls/editor_integration.html#sublime-text)
26+
[Sublime Text](https://gnikit.github.io/fortls/editor_integration.html#sublime-text),
2027
[(Neo)Vim](https://gnikit.github.io/fortls/editor_integration.html#vim-neovim-gvim),
21-
[Visual Studio](https://gnikit.github.io/fortls/editor_integration.html#visual-studio-2017),
2228
and [Emacs](https://gnikit.github.io/fortls/editor_integration.html#emacs).
2329

24-
## `fortls` vs `fortran-language-server`
25-
26-
This project is based on @hansec's original Language Server implementation but the two projects have since diverged.
27-
`fortls` (this project) is now developed independently of the upstream `hansec/fortran-language-server` project and contains numerous bug fixes and new features
28-
the original `fortran-language-server` does not.
29-
30-
For a complete and detailed list of the differences between the two Language Servers
31-
see the Documentation section: [Unique fortls features (not in fortran-language-server)](https://gnikit.github.io/fortls/fortls_changes.html)
32-
33-
The name of executable for this project has been chosen to remain `fortls`
34-
to allow for integration with pre-existing plugins and workflows but it is
35-
potentially subject to change.
36-
3730
## Features
3831

3932
- Project-wide and Document symbol detection and Renaming
@@ -68,20 +61,55 @@ potentially subject to change.
6861

6962
- Signature help and hover does not handle elegantly overloaded functions i.e. interfaces
7063

64+
## `fortls` vs `fortran-language-server`
65+
66+
This project was originally based on `fortran-language-server` LSP implementation, but the two projects have since diverged.
67+
68+
`fortls` (this project) is now developed independently of the upstream `hansec/fortran-language-server` project and contains numerous new features and bug fixes
69+
the original `fortran-language-server` does not.
70+
71+
For a complete and detailed list of the differences between the two Language Servers
72+
see the Documentation section: [Unique fortls features (not in fortran-language-server)](https://gnikit.github.io/fortls/fortls_changes.html)
73+
74+
The name of executable for this project has been chosen to remain `fortls`
75+
to allow for integration with pre-existing plugins and workflows, but it could
76+
change in the future.
77+
7178
## Installation
7279

80+
### PyPi
81+
7382
```sh
7483
pip install fortls
7584
```
7685

77-
> **Warning**: it is not recommended having `fortls` and `fortran-language-server`
78-
> simultaneously installed, since they use the same binary name. If you are having trouble
79-
> getting `fortls` to work try uninstalling `fortran-language-server` and reinstalling `fortls`.
80-
>
81-
> ```sh
82-
> pip uninstall fortran-language-server
83-
> pip install fortls --upgrade
84-
> ```
86+
### Anaconda
87+
88+
```sh
89+
conda install -c conda-forge fortls
90+
```
91+
92+
for more information about the Anaconda installation [see](https://github.com/conda-forge/fortls-feedstock#about-fortls)
93+
94+
### Common installation problems
95+
96+
It is **NOT** recommended having `fortls` and `fortran-language-server`
97+
simultaneously installed, since they use the same binary name. If you are having trouble
98+
getting `fortls` to work try uninstalling `fortran-language-server` and reinstalling `fortls`.
99+
100+
With `pip`
101+
102+
```sh
103+
pip uninstall fortran-language-server
104+
pip install fortls --upgrade
105+
```
106+
107+
or with Anaconda
108+
109+
```sh
110+
conda uninstall fortran-language-server
111+
conda install -c conda-forge fortls
112+
```
85113

86114
## Settings
87115

@@ -129,16 +157,14 @@ An example for a Configuration file is given below
129157
## Acknowledgements
130158

131159
This project would not have been possible without the original work of [@hansec](https://github.com/hansec/)
132-
and the original [`fortran-language-server`](https://github.com/hansec/fortran-language-server)
160+
in [`fortran-language-server`](https://github.com/hansec/fortran-language-server)
133161

134-
## Support
162+
<!-- ## Support
135163
136164
If you want to support this project you can do it through
137165
138166
[![Alt](https://www.paypalobjects.com/webstatic/mktg/Logo/pp-logo-150px.png)](https://paypal.me/inikit)
139-
[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/gnikit)
140-
141-
Support the original project go [here](https://paypal.me/hansec)
167+
[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/gnikit) -->
142168

143169
## Bug reports
144170

assets/animations/intro-demo.gif

1.57 MB
Loading

assets/logo.png

14.7 KB
Loading

assets/logo.svg

Lines changed: 106 additions & 0 deletions
Loading

images/fortls_autocomplete.gif

-1.25 MB
Binary file not shown.

images/fortls_diag.png

-98.9 KB
Binary file not shown.

images/fortls_gotodef.gif

-1.25 MB
Binary file not shown.

images/fortls_hover.gif

-83.9 KB
Binary file not shown.

images/fortls_outline.png

-294 KB
Binary file not shown.

0 commit comments

Comments
 (0)