Skip to content

Commit ceda55b

Browse files
committed
changed logo and document fonts
1 parent 817e32a commit ceda55b

File tree

5 files changed

+26
-27
lines changed

5 files changed

+26
-27
lines changed

README.md

Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
[![PyPI version](https://img.shields.io/pypi/v/ellar.svg)](https://pypi.python.org/pypi/ellar)
1111
[![PyPI version](https://img.shields.io/pypi/pyversions/ellar.svg)](https://pypi.python.org/pypi/ellar)
1212

13-
## Introduction
13+
## **Introduction**
1414

1515
Ellar is a lightweight ASGI framework for building efficient and scalable server-side python applications.
1616
It supports both OOP (Object-Oriented Programming) and FP (Functional Programming)
@@ -19,7 +19,7 @@ Ellar is based on [Starlette (ASGI toolkit)](https://www.starlette.io/), a light
1919
While Ellar provides a high level of abstraction on top of Starlette, it still incorporates some of its features, as well as those of FastAPI.
2020
If you are familiar with these frameworks, you will find it easy to understand and use Ellar.
2121

22-
## Features Summary
22+
## **Features Summary**
2323

2424
- **Easy to Use**: Ellar has a simple and intuitive API that makes it easy to get started with building a fast and scalable web applications or web APIs in Python.
2525
- **Dependency Injection (DI)**: It comes with DI system makes it easy to manage dependencies and reduce coupling between components.
@@ -31,13 +31,13 @@ If you are familiar with these frameworks, you will find it easy to understand a
3131
- **Modularity**: Ellar follows a modular architecture inspired by NestJS, making it easy to organize your code into reusable modules.
3232
- **Asynchronous programming**: It allows you to takes advantage of Python's `async/await` feature to write efficient and fast code that can handle large numbers of concurrent requests
3333

34-
## Dependencies
34+
## **Dependencies**
3535
- Python >= 3.7
3636
- Starlette
3737
- Injector
3838
- Pydantic
3939

40-
## Installation
40+
## **Installation**
4141
### Poetry Installation
4242
For [Poetry](https://python-poetry.org/) usages
4343

@@ -51,11 +51,10 @@ For normal pip installation
5151
pip install ellar-cli
5252
```
5353

54-
## Create a project
54+
## Creating a project
5555
To create an ellar project, you need to have a `pyproject.toml` available on your root directory.
5656
This is necessary for ellar to store some `metadata` about your project.
5757

58-
### Create a project
5958
For Pip Users, you need to create `pyproject.toml` file
6059
```shell
6160
ellar new carsite
@@ -66,7 +65,7 @@ run the ellar create project cli command,
6665
ellar create-project carsite
6766
```
6867

69-
## Run your project
68+
## **Run your project**
7069
Ellar runs [UVICORN - ASGI Server](https://www.uvicorn.org/) under the hood.
7170
```shell
7271
ellar runserver --reload
@@ -78,14 +77,14 @@ Now go to [http://127.0.0.1:8000](http://127.0.0.1:8000)
7877

7978
For more info on Ellar CLI, click [here](https://github.com/eadwinCode/ellar-cli)
8079

81-
## Create a project module
80+
## **Adding a project module**
8281
A project module is a project app defining a group of controllers or services including templates and static files.
8382
So, now we have a project created, lets add an app to the project.
8483
```shell
8584
ellar create-module car
8685
```
8786

88-
## Add Schema
87+
## **Add Schema**
8988
In `car/schema.py`, lets add some serializer for car input and output data
9089
```python
9190
from ellar.serializer import Serializer
@@ -100,7 +99,7 @@ class RetrieveCarSerializer(CarSerializer):
10099
pk: str
101100
```
102101

103-
## Add Services
102+
## **Add Services**
104103
In `car/services.py`, lets create a dummy repository `CarDummyDB` to manage our car data.
105104
```python
106105
import typing as t
@@ -153,7 +152,7 @@ class CarDummyDB:
153152
if idx >= 0:
154153
return self._data.pop(idx)
155154
```
156-
## Add Controller
155+
## **Add Controller**
157156
In `car/controllers.py`, lets create `CarController`
158157

159158
```python
@@ -201,7 +200,7 @@ class CarController(ControllerBase):
201200
return self.car_db.list()
202201

203202
```
204-
## Register Service and Controller
203+
## **Register Service and Controller**
205204
In `car/module.py`, lets register `CarController` and `CarDummyDB`
206205

207206
```python
@@ -225,7 +224,7 @@ class CarModule(ModuleBase):
225224
pass
226225
```
227226

228-
## Registering Module
227+
## **Registering Module**
229228
Ellar is not aware of `CarModule` yet, so we need to add it to the `modules` list of `ApplicationModule` at the `carsite/root_module.py`.
230229
```python
231230
from ellar.common import Module, exception_handler
@@ -243,7 +242,7 @@ class ApplicationModule(ModuleBase):
243242
return JSONResponse(dict(detail="Resource not found."))
244243

245244
```
246-
## Enabling OpenAPI Docs
245+
## **Enabling OpenAPI Docs**
247246
To start up openapi, we need to go back to project folder in the `server.py`
248247
then add the following below.
249248
```python
@@ -280,7 +279,7 @@ Now we can test our API at [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/do
280279
Please ensure your server is running
281280
![Swagger UI](docs/img/car_api.png)
282281

283-
## HTML Templating
282+
## **HTML Templating**
284283
Ellar has built-in support for Jinja2, which is a popular template engine for HTML. This feature allows for easy and efficient HTML templating similar to that of Flask. Jinja2 can be used to create reusable templates, and to insert dynamic data into HTML pages. It also has support for template inheritance, control structures, and other useful features that can help to simplify and streamline the process of creating HTML templates.
285284

286285
```html

docs/index.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<p align="center">
2-
<a href="#" target="blank"><img src="img/EllarLogoIconOnly.png" width="200" alt="Ellar Logo" /></a>
2+
<a href="#" target="blank"><img src="img/EllarLogoB.png" width="200" alt="Ellar Logo" /></a>
33
</p>
44

55
<p align="center"> Ellar - Python ASGI web framework for building fast, efficient and scalable RESTAPIs and server-side application. </p>
@@ -11,23 +11,23 @@
1111
[![PyPI version](https://img.shields.io/pypi/pyversions/ellar.svg)](https://pypi.python.org/pypi/ellar)
1212

1313
---
14-
## Introduction
14+
## **Introduction**
1515
Ellar is a lightweight ASGI framework for building efficient and scalable server-side python applications.
1616
It supports both OOP (Object-Oriented Programming) and FP (Functional Programming)
1717

1818
Ellar is based on [Starlette (ASGI toolkit)](https://www.starlette.io/), a lightweight ASGI framework/toolkit well-suited for developing asynchronous web services in Python.
1919
And while Ellar provides a high level of abstraction on top of Starlette, it still incorporates some of its features, as well as those of FastAPI.
2020
If you are familiar with these frameworks, you will find it easy to understand and use Ellar.
2121

22-
## Inspiration
22+
## **Inspiration**
2323
Ellar was deeply influenced by [NestJS](https://docs.nestjs.com/) for its ease of use and ability to handle complex project structures and applications.
2424
Additionally, it took some concepts from [FastAPI](https://fastapi.tiangolo.com/) in terms of request parameter handling and data serialization with Pydantic.
2525

2626
With that said, the objective of Ellar is to offer a high level of abstraction in its framework APIs, along with a well-structured project setup, an object-oriented approach to web application design,
2727
the ability to adapt to any desired software architecture, and ultimately, speedy request handling.
2828

2929

30-
## Features Summary
30+
## **Features Summary**
3131

3232
- **Easy to Use**: Ellar has a simple and intuitive API that makes it easy to get started with building a fast and scalable web applications or web APIs with Python.
3333
- **Dependency Injection (DI)**: It comes with DI system makes it easy to manage dependencies and reduce coupling between components.
@@ -39,7 +39,7 @@ the ability to adapt to any desired software architecture, and ultimately, speed
3939
- **Modularity**: Ellar follows a modular architecture inspired by NestJS, making it easy to organize your code into reusable modules.
4040
- **Asynchronous programming**: It allows you to takes advantage of Python's `async/await` feature to write efficient and fast code that can handle large numbers of concurrent requests
4141

42-
## Installation
42+
## **Installation**
4343
To get started, you need to scaffold a project using [Ellar-CLI](https://eadwincode.github.io/ellar-cli/) toolkit. This is recommended for a first-time user.
4444
The scaffolded project is more like a guide to project setup.
4545

@@ -61,13 +61,13 @@ $(venv) ellar runserver --reload
6161
Open your browser and navigate to [`http://localhost:8000/`](http://localhost:8000/).
6262
![Swagger UI](img/ellar_framework.png)
6363

64-
## Dependency Summary
64+
## **Dependency Summary**
6565
- `Python >= 3.7`
6666
- `Starlette`
6767
- `Pydantic`
6868
- `Injector`
6969

70-
## Status
70+
## **Status**
7171

7272
Project is still in development
7373

docs/stylesheets/extra.css

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
.md-header {
2-
background-color: #40405e !important;
2+
background-color: rgba(0, 0, 0, 0.86) !important;
33
}

docs/throttling.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ To get started, you'll need to install the `ellar-throttler` package.
66
$(venv) pip install ellar-throttler
77
```
88

9-
## ThrottlerModule
9+
## **ThrottlerModule**
1010

1111
The `ThrottlerModule` is the main entry point for this package, and can be used in a synchronous or asynchronous manner.
1212
All the needs to be passed is the `ttl`, the time to live in seconds for the request tracker, and the `limit`,

mkdocs.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
site_name: Ellar
1+
site_name: ellar
22
site_description: Ellar - Python ASGI web framework for building fast, efficient and scalable RESTAPIs and server-side application.
33
site_url: https://github.com/eadwinCode/ellar
44
repo_name: eadwinCode/ellar
@@ -40,8 +40,8 @@ theme:
4040
icon: material/lightbulb-outline
4141
name: Switch to light mode
4242
font:
43-
text: Roboto
44-
code: Roboto Mono
43+
text: Noto Sans
44+
code: Fira Code
4545
language: en
4646
logo: img/Icon.svg
4747
favicon: img/Icon.svg

0 commit comments

Comments
 (0)