Skip to content

Commit

Permalink
Update doc
Browse files Browse the repository at this point in the history
This reverts commit c8275c610c25c4c25a87e859826db050fae1105b.
  • Loading branch information
mthrok committed Feb 27, 2025
1 parent df767d4 commit b287153
Showing 1 changed file with 2 additions and 43 deletions.
45 changes: 2 additions & 43 deletions docs/source/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,17 +10,10 @@ The following command will build and install `spdl` Python package.

Make sure to use `-v` to see the log from the actual build process.

**Regular installation**

.. code-block::
pip install . -v
**Development installation**

.. code-block::
uv pip install . -v
pip install -e . -v
The build process first downloads/builds/installs some third-party
dependencies, then it builds SPDL and its binding code.
Expand All @@ -39,41 +32,7 @@ Build can be customized through the environment variables;
- ``SPDL_RELASE_GIL=0``: I/O module does not release GIL. This is intended to be used for
experimenting with free-threaded Python (3.13+).

See `setup.py <https://github.com/facebookresearch/spdl/blob/main/setup.py>`_ for the up-to-date available options.

Trouble Shooting
----------------

If you hit an error like the following, ``--no-build-isolation`` can help.

.. code-block:: text
Installing collected packages: ninja, wheel, setuptools, cmake
Creating /tmp/pip-build-env-1ac3bsc_/overlay/bin
changing mode of /tmp/pip-build-env-1ac3bsc_/overlay/bin/ninja to 775
changing mode of /tmp/pip-build-env-1ac3bsc_/overlay/bin/wheel to 775
changing mode of /tmp/pip-build-env-1ac3bsc_/overlay/bin/cmake to 775
changing mode of /tmp/pip-build-env-1ac3bsc_/overlay/bin/cpack to 775
changing mode of /tmp/pip-build-env-1ac3bsc_/overlay/bin/ctest to 775
Successfully installed cmake-3.30.5 ninja-1.11.1.1 setuptools-75.2.0 wheel-0.44.0
...
CMake Error at CMakeLists.txt:3 (project):
Running
'/tmp/pip-build-env-xic7ygls/overlay/bin/ninja' '--version'
failed with:
no such file or directory
This happens because, somehow ``cmake`` command is not pointing the ``ninja`` installed
by ``pip``.

One workaround is to use ``--no-build-isolation`` option.
e.g. ``TMPDIR="${PWD}/build" pip install . -v --no-build-isolation``

See `setup.py <https://github.com/facebookresearch/spdl/blob/main/packaging/spdl_io/setup.py>`_ for the up-to-date available options.

Requirements
------------
Expand Down

0 comments on commit b287153

Please sign in to comment.