From a0867dd73598a40669a8d12909acfcb4b6fe1533 Mon Sep 17 00:00:00 2001 From: "Artem Zinnatullin :slowpoke" Date: Thu, 1 Jun 2017 12:35:55 +0300 Subject: [PATCH] Add initial implementation. (#1) --- .travis.yml | 11 + CHANGELOG.md | 1 + LICENSE.txt | 201 ++++++++++++++++++ README.md | 69 ++++++ build.gradle | 58 +++++ ci/build.sh | 44 ++++ dependencies.gradle | 19 ++ gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 54212 bytes gradle/wrapper/gradle-wrapper.properties | 6 + gradlew | 172 +++++++++++++++ gradlew.bat | 84 ++++++++ koptional/build.gradle | 117 ++++++++++ .../kotlin/com/gojuno/koptional/Optional.kt | 14 ++ .../com/gojuno/koptional/OptionalSpec.kt | 52 +++++ settings.gradle | 1 + 15 files changed, 849 insertions(+) create mode 100644 .travis.yml create mode 100644 CHANGELOG.md create mode 100644 LICENSE.txt create mode 100644 README.md create mode 100644 build.gradle create mode 100755 ci/build.sh create mode 100644 dependencies.gradle create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100755 gradlew create mode 100644 gradlew.bat create mode 100644 koptional/build.gradle create mode 100644 koptional/src/main/kotlin/com/gojuno/koptional/Optional.kt create mode 100644 koptional/src/test/kotlin/com/gojuno/koptional/OptionalSpec.kt create mode 100644 settings.gradle diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 0000000..8a586d8 --- /dev/null +++ b/.travis.yml @@ -0,0 +1,11 @@ +# We use Docker → we need sudo. +sudo: required + +services: + - docker + +script: + - bash ci/build.sh + +notifications: + email: false diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..40ac123 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1 @@ +# See [Releases](https://github.com/gojuno/koptional/releases) diff --git a/LICENSE.txt b/LICENSE.txt new file mode 100644 index 0000000..d55d83c --- /dev/null +++ b/LICENSE.txt @@ -0,0 +1,201 @@ + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2017 Juno Inc. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/README.md b/README.md new file mode 100644 index 0000000..06454cf --- /dev/null +++ b/README.md @@ -0,0 +1,69 @@ +## Koptional — Minimalistic Optional type for Kotlin + +The goal of this implementation is to be convenient to use and fit Kotlin's null-safe type system, which resulted in: + +* Only two functions (mimics Kotlin std `toInt()`/`toBoolean()`/etc): + - `fun T?.toOptional(): Optional` + - `fun Optional.toNullable(): T?` +* `Some` and `None` are declared as **top level types** — no need to write `Optional.Some` or `Optional.None` + +### Usage + +```kotlin + +// Create Some. +val some = Some(value) + +// Use None. +val none = None // It's object. + +// Convert T? to Optional. +// If something is null — you'll get None, otherwise you'll get Some(something). +val o = something.toOptional() + +// Convert Optional to T?. +// If Optional is None — you'll get null, otherwise you'll get not null T value. +val t = optional.toNullable() + +// Check if Optional is Some or None. +val v = when (optional) { + is Some -> optional.value // Smart Casts Optional to Some and allows you access its value. + is None -> "fallback" +} +``` + +### Download + +Koptional is [available on jcenter](https://jcenter.bintray.com/com/gojuno/koptional). + +```groovy +compile 'com.gojuno.koptional:koptional:put-some-version' +``` + +All the releases and changelogs can be found on [Releases Page](https://github.com/gojuno/koptional/releases). + +### How to build + +Dependencies: you only need `docker` and `bash` installed on your machine. + +```console +bash ci/build.sh +``` + +## License + +``` +Copyright 2017 Juno, Inc. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +``` diff --git a/build.gradle b/build.gradle new file mode 100644 index 0000000..2734601 --- /dev/null +++ b/build.gradle @@ -0,0 +1,58 @@ +apply from: 'dependencies.gradle' + +buildscript { + // Gradle will not find vars defined in an external file when referring to them + // in the buildscript block, unless you link it from the buildscript block, too. + apply from: 'dependencies.gradle' + + repositories { + jcenter() + } + + dependencies { + classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$versions.kotlin" + classpath 'com.github.ben-manes:gradle-versions-plugin:0.13.0' + classpath "org.junit.platform:junit-platform-gradle-plugin:$versions.junitPlatform" + classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.3' + } +} + +allprojects { + repositories { + jcenter() + } + + apply plugin: 'com.github.ben-manes.versions' +} + +def gitTag() { + def tag = 'git tag --list --points-at HEAD'.execute((List) null, rootProject.projectDir).text.trim() + + if (tag.split(System.lineSeparator()).length > 1) { + throw new IllegalStateException("gitTag is accessed but commit has multiple tags: $tag") + } + + return tag +} + +def projectVersion() { + def tag = gitTag() + + if (tag.startsWith('v')) { + return tag.substring(1) + } else if (tag.isEmpty()) { + return "development" + } + + return tag +} + +def validateTagAndVersion() { + if (gitTag().isEmpty()) { + throw new IllegalStateException('Publishing is not allowed because current commit has no tag') + } + + if (projectVersion().isEmpty()) { + throw new IllegalStateException('Publishing is not allowed because current projectVersion is empty') + } +} diff --git a/ci/build.sh b/ci/build.sh new file mode 100755 index 0000000..fd50539 --- /dev/null +++ b/ci/build.sh @@ -0,0 +1,44 @@ +#!/bin/bash +set -e + +# You can run it from any directory. +DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" +PROJECT_DIR="$DIR/.." + +pushd "$PROJECT_DIR" + +# Files created in mounted volume by container should have same owner as host machine user to prevent chmod problems. +USER_ID=`id -u $USER` + +BUILD_COMMAND="set -xe && " +BUILD_COMMAND+="apt-get update && apt-get --assume-yes install git && " + +if [ "$USER_ID" == "0" ]; then + echo "Warning: running as r00t." +else + BUILD_COMMAND+="apt-get --assume-yes install sudo && " + BUILD_COMMAND+="groupadd --gid $USER_ID build_user && " + BUILD_COMMAND+="useradd --shell /bin/bash --uid $USER_ID --gid $USER_ID --create-home build_user && " + BUILD_COMMAND+="sudo --set-home --preserve-env -u build_user " +fi + +BUILD_COMMAND+="/opt/project/gradlew " +BUILD_COMMAND+="--no-daemon --info --stacktrace " +BUILD_COMMAND+="clean build " + +if [ "$PUBLISH" == "true" ]; then + BUILD_COMMAND+="bintrayUpload " +fi + +BUILD_COMMAND+="--project-dir /opt/project" + +docker run \ +--env BINTRAY_USER="$BINTRAY_USER" \ +--env BINTRAY_API_KEY="$BINTRAY_API_KEY" \ +--env BINTRAY_GPG_PASSPHRASE="$BINTRAY_GPG_PASSPHRASE" \ +--volume `"pwd"`:/opt/project \ +--rm \ +openjdk:8u121-jdk \ +bash -c "$BUILD_COMMAND" + +popd diff --git a/dependencies.gradle b/dependencies.gradle new file mode 100644 index 0000000..7fa0511 --- /dev/null +++ b/dependencies.gradle @@ -0,0 +1,19 @@ +ext.versions = [ + kotlin : '1.1.1', + + junit : '4.12', + junitPlatform : '1.0.0-M4', + spek : '1.1.2', + assertJ : '3.5.2', +] + +ext.libraries = [ + kotlinStd : "org.jetbrains.kotlin:kotlin-stdlib:$versions.kotlin", + kotlinRuntime : "org.jetbrains.kotlin:kotlin-runtime:$versions.kotlin", + kotlinReflect : "org.jetbrains.kotlin:kotlin-reflect:$versions.kotlin", + + junit : "junit:junit:$versions.junit", + spek : "org.jetbrains.spek:spek-api:$versions.spek", + spekJunitPlatformEngine: "org.jetbrains.spek:spek-junit-platform-engine:$versions.spek", + assertJ : "org.assertj:assertj-core:$versions.assertJ", +] diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..2b265cc4299f90d06e50a6eb184fe50ef83a1fc6 GIT binary patch literal 54212 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 \(.*\)$'` + if expr "$link" : '/.*' > /dev/null; then + PRG="$link" + else + PRG=`dirname "$PRG"`"/$link" + fi +done +SAVED="`pwd`" +cd "`dirname \"$PRG\"`/" >/dev/null +APP_HOME="`pwd -P`" +cd "$SAVED" >/dev/null + +APP_NAME="Gradle" +APP_BASE_NAME=`basename "$0"` + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS="" + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD="maximum" + +warn ( ) { + echo "$*" +} + +die ( ) { + echo + echo "$*" + echo + exit 1 +} + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "`uname`" in + CYGWIN* ) + cygwin=true + ;; + Darwin* ) + darwin=true + ;; + MINGW* ) + msys=true + ;; + NONSTOP* ) + nonstop=true + ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD="$JAVA_HOME/jre/sh/java" + else + JAVACMD="$JAVA_HOME/bin/java" + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD="java" + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then + MAX_FD_LIMIT=`ulimit -H -n` + if [ $? -eq 0 ] ; then + if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then + MAX_FD="$MAX_FD_LIMIT" + fi + ulimit -n $MAX_FD + if [ $? -ne 0 ] ; then + warn "Could not set maximum file descriptor limit: $MAX_FD" + fi + else + warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT" + fi +fi + +# For Darwin, add options to specify how the application appears in the dock +if $darwin; then + GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\"" +fi + +# For Cygwin, switch paths to Windows format before running java +if $cygwin ; then + APP_HOME=`cygpath --path --mixed "$APP_HOME"` + CLASSPATH=`cygpath --path --mixed "$CLASSPATH"` + JAVACMD=`cygpath --unix "$JAVACMD"` + + # We build the pattern for arguments to be converted via cygpath + ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null` + SEP="" + for dir in $ROOTDIRSRAW ; do + ROOTDIRS="$ROOTDIRS$SEP$dir" + SEP="|" + done + OURCYGPATTERN="(^($ROOTDIRS))" + # Add a user-defined pattern to the cygpath arguments + if [ "$GRADLE_CYGPATTERN" != "" ] ; then + OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)" + fi + # Now convert the arguments - kludge to limit ourselves to /bin/sh + i=0 + for arg in "$@" ; do + CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -` + CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option + + if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition + eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"` + else + eval `echo args$i`="\"$arg\"" + fi + i=$((i+1)) + done + case $i in + (0) set -- ;; + (1) set -- "$args0" ;; + (2) set -- "$args0" "$args1" ;; + (3) set -- "$args0" "$args1" "$args2" ;; + (4) set -- "$args0" "$args1" "$args2" "$args3" ;; + (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;; + (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;; + (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;; + (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;; + (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;; + esac +fi + +# Escape application args +save ( ) { + for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done + echo " " +} +APP_ARGS=$(save "$@") + +# Collect all arguments for the java command, following the shell quoting and substitution rules +eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS" + +# by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong +if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then + cd "$(dirname "$0")" +fi + +exec "$JAVACMD" "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..e95643d --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,84 @@ +@if "%DEBUG%" == "" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%" == "" set DIRNAME=. +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS= + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if "%ERRORLEVEL%" == "0" goto init + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto init + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:init +@rem Get command-line arguments, handling Windows variants + +if not "%OS%" == "Windows_NT" goto win9xME_args + +:win9xME_args +@rem Slurp the command line arguments. +set CMD_LINE_ARGS= +set _SKIP=2 + +:win9xME_args_slurp +if "x%~1" == "x" goto execute + +set CMD_LINE_ARGS=%* + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS% + +:end +@rem End local scope for the variables with windows NT shell +if "%ERRORLEVEL%"=="0" goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 +exit /b 1 + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/koptional/build.gradle b/koptional/build.gradle new file mode 100644 index 0000000..7127ac3 --- /dev/null +++ b/koptional/build.gradle @@ -0,0 +1,117 @@ +apply plugin: 'kotlin' +apply plugin: 'org.junit.platform.gradle.plugin' +apply plugin: 'maven' +apply plugin: 'maven-publish' +apply plugin: 'com.jfrog.bintray' + +dependencies { + compile libraries.kotlinStd +} + +dependencies { + testCompile libraries.spek + testCompile libraries.spekJunitPlatformEngine + testCompile libraries.assertJ +} + +jar { + // Build jar with dependencies. + from(configurations.compile.collect { it.isDirectory() ? it : zipTree(it) }) { + exclude 'META-INF/*.SF' + exclude 'META-INF/*.DSA' + exclude 'META-INF/*.RSA' + } +} + +junitPlatform { + platformVersion = versions.junitPlatform + + filters { + engines { + include 'spek' + } + } +} + +task sourcesJar(type: Jar, dependsOn: classes) { + classifier = 'sources' + from sourceSets.main.allSource +} + +task javadocJar(type: Jar, dependsOn: javadoc) { + classifier = 'javadoc' + from javadoc.destinationDir +} + +task validatePublishing { + doLast { + validateTagAndVersion() + } +} + +bintrayUpload.dependsOn validatePublishing + +def pomConfig = { + licenses { + license { + name 'The Apache Software License, Version 2.0' + url 'http://www.apache.org/licenses/LICENSE-2.0.txt' + distribution 'repo' + } + } + developers { + developer { + id 'gojuno' + name 'Juno Inc.' + email 'opensource@gojuno.com' + } + } +} + +publishing { + publications { + KoptionalPublication(MavenPublication) { + from components.java + + artifact sourcesJar + artifact javadocJar + + groupId 'com.gojuno.koptional' + artifactId 'koptional' + version projectVersion() + + pom.withXml { + def root = asNode() + root.appendNode('description', 'Minimalistic Optional type for Kotlin that tries to fit its null-safe type system as smooth as possible.') + root.appendNode('name', 'Koptional') + root.appendNode('url', 'https://github.com/gojuno/koptional') + root.children().last() + pomConfig + } + } + } +} + +bintray { + user = System.getenv('BINTRAY_USER') + key = System.getenv('BINTRAY_API_KEY') + publish = true + + pkg { + repo = 'maven' + name = 'koptional' + licenses = ['Apache-2.0'] + vcsUrl = 'https://github.com/gojuno/koptional.git' + issueTrackerUrl = 'https://github.com/gojuno/koptional/issues' + publications = ['KoptionalPublication'] + + version { + name = projectVersion() + vcsTag = gitTag() + + gpg { + sign = true + passphrase = System.getenv('BINTRAY_GPG_PASSPHRASE') + } + } + } +} diff --git a/koptional/src/main/kotlin/com/gojuno/koptional/Optional.kt b/koptional/src/main/kotlin/com/gojuno/koptional/Optional.kt new file mode 100644 index 0000000..08b59af --- /dev/null +++ b/koptional/src/main/kotlin/com/gojuno/koptional/Optional.kt @@ -0,0 +1,14 @@ +package com.gojuno.koptional + +sealed class Optional { + + fun toNullable(): T? = when (this) { + is Some -> value + is None -> null + } +} + +data class Some(val value: T) : Optional() +object None : Optional() + +fun T?.toOptional(): Optional = if (this == null) None else Some(this) diff --git a/koptional/src/test/kotlin/com/gojuno/koptional/OptionalSpec.kt b/koptional/src/test/kotlin/com/gojuno/koptional/OptionalSpec.kt new file mode 100644 index 0000000..1ea27e7 --- /dev/null +++ b/koptional/src/test/kotlin/com/gojuno/koptional/OptionalSpec.kt @@ -0,0 +1,52 @@ +package com.gojuno.koptional + +import org.assertj.core.api.Assertions.assertThat +import org.jetbrains.spek.api.Spek +import org.jetbrains.spek.api.dsl.context +import org.jetbrains.spek.api.dsl.describe +import org.jetbrains.spek.api.dsl.it + +class OptionalSpec : Spek({ + + describe("toNullable") { + + context("Some.toNullable") { + + val result = Some("string").toNullable() + + it("converts it to value") { + assertThat(result).isEqualTo("string") + } + } + + context("None.toNullable") { + + val result = None.toNullable() + + it("converts it to null") { + assertThat(result as Any?).isNull() + } + } + } + + describe("toOptional") { + + context("NonNull.toOptional") { + + val result = "string".toOptional() + + it("converts it to Some") { + assertThat(result).isEqualTo(Some("string")) + } + } + + context("null.toOptional") { + + val result = null.toOptional() + + it("converts it to None") { + assertThat(result).isEqualTo(None) + } + } + } +}) diff --git a/settings.gradle b/settings.gradle new file mode 100644 index 0000000..ca1db9b --- /dev/null +++ b/settings.gradle @@ -0,0 +1 @@ +include ':koptional'