gitea/src/9c9ba4c4-2039-4396-9ea2-621e42e04c89/code.power at master · joomengine/gitea · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
	/**
	 * List an organization's labels.
	 *
	 * @param   string  $orgName   The organization name.
	 * @param   int     $pageNum    Page number of results to return (1-based).
	 * @param   int     $pageSize   Page size of results.
	 *
	 * @return  array|null
	 * @since   3.2.0
	 **/
	public function list(
		string $orgName,
		int $pageNum = 1,
		int $pageSize = 10
	): ?array
	{
		// Build the request path.
		$path = "/orgs/{$orgName}/labels";

		// Build the URL
		$url = $this->uri->get($path);
		$url->setVar('page', $pageNum);
		$url->setVar('limit', $pageSize);

		// Send the get request.
		return $this->response->get(
			$this->http->get($url)
		);
	}

	/**
	 * Create a label for an organization.
	 *
	 * @param   string   $org       The organization name.
	 * @param   string   $name      The name of the label.
	 * @param   string   $color     The color of the label.
	 * @param   string   $description Optional. The description of the label.
	 *
	 * @return  object|null
	 * @since   3.2.0
	 **/
	public function create(
		string $org,
		string $name,
		string $color,
		string $description = ''
	): ?object
	{
		// Set the lines data
		$data = new \stdClass();
		$data->name = $name;
		$data->color = $color;
		$data->description = $description;

		// Build the request path.
		$path = "/orgs/{$org}/labels";

		// Send the post request.
		return $this->response->get(
			$this->http->post(
				$this->uri->get($path),
				json_encode($data)
			), 201
		);
	}

	/**
	 * Get a single label for an organization.
	 *
	 * @param   string   $org   The organization name.
	 * @param   int      $id    The ID of the label.
	 *
	 * @return  object|null
	 * @since   3.2.0
	 **/
	public function get(string $org, int $id): ?object
	{
		// Build the request path.
		$path = "/orgs/{$org}/labels/{$id}";

		// Send the get request.
		return $this->response->get(
			$this->http->get(
				$this->uri->get($path)
			)
		);
	}

	/**
	 * Delete a label for an organization.
	 *
	 * @param   string   $org   The organization name.
	 * @param   int      $id    The ID of the label.
	 *
	 * @return  string
	 * @since   3.2.0
	 **/
	public function delete(string $org, int $id): string
	{
		// Build the request path.
		$path = "/orgs/{$org}/labels/{$id}";

		// Send the delete request.
		return $this->response->get(
			$this->http->delete(
				$this->uri->get($path)
			), 204, 'success'
		);
	}

	/**
	 * Update a label for an organization.
	 *
	 * @param   string   $org           The organization name.
	 * @param   int      $id            The ID of the label.
	 * @param   string   $name          Optional. The name of the label.
	 * @param   string   $color         Optional. The color of the label.
	 * @param   string   $description   Optional. The description of the label.
	 *
	 * @return  object|null
	 * @since   3.2.0
	 **/
	public function update(
		string $org,
		int $id,
		string $name = '',
		string $color = '',
		string $description = ''
	): ?object
	{
		// Set the lines data
		$data = new \stdClass();

		if ($name) {
			$data->name = $name;
		}

		if ($color) {
			$data->color = $color;
		}

		if ($description) {
			$data->description = $description;
		}

		// Build the request path.
		$path = "/orgs/{$org}/labels/{$id}";

		// Send the patch request.
		return $this->response->get(
			$this->http->patch(
				$this->uri->get($path),
				json_encode($data)
			)
		);
	}