Skip to content

Commit 90a1215

Browse files
committed
chore: update README with usage doc
1 parent a7d767f commit 90a1215

File tree

2 files changed

+129
-40
lines changed

2 files changed

+129
-40
lines changed

.idea/workspace.xml

Lines changed: 1 addition & 22 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

README.md

Lines changed: 128 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -11,35 +11,145 @@ follow the steps below to use the library in your project.
1111

1212
https://jitpack.io/#multiform-validator/java/
1313

14-
## Example of how to use
14+
## Available methods - JAVA (0.0.2)v
1515

16+
- CnpjValidator
17+
- cnpjIsValid
18+
19+
- CpfValidator
20+
- cpfIsValid
21+
22+
CreditCardValidator
23+
- isCreditCardValid
24+
- identifyCreditCard
25+
26+
- EmailValidator
27+
- isEmail
28+
29+
- Utils
30+
- getOnlyEmail
31+
- getOnlyEmailWithOptions (options)
32+
- multiple (boolean) - default: false
33+
- cleanDomain (boolean) - default: false
34+
- repeatEmail (boolean) - default: false
35+
36+
- Validator
37+
- isAscii
38+
- isCEP
39+
- isDate
40+
- isDecimal
41+
- isMACAddress
42+
- isNumber
43+
- isPort
44+
- isPostalCode
45+
- isTime
46+
47+
48+
## How to use
49+
50+
### CnpjValidator
1651
```java
17-
import io.github.multiform_validator.Validator;
18-
import io.github.multiform_validator.EmailValidator;
19-
import io.github.multiform_validator.CpfValidator;
2052
import io.github.multiform_validator.CnpjValidator;
21-
import io.github.multiform_validator.Utils;
2253

2354
public class Main {
2455
public static void main(String[] args) {
25-
System.out.println(EmailValidator.isEmail("foo@bar.com")); // true
26-
System.out.println(EmailValidator.isEmail("foo@bar")); // false
56+
String cnpjTrue = "69.807.668/0001-41";
57+
String cnpjFalse = "61.807.661/0001-48";
58+
System.out.println(CnpjValidator.cnpjIsValid(cnpjTrue)); // true
59+
System.out.println(CnpjValidator.cnpjIsValid(cnpjFalse)); // false
60+
}
61+
}
62+
```
63+
64+
### CpfValidator
65+
```java
66+
import io.github.multiform_validator.CpfValidator;
67+
68+
public class Main {
69+
public static void main(String[] args) {
70+
String cpfTrue = "123.456.789-09";
71+
String cpfFalse = "123.456.789-10";
72+
System.out.println(CpfValidator.cpfIsValid(cpfTrue)); // true
73+
System.out.println(CpfValidator.cpfIsValid(cpfFalse)); // false
74+
}
75+
}
76+
```
2777

28-
System.out.println(CpfValidator.cpfIsValid("123.456.789-09")); // true
29-
System.out.println(CpfValidator.cpfIsValid("123.456.789-00")); // false
30-
31-
System.out.println(CnpjValidator.cnpjIsValid("12.345.678/0001-09")); // true
32-
System.out.println(CnpjValidator.cnpjIsValid("12.345.678/0001-00")); // false
78+
### CreditCardValidator
79+
```java
80+
import io.github.multiform_validator.CreditCardValidator;
3381

34-
System.out.println(Validator.isAscii("foo")); // true
35-
System.out.println(Validator.isAscii("foo©")); // false
36-
37-
System.out.println(Utils.getOnlyEmail("This is an example test1@email.com bla yes my friend loren ipsun")); // test1@email.com
38-
System.out.println(Utils.getOnlyEmail("This is an example bla yes my friend loren ipsun")); // null
82+
public class Main {
83+
public static void main(String[] args) {
84+
String creditCard = "4532 8770 0040 4166";
85+
System.out.println(CreditCardValidator.isCreditCardValid(creditCard)); // true
86+
System.out.println(CreditCardValidator.identifyCreditCard(creditCard)); // Visa
87+
}
88+
}
89+
```
90+
91+
### EmailValidator
92+
```java
93+
import static io.github.multiform_validator.EmailValidator.isEmail;
94+
95+
public class Main {
96+
public static void main(String[] args) {
97+
String email = "foo@bar.com";
98+
System.out.println(isEmail(email)); // true
99+
}
100+
}
101+
```
102+
103+
### Utils
104+
```java
105+
import io.github.multiform_validator.Utils;
106+
107+
public class Main {
108+
public static void main(String[] args) {
109+
String msg1 = "This is a message example with foo@bar.com email to test";
110+
System.out.println(Utils.getOnlyEmail(msg1)); // foo@bar.com
111+
112+
String msg2 = "Example two foo1@bar.com and foo2@bar.com";
39113
// With options
40114
Utils.GetOnlyEmailOptionsParams options = new Utils.GetOnlyEmailOptionsParams();
41115
options.multiple = true;
42-
System.out.println(Utils.getOnlyEmail("This is an example test1@example.com bla test2@example.com yes yes", options)); // [test1@example.com, test2@example.com]
116+
System.out.println(Utils.getOnlyEmailWithOptions(msg2, options)); // [foo1@bar.com, foo2@bar.com]
117+
}
118+
}
119+
```
120+
121+
### Validator
122+
```java
123+
import io.github.multiform_validator.Validator;
124+
125+
public class Main {
126+
public static void main(String[] args) {
127+
validMethods();
128+
invalidMethods();
129+
}
130+
131+
public void validMethods () {
132+
System.out.println(Validator.isAscii("foo")); // true
133+
System.out.println(Validator.isCEP("12345-678")); // true
134+
System.out.println(Validator.isDate("2021-01-01")); // true
135+
System.out.println(Validator.isDecimal("1.5")); // true
136+
System.out.println(Validator.isMACAddress("00:00:00:00:00:00")); // true
137+
System.out.println(Validator.isNumber("123")); // true
138+
System.out.println(Validator.isPort("8080")); // true
139+
System.out.println(Validator.isPostalCode("12345-678")); // true
140+
System.out.println(Validator.isTime("12:00")); // true
141+
}
142+
143+
public void invalidMethods () {
144+
System.out.println(Validator.isAscii("こんにちは")); // false
145+
System.out.println(Validator.isCEP("12345678")); // false
146+
System.out.println(Validator.isDate("2021-01-32")); // false
147+
System.out.println(Validator.isDecimal("1.5.5")); // false
148+
System.out.println(Validator.isMACAddress("00:00:00:00:00:00:00")); // false
149+
System.out.println(Validator.isNumber("123a")); // false
150+
System.out.println(Validator.isPort("8080a")); // false
151+
System.out.println(Validator.isPostalCode("12345678")); // false
152+
System.out.println(Validator.isTime("12:00:00")); // false
43153
}
44154
}
45155
```

0 commit comments

Comments
 (0)