From 2b1c26d427b1cdb49c229196e5d724af741b130e Mon Sep 17 00:00:00 2001 From: Eric Arellano <14852634+Eric-Arellano@users.noreply.github.com> Date: Thu, 15 Feb 2024 07:27:02 -0500 Subject: [PATCH] Don't delete API docs for class aliases (#815) Part of https://github.com/Qiskit/documentation/issues/814. We shouldn't be deleting attribute pages if they don't correspond to an owning class. This PR also runs `npm run regen-apis`; as shown, this PR's logic change only impacts Qiskit v1 docs. --- docs/api/qiskit-ibm-provider/0.7/_toc.json | 1 - docs/api/qiskit-ibm-runtime/0.18/_toc.json | 1 - docs/api/qiskit/dev/primitives.md | 12 ++++---- .../dev/qiskit.primitives.BaseEstimator.md | 12 ++++++++ .../dev/qiskit.primitives.BaseSampler.md | 12 ++++++++ .../qiskit/dev/qiskit.primitives.Estimator.md | 2 +- .../qiskit/dev/qiskit.primitives.Sampler.md | 2 +- public/api/qiskit/dev/objects.inv | Bin 66922 -> 66920 bytes scripts/lib/api/mergeClassMembers.test.ts | 24 +++++++++++++-- scripts/lib/api/mergeClassMembers.ts | 28 ++++++------------ 10 files changed, 63 insertions(+), 31 deletions(-) create mode 100644 docs/api/qiskit/dev/qiskit.primitives.BaseEstimator.md create mode 100644 docs/api/qiskit/dev/qiskit.primitives.BaseSampler.md diff --git a/docs/api/qiskit-ibm-provider/0.7/_toc.json b/docs/api/qiskit-ibm-provider/0.7/_toc.json index 3ab6d002c82..85eeed943b2 100644 --- a/docs/api/qiskit-ibm-provider/0.7/_toc.json +++ b/docs/api/qiskit-ibm-provider/0.7/_toc.json @@ -211,4 +211,3 @@ ], "collapsed": true } - diff --git a/docs/api/qiskit-ibm-runtime/0.18/_toc.json b/docs/api/qiskit-ibm-runtime/0.18/_toc.json index d570d8cfc71..f9faf0ae5bb 100644 --- a/docs/api/qiskit-ibm-runtime/0.18/_toc.json +++ b/docs/api/qiskit-ibm-runtime/0.18/_toc.json @@ -514,4 +514,3 @@ ], "collapsed": true } - diff --git a/docs/api/qiskit/dev/primitives.md b/docs/api/qiskit/dev/primitives.md index b5d7a9e13e4..4c7967c5099 100644 --- a/docs/api/qiskit/dev/primitives.md +++ b/docs/api/qiskit/dev/primitives.md @@ -224,11 +224,11 @@ print([q.binary_probabilities() for q in job_result.quasi_dists]) ## Estimator -| | | -| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | -| [`BaseEstimator`](qiskit.primitives.BaseEstimator#qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator") | alias of `BaseEstimatorV1` | -| [`Estimator`](qiskit.primitives.Estimator "qiskit.primitives.Estimator")(\*\[, options]) | Reference implementation of [`BaseEstimator`](qiskit.primitives.BaseEstimator#qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator"). | -| [`BackendEstimator`](qiskit.primitives.BackendEstimator "qiskit.primitives.BackendEstimator")(backend\[, options, ...]) | Evaluates expectation value using Pauli rotation gates. | +| | | +| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | +| [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator") | alias of `BaseEstimatorV1` | +| [`Estimator`](qiskit.primitives.Estimator "qiskit.primitives.Estimator")(\*\[, options]) | Reference implementation of [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator"). | +| [`BackendEstimator`](qiskit.primitives.BackendEstimator "qiskit.primitives.BackendEstimator")(backend\[, options, ...]) | Evaluates expectation value using Pauli rotation gates. | ## EstimatorV2 @@ -241,7 +241,7 @@ print([q.binary_probabilities() for q in job_result.quasi_dists]) | | | | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | -| [`BaseSampler`](qiskit.primitives.BaseSampler#qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") | alias of `BaseSamplerV1` | +| [`BaseSampler`](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler") | alias of `BaseSamplerV1` | | [`Sampler`](qiskit.primitives.Sampler "qiskit.primitives.Sampler")(\*\[, options]) | Sampler class. | | [`BackendSampler`](qiskit.primitives.BackendSampler "qiskit.primitives.BackendSampler")(backend\[, options, ...]) | A `BaseSampler` implementation that provides an interface for leveraging the sampler interface from any backend. | diff --git a/docs/api/qiskit/dev/qiskit.primitives.BaseEstimator.md b/docs/api/qiskit/dev/qiskit.primitives.BaseEstimator.md new file mode 100644 index 00000000000..023265ce8c2 --- /dev/null +++ b/docs/api/qiskit/dev/qiskit.primitives.BaseEstimator.md @@ -0,0 +1,12 @@ +--- +title: BaseEstimator +description: API reference for qiskit.primitives.BaseEstimator +in_page_toc_min_heading_level: 1 +python_api_type: attribute +python_api_name: qiskit.primitives.BaseEstimator +--- + +# BaseEstimator + +alias of `BaseEstimatorV1` + diff --git a/docs/api/qiskit/dev/qiskit.primitives.BaseSampler.md b/docs/api/qiskit/dev/qiskit.primitives.BaseSampler.md new file mode 100644 index 00000000000..ae40560cae1 --- /dev/null +++ b/docs/api/qiskit/dev/qiskit.primitives.BaseSampler.md @@ -0,0 +1,12 @@ +--- +title: BaseSampler +description: API reference for qiskit.primitives.BaseSampler +in_page_toc_min_heading_level: 1 +python_api_type: attribute +python_api_name: qiskit.primitives.BaseSampler +--- + +# BaseSampler + +alias of `BaseSamplerV1` + diff --git a/docs/api/qiskit/dev/qiskit.primitives.Estimator.md b/docs/api/qiskit/dev/qiskit.primitives.Estimator.md index 752b4b6e440..802b8398085 100644 --- a/docs/api/qiskit/dev/qiskit.primitives.Estimator.md +++ b/docs/api/qiskit/dev/qiskit.primitives.Estimator.md @@ -14,7 +14,7 @@ python_api_name: qiskit.primitives.Estimator Bases: `BaseEstimatorV1`\[`PrimitiveJob`\[[`EstimatorResult`](qiskit.primitives.EstimatorResult "qiskit.primitives.base.estimator_result.EstimatorResult")]] -Reference implementation of [`BaseEstimator`](qiskit.primitives.BaseEstimator#qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator"). +Reference implementation of [`BaseEstimator`](qiskit.primitives.BaseEstimator "qiskit.primitives.BaseEstimator"). **Run Options** diff --git a/docs/api/qiskit/dev/qiskit.primitives.Sampler.md b/docs/api/qiskit/dev/qiskit.primitives.Sampler.md index 112db62ee7e..f9ac6edef0f 100644 --- a/docs/api/qiskit/dev/qiskit.primitives.Sampler.md +++ b/docs/api/qiskit/dev/qiskit.primitives.Sampler.md @@ -16,7 +16,7 @@ Bases: `BaseSamplerV1`\[`PrimitiveJob`\[[`SamplerResult`](qiskit.primitives.Samp Sampler class. -[`Sampler`](#qiskit.primitives.Sampler "qiskit.primitives.Sampler") is a reference implementation of [`BaseSampler`](qiskit.primitives.BaseSampler#qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler"). +[`Sampler`](#qiskit.primitives.Sampler "qiskit.primitives.Sampler") is a reference implementation of [`BaseSampler`](qiskit.primitives.BaseSampler "qiskit.primitives.BaseSampler"). **Run Options** diff --git a/public/api/qiskit/dev/objects.inv b/public/api/qiskit/dev/objects.inv index d78c319b6e8434ba63050199bf9d6c14e49c9092..965ebd4c6e8aa1923cfa12d3a5091fc6f4601efb 100644 GIT binary patch delta 36376 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
~aM|gUg5sbdi4kgnW5nq_W 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 z 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


1BOPQc=RuK6 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 diff --git a/scripts/lib/api/mergeClassMembers.test.ts b/scripts/lib/api/mergeClassMembers.test.ts index 85a7a1342e1..32ace2a5dd5 100644 --- a/scripts/lib/api/mergeClassMembers.test.ts +++ b/scripts/lib/api/mergeClassMembers.test.ts @@ -13,10 +13,11 @@ import { describe, expect, test } from "@jest/globals"; import { mergeClassMembers } from "./mergeClassMembers"; +import { HtmlToMdResultWithUrl } from "./HtmlToMdResult"; describe("mergeClassMembers", () => { test("merge class members", async () => { - const results: Parameters[0] = [ + const results: HtmlToMdResultWithUrl[] = [ { markdown: `## Attributes @@ -130,7 +131,7 @@ Validate options. }); test("merge class with methods already inlined", async () => { - const results: Parameters[0] = [ + const results: HtmlToMdResultWithUrl[] = [ { markdown: `## Attributes @@ -185,4 +186,23 @@ Inlined method `); expect(merged.length).toEqual(1); }); + + test("keep members without an owning class", async () => { + // Regression test for https://github.com/Qiskit/documentation/issues/814. + const results: HtmlToMdResultWithUrl[] = [ + { + markdown: + '\n\n# BaseEstimator\n\nalias of `BaseEstimatorV1`\n', + meta: { + apiType: "attribute", + apiName: "qiskit.primitives.BaseEstimator", + }, + images: [], + isReleaseNotes: false, + url: "/docs/api/qiskit/qiskit.primitives.BaseEstimator", + }, + ]; + const merged = await mergeClassMembers(results); + expect(merged).toEqual(results); + }); }); diff --git a/scripts/lib/api/mergeClassMembers.ts b/scripts/lib/api/mergeClassMembers.ts index b5aeee3eec2..d868e682b00 100644 --- a/scripts/lib/api/mergeClassMembers.ts +++ b/scripts/lib/api/mergeClassMembers.ts @@ -10,7 +10,7 @@ // copyright notice, and modified files need to carry a notice indicating // that they have been altered from the originals. -import { includes, isEmpty, orderBy, reject } from "lodash"; +import { includes, isEmpty, orderBy } from "lodash"; import { unified } from "unified"; import remarkParse from "remark-parse"; import remarkMdx from "remark-mdx"; @@ -32,21 +32,16 @@ export async function mergeClassMembers( const classes = resultsWithName.filter( (result) => result.meta.apiType === "class", ); + const mergedMemberUrls = new Set(); for (const clazz of classes) { - const members = orderBy( - resultsWithName.filter((result) => { - if ( - !includes( - ["method", "property", "attribute", "function"], - result.meta.apiType, - ) - ) - return false; - return result.meta.apiName?.startsWith(`${clazz.meta.apiName}.`); - }), - (result) => result.meta.apiName, + const unsortedMembers = resultsWithName.filter( + (result) => + includes(["method", "property", "attribute"], result.meta.apiType) && + result.meta.apiName?.startsWith(`${clazz.meta.apiName}.`), ); + unsortedMembers.forEach((result) => mergedMemberUrls.add(result.url)); + const members = orderBy(unsortedMembers, (result) => result.meta.apiName); const attributesAndProps = members.filter( (member) => @@ -94,12 +89,7 @@ export async function mergeClassMembers( } } - // remove merged results - const finalResults = reject(results, (result) => - includes(["method", "attribute", "property"], result.meta.apiType), - ); - - return finalResults; + return results.filter((result) => !mergedMemberUrls.has(result.url)); } async function replaceMembersAfterTitle(