remove Commands.chpl from tree

arkouda-env-dev.yml

@@ -23,6 +23,7 @@ dependencies:
   - scipy<=1.13.1
   - pytest>=6.0
   - pytest-env
+  # - chapel-py
 
   # Developer dependencies
   - pexpect
@@ -49,4 +50,3 @@ dependencies:
     - furo # sphinx theme
     - myst-parser
     - linkify-it-py
-

arkouda-env.yml

@@ -23,6 +23,7 @@ dependencies:
   - scipy<=1.13.1
   - pytest>=6.0
   - pytest-env
+  # - chapel-py
 
   - pip:
       - typeguard==2.10.0

pydoc/requirements.txt

@@ -20,6 +20,7 @@ jupyter
 scipy<=1.13.1
 pytest>=6.0
 pytest-env
+# chapel-py
 
 # Developer dependencies
 pexpect

pydoc/setup/BUILD.md

@@ -47,6 +47,18 @@ Location: /opt/homebrew/Caskroom/miniforge/base/envs/arkouda/lib/python3.12/site
 
 The `chpl` compiler will be executed with `-I`, `-L` and `-rpath` for each path in your `Makefile.paths`
 
+#### installing the `chapel-py` dependency
+
+Next, the `chpl` compiler's frontend Python bindings (aka `chapel-py`) need to be installed. This is a Python library that gives Arkouda's build system access to the Chapel compiler's frontend, which is used to support Arkouda's command-registration annotations. The library can be installed using the following command:
+
+```
+(cd $CHPL_HOME && make chapel-py-venv)
+```
+
+This adds `chapel-py` to a Python environment shipped with Chapel. When building Arkouda, that environment will be invoked temporarily to use `chapel-py`. To manually build and install `chapel-py` in your Python or Anaconda environment, see the instructions in the next section.
+
+Note: if the above command fails (potentially due to a stale virtual environment), try running `make clobber` from `$CHPL_HOME/third-party/chpl-venv`, and then rerun the above command.
+
 ### Installing Dependencies Manually
 
 *Please Note: This step is to only be performed if you are NOT using dependencies from a conda/pip env. If you attempt to use both, it is possible that version mismatches will cause build failures*.
@@ -120,6 +132,14 @@ pip install dist/arkouda*.whl
 pip install dist/arkouda*.tar.gz
 ```
 
+#### installing the `chapel-py` dependency manually
+
+To manually install `chapel-py`, navigate to `$CHPL_HOME/tools/chapel-py/`, and:
+
+```
+pip install -e .
+```
+
 ## Build the Server
 
 Run the `make` command to build the `arkouda_server` executable.

pydoc/setup/REQUIREMENTS.md

@@ -38,6 +38,7 @@ The following python packages are required by the Arkouda client package.
 - `scipy<=1.13.1`
 - `pytest>=6.0`
 - `pytest-env`
+- `chapel-py` (to be installed manually, as it is shipped with Chapel)
 
 ### Developer Specific
 

setup.py

@@ -129,6 +129,7 @@
         "tables>=3.8.0",
         "pyarrow",
         "scipy<=1.13.1",
+        # chapel-py
     ],
     # List additional groups of dependencies here (e.g. development
     # dependencies). Users will be able to install these using the "extras"

src/registry/.gitignore

@@ -0,0 +1 @@
+Commands.chpl

src/registry/register_commands.bash

@@ -16,11 +16,11 @@ then
     :
 else
     # if not sucessfull (likely due to mismatched python version), try again with the current python environment
-    echo "...attempting to use chapel-py bindings from existing environment instead"
     if python3 $1/register_commands.py $2 $3 $4;
     then
         :
     else
-        echo "Unable to register commands; falling back to default 'Commands.chpl' file"
+        echo "Unable to register commands; make sure 'chapel-py' is installed"
+        exit 1
     fi
 fi