npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

liftie

v3.53.0

Published

Clean, simple, easy to read, fast ski resort lift status

Downloads

1,189

Readme

NPM version Build Status Dependencies

liftie.info

Clean, simple, easy to read, fast ski resort lift status.

Features

  • Displays multiple resorts on a single page.

  • Refreshes automatically every 65 seconds.

  • Index page displays all supported resorts but it's possible to specify (and bookmark) a subset:

      https://liftie.info?resorts=alpine,palisades
  • REST type API returns a status of each resort.

      GET https://liftie.info/api/resort/<resort>
  • Status is cached on a server side. Regardless of the number of browser request, server will retrieve (and parse) the resort pages only once per minute.

How to run liftie locally

Clone this repo (or your fork)

git clone [email protected]:pirxpilot/liftie.git && cd liftie

Build client side scripts: make will install all external components and trigger component build for you.

make

Run and profit (liftie binds to port 3000 by default)

node app

How to add your favorite acme.com resort

Generate resort scaffolding

The easiest way to start working on a new resort is to run generate script.

$./bin/generate

The script expects the short (one word, dashes OK) identifier of the ski resort, the human readable name and the URL of the page with lift status. It also asks for resort geographical coordinates.

The following files are generated for a newly added resort:

  • resort descriptor lib/resort/acme/resort.json,
  • parser lib/resort/acme/index.js,
  • and a test for a parsing function test/resort/acme.js.
  • lift status page retrieved from internet test/resort/example/acme.html

You can check this commit to see what you can expect after this page is completed.

Newly added resort is displayed automatically on liftie index page, but it won't have any lifts at this stage.

Update test

Now you can flesh out the test by adding expected list of ski lifts. See this commit.

var expected = {
  'Super Express Lift': 'closed',
  'Magic Carpet': 'open',
  'Ultra Gondola': 'hold',
  'T-Bar': 'scheduled'
};

At this point you should probably run the tests: since parsing function is not implemented the test will fail.

You can run only the specific resort test by running:

make test TESTS="**/*/acme.js"

Implement parser

lib/resorts/acme/index.js exports the following object

module.exports = {
  selector: '.lifts',                // selector for lift information
  parse: {
    filter: node => node.children,   // if present skips nodes for which filter is falsy
    name: '0/1',            // example of a simple path descriptor (second child of the first child)
    status: {               // example of a compound descriptor
      child: '+/1',
      attribute: 'alt',
      regex: /-([a-z]+)$/,
      fn: s => s.slice(0, -3)
    }
  }
};

You need to adjust it to find the lift names and their statuses:

  • selector is a CSS selector that should locate the parent of the name and status elements
  • parse needs to contain 2 descriptors - one for name and the other for status
  • name and status descriptors have the following properties
    • child - dash-separated path to the name or status HTML element - index, ,, .., +, - are supported
    • attribute - optional - if specified the value of the attribute instead of the contents of the element is used
    • regex - optional - if specified the regex is executed and the value of the first matching group is used
    • fn - optional - if specified the function is called that can be used to convert the value

If child is the only part of the descriptor it can be used directly. In other words:

name: {
  child: '0/3'
}

is the same as

name: '0/3'

Check out this commit to see the simple parser implemented.

Once parser is ready the tests should succeed.

Improvements

  • improve weather - US resorts can have more precise weather forecast, if there is a NOAA station nearby: run bin/fetch-noaa --overwrite <resort-name> to find it
  • add webcams - normally just specifying position would add some webcams to the liftie page but you can also just add links to the webcams in resort.json descriptor

Alternative status source

In some cases the lift status info is not directly accessible on the web page to which liftie should be redirecting its users. For example lift status might be contained in an invisible iframe or retrieved from a 3rd party server. In such cases specify dataUrl in addition to the url entry in the resort descriptor.

Liftie will always use url to construct the link to the relevant resort page, and - if present - it will use dataUrl to retrieve the page that is subsequently parsed to obtain lift information.

Resort JSON API

In addition to parsing lift status pages Liftie supports resorts that make their lift status available through REST API. In such cases you need to specify api element in resort descriptor.

"api": {
  "host": "http://api.acme.com",
  "pathname": "/api/status"
}

If api is specified Liftie will retrieve status info through HTTP GET. The resort parse function will receive parsed json instead of the dom tree. Please note that you still need to configure url - it is used on Liftie pages to send users to official resort page. Check out this implementation, if you are looking for an example.

Credits

Icon Font generated with IconMoon App

Forecast Font from Icon Vault -- SIL Open Font License

Tags CSS (stylus) is a simplified version of Sliding Tags by Thibaut Courouble -- License MIT

License

3-Clause BSD License