Added CLI support

Author: adamlui

find-project-root/docs/README.md

@@ -21,10 +21,10 @@
 
 **find-project-root** is a lightweight utility that traverses up from a given path until it finds a project marker.
 
-- Minimal dependencies — only uses [project-markers][project-markers-gh] (~4 KB module)
+- Lightweight — < 100 KB
 - Path flexibility — accepts strings, `Path` objects, or current working dir
 - Customizable markers — provide your own or use defaults
-- Multi-Python support — from Python 2.6 thru 3.15+
+- Multi-env support — use via [API](#api-usage) or [CLI](#command-line-usage)
 
 <hr>
 
@@ -84,6 +84,24 @@ root = find_project_root(path='src', max_depth=5, markers=['manifest.json'])
 
 <hr>
 
+## Command line usage
+
+```bash
+find-project-root  # or projectroot
+# e.g. => 'e:\python\utils\translate-messages'
+```
+
+CLI options:
+
+| Option              | Description
+| ------------------- | ------------------------------------
+| `-h`, `--help`      | Show help screen
+| `-v`, `--version`   | Show version
+| `--docs`            | Open docs URL
+
+<hr>
+
+
 ## MIT License
 
 Copyright © 2026 [Adam Lui](https://github.com/adamlui)

find-project-root/noxfile.py

@@ -1,13 +1,19 @@
+from pathlib import Path
 import sys
+from types import SimpleNamespace as sn
 
 import nox
 
 py_cmd = 'py' if sys.platform.startswith('win') else 'python3'
+pkg = sn(dir=Path(__file__).parent.name)
+pkg.name = pkg.dir.replace('-', '_')
 
 def session(func) : return nox.session(venv_backend='none', name=func.__name__.replace('_', '-'))(func)
 
 @session
-def dev(session) : session.run('pip', 'install', '-e', '.')
+def dev(session) : session.run('pip', 'install', '-e', '.') ; session.run(pkg.dir, '--help', *session.posargs)
+@session
+def debug(session) : session.run(py_cmd, '-m', pkg.name, '--debug', *session.posargs, env={ 'PYTHONPATH': 'src' })
 @session
 def test_py26(session):
     from pathlib import Path

find-project-root/pyproject.toml

@@ -18,9 +18,14 @@ license-files = [
     "docs/LICENSE.md",
 ]
 dependencies = [
+    "colorama>=0.4.6,<1 ; platform_system == 'Windows'",
+    "is-unicode-supported>=1.2.1,<2",
+    "json5>=0.14.0,<1",
+    "non-latin-locales>=1.0.5,<2",
     "project-markers>=1.0.4,<2",
+    "sys-lang>=1.0.1,<2",
 ]
-requires-python = ">=2.6,<4"
+requires-python = ">=3.8,<4"
 keywords = [
     "detect",
     "detection",
@@ -71,10 +76,20 @@ Issues = "https://github.com/adamlui/python-utils/issues"
 Releases = "https://github.com/adamlui/python-utils/releases"
 Repository = "https://github.com/adamlui/python-utils"
 
+[project.scripts]
+project-root = "find_project_root.cli.__main__:main"
+get-project-root = "find_project_root.cli.__main__:main"
+find-project-root = "find_project_root.cli.__main__:main"
+projectroot = "find_project_root.cli.__main__:main"
+getprojectroot = "find_project_root.cli.__main__:main"
+findprojectroot = "find_project_root.cli.__main__:main"
+
 [project.optional-dependencies]
 dev = [
     "nox>=2026.4.10",
     "pre-commit>=4.5.1,<5",
+    "remove-json-keys>=1.10.1,<2",
     "tomli>=2.4.1,<3",
     "tomli-w>=1.2.0,<2",
+    "translate-messages>=1.10.1,<2",
 ]

find-project-root/src/find_project_root/__init__.py

@@ -1,5 +1,3 @@
-import sys
-
 from .api import find_project_root
 
-sys.modules[__name__] = find_project_root # type: ignore
+__all__ = ['find_project_root']

find-project-root/src/find_project_root/cli/__init__.py

@@ -0,0 +1,17 @@
+import sys
+
+from ..api import find_project_root
+from .lib import init, settings
+
+def main():
+    cli = init.cli()
+
+    # Process early-exit args (e.g. --help, --version)
+    for ctrl_name, ctrl in vars(settings.controls).items():
+        if getattr(ctrl, 'exit', False) and getattr(cli.config, ctrl_name, False):
+            if hasattr(ctrl, 'handler') : ctrl.handler(cli)
+            sys.exit(0)
+
+    print(find_project_root())
+
+if __name__ == '__main__' : main()

find-project-root/src/find_project_root/cli/__main__.py

@@ -0,0 +1,3 @@
+from . import csv, file, json, sns
+
+__all__ = ['csv', 'file', 'json', 'sns']

find-project-root/utils/lib/color.py …t/src/find_project_root/cli/lib/color.pyfind-project-root/utils/lib/color.py renamed to find-project-root/src/find_project_root/cli/lib/color.py find-project-root/utils/lib/color.py renamed to find-project-root/src/find_project_root/cli/lib/color.py

@@ -0,0 +1,5 @@
+from typing import List
+
+def parse(val: str) -> List[str]:
+    if not val : return []
+    return [item.strip() for item in val.split(',') if item.strip()]