arg-kiss

Create a simple yet useful command-line utility called 'FileSorter' using the 'arg-kiss' Python package. This tool will help users sort files in a directory based on various criteria such as file size, date modified, and extension. The goal is to demonstrate the simplicity and effectiveness of 'arg-kiss' for building command-line interfaces (CLIs).

### Project Overview
- **Name:** FileSorter
- **Purpose:** Sort files in a directory based on user-defined criteria.
- **Features:**
  - List all files in a given directory.
  - Sort files by size (smallest to largest or vice versa).
  - Sort files by date modified (oldest to newest or vice versa).
  - Filter files by file extension (e.g., only .txt files).
  - Display basic information about each file (name, size, last modified date).

### Steps to Build the Application
1. **Setup Environment:** Ensure Python 3.x is installed along with pip. Install 'arg-kiss' using pip:
   ```bash
   pip install arg-kiss
   ```
2. **Initialize Project Structure:** Create a directory named `FileSorter` and within it, create a file named `main.py`. This will be the main entry point of your application.
3. **Define CLI Options:** Use 'arg-kiss' to define command-line options for sorting files. For example, you could have options like `--sort-by`, `--filter-ext`, and `--directory`.
4. **Implement Sorting Logic:** Write functions to handle sorting based on different criteria (size, date, extension). These functions should read the directory specified by the user and then sort the files accordingly.
5. **Display Results:** After sorting, display the sorted list of files in a readable format. Include details such as file name, size, and last modified date.
6. **Test Your Application:** Test the application thoroughly by running it with different parameters to ensure it behaves as expected under various conditions.
7. **Documentation:** Write a README.md file explaining how to use the application, including examples of commands and expected output.

### Example Usage
- To list all files in a directory:
  ```bash
  python main.py --directory /path/to/directory
  ```
- To sort files by size:
  ```bash
  python main.py --directory /path/to/directory --sort-by size
  ```
- To filter files by extension:
  ```bash
  python main.py --directory /path/to/directory --filter-ext .txt
  ```

By following these steps, you'll create a practical and easy-to-use command-line utility that showcases the power of 'arg-kiss' for developing simple but effective CLIs.