Description
Run shell commands from a Kotlin script or application with ease.
Turtle simplifies the process of running external commands and processes from your Kotlin (or Java) code. It comes bundled with a selection of built-in functions, such as opening MacOS applications and dealing with Git. Running shell commands easily is particularly useful from within Kotlin scripts, command line applications and Gradle tasks.
ย
Features โข Installation โข Usage
Turtle ๐ข alternatives and similar packages
Based on the "Kotlin" category.
Alternatively, view Turtle ๐ข alternatives based on common mentions on social networks and blogs.
-
android-youtube-player
YouTube Player library for Android and Chromecast, stable and customizable. -
DrawableToolbox
๐ ๏ธ The missing DrawableToolbox for Android. Get rid of the boring and always repeated drawable.xml files. -
kotlin-android-template
Android + Kotlin + Github Actions + ktlint + Detekt + Gradle Kotlin DSL + buildSrc = โค๏ธ -
Navigation Toolbar for Android
Navigation toolbar is a slide-modeled UI navigation controller made by @Ramotion -
KAndroid
Lightweight library providing useful extensions to eliminate boilerplate code in Android SDK. -
NotyKT ๐๏ธ
๐ NotyKT is a complete Kotlin-stack (Backend + Android) application ๐ฑ built to demonstrate the use of Modern development tools with best practices implementation. -
MaterialTimelineView
With MaterialTimelineView you can easily create a material looking timeline. -
CrunchyCalendar โ awesome calendar widget for android apps
A beautiful material calendar with endless scroll, range selection and a lot more! -
Android Kotlin Samples
Some basic Android code samples writen in Kotlin. -
Swagger Gradle Codegen
๐ซ A Gradle plugin to generate networking code from a Swagger spec file. -
Awesome Jetpack compose
A collaborative list of awesome jetpack compose resources. -
CameraViewEx
CameraViewEx makes integration of camera implementation and various camera features into any Android project very easy. -
Events Calendar
A user-friendly library that helps you achieve a cool Calendar UI with events mapping. -
Pdf Viewer For Android
A Lightweight PDF Viewer Android library which only occupies around 125kb while most of the Pdf viewer occupies up to 16MB space. -
Aimybox voice assistant
Embeddable voice assistant for Android apps written in Kotlin -
Vanilla Place Picker
Simple(vanilla) yet 'Do it all' place picker for your place picking needs in Android -
Maildroid
๐ Maildroid is a small robust android library for sending emails using SMTP server ๐ -
SSCustomEditTextOutLineBorder
Same as an Outlined text fields presented in Material Design page but with some dynamic changes -
ParallaxScrollingView
Parallax scrolling either by offset or automatically. -
SSCustomBottomNavigation
Animated tabbar with native control -
Kotlin-AgendaCalendarView
CalendarView widget (Outlook) -
Kotlin Example
An example for who are all going to start learning Kotlin programming language to develop Android application. -
Google Places AutoComplete EditText
A simple library that can connect your autocomplete edittext to Google places api -
MVVM-To-Do-App
Android To-Do MVVM Architecture App written in Kotlin.(ViewModel, ROOM, Livedata, Coroutines) -
User Consent SDK for Android
Configurable User Consent SDK For Androir -
EasyPermissions-ktx
๐ Kotlin version of the popular google/easypermissions wrapper library to simplify basic system permissions logic on Android M or higher. -
Viola
With Viola android face detection library, you can detect faces in a bitmap, crop faces using predefined algorithm and get additional information from the detected faces. -
Clean-MVVM-NewsApp
Android News app developed using Clean + MVVM architecture -
fusion
An Easy-to-use Kotlin based Customizable Modules Collection with Material Layouts by BlackBeared.
Get performance insights in less than 4 minutes
Do you think we are missing an alternative of Turtle ๐ข or a related project?
README
Run shell commands from a Kotlin script or application with ease.
Turtle simplifies the process of running external commands and processes from your Kotlin (or Java) code. It comes bundled with a selection of built-in functions, such as opening MacOS applications and dealing with Git. Running shell commands easily is particularly useful from within Kotlin scripts, command line applications and Gradle tasks.
Features โข Install โข Usage โข Contributing
Features
โถ๏ธ Run shell commands with minimal boilerplate
Simply specify the comamnd and its arguments to easily run and retrieve output.
โถ๏ธ Call any of the built-in shell commands
Various commands are provided, such as creating a Git commit and opening files.
โถ๏ธ Use the function syntax to run a series of commands
Specify a sequence of commands to run within a function block.
โถ๏ธ Capture error exit code and output
When a command produces an error, the exit code and error output is thrown as an exception.
Install
Turtle is provided as a Gradle/Maven dependency, which will be available via Bintray and Maven Central soon.
โถ๏ธ Gradle Kotlin DSL
dependencies {
implementation("com.lordcodes.turtle:turtle:0.2.0")
}
โถ๏ธ Gradle Groovy DSL
dependencies {
implementation 'com.lordcodes.turtle:turtle:0.2.0'
}
Usage
To run a single custom command, just call shellRun()
and provide the command and arguments.
val output = shellRun("git", listOf("rev-parse", "--abbrev-ref", "HEAD"))
println(output) // Current branch name, e.g. master
The working directory can be provided, to run the command in a particular location. ShellLocation
provides easy access to some useful locations, such as the user's home directory.
val turtleProject = ShellLocation.HOME.resolve("projects/turtle")
val output = shellRun("git", listOf("rev-parse", "--abbrev-ref", "HEAD"), turtleProject)
println(output) // Current branch name, e.g. master
To run a series of commands or use the built-in commands, just call shellRun {}
.
shellRun {
command("mkdir tortoise")
changeWorkingDirectory("tortoise")
git.commit("Initial commit")
git.addTag("v1.2", "Release v1.2")
files.openApplication("Spotify")
}
The initial working directory can be specified.
val turtleProject = ShellLocation.HOME.resolve("projects/turtle")
shellRun(turtleProject) {
โฆ
}
Built-in commands
โถ๏ธ Git
shellRun {
git.init()
git.status()
git.commit("Commit message")
git.commitAllChanges("Commit message")
git.push("origin", "master")
git.pull()
git.checkout("release")
git.clone("https://github.com/lordcodes/turtle.git")
git.addTag("v1.1", "Release v1.1")
git.pushTag("v1.1")
git.currentBranch()
}
โถ๏ธ Files
shellRun {
files.openFile("script.kts")
files.openApplication("Mail")
files.createSymlink("target", "link")
files.readSymlink("link")
}
โถ๏ธ More
Extra commands can easily be added by either calling command
or by extending ShellScript
. If you have created a command that you think should be built in, please feel free to open a PR.
Contributing or Help
If you notice any bugs or have a new feature to suggest, please check out the contributing guide. If you want to make changes, please make sure to discuss anything big before putting in the effort of creating the PR.
To reach out, please contact @lordcodes on Twitter.