sangria.annotations.ApiMayChange Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of sangria-core_2.13 Show documentation

Scala GraphQL implementation

The newest version!

package sangria.annotations;

/*
 * Copied and adapted from the akka annotation @ApiMayChange
 * The akka code was licensed under Apache License Version 2.0, January 2004 which is
 * also used as the Sangria license and the following copyright notice was attached:
 * Copyright (C) 2017-2019 Lightbend Inc. 
 */

import java.lang.annotation.*;

/**
 * Marks APIs that are meant to evolve towards becoming stable APIs, but are not stable APIs yet.
 *
 * Evolving interfaces MAY change from one patch release to another (i.e. 2.4.10 to 2.4.11)
 * without up-front notice. A best-effort approach is taken to not cause more breakage than really
 * necessary, and usual deprecation techniques are utilised while evolving these APIs, however there
 * is NO strong guarantee regarding the source or binary compatibility of APIs marked using this
 * annotation.
 *
 * 
It MAY also change when promoting the API to stable, for example such changes may include
 * removal of deprecated methods that were introduced during the evolution and final refactoring
 * that were deferred because they would have introduced to much breaking changes during the
 * evolution phase.
 *
 * 
Promoting the API to stable MAY happen in a patch release.
 *
 * It is encouraged to document in ScalaDoc how exactly this API is expected to evolve.
 */
@Documented
@Retention(RetentionPolicy.CLASS) // to be accessible by MiMa (not currently used by Sangria)
@Target({
        ElementType.METHOD,
        ElementType.CONSTRUCTOR,
        ElementType.FIELD,
        ElementType.TYPE,
        ElementType.PACKAGE
})
public @interface ApiMayChange {

    /** Reference to issue discussing the future evolvement of this API */
    String issue() default "";
}