Add a page for RPM Python API

We agreed that having examples as scripts in the RPM git repository
would be ideal (syntax highlighting, the possibility to run them, etc)
but for better discoverability, I would like to mention them even from
the RPM website. This way they may be easier to find for people
searching on Google or the website itself.

documentation.md

@@ -29,9 +29,8 @@ This page attempts to track the various relevant documentation that exists for R
 * [How to ensure Large File Support for tools using the rpm API](devel_doc/large_files.html)
 
 ## RPM Language Bindings
-* [RPM Python](https://web.archive.org/web/20050320013335/http://www.ukuug.org/events/linux2004/programme/paper-PNasrat-1/rpm-python-slides/frames.html) slideset / tutorial by Paul Nasrat (2004)
-* [Programming RPM with Python](https://web.archive.org/web/20220628164331/docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html//RPM_Guide/ch-rpm-programming-python.html) from Fedora RPM Guide
-* [Programming RPM with Perl](https://web.archive.org/web/20220628164331/docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html//RPM_Guide/ch-programming-perl.html) from Fedora RPM Guide 
+* [Programming RPM with Python](python.html)
+* [Programming RPM with Perl](https://web.archive.org/web/20220628164331/docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html//RPM_Guide/ch-programming-perl.html) from Fedora RPM Guide
 
 ## Miscellaneous Developer Docs:
   * [Release maintaince](devel_doc/release_maintaince.html)

python.md

@@ -0,0 +1,135 @@
+---
+layout: default
+title: rpm.org - Python RPM
+---
+
+# Python RPM
+
+Searching, querying, installing, and removing RPM packages through Python API.
+
+
+## Presentations
+
+* [RPM Python][slides-paul-nasrat] slideset / tutorial by Paul Nasrat (2004)
+* [Programming RPM with Python][slides-rpm-guide] from Fedora RPM Guide
+
+
+## Examples
+
+Please see the Python API [examples in the RPM repository][examples].
+
+
+### Querying a single package
+
+- A Python equivalent for `rpm -q`
+- Code: [rpm-q.py][rpm-q]
+- Output:
+
+```
+$ python python/examples/rpm-q.py ed
+ed-1.20.2-1.fc40.x86_64
+```
+
+
+### More information about a package
+
+- A Python equivalent for `rpm -qi`
+- Code: [rpm-qi.py][rpm-qi]
+- Output:
+
+```
+$ python python/examples/rpm-qi.py ed
+Name        : ed
+Version     : 1.20.2
+Release     : 1.fc40
+Architecture: x86_64
+Install Date: 1716566271
+Group       : Unspecified
+Size        : 150386
+License     : GPL-2.0-only AND GFDL-1.3-no-invariants-or-later
+Signature   : RSA/SHA256, Wed Apr 24 17:47:49 2024, Key ID 0727707ea15b79cc
+Source RPM  : ed-1.20.2-1.fc40.src.rpm
+Build Date  : 1713973301
+Build Host  : buildvm-x86-07.iad2.fedoraproject.org
+Packager    : Fedora Project
+Vendor      : Fedora Project
+URL         : https://www.gnu.org/software/ed/
+Bug URL     : https://bugz.fedoraproject.org/ed
+Summary     : The GNU line editor
+Description :
+ed is a line-oriented text editor, used to create, display, and modify text
+files (both interactively and via shell scripts). For most purposes, ed has been
+replaced in normal usage by full-screen editors (emacs and vi, for example).
+```
+
+
+### Searching packages
+
+- A Python equivalent for `rpm -qa`
+- Code: [rpm-qa.py][rpm-qa]
+- Output:
+
+```
+$ python python/examples/rpm-qa.py kernel* |tail
+kernel-core-6.10.8-200.fc40.x86_64
+kernel-modules-6.10.8-200.fc40.x86_64
+kernel-devel-6.10.8-200.fc40.x86_64
+kernel-modules-extra-6.10.8-200.fc40.x86_64
+kernel-modules-core-6.10.9-200.fc40.x86_64
+kernel-core-6.10.9-200.fc40.x86_64
+kernel-modules-6.10.9-200.fc40.x86_64
+kernel-devel-6.10.9-200.fc40.x86_64
+kernel-devel-matched-6.10.9-200.fc40.x86_64
+kernel-modules-extra-6.10.9-200.fc40.x86_64
+```
+
+Or listing all installed pacakges:
+
+```
+$ python python/examples/rpm-qa.py |tail
+golang-1.22.7-1.fc40.x86_64
+fakeroot-libs-1.36-1.fc40.x86_64
+fakeroot-1.36-1.fc40.x86_64
+packit-0.101.0-1.fc40.noarch
+google-chrome-stable-129.0.6668.58-1.x86_64
+python3-sqlalchemy1.4-1.4.54-1.fc40.x86_64
+microcode_ctl-2.1-61.3.fc40.x86_64
+ibus-m17n-1.4.32-1.fc40.x86_64
+csdiff-3.5.0-1.fc40.x86_64
+cargo2rpm-0.1.17-1.fc40.noarch
+```
+
+### Installing a package
+
+- A Python equivalent for `rpm -i`
+- Code: [rpm-i.py][rpm-i]
+- Output:
+
+```
+$ sudo python/examples/rpm-i.py hello-2.12.1-4.fc40.x86_64.rpm
+$ hello
+Hello, world!
+```
+
+
+### Erasing a package
+
+
+- A Python equivalent for `rpm -e hello`
+- Code: [rpm-e.py][rpm-e]
+- Output:
+
+```
+$ sudo python/examples/rpm-e.py hello
+```
+
+
+
+[slides-paul-nasrat]: https://web.archive.org/web/20050320013335/http://www.ukuug.org/events/linux2004/programme/paper-PNasrat-1/rpm-python-slides/frames.html
+[slides-rpm-guide]: https://web.archive.org/web/20220628164331/docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html//RPM_Guide/ch-rpm-programming-python.html
+[rpm-examples]: https://github.com/rpm-software-management/rpm/tree/master/python/examples
+[rpm-q]: https://github.com/rpm-software-management/rpm/blob/master/python/examples/rpm-q.py
+[rpm-qi]: https://github.com/rpm-software-management/rpm/blob/master/python/examples/rpm-qi.py
+[rpm-qa]: https://github.com/rpm-software-management/rpm/blob/master/python/examples/rpm-qa.py
+[rpm-i]: https://github.com/rpm-software-management/rpm/blob/master/python/examples/rpm-i.py
+[rpm-e]: https://github.com/rpm-software-management/rpm/blob/master/python/examples/rpm-e.py