Title: Bug: macOS build instructions use unavailable `nproc` command · Issue #1959 · python/devguide · GitHub
Open Graph Title: Bug: macOS build instructions use unavailable `nproc` command · Issue #1959 · python/devguide
X Title: Bug: macOS build instructions use unavailable `nproc` command · Issue #1959 · python/devguide
Description: Describe the bug Problem The CPython Developer's Guide currently instructs contributors to compile CPython using the following command in getting-started/setup-building.rst, under the Unix build instructions: make -s -j $(nproc) However,...
Open Graph Description: Describe the bug Problem The CPython Developer's Guide currently instructs contributors to compile CPython using the following command in getting-started/setup-building.rst, under the Unix build in...
X Description: Describe the bug Problem The CPython Developer's Guide currently instructs contributors to compile CPython using the following command in getting-started/setup-building.rst, under the Unix buil...
Opengraph URL: https://github.com/python/devguide/issues/1959
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Bug: macOS build instructions use unavailable `nproc` command","articleBody":"### Describe the bug\n\n### Problem\n\nThe CPython Developer's Guide currently instructs contributors to compile CPython using the following command in `getting-started/setup-building.rst`, under the Unix build instructions:\n\n```bash\nmake -s -j $(nproc)\n```\n\nHowever, `nproc` is a GNU coreutils utility that is not available by default on macOS.\n\nWhen a contributor follows these instructions on a standard macOS installation, the shell reports:\n\n```console\nzsh: command not found: nproc\n```\n\nAs a result, the command substitution produces an empty string, effectively executing:\n\n```bash\nmake -s -j\n```\n\nWithout an explicit job count, GNU Make allows unlimited parallel jobs. This can result in excessive resource consumption during compilation.\n\n### Expected Behaviour\n\nThe build instructions should provide a macOS-compatible command that determines the available logical CPU count without requiring additional utilities.\n\n### Proposed Solution\n\nIntroduce separate Unix and macOS tabs for the compilation command, following the existing documentation conventions in:\n\n- `getting-started/quick-reference.rst`\n- `development-tools/sanitizers.rst`\n\nKeep the existing Unix command:\n\n```bash\nmake -s -j $(nproc)\n```\n\nFor macOS, use:\n\n```bash\nmake -s -j $(sysctl -n hw.logicalcpu)\n```\n\nThis would allow macOS contributors to build CPython using the available logical CPU count without installing GNU coreutils.\n\n### Additional Context\n\nA similar macOS compatibility issue was previously addressed in PR #1545, where `nproc` was replaced with a fixed job count in another section of the documentation.\n\nHowever, the primary compilation instructions still contain the incompatible command.\n\nThis issue proposes applying the existing macOS-specific approach consistently to the main build instructions.\n\n### Screenshots\n\n_No response_\n\n### Additional context\n\n_No response_","author":{"url":"https://github.com/lokeshsahu2804-korba","@type":"Person","name":"lokeshsahu2804-korba"},"datePublished":"2026-11-03T18:05:19Z","url":"https://github.com/python/devguide/issues/1959"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:bb7a8696-2ff7-f398-3281-f4bfa07a5230 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | B3A8:24645:1387810:19CB853:6B01EF88 |
| html-safe-nonce | 1d4c45f043fb014bb96dc4113332fbe7d309fb797c7284acd578af33a27151d3 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCM0E4OjI0NjQ1OjEzODc4MTA6MTlDQjg1Mzo2QjAxRUY4OCIsInZpc2l0b3JfaWQiOiIxOTA4Nzg3NTc4MTQ0OTQ0MDA4IiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | b3658cdfff06af84744215061ffad1cdc10c37f09adc662361affeb2040ce0da |
| hovercard-subject-tag | issue:6188379934 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/devguide/1959/issue_layout |
| twitter:image | https://opengraph.githubassets.com/c5634e949933525c4da13e00c97e6c1576bc108826c45ba20c2b2f28e9fbbae5/python/devguide/issues/1959 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/c5634e949933525c4da13e00c97e6c1576bc108826c45ba20c2b2f28e9fbbae5/python/devguide/issues/1959 |
| og:image:alt | Describe the bug Problem The CPython Developer's Guide currently instructs contributors to compile CPython using the following command in getting-started/setup-building.rst, under the Unix build in... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | lokeshsahu2804-korba |
| hostname | github.com |
| expected-hostname | github.com |
| None | 87e774ee7c6b3bee0490394e4d3e57ec9dbc956f74b87ea685dc8996c1676456 |
| turbo-cache-control | no-preview |
| go-import | github.com/python/devguide git https://github.com/python/devguide.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 63972479 |
| octolytics-dimension-repository_nwo | python/devguide |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 63972479 |
| octolytics-dimension-repository_network_root_nwo | python/devguide |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 423dbb54c5e7bfecc838eb387c1435eb3d0e760d |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width