README

Allows easy concatenation of ints without conversion through strings.

Installation

composer install

Usage

use GryfOSS\Formatter\IntCombiner;

// Combine two positive integers
$result = IntCombiner::combine(123, 456); // Returns: 123456

// Handle edge case where second number is zero
$result = IntCombiner::combine(123, 0); // Returns: 1230 (123 * 10)

// Both numbers must be non-negative
IntCombiner::combine(-1, 5); // Throws InvalidArgumentException

Testing

This project includes comprehensive testing with both PHPUnit (unit tests) and Behat (behavior-driven testing) to ensure 100% code coverage and validate all behavioral scenarios.

Unit Testing with PHPUnit

Run PHPUnit tests with the following commands:

# Run unit tests
composer test

# Run tests with coverage report
composer test-coverage

# Generate HTML coverage report
composer test-coverage-html

Behavior-Driven Testing with Behat

Run Behat tests to validate behavioral scenarios:

# Run all Behat scenarios
composer behat

# Dry run to validate feature files
composer behat-dry

# Run both PHPUnit and Behat tests
composer test-all

Test Coverage Details

PHPUnit Unit Tests cover:

✅ Normal integer combination scenarios
✅ Edge case when second number is zero (special multiplication logic)
✅ Edge case when first number is zero
✅ Single digit and multi-digit number combinations
✅ Large number combinations
✅ Error handling for negative numbers (both first and second parameter)
✅ Digit counting logic verification (log10 calculations)
✅ Power of 10 calculations for proper concatenation
✅ Boundary conditions and edge cases

Behat BDD Scenarios cover:

🎯 43 scenarios with 220 steps testing real-world usage patterns
🔍 Mathematical properties validation with digit counting verification
⚡ Performance testing with large number combinations
🚫 Error scenarios with comprehensive exception handling
📊 Boundary value testing with edge cases
🧮 Advanced mathematical logic verification with documented formulas

Continuous Integration

This project includes a comprehensive GitHub Actions workflow that:

✅ Multi-PHP Testing - Tests on PHP 8.2, 8.3, and 8.4
🧪 Unit Tests - Runs PHPUnit tests with Xdebug coverage
🎯 Feature Tests - Executes all Behat BDD scenarios
📊 Coverage Enforcement - Fails if coverage is not 100%
🔍 Code Quality - Validates composer files and project structure
🚀 Codecov Integration - Optional coverage reporting

Local CI Testing

# Run the same checks as GitHub Actions locally
composer ci-local

# Or individual steps
composer validate --strict    # Validate composer.json
composer check-coverage       # Verify 100% coverage requirement
composer behat                # Run feature tests

Current Coverage: 100% (1/1 classes, 1/1 methods, 6/6 lines)

Contributing

We welcome contributions from everyone! Whether you want to report a bug, suggest a feature, or submit code improvements, your input is valuable.

How to Contribute

🐛 Report Issues

Found a bug? Open an issue
Include steps to reproduce and expected vs actual behavior
Provide PHP version and relevant environment details

💡 Suggest Features

Have an idea for improvement? Create a feature request
Explain the use case and expected behavior
Consider backward compatibility implications

🔧 Submit Pull Requests

Fork the repository and create a feature branch
Make your changes with appropriate tests
Ensure 100% test coverage is maintained
Run composer ci-local to verify all checks pass
Submit a pull request with clear description of changes

Development Guidelines

All code must have 100% test coverage (both PHPUnit and Behat scenarios)
Follow existing code style and conventions
Add tests for new functionality or bug fixes
Update documentation as needed
Ensure all GitHub Actions checks pass

Questions or Discussion

Open an issue for questions
Tag with appropriate labels (question, enhancement, bug, etc.)

Every contribution, no matter how small, helps improve the project for everyone! 🎉

gryfoss / int-combiner

Maintainers

Details