14503644156

Committed 16 Apr 2025 10:16PM UTC coverage: 81.656% (-0.4%) from 82.08%

Build # 14503644156

Build Type

push

github

Committed by

tylernathanreed

Commit Message

- Dropped guzzle as a requirement

Coverage Stats

53 of 99 new or added lines in 8 files covered. (53.54%)

5738 of 7027 relevant lines covered (81.66%)

10.35 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

76.67

/src/Client.php

<?php

namespace Jira\Client;

use Closure;
use Jira\Client\Http\Contracts\Transporter as TransporterContract;
use Jira\Client\Http\Deserializer;
use Jira\Client\Http\Dto;
use Jira\Client\Http\Exceptions\StrayRequestException;
use Jira\Client\Http\PendingOperation;
use Jira\Client\Http\PolymorphicDto;
use Jira\Client\Http\Processor;
use Jira\Client\Http\Request;
use Jira\Client\Http\Response;
use Jira\Client\Http\TransporterFactory;

class Client
{
    use PerformsOperations;

    public readonly Configuration $configuration;
    public readonly TransporterContract $transporter;
    public readonly Processor $processor;

    /** @var list<Closure(Request):?Response> */
    protected array $stubCallbacks = [];

    public function __construct(
        Configuration $configuration,
        ?TransporterContract $transporter = null,
        ?Processor $processor = null
    ) {
        $this->configuration = $configuration;
        $this->transporter = $transporter ?: TransporterFactory::make();
        $this->processor = $processor ?: new Processor(new Deserializer());
    }

    /**
     * @phpstan-template TDto of Dto
     * 
     * @param 'get'|'post'|'put'|'patch'|'delete' $method
     * @param array{0:class-string<TDto>}|class-string<TDto>|true $schema
     * @param Dto|array<string,mixed> $body
     * @param array<string,mixed> $header
     * @param array<string,mixed> $query
     * @param array<string,int|string|null> $path
     *
     * @return (
     *     $schema is array ? (TDto is PolymorphicDto ? list<Dto> : list<TDto>) : (
     *     $schema is string ? (TDto is PolymorphicDto ? Dto : TDto) : (
     *     true
     * )))
     */
    public function call(
        string $uri,
        string $method,
        int $success,
        array|string|true $schema,
        Dto|array $body = [],
        array $header = [],
        array $query = [],
        array $path = [],
    ): array|Dto|true {
        $operation = new PendingOperation(
            uri: $uri,
            method: $method,
            body: $body,
            header: $header,
            query: $query,
            path: $path,
        );

        $request = $this->transporter->newRequest($operation, $this->configuration);

        $response = $this->handleStubCallbacks($request)
            ?: $this->transporter->newResponse($request, $this->configuration);

        return $this->processor->process($operation, $response, $success, $schema);
    }

    /** @param Closure(Request):?Response $callback */
    public function fake(Closure $callback): static
    {
        $this->stubCallbacks[] = $callback;

        return $this;
    }

    protected function handleStubCallbacks(Request $request): ?Response
    {
        foreach ($this->stubCallbacks as $callback) {
            if (! is_null($response = $callback($request))) {
                return $response;
            }
        }

        if (! empty($this->stubCallbacks)) {
            throw new StrayRequestException(sprintf(
                'Attempted request to [%s] without a matching fake.',
                $request->uri,
            ));
        }

        return null;
    }
}

1	<?php
2
3	namespace Jira\Client;
4
5	use Closure;
6	use Jira\Client\Http\Contracts\Transporter as TransporterContract;
7	use Jira\Client\Http\Deserializer;
8	use Jira\Client\Http\Dto;
9	use Jira\Client\Http\Exceptions\StrayRequestException;
10	use Jira\Client\Http\PendingOperation;
11	use Jira\Client\Http\PolymorphicDto;
12	use Jira\Client\Http\Processor;
13	use Jira\Client\Http\Request;
14	use Jira\Client\Http\Response;
15	use Jira\Client\Http\TransporterFactory;
16
17	class Client
18	{
19	use PerformsOperations;
20
21	public readonly Configuration $configuration;
22	public readonly TransporterContract $transporter;
23	public readonly Processor $processor;
24
25	/** @var list<Closure(Request):?Response> */
26	protected array $stubCallbacks = [];
27
28	public function __construct(	512✔
29	Configuration $configuration,
30	?TransporterContract $transporter = null,
31	?Processor $processor = null
32	) {
33	$this->configuration = $configuration;	512✔
34	$this->transporter = $transporter ?: TransporterFactory::make();	512✔
35	$this->processor = $processor ?: new Processor(new Deserializer());	512✔
36	}
37
38	/**
39	* @phpstan-template TDto of Dto
40	*
41	* @param 'get'\|'post'\|'put'\|'patch'\|'delete' $method
42	* @param array{0:class-string<TDto>}\|class-string<TDto>\|true $schema
43	* @param Dto\|array<string,mixed> $body
44	* @param array<string,mixed> $header
45	* @param array<string,mixed> $query
46	* @param array<string,int\|string\|null> $path
47	*
48	* @return (
49	* $schema is array ? (TDto is PolymorphicDto ? list<Dto> : list<TDto>) : (
50	* $schema is string ? (TDto is PolymorphicDto ? Dto : TDto) : (
51	* true
52	* )))
53	*/
54	public function call(	512✔
55	string $uri,
56	string $method,
57	int $success,
58	array\|string\|true $schema,
59	Dto\|array $body = [],
60	array $header = [],
61	array $query = [],
62	array $path = [],
63	): array\|Dto\|true {
64	$operation = new PendingOperation(	512✔
65	uri: $uri,	512✔
66	method: $method,	512✔
67	body: $body,	512✔
68	header: $header,	512✔
69	query: $query,	512✔
70	path: $path,	512✔
71	);	512✔
72
73	$request = $this->transporter->newRequest($operation, $this->configuration);	512✔
74
75	$response = $this->handleStubCallbacks($request)	512✔
NEW 76	?: $this->transporter->newResponse($request, $this->configuration);	×
77
78	return $this->processor->process($operation, $response, $success, $schema);	512✔
79	}
80
81	/** @param Closure(Request):?Response $callback */
82	public function fake(Closure $callback): static	512✔
83	{
84	$this->stubCallbacks[] = $callback;	512✔
85
86	return $this;	512✔
87	}
88
89	protected function handleStubCallbacks(Request $request): ?Response	512✔
90	{
91	foreach ($this->stubCallbacks as $callback) {	512✔
92	if (! is_null($response = $callback($request))) {	512✔
93	return $response;	512✔
94	}
95	}
96
NEW 97	if (! empty($this->stubCallbacks)) {	×
NEW 98	throw new StrayRequestException(sprintf(	×
NEW 99	'Attempted request to [%s] without a matching fake.',	×
NEW 100	$request->uri,	×
NEW 101	));	×
102	}
103
NEW 104	return null;	×
105	}
106	}

tylernathanreed / jira-client-php / 14503644156

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous