# 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
0. Earlier points override latter ones, unless there is a huge gain.
1. The system is usable with the software the user specified.
2. Meta requirements (e.g. archivers and package managers) are installed the
same way user requirements are.
3. Everything is installed and upgraded to the latest version every time.
4. Superuser access is not required.
## Usage
* Run the [bootstrap](bootstrap) script:
```shell
/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](https://github.com/koterpillar/desktop/).
* To install optional components, add their names as arguments, e.g.
`mybox development`.
## Development
Pre-requisites (see [install-dev](install-dev) for ways to install):
* [Poetry](https://python-poetry.org/)
* [ShellCheck](https://www.shellcheck.net/)
Run [`./lint`](lint) to check style & types, `./lint --format` to apply
formatting automatically.
Run [`./test-script`](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](.github/workflows/build.yml).
Raw data
{
"_id": null,
"home_page": "https://github.com/koterpillar/mybox",
"name": "mybox",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": null,
"keywords": null,
"author": "Alexey Kotlyarov",
"author_email": "a@koterpillar.com",
"download_url": "https://files.pythonhosted.org/packages/d8/22/6e166c682dbe7db22617627ca388fda98f867f2601f57c03781b0dcbf9aa/mybox-2.10.2.tar.gz",
"platform": null,
"description": "# Mybox\n\n\ud83d\udda5\ufe0f This is a box. \ud83d\udce6 And it is mine. \ud83d\udc31\n\nThere are many \ud83c\udf71 nice things in there. I wouldn't want \ud83e\uddf0 to be without them.\n\nEven if I move \ud83c\udfe0 or work \ud83c\udfe2 I want to be comfortable.\n\n---\n\nManage the configuration and tools on your workstation without bothering the OS\ntoo much (maybe your favorite one isn't supported by `$WORK` or you have\ndifferent ones for different roles).\n\n## Values\n\n0. Earlier points override latter ones, unless there is a huge gain.\n1. The system is usable with the software the user specified.\n2. Meta requirements (e.g. archivers and package managers) are installed the\n same way user requirements are.\n3. Everything is installed and upgraded to the latest version every time.\n4. Superuser access is not required.\n\n## Usage\n\n* Run the [bootstrap](bootstrap) script:\n\n ```shell\n /bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/koterpillar/mybox/main/bootstrap)\"\n ```\n\n* Run `mybox` from the directory with package definitions.\n\n For package definition examples, see\n [koterpillar/desktop](https://github.com/koterpillar/desktop/).\n\n* To install optional components, add their names as arguments, e.g.\n `mybox development`.\n\n## Development\n\nPre-requisites (see [install-dev](install-dev) for ways to install):\n\n* [Poetry](https://python-poetry.org/)\n* [ShellCheck](https://www.shellcheck.net/)\n\nRun [`./lint`](lint) to check style & types, `./lint --format` to apply\nformatting automatically.\n\nRun [`./test-script`](test-script) to execute the project's tests.\n\n### Running locally\n\n* Run `poetry install`.\n* Run `poetry shell`.\n* In the launched shell, go to the directory with package definitions.\n* Run `mybox` with the desired arguments.\n\n### Releasing\n\nReleases are done using Semantic Release, see [build.yml](.github/workflows/build.yml).\n\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "Manage the configuration and tools on your workstation without bothering the OS too much",
"version": "2.10.2",
"project_urls": {
"Homepage": "https://github.com/koterpillar/mybox",
"Repository": "https://github.com/koterpillar/mybox"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3f945b14abc012e86f9fa46f1e169693bc7c16211254dedd870d1ef2e02e60d1",
"md5": "72cfd2b05a635eb9472faf63ab30b1b7",
"sha256": "36c303e307a67585efab1bed0d55bff3dce3116b87a94d2b17b9cb25fc1de8e3"
},
"downloads": -1,
"filename": "mybox-2.10.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "72cfd2b05a635eb9472faf63ab30b1b7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 52113,
"upload_time": "2024-12-06T20:33:46",
"upload_time_iso_8601": "2024-12-06T20:33:46.241810Z",
"url": "https://files.pythonhosted.org/packages/3f/94/5b14abc012e86f9fa46f1e169693bc7c16211254dedd870d1ef2e02e60d1/mybox-2.10.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d8226e166c682dbe7db22617627ca388fda98f867f2601f57c03781b0dcbf9aa",
"md5": "2d6a30bc7c521e57a7e83647287f8227",
"sha256": "d9d1dc153faab46eab03276666e8151f2d1fe59eced5ddb40a2220b9609acd6e"
},
"downloads": -1,
"filename": "mybox-2.10.2.tar.gz",
"has_sig": false,
"md5_digest": "2d6a30bc7c521e57a7e83647287f8227",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 39809,
"upload_time": "2024-12-06T20:33:48",
"upload_time_iso_8601": "2024-12-06T20:33:48.066226Z",
"url": "https://files.pythonhosted.org/packages/d8/22/6e166c682dbe7db22617627ca388fda98f867f2601f57c03781b0dcbf9aa/mybox-2.10.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-06 20:33:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "koterpillar",
"github_project": "mybox",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "mybox"
}