Merge branch 'release/0.4'

Author: virantha

CHANGES.rst

@@ -2,6 +2,7 @@
 Version  Date       Changes
 -------  --------   ------
 
+v0.4     10/28/13   Added early Evernote upload support
 v0.3.1   10/24/13   Path fix on windows
 v0.3     10/23/13   Added filing of converted pdfs using a configuration file to specify target directories based on keyword matches in the pdf text
 v0.2.2   10/22/13   Added a console script to put the pypdfocr script into your bin

README.md

@@ -1,16 +1,16 @@
 # PyPDFOCR
-This program will help manage your scanned PDFs for you.  It can do the following:
+This program will help manage your scanned PDFs by doing the following:
 
 - Take a scanned PDF file and run OCR on it (using free OCR tools), generating a searchable PDF
 - Optionally, watch a folder for incoming scanned PDFs and automatically run OCR on them
 - Optionally, file the scanned PDFs into directories based on simple keyword matching that you specify
-- _Coming soon_: Evernote auto-upload and filing
+- **New:** Evernote auto-upload and filing based on keyword search
 
 More links:
 
-- [Blog](http://virantha.com/categories/projects/pypdfocr)
-- [Documentation](http://documentup.com/virantha/pypdfocr)
-- [Source](https://www.github.com/virantha/pypdfocr)
+- [Blog @ virantha.com](http://virantha.com/category/projects/pypdfocr)
+- [Documentation @ documentup.com](http://documentup.com/virantha/pypdfocr)
+- [Source @ github](https://www.github.com/virantha/pypdfocr)
 
 
 ## Usage: 
@@ -24,7 +24,7 @@ More links:
 
     --> Every time a pdf file is added to `watch_directory` it will be OCR'ed
 
-### Automatic filing (new!):
+### Automatic filing:
 To automatically move the OCR'ed pdf to a directory based on a keyword, use the -f option
 and specify a configuration file (described below):
 
@@ -75,9 +75,53 @@ commented out, your original PDF will stay where it was found.
 If there is any naming conflict during filing, the program will add an underscore followed by a
 number to each filename, in order to avoid overwriting files that may already be present.
 
+### Evernote upload(new!):
+#### Evernote authentication token
+To enable Evernote support, you will need to [get a developer token for your 
+Evernote account.](https://www.evernote.com/api/DeveloperToken.action).  You
+should note that this script will never delete or modify existing notes in your
+account, and limits itself to creating new Notebooks and Notes.
+Once you get that token, you copy and paste it into your configuration file
+as shown below
+
+#### Evernote filing usage
+To automatically upload the OCR'ed pdf to a folder based on a keyword, use the
+``-e`` option instead of the ``-f`` auto filing option.
+
+    pypdfocr filename.pdf -e -c config.yaml
+
+Similarly, you can also do this in folder monitoring mode:
+
+    pypdfocr -w watch_directory -e -c config.yaml
+
+#### Evernote filing configuration file
+The config file shown above only needs to change slightly. The folders section
+is completely unchanged, but note that ``target_folder`` is the name of your
+"Notebook stack" in Evernote, and the ``default_folder`` should just be the
+default Evernote upload notebook name.
+
+    target_folder: "evernote_stack"
+    default_folder: "default"
+    original_move_folder: "docs/originals"
+    evernote_developer_token: "YOUR_TOKEN"
+   
+    folders:
+        finances:
+            - american express
+            - chase card
+            - internal revenue service
+        travel:
+            - boarding pass
+            - airlines
+            - expedia
+            - orbitz
+        receipts:
+            - receipt
 ## Caveats
-This code is brand-new, and is barely commented with no unit-tests included.  I plan to improve 
-things as time allows in the near-future.  Sphinx code generation is on my TODO list.
+This code is brand-new, and incorporation of unit-testing is just starting.  I
+plan to improve things as time allows in the near-future.  Sphinx code
+generation is on my TODO list.  The software is distributed on an "AS IS"
+BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 
 ## Installation
 ### Using pip
@@ -114,7 +158,7 @@ These can all be installed via pip:
 
 You will also need to install the external dependencies listed below.
 
-## External Dependencies:
+## External Dependencies
 PyPDFOCR relies on the following (free) programs being installed and in the path:
 
 - Tesseract OCR software https://code.google.com/p/tesseract-ocr/

README.rst

@@ -1,22 +1,23 @@
 PyPDFOCR
 ========
 
-This program will help manage your scanned PDFs for you. It can do the
-following:
+This program will help manage your scanned PDFs by doing the following:
 
 -  Take a scanned PDF file and run OCR on it (using free OCR tools),
    generating a searchable PDF
 -  Optionally, watch a folder for incoming scanned PDFs and
    automatically run OCR on them
 -  Optionally, file the scanned PDFs into directories based on simple
    keyword matching that you specify
--  *Coming soon*: Evernote auto-upload and filing
+-  **New:** Evernote auto-upload and filing based on keyword search
 
 More links:
 
--  `Blog <http://virantha.com/categories/projects/pypdfocr>`__
--  `Documentation <http://documentup.com/virantha/pypdfocr>`__
--  `Source <https://www.github.com/virantha/pypdfocr>`__
+-  `Blog @
+   virantha.com <http://virantha.com/category/projects/pypdfocr>`__
+-  `Documentation @
+   documentup.com <http://documentup.com/virantha/pypdfocr>`__
+-  `Source @ github <https://www.github.com/virantha/pypdfocr>`__
 
 Usage:
 ------
@@ -39,8 +40,8 @@ Folder monitoring:
 
     --> Every time a pdf file is added to `watch_directory` it will be OCR'ed
 
-Automatic filing (new!):
-~~~~~~~~~~~~~~~~~~~~~~~~
+Automatic filing:
+~~~~~~~~~~~~~~~~~
 
 To automatically move the OCR'ed pdf to a directory based on a keyword,
 use the -f option and specify a configuration file (described below):
@@ -104,12 +105,72 @@ If there is any naming conflict during filing, the program will add an
 underscore followed by a number to each filename, in order to avoid
 overwriting files that may already be present.
 
+Evernote upload(new!):
+~~~~~~~~~~~~~~~~~~~~~~
+
+Evernote authentication token
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+To enable Evernote support, you will need to `get a developer token for
+your Evernote
+account. <https://www.evernote.com/api/DeveloperToken.action>`__. You
+should note that this script will never delete or modify existing notes
+in your account, and limits itself to creating new Notebooks and Notes.
+Once you get that token, you copy and paste it into your configuration
+file as shown below
+
+Evernote filing usage
+^^^^^^^^^^^^^^^^^^^^^
+
+To automatically upload the OCR'ed pdf to a folder based on a keyword,
+use the ``-e`` option instead of the ``-f`` auto filing option.
+
+::
+
+    pypdfocr filename.pdf -e -c config.yaml
+
+Similarly, you can also do this in folder monitoring mode:
+
+::
+
+    pypdfocr -w watch_directory -e -c config.yaml
+
+Evernote filing configuration file
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The config file shown above only needs to change slightly. The folders
+section is completely unchanged, but note that ``target_folder`` is the
+name of your "Notebook stack" in Evernote, and the ``default_folder``
+should just be the default Evernote upload notebook name.
+
+::
+
+    target_folder: "evernote_stack"
+    default_folder: "default"
+    original_move_folder: "docs/originals"
+    evernote_developer_token: "YOUR_TOKEN"
+
+    folders:
+        finances:
+            - american express
+            - chase card
+            - internal revenue service
+        travel:
+            - boarding pass
+            - airlines
+            - expedia
+            - orbitz
+        receipts:
+            - receipt
+
 Caveats
 -------
 
-This code is brand-new, and is barely commented with no unit-tests
-included. I plan to improve things as time allows in the near-future.
-Sphinx code generation is on my TODO list.
+This code is brand-new, and incorporation of unit-testing is just
+starting. I plan to improve things as time allows in the near-future.
+Sphinx code generation is on my TODO list. The software is distributed
+on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+either express or implied.
 
 Installation
 ------------
@@ -141,11 +202,14 @@ Clone the source directly from github (you need to have git installed):
 
     git clone https://github.com/virantha/pypdfocr.git
 
-Then, install the following third-party python libraries: - PIL (Python
-Imaging Library) http://www.pythonware.com/products/pil/ - ReportLab
-(PDF generation library) http://www.reportlab.com/software/opensource/ -
-Watchdog (Cross-platform fhlesystem events monitoring)
-https://pypi.python.org/pypi/watchdog - PyPDF2 (Pure python pdf library)
+Then, install the following third-party python libraries:
+
+-  PIL (Python Imaging Library) http://www.pythonware.com/products/pil/
+-  ReportLab (PDF generation library)
+   http://www.reportlab.com/software/opensource/
+-  Watchdog (Cross-platform fhlesystem events monitoring)
+   https://pypi.python.org/pypi/watchdog
+-  PyPDF2 (Pure python pdf library)
 
 These can all be installed via pip:
 
@@ -158,8 +222,8 @@ These can all be installed via pip:
 
 You will also need to install the external dependencies listed below.
 
-External Dependencies:
-----------------------
+External Dependencies
+---------------------
 
 PyPDFOCR relies on the following (free) programs being installed and in
 the path:

dist/pypdfocr.exe

@@ -13,6 +13,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+import smtplib
 import argparse
 import sys, os
 import logging
@@ -28,6 +29,7 @@
 from pypdfocr_watcher import PyPdfWatcher
 from pypdfocr_pdffiler import PyPdfFiler
 from pypdfocr_filer_dirs import PyFilerDirs
+from pypdfocr_filer_evernote import PyFilerEvernote
 
 def error(text):
     print("ERROR: %s" % text)
@@ -86,6 +88,7 @@ def get_options(self, argv):
             :ivar watch_dir: Directory to watch for files to convert
             :ivar config: Dict of the config file
             :ivar watch: Whether folder watching mode is turned on
+            :ivar enable_evernote: Enable filing to evernote
 
         """
         p = argparse.ArgumentParser(
@@ -117,6 +120,8 @@ def get_options(self, argv):
             default=False, dest='enable_filing', help='Enable filing of converted PDFs')
         filing_group.add_argument('-c', '--config', type = argparse.FileType('r'),
              dest='configfile', help='Configuration file for defaults and PDF filing')
+        filing_group.add_argument('-e', '--evernote', action='store_true',
+            default=False, dest='enable_evernote', help='Enable filing to Evernote')
 
 
         args = p.parse_args(argv)
@@ -138,7 +143,12 @@ def get_options(self, argv):
             logging.debug("Read in configuration file")
             logging.debug(self.config)
 
-        if args.enable_filing:
+        if args.enable_evernote:
+            self.enable_evernote = True
+        else:
+            self.enable_evernote = False
+
+        if args.enable_filing or args.enable_evernote:
             self.enable_filing = True
             if not args.configfile:
                 p.error("Please specify a configuration file(CONFIGFILE) to enable filing")
@@ -182,7 +192,11 @@ def _setup_filing(self):
             original_move_folder = None
 
         # Start the filing object
-        self.filer = PyFilerDirs()
+        if self.enable_evernote:
+            self.filer = PyFilerEvernote(self.config['evernote_developer_token'])
+        else:
+            self.filer = PyFilerDirs()
+            
         self.filer.target_folder = self.config['target_folder']
         self.filer.default_folder = self.config['default_folder']
         self.filer.original_move_folder = original_move_folder
@@ -221,11 +235,40 @@ def file_converted_file(self, ocr_pdffilename, original_pdffilename):
         if tgt_path != original_pdffilename:
             print("Filed original file %s to %s as %s" % (original_pdffilename, os.path.dirname(tgt_path), os.path.basename(tgt_path)))
 
+  
+    def _send_email(self, from_addr, to_addr_list, cc_addr_list,
+                  subject, message,
+                  login, password,
+                  smtpserver):
+        header  = 'From: %s\n' % from_addr
+        header += 'To: %s\n' % ','.join(to_addr_list)
+        header += 'Cc: %s\n' % ','.join(cc_addr_list)
+        header += 'Subject: %s\n\n' % subject
+        message = header + message
+      
+        server = smtplib.SMTP(smtpserver)
+        server.starttls()
+        server.login(login,password)
+        problems = server.sendmail(from_addr, to_addr_list, message)
+        server.quit()
+
     def go(self, argv):
 
         # Read the command line options
         self.get_options(argv)
 
+        # 
+        #self._send_email(
+                        #from_addr="[email protected]",
+                        #to_addr_list=["[email protected]"],
+                        #cc_addr_list = [],
+                        #subject = "PyPDFOCR upload",
+                        #message = "Uploaded email\n\n-Virantha", 
+                        #login = "[email protected]",
+                        #password = "cctahvuntxbuwmox",
+                        #smtpserver = "smtp.gmail.com:587",
+                        #)
+
         # Setup the pdf filing if enabled
         if self.enable_filing:
             self._setup_filing()