Skip to content

Commit 585cdf2

Browse files
committed
first commit
0 parents  commit 585cdf2

38 files changed

+1269
-0
lines changed

.gitignore

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
.gradle/
2+
.idea/
3+
**/build/
4+
local.properties

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2025 Javad Tahmasbi
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

README.md

Lines changed: 139 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,139 @@
1+
# JimToast 🍞 – A lightweight Android Toast library
2+
3+
JimToast is a lightweight and stylish toast library for Android, written entirely in Java with no external dependencies.
4+
It offers predefined colorful styles, smart queuing, customizable icons, and immediate display support.
5+
6+
# ![JimToast Banner](./banner.webp)
7+
[![Language](https://img.shields.io/badge/Language-Java-DC843D)](https://docs.oracle.com/java)
8+
[![Platform](https://img.shields.io/badge/Platform-Android-3DDC84)](https://android.com)
9+
[![API](https://img.shields.io/badge/API-21%20%2B-843DDC)](https://developer.android.com/about/versions/lollipop)
10+
[![JitPack](https://img.shields.io/github/v/release/tmsbj/jimtoast?label=JitPack&color=DC3D84)](https://jitpack.io/#tmsbj/jimtoast)
11+
[![Size](https://img.shields.io/badge/Size-~15KB-3D84DC)](https://github.com/tmsbj/jimtoast/tree/main/jimtoast/src/main)
12+
[![License](https://img.shields.io/badge/License-MIT-84DC3D)](./LICENSE)
13+
14+
---
15+
16+
## ✨ Features
17+
18+
* 🔹 **Standalone** — No external libraries required
19+
* 🎨 **Predefined types** — 10 colorful styles (Success, Error, Warning, etc.)
20+
* 🔁 **Queue support** — Toasts auto-queued without overlap
21+
***Urgent display** — Cancel queued toasts and show immediately
22+
* 🖼️ **Custom icons** — Set custom drawable or remove completely
23+
* 🧩 **Flexible messages** — Accepts any object (auto-converted to string)
24+
* 🧼 **Clean Java-only** — No annotations, no dependencies
25+
***Cancelable** — Cancel active or queued toasts on demand
26+
27+
---
28+
29+
## 📎 Sample APK
30+
31+
Download and install the latest release to see JimToast in action:
32+
33+
👉 [Download Latest APK](https://github.com/tmsbj/jimtoast/releases/latest/download/app-release.apk) 📲
34+
35+
<sub>No permissions required. Works in all Android versions API 21+.</sub>
36+
37+
---
38+
39+
## 📁 Gradle Setup
40+
41+
1. **Add JitPack to your `settings.gradle`:**
42+
43+
<sub>Project-level (`settings.gradle`):</sub>
44+
```groovy
45+
dependencyResolutionManagement {
46+
repositories {
47+
google()
48+
mavenCentral()
49+
maven { url 'https://jitpack.io' }
50+
}
51+
}
52+
```
53+
54+
2. **Add the dependency to your `build.gradle`:**
55+
56+
<sub>App-level (`build.gradle`):</sub>
57+
58+
```groovy
59+
dependencies {
60+
implementation 'com.github.tmsbj:jimtoast:1.0.0'
61+
}
62+
```
63+
64+
---
65+
66+
## 🚀 Usage
67+
68+
**📌 Basic usage:** Show a toast with the default icon based on type
69+
70+
```java
71+
JimToast.show(getApplicationContext(), "Message text", JimToast.DURATION_SHORT, JimToast.TYPE_SUCCESS);
72+
```
73+
#
74+
**⚡ Urgent toast:** Cancel all queued toasts and show this one immediately
75+
76+
```java
77+
JimToast.showUrgent(getApplicationContext(), "Urgent toast", JimToast.DURATION_LONG, JimToast.TYPE_WARNING);
78+
```
79+
#
80+
**🎨 Custom icon:** Override the default icon with a resource, or remove the icon by passing `0`
81+
82+
```java
83+
JimToast.show(getApplicationContext(), "Custom icon", JimToast.DURATION_SHORT, JimToast.TYPE_ERROR, R.drawable.ic_launcher);
84+
JimToast.show(getApplicationContext(), "Remove icon", JimToast.DURATION_SHORT, JimToast.TYPE_HELP, 0);
85+
```
86+
#
87+
**🧠 Flexible message input:** Accepts any type convertible to `String`
88+
89+
```java
90+
JimToast.show(getApplicationContext(), 3.14f, JimToast.DURATION_LONG, JimToast.TYPE_INFO);
91+
JimToast.show(getApplicationContext(), new Date(), JimToast.DURATION_LONG, JimToast.TYPE_PENDING);
92+
JimToast.show(getApplicationContext(), R.string.hello_text, JimToast.DURATION_LONG, JimToast.TYPE_SETUP);
93+
```
94+
#
95+
**🔁 Cancel all current and queued toasts**
96+
97+
```java
98+
JimToast.cancelAllToasts();
99+
```
100+
#
101+
**🔍 Check if a toast is currently showing**
102+
103+
```java
104+
boolean isActive = JimToast.isShowing();
105+
```
106+
107+
---
108+
109+
## ⚙️ Parameters
110+
111+
| Name | Type | Description |
112+
| ---------- |--------------------------------------------------|-----------------------------------------------------------|
113+
| `context` | `Context` | A valid Context (Activity or Application) |
114+
| `message` | `Object` (String, CharSequence, or `@StringRes`) | Any text or object convertible to string |
115+
| `duration` | `DURATION_SHORT` or `DURATION_LONG` | Toast display duration |
116+
| `type` | `TYPE_*` constants | Visual style of the toast |
117+
| `iconRes` | *(optional)* `@DrawableRes int` | Custom icon resource. Use `0` to remove, or `-1` to hide |
118+
119+
All parameters are easy to use and designed to provide maximum flexibility with minimal code.
120+
121+
---
122+
123+
## 🎨 Toast Types
124+
125+
These are the available visual styles:
126+
127+
`TYPE_DEFAULT`, `TYPE_SETUP`, `TYPE_SUCCESS`, `TYPE_WARNING`, `TYPE_ERROR`,
128+
`TYPE_HELP`, `TYPE_INFO`, `TYPE_PENDING`, `TYPE_STAR`, `TYPE_BOLT`
129+
130+
---
131+
132+
## 📄 License
133+
134+
This library is licensed under the [MIT License](https://opensource.org/licenses/MIT).
135+
136+
---
137+
138+
Made with 💙 by [Javad Tahmasbi](https://github.com/tmsbj)
139+
#

banner.webp

94.7 KB
Loading

build.gradle

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
// Top-level build file where you can add configuration options common to all sub-projects/modules.
2+
plugins {
3+
id 'com.android.application' version '8.0.2' apply false
4+
id 'com.android.library' version '8.0.2' apply false
5+
}

gradle.properties

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# Project-wide Gradle settings.
2+
# IDE (e.g. Android Studio) users:
3+
# Gradle settings configured through the IDE *will override*
4+
# any settings specified in this file.
5+
# For more details on how to configure your build environment visit
6+
# http://www.gradle.org/docs/current/userguide/build_environment.html
7+
# Specifies the JVM arguments used for the daemon process.
8+
# The setting is particularly useful for tweaking memory settings.
9+
org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
10+
# When configured, Gradle will run in incubating parallel mode.
11+
# This option should only be used with decoupled projects. More details, visit
12+
# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
13+
# org.gradle.parallel=true
14+
# AndroidX package structure to make it clearer which packages are bundled with the
15+
# Android operating system, and which are packaged with your app's APK
16+
# https://developer.android.com/topic/libraries/support-library/androidx-rn
17+
android.useAndroidX=false
18+
android.enableJetifier=false
19+
# Enables namespacing of each library's R class so that its R class includes only the
20+
# resources declared in the library itself and none from the library's dependencies,
21+
# thereby reducing the size of the R class for that library
22+
android.nonTransitiveRClass=true

gradle/wrapper/gradle-wrapper.jar

57.8 KB
Binary file not shown.
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
#Mon Jun 30 02:31:47 IRST 2025
2+
distributionBase=GRADLE_USER_HOME
3+
distributionPath=wrapper/dists
4+
distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
5+
zipStoreBase=GRADLE_USER_HOME
6+
zipStorePath=wrapper/dists

gradlew

Lines changed: 185 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
1+
#!/usr/bin/env sh
2+
3+
#
4+
# Copyright 2015 the original author or authors.
5+
#
6+
# Licensed under the Apache License, Version 2.0 (the "License");
7+
# you may not use this file except in compliance with the License.
8+
# You may obtain a copy of the License at
9+
#
10+
# https://www.apache.org/licenses/LICENSE-2.0
11+
#
12+
# Unless required by applicable law or agreed to in writing, software
13+
# distributed under the License is distributed on an "AS IS" BASIS,
14+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15+
# See the License for the specific language governing permissions and
16+
# limitations under the License.
17+
#
18+
19+
##############################################################################
20+
##
21+
## Gradle start up script for UN*X
22+
##
23+
##############################################################################
24+
25+
# Attempt to set APP_HOME
26+
# Resolve links: $0 may be a link
27+
PRG="$0"
28+
# Need this for relative symlinks.
29+
while [ -h "$PRG" ] ; do
30+
ls=`ls -ld "$PRG"`
31+
link=`expr "$ls" : '.*-> \(.*\)$'`
32+
if expr "$link" : '/.*' > /dev/null; then
33+
PRG="$link"
34+
else
35+
PRG=`dirname "$PRG"`"/$link"
36+
fi
37+
done
38+
SAVED="`pwd`"
39+
cd "`dirname \"$PRG\"`/" >/dev/null
40+
APP_HOME="`pwd -P`"
41+
cd "$SAVED" >/dev/null
42+
43+
APP_NAME="Gradle"
44+
APP_BASE_NAME=`basename "$0"`
45+
46+
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
47+
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
48+
49+
# Use the maximum available, or set MAX_FD != -1 to use that value.
50+
MAX_FD="maximum"
51+
52+
warn () {
53+
echo "$*"
54+
}
55+
56+
die () {
57+
echo
58+
echo "$*"
59+
echo
60+
exit 1
61+
}
62+
63+
# OS specific support (must be 'true' or 'false').
64+
cygwin=false
65+
msys=false
66+
darwin=false
67+
nonstop=false
68+
case "`uname`" in
69+
CYGWIN* )
70+
cygwin=true
71+
;;
72+
Darwin* )
73+
darwin=true
74+
;;
75+
MINGW* )
76+
msys=true
77+
;;
78+
NONSTOP* )
79+
nonstop=true
80+
;;
81+
esac
82+
83+
CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
84+
85+
86+
# Determine the Java command to use to start the JVM.
87+
if [ -n "$JAVA_HOME" ] ; then
88+
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
89+
# IBM's JDK on AIX uses strange locations for the executables
90+
JAVACMD="$JAVA_HOME/jre/sh/java"
91+
else
92+
JAVACMD="$JAVA_HOME/bin/java"
93+
fi
94+
if [ ! -x "$JAVACMD" ] ; then
95+
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
96+
97+
Please set the JAVA_HOME variable in your environment to match the
98+
location of your Java installation."
99+
fi
100+
else
101+
JAVACMD="java"
102+
which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
103+
104+
Please set the JAVA_HOME variable in your environment to match the
105+
location of your Java installation."
106+
fi
107+
108+
# Increase the maximum file descriptors if we can.
109+
if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
110+
MAX_FD_LIMIT=`ulimit -H -n`
111+
if [ $? -eq 0 ] ; then
112+
if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
113+
MAX_FD="$MAX_FD_LIMIT"
114+
fi
115+
ulimit -n $MAX_FD
116+
if [ $? -ne 0 ] ; then
117+
warn "Could not set maximum file descriptor limit: $MAX_FD"
118+
fi
119+
else
120+
warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
121+
fi
122+
fi
123+
124+
# For Darwin, add options to specify how the application appears in the dock
125+
if $darwin; then
126+
GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
127+
fi
128+
129+
# For Cygwin or MSYS, switch paths to Windows format before running java
130+
if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
131+
APP_HOME=`cygpath --path --mixed "$APP_HOME"`
132+
CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
133+
134+
JAVACMD=`cygpath --unix "$JAVACMD"`
135+
136+
# We build the pattern for arguments to be converted via cygpath
137+
ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
138+
SEP=""
139+
for dir in $ROOTDIRSRAW ; do
140+
ROOTDIRS="$ROOTDIRS$SEP$dir"
141+
SEP="|"
142+
done
143+
OURCYGPATTERN="(^($ROOTDIRS))"
144+
# Add a user-defined pattern to the cygpath arguments
145+
if [ "$GRADLE_CYGPATTERN" != "" ] ; then
146+
OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
147+
fi
148+
# Now convert the arguments - kludge to limit ourselves to /bin/sh
149+
i=0
150+
for arg in "$@" ; do
151+
CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
152+
CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
153+
154+
if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
155+
eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
156+
else
157+
eval `echo args$i`="\"$arg\""
158+
fi
159+
i=`expr $i + 1`
160+
done
161+
case $i in
162+
0) set -- ;;
163+
1) set -- "$args0" ;;
164+
2) set -- "$args0" "$args1" ;;
165+
3) set -- "$args0" "$args1" "$args2" ;;
166+
4) set -- "$args0" "$args1" "$args2" "$args3" ;;
167+
5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
168+
6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
169+
7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
170+
8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
171+
9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
172+
esac
173+
fi
174+
175+
# Escape application args
176+
save () {
177+
for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
178+
echo " "
179+
}
180+
APP_ARGS=`save "$@"`
181+
182+
# Collect all arguments for the java command, following the shell quoting and substitution rules
183+
eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
184+
185+
exec "$JAVACMD" "$@"

0 commit comments

Comments
 (0)