Skip to main content

Python powered Fortran preprocessor

Project description

Fypp is a Python powered preprocessor. It can be used for any programming languages but its primary aim is to offer a Fortran preprocessor, which helps to extend Fortran with condititional compiling and template metaprogramming capabilities. Instead of introducing its own expression syntax, it uses Python expressions in its preprocessor directives, offering the consistency and versatility of Python when formulating metaprogramming tasks. It puts strong emphasis on robustness and on neat integration into developing toolchains.

The project is hosted on bitbucket.

Detailed DOCUMENTATION is available on

Fypp is released under the BSD 2-clause license.

Main features

  • Definition, evaluation and removal of variables:

    #:if DEBUG > 0
      print *, "Some debug information"
    #:set LOGLEVEL = 2
    print *, "LOGLEVEL: ${LOGLEVEL}$"
    #:del LOGLEVEL
  • Macro definitions and macro calls:

    #:def assertTrue(cond)
    #:if DEBUG > 0
    if (.not. ${cond}$) then
      print *, "Assert failed in file ${_FILE_}$, line ${_LINE_}$"
      error stop
    end if
    #:enddef assertTrue
    ! Invoked via direct call (argument needs no quotation)
    @:assertTrue(size(myArray) > 0)
    ! Invoked as Python expression (argument needs quotation)
    $:assertTrue('size(myArray) > 0')
  • Conditional output:

    program test
    #:if defined('WITH_MPI')
      use mpi
    #:elif defined('WITH_OPENMP')
      use openmp
      use serial
  • Iterated output (e.g. for generating Fortran templates):

    interface myfunc
    #:for dtype in ['real', 'dreal', 'complex', 'dcomplex']
      module procedure myfunc_${dtype}$
    end interface myfunc
  • Inline directives:

    logical, parameter :: hasMpi = #{if defined('MPI')}# .true. #{else}# .false. #{endif}#
  • Insertion of arbitrary Python expressions:

    character(*), parameter :: comp_date = "${time.strftime('%Y-%m-%d')}$"
  • Inclusion of files during preprocessing:

    #:include "macrodefs.fypp"
  • Using Fortran-style continutation lines in preprocessor directives:

    #:if var1 > var2 &
        & or var2 > var4
      print *, "Doing something here"
  • Passing (unquoted) multiline string arguments to callables:

    #! Callable needs only string argument
    #:def debug_code(code)
      #:if DEBUG > 0
    #:enddef debug_code
    #! Pass code block as first positional argument
    #:call debug_code
      if (size(array) > 100) then
        print *, "DEBUG: spuriously large array"
      end if
    #:endcall debug_code
    #! Callable needs also non-string argument types
    #:def repeat_code(code, repeat)
      #:for ind in range(repeat)
    #:enddef repeat_code
    #! Pass code block as positional argument and 3 as keyword argument "repeat"
    #:call repeat_code(repeat=3)
    this will be repeated 3 times
    #:endcall repeat_code
  • Preprocessor comments:

    #! This will not show up in the output
    #! Also the newline characters at the end of the lines will be suppressed
  • Suppressing the preprocessor output in selected regions:

    #! Definitions are read, but no output (e.g. newlines) will be produced
    #:include "macrodefs.fypp"
  • Explicit request for stopping the preprocessor:

    #:if DEBUGLEVEL < 0
      #:stop 'Negative debug level not allowed!'
  • Easy check for macro parameter sanity:

    #:def mymacro(RANK)
      #! Macro only works for RANK 1 and above
      #:assert RANK > 0
    #:enddef mymacro
  • Line numbering directives in output:

    program test
    #:if defined('MPI')
    use mpi

    transformed to

    # 1 "test.fypp" 1
    program test
    # 3 "test.fypp"
    use mpi
    # 5 "test.fypp"

    when variable MPI is defined and Fypp was instructed to generate line markers.

  • Automatic folding of generated lines exceeding line length limit


Fypp needs a working Python interpreter. It is compatible with Python 2 (version 2.6 and above) and Python 3 (all versions).

Automatic install

Use Pythons command line installer pip in order to download the stable release from the Fypp page on PyPI and install it on your system:

pip install fypp

This installs both, the command line tool fypp and the Python module Latter you can import if you want to access the functionality of Fypp directly from within your Python scripts.

Manual install

For a manual install, you can download the source code from the Fypp project website

git clone

The project follows Vincent Driessens git workflow, so in order to obtain

  • the latest stable version, check out the master branch:

    cd fypp
    git co master
  • the latest development snapshot, check out the develop branch:

    cd fypp
    git co develop

The command line tool is a single stand-alone script. You can run it directly from the source folder


or after copying it from the bin folder to any location listed in your PATH environment variable, by just issuing


The python module can be found in FYP_SOURCE_FOLDER/src.


The Fypp command line tool reads a file, preprocesses it and writes it to another file, so you would typically invoke it like:

fypp source.fpp source.f90

which would process source.fpp and write the result to source.f90. If input and output files are not specified, information is read from stdin and written to stdout.

The behavior of Fypp can be influenced with various command line options. A summary of all command line options can be obtained by:

fypp -h

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for fypp, version 2.0
Filename, size File type Python version Upload date Hashes
Filename, size fypp-2.0.tar.gz (42.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page