|
|
|
Le script Bash `mcli` permet de centraliser des commandes courantes, notamment liées à l'indexation ou l'extraction. Il est à la racine du répertoire git Macao-Legacy
|
|
|
|
Le script Bash `mcli` permet de centraliser des commandes courantes, notamment liées à l'indexation ou l'extraction. Il est à la racine du répertoire git Macao-Legacy.
|
|
|
|
|
|
|
|
```sh
|
|
|
|
./mcli [commande]
|
|
|
|
./mcli [version] <commande>
|
|
|
|
```
|
|
|
|
|
|
|
|
[[_TOC_]]
|
|
|
|
|
|
|
|
## Version
|
|
|
|
Le premier paramètre est la "version Macao" à utiliser, puisque les sources `macao_12` et `macao_3` sont séparées.
|
|
|
|
- `12` ou `macao_12`
|
|
|
|
- `3` ou `macao_3`
|
|
|
|
- `each` pour répéter la commande sur chacune des deux versions (12 puis 3)
|
|
|
|
- `full` pour combiner les résultats des deux versions
|
|
|
|
Ex: pour convertir l'intégralité du contenu
|
|
|
|
|
|
|
|
## Shell
|
|
|
|
|
|
|
|
La commande `shell`, sans doute la plus utile, ouvre un **sous-shell dans l'environnement Macao**, avec toutes les variables utiles accessibles (`MACAO_ROOT` pour la racine git, `SOURCES_DIR` pour les sources, `SCRIPTS_DIR` pour l'emplacement des scripts d'extraction...).
|
|
|
|
|
|
|
|
```sh
|
|
|
|
$ ./mcli shell
|
|
|
|
$ cd $SCRIPTS_DIR
|
|
|
|
$ pwd
|
|
|
|
/home/user/macao-legacy/tetras_extraction/macao_12/script
|
|
|
|
```
|
|
|
|
|
|
|
|
Elle ajoute aussi `mcli` au `PATH`, ce qui permet de l'utiliser sans son chemin
|
|
|
|
|
|
|
|
```sh
|
|
|
|
$ ./mcli shell
|
|
|
|
$ mcli help
|
|
|
|
```
|
|
|
|
|
|
|
|
La commande `status` permet de vérifier **l'état de l'environnement** :
|
|
|
|
|
|
|
|
```
|
|
|
|
$ mcli status
|
|
|
|
VERSION=macao_12
|
| ... | ... | @@ -39,18 +54,22 @@ nothing to commit, working tree clean |
|
|
|
|
|
|
|
Toutes ces variables d'environnement ont une valeur par défaut, mais **héritent de leur valeur existante** si définie, ce qui permet de paramétrer `mcli`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Indexation et comptage
|
|
|
|
|
|
|
|
`mcli index-extensions` génère l'[index des fichiers triés par extension](https://gitlab.tetras-libre.fr/macao/macao-legacy/-/commit/6881597beece6d9a1b7a37fb3a313a19d32c49e9), vers `$INDEXES_DIR/index_per_extension.txt`
|
|
|
|
`mcli index-extensions` génère l'[index des fichiers triés par extension](https://gitlab.tetras-libre.fr/macao/macao-legacy/-/commit/6881597beece6d9a1b7a37fb3a313a19d32c49e9 "Indexation Macao12 par extension de fichier pour comptage"), vers `$INDEXES_DIR/index_per_extension.txt`
|
|
|
|
|
|
|
|
`mcli count-streams` compte les streams audio dans chaque SWF, vers `$INDEXES_DIR/swf_streams_count.txt` ; ce comptage peut être assez long (1-2 min).
|
|
|
|
|
|
|
|
`mcli count-all` se base sur ces index pour générer un compte des nombreux types d'objets de Macao (cf [Concepts et objets de MACAO](Concepts-et-objets-de-MACAO)). Avec `--force`, les index sont régénérés du même coup.
|
|
|
|
|
|
|
|
## Extraction
|
|
|
|
L'extracteur principal est lancé avec `mcli extract-rdf`.
|
|
|
|
|
|
|
|
## Extraction / conversion
|
|
|
|
|
|
|
|
**Avant le premier lancement**, l'environnement de développement Python doit être initialisé (virtualenv, dépendances...) avec **`mcli setup`**.
|
|
|
|
|
|
|
|
L'extraction des audios à partir des fichiers Flash se fait séparément (et sans Python) avec `mcli extract-mp3`.
|
|
|
|
La conversion complète est lancée avec `mcli <version> convert`.\
|
|
|
|
Chacune des trois étapes `extract`, `transform` et `export` est disponible individuellement avec sa propre commande.
|
|
|
|
|
|
|
|
 |
|
|
\ No newline at end of file |
|
|
|
L'extraction des audios à partir des fichiers Flash se fait séparément (et sans Python) avec `mcli extract-mp3`. |
|
|
\ No newline at end of file |
