Skip to main content

Oncall is a calendar tool designed for scheduling and managing on-call shifts

Project description

Oncall Gitter chat Build Status

See admin docs for information on how to run and manage Oncall.

Development setup

Local machine

See instructions for setting up Oncall on your local machine

Prerequisites

  • Debian/Ubuntu - sudo apt-get install libsasl2-dev python3-dev libldap2-dev libssl-dev python-pip python-setuptools mysql-server mysql-client

Install

python setup.py develop
pip install -e '.[dev]'

Setup mysql schema:

mysql -u root -p < ./db/schema.v0.sql

Setup app config by editing configs/config.yaml.

Optionally, you can import dummy data for testing:

mysql -u root -p -o oncall < ./db/dummy_data.sql

Run

One of the following commands:

  • goreman start
  • procman start
  • make serve
  • oncall-dev ./configs/config.yaml

Test

make test

Docker compose

See instructions for using docker compose

Running

make compose

or running docker compose directly:

docker compose up --build

Limitations

  • Doesn't currently provide a mechanism for running tests
  • Requires rebuilding to apply code changes
  • Doesn't tail Python logs to stdout

Contributing

Check out https://github.com/linkedin/oncall/issues for a list of outstanding issues, and tackle any one that catches your interest. Contributions are expected to be tested thoroughly and submitted with unit/end-to-end tests; look in the e2e directory for our suite of end-to-end tests.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

oncall-2.1.7.tar.gz (581.8 kB view details)

Uploaded Source

Built Distribution

oncall-2.1.7-py3-none-any.whl (644.4 kB view details)

Uploaded Python 3

File details

Details for the file oncall-2.1.7.tar.gz.

File metadata

  • Download URL: oncall-2.1.7.tar.gz
  • Upload date:
  • Size: 581.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.2

File hashes

Hashes for oncall-2.1.7.tar.gz
Algorithm Hash digest
SHA256 a78686317eb77e3c4d92b09fce6274535fb7d4f5566a697eba7d828146c93bd9
MD5 9984c13621910e8b7d8007b307c5d2e1
BLAKE2b-256 a4fbdd59d1955c27a0fcf55734e4314948665379f5344c8009be53d9d8ea43bf

See more details on using hashes here.

Provenance

File details

Details for the file oncall-2.1.7-py3-none-any.whl.

File metadata

  • Download URL: oncall-2.1.7-py3-none-any.whl
  • Upload date:
  • Size: 644.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.2

File hashes

Hashes for oncall-2.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 773a3d884b229c745bfa2cf4e60fc5a42931790e4d8db91f8605991d2b89ed7d
MD5 cba3c21648195ed8fc978723b8ec5c35
BLAKE2b-256 7f1da7a62ab1c619bb260e09a777b920519370c339e14b6707df64ba6a36f6a3

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page