lib_wraphandlers/README.md

# Webservices (wrap) Handlers Library

## Rust Libraries Collections for webservices ([warp](https://github.com/seanmonstar/warp)) handlers

Part of the following developments:

- [Zteron](https://rlung.librecloud.online/LibreCloud/CloudMandala#cloudmandala)

Includes applications definitions and functions for following areas:

- App auth handlers library: login, admin, member.
- Files Upload.
- Web Request enviroment definition and functions.
- Authentication
- Render templates and pages
- Lang definitions

### Criteria

In a basic application scenario this group or library collections are included together.

Updating packages or dependencies shoud be keep in sync among <u>Cargo.toml</u> declarations.

### How to use

1 - Clone or download this lib in a path, better outside of target development

2 - Get current version from <u>Cargo.toml</u>

3 - <u>For each member of</u>  of **Handlers Library** one line like the one below should be included in <u>target development Cargo.toml</u> (adjust version & path) and **use** whatever is need.

```toml
app_auth_handlers = { version = "0.1.0", path = "../lib/handlers/app_auth_handlers" }
```

To include all libraries:

```toml
app_auth_handlers = { version = "0.1.0", path = "../lib/handlers/app_auth_handlers" }
app_file_filters = { version = "0.1.0", path = "../lib/filters/app_file_filters" }
app_file_handlers = { version = "0.1.0", path = "../lib/handlers/app_file_handlers" }
reqtasks = { version = "0.1.0", path = "../lib/handlers/reqtasks" }
reqenv = { version = "0.1.0", path = "../lib/handlers/reqenv" }
```

### Structure

Each directory contains a Library dedicated to applications common needs:
Inside of each directory README.md and TODO.md files has more details.

#### app_auth_handlers

App auth handlers library

Handlers for request for auth management using [warp](https://github.com/seanmonstar/warp)

<pre>
app_auth_handlers
├── Cargo.toml
├── README.md
├── TODO.md
└── src
    └── lib.rs
</pre>

#### app_file_handlers

Files uploads.

<pre>
app_file_handlers/
├── Cargo.toml
├── README.md
├── TODO.md
└── src
    └── lib.rs
</pre>

#### reqenv

Web Request enviroment definition and functions

<pre>
reqenv
├── Cargo.toml
├── README.md
├── TODO.md
└── src
    └── lib.rs
</pre>

#### reqtasks

Handlers for: 

- Authentication
- Access: admin, session token.
- Render tamplates and pages
- Lang definitions

<pre>
reqtasks
├── Cargo.toml
├── README.md
├── TODO.md
└── src
    └── lib.rs
</pre>

## Author

- [Jesús Pérez](https://info.jesusperez.pro).

## License

MIT