Add Functions

July 23, 2026 · View on GitHub

Where

Create or update a module under particula//.

Checklist

  • Python – no I/O or global state changes.
  • Follow Code Specifications for formatting.
  • Input validation via util.validate_inputs when applicable.
  • Logging: use logger = logging.getLogger("particula") and log at DEBUG.

Steps

  1. Create a new issue on GitHub and assign it to yourself.
    1. Create a branch on your forked repo for this issue.
  2. Add a new function(s) to the appropriate module in particula//.
    1. Add a package __init__.py export only when the function is an approved public API. Concrete, staged, or internal-module contracts may deliberately remain unexported.
    2. If the function is a helper, add prefix _ to the function name.
    3. Write a docstring.
  3. Add type hints for all parameters and return values.
  4. Add Unit Tests for the function (see Add Unit Tests).
  5. Commit this file in a branch.
  6. Create your pull‑request to the main repo.