Metadata-Version: 2.1
Name: unstructured
Version: 0.2.3
Summary: A library that prepares raw documents for downstream ML tasks.
Home-page: https://github.com/Unstructured-IO/unstructured
Author: Unstructured Technologies
Author-email: devops@unstructuredai.io
License: Apache-2.0
Description: <h3 align="center">
          <img
            src="https://raw.githubusercontent.com/Unstructured-IO/unstructured/main/img/unstructured_logo.png"
            height="200"
          >
        </h3>
        
        <h3 align="center">
          <p>Open-Source Pre-Processing Tools for Unstructured Data</p>
        </h3>
        
        
        The `unstructured` library provides open-source components for pre-processing text documents
        such as PDFs, HTML and Word Documents. These components are packaged as "bricks", which provide
        users the building blocks they need to build pipelines targeted at the documents they care
        about. Bricks in the library fall into three categories:
        
        - :jigsaw: ***Partitioning bricks*** that break raw documents down into standard, structured
          elements.
        - :broom: ***Cleaning bricks*** that remove unwanted text from documents, such as boilerplate and
          sentence
          fragments.
        - :performing_arts: ***Staging bricks*** that format data for downstream tasks, such as ML inference
          and data labeling.
        
        ## Installation
        
        To install the library, run `pip install unstructured`.
        
        ## Developer Quick Start
        
        * Using `pyenv` to manage virtualenv's is recommended
        	* Mac install instructions. See [here](https://github.com/Unstructured-IO/community#mac--homebrew) for more detailed instructions.
        		* `brew install pyenv-virtualenv`
        	  * `pyenv install 3.8.13`
          * Linux instructions are available [here](https://github.com/Unstructured-IO/community#linux).
        
        * Create a virtualenv to work in and activate it, e.g. for one named `unstructured`:
        
        	`pyenv  virtualenv 3.8.13 unstructured` <br />
        	`pyenv activate unstructured`
        
        * Run `make install-project-local`
        
        ## Quick Tour
        
        The following examples show how to get started with the `unstructured` library. See
        our [documentation page](https://unstructured-io.github.io/unstructured) for a full description
        of the features in the library.
        
        ### HTML Parsing
        
        You can parse an HTML document using the following workflow:
        
        ```python
        from unstructured.documents.html import HTMLDocument
        
        doc = HTMLDocument.from_file("example-docs/example-10k.html")
        print(doc.pages[2])
        ```
        
        The output of this will be the following:
        
        ```
        SPECIAL NOTE REGARDING FORWARD-LOOKING STATEMENTS
        
        This report contains statements that do not relate to historical or current facts but are “forward-looking” statements. These statements relate to analyses and other information based on forecasts of future results and estimates of amounts not yet determinable. These statements may also relate to future events or trends, our future prospects and proposed new products, services, developments or business strategies, among other things. These statements can generally (although not always) be identified by their use of terms and phrases such as anticipate, appear, believe, could, would, estimate, expect, indicate, intent, may, plan, predict, project, pursue, will continue and other similar terms and phrases, as well as the use of the future tense.
        
        Actual results could differ materially from those expressed or implied in our forward-looking statements. Our future financial condition and results of operations, as well as any forward-looking statements, are subject to change and to inherent known and unknown risks and uncertainties. You should not assume at any point in the future that the forward-looking statements in this report are still valid. We do not intend, and undertake no obligation, to update our forward-looking statements to reflect future events or circumstances.
        ```
        
        If you then run:
        
        ```python
        doc.pages[2].elements
        ```
        
        You'll get the following output, showing that the parser successfully differentiated between
        titles and narrative text.
        
        ```python
        [<unstructured.documents.base.Title at 0x169cbe820>,
         <unstructured.documents.base.NarrativeText at 0x169cbe8e0>,
         <unstructured.documents.base.NarrativeText at 0x169cbe3a0>]
        ```
        
        ### PDF Parsing
        
        You can use the following workflow to parse PDF documents. Note, PDF parsing is currently
        expiremental and will be refined in the coming months.
        
        ```python
        from unstructured.documents.pdf import PDFDocument
        
        doc = PDFDocument.from_file("example-docs/layout-parser-paper.pdf")
        print(doc)
        ```
        
        At this point, `print(doc)` will print out a string representation of the PDF file. The
        first page of output looks like the following:
        
        ```
        
        LayoutParser : A Uniﬁed Toolkit for Deep Learning Based Document Image Analysis
        
        Zejiang Shen 1 ( (cid:0) ), Ruochen Zhang 2 , Melissa Dell 3 , Benjamin Charles Germain Lee 4 , Jacob Carlson 3 , and
        Weining Li 5
        
        Abstract. Recent advances in document image analysis (DIA) have been primarily driven by the application of neural
        networks. Ideally, research outcomes could be easily deployed in production and extended for further investigation.
        However, various factors like loosely organized codebases and sophisticated model conﬁgurations complicate the easy
        reuse of im- portant innovations by a wide audience. Though there have been on-going eﬀorts to improve reusability and
        simplify deep learning (DL) model development in disciplines like natural language processing and computer vision, none
        of them are optimized for challenges in the domain of DIA. This represents a major gap in the existing toolkit, as DIA
        is central to academic research across a wide range of disciplines in the social sciences and humanities. This paper
        introduces LayoutParser , an open-source library for streamlining the usage of DL in DIA research and applica- tions.
        The core LayoutParser library comes with a set of simple and intuitive interfaces for applying and customizing DL models
        for layout de- tection, character recognition, and many other document processing tasks. To promote extensibility,
        LayoutParser also incorporates a community platform for sharing both pre-trained models and full document digiti- zation
        pipelines. We demonstrate that LayoutParser is helpful for both lightweight and large-scale digitization pipelines in
        real-word use cases. The library is publicly available at https://layout-parser.github.io
        
        Keywords: Document Image Analysis · Deep Learning · Layout Analysis · Character Recognition · Open Source library ·
        Toolkit.
        
        Introduction
        
        Deep Learning(DL)-based approaches are the state-of-the-art for a wide range of document image analysis (DIA) tasks
        including document image classiﬁcation [11,
        ```
        
        The `Document` has a `pages` attribute consisting of `Page` object and the `Page` object
        has an `element` attribute consisting of `Element` objects. Sub-types of the `Element` class
        represent different components of a document, such as `NarrativeText` and `Title`. You can use
        these normalized elements to zero in on the components of a document you most care about.
        
        ## Security Policy
        
        See our [security policy](https://github.com/Unstructured-IO/unstructured/security/policy) for
        information on how to report security vulnerabilities.
        
        ## Learn more
        
        | Section | Description |
        |-|-|
        | [Company Website](https://unstructured.io) | Unstructured.io product and company info |
        | [Documentation](https://unstructured-io.github.io/unstructured) | Full API documentation |
        
Keywords: NLP PDF HTML CV XML parsing preprocessing
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8.0
Description-Content-Type: text/markdown
Provides-Extra: huggingface
Provides-Extra: pdf
