Extractous

https://github.com/yobix-ai/extractous
Admin
Extractous is a high-performance content and metadata extraction tool written in Rust, offering fast...
Tokens:27,545
Snippets:70
Trust Score:6
License:Apache-2.0
Update:1 year ago
Show doc for...
Tokens:
Raw
### Install Extractous Python Bindings

Source: https://github.com/yobix-ai/extractous/blob/main/bindings/extractous-python/README.md

Installs the extractous Python library using pip. This is the primary method for getting the library into your Python environment.

```bash
pip install extractous
```

--------------------------------

### Install Extractous

Source: https://github.com/yobix-ai/extractous/blob/main/bindings/extractous-python/examples/extract.ipynb

Installs the extractous library using pip.

```python
# Install extractous
%pip install extractous
```

--------------------------------

### Install GraalVM JDK (SDKMAN)

Source: https://github.com/yobix-ai/extractous/blob/main/extractous-core/README.md

Installs a specific GraalVM JDK version using the SDKMAN tool. This is a prerequisite for building Apache Tika as native shared libraries for Extractous.

```Shell
sdk install java 23.0.1-graalce
```

--------------------------------

### Verify GraalVM Installation

Source: https://github.com/yobix-ai/extractous/blob/main/extractous-core/README.md

Confirms that GraalVM is installed correctly by checking the Java version. The output should indicate the GraalVM version and build details.

```Text
openjdk 23.0.1 2024-10-15
OpenJDK Runtime Environment GraalVM CE 23.0.1+11.1 (build 23.0.1+11-jvmci-b01)
OpenJDK 64-Bit Server VM GraalVM CE 23.0.1+11.1 (build 23.0.1+11-jvmci-b01, mixed mode, sharing)
```

--------------------------------

### Install Tesseract OCR (Debian/Ubuntu)

Source: https://github.com/yobix-ai/extractous/blob/main/extractous-core/README.md

Installs the Tesseract OCR engine on Debian-based systems like Ubuntu. This is required for Extractous's OCR capabilities. Language packs can also be installed.

```Shell
sudo apt install tesseract-ocr
```

```Shell
sudo apt install tesseract-ocr-deu tesseract-ocr-ara
```

--------------------------------

### Extract File/URL/Bytes to Buffered Stream with Extractous

Source: https://github.com/yobix-ai/extractous/blob/main/bindings/extractous-python/README.md

Shows how to extract content from a file, URL, or byte array into a buffered stream. The example iterates through the stream to read and print the content, along with metadata.

```python
from extractous import Extractor

extractor = Extractor()
# for file
reader, metadata = extractor.extract_file("tests/quarkus.pdf")
# for url
# reader, metadata = extractor.extract_url("https://www.google.com")
# for bytearray
# with open("tests/quarkus.pdf", "rb") as file:
#     buffer = bytearray(file.read())
# reader, metadata = extractor.extract_bytes(buffer)

result = ""
buffer = reader.read(4096)
while len(buffer) > 0:
    result += buffer.decode("utf-8")
    buffer = reader.read(4096)

print(result)
print(metadata)
```

--------------------------------

### Install Tesseract OCR (macOS)

Source: https://github.com/yobix-ai/extractous/blob/main/extractous-core/README.md

Installs the Tesseract OCR engine and language packs on macOS using Homebrew. This enables OCR functionality within Extractous.

```Shell
brew install tesseract tesseract-lang
```

--------------------------------

### Configure GraalVM Home (Ubuntu)

Source: https://github.com/yobix-ai/extractous/blob/main/extractous-core/README.md

Sets the GRAALVM_HOME environment variable on Ubuntu to point to the installed GraalVM JDK, allowing applications to locate it. This is necessary for using GraalVM from IDEs like IDEA.

```Shell
GRAALVM_HOME=$HOME/.sdkman/candidates/java/23.0.1-graalce
```

--------------------------------

### Install Bellsoft Liberica NIK (macOS)

Source: https://github.com/yobix-ai/extractous/blob/main/extractous-core/README.md

Installs the Bellsoft Liberica NIK JDK on macOS, which is recommended for compatibility with Java AWT code, a known issue with official GraalVM JDKs on macOS.

```Shell
sdk install java 24.1.1.r23-nik
```

--------------------------------

### Extract File to Buffered Stream

Source: https://github.com/yobix-ai/extractous/blob/main/bindings/extractous-python/examples/extract.ipynb

Shows how to extract content from a file (tests/quarkus.pdf) into a buffered stream. The example reads the file in chunks of 4096 bytes and concatenates them into a single string.

```python
from extractous import Extractor

extractor = Extractor()
reader = extractor.extract_file("tests/quarkus.pdf")

result = ""
buffer = reader.read(4096)
while len(buffer) > 0:
    result += buffer.decode("utf-8")
    buffer = reader.read(4096)

print(result)
```

--------------------------------

### Extract File with OCR using Extractous and Tesseract

Source: https://github.com/yobix-ai/extractous/blob/main/bindings/extractous-python/README.md

Demonstrates how to configure and use Optical Character Recognition (OCR) with Extractous. This example specifically shows setting the Tesseract OCR language to German ('deu') for extracting text from a PDF file that requires OCR.

```python
from extractous import Extractor, TesseractOcrConfig

extractor = Extractor().set_ocr_config(TesseractOcrConfig().set_language("deu"))
result, metadata = extractor.extract_file_to_string("../../test_files/documents/eng-ocr.pdf")

print(result)
print(metadata)
```

--------------------------------

### Extract PDF Content with OCR

Source: https://github.com/yobix-ai/extractous/blob/main/extractous-core/README.md

Demonstrates extracting text from a PDF file using Optical Character Recognition (OCR). This requires Tesseract OCR and its language packs to be installed. It configures the extractor to use a specific language ('deu') and sets the OCR strategy to 'OCR_ONLY'.

```rust
use extractous::Extractor;

fn main() {
  let file_path = "../test_files/documents/deu-ocr.pdf";

  let extractor = Extractor::new()
          .set_ocr_config(TesseractOcrConfig::new().set_language("deu"))
          .set_pdf_config(PdfParserConfig::new().set_ocr_strategy(PdfOcrStrategy::OCR_ONLY));
  // extract file with extractor
  let (content, metadata) = extractor.extract_file_to_string(file_path).unwrap();
  println!("{}", content);
  println!("{:?}", metadata);
}
```

--------------------------------

### Extract File with OCR (Python)

Source: https://github.com/yobix-ai/extractous/blob/main/README.md

Extracts text from a PDF file using Optical Character Recognition (OCR). Requires Tesseract OCR and language packs to be installed. Uses 'extractous' library.

```Python
from extractous import Extractor, TesseractOcrConfig

extractor = Extractor().set_ocr_config(TesseractOcrConfig().set_language("deu"))
result, metadata = extractor.extract_file_to_string("../../test_files/documents/eng-ocr.pdf")

print(result)
print(metadata)
```

--------------------------------

### Extract File to String

Source: https://github.com/yobix-ai/extractous/blob/main/bindings/extractous-python/examples/extract.ipynb

Demonstrates how to extract the content of a file (README.md) into a string using the Extractor class. It also shows how to set a maximum length for the extracted string.

```python
from extractous import Extractor

extractor = Extractor()
extractor.set_extract_string_max_length(1000)
result = extractor.extract_file_to_string("README.md")

print(result)
```

--------------------------------

### Initialize and Configure Extractor

Source: https://github.com/yobix-ai/extractous/blob/main/extractous-core/README.md

Demonstrates how to create an Extractor instance and apply configurations such as setting the maximum string length for extraction and customizing PDF parsing behavior, including disabling annotation text extraction.

```rust
use extractous::Extractor;
use extractous::PdfParserConfig;

fn main() {
    // Create a new extractor. Note it uses the consuming builder pattern
    let mut extractor = Extractor::new()
        .set_extract_string_max_length(1000);

    // can also perform conditional configuration
    let custom_pdf_config = true;
    if custom_pdf_config {
        extractor = extractor.set_pdf_config(
            PdfParserConfig::new().set_extract_annotation_text(false)
        );
    }
}
```

--------------------------------

### Extract File to String with Extractous

Source: https://github.com/yobix-ai/extractous/blob/main/bindings/extractous-python/README.md

Demonstrates how to use the Extractor class to extract text content from a local file and retrieve metadata. It shows how to set maximum string length and optionally enable XML output.

```python
from extractous import Extractor

# Create a new extractor
extractor = Extractor()
extractor = extractor.set_extract_string_max_length(1000)
# if you need an xml
# extractor = extractor.set_xml_output(True)

# Extract text from a file
result, metadata = extractor.extract_file_to_string("README.md")
print(result)
print(metadata)
```

--------------------------------

### Build Extractous

Source: https://github.com/yobix-ai/extractous/blob/main/extractous-core/README.md

Compiles the Extractous project using Cargo, Rust's build system and package manager. This command builds the entire project, including any native dependencies.

```Shell
cargo build
```

--------------------------------

### Inline XBRL Document Set

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

This refers to the Inline XBRL (eXtensible Business Reporting Language) document set, which is used for filing financial statements and accompanying notes in a machine-readable format. This facilitates easier data analysis and retrieval by regulators and investors.

```APIDOC
Inline XBRL Document Set for the condensed consolidated financial statements and accompanying notes in Part I, Item 1, “Financial Statements” of this Quarterly Report on Form 10-Q.
```

--------------------------------

### Run Extractous Tests

Source: https://github.com/yobix-ai/extractous/blob/main/extractous-core/README.md

Executes all tests defined within the Extractous project using Cargo. This is crucial for verifying the functionality and stability of the project, including OCR tests that depend on Tesseract.

```Shell
cargo test
```

--------------------------------

### Fair Value Estimate Levels Explanation

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

Provides explanations for Level 1 and Level 2 fair value estimates used in financial reporting.

```text
(1) Level 1 fair value estimates are based on quoted prices in active markets for identical assets or liabilities.
(2) Level 2 fair value estimates are based on observable inputs other than quoted prices in active markets for identical assets and liabilities, quoted prices for identical or similar assets or liabilities in inactive markets, or other inputs that are observable or can be corroborated by observable market data for substantially the full term of the assets or liabilities.
```

--------------------------------

### Extractous Performance Benchmarks

Source: https://github.com/yobix-ai/extractous/blob/main/README.md

This section details the performance advantages of Extractous, showcasing its speed and memory efficiency compared to unstructured-io through benchmark results and visualizations. It also touches upon the quality of extracted content.

```markdown
## 🔥 Performance
* **Extractous** is fast, please don't take our word for it, you can run the [benchmarks](https://github.com/yobix-ai/extractous-benchmarks) yourself. For example extracting content out of [sec10 filings pdf forms](https://github.com/yobix-ai/extractous-benchmarks/raw/main/dataset/sec10-filings), Extractous is on average **~18x faster** than unstructured-io:

![extractous_speedup_relative_to_unstructured](https://github.com/yobix-ai/extractous-benchmarks/raw/main/docs/extractous_speedup_relative_to_unstructured.png)

* Not just speed it is also memory efficient, Extractous allocates **~11x less memory** than unstructured-io:

![extractous_memory_efficiency_relative_to_unstructured](https://github.com/yobix-ai/extractous-benchmarks/raw/main/docs/extractous_memory_efficiency_relative_to_unstructured.png)

* You might be questioning the quality of the extracted content, gues what we even do better in that regard:

![extractous_memory_efficiency_relative_to_unstructured](https://github.com/yobix-ai/extractous-benchmarks/raw/main/docs/extractous_unstructured_quality_scores.png)
```

--------------------------------

### Extract File Content to String

Source: https://github.com/yobix-ai/extractous/blob/main/extractous-core/README.md

Shows how to extract the text content and metadata from a file specified by its path. The extracted content is returned as a String, and the metadata is returned as a HashMap.

```rust
use extractous::Extractor;

fn main() {
  // Get the command-line arguments
  let args: Vec<String> = std::env::args().collect();
  let file_path = &args[1];

  // Extract the provided file content to a string
  let mut extractor = Extractor::new();
  // if you need an xml
  // extractor = extractor.set_xml_output(false);
  // Extract text from a file
  let (content, metadata) = extractor.extract_file_to_string(file_path).unwrap();
  println!("{}", content);
  println!("{:?}", metadata);
}
```

--------------------------------

### Apple Inc. Revenue Disaggregation by Product and Service (Q3 2022)

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

Breaks down Apple Inc.'s net sales for the three- and nine-month periods ended June 25, 2022, and June 26, 2021, by major product and service categories. Includes a note regarding the amortization of deferred value for software upgrade rights included in product sales.

```APIDOC
Revenue Disaggregation:

Periods:
  Three Months Ended June 25, 2022 vs. June 26, 2021
  Nine Months Ended June 25, 2022 vs. June 26, 2021

Net Sales (in millions):
  iPhone:
    Three Months Ended:
      June 25, 2022: $40,665
      June 26, 2021: $39,570
    Nine Months Ended:
      June 25, 2022: $162,863
      June 26, 2021: $153,105
  Mac:
    Three Months Ended:
      June 25, 2022: $7,382
      June 26, 2021: $8,235
    Nine Months Ended:
      June 25, 2022: $28,669
      June 26, 2021: $26,012
  iPad:
    Three Months Ended:
      June 25, 2022: $7,224
      June 26, 2021: $7,368
    Nine Months Ended:
      June 25, 2022: $22,118
      June 26, 2021: $23,610
  Wearables, Home and Accessories:
    Three Months Ended:
      June 25, 2022: $8,084
      June 26, 2021: $8,775
    Nine Months Ended:
      June 25, 2022: $31,591
      June 26, 2021: $29,582
  Services:
    Three Months Ended:
      June 25, 2022: $19,604
      June 26, 2021: $17,486
    Nine Months Ended:
      June 25, 2022: $58,941
      June 26, 2021: $50,148
  Total net sales:
    Three Months Ended:
      June 25, 2022: $82,959
      June 26, 2021: $81,434
    Nine Months Ended:
      June 25, 2022: $304,182
      June 26, 2021: $282,457

Note (1):
  Products net sales include amortization of the deferred value of unspecified software upgrade rights, which are bundled in the sales price of the respective product.
```

--------------------------------

### Extractous Contribution and License Information

Source: https://github.com/yobix-ai/extractous/blob/main/README.md

Information for users interested in contributing to the Extractous project, including how to submit issues or pull requests. It also specifies the project's license as Apache License 2.0.

```markdown
## 🤝 Contributing
Contributions are welcome! Please open an issue or submit a pull request if you have any improvements or new features to propose.

## 🕮 License
This project is licensed under the Apache License 2.0. See the LICENSE file for details.
```

--------------------------------

### Inline XBRL Cover Page

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

This specifies the Inline XBRL document for the cover page of the Quarterly Report on Form 10-Q. It is part of the overall Inline XBRL Document Set and provides standardized metadata for the report.

```APIDOC
Inline XBRL for the cover page of this Quarterly Report on Form 10-Q, included in the Exhibit 101 Inline XBRL Document Set.
```

--------------------------------

### Apple Inc. Form 10-Q Filing - Table of Contents

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

The table of contents for Apple Inc.'s Form 10-Q filing for the fiscal quarter ended June 25, 2022. It outlines the structure of the report, including Part I and Part II sections covering financial statements, management's discussion, risk factors, and exhibits.

```APIDOC
Apple Inc.
Form 10-Q
For the Fiscal Quarter Ended June 25, 2022

TABLE OF CONTENTS
Page

Part I
Item 1. Financial Statements 1
Item 2. Management’s Discussion and Analysis of Financial Condition and Results of Operations 14
Item 3. Quantitative and Qualitative Disclosures About Market Risk 19
Item 4. Controls and Procedures 19

Part II
Item 1. Legal Proceedings 20
Item 1A. Risk Factors 20
Item 2. Unregistered Sales of Equity Securities and Use of Proceeds 20
Item 3. Defaults Upon Senior Securities 21
Item 4. Mine Safety Disclosures 21
Item 5. Other Information 21
Item 6. Exhibits 21
```

--------------------------------

### Financial Instruments: Cash, Cash Equivalents, and Marketable Securities (June 25, 2022)

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

Presents the Company's cash, cash equivalents, and marketable securities by investment category as of June 25, 2022. Includes cost, unrealized gains/losses, and fair value, categorized by Level 1 and Level 2 inputs.

```text
June 25, 2022
Adjusted
Cost
Unrealized
Gains
Unrealized
Losses
Fair
Value
Cash and
Cash
Equivalents
Current
Marketable
Securities
Non-Current
Marketable
Securities
Cash $ 12,852 $ — $ — $ 12,852 $ 12,852 $ — $ —
Level 1 :
Money market funds 10,970 — — 10,970 10,970 — —
Mutual funds 252 — (32) 220 — 220 —
Subtotal 11,222 — (32) 11,190 10,970 220 —
Level 2 :
U.S. Treasury securities 25,296 — (1,328) 23,968 91 3,511 20,366
U.S. agency securities 5,805 — (511) 5,294 4 240 5,050
Non-U.S. government securities 17,597 6 (1,023) 16,580 — 6,336 10,244
Certificates of deposit and time deposits 3,928 — — 3,928 3,374 504 50
Commercial paper 966 — — 966 209 757 —
Corporate debt securities 88,912 15 (6,455) 82,472 2 8,738 73,732
Municipal securities 978 — (26) 952 — 203 749
Mortgage- and asset-backed securities 23,058 — (1,952) 21,106 — 220 20,886
Subtotal 166,540 21 (11,295) 155,266 3,680 20,509 131,077
Total $ 190,614 $ 21 $ (11,327) $ 179,308 $ 27,502 $ 20,729 $ 131,077
```

--------------------------------

### Apple Inc. Share Repurchase Program (Q3 2022)

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

Details the share repurchase activity for the nine months ended June 25, 2022, including the number of shares repurchased and the total cost. Mentions the authorization by the Board of Directors and compliance with Rule 10b-5.

```APIDOC
Share Repurchase Program:
  Nine Months Ended June 25, 2022:
    Shares repurchased: 408 million
    Total cost: $ 65.0 billion
    Shares delivered under accelerated share repurchase agreements: 35 million
    Total cost of accelerated share repurchases: $ 6.0 billion
    Agreements entered into in: November 2021
  Program details:
    Authorized by the Board of Directors.
    Does not obligate the Company to acquire a minimum amount of shares.
    Shares may be repurchased in privately negotiated and/or open market transactions.
    Includes plans complying with Rule 10b5-1 under the Securities Exchange Act of 1934.
```

--------------------------------

### Extractous Supported File Formats

Source: https://github.com/yobix-ai/extractous/blob/main/README.md

A comprehensive list of file formats supported by Extractous, categorized by type. This includes Microsoft Office, OpenOffice, PDF, spreadsheets, web documents, e-books, text files, images, e-mail, archives, audio, video, CAD files, and geospatial formats.

```markdown
## 📄 Supported file formats

| **Category**        | **Supported Formats**                                   | **Notes**                                      |
|---------------------|---------------------------------------------------------|------------------------------------------------|
| **Microsoft Office**| DOC, DOCX, PPT, PPTX, XLS, XLSX, RTF                    | Includes legacy and modern Office file formats |
| **OpenOffice**      | ODT, ODS, ODP                                           | OpenDocument formats                           |
| **PDF**             | PDF                                                     | Can extracts embedded content and supports OCR |
| **Spreadsheets**    | CSV, TSV                                                | Plain text spreadsheet formats                 |
| **Web Documents**   | HTML, XML                                               | Parses and extracts content from web documents |
| **E-Books**         | EPUB                                                    | EPUB format for electronic books               |
| **Text Files**      | TXT, Markdown                                           | Plain text formats                             |
| **Images**          | PNG, JPEG, TIFF, BMP, GIF, ICO, PSD, SVG                | Extracts embedded text with OCR                |
| **E-Mail**          | EML, MSG, MBOX, PST                                     | Extracts content, headers, and attachments     |
```

--------------------------------

### Apple Inc. Term Debt Details (Q3 2022)

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

Provides details on Apple Inc.'s outstanding floating- and fixed-rate notes (the "Notes") as of June 25, 2022, and September 25, 2021. Includes aggregate carrying amount and fair value.

```APIDOC
Term Debt (Notes):
  As of June 25, 2022:
    Aggregate carrying amount: $ 108.7 billion
    Fair value (Level 2 inputs): $ 101.0 billion
  As of September 25, 2021:
    Aggregate carrying amount: $ 118.7 billion
    Fair value (Level 2 inputs): $ 125.3 billion
```

--------------------------------

### CEO/CFO Certification Requirements (Rule 13a-14(a))

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

This section outlines the certification requirements for the Chief Executive Officer and Chief Financial Officer as per Rule 13a-14(a) of the Securities Exchange Act. It details the affirmations regarding the review of the quarterly report, absence of material misstatements, fair presentation of financial information, and responsibilities for disclosure controls and internal financial reporting.

```APIDOC
CERTIFICATION
I, [Officer Name], certify that:
1. I have reviewed this quarterly report on Form 10-Q of [Company Name];
2. Based on my knowledge, this report does not contain any untrue statement of a material fact or omit to state a material fact necessary to make the statements made, in light of the circumstances under which such statements were made, not misleading with respect to the period covered by this report;
3. Based on my knowledge, the financial statements, and other financial information included in this report, fairly present in all material respects the financial condition, results of operations and cash flows of the Registrant as of, and for, the periods presented in this report;
4. The Registrant’s other certifying officer(s) and I are responsible for establishing and maintaining disclosure controls and procedures (as defined in Exchange Act Rules 13a-15(e) and 15d-15(e)) and internal control over financial reporting (as defined in Exchange Act Rules 13a-15(f) and 15d-15(f)) for the Registrant and have:
(a) Designed such disclosure controls and procedures, or caused such disclosure controls and procedures to be designed under our supervision, to ensure that material information relating to the Registrant, including its consolidated subsidiaries, is made known to us by others within those entities, particularly during the period in which this report is being prepared;
(b) Designed such internal control over financial reporting, or caused such internal control over financial reporting to be designed under our supervision, to provide reasonable assurance regarding the reliability of financial reporting and the preparation of financial statements for external purposes in accordance with generally accepted accounting principles;
(c) Evaluated the effectiveness of the Registrant’s disclosure controls and procedures and presented in this report our conclusions about the effectiveness of the disclosure controls and procedures, as of the end of the period covered by this report based on such evaluation; and
(d) Disclosed in this report any change in the Registrant’s internal control over financial reporting that occurred during the Registrant’s most recent fiscal quarter (the Registrant’s fourth fiscal quarter in the case of an annual report) that has materially affected, or is reasonably likely to materially affect, the Registrant’s internal control over financial reporting; and
5. The Registrant’s other certifying officer(s) and I have disclosed, based on our most recent evaluation of internal control over financial reporting, to the Registrant’s auditors and the audit committee of the Registrant’s board of directors (or persons performing the equivalent functions):
(a) All significant deficiencies and material weaknesses in the design or operation of internal control over financial reporting which are reasonably likely to adversely affect the Registrant’s ability to record, process, summarize and report financial information; and
(b) Any fraud, whether or not material, that involves management or other employees who have a significant role in the Registrant’s internal control over financial reporting.
Date: [Date]
By: /s/ [Officer Name]
[Officer Name]
[Title]
```

--------------------------------

### Apple Inc. Net Sales Breakdown

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

Details net sales for Wearables, Home and Accessories, and Services, including components of each category. Also provides information on deferred revenue recognition and expectations.

```text
Wearables, Home and Accessories net sales include sales of AirPods , Apple TV , Apple Watch , Beats products, HomePod mini and accessories.
Services net sales include sales from the Company’s advertising, AppleCare , cloud, digital content, payment and other services. Services net sales also include amortization of the deferred value of services bundled in the sales price of certain products.
Includes $3.1 billion of revenue recognized in the three months ended June 25, 2022 that was included in deferred revenue as of March 26, 2022, $3.0 billion of revenue recognized in the three months ended June 26, 2021 that was included in deferred revenue as of March 27, 2021, $6.3 billion of revenue recognized in the nine months ended June 25, 2022 that was included in deferred revenue as of September 25, 2021, and $5.5 billion of revenue recognized in the nine months ended June 26, 2021 that was included in deferred revenue as of September 26, 2020.
The Company’s proportion of net sales by disaggregated revenue source was generally consistent for each reportable segment in Note 9, “Segment Information and Geographic Data” for the three- and nine-month periods ended June 25, 2022 and June 26, 2021, except in Greater China, where iPhone revenue represented a moderately higher proportion of net sales.
As of June 25, 2022 and September 25, 2021, the Company had total deferred revenue of $12.2 billion and $11.9 billion, respectively. As of June 25, 2022, the Company expects 63% of total deferred revenue to be realized in less than a year, 27% within one-to-two years, 8% within two-to-three years and 2% in greater than three years.
```

--------------------------------

### Extract File Content to String (Rust)

Source: https://github.com/yobix-ai/extractous/blob/main/README.md

Extracts the text content of a file into a string using the Extractous Rust library. Allows setting maximum extraction length and XML output. Uses a consuming builder pattern.

```Rust
use extractous::Extractor;

fn main() {
    // Create a new extractor. Note it uses a consuming builder pattern
    let mut extractor = Extractor::new().set_extract_string_max_length(1000);
    // if you need an xml
    // extractor = extractor.set_xml_output(true);

    // Extract text from a file
    let (text, metadata) = extractor.extract_file_to_string("README.md").unwrap();
    println!("{}", text);
    println!("{:?}", metadata);
}
```

--------------------------------

### Section 1350 Certifications (CEO and CFO)

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

This entry covers the certifications required by Section 1350 of the Sarbanes-Oxley Act, which are to be provided by the Chief Executive Officer and Chief Financial Officer. These certifications attest to the accuracy of periodic reports filed with the SEC.

```APIDOC
Section 1350 Certifications of Chief Executive Officer and Chief Financial Officer.
```

--------------------------------

### Apple Inc. Restricted Stock Unit (RSU) Activity (Q3 2022)

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

Provides a summary of Apple Inc.'s restricted stock unit (RSU) activity for the nine months ended June 25, 2022. Includes RSU grants, vesting, cancellations, and balances.

```APIDOC
Restricted Stock Unit (RSU) Activity:
  Nine Months Ended June 25, 2022:
    Balance as of September 25, 2021:
      Number of RSUs (in thousands): 240,427
      Weighted-Average Grant Date Fair Value Per RSU: $ 75.16
    RSUs granted:
      Number of RSUs (in thousands): 84,927
      Weighted-Average Grant Date Fair Value Per RSU: $ 150.02
    RSUs vested:
      Number of RSUs (in thousands): (109,846)
      Weighted-Average Grant Date Fair Value Per RSU: $ 70.96
    RSUs canceled:
      Number of RSUs (in thousands): (12,986)
      Weighted-Average Grant Date Fair Value Per RSU: $ 98.26
    Balance as of June 25, 2022:
      Number of RSUs (in thousands): 202,522
      Weighted-Average Grant Date Fair Value Per RSU: $ 107.35
      Aggregate Fair Value (in millions): $ 28,689

  Fair Value of RSUs at Vesting Dates:
    Three Months Ended June 25, 2022: $ 7.8 billion
    Nine Months Ended June 25, 2022: $ 17.3 billion
    Three Months Ended June 26, 2021: $ 7.9 billion
    Nine Months Ended June 26, 2021: $ 17.3 billion
```

--------------------------------

### Extract File Content to StreamReader

Source: https://github.com/yobix-ai/extractous/blob/main/extractous-core/README.md

Illustrates extracting file content into a `StreamReader` for buffered reading. This method supports extracting from file paths, URLs, or byte slices, and provides metadata alongside the stream.

```rust
use std::io::{BufReader, Read};
// use std::fs::File; use for bytes
use extractous::Extractor;

fn main() {
  // Get the command-line arguments
  let args: Vec<String> = std::env::args().collect();
  let file_path = &args[1];

  // Extract the provided file content to a string
  let extractor = Extractor::new();
  let (stream, metadata) = extractor.extract_file(file_path).unwrap();
  // Extract url
  // let (stream, metadata) = extractor.extract_url("https://www.google.com/").unwrap();
  // Extract bytes
  // let mut file = File::open(file_path)?;
  // let mut buffer = Vec::new();
  // file.read_to_end(&mut buffer)?;
  // let (stream, metadata) = extractor.extract_bytes(&file_bytes);

  // Because stream implements std::io::Read trait we can perform buffered reading
  // For example we can use it to create a BufReader
  let mut reader = BufReader::new(stream);
  let mut buffer = Vec::new();
  reader.read_to_end(&mut buffer).unwrap();

  println!("{}", String::from_utf8(buffer).unwrap());
  println!("{:?}", metadata);
}
```

--------------------------------

### Analysis of Gross Margin Changes

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

Explains the reasons behind changes in Apple Inc.'s gross margin for Products and Services, considering factors like product mix, volume, foreign currency impacts, and leverage for Q3 2022.

```APIDOC
APIDOC:
  Gross Margin Analysis:
    Products Gross Margin:
      - Three Months Ended Q3 2022 vs. Q3 2021:
        - Decrease primarily due to weakness in foreign currencies relative to the U.S. dollar.
      - First Nine Months 2022 vs. 2021:
        - Increase primarily due to different Products mix and higher Products volume.
        - Partially offset by weakness in foreign currencies relative to the U.S. dollar.
    Products Gross Margin Percentage:
      - Three Months Ended Q3 2022 vs. Q3 2021:
        - Decrease primarily due to weakness in foreign currencies relative to the U.S. dollar and a different Products mix.
      - First Nine Months 2022 vs. 2021:
        - Increase primarily due to a different Products mix.
    Services Gross Margin:
      - Three Months Ended Q3 2022 vs. Q3 2021:
        - Increase primarily due to higher Services net sales.
        - Partially offset by weakness in foreign currencies relative to the U.S. dollar.
      - First Nine Months 2022 vs. 2021:
        - Increase primarily due to higher Services net sales.
        - Partially offset by weakness in foreign currencies relative to the U.S. dollar.
    Services Gross Margin Percentage:
      - Three Months Ended Q3 2022 vs. Q3 2021:
        - Increase primarily due to improved leverage and a different Services mix.
        - Partially offset by weakness in foreign currencies relative to the U.S. dollar and higher Services costs.
      - First Nine Months 2022 vs. 2021:
        - Increase primarily due to improved leverage and a different Services mix.
        - Partially offset by weakness in foreign currencies relative to the U.S. dollar and higher Services costs.
    Future Outlook:
      - Gross margins subject to volatility and downward pressure due to various factors, as discussed in Part I, Item 1A of the 2021 Form 10-K.
```

--------------------------------

### Apple Inc. Commercial Paper Program Details (Q3 2022)

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

Summarizes cash flows associated with the issuance and maturities of Commercial Paper for the nine months ended June 25, 2022, and June 26, 2021. This includes proceeds and repayments.

```APIDOC
Commercial Paper Cash Flows:
  Nine Months Ended June 25, 2022:
    Maturities 90 days or less:
      Proceeds from commercial paper, net: $ 4,383 million
    Maturities greater than 90 days:
      Proceeds from commercial paper: $ 5,731 million
      Repayments of commercial paper: $ (5,144) million
      Proceeds from commercial paper, net: $ 587 million
    Total proceeds from commercial paper, net: $ 4,970 million
  Nine Months Ended June 26, 2021:
    Maturities 90 days or less:
      Proceeds from commercial paper, net: $ 2,745 million
    Maturities greater than 90 days:
      Proceeds from commercial paper: $ 3,993 million
      Repayments of commercial paper: $ (3,716) million
      Proceeds from commercial paper, net: $ 277 million
    Total proceeds from commercial paper, net: $ 3,022 million
```

--------------------------------

### Ice Hockey Rules Overview

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/winter-sports.epub.txt

Details the fundamental rules of ice hockey, including puck and stick specifications, goal dimensions, team size, game duration, and winning conditions.

```APIDOC
Ice Hockey Rules:

1. Puck and Stick Specifications:
   - Puck: Made of india-rubber, 3 inches in diameter, 1 inch thick, weighing 1¼ lbs. Size and shape may vary as decided.
   - Stick: Must be able to pass through a 3-inch diameter ring.

2. Goal Dimensions:
   - Goal-posts: 4 feet high and 4 feet apart at each end of the ice.

3. Team Composition:
   - Each team shall consist of six players.

4. Scoring:
   - A goal is scored when the puck passes between the goal-posts.

5. Game Duration:
   - The game consists of two halves of 20 minutes each.
   - Teams switch goals at half-time.

6. Winning the Match:
   - The team scoring the greater number of goals wins.
   - In case of a tie, five minutes of overtime each way is played until the tie is decided, or teams may arrange another match.

7. Referee and Officials:
   - A referee is appointed to decide all disputed points; their decision is final.
   - The referee may appoint four goal umpires (two at each end).
   - The referee can stop the game for any cause and for any duration.
   - For unfair or rough play, the referee shall caution the offender. Repeated offenses may result in the offender being ordered off the ice for an interval or the rest of the match.
   - If no referee is appointed, captains arbitrate disputes.

8. Game Start and Restarts:
   - The game starts with the puck placed between two opposing players on the half-way line. Sticks must meet three times before touching the puck.
   - After a goal, the puck is restarted in the center of the ring as above.

9. Puck Out of Play:
   - If the puck goes off the ice, it is restarted 3 yards from the side where it left.
   - If behind the goal line, it is restarted 5 yards from the goal line and 3 yards from the side.

10. Prohibited Actions:
    - Charging, crossing, riding off, pushing, or tripping are not allowed.

11. Stick Height:
    - A player may not raise their stick above their shoulder.

12. Puck Handling:
    - Players may not carry, stand on, kick, or throw the puck, except the goalkeeper who may kick, catch, or knock it away with hand, leg, or body.

13. Fallen Players:
    - A fallen player is out of play and cannot participate until they regain their feet and stick.

14. Stoppage of Play:
    - If the game is stopped due to rule infringement, accident, or player change, the puck restarts where it was last played.

15. Forward Pass Rule:
    - A forward pass is illegal if fewer than two opponents (including the goalkeeper) are between the passer and the opponents' goal line.
    - If an illegal forward pass occurs, the puck restarts where the pass was made.

16. Player Injury:
    - If a player is disabled, the opposing captain may allow a substitute or remove one player from their own team.
```

--------------------------------

### Python Bindings for Extractous

Source: https://github.com/yobix-ai/extractous/blob/main/README.md

Extractous provides Python bindings that act as a wrapper around the Rust core. This allows Python applications to leverage the performance benefits of Rust, bypassing the Global Interpreter Lock (GIL) and utilizing multi-core processing for efficient document extraction.

```python
from extractous import Extractous

# Initialize the Extractous client
extractor = Extractous()

# Path to the document file
document_path = "/path/to/your/document.pdf"

# Extract text content from the document
try:
    text_content = extractor.extract_text(document_path)
    print("Extracted Text:")
    print(text_content)

    # Extract metadata from the document
    metadata = extractor.extract_metadata(document_path)
    print("\nExtracted Metadata:")
    print(metadata)

except Exception as e:
    print(f"An error occurred: {e}")

```

--------------------------------

### Apple Inc. Condensed Consolidated Statements of Comprehensive Income

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

Presents Apple Inc.'s net income and other comprehensive income/(loss) components for the three and nine months ended June 25, 2022, and June 26, 2021. It details changes in foreign currency translation, derivative instruments, and marketable debt securities.

```APIDOC
Apple Inc. - Condensed Consolidated Statements of Comprehensive Income (Unaudited)
(In millions)

Three Months Ended | Nine Months Ended
June 25, 2022 | June 26, 2021 | June 25, 2022 | June 26, 2021
------------------|----------------|----------------|----------------
Net income $ 19,442 | $ 21,744 | $ 79,082 | $ 74,129
Other comprehensive income/(loss):
Change in foreign currency translation, net of tax (721) | 188 | (1,102) | 659
Change in unrealized gains/losses on derivative instruments, net of tax:
  Change in fair value of derivative instruments 852 | (24) | 1,548 | 4
  Adjustment for net (gains)/losses realized and included in net income 121 | 17 | (87) | 593
  Total change in unrealized gains/losses on derivative instruments 973 | (7) | 1,461 | 597
Change in unrealized gains/losses on marketable debt securities, net of tax:
  Change in fair value of marketable debt securities (3,150) | 217 | (9,959) | (558)
  Adjustment for net (gains)/losses realized and included in net income 95 | (54) | 140 | (234)
  Total change in unrealized gains/losses on marketable debt securities (3,055) | 163 | (9,819) | (792)
Total other comprehensive income/(loss) (2,803) | 344 | (9,460) | 464
Total comprehensive income $ 16,639 | $ 22,088 | $ 69,622 | $ 74,593
```

--------------------------------

### Financial Instruments: Cash, Cash Equivalents, and Marketable Securities (September 25, 2021)

Source: https://github.com/yobix-ai/extractous/blob/main/test_files/expected_result/2022_Q3_AAPL.pdf.txt

Presents the Company's cash, cash equivalents, and marketable securities by investment category as of September 25, 2021. Includes cost, unrealized gains/losses, and fair value, categorized by Level 1 and Level 2 inputs.

```text
September 25, 2021
Adjusted
Cost
Unrealized
Gains
Unrealized
Losses
Fair
Value
Cash and
Cash
Equivalents
Current
Marketable
Securities
Non-Current
Marketable
Securities
Cash $ 17,305 $ — $ — $ 17,305 $ 17,305 $ — $ —
Level 1 :
Money market funds 9,608 — — 9,608 9,608 — —
Mutual funds 175 11 (1) 185 — 185 —
Subtotal 9,783 11 (1) 9,793 9,608 185 —
Level 2 :
Equity securities 1,527 — (564) 963 — 963 —
U.S. Treasury securities 22,878 102 (77) 22,903 3,596 6,625 12,682
U.S. agency securities 8,949 2 (64) 8,887 1,775 1,930 5,182
Non-U.S. government securities 20,201 211 (101) 20,311 390 3,091 16,830
Certificates of deposit and time deposits 1,300 — — 1,300 490 810 —
Commercial paper 2,639 — — 2,639 1,776 863 —
Corporate debt securities 83,883 1,242 (267) 84,858 — 12,327 72,531
Municipal securities 967 14 — 981 — 130 851
Mortgage- and asset-backed securities 20,529 171 (124) 20,576 — 775 19,801
Subtotal 162,873 1,742 (1,197) 163,418 8,027 27,514 127,877
Total $ 189,961 $ 1,753 $ (1,198) $ 190,516 $ 34,940 $ 27,699 $ 127,877
```
Tokens:
Raw