| Name | smartie JSON |
| Version |
4.0.4
JSON |
| download |
| home_page | None |
| Summary | A pure-python S.M.A.R.T library. |
| upload_time | 2024-11-07 05:04:15 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | None |
| keywords |
hardware
monitor
sensors
smart
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# SMARTie
This is a pure-python, 0-dependency library for getting basic disk information
such as model, serial number, disk health, temperature, and SMART data. It
supports both SCSI/ATA and NVMe devices.
## Documentation
Read the getting started guide and API documentation at
https://tkte.ch/smartie/.
## Installation
SMARTie currently requires Python 3.8 or greater.
```
pip install smartie
```
If you want the command line tools, you'll also want to do:
```
pip install smartie[cli]
```
## FAQ
### This library isn't returning any of my drives?
The APIs this library uses to communicate with devices typically require
root (on Linux) or administrator (on Windows) access to work.
### My drive doesn't work with this library?
Support for drives that don't follow modern standards is still a work in
progress. Open an [issue][].
### Library Y does X, can I copy that code?
**It depends.** This library is available under the MIT license and is a fun side
project. I want anyone to be able to use it. Many existing projects are GPL or
LGPL, so you need to avoid them when contributing to this project. Instead:
- Use the specifications or vendor documentation whenever possible.
- Use the SG_IO documentation by Danny (https://sg.danny.cz/sg/).
- Use the _conversations_ in mailing lists and bug trackers, while avoiding the
code.
### Does this library support RAID controllers?
Some RAID/HBA controllers are known to work and others should as well. If
you're using a RAID controller, and it doesn't work, open an [issue][].
| RAID/HBA Adapter | OS under test| SCSI Supported | ATA Supported |
|--------------------|--------------|----------------|---------------|
| Broadcom RAID 9440 | CentOS 8.4 | Yes | Yes |
| Broadcom RAID 9560 | CentOS 8.4 | Yes | Yes |
| Broadcom HBA 9500 | CentOS 8.4 | Yes | Yes |
| ThinkSystem 930 | CentOS 8.4 | Yes | Yes |
| ThinkSystem 940 | CentOS 8.4 | Yes | Yes |
| ThinkSystem 4350 | CentOS 8.4 | Yes | Yes |
| ThinkSystem 5350 | CentOS 8.4 | Yes | Yes |
Only ``INQUIRY``, ``IDENTIFY`` and ``SMART``-related commands are tested, and
the tests use the latest driver from vendor support web. If it does not work in
your environment, open an [issue][]. The compatibility should be same as
[pydiskcmd][]. Find the testing methodology [here][testingpdc].
### ATA, ATAPI, SCSI, NVMe, what?
Acronyms, acronyms everywhere! What does any of this mean?
- [ATA]: Advanced Technology Attachment.
- [ATAPI]: AT Attachment Packet Interface.
- [SCSI]: Small Computer System Interface.
- [NVMe]: Non-Volatile Memory Express. The standard for connecting "modern" solid-state
drives to a computer, typically through [PCI-e].
- [SATA]: Serial ATA.
- [PATA]: Parallel ATA.
- [S.M.A.R.T]: Self-Monitoring, Analysis, and Reporting Technology. A standard for
hard drives and solid-state drives to report their health and status.
[ATA]: https://en.wikipedia.org/wiki/ATA
[ATAPI]: https://en.wikipedia.org/wiki/ATAPI
[SCSI]: https://en.wikipedia.org/wiki/SCSI
[NVMe]: https://en.wikipedia.org/wiki/NVMe
[PCI-e]: https://en.wikipedia.org/wiki/PCI_Express
[SATA]: https://en.wikipedia.org/wiki/SATA
[PATA]: https://en.wikipedia.org/wiki/Parallel_ATA
[S.M.A.R.T]: https://en.wikipedia.org/wiki/S.M.A.R.T.
[phm]: https://github.com/TkTech/PortableHardwareMonitor
[issue]: https://github.com/TkTech/smartie/issues/new.
[pydiskcmd]: https://github.com/jackeichen/pydiskcmd?tab=readme-ov-file#raidhba-support
[testingpdc]: https://github.com/jackeichen/pydiskcmd/blob/main/raid_support_matrix_with_smartie.txt
Raw data
{
"_id": null,
"home_page": null,
"name": "smartie",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "hardware, monitor, sensors, smart",
"author": null,
"author_email": "Tyler Kennedy <tk@tkte.ch>",
"download_url": "https://files.pythonhosted.org/packages/e3/e9/f4883d6027927e41d22c95e47922290e59850b4d393fab45830dd2f07d00/smartie-4.0.4.tar.gz",
"platform": null,
"description": "\n\n# SMARTie\n\nThis is a pure-python, 0-dependency library for getting basic disk information\nsuch as model, serial number, disk health, temperature, and SMART data. It\nsupports both SCSI/ATA and NVMe devices.\n\n## Documentation\n\nRead the getting started guide and API documentation at\nhttps://tkte.ch/smartie/.\n\n## Installation\nSMARTie currently requires Python 3.8 or greater.\n\n```\npip install smartie\n```\n\nIf you want the command line tools, you'll also want to do:\n\n```\npip install smartie[cli]\n```\n\n## FAQ\n\n### This library isn't returning any of my drives?\n\nThe APIs this library uses to communicate with devices typically require\nroot (on Linux) or administrator (on Windows) access to work.\n\n### My drive doesn't work with this library?\n\nSupport for drives that don't follow modern standards is still a work in\nprogress. Open an [issue][].\n\n### Library Y does X, can I copy that code?\n\n**It depends.** This library is available under the MIT license and is a fun side\nproject. I want anyone to be able to use it. Many existing projects are GPL or\nLGPL, so you need to avoid them when contributing to this project. Instead:\n\n- Use the specifications or vendor documentation whenever possible.\n- Use the SG_IO documentation by Danny (https://sg.danny.cz/sg/).\n- Use the _conversations_ in mailing lists and bug trackers, while avoiding the\n code.\n\n### Does this library support RAID controllers?\n\nSome RAID/HBA controllers are known to work and others should as well. If\nyou're using a RAID controller, and it doesn't work, open an [issue][].\n\n| RAID/HBA Adapter | OS under test| SCSI Supported | ATA Supported |\n|--------------------|--------------|----------------|---------------|\n| Broadcom RAID 9440 | CentOS 8.4 | Yes | Yes |\n| Broadcom RAID 9560 | CentOS 8.4 | Yes | Yes |\n| Broadcom HBA 9500 | CentOS 8.4 | Yes | Yes |\n| ThinkSystem 930 | CentOS 8.4 | Yes | Yes |\n| ThinkSystem 940 | CentOS 8.4 | Yes | Yes |\n| ThinkSystem 4350 | CentOS 8.4 | Yes | Yes |\n| ThinkSystem 5350 | CentOS 8.4 | Yes | Yes |\n\nOnly ``INQUIRY``, ``IDENTIFY`` and ``SMART``-related commands are tested, and\nthe tests use the latest driver from vendor support web. If it does not work in\nyour environment, open an [issue][]. The compatibility should be same as\n[pydiskcmd][]. Find the testing methodology [here][testingpdc].\n\n### ATA, ATAPI, SCSI, NVMe, what?\n\nAcronyms, acronyms everywhere! What does any of this mean?\n\n- [ATA]: Advanced Technology Attachment.\n- [ATAPI]: AT Attachment Packet Interface.\n- [SCSI]: Small Computer System Interface. \n- [NVMe]: Non-Volatile Memory Express. The standard for connecting \"modern\" solid-state\n drives to a computer, typically through [PCI-e].\n- [SATA]: Serial ATA. \n- [PATA]: Parallel ATA.\n- [S.M.A.R.T]: Self-Monitoring, Analysis, and Reporting Technology. A standard for\n hard drives and solid-state drives to report their health and status.\n\n[ATA]: https://en.wikipedia.org/wiki/ATA\n[ATAPI]: https://en.wikipedia.org/wiki/ATAPI\n[SCSI]: https://en.wikipedia.org/wiki/SCSI\n[NVMe]: https://en.wikipedia.org/wiki/NVMe\n[PCI-e]: https://en.wikipedia.org/wiki/PCI_Express\n[SATA]: https://en.wikipedia.org/wiki/SATA\n[PATA]: https://en.wikipedia.org/wiki/Parallel_ATA\n[S.M.A.R.T]: https://en.wikipedia.org/wiki/S.M.A.R.T.\n[phm]: https://github.com/TkTech/PortableHardwareMonitor\n[issue]: https://github.com/TkTech/smartie/issues/new.\n[pydiskcmd]: https://github.com/jackeichen/pydiskcmd?tab=readme-ov-file#raidhba-support\n[testingpdc]: https://github.com/jackeichen/pydiskcmd/blob/main/raid_support_matrix_with_smartie.txt\n",
"bugtrack_url": null,
"license": null,
"summary": "A pure-python S.M.A.R.T library.",
"version": "4.0.4",
"project_urls": {
"Repository": "https://github.com/tktech/smartie"
},
"split_keywords": [
"hardware",
" monitor",
" sensors",
" smart"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c0cf3a051fb4940569d52f4d3c719a5a97536069b1cf96c4337c8b917b589cb9",
"md5": "f34eafac1ef3bb2950ba222e814d3035",
"sha256": "9e6732362db881916ed05315b8951cae74f5a36cff8f457edcb4cbfc2bfea33d"
},
"downloads": -1,
"filename": "smartie-4.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f34eafac1ef3bb2950ba222e814d3035",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 35406,
"upload_time": "2024-11-07T05:04:14",
"upload_time_iso_8601": "2024-11-07T05:04:14.285110Z",
"url": "https://files.pythonhosted.org/packages/c0/cf/3a051fb4940569d52f4d3c719a5a97536069b1cf96c4337c8b917b589cb9/smartie-4.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e3e9f4883d6027927e41d22c95e47922290e59850b4d393fab45830dd2f07d00",
"md5": "b8df6a3e137bc53373cd92ef4c1b068a",
"sha256": "98162893c16b50379b2d4b9479587238f4305175c38947faf1e6c1bf6606d4e6"
},
"downloads": -1,
"filename": "smartie-4.0.4.tar.gz",
"has_sig": false,
"md5_digest": "b8df6a3e137bc53373cd92ef4c1b068a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 333819,
"upload_time": "2024-11-07T05:04:15",
"upload_time_iso_8601": "2024-11-07T05:04:15.706390Z",
"url": "https://files.pythonhosted.org/packages/e3/e9/f4883d6027927e41d22c95e47922290e59850b4d393fab45830dd2f07d00/smartie-4.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-07 05:04:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tktech",
"github_project": "smartie",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "smartie"
}
