How to relocate the example project?

Open
#477 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
38/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
cpp, python

Research direction

Start with the linked no_install_quickstart documentation, then compare its relocation instructions with the current boost-build.jam and Jamroot files and the shown Jamfile. Reproduce the move to a new project folder and investigate the reported unknown run-test rule. Done means the documentation matches the current files and gives a working relocation procedure.

Written by the indexing model from the issue text.

Description

Hello!
I've managed to build the example project but needed to relocate it to my project's folder. The documentation doesn't really reflect the current state of the code and I'm a bit lost when updating the jamfile to match this new folder.

Reading the currently available documentation it suggests changing some lines in the jamfile that point to the boost source folder, however as of boost 1.82.0 these lines don't exist in the jamfile anymore. In the docs we have

change the first path in boost-build.jam from
../../../../tools/build/src
to
/home/dave/boost_1_34_0/tools/build/src

and change the first path in Jamroot from
../../../..
to
/home/dave/boost_1_34_0

however the current jamfile looks like this

import python ;

project tutorial
  : requirements
    <location>.
    ;

python-extension hello_ext : hello.cpp ;

run-test hello : hello_ext hello.py ;

alias test : hello ;
explicit test ;

which results in an error when building,
ERROR: rule "run-test" unknown in module "Jamfile</home/userfolder/projectfolder>"
which I imagine stems from this misconfiguration as it builds fine in the original folder. I am not familiar enough with the jam build system and would appreciate some directions here.
Thanks in advance!

Dominant language
C++
Stars
537
Forks
223
Avg merge
11h 22m
Merged PRs (30d)
2

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from boostorg/python

All issues in boostorg/python

Similar issues

More C++ issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.