AmniXTension [DEPRECATED]
No Longer maintained. There are tons of ktx libraries prvided by google itself now which are more preferable over this. A Kotlin extensions + Utils library with Bunch of Help inbuild.
Documentation | FileTree | FAQ's | RoadMap | Demo | Suggestion | Bugs
AmniXTension = AmniX's Tension Which Means No Tension to Developers, AmniXTension is Here.
AmniXTension is On Jcenter, Simply implementat the library and simplify Your Life
dependencies {
implementation 'com.amnix.xtension:AmniXtension:x.x.x'
}
Demo
Wanna See Some Demo? Few are mention, Many to explore.
Things Are Collapsed. You need to Expand them ;)
Extensions:-
Global Extensions
Global Extensions Means You can Use them Anywhere
async{
// Some Code Which Will Run in a Worker Thread
// Caution : Make sure you don't do some context related stuff in async, It may cause an memory leak
}
asyncAwait({
// Some Code Which Will Run in a Worker Thread
// Caution : Make sure you don't do some context related stuff in async, It may cause an memory leak
result // Keep the Result in Last Line, You Will Receive it in Await Block Magically.
},{result->
// Some Code Will be Executed After Async Block
// You Will Receive Result Passed From Async Block Last line
})
OR
asyncAwait<Bitmap>({bitmap->
// Some Code Which Will Run in a Worker Thread
// Caution : Make sure you don't do some context related stuff in async, It may cause an memory leak
result // Keep the Result in Last Line, You Will Receive it in Await Block Magically.
},{result->
// Some Code Will be Executed After Async Block
// You Will Receive Result Passed From Async Block Last line
})
tryOrIgnore{
// Code Here Which Can be throw Exception but App Won't Crash At All
}
object.castTo(Object::class) // Cast Object inline and Supports Code Chaining.
OR
object.castAs(Object::class) // Cast Object inline and Supports Code Chaining.
tryAndCatch({
// Try Code
},{
// catch Exception
},{
// Optional Finally Block
})
if(guardRun{
//Run Code in Guarded Way
}){
//Code There If Above Code Executed Without Any Exception
}
object.ifIs(otherObject){
// Run Code if above Object is equal to other Object.
It does Simply Replace below code
if(object == otherObject){
//Your Code
}
}
object.ifIsNot(otherObject){
// Run Code if above Object is equal to other Object.
It does Simply Replace below code
if(object != otherObject){
//Your Code
}
}
closeSafely(inputStream, outputStream) // Clode Streams Safely and prevent any memory leak
if(isDeviceRooted()){
// Alert User that Few Features are disable Because You have Rooted Device
}
val date = currentDate()
runOnUiThread{
// Run Your Code On UI thread Without the Activity Object
}
putInMemory("key",value) // Put Anything In Memory For Later Use
val value = getFromMemory("key") // Get Your Saved Value from Memory
BoilerPlate Extensions
surfaceView.setupCamera{
it.startPreview()
}
textureView.setupCamera{
it.startPreview()
}
Activity Extensions
requestPermission(Manifest.permission.CAMERA){
//No need to check if the Permission Grated Already Or Not, We Will do it for you. Just Place the code in [onResult] Block, We will Execute it SomeHow.
if(it){
// Yay, We have Permission to start the Camera
}else{
// Alas, We Don't have Permission to Start The Camera, Ask User to disable the feature
}
}
getStatusBarHeight()
getNavigationBarSize()
showSnackBar() // Show SnackBar WithOut Design Support Library. Its look better then Actual Snackbar ;)
setStatusBarColor()
setNavigationBarColor()
setNavigationBarDividerColor()
onViewInflated{
// Code On View Inflated
// Mimics the ViewTreeObserver/globalLayoutListener
}
getRootView()
Bitmap Extensions
Bitmap.save("/path/..../image.jpg")
Bitmap.saveAsync("/path/..../image.jpg")
val pixel = bitmap[x,y]
bitmap[x,y] = Color.WHITE
val base64 = bitmap.toBase64()
val resized = bitmap.resize(20,40)
val rotated = bitmap.rotateTo(90)
val round = bitmap.toRound()
val roundCorner = bitmap.toRoundCorner()
val grey = bitmap.toGrayScale()
val byteArray = bitmap.toByteArray
val compressed = bitmap.compressBySampleSize(400,500)
val compressedQuality = bitmap.compressByQuality(80)
Context Extensions
val screenWidth = context.screenWidth
val screenHeight = context.screenHeight
context.showNotification("Hello Notification",...,...,... other params) //Handles Everything For You
context.showToast()
context.showToastHard()
context.showConfirmationDialog()
context.showSinglePicker()
context.showMultiPicker()
context.showDatePicker()
context.showTimePicker()
context.isGPSEnable()
context.isNetworkAvailable()
context.isAppInstalled()
context.isIntentResolvable()
context.checkSelfPermissions()
context.getAndroidID()
context.getDeviceID()
context.getIMEI()
context.requestMediaScanner()
context.vibrate()
context.startApp()
context.startActivity()
context.startService()
context.startApp()
context.getAllImages()
context.getAllVideos()
context.getAllAudios()
context.getAppName() // Current or Given Package
context.getAppIcon() // Current or Given Package
context.getAppSize() // Current or Given Package
context.getAppApk() // Current or Given Package
context.getAppVersionName() // Current or Given Package
context.getAppVersionCode() // Current or Given Package
context.isServiceRunning() //Check If Service is Running Or Not
context.getActivityManager()
context.getAlarmManager()
context.getAudioManager()
context.getClipboardManager()
context.getConnectivityManager()
context.getKeyguardManager()
context.getLocationManager()
context.getNotificationManager()
context.getPowerManager()
context.getSearchManager()
context.getSensorManager()
context.getTelephonyManager()
context.getVibrator()
context.getWifiManager()
context.getWindowManager()
context.getInputMethodManager()
context.getKeyguardManager()
context.getLayoutInflater()
.....And All The...........
......System Service.......
........Are Avaibale.......
File Extensions
val file = File("/a/file/from/anywhere")
val string = file.readToString()
val inputStream = file.open()
val byteArray = file.toByteArray()
file.copy(File("copy to"))
file.move(File("copy to"))
file.deleteAll()
if(file.isImage()){
//do the Stuff Like Decoding File to image
}
Number Extensions
pxFromSp()
spFromPx()
pxFromDp()
dpFromPx()
40.loop{
// Loop Till 0 to 40
}
1.toBoolean()
SeekBar Extensions
seekBar.setOnSeekBarChangeListener(
onProgressChanged={seek,progress,fromUser->
})
String Extensions
encodeToBase64()
decodeToBase64()
toCamelCase()
toTitleCase()
encryptAES("mySecretKey")
decryptAES("mySecretKey")
encodeToBinary()
deCodeToBinary()
View Extensions
val bitmap = view.screenshot()
view.setOnSingleClickListener{
//Prevent Multiple tap from Geeky Users
}
view.fadeIn() // Fade the View In
view.fadeOut() // Fade the View Out
view.showKeyBoard()
view.hideKeyBoard()
setPaddingLeft(40)
setPaddingRight(40)
top
bottom
start
end
Horizontal
setPaddingVertical(40)
setHeight()
setWidth()
isVisible()
isGone()
isInvisible()
getActivity()
Extras :-
Code benchMarking
Want to Know How Much Does You Code takes to Execute?
Let me show you how you can do the same Easily.
val bench = BenchMarkUtils()
Your Code Goes Here
And Maybe Here Too
And Might Be Here Too...
val time = bench.dump() // Dumps The Time to Logcat and Returns The Same Too
//Now Check the Logcat With Tha Class name Tag and You will see the Results
Color Progress bar
A ProgressBar But Supported Color Change from xml Only.
<com.amnix.xtension.widgets.ColorProgressBar
android:layout_width="wrap_content"
android:layout_height="wrap_content"
app:color="#FF0000"/>
<!--RED Progress Bar-->
Shadow View
A View to Apply Linear Shadow to any View, Its Like and Gradient Replacement From the xml itself
<com.amnix.xtension.widgets.ShadowView
android:layout_width="match_parent"
android:layout_height="8dp"
app:angle="bottomToTop"
app:endColor="#00000000"
app:startColor="#FF0000" />
<!--Linear Shadow From Bottom to Top -->
Touch ImageView
An ImageView With Inbuild Support of ImageView Ping and Double Tap to Zoom
<com.amnix.xtension.widgets.TouchImageView
android:layout_width="match_parent"
android:layout_height="wrap_content"/>
<!--Touch ImageView -->
Circular ImageView
```xml
</p>
</details>
<details><summary>InMemoryCache</summary>
<p>
Keep AnyThing In Memory and Access From Anywhere Easily
```kotlin
val myData = "HelloData"
InMemoryCache.put("data",myData)
val data = InMemoryCache.get("data")
InMemoryCache.clear()
More Methods To Explore.
Pretty Logging
Logging is Simple Now, Auto TAGS, Will Embed The Tag From Its Invoked Class Name Automatically.
AmniXtension.isLoggingEnabled = true // Sets The Logging Enable Or Disable
L.d(listOf("One", "Two", "Three"))
L.d(mapOf(1 to "One", 2 to "Two", 3 to "Three"))
L.d(arrayOf("One", "Two", "Three"))
L.d(setOf("One", "Two", "Three"))
L.d(UUID.randomUUID().toString().append(UUID.randomUUID().toString()))
L.e(UUID.randomUUID().toString())
L.d("A Long String Is Here to Print to Log And Can Be Printed Easily")
L.json("{ \"glossary\": { \"title\": \"example glossary\", \"GlossDiv\": { \"title\": \"S\", \"GlossList\": { \"GlossEntry\": { \"ID\": \"SGML\", \"SortAs\": \"SGML\", \"GlossTerm\": \"Standard Generalized Markup Language\", \"Acronym\": \"SGML\", \"Abbrev\": \"ISO 8879:1986\", \"GlossDef\": { \"para\": \"A meta-markup language, used to create markup languages such as DocBook.\", \"GlossSeeAlso\": [\"GML\", \"XML\"] }, \"GlossSee\": \"markup\" } } } } }")
Above Lines Will Print the Logs Like Below-
2019-03-07 12:34:02.171 8162-8162/? D/AmniXLogs:
┌────────────────────────────────────────────────────────────────────────────────────────
│ Thread: main, Source: com.amnix.xtension.MainActivity.onCreate (MainActivity.kt:17)
├────────────────────────────────────────────────────────────────────────────────────────
│ [One, Two, Three]
└────────────────────────────────────────────────────────────────────────────────────────
2019-03-07 12:34:02.178 8162-8162/? D/AmniXLogs:
┌────────────────────────────────────────────────────────────────────────────────────────
│ Thread: main, Source: com.amnix.xtension.MainActivity.onCreate (MainActivity.kt:18)
├────────────────────────────────────────────────────────────────────────────────────────
│ {1=One, 2=Two, 3=Three}
└────────────────────────────────────────────────────────────────────────────────────────
2019-03-07 12:34:02.179 8162-8162/? D/AmniXLogs:
┌────────────────────────────────────────────────────────────────────────────────────────
│ Thread: main, Source: com.amnix.xtension.MainActivity.onCreate (MainActivity.kt:19)
├────────────────────────────────────────────────────────────────────────────────────────
│ [One, Two, Three]
└────────────────────────────────────────────────────────────────────────────────────────
2019-03-07 12:34:02.270 8162-8162/? D/AmniXLogs:
┌────────────────────────────────────────────────────────────────────────────────────────
│ Thread: main, Source: com.amnix.xtension.MainActivity.onCreate (MainActivity.kt:20)
├────────────────────────────────────────────────────────────────────────────────────────
│ [One, Two, Three]
└────────────────────────────────────────────────────────────────────────────────────────
2019-03-07 12:34:02.277 8162-8162/? D/AmniXLogs:
┌────────────────────────────────────────────────────────────────────────────────────────
│ Thread: main, Source: com.amnix.xtension.MainActivity.onCreate (MainActivity.kt:21)
├────────────────────────────────────────────────────────────────────────────────────────
│ 333bd5d4-ae3c-488f-afb8-bddfb4e6661cecd401a7-835c-45bb-9827-a6fa5bd4d723
└────────────────────────────────────────────────────────────────────────────────────────
2019-03-07 12:34:02.278 8162-8162/? E/AmniXLogs:
┌────────────────────────────────────────────────────────────────────────────────────────
│ Thread: main, Source: com.amnix.xtension.MainActivity.onCreate (MainActivity.kt:22)
├────────────────────────────────────────────────────────────────────────────────────────
│ 19449369-e192-44aa-8460-a7d3d8776fff
└────────────────────────────────────────────────────────────────────────────────────────
2019-03-07 12:34:02.279 8162-8162/? D/AmniXLogs:
┌────────────────────────────────────────────────────────────────────────────────────────
│ Thread: main, Source: com.amnix.xtension.MainActivity.onCreate (MainActivity.kt:23)
├────────────────────────────────────────────────────────────────────────────────────────
│ A Long String Is Here to Print to Log And Can Be Printed Easily
└────────────────────────────────────────────────────────────────────────────────────────
2019-03-07 12:34:02.291 8162-8162/? D/AmniXLogs:
┌────────────────────────────────────────────────────────────────────────────────────────
│ Thread: main, Source: com.amnix.xtension.MainActivity.onCreate (MainActivity.kt:24)
├────────────────────────────────────────────────────────────────────────────────────────
│ {
│ "glossary": {
│ "title": "example glossary",
│ "GlossDiv": {
│ "title": "S",
│ "GlossList": {
│ "GlossEntry": {
│ "ID": "SGML",
│ "SortAs": "SGML",
│ "GlossTerm": "Standard Generalized Markup Language",
│ "Acronym": "SGML",
│ "Abbrev": "ISO 8879:1986",
│ "GlossDef": {
│ "para": "A meta-markup language, used to create markup languages such as DocBook.",
│ "GlossSeeAlso": [
│ "GML",
│ "XML"
│ ]
│ },
│ "GlossSee": "markup"
│ }
│ }
│ }
│ }
│}
└────────────────────────────────────────────────────────────────────────────────────────
License
Copyright 2019, AmniX
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.