better colors management and docs

Author: Matars

README.md

@@ -185,16 +185,115 @@ gitfetch/
 
 Configuration file location: `~/.config/gitfetch/gitfetch.conf`
 
-Example configuration:
+The configuration file is automatically created on first run and contains two main sections:
+
+### [DEFAULT] Section
 
 ```ini
 [DEFAULT]
 username = yourusername
-cache_expiry_hours = 6
+cache_expiry_hours = 24
+```
+
+- `username`: Your default GitHub username (automatically set from authenticated GitHub CLI user)
+- `cache_expiry_hours`: How long to keep cached data (default: 24 hours)
+
+### [COLORS] Section
+
+gitfetch supports extensive color customization. All colors use ANSI escape codes.
+
+```ini
+[COLORS]
+reset = \033[0m
+bold = \033[1m
+dim = \033[2m
+red = \033[91m
+green = \033[92m
+yellow = \033[93m
+blue = \033[94m
+magenta = \033[95m
+cyan = \033[96m
+white = \033[97m
+orange = \033[38;2;255;165;0m
+accent = \033[1m
+header = \033[38;2;118;215;161m
+muted = \033[2m
+0 = \033[48;5;238m
+1 = \033[48;5;28m
+2 = \033[48;5;34m
+3 = \033[48;5;40m
+4 = \033[48;5;82m
+```
+
+#### Color Reference
+
+- **Text Styles**:
+
+  - `reset`: Reset all formatting
+  - `bold`: Bold text
+  - `dim`: Dimmed text
+  - `accent`: Accent styling (bold)
+
+- **Basic Colors**:
+
+  - `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, `white`: Standard ANSI colors
+  - `orange`: Custom orange color
+
+- **UI Elements**:
+
+  - `header`: Section headers and main display text
+  - `muted`: Separators and underlines
+
+- **Contribution Graph**:
+  - `0`: No contributions (lightest)
+  - `1`: 1-2 contributions
+  - `2`: 3-6 contributions
+  - `3`: 7-12 contributions
+  - `4`: 13+ contributions (darkest)
+
+#### Customizing Colors
+
+To change colors, edit `~/.config/gitfetch/gitfetch.conf` and modify the ANSI escape codes:
+
+**Example: Change header color to blue**
+
+```ini
+header = \033[94m
+```
+
+**Example: Change contribution graph colors to a purple theme**
+
+```ini
+0 = \033[48;5;235m  # Dark gray for no contributions
+1 = \033[48;5;60m   # Dark purple
+2 = \033[48;5;62m   # Medium purple
+3 = \033[48;5;64m   # Light purple
+4 = \033[48;5;66m   # Bright purple
 ```
 
+**Common ANSI Color Codes**:
+
+- `\033[91m` = Bright Red
+- `\033[92m` = Bright Green
+- `\033[93m` = Bright Yellow
+- `\033[94m` = Bright Blue
+- `\033[95m` = Bright Magenta
+- `\033[96m` = Bright Cyan
+- `\033[97m` = Bright White
+
+**Background Colors** (for contribution blocks):
+
+- `\033[48;5;{color_code}m` where color_code is 0-255 (256-color palette)
+
+Changes take effect immediately - no restart required.
+
+## Caching
+
 Cache database location: `~/.config/gitfetch/cache.db`
 
+This will be moved in the future to a more standard location based on OS conventions.
+This will also come with a gitfetch --migrate-cache command to migrate existing cache to the new location.
+
 ## Why GitHub CLI?
 
 Using the GitHub CLI (gh) instead of direct API calls provides several benefits:

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gitfetch"
-version = "1.0.16"
+version = "1.0.17"
 description = "A neofetch-style CLI tool for GitHub statistics"
 readme = "README.md"
 requires-python = ">=3.8"

src/gitfetch/config.py

@@ -49,7 +49,8 @@ def _load_config(self) -> None:
         if self.CONFIG_FILE.exists():
             self.config.read(self.CONFIG_FILE)
             if "COLORS" in self.config:
-                self.config._sections['COLORS'] = {**default_colors, **self.config._sections['COLORS']}
+                self.config._sections['COLORS'] = {
+                    **default_colors, **self.config._sections['COLORS']}
             else:
                 self.config._sections['COLORS'] = default_colors
         else:
@@ -58,9 +59,12 @@ def _load_config(self) -> None:
                 'username': '',
                 'cache_expiry_hours': '24'
             }
-            self.config._sections['COLORS'] = default_colors
-        for k,v in self.config._sections['COLORS'].items():
-            self.config._sections['COLORS'][k] = v.encode('utf-8').decode('unicode_escape')
+            self.config.add_section('COLORS')
+            for key, value in default_colors.items():
+                self.config.set('COLORS', key, value)
+        for k, v in self.config._sections['COLORS'].items():
+            self.config._sections['COLORS'][k] = v.encode(
+                'utf-8').decode('unicode_escape')
 
     def get_default_username(self) -> Optional[str]:
         """