cpg.info

Let’s break down what this script does in detail. The script is named cpg.sh, authored by GJS (homelab-alpha), and its purpose is to create a function called cpg that can copy files or directories from a source location to a destination location. The script handles both single files and directories, including recursive copying for directories.

Here’s a detailed explanation:

Script Metadata link

• Filename: cpg.sh
• Author: GJS (homelab-alpha)
• Date: May 26, 2024
• Version: 1.0.1
• Description: The script provides a function cpg to copy files or directories from a source to a destination, handling both single files and directories recursively.
• RAW Script: cpg.sh

The main part of this script is the function cpg. Let’s go through what it does step by step.

Function Definition and Argument Check link

function cpg() {
  if [ $# -ne 2 ]; then
    echo "Usage: cpg source destination"
    return 1
  fi

The function cpg is defined here. It starts by checking if the number of arguments passed is exactly 2. If not, it prints a usage message (Usage: cpg source destination) and returns an error status (1).

Variables Assignment link

  local source="$1"
  local destination="$2"

The script assigns the first argument to a variable named source and the second argument to a variable named destination. This makes the code more readable and easier to work with.

Directory Check and Recursive Copy link

  if [ -d "$source" ]; then
    if [ -d "$destination" ]; then
      cp -r "$source" "$destination" && cd "$destination/$(basename "$source")" || exit
    else
      echo "Destination is not a directory: $destination"
      return 1
    fi
  else
    cp "$source" "$destination"
  fi
}

Next, the script checks if the source is a directory using the -d flag. If source is a directory, it then checks if the destination is also a directory. If both conditions are true, it uses the cp -r command to recursively copy the source directory to the destination. After the copy operation, it changes the current directory to the newly copied directory within the destination using the cd command. If the directory change fails, the script exits with an error.

Single File Copy link

If the source is not a directory, the script simply copies the source file to the destination using the cp command.

Error Handling link

The script includes basic error handling. If the destination is not a directory when the source is a directory, it prints an error message (Destination is not a directory: $destination) and returns an error status (1).

Conclusion link

To summarize, the cpg function in the cpg.sh script:

1. Checks Argument Count: Ensures exactly two arguments are passed.
2. Assigns Variables: Stores the arguments in source and destination.
3. Handles Directories:
   • If source is a directory and destination is also a directory, it copies source to destination recursively and changes the directory to the copied directory.
   • If destination is not a directory, it prints an error and exits.
4. Handles Files: If source is a file, it copies the file to destination.

This function is a useful tool for copying files and directories with ease, including handling the complexities of recursive directory copying.