Skip to main content

Manage the configuration and tools on your workstation without bothering the OS too much

Project description

Mybox

🖥️ This is a box. 📦 And it is mine. 🐱

There are many 🍱 nice things in there. I wouldn't want 🧰 to be without them.

Even if I move 🏠 or work 🏢 I want to be comfortable.


Manage the configuration and tools on your workstation without bothering the OS too much (maybe your favorite one isn't supported by $WORK or you have different ones for different roles).

Values

  1. Earlier points override latter ones, unless there is a huge gain.
  2. The system is usable with the software the user specified.
  3. Meta requirements (e.g. archivers and package managers) are installed the same way user requirements are.
  4. Everything is installed and upgraded to the latest version every time.
  5. Superuser access is not required.

Usage

  • Run the bootstrap script:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/koterpillar/mybox/main/bootstrap)"
    
  • Run mybox from the directory with package definitions.

    For package definition examples, see koterpillar/desktop.

  • To install optional components, add their names as arguments, e.g. mybox development.

Development

Pre-requisites (see install-dev for ways to install):

Run ./lint to check style & types, ./lint --format to apply formatting automatically.

Run ./test-script to execute the project's tests.

Running locally

  • Run poetry install.
  • Run poetry shell.
  • In the launched shell, go to the directory with package definitions.
  • Run mybox with the desired arguments.

Releasing

Releases are done using Semantic Release, see build.yml.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

mybox-2.8.3.tar.gz (39.7 kB view details)

Uploaded Source

Built Distribution

mybox-2.8.3-py3-none-any.whl (51.9 kB view details)

Uploaded Python 3

File details

Details for the file mybox-2.8.3.tar.gz.

File metadata

  • Download URL: mybox-2.8.3.tar.gz
  • Upload date:
  • Size: 39.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.10

File hashes

Hashes for mybox-2.8.3.tar.gz
Algorithm Hash digest
SHA256 4d10a69a5145f68b36de8a5af7ead06c9794c1e2eb4149a656eaa42818c1f732
MD5 42fc7a4747c2aa9e3921d9a0c8d2e6d0
BLAKE2b-256 46a6c64b53715ae7f1aed16a2f2dd13a2b5bfb04dfb4d992ba068cd12e9c8691

See more details on using hashes here.

File details

Details for the file mybox-2.8.3-py3-none-any.whl.

File metadata

  • Download URL: mybox-2.8.3-py3-none-any.whl
  • Upload date:
  • Size: 51.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.10

File hashes

Hashes for mybox-2.8.3-py3-none-any.whl
Algorithm Hash digest
SHA256 d4bb28b2d4884aba2c68bdc86b04bd6b3218350d16c94cd31d9fcf1383592b5b
MD5 6e936cf3fd297e6371b47cf38ee4da57
BLAKE2b-256 1b822282e67a2e0c189b5ee22e3c57d5cdb93a8dd46d3b1f1b6bba5b87c6f113

See more details on using hashes here.

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