jvm-memcached-tool

This is a practice project to learn how to use Quarkus, the Supersonic Subatomic Java Framework, with Picocli.

• Command Mode with Picocli - Quarkus
  • Command Mode Applications - Quarkus
• picocli - a mighty tiny command line interface

original: scripts/memcached-tool

Prerequisite

• JDK 17

Build

$ ./mvnw clean package

# the below jar is an executable jar. Please rename it if necessary.
$ ls target/memcached-tool.jar
target/memcached-tool.jar

Run

$ java -jar target/memcached-tool.jar
Usage: memcached-tool [-hvV] [--host=<configEndpoint>] [-p=<clusterPort>]
                      [COMMAND]
Simple tool to handle memcached
  -h, --help
      --host=<configEndpoint>
                             Cluster hostname.
                               Default: localhost
  -p, --port=<clusterPort>   Cluster port number.
                               Default: 11211
  -v, --verbose              Enable verbose mode.
  -V, --version              print version information and exit
Commands:
  display        Display slab statistics
  generate, gen  Generate items on memcached!
  dump
  keys
  stats          Perform stats command
  sizes          Display item size histogram
  flush          Flush items on memcached

Development

Run Memcached with Docker

To spin up a local Memcached instance quickly, start the official Docker image:

$ docker run -d --rm --name memcached \
    -p 11211:11211 \
    memcached:1.6.32-alpine

# Verify the instance via the stats command
$ java -jar target/memcached-tool.jar stats --host localhost --port 11211

📦 Releasing jvm-memcached-tool to Maven Central

This document describes how to release this library to Maven Central using maven-release-plugin and central-publishing-maven-plugin.

---

✅ Prerequisites

• You must have a Sonatype Central Portal account.
• Your project must be registered and approved via OSSRH (JIRA).
• Your ~/.m2/settings.xml must contain the following credentials:

<servers>
  <server>
    <id>central</id>
    <username>your-token-username</username>
    <password>your-token-password</password>
  </server>
</servers>

$ mvn -Prelease release:prepare
$ mvn -Prelease release:perform

(If necessary) When the release commands are failed

mvn release:clean
git reset --hard
git clean -fd
git tag -d <TAG: 0.2.1>

References

• memcached - Official Image | Docker Hub
• Testcontainers for Java
  • Jupiter / JUnit 5 - Testcontainers for Java