Add cli integration

Author: josheppinette

README.md

@@ -26,6 +26,15 @@ $ pip install sssdldapauth
 
 ## Usage
 
+**CLI**
+
+```sh
+$ sssdldapauth deobfuscate <obfuscated_password>
+<password>
+```
+
+**Library**
+
 ```python
 from sssdldapauth import deobfuscate
 

setup.cfg

@@ -14,7 +14,12 @@ packages = find:
 python_requires = >= 3.6
 include_package_data = True
 install_requires=
+	click
 	cryptography
 
 [options.package_data]
 sssdldapauth = py.typed
+
+[options.entry_points]
+console_scripts =
+  sssdldapauth = sssdldapauth.cli:root

sssdldapauth/cli.py

@@ -0,0 +1,22 @@
+import sys
+
+import click
+
+import sssdldapauth
+
+
+@click.group()
+def root():
+    pass
+
+
+@root.command()
+@click.argument("token")
+def deobfuscate(token):
+    try:
+        password = sssdldapauth.deobfuscate(token)
+    except Exception:
+        click.echo("unable to deobfuscate token", err=True)
+        sys.exit(1)
+
+    click.echo(password)

tests/test_cli.py

@@ -0,0 +1,30 @@
+import pytest
+from click.testing import CliRunner
+
+from sssdldapauth import cli
+
+OBFUSCATED = (
+    "AAAQABagVAjf9KgUyIxTw3A+HUfbig7N1+L0qtY4xAULt2GY"
+    "HFc1B3CBWGAE9ArooklBkpxQtROiyCGDQH+VzLHYmiIAAQID"
+)
+DEOBFUSCATED = "Passw0rd"
+
+
+@pytest.fixture()
+def runner():
+    return CliRunner(mix_stderr=False)
+
+
+def test_valid(runner):
+    result = runner.invoke(cli.root, ["deobfuscate", OBFUSCATED])
+
+    assert result.exit_code == 0
+    assert result.output == f"{DEOBFUSCATED}\n"
+
+
+def test_invalid(runner):
+    result = runner.invoke(cli.root, ["deobfuscate", "invalid"])
+
+    assert result.exit_code == 1
+    assert result.output == ""
+    assert result.stderr == "unable to deobfuscate token\n"

tox.ini

@@ -2,5 +2,8 @@
 envlist = py36,py37,py38,py39,py310
 
 [testenv]
-deps = pytest
+deps =
+	click
+	cryptography
+	pytest
 commands = pytest {posargs}