First working version of Mermaid class diagram generator

Makefile

@@ -93,10 +93,12 @@ test_release: release
 install: release
 	make -C release install DESTDIR=${DESTDIR}
 
-test_plantuml: test
-	plantuml -tsvg debug/tests/puml/*.puml
+test_diagrams: test
+	plantuml -tsvg debug/tests/diagrams/puml/*.puml
+	python3 util/validate_json.py debug/tests/diagrams/json/*.json
+	python3 util/generate_mermaid.py debug/tests/diagrams/mermaid/*.mmd
 
-document_test_cases: test_plantuml
+document_test_cases: test_diagrams
 	python3 util/generate_test_cases_docs.py
 	python3 util/format_svg.py docs/test_cases/*.svg
 

README.md

@@ -108,7 +108,7 @@ which should be generated by `clang-uml`. Basic example is as follows:
 
 ```yaml
 compilation_database_dir: .
-output_directory: puml
+output_directory: diagrams
 diagrams:
   myproject_class:
     type: class

docs/class_diagrams.md

@@ -18,7 +18,7 @@ The minimal config required to generate a class diagram is presented below:
 # Path to the directory where `compile_commands.json` can be found
 compilation_database_dir: _build
 # Output directory for the diagrams
-output_directory: puml
+output_directory: diagrams
 # Diagrams definitions
 diagrams:
   # Diagram name

docs/include_diagrams.md

@@ -15,7 +15,7 @@ The minimal config required to generate an include diagram is presented below:
 # Path to the directory where `compile_commands.json` can be found
 compilation_database_dir: _build
 # Output directory for the diagrams
-output_directory: puml
+output_directory: diagrams
 # Diagrams definitions
 diagrams:
   # Diagram name

docs/package_diagrams.md

@@ -15,7 +15,7 @@ The minimal config required to generate a package diagram is presented below:
 # Path to the directory where `compile_commands.json` can be found
 compilation_database_dir: _build
 # Output directory for the diagrams
-output_directory: puml
+output_directory: diagrams
 # Diagrams definitions
 diagrams:
   # Diagram name

docs/quick_start.md

@@ -17,7 +17,7 @@ To add an initial class diagram to your project, follow these steps:
     # Path to `compile_commands.json` directory
     compilation_database_dir: .
     # Path to diagram output directory
-    output_directory: puml
+    output_directory: diagrams
     diagrams:
       # This is the name of the diagram
       some_class_diagram:

docs/sequence_diagrams.md

@@ -17,7 +17,7 @@ The minimal config required to generate a sequence diagram is presented below:
 # Path to the directory where `compile_commands.json` can be found
 compilation_database_dir: _build
 # Output directory for the diagrams
-output_directory: puml
+output_directory: diagrams
 # Diagrams definitions
 diagrams:
   # Diagram name
@@ -259,7 +259,7 @@ possible to override this order in the diagram definition using
 
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20029_sequence:
     type: sequence

docs/test_cases/t00002.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00002_class:
     type: class

docs/test_cases/t00003.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00003_class:
     type: class

docs/test_cases/t00004.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00004_class:
     type: class

docs/test_cases/t00005.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00005_class:
     type: class

docs/test_cases/t00006.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00006_class:
     type: class

docs/test_cases/t00007.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00007_class:
     type: class

docs/test_cases/t00008.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00008_class:
     type: class

docs/test_cases/t00009.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00009_class:
     type: class

docs/test_cases/t00010.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00010_class:
     type: class

docs/test_cases/t00011.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00011_class:
     type: class

docs/test_cases/t00012.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00012_class:
     type: class

docs/test_cases/t00013.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00013_class:
     type: class

docs/test_cases/t00014.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00014_class:
     type: class

docs/test_cases/t00015.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00015_class:
     type: class

docs/test_cases/t00016.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00016_class:
     type: class

docs/test_cases/t00017.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00017_class:
     type: class

docs/test_cases/t00018.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00018_class:
     type: class

docs/test_cases/t00019.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00019_class:
     type: class

docs/test_cases/t00020.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00020_class:
     type: class

docs/test_cases/t00021.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00021_class:
     type: class

docs/test_cases/t00022.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00022_class:
     type: class

docs/test_cases/t00023.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00023_class:
     type: class

docs/test_cases/t00024.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00024_class:
     type: class

docs/test_cases/t00025.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00025_class:
     type: class

docs/test_cases/t00026.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00026_class:
     type: class

docs/test_cases/t00027.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00027_class:
     type: class

docs/test_cases/t00028.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00028_class:
     type: class

docs/test_cases/t00029.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00029_class:
     type: class

docs/test_cases/t00030.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00030_class:
     type: class

docs/test_cases/t00031.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00031_class:
     type: class

docs/test_cases/t00032.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00032_class:
     type: class

docs/test_cases/t00033.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00033_class:
     type: class

docs/test_cases/t00034.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00034_class:
     type: class

docs/test_cases/t00035.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00035_class:
     type: class

docs/test_cases/t00036.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00036_class:
     type: class

docs/test_cases/t00037.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00037_class:
     type: class

docs/test_cases/t00038.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00038_class:
     type: class

docs/test_cases/t00039.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00039_class:
     type: class

docs/test_cases/t00040.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00040_class:
     type: class

docs/test_cases/t00041.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00041_class:
     type: class

docs/test_cases/t00042.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00042_class:
     type: class

docs/test_cases/t00043.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00043_class:
     type: class

docs/test_cases/t00044.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00044_class:
     type: class

docs/test_cases/t00045.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00045_class:
     type: class

docs/test_cases/t00046.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00046_class:
     type: class

docs/test_cases/t00047.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00047_class:
     type: class

docs/test_cases/t00048.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00048_class:
     type: class

docs/test_cases/t00049.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00049_class:
     type: class

docs/test_cases/t00050.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00050_class:
     type: class

docs/test_cases/t00051.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00051_class:
     type: class

docs/test_cases/t00052.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00052_class:
     type: class

docs/test_cases/t00053.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00053_class:
     type: class

docs/test_cases/t00054.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00054_class:
     type: class

docs/test_cases/t00055.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00055_class:
     type: class

docs/test_cases/t00056.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00056_class:
     type: class

docs/test_cases/t00057.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00057_class:
     type: class

docs/test_cases/t00058.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00058_class:
     type: class

docs/test_cases/t00059.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00059_class:
     type: class

docs/test_cases/t00060.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00060_class:
     type: class

docs/test_cases/t00061.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00061_class:
     type: class

docs/test_cases/t00062.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00062_class:
     type: class

docs/test_cases/t00063.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00063_class:
     type: class

docs/test_cases/t00064.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00064_class:
     type: class

docs/test_cases/t00065.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00065_class:
     type: class

docs/test_cases/t00066.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00066_class:
     type: class

docs/test_cases/t00067.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t00067_class:
     type: class

docs/test_cases/t20001.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20001_sequence:
     type: sequence

docs/test_cases/t20002.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20002_sequence:
     type: sequence

docs/test_cases/t20003.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20003_sequence:
     type: sequence

docs/test_cases/t20004.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20004_sequence:
     type: sequence

docs/test_cases/t20005.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20005_sequence:
     type: sequence

docs/test_cases/t20006.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20006_sequence:
     type: sequence

docs/test_cases/t20007.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20007_sequence:
     type: sequence

docs/test_cases/t20008.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20008_sequence:
     type: sequence

docs/test_cases/t20009.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20009_sequence:
     type: sequence

docs/test_cases/t20010.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20010_sequence:
     type: sequence

docs/test_cases/t20011.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20011_sequence:
     type: sequence

docs/test_cases/t20012.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20012_sequence:
     type: sequence

docs/test_cases/t20013.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20013_sequence:
     type: sequence

docs/test_cases/t20014.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20014_sequence:
     type: sequence

docs/test_cases/t20015.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20015_sequence:
     type: sequence

docs/test_cases/t20016.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20016_sequence:
     type: sequence

docs/test_cases/t20017.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20017_sequence:
     type: sequence

docs/test_cases/t20018.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20018_sequence:
     type: sequence

docs/test_cases/t20019.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20019_sequence:
     type: sequence

docs/test_cases/t20020.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20020_sequence:
     type: sequence

docs/test_cases/t20021.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20021_sequence:
     type: sequence

docs/test_cases/t20022.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20022_sequence:
     type: sequence

docs/test_cases/t20023.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20023_sequence:
     type: sequence

docs/test_cases/t20024.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20024_sequence:
     type: sequence

docs/test_cases/t20025.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20025_sequence:
     type: sequence

docs/test_cases/t20026.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20026_sequence:
     type: sequence

docs/test_cases/t20027.md

@@ -2,7 +2,7 @@
 ## Config
 ```yaml
 compilation_database_dir: ..
-output_directory: puml
+output_directory: diagrams
 diagrams:
   t20027_sequence:
     type: sequence