PHPackages                             ddouggs/test\_command - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. ddouggs/test\_command

ActiveLibrary[CLI & Console](/categories/cli)

ddouggs/test\_command
=====================

Comandos para testes shell

v0.1.23(3d ago)05GPL-3.0PHP

Since Oct 29Pushed 2mo agoCompare

[ Source](https://github.com/DDouGGS/test_command)[ Packagist](https://packagist.org/packages/ddouggs/test_command)[ RSS](/packages/ddouggs-test-command/feed)WikiDiscussions master Synced today

READMEChangelog (10)Dependencies (1)Versions (26)Used By (0)

Aqui está um exemplo de **README.md** bem estruturado para a sua classe `TC`:

---

📦 TestCommand (TC)
==================

[](#-testcommand-tc)

A classe `TC` é um utilitário abstrato para gerenciamento de testes, breakpoints e manipulação de arquivos dentro de um fluxo de execução. Ela atua como uma fachada (facade), centralizando chamadas para diferentes responsabilidades:

- 🧪 Testes (`Tests`)
- 📁 Arquivos (`Archives`)
- 🛑 Breakpoints (`Breakpoints`)

---

🚀 Objetivo
----------

[](#-objetivo)

Facilitar a execução de testes e depuração durante o desenvolvimento, fornecendo métodos estáticos simples e diretos para validações e controle de fluxo.

---

📂 Namespace
-----------

[](#-namespace)

```
namespace test_command;
```

---

🧱 Estrutura
-----------

[](#-estrutura)

A classe depende das seguintes implementações:

- `Tests` / `TestsInterface`
- `Archives` / `ArchivesInterface`
- `Breakpoints` / `BreakpointsInterface`

Essas classes são instanciadas automaticamente quando necessário (lazy loading).

---

⚙️ Inicialização
----------------

[](#️-inicialização)

Ao instanciar a classe, o componente de arquivos é automaticamente carregado:

```
public function __construct()
{
    $this->setArchives(new Archives());
}
```

---

🛑 Breakpoints
-------------

[](#-breakpoints)

Permite controlar a execução do código em pontos específicos:

### Métodos disponíveis:

[](#métodos-disponíveis)

```
TC::halt($output = [], $condition = true);
TC::begin($output = [], $condition = true);
TC::rollback($output = [], $condition = true);
```

### Descrição:

[](#descrição)

- **halt** → Interrompe a execução
- **begin** → Marca o início de um bloco monitorado
- **rollback** → Reverte ou desfaz execução

---

🧪 Testes
--------

[](#-testes)

### Execução de testes

[](#execução-de-testes)

```
TC::testing($configs = null, $test = null);
```

---

✅ Asserções disponíveis
-----------------------

[](#-asserções-disponíveis)

A classe fornece diversas asserções para validação de dados:

### Tipos primitivos

[](#tipos-primitivos)

```
TC::assertBool(fn() => true);
TC::assertString(fn() => "texto");
TC::assertInt(fn() => 10);
TC::assertFloat(fn() => 10.5);
TC::assertArray(fn() => []);
TC::assertObject(fn() => new stdClass());
TC::assertResource(fn() => fopen(...));
```

---

### Comparações e validações

[](#comparações-e-validações)

```
TC::assertTrue(fn() => true);
TC::assertFalse(fn() => false);
TC::assertNull(fn() => null);
TC::assertEmpty(fn() => []);
TC::assertEquals($expected, fn() => $value);
TC::assertDiff($unexpected, fn() => $value);
```

---

### Expressões e arquivos

[](#expressões-e-arquivos)

```
TC::assertRegExp('/regex/', fn() => "valor");
TC::assertFileExists(fn() => "/caminho/arquivo");
```

---

### Comparações numéricas

[](#comparações-numéricas)

```
TC::assertGreaterThan(10, fn() => 20);
TC::assertGreaterThanOrEqual(10, fn() => 10);
TC::assertLessThan(10, fn() => 5);
TC::assertLessThanOrEqual(10, fn() => 10);
```

---

### Tipagem e instância

[](#tipagem-e-instância)

```
TC::assertInstanceOf(MinhaClasse::class, fn() => new MinhaClasse());
```

---

🧠 Funcionamento interno
-----------------------

[](#-funcionamento-interno)

A classe utiliza:

- **Lazy initialization**: Instancia objetos apenas quando necessário
- **Singleton-like static storage**: Mantém instâncias em propriedades estáticas
- **Encapsulamento**: Métodos `get*` e `set*` controlam acesso interno

---

🔒 Métodos internos importantes
------------------------------

[](#-métodos-internos-importantes)

- `getTests()` / `setTests()`
- `getArchives()` / `setArchives()`
- `getBreakpoints()` / `setBreakpoints()`

Esses métodos garantem que apenas uma instância de cada componente seja utilizada.

---

📌 Observações
-------------

[](#-observações)

- Todos os métodos são **estáticos**, facilitando o uso global
- Ideal para ambientes de desenvolvimento e debugging
- Depende da correta implementação das classes auxiliares (`Tests`, `Archives`, `Breakpoints`)

---

💡 Exemplo de uso
----------------

[](#-exemplo-de-uso)

```
use test_command\TC;

// Teste simples
TC::assertTrue(fn() => 1 === 1, 'Teste básico');

// Comparação
TC::assertEquals(10, fn() => 5 + 5);

// Breakpoint
TC::halt(['Erro encontrado'], true);
```

---

📄 Licença
---------

[](#-licença)

Defina aqui a licença do seu projeto.

---

Se quiser, posso melhorar esse README para:

- padrão de pacote Composer
- adicionar badges (build, cobertura, etc.)
- ou transformar isso em documentação estilo Laravel/PHPUnit 👌

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance84

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~11 days

Recently: every ~22 days

Total

22

Last Release

3d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/12718033?v=4)[Douglas Gonçalves de Souza](/maintainers/douggonsouza)[@douggonsouza](https://github.com/douggonsouza)

---

Top Contributors

[![DDouGGS](https://avatars.githubusercontent.com/u/158485475?v=4)](https://github.com/DDouGGS "DDouGGS (32 commits)")

### Embed Badge

![Health badge](/badges/ddouggs-test-command/health.svg)

```
[![Health](https://phpackages.com/badges/ddouggs-test-command/health.svg)](https://phpackages.com/packages/ddouggs-test-command)
```

###  Alternatives

[illuminate/console

The Illuminate Console package.

13046.0M6.5k](/packages/illuminate-console)[styleci/cli

The CLI tool for StyleCI

71470.5k9](/packages/styleci-cli)[winbox/args

Windows command-line formatter

20720.9k21](/packages/winbox-args)[tomatophp/filament-artisan

Simple but yet powerful library for running some artisan commands for FilamentPHP

3275.4k1](/packages/tomatophp-filament-artisan)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)