Hello Apache DataSketches Community,

1. This is a call for vote to release Apache DataSketches-memory version:
 1.0.0-incubating-RC1

NOTE 1: This is one component of the DataSketches library which needs to be
released first as other
repositories have a dependency on this one. Once this is released, the
other components of the library
will be able to be released.

NOTE 2: All of the code has been properly refactored with
"org.apache.datasketches...".
All source files have the proper Apache license and have been checked with
the Maven Rat Plugin.
The code passes all tests with a coverage of > 98%.

2. The release candidate:
https://dist.apache.org/repos/dist/dev/incubator/datasketches/memory/1.0.0-incubating-RC2/apache-datasketches-memory-1.0.0-incubating-src.zip

3. Source repository:
https://github.com/apache/incubator-datasketches-memory

Git Tag for this release:
https://github.com/apache/incubator-datasketches-memory/tree/1.0.0-incubating-RC2

Git HashId for this release starts with: ec8f16e

The artifacts have been signed with --keyid-format SHORT : 8CD4A902

4. Repository: dist.apache.org repository:

The public signing key can be found in the KEYS file:
https://dist.apache.org/repos/dist/dev/incubator/datasketches/KEYS

Upon acceptance, the above artifacts will be deployed into the official
Apache release repository:
https://dist.apache.org/repos/dist/release/incubator/datasketches/memory/

5. Repository: Maven Central (repository.apache.org):

Upon acceptance the jar artifacts will be generated from the source
repository and deployed
to the Apache Maven Central staging repository:

https://repository.apache.org/content/groups/staging/org/apache/datasketches/memory/

And then released into
https://repository.apache.org/content/repositories/releases/datasketches/memory/

6. Build Guide:

The DataSketches-memory component is pure Java and is structured as a Maven
project.  You must compile using JDK 8.  There is one run-time dependency
and, of course, a number of test and Maven plugin dependencies, all of
which can be resolved by Maven.

This component is a set of low-level library functions that is used by the
other DataSketches components.  It has no user interface so the only thing
you can do is compile and run the unit tests.
There are two types of tests: normal unit tests and tests run by the strict
profile.  To run normal unit tests:

  $ mvn clean test

To run the strict profile tests:

  $ mvn clean test -P strict

Note also that when running the test suite, you might get the following
message:

  SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
  SLF4J: Defaulting to no-operation (NOP) logger implementation
  SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further
details.

This is normal.  It just indicates that in your environment, you do not
have a logger in your class-path so the default logger of a no-op is used
instead.

To install jars in your local .m2 repository:

  $ mvn clean install

7. If you are interested in the actual functions of the Memory, you will
need to write some code that calls the Memory functions.

The documentation for the DataSketches Memory component is part of the
website.

Overview documentation:
- https://datasketches.github.io/docs/Memory/MemoryPackage.html
- https://datasketches.github.io/docs/Memory/MemoryPerformance.html

Javadocs:
https://datasketches.github.io/api/memory/snapshot/apidocs/index.html

This particular component has been split out from the rest of the
DataSketches code because there have been a number of requests from folks
that are interested in these high-performance functions independently of
the remainder of the DataSketches library.


8. The vote will be performed in two stages:
   - This letter will be published on dev@ open for at least 72 hours or
until necessary number of votes are reached.
   - This letter will be published on incubator@general for at least 72
hours or until necessary number of votes are reached.

  Anybody can vote, but only IPMC member's votes count.

Please vote accordingly:

[ ] +1 approve
[ ] +0 no opinion
[ ] -1 disapprove with the reason

Thanks,
The Apache DataSketches Team

Reply via email to