Skip to main content

Log Keeper

661 VGS - All-in-one log keeper for the Viking fleet. Records launches from 2965D log sheets, uploads to MongoDB Atlas, and provides a web interface for viewing statistics.

image

Contents

  1. Installation
  2. Usage
  3. Contribution
  4. Testing
  5. Support
  6. License

Installation

  1. Sync your squadron sharepoint using OneDrive:

    image

  2. Create a directory on your sharepoint to store the log sheets e.g. Log Sheets.

  3. Save the 2965B_YYMMDD_ZEXXX.xlsx template (See docs/) into the Log Sheets directory.

    image

  4. Get started with creating some log sheets to test it out. Note, you will need to update the hidden INPUT_DATA sheet to add your aircraft and pilots:

    image

  5. Sign up to MongoDB Atlas. Contact the project owner for access to the database.

Usage

Normal Usage

  1. Login to the dashboard:

    Dashboard login

  2. Upload your completed log sheets. Note, the re-uploading log sheets will overwrite the existing data:

    Upload page

Python Dashboard

  1. The log keeper comes with a python dashboard for viewing statistics. To run the dashboard, setup the secrets. NOTE, you must have a MongoDB Atlas account and access to the database (get this from the project owner).:

    echo "MONGO_URI=<YOUR_MONGO_URI>" > .streamlit/secrets.toml
    echo "OPS_FORM_URL=<YOUR_OPS_FORM_URL>" >> .streamlit/secrets.toml
    # COOKIE_SECRET keeps users logged in across page refreshes. Generate one:
    echo "COOKIE_SECRET=\"$(python -c 'from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())')\"" >> .streamlit/secrets.toml
    

    When deploying to Streamlit Community Cloud, add the same secrets (MONGO_URI, OPS_FORM_URL, COOKIE_SECRET) under the app's Settings → Secrets. If COOKIE_SECRET is omitted the app still works, but logins are not persisted across refreshes. Rotating it logs everyone out once.

  2. run the following command:

    viking-dashboard
    

    image

Contribution

image

Testing

To run the tests, run the following commands:

playwright install
python -m pytest

Support

For questions and assistance, consider raising an issue on the issue tracker. All other queries can be directed to mjennings061@gmail.com

License

The project is licensed under the MIT License.

Metadata

Release files for viking-log-keeper 3.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for viking-log-keeper 3.0.0
File Size Uploaded
viking_log_keeper-3.0.0.tar.gz 414.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for viking-log-keeper 3.0.0
File Interpreter ABI Platform
viking_log_keeper-3.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 816.3 kB

Release files / viking_log_keeper-3.0.0.tar.gz

Download URL viking_log_keeper-3.0.0.tar.gz
Size 414.1 kB
Tags Source
SHA-256 checksum
How to use checksums
975fd02c017d14e8fb6b3efd94967723119a301c2779671601d45c752d625eed
BLAKE2b-256 checksum
How to use checksums
d169479248dc324a7590654fcde3a6953a5749b63ace164108089420031a0451
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.16

Release files / viking_log_keeper-3.0.0-py3-none-any.whl

Download URL viking_log_keeper-3.0.0-py3-none-any.whl
Size 402.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
86e1fc3b47ef36bdf91feefc03f9c0e7d5d401d995c297190e412b553c804309
BLAKE2b-256 checksum
How to use checksums
5046b83a3b09db3d7dade122a7b78a4c3beef02f1e636c8588a2cac88af0cd54
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.16

Release history Release notifications | RSS feed

This release

3.0.0 This release

2 release files

2.7.0

2 release files

2.6.0

2 release files

2.5.0

2 release files

2.4.0

2 release files

2.2.6

2 release files

2.2.0

2 release files

2.1.0

2 release files

2.0.0

2 release files

1.6.0

2 release files

1.5.0

2 release files

1.4.0

2 release files

1.3.2

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.0

2 release files

0.9.0

2 release files

0.8.0

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page