migrate therinaldos.com data

wedding-pics/lib/public/Log/Audit/CriticalActionPerformedEvent.php

@@ -0,0 +1,83 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2021 Joas Schilling <coding@schilljs.com>
+ *
+ * @author Joas Schilling <coding@schilljs.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCP\Log\Audit;
+
+use OCP\EventDispatcher\Event;
+
+/**
+ * Emitted when the admin_audit app should log an entry
+ *
+ * @since 22.0.0
+ */
+class CriticalActionPerformedEvent extends Event {
+	/** @var string */
+	private $logMessage;
+
+	/** @var array */
+	private $parameters;
+
+	/** @var bool */
+	private $obfuscateParameters;
+
+	/**
+	 * @param string $logMessage
+	 * @param array $parameters
+	 * @param bool $obfuscateParameters
+	 * @since 22.0.0
+	 */
+	public function __construct(string $logMessage,
+		array $parameters = [],
+		bool $obfuscateParameters = false) {
+		parent::__construct();
+		$this->logMessage = $logMessage;
+		$this->parameters = $parameters;
+		$this->obfuscateParameters = $obfuscateParameters;
+	}
+
+	/**
+	 * @return string
+	 * @since 22.0.0
+	 */
+	public function getLogMessage(): string {
+		return $this->logMessage;
+	}
+
+	/**
+	 * @return array
+	 * @since 22.0.0
+	 */
+	public function getParameters(): array {
+		return $this->parameters;
+	}
+
+	/**
+	 * @return bool
+	 * @since 22.0.0
+	 */
+	public function getObfuscateParameters(): bool {
+		return $this->obfuscateParameters;
+	}
+}

wedding-pics/lib/public/Log/BeforeMessageLoggedEvent.php

@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * @copyright Copyright (c) 2023 Robin Appelman <robin@icewind.nl>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+
+namespace OCP\Log;
+
+use OCP\EventDispatcher\Event;
+
+/**
+ * Even for when a log item is being logged
+ *
+ * @since 28.0.0
+ */
+class BeforeMessageLoggedEvent extends Event {
+	private int $level;
+	private string $app;
+	private $message;
+
+	/**
+	 * @param string $app
+	 * @param int $level
+	 * @param array $message
+	 * @since 28.0.0
+	 */
+	public function __construct(string $app, int $level, array $message) {
+		$this->level = $level;
+		$this->app = $app;
+		$this->message = $message;
+	}
+
+	/**
+	 * Get the level of the log item
+	 *
+	 * @return int
+	 * @since 28.0.0
+	 */
+	public function getLevel(): int {
+		return $this->level;
+	}
+
+
+	/**
+	 * Get the app context of the log item
+	 *
+	 * @return string
+	 * @since 28.0.0
+	 */
+	public function getApp(): string {
+		return $this->app;
+	}
+
+
+	/**
+	 * Get the message of the log item
+	 *
+	 * @return array
+	 * @since 28.0.0
+	 */
+	public function getMessage(): array {
+		return $this->message;
+	}
+}

wedding-pics/lib/public/Log/IDataLogger.php

@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @copyright Copyright (c) 2019 Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCP\Log;
+
+/**
+ * Interface IDataLogger
+ *
+ * @since 18.0.1
+ */
+interface IDataLogger {
+	/**
+	 * allows to log custom data, similar to how logException works
+	 *
+	 * @since 18.0.1
+	 */
+	public function logData(string $message, array $data, array $context = []): void;
+}

wedding-pics/lib/public/Log/IFileBased.php

@@ -0,0 +1,42 @@
+<?php
+/**
+ * @copyright Copyright (c) 2018 Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
+ * @author Christoph Wurst <christoph@winzerhof-wurst.at>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCP\Log;
+
+/**
+ * Interface IFileBased
+ *
+ *
+ * @since 14.0.0
+ */
+interface IFileBased {
+	/**
+	 * @since 14.0.0
+	 */
+	public function getLogFilePath():string;
+
+	/**
+	 * @since 14.0.0
+	 */
+	public function getEntries(int $limit = 50, int $offset = 0): array;
+}

wedding-pics/lib/public/Log/ILogFactory.php

@@ -0,0 +1,60 @@
+<?php
+/**
+ * @copyright Copyright (c) 2018 Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
+ * @author Christoph Wurst <christoph@winzerhof-wurst.at>
+ * @author Johannes Ernst <jernst@indiecomputing.com>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCP\Log;
+
+use OCP\ILogger;
+use Psr\Log\LoggerInterface;
+
+/**
+ * Interface ILogFactory
+ *
+ * @since 14.0.0
+ */
+interface ILogFactory {
+	/**
+	 * @param string $type - one of: file, errorlog, syslog, systemd
+	 * @return IWriter
+	 * @since 14.0.0
+	 */
+	public function get(string $type): IWriter;
+
+	/**
+	 * @param string $path
+	 * @return ILogger
+	 * @since 14.0.0
+	 * @deprecated 22.0.0 Use \OCP\Log\ILogFactory::getCustomPsrLogger
+	 * @see \OCP\Log\ILogFactory::getCustomPsrLogger
+	 */
+	public function getCustomLogger(string $path): ILogger;
+
+	/**
+	 * @param string $path
+	 * @param string $type
+	 * @param string $tag
+	 * @return LoggerInterface
+	 * @since 22.0.0 - Parameters $type and $tag were added in 24.0.0
+	 */
+	public function getCustomPsrLogger(string $path, string $type = 'file', string $tag = 'Nextcloud'): LoggerInterface;
+}

wedding-pics/lib/public/Log/IWriter.php

@@ -0,0 +1,39 @@
+<?php
+/**
+ * @copyright Copyright (c) 2018 Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCP\Log;
+
+/**
+ * Interface IWriter
+ *
+ * @since 14.0.0
+ */
+interface IWriter {
+	/**
+	 * @since 14.0.0
+	 *
+	 * @param string $app
+	 * @param string|array $message
+	 * @param int $level
+	 */
+	public function write(string $app, $message, int $level);
+}

wedding-pics/lib/public/Log/RotationTrait.php

@@ -0,0 +1,68 @@
+<?php
+/**
+ * @copyright Copyright (c) 2018 Arthur Schiwon <blizzz@arthur-schiwon.de>
+ *
+ * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
+ * @author dartcafe <github@dartcafe.de>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCP\Log;
+
+/**
+ * Trait RotationTrait
+ *
+ *
+ * @since 14.0.0
+ */
+trait RotationTrait {
+	/**
+	 * @var string
+	 * @since 14.0.0
+	 */
+	protected $filePath;
+
+	/**
+	 * @var int
+	 * @since 14.0.0
+	 */
+	protected $maxSize;
+
+	/**
+	 * @return string the resulting new filepath
+	 * @since 14.0.0
+	 */
+	protected function rotate():string {
+		$rotatedFile = $this->filePath.'.1';
+		rename($this->filePath, $rotatedFile);
+		return $rotatedFile;
+	}
+
+	/**
+	 * @return bool
+	 * @since 14.0.0
+	 */
+	protected function shouldRotateBySize():bool {
+		if ((int)$this->maxSize > 0 && file_exists($this->filePath)) {
+			$filesize = @filesize($this->filePath);
+			if ($filesize >= (int)$this->maxSize) {
+				return true;
+			}
+		}
+		return false;
+	}
+}

wedding-pics/lib/public/Log/functions.php

@@ -0,0 +1,74 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * @copyright 2022 Christoph Wurst <christoph@winzerhof-wurst.at>
+ *
+ * @author 2022 Christoph Wurst <christoph@winzerhof-wurst.at>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+namespace OCP\Log;
+
+use OC;
+use OCP\AppFramework\QueryException;
+use Psr\Log\LoggerInterface;
+use Psr\Log\NullLogger;
+use function class_exists;
+
+/**
+ * Get a PSR logger
+ *
+ * Whenever possible, inject a logger into your classes instead of relying on
+ * this helper function.
+ *
+ * @warning the returned logger implementation is not guaranteed to be the same
+ *          between two function calls. During early stages of the process you
+ *          might in fact get a noop implementation when Nextcloud isn't ready
+ *          to log. Therefore you MUST NOT cache the result of this function but
+ *          fetch a new logger for every log line you want to write.
+ *
+ * @param string|null $appId optional parameter to acquire the app-specific logger
+ *
+ * @return LoggerInterface
+ * @since 24.0.0
+ */
+function logger(string $appId = null): LoggerInterface {
+	/** @psalm-suppress TypeDoesNotContainNull false-positive, it may contain null if we are logging from initialization */
+	if (!class_exists(OC::class) || OC::$server === null) {
+		// If someone calls this log before Nextcloud is initialized, there is
+		// no logging available. In that case we return a noop implementation
+		// TODO: evaluate whether logging to error_log could be an alternative
+		return new NullLogger();
+	}
+
+	if ($appId !== null) {
+		try {
+			$appContainer = OC::$server->getRegisteredAppContainer($appId);
+			return $appContainer->get(LoggerInterface::class);
+		} catch (QueryException $e) {
+			// Ignore and return the server logger below
+		}
+	}
+
+	try {
+		return OC::$server->get(LoggerInterface::class);
+	} catch (QueryException $e) {
+		return new NullLogger();
+	}
+}