superuser 0.1.0

Detect, verify user who execute Flutter program has superuser role and running with superuser permission.

Superuser detection for Flutter desktop application

Superuser is a special user, who granted as much as possible to access system files for maintenance purpose. Different systems has different names to refer superuser (e.g. root in various UNIX system and Administrator in Windows).

Although pub.dev has numerous of packages to detect superuser, they are designed for Android and some packages added iOS support already. Hence, these package may become bulky because of unnessary callbacks along with detection.

Instead, superuser package offers superuser detection in Flutter desktop as well as return username who opened an application.

Implementations

Production

No additional setup needed.

Testing or simulating with mock interface

For testing, MockSuperuser must be binded already before performing widget test:

import 'package:flutter_test/flutter_test.dart';
import 'package:superuser/instance.dart' as su_inst show bindInstance;
import 'package:superuser/mock.dart';

void main() {
    setUpAll(() {
        // Bind mock instance here
        su_inst.bindInstance(MockSuperuser(whoAmI: "reonaw"));
    });
    // Do any testes below
}

If using for debug simulation, mock interface must be binded before runApp:

import 'package:flutter/widgets.dart';
import 'package:superuser/instance.dart' as su_inst show bindInstance;
import 'package:superuser/mock.dart';

void main() {
    su_inst.bindInstance(MockSuperuser(whoAmI: "raisushawaa", isSuperuser: true, isActivated: true));

    runApp(const YourApp());
}

When using MockSuperuser, ensure isActivated cannot be satisified if isSuperuser is false. Assign this mock data will cause assertion error when constructing mock interface:

import 'package:superuser/instance.dart' as su_inst show bindInstance;
import 'package:superuser/mock.dart';

void main() {
    su_inst.bindInstance(
        // AssertionError will be thrown
        MockSuperuser(whoAmI: "yuunagit", isActivated: true)
    );
}

Demo

Demo application of superuser has been available in release page in Windows and Linux application.

Open without superuser right

Open with superuser right

License

BSD-3