From 6abde80d3513655a3c5b904e5e3b1357a44c80d0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C2=A0Ilya=20Atamas?= Date: Thu, 18 Apr 2019 15:18:55 +0300 Subject: [PATCH] docs: add commands overview --- proxy/cache.go | 6 +++--- readme.md | 37 ++++++++++++++++++++++++++++++++++--- 2 files changed, 37 insertions(+), 6 deletions(-) diff --git a/proxy/cache.go b/proxy/cache.go index 2bcacd7..c5817ab 100644 --- a/proxy/cache.go +++ b/proxy/cache.go @@ -6,7 +6,7 @@ import ( "strings" ) -// GetMetadata returns NPM response for a given package path +// GetMetadata returns cached NPM response for a given package path func (proxy Proxy) GetMetadata(name string, originalPath string, header http.Header) ([]byte, error) { options, err := proxy.GetOptions() if err != nil { @@ -67,7 +67,7 @@ func (proxy Proxy) GetMetadata(name string, originalPath string, header http.Hea return []byte(pkg), nil } -// ListMetadata returns a list of all cached packages +// ListMetadata returns list of all cached packages func (proxy Proxy) ListMetadata() ([]string, error) { options, err := proxy.GetOptions() if err != nil { @@ -87,7 +87,7 @@ func (proxy Proxy) ListMetadata() ([]string, error) { return deprefixedMetadata, nil } -// Purge deletes all cached packages +// PurgeMetadata deletes all cached packages func (proxy Proxy) PurgeMetadata() error { options, err := proxy.GetOptions() if err != nil { diff --git a/readme.md b/readme.md index b3aa501..69a0901 100644 --- a/readme.md +++ b/readme.md @@ -1,11 +1,42 @@ # npm-cache-proxy ![Docker Cloud Build Status](https://img.shields.io/docker/cloud/build/emeralt/npm-cache-proxy.svg?style=for-the-badge) -## Usage -... -## Configuration +- [npm-cache-proxy](#npm-cache-proxy) + - [Download](#download) + - [Usage](#usage) + - [`ncp`](#ncp) + - [`ncp list`](#ncp-list) + - [`ncp purge`](#ncp-purge) + - [Programmatic usage](#programmatic-usage) + - [License](#license) + +## Download ... +## Usage + +### `ncp` +Start proxy server. + +| Options | Env | Default | Description | +| ------------------------- | ------------- | ----------------------- | --------------------------- | +| `-p, --port ` | `HTTP_PORT` | `8080` | Port to listen to | +| `-l, --limit ` | `CACHE_LIMIT` | - | Cached packages count limit | +| `-t, --ttl ` | `CACHE_TTL` | `3600` | Cache expiration timeout | +| `-h, --host
` | `REDIS_HOST` | `http://localhost:6379` | Redis address | +| `-d, --db ` | `REDIS_DB` | `0` | Redis database | +| `-a, --access ` | `REDIS_PASS` | - | Redis password | + + +### `ncp list` +List cached packages. + +### `ncp purge` +Purge cached pacakges. + ## Programmatic usage ... + +## License +[MIT](./license)