summaryrefslogtreecommitdiff
path: root/docs/source/docs/quickstart.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/docs/quickstart.rst')
-rw-r--r--docs/source/docs/quickstart.rst96
1 files changed, 96 insertions, 0 deletions
diff --git a/docs/source/docs/quickstart.rst b/docs/source/docs/quickstart.rst
new file mode 100644
index 0000000..a0384e6
--- /dev/null
+++ b/docs/source/docs/quickstart.rst
@@ -0,0 +1,96 @@
+Quickstart
+==========
+
+Adding lines to ``fstab``::
+
+ >>> from reconfigure.configs import FSTabConfig
+ >>> from reconfigure.items.fstab import FilesystemData
+ >>>
+ >>> config = FSTabConfig(path='/etc/fstab')
+ >>> config.load()
+ >>> print config.tree
+ {
+ "filesystems": [
+ {
+ "passno": "0",
+ "device": "proc",
+ "mountpoint": "/proc",
+ "freq": "0",
+ "type": "proc",
+ "options": "nodev,noexec,nosuid"
+ },
+ {
+ "passno": "1",
+ "device": "UUID=dfccef1e-d46c-45b8-969d-51391898c55e",
+ "mountpoint": "/",
+ "freq": "0",
+ "type": "ext4",
+ "options": "errors=remount-ro"
+ }
+ ]
+ }
+ >>> tmpfs = FilesystemData()
+ >>> tmpfs.mountpoint = '/srv/cache'
+ >>> tmpfs.type = 'tmpfs'
+ >>> tmpfs.device = 'none'
+ >>> config.tree.filesystems.append(tmpfs)
+ >>> config.save()
+ >>> quit()
+ $ cat /etc/fstab
+ proc /proc proc nodev,noexec,nosuid 0 0
+ UUID=dfccef1e-d46c-45b8-969d-51391898c55e / ext4 errors=remount-ro 0 1
+ none /srv/cache tmpfs none 0 0
+
+Changing Samba settings::
+
+ >>> from reconfigure.configs import SambaConfig
+ >>> config = SambaConfig(path='/etc/samba/smb.conf')
+ >>> config.load()
+ >>> print config.tree.shares
+ [
+ {
+ "comment": "All Printers",
+ "browseable": false,
+ "create_mask": "0700",
+ "name": "printers",
+ "directory_mask": "0755",
+ "read_only": true,
+ "guest_ok": false,
+ "path": "/var/spool/samba"
+ },
+ {
+ "comment": "Printer Drivers",
+ "browseable": true,
+ "create_mask": "0744",
+ "name": "print$",
+ "directory_mask": "0755",
+ "read_only": true,
+ "guest_ok": false,
+ "path": "/var/lib/samba/printers"
+ }
+ ]
+ >>> config.tree.shares[0].guest_ok = True
+ >>> print config.tree.shares
+ [
+ {
+ "comment": "All Printers",
+ "browseable": false,
+ "create_mask": "0700",
+ "name": "printers",
+ "directory_mask": "0755",
+ "read_only": true,
+ "guest_ok": true,
+ "path": "/var/spool/samba"
+ },
+ {
+ "comment": "Printer Drivers",
+ "browseable": true,
+ "create_mask": "0744",
+ "name": "print$",
+ "directory_mask": "0755",
+ "read_only": true,
+ "guest_ok": false,
+ "path": "/var/lib/samba/printers"
+ }
+ ]
+ >>> config.save()