Added apt clean-up, updated Readme and defaults

README.md

@@ -1,19 +1,23 @@
 ## Ansibles - apt [![Build Status](https://travis-ci.org/Ansibles/apt.png)](https://travis-ci.org/Ansibles/apt)
 
-Update and manage the apt-cache
+Ansible role which executes apt-get update to ensure the local APT package cache is up to date. At the same time, it cleans it from packages and .deb files which are no longer needed.
+
 
 #### Variables
 
 ```yaml
-apt_cache_valid_time: # time (in seconds) that the apt cache stays valid
-apt_install_recommends: # true/false - whether or not to install the "recommended" packages
-apt_install_suggests: # true/false - whether or not to install the "suggested" packages
+apt_reset_source_list: no         # reset the /etc/apt/sources.list to the default
+apt_cache_valid_time: 3600        # Time (in seconds) the apt cache stays valid
+apt_install_recommends: yes       # whether or not to install the "recommended" packages
+apt_install_suggests: yes         # whether or not to install the "suggested" packages
 ```
 
+
 #### License
 
 Licensed under the MIT License. See the LICENSE file for details.
 
+
 #### Feedback, bug-reports, requests, ...
 
 Are [welcome](https://github.com/ansibles/apt/issues)!

defaults/main.yml

@@ -1,5 +1,6 @@
 # file: apt/defaults/main.yml
 
-apt_cache_valid_time: 3600
-apt_install_recommends: true
-apt_install_suggests: true
+apt_reset_source_list: no         # reset the /etc/apt/sources.list to the default
+apt_cache_valid_time: 3600        # Time (in seconds) the apt cache stays valid
+apt_install_recommends: yes       # whether or not to install the "recommended" packages
+apt_install_suggests: yes         # whether or not to install the "suggested" packages

meta/main.yml

@@ -2,7 +2,7 @@
 
 galaxy_info:
   author: pjan vandaele
-  description: Update and manage the apt-cache
+  description: Manages apt and executes apt-get update to ensure the local APT package cache is up to date.
   min_ansible_version: 1.4
   license: MIT
   platforms:

tasks/main.yml

@@ -1,27 +1,34 @@
 # file: apt/tasks/main.yml
 
-- name: Aptitude | Update the sources list (/etc/apt/sources.list)
+- name: APT | Reset the sources list (/etc/apt/sources.list)
   copy:
     src: etc_apt_sources.list
     dest: /etc/apt/sources.list
     owner: root
     group: root
     mode: 0644
+  when: apt_reset_source_list
 
-- name: Aptitude | Update the apt cache
+- name: APT | Update the apt cache
   apt:
     update_cache: yes
     cache_valid_time: "{{apt_cache_valid_time}}"
 
-- name: Aptitude | Update the general configuration (/etc/apt/apt.conf.ds/10general)
+- name: APT | Remove packages that are no longer needed for dependencies
+  shell: apt-get -y autoremove
+
+- name: APT | Remove .deb files for packages no longer on your system
+  shell: apt-get -y autoclean
+
+- name: APT | Update the general configuration (/etc/apt/apt.conf.ds/10general)
   template:
     src: etc_apt_apt.conf.d_10general.j2
     dest: /etc/apt/apt.conf.d/10general
     owner: root
     group: root
     mode: 0644
 
-- name: Aptitude | Make sure the required packages are installed
+- name: APT | Make sure the required packages are installed
   apt:
     pkg: "{{item}}"
     state: present

templates/etc_apt_apt.conf.d_10general.j2

@@ -1,4 +1,4 @@
-APT::Install-Recommends "{{ apt_install_recommends }}";
-APT::Install-Suggests "{{ apt_install_suggests }}";
+APT::Install-Recommends "{{apt_install_recommends}}";
+APT::Install-Suggests "{{apt_install_suggests}}";
 
 APT::Get::Show-Upgraded "true";