https://github.com/dart-lang/shelf

Web server middleware for Dart
https://github.com/dart-lang/shelf

dart http server

Last synced: about 1 month ago
JSON representation

Web server middleware for Dart

• Host: GitHub
• URL: https://github.com/dart-lang/shelf
• Owner: dart-lang
• License: bsd-3-clause
• Created: 2014-12-19T21:51:14.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2024-01-03T09:25:58.000Z (10 months ago)
• Last Synced: 2024-01-30T12:58:35.658Z (9 months ago)
• Topics: dart, http, server
• Language: Dart
• Homepage: https://pub.dev/packages/shelf
• Size: 985 KB
• Stars: 842
• Watchers: 62
• Forks: 125
• Open Issues: 50
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-dart - Shelf - Web server middleware for Dart.[<img src="https://travis-ci.org/dart-lang/shelf.svg?branch=master">](https://travis-ci.org/dart-lang/shelf) (Libraries / Server Frameworks)

README

        
[![Build Status](https://github.com/dart-lang/shelf/workflows/Dart%20CI/badge.svg)](https://github.com/dart-lang/shelf/actions?query=workflow%3A"Dart+CI"+branch%3Amaster)

## About Shelf

Shelf makes it easy to create and compose web servers and parts of web servers. How?

- Expose a small set of simple types.

- Map server logic into a simple function: a single argument for the request, the response is the return value.

- Trivially mix and match synchronous and asynchronous processing.

- Flexibility to return a simple string or a byte stream with the same model.

It was inspired by [Connect](https://github.com/senchalabs/connect) for NodeJS

and [Rack](https://github.com/rack/rack) for Ruby.

See the [package:shelf readme](pkgs/shelf/) for more information.

## Packages

| Package | Description | Version |

| --- | --- | --- |

| [shelf](pkgs/shelf/) | A model for web server middleware that encourages composition and easy reuse. | [![pub package](https://img.shields.io/pub/v/shelf.svg)](https://pub.dev/packages/shelf) |

| [shelf_packages_handler](pkgs/shelf_packages_handler/) | A shelf handler for serving a `packages/` directory. | [![pub package](https://img.shields.io/pub/v/shelf_packages_handler.svg)](https://pub.dev/packages/shelf_packages_handler) |

| [shelf_proxy](pkgs/shelf_proxy/) | A shelf handler for proxying HTTP requests to another server. | [![pub package](https://img.shields.io/pub/v/shelf_proxy.svg)](https://pub.dev/packages/shelf_proxy) |

| [shelf_router](pkgs/shelf_router/) | A convenient request router for the shelf web-framework, with support for URL-parameters, nested routers and routers generated from source annotations. | [![pub package](https://img.shields.io/pub/v/shelf_router.svg)](https://pub.dev/packages/shelf_router) |

| [shelf_router_generator](pkgs/shelf_router_generator/) | A package:build-compatible builder for generating request routers for the shelf web-framework based on source annotations. | [![pub package](https://img.shields.io/pub/v/shelf_router_generator.svg)](https://pub.dev/packages/shelf_router_generator) |

| [shelf_static](pkgs/shelf_static/) | Static file server support for the shelf package and ecosystem. | [![pub package](https://img.shields.io/pub/v/shelf_static.svg)](https://pub.dev/packages/shelf_static) |

| [shelf_test_handler](pkgs/shelf_test_handler/) | A Shelf handler that makes it easy to test HTTP interactions. | [![pub package](https://img.shields.io/pub/v/shelf_test_handler.svg)](https://pub.dev/packages/shelf_test_handler) |

| [shelf_web_socket](pkgs/shelf_web_socket/) | A shelf handler that wires up a listener for every connection. | [![pub package](https://img.shields.io/pub/v/shelf_web_socket.svg)](https://pub.dev/packages/shelf_web_socket) |

## Publishing automation

For information about our publishing automation and release process, see

https://github.com/dart-lang/ecosystem/wiki/Publishing-automation.