Add RPM spec files

These RPMs won't get distributed officially (yet?), but they may be
useful for people who are not comfortable with python & pip
installations, and would prefer a simple dnf installation.

Signed-off-by: Stephen Brennan <[email protected]>

Author: brenns10

Makefile

@@ -80,7 +80,11 @@ _release_sanity_check:
 	    echo error: It looks like you have not bumped the version since last release.; \
 	    exit 1; \
 	fi
-	if [ -z "$$(grep -Pzo $(shell echo $(VERSION) | sed 's/\./\\./g')"[^\n]+\n-+\n" CHANGELOG.rst)" ]; then \
+	@if [ -z "$$(grep -P "^Version:\s+$(shell echo $(VERSION) | sed 's/\./\\./g')" buildrpm/yo.spec)" ]; then \
+	    echo error: It looks like you have not updated buildrpm/yo.spec; \
+	    exit 1; \
+	fi 2>/dev/null
+	@if [ -z "$$(grep -Pzo $(shell echo $(VERSION) | sed 's/\./\\./g')"[^\n]+\n-+\n" CHANGELOG.rst)" ]; then \
 	    echo error: It looks like you have not documented this release in CHANGELOG.rst; \
 	    exit 1; \
 	fi 2>/dev/null
@@ -95,8 +99,15 @@ _release_sanity_check:
 prerelease: _release_sanity_check test
 	@echo "Safe to release $(VERSION)"
 
+.PHONY: rpm
+rpm:
+	git archive HEAD --format=tar.gz --prefix=yo-$(VERSION)/ -o buildrpm/v$(VERSION).tar.gz
+	rpmbuild --define "_sourcedir $$(pwd)/buildrpm" \
+	         --define "_topdir $$(pwd)/buildrpm/tmp" \
+	         -ba buildrpm/yo.spec
+
 .PHONY: release
-release: _release_sanity_check test
+release: _release_sanity_check test rpm
 	@if [ ! $$(git symbolic-ref -q HEAD) = "refs/heads/main"  ]; then \
 	    echo error: You must be on main to release a new version.; \
 	    exit 1; \

buildrpm/.gitignore

@@ -0,0 +1,2 @@
+tmp/
+v*.tar.gz

buildrpm/yo.spec

@@ -0,0 +1,53 @@
+# Copyright (c) 2025, Oracle and/or its affiliates.
+# Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl/
+Name:           yo
+Version:        1.9.0
+Release:        0%{?dist}
+Summary:        A fast and simple CLI client for managing OCI instances
+
+License:        UPL
+URL:            https://github.com/oracle/yo
+Source:         https://github.com/oracle/yo/archive/refs/tags/v%{version}.tar.gz
+
+BuildArch:      noarch
+BuildRequires:  python3-devel
+BuildRequires:  python3dist(sphinx)
+BuildRequires:  python3dist(sphinx-argparse)
+BuildRequires:  python3dist(pytest)
+
+%global _description %{expand:
+yo is a command-line client for managing OCI instances. It makes launching OCI
+instances as simple as rudely telling your computer "yo, launch an instance".
+Its goals are speed, ease of use, and simplicity.
+...}
+
+%description %_description
+
+%prep
+%autosetup -p1 -n yo-%{version}
+echo -n "dnf" >yo/data/pkgman
+
+
+%build
+%pyproject_wheel
+
+
+%install
+%pyproject_install
+%pyproject_save_files yo
+sphinx-build --color -W -bhtml doc %{buildroot}/%{_docdir}/yo
+
+
+%check
+%pytest tests/
+
+
+%files -n yo -f %{pyproject_files}
+%doc %{_docdir}/yo
+%doc README.*
+%{_bindir}/yo
+
+
+%changelog
+* Wed Apr 9 2025 Stephen Brennan <[email protected]> - 1.9.0-0
+- Initial packaging of 1.9.0

doc/development.rst

@@ -65,6 +65,47 @@ Simply run the following command from the root of the git repo:
    on your whole system. If you'd prefer not to have this risk, then don't use
    this method!
 
+Building an RPM
+---------------
+
+Yo has an RPM spec file at ``buildrpm/yo.spec``, which can be used to build an
+RPM on Oracle Linux 9+, and likely Fedora as well. The RPMs themselves are not
+currently officially built or distributed, but they can be built easily. These
+instructions are for Oracle Linux 9. Similar instructions will likely work for
+Oracle Linux 10, but Oracle Linux 8 does not contain necessary dependencies.
+
+First, install the build requirements:
+
+.. code:: bash
+
+   sudo dnf install -y oracle-epel-release-el9 \
+                       oraclelinux-developer-release-el9 \
+                       pyproject-rpm-macros
+   sudo dnf builddep -y buildrpm/yo.spec
+
+
+There are two ways to build the RPM. First is by using the current git tree to
+build, and the second is to fetch the latest release from Github and build from
+that source.
+
+To use the current git tree, first ensure that all your changes are committed.
+The source distribution is built using ``git archive``, so only committed
+changes are included. You may also want to update the spec file to tweak the
+"Release" value, if you do not have a release tag checked out. Then:
+
+.. code:: bash
+
+    make rpm
+
+To download the source tarball from Github and then build:
+
+.. code:: bash
+
+    cd buildrpm
+    spectool -gS yo.spec
+    rpmbuild --define "_sourcedir `pwd`" --define "_topdir `pwd`/tmp" -ba yo.spec
+
+
 Creating and Testing Changes
 ----------------------------