1.3.2

CHANGELOG.md

 # v1.3.2
 
-* _TBA_
+* added `read_requirements_txt`
 
 # v1.3.1
 

README.md

@@ -73,3 +73,23 @@ logger = logging.getLogger(__name__)
 
 Otherwise `PyInit` won't be generated by Cython 
 and such module will be unimportable in Python. Normal import won't suffice.
+
+Further streamlining your builds
+--------------------------------
+
+If you add a MANIFEST.in file with contents:
+
+```
+include requirements.txt
+```
+
+Then you can write the following in your setup.py:
+
+```python
+from snakehouse import read_requirements_txt
+
+setup(install_requires=read_requirements_txt())                       
+```
+
+This will read in your requirements.txt and extract packages from there.
+Be sure to entertain it's [pydoc](snakehouse/requirements.py)!

requirements.txt

 Cython
 mako
-satella
+satella>=2.14.46

setup.py

@@ -6,7 +6,7 @@ setup(keywords=['cython', 'extension', 'multiple', 'pyx'],
       packages=find_packages(include=['snakehouse']),
       version=__version__,
       install_requires=[
-            'Cython', 'mako', 'satella',
+            'Cython', 'mako', 'satella>=2.14.46',
       ],
       python_requires='!=2.7.*,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*',
       package_data={

snakehouse/__init__.py

 from .build import build
 from .multibuild import Multibuild
 from .faster_builds import monkey_patch_parallel_compilation
+from .requirements import read_requirements_txt
 
-__version__ = '1.3.2a1'
+__version__ = '1.3.2'

snakehouse/requirements.py

+from satella.files import read_lines
+
+
+def read_requirements_txt(path: str = 'requirements.txt'):
+    """
+    Read requirements.txt and parse it into a list of packages
+    as given by setup(install_required=).
+
+    This means it will read in all lines, discard empty and commented ones,
+    and discard all those who are an URL.
+
+    Remember to include your requirements.txt inside your MANIFEST.in!
+
+    :param path: path to requirements.txt. Default is `requirements.txt`.
+    :return: list of packages ready to be fed to setup(install_requires=)
+    """
+    lines = read_lines(path)
+    lines = (line.strip() for line in lines)
+    lines = (line for line in lines if not line.startswith('#'))
+    lines = (line for line in lines if not line.startswith('git+'))
+    lines = (line for line in lines if not line.startswith('http'))
+    lines = (line for line in lines if line)
+    return list(lines)