ldap-cli 0.2.0__py3-none-any.whl

ldap_cli-0.2.0.dist-info/METADATA

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: ldap-cli
+Version: 0.2.0
+Summary: A Python CLI tool for managing LDAP directories
+Project-URL: Homepage, https://github.com/tmb28054/ldap-cli
+Author-email: Topaz Bott <topaz@topazhome.net>
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Requires-Dist: keyring<26.0,>=25.0
+Requires-Dist: ldap3<3.0,>=2.9
+Requires-Dist: pyyaml<7.0,>=6.0
+Requires-Dist: rich<14.0,>=13.0
+Provides-Extra: dev
+Requires-Dist: bandit<2.0,>=1.7; extra == 'dev'
+Requires-Dist: hypothesis<7.0,>=6.100; extra == 'dev'
+Requires-Dist: mypy<2.0,>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov<6.0,>=5.0; extra == 'dev'
+Requires-Dist: pytest<9.0,>=8.0; extra == 'dev'
+Requires-Dist: ruff<1.0,>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ldapc
+
+A Python CLI tool for querying and managing LDAP directories. Provides a simple subcommand interface to list, search, get, add, and delete users and groups, with persistent configuration and secure credential storage via the OS keychain.
+
+## Features
+
+- List all users or groups
+- Search users by name/uid, groups by name (case-insensitive substring)
+- Get detailed info on a specific user or group
+- Add and delete users and groups
+- Manage group membership (add/remove users from groups)
+- Text, JSON, and YAML output formats
+- Persistent configuration in `~/.ldapc/config.yaml`
+- Secure credential storage via OS keychain
+- TLS-secured connections with optional certificate verification skip
+- Debug logging for troubleshooting
+
+## Installation
+
+```bash
+# From PyPI
+pip install ldap-cli
+
+# From source (editable, with dev deps)
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```bash
+# Configure (host, base DN, bind DN, password)
+ldapc configure
+
+# List all users
+ldapc list users
+
+# Search for a user
+ldapc search user john
+
+# Get user details in YAML
+ldapc get user jdoe --yaml
+
+# Skip SSL verification (self-signed certs)
+ldapc list users --skip-ssl-verify
+```
+
+## Usage
+
+### Configure
+
+```bash
+ldapc configure
+```
+
+Prompts for LDAP host URL, base DN, bind DN, and password. Config is stored in `~/.ldapc/config.yaml`; password goes to the OS keychain.
+
+### List
+
+```bash
+ldapc list users          # all users
+ldapc list groups         # all groups
+```
+
+### Search
+
+```bash
+ldapc search user john    # users matching "john" (case-insensitive)
+ldapc search group admin  # groups matching "admin"
+```
+
+### Get
+
+```bash
+ldapc get user jdoe       # exact user lookup
+ldapc get group devs      # exact group lookup
+```
+
+### Add / Delete
+
+```bash
+ldapc add user newuser
+ldapc add group newgroup
+ldapc delete user olduser
+ldapc delete group oldgroup
+```
+
+### Group Membership
+
+```bash
+ldapc user add group jdoe developers      # add user to group
+ldapc user remove group jdoe developers   # remove user from group
+```
+
+### Output Formats
+
+```bash
+ldapc list users --json   # JSON output
+ldapc list users --yaml   # YAML output (simplified, human-friendly)
+```
+
+### Global Flags
+
+These flags can appear after any subcommand:
+
+| Flag | Env Var | Description |
+|------|---------|-------------|
+| `--debug` | — | Enable debug logging to stderr |
+| `--skip-ssl-verify` | `LDAPC_SKIP_SSL_VERIFY=1` | Skip TLS certificate verification |
+| `--json` | — | Output as JSON |
+| `--yaml` | — | Output as simplified YAML |
+
+### Help
+
+```bash
+ldapc --help          # top-level help
+ldapc get --help      # subcommand help
+ldapc --version       # show version
+```
+
+### Documentation
+
+```bash
+ldapc --docs                          # list available doc files
+ldapc --docs README.md                # render README as rich text
+ldapc --docs README.md --page         # render with paging
+ldapc --docs README.md --markdown     # output raw markdown
+ldapc --docs docs/README.md --page    # view docs/README.md with paging
+```
+
+## Running Tests
+
+```bash
+pip install -e ".[dev]"
+python3 -m pytest tests/ -v
+```
+
+With coverage:
+
+```bash
+python3 -m pytest tests/ --cov=ldapc --cov-report=term-missing
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

ldap_cli-0.2.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+CHANGELOG.md,sha256=OYKeeRfc8AYsFLXfoDu62BwXNbeQgNuK1RlgrT_IInM,2080
+README.md,sha256=nbc8MTx30j9_2bE-URuofmpHyrmiEoYEHO9-hiMpSKc,3247
+.kiro/specs/ldap-cli/design.md,sha256=koYsCnQvNuuEj5xgJSqFABkwPFxrEz0dcHkOjIkH-S8,13482
+.kiro/specs/ldap-cli/requirements.md,sha256=xFScCYTZxif-2cYPPN1HIxzCrt8qu9gm1bGjTcH8NO4,7514
+.kiro/specs/ldap-cli/tasks.md,sha256=Z9gBfveLGUQYd_LQUFQjRRrrFNidE8-Y5JKPlcDJYsU,13605
+docs/reference.md,sha256=924U-gzlWNtfUHTIqftm8TVnnSwzlGXNUnZ2174qXjI,4492
+ldapc/__init__.py,sha256=8ntPgJlmCUqN9NCmLQVud9Mdmn0REdE0JYmogK0ZYNw,154
+ldapc/_version.py,sha256=mIgpETlDjKiEIAT1QDogOA_05_j0D8qmqQQ6V_WUlNg,648
+ldapc/cli.py,sha256=Ti0iUsFi9fHsQaN9f2_SjDQ_sX-a3-jGKchjgMKddeE,15830
+ldapc/config.py,sha256=pJo8VwTQcxL-Rb4-h9s87BfhUMYGRe4wPYnoab-lYUo,5126
+ldapc/exceptions.py,sha256=i898J3IUMbWj9MMHhMnezVZneqeB_KPgNOrpZGDN7aQ,969
+ldapc/formatter.py,sha256=YXbhrI0x0zQ7pcbm_cuPyrwsGL-VauyqcK27Y7N1D0c,7724
+ldapc/ldap_client.py,sha256=FSQTEWSIWYSBcPJkHMSqdnZLVx3CWMhKRlgFtLOJDU4,18177
+ldap_cli-0.2.0.dist-info/METADATA,sha256=ivLrjV6Basjoe2jkHjpBTsjI-4BrlBTIuezlW-_Gd9E,4434
+ldap_cli-0.2.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+ldap_cli-0.2.0.dist-info/entry_points.txt,sha256=D6nHTNes2NRHTR0bA633sFT4HYbB1Ot3Roeg1WYRS0M,41
+ldap_cli-0.2.0.dist-info/licenses/LICENSE,sha256=UMcMnj-XOQ0ZDOJqJrBnb-BjKOQjvm0CZcskx7k0_H8,1067
+ldap_cli-0.2.0.dist-info/RECORD,,

ldap_cli-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

ldap_cli-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ldapc = ldapc.cli:main

ldap_cli-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Topaz Bott
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ldapc/__init__.py

@@ -0,0 +1,7 @@
+"""LDAP CLI tool for querying LDAP directories."""
+
+from __future__ import annotations
+
+from ldapc._version import __version__
+
+__all__ = ['__version__']

ldapc/_version.py

@@ -0,0 +1,23 @@
+"""Version information for ldapc package."""
+
+from __future__ import annotations
+
+import os
+
+
+def get_version() -> str:
+    """Extract the latest version from CHANGELOG.md.
+
+    Returns:
+        str: Version string from the first non-unreleased entry in CHANGELOG.md,
+            or 'unknown' if not found.
+    """
+    changelog = os.path.join(os.path.dirname(__file__), '..', 'CHANGELOG.md')
+    with open(changelog, encoding='utf8') as f:
+        for line in f:
+            if line.startswith('## [') and 'unreleased' not in line.lower():
+                return line.split(']')[0].split('[')[1]
+    return 'unknown'
+
+
+__version__ = get_version()