arch_test

ArchTest

O Archtest é uma ferramenta de teste de arquitetura baseada em regras. Aplica análises estáticas no projeto de ferrugem especificado para extrair relacionamentos de uso.

Características

• Detectar dependências cíclicas Nível de nível ou módulo
• Proibir o acesso aos pais
• Defina relacionamentos de camada como MayNotAccess , MayOnlyAccess , MyNotBeAccessedBy , MayOnlyBeAccessedBy
• E mais, consulte a documentação.

Instalar

Você pode instalá -lo como sub comando da carga ou como um pacote em suas dependências do desenvolvedor.

 # Sub command
cargo install cargo-archtest --force

# Package
[dev-dependencies]
arch_test_core = "*"

Como usá -lo

Usando o comando de sub -carga

Defina no caminho da raiz de carga um arquivo chamado architecture.json . Preencha -o de acordo com a estrutura Specification . Exemplo:

{
  "layer_names" : [ " analyzer " , " parser " , " domain_values " , " entities " , " materials " , " services " , " tests " , " utils " ],
  "access_rules" : [
    " NoLayerCyclicDependencies " ,
    " NoModuleCyclicDependencies " ,
    " NoParentAccess " ,
    {
      "MayNotAccess" : {
        "accessor" : " parser " ,
        "accessed" : [ " analyzer " ],
        "when_same_parent" : true
      }
    },
    {
      "MayOnlyBeAccessedBy" : {
        "accessors" : [ " services " , " tests " ],
        "accessed" : " materials " ,
        "when_same_parent" : false
      }
    },
    {
      "MayNotBeAccessedBy" : {
        "accessors" : [ " materials " , " domain_values " , " entities " , " utils " ],
        "accessed" : " services " ,
        "when_same_parent" : true
      }
    }
  ]
}

Usando um teste de ferrugem

Você pode usar a estrutura Architecture para definir sua arquitetura. Depois, você verifica as falhas.

 let architecture = Architecture :: new ( hash_set ! [ "analyzer" . to_owned ( ) , "parser" . to_owned ( ) , ... ] )
. with_access_rule ( NoParentAccess )
. with_access_rule ( NoModuleCyclicDependencies )
. with_access_rule ( NoLayerCyclicDependencies )
...
. with_access_rule ( MayNotAccess :: new (
    "materials" . to_owned ( ) ,
    hash_set ! [ "tests" . to_owned ( ) ] ,
    true ,
) ) ;
let module_tree = ModuleTree :: new ( "src/lib.rs" ) ;
assert ! ( architecture . validate_access_rules ( ) . is_ok ( ) ) ;
assert ! ( architecture . check_access_rules ( & module_tree ) . is_ok ( ) ) ;

Se você estiver interessado no fracasso, pode imprimi -lo assim:

architecture . check_access_rules ( & module_tree ) . err ( ) . unwrap ( ) . print ( module_tree . tree ( ) ) ; 

Integração contínua

Você pode usá -lo em integração contínua usando qualquer um dos métodos. Se você decidir usar o comando Sub Cargo no Github, o seguinte snippet permitirá que você teste seu projeto.

 arch_test :
  name : ArchTest
  runs-on : ubuntu-latest
  steps :
    - uses : actions/checkout@v2
    - uses : actions-rs/[email protected]
      with :
        crate : cargo-archtest
        version : latest
    - run : cargo archtest