Merge remote-tracking branch 'upstream/master' into openmp_cce

Author: wilfonba

.github/workflows/homebrew.yml

@@ -251,8 +251,8 @@ jobs:
           cp $(brew --prefix mfc)/examples/1D_sodshocktube/case.py "$TESTDIR/"
           
           echo "Running with $(sysctl -n hw.ncpu) processors..."
-          # Use absolute path since mfc wrapper creates its own tmpdir
-          mfc run "$TESTDIR/case.py" -j $(sysctl -n hw.ncpu)
+          # Use absolute path and shorthand syntax (mfc auto-detects and prepends 'run')
+          mfc "$TESTDIR/case.py" -j $(sysctl -n hw.ncpu)
           
           echo "Test case completed successfully!"
       

README.md

@@ -36,13 +36,16 @@
     <img src="https://img.shields.io/badge/Codespaces-Open%20in%201%20click-2ea44f?logo=github" />
   </a>
   <a href="https://github.com/MFlowCode/MFC/releases">
-    <img src="https://img.shields.io/github/v/release/MFlowCode/MFC?display_name=release&sort=semver" />
+    <img src="https://img.shields.io/github/v/release/MFlowCode/MFC?display_name=release" />
   </a>
+  <a href="https://github.com/MFlowCode/homebrew-mfc">
+    <img src="https://img.shields.io/badge/homebrew-mflowcode%2Fmfc%2Fmfc-brown?logo=homebrew&style=flat" />
+  </a>	
 </p>
 
 <p align="center">
   <a href="https://star-history.com/#MFlowCode/MFC&Date">
-    <img src="https://api.star-history.com/svg?repos=MFlowCode/MFC&type=Date" alt="Star History Chart" width="600"/>
+    <img src="https://api.star-history.com/svg?repos=MFlowCode/MFC&type=Date&theme=dark" alt="Star History Chart" width="600"/>
   </a>
 </p>
 
@@ -59,9 +62,9 @@ MFC runs at exascale on the world's fastest supercomputers:
 
 | Path | Command |
 | --- | --- |
-| **Codespaces** (fastest) | Click the "Codespaces" badge above to launch in 1 click |
-| **Homebrew (macOS)** | `brew install mflowcode/mfc/mfc && mfc run $(brew --prefix mfc)/examples/1D_sodshocktube/case.py -n 2` |
-| **Local build** | `./mfc.sh build -j $(nproc) && ./mfc.sh test -j $(nproc)` |
+| **Codespaces** (fastest) 💨 | Click the "Codespaces" badge above to launch in 1 click |
+| **Homebrew** (macOS) 🍺 | `brew install mflowcode/mfc/mfc && mfc $(brew --prefix mfc)/examples/1D_sodshocktube/case.py -n 2` |
+| **Local build** 💻 | `./mfc.sh build -j $(nproc) && ./mfc.sh test -j $(nproc)` |
 
 **Welcome!**
 MFC simulates compressible multi-phase flows, [among other things](#what-else-can-this-thing-do). 
@@ -127,6 +130,16 @@ And here is a high-amplitude acoustic wave reflecting and emerging through a cir
 
 ## Getting started
 
+You can navigate [to this webpage](https://mflowcode.github.io/documentation/md_getting-started.html) to get you get started using MFC on your local machine, cluster, or supercomputer!
+It's rather straightforward.
+Some examples are below.
+
+### Codespaces and Containers
+
+  <a href="https://github.com/codespaces/new?hide_repo_select=true&ref=master&repo=MFlowCode%2FMFC">
+    <img src="https://img.shields.io/badge/Codespaces-Open%20in%201%20click-2ea44f?logo=github" />
+  </a>
+  
 For a _very_ quick start, open a GitHub Codespace to load a pre-configured Docker container and familiarize yourself with MFC commands.
 Click <kbd> <> Code</kbd> (green button at top right) → <kbd>Codespaces</kbd> (right tab) → <kbd>+</kbd> (create a codespace).
 
@@ -135,18 +148,19 @@ Click <kbd> <> Code</kbd> (green button at top right) → <kbd>Codespaces</kbd>
 > Don't conduct any critical work here!
 > To learn more, please see [how Docker & Containers work](https://mflowcode.github.io/documentation/md_docker.html).
 
-You can navigate [to this webpage](https://mflowcode.github.io/documentation/md_getting-started.html) to get you get started using MFC on your local machine, cluster, or supercomputer!
-It's rather straightforward.
-
 ### macOS quick start (Homebrew)
 
+<a href="https://github.com/MFlowCode/homebrew-mfc">
+<img src="https://img.shields.io/badge/homebrew-mflowcode%2Fmfc%2Fmfc-brown?logo=homebrew&style=flat" />
+</a>
+
 Install the prebuilt package and run an example:
 
 ```bash
 brew install mflowcode/mfc/mfc
 mkdir -p ~/mfc_quickstart && cd ~/mfc_quickstart
 cp $(brew --prefix mfc)/examples/1D_sodshocktube/case.py .
-mfc run case.py -n 2
+mfc case.py -n 2
 ```
 
 Use `-n X` to select the number of MPI processes. For developer commands (`build`, `test`, etc.), clone the repo and use `./mfc.sh`.

docs/documentation/getting-started.md

@@ -23,11 +23,12 @@ Run a quick example:
 mkdir -p ~/mfc_quickstart && cd ~/mfc_quickstart
 cp $(brew --prefix mfc)/examples/1D_sodshocktube/case.py .
 # Use -n X to choose the number of MPI processes
-mfc run case.py -n 2
+mfc case.py -n 2
 ```
 
 Notes:
-- The Homebrew wrapper supports only `mfc run ...`. Developer commands like `build`, `test`, `clean` are available when you clone the repo and use `./mfc.sh`.
+- The Homebrew package uses a simplified syntax: just `mfc <case.py>` to run cases.
+- Developer commands like `build`, `test`, `clean` are available when you clone the repo and use `./mfc.sh`.
 - The package bundles a Python venv and prebuilt binaries; no additional setup is required.
 - Examples are installed at `$(brew --prefix mfc)/examples/`.
 

docs/documentation/running.md

@@ -13,11 +13,11 @@ several supercomputer clusters, both interactively and through batch submission.
 If you installed MFC via Homebrew, run cases with the `mfc` wrapper:
 
 ```bash
-mfc run <path/to/case.py> -n 2
+mfc <path/to/case.py> -n 2
 ```
 
 - Use `-n X` to control the number of MPI processes (ranks).
-- Only the `run` command is supported in the Homebrew wrapper.
+- The Homebrew package uses a simplified syntax: just `mfc <case.py>` to run cases.
 - To use developer commands (`build`, `test`, `clean`, etc.), clone the repository and use `./mfc.sh`.
 - The wrapper passes through runtime flags like `-t pre_process simulation`, `-n`, and others; it always runs with preinstalled binaries.
 - Examples live at `$(brew --prefix mfc)/examples/`.

packaging/homebrew/README.md

@@ -15,7 +15,7 @@ Run the 1D Sod shock tube example:
 ```bash
 mkdir -p ~/mfc_example && cd ~/mfc_example
 cp $(brew --prefix mfc)/examples/1D_sodshocktube/case.py .
-mfc run case.py -n 2
+mfc case.py -n 2
 ```
 
 ## What's Included
@@ -28,12 +28,12 @@ mfc run case.py -n 2
 ## Usage
 
 ```bash
-mfc run <case.py> -n <processes>
+mfc <case.py> -n <processes>
 ```
 
 Use `-n X` to set the number of MPI processes.
 
-**Note**: The Homebrew wrapper supports only `mfc run`. For developer commands (`build`, `test`, `clean`, etc.), [clone the repository](https://github.com/MFlowCode/MFC) and use `./mfc.sh`.
+**Note**: The Homebrew wrapper supports only running cases. For developer commands (`build`, `test`, `clean`, etc.), [clone the repository](https://github.com/MFlowCode/MFC) and use `./mfc.sh`.
 
 ## Documentation
 

packaging/homebrew/mfc.rb

@@ -94,18 +94,17 @@ def install
           fi
         done
 
-        SUBCMD="${ARGS[0]-}"
-
         # Friendly help and guardrails
-        if [[ ${#ARGS[@]} -eq 0 ]] || [[ "${SUBCMD}" == "--help" ]] || [[ "${SUBCMD}" == "-h" ]]; then
+        if [[ ${#ARGS[@]} -eq 0 ]] || [[ "${ARGS[0]-}" == "--help" ]] || [[ "${ARGS[0]-}" == "-h" ]]; then
           cat <<'HHELP'
       MFC (Homebrew) #{version}
 
       Usage:
-        mfc run <case.py> [options]
+        mfc <case.py> [options]
 
       Examples:
-        mfc run case.py -j 1
+        mfc case.py -n 2
+        mfc examples/1D_sodshocktube/case.py -n 2 -t pre_process simulation
 
       Notes:
         - This Homebrew wrapper uses prebuilt binaries and a preinstalled venv.
@@ -115,12 +114,48 @@ def install
           exit 0
         fi
 
-        if [[ "${SUBCMD}" != "run" ]]; then
-          echo "mfc (Homebrew): only 'run' is supported in the Homebrew package."
-          echo "Use 'mfc run <case.py>' or clone the repository for developer commands."
+        # Handle --version flag
+        if [[ "${ARGS[0]-}" == "--version" ]] || [[ "${ARGS[0]-}" == "-v" ]]; then
+          echo "MFC (Homebrew) #{version}"
+          exit 0
+        fi
+
+        # Find first non-flag argument
+        first_nonflag=""
+        for arg in "${ARGS[@]}"; do
+          if [[ "$arg" != -* ]]; then
+            first_nonflag="$arg"
+            break
+          fi
+        done
+
+        # Check if no case file provided
+        if [[ -z "${first_nonflag}" ]]; then
+          echo "mfc (Homebrew): missing case file."
+          echo "Usage: mfc <case.py> [options]"
+          echo "Example: mfc case.py -n 2"
+          exit 2
+        fi
+
+        # Check if user accidentally used 'mfc run' syntax (even with flags before it)
+        if [[ "${first_nonflag}" == "run" ]]; then
+          echo "mfc (Homebrew): The 'run' command is not needed."
+          echo "Usage: mfc <case.py> [options]"
+          echo "Example: mfc case.py -n 2"
           exit 2
         fi
 
+        # Require a readable Python file (not a directory)
+        if [[ ! "${first_nonflag}" =~ .py$ ]] || [[ ! -f "${first_nonflag}" ]]; then
+          echo "mfc (Homebrew): first argument must be a readable Python case file."
+          echo "Given: ${first_nonflag}"
+          echo "Usage: mfc <case.py> [options]"
+          exit 2
+        fi
+
+        # Always prepend "run" since this wrapper only supports running cases
+        ARGS=("run" "${ARGS[@]}")
+
         # Create a temporary working directory (Cellar is read-only)
         TMPDIR="$(mktemp -d)"
         trap 'rm -rf "${TMPDIR}"' EXIT
@@ -218,17 +253,17 @@ def caveats
       MFC has been installed successfully!
 
       To run a case:
-        mfc run <case.py>
+        mfc <case.py> [options]
 
       Pre-built binaries are also available directly:
         pre_process, simulation, post_process
 
       Examples are available in:
         #{prefix}/examples
 
-      Example:
+      Quick start:
         cp #{prefix}/examples/1D_sodshocktube/case.py .
-        mfc run case.py
+        mfc case.py -n 2
 
       Note: Cantera 3.1.0 is pre-installed in the MFC virtual environment.
     EOS