txt: ## dist_zef-tbrowder-QueryOS.md
  [![Actions Status](https://github.com/tbrowder/QueryOS/actions/workflows/linux.yml/badge.svg)](https://github.com/tbrowder/QueryOS/actions) [![Actions Status](https://github.com/tbrowder/QueryOS/actions/workflows/macos.yml/badge.svg)](https://github.com/tbrowder/QueryOS/actions) [![Actions Status](https://github.com/tbrowder/QueryOS/actions/workflows/windows.yml/badge.svg)](https://github.com/tbrowder/QueryOS/actions)
  
  # NAME
  
  **QueryOS** - Provides a class and an executable, `query-os`, to list OS details
  
  # SYNOPSIS
  
  ```
  use QueryOS;
  my $o = OS.new;
  say $o.version-name # OUTPUT: «debian␤»
  
  ```
  
  # DESCRIPTION
  
  **QueryOS** is a module that provides a class, `OS`, with methods and attributes to simplify module authors' porting their work to various operating systems by identifying important system discriminators. The module relies on the attributes of Raku's `$*USER`, `$*DISTRO`, and `$*KERNEL` variables and parses out additional details in parts of those attributes.
  
  Current attributes and methods are:
  
  * name - from `$*DISTRO.name`
  * version - from `$*DISTRO.version`
  * version-name - text part of `$*DISTRO.name`
  * version-serial - number part of `$*DISTRO.name`
  * is-linux
  * is-windows
  * is-macos
  
  # List of known DISTRO names:
  
  * debian
  * gentoo
  * macos
  * mswin
  * suse
  * ubuntu
  
  # Example binary use
  
  When I execute `query-os q` on my system I get:
  
  ```
  This program is currently running on:
  
      Host:           bigtom
      User:           tbrowde
      Distro:         debian*
      Version name:   bullseye
      Version number: 11
      System:         x86_64
  
  This module provides class 'OS' whose attributes
  provide details of the system to aid module
  authors porting to multiple versions. See the
  README for more information or use the 'list'
  option to this program.
  
  *NOTE: If the 'Distro' name is not recognized,
         it will be so stated in parentheses
         following the reported name.
  
  ```
  
  # AUTHOR
  
  Tom Browder [tbrowder@acm.org](mailto:tbrowder@acm.org)
  
  # COPYRIGHT AND LICENSE
  
  © 2023-2024 Tom Browder
  
  This library is free software; you may redistribute it or modify it under the Artistic License 2.0.
  