feat: add automatic version updater script

Author: barbaraperic

.github/workflows/update-versions.yml

@@ -0,0 +1,45 @@
+name: Update Lotus Version
+
+on:
+  schedule:
+    - cron: '0 0 * * 1'  # Runs at 00:00 every Monday
+  workflow_dispatch:  # Allows manual trigger
+
+jobs:
+  update-version:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+      
+      - name: Get latest Lotus version
+        id: get-version
+        run: |
+          LATEST_VERSION=$(curl -s https://api.github.com/repos/filecoin-project/lotus/releases/latest | jq -r .tag_name | sed 's/^v//')
+          echo "LATEST_VERSION=$LATEST_VERSION" >> $GITHUB_ENV
+
+      - name: Run update script
+        run: |
+          node update-versions.js ${{ env.LATEST_VERSION }}
+          
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v5
+        with:
+          commit-message: 'chore: update Lotus version references to ${{ env.LATEST_VERSION }}'
+          title: 'chore: update Lotus version references to ${{ env.LATEST_VERSION }}'
+          body: |
+            Automated PR to update Lotus version references to ${{ env.LATEST_VERSION }}
+            
+            This PR updates all references of:
+            - `lotus-X.X.X`
+            - Previous lotus version numbers
+            
+            to `lotus-${{ env.LATEST_VERSION }}`
+            
+            This PR was automatically generated by GitHub Actions.
+          branch: update-lotus-version
+          delete-branch: true

nodes/full-nodes/basic-setup.md

@@ -12,14 +12,14 @@ To install Lotus on your computer, follow these steps:
 2. Once you have downloaded the binary file, extract the contents to a directory of your choice. For example, if you are using Linux, you can extract the contents to the `/usr/local/bin directory` by running the command:
 
 ```sh
-sudo tar -C /usr/local/bin -xzf lotus-X.X.X-linux-amd64.tar.gz
+sudo tar -C /usr/local/bin -xzf lotus-1.31.3-linux-amd64.tar.gz
 ```
 
 3. Replace `X.X.X` with the version number of the release you downloaded.
 4. After extracting the contents, navigate to the `lotus` directory in your terminal. For example, if you extracted the contents to `/usr/local/bin`, you can navigate to the lotus directory by running the command:
 
 ```sh
-cd /usr/local/bin/lotus-X.X.X
+cd /usr/local/bin/lotus-1.31.3
 ```
 
 5. Again, replace `X.X.X` with the version number of the release you downloaded.

package.json

@@ -0,0 +1,21 @@
+{
+  "name": "filecoin-docs",
+  "version": "1.0.0",
+  "description": "<div align=center>",
+  "main": "update-versions.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "update-versions": "node update-versions.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/filecoin-project/filecoin-docs.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/filecoin-project/filecoin-docs/issues"
+  },
+  "homepage": "https://github.com/filecoin-project/filecoin-docs#readme"
+}

update-versions.js

@@ -0,0 +1,62 @@
+const fs = require('fs');
+const path = require('path');
+
+// Get the new version from command line argument
+const NEW_VERSION = process.argv[2];
+
+if (!NEW_VERSION) {
+    console.error('Please provide the new version number as an argument.');
+    console.error('Usage: node script.js <new_version>');
+    console.error('Example: node script.js 1.31.2');
+    process.exit(1);
+}
+
+const getAllFiles = (dirPath, arrayOfFiles = []) => {
+    const files = fs.readdirSync(dirPath);
+
+    files.forEach(file => {
+        const fullPath = path.join(dirPath, file);
+        if (fs.statSync(fullPath).isDirectory()) {
+            if (file !== 'preview') {
+                getAllFiles(fullPath, arrayOfFiles);
+            }
+        } else if (path.extname(file) === '.md') {
+            arrayOfFiles.push(fullPath);
+        }
+    });
+
+    return arrayOfFiles;
+};
+
+function processFiles() {
+    const files = getAllFiles('.');
+    // Regex patterns for both actual versions and X.X.X pattern
+    const versionRegex = /lotus-(\d+\.\d+\.\d+|X\.X\.X)/g;
+
+    files.forEach(file => {
+        try {
+            const content = fs.readFileSync(file, 'utf8');
+            let processed = content;
+            
+            // Find all version patterns in the file
+            const matches = content.match(versionRegex);
+            if (matches) {
+                matches.forEach(oldVersionString => {
+                    const newVersionString = `lotus-${NEW_VERSION}`;
+                    processed = processed.replace(oldVersionString, newVersionString);
+                });
+                
+                if (content !== processed) {
+                    fs.writeFileSync(file, processed);
+                    console.log(`Updated versions in: ${file}`);
+                    console.log(`Found patterns: ${matches.join(', ')}`);
+                    console.log(`Updated to: lotus-${NEW_VERSION}`);
+                }
+            }
+        } catch (error) {
+            console.error(`Error processing ${file}:`, error);
+        }
+    });
+}
+
+processFiles();