update tool installation to not reinstall

Author: memalhot

README.md

@@ -1,47 +1,73 @@
-The Tools branch of OPE contains the main ope tool along with its friends.
+# OPE Tool
 
-Here is some of my current thinking
+This tool is designed to facilitate the management of projects within the Open Publishing Environment (OPE). It includes a variety of functions for handling repositories, books, containers, and course creation.
 
-# OPE commands
+## Installation
 
-## Project Commands
+1. Clone this repository to your local machine.
+2. Ensure you have Git installed, as it is required for several functions.
+3. **Command**: In the directory, run `./install.sh`
 
-### `ope project <name>`
+## Usage
 
-### `ope book new <name>`
+Each function in the script is intended for specific tasks. Below are the usages and descriptions for each function.
 
-### `ope container new <name>`
+### General
 
-## Book Commands
+- **Usage**: Run the tool with a specific command and relevant arguments.
+- **Command**: `ope <function> [arguments]`
 
-### `ope build`
+### new_project
 
-### `ope publish`
+- **Description**: Creates a new OPE project from templates.
+- **Usage**: `ope new_project <project_name> [repo_url]`
+- **Arguments**:
+  - `project_name`: Name of the new project.
+  - `repo_url` (optional): URL of the Git repository to associate with the project.
 
-### `ope print`
+### new_book
 
-### `ope test`
+- **Description**: Creates a new book within the project.
+- **Usage**: `ope new_book <book_name>`
+- **Arguments**:
+  - `book_name`: Name of the new book.
 
-## Container 
+### new_container
 
-### `ope run [user|root]`
+- **Description**: Adds source for building a new container for the project.
+- **Usage**: `ope new_container <container_name>`
+- **Arguments**:
+  - `container_name`: Name of the new container.
 
-### `ope build`
+### new_course
 
-### `ope publish`
+- **Description**: Creates a new course with a standard set of books and a container.
+- **Usage**: `ope new_course <course_name> [repo_url]`
+- **Arguments**:
+  - `course_name`: Name of the new course.
+  - `repo_url` (optional): URL of the Git repository for the course.
 
+### update
 
-# USER GUIDE Draft
+- **Description**: Updates and rebases changes from the OPE framework.
+- **Usage**: `ope update`
+- No arguments required.
 
-## OPE USER GUIDE
+### Helper Functions
 
-A collection of OPE books and associated container images are organized into a project.
+- **`repo_add`**: Adds a repository to a project.
+- **`findprojectdir`**: Finds the project directory.
+- **`projectdir`**: Outputs the project directory.
+- **`new_part`**: Creates a new part in a book or course.
+- **`print_func_page`**: Prints the help page for functions.
+- **`Usage`**: Prints general usage information.
 
-## Creating a new OPE project
+### Logging and Configuration
 
-We will use the project `ucsls` as a running example.
+- The script includes logging functionality. Check `/tmp/ope.<process_id>.log` for logs.
+- Color configuration is included for better readability of output.
 
-1. We recommend that you create a new email address that will act as the central admin address for your project.  Eg. ucsls.organization@gmail.com.  You can then use this as the admin and identity for all online resources of your project.
 
-2. Assuming that you are using github or gitlab we recommend you create a new organization for your project.  If you will be publishing containers as part of your project we also recommend that you create an docker image registery organization.
+## License
 
+This project is licensed under the MIT License. See the `LICENSE` file for details.

install.sh

@@ -1,5 +1,12 @@
 #!/bin/bash
+
 current_dr=$(pwd)/bin
-echo "run the following command to add the ope to your path"
-echo "export PATH=$current_dr:\$PATH"
 
+#if path was not already added, add path
+if ! grep -q -s "export PATH=$current_dr:\$PATH" ~/.bashrc; then
+  echo "export PATH=$current_dr:\$PATH" >> ~/.bashrc #add it to path
+  source ~/.bashrc #rerun bashrc to reset shell
+fi
+
+#tell user ope tool has been installed
+echo "ope has been added to the path successfully"