[![CI](https://github.com/gap-packages/utils/actions/workflows/CI.yml/badge.svg)](https://github.com/gap-packages/utils/actions/workflows/CI.yml)
[![Code Coverage](https://codecov.io/github/gap-packages/utils/coverage.svg?branch=master&token=)](https://codecov.io/gh/gap-packages/utils)

# The GAP 4 package `Utils` 

## Introduction 

This package collects together utility functions from a selection of GAP 
packages in order to make them more widely visible to other package authors. 

Other generally useful functions, which are not deemed suitable for the main library, and also welcome.  For example, recent additions are functions to convert certain types of group to Magma format.

## Distribution

 * The GitHub package repository is at 
   <https://github.com/gap-packages/utils/> 
 * and the latest release is available at 
   <https://gap-packages.github.io/utils/>

## Copyright

The `Utils` package is Copyright © The GAP Group, 2015-2025. 

`Utils` is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version. 

For details, see <https://www.gnu.org/licenses/gpl.html>

## Installation

 * unpack `utils-<version_number>.tar.gz` in the `pkg` subdirectory 
of the GAP root directory.

 * From within GAP load the package with:
    ```
    gap> LoadPackage("utils");
    true
    ```
 * The file `manual.pdf` is in the `doc` subdirectory.

## Contact

If you have a question relating to `Utils`, encounter any problems, 
or wish to suggest other functions to be transferred to the package, please
 * email: <mailto:cdwensley.maths@btinternet.com> 
 * or report an issue on the GitHub issue tracker at: 
   <https://github.com/gap-packages/utils/issues/new> 
