make into pip installable package

README.md

@@ -37,10 +37,11 @@ for element in function(Bucket='my-bucket'):
 
 This library provides that function.
 
-## Installation and usage
+## Installation
 
-Download `wrapper.py`, save it in the same directory as the file calling it.
-(I'll eventually make it `pip` installable.)
+`pip install bbp`
+
+## Usage
 
 Here's an example of how to use it for the [Lambda `ListFunctions` paginator](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda.html#Lambda.Paginator.ListFunctions).
 
@@ -72,4 +73,7 @@ for obj in paginator('s3', 'list_objects_v2', 'Contents', Bucket='mybucket'):
 * `Bucket='mybucket'` and any other `name=value` arguments are what get passed to [the paginator](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3.html#S3.Paginator.ListObjectsV2).
 
 
+## Packaging
 
+This is my first ever package on PyPI.
+I used [this guide](https://medium.com/@joel.barmettler/how-to-upload-your-python-package-to-pypi-65edc5fe9c56) to learn how to do this.

bbp/__init__.py

@@ -0,0 +1 @@
+from .wrapper import paginator

lambda_example.py

@@ -1,4 +1,4 @@
-from wrapper import paginator
+from bbp import paginator
 from pprint import pprint
 for lam in paginator('lambda', 'list_functions', 'Functions'):
         pprint(lam) # process a single resource

s3_example.py

@@ -1,4 +1,4 @@
-from wrapper import paginator
+from bbp import paginator
 from pprint import pprint
 bucket_name = 'reddit-amp-bot-code'
 for obj in paginator('s3', 'list_objects_v2', 'Contents', Bucket=bucket_name):

setup.cfg

@@ -0,0 +1,3 @@
+# Inside of setup.cfg
+[metadata]
+description-file = README.md

setup.py

@@ -0,0 +1,25 @@
+from distutils.core import setup
+setup(
+  name = 'bbp',         # How you named your package folder (MyLib)
+  packages = ['bbp'],   # Chose the same as "name"
+  version = '0.1',      # Start with a small number and increase it with every change you make
+  license='GPLv3', 
+  description = 'A wrapper for boto3 paginators to iterate per resource',
+  author = 'Matthew Davis',
+  author_email = '[email protected]',
+  url = 'https://github.com/mlda065/bbp',   # Provide either the link to your github or to your website
+  download_url = 'https://github.com/mlda065/bbp/archive/v_01.tar.gz',
+  keywords = ['boto3', 'boto', 'AWS', 'Amazon', 'paginator', 'pagination', 'page', 'api', 'cloud'],
+  install_requires=['boto3'],
+  classifiers=[
+    'Development Status :: 3 - Alpha',      # Chose either "3 - Alpha", "4 - Beta" or "5 - Production/Stable" as the current state of your package
+    'Intended Audience :: Developers',
+    'Topic :: Software Development :: Build Tools',
+    'License :: OSI Approved :: GPLv3 License',
+    'Programming Language :: Python :: 3',      #Specify which pyhton versions that you want to support
+    'Programming Language :: Python :: 3.4',
+    'Programming Language :: Python :: 3.5',
+    'Programming Language :: Python :: 3.6',
+    'Programming Language :: Python :: 3.7'
+  ],
+)