https://github.com/marknjunge/ams-parse

A web scraper for Strathmore's AMS student's module
https://github.com/marknjunge/ams-parse

cheerio puppeteer strathmore webscraping

Last synced: 2 months ago
JSON representation

A web scraper for Strathmore's AMS student's module

• Host: GitHub
• URL: https://github.com/marknjunge/ams-parse
• Owner: MarkNjunge
• License: mit
• Created: 2018-07-08T15:37:42.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2019-10-11T13:32:50.000Z (almost 7 years ago)
• Last Synced: 2025-04-09T13:19:53.705Z (over 1 year ago)
• Topics: cheerio, puppeteer, strathmore, webscraping
• Language: JavaScript
• Homepage:
• Size: 94.7 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.MD
  • Changelog: Changelog.MD
  • License: LICENSE

Awesome Lists containing this project

README

          
# ams-parse 

[![Build Status](https://travis-ci.org/MarkNjunge/ams-parse.svg?branch=master)](https://travis-ci.org/MarkNjunge/ams-parse) 

[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FMarkNjunge%2Fams-parse.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2FMarkNjunge%2Fams-parse?ref=badge_shield)

[![Known Vulnerabilities](https://snyk.io/test/github/MarkNjunge/ams-parse/badge.svg?targetFile=package.json)](https://snyk.io/test/github/MarkNjunge/ams-parse?targetFile=package.json)

Extracts data from Strathmore's AMS student's module using [Puppeteer](https://github.com/GoogleChrome/puppeteer) and [Cheerio](https://github.com/cheeriojs/cheerio).

Currently supports:

- Attendance

- Dashboard

- My details

- Fees Statement

- Progress report

**NB**: Requires you to have access to the student's portal via a browser.

## Installation

1.  Clone the repository and install the dependencies using yarn (or npm)

2.  Create a .env file similar to [.env.sample](./.env.sample)

- The .env file is not required if arguments are passed via the run command. See usage.

- In development environment, alternative endpoints will need to be provided. See [src/config/index.js](./src/config/index.js)

## Usage

Run using `npm start`.

Alternatively, `yarn start --number= --password=`

The data will be written to the `output` folder.

## Testing

```

yarn install

yarn test

```

## License

[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FMarkNjunge%2Fams-parse.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2FMarkNjunge%2Fams-parse?ref=badge_large)