Skip to content

Commit e50c365

Browse files
committed
readme update
1 parent 7201f30 commit e50c365

File tree

1 file changed

+15
-1
lines changed

1 file changed

+15
-1
lines changed

README.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,20 @@ How is this fork different from upstream BaGet:
4848
- adds V2 implementation from old LiGet
4949
- caching proxy has different endpoint `/api/cache/v3/index.json` than private packages `/api/v3/index.json`
5050

51+
## Features and limitations
52+
53+
* Implements light-weight [nuget V3 API](https://docs.microsoft.com/en-us/nuget/api/overview) for hosting private packages.
54+
* Supports V3 search.
55+
* Limited **NuGet V2 API for hosting private packages**. Includes endpoints `FindPackagesById()`, `Packages()` and `PUT /api/v2`.
56+
Which is sufficient for clients to download, push, find or restore packages.
57+
* **Caching proxy of with NuGet V3 API**.
58+
- Allows to cache `.nupkg` packages on server, rather than downloading them from the Internet each time.
59+
60+
Not implemented:
61+
62+
* Cache package metadata and invalidates when upstream changes are detected using [NuGet.CatalogReader](https://github.com/emgarten/NuGet.CatalogReader). *This will be ported from older liget < 1.0.0.*
63+
* V2 search, filter and alike queries. *This is not planned.*
64+
5165
# Usage
5266

5367
See [releases](https://github.com/ai-traders/LiGet/releases) to get docker image version.
@@ -207,11 +221,11 @@ Kestrel specific:
207221

208222
* `LIGET_CACHE_ENABLED` - default is true.
209223
* `LIGET_CACHE_PROXY_SOURCE_INDEX` - address of original V3 API to cache. By default `https://api.nuget.org/v3/index.json`.
210-
* `LIGET_CACHE_INVALIDATION_CHECK_PERIOD` - defines frequency at which a check with upstream server is made to see if cache is invalid. By default `60` (seconds).
211224
* `LIGET_NUPKG_CACHE_BACKEND` - backend of the .nupkg caching proxy. By default `simple2`,
212225
which in `1.0.0` was introduced as the only implementation.
213226
* `LIGET_NUPKG_CACHE_SIMPLE2_ROOT_PATH` - root directory where dbreeze will store cached packages.
214227
By default `/cache/simple2`.
228+
* `LIGET_CACHE_INVALIDATION_CHECK_PERIOD` - defines frequency at which a check with upstream server is made to see if cache is invalid. By default `60` (seconds). *Not Implemented yet in 1.0.0*
215229

216230
#### Logging
217231

0 commit comments

Comments
 (0)