Skip to main content

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

This project has been archived.

The maintainers of this project have marked this project as archived. No new releases are expected.

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://github.com/koterpillar/mybox/releases/latest/download/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-3.1.0.tar.gz (39.3 kB view details)

Uploaded Source

Built Distribution

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

mybox-3.1.0-py3-none-any.whl (53.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for mybox-3.1.0.tar.gz
Algorithm Hash digest
SHA256 98682b3c0af3266e1ba4572b617ac8ac3b007409dc1b4459c0a3cdbdb19f97f3
MD5 eb0283ab377c1f45e5ef09ed73eb6282
BLAKE2b-256 ee0bf3343cc19425da15c27b6dae26d6fadce5751828154520947af737bc7903

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for mybox-3.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7d3f5cdf56f5dfbb919d2896f0c7cd847d7ba635f2449b87bc07dbb189acd4e7
MD5 23e042a9d0ae7dd96e6903542b3fc2f5
BLAKE2b-256 7b2c8e03af7f2de7703dce3362cca62fd5fea9ea8b98338d4895b76fedb255af

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