Fortran Parsing, Unit Testing and Intellisense
Python Emacs Intellisense and Unit Testing Support for Fortran
Fortpy is a python based parsing, unit testing and auto-complete framework for supporting Fortran 2003 including object oriented constructs. Auto-completion integration currently only available for emacs. Here are some of the features:
Python Package Installation
If you install Fortpy using pip install the dependencies will automatically get installed.
pip install fortpy
In most real-usage scenarios, the out-of-the-box support for multiple libraries is incomplete. A configuration file can be created that gives additional information about source code folders to parse, server information for SSH editing over tramp and auto-completion configuration settings. After you have created a config.xml file on your system, you need to configure an environment variable to tell Fortpy where to find it:
NOTE: Environment variables for emacs are set when it first starts; adding a config.xml file will not affect the emacs isense support until you restart emacs.
Here are some of the things you can do once Fortpy is integrated with Emacs using fortpy.el:
Automatic Signature Suggestions
Help with call signatures of functions and subroutines.
Embedded Member Suggestions
Completion suggestions for both methods and variables embedded in user-defined types.
Bracket Complete Embedded Methods
Documentation strings for methods embedded in user-defined types.
- Integration with emacs using virtualenv, epc and auto-complete.
- Context-specific suggestions for variable names and available executables.
See the isense package documentation
XML Documentation Standard
Fortpy uses an XML documentation standard that is derived from the Microsoft XML code documentation standard. As such, many of the same tags and attributes are available for decorating the methods, types and variables in a Fortran module. Because the parsers were designed to work with Fortran 2003, they understand embedded methods in user types that point to other methods in the module. See the wiki page on documenting your code to work with Fortpy.
XML Documentation Example
Automated Unit Testing
Because Fortpy is aware of the structure and dependencies between modules, it can generate automated unit tests for individual functions. You can specify the tests to run in some XML documentation decorating the method to test. When the unit testing scripts are run, a fortran program gets generated and all the necessary dependencies are automatically included. After running the program, the framework tests the output and generates a similarity score. See the full documentation.
Code Version Support
Fortpy’s unit testing framework makes use of XML templates that specify the structure of input/output files to run and test. Using these same templates, the interoperability package allows input and ouput files to be converted between versions of the Fortran program. Since most Fortran programs run on simple text files for input, the interop package also gives support for XML input files to be used; scripts convert the XML input files to the correct plain-text format at run-time.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|File Name & Checksum SHA256 Checksum Help||Version||File Type||Upload Date|
|Fortpy-1.7.7-py2.py3-none-any.whl (378.7 kB) Copy SHA256 Checksum SHA256||2.7||Wheel||Oct 10, 2016|
|Fortpy-1.7.7.tar.gz (829.7 kB) Copy SHA256 Checksum SHA256||–||Source||Oct 10, 2016|