MFlowCode · sbryngelson · Nov 12, 2025 · Nov 4, 2025 · Nov 4, 2025 · Nov 4, 2025
@@ -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!"
 

@@ -102,10 +102,12 @@ def install
       MFC (Homebrew) #{version}
 
       Usage:
+        mfc <case.py> [options]
         mfc run <case.py> [options]
 
       Examples:
-        mfc run case.py -j 1
+        mfc case.py -n 2
+        mfc run case.py -n 2 -t pre_process simulation
 
       Notes:
         - This Homebrew wrapper uses prebuilt binaries and a preinstalled venv.
@@ -115,9 +117,15 @@ def install
           exit 0
         fi
 
+        # Smart detection: if first arg looks like a case file, auto-prepend "run"
+        if [[ "${SUBCMD}" =~ .py$ ]] || [[ -f "${SUBCMD}" ]]; then
-        if [[ "${SUBCMD}" =~ .py$ ]] || [[ -f "${SUBCMD}" ]]; then
+        if [[ "${SUBCMD}" =~ \.py$ ]] || [[ -f "${SUBCMD}" ]]; then
-        if [[ "${SUBCMD}" =~ .py$ ]] || [[ -f "${SUBCMD}" ]]; then
+        if [[ "${SUBCMD}" =~ \.py$ ]]; then
-        if [[ "${SUBCMD}" =~ .py$ ]] || [[ -f "${SUBCMD}" ]]; then
+        if [[ "${SUBCMD}" =~ \.py$ ]] || [[ -f "${SUBCMD}" ]]; then
-        if [[ "${SUBCMD}" =~ .py$ ]] || [[ -f "${SUBCMD}" ]]; then
+        if [[ "${SUBCMD}" =~ \.py$ ]]; then
+          ARGS=("run" "${ARGS[@]}")
+          SUBCMD="run"
+        fi
-        # Smart detection: if first arg looks like a case file, auto-prepend "run"
-        if [[ "${SUBCMD}" =~ .py$ ]] || [[ -f "${SUBCMD}" ]]; then
-          ARGS=("run" "${ARGS[@]}")
-          SUBCMD="run"
-        fi
+        # Smart detection: if 'run' is not specified, find a case file and prepend 'run'
+        if [[ "${SUBCMD}" != "run" ]]; then
+          for arg in "${ARGS[@]}"; do
+            # If we find an argument that is a file and not an option, prepend "run"
+            if [[ ! "${arg}" =~ ^- ]] && ([[ "${arg}" =~ \.py$ ]] || [[ -f "${arg}" ]]); then
+              ARGS=("run" "${ARGS[@]}")
+              SUBCMD="run"
+              break
+            fi
+          done
+        fi
-        # Smart detection: if first arg looks like a case file, auto-prepend "run"
-        if [[ "${SUBCMD}" =~ .py$ ]] || [[ -f "${SUBCMD}" ]]; then
-          ARGS=("run" "${ARGS[@]}")
-          SUBCMD="run"
-        fi
+        # Smart detection: if 'run' is not specified, find a case file and prepend 'run'
+        if [[ "${SUBCMD}" != "run" ]]; then
+          for arg in "${ARGS[@]}"; do
+            # If we find an argument that is a file and not an option, prepend "run"
+            if [[ ! "${arg}" =~ ^- ]] && ([[ "${arg}" =~ \.py$ ]] || [[ -f "${arg}" ]]); then
+              ARGS=("run" "${ARGS[@]}")
+              SUBCMD="run"
+              break
+            fi
+          done
+        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."
+          echo "Use 'mfc <case.py>' or clone the repository for developer commands."
           exit 2
         fi
 
@@ -218,17 +226,18 @@ def caveats
       MFC has been installed successfully!
 
       To run a case:
-        mfc run <case.py>
+        mfc <case.py>
+        mfc run <case.py>  (explicit form)
 
       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