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. -
CalendarView
A highly customizable calendar library for Android, powered by RecyclerView. -
Balloon
:balloon: Modernized and sophisticated tooltips, fully customizable with an arrow and animations for Android. -
Kotterknife
Android view injection writen in Kotlin based on ButterKnife -
Shortbread
Android library that creates app shortcuts from annotations -
kotlin-android-template
Android + Kotlin + Github Actions + ktlint + Detekt + Gradle Kotlin DSL + buildSrc = β€οΈ -
NotyKT ποΈ
π NotyKT is a complete πKotlin-stack (Backend + Android) π± application built to demonstrate the use of Modern development tools with best practices implementationπ¦Έ. -
DrawableToolbox
π οΈ The missing drawable toolbox for Android. Create drawables programmatically and get rid of the boring and always repeated drawable.xml files. -
Navigation Toolbar for Android
:octocat: Navigation toolbar is a slide-modeled UI navigation controller made by @Ramotion -
CodeView
Display code with syntax highlighting :sparkles: in native way. -
MaterialTimelineView
With MaterialTimelineView you can easily create a material looking timeline. -
MaterialDrawerKt
A Kotlin DSL wrapper around the mikepenz/MaterialDrawer library. -
sliding-panel
Android sliding panel that is part of the view hierarchy, not above it. -
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 samples of Kotlin for Android -
Carousel Recyclerview
Carousel Recyclerview let's you create carousel layout with the power of recyclerview by creating custom layout manager. -
Transition X
{ } Declarative Kotlin DSL for choreographing Android transitions -
Only
:bouquet: An easy way to persist and run code block only as many times as necessary on Android. -
Pluto Debug Framework
Pluto is a on-device debugging framework for Android applications, which helps in inspection of HTTP requests/responses, capture Crashes and ANRs and manipulating application data on-the-go. -
Swagger Gradle Codegen
π« A Gradle Plugin to generate your networking code from Swagger -
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. -
SSCustomBottomNavigation
Animated TabBar with native control and Jetpack Navigation support..β¨ππ -
Capturable
πJetpack Compose utility library for capturing Composable content and transforming it into Bitmap ImageπΌοΈ -
Awesome Jetpack compose
A collaborative list of awesome jetpack compose resources. -
DeviceInfo-Sample
[Android Library] Get easy access to device information super fast, real quick -
CameraViewEx
Easy Android camera integration, advanced features. -
EasyPermissions-ktx
π Kotlin version of the popular google/easypermissions wrapper library to simplify basic system permissions logic on Android M or higher. -
Aimybox voice assistant
Embeddable custom voice assistant for Android applications -
Events Calendar
Events Calendar is a user-friendly library that helps you achieve a cool Calendar UI with events mapping. You can customise every pixel of the calendar as per your wish and still achieve in implementing all the functionalities of the native android calendar in addition with adding dots to the calendar which represents the presence of an event on the respective dates. It can be done easily, you are just a few steps away from implementing your own badass looking Calendar for your very own project! -
ZoomHelper
ZoomHelper will make any view to be zoomable just like Instagram pinch-to-zoom -
SSCustomEditTextOutLineBorder
Same as the Outlined text fields presented on the Material Design page but with some dynamic changes. π π -
Maildroid
Maildroid is a small robust android library for sending emails using SMTP server -
Vanilla Place Picker
Simple(vanilla) yet 'Do it all' place picker for your place picking needs in Android -
TimelineView
A customizable and easy-to-use Timeline View library for Android. Works as a RecyclerView decorator (ItemDecoration) -
Nextflix-Composable
Includes jetpack compose, navigation, paging, hilt, retrofit, coil, coroutines, flow.. -
RecyclerView Presenter
RecyclerView Adapter Library with different models and different layouts as convenient as possible. -
Intro Showcase View
Highlight different features of the app using Jetpack Compose -
PopKorn
DI can be simple. Forget about modules and components. Just use it! -
Google Places AutoComplete EditText
A simple library that can connect your autocomplete edittext to Google places api -
Kotlin-AgendaCalendarView
Android calendar library provides easy to use widget with events -
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. -
CollapsingAvatarToolbarSample
An example of animation collapsing toolbar in android -
MVVM-To-Do-App
Android To-Do MVVM Architecture App written in Kotlin.(ViewModel, ROOM, Livedata, Coroutines)
Appwrite - The Open Source Firebase alternative introduces iOS support
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.
- v0.5.0 onwards are available via Maven Central.
- v0.3.0 and v0.4.0 had issues, so please use v0.5.0 or later.
- Earlier releases were available via Bintray/JCenter.
βΆοΈ Gradle Kotlin DSL
dependencies {
implementation("com.lordcodes.turtle:turtle:0.6.0")
}
βΆοΈ Gradle Groovy DSL
dependencies {
implementation 'com.lordcodes.turtle:turtle:0.6.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.