معرفی شرکت ها
blacksheep-2.0a6
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Fast web framework for Python asyncio
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | blacksheep-2.0a6 |
| نام | blacksheep |
| نسخه کتابخانه | 2.0a6 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Roberto Prevato |
| ایمیل نویسنده | roberto.prevato@gmail.com |
| آدرس صفحه اصلی | https://github.com/Neoteroi/BlackSheep |
| آدرس اینترنتی | https://pypi.org/project/blacksheep/ |
| مجوز | MIT |
[](https://github.com/Neoteroi/BlackSheep/actions)
[](https://pypi.org/project/BlackSheep/)
[](https://github.com/robertoprevato/blacksheep)
[](https://codecov.io/gh/Neoteroi/BlackSheep)
[](https://github.com/Neoteroi/blacksheep/blob/main/LICENSE) [](https://gitter.im/Neoteroi/BlackSheep?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://www.neoteroi.dev/blacksheep/)
# BlackSheep
BlackSheep is an asynchronous web framework to build event based web
applications with Python. It is inspired by
[Flask](https://palletsprojects.com/p/flask/), [ASP.NET
Core](https://docs.microsoft.com/en-us/aspnet/core/), and the work by [Yury
Selivanov](https://magic.io/blog/uvloop-blazing-fast-python-networking/).
<p align="left">
<a href="#blacksheep"><img width="320" height="271" src="https://www.neoteroi.dev/blacksheep/img/blacksheep.png" alt="Black Sheep"></a>
</p>
```bash
pip install blacksheep
```
**Important.** This branch contains the code of the version 1 of the web
framework. The `main` branch contains the code for the currently developed
version.
---
```python
from datetime import datetime
from blacksheep import Application
app = Application()
@app.route("/")
async def home():
return f"Hello, World! {datetime.utcnow().isoformat()}"
```
## Getting started
The documentation offers getting started tutorials:
* [Getting started:
basics](https://www.neoteroi.dev/blacksheep/getting-started/)
* [Getting started: the MVC project
template](https://www.neoteroi.dev/blacksheep/mvc-project-template/)
These project templates can be used to start new applications faster:
* [BlackSheep MVC project
template](https://github.com/Neoteroi/BlackSheepMVC)
* [BlackSheep empty project
template](https://github.com/Neoteroi/BlackSheepEmptyProject)
## Requirements
[Python](https://www.python.org) version **3.7**, **3.8**, **3.9**, or **3.10**.
BlackSheep belongs to the category of
[ASGI](https://asgi.readthedocs.io/en/latest/) web frameworks, so it requires
an ASGI HTTP server to run, such as [uvicorn](http://www.uvicorn.org/), or
[hypercorn](https://pgjones.gitlab.io/hypercorn/). For example, to use it with
uvicorn:
```bash
$ pip install uvicorn
```
To run an application like in the example above, use the methods provided by
the ASGI HTTP Server:
```bash
# if the BlackSheep app is defined in a file `server.py`
$ uvicorn server:app
```
To run for production, refer to the documentation of the chosen ASGI server
(i.e. for [uvicorn](https://www.uvicorn.org/#running-with-gunicorn)).
## Automatic bindings and dependency injection
BlackSheep supports automatic binding of values for request handlers, by type
annotation or by conventions. See [more
here](https://www.neoteroi.dev/blacksheep/requests/).
```python
from dataclasses import dataclass
from blacksheep import Application, FromJSON, FromQuery
app = Application()
@dataclass
class CreateCatInput:
name: str
@app.router.post("/api/cats")
async def example(data: FromJSON[CreateCatInput]):
# in this example, data is bound automatically reading the JSON
# payload and creating an instance of `CreateCatInput`
...
@app.router.get("/:culture_code/:area")
async def home(culture_code, area):
# in this example, both parameters are obtained from routes with
# matching names
return f"Request for: {culture_code} {area}"
@app.router.get("/api/products")
def get_products(
page: int = 1,
size: int = 30,
search: str = "",
):
# this example illustrates support for implicit query parameters with
# default values
# since the source of page, size, and search is not specified and no
# route parameter matches their name, they are obtained from query string
...
@app.router.get("/api/products2")
def get_products2(
page: FromQuery[int] = FromQuery(1),
size: FromQuery[int] = FromQuery(30),
search: FromQuery[str] = FromQuery(""),
):
# this example illustrates support for explicit query parameters with
# default values
# in this case, parameters are explicitly read from query string
...
```
It also supports [dependency
injection](https://www.neoteroi.dev/blacksheep/dependency-injection/), a
feature that provides a consistent and clean way to use dependencies in request
handlers.
## Generation of OpenAPI Documentation
[Generation of OpenAPI Documentation](https://www.neoteroi.dev/blacksheep/openapi/).
## Strategies to handle authentication and authorization
BlackSheep implements strategies to handle authentication and authorization.
These features are documented here:
* [Authentication](https://www.neoteroi.dev/blacksheep/authentication/)
* [Authorization](https://www.neoteroi.dev/blacksheep/authorization/)
```python
app.use_authentication()\
.add(ExampleAuthenticationHandler())
app.use_authorization()\
.add(AdminsPolicy())
@auth("admin")
@app.router.get("/")
async def only_for_admins():
...
@auth()
@app.router.get("/")
async def only_for_authenticated_users():
...
```
Since version `1.2.1`, BlackSheep implements:
* [Built-in support for OpenID Connect authentication](https://www.neoteroi.dev/blacksheep/authentication/#oidc)
* [Built-in support for JWT Bearer authentication](https://www.neoteroi.dev/blacksheep/authentication/#jwt-bearer)
Meaning that it is extremely easy to integrate with services such as:
* [Auth0](https://auth0.com)
* [Azure Active Directory](https://azure.microsoft.com/en-us/services/active-directory/)
* [Azure Active Directory B2C](https://docs.microsoft.com/en-us/azure/active-directory-b2c/overview)
* [Okta](https://www.okta.com)
Refer to the documentation for more details and examples.
## Web framework features
* [ASGI compatibility](https://www.neoteroi.dev/blacksheep/asgi/)
* [Routing](https://www.neoteroi.dev/blacksheep/routing/)
* Request handlers can be [defined as
functions](https://www.neoteroi.dev/blacksheep/request-handlers/), or [class
methods](https://www.neoteroi.dev/blacksheep/controllers/)
* [Middlewares](https://www.neoteroi.dev/blacksheep/middlewares/)
* [WebSocket](https://www.neoteroi.dev/blacksheep/websocket/)
* [Built-in support for dependency
injection](https://www.neoteroi.dev/blacksheep/dependency-injection/)
* [Support for automatic binding of route and query parameters to request
handlers methods
calls](https://www.neoteroi.dev/blacksheep/getting-started/#handling-route-parameters)
* [Strategy to handle
exceptions](https://www.neoteroi.dev/blacksheep/application/#configuring-exceptions-handlers)
* [Strategy to handle authentication and
authorization](https://www.neoteroi.dev/blacksheep/authentication/)
* [Built-in support for OpenID Connect authentication using OIDC
discovery](https://www.neoteroi.dev/blacksheep/authentication/#oidc)
* [Built-in support for JWT Bearer authentication using OIDC discovery and
other sources of
JWKS](https://www.neoteroi.dev/blacksheep/authentication/#jwt-bearer)
* [Handlers
normalization](https://www.neoteroi.dev/blacksheep/request-handlers/)
* [Serving static
files](https://www.neoteroi.dev/blacksheep/static-files/)
* [Integration with
Jinja2](https://www.neoteroi.dev/blacksheep/templating/)
* [Support for serving SPAs that use HTML5 History API for client side
routing](https://www.neoteroi.dev/blacksheep/static-files/#how-to-serve-spas-that-use-html5-history-api)
* [Support for automatic generation of OpenAPI
Documentation](https://www.neoteroi.dev/blacksheep/openapi/)
* [Strategy to handle CORS settings](https://www.neoteroi.dev/blacksheep/cors/)
* [Sessions](https://www.neoteroi.dev/blacksheep/sessions/)
* Support for automatic binding of `dataclasses` and
[`pydantic`](https://pydantic-docs.helpmanual.io) models to handle the
request body payload expected by request handlers
* [`TestClient` class to simplify testing of applications](https://www.neoteroi.dev/blacksheep/testing/)
* [Anti Forgery validation](https://www.neoteroi.dev/blacksheep/anti-request-forgery) to protect against Cross-Site Request Forgery (XSRF/CSRF) attacks
## Client features
BlackSheep includes an HTTP Client.
**Example:**
```python
import asyncio
from blacksheep.client import ClientSession
async def client_example(loop):
async with ClientSession() as client:
response = await client.get("https://docs.python.org/3/")
assert response is not None
text = await response.text()
print(text)
loop = asyncio.get_event_loop()
loop.run_until_complete(client_example(loop))
```
## Supported platforms and runtimes
* Python 3.7 (cpython)
* Python 3.8 (cpython)
* Python 3.9 (cpython)
* Python 3.10 (cpython)
* Ubuntu 18.04
* Windows 10
* macOS
## Documentation
Please refer to the [documentation website](https://www.neoteroi.dev/blacksheep/).
## Communication
[BlackSheep community in Gitter](https://gitter.im/Neoteroi/BlackSheep).
نیازمندی
| مقدار | نام |
|---|---|
| >=0.5 | httptools |
| ~=3.1.2 | Jinja2 |
| >=2022.12.7 | certifi |
| ~=3.1.0 | charset-normalizer |
| ~=0.0.9 | guardpost |
| ~=1.1.1 | rodi |
| <2.0,>=1.1.4 | essentials |
| <1.1,>=0.1.4 | essentials-openapi |
| ~=2.8.2 | python-dateutil |
| ~=2.1.2 | itsdangerous |
| - | typing-extensions |
| ~=38.0.1 | cryptography |
| ~=2.6.0 | PyJWT |
| ~=10.3 | websockets |
نحوه نصب
نصب پکیج whl blacksheep-2.0a6:
pip install blacksheep-2.0a6.whl
نصب پکیج tar.gz blacksheep-2.0a6:
pip install blacksheep-2.0a6.tar.gz