Contributing to QuantLibXlOilΒΆ

We encourage contributions to the package to increase coverage, fix issues and improve tests and documentation.

In this section, we explain the workflow for contributing to the QuantLibXlOil package.

Please read the coding guides here and the test case guide here.

  1. Uninstall any pre-installed QuantLibXlOil package from the Python environment

    pip uninstall quantlib_xloil

    Make sure xlOil remains installed in the Python environment.

  2. Fork the repository on GitHub.

  3. Clone the forked repository.

    git clone https://github.com/[your-username]/QuantLibXlOil

  4. Add source path

    C:\[...]\QuantLibXlOil\src

    to Excel / xlOil Py / Modules / Search Paths.

    Make sure Excel / xlOil Py / Modules / Load Modules contains the QuantLib_xlOil entry.

  5. Add an example function and double-check that you can access it from Excel.

  6. Implement a new feature.

    1. Add wrapper code to C:\[...]\QuantLibXlOil\src.

    2. Add unit tests to C:\[...]\QuantLibXlOil\tests\unittests.

    3. Add a test workbook to C:\[...]\QuantLibXlOil\tests\workbooks.

  7. Push changes to your GitHub repository.

  8. Create a pull request.