Developer guide

• Getting started with Finesse development
  • Submitting a bug report
  • Contributing to development
    • Installing git
    • Setting up your fork
    • Setting up the Finesse development environment
    • Rebuilding extensions
• Guide to the Finesse source code
  • The Finesse Cython extensions
    • Structure
    • The ‘finesse.cymath’ extension
    • Optimising Cython code
    • Managing exceptions
    • Checking a Cython extension for CPython interaction
    • Documenting Cython extensions
    • Useful resources
  • KatScript grammar, parser and generator
    • Grammar
    • Parsing
    • Unparsing
  • Requirements for building, running and developing Finesse
    • Python package requirements for Finesse
• Developer tools
  • Tool configuration
• Packaging Finesse
  • Conda
  • Wheels
    • Building for ‘manylinux’
    • Building for Mac OSX
• Contributing to the documentation
  • Structure of the project
  • Comments and todo items
  • Writing Sphinx compatible docstrings
  • Linking to internal and external objects
  • Documenting Cython extensions
  • Showing output from inline scripts
  • Style guide
    • Grammar
    • Capitalisation
    • Code examples
  • Building the documentation
  • Linting tools
• Contributing to the editor extensions
  • JupyterLab
    • pip
    • npm
  • Visual Studio Code
    • Visual Studio Marketplace
    • Open VSX
  • Vim
  • Pygments
• Finesse code style
  • Specific notes
    • ‘__init__.py’ files
    • Absolute and relative imports
    • Indentation of multi-line quotes
    • Singletons
• Testing
  • Running and writing tests
    • Pytest
    • Running the tests provided with Finesse
    • Types of test
    • Writing tests
• Continuous integration
  • Configuring the pipeline
  • Pushing code without triggering the pipeline
  • Wheels built by the pipeline
    • Mac OSX on AMD64
• Debugging Finesse
  • Compile Cython extensions with debug symbols
  • Run the code using a debugger