Test ran at 2025-02-21 00:51:29.475972+00:00

SOLUTION:
universal_text_file=20220720.0.0: Proposed universal format for Unicode text files
Origin: commit d58797dfdf1818ac064eba99e999bb8cc453d389 from https://github.com/bracke/Universal-Text-File.git
Properties:
   Author: Jeff Carter
   Build Switches: 
   Description: Proposed universal format for Unicode text files
   License: BSD-3-Clause
   Long_Description: # Universal Text File Format
Proposed universal format for Unicode text files

Here I propose a universal format for Unicode text files, specified by its Ada implementation. Some features of the format are

* ASCII code points are encoded as themselves
* At most three bytes are used to encode a code point
* All code points may occur in a line
* Lines may be any length (though the implementation is limited to Integer'Last)

I have called this format Universal Text File format, with the acronym UTF. Like GNAT Programming Studio (GPS), this result is an acronym collision. Suggestions for alternative names are welcome.

## Combined Specification and Ada Implementation
The format is specified here by its Ada implementation in package UTF, which is short and straightforward.

## Tools
Three simple tools are provided:
* To_UTF, to convert an Ada.Text_IO file to UTF
* From_UTF, to convert a UTF file into an Ada.Text_IO file
* Umore, a simple `more` program for UTF files

## Suitability
Most tools for processing text files on the major platforms work with native text files from other platforms, and UTF-8 has been widely adopted for encoding Unicode text files, so it seems unlikely that an alternative will gain much traction. However, having done this, I thought I would share it should anyone be interested.

## Standard Software-Engineering Practice
Encodings should normally only be used externally to a program. Encoded input data should be decoded immediately upon input, and output data encoded immediatly before output.

   Maintainer: Bent Bracke <bent@bracke.dk>
   Maintainers_Logins: bracke
   Name: universal_text_file
   Tag: format
   Tag: unicode
   Tag: text
   Version: 20220720
   Website: https://github.com/bracke/Universal-Text-File
Dependencies (direct):
   gnat<13.0 | >=13.3
Dependencies (solution):
   gnat=10.3.2 (gnat_native)
Dependencies (graph):
   universal_text_file=20220720.0.0 --> gnat=10.3.2 (gnat_native) (<13.0 | >=13.3)


LOG:
Spawning: alr -d -n get --build universal_text_file=20220720.0.0
Note: Deploying universal_text_file=20220720.0.0...
Note: Building universal_text_file=20220720.0.0/universal_text_file.gpr...
Setup
   [mkdir]        object directory for project Universal_Text_File
   [mkdir]        library directory for project Universal_Text_File
Compile
   [Ada]          universal_text_file_config.ads
   [Ada]          utf.adb
Build Libraries
   [gprlib]       Universal_Text_File.lexch
   [archive]      libUniversal_Text_File.a
   [index]        libUniversal_Text_File.a

universal_text_file=20220720.0.0 successfully retrieved and built.
Dependencies were solved as follows:

   +b gnat 10.3.2 (new,gnat_native,binary)
Found declared GPR file: universal_text_file.gpr