{"id":26936530,"url":"https://github.com/sethfalco/converters4deltaspike","last_synced_at":"2025-04-02T12:34:56.731Z","repository":{"id":193763013,"uuid":"285455066","full_name":"SethFalco/converters4deltaSpike","owner":"SethFalco","description":"Provides configuration property converters for the DeltaSpike Configuration mechanism. Adds support for additional objects in the Java standard library, optimized and thoroughly tested for general use. [This is a mirror from GitLab, please interact with the repository there.]","archived":false,"fork":false,"pushed_at":"2020-08-21T07:00:17.000Z","size":131,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-27T12:01:42.875Z","etag":null,"topics":["apache","configuration","converters4deltaspike","deltaspike","java11"],"latest_commit_sha":null,"homepage":"https://gitlab.com/SethFalco/converters4deltaspike","language":"Java","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SethFalco.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":["elypia"],"custom":["https://elypia.org/donate"]}},"created_at":"2020-08-06T02:38:23.000Z","updated_at":"2025-03-27T00:56:42.000Z","dependencies_parsed_at":"2023-09-09T21:38:37.971Z","dependency_job_id":null,"html_url":"https://github.com/SethFalco/converters4deltaSpike","commit_stats":null,"previous_names":["elypia/converters4deltaspike","sethfalco/converters4deltaspike"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SethFalco%2Fconverters4deltaSpike","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SethFalco%2Fconverters4deltaSpike/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SethFalco%2Fconverters4deltaSpike/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SethFalco%2Fconverters4deltaSpike/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SethFalco","download_url":"https://codeload.github.com/SethFalco/converters4deltaSpike/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246816860,"owners_count":20838726,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apache","configuration","converters4deltaspike","deltaspike","java11"],"created_at":"2025-04-02T12:34:56.637Z","updated_at":"2025-04-02T12:34:56.714Z","avatar_url":"https://github.com/SethFalco.png","language":"Java","funding_links":["https://github.com/sponsors/elypia","https://elypia.org/donate"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Converters4DeltaSpike\n[![Matrix]][matrix-community] [![Discord]][discord-guild] [![Maven Central]][maven-page] [![Docs]][documentation] [![Build]][gitlab] [![Coverage]][gitlab] [![Donate]][elypia-donate]\n\u003c/div\u003e\n\n## About\nDeltaSpike supports a limited number types for configuration by default, \nplease see a list of supported types on the official \n[documentation][deltaspike-supported-types]. Converters4DeltaSpike provides \nadditional [`ConfigResolver.Converter`] implementations for various types in \nJava which are optimized and thoroughly tested. This is helpful for applications, \nframeworks, or libraries, with a lot of flexibility in configuration including \nthe ability to use regular expression, dates, or enumerated types.\n\nThis will add converters for the following types and types derived (`extends`) \nfrom them:\n\u003c!-- Listed in alphabetical order. --\u003e\n* [`Character`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Character.html)\n* [`Color`](https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/java/awt/Color.html)\n* [`Dimension`](https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/java/awt/Dimension.html)\n* [`Duration`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/Duration.html)\n* [`Enum`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/Enum.html)\n* [`File`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/io/File.html)\n* [`InetAddress`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/net/InetAddress.html)\n* [`Instant`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/Instant.html)\n* [`Locale`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Locale.html)\n* [`Pattern`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Pattern.html)\n* [`Period`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/Period.html)\n* [`Point`](https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/java/awt/Point.html)\n* [`URI`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/net/URI.html)\n* [`URL`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/net/URL.html)\n* [`UUID`](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/UUID.html)\n\nThe [Gradle]/[Maven] import strings can be found at the maven-central badge above!\n\n## Usage\nThere are no special conditions or usage guidelines for this project; \nyou can just follow the regular documentation provided by the \nApache DeltaSpike project.\n\nPlease see the [documentation][deltaspike-typed-resolver-api] for more information.\n\n### Example\nThe most simple example is to create an interface based configuration and use the\n`@ConfigProperty#converter()` property to specify the desired converter for \nthe type required.\n\n```java\n@Configuration(prefix = \"config.\")\npublic interface MyCustomConfig {\n\n    /** Accepts: / */\n    @ConfigProperty(name = \"seperator\", converter = CharacterConverter.class)\n    Character getSeperator();\n\n    /** Accepts: #FFF */\n    @ConfigProperty(name = \"color\", converter = ColorConverter.class)\n    Color getColor();\n\n    /** Accepts: P2D */ \n    @ConfigProperty(name = \"interval\", converter = DurationConverter.class)\n    Duration getInterval();\n\n    /** Accepts: java.time.DayOfWeek#MONDAY */\n    @ConfigProperty(name = \"day\", converter = EnumConverter.class)\n    DayOfWeek getDay();\n    \n    /** Accepts: en-US */\n    @ConfigProperty(name = \"locale\", converter = LocaleConverter.class)\n    Locale getLocale();\n    \n    /** Accepts: \\\\s+ */\n    @ConfigProperty(name = \"delimiter\", converter = PatternConverter.class)\n    Pattern getDelimiter();\n}\n```\n\n## Open-Source\nThis project is open-source under the [Apache 2.0]!  \nWhile not legal advice, you can find a [TL;DR] that sums up what\nyou're allowed and not allowed to do along with any requirements if you want to \nuse or derive work from this source code!  \n\n[matrix-community]: https://matrix.to/#/+elypia:matrix.org \"Matrix Invite\"\n[discord-guild]: https://discord.com/invite/hprGMaM \"Discord Invite\"\n[maven-page]: https://search.maven.org/search?q=g:org.elypia.converters4deltaspike \"Maven Central\"\n[documentation]: https://elypia.gitlab.io/converters4deltaspike \"Project Documentation\"\n[gitlab]: https://gitlab.com/Elypia/converters4deltaspike/commits/master \"Repository on GitLab\"\n[elypia-donate]: https://elypia.org/donate \"Donate to Elypia\"\n[Gradle]: https://gradle.org/ \"Depend via Gradle\"\n[Maven]: https://maven.apache.org/ \"Depend via Maven\"\n[`ConfigResolver.Converter`]: https://deltaspike.apache.org/javadoc/1.9.3/org/apache/deltaspike/core/api/config/ConfigResolver.Converter.html\n[deltaspike-supported-types]: https://deltaspike.apache.org/documentation/configuration.html#_supported_types\n[deltaspike-typed-resolver-api]: https://deltaspike.apache.org/documentation/configuration.html#TypedResolverAPI\n[Apache 2.0]: https://www.apache.org/licenses/LICENSE-2.0 \"Apache 2.0 License\"\n[TL;DR]: https://tldrlegal.com/license/apache-license-2.0-(apache-2.0) \"TL;DR of Apache 2.0\"\n\n[Matrix]: https://img.shields.io/matrix/elypia:matrix.org?logo=matrix \"Matrix Shield\"\n[Discord]: https://discord.com/api/guilds/184657525990359041/widget.png \"Discord Shield\"\n[Maven Central]: https://img.shields.io/maven-central/v/org.elypia.converters4deltaspike/converters4deltaspike \"Download Shield\"\n[Docs]: https://img.shields.io/badge/docs-converters4deltaspike-blue.svg \"Documentation Shield\"\n[Build]: https://gitlab.com/Elypia/converters4deltaspike/badges/master/pipeline.svg \"GitLab Build Shield\"\n[Coverage]: https://gitlab.com/Elypia/converters4deltaspike/badges/master/coverage.svg \"GitLab Coverage Shield\"\n[Donate]: https://img.shields.io/badge/donate-elypia-blueviolet \"Donate Shield\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsethfalco%2Fconverters4deltaspike","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsethfalco%2Fconverters4deltaspike","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsethfalco%2Fconverters4deltaspike/lists"}