CheckPasswordStrength
==

[English](README.md) | 简体中文

[![JitPack](https://jitpack.io/v/venshine/CheckPasswordStrength.svg)](https://jitpack.io/#venshine/CheckPasswordStrength)  [![CI](https://github.com/venshine/CheckPasswordStrength/actions/workflows/ci.yml/badge.svg)](https://github.com/venshine/CheckPasswordStrength/actions/workflows/ci.yml)

CheckPasswordStrength是一个Java开源库，提供检测密码强度的功能。

Desc
--
#### Dictionary（字典）
**{"password", "abc123", "iloveyou", "adobe123", "123123", "sunshine","1314520", "a1b2c3", "123qwe", "aaa111", "qweasd", "admin", "passwd"}**

#### Level（级别）
* **0-3 : [easy]**
* **4-6 : [medium]**  
* **7-9 : [strong]**  
* **10-12 : [very strong]**  
* **>12 : [extremely strong]**  

Usage
--
纯 Java 实现，没有第三方依赖，Java 和 Kotlin（JVM / Android）都可以直接调用。

##### Java:
```Java
    public static void main(String[] args) {
		String passwd = "2hAj5#mne-ix.86H";
		System.out.println(CheckStrength.checkPasswordStrength(passwd));
	}
```

```Java
    CheckStrength.LEVEL level = CheckStrength.getPasswordLevel(passwd); // EASY / MEDIUM / STRONG / VERY_STRONG / EXTREMELY_STRONG
```

##### Kotlin:
```kotlin
import com.wx.pwd.CheckStrength

fun main() {
    val passwd = "2hAj5#mne-ix.86H"
    println(CheckStrength.checkPasswordStrength(passwd)) // 强度分值

    when (CheckStrength.getPasswordLevel(passwd)) {
        CheckStrength.LEVEL.EASY, CheckStrength.LEVEL.MEDIUM -> println("密码太弱")
        else -> println("密码强度合格")
    }
}
```

Download
--
##### Gradle（通过 JitPack）:
```groovy
repositories {
    maven { url = 'https://jitpack.io' }
}

dependencies {
    implementation 'com.github.venshine:CheckPasswordStrength:2.0.0'
}
```

##### Gradle Kotlin DSL:
```kotlin
repositories {
    maven("https://jitpack.io")
}

dependencies {
    implementation("com.github.venshine:CheckPasswordStrength:2.0.0")
}
```

##### Jar:
[下载jar包](https://github.com/venshine/CheckPasswordStrength/releases/download/2.0.0/CheckPasswordStrength.jar)

> 2.0.0 修复了连续序列、字典词检测和超长纯数字崩溃等问题，部分密码的评分会与 1.x 不同；枚举 `LEVEL.MIDIUM` 更名为 `LEVEL.MEDIUM`。详见 [CHANGELOG](CHANGELOG.md)。

Test
--
```shell
./test.sh
```

About
--
* Email：venshine.cn@gmail.com

License
--
    Copyright (C) 2014 venshine.cn@gmail.com

    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.