Skip to content

/aut

The Archives Unleashed Toolkit is an open-source toolkit for analyzing web archives.
spark hadoop webarchives analysis apache-spark java scala digital-humanities pyspark dataframe
Scala Java Python
  1. Scala 79.0%
  2. Java 16.7%
  3. Python 4.3%
Branch: master
Find File
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Open in Desktop Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

@jrwiebe @ruebot
jrwiebe and ruebot Add PDF binary extraction. (#340) 
Introduces the new extractPDFDetailsDF() method and brings in changes to make our use of Tika's MIME type detection more efficient, as well as POM updates to use a shaded version of tika-parsers in order to eliminate a dependency version conflict that has long been troublesome.

- Updates getImageBytes to getBinaryBytes
- Refactor SaveImage class to more general SaveBytes, and saveToDisk to saveImageToDisk
- Only instantiate Tika when the DetectMimeTypeTika singleton object is first referenced. See https://git.io/fj7g0.
- Use TikaInputStream to enabler container-aware detection. Until now we were only using the default Mime Magic detection. See https://tika.apache.org/1.22/detection.html#Container_Aware_Detection.
- Added generic saveToDisk method to save a bytes column of a DataFrame to files
- Updates tests
- Resolves #302
- Further addresses #308
- Includes work by @ruebot, see #340 for all commits before squash
Latest commit 73981a7 Aug 11, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update Bug report template. (#268) Sep 10, 2018
config/checkstyle More scalastyle work; addresses #196. (#339) Aug 8, 2019
src Add PDF binary extraction. (#340) Aug 12, 2019
.gitignore Python formatting, and gitignore additions. (#326) Jul 18, 2019
.travis.yml Test Java 8 & 11, and remove OracleJDK; resolves #324. (#325) Jul 8, 2019
CODE_OF_CONDUCT.md Created Code of Conduct file (#110) Nov 3, 2017
CONTRIBUTING.md warcbase core moves to aut Jul 5, 2017
LICENSE warcbase core moves to aut Jul 5, 2017
LICENSE_HEADER.txt Update license headers for #208. (#290) Nov 22, 2018
README.md [skip travis] Update README (#284) Oct 17, 2018
pom.xml Add PDF binary extraction. (#340) Aug 12, 2019

README.md

The Archives Unleashed Toolkit

Build Status codecov Maven Central Javadoc Scaladoc LICENSE Contribution Guidelines

The Archives Unleashed Toolkit is an open-source toolkit for analyzing web archives built around Apache Spark. This toolkit is part of the Archives Unleashed Project.

The toolkit grew out of a previous project called Warcbase. The following article provides a nice overview, much of which is still relevant:

Getting Started

Easy

If you have Apache Spark ready to go, it's as easy as:

$ spark-shell --packages "io.archivesunleashed:aut:0.17.0"

A little less easy

You can download the latest release here and include it like so:

$ spark-shell --jars /path/to/aut-0.17.0-fatjar.jar"

Even less easy

Build it yourself as per the instructions below:

Clone the repo:

$ git clone http://github.com/archivesunleashed/aut.git

You can then build The Archives Unleashed Toolkit.

$ mvn clean install

For the impatient, to skip tests:

$ mvn clean install -DskipTests

I want to use Docker!

Ok! Take a quick spin with aut with Docker.

Documentation! Or, how do I use this?

Once built or downloaded, you can follow the basic set of recipes and tutorials here.

License

Licensed under the Apache License, Version 2.0.

Acknowledgments

This work is primarily supported by the Andrew W. Mellon Foundation. Additional funding for the Toolkit has come from the U.S. National Science Foundation, Columbia University Library's Mellon-funded Web Archiving Incentive Award, the Natural Sciences and Engineering Research Council of Canada, the Social Sciences and Humanities Research Council of Canada, and the Ontario Ministry of Research and Innovation's Early Researcher Award program. Any opinions, findings, and conclusions or recommendations expressed are those of the researchers and do not necessarily reflect the views of the sponsors.

You can’t perform that action at this time.