caf-ranks

Library of the Canadian Armed Forces rank structure (bilingual)


Keywords
dataset, military, canadian armed forces, rank structure, canadian-armed-forces, rank-structure
License
OGL-Canada-2.0
Install
npm install caf-ranks@0.8.0

Documentation

Canadian Armed Forces (CAF) Ranks

Ranks in the Canadian Armed Forces mark a person's position in its hierarchical structure. As people gain more responsibility and authority, they earn promotions in rank.

This library enables the easy reusability of the Canadian Armed Forces Ranks within your own project.

Features

  • Support for both official languages (English and French)
  • Static JSON document
  • Typing support
  • Built-in filtering methods:
    • Filter by uniform (Army, Air, Navy)
    • Filter by Rank Category (NCM, NCO, Junior Officer ...)

Install

This library is available using the Node Package Manager.

npm install caf-ranks

Examples

Basic Usage

import { allRanks } from "caf-ranks";

// Log all English ranks to the console
allRanks.forEach((rank) => {
  console.log(rank.title.en);
});
/*
  General
  Admiral
  Lieutenant-General
  Vice-Admiral
  Major-General
  (...)
*/

// Log all French rank abberviations to the console
allRanks.forEach((rank) => {
  console.log(rank.abbreviation.fr);
});
/*
  gén
  am
  lgén
  vam
  mgén
  (...)
*/

Filtering Ranks

import {
  allRanks,
  filterRanksByUniform,
  filterRanksByCategory,
} from "caf-ranks";

// Log all English Navy ranks to the console
const navyRanks = filterRanksByUniform(allRanks, "RCN");
navyRanks.forEach((rank) => {
  console.log(rank.title.en);
});
/*
  Admiral
  Vice-Admiral
  Rear-Admiral
  Commodore
  Captain(N)
  (...)
*/

// Log all French Air Force NCM ranks to the console
const airForceRanks = filterRanksByUniform(allRanks, "RCAF");
const airForceNCMRanks = filterRanksByCategory(airForceRanks, "JuniorNCM");
airForceNCMRanks.forEach((rank) => {
  console.log(rank.title.fr);
});
/*
  Caporal-chef
  Caporal
  Aviateur (formé)
  Aviateur (confirmé)
*/

Using Rank Meta

import { rankMeta } from "caf-ranks";

// Log the English version of the Army uniform to the console
console.log(rankMeta.uniform.CA.en);
/*
  Canadian Army
*/

// Log the French version of the Flag Officer category to the console
console.log(rankMeta.category.FlagOfficer.fr);
/*
  Officiers généraux
*/

License

This project is licensed under the Open Government Licence - Canada 2.0

See LICENSE.md

Sources