Initial commit

Author: Sevavietl

.gitignore

@@ -0,0 +1,4 @@
+.idea
+vendor
+composer.lock
+build

.travis.yml

@@ -0,0 +1,18 @@
+language: php
+sudo: false
+php:
+- 7.1
+- 7.2
+
+before_install:
+- composer self-update
+
+install:
+- travis_retry composer install --no-interaction --prefer-source
+
+script:
+- vendor/bin/phpstan analyze src/ test/ --level max
+- vendor/bin/phpunit --coverage-clover build/logs/clover.xml
+
+after_success:
+- travis_retry php vendor/bin/php-coveralls -v

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 Vsevolod Vietluzhskykh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,10 @@
+# TypeCasting - kind of explicit type casting in PHP
+
+[![Build Status](https://travis-ci.com/Sevavietl/TypeCasting.svg?branch=master)](https://travis-ci.com/Sevavietl/TypeCasting)
+[![Coverage Status](https://coveralls.io/repos/github/Sevavietl/TypeCasting/badge.svg)](https://coveralls.io/github/Sevavietl/TypeCasting)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PHPStan](https://img.shields.io/badge/PHPStan-enabled-brightgreen.svg?style=flat)](https://github.com/phpstan/phpstan)
+
+Neither real [covariance](https://en.wikipedia.org/wiki/Covariance_and_contravariance_(computer_science)) in method return type hints, nor [explicit type casting](https://www.baeldung.com/java-type-casting) are supported in PHP.
+
+Sometimes it is useful to downcast object, so PhpStorm or PHPStan stop complaining about absent methods or mismatched types.

composer.json

@@ -0,0 +1,29 @@
+{
+    "name": "sevavietl/type-casting",
+    "type": "library",
+    "require": {
+        "php": ">=7.1"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^7.4",
+        "phpstan/phpstan": "^0.10.5",
+        "php-coveralls/php-coveralls": "^2.1"
+    },
+    "autoload": {
+        "psr-4": {
+            "TypeCasting\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "TypeCasting\\Test\\": "test/"
+        }
+    },
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "sevavietl",
+            "email": "sevavietl@gmail.com"
+        }
+    ]
+}

phpunit.xml.dist

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit backupGlobals="false"
+         backupStaticAttributes="false"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false">
+    <filter>
+        <whitelist processUncoveredFilesFromWhitelist="true">
+            <directory suffix=".php">./src</directory>
+        </whitelist>
+    </filter>
+    <testsuites>
+        <testsuite name="unit">
+            <directory suffix="Test.php">test/</directory>
+        </testsuite>
+    </testsuites>
+</phpunit>

src/TypeCasting.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace TypeCasting;
+
+trait TypeCasting
+{
+    public static function cast($object): self
+    {
+        return $object;
+    }
+}

test/Animal.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace TypeCasting\Test;
+
+class Animal
+{
+}

test/Cat.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace TypeCasting\Test;
+
+use TypeCasting\TypeCasting;
+
+final class Cat extends Animal
+{
+    use TypeCasting;
+
+    public function meow(): string
+    {
+        return 'meow';
+    }
+}

test/Dog.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace TypeCasting\Test;
+
+use TypeCasting\TypeCasting;
+
+class Dog extends Animal
+{
+    use TypeCasting;
+
+    public function bark(): string
+    {
+        return 'bark';
+    }
+}