v0.1.6(.4) Added scripts directory & ouiupdate.py

CHANGES

@@ -197,4 +197,6 @@ v 0.1.6 Continue with STA functionality
    - no significant change but will reduce bytecode size
   o fixed error in iswireless (referenced in wifiphisher #329)
   o fixed phylist failure for OpenWRT as pointed out by sarom5
-  o Corrected README.md (Issue #27)
+  o Corrected README.md (Issue #27)
+  o Added scripts directory
+   - added ouiupdate.py to scripts directory

README.md

@@ -1,4 +1,4 @@
-# PyRIC 0.1.6.3: Python Radio Interface Controller
+# PyRIC 0.1.6.4: Python Radio Interface Controller
 ## Linux wireless library for the Python Wireless Developer and Pentester
 ![](docs/logo.png?raw=true)
 
@@ -187,12 +187,11 @@ form t = (error code,error message).
 ...     #handle the error
 ```
 
-Work is ongoing to help clarify some of the error messages returned by default
-by os.strerror for example. 
-
 Read the user guide, or type dir(pyw) in your console to get a full listing
 of all pyw functions.
 
+The examples below can also be run with named arguments.
+
 ### a. System/Wireless Core Functionality
 These functions do not work with a specific device rather with the system.
 
@@ -867,3 +866,5 @@ with (-) are not included in pip installs or PyPI downloads
       * nsearch.py        nl80211 search
       * commands.help     nl80211 commands help data
       * attributes.help   nl80211 attributes help data
+    + scripts             script subpackage
+      * ouiupdate         fetch oui.txt & update oui dict

TODO

@@ -22,4 +22,6 @@
  39) parsing wiphy_bands (should we add the below?)
    o _HT_MCS_SET: a 16-bit attr containing the MCS set as defined in 802.11n
    o _HT_CAPA: as in the HT information IE
+ 40) add IEEE update (should we modify to use pickle or keep as?)
+ 41) add command line versions as scripts? i.e. up, down, macchanger etc
 

docs/PyRIC.tex

@@ -73,7 +73,7 @@
     basicstyle=\footnotesize
 }
 
-\title{\includegraphics[scale=1]{logo}\\ PyRIC v0.1.6.3: User Manual}
+\title{\includegraphics[scale=1]{logo}\\ PyRIC v0.1.6.4: User Manual}
 \author{Dale V. Patterson\\ [email protected]}
 
 \begin{document}
@@ -1121,7 +1121,7 @@ \subsection{Functions}
 \end{enumerate}
 
 \section{Copyright and License}\label{sec:copy}
-PYRIC: Python Radio Interface Controller v0.1.6.3\\
+PYRIC: Python Radio Interface Controller v0.1.6.4\\
 
 Copyright (C) 2016  Dale V. Patterson ([email protected])\\
 

pyric/__init__.py

@@ -39,8 +39,8 @@
 
 __name__ = 'pyric'
 __license__ = 'GPLv3'
-__version__ = '0.1.6.3'
-__date__ = 'December 2016'
+__version__ = '0.1.6.4'
+__date__ = 'January 2017'
 __author__ = 'Dale Patterson'
 __maintainer__ = 'Dale Patterson'
 __email__ = '[email protected]'
@@ -84,7 +84,7 @@ def strerror(errno):
 
 # define long description
 long_desc = """
-# PyRIC 0.1.6.3: Python Radio Interface Controller
+# PyRIC 0.1.6.4: Python Radio Interface Controller
 ## Linux wireless library for the Python Wireless Developer and Pentester
 
 ## DESCRIPTION:

pyric/scripts/__init__.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python
+""" scripts PyRIC scripts
+
+Copyright (C) 2016  Dale V. Patterson ([email protected])
+
+This program is free software: you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation, either version 3 of the License, or (at your option) any later
+version.
+
+Redistribution and use in source and binary forms, with or without modifications,
+are permitted provided that the following conditions are met:
+ o Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+ o Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+ o Neither the name of the orginal author Dale V. Patterson nor the names of any
+   contributors may be used to endorse or promote products derived from this
+   software without specific prior written permission.
+
+ scripts 0.0.1
+  desc: currently only holds ouiupdate for fetching oui file from IEEE and
+  updating PyRIC oui dict
+  includes: ouiupdate 0.1.1
+  changes:
+
+"""
+
+__name__ = 'scripts'
+__license__ = 'GPLv3'
+__version__ = '0.0.1'
+__date__ = 'January 2017'
+__author__ = 'Dale Patterson'
+__maintainer__ = 'Dale Patterson'
+__email__ = '[email protected]'
+__status__ = 'Production'

pyric/scripts/ouiupdate.py

@@ -0,0 +1,52 @@
+#!/usr/bin/env python
+
+""" ouiupdate.py: get ouis data from IEEE
+
+Copyright (C) 2016  Dale V. Patterson ([email protected])
+
+This program is free software:you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation,either version 3 of the License,or (at your option) any later
+version.
+
+Redistribution and use in source and binary forms,with or without modifications,
+are permitted provided that the following conditions are met:
+ o Redistributions of source code must retain the above copyright notice,this
+   list of conditions and the following disclaimer.
+ o Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+ o Neither the name of the orginal author Dale V. Patterson nor the names of any
+   contributors may be used to endorse or promote products derived from this
+   software without specific prior written permission.
+
+Fetchs and stores oui data from IEEE
+
+"""
+from __future__ import print_function  # python 2to3 compability
+
+#__name__ = 'ouiupdate'
+__license__ = 'GPLv3'
+__version__ = '0.0.1'
+__date__ = 'January 2017'
+__author__ = 'Dale Patterson'
+__maintainer__ = 'Dale Patterson'
+__email__ = '[email protected]'
+__status__ = 'Production'
+
+import argparse as ap
+import pyric.utils.ouifetch as ouifetch
+
+if __name__ == '__main__':
+    # create arg parser and parse command line args
+    print("IEEE OUI Fetch")
+    argp = ap.ArgumentParser(description="IEEE OUI fetch and parse")
+    argp.add_argument('-p','--path',help="Path to write parsed file")
+    argp.add_argument('-v','--verbose',action='store_true',help="Display operations to stdout")
+    argp.add_argument('--version',action='version',version="OUI Fetch {0}".format(__version__))
+    args = argp.parse_args()
+    verbose = args.verbose
+    path = args.path
+
+    # execute
+    ouifetch.fetch(path,verbose)