ASA Swim time scraper

This is a javascript website scraper for the ASA personal swim times. Pass in swimmer ASA Number and get back the personal best history from ASA.

Permissions

This is not affiliated to the ASA, or any of its partners / affiliates. It is intended to be used as an example of how to connect to a website. If you intend to use more broadly, you may require permission.

Status

Getting Started

Include the library in your project. Pass the ASA Number. The single function will return the times.

Prerequisites

What things you need to install the software and how to install them

None

Installing

Install the library using npm...

npm install --save asa-swim-time-scraper

...or, take the library directly from githb

git clone https://github.com/paulcull/asa-swim-time-scraper

This library uses promises. The function when called returns a promise, allowing you to get on with anything else that you need to. There are no runtime 3rd party dependencies in this library.

var getTime = require('asa-swim-time-scraper');

getTimes("99999999").then(function(times){
    console.log(times);
})

• Also check the tests and example

Running the tests

There are a limited number of tests. Several negative tests and a couple of checks on times to convert

npm test

Deployment

Not designed to run stand-alone - this should be used as a libray.

Built With

• NPM - Dependency Management
• MOCHA - Test management
• CHAI - BDD / TDD assertion (including with PROMISES)

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

TODO

These are things that should be done to complete.

• [ ] Reduce / remove external dependancies
• [X] Add project documentation
• [X] Add simple example
• [X] Setup travis-ci
• [X] Add grunt to manage a min step and create a smaller footprint library
• [X] Introduce dependency monitoring
• [ ] Publish to npm.org

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

• Paul Cullender - Initial work - paulcull

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

• The very reusable git documents from PurpleBooth