browsenpm / 0.5.1 last updated 3 months ago created on May 6th 2014

Install

npm install --save browsenpm

Clone

git clone git@github.com:nodejitsu/browsenpm.org.git

dependencies show all 388

main async 0.9.0 MIT
bigpipe 0.8.3 MIT
bigpipe-layout 0.1.0 MIT
bigpipe-watch 0.1.1 MIT
connect 2.15.0 MIT

maintainers +1 more

npm-probe npm-probe
swaagie swaagie
jcrugzz jcrugzz
V1 V1
indexzero indexzero

versions 11 total

0.5.1 3 months ago V1
0.5.0 3 months ago V1
0.4.0 4 months ago V1
0.3.1 5 months ago swaagie
0.3.0 6 months ago V1
0.2.12 6 months ago swaagie
0.2.11 6 months ago swaagie
0.2.10 6 months ago swaagie
0.2.9 6 months ago swaagie
0.2.8 6 months ago swaagie
0.2.7 7 months ago npm-probe
22 Downloads yesterday.

readme

browsenpm.org

Browse packages, users, code, stats and more the public npm registry in style.

Installation

Browsenpm.org has several dependencies to run locally for development purposes.

sudo apt-get install redis-server couchdb
npm install

After update the configuration in development.json and provide the details needed. Note that your database might require authentication credentials.

Running

1
2
3
4
npm start

# Or run the server by specifying a configuration file.
bin/server -c config.dev.json

Providing a custom configuration is optional. By default development.json will be used.

Database

Both Redis and CouchDB should be running to cache data for certain pagelets. Make sure you run them locally or provide a server that runs either.

CouchDB will be used to cache all the data of npm-probe. The views in plugins/couchdb.json should be available on the database to ensure the pagelet can fetch the data. These views will be added to the browsenpm database on startup.

Status npm-mirrors

The current registry status is provided via npm-probe. Several probes are run at set intervals. The publish probe requires authentication with npm-probe. These credentials can (and are) provided to the configuration of the npm-probe instance.

npm-probe is provided with a CouchDB cache instance. All data is stored in the database browsenpm.

When running multiple instances of browsenpm.org accessible via balancers, make sure to only start npm-probe once. Set the environment variable PROBE=silent to prevent an instance from collecting data.

Cache

During development it might be useful to destroy cached data, simply set any of the following environment variables to flush cache.

CACHE=flush:redis
CACHE=flush:couchdb

Debugging

Most components have debug statements to help debugging, shortlist:

Module Description Statement
bigpipe all components DEBUG=bigpipe:*
bigpipe server DEBUG=bigpipe:server
bigpipe pages DEBUG=bigpipe:page
bigpipe pagelets DEBUG=bigpipe:pagelet
npm-probe statistics DEBUG=npm-probe
dynamis cache layer DEBUG=dynamis
ALL every module DEBUG=bigpipe:*,dynamis,npm-probe
Resolving all dependencies.. This could take a while as our cache is not yet fully warmed up.