https://github.com/sangeethnandakumar/testtube
Highly simplified Android programming helper library
https://github.com/sangeethnandakumar/testtube
android app distance distance-matrix-api file-download google gps grdview library listview permission settings webpage
Last synced: about 2 months ago
JSON representation
Highly simplified Android programming helper library
- Host: GitHub
- URL: https://github.com/sangeethnandakumar/testtube
- Owner: sangeethnandakumar
- Created: 2017-05-18T15:56:05.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-06-13T05:56:29.000Z (about 8 years ago)
- Last Synced: 2025-04-03T23:15:41.416Z (about 1 year ago)
- Topics: android, app, distance, distance-matrix-api, file-download, google, gps, grdview, library, listview, permission, settings, webpage
- Language: Java
- Homepage:
- Size: 5.96 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Introducing TestTube
The TestTube library project for easy Android implimentations
[](https://jitpack.io/#sangeethnandakumar/TestTube)
[]()
[]()
[]()
**HIT THAT STAR ONLY AFTER THIS HELPS YOU | **
**FIRE A MAIL DIRECTLY : sangeethnandakumar@gmail.com | **
**DROP A MSG ON WHATSAPP: +91 9495661468**
# Include the Gradle Dependency
1. On project level Gradle, add
```gradle
allprojects
{
repositories
{
...
maven { url 'https://jitpack.io' }
}
}
```
2. In app/module level Gradle, add
```gradle
dependencies
{
compile 'com.github.sangeethnandakumar:TestTube:[LATEST_VERSION]'
}
```
3. **LATEST_VERSION (Use this version on dependency)** : [](https://jitpack.io/#sangeethnandakumar/TestTube)
Library Version | Improvements | Dependency
------------ | ------------- | -------------
Prior to v2.0.1 | Not available on GitHub | Not available on GitHub
v2.0.1 | New : Standard listview (SLV)
Removed : Old WebServer class | com.github.sangeethnandakumar:TestTube:v2.0.1
v2.0.2 | Upgraded : SLV now supports linear/card layerings
Upgraded : Specification added to adapter | com.github.sangeethnandakumar:TestTube:v2.0.2
v2.0.3 | New : Fully implemented FileDownloader class for url downloads
Minor bug fixes and improvements
New : WebDoc class to convert a webpage to pdf | com.github.sangeethnandakumar:TestTube:v2.0.3
v2.0.4 | New : Standard gridview (SGV)
New : Support for gridview card/linear layering
New : SGV supports drawable or web resource
Upgraded : Code optimised | com.github.sangeethnandakumar:TestTube:v2.0.4
v2.0.5 | New : Android runtime permission helper
Upgraded : Permit class to support multimple permissions at once
Upgraded : Permission reponce interface | com.github.sangeethnandakumar:TestTube:v2.0.5
v2.1.0 | New : Permanant settings
New : Autostack page stack
Beta : Google Distance Metrix initial phase (GDM) | com.github.sangeethnandakumar:TestTube:v2.1.0
v2.5.0 | Upgraded : Google Distance Metrix fully implemented
New : Support for Http GET request
New : Support for Http POST request
Upgraded : POST request to send a DataRack | com.github.sangeethnandakumar:TestTube:v2.5.0
v2.5.1 | Removed : RW External storage permission
New : 'SuperDatabase', a pure local SQL database
Upgraded : injectSQL to do non returning SQL queries
Upgraded : ejectSQL to do returning SQL queries
Upgraded : ArrayString, JSON and XML out from Database
Beta : Ability to import 'Asset DB' and use
Beta : Importing .db database with existing control
New : Syntax highlighter with a number of language support | com.github.sangeethnandakumar:TestTube:v2.5.1
v2.5.2 | Applied : Minor bug fixes | com.github.sangeethnandakumar:TestTube:v2.5.2
v2.5.3 | Applied : Major bug fixes | com.github.sangeethnandakumar:TestTube:v2.5.3
Important:
[]()
[]()
[]()
[]()
#
## SIMPLE STANDARD LISTVIEW (adapter)
Its very simple to use a standard list now
1. Declare your listview
```java
ListView list=(ListView)findViewById(R.id.listview);
```
2. Add your items in a SimpleItem list
```java
List simpleItems=new ArrayList<>();
simpleItems.add(new SimpleItem("United States"));
simpleItems.add(new SimpleItem("India"));
simpleItems.add(new SimpleItem("Russia"));
simpleItems.add(new SimpleItem("China"));
```
3. Create a SimpleAdapter
```java
SimpleAdapter simpleAdapter=new SimpleAdapter(getApplicationContext(),simpleItems, AdapterType.LISTVIEW, AdapterLayering.LINEAR);
```
4. Just attach the Adapter to your listview and its over
```java
list.setAdapter(simpleAdapter);
```
### You done everything.!!!, For further minimal customizing
a) Add optional resource image if you want it
```java
simpleItems.add(new SimpleItem("Lotus Flower",R.drawable.lotus));
simpleItems.add(new SimpleItem("Lilly Flower",R.drawable.lilly));
simpleItems.add(new SimpleItem("Rose Flower",R.drawable.rose));
```
b) Add optional web image if you want it (requires internet)
```java
simpleItems.add(new SimpleItem("Google","https://www.google.com/something.png"));
simpleItems.add(new SimpleItem("Facebook","https://www.facebook.com/something.png"));
simpleItems.add(new SimpleItem("YouTube","https://www.youtube.com/something.png"));
```
c) Feel free to mix all these
```java
simpleItems.add(new SimpleItem("Simply text"));
simpleItems.add(new SimpleItem("Resource image",R.drawable.elephant));
simpleItems.add(new SimpleItem("Web image","https://www.google.com/something.png"));
```
### Another way
a) You can change the AdapterLayering to CARD if you need it
```java
SimpleAdapter simpleAdapter=new SimpleAdapter(getApplicationContext(),simpleItems, AdapterType.LISTVIEW, AdapterLayering.CARD);
```
### DUAL STANDARD LISTVIEW (adapter)
Like Simple Standard listview before, Use a standard dual list view
1. Previous statements are same except here
```java
List dualItems=new ArrayList<>();
dualItems.add(new DualItem("Samsung","User in Korea"));
dualItems.add(new DualItem("Pixel","User in California"));
dualItems.add(new DualItem("Sony Xperia","User in Japan"));
DualAdapter dualAdapter=new DualAdapter(getApplicationContext(),dualItems,AdapterType.LISTVIEW,AdapterLayering.CARD);
list.setAdapter(dualAdapter);
```
NOTE : Images from resources and web are also compatable here
### TRIPLE STANDARD LISTVIEW (adapter)
Like Dual Standard listview before, Use a standard triple list view
1. Statements are changed like
```java
List tripleItems=new ArrayList<>();
tripleItems.add(new TripleItem("Billy","Cat","At Kerala"));
tripleItems.add(new TripleItem("Snoory","Cat","At Banglore"));
tripleItems.add(new TripleItem("Dingi","Dog","At Mumbai"));
tripleItems.add(new TripleItem("Pupy","Dog","At Jammu"));
TripleAdapter tripleAdapter=new TripleAdapter(getApplicationContext(),tripleItems,AdapterType.LISTVIEW,AdapterLayering.LINEAR);
list.setAdapter(tripleAdapter);
```
NOTE : Images from resources and web are also compatable here
## SIMPLE/DUAL/TRIPLE STANDARD GRIDVIEW (adapter)
Like Simple/Dual/Tripple Standard listview before, Simple change this to make into a GridView
1. Previous statements are same except here
```java
DualAdapter dualAdapter=new DualAdapter(getApplicationContext(),dualItems,AdapterType.GRIDVIEW,AdapterLayering.CARD);
grid.setAdapter(dualAdapter);
```
## ASKING RUNTIME PERMISSIONS (permissions)
Android runtime permissions are no longer RoCketScience
1. Initialise the Permit object, passing your current activity
```java
Permit permit=new Permit(MainActivity.this);
```
2. Simply listen to the permission events using event listner
```java
permit.setOnPermitStatusListner(new Permit.OnPermitStatusListner()
{
@Override
public void onAllPermitsGranded()
{
// ALL PERMITS ACCEPTED
}
@Override
public void onSomePermitsDenied(ArrayList deniedPermits)
{
// SOME PERMITS ACCEPTED
}
@Override
public void onAllPermitsDenied()
{
// ALL PERMITS DENIED
}
});
```
3. Now just ask for what permissions you need. Yes, It's over
```java
permit.askPermitsFor(
Manifest.permission.CAMERA,
Manifest.permission.READ_CALENDAR,
Manifest.permission.READ_CONTACTS);
```
## PERMANANT SETTINGS FOR YOUR APP (managers)
1. Wan't to store/retrive your application settings? Simple initialise the AppSettings class with any context
```java
AppSettings settings=new AppSettings(getApplicationContext());
```
2. Store what all stuffs you want like (KEY-VALUE) style
```java
settings.saveSettings("username","sangeeth");
settings.saveSettings("password","sangeeth@123");
settings.saveSettings("points","250");
settings.saveSettings("level","5");
settings.saveSettings("gender","male");
```
3. Retrive what all stored
```java
String username=settings.retriveSettings("username");
Toast.makeText(MainActivity.this, "Username is - " + username, Toast.LENGTH_SHORT).show();
```
NOTE : The settings stores here will persist even the app is closed. (Until uninstalled)
## AUTOSTACK FOR YOUR PAGE MANAGEMENTS (managers)
Its simply a string stack. When you are on a page, then push that PAGE_KEY. When user press BACK button, pop out the PAGE_KEY and check. If nothing to pop out, exit the app. Don't undersatand? It's simple like catching a frog from your pond.
1. Just initialise the AutoStack
```java
AutoStack stack=new AutoStack();
```
2. Push while you traverse each pages of something (Assume a book)
```java
// Assume user is presented with a menu
// As he enters each menu another menu is appearing (Like a directory)
// User at page SPACE (SPACE)
page.push("space");
// User clicks on EARTH (SPACE/EARTH)
page.push("earth");
// User clicks on ASIA (SPACE/EARTH/ASIA)
page.push("asia");
// User clicks on INDIA (SPACE/EARTH/ASIA/INDIA)
page.push("india");
```
3. Override the onBackPressed() methord of your activity
```java
@Override
public void onBackPressed()
{
if (page.isEmpty())
{
super.onBackPressed();
}
else
{
switch (page.pop())
{
case "india" :
showAsiaMenu();
break;
case "asia" :
showEarthMenu();
break;
case "space" :
showSpaceMenu();
break;
}
}
}
```
NOTE : STACK space used is not persistant and will be cleared when app restarts or context switched
## GOOGLE DISTANCE MATRIX FOR YOUR ADDRESSES (extended)
New feature that brings you the address of locations, distance to travel on road along with units and time to travel along with units from Google Servers in its most simplest way
0. Look at the GoogleDistanceMatrix class initialisation syntax
```java
GoogleDistanceMatrix gdm=new GoogleDistanceMatrix("","","","","",);
```
1. Now initialise it as depected
```java
//Initialise key. You will get this key from here : https://developers.google.com/maps/documentation/distance-matrix/get-api-key
String key = "ABcdEfGHIJ7L4YhXw01INDIAHbVlgIhjmouSeVc";
//Set origin to
String origin_lat="36.752071";
String origin_lng="-119.823064";
// Set destination to
String dest_lat="36.773276";
String dest_lng="-119.845252";
GoogleDistanceMatrix gdm = new GoogleDistanceMatrix(key,origin_lat,origin_lng,dest_lat,dest_lng,getApplicationContext());
```
2. Simplicity starts right now. Attach that listner
```java
gdm.setOnGDMStatusListner(new GoogleDistanceMatrix.OnGDMStatusListner()
{
@Override
public void onGDMAvailable(GoogleDistanceMatrix gdm)
{
//Quickly collect details
String origin_address = gdm.getOrgin_address();
String dest_address = gdm.getDest_address();
String distance = gdm.getDistance();
String duration = gdm.getDuration();
}
@Override
public void onGDMFailed()
{
//Failed due to some resons
}
});
```
3. Now send that request to GoogleServers via Our server (Complex codes are implimented on our server to keep you smiling). Now just request.!
```java
gdm.getDistanceMatrix();
```
NOTE : Details will be arrived at the listners as soon us our server sends it back
## DOWNLOAD A FILE (network)
Thinking for an ultimate simple way to download an file from an URL? With multithreading and simultanious download features, Here comes the new FileDownloader class
0. Look at the initialisation syntax
```java
FileDownloader downloader=new FileDownloader(,);
```
1. Now initialise the object like before
```java
FileDownloader downloader=new FileDownloader(getApplicationContext(),"http://www.example.com/test.pdf")
```
2. Keep track of downloader with these event listners
```java
downloader.setOnDownloadStatusListner(new FileDownloader.OnDownloadStatusListner() {
@Override
public void onStarted()
{
}
@Override
public void onConnecting()
{
}
@Override
public void onConnected(long total, boolean isRangeSupport)
{
}
@Override
public void onDownloading(long finished, long total, int progress)
{
}
@Override
public void onCompleted()
{
}
@Override
public void onFailed(String message)
{
}
@Override
public void onPaused()
{
}
@Override
public void onCancelled()
{
}
});
```
3. This is the last step to download. So simple...
```java
downloader.downloadFile("/storage/emulated/0","newfile.pdf");
```
NOTE : The construction and devolopment of this class is in BETA. Unfortunatelly, Pause and Cancel is not working as of now. You can use without any other problems. Pause and Cancel support will be added soon.
## HTTP GET REQUEST (network)
Http GET methord requests a server with inline parameters on its URL. DOn't use Http GET to transfer passwords!. Http GET is best for visible parameters and easy to debug
1. Initialise a WebServer instance and start its listners
```java
WebServer server=new WebServer(getApplicationContext());
server.setOnServerStatusListner(new WebServer.OnServerStatusListner() {
@Override
public void onServerResponded(String responce) {
}
@Override
public void onServerRevoked() {
}
});
````
2. Now just call the server with GET parameters
```java
server.connectWithGET("https://www.google.com/test.php?name=Sangeeth&loc=India");
```
## HTTP POST REQUEST (network)
Http POST methord requests a server with unvisible parameters. Usefull to transport passwords.
1. Initialise a WebServer instance and start its listners
```java
WebServer server=new WebServer(getApplicationContext());
server.setOnServerStatusListner(new WebServer.OnServerStatusListner() {
@Override
public void onServerResponded(String responce) {
}
@Override
public void onServerRevoked() {
}
});
````
3. Create a list of DataRack for your key-value pairs
```java
List racks=new ArrayList();
racks.add(new DataRack("name","Simon"));
racks.add(new DataRack("age","40"));
racks.add(new DataRack("location","Canada"));
````
2. Now just call the server with POST rack along caller activity
```java
server.connectWithPOST(MainActivity.this,"http://sangeethnandakumar.esy.es/PROJECTS/PUBLIC_SERVICE/posttest.php",racks);
```
## SUPER DATABASE (managers)
Messed up with Android database implementations? Here is the perfect pure simple SQL database
0. Look at the syntax
```java
SuperDatabase database=new SuperDatabase(,,);
```
1. Declare the SuperDatabase
```java
SuperDatabase database=new SuperDatabase(getApplicationContext(),"Foods","CREATE TABLE IF NOT EXISTS food('name' VARCHAR(20),'vitamin' VARCHAR(20);");
```
Now fire the queries
a). Create an INJECT statement, If you have a non returning query
```java
database.sqlInject("INSERT INTO food VALUES('Banana','Vitamin A');");
database.sqlInject("INSERT INTO food VALUES('Apple','Vitamin B');");
database.sqlInject("INSERT INTO food VALUES('Grapes','Vitamin C');");
```
It will simply executes...
b). Create an EJECT statement, If you have a returning query
```java
= database.sqlEjectCSV("SELECT * FROM food;");
```
b). EJECT statement can eject data in CSV, JSON & XML formats. CSV needs an ArrayList
**CSV**
```java
ArrayList rows=new ArrayList();
rows=database.sqlEjectCSV("SELECT * FROM food;");
for (int i=0;i,,,);
```
1 a). If your app runs for the first time after installation, Then import the database from asset. So declare like this
```java
SuperDatabase database=new SuperDatabase(getApplicationContext(),"foods.db", AssetDatabaseMode.COPY_TO_SYSTEM);
```
1 b). If your app runs after first time, Never import the asset database again. So declare like this
```java
SuperDatabase database=new SuperDatabase(getApplicationContext(),"foods.db", AssetDatabaseMode.READ_FROM_DEVICE);
```
**NOTE : Now do the INJECT and EJECT queries as before (Also supports CSV, JSON and XML)**
IMPORTANT NOTE
```xml
1. You need a .db database for this
2. Download DB Browser For SQLite (Recomended Windows) - http://sqlitebrowser.org/
3. Click on 'New Database'
4. On save prompt - Include ".db" extension after filename
5. Done, Now import to assets folder
```
## SYNTAX HIGHLIGHTING (extended)
Online syntax highlighting highlights any language code segment with HTML that you can render on a WebView easly
1. Create the object
```java
SyntaxLight syntax=new SyntaxLight(getApplicationContext(),"PHP","");
```
2. Implement the listners
```java
syntax.setOnCodeStatusListner(new SyntaxLight.OnCodeStatusListner() {
@Override
public void parsedToHTML(String s) {
//You got HTML here
}
@Override
public void parseError() {
}
});
```
3. Now highlight the code
```java
syntax.highlightCode();
```