https://github.com/scssphp/scssphp

SCSS compiler written in PHP
https://github.com/scssphp/scssphp

hacktoberfest php sass scss

Last synced: 28 days ago
JSON representation

SCSS compiler written in PHP

• Host: GitHub
• URL: https://github.com/scssphp/scssphp
• Owner: scssphp
• License: mit
• Created: 2019-06-05T00:30:40.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2024-09-17T12:24:08.000Z (about 2 months ago)
• Last Synced: 2024-10-01T16:45:05.043Z (about 1 month ago)
• Topics: hacktoberfest, php, sass, scss
• Language: PHP
• Homepage: https://scssphp.github.io/scssphp/
• Size: 4.32 MB
• Stars: 574
• Watchers: 18
• Forks: 77
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# scssphp

### 

![Build](https://github.com/scssphp/scssphp/workflows/CI/badge.svg)

[![License](https://poser.pugx.org/scssphp/scssphp/license)](https://packagist.org/packages/scssphp/scssphp)

`scssphp` is a compiler for SCSS written in PHP.

Checkout the homepage, , for directions on how to use.

## Running Tests

`scssphp` uses [PHPUnit](https://github.com/sebastianbergmann/phpunit) for testing.

Run the following command from the root directory to run every test:

    vendor/bin/phpunit tests

There are several tests in the `tests/` directory:

* `ApiTest.php` contains various unit tests that test the PHP interface.

* `ExceptionTest.php` contains unit tests that test for exceptions thrown by the parser and compiler.

* `FailingTest.php` contains tests reported in Github issues that demonstrate compatibility bugs.

* `InputTest.php` compiles every `.scss` file in the `tests/inputs` directory

  then compares to the respective `.css` file in the `tests/outputs` directory.

* `SassSpecTest.php` extracts tests from the `sass/sass-spec` repository.

When changing any of the tests in `tests/inputs`, the tests will most likely

fail because the output has changed. Once you verify that the output is correct

you can run the following command to rebuild all the tests:

    BUILD=1 vendor/bin/phpunit tests

This will compile all the tests, and save results into `tests/outputs`. It also

updates the list of excluded specs from sass-spec.

To enable the full `sass-spec` compatibility tests:

    TEST_SASS_SPEC=1 vendor/bin/phpunit tests

## Coding Standard

`scssphp` source conforms to [PSR12](https://www.php-fig.org/psr/psr-12/).

Run the following command from the root directory to check the code for "sniffs".

    vendor/bin/phpcs --standard=PSR12 --extensions=php bin src tests

## Static Analysis

`scssphp` uses [phpstan](https://phpstan.org/) for static analysis.

Run the following command from the root directory to analyse the codebase:

    make phpstan

As most of the codebase is composed of legacy code which cannot be type-checked

fully, the setup contains a baseline file with all errors we want to ignore. In

particular, we ignore all errors related to not specifying the types inside arrays

when these arrays correspond to the representation of Sass values and Sass AST nodes

in the parser and compiler.

When contributing, the proper process to deal with static analysis is the following:

1. Make your change in the codebase

2. Run `make phpstan`

3. Fix errors reported by phpstan when possible

4. Repeat step 2 and 3 until nothing gets fixed anymore at step 3

5. Run `make phpstan-baseline` to regenerate the phpstan baseline

Additions to the baseline will be reviewed to avoid ignoring errors that should have

been fixed.