Merge branch 'release-v1.3.0'

.ansible-lint

@@ -5,5 +5,6 @@ exclude_paths:
   - .cache/
   - ~/.cache/ansible-lint/
   - ~/.cache/ansible-compat/
+  - mkdocs.yml
 warn_list:
   - galaxy[version-incorrect]

.bumpversion.cfg

@@ -1,7 +1,7 @@
 [bumpversion]
 commit = True
 tag = False
-current_version = 1.2.0
+current_version = 1.3.0
 
 [bumpversion:file:pyproject.toml]
 search = version = "{current_version}"

.github/workflows/codeql-analysis.yml

@@ -27,18 +27,18 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/[email protected].1
+        uses: actions/[email protected].7
 
       # Initializes the CodeQL tools for scanning.
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@v2
+        uses: github/codeql-action/init@v3
         with:
           languages: ${{ matrix.language }}
 
       # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
       # If this step fails, then you should remove it and run the build manually (see below)
       - name: Autobuild
-        uses: github/codeql-action/autobuild@v2
+        uses: github/codeql-action/autobuild@v3
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v2
+        uses: github/codeql-action/analyze@v3

.github/workflows/docs.yml

@@ -0,0 +1,66 @@
+name: docs
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Build job
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/[email protected]
+
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install system deps
+        shell: bash
+        run: |
+          pip install poetry
+          pip install poetry-plugin-export
+          poetry config virtualenvs.in-project true
+          poetry install --only docs --sync
+
+      - name: Build docs
+        shell: bash
+        run: poetry run inv docs
+
+      - name: Setup Pages
+        uses: actions/[email protected]
+
+      - name: Upload artifact
+        uses: actions/[email protected]
+        with:
+          # Upload entire repository
+          path: 'site/'
+
+  # Deployment job
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/[email protected]

.github/workflows/pre-commit-autoupdate.yml

@@ -10,12 +10,12 @@ jobs:
     name: autoupdate
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/[email protected].1
+      - uses: actions/[email protected].7
         with:
           ref: develop
 
       - name: Set up Python 3.10
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: "3.10"
 
@@ -38,7 +38,7 @@ jobs:
       - name: Run pre-commit
         run: poetry run pre-commit run --all-files
 
-      - uses: peter-evans/create-pull-request@v5.0.2
+      - uses: peter-evans/create-pull-request@v7.0.2
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           branch: chore-update-pre-commit-hooks

.github/workflows/release.yml

@@ -10,7 +10,7 @@ jobs:
     name: Create Github Release
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/[email protected].1
+      - uses: actions/[email protected].7
 
       - name: Get version from tag
         id: tag_name
@@ -20,7 +20,7 @@ jobs:
 
       - name: Get Changelog Entry
         id: changelog_reader
-        uses: mindsers/[email protected].2
+        uses: mindsers/[email protected].3
         with:
           version: ${{ steps.tag_name.outputs.current_version }}
           path: ./CHANGELOG.md

.github/workflows/tests.yml

@@ -14,10 +14,10 @@ jobs:
     name: Linting
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/[email protected].1
+      - uses: actions/[email protected].7
 
       - name: Set up Python 3.10
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: "3.10"
 
@@ -47,10 +47,10 @@ jobs:
           - debian11
       fail-fast: true
     steps:
-      - uses: actions/[email protected].1
+      - uses: actions/[email protected].7
 
       - name: Set up Python 3.10
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: "3.10"
 

.pre-commit-config.yaml

@@ -5,11 +5,12 @@ default_install_hook_types:
   - post-merge
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v4.6.0
     hooks:
       - id: check-toml
       - id: check-json
       - id: check-yaml
+        args: ['--unsafe']
       - id: debug-statements
       - id: check-merge-conflict
       - id: pretty-format-json
@@ -19,28 +20,29 @@ repos:
       - id: trailing-whitespace
         exclude: .bumpversion.cfg
   - repo: https://github.com/timothycrosley/isort
-    rev: 5.12.0
+    rev: 5.13.2
     hooks:
       - id: isort
   - repo: https://github.com/psf/black
-    rev: 23.11.0
+    rev: 24.8.0
     hooks:
       - id: black
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.5
+    rev: v0.6.5
     hooks:
       - id: ruff
   - repo: https://github.com/python-poetry/poetry
-    rev: 1.7.0
+    rev: 1.8.0
     hooks:
       - id: poetry-check
       - id: poetry-install
   - repo: https://github.com/adrienverge/yamllint.git
-    rev: v1.33.0
+    rev: v1.35.1
     hooks:
       - id: yamllint
   - repo: https://github.com/ansible-community/ansible-lint.git
-    rev: v6.22.0
+    rev: v24.9.0
     hooks:
       - id: ansible-lint
-        files: \.(yaml|yml)$
+        stages:
+          - pre-commit

.safety-policy.yml

@@ -0,0 +1,12 @@
+version: '2.0'
+
+# Safety Security and License Configuration file
+security: # configuration for the `safety check` command
+    ignore-cvss-severity-below: 0 # A severity number between 0 and 10. Some helpful reference points: 9=ignore all vulnerabilities except CRITICAL severity. 7=ignore all vulnerabilities except CRITICAL
+    ignore-cvss-unknown-severity: False # True or False. We recommend you set this to False.
+    ignore-vulnerabilities: # Here you can list multiple specific vulnerabilities you want to ignore (optionally for a time period)
+        # We recommend making use of the optional `reason` and `expires` keys for each vulnerability that you ignore.
+        70612:
+            reason: we do not use the vulnerable function
+            expires: '2024-10-10'
+    continue-on-vulnerability-error: False # Suppress non-zero exit codes when vulnerabilities are found. Enable this in pipelines and CI/CD processes if you want to pass builds that have vulnerabilities

CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.0] - 2024-10-04
+### Added
+- Docs site.
+
+- MacOS Tools/Packages:
+    * Ubuntu Nerd Font.
+    * Ubuntu Mono Nerd Font.
+    * xkcd Nerd Font.
+    * xkcd-script Nerd Font.
+    * btop.
+
+- MacOS Apps:
+    * Discord.
+
+### Changed
+- MacOS Apps:
+    * WhatsApp.
+
+- MacOS Tools/Packages:
+    * Upgrade python versions.
+
+### Fixed
+- MacOS:
+    * brew doctor issues.
+    * pipx injected packages.
+
 ## [1.2.0] - 2023-11-16
 ### Added
 - MacOS Tools/Packages:
@@ -39,7 +65,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - First release.
 
-[Unreleased]: https://github.com/fedejaure/dev-setup/compare/v1.2.0...develop
+[Unreleased]: https://github.com/fedejaure/dev-setup/compare/v1.3.0...develop
+[1.3.0]: https://github.com/fedejaure/dev-setup/compare/v1.2.0...v1.3.0
 [1.2.0]: https://github.com/fedejaure/dev-setup/compare/v1.1.0...v1.2.0
 [1.1.0]: https://github.com/fedejaure/dev-setup/compare/v1.0.0...v1.1.0
 [1.0.0]: https://github.com/fedejaure/dev-setup/compare/releases/tag/v1.0.0

CONTRIBUTING.md

@@ -9,6 +9,7 @@ mostly guidelines, not rules. Use your best judgment, and feel free to propose c
 
 We take our open source community seriously and hold ourselves and other contributors to high standards of communication. By participating and contributing to this project, you agree to uphold our [Code of Conduct](CODE_OF_CONDUCT.md).
 
+
 ## Getting Started
 
 ### Requirements

LICENSE.rst → LICENSE.md

@@ -1,6 +1,5 @@
 
-MIT License
-===========
+# MIT License
 
 Copyright (c) 2022, Federico Jaureguialzo