Fortran-Python包装器

自动生成Fortran和Python集成的包装器

此项目由几个不同的组件组成

• fgen
• fgen_runtime
• libfgen

完整文档可以在以下位置找到： fgen.readthedocs.io。我们建议您在那里阅读文档，因为GitLab的查看器无法正确渲染内部文档链接。

安装

fgen可以使用pip安装

pip install fgen

用法

待办事项

libfgen

如果您希望在下游库中使用Fortran功能，则必须编译和链接Fortran库。本存储库中提供了一个用于查找或检索fgen库的CMake模块（从存储库根目录，请参阅cmake/Findfgen.cmake）。此模块将尝试根据几种不同的方法查找fgen

• cmake: 使用CMake配置文件（使用CMake命令 find_package(fgen CONFIG)）
• 子项目: 使用相对于CMake文件的相对目录，指向已克隆的fgen仓库
• fetch: 从GitLab下载项目并在本地构建

尝试方法的顺序可以通过CMake定义：FGEN_FIND_METHOD来设置（默认顺序：["cmake" "subproject" "fetch"]）。必须从目标仓库访问Findfgen.cmake CMake模块。当前建议将Findfgen.cmake复制到仓库中。这允许目标仓库锁定特定的fgen git hash以使用。

然后可以通过添加以下片段将库集成到CMake项目中

if(
  NOT
  TARGET
  "fgen::fgen"
)
  # Find the fgen package, fetch it from gitlab if it isn't available locally
  find_package(
    "fgen"
    REQUIRED
  )
endif()

在tests/test-data中提供了使用fgen的一些示例。

对于开发者

为了开发，我们依赖于poetry来管理所有依赖项。要开始，请确保poetry已安装（在此处获取说明，我们发现pipx和pip在Mac上安装效果更好）。

对于所有的工作，我们使用我们的Makefile。如果您愿意，可以手动阅读说明并运行命令，但我们通常不鼓励这样做，因为它可能会出错。为了创建您的环境，请运行make virtual-environment。

创建虚拟环境后，可以使用make build构建libfgen。此库包含所有包装器使用的通用Fortran代码，并使用CMake进行构建，需要有效的Fortran编译器。

如果有任何问题，Makefile中的消息应能引导您解决问题。如果没有，请在问题跟踪器中提出问题。

有关我们其他开发者文档，请参阅。