snegov/cura-te-ipsum
1
0
Fork 0
Code Issues 29 Releases Wiki Activity

macOS gcp requirement not clearly documented #27

New Issue
Open
opened 2025-11-15 03:44:25 +00:00 by snegov · 0 comments
snegov commented 2025-11-15 03:44:25 +00:00
Owner
Copy Link

macOS gcp requirement not clearly documented

Priority: Low
Component: README.md, cli.py
Type: Documentation

Description

The code requires gcp (GNU cp) on macOS for the --external-hardlink option, but the README doesn't clearly explain this requirement or how to install it.

Current State

  • README says "Optional: rsync and GNU cp"
  • Error message: "gcp should be installed to use --external-hardlink option"
  • No installation instructions

Users are left to figure out:

  • What is gcp?
  • Why isn't the built-in cp sufficient?
  • How do I install it?

Location

curateipsum/cli.py:77-81

Proposed Solution

1. Improve error message:

if args.external_hardlink and not shutil.which(cp_program):
    if sys.platform == "darwin":
        _lg.error(
            "GNU coreutils required for --external-hardlink on macOS.\n"
            "Install with: brew install coreutils"
        )
    else:
        _lg.error("cp command not found, cannot use --external-hardlink.")
    return 1

2. Update README:

### macOS-Specific Requirements

For the `--external-hardlink` option on macOS, you need GNU coreutils:

```bash
brew install coreutils

This provides gcp, which supports the -l flag for hardlinking (macOS's built-in cp doesn't support this).


## Impact
**Low** - Documentation and error message improvement.
# macOS gcp requirement not clearly documented **Priority:** Low **Component:** README.md, cli.py **Type:** Documentation ## Description The code requires `gcp` (GNU cp) on macOS for the `--external-hardlink` option, but the README doesn't clearly explain this requirement or how to install it. ## Current State - README says "Optional: rsync and GNU cp" - Error message: "gcp should be installed to use --external-hardlink option" - No installation instructions Users are left to figure out: - What is `gcp`? - Why isn't the built-in `cp` sufficient? - How do I install it? ## Location `curateipsum/cli.py:77-81` ## Proposed Solution **1. Improve error message:** ```python if args.external_hardlink and not shutil.which(cp_program): if sys.platform == "darwin": _lg.error( "GNU coreutils required for --external-hardlink on macOS.\n" "Install with: brew install coreutils" ) else: _lg.error("cp command not found, cannot use --external-hardlink.") return 1 ``` **2. Update README:** ```markdown ### macOS-Specific Requirements For the `--external-hardlink` option on macOS, you need GNU coreutils: ```bash brew install coreutils ``` This provides `gcp`, which supports the `-l` flag for hardlinking (macOS's built-in `cp` doesn't support this). ``` ## Impact **Low** - Documentation and error message improvement.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
No items
No Label
Milestone
Clear milestone
No items
No Milestone
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: snegov/cura-te-ipsum#27
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?