Skip to content

Latest commit

 

History

History
55 lines (36 loc) · 1.95 KB

README.md

File metadata and controls

55 lines (36 loc) · 1.95 KB

Sirius: create APIs that shine like a star

Sirius, commonly known as the brightest star in the night sky, is also an API framework written with ease-of-use and developer experience in mind. By learning from frameworks written not only in Python, but other languages too, Sirius provides a set of distinctive features aiming to provide the best possible experience developing a dazzling application on a starry night.

Twitter

Features

  • File-system based routing
  • A zero-boilerplate experience
  • A CLI utility

Planned features

  • State-of-the-art documentation (#2)
  • Full ASGI compliance (#3)
  • A simple configuration system (#4)

Getting Started

Installation
Usage

Installation

Currently, the only way to install Sirius is using pip, the Python package manager. Either within a virtual environment, or globally, Sirius can be installed with:

$ python3 -m pip install sirius-api

Usage

After installing Sirius, you can create a new project! Throughout the documentation we'll work on an API that mocks data about planets 🪐.

Project Structure

A basic Sirius project will contain the following files in its root directory:

pyproject.toml/poetry.lock - Files to define dependencies, Sirius is in here!
sirius.config.toml - Sirius needs configuration... you provide configuration!

Then, the truly galactic part. File-system routing! Create a directory called src and within it a subdirectory named routes.

We have now entered holy land - there is no turning back once you realise that every file you define from now on, will be an endpoint in your API.