Release 1.1

Conflicts:
	docs/conf.py

Author: Shakeel Mohamed

.gitignore

@@ -13,3 +13,5 @@ proxy.log
 MANIFEST
 coverage_report
 test.log
+examples/*/local
+examples/*/metadata

CHANGELOG.md

@@ -1,4 +1,24 @@
-# Splunk Python SDK Changelog
+# Splunk SDK for Python Changelog
+
+## Version 1.1
+
+### New features and APIs
+
+* Added support for building modular input scripts in Python using the Splunk
+  SDK for Python.
+
+### Minor additions
+
+* Added 2 modular input examples: `Github forks` and `random numbers`.
+
+* Added a `dist` command to `setup.py`. Running `setup.py dist` will generate
+  2 `.spl` files for the new modular input example apps.
+
+* `client.py` in  the `splunklib` module will now restart Splunk via an HTTP
+  post request instead of an HTTP get request.
+
+* `.gitignore` has been updated to ignore `local` and `metadata` subdirectories
+for any examples.
 
 ## Version 1.0
 

README.md

@@ -1,8 +1,8 @@
-# The Splunk Python Software Development Kit
+# The Splunk Software Development Kit for Python
 
-#### Version 1.0
+#### Version 1.1
 
-The Splunk Python Software Development Kit (SDK)  contains library code and 
+The Splunk Software Development Kit (SDK) for Python contains library code and 
 examples designed to enable developers to build applications using Splunk.
 
 Splunk is a search engine and analytic environment that uses a distributed
@@ -19,9 +19,9 @@ technology used by the Splunk product to build exciting new applications that
 are enabled by Splunk's unique capabilities.
 
 
-## Getting started with the Splunk Python SDK
+## Getting started with the Splunk SDK for Python
 
-The Splunk Python SDK contains library code and examples that show how to 
+The Splunk SDK for Python contains library code and examples that show how to 
 programmatically interact with Splunk for a variety of scenarios including 
 searching, saved searches, data inputs, and many more, along with building 
 complete applications. 
@@ -31,11 +31,11 @@ in-depth information be sure to visit the
 [Splunk Developer Portal](http://dev.splunk.com/view/SP-CAAAEBB). 
 ### Requirements
 
-Here's what you need to get going with the Splunk Python SDK.
+Here's what you need to get going with the Splunk SDK for Python.
 
 #### Python
 
-The Splunk Python SDK requires Python 2.6+. 
+The Splunk SDK for Python requires Python 2.6+. 
 
 #### Splunk
 
@@ -44,15 +44,15 @@ If you haven't already installed Splunk, download it
 Splunk and system requirements, see 
 [Installing & Running Splunk](http://dev.splunk.com/view/SP-CAAADRV). 
 
-#### Splunk Python SDK
-Get the Splunk Python SDK from [GitHub](https://github.com/) and clone the 
-resources to your computer. For example, use the following command: 
+#### Splunk SDK for Python
+Get the Splunk SDK for Python; [download the SDK as a ZIP](http://dev.splunk.com/view/SP-CAAAEBB) 
+and extract the files. Or, if you want to contribute to the SDK, clone the 
+repository from [GitHub](https://github.com/splunk/splunk-sdk-python).
 
-    git clone https://github.com/splunk/splunk-sdk-python.git
 
 ### Installing the SDK
 
-You can install the Splunk Python SDK libraries by using `easy_install` or `pip`:
+You can install the Splunk SDK for Python libraries by using `easy_install` or `pip`:
 
     [sudo] easy_install splunk-sdk
 
@@ -151,7 +151,7 @@ To get help for an example, use the `--help` argument with an example:
 
 #### Unit tests
 
-The Splunk Python SDK contains a collection of unit tests. To run them, open a 
+The Splunk SDK for Python contains a collection of unit tests. To run them, open a 
 command prompt in the **/splunk-sdk-python** directory and enter:
 
     python setup.py test
@@ -220,10 +220,10 @@ If you need to know more:
   [Splunk Developer Portal](http://dev.splunk.com).
 
 * For conceptual and how-to documentation, see the 
-  [Overview of the Splunk Python SDK](http://dev.splunk.com/view/SP-CAAAEBB).
+  [Overview of the Splunk SDK for Python](http://dev.splunk.com/view/SP-CAAAEBB).
 
 * For API reference documentation, see the 
-  [Splunk Python SDK Reference](http://docs.splunk.com/Documentation/PythonSDK).
+  [Splunk SDK for Python Reference](http://docs.splunk.com/Documentation/PythonSDK).
 
 * For more about the Splunk REST API, see the 
   [REST API Reference](http://docs.splunk.com/Documentation/Splunk/latest/RESTAPI).
@@ -281,7 +281,7 @@ If you would like to contribute to the SDK, go here for more information:
 
 1. You will be granted support if you or your company are already covered 
    under an existing maintenance/support agreement. Send an email to 
-   _support@splunk.com_ and include "Splunk Python SDK" in the subject line. 
+   _support@splunk.com_ and include "Splunk SDK for Python" in the subject line. 
 
 2. If you are not covered under an existing maintenance/support agreement, you 
    can find help through the broader community at:

docs/conf.py

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Splunk Python SDK documentation build configuration file, created by
+# Splunk SDK for Python documentation build configuration file, created by
 # sphinx-quickstart on Fri Apr 13 12:28:15 2012.
 #
 # This file is execfile()d with the current directory set to its containing dir.
@@ -110,7 +110,7 @@
 html_title = "Splunk SDK for Python API Reference"
 
 # A shorter title for the navigation bar.  Default is the same as html_title.
-#html_short_title = "Splunk Python SDK Reference"
+#html_short_title = "Splunk SDK for Python Reference"
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.

docs/index.rst

@@ -1,5 +1,5 @@
-Welcome to the API reference for the Splunk Python SDK, which describes the modules that are included in the Splunk Python SDK.
-For more information about the SDK, see the `Splunk Developer Portal <http://dev.splunk.com/view/python-sdk/SP-CAAAEBB>`_.
+Welcome to the API reference for the Splunk SDK for Python, which describes the modules that are included in the SDK.
+For more information, see the `Splunk Developer Portal <http://dev.splunk.com/view/python-sdk/SP-CAAAEBB>`_.
 
 .. toctree::
    :maxdepth: 2
@@ -122,3 +122,20 @@ For more information about the SDK, see the `Splunk Developer Portal <http://dev
     :class:`~splunklib.results.ResultsReader` class 
 
     :class:`~splunklib.results.Message` class 
+
+:doc:`modularinput`
+--------------
+
+    :class:`~splunklib.modularinput.Argument` class 
+
+    :class:`~splunklib.modularinput.Event` class 
+
+    :class:`~splunklib.modularinput.EventWriter` class 
+
+    :class:`~splunklib.modularinput.InputDefinition` class 
+
+    :class:`~splunklib.modularinput.Scheme` class 
+    
+    :class:`~splunklib.modularinput.Script` class 
+    
+    :class:`~splunklib.modularinput.ValidationDefinition` class 

docs/modularinput.rst

@@ -0,0 +1,25 @@
+splunklib.modularinput
+--------------
+
+.. automodule:: splunklib.modularinput
+
+.. autoclass:: Argument
+    :members: 
+
+.. autoclass:: Event
+    :members: 
+
+.. autoclass:: EventWriter
+    :members: 
+
+.. autoclass:: InputDefinition
+    :members: 
+
+.. autoclass:: Scheme
+    :members: 
+
+.. autoclass:: Script
+    :members: 
+
+.. autoclass:: ValidationDefinition
+    :members: 

examples/async/async.py

@@ -15,7 +15,7 @@
 # under the License.
 
 # A sample that demonstrates a custom HTTP handler for the Splunk service,
-# as well as showing how you could use the Splunk Python SDK with coroutine
+# as well as showing how you could use the Splunk SDK for Python with coroutine
 # based systems like Eventlet.
 
 #### Main Code

examples/export/export.py

@@ -28,7 +28,7 @@
 # splunk support files
 from splunklib.binding import connect
 try:
-    from utils import error, parse
+    from utils import parse
 except ImportError:
     raise Exception("Add the SDK repository to your PYTHONPATH to run the examples "
                     "(e.g., export PYTHONPATH=~/splunk-sdk-python.")
@@ -329,7 +329,9 @@ def main():
 
     if path.exists(options.kwargs['output']):
         if options.kwargs['recover'] == False:
-            error("Export file %s exists, and recover option nor specified" % options.kwargs['output'], exitcode=1)
+            print "Export file %s exists, and recover option nor specified" % \
+                  options.kwargs['output']
+            sys.exit(1)
         else:
             options.kwargs['end'] = recover(options)
             options.kwargs['fixtail'] = True

examples/github_forks/README/inputs.conf.spec

@@ -0,0 +1,5 @@
+[github_forks://<name>]
+*Streams events giving the number of forks of a GitHub repository
+
+owner = <value>
+repo_name = <value>

examples/github_forks/default/app.conf

@@ -0,0 +1,11 @@
+[install]
+is_configured = 0
+
+[ui]
+is_visible = 1
+label = Github Repository Forks
+
+[launcher]
+author=Splunk
+description=Streams events giving the number of forks of a GitHub repository
+version = 1.0