Merge branch 'develop'

* develop: (36 commits)
  specify the next release version
  fix documentation
  add changelog
  flag facades as internal
  fix minimum version of psalm
  remove wired memory as it seems to be macOS specific
  Revert "debug linux memory"
  debug linux memory
  declare thrown exceptions
  test against lowest dependencies
  test against php 8.1
  change email
  use symfony/process 6
  use CS 2
  use latest innmind versions
  remove use of an exception
  CS
  remove unparseable elements instead of throwing an exception
  use own exception
  fix linux tests
  ...

Author: Baptouuuu

.github/workflows/ci.yml

@@ -8,7 +8,8 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macOS-latest]
-        php-version: ['7.4', '8.0']
+        php-version: ['8.0', '8.1']
+        dependencies: ['lowest', 'highest']
     name: 'PHPUnit'
     steps:
       - name: Checkout
@@ -29,7 +30,11 @@ jobs:
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           restore-keys: ${{ runner.os }}-composer-
       - name: Install Dependencies
-        run: composer install
+        if: ${{ matrix.dependencies == 'lowest' }}
+        run: composer update --prefer-lowest --no-progress
+      - name: Install Dependencies
+        if: ${{ matrix.dependencies == 'highest' }}
+        run: composer install --no-progress
       - name: PHPUnit
         run: vendor/bin/phpunit --coverage-clover=coverage.clover
       - uses: codecov/codecov-action@v1
@@ -39,7 +44,8 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        php-version: ['7.4', '8.0']
+        php-version: ['8.0', '8.1']
+        dependencies: ['lowest', 'highest']
     name: 'Psalm'
     steps:
       - name: Checkout
@@ -59,14 +65,18 @@ jobs:
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.json') }}
           restore-keys: ${{ runner.os }}-composer-
       - name: Install Dependencies
-        run: composer install
+        if: ${{ matrix.dependencies == 'lowest' }}
+        run: composer update --prefer-lowest --no-progress
+      - name: Install Dependencies
+        if: ${{ matrix.dependencies == 'highest' }}
+        run: composer install --no-progress
       - name: Psalm
         run: vendor/bin/psalm --shepherd
   cs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        php-version: ['7.4']
+        php-version: ['8.0']
     name: 'CS'
     steps:
       - name: Checkout
@@ -88,4 +98,4 @@ jobs:
       - name: Install Dependencies
         run: composer install --no-progress
       - name: CS
-        run: vendor/bin/php-cs-fixer fix --diff --dry-run --diff-format udiff
+        run: vendor/bin/php-cs-fixer fix --diff --dry-run

.php_cs.dist .php-cs-fixer.dist.php.php_cs.dist renamed to .php-cs-fixer.dist.php

@@ -0,0 +1,31 @@
+# Changelog
+
+## 3.0.0 - 2022-01-23
+
+### Added
+
+- `Innmind\Server\Status\Server\Process\Pid::equals()`
+- `Innmind\Server\Status\Server\Process\Pid::is()`
+- `Innmind\Server\Status\Server\Disk\Volume\MountPoint::equals()`
+- `Innmind\Server\Status\Server\Disk\Volume\MountPoint::is()`
+
+### Changed
+
+- `Innmind\Server\Status\Server\Processes::all()` now returns `Innmind\Immutable\Set<Innmind\Server\Status\Server\Process>`
+- `Innmind\Server\Status\Server\Processes::get()` now returns `Innmind\Immutable\Maybe<Innmind\Server\Status\Server\Process>` instead of throwing an exception
+- `Innmind\Server\Status\Server\Process::start()` now returns `Innmind\Immutable\Maybe<Innmind\TimeContinuum\PointInTime>`
+- `Innmind\Server\Status\Server\Memory\Bytes::of()` now returns `Innmind\Immutable\Maybe<Innmind\Server\Status\Server\Memory\Bytes>` instead of throwing an exception
+- `Innmind\Server\Status\Server\Disk::volumes()` now return `Innmind\Immutable\Set<Innmind\Server\Status\Server\Disk\Volume>`
+- `Innmind\Server\Status\Server\Disk::get()` now return `Innmind\Immutable\Maybe<Innmind\Server\Status\Server\Disk\Volume>` instead of throwing an exception
+- `Innmind\Server\Status\Server::cpu()` now returns `Innmind\Immutable\Maybe<Innmind\Server\Status\Server\Cpu>` instead of throwing an exception
+- `Innmind\Server\Status\Server::memory()` now returns `Innmind\Immutable\Maybe<Innmind\Server\Status\Server\Memory>` instead of throwing an exception
+
+### Removed
+
+- `Innmind\Server\Status\Servers\Decorator\CacheMemory`
+- `Innmind\Server\Status\Servers\Decorator\CacheLoadAverage`
+- `Innmind\Server\Status\Servers\Decorator\CacheCpu`
+- `Innmind\Server\Status\ServerFactory::__invoke()`
+- `Innmind\Server\Status\Server\Memory\Bytes` public constants
+- `Innmind\Server\Status\Server\Memory::wired()`
+- Support for php 7

CHANGELOG.md

@@ -26,34 +26,53 @@ use Innmind\TimeContinuum\Earth\Clock;
 
 $server = ServerFactory::build(new Clock);
 
-$server->cpu()->user(); //percentage of the cpu used by the user
-$server->cpu()->system(); //percentage of the cpu used by the system
-$server->cpu()->idle(); //percentage of the cpu not used
-$server->cput()->cores(); //number of cores available
-
-$server->memory()->total(); //total memory of the server
-$server->memory()->wired(); //memory that cannot be taken out of ram
-$server->memory()->active(); //memory that is used by processes
-$server->memory()->free(); //memory that is not used
-$server->memory()->swap(); //memory that is used and located on disk
-$server->memory()->used(); //total - free
+$server->cpu()->match(
+    function($cpu) {
+        $cpu->user(); // percentage of the cpu used by the user
+        $cpu->system(); // percentage of the cpu used by the system
+        $cpu->idle(); // percentage of the cpu not used
+        $cpu->cores(); // number of cores available
+    },
+    fn() => null, // unable to retrieve the cpu information
+);
+
+$server->memory()->match(
+    function($memory) {
+        $memory->total(); // total memory of the server
+        $memory->active(); // memory that is used by processes
+        $memory->free(); // memory that is not used
+        $memory->swap(); // memory that is used and located on disk
+        $memory->used(); // total - free
+    },
+    fn() => null, // unable to retrieve the memory information
+);
 
 $server->loadAverage()->lastMinute();
 $server->loadAverage()->lastFiveMinutes();
 $server->loadAverage()->lastFifteenMinutes();
 
-$server->disk()->get(new MountPoint('/'))->size(); //total size of the volume
-$server->disk()->get(new MountPoint('/'))->available();
-$server->disk()->get(new MountPoint('/'))->used();
-$server->disk()->get(new MountPoint('/'))->usage(); //percentage of space being used
-
-$server->processes()->get(new Pid(1))->user(); //root in this case
-$server->processes()->get(new Pid(1))->cpu(); //percentage
-$server->processes()->get(new Pid(1))->memory(); //percentage
-$server->processes()->get(new Pid(1))->start(); //point in time at which the process started
-$server->processes()->get(new Pid(1))->command();
-
-$server->tmp(); //path to temp directory
+$server->disk()->get(new MountPoint('/'))->match(
+    function($disk) {
+        $disk->size(); // total size of the volume
+        $disk->available();
+        $disk->used();
+        $disk->usage(); // percentage of space being used
+    },
+    fn() => null, // the mount point doesn't exist
+);
+
+$server->processes()->get(new Pid(1))->match(
+    function($process) {
+        $process->user(); // root in this case
+        $process->cpu(); // percentage
+        $process->memory(); // percentage
+        $process->start(); // point in time at which the process started
+        $process->command();
+    },
+    fn() => null, // the process doesn't exist
+);
+
+$server->tmp(); // path to temp directory
 ```
 
 You can easily log all the informations gathered via a simple decorator:

README.md

@@ -7,19 +7,19 @@
     "authors": [
         {
             "name": "Baptiste Langlade",
-            "email": "langlade.baptiste@gmail.com"
+            "email": "baptiste.langlade@hey.com"
         }
     ],
     "support": {
         "issues": "http://github.com/Innmind/ServerStatus/issues"
     },
     "require": {
-        "php": "~7.4|~8.0",
-        "innmind/immutable": "~3.0",
-        "innmind/time-continuum": "~2.0",
-        "symfony/process": "~4.0|~5.0",
-        "innmind/url": "~3.0",
-        "psr/log": "^1.1"
+        "php": "~8.0",
+        "innmind/immutable": "~4.0",
+        "innmind/time-continuum": "~3.0",
+        "symfony/process": "~6.0",
+        "innmind/url": "~4.0",
+        "psr/log": "~3.0"
     },
     "autoload": {
         "psr-4": {
@@ -33,7 +33,7 @@
     },
     "require-dev": {
         "phpunit/phpunit": "~9.0",
-        "vimeo/psalm": "~4.1",
-        "innmind/coding-standard": "^1.0"
+        "vimeo/psalm": "~4.9",
+        "innmind/coding-standard": "~2.0"
     }
 }