docs: add usage

- update pyproject description

Author: phthallo

README.md

@@ -5,26 +5,64 @@ https://github.com/phthallo/pyflagoras/assets/84078890/5440a9d3-2c49-4200-a52a-f
 
 ## Installation 
 You can install this package from [pypi.org](https://pypi.org)! Open a terminal and run the following:
-```python
+```
 pip install pyflagoras
 ```
 
+## Usage
+```
+$ pyflagoras --help
+usage: pyflagoras [-h] [-f FLAG] [-n NAME] [-v] image
+
+A command line interface tool to generate pride flags from images.
+
+positional arguments:
+  image                 Path to the image to generate a flag from.
+                        Examples:
+                            image.png
+                            foo/bar/image.jpg
+
+options:
+  -h, --help            show this help message and exit
+  -f FLAG, --flag FLAG  The ID (<flag_name>_<year_of_release>) of the flag to generate.
+                        Examples:
+                            intersexInclusive_2021
+                            nonbinary_2014
+                        Default:
+                            progressPride_2018
+                        See https://github.com/phthallo/pyflagoras/blob/main/dev/flag_list.txt for a complete list of flag IDs.
+  -n NAME, --name NAME  Customise the name of the final .svg. The following can be used as part of the file name:
+                        Format placeholders:
+                            {n}: File name (e.g celeste_classic)
+                            {N}: File name (full) (e.g celeste_classic.png)
+                            {f}: Flag name (e.g Progress Pride)
+                            {F}: Flag ID (e.g progressPride_2018)
+                        Examples:
+                            pyflagoras celeste_classic.png -n "{f}_{n}" [renders Progress Pride_celeste_classic.svg]
+                        Default:
+                            {n}_{F} [renders celeste_classic_progressPride_2018.svg]
+
+  -v, --version         show the program's version number and exit
+
+Documentation, issues and more: https://github.com/phthallo/pyflagoras
+```
+
 ## Development
 Substitute `py` for `python3` as necessary.
 1. Clone the repository.
-    ```python
+    ```
     git clone https://github.com/phthallo/pyflagoras
     ```
 2. Install the build tool.
-    ```python
+    ```
     py -m pip install --upgrade build
     ```
 3. `cd` to the root of the repository and build the package.
-    ```python
+    ```
     py -m build
     ```
 4. Both the source distribution (`pyflagoras-x.x.x-tar.gz`) and the built distribution (`pyflagoras-x.x.x-py3-none-any.whl`) will be found under the `/dist` subdirectory. You can then install the wheel using:
-    ```python
+    ```bash
     py -m pip install dist/pyflagoras-x.x.x-py3-none-any.whl
     ```
 

pyproject.toml

@@ -15,7 +15,7 @@ dependencies = [
 authors = [
   { name="Annabel Quach", email="[email protected]" },
 ]
-description = "Generate pride flags from images"
+description = "A command line interface tool to generate pride flags from images."
 readme = "README.md"
 requires-python = ">=3.10"
 classifiers = [