Add constructor API documentation
This commit is contained in:
parent
c3223f0add
commit
df3ef9829e
60 changed files with 80 additions and 2 deletions
|
@ -26,6 +26,7 @@ import de.staropensource.engine.base.implementable.formatter.TwoCycleFormatterIm
|
||||||
* Formats a string using ANSI
|
* Formats a string using ANSI
|
||||||
* escape sequences.
|
* escape sequences.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this formatter
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class AnsiFormatter : TwoCycleFormatterImpl() {
|
class AnsiFormatter : TwoCycleFormatterImpl() {
|
||||||
|
|
|
@ -28,6 +28,7 @@ import de.staropensource.engine.base.utility.dnihbd.BuildInformation
|
||||||
/**
|
/**
|
||||||
* The ANSI subsystem.
|
* The ANSI subsystem.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this subsystem
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class AnsiSubsystem : Subsystem() {
|
class AnsiSubsystem : Subsystem() {
|
||||||
|
|
|
@ -35,6 +35,7 @@ import kotlin.reflect.KClass
|
||||||
* This class is responsible for starting
|
* This class is responsible for starting
|
||||||
* and shutting the engine up or down.
|
* and shutting the engine up or down.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class Engine private constructor() {
|
class Engine private constructor() {
|
||||||
|
|
|
@ -40,6 +40,7 @@ import kotlin.reflect.KClass
|
||||||
/**
|
/**
|
||||||
* Provides the engine configuration.
|
* Provides the engine configuration.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class EngineConfiguration private constructor() {
|
class EngineConfiguration private constructor() {
|
||||||
|
|
|
@ -26,6 +26,8 @@ package de.staropensource.engine.base.exception
|
||||||
* After this occurs, it will no longer
|
* After this occurs, it will no longer
|
||||||
* be possible to initialize the engine.
|
* be possible to initialize the engine.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this exception
|
||||||
|
* @param throwable [Throwable] which caused the initialization to fail
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class EngineInitializationFailureException(val throwable: Throwable) : RuntimeException("The StarOpenSource Engine failed to initialize", throwable)
|
class EngineInitializationFailureException(val throwable: Throwable) : RuntimeException("The StarOpenSource Engine failed to initialize", throwable)
|
||||||
|
|
|
@ -22,6 +22,9 @@ package de.staropensource.engine.base.exception
|
||||||
/**
|
/**
|
||||||
* Thrown when a verification fails.
|
* Thrown when a verification fails.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this exception
|
||||||
|
* @param error error
|
||||||
|
* @param throwable [Throwable] which caused the verification to fail
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class VerificationFailedException(val error: String? = null, val throwable: Throwable? = null) : RuntimeException(error, throwable)
|
class VerificationFailedException(val error: String? = null, val throwable: Throwable? = null) : RuntimeException(error, throwable)
|
||||||
|
|
|
@ -23,6 +23,9 @@ package de.staropensource.engine.base.exception.io
|
||||||
* Thrown when being unable to
|
* Thrown when being unable to
|
||||||
* find a file or directory.
|
* find a file or directory.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this exception
|
||||||
|
* @param path path which does not exist
|
||||||
|
* @param throwable [Throwable] which caused the file or directory to not be found
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class FileOrDirectoryNotFoundException(val path: String, val throwable: Throwable? = null) : Exception("The file or directory '${path}' could not be found", throwable)
|
class FileOrDirectoryNotFoundException(val path: String, val throwable: Throwable? = null) : Exception("The file or directory '${path}' could not be found", throwable)
|
||||||
|
|
|
@ -24,6 +24,9 @@ package de.staropensource.engine.base.exception.io
|
||||||
* fails due to it being larger
|
* fails due to it being larger
|
||||||
* than the heap.
|
* than the heap.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this exception
|
||||||
|
* @param path path of the file which is too large
|
||||||
|
* @param throwable [Throwable] which caused the file read to fail
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class FileTooLargeException(val path: String, val throwable: Throwable? = null) : RuntimeException("Unable to read file '${path}' as it is larger than the configured heap size", throwable)
|
class FileTooLargeException(val path: String, val throwable: Throwable? = null) : RuntimeException("Unable to read file '${path}' as it is larger than the configured heap size", throwable)
|
||||||
|
|
|
@ -23,6 +23,9 @@ package de.staropensource.engine.base.exception.io
|
||||||
* Thrown when a general
|
* Thrown when a general
|
||||||
* IO error occurs.
|
* IO error occurs.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this exception
|
||||||
|
* @param error error
|
||||||
|
* @param throwable [Throwable] which caused this IO error
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class IOAccessException(val error: String? = null, val throwable: Throwable? = null) : RuntimeException(error, throwable)
|
class IOAccessException(val error: String? = null, val throwable: Throwable? = null) : RuntimeException(error, throwable)
|
||||||
|
|
|
@ -25,6 +25,8 @@ import de.staropensource.engine.base.implementable.stream.Stream
|
||||||
* Thrown when trying to
|
* Thrown when trying to
|
||||||
* access a closed [Stream].
|
* access a closed [Stream].
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this exception
|
||||||
|
* @param stream stream which was accessed
|
||||||
* @see Stream
|
* @see Stream
|
||||||
* @see Stream.closed
|
* @see Stream.closed
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
|
|
|
@ -22,6 +22,7 @@ package de.staropensource.engine.base.implementable
|
||||||
/**
|
/**
|
||||||
* Provides an API for the engine to talk to subsystems.
|
* Provides an API for the engine to talk to subsystems.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this subsystem
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
abstract class Subsystem {
|
abstract class Subsystem {
|
||||||
|
|
|
@ -48,6 +48,7 @@ package de.staropensource.engine.base.implementable.formatter
|
||||||
* If an invalid tag is found it must be
|
* If an invalid tag is found it must be
|
||||||
* simply ignored.
|
* simply ignored.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this formatter
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
abstract class Formatter {
|
abstract class Formatter {
|
||||||
|
|
|
@ -31,6 +31,7 @@ package de.staropensource.engine.base.implementable.formatter
|
||||||
* unnecessary resource and memory usage for
|
* unnecessary resource and memory usage for
|
||||||
* certain formatters.
|
* certain formatters.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this formatter
|
||||||
* @see Formatter
|
* @see Formatter
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -31,6 +31,7 @@ package de.staropensource.engine.base.implementable.formatter
|
||||||
* unnecessary resource and memory usage for
|
* unnecessary resource and memory usage for
|
||||||
* certain formatters.
|
* certain formatters.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this formatter
|
||||||
* @see Formatter
|
* @see Formatter
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -38,6 +38,7 @@ import kotlin.text.iterator
|
||||||
* - `COLOR:` (example `COLOR:RED`)
|
* - `COLOR:` (example `COLOR:RED`)
|
||||||
* - `ATTRIBUTE:` (example `ATTRIBUTE:BOLD`)
|
* - `ATTRIBUTE:` (example `ATTRIBUTE:BOLD`)
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this formatter
|
||||||
* @see TwoCycleFormatter
|
* @see TwoCycleFormatter
|
||||||
* @see Formatter
|
* @see Formatter
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
|
|
|
@ -26,6 +26,7 @@ import de.staropensource.engine.base.type.logging.Feature
|
||||||
/**
|
/**
|
||||||
* Builds log formats.
|
* Builds log formats.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this format builder
|
||||||
* @param call [Call] to build a format for
|
* @param call [Call] to build a format for
|
||||||
* @param channelSettings appropriate [ChannelSettings] instance
|
* @param channelSettings appropriate [ChannelSettings] instance
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
|
|
|
@ -22,6 +22,7 @@ package de.staropensource.engine.base.implementable.stream
|
||||||
/**
|
/**
|
||||||
* A read-only [Stream].
|
* A read-only [Stream].
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
abstract class ReadStream : Stream(
|
abstract class ReadStream : Stream(
|
||||||
|
|
|
@ -31,6 +31,7 @@ import java.io.OutputStream
|
||||||
/**
|
/**
|
||||||
* Makes streaming data easy.
|
* Makes streaming data easy.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param streamMode supported [StreamMode]s
|
* @param streamMode supported [StreamMode]s
|
||||||
* @param autoFlushAfter after which amount of bytes to automatically flush. May be ignored by some implementations. Implementations should expose this argument in their constructor
|
* @param autoFlushAfter after which amount of bytes to automatically flush. May be ignored by some implementations. Implementations should expose this argument in their constructor
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
|
@ -706,6 +707,7 @@ abstract class Stream(
|
||||||
* An implementation of Java
|
* An implementation of Java
|
||||||
* [InputStream]s for [Stream]s.
|
* [InputStream]s for [Stream]s.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param stream [Stream] to use
|
* @param stream [Stream] to use
|
||||||
* @throws IOException on IO error
|
* @throws IOException on IO error
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
|
@ -733,6 +735,7 @@ abstract class Stream(
|
||||||
* An implementation of Java
|
* An implementation of Java
|
||||||
* [OutputStream]s for [Stream]s.
|
* [OutputStream]s for [Stream]s.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param stream [Stream] to use
|
* @param stream [Stream] to use
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -22,6 +22,7 @@ package de.staropensource.engine.base.implementable.stream
|
||||||
/**
|
/**
|
||||||
* A write-only [Stream].
|
* A write-only [Stream].
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param autoFlushAfter after which amount of bytes to automatically flush. May be ignored by some implementations. Implementations should expose this argument in their constructor
|
* @param autoFlushAfter after which amount of bytes to automatically flush. May be ignored by some implementations. Implementations should expose this argument in their constructor
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -26,6 +26,7 @@ import kotlin.system.exitProcess
|
||||||
* [ShutdownHandler] implementation using
|
* [ShutdownHandler] implementation using
|
||||||
* Kotlin's [exitProcess] method.
|
* Kotlin's [exitProcess] method.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this shutdown handler
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class KotlinShutdownHandler private constructor() : ShutdownHandler {
|
class KotlinShutdownHandler private constructor() : ShutdownHandler {
|
||||||
|
|
|
@ -27,6 +27,7 @@ import kotlin.text.iterator
|
||||||
* Swallows all formatting tags
|
* Swallows all formatting tags
|
||||||
* and returns a clean format.
|
* and returns a clean format.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this formatter
|
||||||
* @see Formatter
|
* @see Formatter
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -27,6 +27,8 @@ import de.staropensource.engine.base.utility.FileAccess
|
||||||
* [Adapter] for writing log
|
* [Adapter] for writing log
|
||||||
* output to the specific file.
|
* output to the specific file.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this adapter
|
||||||
|
* @param location file to write log output to
|
||||||
* @see Adapter
|
* @see Adapter
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -26,6 +26,7 @@ import de.staropensource.engine.base.type.logging.Call
|
||||||
* [Adapter] for printing messages
|
* [Adapter] for printing messages
|
||||||
* using Kotlin's [println] method.
|
* using Kotlin's [println] method.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this adapter
|
||||||
* @see Adapter
|
* @see Adapter
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -26,6 +26,7 @@ import de.staropensource.engine.base.utility.dnihbd.BuildInformation
|
||||||
* [CrashCategory] implementation
|
* [CrashCategory] implementation
|
||||||
* providing information about the engine.
|
* providing information about the engine.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this crash category
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class EngineCrashCategory private constructor() : BuildInformation.BuildInformationCrashCategory() {
|
class EngineCrashCategory private constructor() : BuildInformation.BuildInformationCrashCategory() {
|
||||||
|
|
|
@ -32,6 +32,7 @@ import kotlinx.datetime.toLocalDateTime
|
||||||
* providing information about the
|
* providing information about the
|
||||||
* environment the engine runs in.
|
* environment the engine runs in.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this crash category
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class EnvironmentCrashCategory private constructor() : CrashCategory {
|
class EnvironmentCrashCategory private constructor() : CrashCategory {
|
||||||
|
|
|
@ -28,6 +28,7 @@ import de.staropensource.engine.base.utility.misc.StackTraceUtils
|
||||||
* [CrashCategory] implementation
|
* [CrashCategory] implementation
|
||||||
* providing insight into a crash.
|
* providing insight into a crash.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this crash category
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class InfoCrashCategory private constructor() : CrashCategory {
|
class InfoCrashCategory private constructor() : CrashCategory {
|
||||||
|
|
|
@ -41,6 +41,7 @@ import kotlin.time.Duration
|
||||||
* [505ms] [03.10.1990 23:23:23] [INFO de.staropensource.engine.testapp.Main#sayHi~42] Hello World!
|
* [505ms] [03.10.1990 23:23:23] [INFO de.staropensource.engine.testapp.Main#sayHi~42] Hello World!
|
||||||
* ```
|
* ```
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this format builder
|
||||||
* @param call [Call] to build a format for
|
* @param call [Call] to build a format for
|
||||||
* @param channelSettings appropriate [ChannelSettings] instance
|
* @param channelSettings appropriate [ChannelSettings] instance
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
|
|
|
@ -28,6 +28,7 @@ import java.io.ByteArrayInputStream
|
||||||
* A [Stream] which can
|
* A [Stream] which can
|
||||||
* only read [Byte]s.
|
* only read [Byte]s.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param bytesRead [ByteArray] to provide for reading
|
* @param bytesRead [ByteArray] to provide for reading
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -27,6 +27,7 @@ import java.io.ByteArrayInputStream
|
||||||
* A [Stream] which can
|
* A [Stream] which can
|
||||||
* read and write [Byte]s.
|
* read and write [Byte]s.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param bytesRead [ByteArray] to provide for reading
|
* @param bytesRead [ByteArray] to provide for reading
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -27,6 +27,7 @@ import de.staropensource.engine.base.implementable.stream.WriteStream
|
||||||
* A [Stream] which can
|
* A [Stream] which can
|
||||||
* only write [Byte]s.
|
* only write [Byte]s.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
open class ByteWriteStream : WriteStream(
|
open class ByteWriteStream : WriteStream(
|
||||||
|
|
|
@ -31,6 +31,7 @@ import java.io.InputStream
|
||||||
* accessing files via the [FileAccess]
|
* accessing files via the [FileAccess]
|
||||||
* API.
|
* API.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param file [FileAccess] to use
|
* @param file [FileAccess] to use
|
||||||
* @see FileAccess.toStream
|
* @see FileAccess.toStream
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
|
|
|
@ -30,6 +30,7 @@ import java.io.InputStream
|
||||||
* it's calls instances of Java's
|
* it's calls instances of Java's
|
||||||
* [InputStream] class.
|
* [InputStream] class.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param inputStream Java's [InputStream] to read from
|
* @param inputStream Java's [InputStream] to read from
|
||||||
* @param autoCloseJavaStream if to automatically close the supplied [InputStream] if [close] is invoked
|
* @param autoCloseJavaStream if to automatically close the supplied [InputStream] if [close] is invoked
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
|
|
|
@ -31,6 +31,7 @@ import java.io.OutputStream
|
||||||
* [InputStream] and [OutputStream]
|
* [InputStream] and [OutputStream]
|
||||||
* classes.
|
* classes.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param inputStream Java's [InputStream] to read from
|
* @param inputStream Java's [InputStream] to read from
|
||||||
* @param outputStream Java's [OutputStream] to write to
|
* @param outputStream Java's [OutputStream] to write to
|
||||||
* @param autoCloseJavaStreams if to automatically close the supplied [InputStream] and [OutputStream] if [close] is invoked
|
* @param autoCloseJavaStreams if to automatically close the supplied [InputStream] and [OutputStream] if [close] is invoked
|
||||||
|
|
|
@ -30,6 +30,7 @@ import java.io.OutputStream
|
||||||
* it's calls instances of Java's
|
* it's calls instances of Java's
|
||||||
* [OutputStream] class.
|
* [OutputStream] class.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param outputStream Java's [OutputStream] to write to
|
* @param outputStream Java's [OutputStream] to write to
|
||||||
* @param autoCloseJavaStream if to automatically close the supplied [OutputStream] if [close] is invoked
|
* @param autoCloseJavaStream if to automatically close the supplied [OutputStream] if [close] is invoked
|
||||||
* @param autoFlushAfter after which amount of bytes to automatically flush. May be ignored by some implementations. Implementations should expose this argument in their constructor
|
* @param autoFlushAfter after which amount of bytes to automatically flush. May be ignored by some implementations. Implementations should expose this argument in their constructor
|
||||||
|
|
|
@ -32,6 +32,7 @@ import de.staropensource.engine.base.utility.FileAccess
|
||||||
* A log message is only printed
|
* A log message is only printed
|
||||||
* after a newline (`\n`) is written.
|
* after a newline (`\n`) is written.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param logger [Logger] instance to use
|
* @param logger [Logger] instance to use
|
||||||
* @see FileAccess.toStream
|
* @see FileAccess.toStream
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
|
|
|
@ -25,6 +25,7 @@ import de.staropensource.engine.base.implementable.stream.Stream
|
||||||
* A [Stream] which does nothing
|
* A [Stream] which does nothing
|
||||||
* and cannot even be closed.
|
* and cannot even be closed.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class NullStream private constructor() : Stream(streamMode = StreamMode.READ_WRITE) {
|
class NullStream private constructor() : Stream(streamMode = StreamMode.READ_WRITE) {
|
||||||
|
|
|
@ -25,6 +25,7 @@ import de.staropensource.engine.base.implementable.stream.Stream
|
||||||
* A [Stream] which can
|
* A [Stream] which can
|
||||||
* only read strings.
|
* only read strings.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param stringRead string to provide for reading
|
* @param stringRead string to provide for reading
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -25,6 +25,7 @@ import de.staropensource.engine.base.implementable.stream.Stream
|
||||||
* A [Stream] which can
|
* A [Stream] which can
|
||||||
* read and write strings.
|
* read and write strings.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @param stringRead string to provide for reading
|
* @param stringRead string to provide for reading
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -25,6 +25,7 @@ import de.staropensource.engine.base.implementable.stream.Stream
|
||||||
* A [Stream] which can
|
* A [Stream] which can
|
||||||
* only write strings.
|
* only write strings.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
open class StringWriteStream : ByteWriteStream() {
|
open class StringWriteStream : ByteWriteStream() {
|
||||||
|
|
|
@ -30,6 +30,7 @@ import de.staropensource.engine.base.type.logging.ChannelSettings
|
||||||
/**
|
/**
|
||||||
* Handles crashes.
|
* Handles crashes.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class CrashHandler private constructor() {
|
class CrashHandler private constructor() {
|
||||||
|
|
|
@ -25,6 +25,7 @@ import de.staropensource.engine.base.type.logging.Call
|
||||||
/**
|
/**
|
||||||
* Handles call filtering.
|
* Handles call filtering.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class Filterer private constructor() {
|
class Filterer private constructor() {
|
||||||
|
|
|
@ -39,6 +39,7 @@ import kotlinx.datetime.Instant
|
||||||
* with internal classes while leaving the
|
* with internal classes while leaving the
|
||||||
* unimportant bits out.
|
* unimportant bits out.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class Logger {
|
class Logger {
|
||||||
|
|
|
@ -37,6 +37,7 @@ import kotlin.reflect.full.primaryConstructor
|
||||||
* This class will parse, process,
|
* This class will parse, process,
|
||||||
* reformat and finally print log messages.
|
* reformat and finally print log messages.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class Processor private constructor() {
|
class Processor private constructor() {
|
||||||
|
|
|
@ -24,6 +24,7 @@ import de.staropensource.engine.base.EngineConfiguration
|
||||||
/**
|
/**
|
||||||
* Holds data about a method caller.
|
* Holds data about a method caller.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @param packageName fully qualified name of the package where the calling class is in
|
* @param packageName fully qualified name of the package where the calling class is in
|
||||||
* @param className name of the calling class
|
* @param className name of the calling class
|
||||||
* @param methodName name of the calling method
|
* @param methodName name of the calling method
|
||||||
|
|
|
@ -25,6 +25,7 @@ import de.staropensource.engine.base.type.Origin
|
||||||
/**
|
/**
|
||||||
* Holds information about log calls.
|
* Holds information about log calls.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @param origin caller origin
|
* @param origin caller origin
|
||||||
* @param level level
|
* @param level level
|
||||||
* @param message message
|
* @param message message
|
||||||
|
|
|
@ -29,12 +29,13 @@ import de.staropensource.engine.base.implementation.logging.adapter.PrintlnAdapt
|
||||||
* Holds the configuration of one
|
* Holds the configuration of one
|
||||||
* or multiple log channels.
|
* or multiple log channels.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @param enable enables or disables all log messages utilising this channel. Defaults to the global value or `true` if set to `null`
|
* @param enable enables or disables all log messages utilising this channel. Defaults to the global value or `true` if set to `null`
|
||||||
* @param sanitizeMessage if message sanitization (escaping `<`) should be performed. Defaults to the global value or `true` if set to `null`
|
* @param sanitizeMessage if message sanitization (escaping `<`) should be performed. Defaults to the global value or `true` if set to `null`
|
||||||
* @param permitFormatting if formatting shall be permitted for the entire format. For disallowing formatting for the message only, see [sanitizeMessage]. Defaults to the global value or `true` if set to `null`
|
* @param permitFormatting if formatting shall be permitted for the entire format. For disallowing formatting for the message only, see [sanitizeMessage]. Defaults to the global value or `true` if set to `null`
|
||||||
* @param applicationName name of the application. Used in crash reports. Defaults to the global value or `"This application"` if `null`
|
* @param applicationName name of the application. Used in crash reports. Defaults to the global value or `"This application"` if `null`
|
||||||
* @param formatter determines how messages are formatted and stylized. Defaults to the global value or [NoOperationFormatter] if set to `null`
|
* @param formatter determines how messages are formatted and stylized. Defaults to the global value or [NoOperationFormatter] if set to `null`
|
||||||
* @param adapter used for printing the finalized log format somewhere. Defaults to the global value [PrintlnAdapter] if set to `null`
|
* @param adapters used for printing the finalized log format somewhere. Defaults to the global value [PrintlnAdapter] if set to `null`
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
data class ChannelSettings(
|
data class ChannelSettings(
|
||||||
|
|
|
@ -24,9 +24,10 @@ package de.staropensource.engine.base.type.versioning
|
||||||
* [SOSVS](z.staropensource.de/spec-versioning)
|
* [SOSVS](z.staropensource.de/spec-versioning)
|
||||||
* specifications.
|
* specifications.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class VersionType {
|
class VersionType private constructor() {
|
||||||
/**
|
/**
|
||||||
* Represents the version types
|
* Represents the version types
|
||||||
* found in the [second iteration](z.staropensource.de/spec-versioning-v2)
|
* found in the [second iteration](z.staropensource.de/spec-versioning-v2)
|
||||||
|
|
|
@ -27,6 +27,7 @@ import java.util.Locale
|
||||||
/**
|
/**
|
||||||
* Converts between various data size units.
|
* Converts between various data size units.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @param bytes bytes to convert
|
* @param bytes bytes to convert
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -31,6 +31,7 @@ import oshi.hardware.HardwareAbstractionLayer
|
||||||
* Provides information about the
|
* Provides information about the
|
||||||
* environment the application runs in.
|
* environment the application runs in.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
@Suppress("Unused")
|
@Suppress("Unused")
|
||||||
|
@ -456,6 +457,7 @@ class Environment private constructor() {
|
||||||
/**
|
/**
|
||||||
* Represents a graphics card.
|
* Represents a graphics card.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class GraphicsCard internal constructor(val graphicsCard: oshi.hardware.GraphicsCard) {
|
class GraphicsCard internal constructor(val graphicsCard: oshi.hardware.GraphicsCard) {
|
||||||
|
|
|
@ -41,6 +41,7 @@ import java.nio.file.attribute.PosixFilePermissions
|
||||||
* Provides a simplified way of
|
* Provides a simplified way of
|
||||||
* accessing files and directories.
|
* accessing files and directories.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
@Suppress("Unused")
|
@Suppress("Unused")
|
||||||
|
@ -1472,6 +1473,7 @@ class FileAccess {
|
||||||
* {@link FileVisitor} instance for
|
* {@link FileVisitor} instance for
|
||||||
* copying directories recursively.
|
* copying directories recursively.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @param source source to copy from
|
* @param source source to copy from
|
||||||
* @param destination destination to copy to
|
* @param destination destination to copy to
|
||||||
* @since v1-alpha9
|
* @since v1-alpha9
|
||||||
|
@ -1503,6 +1505,7 @@ class FileAccess {
|
||||||
* {@link FileVisitor} instance for
|
* {@link FileVisitor} instance for
|
||||||
* delete directories recursively.
|
* delete directories recursively.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha9
|
* @since v1-alpha9
|
||||||
*/
|
*/
|
||||||
private class DeleteDirectoryVisitor : FileVisitor<Path> {
|
private class DeleteDirectoryVisitor : FileVisitor<Path> {
|
||||||
|
|
|
@ -358,6 +358,7 @@ class Process {
|
||||||
* Used for the [standardInput]
|
* Used for the [standardInput]
|
||||||
* stream of a [Process].
|
* stream of a [Process].
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
private class StandardInputStream(
|
private class StandardInputStream(
|
||||||
|
@ -395,6 +396,7 @@ class Process {
|
||||||
* and [standardError] streams
|
* and [standardError] streams
|
||||||
* of a [Process].
|
* of a [Process].
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this stream
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
private class StandardOutputErrorStream(
|
private class StandardOutputErrorStream(
|
||||||
|
|
|
@ -47,6 +47,7 @@ import java.util.*
|
||||||
* `help what does this do i don't
|
* `help what does this do i don't
|
||||||
* understand :neofox_woozy:` disease.
|
* understand :neofox_woozy:` disease.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @param loadPrefix prefix used for accessing the files
|
* @param loadPrefix prefix used for accessing the files
|
||||||
* @param loadLocation location used for accessing the files. Set to `null` to use the JAR's bundled resources.
|
* @param loadLocation location used for accessing the files. Set to `null` to use the JAR's bundled resources.
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
|
@ -430,6 +431,7 @@ open class BuildInformation
|
||||||
* A [CrashCategory] implementation providing
|
* A [CrashCategory] implementation providing
|
||||||
* details about your running build.
|
* details about your running build.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this crash category
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
abstract class BuildInformationCrashCategory : CrashCategory {
|
abstract class BuildInformationCrashCategory : CrashCategory {
|
||||||
|
|
|
@ -22,6 +22,7 @@ package de.staropensource.engine.base.utility.misc
|
||||||
/**
|
/**
|
||||||
* REALLY miscellaneous methods are in here.
|
* REALLY miscellaneous methods are in here.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class Miscellaneous private constructor() {
|
class Miscellaneous private constructor() {
|
||||||
|
|
|
@ -26,6 +26,7 @@ import java.lang.reflect.InvocationTargetException
|
||||||
* Utility methods for stack trace
|
* Utility methods for stack trace
|
||||||
* and exception analysis.
|
* and exception analysis.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class StackTraceUtils private constructor() {
|
class StackTraceUtils private constructor() {
|
||||||
|
|
|
@ -28,6 +28,7 @@ import de.staropensource.engine.testing.TestBase
|
||||||
* This class sets some nice defaults
|
* This class sets some nice defaults
|
||||||
* and adds other things only useful to us.
|
* and adds other things only useful to us.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @param autoManage automatically initializes and shuts the engine down after each test
|
* @param autoManage automatically initializes and shuts the engine down after each test
|
||||||
* @param logLevels contains the allowed log levels
|
* @param logLevels contains the allowed log levels
|
||||||
* @param shutdownMarksFailure whether engine shutdowns should mark the test as failed
|
* @param shutdownMarksFailure whether engine shutdowns should mark the test as failed
|
||||||
|
|
|
@ -23,6 +23,7 @@ package de.staropensource.engine.newsubprj
|
||||||
/**
|
/**
|
||||||
* An example class.
|
* An example class.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class Example private constructor() {
|
class Example private constructor() {
|
||||||
|
|
|
@ -28,6 +28,7 @@ import de.staropensource.engine.base.type.logging.Level
|
||||||
/**
|
/**
|
||||||
* Testing program for the StarOpenSource Engine.
|
* Testing program for the StarOpenSource Engine.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class Main private constructor() {
|
class Main private constructor() {
|
||||||
|
|
|
@ -37,6 +37,7 @@ import kotlin.jvm.optionals.getOrNull
|
||||||
/**
|
/**
|
||||||
* Base class for implementing tests.
|
* Base class for implementing tests.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this class
|
||||||
* @param autoManage automatically initializes and shuts the engine down after each test
|
* @param autoManage automatically initializes and shuts the engine down after each test
|
||||||
* @param suppressInitAndShutdownLogging if to suppress the engine's log output during engine initialization and shutdown. Only takes effect if [autoManage] is `true`
|
* @param suppressInitAndShutdownLogging if to suppress the engine's log output during engine initialization and shutdown. Only takes effect if [autoManage] is `true`
|
||||||
* @param logLevels contains the allowed log levels
|
* @param logLevels contains the allowed log levels
|
||||||
|
|
|
@ -26,6 +26,7 @@ import kotlin.test.fail
|
||||||
* [ShutdownHandler] implementation which
|
* [ShutdownHandler] implementation which
|
||||||
* causes the test to fail if executed.
|
* causes the test to fail if executed.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this shutdown handler
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class FailureShutdownHandler private constructor() : ShutdownHandler {
|
class FailureShutdownHandler private constructor() : ShutdownHandler {
|
||||||
|
|
|
@ -26,6 +26,7 @@ import kotlin.test.fail
|
||||||
* [ShutdownHandler] implementation which
|
* [ShutdownHandler] implementation which
|
||||||
* causes the test to fail if executed.
|
* causes the test to fail if executed.
|
||||||
*
|
*
|
||||||
|
* @constructor Initializes this shutdown handler
|
||||||
* @since v1-alpha10
|
* @since v1-alpha10
|
||||||
*/
|
*/
|
||||||
class NoOperationShutdownHandler private constructor() : ShutdownHandler {
|
class NoOperationShutdownHandler private constructor() : ShutdownHandler {
|
||||||
|
|
Loading…
Reference in a new issue