Synchronize with develop

.github/workflows/dependencies-macos.sh

@@ -2,9 +2,7 @@
 
 set -eu -o pipefail
 
-export HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK=FALSE
-
-brew install open-mpi automake
+brew install open-mpi automake m4 libtool
 
 # libfabric
 wget https://github.com/ofiwg/libfabric/archive/refs/tags/v1.15.2.tar.gz

.github/workflows/gitlab-develop.yml

@@ -0,0 +1,28 @@
+name: GitLab
+
+on:
+  push:
+    branches:
+      - develop
+
+jobs:
+  sync-with-gitlab:
+    runs-on: ubuntu-latest
+    timeout-minutes: 2
+
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Setup git
+        run: |
+          git config --global user.name "PDC BOT"
+          git config --global user.email "pdc@example.com"
+
+      - name: Update branch
+        run: |
+          git fetch origin develop
+          git remote add gitlab https://${{ secrets.GITLAB_TOKEN_NAME }}:${{ secrets.GITLAB_TOKEN }}@${{ secrets.GITLAB_URL }}
+          git checkout develop
+          git push -f gitlab -u develop

.github/workflows/gitlab-stable.yml

@@ -0,0 +1,28 @@
+name: GitLab
+
+on:
+  push:
+    branches:
+      - stable
+
+jobs:
+  sync-with-gitlab:
+    runs-on: ubuntu-latest
+    timeout-minutes: 2
+
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Setup git
+        run: |
+          git config --global user.name "PDC BOT"
+          git config --global user.email "pdc@example.com"
+
+      - name: Update branch
+        run: |
+          git fetch stable
+          git remote add gitlab https://${{ secrets.GITLAB_TOKEN_NAME }}:${{ secrets.GITLAB_TOKEN }}@${{ secrets.GITLAB_URL }}
+          git checkout stable
+          git push -f gitlab -u stable

.github/workflows/macos.yml

@@ -33,4 +33,4 @@ jobs:
           sudo sh -c 'echo "`ipconfig getifaddr en0` PDC" >> /etc/hosts'
           sudo scutil --set HostName PDC
           export HG_TRANSPORT="sockets"
-          ctest -L serial
+          ctest -L serial --output-on-failure

.github/workflows/ubuntu-cache-profiling.yml

@@ -0,0 +1,31 @@
+name: Ubuntu (profiling)
+
+on:
+  pull_request:
+    branches: [ stable, develop ]
+
+  push:
+    branches: [ stable, develop ]
+
+  workflow_dispatch:
+
+jobs:
+  PDC:
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Dependencies
+        run: .github/workflows/dependencies-linux.sh
+
+      - name: Build PDC
+        run: |
+          mkdir build && cd build
+          cmake ../ -DBUILD_MPI_TESTING=ON -DBUILD_SHARED_LIBS=ON -DPDC_SERVER_CACHE=ON -DBUILD_TESTING=ON -DPDC_ENABLE_MPI=ON -DPDC_ENABLE_PROFILING=ON -DCMAKE_C_COMPILER=mpicc -DCMAKE_POLICY_VERSION_MINIMUM=3.5
+          make -j2
+
+      - name: Test PDC
+        working-directory: build
+        run: ctest -L serial --output-on-failure

.github/workflows/ubuntu-cache.yml

@@ -28,4 +28,4 @@ jobs:
 
       - name: Test PDC
         working-directory: build
-        run: ctest -L serial
+        run: ctest -L serial --output-on-failure

.github/workflows/ubuntu-no-cache.yaml

@@ -28,4 +28,4 @@ jobs:
 
       - name: Test PDC
         working-directory: build
-        run: ctest -L serial
+        run: ctest -L serial --output-on-failure

README.md

@@ -15,7 +15,7 @@ Proactive Data Containers (PDC) software provides an object-focused data managem
 
 Full documentation of PDC with installation instructions, code examples for using PDC API, and research publications are available at [pdc.readthedocs.io](https://pdc.readthedocs.io)
 
-More information and publications on PDC is available at https://sdm.lbl.gov/pdc
+More information and publications on PDC are available at https://sdm.lbl.gov/pdc
 
 If you use PDC in your research, please use the following citations:
 

docs/.gitignore

@@ -0,0 +1,2 @@
+_build
+html

docs/README.md

@@ -0,0 +1,44 @@
+# PDC Documentation
+
+This walks you through setting up a local environment
+for building the PDC project documentation.
+
+---
+
+## Requirements
+
+Ensure the following versions are installed on your system. Other versions
+may also work but have not been tested.
+
+- **Python 3.8.18**
+- **pip 25.0.1**
+- **Doxygen 1.13.2**
+
+You can check the versions with:
+> ```bash
+> python3.8 --version
+> pip --version
+> doxygen --version
+> ```
+
+---
+
+## Setup Instructions
+
+### 1. Clone the repository (if not already)
+```bash
+git clone https://github.com/hpc-io/pdc.git
+cd pdc/docs
+```
+
+### 2. Create Python environment install dependencies
+```bash
+python3.8 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+### 3. Build the html
+```bash
+python -m sphinx -T -b html -d _build/doctrees -D language=en source html
+```