Skip to main content

A Python package enabling the secure transfer of data from an insecure sender to an air-gapped computer equipped with a camera.

Project description

Python Project Template

A low dependency and really simple to start project template for Python Projects.

See also

  • Flask-Project-Template for a full feature Flask project including database, API, admin interface, etc.
  • FastAPI-Project-Template The base to start an openapi project featuring: SQLModel, Typer, FastAPI, JWT Token Auth, Interactive Shell, Management Commands.

HOW TO USE THIS TEMPLATE

DO NOT FORK this is meant to be used from Use this template feature.

  1. Click on Use this template
  2. Give a name to your project
    (e.g. my_awesome_project recommendation is to use all lowercase and underscores separation for repo names.)
  3. Wait until the first run of CI finishes
    (Github Actions will process the template and commit to your new repo)
  4. If you want codecov Reports and Automatic Release to PyPI
    On the new repository settings->secrets add your PYPI_API_TOKEN and CODECOV_TOKEN (get the tokens on respective websites)
  5. Read the file CONTRIBUTING.md
  6. Then clone your new project and happy coding!

NOTE: WAIT until first CI run on github actions before cloning your new project.

What is included on this template?

  • 🖼️ Templates for starting multiple application types:
    • Basic low dependency Python program (default) use this template
    • Flask with database, admin interface, restapi and authentication use this template. or Run make init after cloning to generate a new project based on a template.
  • 📦 A basic setup.py file to provide installation, packaging and distribution for your project.
    Template uses setuptools because it's the de-facto standard for Python packages, you can run make switch-to-poetry later if you want.
  • 🤖 A Makefile with the most useful commands to install, test, lint, format and release your project.
  • 📃 Documentation structure using mkdocs
  • 💬 Auto generation of change log using gitchangelog to keep a HISTORY.md file automatically based on your commit history on every release.
  • 🐋 A simple Containerfile to build a container image for your project.
    Containerfile is a more open standard for building container images than Dockerfile, you can use buildah or docker with this file.
  • 🧪 Testing structure using pytest
  • ✅ Code linting using flake8
  • 📊 Code coverage reports using codecov
  • 🛳️ Automatic release to PyPI using twine and github actions.
  • 🎯 Entry points to execute your program using python -m <send2airgap> or $ send2airgap with basic CLI argument parsing.
  • 🔄 Continuous integration using Github Actions with jobs to lint, test and release your project on Linux, Mac and Windows environments.

Curious about architectural decisions on this template? read ABOUT_THIS_TEMPLATE.md
If you want to contribute to this template please open an issue or fork and send a PULL REQUEST.

❤️ Sponsor this project


send2airgap

codecov

CI

Awesome send2airgap created by poing

Install it from PyPI

pip install send2airgap

Usage

from send2airgap import BaseClass
from send2airgap import base_function

BaseClass().base_method()
base_function()
$ python -m send2airgap
#or
$ send2airgap

Development

Read the CONTRIBUTING.md file.

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

send2airgap-0.0.1.tar.gz (7.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

send2airgap-0.0.1-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file send2airgap-0.0.1.tar.gz.

File metadata

  • Download URL: send2airgap-0.0.1.tar.gz
  • Upload date:
  • Size: 7.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.1

File hashes

Hashes for send2airgap-0.0.1.tar.gz
Algorithm Hash digest
SHA256 ae86bdc70cb19eaff56d305d3f25106bb3848d0efa71a1e2f395206bf32d2709
MD5 52c0222833093ecc3b5866f6a0f6013a
BLAKE2b-256 88d322fe70751ed61345779cc3c5f15a6e30588df1545a5a74f1b9cbbaf08e05

See more details on using hashes here.

File details

Details for the file send2airgap-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: send2airgap-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 6.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.1

File hashes

Hashes for send2airgap-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 113c7f03339a50555b7d8a68bd9970713ca1c1c89a11a5e8d39336d9999e8428
MD5 4c0f62b3c9123afc78e25d9ab932d390
BLAKE2b-256 f5160bea4f191686339ca467a5b8034b631e5085d7a6cb85f803ad504fe4e733

See more details on using hashes here.

Supported by

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