| Name | lithio JSON |
| Version |
1.0.3
JSON |
| download |
| home_page | None |
| Summary | A Python-based clone of the GNU install command. |
| upload_time | 2025-04-29 15:47:15 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT |
| keywords |
install
gnu
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Lithio - Python clone of GNU install
Lithio is a Python clone of the GNU `install` command, designed to provide a safe, flexible, and cross-platform solution for installing files and managing file permissions in various environments.
### Installation
#### To install, run (be aware of what the `install.sh` script does):
```bash
bash install.sh
```
> **Note:** The `install.sh` script sets up the package and installs necessary dependencies. Review the script before running it to understand what actions it performs.
#### To install files:
Once installed, you can use `lithio` to install files:
```bash
lithio file1 file2 /path/to/destination
```
This will copy `file1` and `file2` to the specified destination directory.
> **Note:** If you used `install.sh` to install the package, you can install files that require elevated privileges `sudo -E lithio`
#### To install files with `sudo`:
```bash
sudo -E lithio file1 file2 /path/to/destination
```
The `-E` flag preserves the user's environment, which is useful when running the command with `sudo`.
### Features
- **Simple command-line usage**: Install files with ease and flexibility.
- **Checksum validation**: You can validate file integrity using the `--checksum <checksum_file>` option with `--checksum-type`. The `<checksum_file>` should contain a list of file names and their associated hashes in the format `<file_name>:<file_hash>\n`.
- **Usability in scripts**: `lithio` does not require any kind of user interaction, making it ideal for automation.
- **Extendable**: Easily adaptable for future functionalities.
- **More**: More information can be found in the `man` page `man lithio`
### Contributing
Contributions are welcome! If you have suggestions, bug reports, or improvements, please open an issue or submit a pull request.
1. Fork the repository
2. Create a new branch (\`git checkout -b feature-branch\`)
3. Commit your changes (\`git commit -am 'Add new feature'\`)
4. Push to the branch (\`git push origin feature-branch\`)
5. Create a new pull request
Make sure to add tests and documentation for your changes.
### License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
### Contact
For questions, you can reach me at [voyager-2019@outlook.com](mailto:voyager-2019@outlook.com).
### Acknowledgments
- Inspired by the GNU \`install\` command
- Thanks to the contributors who helped improve this project!
Raw data
{
"_id": null,
"home_page": null,
"name": "lithio",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "install, GNU",
"author": null,
"author_email": "voyager-2021 <voyager-2019@outlook.com>",
"download_url": "https://files.pythonhosted.org/packages/02/49/f903d372a4b5772d4f303effc2e41b763ba7d4e28f7b1a40d3b58856e29d/lithio-1.0.3.tar.gz",
"platform": null,
"description": "\n# Lithio - Python clone of GNU install\n\nLithio is a Python clone of the GNU `install` command, designed to provide a safe, flexible, and cross-platform solution for installing files and managing file permissions in various environments.\n\n### Installation\n\n#### To install, run (be aware of what the `install.sh` script does):\n```bash\nbash install.sh\n```\n\n> **Note:** The `install.sh` script sets up the package and installs necessary dependencies. Review the script before running it to understand what actions it performs.\n\n#### To install files:\nOnce installed, you can use `lithio` to install files:\n\n```bash\nlithio file1 file2 /path/to/destination\n```\n\nThis will copy `file1` and `file2` to the specified destination directory.\n\n> **Note:** If you used `install.sh` to install the package, you can install files that require elevated privileges `sudo -E lithio`\n\n#### To install files with `sudo`:\n\n```bash\nsudo -E lithio file1 file2 /path/to/destination\n```\n\nThe `-E` flag preserves the user's environment, which is useful when running the command with `sudo`.\n\n### Features\n- **Simple command-line usage**: Install files with ease and flexibility.\n- **Checksum validation**: You can validate file integrity using the `--checksum <checksum_file>` option with `--checksum-type`. The `<checksum_file>` should contain a list of file names and their associated hashes in the format `<file_name>:<file_hash>\\n`.\n- **Usability in scripts**: `lithio` does not require any kind of user interaction, making it ideal for automation.\n- **Extendable**: Easily adaptable for future functionalities.\n- **More**: More information can be found in the `man` page `man lithio`\n\n### Contributing\n\nContributions are welcome! If you have suggestions, bug reports, or improvements, please open an issue or submit a pull request.\n\n1. Fork the repository\n2. Create a new branch (\\`git checkout -b feature-branch\\`)\n3. Commit your changes (\\`git commit -am 'Add new feature'\\`)\n4. Push to the branch (\\`git push origin feature-branch\\`)\n5. Create a new pull request\n\nMake sure to add tests and documentation for your changes.\n\n### License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n### Contact\n\nFor questions, you can reach me at [voyager-2019@outlook.com](mailto:voyager-2019@outlook.com).\n\n### Acknowledgments\n\n- Inspired by the GNU \\`install\\` command\n- Thanks to the contributors who helped improve this project!",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python-based clone of the GNU install command.",
"version": "1.0.3",
"project_urls": {
"homepage": "https://github.com/voyager-2021/lithio",
"repository": "https://github.com/voyager-2021/lithio"
},
"split_keywords": [
"install",
" gnu"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a4967c84544cf102a4efe3ba96ce78bc564a980b4dcb69a3e433f73ccca12817",
"md5": "c125288b22af9f9326d8532eaf32cd6a",
"sha256": "6bf47e5f4d0d071eb80121e31a13dead2ab7d75686b59c4391dbe2e4ed99d23c"
},
"downloads": -1,
"filename": "lithio-1.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c125288b22af9f9326d8532eaf32cd6a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 5639,
"upload_time": "2025-04-29T15:47:14",
"upload_time_iso_8601": "2025-04-29T15:47:14.337798Z",
"url": "https://files.pythonhosted.org/packages/a4/96/7c84544cf102a4efe3ba96ce78bc564a980b4dcb69a3e433f73ccca12817/lithio-1.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0249f903d372a4b5772d4f303effc2e41b763ba7d4e28f7b1a40d3b58856e29d",
"md5": "6ee3c138c283b6510ef115259c66a60d",
"sha256": "aa474e98b4d501082cb66f2ac19c4d4dc02f3f209543231a7556b80df4b29076"
},
"downloads": -1,
"filename": "lithio-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "6ee3c138c283b6510ef115259c66a60d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 4744,
"upload_time": "2025-04-29T15:47:15",
"upload_time_iso_8601": "2025-04-29T15:47:15.289866Z",
"url": "https://files.pythonhosted.org/packages/02/49/f903d372a4b5772d4f303effc2e41b763ba7d4e28f7b1a40d3b58856e29d/lithio-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-04-29 15:47:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "voyager-2021",
"github_project": "lithio",
"github_not_found": true,
"lcname": "lithio"
}
