Add GPR externals and env. vars. to build hash computation (#1428)

* Update pins and dependencies

* Include GPR externals in hash computation

* Avoid recursivity when loading environment

* Test of hashing externals

Fix use of canary file during `alr install` (#1429)

New Force_Delete (#1426)

Replace `rsync` with `GNATCOLL.VFS.Copy` (#1427)

MacOS; export PATH variables for includes and libraries. (#1420)

* MacOS; export PATH variables for includes and libraries.

Homebrew and MacPorts install include files and libraries in places
where GCC won't look by default.

GCC will use these environment variables if set:

   C_INCLUDE_PATH     for C includes
   CPLUS_INCLUDE_PATH for C++ includes
   LIBRARY_PATH       for libraries

Both of the distribution managers place (symbolic links to) include
files in ${top_level}/include and libraries in ${top_level}/lib.

   For Homebrew on Intel silicon, top_level is normally /usr/local.
   For Homebrew on Apple silicon, top_level is normally /opt/homebrew.
   For MacPorts,                  top_level is normally /opt/local

  * src/alire/alire-platforms-current.ads (Load_Environment): add note
      on macOS use.
  * src/alire/os_macos/alire-platforms-current__macos.adb
    (context): added Alire.Environment (was limited), Ada.Directories.
    (Brew_Access): new.
    (Homebrew_Present): if Brew_Access is not null.
    (Detected_Distribution): made into an expression function.
    (Containing_Containing_Dir): new, used in Distribution_Root.
    (Distribution_Root): reworked.
    (Load_Environment): if either distribution is present, arrange to
      export the environment variables to suit.

* Update testsuite to match new macOS distribution detection.

  * testsuite/drivers/helpers.py (distribution): if on macOS, check whether
      the distribution management tool is on the PATH. We used to check for
      the environment variable HOMEBREW_PREFIX, but users don't have to
      arrange for this to be set in order to run Homebrew.

      First, if 'brew' is found, the distribution is Homebrew.
      If not and 'port' is found, the distribution is MacPorts.
      Otherwise, the distribution is unknown.

* In the macOS CI workflow, run the test script once only.

  * .github/workflows/ci-macos.yml (Run test script): remove the second
      call, which set up HOMEBREW_PREFIX (now no longer used by alr),
      and remove the note '(without Homebrew)' in the first.

Use build profile in build hash (#1425)

* Compute hash using build profile

* Fix problem with multiple hashes in one run

Rooted in that default build profiles were used first and later the actual
profiles caused different folders to be used, in turn causing errors with the
conflicting CRATE_ALIRE_PREFIX variables.

* Write hash inputs to build dirs

* Testsuite additions and fixes

* Self-review

* Update pins and dependencies

Refactor Alire.Shared into Alire.Toolchains (#1423)

Trivial safeguard in `Force_Delete` (#1422)

New shared builds mechanism (mockup) (#1419)

* New shared builds mechanism (mockup)

* Self-review

* Fixes for Windows

Don't treat warnings as erros when no style checks (#1412)

Better random generation of temp file names (#1414)

The issue was with the default random seed being the same during a whole
second, so batch runs in the testsuite did clash from time to time.

Fix nightly build (#1413)

New `alr publish --request-review` (#1409)

* Descriminate more PR states

Only missing is when there are changes requested

* Colored states

* Fixed review evaluation

* New `alr publish --request-review`

* Document new feature in user visible changes

* Self-review

New `alr publish --cancel` (#1406)

* New `alr publish --cancel <num> --reason <text>`

* Added JSON escaping

* Update alire.toml pins

* user-changes.md: new `--status`, `--cancel` switches

dev: use env for executable shebangs (#1408)

This is just a minor fix to let the scripts run in more exotic
environments, i.e., NixOS.

`alr publish --status` (#1400)

* Update doc on publishing to match new behavior

* Retrieve status of opened PRs by the user

Make it so the maximum number of results is returned by github

* Self-review

Change all mentions of 'catalog' to 'index' (#1405)

Support MacPorts as external provider. (#1404)

* src/alire/alire-origins-deployers-system-macports.adb: new.
  * src/alire/alire-origins-deployers-system-macports.ads: new.
  * src/alire/alire-origins-deployers-system.adb
    (context): add Alire.Origins.Deployers.System.Macports.
    (Platform_Deployer): Platforms.Macports => System.Macports.Deployer.
  * src/alire/alire-platforms.ads
    (Distributions): add Macports.
    (Package_Managers): likewise.
    (Distro_Manager): Macports => Macports.
  * src/alire/alire-utils-tools.adb (System_Package_For_Tool): add Macports,
      same as the other distributions.
  * src/alire/os_macos/alire-platforms-current__macos.adb:
    (context): add GNAT.OS_Lib.
    (Port_Access): new, access to Macports' 'port' executable.
    (Macports_Present): new, true if 'port' was found.
    (Detected_Distribution): first, check for Homebrew_Present, then, for
      Macports_Present. Return the corresponding Distribution if found.

Bits from the `alr share` feat to be kept (#1399)

* Bits from the `alr share` feat to be kept

* Code review changes

* Update CLIC pin

* Use upstream CLIC repository

Improvements to publishing with automatic PR creation (#1398)

* Added --submit switch to `alr publish`

* Forking of community index

* Changes up to pushing the manifest

* PR creation

* Reshaped as steps of the assistant

* Use release-specific branch

* Report PR webpage after creation

* Detect existing conflicting PR

* Minor tweaks (draft mode, texts, busy spinners)

* Documentation

* Allow overriding of community index info

This will allow our testing and help maintainers of other indexes

* Fix temp dir being not absolute

* Fixes for self-build with `alr build`

* Fixes for Windows temp file specifics

* Document all steps more thoroughly

Also use a better name for the new child package.

* Make submission the default after user confirmation

Document this change in behavior and the new `--skip-submit` switch that
restores the former behavior.

* Default to submit, and add switch not to submit

Indicators in solution diff about non-source dependencies (#1395)

* Warn about non-source dependencies

* Disable fail-fast in workflow

* Create virtual environment

Use a python3 venv on Linux distros (#1396)

Fix Windows testsuite for self-built alr (#1387)

Unify naming of session/working folder as workspace (#1390)

Select default toolchain automatically instead of showing assistant on 1st run (#1391)

* Use defaults for toolchain instead of assistant on 1st run

* Test automatic toolchain selection

* Self-review

* Extra check in test

Fix unpacking of tarfiles with softlinks to subdirectories (#1382)

* Fix Traverse_Tree for softlinked dirs

Remains: GC.VFS.Remove_Dir fails because of the same reason, probably.

* Manually delete softlinks prior to deleting a dir

Otherwise, depending on the links' targets, both Ada.Directories and
GNATCOLL.VFS had trouble with fully deleting a tree containing such links.

* Test for tarballs containing softlinks

* Self-review

* Skip new test on Windows

Don't raise on bad external detection from output (#1389)

* New test case for detection from output

* Add exception catch-all and report in debug output

"Compiler version" --> "Compiled with version" (#1388)

Fixes for compilation with gcc 13.1 (#1381)

alire-platforms-current__windows.adb: add C++ include path for msys2 (#1375)

Alr init fixes (#1372)

* Alr.Commands.Init: improve error message on tag input validation

* Alr.Commands.Init: fix string escape for generated manifest

* Alr.Commands.Init: add LLVM-exception options and change default

Fix Wide_Wide_String interpreted as String (#1370)

Remove `alr test --docker` (#1366)

* Local testing of crates with docker images

WIP: write tests for local+docker default+custom tests

This opens the doors to batch testing on many distros locally

* Test for the use of docker with local `alr test`

* Self-review

* WIP: something funny with the testsuite output

* Remove `alr test --docker`

* Add user changes

* Revert .vscode changes to unclutter PR

* Fix PR number in user changes

Config option to globally share dependencies (#1367)

* Add config option to override dependencies location

Note that pins are not affected, as those are likely to be conflicting across
projects.

* Ensure shared deps have a manifest, show in `alr version`

* Test for new shared dependencies

* Force regeneration of config when global dep sharing

* Check that configs are regenerated every time

Tweaks to VSCode support configuration

Bump clic dependency (#1363)

* Bump clic dependency to include clic#27

* Add test to double-check proper UTF-8 output

* Make test not dependent on tty detection

Fix nightly build (#1365)

* Add branch to test config

* Try to pinpoint offending 'uses'

Switch to ghcr.io from dockerhub (#1360)

* Switch to ghcr.io from dockerhub

* Use action instead of manually invoking Docker

Typed variants of Alire.Config.Edit.Set (#1353)

* Typed variants of Alire.Config.Edit.Set

Mostly because it's too easy to mix Boolean with String

* Migrate raw uses to typed uses

* Leave only needed instances

* Update clic dependency

Docker driver for tests in default configuration (#1358)

Test the local release with `alr test` (#1356)

* Ability to test local crate

* Test for local crate testing

* self-review

* Add user changes entry

* Add check of release profile to tests

Unicode documentation (#1332)

* Document Alire policy on Unicode

* Add control over -gnatW8 switch

* Tweak documentation and tests

* Document in AEP the -gnatW8 effects

* Reformat long lines

* Add comp.lang.ada references

* Renamed source encoding switches

* Use Compiler_Default for no switches

* Update catalog doc to match new source encoding types

* Fix wrong mix of Wide_String with UTF-16

* Bump dependencies

Actually use the cache location for shared releases (#1349)

* Use the cache location for shared releases

* Self-review

* User changes summary

* Cache migration to avoid redownloads

* Removed cache migration

Avoid a crash when system pkg is detected twice (#1350)

Different system package names may resolve to the same version, e.g. when using
transitional names. Although the external definition is probably wrong and
could be fixed, better not to crash as this is a non-issue for us.

Update getting-started.md (#1343)

* Update getting-started.md

Lines 12 - 15.

More clarity on how to add PATH entry for Alire ecosystem client installed on a user's local Linux machine.
PATH value was missing the required double quotes.

* Update getting-started.md

To offer users a choice of adding the Alire client environment to their PATH environment either just for their current terminal session or for future sessions also.

* Update getting-started.md

Put PATH entries into .profile rather than .bashrc since some users may not be using the bash shell, i.e. may be using csh, zsh, fsh, etc.

Update: "This file is generated" (#1338)

* Update: "This file is generated"

* Update alire-lockfiles.adb

Don't enable color if TERM=dumb (#1342)

More explicit identifier error message (#1341)

New `--nested` switch for `alr show` (#1333)

* Print nested crates under current folder

With `alr show --nested`, or after `alr get`/`alr with`.

* Test for `alr show --nested`

* Do not show when run non-interactive

* Self-review

Install indexed crates (#1335)

* Improve Roots.Create_From_Release

* Install crates directly from index

Replace uses of GNAT CE with latest FSF from Alire (#1330)

* Replace uses of GNAT CE with latest FSF from Alire

* Set up alr path in run.py

* Remove caching already done by alr-install

Mention dev/build.sh and fix typos in readme (#1331)

* Fix readme typos

* Mention dev/build.sh in readme

Add Alire.Platforms.Folders.Home for FreeBSD (#1328)

Co-authored-by: Alejandro R. Mosteo <amosteo@unizar.es>

Write Warn/Error traces to stderr by default (#1327)

* Write Warn/Error traces to stderr by default

* Update simple_logging pin

Run testsuite on selfbuilds too (#1324)

Run the testsuite after `alr build` ourselves. This ensures no only that
`alire.toml` allows building, but that the dependency versions are proper.

Also start using `setup-alire@v2` which should result in speed-up.

Install a local crate (#1322)

* Install a local crate to a prefix

* Make --this the default, list info with --info

Fix the example for editor.cmd (#1313)

Using double quotes, the  ${GPR_FILE} is interpreted as a variable by Bourne-like shells and evaluated to an empty string or whatever value has when executed. Single quotes is a way to avoid that evaluation.

This example will not make Emacs select and load the GPR_FILE as the project file for ada-mode, that would be more cumbersome (and requires ada-mode 8.0.3), but I didn't want to complicate the example:
```
alr config --set --global editor.cmd 'emacs --eval=(ada-build-prompt-select-prj-file"${GPR_FILE}") ${GPR_FILE}'
```

`alr install`: Installation of binary crates (#1302)

* Installation of binary releases

* Basic prevention of conflicting installs

* Self-review and cleanup

* Add test and related fixes

* gprbuild tests wrt library placement and artifacts

alire_common.gpr: remove default host os to avoid mistakes on macOS (#1298)

* alire_common.gpr: remove default host os to avoid mistakes on macOS

With the default being Linux, macOS users will not notice any issue until they try to use the executable.
Even then the issue will be obscure.

* Remove any implicit detection of the host OS

This should avoid misbuilds that mix Linux/macOS.

A bash function is now provided for detection of the OS in our scripts.

---------

Co-authored-by: Alejandro R. Mosteo <amosteo@unizar.es>

Check remote hosts during `alr index --check` (#1309)

Specify the initial branch for test repos. (#1244)

Reason: the git in macOS Xcode 14 defaults the initial branch to 'main',
but the tests assume 'master'.

  * testsuite/drivers/helpers.py (init_git_repo): check out the branch
      'master'.

Fix error when showing an unavailable binary origin (#1304)

This only triggers when a binary origin is lacking entries for the current
platform.

Clearer error for misplaced manifest in index tree (#1213)

Co-authored-by: GHA <actions@github.com>

Fix "Loading crate=0.0.0" log message (#1106)

Add `--alr` testsuite option (#1295)

The testsuite runs tests against `alr` from project's `bin` dir by default.
This option makes it possible to select arbitrary `alr` to test.

Disallow dots in identifiers (#1267)

* Disallow leading dot in identifiers

This is to avoid `alr printenv` printing invalid
environment variable names, i.e. with leading dot.

* Fix typo in run_alr error message

* Simplify crate name validation test code

* Use two letters for min crate name length verification

* Test init with valid crate name

* Add more test cases for bad index name

* Use constant instead of dot literal

* Disallow dots in identifiers

Dots in identifiers are allowed by mistake.
This commit forbids them completely, instead
of just disallowing dots as the first character
in crate name.

Use XDG_CACHE_DIR for cache (#1265)

Enable manual running of Nightly workflow

Fix typo in Nightly workflow

Workflow to have a binary nightly build (#1293)

This is with an eye on being able to use latest devel features without
requiring setting up a compiler or compiling alr

Fix typo. (#1292)

Update msys2 installer (#1284)

* Update msys2 installer

* Follow updated MSYS2 first install instructions

* Show proper error message if msys2 update fails

* Fix the command to query for pending updates

* Don't scare-warn needlessly during msys2 update

Co-authored-by: Alejandro R. Mosteo <amosteo@unizar.es>

Use `alr` from project bin dir in testsuite (#1262)

* Mention Python 3 testsuite run script's comment

* Prepend alr project dir to PATH before running tests

* Fail user input validation test explicitly

Use Polish letter 'ł' to make user input validation test
explicitly mention encoding problems when failing.

Alr.Commands.Search: unify "search" and "search --crates" behavior (#1254)

They now both look in names and descriptions, case insensitive.

Update getting-started.md (#1253)

We don't want to imply that those info will be required at some point.
In particular we don't want the use of Alire to require a GitHub account.

Update testsuite readme (#1252)

* Require Python 3 in testsuite readme

* Add e3-testsuite link to testsuite readme

* Add GNAT and GPRBuild requirement to testsuite readme

Use hyphens for action usage output (#1249)

Currently action usage output looks like:
`alr action [options] [post_fetch|pre_build|post_build|test]`,
but it should look like:
`alr action [options] [post-fetch|pre-build|post-build|test]`,
because TOML expects keys to be hyphenated.

This commit fixes the problem by replacing underscores with hyphens.

Fix crate config conflicts errors (#1208)

* Alire.Properties.Configurations: print boolean values in lowercase

To match casing of TOML files where they come from.

* Alire.Crate_Configuration: fix, improve, and test value conflicts

 - TOML value comparison was incorrect (use Equals function now)
 - The "set by" info was incorrect
 - Error message now show the conflicting values

Improve user experience with better manifest errors messages (#1229)

* Improve user experience with better manifest errors messages

This is patch introduces suggestions in various error messages
from the manifest parser. A potential suggestion is made using
edit distance computing from a list of possible values. If the
quality is not deemed good enough, the full list of values is
printed.

* Temp fix GNAT version to check error on macOS

* Revert "Temp fix GNAT version to check error on macOS"

This reverts commit 5da86ba29a013940cb8469ae7f07b8114e488714.

* Try with fixed macOS 10.15 version

alr-commands-init.adb: make alr init interactive (#1228)

Alr init will now queries the user for information such as license,
description, tags, etc.

Non-interactive usage is still possible using existing switches and `-n`.

alr publish: warn about -dev version (#1221)

* testsuite: simplify some alr publish tests

* alr publish: warn about -dev version

Encode wwstrings as utf8 (#1220)

* Encode wwstrings as utf8

* Fixes for raw byte reading in ada-toml

* Further fixes related to UTF-8 encodings

* Sync pins with submodules

* Revert unneeded changes in Simple_Logging

Since GNAT.IO is safe to use with utf8

Co-authored-by: GHA <actions@github.com>

Add source code recommendations to the policies (#1202)

about UTF-8 encoding and a URL to Ada Style Guide.
Refs #919.

Build switches: unconditionally add -gnatW8 (#972)

* Build switches: unconditionally add -gnatW8

* Update user-changes.md

Fix alr help edit: GNAT Studio (#1199)

Implement Homebrew as the system deployer for macOS. (#1185)

* Implement Homebrew as the system deployer for macOS.

  * src/alire/alire-origins-deployers-system-homebrew.adb: new.
  * src/alire/alire-origins-deployers-system-homebrew.ads: new.
  * src/alire/alire-origins-deployers-system.adb (Platform_Deployer):
      When the platform distro manager is Homebrew, return Homebrew.Deployer.
  * src/alire/alire-platforms.ads (Distributions): include macOS.
    (Package_Managers): add Homebrew.
    (Distro_Manager): for macOS, use Homebrew.
  * src/alire/alire-utils-tools.adb (System_Package_For_Tool): treat MacOS
      like other distributions.
  * src/alire/os_macos/alire-platforms-current__macos.adb
    (Detected_Distribution): return Platforms.MacOS.
  * testsuite/drivers/helpers.py (on_macos()): new.
    (distribution()): return 'MACOS' if on_macos() is True.

; Squashed commit of the following:

; commit 0110299ceb66f58cd4793fd78a69fc5b100b4ccf
; Author: Simon Wright <simon@pushface.org>
; Date:   Fri Sep 9 17:45:04 2022 +0100

;     Restore test to correct sense.

; commit d396b6b54a73bbbfd59071539bf6268bccce3cf0
; Author: Simon Wright <simon@pushface.org>
; Date:   Fri Sep 9 17:34:54 2022 +0100

;     Replace assertions in Homebrew deployer with exceptions

; commit d7603110b9543bdaac9516fa844599e87fac70aa
; Author: Simon Wright <simon@pushface.org>
; Date:   Mon Sep 5 14:14:03 2022 +0100

;     Recognise macOS as a distribution.

;       * testsuite/drivers/helpers.py (on_macos()): new.
;         (distribution()): check on_macos(). Return 'MACOS' if true.

; commit 8703acfeb8fdf336d862cefc16706eac5d3f0758
; Author: Simon Wright <simon@pushface.org>
; Date:   Sun Sep 4 17:33:13 2022 +0100

;     Use 'brew info' to get available, installed versions.

; commit 8b22b904e19d64fecb89233e6527c2faf655d982
; Author: Simon Wright <simon@pushface.org>
; Date:   Wed Aug 31 15:54:51 2022 +0100

;     Continuing.

; commit a9821ed9a605e30b5699a49df6fffd11224ab931
; Author: Simon Wright <simon@pushface.org>
; Date:   Mon Aug 22 17:09:48 2022 +0100

;     First changes for macOS Homebrew.

* Implement Homebrew for MacOS: response to comments on PR#1185

  * .github/workflows/ci-macos.yml (Run test script): renamed to
      "Run test script (without Homebrew)".
    (Run test script (with Homebrew)): added 'eval $(brew shellenv)' before
      running the test script, so that HOMEBREW_PREFIX gets defined.
  * src/alire/alire-origins-deployers-system-homebrew.adb
    (Homebrew_Prefix, Homebrew_Present): removed.
    (Get_Info): named the declare block. Removed commented-out exception
      handler.
    (Already_Installed): use Get_Info's returned Installed_Version's length
      to determine the result.
    (Detect): Get_Version_From_String uses Semantic_Versioning.Parse.
        Don't check for Homebrew_Present, it has to be or we wouldn't be
        called.
  * src/alire/alire-platforms.ads (Distributions): rename MacOS to Homebrew.
    (Distro_Manager): likewise.
  * src/alire/alire-utils-tools.adb (System_Package_For_Tool): MacOS (in
      'case Distribution)' changed to Homebrew.
  * src/alire/os_macos/alire-platforms-current__macos.adb
    (Homebrew_Prefix): new, gets the environment variable "HOMEBREW_PREFIX".
    (Homebrew_Present): new, true if the environment variable is present.
    (Detected_Distribution): checks Homebrew_Present, returns Homebrew
      or Distro_Unknown accordingly.
    (Distribution_Root): returns Homebrew_Prefix if present, otherwise "/".
  * testsuite/drivers/helpers.py (distribution()): if on macOS, return
      HOMEBREW if HOMEBREW_PREFIX is found, DISTRO_UNKNOWN otherwise.

* Remove improper pragma in response to comment on #1185

  * src/alire/alire-origins-deployers-system-homebrew.adb: removed
      the innefective pragma Warnings (Off).

* Merging with openSUSE changes in #1173.

  * src/alire/alire-origins-deployers-system.adb: added Homebrew option.
  * src/alire/alire-platforms.ads: likewise.
  * src/alire/alire-utils-tools.adb: likewise.

Co-authored-by: John Serock <1468970+serock@users.noreply.github.com>
Co-authored-by: GHA <actions@github.com>

Allow missing configuration values until build (#1167)

* Allow missing configuration values until build

* Do not generate files on incomplete config

* Crate_Configuration: refactor .Map to .Var_Map

Co-authored-by: GHA <actions@github.com>

Support openSUSE and SUSE distributions (#1173)

* Support zypper package manager

* Support openSUSE and SUSE distributions

Help: reorganize commands and simplify descriptions (#1180)

* Move some commands to Crate or Internal group

Fixes: #1138
* Use imperative mood and simplify descriptions of several commands

* Rename group "Internal" to "Testing" and adjust label of command "show"

Use release build when `alr get --build`ing. (#1169)

This will also make `alr test` to use release builds, which is what we want as
submitted crates are tested in release mode.

Co-authored-by: GHA <actions@github.com>

Fail test if complain_on_error=False but no error (#1171)

This removes the need to assert that the expected failure indeed happened, and
hardens tests against situations where is unclear if an error should happen.

`alr show --dependents` to show which crates have another as a dependency (#1170)

* `alr show --dependents` to show direct dependencies

Show all crates that directly depend on a given release

* Allow showing indirect dependents too

* Improved --dependents switch

* Improved ordering

* New test for `alr with --dependents`

* Add user visible changes entry

Co-authored-by: GHA <actions@github.com>

Remove too strict check for root manifest reload (#1168)

* Remove too strict check for root manifest reload

Since we are using absolute paths all around, that check is no longer
necessary.

Add a test for this situation, which should work besides the warning.

* Self-review fixes

Co-authored-by: GHA <actions@github.com>

Document steps to carry out during a release (#1162)

* Document steps to carry out during a release

Memory flaky

* Add index.toml step

Co-authored-by: GHA <actions@github.com>

Allow package removal by `apt` with --force (#1165)

* Allow package removal by apt with --force

* Propagate --force during `alr test`

* New test for default `alr test` get&build

* Self-review fixes

* Relax syntax in prototype for older python

Fix copy/paste error (#1179)

Bump index version to 1.2.1

Right trim tables (#1166)

* Right trim tables

* Adapt testcases

Add support for FreeBSD (#1148)

* Add support for FreeBSD (#22)

* update GNAT project to recognize -XOS=freebsd and configure accordingly
* add FreeBSD as a valid operating system
* add AMD64 as an alias for X86_64 because uname -m returns amd64 on FreeBSD
* add platform specific implementation for FreeBSD

To build on FreeBSD, we should use

gprbuild -j0 -P alr_env -XOS=freebsd

* Fixes requested during code review

Co-authored-by: GHA <actions@github.com>

`alr test`: Allow binary releases to not contain project files (#1159)

* Allow binary releases to not contain project files

* Fix logic and output to test log instead of stdout