package sihl-user
Install
Dune Dependency
Authors
Maintainers
Sources
md5=ada35566185af0fdde18aed448d23aa8
sha512=4d7cae8948061249246d0a19ad8c1ea3dc5238557d6055b9fee3479af1451d089047c96524516aaea20f0896662a79919d7107ddc8911dd036e11cd5cdd5df7c
Description
Modules for user management and password reset workflows with support for PostgreSQL and MariaDB.
Published: 03 May 2021
README
README.md
A modular and functional web framework
Explore the docs »
Getting Started
·
Demo project
·
Report Bug
·
Request Feature
Table of Contents
About
Note that even though Sihl is being used in production, the API is still under active development.
Sihl is a batteries-included web framework built on top of Opium, caqti, logs and many more. Thanks to the modular architecture, included batteries can be swapped easily. Statically typed functional programming with OCaml makes web development fun and safe.
Getting Started
The easiest way to get started is by using Spin. If you want to jump into code, have a look at the demo project.
Prerequisites
Basic understanding of OCaml
Installation of opam
To initialize opam:
opam init
To install Spin, following the instructions here. You can install it using opam:
opam install spin
Create a project
Generate a start project:
spin new https://github.com/oxidizing/spin-sihl.git app
Visit http://localhost:3000/
, you should see a welcome text.
Check out the demo project.
Background
Design Goals
These are the main design goals of Sihl.
Fun
The overarching goal is to make web development fun. Fun is hard to quantify, so let's just say fun is maximized when frustration is minimized. This is what the other design goals are here for.
Swappable batteries included
Sihl should provide high-level features that are common in web applications out-of-the-box. It should provide sane and ergonomic defaults for 80% of the use cases with powerful but not necessarily ergonomic customization options for the other 20%.
Ergonomic but safe
OCaml itself ensures a certain level of correctness at compile-time. In order to optimized developer experience, some things are not verified at compile-time but at start-time. Sihl makes sure that your app does not start without the needed configurations and the required environment.
Features
These are some of things that Sihl can take care of for you.
Database handling (pooling, transactions, migrations)
Configuration (from env variables to configuration services)
Logging
User management
Token management
Session management
HTTP routes & middlewares
Flash Messages
Authentication
Authorization
Emailing
CLI Commands
Job Queue
Schedules
Block Storage
Do we need another web framework?
Yes, because all other frameworks have not been invented here!
On a more serious note, originally we wanted to collect a set of services, libraries, best practices and architecture to quickly and sustainably spin-off our own tools and products. An evaluation of languages and tools lead us to build the 5th iteration of what became Sihl with OCaml. We believe OCaml is a phenomenal place to build web apps.
Thanks to OCaml Sihl is ...
... runs fast
... compiles fast
... is pragmatic and safe
... is fun to use
Documentation
The API documentation for the latest version can be found here: https://oxidizing.github.io/sihl
Roadmap
Our main goal is to stabilize the service APIs, so updating Sihl in the future becomes easier. We would like to attract contributions for service contributions, once the framework reaches some level of maturity.
Contributing
Check out the Contributing guidelines.
License
Copyright (c) 2020 Oxidizing Systems
Distributed under the MIT License. See LICENSE
for more information.
Contact
Oxidizing Systems - @oxidizingsys - hello@oxidizing.io
Project Link: https://github.com/oxidizing/sihl
Dev Dependencies (5)
-
odoc
with-doc
-
caqti-driver-mariadb
>= "1.2.0" & < "2.0.0~" & with-test
-
caqti-driver-postgresql
>= "1.2.0" & < "2.0.0~" & with-test
-
alcotest-lwt
>= "1.3.0" & with-test
-
sihl-token
= version & with-test
Used by
None
Conflicts
None