|
1 |
| -[](https://github.com/math-comp/hierarchy-builder/actions) |
2 |
| -[](https://coq.zulipchat.com/#narrow/stream/237868-Hierarchy-Buidlder) |
3 |
| - |
| 1 | +<!--- |
| 2 | +This file was generated from `meta.yml`, please do not edit manually. |
| 3 | +Follow the instructions on https://github.com/coq-community/templates to regenerate. |
| 4 | +---> |
4 | 5 | # Hierarchy Builder
|
5 | 6 |
|
6 |
| -High level commands to declare and evolve a hierarchy based on packed classes. |
| 7 | +[![Docker CI][docker-action-shield]][docker-action-link] |
| 8 | +[![Nix CI][nix-action-shield]][nix-action-link] |
| 9 | +[![Chat][chat-shield]][chat-link] |
| 10 | + |
| 11 | +[docker-action-shield]: https://github.com/math-comp/hierarchy-builder/workflows/Docker%20CI/badge.svg?branch=master |
| 12 | +[docker-action-link]: https://github.com/math-comp/hierarchy-builder/actions?query=workflow:"Docker%20CI" |
| 13 | + |
| 14 | +[nix-action-shield]: https://github.com/math-comp/hierarchy-builder/workflows/Nix%20CI/badge.svg?branch=master |
| 15 | +[nix-action-link]: https://github.com/math-comp/hierarchy-builder/actions?query=workflow:"Nix%20CI" |
| 16 | +[chat-shield]: https://img.shields.io/badge/zulip-join_chat-brightgreen.svg |
| 17 | +[chat-link]: https://coq.zulipchat.com/#narrow/stream/237868-Hierarchy-Builder |
| 18 | + |
| 19 | + |
| 20 | + |
| 21 | + |
| 22 | +Hierarchy Builder is a high level language to build hierarchies of |
| 23 | +algebraic structures and make these hierarchies evolve without breaking |
| 24 | +user code. The key concepts are the ones of factory, builder and |
| 25 | +abbreviation that let the hierarchy developer describe an actual |
| 26 | +interface for their library. Behind that interface the developer can |
| 27 | +provide appropriate code to ensure retro compatibility. |
| 28 | + |
| 29 | +## Meta |
| 30 | + |
| 31 | +- Author(s): |
| 32 | + - Cyril Cohen (initial) |
| 33 | + - Kazuhiko Sakaguchi (initial) |
| 34 | + - Enrico Tassi (initial) |
| 35 | +- License: [MIT](LICENSE) |
| 36 | +- Compatible Coq versions: Coq 8.11 to 8.13 (or dev) |
| 37 | +- Additional dependencies: |
| 38 | + - [Coq elpi](https://github.com/LPCIC/coq-elpi) |
| 39 | +- Coq namespace: `HB` |
| 40 | +- Related publication(s): |
| 41 | + - [Hierarchy Builder: algebraic hierarchies made easy in Coq with Elpi](https://hal.inria.fr/hal-02478907) doi:[10.4230/LIPIcs.FSCD.2020.34](https://doi.org/10.4230/LIPIcs.FSCD.2020.34) |
| 42 | + - [Hierarchy Builder: FSCD Talk](https://www.youtube.com/watch?v=F6iRaTlQrlo)) |
| 43 | + |
| 44 | +## Building and installation instructions |
| 45 | + |
| 46 | +### Opam installation |
| 47 | + |
| 48 | +<details><summary>(click to expand)</summary><p> |
| 49 | + |
| 50 | +The easiest way to install the latest released version of Hierarchy Builder |
| 51 | +is via [OPAM](https://opam.ocaml.org/doc/Install.html): |
| 52 | + |
| 53 | +```shell |
| 54 | +opam repo add coq-released https://coq.inria.fr/opam/released |
| 55 | +opam install coq-hierarchy-builder |
| 56 | +``` |
| 57 | + |
| 58 | +</p></details> |
| 59 | + |
| 60 | +### Manual installation |
| 61 | + |
| 62 | +<details><summary>(click to expand)</summary><p> |
| 63 | + |
| 64 | +To instead build and install manually, do: |
| 65 | + |
| 66 | +``` shell |
| 67 | +git clone https://github.com/math-comp/hierarchy-builder.git |
| 68 | +cd hierarchy-builder |
| 69 | +make # or make -j <number-of-cores-on-your-machine> |
| 70 | +make install VFILES=structures.v |
| 71 | +``` |
| 72 | + |
| 73 | +</p></details> |
7 | 74 |
|
8 |
| -[Presented at FSCD2020, talk available on youtube.](https://www.youtube.com/watch?v=F6iRaTlQrlo) |
9 | 75 |
|
10 | 76 | ## Example
|
11 | 77 |
|
@@ -74,21 +140,12 @@ The current version forces the carrier to be a type, ruling hierarchies of morph
|
74 | 140 | This [draft paper](https://hal.inria.fr/hal-02478907) describes the language
|
75 | 141 | in full detail.
|
76 | 142 |
|
77 |
| -#### Installation & availability |
| 143 | +#### Alternative Installation instructions |
78 | 144 |
|
79 | 145 | <details><summary>(click to expand)</summary><p>
|
80 | 146 |
|
81 |
| -HB works on Coq 8.10 and 8.11. |
82 |
| - |
83 |
| -- You can install it via OPAM |
84 |
| - |
85 |
| -```shell |
86 |
| -opam repo add coq-released https://coq.inria.fr/opam/released |
87 |
| -opam install coq-hierarchy-builder |
88 |
| -``` |
| 147 | +- You can use it in nix with the attribute `coqPackages_8_13.hierarchy-builder` e.g. via `nix-shell -p coq_8_13 -p coqPackages_8_13.hierarchy-builder` |
89 | 148 |
|
90 |
| -- You can use it in nix with the attribute `coqPackages_8_11.hierarchy-builder` e.g. via `nix-shell -p coq_8_11 -p coqPackages_8_11.hierarchy-builder` |
91 |
| - |
92 | 149 | </p></details>
|
93 | 150 |
|
94 | 151 | #### Key concepts
|
|
0 commit comments