embedded resources

Ressources publiques artistiques intégrées

Contient des modèles, des documents et des exemples de code source référencés sur https://embeddedartistry.com.

Table des matières

1. Exigences
   1. git-lfs
   2. méson
2. Structure
3. Bâtiment
4. Essais

Exigences

Ce référentiel utilise des sous-modules. Vous pouvez cloner le référentiel de manière récursive pour configurer automatiquement les sous-modules :

 $ git clone https://github.com/embeddedartistry/embedded-resources.git --recursive

Vous pouvez également initialiser les sous-modules après le clonage :

 $ git submodule update --init --recursive

git-lfs

Ce référentiel nécessite git-lfs. Si vous ne l'avez pas installé, veuillez visiter https://git-lfs.github.com

Si vous avez cloné ce référentiel avant d'installer git-lfs, veuillez exécuter git lfs pull . Sinon, clone effectuera automatiquement un git lfs pull .

méson

Ce référentiel est construit avec meson, qui nécessite Python 3 et Ninja.

Sur Ubuntu, ceux-ci peuvent être facilement installés avec la commande suivante :

 $ sudo apt-get install python3 python3-pip ninja-build

Pour OSX, vous pouvez utiliser brew :

 $ brew install python3 ninja

La meilleure façon d'obtenir Meson est via pip :

 $ pip3 install meson

Structure

• build/
  • Scripts de build et définitions courants
• docs
  • Modèles de projets open source et documentation de référence
• examples/
  • c/
    • Exemples C pour le site Web Embedded Artistry
  • cpp/
    • Exemples C++ pour le site Web Embedded Artistry
  • libc/
    • Exemples d'implémentations de la libc
  • libcpp/
    • Exemples d'implémentations de libcpp
• interview/
  • Exemples de mise en œuvre de questions d'entretien
• manufacturing/
  • Documents et modèles utiles pour le côté fabrication du monde embarqué.

Bâtiment

Vous pouvez exécuter make à partir du niveau supérieur pour créer tous les exemples. La sortie sera placée dans un dossier appelé buildresults/ au niveau supérieur.

Vous pouvez également utiliser la syntaxe méson appropriée :

 $ meson buildresults
$ cd buildresults
$ ninja

Les cibles peuvent être construites individuellement en utilisant l'interface ninja dans le répertoire buildresults/ .

 $ cd buildresults
$ ninja interview/bad_c

Pour nettoyer les builds, exécutez make clean à partir de la racine du projet ou ninja clean dans le répertoire buildresults/ .

Les binaires seront stockés dans le dossier buildresults/ au même niveau hiérarchique que dans l'arborescence source. Par exemple, l'application de démonstration d'interview bad_c sera dans buildresults/interview/ .

Essais

Ce référentiel inclut désormais des tests. Les tests peuvent être exécutés avec make test , qui construira le projet, exécutera les tests et vous donnera le rapport récapitulatif du programme d'exécution de tests de Meson. Dans ce scénario, les résultats des tests sont stockés dans des fichiers XML trouvés dans buildresults/test

Pour voir une sortie lisible par un humain, construisez le projet comme vous le feriez normalement ( make ou make test ), puis exécutez cette commande :

 $ ninja -C buildresults/ embedded-resources-tests
ninja: Entering directory `buildresults/'
[0/1] Running external command embedde...es-tests (wrapped by meson to set env)
[==========] Running 1 test(s).
[ RUN      ] test_case
[       OK ] test_case
[==========] 1 test(s) run.
[  PASSED  ] 1 test(s).

Lectures complémentaires

• Méson
• Implémentation complète de la bibliothèque Artistry intégrée
• Libmemory Artistry intégrée