aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorAdam Stokes <adam.stokes@ubuntu.com>2013-04-04 20:50:59 -0400
committerAdam Stokes <adam.stokes@ubuntu.com>2013-04-04 20:50:59 -0400
commit0c48b167ea53362b67c46a10c17ee7bc9ea9887a (patch)
tree0c4871eb82bc7611cdc29e6711861f26b506422e /README.md
parent76156e8b7a8b7a31e30038819d0aa0d7ca5de197 (diff)
downloadsos-0c48b167ea53362b67c46a10c17ee7bc9ea9887a.tar.gz
Fix unittests and more pep8 conforming
- In our unittest we defined 'is_installed' to be a bool when in fact we wanted to verify if a package is installed via the _method_ is is_installed. Since overriding that method with our variable definition we basically removed any functionality of 'is_installed' method in Plugin class. - Initializing a fake plugin to test was failing due to our global logger not being initialized. Put a simple check in the library to make sure the logger is defined no matter what the calling state does. - Make import selinux conditional - Add travis-ci support - Rename README to utilize travis-ci build status and other markdown supported features Signed-off-by: Adam Stokes <adam.stokes@ubuntu.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md40
1 files changed, 40 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..d4205e7d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+[![Build Status](https://travis-ci.org/battlemidget/sosreport.png?branch=develop)](https://travis-ci.org/battlemidget/sosreport)
+
+This set of tools is designed to provide information to support organizations
+in an extensible manner, allowing third parties, package maintainers, and
+anyone else to provide plugins that will collect and report information that
+is useful for supporting software packages.
+
+This project is hosted at http://github.com/sosreport/sosreport For the latest
+version, to contribute, and for more information, please visit there.
+
+To access to the public source code repository for this project run:
+
+```
+git clone git://github.com/sosreport/sosreport.git
+```
+
+### Manual Installation ###
+
+```
+to install locally (as root) ==> make install
+to build an rpm ==> make rpm
+to build a deb ==> make deb-unsign
+to build a zipfile for use with jython ==> make zip
+```
+
+### Pre-built Packaging ###
+
+Fedora/RHEL users install via yum:
+
+```
+yum install sos
+```
+
+Debian/Ubuntu users can install via PPA:
+
+```
+sudo add-apt-repository ppa:debugmonkeys/sosreport
+sudo apt-get update
+sudo apt-get install sos
+```