penguins-eggs 10.0.28 → 10.0.31

package/dist/classes/users.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ./src/classes/users.ts
+ * penguins-eggs v.10.0.0 / ecmascript 2020
+ * author: Piero Proietti
+ * email: piero.proietti@gmail.com
+ * license: MIT
+ */
+/**
+ *
+ */
+export default class Users {
+    gecos: string;
+    gid: string;
+    hasHome: boolean;
+    home: string;
+    login: string;
+    password: string;
+    saveIt: boolean;
+    shell: string;
+    size: number;
+    uid: string;
+    constructor(login: string, password: string, uid: string, gid: string, gecos: string, home: string, shell: string);
+    /**
+     * getSize
+     * @param verbose
+     */
+    getValues(): Promise<void>;
+}

package/dist/classes/users.js

@@ -0,0 +1,143 @@
+/**
+ * ./src/classes/users.ts
+ * penguins-eggs v.10.0.0 / ecmascript 2020
+ * author: Piero Proietti
+ * email: piero.proietti@gmail.com
+ * license: MIT
+ */
+import fs from 'node:fs';
+import { exec } from '../lib/utils.js';
+/**
+ *
+ */
+export default class Users {
+    gecos;
+    gid;
+    hasHome;
+    home;
+    login;
+    password;
+    saveIt;
+    shell;
+    size;
+    uid;
+    constructor(login, password, uid, gid, gecos, home, shell) {
+        this.login = login;
+        this.password = password;
+        this.uid = uid;
+        this.gid = gid;
+        this.gecos = gecos;
+        this.home = home;
+        this.shell = shell;
+        this.size = 0;
+        this.hasHome = false;
+        this.saveIt = false;
+    }
+    /**
+     * getSize
+     * @param verbose
+     */
+    async getValues() {
+        const fLevels = [
+            { path: 'bin', saveIt: false },
+            { path: 'boot', saveIt: false },
+            { path: 'dev', saveIt: false },
+            { path: 'etc', saveIt: false },
+            { path: 'lib', saveIt: false },
+            { path: 'lib32,', saveIt: false },
+            { path: 'libx32', saveIt: false },
+            { path: 'lib64', saveIt: false },
+            { path: 'home', saveIt: true },
+            { path: 'media', saveIt: false },
+            { path: 'mnt', saveIt: false },
+            { path: 'opt', saveIt: true },
+            { path: 'proc', saveIt: false },
+            { path: 'root', saveIt: false },
+            { path: 'run', saveIt: false },
+            { path: 'sbin', saveIt: false },
+            { path: 'sys', saveIt: false },
+            { path: 'srv', saveIt: true },
+            { path: 'tmp', saveIt: false },
+            { path: 'usr', saveIt: true },
+            { path: 'var', saveIt: true }
+        ];
+        let hasHome = false;
+        let saveIt = false;
+        let size = 0;
+        // Only users not services
+        if (Number.parseInt(this.uid) >= 1000) {
+            if (this.home != undefined) {
+                /**
+                 * analyze firstLevel and
+                 * excluded to be saved
+                 */
+                const fLevel = this.home.split('/')[1];
+                for (const fLevel_ of fLevels) {
+                    if (fLevel_.path === fLevel) {
+                        saveIt = fLevel_.saveIt;
+                    }
+                }
+                /**
+                 * analize second level
+                 * examples: /var/run, /var/cache, /var/spool, etc
+                 */
+                if (saveIt) {
+                    const sLevel = this.home.split('/')[2];
+                    if (sLevel === 'cache' || sLevel === 'run' || sLevel === 'spool') {
+                        saveIt = false;
+                    }
+                }
+                /**
+                 * exclude to save if home don't exist
+                 */
+                if (!fs.existsSync(this.home)) {
+                    saveIt = false;
+                }
+                /**
+                 * others motivations to exclude
+                 */
+                if (saveIt) {
+                    switch (this.home) {
+                        /**
+                         * exclude always /
+                         */
+                        case '/': {
+                            break;
+                        }
+                        /**
+                         * excludes: under /usr
+                         */
+                        case '/usr/bin':
+                        case '/usr/sbin': {
+                            saveIt = false;
+                            break;
+                        }
+                        /**
+                         * excludes: under var
+                         */
+                        case '/var/backups':
+                        case '/var/lib/colord':
+                        case '/var/lib/geoclue':
+                        case '/var/lib/misc':
+                        case '/var/mail': {
+                            saveIt = false;
+                            break;
+                        }
+                        default: {
+                            if (fs.existsSync(this.home)) {
+                                hasHome = true;
+                                const sizeUser = await exec(` du --block-size=1 --summarize ${this.home} | awk '{print $1}'`, { capture: true, echo: false, ignore: false });
+                                size = Number.parseInt(sizeUser.data);
+                            }
+                            saveIt = true;
+                            break;
+                        }
+                    }
+                }
+            }
+            this.saveIt = saveIt;
+            this.size = size;
+            this.hasHome = hasHome;
+        }
+    }
+}

package/dist/classes/utils.d.ts

@@ -0,0 +1,323 @@
+/**
+* ./src/classes/utils.tsx
+* penguins-eggs v.10.0.0 / ecmascript 2020
+* author: Piero Proietti
+* email: piero.proietti@gmail.com
+* license: MIT
+*/
+/**
+ * Utils: general porpourse utils
+ * @remarks all the utilities
+ */
+export default class Utils {
+    /**
+    * Custom function to sort object keys
+    * @param obj
+    * @returns
+    */
+    static sortObjectKeys(obj: {
+        [key: string]: any;
+    }): {
+        [key: string]: any;
+    };
+    /**
+     *
+     * @param file
+     * @param search
+     * @returns value
+     */
+    static searchOnFile(file?: string, search?: string): string;
+    /**
+     * Restituisce il prefisso della iso
+     * @param distroId
+     * @param codenameId
+     */
+    static snapshotPrefix(distroId: string, codenameId: string): string;
+    /**
+    * Controlla se il sistema è avviato con systemd
+    * funziona anche in MX che utilizza systemd
+    * ma viene avviato con init
+    */
+    static isSystemd(): boolean;
+    /**
+     *
+     * @returns
+     */
+    static isOpenRc(): boolean;
+    /**
+     *
+     * @returns
+     */
+    static isSysvinit(): boolean;
+    /**
+     * ricava path per vmlinuz
+     * Normalmente cerca BOOT_IMAGE
+     * BOOT_IMAGE=/boot/vmlinuz-5.16.0-3-amd64 root=UUID=13768873-d6ba-4ae5-9e14-b5011f5aa31c ro quiet splash resume=UUID=beafb9b4-c429-4e1f-a268-4270b63a14e6
+     * se non è presente, come nel caso di Franco, cerca initrd e ricostruisce vmlinuz
+     * ro root=UUID=3dc0f202-8ac8-4686-9316-dddcec060c48 initrd=boot\initrd.img-5.15.0-0.bpo.3-amd64 // Conidi
+     */
+    static vmlinuz(): string;
+    /**
+     * ricava path per initrdImg
+     */
+    static initrdImg(): string;
+    /**
+     * Occore vedere un modo per creare machine-id dove non esiste
+     */
+    static machineId(): string;
+    /**
+     *
+     * @param msg
+     */
+    static warning(msg?: string): void;
+    static error(msg?: string): void;
+    /**
+     * Return the primary user's name
+     */
+    static getPrimaryUser(): Promise<string>;
+    /**
+     * restituisce uuid
+     * @param device
+     */
+    static uuid(device: string): string;
+    /**
+     *
+     * @param date
+     */
+    static formatDate(date: Date): string;
+    /**
+     * return the name of the package: penguins-eggs
+     * @returns penguins-eggs
+     */
+    static getPackageName(): string;
+    /**
+     * Count the eggs present in the nest
+     * @returns {number} Numero degli snapshot presenti
+     */
+    static getSnapshotCount(snapshot_dir?: string): number;
+    /**
+     * Get the syze of the snapshot
+     * @returns {string} grandezza dello snapshot in Byte
+     */
+    static getSnapshotSize(snapshot_dir?: string): number;
+    /**
+     * uefiArch
+     * @returns arch
+     */
+    static uefiArch(): string;
+    /**
+     * i386-efi,
+     * x86_64-efi,
+     * arm64-efi,
+     */
+    static uefiFormat(): string;
+    /**
+     *
+     * @returns
+     */
+    static uefiBN(): string;
+    /**
+     *
+     * @returns
+     */
+    static usrLibPath(): string;
+    /**
+     *
+     * @param prefix
+     * @param backup
+     * @returns
+     */
+    static getPrefix(prefix: string, backup?: boolean): string;
+    /**
+     *
+     * @param volid
+     */
+    static getVolid(volid?: string): string;
+    /**
+     * Return postfix
+     * @param basename
+     * @returns eggName
+     */
+    static getPostfix(): string;
+    /**
+     * Calculate the space used on the disk
+     * @return {void}
+     */
+    static getUsedSpace(): number;
+    /**
+     * Extimate the linuxfs dimension
+     * probably is better to rename it as
+     * getLiveSpaceRootNeed
+     * @returns {number} Byte
+     */
+    static getLiveRootSpace(type?: string): number;
+    /**
+     * Return true if i686 architecture
+     * @remarks to move in Utils
+     * @returns {boolean} true se l'architettura è i686
+     */
+    static isi686(): boolean;
+    /**
+     * Controlla se è un pacchetto deb
+     * /usr/lib/penguins-eggs/bin/node
+     */
+    static isDebPackage(): boolean;
+    /**
+     * Controlla se è un pacchetto sorgente
+     */
+    static isSources(): boolean;
+    /**
+     * Controlla se è un pacchetto npm
+     */
+    static isNpmPackage(): boolean;
+    /**
+     *
+     */
+    static rootPenguin(): string;
+    /**
+     * return the short name of the package: eggs
+     * @returns eggs
+     */
+    static getFriendName(): string;
+    /**
+     * return the version of the package
+     * @returns version example 8.0.0
+     */
+    static getPackageVersion(): string;
+    /**
+     * Get author name
+     */
+    static getAuthorName(): string;
+    /**
+     * Return the Debian version
+     * @returns {number} Versione di Debian
+     */
+    static getDebianVersion(): number;
+    /**
+     * Return true if live system
+     * @returns {boolean} isLive
+     */
+    static isLive(): boolean;
+    /**
+     * Ritorna vero se path è un mountpoint
+     * @param path
+     */
+    static isMountpoint(path?: string): boolean;
+    /**
+     *
+     * @param device
+     * @returns
+     */
+    static isBlockDevice(device?: string): boolean;
+    /**
+     * return true if eggs run as root
+     * @returns isRoot
+     */
+    static isRoot(command?: string): boolean;
+    /**
+     *
+     * @param command
+     */
+    static useRoot(command?: string): void;
+    /**
+     * get the kernel version
+     */
+    static kernelVersion(): string;
+    /**
+     * return the name of network device
+     */
+    static iface(): Promise<string>;
+    /**
+     * address
+     */
+    static address(): string;
+    /**
+     * netmask
+     */
+    static netmask(): string;
+    /**
+     * cidr
+     */
+    static cidr(): string;
+    /**
+     *
+     * broadcast
+    */
+    static broadcast(): string;
+    /**
+     * dns
+     */
+    static getDns(): string[];
+    /**
+     * getDomain
+     */
+    static getDomain(): string;
+    /**
+     * @returns gateway
+     */
+    static gateway(): string;
+    /**
+     * write a file
+     * @param file
+     * @param text
+     */
+    static write(file: string, text: string): void;
+    /**
+     *
+     * @param file
+     * @param cmd
+     */
+    static writeX(file: string, cmd: string): void;
+    /**
+     *
+     * @param file
+     * @param cmd
+     */
+    static writeXs(file: string, cmds: string[]): void;
+    /**
+     *
+     * @param msg
+     */
+    static customConfirm(msg?: string): Promise<boolean>;
+    /**
+     *
+     * @param msg
+     */
+    static customConfirmCompanion(msg?: string): Promise<any>;
+    /**
+     *
+     * @param msg
+     */
+    static customConfirmAbort(msg?: string): Promise<any>;
+    /**
+     *
+     */
+    static pressKeyToExit(warming?: string, procContinue?: boolean): Promise<void>;
+    /**
+     * titles
+     * Penguin's are gettings alive!
+     */
+    static titles(command?: string): void;
+    /**
+     *
+     * @returns flag
+     */
+    static flag(): string;
+    /**
+     *
+     * @param verbose
+     */
+    static setEcho(verbose?: boolean): object;
+    /**
+     *
+     * @param bytes
+     * @param decimals
+     * @returns
+     */
+    static formatBytes(bytes: number, decimals?: number): string;
+    /**
+     *
+     * @returns wardrobe
+     */
+    static wardrobe(): Promise<string>;
+}