IfcOpenShell/pyodide/README.md

There are two ways to build pyodide ifcopenshell Python wrapper wheel.

1. Using pyodide build system (`build_pyodide.yml` does it):

- setup pyodide environment in `pyodide_root` folder - either by using image or build it from source - see https://pyodide.org/en/stable/development/building-from-sources.html
- clone IfcOpenShell repo next to it to `IfcOpenShell` folder
- create `packages/ifcopenshell` folder that will be used by pyodide build system
- from `IfcOpenShell` move building recipe `pyodide/meta.yaml` to `packages/ifcopenshell`
- run `pyodide build-recipes ifcopenshell --install`, it will
    - execute `meta.yaml` recipe - it will:
        - copy IfcOpenShell source to build folder `packages/ifcopenhell/build/ifcopenshell-0.8.0`
        - build ifcopenshell and its dependencies
        - note that rerunning `pyodide build-recipes` will remove previous build folder and rebuild all dependencies.  
        The way to avoid it, if build fails, is to use `pyodide build-recipes-no-deps ifcopenshell --continue` instead.
    - run `setup.py` in `IfcOpenShell` root, producing a wheel in `IfcOpenShell/dist`
    - copy that wheel to `packages/ifcopenshell/dist`
    - `--install` it to current build envrionment
        - copy the wheel next to `dist` folder (in root directory, next to `packages`)
        - add wheel to `dist/pyodide-lock.json`

2. Build it outside of pyodide system.

Building inside pyodide build system should be preferred, option to build it outside is useful for debugging purposes,
since it's pure cmake without any additional moving parts.

- setup pyodide environment in `pyodide_root` folder, see above
- clone IfcOpenShell repo next to it to `IfcOpenShell` folder
- setup debug build environment using `source pyodide/debug_build_env.sh /path/to/pyodide_root`
- run `python nix/build-all.py -wasm -py-313` in `IfcOpenShell`
    - it will produce Python package in `IfcOpenShell/ifcopenshell`
- run `pyodide build`
    - it will produce a wheel in `IfcOpenShell/dist`