This code won't be executed in your app, we only need it to *document* how that *external API* should look like.

But, you already know how to easily create automatic documentation for an API with **FastAPI**.

So we are going to use that same knowledge to document how the *external API* should look like... by creating the *path operation(s)* that the external API should implement (the ones your API will call).

!!! tip

Automated Testing :: Automated testing includes unit, integration, and functional testing.

image::testing-pyramid.png[float=right]

The testing pyramid introduced by Mike Cohen in his book link:https://www.mountaingoatsoftware.com/books/succeeding-with-agile-software-development-using-scrum[Succeeding with Agile: Software Development Using Scrum] describes three types of automated tests:

import org.lastaflute.core.direction.FwAssistantDirector;

/**
 * @author jflute
 */
public class FessCurtainBeforeHook implements CurtainBeforeHook {

    @Override
    public void hook(final FwAssistantDirector assistantDirector) {
        processDBFluteSystem();
    }

    protected void processDBFluteSystem() {
        DBFluteSystem.unlock();

	"time"
)

var closeHook atomic.Value // func(fd int)

func init() {
	closeFunc := poll.CloseFunc
	poll.CloseFunc = func(fd int) (err error) {
		if v := closeHook.Load(); v != nil {
			if hook := v.(func(int)); hook != nil {
				hook(fd)
			}
		}
		return closeFunc(fd)
	}
}

func TestSplicePipePool(t *testing.T) {
	const N = 64
	var (
		p          *poll.SplicePipe
		ps         []*poll.SplicePipe

    }

    .appendix .toc > dl > dt,
    .appendix .toc > dl > dt:last-of-type
    .book .home .toc > dl > dt,
    .book .home .toc > dl > dt:last-of-type
    .chapter .toc > dl > dt,
    .chapter .toc > dl > dt:last-of-type {
        padding: 0.5rem 0;
        margin: 0;
    }

    .appendix .toc a,
    .book .home .toc a,
    .chapter .toc a {
        padding-left: 10px;
        font-weight: 400;

/**
 * @author jflute
 */
public class FessCurtainFinallyHook implements CurtainFinallyHook {

    private static final Logger logger = LogManager.getLogger(FessCurtainFinallyHook.class);

    @Override
    public void hook(final FwAssistantDirector assistantDirector) {
        shutdownCommonsHttpClient();
    }

    private void shutdownCommonsHttpClient() { // from Tomcat7ConfigServlet (old class)
        try {

	hook := &preShutdownHookHandler{
		blockedCh: make(chan struct{}),
		resultCh:  make(chan result),
	}
	if err := s.AddPreShutdownHook("test-preshutdown-hook", func() error {
		// wait until the test commands this pre shutdown
		// hook to invoke an API call.
		<-hook.blockedCh

The upload process converts count files into reports, and
uploads reports. There will be only one report, named YYYY-MM-DD.json,
for a given day.

First phase. Look at the localdir (os.UserConfigdir()/go/telemetry/local)
and find all .count and .json files. Find the count files that are no
longer active by looking at their metadata.

Second phase. Group the inactive count files by their expiry date, and

    // ===================================================================================
    //                                                                               Hook
    //                                                                              ======
    @Override
    protected void setupHtmlData(final ActionRuntime runtime) {
        super.setupHtmlData(runtime);

        succeeds 'resolveDependencies'
    }

    def "can modify a configuration in a beforeResolve hook when the hook resolves another configuration"() {
        mavenRepo.module('org.test', 'module1', '1.0').publish()
        mavenRepo.module('org.test', 'module2', '1.0').publish()
        settingsFile << """
           include ":lib"