✨ create laravel integration for devmoath/jira-php

Author: devmoath

.gitattributes

@@ -0,0 +1,11 @@
+/.github           export-ignore
+/art               export-ignore
+/tests             export-ignore
+.gitattributes     export-ignore
+.gitignore         export-ignore
+CONTRIBUTING.md    export-ignore
+LICENSE.md         export-ignore
+phpstan.neon.dist  export-ignore
+phpunit.xml.dist   export-ignore
+README.md          export-ignore
+rector.php         export-ignore

.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+    -   package-ecosystem: "github-actions"
+        directory: "/"
+        schedule:
+            interval: "weekly"
+        labels:
+            - "dependencies"

.github/workflows/formats.yml

@@ -0,0 +1,37 @@
+name: Formats
+
+on: [ 'push', 'pull_request' ]
+
+jobs:
+    formats:
+        runs-on: ${{ matrix.os }}
+        strategy:
+            fail-fast: true
+            matrix:
+                os: [ ubuntu-latest ]
+                php: [ 8.2 ]
+                stability: [ prefer-lowest, prefer-stable ]
+
+        name: Formats php${{ matrix.php }} - ${{ matrix.os }} - ${{ matrix.stability }}
+
+        steps:
+            -   name: Checkout
+                uses: actions/checkout@v3
+
+            -   name: Setup PHP
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: ${{ matrix.php }}
+                    coverage: none
+
+            -   name: Install Composer dependencies
+                run: composer update --${{ matrix.stability }} --no-interaction
+
+            -   name: Coding Style Checks
+                run: composer test:lint
+
+            -   name: Refactor Checks
+                run: composer test:refactor
+
+            -   name: Type Checks
+                run: composer test:types

.github/workflows/tests.yml

@@ -0,0 +1,31 @@
+name: Tests
+
+on: [ 'push', 'pull_request' ]
+
+jobs:
+    tests:
+        runs-on: ${{ matrix.os }}
+        strategy:
+            fail-fast: true
+            matrix:
+                os: [ ubuntu-latest ]
+                php: [ 8.1, 8.2 ]
+                stability: [ prefer-lowest, prefer-stable ]
+
+        name: Tests php${{ matrix.php }} - ${{ matrix.os }} - ${{ matrix.stability }}
+
+        steps:
+            -   name: Checkout
+                uses: actions/checkout@v3
+
+            -   name: Setup PHP
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: ${{ matrix.php }}
+                    coverage: pcov
+
+            -   name: Install Composer dependencies
+                run: composer update --${{ matrix.stability }} --no-interaction
+
+            -   name: Unit Tests
+                run: composer test:unit

.gitignore

@@ -0,0 +1,4 @@
+/.idea/
+/vendor/
+/.phpunit.result.cache
+/composer.lock

CONTRIBUTING.md

@@ -0,0 +1,68 @@
+# CONTRIBUTING
+
+Contributions are welcome, and are accepted via pull requests.
+Please review these guidelines before submitting any pull requests.
+
+## Process
+
+1. Fork the project
+2. Create a new branch
+3. Code, test, commit and push
+4. Open a pull request detailing your changes.
+
+## Guidelines
+
+* Please ensure the coding style running `composer lint`.
+* 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.
+* Please remember that we follow [SemVer](http://semver.org/).
+
+## Setup
+
+Clone your fork, then install the dev dependencies:
+
+```bash
+composer install
+```
+
+## Refactor
+
+Refactor your code:
+
+```bash
+composer refactor
+```
+
+## Lint
+
+Lint your code:
+
+```bash
+composer lint
+```
+
+## Tests
+
+Run all tests:
+
+```bash
+composer test
+```
+
+Check code quality:
+
+```bash
+composer test:refactor
+```
+
+Check types:
+
+```bash
+composer test:types
+```
+
+Unit tests:
+
+```bash
+composer test:unit
+```

LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Moath Alhajri <moath.alhajrii@gmail.com>
+
+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,65 @@
+<p align="center">
+    <img src="art/example.png" alt="Jira Laravel">
+</p>
+
+<p align="center">
+    <a href="https://github.com/devmoath/jira-laravel/actions"><img alt="GitHub Workflow Status (0.x)" src="https://img.shields.io/github/actions/workflow/status/devmoath/jira-laravel/tests.yml?branch=0.x"></a>
+    <a href="https://packagist.org/packages/devmoath/jira-laravel"><img alt="Total Downloads" src="https://img.shields.io/packagist/dt/devmoath/jira-laravel"></a>
+    <a href="https://packagist.org/packages/devmoath/jira-laravel"><img alt="Latest Version" src="https://img.shields.io/packagist/v/devmoath/jira-laravel"></a>
+    <a href="https://packagist.org/packages/devmoath/jira-laravel"><img alt="License" src="https://img.shields.io/github/license/devmoath/jira-laravel"></a>
+</p>
+
+---
+
+**Jira PHP** for Laravel is a supercharged PHP API client that allows you to interact with
+the [Jira API](https://docs.atlassian.com/software/jira/docs/api/REST/8.0.0) and
+the [Service Desk API](https://docs.atlassian.com/jira-servicedesk/REST/5.2.0/).
+
+> **Note**
+>
+> This repository contains the integration code of the **Jira PHP** for Laravel. If you want to use the **Jira PHP**
+> client in a framework-agnostic way, take a look at the [devmoath/jira-php](https://github.com/devmoath/jira-php)
+> repository.
+
+## Get Started
+
+> **Requires [PHP 8.1+](https://php.net/releases/)**
+
+First, install `devmoath/jira-laravel` via the [Composer](https://getcomposer.org/) package manager:
+
+```bash
+composer require devmoath/jira-laravel
+```
+
+Next, publish the configuration file:
+
+```bash
+php artisan vendor:publish --provider="Jira\Laravel\ServiceProvider"
+```
+
+This will create a `config/jira.php` configuration file in your project, which you can modify to your needs
+using environment variables:
+
+```dotenv
+JIRA_USERNAME=USERNAME
+JIRA_PASSWORD=PASSWORD
+JIRA_HOST=jira.domain.com
+```
+
+Finally, you may use the `Jira` facade to access the available functions:
+
+```php
+use Jira\Laravel\Facades\Jira;
+
+$result = Jira::issues()->search();
+
+echo $result['issues'][0]['key']; // KEY-1000
+```
+
+## Usage
+
+For usage examples, take a look at the [devmoath/jira-php](https://github.com/devmoath/jira-php) repository.
+
+---
+
+Jira PHP for Laravel is an open-sourced software licensed under the **[MIT license](https://opensource.org/licenses/MIT)**.