Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev2.3.2

numerus

Extensões do Dart para traduzir inteiros em numerais romanos e strings de numerais romanos em inteiros.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
74,1 mil
Curtidas
18
Pontos Pub
160

Instalar pacote

flutter pub add numerus

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Numerus é um pacote Dart que fornece extensões para converter inteiros em numerais romanos e vice-versa. Ele simplifica o trabalho com representações de numerais romanos ao oferecer métodos intuitivos diretamente nos tipos inteiro e string. Ideal para aplicativos educacionais, processamento de dados históricos ou qualquer aplicação que exija formatação de numerais romanos. O pacote suporta todas as principais plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux, garantindo ampla compatibilidade. Com sintaxe limpa e minimalista, ele melhora a legibilidade do código e reduz o código repetitivo ao lidar com conversões numéricas.

Casos de uso

  • Convertendo datas para algarismos romanos
  • Aplicativos educacionais para sistemas numéricos
  • Digitalização de documentos históricos
  • Exibindo números de capítulo em estilo romano
  • Rastreamento de pontuação do jogo com algarismos romanos

Principais recursos

  • Conversão simples de inteiro para romano
  • Análise de string para inteiro
  • Métodos de extensão do Dart
  • Suporte multiplataforma
  • Superfície mínima da API
  • Tratamento robusto de erros

Indicado para

  • Desenvolvedores de ferramentas matemáticas
  • Software educacional
  • Aplicativos com temas históricos
  • Projetos que precisam de formatos numéricos legíveis
  • Usuários que preferem sintaxe concisa

Considerações

  • Lida apenas com numerais romanos padrão (sem variantes subtrativas além das regras comuns)
  • Não suporta números muito grandes (>3999) devido às limitações dos numerais romanos
  • Sem suporte de localização para scripts não latinos
  • Requer validação manual para casos de borda, como strings de entrada inválidas

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Numerus

Dart extensions for translating decimal numbers to Roman numerals and vice versa.

  • Negative numbers are not supported.
  • Functions will return null in place of generating nonsense.
  • Zero can be specified as an option to the RomanNumeralConfig.
  • "Common" Roman numeral format used in modern times (i.e. MDCLXVI) is the default RomanNumeralConfig style. There are other styles: vinculum, apostrophus, and a compact apostrophus that uses single Unicode characters instead of tally marks. See the example below.

Coverage

Examples

import 'package:numerus/numerus.dart';

void main() {
  /// 1) Nice and easy, default config is the "common" config.

  var n = 418;
  print(n.toRomanNumeralString());
  // 'CDXVIII'

  var str = 'CDXVIII';
  print(str.isValidRomanNumeralValue());
  // true
  print(str.toRomanNumeralValue());
  // 418

  /// 2) You can specify other [RomanNumeralConfig]'s to change the style.
  /// You can set the config globally, if you'd like.
  RomanNumerals.romanNumeralsConfig = VinculumRomanNumeralsConfig();

  /// 3) Vinculum config style
  n = 3449671;
  print(n.toRomanNumeralString());
  // M̅M̅M̅C̅D̅X̅L̅MX̅DCLXXI

  str = 'M̅M̅M̅C̅D̅X̅L̅MX̅DCLXXI';
  print(str.isValidRomanNumeralValue());
  // true
  print(str.toRomanNumeralValue());
  // 3449671

  /// 4) You can specify the config inline, too.
  /// 5) Apostrophus style
  n = 2449671;
  print(n.toRomanNumeralString(config: ApostrophusRomanNumeralsConfig()));
  // CCCCIↃↃↃↃCCCCIↃↃↃↃCCCIↃↃↃIↃↃↃↃCCIↃↃIↃↃↃCIↃCCIↃↃIↃCLXXI

  /// 6) ... but frankly, globally set is probably the most common use case
  RomanNumerals.romanNumeralsConfig = ApostrophusRomanNumeralsConfig();

  str = 'CCCCIↃↃↃↃCCCCIↃↃↃↃCCCIↃↃↃIↃↃↃↃCCIↃↃIↃↃↃCIↃCCIↃↃIↃCLXXI';
  print(str.isValidRomanNumeralValue());
  // true
  print(str.toRomanNumeralValue());
  // 2449671

  /// 7) The compact Apostrophus style uses special Unicode characters
  /// just for these symbols.
  RomanNumerals.romanNumeralsConfig = CompactApostrophusRomanNumeralsConfig();
  n = 347449;
  print(n.toRomanNumeralString());
  // ↈↈↈↂↇↁↀↀCCCCXLIX

  // NOTE: if you see missing characters in this example, then you'll need to
  // install a font that supports them.
  str = 'ↈↈↈↂↇↁↀↀCCCCXLIX';
  print(str.isValidRomanNumeralValue());
  // true
  print(str.toRomanNumeralValue());
  // 347449

  /// 8) You can specify a "nulla" (zero placeholder) if you want
  /// to support zero easily.
  RomanNumerals.romanNumeralsConfig = CommonRomanNumeralsConfig(nulla: 'N');
  n = 0;
  print(n.toRomanNumeralString());
  // N

  str = 'N';
  print(str.isValidRomanNumeralValue());
  // true
  print(str.toRomanNumeralValue());
  // 0
}

Features and bugs

Please file feature requests and bugs at the issue tracker.

Local development

Set up an environment for local development
  • Install Dart or Flutter
  • Install the coverage tool
    $ dart pub global activate coverage
    
  • Install lcov on your system. e.g. macOS with brew:
    $ brew install lcov
    
Generate code coverage from tests
$ ./bin/coverage-gen
# If you are on macOS and would like the report to immediately
# open, then run the following (not suitable for automation):
$ ./bin/coverage-gen -i

Categorias

Dependências

Lista de dependências 1 itens

Repositório-fonte

Projetos que usam este pacote