Initial commit

Author: GrahamCampbell

.gitattributes

@@ -0,0 +1,9 @@
+* text=auto
+
+/tests export-ignore
+/.gitattributes export-ignore
+/.gitignore export-ignore
+/.travis.yml export-ignore
+/phpunit.xml.dist export-ignore
+/CONTRIBUTING.md export-ignore
+/README.md export-ignore

.gitignore

@@ -0,0 +1,3 @@
+composer.lock
+phpunit.xml
+vendor

.travis.yml

@@ -0,0 +1,35 @@
+language: php
+dist: trusty
+sudo: false
+
+matrix:
+  include:
+    - php: 7.1
+      env:
+        - SYMFONY_VERSION=^3.0
+        - PHPUNIT_VERSION=^6.5
+    - php: 7.1
+      env:
+        - SYMFONY_VERSION=^4.0
+        - PHPUNIT_VERSION=^7.0
+    - php: 7.2
+      env:
+        - SYMFONY_VERSION=^3.0
+        - PHPUNIT_VERSION=^6.5
+    - php: 7.2
+      env:
+        - SYMFONY_VERSION=^4.0
+        - PHPUNIT_VERSION=^7.0
+
+install:
+  - composer require "symfony/lts:${SYMFONY_VERSION}" --no-update -n
+  - composer require "phpunit/phpunit:${PHPUNIT_VERSION}" --dev --no-update -n
+  - travis_retry composer install --no-suggest --prefer-dist -n -o
+
+script:
+  - if [ "$TRAVIS_PHP_VERSION" != "7.1" ]; then vendor/bin/phpunit; fi
+  - if [ "$TRAVIS_PHP_VERSION" == "7.1" ]; then vendor/bin/phpunit --coverage-clover build/logs/clover.xml; fi
+
+after_script:
+  - if [ "$TRAVIS_PHP_VERSION" == "7.1" ]; then wget https://scrutinizer-ci.com/ocular.phar; fi
+  - if [ "$TRAVIS_PHP_VERSION" == "7.1" ]; then php ocular.phar code-coverage:upload --format=php-clover build/logs/clover.xml; fi

CONTRIBUTING.md

@@ -0,0 +1,38 @@
+CONTRIBUTING
+============
+
+
+Contributions are welcome, and are accepted via pull requests. Please review these guidelines before submitting any pull requests.
+
+
+## Guidelines
+
+* Please follow the [PSR-2 Coding Style Guide](http://www.php-fig.org/psr/psr-2/), enforced by [StyleCI](https://styleci.io/).
+* Ensure that the current tests pass, and if you've added something new, add the tests where relevant.
+* Send a coherent commit history, making sure each individual commit in your pull request is meaningful.
+* You may need to [rebase](https://git-scm.com/book/en/v2/Git-Branching-Rebasing) to avoid merge conflicts.
+* If you are changing the behavior, or the public api, you may need to update the docs.
+* Please remember that we follow [SemVer](http://semver.org/).
+
+
+## Running Tests
+
+You will need an install of [Composer](https://getcomposer.org/) before continuing.
+
+First, install the dependencies:
+
+```bash
+$ composer install
+```
+
+Then run PHPUnit:
+
+```bash
+$ vendor/bin/phpunit
+```
+
+If the test suite passes on your local machine you should be good to go.
+
+When you make a pull request, the tests will automatically be run again by [Travis CI](https://travis-ci.org/).
+
+We also have [StyleCI](https://styleci.io/) setup to automatically fix any code style issues.

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Alt Three Services Limited
+
+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,26 @@
+# Alt Three UUID
+
+A UUID to 64-bit signed integer converter.
+
+This is a lossy conversion, performed by xoring the both halves.
+
+
+## Installation
+
+This version requires 64-bit [PHP](https://php.net) 7.1 or 7.2.
+
+To get the latest version, simply require the project using [Composer](https://getcomposer.org):
+
+```bash
+$ composer require alt-three/uuid
+```
+
+
+## Security
+
+If you discover a security vulnerability within this package, please e-mail us at support@alt-three.com. All security vulnerabilities will be promptly addressed.
+
+
+## License
+
+Alt Three Storage is licensed under [The MIT License (MIT)](LICENSE).

composer.json

@@ -0,0 +1,39 @@
+{
+    "name": "alt-three/uuid",
+    "description": "A UUID To Integer Converter",
+    "keywords": ["UUID", "Alt Three"],
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Alt Three",
+            "email": "support@alt-three.com"
+        }
+    ],
+    "require": {
+        "php-64bit": "^7.1.3"
+    },
+    "require-dev": {
+        "graham-campbell/analyzer": "^2.0",
+        "phpunit/phpunit": "^6.5|^7.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "AltThree\\Uuid\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "AltThree\\Tests\\Uuid\\": "tests/"
+        }
+    },
+    "config": {
+        "preferred-install": "dist"
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-master": "1.0-dev"
+        }
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true
+}

phpunit.xml.dist

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit backupGlobals="false"
+         backupStaticAttributes="false"
+         beStrictAboutTestsThatDoNotTestAnything="true"
+         beStrictAboutOutputDuringTests="true"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         failOnRisky="true"
+         failOnWarning="true"
+         processIsolation="false"
+         stopOnError="false"
+         stopOnFailure="false"
+         verbose="true"
+>
+    <testsuites>
+        <testsuite name="Alt Three UUID Test Suite">
+            <directory suffix="Test.php">./tests</directory>
+        </testsuite>
+    </testsuites>
+    <filter>
+        <whitelist processUncoveredFilesFromWhitelist="true">
+            <directory suffix=".php">./src</directory>
+        </whitelist>
+    </filter>
+</phpunit>

src/UuidConverter.php

@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of Alt Three UUID.
+ *
+ * (c) Alt Three Services Limited
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace AltThree\Uuid;
+
+/**
+ * This is the uuid converter class.
+ *
+ * @author Graham Campbell <graham@alt-three.com>
+ */
+final class UuidConverter
+{
+    /**
+     * Convert a uuid to a 64-bit signed integer.
+     *
+     * This is a lossy conversion, performed by xoring the both halves.
+     *
+     * @param string $uuid
+     *
+     * @return int
+     */
+    public static function convert(string $uuid)
+    {
+        // convert to 16 byte binary represention
+        $bin = hex2bin(str_replace(['{', '-', '}'], '', $uuid));
+
+        // xor first half with second to give 8 bytes
+        $xor = self::xor(...str_split($bin, 8));
+
+        // convert to a 64-bit signed integer
+        return unpack('q', $xor)[1];
+    }
+
+    /**
+     * Bitwise xor both strings.
+     *
+     * @param string $a
+     * @param string $b
+     *
+     * @return string
+     */
+    private static function xor(string $a, string $b)
+    {
+        return $a ^ $b;
+    }
+}

tests/AnalysisTest.php

@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of Alt Three UUID.
+ *
+ * (c) Alt Three Services Limited
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace AltThree\Tests\Uuid;
+
+use GrahamCampbell\Analyzer\AnalysisTrait;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * This is the analysis test class.
+ *
+ * @author Graham Campbell <graham@alt-three.com>
+ */
+class AnalysisTest extends TestCase
+{
+    use AnalysisTrait;
+
+    /**
+     * Get the code paths to analyze.
+     *
+     * @return string[]
+     */
+    protected function getPaths()
+    {
+        return [
+            realpath(__DIR__.'/../src'),
+            realpath(__DIR__),
+        ];
+    }
+}