Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 2 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,10 +79,9 @@ new features in the latest version will enhance your experience.
If you are using Maven for project building, add the following configuration in the `pom.xml` file:

```xml

<dependency>
<groupId>org.apache.fesod</groupId>
<artifactId>fesod</artifactId>
<artifactId>fesod-sheet</artifactId>
<version>version</version>
</dependency>
```
Expand All @@ -93,7 +92,7 @@ If you are using Gradle for project building, add the following configuration in

```gradle
dependencies {
implementation 'org.apache.fesod:fesod:version'
implementation 'org.apache.fesod:fesod-sheet:version'
}
```

Expand Down
5 changes: 2 additions & 3 deletions README_CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,10 +63,9 @@ Apache Fesod (Incubating) 需要 **Java 1.8** 或更高版本。建议使用最
如果使用 Maven 进行项目构建,请在 `pom.xml` 文件中添加以下配置:

```xml

<dependency>
<groupId>org.apache.fesod</groupId>
<artifactId>fesod</artifactId>
<artifactId>fesod-sheet</artifactId>
<version>version</version>
</dependency>
```
Expand All @@ -77,7 +76,7 @@ Apache Fesod (Incubating) 需要 **Java 1.8** 或更高版本。建议使用最

```gradle
dependencies {
implementation 'org.apache.fesod:fesod:version'
implementation 'org.apache.fesod:fesod-sheet:version'
}
```

Expand Down
75 changes: 53 additions & 22 deletions website/docs/download.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,56 +3,87 @@ id: 'download'
title: 'Download'
---

Here is the Apache Fesod (Incubating) official download page. Please choose version to download from the following tables. It is recommended use the latest.
Here is the Apache Fesod (Incubating) official download page. Apache Fesod provides source releases that can be downloaded from the ASF distribution site. Binary artifacts are available through Maven Central.

:::tip
# How to Use Apache Fesod (Incubating)

We are currently preparing for the first release under the Apache Incubator. Previous releases were non-Apache releases.
## Using Maven Central (Recommended)

:::
For most users, simply add the dependency to your project:

## Previous Releases (Non-Apache)
```xml
<dependency>
<groupId>org.apache.fesod</groupId>
<artifactId>fesod-sheet</artifactId>
<version>2.0.0-incubating</version>
</dependency>
```

Browse all artifacts: [Maven Central Repository](https://repo1.maven.org/maven2/org/apache/fesod/)

## Available Modules

- **fesod-sheet** - Core module for Excel/CSV processing (recommended for most users)
- **fesod-bom** - Bill of Materials for dependency management
- **fesod-common** - Common utilities (automatically included with fesod-sheet)
- **fesod-shaded** - Shaded dependencies to avoid conflicts (automatically included with fesod-sheet)

# Apache Source Releases

## The Latest Release

| Version | Date | Source Download | Release Notes |
|:-----------------:|:----------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------:|
| 2.0.0-incubating | 2026-01-24 | [Source](https://downloads.apache.org/incubator/fesod/2.0.0-incubating/) ([asc](https://downloads.apache.org/incubator/fesod/2.0.0-incubating/apache-fesod-2.0.0-incubating-src.tar.gz.asc), [sha512](https://downloads.apache.org/incubator/fesod/2.0.0-incubating/apache-fesod-2.0.0-incubating-src.tar.gz.sha512)) | [Release Notes](https://github.com/apache/fesod/releases/tag/2.0.0-incubating) |

# Previous Releases (Non-Apache)

### The latest release
## All archived releases

| Version | Date | Download | Release notes |
|:-------:|:----------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------:|
| 1.3.0 | 2025-08-23 | [fastexcel-1.3.0.jar](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.3.0/fastexcel-1.3.0.jar) ( [asc](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.3.0/fastexcel-1.3.0.jar.asc) \| [sha](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.3.0/fastexcel-1.3.0.jar.sha1)) | [notes](https://github.com/apache/fesod/releases/tag/1.3.0) |

### All archived releases

| Version | Date | Download | Release notes |
|:-------:|:----------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------:|
| 1.2.0 | 2025-04-14 | [fastexcel-1.2.0.jar](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.2.0/fastexcel-1.2.0.jar) ( [asc](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.2.0/fastexcel-1.2.0.jar.asc) \| [sha](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.2.0/fastexcel-1.2.0.jar.sha1)) | [notes](https://github.com/apache/fesod/releases/tag/1.2.0) |
| 1.1.0 | 2025-01-14 | [fastexcel-1.1.0.jar](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.1.0/fastexcel-1.1.0.jar) ( [asc](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.1.0/fastexcel-1.1.0.jar.asc) \| [sha](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.2.0/fastexcel-1.1.0.jar.sha1)) | [notes](https://github.com/apache/fesod/releases/tag/1.1.0) |
| 1.0.0 | 2024-12-05 | [fastexcel-1.0.0.jar](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.0.0/fastexcel-1.0.0.jar) ( [asc](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.0.0/fastexcel-1.0.0.jar.asc) \| [sha](https://repo1.maven.org/maven2/cn/idev/excel/fastexcel/1.0.0/fastexcel-1.0.0.jar.sha1)) | [notes](https://github.com/apache/fesod/releases/tag/1.0.0) |

## Notes
# Verifying Apache Releases

All Apache releases must be verified before use. Follow these steps to verify the integrity and authenticity of the source release:

## Download Verification Files

Download the [KEYS](https://downloads.apache.org/incubator/fesod/KEYS) file containing the public keys used for signing releases.

* When downloading a release, please verify the OpenPGP compatible signature (or failing that, check the SHA-512); these should be fetched from the main Apache site.
* The KEYS file contains the public keys used for signing release. It is recommended that (when possible) a web of trust is used to confirm the identity of these keys.
## Verify Signature

### To verify the signature of the release artifact
1. Import the KEYS file to your GPG keyring:

You will need to download both the release artifact and the .asc signature file for that artifact. Then verify the signature by:
```bash
gpg --import KEYS
```

* Download the KEYS file and the .asc signature files for the relevant release artifacts.
* Import the KEYS file to your GPG keyring:
2. Download the source release, .asc signature file, and .sha512 checksum file.

3. Verify the GPG signature:

```bash
gpg --import KEYS
gpg --verify apache-fesod-2.0.0-incubating-src.tar.gz.asc apache-fesod-2.0.0-incubating-src.tar.gz
```

* Verify the signature of the release artifact using the following command:
## Verify Checksum

Verify the SHA-512 checksum:

```bash
gpg --verify <artifact>.asc <artifact>
shasum -a 512 -c apache-fesod-2.0.0-incubating-src.tar.gz.sha512
```

### To verify the checksum of the release artifact

You will need to download both the release artifact and the .sha512 checksum file for that artifact. Then verify the checksum by:
Or on Linux:

```bash
shasum -a 512 -c <artifact>.sha512
sha512sum -c apache-fesod-2.0.0-incubating-src.tar.gz.sha512
```
10 changes: 6 additions & 4 deletions website/docs/migration/from-fastexcel.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,24 +41,26 @@ Replace your existing dependency with Apache Fesod (Incubating):
| Source | GroupId | ArtifactId | Version |
|--------|---------|------------|----------|
| **cn.idev FastExcel** | cn.idev.excel | fastexcel | 1.3.0 |
| **Apache Fesod (Incubating)** ✅ | org.apache.fesod | fesod | 1.3.0+ |
| **Apache Fesod (Incubating)** ✅ | org.apache.fesod | fesod-sheet | 2.0.0-incubating+ |

**Maven:**

```xml
<dependency>
<groupId>org.apache.fesod</groupId>
<artifactId>fesod</artifactId>
<version>1.3.0</version>
<artifactId>fesod-sheet</artifactId>
<version>2.0.0-incubating</version>
</dependency>
```

**Gradle:**

```gradle
implementation 'org.apache.fesod:fesod:1.3.0'
implementation 'org.apache.fesod:fesod-sheet:2.0.0-incubating'
```

> **Note**: The `fesod-sheet` module is the core module for Excel/CSV processing. It automatically includes the necessary dependencies (`fesod-common` and `fesod-shaded`).

### Step 2: Package Import Updates

Update all import statements to use the new Apache Fesod (Incubating) package structure.
Expand Down
61 changes: 47 additions & 14 deletions website/docs/quickstart/guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,20 +7,28 @@ title: 'Guide'

## Compatibility Information

The following table lists the minimum Java language version requirements for each version of the Fesod library:
The following table lists the minimum Java language version requirements for each version of the Apache Fesod(Incubating) library:

| Version | JDK Version Support Range | Notes |
|---------|---------------------------|-------|
| 1.3.x | JDK8 - JDK25 | |
| 1.2.x | JDK8 - JDK21 | |
| 1.1.x | JDK8 - JDK21 | |
| 1.0.x | JDK8 - JDK21 | |
| Version | JDK Version Support Range | Notes |
|-------------------|---------------------------|--------------------------------|
| 2.0.0-incubating | JDK8 - JDK25 | First Apache Incubator release |
| 1.3.x | JDK8 - JDK25 | Non-Apache release |
| 1.2.x | JDK8 - JDK21 | Non-Apache release |
| 1.1.x | JDK8 - JDK21 | Non-Apache release |
| 1.0.x | JDK8 - JDK21 | Non-Apache release |

We strongly recommend using the latest version of Fesod, as performance optimizations, bug fixes, and new features
We strongly recommend using the latest version of Apache Fesod(Incubating), as performance optimizations, bug fixes, and new features
in the latest version will enhance your experience.

> Currently, Fesod uses POI as its underlying package. If your project already includes POI-related components, you
> will need to manually exclude POI-related jar files.
### Dependencies

Apache Fesod(Incubating) uses the following key dependencies:

- **Apache POI 5.5.1** - For Excel file processing
- **Apache Commons CSV 1.14.1** - For CSV file support
- **Ehcache 3.9.11** - For caching functionality

> If your project already includes POI-related components, you may need to manually exclude POI-related jar files to avoid version conflicts.

## Version Update

Expand All @@ -33,20 +41,45 @@ available versions in the [Maven Central Repository](https://mvnrepository.com/a
If you are using Maven for project building, add the following configuration in the `pom.xml` file:

```xml

<dependency>
<groupId>org.apache.fesod</groupId>
<artifactId>fesod</artifactId>
<version>version</version>
<artifactId>fesod-sheet</artifactId>
<version>2.0.0-incubating</version>
</dependency>
```

### Alternative: Using BOM for Version Management

For better dependency management, you can use the Fesod BOM:

```xml
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.apache.fesod</groupId>
<artifactId>fesod-bom</artifactId>
<version>2.0.0-incubating</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>

<dependencies>
<dependency>
<groupId>org.apache.fesod</groupId>
<artifactId>fesod-sheet</artifactId>
<!-- Version managed by BOM -->
</dependency>
</dependencies>
```

## Gradle

If you are using Gradle for project building, add the following configuration in the `build.gradle` file:

```gradle
dependencies {
implementation 'org.apache.fesod:fesod:version'
implementation 'org.apache.fesod:fesod-sheet:2.0.0-incubating'
}
```
Loading
Loading