Skip to content

Commit

Permalink
Documentation updated for the new utility functions and partitions
Browse files Browse the repository at this point in the history
  • Loading branch information
petersulyok committed Oct 23, 2022
1 parent be813f2 commit bed252a
Show file tree
Hide file tree
Showing 12 changed files with 310 additions and 81 deletions.
14 changes: 8 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,26 +11,28 @@ Disk information Python library can assist in collecting disk information on Lin
- collect information about a specific disk
- explore existing disks in the system
- translate between traditional and persistent disk names
- read disk temperature
- read SMART data of the disk
- read current disk temperature
- read SMART data of a disk
- read partition list of a disk

Installation
------------
Standard installation from [pypi.org](https://pypi.irg):
Standard installation from [pypi.org](https://pypi.org):

pip install diskinfo

The package requires Python version >= `3.7`.

Demo
----
The library contains a simple demo, it can be executed in the following way:
The library contains multiple demo screens ([`rich`](https://pypi.org/project/rich) needs to be installed):

pip install rich
python -m diskinfo.demo

<img src="https://github.com/petersulyok/diskinfo/raw/main/docs/diskinfo_rich_demo.png" align="left">
![Demo screen](https://github.com/petersulyok/diskinfo/raw/main/docs/diskinfo_rich_demo.png)

Please note that [rich](https://pypi.org/project/rich/) Python library needs to be installed for this colorful demo.
See more demo screens in the [documentation](https://diskinfo.readthedocs.io/en/latest/intro.html#demo).

API documentation
-----------------
Expand Down
5 changes: 4 additions & 1 deletion docs/source/api.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
API reference
=============
In this section you will find the detailed API reference about the implemented classes of ``diskinfo`` library.
In this section you will find the detailed API reference about the implemented classes and functions
of ``diskinfo`` library.

.. toctree::

Expand All @@ -9,4 +10,6 @@ In this section you will find the detailed API reference about the implemented c
disksmart.rst
smartattr.rst
nvmeattr.rst
partition.rst
diskinfo.rst
utils.rst
2 changes: 1 addition & 1 deletion docs/source/disk.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.. py:currentmodule:: diskinfo
``Disk`` class
`Disk` class
--------------
.. autoclass:: Disk
:members:
2 changes: 1 addition & 1 deletion docs/source/diskinfo.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.. py:currentmodule:: diskinfo
``DiskInfo`` class
`DiskInfo` class
------------------
.. autoclass:: DiskInfo
:members:
2 changes: 1 addition & 1 deletion docs/source/disksmart.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.. py:currentmodule:: diskinfo
``DiskSmartData`` class
`DiskSmartData` class
-----------------------
.. autoclass:: DiskSmartData
:members:
2 changes: 1 addition & 1 deletion docs/source/disktype.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
.. py:currentmodule:: diskinfo
``DiskType`` class
`DiskType` class
------------------
.. autoclass:: DiskType
:members:
Loading

0 comments on commit bed252a

Please sign in to comment.