dart-lang/pub_server

Name: pub_server

Owner: Dart

Description: Reusable components for making a pub package server

Created: 2015-02-11 14:08:13.0

Updated: 2018-05-21 12:13:26.0

Pushed: 2018-05-22 21:01:56.0

Homepage: https://pub.dartlang.org/packages/pub_server

Size: 74

Language: Dart

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Provides re-usable code for making a Dart package repository server. The package:pub_server/shelf_pubserver.dart library provides a shelf HTTP handler which provides the HTTP API used by the pub client. One can use different backend implementations by implementing the PackageRepository interface of the package:pub_server/repository.dart library.

Example pub repository server

An experimental pub server based on a file system can be found in example/example.dart. It uses a filesystem-based PackageRepository for storing packages and has a read-only fallback to the real pub.dartlang.org site, if a package is not available locally. This allows one to use all pub.dartlang.org packages and have additional ones, on top of the publicly available packages, available only locally.

It can be run as follows

git clone https://github.com/dart-lang/pub_server.git
cd pub_server
b_server $ pub get

b_server $ dart example/example.dart -d /tmp/package-db
ening on http://localhost:8080

ake the pub client use this repository configure your shell via:

$ export PUB_HOSTED_URL=http://localhost:8080

Using it for uploading new packages to the locally running server or downloading packages locally available or via a fallback to pub.dartlang.org is as easy as:

obar $ export PUB_HOSTED_URL=http://localhost:8080
obar $ pub get

obar $ pub publish
ishing x 0.1.0 to http://localhost:8080:
...
pubspec.yaml

s great! Are you ready to upload your package (y/n)? y
ading...
essfully uploaded package.

The fact that the pub publish command requires you to grant it oauth2 access - which requires a Google account - is due to the fact that the pub publish cannot work without authentication or with another authentication scheme. But the information sent by the pub client is not used for this local server at the moment.

NOTE: This is package is an alpha version and is not recommended for production use.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.