{"id":16157078,"url":"https://github.com/charlesrocket/essential-collection","last_synced_at":"2025-04-10T17:36:15.029Z","repository":{"id":156664951,"uuid":"619967395","full_name":"charlesrocket/essential-collection","owner":"charlesrocket","description":null,"archived":false,"fork":false,"pushed_at":"2024-12-19T15:10:40.000Z","size":420,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"trunk","last_synced_at":"2025-03-24T15:11:22.755Z","etag":null,"topics":["ansible","dotfiles","git"],"latest_commit_sha":null,"homepage":"https://charlesrocket.github.io/essential-collection/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/charlesrocket.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-27T19:11:39.000Z","updated_at":"2024-12-19T15:07:55.000Z","dependencies_parsed_at":"2023-12-03T22:22:19.182Z","dependency_job_id":"7bb0b862-a689-4d53-a46b-13f9e212e229","html_url":"https://github.com/charlesrocket/essential-collection","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlesrocket%2Fessential-collection","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlesrocket%2Fessential-collection/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlesrocket%2Fessential-collection/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/charlesrocket%2Fessential-collection/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/charlesrocket","download_url":"https://codeload.github.com/charlesrocket/essential-collection/tar.gz/refs/heads/trunk","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248262034,"owners_count":21074230,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","dotfiles","git"],"created_at":"2024-10-10T01:48:03.472Z","updated_at":"2025-04-10T17:36:15.010Z","avatar_url":"https://github.com/charlesrocket.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# essential-collection\n[![galaxy](https://img.shields.io/badge/dynamic/json?style=flat\u0026label=galaxy\u0026prefix=v\u0026url=https://galaxy.ansible.com/api/v3/collections/charlesrocket/essential/\u0026query=highest_version.version)](https://galaxy.ansible.com/ui/repo/published/charlesrocket/essential/)\n[![molecule](https://github.com/charlesrocket/essential_collection/actions/workflows/ci.yml/badge.svg?branch=trunk\u0026event=push)](https://github.com/charlesrocket/essential_collection/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/gh/charlesrocket/essential-collection/branch/trunk/graph/badge.svg)](https://codecov.io/gh/charlesrocket/essential-collection)\n\n### Install\n\n`requirements.yml`:\n\n```yaml\ncollections:\n  - name: charlesrocket.essential\n```\n\n## `dotfiles`\n#### Requirements\n`git` on managed machines\n\n### Example\n\n```yaml\n- name: Playbook\n  hosts: all\n\n  roles:\n    - charlesrocket.essential.dotfiles\n```\n\n### Set variables\n\n```yaml\ndotfiles_repo: \"https://github.com/charlesrocket/dotfiles.git\" # dotfiles\ndotfiles_repo_version: openbsd # branch to track\ndotfiles_repo_accept_newhostkey: false # StrictHostKeyChecking=accept-new\ndotfiles_repo_force: false # force git clone\ndotfiles_repo_local_destination: \"~/git/dotfiles\" # local repo path\ndotfiles_home: \"~\" # local dotfiles path\ndotfiles_files: # files to track\n  - .config/mc/ini\n  - .zshrc\n```\n\n## `git`\n### Example\n\n```yaml\n- name: Playbook\n  hosts: all\n\n  roles:\n    - charlesrocket.essential.git\n```\n\n### Credential helper\n\nDefine the following variables to deploy the credential helper:\n\n```yaml\ngit_repo_destination: \"~/gitlab/git\" # git repository destination\ngit_helper_directory: \"~/bin\" # helper directory\ngit_helper: [\"netrc\"]\n```\n\n* Add `git_repo_shallow: true` to use shallow clone.\n* Add `git_repo_force: true` to override local modifications.\n\n## `fetch_vars`\n\nInject variables from remote hosts:\n\n```yaml\n- name: Playbook\n  hosts: all\n\n  tasks:\n    - name: Import user variables\n      include_role:\n        name: charlesrocket.essential.fetch_vars\n      vars:\n        fetch_vars_url: https://www.example.com/user_vars.yaml\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharlesrocket%2Fessential-collection","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcharlesrocket%2Fessential-collection","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcharlesrocket%2Fessential-collection/lists"}