Merge branch 'master' into issues/57-move-logger-call-in-subroutine

Author: devkapilbansal

.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: [openwisp]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: ["https://openwisp.org/sponsorship/"]

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,29 @@
+---
+name: Bug report
+about: Open a bug report
+title: "[bug] "
+labels: bug
+assignees: ""
+---
+
+**Describe the bug**
+A clear and concise description of the bug or unexpected behavior.
+
+**Steps To Reproduce**
+Steps to reproduce the behavior:
+
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**System Informatioon:**
+
+- OS: [e.g. Ubuntu 24.04 LTS]
+- OpenWrt Version: [e.g. OpenWrt 23.05]

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: "[feature] "
+labels: enhancement
+assignees: ""
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,11 @@
+---
+name: Question
+about: Please use the Discussion Forum to ask questions
+title: "[question] "
+labels: question
+assignees: ""
+---
+
+Please use the [Discussion Forum](https://github.com/orgs/openwisp/discussions) to ask questions.
+
+We will take care of moving the discussion to a more relevant repository if needed.

.github/dependabot.yml

@@ -0,0 +1,14 @@
+---
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions" # Check for GitHub Actions updates
+    directory: "/" # The root directory where the Ansible role is located
+    schedule:
+      interval: "monthly" # Check for updates monthly
+    commit-message:
+      prefix: "[ci] "

.github/pull_request_template.md

@@ -0,0 +1,20 @@
+## Checklist
+
+- [ ] I have read the [OpenWISP Contributing Guidelines](http://openwisp.io/docs/developer/contributing.html).
+- [ ] I have manually tested the changes proposed in this pull request.
+- [ ] I have written new test cases for new code and/or updated existing tests for changes to existing code.
+- [ ] I have updated the documentation.
+
+## Reference to Existing Issue
+
+Closes #<issue-number>.
+
+Please [open a new issue](https://github.com/openwisp/openwrt-openwisp-monitoring/issues/new/choose) if there isn't an existing issue yet.
+
+## Description of Changes
+
+Please describe these changes.
+
+## Screenshot
+
+Please include any relevant screenshots.

.github/workflows/ci.yml

@@ -1,4 +1,4 @@
-name: OpenWRT OPENWISP MONITORING CI Build
+name: OpenWrt OpenWISP Monitoring CI Build
 
 on:
   push:
@@ -11,39 +11,43 @@ on:
 jobs:
   tests:
     name: QA-Checks and Tests
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v6
         with:
           ref: ${{ github.event.pull_request.head.sha }}
 
       - name: Set up Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v6
         with:
-          python-version: 3.7
+          # This limitation can be removed once docstrfmt
+          # is upgraded to 2.0.0 or higher (in openwisp-utils).
+          python-version: "3.13"
 
-      - name: Install Python dependencies
-        run: pip install openwisp-utils[qa]>=0.7
-
-      - name: Install Development dependencies
-        run: sudo ./install-dev.sh
+      - name: Install dependencies
+        id: deps
+        run: |
+          pip install "openwisp-utils[qa]~=1.2.1"
+          sudo ./install-dev.sh
 
       - name: QA-Checks
         run: ./run-qa-checks
         env:
           CI: 1
 
       - name: Run sh-checker
-        uses: luizm/action-sh-checker@master
+        uses: luizm/action-sh-checker@v0.9.0
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         with:
           sh_checker_comment: true
 
       - name: Tests
+        if: ${{ !cancelled() && steps.deps.conclusion == 'success' }}
         run: ./runtests
 
       - name: Upload Coverage
+        if: ${{ success() }}
         run: |
           cd openwisp-monitoring/tests
           luacov-coveralls -v
@@ -52,25 +56,24 @@ jobs:
 
   build:
     name: Build and upload package as artifacts
-    needs: tests
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     env:
-      BUILD_DIR: '/home/runner/work/build'
-      DOWNLOADS_DIR: '/home/runner/work/downloads'
+      BUILD_DIR: "/home/runner/work/build"
+      DOWNLOADS_DIR: "/home/runner/work/downloads"
       CORES: 2
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v6
         with:
           ref: ${{ github.event.pull_request.head.sha }}
 
-      - name: Cache OpenWRT dependencies
+      - name: Cache OpenWrt dependencies
         id: cache
-        uses: actions/cache@v2
+        uses: actions/cache@v5
         env:
           cache-name: cache-openwrt-dependencies
         with:
-          path: '/home/runner/work/build'
+          path: "/home/runner/work/build"
           key: ${{ runner.os }}-build-${{ env.cache-name }}
 
       - name: Set Environment
@@ -87,17 +90,24 @@ jobs:
           CI_CACHE: ${{ steps.cache.outputs.cache-hit }}
 
       - name: Upload packages as artifacts
-        uses: actions/upload-artifact@v2
+        if: ${{ github.event_name=='push' }}
+        uses: actions/upload-artifact@v6
         with:
           name: Packages
           path: "${{ env.DOWNLOADS_DIR }}/${{ env.START_TIME }}"
 
-      - name: Setup Google Cloud
-        uses: google-github-actions/setup-gcloud@v0
+      - name: Google Cloud Auth
+        if: ${{ github.event_name=='push' }}
+        uses: "google-github-actions/auth@v3"
+        with:
+          project_id: ${{ secrets.GCS_PROJECT_ID }}
+          credentials_json: ${{ secrets.GCS_DOWNLOADS_SERVICE_ACCOUNT_JSON }}
+
+      - name: Google Cloud Setup
+        if: ${{ github.event_name=='push' }}
+        uses: google-github-actions/setup-gcloud@v3
         with:
-          service_account_key: ${{ secrets.GCS_DOWNLOADS_SERVICE_ACCOUNT_JSON }}
           project_id: ${{ secrets.GCS_PROJECT_ID }}
-          export_default_credentials: true
 
       - name: Upload compiled packages to downloads.openwisp.io
         if: ${{ github.event_name=='push' }}

CHANGELOG.rst

@@ -1,19 +1,94 @@
 Change log
-^^^^^^^^^^
+==========
+
+0.3.0 [2025-10-27]
+------------------
+
+Bugfixes
+~~~~~~~~
+
+- Switch to portable df output (df -P) `#153
+  <https://github.com/openwisp/openwrt-openwisp-monitoring/issues/153>`_.
+- Fixed issue where WiFi client data was sent even when no clients were
+  connected.
+- Added check to ensure data file exists before sending to prevent errors
+  `#102
+  <https://github.com/openwisp/openwrt-openwisp-monitoring/issues/102>`_.
+- Ignored duplicate IP addresses in network configuration.
+
+0.2.1 [2024-11-07]
+------------------
+
+Bugfixes
+~~~~~~~~
+
+- Fixed compiling the package without the ``rpcd-mod-iwinfo`` dependency.
+
+0.2.0 [2024-09-25]
+------------------
+
+Features
+~~~~~~~~
+
+- Added ``bootup_delay`` option to control delay before the agent starts
+  on boot.
+- Restart the agent when ``openwisp-config`` starts or restarts to ensure
+  configuration consistency.
+- Added ``htmode`` to wireless interface stats for enhanced monitoring.
+- Added bitrate, quality, and connected AP information for wireless
+  "station" mode.
+- Added support for using the ``cacert`` and ``capath`` configuration
+  options defined in the ``openwisp-config`` configuration file for
+  ``curl`` command.
+- Allowed compiling the package without the ``rpcd-mod-iwinfo``
+  dependency. This is beneficial for space-constrained devices that do not
+  have a WiFi card.
+
+Changes
+~~~~~~~
+
+- Allowed WireGuard protocol to be used as a virtual interface type.
+- Improved sending of accumulated data by adding a random pause after
+  every 10 successful requests.
+- Enhanced mesh station information handling.
+- Stopped sending data after receiving repeated 404 responses to prevent
+  unnecessary retries.
+- Skipped adding the wireless section if the WiFi channel is not
+  available.
+
+Backward incompatible
++++++++++++++++++++++
+
+- Implemented a randomized backoff mechanism for HTTP requests, replacing
+  the previous exponential backoff approach.
+
+Bugfixes
+~~~~~~~~
+
+- Applied a workaround for devices that incorrectly report zero CPUs,
+  ensuring at least one CPU is assumed.
+- Prevented the addition of bridge members when the list is empty to avoid
+  unnecessary configurations.
+- Discarded data when receiving a bad request response from the server to
+  avoid re-sending corrupted data.
+- Used the correct device network section for STP on OpenWrt versions
+  greater than 21.
+- Skipped adding empty DHCP lease tables to avoid unnecessary data
+  processing.
+- Avoided including mobile signal data if it is not available.
 
 0.1.1 [2022-06-08]
-==================
+------------------
 
 - Fixed crash when ULA prefix is not available
 
 0.1.0 [2022-05-10]
-==================
+------------------
 
 First release. Features:
 
 - ``netjson-monitoring`` package
 - ``openwisp-monitoring`` package
-- resilient metric sending:
-  when the device cannot communicate with the server, the metrics are
-  stored in memory until there's enough free memory and sent later
-  when the communication is established again
+- resilient metric sending: when the device cannot communicate with the
+  server, the metrics are stored in memory until there's enough free
+  memory and sent later when the communication is established again

CONTRIBUTING.rst

@@ -1 +1,2 @@
-Please refer to the `Contribution Guidelines <http://openwisp.io/docs/developer/contributing.html>`_.
+Please refer to the `Contribution Guidelines
+<http://openwisp.io/docs/developer/contributing.html>`_.