update README

Author: Garcia6l20

README.md

@@ -4,12 +4,28 @@
 
 _dan_ is a build system inspired from _GNU make_, _cmake_, _meson_, ... but only in python.
 
+It is mostly designed to be easy to use, it comes with its [vscode extension](https://github.com/Garcia6l20/dan-vscode) available on the [marketplace](https://marketplace.visualstudio.com/items?itemName=garcia6l20.dan).
+
+It also provide a packaging system called [dan.io](https://github.com/Garcia6l20/dan.io),
+that will fetch and build 3rd party libraries.
+
+## Install
+
+_dan_ is available on pip:
+
+```bash
+pip install dan-build
+```
+
 ## Features
 
-- Generators:
+### Generators
 
 Generators are python functions that generates an output:
+
 ```python
+from dan import generator
+
 @generator(output='hello.txt', dependencies=['source.jinja'])
 def hello(self):
     env = jinja2.Environment(loader=jinja2.FileSystemLoader(self.source_path))
@@ -18,6 +34,7 @@ def hello(self):
 ```
 
 They can be async:
+
 ```python
 @generator(output='hello-cpy.txt', dependencies=[hello])
 async def hello_cpy(self):
@@ -27,8 +44,60 @@ async def hello_cpy(self):
             await dst.write(await src.read())
 ```
 
+### C/CXX
 
-## Cli usage:
+#### Libraries/Executables
+
+    ```python
+    from dan.cxx import Library, Executable
+    class MyLib(Library):
+        name = 'my-lib'
+        sources = ['src/my-lib.cpp']
+        public_includes = ['include']
+
+    class MyExe(Executable):
+        name = 'my-exe'
+        sources = ['src/main.cpp']
+        dependencies = [MyLib]
+
+    ```
+
+#### Packages
+    [dan.io](https://github.com/Garcia6l20/dan.io) is the main (default) package source repository (custom repositories are supported by editting _~/.dan/repositories.json_) [documentation comming soon].
+    ```python
+    class MyExe(Executable):
+        name = 'my-exe'
+        sources = ['src/main.cpp']
+        dependencies = ['boost:headers@dan.io >= 1.82']
+    ```
+
+## dan cli usage
+
+`dan` is the main executable to build your project, it can build, test, list targets/test, ...
+
+```bash
+dan --help
+Usage: dan [OPTIONS] COMMAND [ARGS]...
+
+Options:
+  --version           Show the version and exit.
+  -q, --quiet         Dont print informations (errors only)
+  -v, --verbose       Pring debug informations
+  -j, --jobs INTEGER  Maximum jobs
+  --help              Show this message and exit.
+
+Commands:
+  build            Build targets
+  clean            Clean generated stuff
+  code             VS-Code specific commands
+  configure        Configure dan project
+  install          Install targets
+  ls               Inspect stuff
+  run              Run executable(s)
+  scan-toolchains  Scan system toolchains
+  test             Run tests
+  uninstall        Uninstall previous installation
+```
 
 ### Toolchain scan
 
@@ -63,3 +132,54 @@ Settings:
 - *install.includes_prefix*: Includes installation prefix (default: include).
 - *install.data_prefix*: Data files installation prefix (default: share).
 - *install.project_prefix*: !!! NOT USED YET !!! Project prefix (default: None).
+
+
+## dan-io cli usage
+
+`dan-io` is a secondary utility to interract with package management system.
+
+```bash
+$ dan-io --help 
+Usage: dan-io [OPTIONS] COMMAND [ARGS]...
+
+Options:
+  --help  Show this message and exit.
+
+Commands:
+  ls      Inspect stuff
+  search  Search for NAME in repositories
+```
+
+```bash
+$ dan-io ls --help
+Usage: dan-io ls [OPTIONS] COMMAND [ARGS]...
+
+  Inspect stuff
+
+Options:
+  --help  Show this message and exit.
+
+Commands:
+  libraries     List available libraries
+  repositories  List available repositories
+  versions      Get LIBRARY's available versions
+```
+
+
+## Auto completion
+
+`bash` and `zsh` completions are currently supported:
+
+- bash:
+    ```bash
+    for script in ~/.local/etc/bash_completion.d/*.sh; do
+        source ${script}
+    done
+    ```
+
+- ksh:
+    ```ksh
+    for script in ~/.local/etc/ksh_completion.d/*.sh; do
+        source ${script}
+    done
+    ```

dan/cli/io.py

@@ -50,17 +50,20 @@ def cli():
 
 @cli.group()
 def ls():
+    """Inspect stuff"""
     pass
 
 
 @ls.command()
 async def repositories():
+    """List available repositories"""
     repos = await get_repositories()
     for repo in repos:
         click.echo(repo.name)
 
 @ls.command()
 async def libraries():
+    """List available libraries"""
     repos = await get_repositories()
     for repo in repos:
         for name, lib in repo.installed.items():
@@ -69,6 +72,7 @@ async def libraries():
 @ls.command()
 @click.argument('LIBRARY')
 async def versions(library: str):
+    """Get LIBRARY's available versions"""
     package, library, repository = parse_package(library)
     repo = await get_repository(repository)
     if repo is None:
@@ -98,6 +102,7 @@ async def versions(library: str):
 @cli.command()
 @click.argument('NAME')
 async def search(name):
+    """Search for NAME in repositories"""
     name = f'*{name}*'
     repos = await get_repositories()
     for repo in repos:

dan/cli/main.py

@@ -73,6 +73,7 @@ def make(self):
 
 
 @click.group()
+@click.version_option(package_name='dan-build')
 @click.option('--quiet', '-q', is_flag=True,
               help='Dont print informations (errors only)')
 @click.option('--verbose', '-v', is_flag=True,