From d7eb35f4ee49cbb8fe065db445a84000883d69b5 Mon Sep 17 00:00:00 2001 From: Anton Hvornum Date: Wed, 22 Nov 2023 22:24:29 +0100 Subject: Nuking docs to allow for redirect (ouff) (#2245) --- docs/examples/python.rst | 96 ------------------------------------------------ 1 file changed, 96 deletions(-) delete mode 100644 docs/examples/python.rst (limited to 'docs/examples/python.rst') diff --git a/docs/examples/python.rst b/docs/examples/python.rst deleted file mode 100644 index 7fb3f6c3..00000000 --- a/docs/examples/python.rst +++ /dev/null @@ -1,96 +0,0 @@ -.. _examples.python: - -Python module -============= - -Archinstall supports running in `module mode `_. -The way the library is invoked in module mode is limited to executing scripts under the `scripts`_ folder. - -It's therefore important to place any script or profile you wish to invoke in the examples folder prior to building and installing. - -Pre-requisites --------------- - -We'll assume you've followed the :ref:`installing.python.manual` method. -Before actually installing the library, you will need to place your custom installer-scripts under `scripts`_ as a python file. - -More on how you create these in the next section. - -.. warning:: - - This is subject to change in the future as this method is currently a bit stiff. The script path will become a parameter. But for now, this is by design. - -Creating a script ------------------ - -Lets create a `test_installer` - installer as an example. This is assuming that the folder `./archinstall` is a git-clone of the main repo. -We begin by creating "`scripts`_:code:`/test_installer.py`". The placement here is important later. - -This script can now already be called using :code:`python -m archinstall test_installer` after a successful installation of the library itself. -But the script won't do much. So we'll do something simple like list all the hard drives as an example. - -To do this, we'll begin by importing :code:`archinstall` in our "`scripts`_:code:`/test_installer.py`" and call a function whtin ``archinstall``. - -.. code-block:: python - - import archinstall - - print(archinstall.disk.device_handler.devices) - -Now, go ahead and reference the :ref:`installing.python.manual` installation method. -After runnig ``python -m archinstall test_installer`` it should print something that looks like: - -.. code-block:: text - - [ - BDevice( - disk=, - device_info=_DeviceInfo( - model='PC801 NVMe SK hynix 512GB', - path=PosixPath('/dev/nvme0n1'), - type='nvme', - total_size=Size(value=512110190592, unit=, - sector_size=SectorSize(value=512, unit=)), - free_space_regions=[ - , - , - ], - sector_size=SectorSize(value=512, unit=), - read_only=False, - dirty=False - ), - partition_infos=[ - _PartitionInfo( - partition=, - name='primary', - type=, - fs_type=, - path='/dev/nvme0n1p1', - start=Size(value=2048, unit=, sector_size=SectorSize(value=512, unit=)), - length=Size(value=535822336, unit=, sector_size=SectorSize(value=512, unit=)), - flags=[ - , - - ], - partn=1, - partuuid='a26be943-c193-41f4-9930-9341cf5f6b19', - uuid='6EE9-2C00', - disk=, - mountpoints=[ - PosixPath('/boot') - ], - btrfs_subvol_infos=[] - ), - _PartitionInfo(...) - ] - ) - ] - -That means your script is in the right place, and ``archinstall`` is working as intended. - -.. note:: - - Most calls, including the one above requires `root `_ privileges. - - -.. _scripts: https://github.com/archlinux/archinstall/tree/master/archinstall/scripts \ No newline at end of file -- cgit v1.2.3-70-g09d2