lnp-devopscli 1.0.0__py3-none-any.whl

dc_cli/main.py

@@ -0,0 +1,54 @@
+"""Entry point do CLI dc - DevOps CLI."""
+
+from __future__ import annotations
+
+import importlib
+from pathlib import Path
+
+import click
+
+from . import __version__
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="devopscli")
+def cli():
+    """DevOps CLI — ferramentas DevOps para LNP Consulting TI."""
+
+
+def _auto_register_groups():
+    """Auto-discover e registra command groups de groups/.
+
+    Convencao: cada arquivo groups/<nome>.py deve exportar <nome>_group.
+    Exemplo: groups/gl.py exporta gl_group.
+    """
+    groups_dir = Path(__file__).parent / "groups"
+
+    for py_file in sorted(groups_dir.glob("*.py")):
+        if py_file.name.startswith("_"):
+            continue
+
+        module_name = py_file.stem
+        expected_name = f"{module_name}_group"
+
+        try:
+            module = importlib.import_module(
+                f".groups.{module_name}", package=__package__
+            )
+            group = getattr(module, expected_name, None)
+
+            if group and isinstance(group, (click.Group, click.Command)):
+                cli.add_command(group)
+        except Exception as e:
+            click.echo(f"[ERRO] Falha ao carregar grupo '{module_name}': {e}", err=True)
+
+
+_auto_register_groups()
+
+
+def main():
+    cli(prog_name="devopscli")
+
+
+if __name__ == "__main__":
+    main()

dc_cli/utils/config.py

@@ -0,0 +1,83 @@
+"""Utilitarios de configuracao: .env, config.yaml, workspace root."""
+
+from __future__ import annotations
+
+import os
+import sys
+from pathlib import Path
+
+import yaml
+
+
+def get_workspace_root() -> Path:
+    """Retorna raiz do projeto (3 niveis acima de utils/)."""
+    return Path(__file__).resolve().parent.parent.parent.parent
+
+
+def get_global_config_path() -> Path:
+    """Retorna path do config global (~/bin/config.yaml)."""
+    return Path.home() / "bin" / "config.yaml"
+
+
+def _strip_quotes(value: str) -> str:
+    """Remove aspas simples ou duplas que envolvem o valor."""
+    if len(value) >= 2 and value[0] == value[-1] and value[0] in ('"', "'"):
+        return value[1:-1]
+    return value
+
+
+def parse_env_line(line: str) -> tuple[str, str] | None:
+    """Parseia uma linha de .env e retorna (key, value) ou None."""
+    line = line.strip()
+    if not line or line.startswith("#") or "=" not in line:
+        return None
+    key, _, value = line.partition("=")
+    key = key.strip()
+    value = _strip_quotes(value.strip())
+    if not key:
+        return None
+    return key, value
+
+
+def load_dotenv() -> None:
+    """Carrega variaveis do .env do workspace-personal (se existir)."""
+    env_file = Path.home() / "workspace-personal" / ".env"
+    if not env_file.exists():
+        env_file = get_workspace_root() / ".env"
+    if not env_file.exists():
+        return
+    with open(env_file) as f:
+        for line in f:
+            parsed = parse_env_line(line)
+            if not parsed:
+                continue
+            key, value = parsed
+            if key not in os.environ:
+                os.environ[key] = value
+
+
+def load_config() -> dict:
+    """Carrega config.yaml completo, retorna dict."""
+    import click
+
+    config_path = get_global_config_path()
+    if not config_path.exists():
+        config_path = get_workspace_root() / "config.yaml"
+    if not config_path.exists():
+        click.echo("[ERRO] config.yaml nao encontrado.", err=True)
+        sys.exit(1)
+
+    with open(config_path) as f:
+        return yaml.safe_load(f) or {}
+
+
+def get_section(name: str) -> dict:
+    """Retorna secao do config (ex: 'gl' -> config['gl'])."""
+    import click
+
+    config = load_config()
+    section = config.get(name)
+    if not section:
+        click.echo(f"[ERRO] Secao '{name}' nao encontrada no config.yaml.", err=True)
+        sys.exit(1)
+    return section

dc_cli/utils/gitlab.py

@@ -0,0 +1,165 @@
+"""GitLab API helper — wrapper fino para requests."""
+
+from __future__ import annotations
+
+from typing import Any, cast
+
+import click
+import requests
+
+
+class GitLabAPI:
+    """Cliente para a API do GitLab."""
+
+    def __init__(self, host: str, token: str):
+        self.host = host.rstrip("/")
+        self.token = token
+        self.session = requests.Session()
+        self.session.headers.update({"PRIVATE-TOKEN": token})
+
+    def _url(self, path: str) -> str:
+        return f"{self.host}/api/v4{path}"
+
+    def get(self, path: str, **params) -> Any:
+        """GET request para a API do GitLab."""
+        resp = self.session.get(self._url(path), params=params)
+        resp.raise_for_status()
+        return resp.json()
+
+    def post(self, path: str, **data) -> dict[str, Any]:
+        """POST request para a API do GitLab."""
+        resp = self.session.post(self._url(path), json=data)
+        resp.raise_for_status()
+        return resp.json()
+
+    def delete(self, path: str) -> None:
+        """DELETE request para a API do GitLab."""
+        resp = self.session.delete(self._url(path))
+        resp.raise_for_status()
+
+    def search_groups(self, search: str) -> list[dict[str, Any]]:
+        """Busca grupos pelo nome/path."""
+        return cast(
+            list[dict[str, Any]], self.get("/groups", search=search, per_page=20)
+        )
+
+    def search_projects(self, search: str) -> list[dict[str, Any]]:
+        """Busca projetos pelo nome/path."""
+        return cast(
+            list[dict[str, Any]],
+            self.get("/projects", search=search, simple=True, per_page=20),
+        )
+
+    def resolve_group_id(self, group: str) -> int:
+        """Resolve group_id a partir de ID numerico ou path.
+
+        Aceita:
+          - "12345" -> retorna 12345
+          - "lnp-consulting-ti" -> busca e retorna o ID
+          - "lnp-consulting-ti/saas" -> busca e retorna o ID
+        """
+        if group.isdigit():
+            return int(group)
+
+        # Tentar buscar pelo path exato via URL-encoded path
+        try:
+            encoded = group.replace("/", "%2F")
+            result = cast(dict[str, Any], self.get(f"/groups/{encoded}"))
+            return result["id"]
+        except requests.HTTPError:
+            pass
+
+        # Fallback: buscar pelo nome
+        groups = self.search_groups(group)
+        for g in groups:
+            if g["full_path"] == group or g["path"] == group:
+                return g["id"]
+
+        if groups:
+            click.echo(
+                f"[!] Grupo exato '{group}' nao encontrado. Resultados parciais:"
+            )
+            for g in groups[:5]:
+                click.echo(f"    {g['full_path']} (id: {g['id']})")
+
+        raise click.ClickException(f"Grupo '{group}' nao encontrado.")
+
+    def create_deploy_token(
+        self, group_id: int, name: str, scopes: list[str]
+    ) -> dict[str, Any]:
+        """Cria deploy token no grupo."""
+        return self.post(
+            f"/groups/{group_id}/deploy_tokens",
+            name=name,
+            scopes=scopes,
+        )
+
+    def list_deploy_tokens(self, group_id: int) -> list[dict[str, Any]]:
+        """Lista deploy tokens do grupo."""
+        return cast(
+            list[dict[str, Any]],
+            self.get(f"/groups/{group_id}/deploy_tokens", per_page=100),
+        )
+
+    def revoke_deploy_token(self, group_id: int, token_id: int) -> None:
+        """Revoga deploy token do grupo."""
+        self.delete(f"/groups/{group_id}/deploy_tokens/{token_id}")
+
+    def resolve_project_id(self, project: str) -> int:
+        """Resolve project_id a partir de ID numerico ou path."""
+        if project.isdigit():
+            return int(project)
+
+        try:
+            encoded = project.replace("/", "%2F")
+            result = cast(dict[str, Any], self.get(f"/projects/{encoded}"))
+            return result["id"]
+        except requests.HTTPError:
+            pass
+
+        projects = self.search_projects(project)
+        for p in projects:
+            if p.get("path_with_namespace") == project or p.get("path") == project:
+                return p["id"]
+
+        if projects:
+            click.echo(
+                f"[!] Projeto exato '{project}' nao encontrado. Resultados parciais:"
+            )
+            for p in projects[:5]:
+                click.echo(
+                    f"    {p.get('path_with_namespace', '?')} (id: {p.get('id', '?')})"
+                )
+
+        raise click.ClickException(f"Projeto '{project}' nao encontrado.")
+
+    def create_project_access_token(
+        self,
+        project_id: int,
+        name: str,
+        scopes: list[str],
+        access_level: int | None = None,
+        expires_at: str | None = None,
+    ) -> dict[str, Any]:
+        """Cria project access token."""
+        payload: dict[str, Any] = {
+            "name": name,
+            "scopes": scopes,
+        }
+        if access_level is not None:
+            payload["access_level"] = access_level
+        if expires_at:
+            payload["expires_at"] = expires_at
+
+        return self.post(f"/projects/{project_id}/access_tokens", **payload)
+
+    def list_project_access_tokens(self, project_id: int) -> list[dict[str, Any]]:
+        """Lista project access tokens do projeto."""
+        return cast(
+            list[dict[str, Any]],
+            self.get(f"/projects/{project_id}/access_tokens", per_page=100),
+        )
+
+    def revoke_project_access_token(self, project_id: int, token_id: int) -> None:
+        """Revoga project access token do projeto."""
+        self.delete(f"/projects/{project_id}/access_tokens/{token_id}")

lnp_devopscli-1.0.0.dist-info/METADATA

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: lnp-devopscli
+Version: 1.0.0
+Summary: DevOps CLI — workspace sync (GDrive, git, GPG, systemd timers) + GitLab/Bitwarden tooling
+Author-email: Lucas Neves Pires <npires.lucas@gmail.com>
+License: MIT
+Project-URL: Homepage, https://gitlab.com/lnp-consulting-ti/devops/devops-cli
+Project-URL: Repository, https://gitlab.com/lnp-consulting-ti/devops/devops-cli
+Project-URL: Issues, https://gitlab.com/lnp-consulting-ti/devops/devops-cli/-/issues
+Keywords: devops,workspace-sync,rclone,gdrive,gitlab,bitwarden,systemd
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: requests>=2.28
+
+# lnp-devopscli
+
+DevOps CLI for workspace sync (Google Drive + git + GPG + systemd timers) and
+GitLab/Bitwarden tooling.
+
+## Install
+
+### Via PyPI (recommended)
+
+```bash
+pipx install lnp-devopscli
+# or
+pip install --user lnp-devopscli
+```
+
+Provides two equivalent commands: `devopscli` and `dc`.
+
+### From source
+
+```bash
+git clone https://gitlab.com/lnp-consulting-ti/devops/devops-cli.git ~/bin/devops-cli
+cd ~/bin/devops-cli && make setup
+```
+
+### Bootstrap on a new PC
+
+For a full workspace bootstrap (rclone + GPG + git-crypt + 10 repos + systemd
+timers), use the public bootstrap launcher:
+
+```bash
+bash <(curl -fsSL https://gitlab.com/-/snippets/6003334/raw/main/bootstrap.sh)
+```
+
+See [MIGRATION-RUNBOOK.md](https://gitlab.com/lnpires/ai/workspace-personal/-/blob/main/MIGRATION-RUNBOOK.md)
+for the complete migration procedure.
+
+## Commands
+
+```bash
+devopscli ws sync             # full bidirectional sync (pull → git → push)
+devopscli ws push             # sync local → GDrive (13 categories)
+devopscli ws pull             # sync GDrive → local
+devopscli ws doctor           # health check (deps, configs, timers, repos)
+devopscli ws ai-sync          # git pull/commit/push for ai_workspaces
+devopscli ws repos-sync       # git pull/commit/push for repos_sync
+devopscli ws gpg-backup       # export GPG key + encrypt + send to GDrive
+devopscli ws gpg-restore      # download GPG key from GDrive + decrypt + import
+devopscli ws install-timers   # install systemd user timers (replaces cron)
+devopscli ws uninstall-timers # remove systemd timers
+```
+
+See `devopscli ws --help` for the full list.
+
+## Security
+
+The CLI is open source but never accesses your data without your credentials:
+
+- **Google OAuth** protects access to your GDrive (rclone config)
+- **GPG passphrase** protects the GPG key backup
+- **git-crypt** protects `.env` files inside synced repos
+- **GitLab/SSH keys** protect access to private repositories
+
+Anyone can `pip install` the CLI — but without your credentials, they cannot
+access your data.
+
+## Configuration
+
+Edit `~/bin/config.yaml` (synced via `ws push` step 7):
+
+```yaml
+ai_workspaces:
+  - name: "workspace-personal"
+    path: "~/workspace-personal"
+    clone_url: "git@gitlab.com:user/repo.git"
+    remote: "origin"
+    branch: "main"
+    auto_commit: true
+    commit_message: "chore(auto-sync): snapshot via ws ai-sync"
+
+repos_sync:
+  - name: "devops-cli"
+    path: "~/bin/devops-cli"
+    clone_url: "git@gitlab.com:lnp-consulting-ti/devops/devops-cli.git"
+    remote: "origin"
+    branch: "main"
+    auto_commit: true
+    commit_message: "chore(auto-sync): snapshot via ws repos-sync"
+```
+
+## Release
+
+To publish a new version to PyPI:
+
+```bash
+# 1. Bump version in pyproject.toml
+git commit -am "chore(release): v1.0.1"
+
+# 2. Tag and push
+git tag v1.0.1
+git push origin main v1.0.1
+```
+
+The GitLab CI pipeline auto-publishes when a tag matches `v*.*.*`.
+
+Setup once: add `PYPI_TOKEN` to GitLab CI/CD Variables (Settings > CI/CD).
+
+## License
+
+MIT

lnp_devopscli-1.0.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+dc_cli/__init__.py,sha256=V8NQxHA6heIkRMo_WVrkPrlazyK21jUDcGWwRuNgQzs,61
+dc_cli/main.py,sha256=h30wx8jGTZ_qOpYtMzfTUB2nW3VKePcXRSoLYUOMWZ0,1326
+dc_cli/groups/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dc_cli/groups/bw.py,sha256=AACX6MSslPjlU2tHTX5FL8tDlHf4IzZtRTlxcnfvd5Q,12997
+dc_cli/groups/gl.py,sha256=d_OVtQOGRcPTQ2yJOwUiVbrcuBqiEOahrZ1i1_Jr4X0,9632
+dc_cli/groups/ws.py,sha256=bRhOz6ar0DgZX8pd-hgwfML_r3S101j_RnUAvpYlaWM,47147
+dc_cli/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dc_cli/utils/config.py,sha256=rnZmJqfd3vq0MoD5UFwzVVtJjQLw28aWS22RqxaxAag,2383
+dc_cli/utils/gitlab.py,sha256=yK0UuvYfwxgV1T6nJxo0iOm-pYQWZJ9sWkjl01Ko1sw,5577
+lnp_devopscli-1.0.0.dist-info/METADATA,sha256=Neg9EcLmTYgNbjRRP0w7vMNGn4AZpyiSD9-JSsvdoZI,4208
+lnp_devopscli-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+lnp_devopscli-1.0.0.dist-info/entry_points.txt,sha256=yvFR7YX57Mr_KtRiCA2muf61eVGV2ThFmXOu6O2jy0U,69
+lnp_devopscli-1.0.0.dist-info/top_level.txt,sha256=lddxuZKQNgGZHWu5I8IQX_PYOOYHfVQZpiBIeU2DYfc,7
+lnp_devopscli-1.0.0.dist-info/RECORD,,

lnp_devopscli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

lnp_devopscli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+dc = dc_cli.main:main
+devopscli = dc_cli.main:main

lnp_devopscli-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+dc_cli