Package: parse-1099
🍃 1099 ParserNote: Dividend features are in beta. I haven't written tests yet. Use the--analysis-reportflag to get more details about how decisions are made and double check my work.Massive caveat: The parser is no longer compatible with Robinhood or Wealthfront for the 2023 tax year.Both institutions have simplified their sales reports so that securities sold on a particular day but acquired on different days no have a separate line item for each of the dates acquired (and, in lieu of reporting any acquisition dates at all, the acquired date is simply 'Various'). This breaks the parser (which can be fixed) but more importantly removes a piece of information. Without date acquired, it's no longer possible to analyze (based purely on the consolidated 1099) whether dividends become unqualified.This project converts standard 1099 tax documents (validated on Robinhood and Wealthfront documents so far) from PDF to CSV file. This tool will be helpful for those who need every transaction in a spreadsheet format for tax reporting purposes. After parsing the tax documents, it will perform some simple analysis on the holding period of securities which reported qualifying dividends.Original WorkCopyright (c) 2023 Andrew Wells (ajwells@uchicago.com)Original AuthorMany kudos to original author Keun Park (kevin.park1217@gmail.com), whose work I used as a foundation upon which to expand.🚀 Running LocallyPrerequisitesMake sure you have the following installed on your computer.LatestPython 3Must be version 3.6 or higher[Windows Only]Build Tools for Visual Studio 2019In the installer, selectC++ build toolstheWindows 10 SDKthe latest version ofMSVC v142 x64/x86 build tools.Installing$python-mpipinstallwheel
$python-mpipinstall--upgradeparse_1099Note: If commands above fail, try replacingpythonwithpython3Running$parse_1099
usage:parse_1099[-h]--pdfFILE[--csvFILE][--silent][--validate][--disable-dividend-analysis][--analysis-report]Example and ValidationSet the--validateflag to print out total values for some columns. Make sure these values match with the PDF!$parse_1099--pdfconsolidated_1099.pdf--validate
Pages:100%|██████████████████████████████████████████████████████████████|40/40[00:03<00:00,10.41it/s]>>>CalculatedTotals:MakesurethevaluesmatcheswiththePDFtotals!proceeds:$77,521.03,cost:$80,902.05,wash_sales_loss:$3,733.41,gain_loss:$352.39
>>>Savedtooutput.csv🐞 Issues and BugsIf you have any issues with the tool, please open a GitHub Issue with as much as detail as you can provide.DevelopmentStructureThis is the first python module I've worked on, so the structure may be a little goofy. I tried to structure the project into two parsers, one for 1099-B Proceeds from Broker and Barter Exchange Transactions and one for 1099-DIV Detail for Dividends and Distributions.In each case, I designed for extensibility via versioning, in case the structure of the data or the presentation of the data on the PDF ever changes. Hypothetically the correct version of the subparser could be detected, but there's no sense writing that functionality until the scenario arises.BuildingThe following will build the python wheel file into thedistfolder. Note thatpythonandpipcan be exchanged withpython3andpip3depending on your environment configuration.$python-mbuildThe following will update the installed module requiring a version bump.$pipinstalldist/parse_1099-X.Y.Z-...whl--force-reinstall--no-deps