Merge pull request #1 from conjoon/dev

chore: add library sources and tests

Author: ThorstenSuckow

.github/workflows/run.tests.yml

@@ -0,0 +1,42 @@
+name: Unit Tests
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+
+jobs:
+  php-tests:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    env:
+      COMPOSER_NO_INTERACTION: 1
+      LC_ALL: en_US.UTF-8
+
+    strategy:
+      matrix:
+        php: [7.4]
+        dependency-version: [prefer-stable]
+
+    name: P${{ matrix.php }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: none
+          tools: composer:v1
+
+      - name: Install dependencies
+        run: composer install --no-progress
+
+      - name: Execute Unit Tests
+        run: ./vendor/bin/phpunit --do-not-cache-result
+
+      - name: Check Project Coding Standards
+        run: vendor/bin/phpcs

.gitignore

@@ -0,0 +1,3 @@
+/vendor/
+/.phpunit.result.cache
+/.ddev/

LICENSE renamed to LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022 conjoon
+Copyright (c) 2019-2022 Thorsten Suckow-Homberg https://github.com/conjoon/php-lib-conjoon
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -0,0 +1,24 @@
+# conjoon/php-lib-conjoon ![MIT](https://img.shields.io/github/license/conjoon/php-lib-conjoon) ![Tests](https://github.com/conjoon/php-lib-conjoon/actions/workflows/run.tests.yml/badge.svg)
+PHP library for IMAP operations. 
+
+## Installation
+
+```shell
+$ composer i
+```
+
+## Troubleshooting
+
+### Composer 2.0 - Pear/Horde vows
+If you experience any troubles running `composer`, please revert to **Composer 1.***. You can safely 
+go back to **Composer 2** afterwards.
+
+ - remove `requires` and `repositories` from the _composer.json_, then run
+```shell
+composer self-update --1
+```
+ - add the previously removed `requires` and `repositories` back to _composer.json_, then run
+```shell
+composer update
+composer self-update --rollback
+```

composer.json

@@ -0,0 +1,42 @@
+{
+    "name": "conjoon/php-lib-conjoon",
+    "description": "PHP email library",
+    "type": "library",
+    "repositories": [
+        {
+            "type": "pear",
+            "url": "https://pear.horde.org"
+        }
+    ],
+    "require": {
+        "php": ">=7.4",
+        "ezyang/htmlpurifier": "^4.11",
+        "laravel/lumen-framework": "5.8.*",
+        "pear-pear.horde.org/horde_imap_client": "*",
+        "pear-pear.horde.org/horde_smtp": "*"
+    },
+    "require-dev": {
+        "fakerphp/faker": "^1.9.1",
+        "mockery/mockery": "^1.3.1",
+        "phpunit/phpunit": "^9.3",
+        "squizlabs/php_codesniffer": "*"
+    },
+    "license": "MIT",
+    "autoload": {
+        "psr-4": {
+            "Conjoon\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\Conjoon\\": "tests/",
+            "Tests\\": "tests/"
+        }
+    },
+    "authors": [
+        {
+            "name": "Thorsten Suckow-Homberg",
+            "email": "[email protected]"
+        }
+    ]
+}