Table of Contents
Description
The transformcommentedtestlinestophpunit is a Visual Studio Code extension tailored for PHP developers who use PHPUnit for testing. This extension enables a streamlined process of creating PHPUnit test methods from comments, thus making your coding and testing process faster and more efficient.
The extension operates by scanning your active PHP file for any line comments starting with //test or // test. It then transforms these comments into boilerplate PHPUnit methods, laying the groundwork for your test cases. The extension is designed to only work on PHP files that end with Test.php, ensuring it only functions in the context of your test files.
Remember to replace the method body with your test implementation to make the test meaningful.
Features
- Transforms
//test or // test comments into PHPUnit methods quickly and efficiently.
- Exclusive functionality for PHP files ending with
Test.php.
Dependencies
The transformcommentedtestlinestophpunit extension depends on the following packages:
@types/vscode version ^1.70.0
@types/glob version ^8.1.0
@types/mocha version ^10.0.1
@types/node version 16.x
eslint version ^8.39.0
glob version ^8.1.0
mocha version ^10.2.0
typescript version ^5.0.4
@vscode/test-electron version ^2.3.0
How to use
- Open a PHP file in Visual Studio Code that ends with
Test.php.
- Add a comment line starting with
//test or // test and write the name of your test function. For example: //test should return true
- Press
F1 to open the Command Palette.
- Start typing
Transform commented lines to PHPUnit methods and select it.
- The extension will replace the
//test comment with a PHPUnit method.
Example
Input
<?php
use PHPUnit\Framework\TestCase;
final class UserTest extends TestCase{
//test get name returns an empty string by default
//test set name returns true
//test get name returns the expected value
//test getname returns a string
}
Output
<?php
use PHPUnit\Framework\TestCase;
final class UserTest extends TestCase{
public function testGetNameReturnsAnEmptyStringByDefault(){
}
public function testSetNameReturnsTrue(){
}
public function testGetNameReturnsTheExpectedValue(){
}
public function testGetnameReturnsAString(){
}
}
Extension Settings
This extension currently does not offer any configurable settings.
Known Issues
No known issues at this time.
Release Notes
0.0.1
Initial release of transformcommentedtestlinestophpunit
Contributing
If you have suggestions for improving transformcommentedtestlinestophpunit, or want to report a bug, open an issue! Contributions of all kinds are welcome.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Feedback
If you have any feedback, please reach out on GitHub.
Acknowledgements
This project follows the all-contributors specification. Contributions of any kind are welcome!