User Guide¶

This section continues the Getting Started workflow. Read it in sidebar order to move from basic values and procedures to objects, storage, and advanced runtime behavior.

---

Start Here¶

• Data Types — Fortran types, semantic .pyi names, exact NumPy dtypes, strings, and arrays
• Arrays — Rank, shape, strides, contiguity, and layout rules
• Strings — Immutable text, mutable byte storage, and string arrays
• Wrapping Functions
• Wrapping Subroutines
• Wrapping Modules
• Optional Arguments
• Generic Interfaces
• Wrapping Derived Types

---

Storage and Objects¶

• Allocatables
• Pointers
• Memory Management

---

Runtime Behavior¶

• Callbacks
• Enumerations
• Raw Addresses — Advanced primitive, array, and fixed-string address boundaries
• Error Handling

---

Building¶

• Building the Shared Library

---

Important Note

The recommended workflow starts from Fortran source. The generated semantic .pyi file describes the Python interface and native call. Editing that file lets you customize the wrapper without changing the native implementation. This guide introduces useful edits on the pages where they matter. The editing reference collects the complete rules in one place.

---

Start with Data Types.