Browse Source

Update readme and pom, add .travis.yml

master
Travis Burtrum 2 years ago
parent
commit
efd88b7f44
6 changed files with 138 additions and 156 deletions
  1. +9
    -0
      .travis-settings.xml
  2. +32
    -0
      .travis.yml
  3. +24
    -0
      README.md
  4. +0
    -107
      README.rst
  5. +72
    -49
      pom.xml
  6. +1
    -0
      src/test/java/CalculationTest.java

+ 9
- 0
.travis-settings.xml View File

@ -0,0 +1,9 @@
<settings>
<servers>
<server>
<id>sonatype-nexus-snapshots</id>
<username>${env.SONATYPE_USERNAME}</username>
<password>${env.SONATYPE_PASSWORD}</password>
</server>
</servers>
</settings>

+ 32
- 0
.travis.yml View File

@ -0,0 +1,32 @@
language: java
sudo: false
matrix:
include:
- env: JDK='OpenJDK 7'
jdk: openjdk7
- env: JDK='OpenJDK 8'
jdk: openjdk8
- env: JDK='OpenJDK 9'
install: . ./install-jdk.sh -F 9 -L GPL
- env: JDK='OpenJDK 10'
install: . ./install-jdk.sh -F 10 -L GPL
- env: JDK='OpenJDK 11'
install: . ./install-jdk.sh -F 11 -L GPL
- env: JDK='OpenJDK 12'
install: . ./install-jdk.sh -F 12 -L GPL
script: mvn test -B -Djava.version=7 # java12 minimum target is 7, not 6
- env: JDK='OpenJDK 13'
install: . ./install-jdk.sh -F 13 -L GPL
script: mvn test -B -Djava.version=7 # java13 minimum target is 7, not 6
before_install: wget https://raw.githubusercontent.com/sormuras/bach/master/install-jdk.sh
after_success:
- if [[ "${JDK}" == 'OpenJDK 7' ]]; then
mvn deploy --settings .travis-settings.xml -Dmaven.test.skip=true -B || travis_terminate 1;
fi
cache:
directories:
- $HOME/.m2

+ 24
- 0
README.md View File

@ -0,0 +1,24 @@
POI Fast Calc
======================
[![Travis-CI Build Status](https://api.travis-ci.org/moparisthebest/poi.svg?branch=master)](https://travis-ci.org/moparisthebest/poi)
A Java library to calculate Excel formulas quickly.
This is a fork of [Apache POI](https://poi.apache.org/) version [3.16](https://github.com/apache/poi/tree/REL_3_16_FINAL)
that serves simply to calculate formulas quickly, it supports XLSX (Excel 2007) row/column limits in the HSSF engine for
much faster evaluation than XML-backed XSSF is capable of, with the drawback that it can't read or write XLS/XLSX files
from or to disk. Read the [email thread](https://lists.apache.org/thread.html/0bc90a3ed386edddfcb9b93ce6c262ad145a6b0433d0fcfe70ef10a2@%3Cdev.poi.apache.org%3E)
with my original proposed patch to upstream poi for background.
To use, add this to your maven pom.xml:
```xml
<dependency>
<groupId>com.moparisthebest.poi</groupId>
<artifactId>poi-fast-calc</artifactId>
<version>3.16-SNAPSHOT</version>
</dependency>
```
The `org.apache.poi` package has been renamed `com.moparisthebest.poi` and all dependencies removed,
so this can cleanly live aside modern/newer upstream poi forever, and shouldn't ever need to change.

+ 0
- 107
README.rst View File

@ -1,107 +0,0 @@
Apache POI
======================
A Java library for reading and writing Microsoft Office binary and OOXML file formats.
The Apache POI Project's mission is to create and maintain Java APIs for manipulating various file formats based upon the Office Open XML standards (OOXML) and Microsoft's OLE 2 Compound Document format (OLE2). In short, you can read and write MS Excel files using Java. In addition, you can read and write MS Word and MS PowerPoint files using Java. Apache POI is your Java Excel solution (for Excel 97-2008). We have a complete API for porting other OOXML and OLE2 formats and welcome others to participate.
OLE2 files include most Microsoft Office files such as XLS, DOC, and PPT as well as MFC serialization API based file formats. The project provides APIs for the OLE2 Filesystem (POIFS) and OLE2 Document Properties (HPSF).
Office OpenXML Format is the new standards based XML file format found in Microsoft Office 2007 and 2008. This includes XLSX, DOCX and PPTX. The project provides a low level API to support the Open Packaging Conventions using openxml4j.
For each MS Office application there exists a component module that attempts to provide a common high level Java api to both OLE2 and OOXML document formats. This is most developed for Excel workbooks (SS=HSSF+XSSF). Work is progressing for Word documents (WP=HWPF+XWPF) and PowerPoint presentations (SL=HSLF+XSLF).
The project has some support for Outlook (HSMF). Microsoft opened the specifications to this format in October 2007. We would welcome contributions.
There are also projects for Visio (HDGF and XDGF), TNEF (HMEF), and Publisher (HPBF).
This library includes the following components, roughly in descending order of maturity:
* Excel spreadsheets (Common SS = HSSF, XSSF, and SXSSF)
* PowerPoint slideshows (Common SL = HSLF and XSLF)
* Word processing documents (Common WP = HWPF and XWPF)
* Outlook email (HSMF and HMEF)
* Visio diagrams (HDGF and XDGF)
* Publisher (HPBF)
And lower-level, supporting components:
* OLE2 Filesystem (POIFS)
* OLE2 Document Properties (HPSF)
* TNEF (HMEF) for Outlook winmail.dat files
* OpenXML4J (OOXML)
| Components named H??F are for reading or writing OLE2 binary formats.
| Components named X??F are for reading or writing OpenOffice XML (OOXML) formats.
Getting started
------------------
Website: https://poi.apache.org/
`Mailing lists`_:
* `Developers`_
* `Users`_
* `General`_ (release announcements)
Bug tracker:
* `Bugzilla`_
* `GitHub pull requests`_
Source code:
* Official `Apache Subversion repo`_ at apache.org
* `ViewVC repo browser`_ at apache.org
* Official `Apache git mirror`_ at apache.org
* Unofficial `GitHub git mirror`_ at github.com
Requires Java 1.6 or later.
Contributing
------------------
* Download and install svn or git, Java JDK 1.6+, and Apache Ant 1.8+ or Gradle
* Check out the code from svn or git
* Import the project into Eclipse or your favorite IDE
* Write a unit test:
* Binary formats and Common APIs: src/testcases/org/apache/poi/
* OOXML APIs only: src/ooxml/testcases/org/apache/poi/
* Scratchpad (Binary formats): src/scratchpad/testcases/org/apache/poi/
* test files: test-data/
* Navigate the source, make changes, and run unit tests to verify
* Binary formats and Common APIs: src/java/org/apache/poi/
* OOXML APIs only: src/ooxml/java/org/apache/poi/
* Scratchpad (Binary formats): src/scratchpad/src/org/apache/poi/
* Examples: src/examples/src/org/apache/poi/
Building jar files
------------------
To build the jar files for poi, poi-ooxml, poi-ooxml-schemas, and poi-examples::
ant jar
.. _Mailing lists: https://poi.apache.org/mailinglists.html
.. _Developers: https://lists.apache.org/list.html?dev@poi.apache.org
.. _Users: https://lists.apache.org/list.html?user@poi.apache.org
.. _General: https://lists.apache.org/list.html?general@poi.apache.org
.. _Bugzilla: https://bz.apache.org/bugzilla/buglist.cgi?product=POI
.. _GitHub pull requests: https://github.com/apache/poi/pulls
.. _Apache Subversion repo: https://svn.apache.org/repos/asf/poi/trunk
.. _ViewVC repo browser: https://svn.apache.org/viewvc/poi/trunk
.. _Apache git mirror: https://git.apache.org/poi.git/
.. _GitHub git mirror: https://github.com/apache/poi

+ 72
- 49
pom.xml View File

@ -21,60 +21,83 @@
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<parent>
<groupId>org.sonatype.oss</groupId>
<artifactId>oss-parent</artifactId>
<version>9</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<groupId>com.moparisthebest.poi</groupId>
<artifactId>poi-fast-calc</artifactId>
<version>3.16-SNAPSHOT</version>
<packaging>jar</packaging>
<name>POI Fast Calc</name>
<url>https://code.moparisthebest.com/moparisthebest/poi</url>
<description>POI Fast Calc - Java API To Calculate Excel formulas quickly</description>
<modelVersion>4.0.0</modelVersion>
<groupId>com.moparisthebest.poi</groupId>
<artifactId>poi-fast-calc</artifactId>
<version>3.16</version>
<packaging>jar</packaging>
<name>Apache POI</name>
<url>http://poi.apache.org/</url>
<description>Apache POI - Java API To Access Microsoft Format Files</description>
<licenses>
<license>
<name>The Apache Software License, Version 2.0</name>
<url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
</license>
</licenses>
<mailingLists>
<mailingList>
<name>POI Users List</name>
<subscribe>user-subscribe@poi.apache.org</subscribe>
<unsubscribe>user-unsubscribe@poi.apache.org</unsubscribe>
<archive>http://mail-archives.apache.org/mod_mbox/poi-user/</archive>
</mailingList>
<mailingList>
<name>POI Developer List</name>
<subscribe>dev-subscribe@poi.apache.org</subscribe>
<unsubscribe>dev-unsubscribe@poi.apache.org</unsubscribe>
<archive>http://mail-archives.apache.org/mod_mbox/poi-dev/</archive>
</mailingList>
</mailingLists>
<organization>
<name>moparisthebest.com</name>
<url>https://www.moparisthebest.com</url>
</organization>
<licenses>
<license>
<name>The Apache Software License, Version 2.0</name>
<url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
</license>
</licenses>
<scm>
<connection>scm:git:https://code.moparisthebest.com/moparisthebest/poi.git</connection>
<developerConnection>scm:git:https://code.moparisthebest.com/moparisthebest/poi.git</developerConnection>
<url>https://code.moparisthebest.com/moparisthebest/poi</url>
</scm>
<organization>
<name>Apache Software Foundation</name>
<url>http://www.apache.org/</url>
</organization>
<properties>
<java.version>1.6</java.version>
<project.build.sourceEncoding>utf8</project.build.sourceEncoding>
<maven.compiler.source>${java.version}</maven.compiler.source>
<maven.compiler.target>${java.version}</maven.compiler.target>
</properties>
<properties>
<java.version>1.6</java.version>
<maven.compiler.source>${java.version}</maven.compiler.source>
<maven.compiler.target>${java.version}</maven.compiler.target>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<scope>test</scope>
<version>4.12</version>
</dependency>
</dependencies>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<pushChanges>false</pushChanges>
<localCheckout>true</localCheckout>
<build>
<!-- default argline for junit tests, java 9+ requires much less memory than 6/7/8, but more runs faster -->
<test.argLine>-Xmx4096m</test.argLine>
</properties>
</build>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<scope>test</scope>
<version>4.12</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.22.1</version>
<configuration>
<verbose>true</verbose>
<fork>true</fork>
<argLine>${test.argLine}</argLine>
</configuration>
</plugin>
<plugin>
<groupId>org.sonatype.plugins</groupId>
<artifactId>nexus-staging-maven-plugin</artifactId>
<version>1.6.5</version>
<extensions>true</extensions>
<configuration>
<serverId>ossrh</serverId>
<nexusUrl>https://oss.sonatype.org/</nexusUrl>
<autoReleaseAfterClose>true</autoReleaseAfterClose>
</configuration>
</plugin>
</plugins>
</build>
</project>

+ 1
- 0
src/test/java/CalculationTest.java View File

@ -66,6 +66,7 @@ public class CalculationTest {
final int maxRows = maxRow - 1; // because we created 1 above
System.gc(); // to clean up from previous runs before we start counting
final long start = System.currentTimeMillis();
//rowNum = maxRow - 3;


Loading…
Cancel
Save