Go to file
Anthony Arnold 1b407c8a96 Bump version. 2021-12-08 23:50:42 +10:00
ali Split some unit tests up to test more distinct functionality. Added new unit test to check that Invalid_String is thrown in From_Name. Fixed up some ignore files. 2012-01-17 13:26:45 +10:00
bin Split some unit tests up to test more distinct functionality. Added new unit test to check that Invalid_String is thrown in From_Name. Fixed up some ignore files. 2012-01-17 13:26:45 +10:00
doc Added documentation generated with AdaBrowse. When changing an interface, must run 'make docs' before commiting. 2012-01-20 11:20:42 +10:00
include Enforce token spacing with style check 2016-08-02 08:53:33 -05:00
lib Added documentation generated with AdaBrowse. When changing an interface, must run 'make docs' before commiting. 2012-01-20 11:20:42 +10:00
obj Split some unit tests up to test more distinct functionality. Added new unit test to check that Invalid_String is thrown in From_Name. Fixed up some ignore files. 2012-01-17 13:26:45 +10:00
src Enforce token spacing with style check 2016-08-02 08:53:33 -05:00
support Can now make install. 2012-01-17 17:10:23 +10:00
test Fix compatibility errors 2021-12-08 23:49:42 +10:00
.gitignore Can now make install. 2012-01-17 17:10:23 +10:00
LICENSE Switch to Simplified BSD License 2016-07-19 22:04:20 +10:00
Makefile Bump version. 2021-12-08 23:50:42 +10:00
README.md Readme Update after 4 years 2015-07-14 21:59:04 +10:00
adaid.gpr.in Fix for building using FSF GNAT 9 2021-12-02 20:32:40 +01:00
adaid_debug.gpr Update adaid.gpr.in similarly to adaid_debug.gpr 2016-08-03 08:14:49 -05:00
test.gpr Fix for building using FSF GNAT 9 2021-12-02 20:32:40 +01:00

README.md

#AdaID#

What is it? AdaID is a simple Ada library for generating UUIDs. Supported operations include:

  • Generating random UUIDs
  • Generating name-based UUIDs
  • Restoring UUIDs from a string representation.
  • Converting a UUID to a string

What are the dependencies? All of the code is self-contained, but the build system assumes GNAT is present.

If you want to run the unit test suite, you'll need AUnit installed. If you don't have it, and you don't care about running the tests (and you should), then just avoid running make test.

How do I build it? To build the library: run make, optionally followed by make test, and finally make install. The library should now be installed on your system.

OK, how is it used? Here's an example usage:

-- file: print_random_uuid.adb
with AdaID; use AdaID;
with Ada.Text_IO; use Ada.Text_IO;
procedure Print_Random_UUID is
	id : UUID;
begin
	Random(id);
	Put_Line(To_String(id));
end Print_Random_UUID;

To compile, create a gnat project file to build the example:

with "adaid.gpr";
project Print_Random_UUID is
	for Main use ("print_random_uuid.adb");
	for Languages use ("Ada");
end Print_Random_UUID;

And build:

gnatmake -Pprint_random_uuid.gpr

What's next? Future improvements include:

  • General make file improvements
  • Library documentation