npm

Need private packages and team management tools?Check out npm Orgs. »

simplified-circulation-web

0.3.7 • Public • Published

circulation-web

Web front-end for the Circulation Manager administrative interface.

npm version

Build Status

Library Simplified Documentation

To see screenshots, read in-depth documentation, and find out more about the project, check out the Confluence site hosted by The New York Public Library.

Setup

This package is meant to be used with the Library Simplified Circulation Manager.

Use npm version

Suggested local folder setup:

  • /[path to project folder]/circulation

To use the published version with your circulation manager, run npm install from api/admin in the circulation local installed repository.

Use local development version

Suggested local folder setup:

  • /[path to project folder]/circulation
  • /[path to project folder]/circulation-web

If you're working on the administrative interface and want to test local changes, you can link your local clone of this repository to your local circulation manager. These steps will allow you to work on the front-end administrative interface and see updates while developing.

  1. Run npm link in this circulation-web repository,
  2. run npm link simplified-circulation-web from api/admin in the circulation repository,
  3. run the circulation manager using python app.py at the root in the circulation repository,
  4. run the web interface using npm run dev at the root of this circulation-web repository,
  5. visit localhost:6500/admin/

Webpack will take care of compiling and updating any new changes made locally for development. Just refresh the page to see updates without having to restart either the circulation or circulation-web servers.

Web Catalog

The Circulation Manager administrative interface relies on the OPDS Web Catalog as its base React component and application. For more information, please check out the repository.

Publishing

This package is published to npm.

To publish a new version, you need to create an npm account and be a collaborator on the package. Then you can run npm publish from your local copy of the repository.

Tests

Unit Tests

Like the codebase, all the unit tests are written in Typescript. Tests are written for all React components as well as redux and utility functions, and all can be found in their respective __tests__ folders.

To run the tests, perform npm test.

We use Travis CI for continuous integration. Any pull requests submitted must have tests and those tests must pass on Travis CI.

Nightwatch

There are end-to-end tests that run on Nightwatch. This selenium-based test runner allows us to include integration tests for logging into the admin and clicking through different pages.

To set up credentials and run the tests, check out the README in `/tests/.

License

Copyright © 2015 The New York Public Library, Astor, Lenox, and Tilden Foundations

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Keywords

none

install

npm i simplified-circulation-web

Downloadsweekly downloads

285

version

0.3.7

license

Apache-2.0

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
Report a vulnerability